Guia Configuração do External Service Incident Dynatrace na Elven Platform

O External Services Center da Elven Platform é a ponte que conecta você às melhores ferramentas do mercado para monitorar, gerenciar e resolver incidentes de forma simples e eficiente. Nele, é possível integrar o Dynatrace com a Elven Platform, permitindo o recebimento de notificações e eventos relacionados a incidentes diretamente na plataforma. Isso possibilita monitorar e analisar suas aplicações e serviços sob a perspectiva da Gestão de Incidentes, utilizando as melhores práticas e metodologias do mercado, tudo em um único lugar.

API Token

Para integrar o Elven Platform com Dynatrace, precisamos criar um API Token. Essa chave única é indispensável para que as duas plataformas se conectem com segurança, garantindo a troca de informações confiável e autenticada. Basta acessar o Organization Settings da Elven Platform, navegar até a seção de API e gerar.

Criando um API Token

No menu superior na parte de configuração de seu usuário, clique em Organization Settings.

Na aba API, clique no botão + para criar um novo API Token.

Acessando External Service Incident Dynatrace

Navegue até o menu principal e clique em Services Hub.

Em External Services Monitoring, selecione o item Incident Dynatrace.

Criando o External Services para Incident Dynatrace

No formulário, comece preenchendo o campo External Service Name, que será o nome do serviço externo, e defina os Responders, ou seja, as pessoas ou equipes que receberão notificações relacionadas a este serviço. Após isso, clique em CREATE para prosseguir. Essa ação criará o registro inicial do seu serviço externo.

Em seguida, localize o API Token que você gerou anteriormente e selecione-o para configurar a integração com o Dynatrace.

Configurando Webhooks no Dynatrace

Para configurar um webhook no Dynatrace e integrá-lo à Elven Platform, o processo é simples e direto. Comece acessando o painel lateral esquerdo do Dynatrace, navegando em Apps > Manage > Settings Classic. Lá, vá até a seção Integration e escolha a opção Problem Notification.

Na próxima etapa, clique em Add Notification para criar sua nova notificação. Escolha o tipo de notificação como Custom Integration e dê um nome amigável no campo Display Name para facilitar a identificação. No campo Webhook URL, insira a URL que você obteve ao configurar o serviço externo no External Service Dynatrace.

Lembre-se de ativar a opção Call Webhook if problem is Closed, garantindo que você será notificado tanto na abertura quanto no fechamento de problemas. Adicione também um cabeçalho HTTP configurando o nome como User-Agent e o valor como 1PCustomAuth/1.0.

No campo de Custom Payload, você deve colar o conteúdo fornecido pela Elven Platform. Esse payload é essencial para a integração e deve incluir os níveis de severidade, que vão de critical a informational, passando por high, moderate e low.

{

  "title": "{ProblemTitle}",

  "description": "{ProblemDetailsText}",

  "external_aggregate_key": "{Pid}",

  "action": "{State}",

  "severity": ""

}

O campo “severity” deverá ser preenchido com os seguintes valores:

critical
high
moderate
low
informational

Por fim, selecione o Alerting Profile que corresponde aos tipos de incidentes que deseja monitorar e clique em Save Changes.

Assim que configurado, o serviço aparecerá no External Services Monitoring Center, classificado por status, facilitando o monitoramento de incidentes com prioridade para aqueles em estado de alarme.

Configurações adicionais de segurança e performance

Whitelist de IPs: A comunicação via API pode ser configurada para permitir apenas IPs autorizados. Para ativar ou modificar essa configuração, entre em contato com o suporte da Elven Platform.
Rate Limiting: O tempo padrão para limitação de requisições é 5 minutos, mas pode ser ajustado conforme a necessidade. Para alterações, entre em contato com o suporte da Elven Platform.

Essas configurações garantem maior segurança e controle sobre o tráfego de dados entre os sistemas integrados.

Glossário de Termos Técnicos

API Token: Uma chave única gerada para permitir a integração segura entre plataformas, garantindo troca de informações autenticada. Na Elven Platform, ela é criada em Organization Settings, na seção API.

External Service Name: Nome designado ao serviço externo durante sua configuração na Elven Platform, utilizado para identificação e organização.

Responders: Pessoas ou equipes definidas como responsáveis por receber notificações e atuar na resolução de incidentes relacionados ao serviço integrado.

Webhook: Um método para enviar notificações ou eventos em tempo real de uma aplicação para outra. No Dynatrace, o webhook é configurado com uma Webhook URL fornecida pela Elven Platform para garantir a integração.

Webhook URL: URL fornecida pela Elven Platform usada no Dynatrace para direcionar notificações e eventos à plataforma integrada.

Custom Integration: Tipo de notificação configurada no Dynatrace para criar uma integração personalizada, permitindo especificar detalhes como payload e cabeçalhos HTTP.

Problem Notification: Funcionalidade do Dynatrace que permite configurar notificações baseadas em eventos ou incidentes monitorados pela ferramenta.

Custom Payload: Conteúdo enviado pelo Dynatrace via webhook que inclui detalhes do incidente, como nível de severidade. O formato do payload é definido pela equipe da Elven Platform.

Severity: Nível de gravidade do incidente registrado no Dynatrace, classificado como:

Critical: Problema crítico que requer atenção imediata.

High: Problema de alta prioridade.

Moderate: Problema moderado que pode impactar parcialmente o sistema.

Low: Problema de baixa prioridade.

Informational: Informações sem impacto direto no sistema.

Alerting Profile: Perfil configurado no Dynatrace para definir quais tipos de incidentes ou alertas devem ser monitorados e notificados.

User-Agent: Cabeçalho HTTP usado para identificar o cliente que faz uma requisição à API, configurado como 1PCustomAuth/1.0 no webhook do Dynatrace.

Integration: Seção no menu de configurações do Dynatrace onde é possível gerenciar integrações, como notificações de problemas (Problem Notification).

Add Notification: Opção no Dynatrace para criar uma nova notificação personalizada, usada para configurar o envio de eventos para a Elven Platform.