Mapper les attributs de charge utile du message Kafka aux champs d'alerte

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 4 minutes de lecture

    • Mappez les attributs de message Kafka aux champs d’alerte pour rendre les alertes basées sur les messages plus pertinentes. Utilisez le mappage de champs d’événements pour mapper les valeurs de gravité Kafka aux valeurs appropriées ServiceNow .

    Avant de commencer

    Rôle requis : evt_mgmt_admin

    Pourquoi et quand exécuter cette tâche

    En fonction de votre charge utile, utilisez des mappages de champs d’événements pour fournir des informations plus complètes dans une alerte d’événement en remplaçant des valeurs de la règle de mappage de champs d’événements dans l’événement. En fonction de votre charge utile, transformez les informations en événements pour renseigner les valeurs de champ d’alerte spécifiées et composez des champs d’alerte à partir de différentes valeurs pour générer des alertes à des fins de suivi et de correction. Si nécessaire, utilisez à la fois les mappages de champs d’événements et les règles d’alerte.

    Le tableau suivant compare un message reçu d’une rubrique et une charge utile aplatie dans le champ Informations supplémentaires de l’événement. Le message reçu d’une rubrique est aplati en tant que champ unique et apparaît dans le champ Informations supplémentaires de l’événement. Utilisez ces messages aplatis pour créer des règles et des mappages d’événements.

    Tableau 1. Charge utile réelle par rapport à la charge utile aplatie
    Charge utile réelle insérée dans une rubrique Charge utile aplatie dans le champ Informations supplémentaires 
    { 

  "version": "v0.1.0", 

  "name": "fibsrc", 

  "id": "mnop6789", 

  "trigger_description": "Triggers on duration_ms goes above 5K", 

  "status": "TRIGGERED", 

  "alert_type": "on_true", 

  "summary": "Triggered: fibsrc", 

  "description": "Current value (12.296815 k) greater than threshold value (5 k)", 

  "operator": "greater than", 

  "threshold": 5000, 

  "groups": [ 

    { 

      "Group": "GroupA", 

      "Result": 12296.815478000368 

    } 

  ], 

  "trigger": { 

    "Result": 12296.815478000368 

  } 

} 
    { 

  "flattened.alert_type": "on_true", 

  "flattened.description": "Current value (12.296815 k) greater than threshold value (5 k)", 

  "flattened.id": " mnop6789", 

  "flattened.kafkaKey": "null", 

  "flattened.kafkaOffset": "28", 

  "flattened.kafkaPartition": "0", 

  "flattened.kafkaTopicName": "topic123", 

  "flattened.name": "fibsrc", 

  "flattened.operator": "greater than", 

  "flattened.status": "TRIGGERED", 

  "flattened.summary": "Triggered: fibsrc", 

  "flattened.trigger_description": "Triggers on duration_ms goesa above 5K", 

  "flattened.version": "v0.1.0", 

  "flattened.version": 5000, 

  "flattened.groups.0.Group": "GroupA", 

  "flattened.groups.0.Result": 12296.815478000368, 

  "flattened.trigger.Result": 12296.815478000368 

}

    Procédure

    1. Pour mapper les attributs du message Kafka aux champs d’alerte prédéfinis afin de générer des alertes en créant des mappages de champs d’événements.
      1. Accédez à la Tous > Gestion des événements > Règles > Mappage de champs d'événements.
      2. Dans la fenêtre Mappage de champs d’événements, sélectionnez Nouveau.
      3. Dans le champ Nom, saisissez un nom pour le mappage de champs.
      4. Dans le champ Source, saisissez Consommateur Kafka.
      5. Dans le champ Type de mappage, sélectionnez le type de mappage approprié
      6. Pour obtenir la liste des types de mappage disponibles, consultez Mappages de champs d’événements.
    2. Pour mapper les attributs du message Kafka aux champs d’alerte prédéfinis afin de générer des alertes en créant des règles d’événements.
      1. Accédez à la Tous > Gestion des événements > Règles > Règles d'événements.
      2. Sélectionnez Nouveau .
      3. Dans le champ Nom, saisissez un nom pour la règle d’événement.
      4. Dans le champ Source, saisissez Consommateur Kafka.
      5. Sélectionnez Filtre d’événement.
      6. Saisissez le filtre approprié en fonction de vos besoins.
      7. Sélectionnez Transformer et composer la sortie d’alerte.

        Lors de la création de règles d’événements, les champs d’événement s’affichent dans l’onglet Sortie d’alerte de transformation et de composition des règles d’événement. Étant donné que le message Kafka varie d’un utilisateur à l’autre, vous devez transformer les champs d’événement en champs d’alerte pour afficher les détails de l’alerte.

        Remarque :
        Étant donné que la valeur de gravité est requise pour créer une alerte, vous devez mapper le champ Gravité à l’aide de règles d’événements ou de mappages de champs d’événements. Si le champ Gravité est vide, l’événement n’est pas traité et passe dans un état d’erreur.
      8. Mappez les champs de l’événement et le champ Informations supplémentaires aux champs de l’alerte.
      9. Sélectionnez Liaison.
      10. Saisissez la liaison appropriée selon vos besoins.
      11. Sélectionnez Envoyer.
        Pour plus d'informations, consultez Créer ou modifier une règle d’événement.
    3. Dans l’écran Tous les événements, vérifiez si l’un des événements de Kafka est en état d’erreur en raison d’une règle d’événement manquante et fournissez des règles manquantes.
      1. Accédez à la Tous > Gestion des événements > Tous les événements.
      2. Dans la table Tous les événements, ouvrez n’importe quel événement de consommateur Kafka qui affiche l’erreur comme état dans la colonne Gravité .

        Le message reçu du consommateur Kafka peut varier. Étant donné que le connecteur ne peut pas connaître les attributs qui seront reçus, vous devez mapper le champ Gravité ou d’autres champs d’événement aux champs du message pour vous assurer que les champs d’alerte sont correctement renseignés.

      3. Sur l’écran Tous les événements, créez une règle d’événement en sélectionnant Créer une règle d’événement.
        Pour plus d’informations sur la création de règles d’événements, consultez Règles d’événements.

        S’il n’existe aucun mappage de champs d’événements pour gérer le nouveau type d’événement, créez des mappages de champs d’événements. Pour plus d'informations, consultez Créer des mappages de champs d’événements.

    Résultats

    Votre connecteur de consommateur Apache Kafka est configuré. Lorsque de nouveaux messages arrivent dans la rubrique Kafka, ils sont reçus dans l’instance sous forme d’événementsServiceNow, et des alertes sont ensuite créées à partir de ces événements.