Skip to main content
Devin Oncall examine, corrige et atténue vos alertes, vos bugs et vos incidents, et vous fournit des analyses exploitables issues de votre Oncall. Devin se met au travail dès qu’une alerte, un rapport de bogue ou un incident se déclenche. Il s’appuie sur votre télémétrie, votre code, vos déploiements, vos runbooks et vos incidents passés pour identifier la cause racine, remédier au problème et ouvrir une PR de correctif. Oncall comprend trois produits :
  • Répondeurs : examinent et corrigent les alertes, les rapports de bogue et les questions de support dès leur arrivée.
  • Incidents : identifient la cause racine, atténuent l’impact et mènent chaque incident jusqu’à sa résolution.
  • Rapports : vous aident à exploiter les analyses sur l’origine de vos alertes, bugs et incidents, par exemple les seuils d’alerte à ajuster ou les catégories de problèmes récurrents à corriger.

Configuration

Oncall nécessite une configuration ponctuelle par organisation. Pendant la configuration, Devin apprend le fonctionnement de vos systèmes à partir de vos outils de télémétrie et de votre code, puis rédige des skills qu’utilise chaque session Oncall.
  1. Ouvrez Oncall dans la barre latérale et cliquez sur Begin setup.
  2. Connectez au moins un outil de télémétrie. Vous pouvez ignorer cette étape si un outil de télémétrie est déjà disponible dans l’environnement de Devin.
  3. Cliquez sur Finish. Devin commence à apprendre le fonctionnement de vos systèmes, ce qui prend généralement 1 à 2 heures. Vous recevez une notification dès qu’Oncall est prêt.
Les sections Répondeurs, Incidents et Reports sont accessibles une fois la configuration terminée.
La configuration nécessite l’autorisation de gérer Oncall. Seuls les administrateurs de l’organisation peuvent connecter des outils pour l’ensemble de l’organisation.

Paramètres d’Oncall

L’icône d’engrenage dans l’en-tête d’Oncall donne accès aux paramètres partagés par toutes les sessions Oncall :
  • Instructions : les consignes suivies par chaque session Oncall, rédigées en markdown. Voyez-les comme un AGENTS.md propre à Oncall.
  • Skills : les skills que Devin a générées à propos de vos systèmes lors de la configuration. Réglez Skill update frequency sur Weekly ou Monthly pour les tenir à jour, ou cliquez sur Update skills now.

Répondeurs

Un répondeur surveille une source d’alertes ou de rapports et confie à Devin l’investigation de chaque nouvel événement. Devin regroupe les événements récurrents en un seul problème : une alerte trop fréquente ne fait ainsi l’objet que d’une seule investigation. Utilisez les répondeurs pour :
  • Les alertes de production publiées dans un canal Slack ou Microsoft Teams par vos outils de surveillance.
  • Les incidents PagerDuty, pour lesquels Devin publie son investigation sous forme de notes d’incident.
  • Les rapports de bogue et les questions de support publiés dans un canal comme #eng-bugs.

Créer un répondeur

  1. Sur la page Oncall, cliquez sur Create répondeur.
  2. Saisissez un Name, puis choisissez le type de répondeur. Le type ne pourra plus être modifié après la création.
  3. Ajoutez un ou plusieurs Déclencheurs.
  4. Si vous le souhaitez, ajustez les paramètres de session, les connecteurs et le runbook.
  5. Cliquez sur Create répondeur.
Le runbook est facultatif. Devin Oncall sait déjà examiner les alertes et les bugs : n’en ajoutez un que pour les étapes propres à votre équipe.

Types de répondeurs

Les alertes et les rapports de bogue ne se traitent pas de la même manière : chaque type de répondeur exécute donc un flux qui lui est propre. Le type détermine également la façon dont les problèmes du répondeur sont suivis sur son tableau.

Déclencheurs

Un répondeur surveille une seule intégration à la fois et peut avoir jusqu’à 10 déclencheurs. Devin intervient dès que l’un d’eux correspond. Ajoutez des conditions à un déclencheur pour restreindre les événements auxquels Devin répond.

Paramètres du répondeur

Incidents

Incidents est conçu pour les équipes qui créent un canal Slack dédié à chaque incident. Devin rejoint le canal, identifie une cause racine probable, recommande des mesures d’atténuation et poursuit son analyse au fil de l’évolution de l’incident. Il publie des mises à jour, répond aux questions dans les fils de discussion et tient à jour un rapport d’incident.

Activer les incidents

  1. Sur la page Oncall, ouvrez l’onglet Incidents et cliquez sur Enable incidents.
  2. Activez Enable incidents.
  3. Dans Slack channel prefix, indiquez le préfixe utilisé par vos canaux d’incident, par exemple incident-.
  4. Choisissez un mode de réponse, puis enregistrez.
Devin lance une investigation dès qu’il rejoint un canal Slack dont le nom commence par ce préfixe. Invitez Devin dans le canal ou activez Rejoindre automatiquement les canaux d’incident.
Pour utiliser les incidents, Slack doit être connecté à votre organisation. Au sein d’une Enterprise, les incidents ne peuvent être activés que pour une seule organisation à la fois.

Modes de réponse

Paramètres des incidents

L’onglet Incidents répertorie chaque incident avec un lien vers sa session. Utilisez Stop pour mettre fin à l’intervention de Devin sur un incident, et Resume pour le faire intervenir de nouveau.

Rapports

Un rapport vous fournit, selon une planification récurrente, des analyses exploitables issues de votre astreinte : seuils d’alerte à ajuster, catégories de problèmes récurrents à corriger, et causes de vos alertes, bugs et incidents. Chaque rapport résume également les problèmes identifiés et corrigés, les incidents examinés, ainsi que les PR ouvertes et fusionnées par Devin. Utilisez les rapports pour le transfert hebdomadaire de l’astreinte, ou limitez leur périmètre à votre équipe, par exemple Billing ou Infrastructure.

Créer un rapport

  1. Sur la page Oncall, ouvrez l’onglet Reports et cliquez sur Create report.
  2. Saisissez un Name.
  3. Sous Répondeurs match, choisissez les répondeurs couverts par le rapport, soit en les sélectionnant individuellement, soit à l’aide de métadonnées.
  4. Sous Incidents match, décrivez les incidents à inclure dans le rapport. Laissez ce champ vide pour exclure les incidents.
  5. Définissez la Schedule et, facultativement, ajoutez des Instructions précisant ce que le rapport doit contenir.
  6. Sous Notifications, choisissez le canal Slack ou Microsoft Teams dans lequel publier le rapport.
  7. Cliquez sur Create report.
Les rapports étant partagés, ils s’exécutent en tant qu’utilisateur de service et non au nom d’une personne. Ouvrez un rapport pour consulter ses exécutions précédentes, ou cliquez sur Generate report pour le générer immédiatement.