Configuration de contenus personnalisés

L'ajout de charge personnalisée à vos notifications d'alerte vous permet d'utiliser les alertes Instana plus efficacement :

  • Informations supplémentaires : incluez les informations pertinentes de votre système surveillé dans le cadre de votre notification d'alerte. Par exemple, si vous utilisez généralement ssh pour accéder aux hôtes concernés par un incident, vous pouvez inclure l'adresse IP de l'hôte hôte ou AWS public IPv4 . Vous pouvez donc accéder directement aux serveurs concernés, sans avoir à passer d'abord par plusieurs tableaux de bord d' Instana s pour trouver les adresses IP correctes.
  • Routage d'alerte avancé : activez les cas d'utilisation de routage d'alerte avancé à l'aide de l'outil de gestion des alertes de votre choix. Par exemple, si votre organisation pense Cloud Native, vous pouvez inclure des responsabilités d'équipe en tant qu'étiquettes dans votre environnement Kubernetes. Les alertes peuvent ensuite être acheminées avec souplesse vers les équipes respectives au sein de l'intégration d'alertes utilisée.

Configurer une charge utile personnalisée au niveau global

Pour inclure des informations supplémentaires qui vous concernent dans toutes les notifications d'alerte envoyées par Instana, procédez comme suit :

  1. Dans la barre latérale, cliquez sur Paramètres.

  2. Sous Événements et alertes, accédez à Charge personnalisée.

    Remarque : l'autorisation CAN_CONFIGURE_GLOBAL_ALERT_PAYLOAD est nécessaire pour afficher cette entrée de navigation.

  3. Entrez les propriétés de l'entrée de charge personnalisée :

    1. Clé unique et significative permettant d'identifier l'entrée de charge personnalisée.

      Remarque : la clé est préfixée par custom: afin de garantir qu'aucune des charges utiles intégrées d' Instana ne soit écrasée.

    2. Sélectionnez le type de valeur de la charge personnalisée :

      • Statique: valeur textuelle fixe.
      • Dynamique: ensemble de valeurs dérivées de l'infrastructure surveillée associée à l'alerte en fonction d'une balise donnée, comme décrit dans Charge utile personnalisée dynamique.
    3. Définissez la valeur de l'entrée de charge.

  4. Vous pouvez également cliquer sur Ajouter une ligne pour ajouter une autre entrée et répéter l'étape précédente.

  5. Cliquez sur Sauvegarder pour soumettre les modifications.

Charge utile personnalisée globale

En conséquence, toutes les notifications d'alerte concernant des problèmes ou des incidents envoyées par Instana vers l'un des canaux d'alerte configurés incluront désormais la charge utile statique ou dynamique configurée, le cas échéant. Les notifications d'alerte du type d'événement Modification incluent uniquement le contenu statique configuré.

Remarque : la charge utile personnalisée dynamique globale s'applique uniquement aux événements personnalisés et aux alertes intelligentes pour les journaux, les applications et l'infrastructure.

Charge personnalisée dynamique

Les notifications d'alerte peuvent être enrichies de données utiles basées sur les relations du système surveillé, détectées automatiquement et mises à jour en continu, grâce au « Dynamic Graph » unique d' Instana. Par conséquent, les valeurs de charge ne sont pas collectées uniquement sur l'entité pour laquelle l'alerte a été déclenchée, mais également à partir d'entités associées.

Chaque entrée de charge dynamique est associée à la balise du catalogue de balises d'Instana. Les informations déduites de chaque balise sélectionnée sont ensuite incluses dans un événement sous la forme d'un ensemble de valeurs.

sélection d'une balise de contenu personnalisé

Vous pouvez utiliser les suggestions pour sélectionner la clé appropriée pour la balise dynamique choisie ou l'ajouter manuellement.

Suggestions de contenu personnalisé dynamique

Exemples de charge personnalisée

Bien qu' Instana prenne en charge les données de notification personnalisées pour tous les canaux d'alerte disponibles, les exemples suivants devraient vous donner une meilleure idée des notifications d'alerte générées contenant les données de notification configurées.

Exemple 1 : Opsgenie

Lorsque vous utilisez le canal d'alerte « Opsgenie », la charge utile sera incluse sous forme de contenu textuel dans la section « Propriétés supplémentaires ».

exemple de contenu personnalisé opsgenie

En outre, des règles de routage basées sur ces contenus personnalisés peuvent être définies pour les cas d'utilisation de routage d'alerte avancé.

Exemple 2 : Slack

Dans Slack ou d'autres outils de notification similaires, tels que Google Chat ou Microsoft Teams, la charge utile personnalisée sera incluse sous la forme d'une liste de valeurs séparées par des virgules. Une entrée de charge personnalisée est tronquée avec des points de suspension pour ne pas trop gonfler le contenu du message.

exemple de slack de contenu personnalisé

Exemple 3 : Webhook

Lorsque vous utilisez le canal d'alerte « Webhook », la charge utile personnalisée est incluse sous forme d'objet imbriqué sous customPayloads. Les valeurs sont représentées sous la forme d'un tableau de chaînes (String[].md).

{
  "issue": {
    "id": "53650436-8e35-49a3-a610-56b442ae7620",
    "type": "issue",
    "state": "OPEN",
    "text": "Custom Process Event",
    ...
    "customPayloads": {
       "custom:team": ["blue"],
       "custom:host-ip": ["10.128.0.85", "10.64.2.1"],
       "custom:app-name": ["rabbitmq"]
    }
  }
}