Metriken & Telemetrie
Erfassen Sie Anwendungsmetriken mit Countern, Gauges und Histogrammen.
Laden
local metrics = require("metrics")
Counter
Counter inkrementieren
metrics.counter_inc("requests_total", {method = "POST"})
| Parameter | Typ | Beschreibung |
|---|---|---|
name |
string | Metrik-Name |
labels |
table? | Label-Schlüssel-Wert-Paare |
Gibt zurück: boolean, error
Zu Counter addieren
metrics.counter_add("bytes_total", 1024, {direction = "out"})
| Parameter | Typ | Beschreibung |
|---|---|---|
name |
string | Metrik-Name |
value |
number | Zu addierender Wert |
labels |
table? | Label-Schlüssel-Wert-Paare |
Gibt zurück: boolean, error
Gauges
Gauge setzen
metrics.gauge_set("queue_depth", 42, {queue = "emails"})
| Parameter | Typ | Beschreibung |
|---|---|---|
name |
string | Metrik-Name |
value |
number | Aktueller Wert |
labels |
table? | Label-Schlüssel-Wert-Paare |
Gibt zurück: boolean, error
Gauge inkrementieren
metrics.gauge_inc("connections", {pool = "db"})
| Parameter | Typ | Beschreibung |
|---|---|---|
name |
string | Metrik-Name |
labels |
table? | Label-Schlüssel-Wert-Paare |
Gibt zurück: boolean, error
Gauge dekrementieren
metrics.gauge_dec("connections", {pool = "db"})
| Parameter | Typ | Beschreibung |
|---|---|---|
name |
string | Metrik-Name |
labels |
table? | Label-Schlüssel-Wert-Paare |
Gibt zurück: boolean, error
Histogramme
Beobachtung aufzeichnen
metrics.histogram("duration_seconds", 0.123, {method = "GET"})
| Parameter | Typ | Beschreibung |
|---|---|---|
name |
string | Metrik-Name |
value |
number | Beobachteter Wert |
labels |
table? | Label-Schlüssel-Wert-Paare |
Gibt zurück: boolean, error
Fehler
| Bedingung | Art | Wiederholbar |
|---|---|---|
| Collector nicht verfügbar | errors.INTERNAL |
nein |
Siehe Fehlerbehandlung für die Arbeit mit Fehlern.