# Guia Configuração do Monitor GCP PubSub na Elven Platform

O **Monitor GCP PubSub** da **Elven Platform** permite verificações baseadas em consultas chaves no **tópico** do **GCP Pub/Sub.** Essa funcionalidade ajuda a configurar verificações contínuas, definir alertas e criar limites para abertura de incidentes automáticos, garantindo que você seja informado rapidamente sobre quaisquer irregularidades na conectividade ou desempenho dos serviços. 

O **Google Cloud Pub/Sub** é um serviço de mensageria gerenciado pela Google Cloud, projetado para facilitar a comunicação assíncrona e escalável entre sistemas distribuídos. Ele permite a publicação e o consumo de mensagens em tempo real, oferecendo um mecanismo de troca de mensagens entre produtores e consumidores de dados de forma flexível e eficiente. Ideal para cenários como integração de sistemas, arquiteturas de microsserviços e processamento de eventos em tempo real, o Pub/Sub simplifica a construção de sistemas resilientes e escaláveis, eliminando a necessidade de gerenciar a infraestrutura de filas e tópicos.

## **Acessando o Monitoramento GCP PubSub**

* Navegue até o menu principal e clique em **Services Hub**. 
* Em **Queue**, selecione o item **PubSub (GCP).** 

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2F7dz1beTTZ9xvH6XBOhRa%2Fgcpmsp01.png?alt=media&#x26;token=905ea8c6-9ac1-4e0f-9eb5-bace70148911" alt=""><figcaption></figcaption></figure>

## **Configuração do Monitoramento**

Monitorar a disponibilidade dos seus serviços nunca foi tão simples. Comece dando um nome claro ao recurso que deseja acompanhar (**Resource Name**) para facilitar a identificação. Depois, ajuste o intervalo entre as verificações (**Interval**) e o tempo limite para respostas (**Timeout**).    &#x20;

Selecione onde está o agente de monitoramento (**Checkpoint Cloud**), escolhendo Environment, se não existir você pode criar em **+ Checkpoint**. Após essa configuração, preencha o campo **Topic**. Este permite especificar o tópico que será monitorado no serviço **Google Cloud Pub/Sub** pela **Elven Platform**. No Pub/Sub, os tópicos são canais de comunicação que enviam mensagens para os assinantes. Além dessa configuração é necessário uma **credencial** no formato **JSON** para autenticar a Elven Platform com o Google Cloud Pub/Sub. Você pode inserir a credencial no respectivo campo ou fazer o Upload através do botão **Upload a JSON**.

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2FSikxdVzOrlFSzLnuXxnr%2Fgcpmsp02.png?alt=media&#x26;token=ff3fc024-c74f-4cac-80a5-e84a19cc2fc0" alt=""><figcaption></figcaption></figure>

## **Abertura de Incidentes Automáticos**

Você pode configurar a abertura automática de incidentes para garantir uma resposta rápida a problemas críticos. Para começar, defina a severidade do incidente, permitindo que você priorize de acordo com a urgência. Em seguida, ajuste o **Check Interval**, especificando o intervalo de checagem em segundos para monitorar continuamente o recurso. Isso ajuda a garantir que você esteja sempre um passo à frente, detectando problemas assim que eles surgem.  &#x20;

Além disso, selecione o time que será notificado sempre que um incidente ocorrer e ative a opção **Enable to set up automatic incidents opening** para garantir que a configuração esteja habilitada. Com essa configuração, a plataforma automatiza a gestão de incidentes, tornando o processo de resposta mais ágil e eficiente, sem a necessidade de intervenção manual. Isso garante que sua equipe esteja sempre pronta para resolver qualquer questão com rapidez e precisão.

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2FL31TiSKu10rNlVenzBvZ%2Fgcpmsp03.png?alt=media&#x26;token=e71ed242-5b8e-4d67-8442-29f734b19df7" alt=""><figcaption></figcaption></figure>

## **Maintenance Window**

