> ## Documentation Index
> Fetch the complete documentation index at: https://ajuda.medemerge.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Diagnóstico

> O primeiro comando quando algo não funciona, e o que cada mensagem de erro quer dizer.

## Rode um ciclo único

O primeiro comando quando algo não funciona. Ele executa um ciclo de coleta, mostra o resultado e sai, sem entrar em loop:

```bash theme={null}
docker compose run --rm coletor --once
```

## Mensagens comuns

| Mensagem | O que fazer |
| - | - |
| `Faltando public_id, agent_secret` | O `credentials.yaml` está ausente ou incompleto. Confira se ele está na mesma pasta do `docker-compose.yml`. |
| `é um diretório, não um arquivo` | O Docker criou uma pasta no lugar do arquivo, porque o `credentials.yaml` não existia quando o compose subiu. Apague a pasta, crie o arquivo e suba de novo. |
| `Credenciais do agente rejeitadas` | O `agent_secret` não vale mais. Peça um novo à MedEmerge e atualize o arquivo. |
| `ORA-12170` ou `TNS:no listener` | Não há rota até o banco a partir desta máquina: firewall, rede, host ou porta. |
| `ORA-01017` | Usuário ou senha do banco incorretos. Avise a MedEmerge: a correção é feita na plataforma, sem mexer nesta instalação. |

## Sem internet por um tempo

O coletor continua coletando e guarda os envios no buffer local. Quando a conexão volta, ele reenvia tudo sozinho. Não é preciso reiniciar nada.

## O que a MedEmerge vê sem acesso à máquina

Falhas de coleta, de conexão com o banco e o registro de funcionamento do agente chegam à plataforma. Se o coletor parar de dar sinal, a MedEmerge é avisada. Em geral, o suporte já sabe o que aconteceu quando entra em contato.

## Falar com o suporte

Escreva para [suporte@medemerge.com.br](mailto:suporte@medemerge.com.br) com a saída do `--once`. Os logs do coletor não contêm senhas nem dado clínico, e podem ser enviados como estão.


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