# Guia Gerenciamento do Synthetic Center da Elven Platform

O **Synthetic Center da Elven Platform** é o núcleo de monitoramento avançado de interações simuladas com seus serviços digitais. Ele permite configurar, gerenciar e visualizar monitoramentos sintéticos que simulam o comportamento de usuários reais, garantindo que suas aplicações e APIs estejam sempre disponíveis e funcionando como esperado. Através de verificações periódicas em URLs e outros recursos, o Synthetic Center ajuda a identificar falhas antes que elas impactem seus clientes, promovendo alta disponibilidade e confiabilidade em suas operações.&#x20;

**Importante:** Por questões de segurança, endereços IP não são permitidos. Se for necessário testar um host que é acessível somente por IP, será preciso criar um DNS antes.

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

## **Acessando o Synthetic Center**

* Navegue até o menu principal e clique em **Monitoring**. &#x20;
* No submenu, selecione item **Synthetics**.&#x20;

## **Trabalhando com Synthetic Center**

A flexibilidade é um dos pilares do Synthetic Center. Ele oferece uma interface simplificada e acessível para que você configure monitoramentos com facilidade, ajustando parâmetros como intervalos de checagem, validações de resposta e notificações automáticas. Tudo foi projetado para fornecer insights proativos, ajudando você a detectar problemas de forma rápida e tomar medidas preventivas com eficiência. Seja gerenciando interações simuladas ou integrando-se a um ambiente monitorado, o Synthetic Center entrega controle total e uma experiência intuitiva para manter suas aplicações sempre no topo do desempenho esperado.&#x20;

No **Synthetic Center** da **Elven Platform**, podemos listar nossos Synthetics configurados e fazer uma gestão eficiente e intuitiva destes. Cada Synthetic configurado aparece de forma clara e organizada, permitindo que você visualize o status de suas aplicações e APIs de maneira centralizada. Para facilitar a navegação, existe uma barra de busca pelo nome do Synthetic com filtros inteligentes que foram incorporados, possibilitando buscar por status. Os filtros por status ajudam a focar em recursos específicos, como **Inativos**, **Com Sucesso**, **Pendentes** ou aqueles com **Erros**. Se você precisa de uma visão geral, basta selecionar a opção **All**, que exibe todos os monitoramentos.

## **Maintenance Window**

Ainda no **Synthetic Center** 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, o **Synthetic Center** 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**

Por meio do Synthetic Center, 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.\
\
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, o Synthetic Center 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.

## **Criando um Synthetic**

Além disso, o **Synthetic Center** da **Elven Platform** foi desenvolvido para tornar a configuração de monitoramentos sintéticos simples e eficiente. Nele, você pode criar novos Synthetics que simulam interações com aplicações ou APIs, garantindo que falhas sejam detectadas antes de impactarem os usuários finais. Para começar, clique no botão **+ Synthetic**, dê um nome descritivo a este, escolha ou crie um ambiente (Environment) e configure parâmetros como frequência das verificações e respostas esperadas. \
\
Cada etapa do processo é personalizável para atender às suas necessidades específicas. Desde configurar healthchecks para URLs e APIs, até definir métodos HTTP (GET ou POST), headers e validações específicas. Ainda Você pode definir as **condições de sucesso** de cada etapa (ou step) com base em **dados JSON**, **códigos de status HTTP** ou **respostas textuais**.

Além disso, podemos contar com o **Response Template**, que gera automaticamente **variáveis** quando você o configura. Basta inserir um **JSON** com o nome das suas variáveis e **valores aleatórios** — ao executar o **step**, o sistema criará variáveis com os **valores atuais** retornados pela resposta da requisição. Essas **variáveis** podem ser reutilizadas nas próximas **etapas** ou **steps do fluxo** **de teste**.

**Exemplo:**\
Se seu **recurso** tem por exemplo esse **formato** JSON:

```
{
   "id":1,
   "name":"Bruno Pereira",
   "email":"bruno.pereira@elven.works",
}
```

Você pode configurar o **Response Template** da seguinte forma:

```
{
   "id":1,
   "name":"Bruno Pereira",
   "email":"bruno.pereira@elven.works"
}
```

