文档文档

kapacitor define

kapacitor define 命令用于创建或更新一个任务。任务通过 TICKscript 定义,该 TICKscript 定义了任务的数据处理管道。

更新现有任务时,该任务将被重新加载,除非在命令中包含了 -no-reload 标志。

用法

kapacitor define [<task-id>] [flags]

参数

  • task-id: 任务的唯一标识符

Flags

标志描述输入
-dbrp用于查询的数据库和保留策略(可多次指定)"db"."rp"(除非标识符包含空格或特殊字符,否则双引号是可选的)
-file用于模板任务的 YAML 或 JSON 文件的路径Filepath
-no-reload即使任务已启用,也不重新加载任务
-template用于创建任务的模板 ID模板 ID
-tick用于创建任务的 TICKscript 的路径Filepath
-type任务类型streambatch
-vars在使用模板时,用于变量的 JSON 文件的路径Filepath

示例

从 TICKscript 创建新任务

kapacitor define my_task \
  -dbrp mydb.myrp \
  -tick /path/to/TICKscript.tick \
  -type stream

从模板创建新任务

kapacitor define my_task \
  -dbrp mydb.myrp \
  -template alert_template \
  -vars /path/to/vars.json \  
  -type batch

更新任务的 TICKscript

kapacitor define existing_task \
  -tick /path/to/new_TICKscript.tick

更新任务而不重新加载任务

kapacitor define existing_task \
  -tick /path/to/new_TICKscript.tick \
  -no-reload

更新任务以查询多个 DBRP 组合

如果一个任务查询多个数据库和保留策略(DBRP)组合,要添加更多,您必须包含所有现有的 DBRP。在更新任务时从命令中省略的任何现有 DBRP 都将从任务中移除。

kapacitor define existing_task \
  -dbrp mydb.myrp \
  -dbrp otherdb.default \
  -dbrp telegraf.autogen

此页面是否有帮助?

感谢您的反馈!


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