Intégrer les événements Prometheus

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 2 minutes de lecture

    • Intégrez Prometheus à Gestion des événements ajoutant un webhook standard dans le gestionnaire d'alertes de Prometheus.

    Avant de commencer

    • Assurez-vous que le module d’extension Gestion des événements Connecteurs (sn_em_connector) est installé sur l’instance Now Platform .
    • Vérifiez que les éléments de configuration pour les hôtes gérés par Prometheus existent dans ServiceNow. Ces CI peuvent être physiques ou virtuels, et peuvent être créés ou détectés manuellement à l'aide de la détection d'adresses IP ou de Cloud Discovery.
    • Rôle requis : evt_mgmt_integration

    Pourquoi et quand exécuter cette tâche

    Configurez l'environnement Gestion des événements pour la collecte d'événements à partir de Prometheus.
    À partir de la Xanadu mise en production, la case à cocher Appliquer des règles de correspondance supplémentaires supplémentaires fournies avec le connecteur, que vous n’avez pas utilisées auparavant (c’est-à-dire ni activées, ni désactivées, ni modifiées), est désormais cochée pour les règles de correspondance supplémentaires . Auparavant, cette case à cocher était désactivée. Ce changement vous permet d’exécuter plus de règles d’événements ou d’automatisation en utilisant les mêmes conditions de filtre pour le connecteur.
    Remarque :
    Cette fonctionnalité s’applique uniquement aux règles d’événements actives.

    Procédure

    1. Dans l'instance Prometheus, ajoutez un webhook.
      1. Accédez à Alertmanager.yml et ajoutez une entrée webhook sous les destinataires.
      2. Spécifiez l'URL du point de terminaison. Par exemple, utilisez https://<nom-instance>/service-now.com/api/sn_em_connector/em/inbound_event?source=prometheus.
      3. Saisissez basic_auth sous http_config.
      4. Ajoutez un nom d'utilisateur et un mot de passe sous basic_auth, puis ajoutez le nom du webhook créé dans le destinataire sous route.
    2. Dans l'instance Prometheus, créez une règle d'alerte.
      1. Créez un fichier pour la règle d'alerte et ajoutez son chemin d'accès dans prometheus.yml sous rules_files.
      2. Créez la règle d'alerte selon le format Prometheus à l'aide de PromQL.
      3. Redémarrez AlertManager et Prometheus pour appliquer les modifications.

    Résultats

    L'envoi des alertes Prometheus au module d'extension Gestion des événements commence. Le module d'extension extrait les informations du message d'alerte Prometheus d'origine pour renseigner les champs d'événement requis et insère l'événement dans la base de données. Dans votre instance Now Platform, accédez à Tous les événements pour afficher les événements.

    Si la gravité n’est pas reçue dans la charge utile, la gravité par défaut est Majeure, qui peut être changée dans la Push Connector Configuration section de Connecteurs par push > Connecteur Push Prometheus. Les valeurs valides de gravité sont les suivantes : 1- Critique, 2- Majeure, 3- Mineure, 4- Avertissement et 5- Informations.

    Remarque :

    pour mapper les hôtes sur l'enregistrement cmdb_ci_vm_object plutôt que sur cmdb_ci_hardware, activez la règle d'événement Liaison d'ordinateur virtuel Prometheus créée pour Prometheus. Pour en savoir plus sur les règles d'événements, consultez la rubrique Règles d'événements.