# Problemas

Acompanhe anomalias recorrentes do sistema (falhas de sincronização de diretórios, de aprovisionamento e de metadados), agrupadas e tratadas até à resolução.

Um **problema** é uma anomalia *do sistema* recorrente que a plataforma detetou por si própria: uma falha operacional que ocorre em segundo plano e tende a repetir-se. Onde o [registo de auditoria](https://dts-identity.com/pt/docs/monitoring/audit-logs.md) regista eventos individuais, os problemas juntam muitas ocorrências do mesmo problema subjacente numa única entrada que pode acompanhar até à resolução: um diretório cuja sincronização falha de hora a hora aparece assim como **um** problema com uma contagem de ocorrências crescente, em vez de dezenas de linhas de registo dispersas.

Encontra-a na Admin Console em **Registo de auditoria → Problemas**.

Encare os problemas como a sua **fila de triagem para aquilo que a plataforma reparou por si própria**: falhas de sincronização, de aprovisionamento, de metadados e de capacidade, bem como outros padrões repetitivos semelhantes, aparecem aqui automaticamente, já agrupados, para que trate o *problema* em vez de perseguir linhas de registo isoladas. Complementa o [registo de auditoria](https://dts-identity.com/pt/docs/monitoring/audit-logs.md): o registo de auditoria é o que se *pesquisa* quando existe uma pergunta concreta («o que aconteceu ao utilizador X?»); os problemas são o que se *revê* para apanhar aquilo que se repete discretamente em segundo plano.

## O que se torna um problema

São gerados problemas para operações em segundo plano que falham, tipicamente:

- **Sincronização de diretórios**: uma execução de sincronização falhada, um erro de sincronização de utilizadores a montante, uma falha de sincronização de palavras-passe ou um problema de sincronização de um utilizador em concreto (por exemplo, um e-mail duplicado já utilizado por outro utilizador).
- **Aprovisionamento (SCIM)**: falhas ao criar, atualizar, desativar ou eliminar utilizadores ou grupos numa aplicação ligada a jusante, ou uma ligação que não pôde ser alcançada.
- **Metadados SAML**: um URL de metadados que não pôde ser atualizado, ou um Request que não pôde ser interpretado.
- **Capacidade**: um registo de dispositivo recusado porque o limite de dispositivos foi atingido.

Cada problema tem uma **gravidade** *Warning* ou *Error* e está ligado ao objeto associado (aplicação, diretório, dispositivo ou utilizador), quando existe um.

## Como funciona o agrupamento

As ocorrências repetidas da mesma causa raiz são fundidas num único problema. Cada problema acompanha:

- uma **contagem de ocorrências**: quantas vezes o evento subjacente foi observado;
- uma data e hora de **primeira observação** e de **última observação**;
- um histograma das ocorrências ao longo do tempo, que pode consultar nas **últimas 24 horas, 30 dias ou 90 dias**, para distinguir um pico pontual de um problema persistente com a granularidade de que precisa.

## Estados de um problema

Um problema percorre estes estados:

| Estado | Significado |
|---|---|
| **Não resolvido** | Aberto e a precisar de atenção: o estado predefinido de um problema recém-criado. |
| **Resolvido** | Tratou a causa subjacente e marcou-o como concluído. |
| **Reincidente** | Um problema anteriormente resolvido que voltou a ocorrer. |
| **Arquivado** | Posto de parte e já não apresentado nas listas ativas. |

A vista abre no separador **Não resolvido** e oferece ainda os separadores **Resolvido**, **Reincidente** e **Arquivado**, para poder circular entre o trabalho em aberto, aquilo que já tratou, os problemas que voltaram e os itens que pôs de parte.

[Image: A lista de problemas com falhas de aprovisionamento recorrentes e o respetivo número de ocorrências]

## Tratar um problema

1. Abra **Registo de auditoria → Problemas**. O separador **Não resolvido** lista os problemas abertos, primeiro os observados mais recentemente.
2. Selecione um problema para abrir a respetiva vista de detalhe. Vê o tipo, a gravidade, o objeto associado, a contagem de ocorrências, as datas de primeira e de última observação, um histograma por problema e o contexto completo do evento.
3. Investigue a causa raiz com base nesse contexto, por exemplo corrigindo as credenciais do diretório ou o mapeamento de aprovisionamento a jusante.
4. **Altere o estado**: marque o problema como *Resolvido* assim que o tiver tratado. Se o mesmo problema voltar a ocorrer mais tarde, regressa como *Reincidente*, para não se perder. Um problema resolvido ou arquivado pode ser **reaberto** (voltar a *Não resolvido*) a partir da respetiva página de detalhe.
5. **Arquive** um problema que queira fora das listas ativas mas queira manter no registo: use **Ações → Arquivar** na página de detalhe. Um problema arquivado fica oculto nos separadores Não resolvido e Resolvido e passa a estar no separador **Arquivado**; o problema e o respetivo histórico são conservados, e continua a poder reabri-lo. Arquivar é a ação reversível «triei isto, ponho de parte».
6. **Elimine** um problema apenas quando realmente não precisar dele no registo. Eliminar remove o problema permanentemente: ao contrário de arquivar, não há forma de anular nem histórico conservado.

## Temas relacionados

- [Registos de auditoria](https://dts-identity.com/pt/docs/monitoring/audit-logs.md): o registo por evento a partir do qual os problemas são derivados.
- [Planos e add-ons](https://dts-identity.com/pt/docs/getting-started/plans-and-addons.md): o que o seu nível inclui.
