Metricas y Telemetria
Registrar metricas de aplicación usando contadores, gauges e histogramas.
Carga
local metrics = require("metrics")
Contadores
Incrementar Contador
metrics.counter_inc("requests_total", {method = "POST"})
| Parámetro | Tipo | Descripción |
|---|---|---|
name |
string | Nombre de metrica |
labels |
table? | Pares clave-valor de etiquetas |
Devuelve: boolean, error
Agregar a Contador
metrics.counter_add("bytes_total", 1024, {direction = "out"})
| Parámetro | Tipo | Descripción |
|---|---|---|
name |
string | Nombre de metrica |
value |
number | Valor a agregar |
labels |
table? | Pares clave-valor de etiquetas |
Devuelve: boolean, error
Gauges
Establecer Gauge
metrics.gauge_set("queue_depth", 42, {queue = "emails"})
| Parámetro | Tipo | Descripción |
|---|---|---|
name |
string | Nombre de metrica |
value |
number | Valor actual |
labels |
table? | Pares clave-valor de etiquetas |
Devuelve: boolean, error
Incrementar Gauge
metrics.gauge_inc("connections", {pool = "db"})
| Parámetro | Tipo | Descripción |
|---|---|---|
name |
string | Nombre de metrica |
labels |
table? | Pares clave-valor de etiquetas |
Devuelve: boolean, error
Decrementar Gauge
metrics.gauge_dec("connections", {pool = "db"})
| Parámetro | Tipo | Descripción |
|---|---|---|
name |
string | Nombre de metrica |
labels |
table? | Pares clave-valor de etiquetas |
Devuelve: boolean, error
Histogramas
Registrar Observacion
metrics.histogram("duration_seconds", 0.123, {method = "GET"})
| Parámetro | Tipo | Descripción |
|---|---|---|
name |
string | Nombre de metrica |
value |
number | Valor observado |
labels |
table? | Pares clave-valor de etiquetas |
Devuelve: boolean, error
Errores
| Condición | Tipo | Reintentable |
|---|---|---|
| Colector no disponible | errors.INTERNAL |
no |
Consulte Manejo de Errores para trabajar con errores.