Usar Azure Application Insights em construtor de aplicativos de API de dados

O Azure Application Insights é um serviço de monitoramento que captura a telemetria, como detalhes da solicitação, contadores de desempenho, logs e exceções. Integrá-lo ao DAB (Construtor de API de Dados) ajuda a diagnosticar problemas e monitorar o comportamento de runtime na produção.

Aviso Não há suporte para o Application Insights quando o DAB é hospedado usando aplicativos Web do Serviço de Aplicativo do Azure.

Configuração

Para configurar o Application Insights na configuração do DAB:

Exemplo da 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 app-insights-connection-string que seja 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 status, tempo de resposta
Telemetria de rastreamento	Logs de console do DAB
Telemetria de exceção	Erros e rastreamentos de pilha
Contadores de desempenho	CPU, memória, métricas de rede

Exibir no Azure

1. Acesse o recurso do Application Insights no portal do Azure: https://portal.azure.com
2. Examine os logs usando esta consulta:

traces
| order by timestamp

Mapeamento de LogLevel:

LogLevel	Severidade	Valor
Traço	Verboso	0
Depurar	Verboso	0
Informação	Informação	1
Aviso	Aviso	2
Erro	Erro	3
Crítico	Crítico	4

3. Verificar métricas dinâmicas

4. Execute esta consulta para solicitações:

requests
| order by timestamp

5. Execute esta consulta para obter exceções:

exceptions
| order by timestamp