> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sondercloud.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Logs & Estatísticas

> Acompanhando logs e uso de recursos de uma database

## Logs

```ts theme={null}
const { logs } = await sonder.databases.logs(databaseId, { tail: 200 });
console.log(logs);
```

**tail** `number` (default: 100)

Número de linhas finais do log a retornar. O padrão de 100 é aplicado pela API quando omitido.

`logs` é retornado como uma única string, já formatada com quebras de linha — não como um array de linhas.

> [!TIP]
>
> Para monitoramento contínuo, faça polling de `logs()` com um `tail` pequeno (ex: 20) em vez de repetir pedidos com `tail` grande, para reduzir o volume de dados retornado a cada chamada.

## Estatísticas de uso

```ts theme={null}
const stats = await sonder.databases.stats(databaseId);
console.log(stats);
```

`DatabaseStats` traz o consumo atual de recursos do container:

| Campo | Tipo | Descrição |
| - | - | - |
| `running` | `boolean` | Se o container está em execução no momento. |
| `cpuPercent` | `string` | Uso de CPU, ex: `"3.2%"`. |
| `memUsage` | `string` | Memória usada / limite, ex: `"128MiB / 256MiB"`. |
| `memPercent` | `string` | Uso de memória em percentual, ex: `"50%"`. |
| `netRx` | `string` | Total de dados recebidos pela rede. |
| `netTx` | `string` | Total de dados enviados pela rede. |
| `pids` | `number` | Quantidade de processos ativos no container. |

> [!NOTE]
>
> Se a database estiver parada ou inacessível no momento da chamada, `stats()` retorna um objeto zerado (`running: false`, tudo em `0`).

## Referência de métodos

| Método | Rota | Descrição |
| - | - | - |
| `databases.logs(id, { tail })` | `GET /v1/databases/:id/logs` | Últimas linhas de log, como string única. |
| `databases.stats(id)` | `GET /v1/databases/:id/stats` | Uso de CPU, RAM, rede e processos. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.