# Guia Configuração do External Service Alert Azure Monitor na Elven Platform O **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. {% embed url="" %} ## **API Token** Para integrar a **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.