Firebase peut envoyer diverses alertes Crashlytics par défaut (consultez la page 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
De manière générale, voici comment configurer ces intégrations dans la Firebase console :
Suivez le workflow guidé pour chaque service dans l' onglet Intégrations de vos
Paramètres du projet .Sélectionnez la configuration à utiliser pour les applications individuelles et configurez la destination des autres alertes sur la fiche Crashlytics de l' onglet Alertes de vos
Paramètres du projet .
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 :
Connectez-vous à la console Firebase, puis sélectionnez votre projet.
Cliquez sur , puis sélectionnez Paramètres du projet.
Sélectionnez l'onglet Intégrations tab.
Sur la fiche d'intégration Slack, cliquez sur Installer.
Configurez l'intégration en définissant des valeurs dans les champs suivants :
Webhook URL (URL du webhook) : collez l'URL du webhook depuis la page des paramètres Slack.
Default channel (Canal par défaut) : saisissez un nom de canal. 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 Valider et enregistrer.
Une fois l'intégration de Slack validée et enregistrée, un message de confirmation s'affiche 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 (Nouvelles erreurs non fatales) : se déclenche lorsque votre application rencontre une erreur non fatale que Crashlytics détecte pour la première fois.
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 sur une période 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 :
Connectez-vous à la console Firebase, puis sélectionnez votre projet.
Cliquez sur , puis sélectionnez Paramètres du projet.
Sélectionnez l'onglet 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 pour Jira Server.
Jira Cloud
Connectez-vous à la console Firebase, puis sélectionnez votre projet.
Cliquez sur , puis sélectionnez Paramètres du projet.
Sélectionnez l'onglet Intégrations tab.
Sur la fiche d'intégration Jira, cliquez sur 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 Valider et enregistrer.
Jira Server
Connectez-vous à la console Firebase, puis sélectionnez votre projet.
Cliquez sur , puis sélectionnez Paramètres du projet.
Sélectionnez l'onglet Intégrations tab.
Sur la fiche d'intégration Jira, cliquez sur 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 Valider 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 (Nouvelles erreurs non fatales) : se déclenche lorsque votre application rencontre une erreur non fatale que Crashlytics détecte pour la première fois.
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 sur une période 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 :
Connectez-vous à la console Firebase, puis sélectionnez votre projet.
Cliquez sur , puis sélectionnez Paramètres du projet.
Sélectionnez l'onglet 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 Associer à Jira.
Cliquez sur Créer un problème dans le projet ou collez l'URL ou la clé de votre problème Jira dans le champ prévu à cet effet.
Dissocier un problème Crashlytics d'un problème Jira
Accédez au problème Crashlytics que vous souhaitez dissocier de Jira.
Cliquez sur Problème associé.
Cliquez sur Plus, puis sélectionnez 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
Connectez-vous à la console Firebase, puis sélectionnez votre projet.
Cliquez sur , puis sélectionnez Paramètres du projet.
Sélectionnez l'onglet Intégrations tab.
Sur la fiche d'intégration PagerDuty, cliquez sur Installer.
Suivez les instructions à l'écran pour configurer l'intégration.
Cliquez sur Valider 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 (Nouvelles erreurs non fatales) : se déclenche lorsque votre application rencontre une erreur non fatale que Crashlytics détecte pour la première fois.
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 sur une période 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 :
Connectez-vous à la console Firebase, puis sélectionnez votre projet.
Cliquez sur , puis sélectionnez Paramètres du projet.
Sélectionnez l'onglet 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.