文档文档

管理 Kapacitor Flux 任务运行

使用 kapacitor CLIKapacitor HTTP API 来管理 Kapacitor Flux 任务运行。每次 Flux 任务执行都被视为一次“运行”。

使用 kapacitor flux task run list 命令及其子命令来管理 Kapacitor Flux 任务运行。

列出 Kapacitor Flux 任务运行

使用 kapacitor flux task run list 命令输出 Kapacitor Flux 任务日志。提供以下标志

* 必需

  • * --task-id: 任务 ID
  • --run-id: 按运行 ID 过滤
  • --before: 返回在此时间之前发生的任务运行(RFC3339 时间戳)
  • --after: 返回在此时间之后发生的任务运行(RFC3339 时间戳)
  • --limit: 限制返回的任务运行数量(默认为 100)

CLI 示例

列出 Flux 任务的运行
kapacitor flux task run list --task-id 000x00xX0xXXx00
列出在某个时间范围内的 Flux 任务运行
kapacitor flux task run list \
  --task-id 000x00xX0xXXx00 \
  --after 2021-01-01T00:00:00Z \
  --before 2021-01-31T00:00:00Z
列出有限数量的 Flux 任务运行
kapacitor flux task run list \
  --task-id 000x00xX0xXXx00 \
  --limit 10

重试 Kapacitor Flux 任务运行

使用 kapacitor flux task run retry 命令重试 Kapacitor Flux 任务运行。提供以下标志

* 必需

  • * --task-id: 任务 ID
  • * --run-id: 运行 ID
kapacitor flux task run retry \
  --task-id 000x00xX0xXXx00 \
  --run-id XXX0xx0xX00Xx0X 

列出 Kapacitor Flux 任务运行

使用以下请求方法和端点列出 Kapacitor Flux 任务运行。

GET /kapacitor/v1/api/v2/tasks/{taskID}/runs

在请求中提供以下信息(* 必填

Headers

  • * Content-type: application/json

路径参数

  • * taskID: 任务 ID

查询参数

  • after: 列出特定运行 ID 之后的任务运行
  • afterTime: 返回在此时间之后发生的任务运行(RFC3339 时间戳)
  • beforeTime: 返回在此时间之前发生的任务运行(RFC3339 时间戳)
  • limit: 限制返回的任务运行数量(默认为 100)

API 示例

以下示例使用了任务 ID 000x00xX0xXXx00

列出 Flux 任务的所有运行
curl --GET 'https://:9092/kapacitor/v1/api/v2/tasks/000x00xX0xXXx00/runs' \
  --header 'Content-Type: application/json'
列出 Flux 任务的有限数量的运行
curl --GET 'https://:9092/kapacitor/v1/api/v2/tasks/000x00xX0xXXx00/runs' \
  --header 'Content-Type: application/json' \
  --data-urlencode "limit=10"
列出特定运行 ID 之后的 Flux 任务运行
curl --GET 'https://:9092/kapacitor/v1/api/v2/tasks/000x00xX0xXXx00/runs' \
  --header 'Content-Type: application/json' \
  --data-urlencode "after=XXX0xx0xX00Xx0X"
列出在某个时间范围内的 Flux 任务运行
curl --GET 'https://:9092/kapacitor/v1/api/v2/tasks/000x00xX0xXXx00/runs' \
  --header 'Content-Type: application/json' \
  --data-urlencode 'afterTime=2021-01-01T00:00:00Z' \
  --data-urlencode 'beforeTime=2021-01-31T00:00:00Z'

重试 Kapacitor Flux 任务运行

使用以下请求方法和端点重试 Kapacitor Flux 任务运行。

POST /kapacitor/v1/api/v2/tasks/{taskID}/runs/{runID}/retry

在请求中提供以下信息(* 必填

路径参数

  • * taskID: 任务 ID
  • * runID: 要重试的运行 ID
# Retry run ID XXX0xx0xX00Xx0X for task ID 000x00xX0xXXx00
curl --request POST \
  'https://:9092/kapacitor/v1/api/v2/tasks/000x00xX0xXXx00/runs/XXX0xx0xX00Xx0X'

要轻松重试所有失败的任务运行,请参阅 重试失败的 Kapacitor 任务


此页面是否有帮助?

感谢您的反馈!


InfluxDB 3.8 新特性

InfluxDB 3.8 和 InfluxDB 3 Explorer 1.6 的主要增强功能。

查看博客文章

InfluxDB 3.8 现已适用于 Core 和 Enterprise 版本,同时发布了 InfluxDB 3 Explorer UI 的 1.6 版本。本次发布着重于操作成熟度,以及如何更轻松地部署、管理和可靠地运行 InfluxDB。

更多信息,请查看

InfluxDB Docker 的 latest 标签将指向 InfluxDB 3 Core

在 **2026 年 2 月 3 日**,InfluxDB Docker 镜像的 latest 标签将指向 InfluxDB 3 Core。为避免意外升级,请在您的 Docker 部署中使用特定的版本标签。

如果使用 Docker 来安装和运行 InfluxDB,latest 标签将指向 InfluxDB 3 Core。为避免意外升级,请在您的 Docker 部署中使用特定的版本标签。例如,如果使用 Docker 运行 InfluxDB v2,请将 latest 版本标签替换为 Docker pull 命令中的特定版本标签 — 例如

docker pull influxdb:2