Configurer des canaux de notification pour les alertes
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
La plate-forme Observability vous permet de configurer des canaux de notification pour les alertes que vous configurez. Le système envoie une alerte à ces canaux personnalisés chaque fois qu'un événement en déclenche une. Vous pouvez ainsi avertir les destinataires de votre choix selon vos méthodes préférées.
L'appliance Google Distributed Cloud (GDC) isolée ne prédéfinit pas les canaux de notification
destinés à l'envoi d'alertes. Vous devez définir au moins un canal pour recevoir les alertes. Si vous ne définissez pas de configuration de canal de notification, le système GDC Observability utilise par défaut la configuration des ressources de la plate-forme. Par conséquent, si vous ne configurez pas de canaux de notification Slack ou par e-mail, mais qu'un administrateur l'a fait pour l'organisation, le système envoie des alertes à ces canaux.
Avant de commencer
Pour obtenir les autorisations nécessaires pour configurer ou afficher les canaux de notification, demandez à votre administrateur IAM de projet de vous accorder l'un des rôles suivants dans l'espace de noms de votre projet :
Éditeur de pipeline d'observabilité : modifie les ressources personnalisées ObservabilityPipeline. Demandez le rôle Éditeur de pipeline Observability (observabilitypipeline-editor).
Lecteur de pipelines d'observabilité : affiche les ressources personnalisées ObservabilityPipeline. Demandez le rôle Lecteur du pipeline d'observabilité (observabilitypipeline-viewer).
Configurer des canaux de notification
Suivez les étapes ci-dessous pour configurer des canaux de notification pour les alertes que vous avez configurées pour la surveillance du système :
Créez un objet ConfigMap et déployez-le dans l'espace de noms de votre projet. L'objet doit contenir les règles de configuration dans le fichier alertmanager.yml.
apiVersion:v1kind:ConfigMapmetadata:# The name must match the ConfigMap name specified in the ObservabilityPipeline custom resource.name:CUSTOMIZED_CONFIGMAP_NAME# Choose namespace that matches the project's namespacenamespace:PROJECT_NAMESPACEdata:# The file name must be alertmanager.yml.alertmanager.yml:|# Add the customized Alertmanager configuration here.
Remplacez les éléments suivants :
CUSTOMIZED_CONFIGMAP_NAME : nom de votre fichier de configuration à utiliser dans la ressource personnalisée ObservabilityPipeline lors de l'étape suivante.
PROJECT_NAMESPACE : espace de noms de votre projet.
Configurez la ressource personnalisée ObservabilityPipeline dans un éditeur de ligne de commande pour importer la configuration dans le champ alertmanagerConfig imbriqué dans le champ alerting.
# Configure observability pipelineapiVersion:observability.gdc.goog/v1kind:ObservabilityPipelinemetadata:# Choose namespace that matches the project's namespacenamespace:PROJECT_NAMESPACEname:observability-configspec:# Configure Alertmanageralerting:# Permission: PA and AO# The alerts configuration must be in the key "alertmanager.yml" of the configMapalertmanagerConfig:CUSTOMIZED_CONFIGMAP_NAME...
Remplacez les éléments suivants :
PROJECT_NAMESPACE : espace de noms de votre projet.
CUSTOMIZED_CONFIGMAP_NAME : nom que vous avez utilisé pour votre fichier de configuration dans l'objet ConfigMap. Le nom doit correspondre exactement.
Enregistrez les modifications apportées à la CR ObservabilityPipeline et quittez l'éditeur de ligne de commande.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/09/04 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Difficile à comprendre","hardToUnderstand","thumb-down"],["Informations ou exemple de code incorrects","incorrectInformationOrSampleCode","thumb-down"],["Il n'y a pas l'information/les exemples dont j'ai besoin","missingTheInformationSamplesINeed","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/09/04 (UTC)."],[[["\u003cp\u003eThe Observability platform allows users to configure custom notification channels for alerts, ensuring that notifications are sent to the desired recipients through their preferred methods.\u003c/p\u003e\n"],["\u003cp\u003eGDC air-gapped appliance requires users to define at least one notification channel to receive alerts, as it does not have predefined channels; if no channels are defined, it uses organization-level configurations.\u003c/p\u003e\n"],["\u003cp\u003eTo configure or view notification channels, users need specific permissions, either the Observability Pipeline Editor role for modifying configurations or the Observability Pipeline Viewer role for viewing configurations.\u003c/p\u003e\n"],["\u003cp\u003eConfiguring notification channels involves defining the configuration in an \u003ccode\u003ealertmanager.yml\u003c/code\u003e file, creating a \u003ccode\u003eConfigMap\u003c/code\u003e object with this file, and then updating the \u003ccode\u003eObservabilityPipeline\u003c/code\u003e custom resource to point to this \u003ccode\u003eConfigMap\u003c/code\u003e.\u003c/p\u003e\n"]]],[],null,["# Configure notification channels for alerts\n\nThe Observability platform lets you configure notification channels for the alerts you set up. The system sends an alert to these customized channels whenever an event causes an alert. This way, you can notify the recipients you need according to your preferred methods.\n\nGoogle Distributed Cloud (GDC) air-gapped appliance does not predefine notification channels\n\nintended for sending alerts. You must define at least one channel to receive alerts. If you don't define a notification channel configuration, the GDC Observability system takes the configuration from the platform resources as a default. Consequently, if you don't configure\n\nnotification channels but an administrator did it for the organization, then the system sends alerts to those channels.\n\nBefore you begin\n----------------\n\nTo get the permissions you need to configure or view notification channels, ask your Project IAM Admin to grant you one of the following roles in your project namespace:\n\n- **Observability Pipeline Editor** : edits or modifies `ObservabilityPipeline` custom resources. Request the Observability Pipeline Editor (`observabilitypipeline-editor`) role.\n- **Observability Pipeline Viewer** : views `ObservabilityPipeline` custom resources. Request the Observability Pipeline Viewer (`observabilitypipeline-viewer`) role.\n\nConfigure notification channels\n-------------------------------\n\nWork through the following steps to configure notification channels for the alerts you set up for system monitoring:\n\n1. Define the Observability alerting configuration following the specification in \u003chttps://prometheus.io/docs/alerting/latest/configuration/\u003e.\n2. Create a `ConfigMap` object and deploy it into your project namespace. The object must contain the configuration rules in the `alertmanager.yml` file.\n\n apiVersion: v1\n kind: ConfigMap\n metadata:\n # The name must match the ConfigMap name specified in the ObservabilityPipeline custom resource.\n name: \u003cvar translate=\"no\"\u003e\u003cspan class=\"devsite-syntax-l devsite-syntax-l-Scalar devsite-syntax-l-Scalar-Plain\"\u003eCUSTOMIZED_CONFIGMAP_NAME\u003c/span\u003e\u003c/var\u003e\n # Choose namespace that matches the project's namespace\n namespace: \u003cvar translate=\"no\"\u003e\u003cspan class=\"devsite-syntax-l devsite-syntax-l-Scalar devsite-syntax-l-Scalar-Plain\"\u003ePROJECT_NAMESPACE\u003c/span\u003e\u003c/var\u003e\n data:\n # The file name must be alertmanager.yml.\n alertmanager.yml: |\n # Add the customized Alertmanager configuration here.\n\n Replace the following:\n - \u003cvar translate=\"no\"\u003eCUSTOMIZED_CONFIGMAP_NAME\u003c/var\u003e: The name of your configuration file to use it in the `ObservabilityPipeline` CR during the following step.\n - \u003cvar translate=\"no\"\u003ePROJECT_NAMESPACE\u003c/var\u003e: The namespace of your project.\n\n | **Note:** Follow the same syntax as described in \u003chttps://prometheus.io/docs/alerting/latest/configuration\u003e to define the notification channels in the `alertmanager.yml` file.\n3. Configure the `ObservabilityPipeline` custom resource in a command-line editor to import the configuration in the `alertmanagerConfig` field nested in the `alerting` field.\n\n # Configure observability pipeline\n apiVersion: observability.gdc.goog/v1\n kind: ObservabilityPipeline\n metadata:\n # Choose namespace that matches the project's namespace\n namespace: \u003cvar translate=\"no\"\u003e\u003cspan class=\"devsite-syntax-l devsite-syntax-l-Scalar devsite-syntax-l-Scalar-Plain\"\u003ePROJECT_NAMESPACE\u003c/span\u003e\u003c/var\u003e\n name: observability-config\n spec:\n # Configure Alertmanager\n alerting:\n # Permission: PA and AO\n # The alerts configuration must be in the key \"alertmanager.yml\" of the configMap\n alertmanagerConfig: \u003cvar translate=\"no\"\u003e\u003cspan class=\"devsite-syntax-l devsite-syntax-l-Scalar devsite-syntax-l-Scalar-Plain\"\u003eCUSTOMIZED_CONFIGMAP_NAME\u003c/span\u003e\u003c/var\u003e\n ...\n\n Replace the following:\n - \u003cvar translate=\"no\"\u003ePROJECT_NAMESPACE\u003c/var\u003e: The namespace of your project.\n - \u003cvar translate=\"no\"\u003eCUSTOMIZED_CONFIGMAP_NAME\u003c/var\u003e: The name you used for your configuration file in the `ConfigMap` object. The name must match exactly.\n4. Save the changes in the `ObservabilityPipeline` CR and exit your command-line editor."]]
