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