Firebase propose des intégrations d'alertes de base pour envoyer des alertes Crashlytics à Slack, Jira et PagerDuty.
Voici comment configurer ces intégrations dans la console Firebase :
Suivez le workflow guidé pour chaque service dans l'onglet Intégrations de vos
Paramètres du projet .Sélectionnez la configuration à utiliser pour chaque application et configurez la destination des autres alertes sur la fiche Crashlytics de l'onglet Alertes dans vos
Paramètres du projet .
Le reste de cette page décrit en détail comment configurer chaque intégration d'alerte de base.
Configurer l'intégration de base avec 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, comme les problèmes nouveaux, régressifs ou dont la vélocité augmente.
Étape 1 : Configurez 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 : Configurez l'intégration 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.
Sur la fiche d'intégration Slack, cliquez sur Installer.
Configurez l'intégration en définissant des valeurs dans les champs suivants :
URL du webhook : collez l'URL du webhook depuis la page des paramètres Slack.
Canal par défaut : saisissez le nom d'un canal. Vous pourrez remplacer cette valeur par défaut ultérieurement pour chaque application ou alerte.
Nom de l'utilisateur qui publie : saisissez un nom sous lequel envoyer les messages.
Cliquez sur Valider et enregistrer.
Après avoir vérifié et enregistré l'intégration Slack, un message de confirmation devrait s'afficher dans le canal par défaut que vous avez sélectionné.
Étape 3 : Configurez les paramètres d'alerte pour Slack
Vous pouvez configurer des alertes par application et par type d'événement. Par exemple, vous pouvez désactiver les alertes dans votre application de test ou rediriger 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 :
Nouveaux problèmes critiques : se déclenchent lorsque votre application rencontre un plantage ou une erreur ANR que Crashlytics détecte pour la première fois.
Nouvelles erreurs non fatales : se déclenchent lorsque votre application rencontre une erreur non fatale que Crashlytics détecte pour la première fois.
Problèmes régression : se déclenchent lorsque votre application rencontre un plantage que vous aviez précédemment marqué comme résolu.
Problèmes courants : déclenchés lorsqu'un problème apparaît ou devient courant.
Problèmes de vélocité croissante : déclenchés lorsqu'un même type de plantage ou d'erreur ANR affecte un pourcentage d'utilisateurs au cours d'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 sur lequel vous souhaitez envoyer les alertes pour cette application.
Pour chaque type d'alerte, sélectionnez dans le menu déroulant si vous souhaitez l'envoyer à 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 présentent de nouveaux problèmes, des régressions ou des problèmes de vitesse croissante.
Configurer l'intégration de base avec Jira
Après avoir configuré l'intégration de Firebase à Jira, votre projet Firebase peut publier des informations dans un projet Jira en réponse aux événements signalés par Crashlytics, comme les problèmes nouveaux, régressés ou dont la vélocité augmente. Vous pouvez également associer des problèmes Crashlytics individuels à 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 API dans un endroit sûr, car vous en aurez besoin plus tard.
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 Types de problèmes.
Cliquez sur Ajouter un type de problème.
Sélectionnez "Bug" ou saisissez-le manuellement.
Étape 2 : Configurez l'intégration Jira dans la console Firebase
Configurez votre intégration Jira pour Jira Cloud ou 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.
Sur la fiche d'intégration Jira, cliquez sur Installer.
Cliquez sur Configurer l'intégration dans 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.
Sur la fiche d'intégration Jira, cliquez sur Installer.
Cliquez sur Configurer l'intégration dans 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 : Configurez les paramètres d'alerte pour Jira
Vous pouvez configurer des alertes par application et par type d'événement. Par exemple, vous pouvez désactiver les alertes dans votre application de test ou les rediriger vers différents projets Jira en fonction des applications.
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 :
Nouveaux problèmes critiques : se déclenchent lorsque votre application rencontre un plantage ou une erreur ANR que Crashlytics détecte pour la première fois.
Nouvelles erreurs non fatales : se déclenchent lorsque votre application rencontre une erreur non fatale que Crashlytics détecte pour la première fois.
Problèmes régression : se déclenchent lorsque votre application rencontre un plantage que vous aviez précédemment marqué comme résolu.
Problèmes courants : déclenchés lorsqu'un problème apparaît ou devient courant.
Problèmes de vélocité croissante : déclenchés lorsqu'un même type de plantage ou d'erreur ANR affecte un pourcentage d'utilisateurs au cours d'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 l'envoyer à Jira.
Répétez ces étapes pour chaque application que vous souhaitez configurer.
Et voilà ! Firebase enverra des alertes à vos projets Jira spécifiés si vos applications présentent de nouveaux problèmes, des régressions ou des problèmes de vitesse croissante.
(Facultatif) Associer les problèmes Crashlytics et les problèmes Jira
En plus des problèmes Jira créés automatiquement par Firebase, il est possible d'associer vos problèmes Crashlytics à des problèmes Jira existants. Vous pouvez également créer un problème Jira à partir de la console Firebase. Vous devez activer l'intégration 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é du 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.
Configurer l'intégration de base avec PagerDuty
Après avoir configuré l'intégration de Firebase à PagerDuty, votre projet Firebase permet à PagerDuty de contacter vos responsables d'astreinte en réponse aux événements signalés par Crashlytics, comme les problèmes nouveaux, régressés ou dont la vélocité augmente.
Étape 1 : Configurez l'intégration 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.
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 : Configurez les paramètres d'alerte pour PagerDuty
Vous pouvez configurer des alertes par application et par type d'événement. Par exemple, vous pouvez désactiver les alertes dans votre application de test ou les acheminer vers différents projets PagerDuty en fonction des applications.
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 :
Nouveaux problèmes critiques : se déclenchent lorsque votre application rencontre un plantage ou une erreur ANR que Crashlytics détecte pour la première fois.
Nouvelles erreurs non fatales : se déclenchent lorsque votre application rencontre une erreur non fatale que Crashlytics détecte pour la première fois.
Problèmes régression : se déclenchent lorsque votre application rencontre un plantage que vous aviez précédemment marqué comme résolu.
Problèmes courants : déclenchés lorsqu'un problème apparaît ou devient courant.
Problèmes de vélocité croissante : déclenchés lorsqu'un même type de plantage ou d'erreur ANR affecte un pourcentage d'utilisateurs au cours d'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 sur 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 les bugs sur le service PagerDuty que vous avez spécifié si vos applications présentent de nouveaux problèmes, des régressions ou des problèmes de vitesse croissante.