> For the complete documentation index, see [llms.txt](https://docs.elven.works/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.elven.works/elven-platform/elven-incident/external-services/guia-configuracao-do-external-service-incident-azure-monitor-na-elven-platform.md). # Guia Configuração do External Service Incident Azure Monitor 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 **Azure Monitor** com a **Elven Platform**, permitindo o recebimento de notificações de 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. {% 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 Incident Azure Monitor** Na **Elven Platform**, no menu superior, clique em **Services Hub**. Depois, procure pela opção **Incident 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 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. ## **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 notificações de incidentes 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 todas as notificações sejam enviadas corretamente. Para organizar melhor seus alertas ou eventos, 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 as notificações estão sendo enviadas 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 o notificação foi realmente recebida, acesse a plataforma e verifique se a notificação chegou conforme esperado. Se tudo estiver certo, clique em **Done** para concluir o processo. Pronto! Seu **Webhook está ativo e funcionando perfeitamente**, garantindo que as notificações 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. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.elven.works/elven-platform/elven-incident/external-services/guia-configuracao-do-external-service-incident-azure-monitor-na-elven-platform.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.