文档文档

任务配置选项

任务选项定义关于任务的具体信息。它们在Flux脚本中设置,在InfluxDB API中,或在InfluxDB用户界面(UI)中。以下任务选项可用

everycron 是互斥的,但至少需要其中一个。

name

任务的名称。 必需

数据类型: 字符串

在 Flux 中

option task = {
    name: "taskName",
    // ...
}
在带有 `scriptID` 的 `/api/v2/tasks` 请求体中
{
  "scriptID": "SCRIPT_ID",
  "name": "TASK_NAME"
  ...
}

SCRIPT_ID 替换为您的 InfluxDB 可调用脚本的 ID。

every

任务运行的间隔。此选项还确定任务首次运行的时间,具体取决于指定的日期和时间(在 持续时间字面量 中指定)。

数据类型: 持续时间

例如,如果您在 2:30 保存或安排任务,并且每小时运行一次任务(1h

option task = {name: "aggregation", every: 1h}

任务首次在下午 3:00 执行,之后每小时执行一次。

在 Flux 中

option task = {
    // ...
    every: 1h,
}
在带有 `scriptID` 的 `/api/v2/tasks` 请求体中
{
  "scriptID": "SCRIPT_ID",
  "every": "1h"
  ...
}

在 InfluxDB UI 中,使用 间隔 字段设置此选项。

cron

定义任务运行计划的 cron 表达式。cron 调度基于系统时间。

数据类型: 字符串

在 Flux 中

option task = {
    // ...
    cron: "0 * * * *",
}
在带有 `scriptID` 的 `/api/v2/tasks` 请求体中
{
  "scriptID": "SCRIPT_ID",
  "cron": "0 * * * *",
  ...
}

偏移量

延迟任务的执行,但保留原始时间范围。例如,如果任务需要在每小时运行,一个 10m 的偏移量将任务延迟到小时后 10 分钟,但任务中定义的所有时间范围都与指定的执行时间相关。

数据类型: 持续时间

在 Flux 中

option task = {
    // ...
    offset: 10m,
}

在带有 scriptID/api/v2/tasks 请求体中

{
  "scriptID": "SCRIPT_ID",
  "offset": "10m",
  ...
}

这个页面有帮助吗?

感谢您的反馈!


Flux 的未来

Flux 正在进入维护模式。您可以继续像现在一样使用它,而无需对您的代码进行任何更改。

阅读更多

InfluxDB v3 增强功能和 InfluxDB 集群现在已普遍可用

新功能,包括更快的查询性能和管理工具,推进了 InfluxDB v3 产品线。InfluxDB 集群现在已普遍可用。

InfluxDB v3 性能和功能

InfluxDB v3产品线在查询性能方面进行了重大改进,并提供了新的管理工具。这些改进包括用于监控InfluxDB集群健康状态的操作仪表板、InfluxDB Cloud Dedicated中的单点登录(SSO)支持以及用于令牌和数据库的新管理API。

了解新的v3改进


InfluxDB集群版正式发布

InfluxDB集群版现已正式发布,让您能够在自管理堆栈中获得InfluxDB v3的功能。

与我们讨论InfluxDB集群版

InfluxDB Cloud基于TSM