> For the complete documentation index, see [llms.txt](https://lunarie.gitbook.io/lunarie-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://lunarie.gitbook.io/lunarie-docs/qualidade/04-monitoramento.md).

# Monitoramento

> **Última atualização:** 08/10/2026 O que é acompanhado em produção e onde, conferido no app, no Supabase e nos ADRs em 08/10/2026. Os eventos de analytics estão em [Analytics (PostHog)](/lunarie-docs/operacao/05-analytics-posthog.md).

## Onde olhar

| Fonte                                    | O que mostra                                                                                                                                                                                                                                                           | Como acessar          |
| ---------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------- |
| PostHog, painel "Indicadores da Lunarie" | Funil de ativação, envios ao Kindle, uso das Pendências e qualidade das buscas de informações (ADR-055).                                                                                                                                                               | PostHog               |
| PostHog, Error Tracking                  | Exceções do app, por fluxo e etapa ([Gestão de Erros](/lunarie-docs/qualidade/03-gestao-de-erros.md)).                                                                                                                                                                 | PostHog               |
| `/admin`, Integrações                    | Teste de cada serviço externo (Google Books, Groq e demais), com a resposta recebida.                                                                                                                                                                                  | App, só administração |
| `/admin`, Uso de IA                      | Chamadas à Groq, tokens, status, latência e limites restantes, por pessoa (`ai_usage_logs`). Os números gerais vêm da última chamada, não de um saldo em tempo real: após 1 minuto o consumo de tokens vale zero, e após 24 h sem chamadas o consumo do dia vale zero. | App, só administração |
| `/admin`, Envios ao Kindle               | Envios por pessoa e seus status (ADR-068).                                                                                                                                                                                                                             | App, só administração |
| `/admin`, Convites                       | Convites emitidos, usados e arquivados.                                                                                                                                                                                                                                | App, só administração |
| Logs do Supabase                         | Logs das Edge Functions, em JSON nas três funções críticas.                                                                                                                                                                                                            | Painel do Supabase    |
| Security Advisors                        | Alertas de segurança do banco, consultados depois de cada migração.                                                                                                                                                                                                    | Painel do Supabase    |
| `storage_delete_audit`                   | Exclusões no bucket `ebooks`.                                                                                                                                                                                                                                          | Banco                 |

## Monitores automáticos

| Monitor                               | O que faz                                                            |
| ------------------------------------- | -------------------------------------------------------------------- |
| `kindle-bounce-check` (a cada 15 min) | Lê as falhas E999 da Amazon e avisa a pessoa por e-mail.             |
| `kindle-resumo-semanal` (sábado)      | Envia o resumo semanal do que foi enviado ao Kindle.                 |
| `notify-admin`                        | Avisa a administração por e-mail quando alguém entra na Fila da Lua. |
| `ErrorBoundary` global                | Mostra a tela de erro e registra a falha no PostHog.                 |

O alerta diário de integridade do storage foi desligado (ADR-078), e a `storage-integrity-check` só roda quando chamada.

## Indicadores

| Tipo    | Indicador                                                               | Fonte                                                                  |
| ------- | ----------------------------------------------------------------------- | ---------------------------------------------------------------------- |
| Produto | Contas criadas, livros importados, envios ao Kindle, uso das Pendências | Eventos do PostHog                                                     |
| Produto | Critérios de saída do beta                                              | [Métricas de Sucesso](/lunarie-docs/produto/07-metricas-de-sucesso.md) |
| Técnico | Erros por fluxo                                                         | Error Tracking                                                         |
| Técnico | Falhas de integração                                                    | Painel `/admin`                                                        |
| Técnico | Uso e custo de IA                                                       | `ai_usage_logs`                                                        |

## Lacunas

* **Sem alerta ativo de erro:** a equipe só vê um erro quando abre o PostHog ou o painel. Nenhuma notificação é disparada.
* **Sem medição de disponibilidade ou tempo de resposta:** não há monitoramento de uptime do app nem das Edge Functions.
* **Sem retenção:** usuários ativos por mês e retorno após 30 dias não têm evento nem painel.
* **Janela sem dados:** de 04/10 às 22h28 até 05/10 às 02h14 (UTC), o proxy do PostHog rejeitou os eventos (ADR-070), e esse período só existe no banco.

## Documentos relacionados

* [Gestão de Erros](/lunarie-docs/qualidade/03-gestao-de-erros.md)
* [Analytics (PostHog)](/lunarie-docs/operacao/05-analytics-posthog.md)
* [Métricas de Sucesso](/lunarie-docs/produto/07-metricas-de-sucesso.md)