Configurando cargas úteis personalizadas
Incluir carga útil customizada em suas notificações de alerta permite que você use alertas do Instana de forma mais eficiente:
- Informações adicionais: inclua informações relevantes de seu sistema monitorado como parte de sua notificação de alerta. Como exemplo, caso você geralmente use
sshpara acessar os hosts afetados de um problema, você pode desejar incluir o endereço IP do host ou o endereço IPv4 público da AWS. Consequentemente, você pode acessar diretamente os respectivos servidores, em vez de ter que navegar primeiro por alguns painéis do Instana para encontrar os endereços IP corretos. - Roteamento de alerta avançado: ative casos de uso de roteamento de alerta avançado usando uma ferramenta de gerenciamento de alertas de sua escolha. Por exemplo, se a sua organização pensa em Nuvem Nativa, você pode incluir responsabilidades da equipe como rótulos em seu ambiente do Kubernetes. Os alertas podem, então, ser encaminhados com flexibilidade para as respectivas equipes dentro da integração de alerta usada.
Configurar carga útil personalizada globalmente
Para incluir informações adicionais relevantes para você em todas as notificações de alerta enviadas por Instana, siga as etapas abaixo:
Na barra lateral, clique em Configurações.
Em Eventos e alertas, navegue até Carga útil customizada.
Nota: a permissão
CAN_CONFIGURE_GLOBAL_ALERT_PAYLOADé necessária para ver essa entrada de navegação.Insira as propriedades da entrada de carga útil customizada:
Uma chave única e significativa para identificar a entrada de carga útil customizada.
Nota: a chave é prefixada com
custom:para garantir que nenhuma carga útil integrada do Instana seja substituída.Selecione o tipo de valor da carga útil customizada:
- Static: Um valor textual fixo.
- Dynamic: Um conjunto de valores derivados da infraestrutura monitorada relacionados ao alerta com base em uma determinada tag, conforme descrito em Dynamic Custom Payload.
Defina o valor da entrada de carga útil.
Opcionalmente, clique em Incluir linha para incluir outra entrada e repita a etapa anterior.
Clique em Salvar para enviar as alterações.
Consequentemente, todas as notificações de alerta de Problemas ou Incidentes enviadas pelo Instana para qualquer um dos Canais de Alerta configurados passarão a incluir a carga útil estática ou dinâmica configurada, se for o caso. Notificações de alerta do tipo de evento Change apenas incluem a carga útil estática configurada.
Carga útil customizada dinâmica
As notificações de alerta podem ser enriquecidas com informações adicionais com base nas relações do sistema monitorado, detectadas automaticamente e atualizadas continuamente, utilizando o Gráfico Dinâmico exclusivo d Instana. Consequentemente, os valores de carga útil não são coletados apenas na entidade para a qual o alerta foi acionado, mas também de entidades relacionadas.
Cada entrada de carga útil dinâmica é associada à tag do catálogo de tags do Instana. As informações derivadas para cada tag selecionada são, então, incluídas em um evento como um conjunto de valores.
Você pode usar as sugestões para selecionar a chave correta para a tag dinâmica selecionada ou adicioná-la manualmente.
Exemplos de carga útil customizada
Embora o Instana ofereça suporte a cargas úteis personalizadas para todos os canais de alerta disponíveis, os exemplos a seguir devem dar uma ideia mais clara das notificações de alerta resultantes que contêm a carga útil configurada.
Exemplo 1: Opsgenie
Ao utilizar o canal de alerta Opsgenie, a carga útil será incluída como conteúdo textual na seção “Propriedades adicionais ”.
Além disso, regras de roteamento com base nessas cargas úteis customizadas podem ser definidas para uso de roteamento de alerta avançado-casos.
Exemplo 2: Slack
No Slack ou em ferramentas de notificação semelhantes, como Google Chat ou Microsoft Teams, a carga útil personalizada será incluída como uma lista de valores separados por vírgulas. Uma entrada de carga útil customizada é truncada com reticências para não extrapolar muito o conteúdo da mensagem.
Exemplo 3: Webhook
Ao usar o canal de alertas Webhook, a carga útil personalizada é incluída como um objeto aninhado em customPayloads. Os valores são representados como uma matriz de strings (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"]
}
}
}