> For the complete documentation index, see [llms.txt](https://ayakaleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ayakaleaf-pro.ayaka.space/on-premises/pt/configuracao/overleaf-toolkit/logging.md).

# Registos

Você pode usar o `bin/logs` script para visualizar os logs dos serviços.

Exemplos de uso básico:

```bash
# Ver os logs do serviço web
bin/logs web

# Mostrar ajuda
bin/logs --help

# Ver logs de vários serviços de uma vez
bin/logs filestore docstore web clsi

# Acompanhar a saída dos logs (como tail -f)
bin/logs -f filestore docstore web clsi

# Limitar o número de linhas exibidas (padrão 50)
bin/logs -n 50 web

# Mostrar todas as linhas do log
bin/logs -n all web

# Redirecionar a saída para um arquivo
bin/logs -n all web > web.log
```

Você pode usar o `bin/logs` script para visualizar os logs dos seguintes serviços: `clsi`, `contacts`, `docstore`, `document-updater`, `filestore`, `git-bridge`, `mongo`, `notifications`, `real-time`, `redis`, `spelling`, `tags`, `track-changes`, `web`, `web-api`, `history-v1`, `project-history`.

## Copiando logs

Consulte a documentação original: <https://docs.overleaf.com/on-premises/configuration/overleaf-toolkit/logging#copying-logs>

Copie os ficheiros de log do principal `sharelatex` contentor para o seu computador local:

```bash
docker cp sharelatex:/var/log/overleaf/{service-name}.log {service-name}.log
```

## Persistência dos logs

Os contentores Docker são efémeros, o que significa que os ficheiros/diretórios criados dentro do contentor durante a execução (incluindo ficheiros de log) serão descartados se o contentor for recriado (por exemplo, ao executar `bin/up`). Para manter os ficheiros de log entre recriações do contentor:

* Defina a variável de ambiente `OVERLEAF_LOG_PATH` no `config/overleaf.rc` ficheiro usado pelo Toolkit. Este deve ser o diretório no anfitrião que será montado por bind para o diretório de logs dentro do `sharelatex` contentor.
* Após alterar isto e executar `bin/up -d`, os ficheiros de log serão persistidos no anfitrião e acessíveis diretamente.

{% hint style="warning" %}
Tem de definir o proprietário do diretório de logs do anfitrião usado para a montagem por bind como o `www-data` utilizador (uid=33) e garantir que as permissões sejam `drwxr-xr-x` (755).

Exemplo:

```bash
chown 33:33 data/overleaf/logs
chmod 755 data/overleaf/logs
```

{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://ayakaleaf-pro.ayaka.space/on-premises/pt/configuracao/overleaf-toolkit/logging.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.