Extension Microsoft Azure App Services
Ce service est en version bêta publique. Si vous souhaitez nous faire part de vos remarques,
contactez l'assistance Datadog. Lors de la période bêta, l'utilisation de cette extension ne fait l'objet d'aucune facturation.
Présentation
Microsoft Azure App Services est un groupe de ressources sans serveur qui vous permettent de créer et d’héberger des applications Web, des backends mobiles, des fonctions axées sur des événements, et des API RESTful sans gérer l’infrastructure. Ce groupe de ressources peut héberger des charges de travail de toutes tailles et offre des options de scaling automatique et de haute disponibilité.
Datadog propose des fonctionnalités de surveillance pour tous les types de ressources Azure App Services :
Extension Azure App Services
L’extension Datadog pour Azure App Services fournit des capacités de surveillance supplémentaires pour les applications Web Azure. Cette prise en charge inclut les éléments suivants :
- Tracing APM distribué complet via l’instrumentation automatique
- Prise en charge de l’instrumentation APM manuelle pour personnaliser les spans
- Injection des
Trace_ID dans les logs d’application
Runtimes pris en charge
L’extension APM .NET Datadog prend en charge les runtimes .NET suivants (architectures x64 et x86) lorsqu’elle est exécutée dans des instances Windows (AAS ne prend pas encore en charge les extensions sous Linux). Pour en savoir plus sur les bibliothèques à instrumentation automatique, consultez la documentation relative au traceur.
- .NET Framework 4.7 (AAS ne prend pas en charge les versions plus récentes)
- .NET Core 2.1
- .NET Core 2.2 (fin de la prise en charge Microsoft le 23/12/2019)
- .NET Core 3.0 (fin de la prise en charge Microsoft le 03/03/2020)
- .NET Core 3.1
Installation
- Ouvrez le portail Azure et accédez au tableau de bord de l’instance Azure App Services que vous souhaitez instrumenter avec Datadog.
- Accédez à l’onglet Paramètres d’application de la page Configuration.
- Ajoutez votre clé d’API Datadog en tant que paramètre d’application appelé
DD_API_KEY avec pour valeur votre clé d’API Datadog. - Si vous utilisez le site européen de Datadog (domaine datadoghq.eu), ajoutez un paramètre d’application
DD_SITE avec pour valeur datadoghq.eu.
Par défaut, l’extension envoie les données au site américain de Datadog (domaine datadoghq.com). Si vous utilisez le site américain, il n’y a donc aucun autre paramètre d’application requis. - Accédez à la page des extensions et cliquez sur Ajouter.
- Sélectionnez l’extension APM Datadog.
- Acceptez les conditions, cliquez sur OK et attendez la fin de l’installation.
- Redémarrez l’application principale : cliquez sur Arrêter, attendez l’arrêt complet, puis cliquez sur Démarrer.
Logs et injection des ID de trace
Les logs pour Azure Web Apps peuvent être envoyés à Datadog via Eventhub en suivant les instructions décrites dans la documentation dédiée à l’intégration Azure.
Une fois que vous avez configuré le pipeline de logging pour votre application, l’injection des ID de trace vous permet d’associer vos logs à vos traces dans Datadog. Pour activer cette fonction avec l’extension, ajoutez un paramètre d’application DD_LOGS_INJECTION:true.
Remarque : l’injection d’ID de trace se fait dans l’application, les logs d’application incluent donc les ID de trace. Les autres catégories de logs de diagnostic disponibles avec Azure, comme les logs HTTP et les logs d’audit, n’incluent pas les ID de trace.
Dépannage
Erreurs 5XX
Si votre application commence à renvoyer des erreurs 5XX immédiatement après l’installation, essayez de réinstaller l’extension après l’arrêt complet de l’application. Procédez comme suit :
- Arrêtez l’application.
- Supprimez l’extension Datadog.
- Réinstallez l’extension Datadog.
- Redémarrez votre application.
Le fait de réinstaller l’extension après l’arrêt complet de l’application résout généralement le problème. Toutefois, si les erreurs 5XX persistent, cela peut être dû à un paramètre de debugging activé, qui peut ralentir le démarrage de votre application et ainsi entraîner une erreur 500. Essayez les solutions suivantes :
- Ajustez vos paramètres de logging et de debugging
- Optez pour un plan App Service supérieur
Traces manquantes
Si vous ne recevez aucune trace ou seulement une partie d’entre elles, vérifiez que vous n’avez pas modifié les paramètres de port manuellement. Dans l’extension, l’Agent du traceur communique avec votre application pour identifier le bon port à utiliser pour le trafic externe. La modification des paramètres de port peut interférer avec ce processus, empêchant alors les traces d’être envoyées.
Besoin d’aide supplémentaire ? Contactez l’assistance Datadog.
Pour aller plus loin
Documentation, liens et articles supplémentaires utiles:
