指标与遥测
使用计数器、仪表和直方图记录应用程序指标。
加载
local metrics = require("metrics")
计数器
递增计数器
metrics.counter_inc("requests_total", {method = "POST"})
| 参数 | 类型 | 描述 |
|---|---|---|
name |
string | 指标名称 |
labels |
table? | 标签键值对 |
返回: boolean, error
增加计数器值
metrics.counter_add("bytes_total", 1024, {direction = "out"})
| 参数 | 类型 | 描述 |
|---|---|---|
name |
string | 指标名称 |
value |
number | 要增加的值 |
labels |
table? | 标签键值对 |
返回: boolean, error
仪表
设置仪表值
metrics.gauge_set("queue_depth", 42, {queue = "emails"})
| 参数 | 类型 | 描述 |
|---|---|---|
name |
string | 指标名称 |
value |
number | 当前值 |
labels |
table? | 标签键值对 |
返回: boolean, error
递增仪表
metrics.gauge_inc("connections", {pool = "db"})
| 参数 | 类型 | 描述 |
|---|---|---|
name |
string | 指标名称 |
labels |
table? | 标签键值对 |
返回: boolean, error
递减仪表
metrics.gauge_dec("connections", {pool = "db"})
| 参数 | 类型 | 描述 |
|---|---|---|
name |
string | 指标名称 |
labels |
table? | 标签键值对 |
返回: boolean, error
直方图
记录观测值
metrics.histogram("duration_seconds", 0.123, {method = "GET"})
| 参数 | 类型 | 描述 |
|---|---|---|
name |
string | 指标名称 |
value |
number | 观测值 |
labels |
table? | 标签键值对 |
返回: boolean, error
错误
| 条件 | 类型 | 可重试 |
|---|---|---|
| 收集器不可用 | errors.INTERNAL |
否 |
错误处理请参阅 错误处理。