ktm metrics alert-eval

Évaluer des métriques par rapport à des règles d'alerte

Évaluer des métriques par rapport à des règles d'alerte

Utilisation

ktm metrics alert-eval [flags]

Exemples

# Inline rules
ktm metrics alert-eval --operator acme   --query "SELECT mean(duration_seconds) FROM test WHERE time > now() - 7d GROUP BY time(1h)"   --rules '[{"type":"threshold","metric":"p95","operator":">","value":5}]'

# Rules from file
ktm metrics alert-eval --operator acme   --query "SELECT mean(duration_seconds) FROM test WHERE time > now() - 7d GROUP BY time(1h)"   --rules-file rules.json

Flags

FlagTypeDéfautDescription
--operatorstringSlug de l'opérateur (= nom de base de données InfluxDB)
--precisionstringPrécision temporelle de la requête (s, ms, u, ns)
--querystringChaîne de requête InfluxQL
--rulesstringTableau JSON de règles d'alerte en ligne
--rules-filestringChemin vers un fichier JSON avec le tableau de règles d'alerte

Détails

Évaluer des métriques InfluxDB par rapport à des règles d'alerte sans Kapacitor.

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, calcule des statistiques, puis vérifie chaque règle.

8 types de règles :

  • threshold : vérifier une métrique par rapport à une valeur (opérateurs : >, <, >=, <=, ==, !=)
  • level_shift : détecter des changements significatifs de moyenne (filtre optionnel min_shift_pct)
  • missing_data : vérifier les lacunes dans les séries temporelles (max_gaps, défaut 0)
  • flatline : détecter les valeurs bloquées (max_flatline_len, défaut 3)
  • rate_change : détecter les pics ou taux excessifs (max_spikes défaut 0, max_abs_rate)
  • outlier : vérifier le pourcentage de valeurs aberrantes (max_outlier_pct, défaut 5.0)
  • counter_reset : détecter les diminutions de compteurs (max_resets, défaut 0)
  • anomaly : détecter les dépassements soutenus de résidus EWMA (sensitivity 1-5, sustained_periods défaut 3)

Fournissez les règles via --rules (JSON en ligne) ou --rules-file (chemin vers un fichier JSON). Workflow SRE typique : metrics query (explorer les données) puis metrics alert-eval (vérifier les règles).

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