Usar Azure Application Insights no API Builder de Dados

O Azure Application Insights é um serviço de monitoramento que captura telemetria, como detalhes de solicitação, contadores de desempenho, logs e exceções. A integração com o Data API builder (DAB) ajuda a diagnosticar problemas e monitorar o comportamento do tempo de execução na produção.

Advertência O Application Insights não é suportado quando o DAB é hospedado usando aplicativos Web do Serviço de Aplicativo do Azure.

Configuração

Para configurar o Application Insights em sua configuração de DAB:

Exemplo de CLI

dab add-telemetry \
  --app-insights-enabled true \
  --app-insights-conn-string "@env('app-insights-connection-string')"

Exemplo de JSON

"runtime": {
  ...
  "telemetry": {
    "application-insights": {
      "enabled": true,
      "connection-string": "@env('app-insights-connection-string')"
    }
  }
  ...
}

Isso pressupõe que app-insights-connection-string é definido como uma variável de ambiente. Você pode usar um .env arquivo para defini-lo.

O que é capturado

Tipo	Descrição
Solicitar telemetria	URL, código de estado, tempo de resposta
Telemetria de rastreio	Registos de consola do DAB
Telemetria de exceção	Erros e rastreamentos de pilha
Contadores de desempenho	CPU, memória, métricas de rede

Ver no Azure

1. Vá para o recurso do Application Insights no portal do Azure: https://portal.azure.com
2. Revise os logs usando esta consulta:

traces
| order by timestamp

Mapeamento LogLevel:

LogLevel	Severidade	Valor
Rastreio	Verbose	0
Depurar	Verbose	0
Informação	Informação	1
Advertência	Advertência	2
Erro	Erro	3
Crítico	Crítico	4

3. Verifique as métricas em tempo real

4. Execute esta consulta para solicitações:

requests
| order by timestamp

5. Execute esta consulta para exceções:

exceptions
| order by timestamp