BatchNode
batch 节点负责创建多个子 QueryNode 或 QueryFluxNodes。每次调用 query 或 queryFlux 都会创建一个可进一步配置的子 batch 节点。参见 QueryNode 和 QueryFluxNode。 batch 任务中的 batch 变量是 BatchNode 的一个实例。
使用 BatchNode 时需要 QueryNode 或 QueryFluxNode。它们定义了批处理数据的源和计划,并且应该在任何其他 链接方法 之前使用。
示例
var errors = batch
|query('SELECT value from errors')
...
var views = batch
|query('SELECT value from views')
...var errors = batch
|queryFlux('''
from(bucket: "example-bucket")
|> range(start: -1m)
|> filter(fn: (r) => r._measurement == "errors")
''')
...
var views = batch
|queryFlux('''
from(bucket: "example-bucket")
|> range(start: -1m)
|> filter(fn: (r) => r._measurement == "views")
''')
...可用统计信息
- query_errors: 查询时的错误数
- batches_queried: 查询返回的批次数
- points_queried: 批次中的总点数
构造函数
| 链式方法 | 描述 |
|---|---|
| 批次 | 没有构造函数签名。 |
属性方法
| Setter 方法 | 描述 |
|---|---|
| quiet ( ) | 抑制此节点的所有错误日志事件。 |
链式方法
Deadman, Query, FluxQuery, Stats
属性
属性方法会修改调用节点的状态。它们不会向管道添加新节点,并且始终返回对调用节点的引用。属性方法使用 . 运算符标记。
Quiet
抑制此节点的所有错误日志事件。
batch.quiet()链式方法
链式方法在管道中创建一个新的节点作为调用节点的子节点。它们不会修改调用节点。链式方法使用 | 运算符标记。
死人开关(Deadman)
用于创建低吞吐量警报(即死人开关)的辅助函数。
- 阈值:如果吞吐量低于每 points/interval 的点数,则触发警报。
- 间隔:检查吞吐量的频率。
- 表达式:可选的表达式列表,也用于评估。对于按时警报很有用。
示例
var data = batch
|query()...
// Trigger critical alert if the throughput drops below 100 points per 10s and checked every 10s.
data
|deadman(100.0, 10s)
//Do normal processing of data
data...以上等同于以下示例
var data = batch
|query()...
// Trigger critical alert if the throughput drops below 100 points per 10s and checked every 10s.
data
|stats(10s)
.align()
|derivative('emitted')
.unit(10s)
.nonNegative()
|alert()
.id('node \'stream0\' in task \'{{ .TaskName }}\'')
.message('{{ .ID }} is {{ if eq .Level "OK" }}alive{{ else }}dead{{ end }}: {{ index .Fields "emitted" | printf "%0.3f" }} points/10s.')
.crit(lambda: "emitted" <= 100.0)
//Do normal processing of data
data...id 和 message 警报属性可以通过 'deadman' 配置部分全局配置。
由于 AlertNode 是最后一个组件,因此可以像往常一样对其进行进一步修改。示例
var data = batch
|query()...
// Trigger critical alert if the throughput drops below 100 points per 10s and checked every 10s.
data
|deadman(100.0, 10s)
.slack()
.channel('#dead_tasks')
//Do normal processing of data
data...您可以指定额外的 lambda 表达式来进一步限制死人开关的触发时间。示例
var data = batch
|query()...
// Trigger critical alert if the throughput drops below 100 points per 10s and checked every 10s.
// Only trigger the alert if the time of day is between 8am-5pm.
data
|deadman(100.0, 10s, lambda: hour("time") >= 8 AND hour("time") <= 17)
//Do normal processing of data
data...batch|deadman(threshold float64, interval time.Duration, expr ...ast.LambdaNode)返回:AlertNode
查询
要执行的查询。WHERE 子句中不得包含时间条件,也不得包含 GROUP BY 子句。时间条件会根据周期、偏移量和计划动态添加。GROUP BY 子句会根据传递给 groupBy 方法的维度动态添加。
batch|query(q string)返回: QueryNode
QueryFlux
要执行的 Flux 查询。
batch|QueryFlux(queryStr string)返回: QueryFluxNode
Stats
创建一个新的数据流,其中包含节点的内部统计信息。interval 表示基于实际时间发出统计信息的频率。这意味着 interval 时间与源节点接收的数据点的时间无关。
batch|stats(interval time.Duration)返回:StatsNode
此页面是否有帮助?
感谢您的反馈!
支持和反馈
感谢您成为我们社区的一员!我们欢迎并鼓励您对 Kapacitor 和本文档提供反馈和错误报告。要获取支持,请使用以下资源: