# Logs de erros de integrações

## Introdução
O formulário de **Logs de Erros de Integrações** é uma ferramenta projetada para o gerenciamento e visualização de erros ocorridos durante processos de integração com outras plataformas no sistema IXC Provedor.

Serão registrados os erros relacionados aos contratos que envolvam usuários de integrações. As integrações contempladas neste formulário são dos tipos a seguir:
- SVA;
- TV;
- MVNO;
- LTE;
- Assinatura digital;
- VoIP.

> [!NOTA] Acesso ao Formulário
> O formulário pode ser acessado através do caminho: Configurações > Logs > Logs de erros integrações.

## Objetivos do formulário
O objetivo principal do formulário de logs de erros de integrações é fornecer uma ferramenta para monitorar, diagnosticar e resolver problemas relacionados às integrações do Sistema com outras plataformas ou serviços externos. 

- **Monitoramento:** permite monitorar o status atual das integrações, oferecendo uma visão clara de gargalos para que possa ser corrigido o quanto antes;
- **Centralização de informações:** ao centralizar todos os logs de erros em um único local, o formulário facilita a identificação rápida de falhas nas integrações, permitindo uma resposta mais ágil a problemas potenciais.

## Benefícios de uso
- Detecção rápida de problemas, minimizando tempo de inatividade e reduzindo impactos negativos nos processos relacionados à integrações;
- Informações detalhadas: o formulário fornece informações detalhadas sobre cada erro, facilitando o diagnóstico da causa raíz dos problemas, acelerando o processo de resolução.

## Estrutura do formulário
O formulário Logs de Erros de Integrações é uma interface dedicada à visualização e gerenciamento de logs de comunicação entre o sistema e integrações com outras plataformas. Ele permite aos usuários acessar um ou mais registros detalhados das interações realizadas através das integrações com plataformas terceiras.

A aba Logs de Erros de Integrações é o componente principal do formulário, destinada à visualização e gerenciamento dos logs de erro das integrações. O formulário está estruturado em uma grid que reúne todos os logs de erros entre a integração do IXC Provedor e uma plataforma terceira, e é apresentado em colunas, conforme descrito na tabela a seguir: 

| Coluna                | Descrição                                                                                                          |
| --------------------- | ------------------------------------------------------------------------------------------------------------------ |
| ID                    | Identificação única do log de erro.                                                                                |
| ID contrato           | Identificação do contrato relacionado ao log de erro.                                                              |
| ID usuário integração | Identificação do registro relacionado a integração. Exemplo: ID do usuário TV, ID linha MVNO (conferir integração) |
| Tipo integração       | Tipo de integração, como TV, MVNO, SVA, LTE, Assinatura digital ou VoIP                                            |
| Data hora             | Data e hora em que o log de erro foi registrado.                                                                   |
| Status                | Estado de resolução do log de erro ("Não solucionado", "Solucionado").                                             |
| Mensagem de erro      | Descrição detalhada do erro ocorrido durante a integração.                                                         |
A aba de Logs de Erros de Integrações permite também a visualização individual de cada registro, ao selecionar um dos logs e clicar no botão "Editar". A aba em questão também permite a atualização em massa de logs para atualizar os registros de erros nas integrações. Para atualizar os logs, clique em "Atualizar logs".

### Visualizar um log
Para visualizar um log, siga os passos descritos a seguir:
1. Acesse menu **Configurações**;
2. Selecione a opção **Logs de Erros de Integrações**;
3. A grid de logs será apresentada. Se necessário, aplique os filtros na barra de consulta para uma busca específica;
4. Para visualizar um log específico, selecione-o e clique no botão de **Editar** para um detalhamento individual do log;

Ao visualizar o log, o sistema apresentará suas informações individuais, conforme os campos descritos nas colunas.

### Atualizar log
Para Atualizar os logs de erro, siga os passos descritos a seguir:
1. Acesse menu **Configurações**;
2. Selecione a opção **Logs de Erros de Integrações**;
3. A grid de logs será apresentada.
4. Para atualizar os logs de erro em massa, clique em **Atualizar logs** e aguarde o sistema finalizar a atualização. Recarregue a grid e visualize os dados atualizados.

### Atualizar log individualmente
A opção de Atualizar log individualmente está disponível para erros de timeout na integração.
Para Atualizar um logs de erro individualmente, siga os passos descritos a seguir:
1. Acesse menu **Configurações**;
2. Selecione a opção **Logs de Erros de Integrações**;
3.  A grid de logs será apresentada. Se necessário, aplique os filtros na barra de consulta para uma busca específica;
4. Para visualizar um log específico, selecione-o e clique no botão de **Editar** para um detalhamento individual do log;
5. Clique em **Atualizar log individual** para efetuar a atualização de statu somente do log em questão.

### Campos Obrigatórios

| Campo | Descrição |
|-------|-----------|
| ID | Identificador único do registro de log |
| ID contrato | Identificador do contrato associado ao erro |
| Tipo integração | Tipo de integração relacionada ao erro |
| Data hora | Data e hora em que o erro ocorreu |
| Status | Estado atual do erro (solucionado ou não) |
| Mensagem de erro | Detalhes da mensagem de erro gerada |

## Funcionalidades principais
### Logs de erros
Esta seção exibe todos os registros de erros de integrações, fornecendo uma visão geral dos problemas ocorridos durante os processos de integração.

### Atualização de log individual
Esta funcionalidade permite a atualização de informações específicas de um log de erro selecionado. 

## Fluxo de utilização
```mermaid
graph TD
    A[Acessar formulário] --> B[Aplicar filtros]
    B --> C{Erros detectados?}
    C -->|Sim| D[Analisar detalhes do erro]
    C -->|Não| E[Monitorar regularmente]
    D --> F[Iniciar resolução de problemas]
    F --> G[Resolver problema]
    G --> H[Atualizar log]
    H --> E

```

## Casos de Uso

### Monitoramento de Erros de Integração
O formulário de Logs de Erros de Integrações é crucial para o monitoramento contínuo da saúde das integrações do sistema. Permite identificar rapidamente problemas recorrentes ou críticos que possam afetar as operações da empresa.

### Resolução de Problemas
Ao fornecer informações detalhadas sobre cada erro, incluindo a mensagem de erro específica, o formulário facilita o processo de resolução de problemas, permitindo que a equipe técnica identifique e resolva problemas de forma mais eficiente.

## Fluxo de Trabalho

```mermaid
graph TD
    A[Ocorrência de Erro] --> B[Registro no Log]
    B --> C{Análise do Erro}
    C --> D[Resolução do Problema]
    C --> E[Atualização do Status]
    D --> F[Verificação da Solução]
    E --> F
    F --> G[Fechamento do Log]
```

## Considerações Finais
O formulário de Logs de Erros de Integrações é uma ferramenta vital para manter a integridade e eficiência das integrações do sistema. Seu uso adequado pode significativamente reduzir o tempo de inatividade e melhorar a qualidade geral dos serviços oferecidos pela empresa.

---

## Etiquetas
#Logs #Integracoes

## Leia Também
- [[integracoes|Integrações]]
- [[integracoes mvno telefonia movel|Integrações MVNO Telefonia Móvel]]
- [[integracoes de telefonia fixa|Integrações de Telefonia Fixa]]
- [[integracoes de tv|Integrações de TV]]
- [[integracoes de sva|Integrações de SVA]]
- [[integracoes olt|Integrações OLT]]