Harvory
    Voltar para Prompts

    Checklist de Observabilidade para Performance da API

    Monta uma estratégia robusta de observabilidade para medir performance por endpoint, query e fluxo autenticado sem achismo.

    Dev
    observabilidade
    apm
    performance
    opentelemetry
    monitoramento
    avançado

    Preencha as variáveis

    0/1 preenchidas

    Preencha os campos abaixo e o prompt será atualizado automaticamente. Depois é só copiar!

    {observacoes_gerais}

    Prompt (prévia ao vivo)

    Você é um especialista em observabilidade, monitoramento e performance de APIs backend.

## Objetivo
Criar uma estratégia prática de observabilidade para esta API, permitindo medir performance de forma confiável por endpoint, query e fluxo, inclusive rotas autenticadas.

## Atenção obrigatória (rotas autenticadas)
- As rotas autenticadas devem ser tratadas explicitamente na instrumentação.
- Defina como medir performance sem expor dados sensíveis (tokens, PII, claims).
- Indique como correlacionar métricas de auth (validação de token/policy) com o tempo total do request.

## O que você deve entregar
1. O que instrumentar
2. Onde instrumentar
3. Quais métricas coletar
4. Como diferenciar público vs autenticado
5. Como criar baseline (média, p95, p99)
6. Como monitorar regressão de performance

## Sugerir (quando aplicável)
- middleware de medição por request
- logging estruturado
- correlação por request-id / trace-id
- EF Core logging/interceptor
- OpenTelemetry
- Application Insights / Grafana / Prometheus / APM equivalente
- MiniProfiler para ambientes internos

## Saída obrigatória
# Checklist de Observabilidade para Performance

## 1. Diagnóstico Atual (estimado)
Se houver pouca observabilidade, explique as lacunas.

## 2. Plano de Instrumentação
Tabela com:
- ponto de medição
- objetivo
- métrica coletada
- inclui rotas autenticadas? (Sim/Não)
- observações de segurança

## 3. Métricas Essenciais
Liste métricas obrigatórias:
- tempo médio por endpoint
- p95 / p99
- nº de queries por request
- tempo de query
- payload
- erro por endpoint
- tempo de auth (quando aplicável)

## 4. Padrão de Logs
Defina padrão de logs estruturados e campos recomendados.

## 5. Painéis e Alertas
O que monitorar e alertar.

## 6. Checklist de Implantação
Passo a passo para ativar sem afetar produção.

## Observações gerais (opcional)
{observacoes_gerais}

    Exemplos

    Entrada

    observacoes_gerais: API .NET com JWT; sem métricas estruturadas hoje; queremos monitorar p95 por endpoint.

    Saída esperada

    # Checklist de Observabilidade para Performance

## 2. Plano de Instrumentação
| Ponto de medição | Objetivo | Métrica | Inclui rotas autenticadas? | Observações |
|---|---|---|---|---|
| Middleware HTTP | Tempo total por endpoint | duration_ms, status_code | Sim | Não registrar token |
| EF Core Interceptor | Tempo por query | sql_duration_ms | Sim | Evitar logar dados sensíveis |

## 3. Métricas Essenciais
- p95/p99 por endpoint
- tempo de auth em rotas privadas