elastic/observability-manage-slos

Que fait observability-manage-slos ?

Créer et gérer des SLO dans Elastic Observability à l'aide de l'API Kibana. Utiliser lors de la définition des SLI, de la configuration des budgets d'erreur ou de la gestion du cycle de vie des SLO.

Aperçu

Cette compétence permet aux agents IA de gérer les Service Level Objectives (SLO) au sein d'Elastic Observability en interagissant directement avec l'API Kibana. Elle prend en charge la création, la mise à jour, la suppression et la consultation des SLO, ce qui en fait un outil précieux pour automatiser les tâches liées à la fiabilité.

Fonctionnalités

• Créer des SLO : Définir de nouveaux SLO avec des SLI personnalisés (par exemple, latence, disponibilité) et des budgets d'erreur.
• Mettre à jour des SLO : Modifier les SLO existants pour ajuster les objectifs, les périodes ou les descriptions.
• Supprimer des SLO : Retirer les SLO qui ne sont plus nécessaires.
• Consulter des SLO : Récupérer la liste des SLO, leurs détails et leurs résumés d'état.
• Gérer le cycle de vie : Activer, désactiver ou archiver des SLO selon les besoins.

Plateformes prises en charge

• Elastic Observability (via l'API Kibana)
• Agents IA : Claude Code, Cursor, Codex, etc.

Comment ça marche

La compétence envoie des requêtes HTTP à l'API REST de Kibana (par exemple, POST /api/observability/slos, GET /api/observability/slos, DELETE /api/observability/slos/{id}). Elle nécessite une authentification appropriée (clé API ou jeton) et des autorisations pour gérer les SLO dans l'espace de travail Elastic.

Exemples d'utilisation

1. Créer un SLO de disponibilité

   curl -X POST "https://votre-cluster.kibana.elastic-cloud.com/api/observability/slos" \
     -H "Content-Type: application/json" \
     -H "Authorization: ApiKey votre-clé-api" \
     -d '{
       "name": "Taux de disponibilité des API",
       "description": "Garantir une disponibilité de 99,9 % pour les points de terminaison critiques",
       "indicator": {
         "type": "availability",
         "params": {
           "filter": "service.name: mon-api"
         }
       },
       "timeWindow": {
         "duration": "7d",
         "type": "rolling"
       },
       "budgetingMethod": "occurrences",
       "objective": {
         "target": 0.999
       }
     }'
   

2. Lister tous les SLO

   curl -X GET "https://votre-cluster.kibana.elastic-cloud.com/api/observability/slos" \
     -H "Authorization: ApiKey votre-clé-api"
   

3. Supprimer un SLO

   curl -X DELETE "https://votre-cluster.kibana.elastic-cloud.com/api/observability/slos/{id-du-slo}" \
     -H "Authorization: ApiKey votre-clé-api"
   

Variables d'environnement

• ELASTIC_KIBANA_URL : URL de l'instance Kibana.
• ELASTIC_API_KEY : Clé API pour l'authentification.

Dépendances

• curl ou toute bibliothèque HTTP (par exemple, requests en Python, fetch en JavaScript) pour interagir avec l'API.
• Accès réseau à l'instance Kibana.

Notes de sécurité

• Ne jamais exposer les clés API dans du code versionné. Utiliser des variables d'environnement ou un gestionnaire de secrets.
• Restreindre les autorisations des clés API au strict nécessaire pour la gestion des SLO.

Ressources

• Documentation de l'API SLO d'Elastic
• Concepts des SLO dans Elastic Observability