Modèle de titre pour la condition d'alerte NRQL

Un modèle de titre est utilisé lorsque les incidents sont ouverts par la condition. Il remplace le titre par défaut.

Pourquoi utiliser un modèle de titre ?

Une condition d’alerte est la base de la création d’un incident. Que vous utilisiez notre mode guidé ou que vous élaboriez une condition à partir d'un graphique ou d'une politique, l'utilisation d'un modèle de titre unique est la dernière étape de la création d'une condition d'alerte.

L'utilisation du modèle de titre est facultative mais nous le recommandons. Une condition d'alerte définit un ensemble de seuil que vous souhaitez monitorer. Si l’un de ces seuils est dépassé, un incident est créé. Des modèles de titres significatifs vous aident à identifier les problèmes et à résoudre les pannes plus rapidement.

Avant de commencer

Voici quelques éléments clés à noter avant d’utiliser notre modèle de titre :

• Compatibilité: La fonctionnalité de modèle de titre est disponible uniquement pour les conditions NRQL.
• Limite de caractères: La longueur maximale d'un modèle de titre est de 256 caractères.
• Formatage: Le modèle de titre doit suivre un format Handlebars valide.
• Incident de signal perdu: Pour un incident déclenché par un signal perdu, le titre par défaut sera toujours utilisé. Pour en savoir plus sur la perte de signal, consultez Perte de signal et remplissage d’espace.

Comprendre le modèle de titre

Disons que vous gérez un site de commerce électronique et que vous avez créé une condition d'alerte pour déclencher un incident lorsque les erreurs de réseau sont élevées. Vous pouvez utiliser un modèle de titre pour rendre l’incident de cette condition facilement identifiable.

Vous avez nommé cette condition d’alerte High Network Errors. Mais vous souhaitez que le titre de l’incident reflète davantage d’informations sur l’entité et la priorité.

Exemple:

{{conditionName}} Affecting {{entity.name}} - {{entity.type}} - {{priority}}

Ce modèle générerait le titre d'incident suivant :

High Network Errors Affecting Entity123 - Kubernetes Pod - Critical

Utiliser le modèle de titre

Vous pouvez interagir avec le modèle de titre de deux manières : via l'UI ou en utilisant GraphQL. Suivez ces étapes pour savoir comment procéder.

mutation {
  alertsNrqlConditionStaticUpdate(
    accountId: 123456
    id: 456789
    condition: { titleTemplate: "{{conditionName}} has triggered an incident" }
  ) {
    titleTemplate
  }
}

Utilisez l'attribut pour définir davantage votre condition

Vous pouvez inclure un sous-ensemble d'attributs d'événement incident dans vos modèles de titre pour ajouter plus de contexte.

Voici comment :

• Utilisez le format {{AN_ATTRIBUTE}}. Par exemple:

  {{conditionName}} has triggered an incident

  Copier

• attribut tag: pour tag, utilisez le format {{tags.TAG_NAME}}.

• Balise de clause de facette: si une condition NRQL utilise une clause FACET, vous pouvez utiliser le formatage tags pour utiliser ces valeurs dans votre modèle de titre. Par exemple, si la requête NRQL incluait FACET hostName, cluster, vous pourriez alors utiliser ceci :

  Host {{tags.hostName}}, cluster {{tags.cluster}} incident

  Copier

les noms de balises ne peuvent pas contenir d'espaces, mais les valeurs développées le peuvent. Pour une liste complète des attributs disponibles, voir l'attribut incident événement.