Firebase peut envoyer différentes alertes Crashlytics par défaut (consultez la page de présentation des alertes). Firebase propose des intégrations d'alertes de base pour envoyer les alertes Crashlytics par défaut à Slack, Jira et PagerDuty.Crashlytics
Voici comment configurer ces intégrations dans la Firebase console :
Suivez le workflow guidé pour chaque service d'alerte sur la
page Firebase Settings > Integrationsde la console. Sélectionnez la configuration à utiliser pour les applications individuelles et configurez la destination des autres alertes dans la Crashlytics fiche de la
Settings > Alerts page de la Firebase console.
Le reste de cette page explique en détail comment configurer chaque intégration d'alertes de base.
Slack : configurer l'intégration à Slack
Après avoir configuré l'intégration de Firebase à Slack, votre projet peut publier des messages dans votre espace de travail Slack en réponse aux événements signalés par Crashlytics, tels que les problèmes nouveaux, régressifs ou à vitesse croissante.
Étape 1 : Configurer un webhook Slack
Avant de configurer l'intégration dans Firebase, vous devez ajouter un webhook entrant dans Slack pour gérer les communications de Firebase.
Pour savoir comment procéder, consultez la documentation Slack sur l'envoi de messages à l'aide de webhooks entrants.
Étape 2 : Configurer l'intégration de Slack dans la console Firebase
Une fois le webhook approprié configuré, vous pouvez configurer l' intégration pour Crashlytics :
Dans la console Firebase, accédez à la page
Settings > Integrations (Paramètres > Intégrations).Sur la fiche d'intégration Slack, cliquez sur Install (Installer).
Configurez l'intégration en définissant des valeurs dans les champs suivants :
Webhook URL (URL de webhook) : collez l'URL de webhook depuis la page des paramètres Slack.
Default channel (Chaîne par défaut) : saisissez un nom de chaîne. Vous pourrez remplacer cette valeur par défaut ultérieurement pour chaque application ou alerte.
Name of posting user (Nom de l'utilisateur qui publie) : saisissez un nom sous lequel envoyer les messages.
Cliquez sur Verify &save (Vérifier et enregistrer).
Après avoir vérifié et enregistré l'intégration de Slack, un message de confirmation devrait s'afficher dans le canal par défaut que vous avez sélectionné.
Étape 3 : Configurer les paramètres d'alerte pour Slack
Vous pouvez configurer les alertes par application et par type d'événement. Par exemple, vous pouvez désactiver les alertes dans votre application de test ou acheminer les alertes de haute priorité dans votre application de production vers un canal #urgent.
Types d'événement
L'intégration de Firebase à Slack vous permet d'envoyer des alertes en réponse aux types d'événements suivants :
New fatal issues (Nouveaux problèmes fatals) : se déclenche lorsque votre application rencontre un plantage ou une erreur ANR que Crashlytics détecte pour la première fois.
New non-fatal issues (Nouveaux problèmes non fatals) : se déclenche lorsque votre application rencontre un problème non fatal que Crashlytics n'a jamais vu auparavant.
Regressed issues (Problèmes régressifs) : se déclenche lorsque votre application rencontre un plantage que vous aviez précédemment marqué comme résolu.
Trending issues (Problèmes courants) : se déclenche lorsqu'un problème apparaît ou devient courant.
Increasing-velocity issues (Problèmes à vitesse croissante) : se déclenche lorsqu'un même type de plantage ou d'erreur ANR touche un certain pourcentage d'utilisateurs dans un délai de 30 minutes pour une version d'application donnée.
Configurer les paramètres pour chaque application
Voici comment configurer les alertes pour chaque application de votre projet Firebase :
Dans la console Firebase, accédez à la page
Settings > Alerts (Paramètres > Alertes).Accédez à la fiche d'alertes Crashlytics. Sélectionnez l'application que vous souhaitez configurer dans le menu déroulant.
Sélectionnez le canal Slack dans lequel vous souhaitez envoyer les alertes pour cette application.
Pour chaque type d'alerte, sélectionnez dans le menu déroulant si vous souhaitez envoyer ce type d'alerte à Slack.
Répétez ces étapes pour chaque application que vous souhaitez configurer.
Et voilà ! Firebase enverra des alertes aux canaux Slack que vous avez spécifiés si vos applications rencontrent des problèmes nouveaux, régressifs ou à vitesse croissante.
Jira : configurer l'intégration à Jira
Après avoir configuré l'intégration de Firebase à Jira, votre projet Firebase peut publier des messages dans un projet Jira en réponse aux événements signalés par Crashlytics, tels que les problèmes nouveaux, régressifs ou à vitesse croissante. Vous pouvez également associer des problèmes individuels Crashlytics à des problèmes Jira.
Étape 1 : Préparer Jira pour l'intégration à Firebase
Créer un jeton d'API (Jira Cloud uniquement)
Avant de configurer l'intégration dans Firebase, vous devez générer un jeton d'API dans Jira Cloud.
Dans la console Jira, ouvrez les paramètres des jetons d'API.
Cliquez sur Create API token (Créer un jeton d'API).
Enregistrez ce jeton d'API dans un endroit sûr, car vous en aurez besoin ultérieurement.
Créer un type de problème "Bug"
L'intégration de Firebase à Jira crée des problèmes de type Bug. Vous devez créer ce type de problème dans votre projet Jira (s'il n'existe pas déjà).
Dans la console Jira, accédez à Project Settings (Paramètres du projet).
Cliquez sur Issue types (Types de problème).
Cliquez sur Add issue type (Ajouter un type de problème).
Sélectionnez "Bug" ou saisissez-le manuellement.
Étape 2 : Configurer l'intégration de Jira dans la console Firebase
Configurez votre intégration Jira pour Jira Cloud ou Jira Server.
Jira Cloud
Dans la console Firebase, accédez à la page
Settings > Integrations (Paramètres > Intégrations).Sur la fiche d'intégration Jira, cliquez sur Install (Installer).
Cliquez sur Set up Jira integration (Configurer l'intégration de Jira).
Saisissez l'URL de votre projet Jira au format suivant :
https://WORKSPACE_NAME.atlassian.net/projects/PROJECT_KEYSaisissez votre adresse e-mail de connexion Jira et votre jeton d'API.
Cliquez sur Verify &save (Vérifier et enregistrer).
Jira Server
Dans la console Firebase, accédez à la page
Settings > Integrations (Paramètres > Intégrations).Sur la fiche d'intégration Jira, cliquez sur Install (Installer).
Cliquez sur Set up Jira integration (Configurer l'intégration de Jira).
Saisissez l'URL de votre projet Jira au format suivant :
https://SERVER_NAME.com/projects/PROJECT_KEYSaisissez votre adresse e-mail de connexion Jira et votre jeton d'API.
Cliquez sur Verify &save (Vérifier et enregistrer).
Étape 3 : Configurer les paramètres d'alerte pour Jira
Vous pouvez configurer les alertes par application et par type d'événement. Par exemple, vous pouvez désactiver les alertes dans votre application de test ou acheminer les alertes concernant différentes applications vers différents projets Jira.
Types d'événement
L'intégration de Firebase à Jira vous permet d'envoyer des alertes en réponse aux types d'événements suivants :
New fatal issues (Nouveaux problèmes fatals) : se déclenche lorsque votre application rencontre un plantage ou une erreur ANR que Crashlytics détecte pour la première fois.
New non-fatal issues (Nouveaux problèmes non fatals) : se déclenche lorsque votre application rencontre un problème non fatal que Crashlytics n'a jamais vu auparavant.
Regressed issues (Problèmes régressifs) : se déclenche lorsque votre application rencontre un plantage que vous aviez précédemment marqué comme résolu.
Trending issues (Problèmes courants) : se déclenche lorsqu'un problème apparaît ou devient courant.
Increasing-velocity issues (Problèmes à vitesse croissante) : se déclenche lorsqu'un même type de plantage ou d'erreur ANR touche un certain pourcentage d'utilisateurs dans un délai de 30 minutes pour une version d'application donnée.
Configurer les paramètres pour chaque application
Voici comment configurer les alertes pour chaque application de votre projet Firebase :
Dans la console Firebase, accédez à la page
Settings > Alerts (Paramètres > Alertes).Accédez à la fiche d'alertes Crashlytics. Sélectionnez l'application que vous souhaitez configurer dans le menu déroulant.
Sélectionnez le projet Jira dans lequel vous souhaitez envoyer les alertes pour cette application.
Pour chaque type d'alerte, sélectionnez dans le menu déroulant si vous souhaitez envoyer ce type d'alerte à Jira.
Répétez ces étapes pour chaque application que vous souhaitez configurer.
Et voilà ! Firebase enverra des alertes aux projets Jira que vous avez spécifiés si vos applications rencontrent des problèmes nouveaux, régressifs ou à vitesse croissante.
(Facultatif) Associer des problèmes Crashlytics et des problèmes Jira
En plus des problèmes Jira créés automatiquement par Firebase, il est possible d'associer vos Crashlytics problèmes à des problèmes Jira existants. Vous pouvez également créer un problème Jira à partir de la Firebase console. Vous devez activer l'intégration de Jira avant d'utiliser cette fonctionnalité.
Accédez au problème Crashlytics que vous souhaitez associer à un problème Jira.
Cliquez sur Link to Jira (Associer à Jira).
Cliquez sur Create issue in Project (Créer un problème dans le projet) ou collez l'URL ou la clé de votre problème Jira dans le champ fourni.
Dissocier un problème Crashlytics d'un problème Jira
Accédez au problème Crashlytics que vous souhaitez dissocier de Jira.
Cliquez sur Linked Issue (Problème associé).
Cliquez sur More (Plus), puis sélectionnez Unlink (Dissocier).
PagerDuty : configurer l'intégration à PagerDuty
Après avoir configuré l'intégration de Firebase à PagerDuty, votre projet Firebase permet à PagerDuty de contacter vos intervenants de garde en réponse aux événements signalés par Crashlytics, tels que les problèmes nouveaux, régressifs ou à vitesse croissante.
Étape 1 : Configurer l'intégration de PagerDuty dans la console Firebase
Dans la console Firebase, accédez à la page
Settings > Integrations (Paramètres > Intégrations).Sur la fiche d'intégration PagerDuty, cliquez sur Install (Installer).
Suivez les instructions à l'écran pour configurer l'intégration.
Cliquez sur Verify &save (Vérifier et enregistrer).
Étape 2 : Configurer les paramètres d'alerte pour PagerDuty
Vous pouvez configurer les alertes par application et par type d'événement. Par exemple, vous pouvez désactiver les alertes dans votre application de test ou acheminer les alertes concernant différentes applications vers différents projets PagerDuty.
Types d'événement
L'intégration de Firebase à PagerDuty vous permet d'envoyer des alertes en réponse aux types d'événements suivants :
New fatal issues (Nouveaux problèmes fatals) : se déclenche lorsque votre application rencontre un plantage ou une erreur ANR que Crashlytics détecte pour la première fois.
New non-fatal issues (Nouveaux problèmes non fatals) : se déclenche lorsque votre application rencontre un problème non fatal que Crashlytics n'a jamais vu auparavant.
Regressed issues (Problèmes régressifs) : se déclenche lorsque votre application rencontre un plantage que vous aviez précédemment marqué comme résolu.
Trending issues (Problèmes courants) : se déclenche lorsqu'un problème apparaît ou devient courant.
Increasing-velocity issues (Problèmes à vitesse croissante) : se déclenche lorsqu'un même type de plantage ou d'erreur ANR touche un certain pourcentage d'utilisateurs dans un délai de 30 minutes pour une version d'application donnée.
Configurer les paramètres pour chaque application
Voici comment configurer les alertes pour chaque application de votre projet Firebase :
Dans la console Firebase, accédez à la page
Settings > Alerts (Paramètres > Alertes).Accédez à la fiche d'alertes Crashlytics. Sélectionnez l'application que vous souhaitez configurer dans le menu déroulant.
Sélectionnez le service PagerDuty dans lequel vous souhaitez envoyer les alertes pour cette application.
Pour chaque type d'alerte, sélectionnez dans le menu déroulant si vous souhaitez envoyer ce type d'alerte à PagerDuty.
Répétez ces étapes pour chaque application que vous souhaitez configurer.
Et voilà ! Firebase publiera des bugs dans le service PagerDuty que vous avez spécifié si vos applications rencontrent des problèmes nouveaux, régressifs ou à vitesse croissante.