> For the complete documentation index, see [llms.txt](https://wiki.datadike.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.datadike.com/pt/sonar/administration/settings/retention.md).

# Retenção de dados

Settings › Retention define quantos dias o SONAR guarda histórico de checks e de dispositivos, alertas resolvidos, logs de depuração e de auditoria e dados de produtividade antes da limpeza horária.

## O que é e quando usar

**Admin Center › Settings › Retention** decide por quanto tempo o SONAR guarda os registros que crescem com o tempo. Cada campo é um número de dias. A cada hora, o SONAR exclui os registros mais antigos que esse número; um campo definido como `0` guarda os seus registros sem exclusão automática.

Defina esses valores quando decidir até onde precisa olhar para trás: quantas semanas de histórico de checks para ver uma tendência, quantos meses de entradas de auditoria para uma investigação, por quanto tempo os dados de atividade dos usuários podem ser guardados. Os valores valem para toda a instalação, em todos os clientes e sites.

{% hint style="warning" %}
Os registros excluídos não podem ser recuperados pelo console. Encurtar um período remove tudo o que for mais antigo que o novo valor na próxima limpeza de hora em hora. Aumentar um período só ajuda dali em diante: os registros já excluídos não voltam.
{% endhint %}

## Antes de começar

* Seu papel precisa de **View Core Settings** para abrir **Settings**, e de **Edit Core Settings** para salvar (grupo **Settings** em **Admin Center › Roles**).
* Decida os períodos com quem responde pela proteção de dados na sua organização, em especial para as entradas de auditoria e para os dados de produtividade, que descrevem o que os usuários fizeram nos seus computadores.

## Passos

1. Abra **Admin Center › Settings**.
2. Abra a aba **Retention**. Ela mostra o quadro **Data Retention**.
3. Digite o número de dias em cada campo que quiser alterar. Use `0` para guardar um tipo de registro sem exclusão automática.
4. Clique em **Save Settings**.
5. Em **Confirm changes**, confira a lista de valores alterados e clique em **Save**.

## O que você deve ver

**Confirm changes** lista cada configuração alterada com o valor antigo e o novo. Depois de **Save**, a mensagem **Settings were edited!** é exibida e os campos mantêm os novos valores.

A limpeza em si é executada a cada hora, aos quinze minutos de cada hora. Os registros mais antigos que o período somem do console depois da execução seguinte.

## Como verificar se funcionou

1. Abra **Reports & Audits › Audits**, escolha **Core Settings** em **Object** e aplique. Uma entrada **Modify Object** mostra a sua alteração; os **Audit details** dela trazem o valor antigo em **Before** e o novo em **After**. Veja [Trilha de auditoria](https://wiki.datadike.com/pt/sonar/administration/audit/audit-trail.md).
2. Depois da próxima execução de hora em hora, confira o registro mais antigo do tipo que você alterou. Para as entradas de auditoria: em **Audits**, defina **Time Window** como **All Time** e vá para a última página. A entrada mais antiga não pode ter mais dias do que o número definido em **Audit Logs (days)**.

## Erros comuns

| Sintoma                                               | Causa                                                    | Correção                                                                             |
| ----------------------------------------------------- | -------------------------------------------------------- | ------------------------------------------------------------------------------------ |
| **Invalid value** sob um campo                        | O valor não é um número inteiro de 0 a 9999              | Digite um número inteiro de dias nesse intervalo                                     |
| **Save Settings** retorna **Failed to save settings** | O papel não tem **Edit Core Settings**                   | Conceda essa permissão em **Admin Center › Roles**, ou peça a um usuário que a tenha |
| **Please select a default agent timezone** ao salvar  | **Default agent timezone** na aba **General** está vazio | Escolha um fuso horário em **Admin Center › Settings › General** e salve de novo     |
| Registros antigos continuam listados depois de salvar | A limpeza é executada uma vez por hora                   | Aguarde a próxima execução, aos quinze minutos da hora                               |
| Registros antigos nunca são removidos                 | O campo está em `0`                                      | Defina um número de dias                                                             |

## Referência de campos

| Campo                                  | O que faz                                                                                                                                                                                     | Valores aceitos      | Padrão |
| -------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------- | ------ |
| **Check History (days)**               | Exclui os resultados de checks com mais de N dias, o histórico por trás de cada check na aba **Checks** do dispositivo                                                                        | 0 a 9999; 0 desativa | 30     |
| **Resolved Alerts (days)**             | Exclui os alertas resolvidos disparados há mais de N dias. Os alertas abertos nunca são excluídos por essa configuração                                                                       | 0 a 9999; 0 desativa | 0      |
| **Agent History (days)**               | Exclui as entradas do histórico do dispositivo com mais de N dias, a lista da aba **History** do dispositivo                                                                                  | 0 a 9999; 0 desativa | 60     |
| **Debug Logs (days)**                  | Exclui os registros de depuração do agente com mais de N dias, exibidos na aba **Debug** do dispositivo                                                                                       | 0 a 9999; 0 desativa | 30     |
| **Audit Logs (days)**                  | Exclui as entradas de auditoria com mais de N dias de **Reports & Audits › Audits** e da aba **Audits** do dispositivo                                                                        | 0 a 9999; 0 desativa | 0      |
| **Productivity data retention (days)** | Exclui os eventos de atividade dos usuários com mais de N dias, junto com os períodos de inatividade deles e as sessões já encerradas, como exibidos em **Users Traces** e **Users Behavior** | 0 a 9999; 0 desativa | 30     |

Com os valores padrão, as entradas de auditoria e os alertas resolvidos são guardados sem exclusão automática.

A opção que limpa as falhas dos dispositivos que deixaram de se comunicar fica na aba **General**; veja [Configurações gerais](https://wiki.datadike.com/pt/sonar/administration/settings/general.md).

## Páginas relacionadas

* [Configurações gerais](https://wiki.datadike.com/pt/sonar/administration/settings/general.md): as outras configurações salvas com o mesmo botão
* [Trilha de auditoria](https://wiki.datadike.com/pt/sonar/administration/audit/audit-trail.md): os registros guardados conforme **Audit Logs (days)**
* [Alertas e modelos de alerta](https://wiki.datadike.com/pt/sonar/administration/automation/alerts.md): os alertas guardados conforme **Resolved Alerts (days)**
* [Rastros dos usuários](https://wiki.datadike.com/pt/sonar/administration/user-activity/users-traces.md): a atividade guardada conforme **Productivity data retention (days)**
* [Checks](https://wiki.datadike.com/pt/sonar/administration/automation/checks.md): o histórico guardado conforme **Check History (days)**
