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

O **Monitor GCP Function** da **Elven Platform** permite verificações baseadas em consultas chaves em funções. 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. 

**GCP Functions** é um serviço de computação serverless do Google Cloud que permite executar código em resposta a eventos, sem a necessidade de provisionar ou gerenciar servidores. Com o GCP Functions, você pode implementar funções altamente escaláveis e sob demanda, pagando apenas pelo tempo de execução e pela quantidade de recursos consumidos, eliminando custos fixos de infraestrutura. 

## **Acessando o Monitoramento GCP Function** 

* Navegue até o menu principal e clique em **Services Hub**. 
* Em **Serverless**, selecione o item **Function GCP**. 

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2FvFVhYW8sLxM24UtR0OCy%2Fgcpf01.png?alt=media&#x26;token=00f41e44-9b64-4b00-b475-0137b223f5a5" 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**.  Em seguida, insira o **Function**, que corresponde ao nome da função que você deseja monitorar. Esse nome é essencial para identificar a função específica dentro do seu ambiente GCP. Depois disso, você precisará configurar a **GCP Location**, que especifica a região onde a sua função está hospedada. Isso ajuda a Elven Platform a conectar-se corretamente ao serviço da GCP.&#x20;

Além dessa configuração é necessário uma **credencial** no formato **JSON** para autenticar a Elven Platform com o Google Cloud Functions. Você pode inserir a credencial no respectivo campo ou fazer o Upload através do botão **Upload a JSON**.  &#x20;

Por fim, a opção **Check not invoke on interval** é uma configuração importante: quando habilitada, ela irá gerar uma falha de monitoramento caso a função não seja invocada dentro do intervalo de tempo configurado. Isso ajuda a garantir que a função Lambda esteja sendo acionada regularmente, evitando inatividade e possíveis falhas no seu fluxo de trabalho.&#x20;

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2Fwoc3omkxsSSrSoS1vWhB%2Fgcpf02.png?alt=media&#x26;token=8df25b91-e1da-4b96-b4f3-cfb1037abc51" 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%2F58xm7vhvkfzK5IPwx9VW%2Fgcpf03.png?alt=media&#x26;token=e65340fb-0e52-4c7e-8bdc-b31c176fc8e4" 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.

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2FLjb4dXcfKi9aHUPmudnN%2Fgcpf04.png?alt=media&#x26;token=23363a71-ac6f-4b91-8d4a-b77898690533" 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.&#x20;

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2FyVyi803utFxjSEUfOu8F%2Fgcpf05.png?alt=media&#x26;token=cb1b4080-8d7c-4dee-99d2-96691babe3fe" alt=""><figcaption></figcaption></figure>

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

**GCP Functions:** O GCP Functions é um serviço de computação sem servidor (serverless) do Google Cloud que permite executar código em resposta a eventos, sem a necessidade de gerenciar ou provisionar servidores. Ele facilita a execução de funções de maneira escalável, eficiente e econômica, sendo ideal para tarefas em tempo real, como manipulação de dados, integração de sistemas, ou respostas a eventos de serviços como Cloud Storage, Pub/Sub ou HTTP triggers. \
&#x20;\
**Timeout:** Tempo limite para que o monitoramento receba uma resposta do recurso monitorado antes de registrar uma falha. **Checkpoint Cloud:** Local onde o agente de monitoramento está localizado, podendo ser um ambiente preexistente ou criado pelo usuário. &#x20;

**Function:** Nome da função que você deseja monitorar dentro do Google Cloud Functions. Esse nome identifica de forma única a função no ambiente GCP.&#x20;

**GCP Location:** A região geográfica onde a função está hospedada. Essa configuração é essencial para conectar corretamente a Elven Platform ao serviço Google Cloud Functions.&#x20;

**Credencial no formato JSON:** Arquivo necessário para autenticar a Elven Platform com o Google Cloud. Ele contém as permissões e informações de autenticação para acessar os serviços do GCP.&#x20;

**Upload a JSON:** Opção que permite enviar o arquivo de credenciais diretamente para a Elven Platform, facilitando a configuração de autenticação.&#x20;

**Check not invoke on interval:** Configuração que, ao ser ativada, gera uma falha de monitoramento caso a função não seja invocada dentro de um intervalo de tempo definido. Essa funcionalidade ajuda a detectar inatividade e evita possíveis interrupções no fluxo de trabalho.&#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;