# Guia Configuração do Monitor via gRPC na Elven Platform

O **Monitor via gRPC** da **Elven Platform** permite monitorar servicos utilizando chamadas gRPC. Essa funcionalidade ajuda a configurar verificacões contínuas, definir alertas e criar limites para abertura de incidentes automáticos, garantindo que você saiba rapidamente quando algo estiver fora do esperado.&#x20;

O **gRPC** é um **framework** de chamadas de procedimento remoto de alto desempenho que utiliza o protocolo HTTP/2. Ele permite que clientes e servidores se comuniquem com métodos definidos em uma interface. Com o monitoramento gRPC, você pode verificar a disponibilidade e o desempenho de seus servicos gRPC, garantindo a integridade das comunicações entre sistemas.&#x20;

{% embed url="<https://demo.elven.works/demo/cmd37ujz40am8z70iaii7u2as>" %}

## **Acessando o Monitoramento gRPC**&#x20;

* Navegue até o **menu principal** e clique em **Services Hub**.&#x20;
* Em **Internet Services**, selecione o item **gRPC**.&#x20;

## **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, insira o host e a porta do recurso que será monitorado. Lembre-se de que o campo de **Host** aceita apenas **URLs**; caso precise utilizar um endereço **IP**, será necessário criá-lo em um **secret** para garantir a segurança e organização das informações.&#x20;

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

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

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

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

**gRPC (Remote Procedure Call):** Framework de alto desempenho que utiliza o protocolo HTTP/2 para permitir a comunicação eficiente entre clientes e servidores por meio de chamadas de procedimento remoto.&#x20;

**HTTP/2:**  Protocolo de rede que melhora a eficiência e o desempenho das comunicações web, utilizado pelo gRPC para transmitir mensagens entre clientes e servidores.&#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;

**Host:** Endereço (URL) do recurso monitorado. Caso seja necessário usar um endereço IP, ele deve ser armazenado em um Secret para maior segurança.&#x20;

**Secret:** Recurso utilizado para armazenar informações sensíveis, como endereços IP ou credenciais, garantindo segurança e organizaçã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 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;
