Modelo de descrição para condição do alerta

Para alguns tipos de condições, você pode definir um modelo de descrição que transmite informações úteis para etapas posteriores para melhores respostas a eventos de alerta ou para uso por outros sistemas. Você pode criar um modelo de descrição na interface do usuário ou com GraphQL.

Requisitos

O recurso de modelo de descrição está disponível para:

• NRQL condição do alerta
• Monitoramento de infraestrutura condição do alerta

O campo do modelo de descrição tem um tamanho máximo de caracteres de 4.000.

O que é um modelo de descrição?

Para alguns tipos de condições, você pode criar um modelo de descrição que passa informações sobre uma condição e seus eventos de alerta a jusante. Usando uma descrição, você pode:

• Capture o motivo da condição
• Defina o sinal que está sendo monitorado
• Defina os próximos passos
• Adicione metadados a sistemas downstream

O campo Description template permite usar uma estrutura de modelo geral que, quando um evento de alerta é gerado, substitui as seções genéricas por valores específicos. Por exemplo, digamos que você usou isso em uma descrição:

This is my condition name : {{conditionName}}
The hostname is : {{tags.fullHostname}}

Um evento de alerta resultante desta condição preencheria os detalhes e você receberia uma notificação como esta:

This is my condition name : My Great Alert Condition
The hostname is : ip-123-45-67-89.us-west-1.compute.internal

Crie um modelo de descrição

/ <img title="description template" alt="A screenshot displaying a sample description template" src="/images/alerts_screenshot-full_custom-incident-description-alerts.webp" /> <figcaption> <DNT>one.newrelic.com > All capabilities > Alerts & AI > Alert conditions (Policies) > (select a policy) > (select a condition)</DNT>: Click <DNT>+ Add description template</DNT> to open the field. </figcaption> /

Você pode criar um modelo de descrição usando o campo dedicado para alertas NRQL ou a seção Descrever esta condição para alertas de infraestrutura.

Exemplo de modelo de modelo de descrição

Aqui está um exemplo de modelo de descrição:

This is my condition name : {{conditionName}}
The hostname is : {{tags.fullHostname}}
Owning Team: {{tags.label.owning_team}}
Product: {{tags.label.product}}
ec2VpcId: {{tags.aws.ec2VpcId}}
Service name : {{tags.label.Name}}
AWS Region : {{tags.aws.awsRegion}}
AWS Availability Zone: {{tags.aws.awsAvailabilityZone}}
Department : {{tags.label.department}}
Environment: {{tags.label.environment}}
Cluster: {{tags.clusterName}}
Cluster Role: {{tags.clusterRole}}
EC2 Instance Type: {{tags.instanceType}}
EC2 InstanceID: {{tags.aws.ec2InstanceId}}
EC2 AmiId: {{tags.aws.ec2AmiId}}
EC2 Root Device Type: {{tags.aws.ec2RootDeviceType}}

Como usar o atributo

Os atributos que você pode usar em um modelo de descrição são um subconjunto de atributos anexados ao evento de alerta. Aqui estão alguns detalhes sobre os atributos disponíveis e como usá-los:

• Atributos de evento de alerta: Para qualquer um dos atributos padrão disponíveis para uso em um modelo de descrição, use o formato {{AN_ATTRIBUTE}}. Por exemplo:

  The target name is : {{targetName}}

  Copiar

• Tag atributo: Para tags, você usaria o formato {{tags.TAG_NAME}}. Existem dois tipos de tags:

  • Tags relacionadas à entidade: For infrastructure conditions only. Você pode encontrar tags relacionadas à entidade disponíveis acessando o entity explorer e procurando em Metadata and tags de um serviço, ou visualizando os detalhes do evento de alerta. Aqui está um exemplo de uso de tags em um modelo de descrição:

    The AWS region is : {{tags.aws.awsRegion}}
    Responsible team : {{tags.label.owning_team}}

    Copiar

  • Tag de cláusula de faceta: For NRQL conditions only. se uma condição NRQL usar uma cláusula FACET, você poderá usar a formatação tags para usar esses valores em seu modelo de descrição. Por exemplo, se a consulta NRQL incluísse FACET hostName, cluster, você poderia usar isto:

    The host is : {{tags.hostName}}
    The cluster is : {{tags.cluster}}

    Copiar

Observe que os nomes tag não podem incluir espaços em branco. Os valores expandidos podem incluir espaços em branco, mas não os nomes da tag em si.

Crie um modelo de descrição com GraphQL

Você pode criar um modelo de descrição em uma condição do alerta NRQL por meio de uma mutação GraphQL com essa descrição.

Aqui está um modelo de mutação vazio:

mutation {
  alertsNrqlConditionStaticUpdate(
    accountId: YOUR_ACCOUNT_ID
    id: "YOUR_CONDITION_ID"
    condition: { description: "" }
  ) {
    YOUR_CUSTOM_INCIDENT_DESCRIPTION
  }
}

Aqui está um exemplo de mutação com um modelo de descrição:

mutation {
  alertsNrqlConditionStaticUpdate(
    accountId: 123456
    id: "123456"
    condition: {
      description: "timestamp : {{timestamp}} \n accountId : {{accountId}} \n type : {{type}} \n event : {{event}} \n description : {{description}} \n policyId : {{policyId}} \n policyName: {{policyName}} \n conditionName : {{conditionName}} \n conditionId : {{conditionId}} \n product : {{product}} \n conditionType : {{conditionType}} \n RunbookUrl : {{runbookUrl}} \n nrqlQuery : {{nrqlQuery}} \n nrqlEventType : {{nrqlEventType}} \n targetID : {{targetId}} \n targetName : {{targetName}} \n commandLine : {{tags.commandLine}} \n entityGuid : {{tags.entityGuid}} \n entityName : {{tags.entityName}} \n fullHostname : {{tags.fullHostname}} \n instanceType : {{tags.instanceType}} \n processDisplayName : {{tags.processDisplayName}}"
    }
  ) {
    description
  }
}

• Para obter mais informações sobre as condições NRQL e como usar a API NerdGraph, acesse API NerdGraph: alerta de condição NRQL.
• Para condições de monitoramento de infraestrutura, você pode criar o modelo de descrição ao criar um monitoramento de infraestrutura condição do alerta.
• Para saber como estruturar um modelo de descrição, veja o modelo de exemplo e as instruções de atributo/tag .

Mencionando usuário ou canal de notificação no Slack

Ao criar uma descrição que você sabe que será enviada ao Slack, talvez você queira @mention um usuário ou gerar uma notificação para todo o canal (por exemplo, @here ou @channel). Para conseguir isso, basta incluir o ID do usuário ou uma notificação para todo o canal na descrição, cercada por < e > caracteres.

Aqui está um exemplo para mencionar um usuário:

Attention <@LewCirne>

Aqui está um exemplo para gerar uma notificação para todo o canal:

Attention <!channel>