ktm metrics slo

Calculer les métriques SLI/SLO selon la méthodologie burn-rate de Google SRE

Calculer les métriques SLI/SLO selon la méthodologie burn-rate de Google SRE

Utilisation

ktm metrics slo [flags]

Exemples

# Compute SLO for 99.9% target over 30-day window
ktm metrics slo --operator acme   --query "SELECT sum(good) AS good, sum(total) AS total FROM test WHERE time > now() - 30d"   --slo-target 99.9

# Custom field names and 7-day window
ktm metrics slo --operator acme   --query "SELECT sum(success) AS ok, sum(requests) AS all_req FROM api WHERE time > now() - 7d"   --slo-target 99.5 --good-field ok --total-field all_req --window 7d

Flags

FlagTypeDéfautDescription
--good-fieldstringgoodNom du field pour les événements réussis
--operatorstringSlug de l'opérateur (= nom de base de données InfluxDB)
--precisionstringPrécision temporelle de la requête (s, ms, u, ns)
--querystringRequête InfluxQL retournant les fields good/total
--slo-targetfloatCible SLO en pourcentage (ex. 99.9)
--total-fieldstringtotalNom du field pour le total des événements
--windowstring30dFenêtre SLO (ex. 30d, 168h)

Détails

Calculer les métriques SLI/SLO à partir des résultats de requêtes InfluxDB.

Prérequis : Découvrez d'abord les measurements et fields disponibles avec 'metrics query --operator <slug> --query "SHOW MEASUREMENTS"' et 'metrics query --operator <slug> --query "SHOW FIELD KEYS FROM <measurement>"'. N'inventez pas de noms de measurement ou de field.

Exécute une requête InfluxQL qui retourne les compteurs d'événements réussis et totaux (ex. SELECT sum(good) AS good, sum(total) AS total FROM ...). L'outil extrait les fields good/total, calcule le SLI, le budget d'erreur, le taux de consommation et la sévérité.

Seuils de sévérité (Google SRE) :

  • critical : burn rate > 14.4x (alerte immédiate)
  • red : burn rate > 6x (créer un ticket)
  • yellow : burn rate > 1x (SLO à risque)
  • green : burn rate <= 1x (dans le budget)

Voir aussi

Les flags globaux (--output, --debug, --host, ...) s'appliquent à toutes les commandes. Voir la présentation de la référence des commandes.

Et ensuite ?

Toutes les commandes

Parcourir la référence complète du CLI.

Premiers pas

Installer le CLI et s'authentifier.

Last updated on