> 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-google-cloud-na-elven-platform.md). # Guia Configuração do External Service Incident Google Cloud 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 **Google Cloud Monitoring** com a **Elven Platform**, permitindo o recebimento de notificações de incidentes e 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 Google Cloud Monitoring, 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 Google Cloud** * Navegue até o menu principal e clique em **Services Hub**. * Em **External Services Monitoring**, selecione o item **Incident Google Cloud**.
## **Acessando External Service Incident Google Cloud** No formulário, 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.
Em seguida, localize o **API Token** que você gerou anteriormente e selecione-o para configurar a integração com o Google Cloud.
## **Configurando Webhooks no Google Cloud** Configurar um webhook no Google Cloud Monitoring para integração com a Elven Platform é simples e direto, e garantirá que você receba notificações de forma eficiente e organizada. Vamos ao passo a passo de maneira prática e humanizada: Primeiro, acesse sua conta no Google Cloud Monitoring. No menu lateral esquerdo, clique na opção **Alerting**. Essa área centraliza a criação e gerenciamento de alertas para os eventos que você deseja monitorar.
No centro da tela, procure pelo botão **Edit Notification Channels** e clique nele. Essa seção é onde você pode adicionar, editar ou remover os canais de notificação que o Google Cloud usa para alertá-lo sobre incidentes.
Role a tela até encontrar a seção **Webhooks** e clique em **Add New**. Isso abrirá um formulário para configurar o novo canal de notificação.
Aqui, você precisará preencher dois campos essenciais: * **Endpoint URL**: insira a URL gerada na Elven Platform, fornecida ao configurar o External Service correspondente. * **Display Name**: escolha um nome que facilite a identificação desse webhook. Pode ser algo como “Alerta Elven Platform” ou qualquer outro que faça sentido para sua equipe. Depois de preencher esses campos, clique em **Save**. E pronto! Seu canal de notificação via webhook foi configurado com sucesso.
Agora, você pode vincular esse canal a qualquer monitoramento configurado no Google Cloud Monitoring e garantir que os alertas cheguem diretamente à Elven Platform, centralizando a gestão de incidentes e agilizando a tomada de decisão. Tudo isso de forma prática, eficiente e segura Assim que configurado, o serviço aparecerá no **External Services Monitoring Center**, classificado por status, facilitando o monitoramento de incidentes com prioridade para aqueles em estado de alarme. ## **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** **API Token:** Uma chave única de autenticação utilizada para estabelecer conexões seguras entre a Elven Platform e ferramentas externas, como o Google Cloud Monitoring. **Organization Settings:** Área de configurações organizacionais dentro da Elven Platform, onde é possível gerenciar permissões, tokens de API e outras configurações administrativas. **External Service Name:** Nome personalizado atribuído a um serviço externo ao configurá-lo na Elven Platform. Ele facilita a identificação do serviço integrado. **Responders:** Equipes ou pessoas definidas para receber notificações relacionadas aos incidentes gerados pelos serviços integrados. **Google Cloud Monitoring:** Serviço da Google Cloud que monitora e coleta métricas de sistemas e aplicações, permitindo a criação de alertas para eventos críticos. **Alerting:** Seção do Google Cloud Monitoring onde são configurados e gerenciados os alertas para incidentes ou eventos específicos. **Notification Channels:** Canais de notificação configurados no Google Cloud Monitoring, como webhooks, e-mails ou mensagens, usados para enviar alertas sobre incidentes. **Webhooks:** Mecanismo de integração que permite enviar notificações em tempo real de eventos ou mudanças em um serviço para outro, utilizando uma URL específica. **Endpoint URL:** Endereço gerado pela Elven Platform, utilizado no Google Cloud Monitoring para configurar o webhook e permitir a comunicação entre as plataformas. **Display Name:** Nome atribuído a um webhook ou serviço para facilitar sua identificação dentro do Google Cloud Monitoring ou da Elven Platform. **Centralização de Gestão de Incidentes:** Prática de consolidar informações e alertas de múltiplas ferramentas em uma única plataforma, como a Elven Platform, para otimizar a análise e resolução de problemas. **Integração Segura:** Processo de conectar duas plataformas, como Google Cloud Monitoring e Elven Platform, de forma que a troca de informações seja protegida por autenticação e chaves seguras, como o API Token. --- # 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-google-cloud-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.