# 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="<https://demo.elven.works/demo/cmd3gyyeo04kk3l0ialca82pt>" %}

## **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**. &#x20;
* Na aba API, clique no botão **+** para criar um novo API Token.&#x20;

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2FPQYXZfbFQHwv64ZGUm99%2Fextgcpi01.png?alt=media&#x26;token=871dbcf6-16ba-40d8-a948-9fc0cde67fe3" alt=""><figcaption></figcaption></figure>

## **Acessando External Service Alert Google Cloud**

* Navegue até o menu principal e clique em **Services Hub**. &#x20;
* Em **External Services Monitoring**, selecione o item **Incident Google Cloud**.&#x20;

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2FNYsHPK165fNk33q8qFma%2Fgcpincident.avif?alt=media&#x26;token=f06198a1-1255-48a4-be95-b1a842efb624" alt=""><figcaption></figcaption></figure>

## **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.

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2FFCJoFRc2PyesXYEhTCMP%2Fextgcpi02.png?alt=media&#x26;token=62aa9bc5-9a5c-47a8-af52-ea739ab4681d" alt=""><figcaption></figcaption></figure>

Em seguida, localize o **API Token** que você gerou anteriormente e selecione-o para configurar a integração com o Google Cloud.

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2FeGpI6jlKAihuyMB7NkCt%2Fextgcpi03.png?alt=media&#x26;token=3836f649-a9a7-4422-a33e-1cbc80dae19a" alt=""><figcaption></figcaption></figure>

## **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:&#x20;

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.

<div align="left"><figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2F4BmvjSTBECuPsVFKk39t%2Fextgcpi04.png?alt=media&#x26;token=59a1920e-91ff-4863-b262-fbfd1ea7d229" alt=""><figcaption></figcaption></figure></div>

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.&#x20;

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2FX05cBHZewW2G1OkMNbW3%2Fextgcpi05.png?alt=media&#x26;token=a4eb6f1b-3793-4b10-8bf3-032a75e3404f" alt=""><figcaption></figcaption></figure>

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.&#x20;

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2Fa985TmSO9M0FF2isKl3g%2Fextgcpi06.png?alt=media&#x26;token=d84bc997-aee4-4357-8cc4-960a35945d1a" alt=""><figcaption></figcaption></figure>

Aqui, você precisará preencher dois campos essenciais:&#x20;

* **Endpoint URL**: insira a URL gerada na Elven Platform, fornecida ao configurar o External Service correspondente.&#x20;
* **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.&#x20;

Depois de preencher esses campos, clique em **Save**. E pronto! Seu canal de notificação via webhook foi configurado com sucesso.&#x20;

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2Fkp5DLeFVK05ImlIaCkzW%2Fextgcpi07.png?alt=media&#x26;token=ca1cc49e-406e-4a6a-af5f-c01788bf82af" alt=""><figcaption></figcaption></figure>

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&#x20;

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.&#x20;

## **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.&#x20;

**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.&#x20;

**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.&#x20;

**Responders:** Equipes ou pessoas definidas para receber notificações relacionadas aos incidentes gerados pelos serviços integrados.&#x20;

**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.&#x20;

**Alerting:** Seção do Google Cloud Monitoring onde são configurados e gerenciados os alertas para incidentes ou eventos específicos.&#x20;

**Notification Channels:** Canais de notificação configurados no Google Cloud Monitoring, como webhooks, e-mails ou mensagens, usados para enviar alertas sobre incidentes.&#x20;

**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.&#x20;

**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.&#x20;

**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.&#x20;

**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.&#x20;

**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.&#x20;