Ainda  temos **Maintenance Window** que é uma funcionalidade essencial para gerenciar períodos de manutenção planejada na sua aplicação. Durante esse intervalo, as verificações são temporariamente pausadas, evitando que o monitoramento, alertas e notificações sejam acionados enquanto você realiza ajustes ou atualizações. Isso permite que a manutenção ocorra de maneira tranquila, sem gerar notificações desnecessárias ou alarmes falsos, garantindo que sua operação siga de forma ordenada e sem interrupções inesperadas nos relatórios de desempenho.    \
&#x20;\
Por exemplo, imagine que você precise atualizar o sistema de pagamento de um e-commerce, realizando ajustes no backend, como a instalação de novos certificados de segurança. Para isso, você pode configurar a **Maintenance Window** para um horário específico, como 13/12/2024, das 14:00 às 14:30. Durante esse período, a Elven Platform suspende as verificações, evitando que o monitoramento registre falhas temporárias ou dispare alertas falsos. Assim, você consegue fazer as alterações necessárias com calma, sabendo que o sistema de monitoramento não será impactado durante a manutenção. Essa abordagem garante que a atualização seja feita de maneira organizada, sem afetar a experiência dos usuários ou gerar notificações indesejadas.&#x20;

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2Fx6TSY6FFxu1xePOczyT4%2Fgcpmsp04.png?alt=media&#x26;token=dbfcc1b5-1ba1-4e9a-a720-6bdcb58477fa" alt=""><figcaption></figcaption></figure>

## **Application Opening Hours**

Ainda, você pode contar com a funcionalidade **Application Opening Hours**, que permite configurar os horários de funcionamento da sua aplicação. Essa funcionalidade é essencial para personalizar o monitoramento com base nos períodos em que sua aplicação está realmente ativa, evitando alertas e notificações fora do horário de operação. Assim, o monitoramento se torna mais alinhado com as necessidades reais do seu negócio, garantindo relatórios mais precisos e uma gestão eficiente.   &#x20;

Por exemplo, imagine que sua aplicação funcione apenas de segunda a sexta-feira, das 09:00 às 18:00. Você pode configurar o **Application Opening Hours** para refletir esse horário, especificando os dias e períodos de funcionamento. Com isso, a Elven Platform desativa automaticamente as verificações fora desses horários, evitando registros de falhas que não afetam os usuários finais e prevenindo alertas desnecessários. Essa abordagem otimiza a análise de desempenho, focando somente nos períodos relevantes e proporcionando uma visão mais clara sobre a saúde da sua aplicação durante seu horário de operação.

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2FklYX64SdLr6MKqUeGoa6%2Fgcpmsp05.png?alt=media&#x26;token=bd970138-a869-4b42-a21f-dd59054d064f" alt=""><figcaption></figcaption></figure>

## **Glossário de Termos Técnicos**

**Pub/Sub:** Serviço de mensageria gerenciado da Google Cloud, projetado para comunicação assíncrona e escalável entre sistemas distribuídos. Facilita o desacoplamento de produtores e consumidores de mensagens, permitindo o processamento de dados em tempo real. Oferece alta disponibilidade, escalabilidade automática e suporte a padrões de publicação/assinatura com entrega garantida. Ideal para integração de sistemas, arquiteturas de microsserviços e processamento de eventos em tempo real, com a praticidade de uma solução totalmente gerenciada.&#x20;

**Interval:** Intervalo de tempo entre as verificações automáticas realizadas no monitoramento. &#x20;

**Timeout:** Tempo limite para que o monitoramento receba uma resposta do recurso monitorado antes de registrar uma falha. &#x20;

**Checkpoint Cloud:** Local onde o agente de monitoramento está localizado, podendo ser um ambiente preexistente ou criado pelo usuário. &#x20;

**Topic**: Este campo permite especificar o tópico que será monitorado no serviço Google Cloud Pub/Sub. No Pub/Sub, os tópicos são canais de comunicação que enviam mensagens para os assinantes. Configurar corretamente o tópico é essencial para garantir que a Elven Platform capture e monitore os dados de comunicação entre sistemas, ajudando a identificar problemas, medir o desempenho e garantir que mensagens sejam entregues conforme esperado.&#x20;

**Credentials (JSON)**: Este campo é usado para inserir as credenciais no formato JSON necessárias para autenticar a Elven Platform com o Google Cloud Pub/Sub. Essas credenciais geralmente são geradas no Google Cloud Console e contêm as permissões necessárias para acessar os tópicos e assinaturas. Configurar este campo corretamente é crucial para estabelecer a conexão segura e permitir que a Elven Platform monitore o serviço sem interrupções ou erros de autenticação.&#x20;

**Enable to set up automatic incidents opening:** Opção que, quando ativada, habilita a abertura automática de incidentes na detecção de problemas críticos. &#x20;

**Severity (Severidade):** Grau de criticidade atribuído a um incidente, permitindo sua priorização conforme a urgência. &#x20;

**Check Interval:**  \
Intervalo de tempo, em segundos, para realizar verificações contínuas do recurso monitorado. &#x20;

**Maintenance Window:** Funcionalidade que pausa temporariamente o monitoramento, alertas e notificações durante os períodos de manutenção planejada. &#x20;

**Application Opening Hours:** Configuração que define os horários de funcionamento da aplicação, alinhando o monitoramento aos períodos ativos e evitando alertas fora desses horários.&#x20;