# Guia Configuração do Monitor Service Bus (Azure) na Elven Platform

O **Monitor Service Bus(Azure)** da **Elven Platform** permite verificações baseadas em consultas chaves em fila ou tópicos do Service Bus da Azure. 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 **Azure Service Bus** é um serviço de mensageria gerenciado pela Microsoft Azure, projetado para oferecer comunicação assíncrona e confiável entre sistemas distribuídos. Ele facilita a troca de mensagens entre produtores e consumidores de dados, permitindo a criação de soluções escaláveis e resilientes. Com suporte a filas, tópicos e assinaturas, o Service Bus é ideal para cenários como integração de aplicações, arquiteturas de microsserviços e processamento de eventos em tempo real. Sua infraestrutura gerenciada elimina a necessidade de configuração e manutenção de filas, simplificando o desenvolvimento de sistemas robustos e eficientes na nuvem.

## **Acessando o Monitoramento Service Bus (Azure)**

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

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2FxNOnawIYAgH8k5DPdk3R%2Fazurebus01.png?alt=media&#x26;token=94a277c6-d0ef-4d1d-9f39-55fd0859dcff" 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, para começar a monitorar o Azure Service Bus na Elven Platform, basta preencher alguns campos essenciais que vão permitir a conexão e o acompanhamento das mensagens da sua fila ou tópico. Vamos guiar você por cada um deles de forma simples e direta.&#x20;

**Connection String** é o ponto de partida. Pense nela como o endereço e a chave que permitem que a Elven Platform se conecte ao seu namespace no Azure Service Bus. Copie a *Connection String* diretamente do portal Azure, onde ela está disponível nas configurações de acesso compartilhado (Shared Access Policies). Sem isso, a Elven Platform não consegue “enxergar” suas filas ou tópicos.&#x20;

Depois, escolha o **Monitoring Type**: se você quer monitorar uma fila (Queue), ideal para processar mensagens sequencialmente e com um único consumidor, ou um tópico (Topic), perfeito para cenários em que múltiplos assinantes precisam receber as mensagens. Dependendo da sua escolha, preencha o campo correspondente: **Queue Name**, caso esteja usando filas, ou **Topic Name** e **Subscription Name**, se estiver trabalhando com tópicos. Esses nomes devem ser exatamente os mesmos configurados no seu Azure Service Bus.

### Monitoring Type: Queue

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2FJtoeV6FV5vr6k9mRjnWR%2Fazurebus02.png?alt=media&#x26;token=7116374b-f9fd-4179-a20d-858cd8ecd945" alt=""><figcaption></figcaption></figure>

### Monitoring Type: Topic

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2FfhfGAW1RDak5Oa558pSq%2Fazurebus03.png?alt=media&#x26;token=0f6658b7-c5f8-47f9-a2f6-fb63843fa4ed" 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. &#x20;

<figure><img src="https://1787513308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjv1RurNOS0w2Y9bpxizM%2Fuploads%2FotAINZwq75G46GBxyeN3%2Fazurebus04.png?alt=media&#x26;token=e7cf3fc0-9165-4075-ae44-b6d2e32b582c" 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%2FLMigp366Oo7G8E3yipXb%2Fazurebus05.png?alt=media&#x26;token=8cd6dea4-9151-4a6e-8572-f032fa84c5b3" 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%2F9dCHjnPiBEaCQvwKqPI4%2Fazurebus06.png?alt=media&#x26;token=69b5e94f-8d85-4694-9e53-1c134412b38d" alt=""><figcaption></figcaption></figure>

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

**Azure Service Bus:** Serviço de mensageria gerenciado da Microsoft Azure, projetado para comunicação assíncrona e confiável entre sistemas distribuídos. Permite o desacoplamento de produtores e consumidores de mensagens, garantindo a entrega ordenada e segura de dados. Suporta filas, tópicos e assinaturas, além de fornecer recursos avançados como agendamento de mensagens, sessões para mensagens relacionadas e processamento transacional. Ideal para integração de aplicações, arquiteturas de microsserviços e gerenciamento de workflows em larga escala, com a conveniência de uma solução gerenciada e altamente escalável. \
&#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. **Checkpoint Cloud:** Local onde o agente de monitoramento está localizado, podendo ser um ambiente preexistente ou criado pelo usuário. &#x20;

**Connection String:** Uma cadeia de conexão que contém o endereço do namespace do Azure Service Bus, a política de acesso compartilhado (*Shared Access Policy*) e a chave de acesso. Permite que a Elven Platform autentique e se conecte ao Azure Service Bus para monitorar filas ou tópicos. \
\
**Namespace:** Um contêiner lógico no Azure que agrupa filas, tópicos e outros recursos do Service Bus. É o ponto central de comunicação para enviar e receber mensagens.&#x20;

**Shared Access Policies (Políticas de Acesso Compartilhado):** Configurações no Azure Service Bus que definem permissões de acesso (como enviar, receber ou gerenciar mensagens) por meio de chaves de acesso. Necessário para gerar a *Connection String* usada na Elven Platform.&#x20;

**Queue (Fila):** Um recurso de mensageria usado para armazenar mensagens temporariamente até que sejam processadas por um único consumidor. Ideal para cenários em que mensagens devem ser processadas sequencialmente.&#x20;

**Topic (Tópico):** Um recurso que permite que múltiplos assinantes recebam mensagens publicadas. Ideal para distribuição de mensagens para diferentes consumidores com necessidades específicas.&#x20;

**Queue Name (Nome da Fila):** O nome atribuído à fila configurada no Azure Service Bus. Necessário para identificar qual fila será monitorada pela Elven Platform.&#x20;

**Topic Name (Nome do Tópico): Definição:** O nome atribuído ao tópico configurado no Azure Service Bus. Necessário para identificar qual tópico será monitorado pela Elven Platform.&#x20;

**Subscription Name (Nome da Assinatura):** O nome de uma assinatura associada a um tópico, que filtra ou organiza as mensagens publicadas no tópico. Necessário para monitorar mensagens específicas dentro de um tópico. \
&#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.