Documentação
Incident ManagementO External Services Center da Elven Platform é o ponto central para integrar e gerenciar alertas de diferentes ferramentas de monitoramento. Com ele, você pode conectar o Azure Monitor à Elven Platform, garantindo que todos os alertas críticos sejam recebidos em um único lugar. Dessa forma, sua equipe pode monitorar alertas em tempo real, automatizar respostas e agir rapidamente para minimizar impactos.
API Token
Para integrar o Elven Platform com o Azure Monitor, 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 Alert Azure Monitor
Na Elven Platform, no menu superior, clique em Services Hub. Depois, procure pela opção Alert Azure Monitor e clique nela. No formulário que aparecer, 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 alertas relacionados a este serviço. Após isso, clique em CREATE para prosseguir. Essa ação criará o registro inicial do seu serviço externo.
Registrando o Provider Microsoft Insights
Para garantir que sua integração com a Elven Platform funcione corretamente, o primeiro passo é ativar o provider necessário no Azure. Acesse o Azure Portal e vá até a seção Subscriptions, onde você pode visualizar e gerenciar suas Subscriptions. Se quiser um atalho, basta usar a barra de pesquisa no topo da página e digitar Subscriptions. Em seguida, selecione a Subscription na qual deseja trabalhar. Se houver mais de uma disponível, escolha aquela que corresponde ao seu projeto.
Dentro da página da Subscription, no menu lateral, clique em Resource Providers. Essa área permite ativar e gerenciar providers de recursos essenciais para os serviços do Azure. Para encontrar rapidamente o que precisamos, digite microsoft.insights na barra de pesquisa. Assim que ele aparecer na lista, clique sobre ele e pressione o botão Register. Esse processo ativará o provider responsável pelos serviços de monitoramento, garantindo que seus alertas sejam enviados corretamente para a Elven Platform. Após a confirmação do registro, sua Subscription estará pronta para a integração, permitindo que você siga com a configuração no Azure Monitor.
Configurando Webhooks no Azure Monitor
Configurar um Webhook no Azure Monitor para integração com a Elven Platform é um processo simples e essencial para garantir que seus alertas sejam recebidos de forma eficiente. Para começar, acesse o Azure Portal e, no menu lateral, procure pela opção Monitor. Dentro dessa seção, clique em Alerts e depois vá até a aba Action Groups. Aqui, você poderá criar, visualizar e configurar grupos de ação que definem como o Azure responderá aos alertas disparados. Essa etapa é fundamental para garantir que as notificações sejam entregues corretamente à Elven Platform.
Agora, vamos criar um novo Action Group. Clique em Create e selecione um Resource Group existente ou crie um novo para organizar seus recursos de forma eficiente. Em seguida, defina um nome claro e intuitivo para o Action Group, algo que facilite a identificação de sua finalidade. Com o grupo criado, é hora de configurar as ações que serão executadas quando um alerta for disparado. Vá até a aba Actions, escolha a opção Webhook e insira a URL do webhook gerada pela Elven Platform. Essa URL será o canal de comunicação entre o Azure Monitor e a plataforma, garantindo que todos os alertas sejam enviados corretamente.
Para organizar melhor seus alertas, você pode adicionar tags que facilitam a identificação e o gerenciamento dos recursos dentro do Azure. Após definir as tags, clique em Review + Create para revisar todas as configurações antes de finalizar. Se tudo estiver correto, clique em Create para concluir o processo. Pronto! Seu Action Group foi criado com sucesso e agora os alertas do Azure Monitor serão enviados automaticamente para a Elven Platform, garantindo um fluxo de notificações eficiente e bem estruturado
Testando a Integração entre Azure Monitor e a Elven Platform
Com a configuração do Webhook finalizada, é importante testar se tudo está funcionando corretamente. Para isso, clique no Action Group recém-criado e vá até a aba Test. Esse teste permitirá validar se os alertas estão sendo enviados corretamente para a Elven Platform. Dentro dessa seção, selecione a opção Availability test alert, que ajudará a simular um alerta e verificar a integração.
Agora, clique em Test e aguarde o resultado. Se tudo estiver configurado corretamente, a notificação será enviada com sucesso para a Elven Platform. Para garantir que alerta foi realmente recebido, acesse a plataforma e verifique se o alerta chegou conforme esperado. Se tudo estiver certo, clique em Done para concluir o processo. Pronto! Seu Webhook está ativo e funcionando perfeitamente, garantindo que os alertas do Azure Monitor sejam entregues de forma rápida e eficiente.
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
Action Group: Grupo de ações no Azure Monitor que define como a plataforma responderá aos alertas disparados. Pode incluir notificações via e-mail, automações e integrações com webhooks.
API Token: Chave única de autenticação utilizada para conectar a Elven Platform ao Azure Monitor com segurança, garantindo a troca de informações autenticada.
External Service: Funcionalidade da Elven Platform que recebe e gerencia notificações de incidentes ou alertas de serviços externos, permitindo um monitoramento centralizado.
Microsoft.Insights: Provider do Azure responsável pelos serviços de monitoramento e análise. Deve ser ativado para que a integração entre o Azure Monitor e a Elven Platform funcione corretamente.
Monitor (Azure Monitor): Serviço do Azure que coleta, analisa e responde a métricas e logs dos recursos da nuvem, permitindo a criação de alertas e a integração com outras plataformas.
Resource Group: Contêiner lógico no Azure usado para organizar e gerenciar recursos, facilitando a administração e segurança da infraestrutura.
Resource Provider: Componente do Azure que gerencia recursos específicos dentro de uma subscription. No caso da integração com a Elven Platform, o provider Microsoft.Insights deve estar ativo.
Responders: Pessoas ou equipes configuradas para receber notificações de incidentes gerados pelo Azure Monitor dentro da Elven Platform.
Subscription: Assinatura do Azure que define um escopo de gerenciamento para recursos e serviços utilizados dentro da plataforma.
Tags: Etiquetas utilizadas para organizar e identificar recursos no Azure, facilitando a gestão e o rastreamento dos alertas e eventos.
Test (Teste de Integração): Processo para validar a comunicação entre o Azure Monitor e a Elven Platform, garantindo que os alertas sejam recebidos corretamente.
Webhook: Endpoint configurado para receber notificações automáticas do Azure Monitor e enviar eventos diretamente para a Elven Platform, garantindo integração contínua e em tempo real.
Whitelist de IPs: Lista de endereços IP autorizados para comunicação via API, aumentando a segurança na troca de dados entre a Elven Platform e o Azure Monitor.
Rate Limiting: Restrição de requisições para evitar sobrecarga no sistema. O tempo padrão na Elven Platform é de 5 minutos, mas pode ser ajustado conforme a necessidade.