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

# Logs e métricas

> Use logs e métricas para acompanhar sua aplicação.

# <Icon icon="code" color="#0516ee" size={30} /> Use sempre os logs e métricas

Logs e métricas ajudam a entender se o deploy funcionou, se a aplicação iniciou corretamente e se ela está consumindo recursos dentro do esperado.

## Logs de deploy

Use os logs de deploy para acompanhar:

* Download/leitura do código enviado.
* Instalação de dependências.
* Build da aplicação.
* Criação da imagem.
* Inicialização do container.
* Erros de comando, dependência ou porta.

## Logs da aplicação

Depois que o container inicia, os logs mostram a saída do seu processo. Tudo que sua aplicação escreve em stdout/stderr aparece nessa área.

Exemplos úteis:

* Servidor iniciou em qual porta.
* Erro de conexão com banco.
* Variável de ambiente ausente.
* Exceção durante boot da aplicação.

## Métricas

As métricas ajudam a acompanhar o consumo de:

| Métrica | Uso                                 |
| ------- | ----------------------------------- |
| CPU     | Indica carga de processamento       |
| RAM     | Mostra memória usada pela aplicação |
| Rede    | Ajuda a observar tráfego            |

## Reinício e “health check” (como interpretar)

Se sua aplicação encerrar o processo (exit), ela será marcada como parada e poderá exigir reinício. Na prática:

* Se o log “morre” logo após o start, geralmente é erro de comando, variável ausente ou exceção.
* Se a aplicação “sobe” mas não responde, geralmente é porta interna errada ou bind em `127.0.0.1`.

Use esta rotina de diagnóstico:

1. Confira a **porta interna** do projeto.
2. Confira se o app escuta em **`0.0.0.0`**.
3. Revise variáveis de ambiente e se houve **novo deploy** após alterá-las.
4. Procure por mensagens de erro específicas nos logs (veja troubleshooting).

## Links relacionados

* [Portas e domínios](/projetos/portas-dominios)
* [Variáveis de ambiente](/projetos/variaveis-ambiente)
* [Erros comuns](/troubleshooting/common-errors)