Introdução
Este documento descreve como configurar eventos personalizados no AppDynamics usando a API REST e conectá-los às regras de integridade para alerta automatizado.
Pré-requisitos
- Acesso a uma instância do AppDynamics SaaS ou Controlador local
 
- Permissões para criar e gerenciar eventos, regras de integridade e políticas
 
- Controlador versão 21.x ou posterior
 
- Canais de notificação (e-mail, SMS ou integrações de terceiros) configurados
 
- Compreensão básica das APIs REST e da interface do usuário do AppDynamics
 
Requisitos
Certifique-se de atender a estes requisitos antes de iniciar:
- AppDynamics Controller versão 21.x ou posterior (para os recursos mais recentes de eventos e alertas)
 
- Acesso à API REST habilitado para seu Controlador
 
- Canais de notificação (e-mail, sms ou integrações) configurados para a entrega de alertas
 
Componentes Utilizados
- Controlador AppDynamics
 
- Agentes do AppDynamics
 
- Canais de notificação
 
As informações neste documento foram criadas a partir de dispositivos em um ambiente de laboratório específico. Todos os dispositivos utilizados neste documento foram iniciados com uma configuração (padrão) inicial. Se a rede estiver ativa, certifique-se de que você entenda o impacto potencial de qualquer comando.
Informações de Apoio
Em um mundo de arquiteturas nativas de nuvem cada vez mais dinâmicas, o monitoramento pró-ativo é essencial para garantir a resiliência do sistema e reduzir o tempo médio para resolução (MTTR). O AppDynamics oferece recursos robustos de observação, incluindo a capacidade de criar eventos e alertas personalizados que ajudam as equipes de operações a detectar anomalias mais rapidamente e responder com precisão.
As métricas prontas para uso são essenciais, mas os sistemas modernos geralmente exigem observabilidade específica ao contexto. Independentemente de você estar integrando pipelines de CI/CD, ferramentas de automação personalizadas ou sistemas externos, a injeção de eventos personalizados no AppDynamics garante:
- Visibilidade unificada em métricas de sistema e de negócios
 
- Detecção em tempo real de anomalias específicas do aplicativo
 
- Intervenção manual reduzida por meio de ações automatizadas
 
Às vezes, faz sentido criar eventos personalizados para monitorar aspectos específicos do aplicativo. O objetivo deste artigo é orientá-lo sobre como criar eventos personalizados por meio da API REST no controlador do AppDynamics e como configurar um alerta com base no evento personalizado.
Configurar
Esta seção abrange o processo passo a passo para criar eventos personalizados e configurar alertas no AppDynamics Controller.
Configurações
Passo 1: Criar eventos personalizados via API REST
Eventos personalizados podem ser gerados usando a API REST do AppDynamics. Isso é útil para integrar sistemas externos, scripts personalizados, estrutura de automação ou ferramentas de terceiros:
Exemplo de chamada à API:
POST https:///controller/rest/applications//events?severity=ERROR&summary=Application+Stopped&eventtype=CUSTOM&customeventtype=App_Stop&comment=Please_start_application
Parâmetros principais:
- Substitua <controller-url> e <application_id> pelos detalhes do seu Controlador.
 
- Parâmetros exigidos:
- severidade (INFO, WARN, ERROR)
 
- resumo (breve descrição)
 
- eventtype (deve ser CUSTOM)
 
- customeventtype (seu rótulo de tipo de evento personalizado)
 
- comentário (mensagem detalhada opcional)
 
 
Uma solicitação bem-sucedida retorna uma ID de evento confirmando a criação
Exemplo: "ID do evento criada com êxito:550346816"
Dica de visibilidade: Não se esqueça de ativar o filtro Personalizado na IU Eventos para visualizar os eventos injetados.
 

Passo 2: Filtragem e monitoramento de eventos personalizados
- Na IU da controladora, navegue para a seção Eventos.
 
- Use Filtrar por eventos personalizados para adicionar o tipo ou as propriedades do evento.
- Você pode especificar pares de chave/valor para uma filtragem mais granular.
 
- Use a lógica All para AND (todas as propriedades devem corresponder) ou Any para a lógica OR (pelo menos uma propriedade corresponde)
 
 
Isso permite o rastreamento direcionado e a investigação de eventos injetados em seu aplicativo.
Passo 3: Configurando alertas: Ações e políticas
Ações:
- Especifique o que acontece quando um evento personalizado é disparado (como enviar email, sms ou chamar um webhook):

 
Políticas:
- Criar uma nova política ou editar uma existente:

 
- Na política, configure o filtro de evento personalizado para corresponder ao evento personalizado definido.
 
  

- Na guia Ações de política, adicione uma nova ação e selecione a ação personalizada que você criou:

 
- Salve o alerta: Depois de configurar o alerta, clique em Salvar para criá-lo:

 
Depois que você cria o alerta, ele é acionado sempre que um evento personalizado que corresponde aos critérios especificados é gerado no controlador. 
Verificar
- Postar um evento personalizado de teste via API REST:

 
- Confirme a visibilidade na interface do usuário Events (verifique os filtros):

 
- Valide se a Ação é disparada para o Evento personalizado:
 
  
- Validar a entrega por meio do canal de notificação configurado:
 


Troubleshooting
| Problema | 
Passos de Troubleshooting | 
| 
 Evento Não Visível 
 | 
- Verifique se o filtro Custom está habilitado para eventtype na interface de usuário Events
 
- Verifique novamente os parâmetros eventtype e customeventtype na chamada à API.
 
 
 | 
| 
 Erros de API 
 | 
- Erro comum: "O resumo do evento não foi especificado." Sempre forneça um resumo em sua solicitação
 
- Verifique a autenticação e a ID do aplicativo na chamada à API.
 
 
 | 
| 
 Alerta não disparado 
 | 
- Confirme se a regra de integridade e a política estão configuradas corretamente.
 
- Verifique a configuração do canal de notificação (configuração do servidor de email/sms).
 
 
 | 
| 
 Limites de Eventos Personalizados 
 | 
- O controlador tem limites na contagem de esquema de evento personalizado e no tamanho do evento.
 
- Revise a documentação se estiver lançando grandes volumes ou esquemas complexos
 
 
 | 
Conclusão
Eventos e alertas personalizados no AppDynamics oferecem uma maneira poderosa de enriquecer sua estratégia de observação. Não importa se você está se integrando com ferramentas de CI/CD, serviços externos ou apenas estendendo a visibilidade dos principais fluxos de trabalho, esses recursos garantem detecção e resolução mais rápidas de problemas antes que eles afetem os usuários. Comece a aproveitar a inteligência de observação personalizada para elevar seu monitoramento de reativo para preditivo.
Precisa de mais assistência
Se você tiver uma dúvida ou estiver com problemas, entre em contato com o Suporte do AppDynamics e inclua detalhes como mensagens de erro, informações de configuração ou logs relevantes para ajudar a acelerar a solução de problemas.
Informações Relacionadas