Charge utile personnalisée dans l’intégration des alertes

  • Rversion finale: Zurich
  • Mis à jour 31 juil. 2025
  • 2 minutes de lecture
  • Les intégrations d’Observateur d’instance vous permettent de définir et de gérer la charge utile des demandes JSON personnalisées et ServiceNow les intégrations tierces.

    Vous pouvez désormais inclure des champs supplémentaires dans les charges utiles de notification, exclure des données spécifiques qui ne sont pas requises par le système cible, formater la charge utile pour s’aligner sur les exigences spécifiques d’API tierces ou la logique métier interne, éliminant ainsi le besoin d’API REST scriptées complexes côté client.

    • Utilisez la charge utile par défaut ou personnalisez-la pour inclure des données supplémentaires si nécessaire.
    • Modifiez la charge utile par défaut, si nécessaire, qui s’affiche dans la fenêtre de l’éditeur à gauche.
    • Modifiez la clé ou la valeur, ou les deux, car chaque paramètre se compose d’une clé et d’une valeur.
    • La section Aperçu à droite affiche la charge utile JSON attendue après le rendu.
    • Si le JSON n’est pas valide, les erreurs sont mises en surbrillance et l’option d’enregistrement est désactivée.

    Modèle de charge utile de moustache par défaut

    {
      "alert_number": "{{alert_number}}",
      "alert_type": "{{alert_type}}",
      "alert_name": "{{alert_name}}",
      "alert_time": "{{alert_time}}",
      "instance": "{{instance}}",
      "description": "{{description}}",
      "alert_created": "{{alert_created}}"
    }
    

    Modifiez la charge utile pour le modèle de charge utile de la moustache par défaut.

    Exemple : charge utile par défaut + paramètres personnalisés

    {
    "alert_number": "{{alert_number}}",
      "alert_type": "{{alert_type}}",
      "alert_name": "{{alert_name}}",
      "alert_time": "{{alert_time}}",
      "instance": "{{instance}}",
      "description": "{{description}}",
      "alert_created": "{{alert_created}}",
      "Custom_message": "{{alert_name}}' of type {{alert_type}} generated for {{instance}} at {{alert_time}}. Please review.",
      "Severity": “High”
    }
    

    Modifiez la charge utile pour la charge utile par défaut + les paramètres personnalisés.

    Paramètres personnalisés et limites

    Le champ custom_parameter vous permet d’insérer un message personnalisé dans le modèle JSON, vous pouvez également utiliser les paramètres existants comme indiqué dans les exemples de paramètres personnalisés.

    Les limitations sont les suivantes :
    • Requis : au moins un et au maximum 20 paramètres pour enregistrer le modèle.
    • Maximum : 13 paramètres personnalisés.
    • En cas de dépassement, un avertissement s’affiche : le modèle doit avoir au moins une clé par défaut et jusqu’à 20 clés. Ajustez ou sélectionnez « Rétablir les valeurs par défaut » pour appliquer les valeurs par défaut.

    Exemples de paramètres personnalisés pour référence syntaxique

    « Information » : « Une alerte {{alert_name}} a été déclenchée pour {{instance}} à {{alert_time}} Description : {{description}} »

    « Alert_message » : « Nouvelle alerte '{{alert_name}}' de type {{alert_type}} générée pour {{instance}} à {{alert_time}}. S’il vous plaît, examinez."

    « Event_type » : « Gravité élevée ! Une alerte {{alert_name}} a été déclenchée pour {{instance}} à {{alert_time}} Description : {{description}}"

    Mappage du corps de la demande tierce

    Certaines intégrations tierces nécessitent des noms de clés spécifiques. Vous pouvez modifier la charge utile par défaut pour qu’elle corresponde au format attendu.

    Exemple : corps de la demande du tiers :
    {
      "endTime": 1,
      "entitySelector": "string",
      "eventType": "AVAILABILITY_EVENT",
      "properties": {},
      "startTime": 1,
      "timeout": 1,
      "title": "string"
    }
    

    Charge utile de l’E/S modifiée pour correspondre au format tiers

    Charge utile de l’E/S modifiée pour correspondre au format tiers.

    Actions et validation

    Rétablir les changements
    Restaure le dernier contenu enregistré.
    Rétablir la valeur par défaut
    Réinitialise le modèle à sa charge utile par défaut.
    Validateur de syntaxe
    Assure la validité de JSON avant l’enregistrement. Des erreurs empêchent l’enregistrement.
    Intégration de tests
    Envoie un exemple de notification pour vérifier l’intégration du webhook.