Ce document explique comment configurer des canaux de notification à l'aide de la console Google Cloud . Cloud Monitoring utilise ces canaux pour vous avertir, vous ou votre équipe d'astreinte, lorsqu'une règle d'alerte est déclenchée. Lorsque vous créez une règle d'alerte, vous sélectionnez les destinataires des notifications en choisissant des canaux de notification configurés dans la liste. Par exemple, vous pouvez configurer des règles d'alerte qui surveillent les instances Compute Engine pour qu'elles publient des données sur un sujet Pub/Sub et qu'elles envoient une notification au canal Slack de l'équipe d'astreinte.
Pour en savoir plus, consultez Latence des notifications et Quand Monitoring envoie des notifications et crée des alertes.
Ce document explique comment utiliser la console Google Cloud . Si vous utilisez l'API Cloud Monitoring, consultez Créer et gérer des canaux de notification à l'aide de l'API.
Cette fonctionnalité n'est disponible que pour les projets Google Cloud . Pour les configurations App Hub, sélectionnez le projet hôte App Hub ou le projet de gestion.
Avant de commencer
Pour obtenir les autorisations nécessaires pour afficher et configurer des canaux de notification à l'aide de la console Google Cloud , demandez à votre administrateur de vous accorder le rôle IAM Éditeur Monitoring (roles/monitoring.editor) sur votre projet.
Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.
Vous pouvez également obtenir les autorisations requises avec des rôles personnalisés ou d'autres rôles prédéfinis.
Pour en savoir plus sur les rôles Cloud Monitoring, consultez Contrôler l'accès avec Identity and Access Management.
Décider des canaux de notification à créer
Dans un souci de redondance, nous vous recommandons de créer plusieurs types de canaux de notification pour les raisons suivantes :
- Google Cloud n'a aucun contrôle sur un grand nombre de systèmes de livraison après leur avoir transmis une notification.
- L'Cloud Mobile App, PagerDuty, les webhooks et les notifications Slack sont tous alimentés par le même service interne Google Cloud . Ils partagent donc un point de défaillance unique. Si vous utilisez l'un de ces canaux de notification, utilisez des e-mails ou Pub/Sub comme canal redondant.
- Les SMS ne sont pas un type de canal de notification entièrement fiable. De plus, il est possible qu'ils ne soient pas disponibles dans certaines régions. Chaque fois que vous utilisez un canal de notification par SMS, utilisez également un autre type de canal de notification en tant que sauvegarde.
Si vous prévoyez d'utiliser des outils d'automatisation pour lire, rediriger, transformer ou effectuer d'autres actions sur les notifications, utilisez les canaux Webhook ou Pub/Sub. Nous vous déconseillons d'utiliser d'autres types de canaux avec les outils d'automatisation, car le format des notifications est susceptible de changer.
Créer un canal de notification
Lorsque vous créez une règle d'alerte, vous pouvez sélectionner n'importe quel canal de notification configuré et l'ajouter à votre règle. Vous pouvez préconfigurer vos canaux de notification, ou les configurer dans le cadre de la création d'une règle d'alerte. Pour en savoir plus, consultez Créer un canal à la demande.
Pour créer un canal de notification à l'aide de la console Google Cloud , suivez les instructions spécifiques au canal figurant dans le tableau ci-dessous :
Pour ajouter un canal de notification par e-mail, procédez comme suit:
-
Dans la console Google Cloud , accédez à la page notifications Alertes :
Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est Monitoring.
- Dans la barre d'outils de la console Google Cloud , sélectionnez votre projet Google Cloud . Pour les configurations App Hub, sélectionnez le projet hôte App Hub ou le projet de gestion.
- Cliquez sur Modifier les canaux de notification.
- Dans la section E-mail, cliquez sur Ajouter.
- Saisissez une seule adresse e-mail et une description.
- Cliquez sur Enregistrer.
Si vous utilisez une adresse e-mail de groupe comme canal de notification pour une règle d'alerte, configurez le groupe pour qu'il accepte les e-mails provenant de alerting-noreply@google.com.
Vous pouvez créer des canaux de notification par e-mail lors de la création d'une règle d'alerte. Pour en savoir plus, consultez Créer un canal à la demande.
Application mobile
Utilisez l'application mobileGoogle Cloud pour surveiller vos ressources de la console Google Cloud et les informations de Monitoring où que vous soyez.Les notifications de l'application mobile Google Cloud console sont envoyées à un appareil ou à un utilisateur spécifique :
- La valeur Device (Appareil) indique que les notifications ne sont envoyées que sur l'appareil spécifique qui a créé le canal de notification. Pour les canaux de notification à l'échelle de l'appareil, le champ Display name (Nom à afficher) inclut les informations sur l'appareil.
- Utilisateur indique que les notifications sont envoyées à tous vos appareils sur lesquels l'application mobile de la console Google Cloud est installée.
Cloud Monitoring détermine le champ d'application des notifications lors de la création du canal. Vous ne pouvez ni sélectionner, ni modifier le champ d'application.
Pour configurer un canal de notification dans l'application mobile Google Cloud console pour un projet Google Cloud spécifique, procédez comme suit :
- Installez l'application mobile Google Cloud Console depuis la plate-forme de téléchargement d'applications de votre appareil mobile.
Sélectionnez un projet à afficher dans l'application mobile de la console Google Cloud .
Après avoir sélectionné un projet, un échange de données a lieu entre l'application et le projet Google Cloud sélectionné. Un canal de notification est créé s'il n'en existe pas. Au bout de quelques minutes, il est listé dans la section Appareils mobiles de la page Canaux de notification.
Pour ajouter votre appareil mobile en tant que canal de notification pour une règle d'alerte, dans la section Notifications d'alerte, sélectionnez Google Cloud console (mobile), puis votre appareil mobile dans la liste.
PagerDuty
PagerDuty est compatible avec la synchronisation bidirectionnelle avec Monitoring. Par conséquent :
- Lorsqu'une alerte est créée dans Monitoring, une alerte miroir est également ouverte dans PagerDuty.
- Vous ne pouvez pas utiliser PagerDuty pour fermer une alerte dans Monitoring.
- Si vous résolvez une alerte dans PagerDuty alors qu'elle est toujours ouverte dans Monitoring, elle est rouverte dans PagerDuty.
Pour configurer les notifications PagerDuty :
- Dans votre compte PagerDuty, configurez l'intégration dans un nouveau service ou ajoutez-la à un service existant.
- Créez un compte ou connectez-vous à un compte existant.
- Accédez à la page Services.
- Pour créer un service, procédez comme suit :
- Cliquez sur + Nouveau service.
- Saisissez un nom et une description pour le service, puis cliquez sur Suivant.
- Configurez une règle d'escalade, puis cliquez sur Suivant.
- Si votre compte PagerDuty est compatible avec le regroupement d'alertes et les alertes transitoires, configurez-les, puis cliquez sur Suivant.
- Sur la page de configuration des intégrations, dans la barre d'outils Rechercher une ou plusieurs intégrations, saisissez
Events API v1, puis cliquez sur Créer un service. Vous êtes ensuite redirigé vers le panneau Integrations (Intégrations) de votre nouveau service.
- Pour modifier un service existant :
- Sélectionnez un service dans votre annuaire des services.
- Sur la page de votre service, sélectionnez le panneau Intégrations.
- Cliquez sur + Ajouter une autre intégration pour accéder à la page de configuration des intégrations.
- Sur la page de configuration des intégrations, dans la barre d'outils Rechercher une ou plusieurs intégrations, saisissez
Events API v1, puis cliquez sur Ajouter. Vous êtes ensuite redirigé vers le panneau Intégrations du service que vous avez modifié.
- Dans le panneau Integrations (Intégrations) de votre service, recherchez la liste de votre nouvelle intégration, développez son menu, puis copiez la clé d'intégration.
- Facultatif : Configurez PagerDuty pour mapper précisément les valeurs de gravité des alertes de Monitoring.
- Dans Cloud Monitoring, ajoutez le canal de notification PagerDuty :
-
Dans la console Google Cloud , accédez à la page notifications Alertes :
Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est Monitoring.
- Dans la barre d'outils de la console Google Cloud , sélectionnez votre projet Google Cloud . Pour les configurations App Hub, sélectionnez le projet hôte App Hub ou le projet de gestion.
-