As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Conectando o Grafana

A integração com o Grafana permite que o AWS DevOps Agente consulte métricas, painéis e dados de alerta de sua instância do Grafana durante investigações de incidentes. Essa integração segue um processo de duas etapas: registro do Grafana em nível de conta, seguido pela conexão com Espaços de Agentes individuais.

Para melhorar a segurança, a integração com o Grafana permite apenas ferramentas somente para leitura. As ferramentas de gravação estão desativadas e não podem ser ativadas. Isso significa que o agente pode consultar e ler dados da sua instância do Grafana, mas não pode criar, modificar ou excluir nenhum recurso do Grafana, como painéis, alertas ou anotações. Para obter mais informações, consulte Segurança no AWS DevOps Agente.

Requisitos do Grafana

Antes de conectar o Grafana, certifique-se de ter:

Registrando o Grafana (nível da conta)

O Grafana é registrado no nível da AWS conta e compartilhado entre todos os espaços do agente nessa conta. Cada registro corresponde a uma instância do Grafana. Para registrar instâncias adicionais do Grafana, repita esse processo para cada uma e dê a cada registro seu próprio nome de serviço.

Etapa 1: configurar o Grafana

Etapa 2: revisar e enviar o registro do Grafana

Adicionando Grafana a um Agent Space

Depois de registrar o Grafana no nível da conta, você pode conectá-lo a espaços de agentes individuais:

Um único Agent Space pode usar mais de um registro do Grafana. Para conectar outro registro, repita essas etapas.

Configurando webhooks de alerta do Grafana

Você pode configurar o Grafana para acionar automaticamente as investigações do AWS DevOps agente quando os alertas forem disparados, enviando webhooks por meio dos pontos de contato do Grafana. Para obter detalhes sobre métodos de autenticação de webhook e gerenciamento de credenciais, consulte. Invocando o DevOps agente por meio do Webhook

Se você perder o segredo do webhook, gire o webhook para gerar um novo segredo. O URL do webhook não muda. Para obter instruções sobre como gerenciar credenciais de webhook, consulte Gerenciando credenciais de webhook.

Etapa 1: criar um modelo de notificação personalizado

Na sua instância do Grafana, navegue até Alertas > Pontos de contato > Modelos de notificação e crie um novo modelo com o seguinte conteúdo:

{{ define "devops-agent-payload" }}
{
  "eventType": "incident",
  "incidentId": "{{ (index .Alerts 0).Labels.alertname }}-{{ (index .Alerts 0).Fingerprint }}",
  "action": "{{ if eq .Status "resolved" }}resolved{{ else }}created{{ end }}",
  "priority": "{{ if eq .Status "resolved" }}MEDIUM{{ else }}HIGH{{ end }}",
  "title": "{{ (index .Alerts 0).Labels.alertname }}",
  "description": "{{ (index .Alerts 0).Annotations.summary }}",
  "service": "{{ if (index .Alerts 0).Labels.job }}{{ (index .Alerts 0).Labels.job }}{{ else }}grafana{{ end }}",
  "timestamp": "{{ (index .Alerts 0).StartsAt }}",
  "data": {
    "metadata": {
      {{ range $k, $v := (index .Alerts 0).Labels }}
      "{{ $k }}": "{{ $v }}",
      {{ end }}
      "_source": "grafana"
    }
  }
}
{{ end }}

Este modelo formata os alertas do Grafana na estrutura de carga útil do webhook esperada pelo Agente. AWS DevOps Ele mapeia rótulos de alerta, anotações e status nos campos apropriados e inclui todos os rótulos de alerta como metadados.

Etapa 2: criar um ponto de contato de webhook

Etapa 3: atribuir o ponto de contato a uma política de notificação

Quando um alerta correspondente for acionado, o Grafana enviará a carga formatada ao AWS DevOps Agente, que iniciará uma investigação automaticamente.

Limitações

Considerações sobre o Amazon Managed Grafana

Se você estiver usando o Amazon Managed Grafana (AMG), esteja ciente das seguintes limitações:

Gerenciando conexões do Grafana