Sentry (Observabilité en lecture seule)

Démarrage rapide

Si l'utilisateur n'est pas authentifié, demande-lui d'exécuter sentry auth login ou de définir SENTRY_AUTH_TOKEN comme variable d'environnement.
La CLI détecte automatiquement org/project à partir des DSN dans les fichiers .env, le code source, les configurations par défaut et les noms de répertoires. Spécifie <org>/<project> uniquement si la détection automatique échoue ou sélectionne la mauvaise cible.
Defaults : plage horaire 24h, environnement production, limite 20.
Utilise toujours --json lors du traitement programmatique de la sortie. Utilise --json --fields pour sélectionner des champs spécifiques et réduire la taille de la sortie.
Utilise sentry schema <resource> pour découvrir rapidement les endpoints API.

Si la CLI n'est pas installée, donne à l'utilisateur ces étapes :

Installe la Sentry CLI : curl https://cli.sentry.dev/install -fsS | bash
Authentifie-toi : sentry auth login
Confirme l'authentification : sentry auth status

Ne demande jamais à l'utilisateur de coller le token complet dans le chat. Demande-lui de le définir localement et confirme quand il est prêt.

Tâches principales (utilise Sentry CLI)

Utilise la CLI sentry pour toutes les requêtes. Elle gère automatiquement l'authentification, la détection org/project, la pagination et les relances. Utilise --json pour une sortie lisible par machine.

1) Lister les problèmes (ordonnés par les plus récents)

sentry issue list \
  --query "is:unresolved environment:production" \
  --period 24h \
  --limit 20 \
  --json --fields shortId,title,priority,level,status

Si la détection automatique ne résout pas org/project, passe-les explicitement :

sentry issue list {your-org}/{your-project} \
  --query "is:unresolved environment:production" \
  --period 24h \
  --limit 20 \
  --json

2) Résoudre un ID court de problème en détail du problème

sentry issue view {ABC-123} --json

Utilise le format ID court (par exemple, ABC-123), pas l'ID numérique.

3) Détail du problème

sentry issue view {ABC-123}

4) Événements du problème

sentry issue events {ABC-123} --limit 20 --json

5) Détail de l'événement

sentry event view {your-org}/{your-project}/{event_id} --json

6) Analyse des causes racines alimentée par l'IA

sentry issue explain {ABC-123}

7) Plan de correction alimenté par l'IA

sentry issue plan {ABC-123}

Recours : accès API arbitraire

Pour les endpoints non couverts par des commandes CLI dédiées, utilise sentry api :

sentry api /api/0/organizations/{your-org}/ --method GET

Utilise sentry schema pour découvrir les endpoints API disponibles :

sentry schema issues

Entrées et defaults

org_slug, project_slug : détectés automatiquement par la CLI à partir des DSN, variables d'environnement et noms de répertoires. Remplace par {your-org}/{your-project} si la détection automatique échoue.
time_range : default 24h (passe en tant que --period 24h).
environment : default prod (passe comme partie de --query, par exemple, environment:production).
limit : default 20 (passe en tant que --limit).
search_query : paramètre --query optionnel, utilise la syntaxe de recherche Sentry (par exemple, is:unresolved, assigned:me).
issue_short_id : utilise directement avec sentry issue view.

Règles de formatage de la sortie

Liste de problèmes : affiche title, short_id, status, first_seen, last_seen, count, environments, top_tags ; ordonne par les plus récents.
Détail de l'événement : inclut culprit, timestamp, environment, release, url.
S'il n'y a aucun résultat, indique-le explicitement.
Masque les PII dans la sortie (emails, IPs). N'imprime pas les stack traces brutes.
Ne retransmets jamais les tokens d'authentification.

Entrées de test de référence

Org : {your-org}
Project : {your-project}
ID court du problème : {ABC-123}

Exemple de prompt : « Liste les 10 premiers problèmes ouverts pour prod au cours des 24 dernières heures. » Résultat attendu : liste ordonnée avec titres, ID courts, comptages, dernier affichage.