> For the complete documentation index, see [llms.txt](https://docs.skail.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.skail.dev/referencia/portal/monitor.md).

# Monitor

Referência da área Monitor do portal: a lista de execuções, os estados, a linha do tempo de uma execução e as ações disponíveis.

## Lista de execuções

Cada linha é uma execução (um TaskId) do environment, com function, workload e versão, estado, início e última atividade. Procure pelo TaskId (o id que você passou no trigger) para achar uma execução específica; filtre por estado para achar o que precisa de atenção.

## Estados

| Estado            | Significado                                                                             | O que olhar                                                 |
| ----------------- | --------------------------------------------------------------------------------------- | ----------------------------------------------------------- |
| Em execução       | A sua aplicação está processando um passo agora                                         | Nada; se demorar demais, o command está lento               |
| Aguardando evento | Parada em uma espera por evento; mostra o nome do evento e o instance id esperados      | Se for inesperado, compare nome e id com o que o fire envia |
| Aguardando prazo  | Parada em um delay; mostra quando vai ser retomada                                      | Nada; é o esperado                                          |
| Na fila           | Aceita pelo trigger ou pronta para retomar, esperando uma instância da aplicação buscar | A aplicação com esse `SKAIL_WORKLOAD` está rodando?         |
| Concluída         | A function retornou                                                                     |                                                             |
| Falha             | Esgotou as tentativas; mostra a exceção                                                 | Corrigir a causa e retomar manualmente                      |

## Linha do tempo

Abrindo uma execução, cada passo é um item, em ordem:

* início da function com os argumentos;
* cada command com argumentos, resultado, duração e número de tentativas;
* cada delay com o prazo;
* cada espera com nome e instance id e o evento recebido com o payload;
* cada espera por todos ou pelo primeiro que terminar, com as tarefas compostas;
* functions filhas como execuções ligadas;
* a exceção, quando houve.

A linha do tempo é montada a partir do histórico da execução e dos spans que o runtime exporta. É o mesmo histórico que o runtime usa no replay e no Time Travel Debug.

Isso responde as perguntas do dia a dia:

* onde está o pedido 4711 (o último item);
* por que ele parou (o estado e o evento esperado);
* o que o gateway devolveu (o resultado do command);
* quantas vezes tentou (as tentativas do command).

## Ações

| Ação                                    | Quando                                                     | Efeito                                                                                                                                                                   |
| --------------------------------------- | ---------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Retomar execução falha                  | Depois de corrigir a causa (dado, serviço externo, código) | Nova entrega; commands concluídos devolvem os resultados da primeira vez; só o que faltava executa. Ver [Retomada manual](/opere/retomada-manual-de-execucoes-falhas.md) |
| Exportar captura para Time Travel Debug | Para depurar na IDE com os dados originais                 | Gera a captura que o runtime local lê em modo de depuração. Ver [Como depurar com Time Travel Debug](/construa/como-fazer/depurar-com-time-travel-debug.md)              |

## O que vale acompanhar

* Execuções em falha.
* Execuções aguardando evento há mais tempo que o prazo esperado.
* Commands com tentativas altas.
* Tempo entre trigger e início (aplicação fora ou com instâncias de menos).

[Monitoramento e alertas](/opere/monitoramento-e-alertas.md) diz o que fazer com cada um.

## Veja também

[Como observar execuções](/construa/como-fazer/observar-execucoes-monitor-otlp-e-logs.md), [Troubleshooting](/opere/troubleshooting.md), [Time Travel Debug](/referencia/portal/time-travel-debug.md).