Partager via


Utiliser Azure Application Insights dans le générateur d’API de données

Diagramme de la séquence du guide de déploiement, y compris ces emplacements, dans l’ordre : Vue d’ensemble, Plan, Préparation, Publication, Surveillance et Optimisation. L’emplacement « Surveiller » est actuellement mis en surbrillance.

Azure Application Insights est un service de surveillance qui capture les données de télémétrie, telles que les détails de la demande, les compteurs de performances, les journaux et les exceptions. L’intégration à Data API Builder (DAB) vous aide à diagnostiquer les problèmes et à surveiller le comportement d’exécution en production.

Avertissement Application Insights n’est pas pris en charge lorsque DAB est hébergé à l’aide d’applications web Azure App Service.

Paramétrage

Pour configurer Application Insights dans votre configuration DAB :

Exemple CLI

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

Exemple JSON

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

Cela suppose qu’il app-insights-connection-string est défini en tant que variable d’environnement. Vous pouvez utiliser un .env fichier pour le définir.

Ce qui est capturé

Catégorie Descriptif
Demande de télémétrie URL, code d’état, temps de réponse
Télémétrie de trace Logs de la console de DAB
Télémétrie des exceptions Erreurs et traces de pile
Compteurs de performance Processeur, mémoire, métriques réseau

Affichage dans Azure

  1. Accédez à votre ressource Application Insights dans le portail Azure : https://portal.azure.com
  2. Consultez les logs à l’aide de cette requête :
traces
| order by timestamp

Mappage des Niveaux de Journalisation :

LogLevel Sévérité Valeur
Trace Verbeux 0
Déboguer Verbeux 0
Informations Informations 1
Avertissement Avertissement 2
Erreur Erreur 3
Essentiel Essentiel 4
  1. Vérifier les métriques actives

Capture d’écran de la page des métriques actives pour les données du générateur d’API de données dans Application Insights.

  1. Exécutez cette interrogation pour les requêtes :
requests
| order by timestamp

Capture d’écran des résultats d’une requête pour les demandes d’application du générateur d’API de données dans Application Insights.

  1. Exécutez cette requête pour les exceptions :
exceptions
| order by timestamp

Capture d’écran des résultats d’une requête pour les exceptions du générateur d’API de données dans Application Insights.