> For the complete documentation index, see [llms.txt](https://docs.gaiodataos.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.gaiodataos.com/gaio-dataos-portuguese/tools/data-workspace/observabilidade.md).

# Observabilidade

Monitore volume, atualização, consumo e mudanças das tabelas.

A **Observabilidade** monitora o acervo de tabelas do projeto: volume, atualização, consumo e mudanças. Ela tem cinco subabas.

<figure><img src="https://1268188283-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F91J5WBQDmSrL6EE6Xqez%2Fuploads%2F0WoVXWz7eXUionHhxGAa%2Fdata-workspace-observabilidade.png?alt=media&amp;token=14d09202-76f7-4ab1-9fd2-32c3f4748e89" alt=""><figcaption></figcaption></figure>

### Resumo

* **Indicadores**: tabelas (definitivas e temporárias), disco total, em dia, atrasada, parada, órfãs, mudanças em 7 dias e expiradas (com espaço recuperável).
* **Acervo**: tamanho total e ocupação média por tabela.
* **Saúde**: tabelas em dia, atrasadas, paradas ou desconhecidas, e o índice de saúde.
* **Distribuição por idade**: última escrita em menos de 1 dia, 1–3 dias, 3–7 dias, 7–30 dias ou mais de 30 dias.
* **Maiores tabelas** e **Mudanças recentes**.
* **Precisa de atenção**: tabelas que pedem ação, como as órfãs (sem consumidores na linhagem).
* **Temporárias**: quantidade de tabelas temporárias, expiradas e espaço recuperável, com atalho para **Expurgar expiradas**.

### Topologia

* **Órfãs**: tabelas sem consumo conhecido.
* **Mais consumidas**: ordenadas pelo número de consumidores.
* **Em dashboards**: tabelas usadas por cada dashboard.

Todas as visões têm busca, filtro por status (Parada, Atrasada, Em dia, Desconhecido), **Rechecar** e ordenação (Atualidade, Nome, Banco).

Cada linha mostra o bucket, se há consumo conhecido e há quanto tempo a tabela foi escrita pela última vez (ex.: **há 9d**).

<figure><img src="https://1268188283-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F91J5WBQDmSrL6EE6Xqez%2Fuploads%2FLITQaPNmilFrWoMCliTA%2Fdw-obs-topologia.png?alt=media&amp;token=c7e1ad89-90de-4ea6-a232-1abedda6dad5" alt=""><figcaption></figcaption></figure>

### Atualidade

Aqui você define um **SLA de atualização** para cada tabela: Sem SLA, A cada 1h, A cada 6h, A cada 12h, Diário ou Semanal. A tabela passa a ser classificada como Em dia, Atrasada ou Parada. Dá para filtrar por status e por "com ou sem SLA", e ordenar por severidade.

Tabelas sem SLA aparecem como **Sem SLA definido**. Para definir, escolha a opção no seletor ao lado da tabela.

<figure><img src="https://1268188283-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F91J5WBQDmSrL6EE6Xqez%2Fuploads%2FelKnA98aNwQcwJ7qpxBm%2Fdw-obs-atualidade.png?alt=media&amp;token=c255989c-2526-4f1d-9a12-a926d6595893" alt=""><figcaption></figcaption></figure>

### Mudanças

Histórico de mudanças de estrutura das tabelas. A aba **Recentes** mostra as últimas mudanças e a aba **Por tabela** agrupa por tabela. Há busca por tabela ou coluna, filtros e ordenação.

Em **Por tabela**, escolha a tabela no painel esquerdo. O botão **Verificar agora** checa mudanças na hora; quando não há nenhuma, aparece **Sem mudanças registradas**.

<figure><img src="https://1268188283-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F91J5WBQDmSrL6EE6Xqez%2Fuploads%2FAJvwm83havLgPWbsXIPj%2Fdw-obs-mudancas.png?alt=media&amp;token=07c3a0e2-52b5-469d-8909-6a3086033da0" alt=""><figcaption></figcaption></figure>

### Tabelas

A subaba tem duas listas, **Definitivas** e **Temporárias**. As tabelas podem ser ordenadas (ex.: por **Tamanho**) e selecionadas uma a uma ou com **Selecionar todas**.

<figure><img src="https://1268188283-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F91J5WBQDmSrL6EE6Xqez%2Fuploads%2FwF3LwQi883XBSG333reM%2Fdw-obs-tabelas.png?alt=media&amp;token=f45abf09-7614-4997-a8ab-42435c05137a" alt=""><figcaption></figcaption></figure>

* **Definitivas**: tamanho, número de linhas e data da última escrita de cada tabela.
* **Temporárias**: a mesma lista, com política de retenção:
  * **Retenção padrão do app**: Sem retenção, 1, 7, 30 ou 90 dias.
  * Retenção individual por tabela.
  * Cada tabela mostra há quanto tempo está sem escrita (ex.: **sem escrever há 7d**), e a lista pode ser ordenada por **Situação**.
  * Botões **Expurgar expiradas** e **Expurgar todas agora**.

{% hint style="danger" %}
**Expurgar expiradas** e **Expurgar todas agora** apagam tabelas temporárias de forma definitiva. Confira a lista antes de usar.
{% endhint %}