Com isso, serão criadas as variáveis  **\[\[.id]]**, **\[\[.name]]** e **\[\[.email]]**, que poderão ser utilizadas automaticamente em etapas seguintes, como em **Buscar Usuário** ou **Atualizar Usuário**, sem necessidade de copiar manualmente esses valores. Lembrando, que podemos usar nesse JSON qualquer valor de retorno da requisição como por exemplo campos do **header** ou do **body**. Contudo, essas **variáveis geradas**, podem ser utilizadas nos seus **steps** do **fluxo de teste**, mas essas são **temporárias (ou efêmeras)**, sempre que a configuração do **Synthetic** for editada, elas serão **apagadas** e precisarão ser **criadas novamente** na próxima execução.

Essa abordagem garante um **fluxo contínuo e automático**, permitindo que dados fluam entre os **steps** com agilidade e consistência.\
\
Isso significa que você pode, por exemplo, validar todas as operações de um **CRUD** (como **criar**, **buscar**, **atualizar** e **excluir**) em etapas diferentes, **compartilhando os resultados entre elas** com estas variáveis. As **variáveis armazenadas** permitem que você aproveite **dados de uma resposta anterior** como **entrada para os próximos passos** (ou **steps**), mantendo o fluxo **dinâmico**, **inteligente** e **conectado**.\
\
Além disso tudo, com apenas alguns cliques, é possível habilitar incidentes automáticos, definir severidade e notificar equipes específicas, proporcionando um monitoramento proativo e centralizado. Tudo foi planejado para entregar controle total, simplificando o monitoramento e garantindo a confiabilidade de suas aplicações.&#x20;

## **Synthetic Steps**

Somado a tudo isso, com poucos cliques, você pode visualizar os steps de seu Synthetic, editar ou excluir este. Além disso, é muito fácil também acessar históricos de eventos e consultar incidentes diretamente na timeline. Na página do Synthetic, existem informações relevantes e organizadas de maneira intuitiva, permitindo que você tenha controle total sobre os steps e eventos sem esforço desnecessário.

## **Glossário de Termos Técnicos**&#x20;

**Synthetic Center:** Ferramenta de monitoramento da **Elven Platform** que simula interações de usuários reais com aplicações e APIs para garantir alta disponibilidade e confiabilidade.&#x20;

**Synthetics:** Monitoramentos sintéticos configurados no Synthetic Center para simular comportamentos de usuários e testar a integridade de aplicações e APIs.&#x20;

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

**Application Opening Hours:** Configuração de horários de funcionamento da aplicação para alinhar o monitoramento aos períodos em que ela está ativa, evitando alertas fora do horário de operação.&#x20;

**Steps:** Etapas configuradas em um monitoramento sintético que simulam interações específicas com uma aplicação ou API.&#x20;

**Environment:** Ambiente onde o Synthetic será executado, podendo ser previamente configurado ou criado durante a definição do monitoramento.&#x20;

**Healthcheck:** Verificação de saúde realizada periodicamente em URLs ou APIs para garantir que estão funcionando corretamente.&#x20;

**Methods HTTP (GET/POST):** Métodos utilizados para realizar requisições durante a simulação no Synthetic, como obter dados (GET) ou enviar informações (POST).&#x20;

**Headers:** Informações adicionais incluídas nas requisições HTTP para personalizar ou validar os testes simulados.&#x20;

**Response Template:** Modelo de resposta esperado configurado para validar o sucesso de uma etapa do Synthetic, com base em dados JSON, status codes ou respostas textuais.&#x20;

**Status Codes:** Códigos HTTP que indicam o resultado das requisições feitas durante os monitoramentos (ex.: 200 para sucesso, 404 para não encontrado).&#x20;

**Frequência de Verificações:** Intervalo de tempo configurado para que o Synthetic realize novas verificações na aplicação ou API.&#x20;

**Incidentes Automáticos:** Eventos criados automaticamente quando um Synthetic detecta falhas, com severidade e notificações configuráveis.&#x20;

**Severidade:** Nível de importância ou impacto associado a um incidente, configurado para priorizar ações corretivas.&#x20;

**Timeline:** Linha do tempo que apresenta o histórico de eventos e incidentes relacionados a um monitoramento sintético.&#x20;

**Histórico de Eventos:** Registro detalhado de eventos relacionados ao Synthetic, permitindo análise e acompanhamento de incidentes ocorridos.&#x20;

**Status:** Indicador que reflete a condição atual de um Synthetic, como Ativo, Com Sucesso, Pendente ou com Erros.&#x20;
