# Guia Configuração do External Service Alert 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 alertas 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/cmd3gza0b036z130ibkez0bd1>" %}

## **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%2FOimaoiHrDsczjBXOwXb2%2Fextgcpa01.png?alt=media&#x26;token=19daacc6-04a8-46d5-8e35-9b69602967cc" 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 **Alert Google Cloud**.&#x20;

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2FhWJXwTaGSdpRxMQxNPfu%2Fextgcp02.png?alt=media&#x26;token=ffe6a715-056b-4c06-a1fb-1a122c866624" alt=""><figcaption></figcaption></figure>

## **Criando o External Services para Alert Google Cloud**&#x20;

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%2FqqLwSkA6rYR0CX5g4inS%2Fextgcp03.png?alt=media&#x26;token=2049c341-3f92-4483-8c05-112b7b63e40b" 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%2FpC4YwXgYqMhQluuCbHt0%2Fextgcpa04.png?alt=media&#x26;token=92847891-83c6-4dcc-a632-0f9e52cf7c49" 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.&#x20;

<div align="left"><figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2F97ZueJkyBmfQoZ3afaSt%2Fextgcpa05.png?alt=media&#x26;token=96e283bf-2a22-47b2-8f09-73123e614394" 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%2FyG1QZvb92hlRd163PuBs%2Fextgcpa06.png?alt=media&#x26;token=77181999-2af0-4e0e-b8a8-e62bd6f9a91e" 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%2FD0B6zD74cJL0Di82Wgxx%2Fextgcpa07.png?alt=media&#x26;token=7ee9ed94-0974-4654-8f7d-048cf72875f6" 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%2FfIXHEs9A0xB7Du5OY1W8%2Fextgcpa08.png?alt=media&#x26;token=94014c61-5bba-4370-bf9a-d61dd8ebc1a4" 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;