Déployer Azure Monitor Application Insights Agent pour les serveurs locaux

Application Insights Agent (anciennement appelé Status Monitor V2) est un module PowerShell publié sur PowerShell Gallery. Il remplace Status Monitor. Les données de télémétrie sont envoyées au Portail Azure, dans lequel vous pouvez surveiller votre application.

Pour obtenir la liste complète des scénarios d’instrumentation automatique pris en charge, consultez Environnements, langages et fournisseurs de ressources pris en charge.

Remarque

Le module prend actuellement en charge l’instrumentation sans code des applications web ASP.NET et ASP.NET Core hébergées par IIS. Utilisez un Kit de développement logiciel (SDK) pour instrumenter les applications Java et Node.js.

Application Insights Agent se trouve dans PowerShell Gallery.

PowerShell Gallery icon.

Instructions

  • Pour commencer à utiliser des exemples de code concis, consultez l’onglet Bien démarrer.
  • Consultez l’onglet Instructions détaillées pour une présentation approfondie du démarrage.
  • Pour plus d’informations de référence sur l’API PowerShell, consultez l’onglet Référence d’API.
  • Pour les mises à jour des notes de publication, voir l’onglet Notes de publication.

Cet onglet contient les commandes de démarrage rapide susceptibles de fonctionner pour la plupart des environnements. Les instructions dépendent de PowerShell Gallery pour la distribution des mises à jour. Ces commandes prennent en charge le paramètre -Proxy PowerShell.

Pour obtenir une explication de ces commandes, des instructions de personnalisation et des informations sur le dépannage, consultez les instructions détaillées.

Si vous n’avez pas d’abonnement Azure, créez un compte gratuit avant de commencer.

Utilisez PowerShell Gallery pour le téléchargement et l’installation.

Prérequis pour l’installation

Pour activer le monitoring, vous devez avoir une chaîne de connexion. Une chaîne de connexion s’affiche dans le volet Vue d’ensemble de votre ressource Application Insights. Pour plus d’informations, consultez Chaînes de connexion.

Notes

Depuis avril 2020, le protocole TLS versions 1.1 et 1.0 est déconseillé avec PowerShell Gallery.

Pour connaître les autres prérequis dont vous pouvez avoir besoin, consultez Prise en charge de TLS dans PowerShell Gallery.

Exécutez PowerShell comme administrateur.

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope Process -Force
Install-PackageProvider -Name NuGet -MinimumVersion 2.8.5.201 -Force
Set-PSRepository -Name "PSGallery" -InstallationPolicy Trusted
Install-Module -Name PowerShellGet -Force

Fermez PowerShell.

Installer Application Insights Agent

Exécutez PowerShell comme administrateur.

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope Process -Force
Install-Module -Name Az.ApplicationMonitor -AllowPrerelease -AcceptLicense

Remarque

Le commutateur AllowPrerelease dans l’applet de commande Install-Module permet l’installation de la version bêta.

Pour plus d’informations, consultez Install-Module.

Activer la supervision

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope Process -Force
Enable-ApplicationInsightsMonitoring -ConnectionString 'InstrumentationKey=00000000-0000-0000-0000-000000000000;IngestionEndpoint=https://xxxx.applicationinsights.azure.com/'

Télécharger et installer manuellement (option hors connexion)

Vous pouvez aussi faire manuellement le téléchargement et l’installation.

Télécharger le module

Téléchargez manuellement la dernière version du module à partir de PowerShell Gallery.

Décompresser et installer Application Insights Agent

$pathToNupkg = "C:\Users\t\Desktop\Az.ApplicationMonitor.0.3.0-alpha.nupkg"
$pathToZip = ([io.path]::ChangeExtension($pathToNupkg, "zip"))
$pathToNupkg | rename-item -newname $pathToZip
$pathInstalledModule = "$Env:ProgramFiles\WindowsPowerShell\Modules\Az.ApplicationMonitor"
Expand-Archive -LiteralPath $pathToZip -DestinationPath $pathInstalledModule

Activer la supervision

Enable-ApplicationInsightsMonitoring -ConnectionString 'InstrumentationKey=00000000-0000-0000-0000-000000000000;IngestionEndpoint=https://xxxx.applicationinsights.azure.com/'

Forum aux questions

Cette section fournit des réponses aux questions fréquentes.

Application Insights Agent prend-il en charge les installations basées sur un serveur proxy ?

Oui. Il existe plusieurs façons de télécharger Application Insights Agent.

  • Si votre ordinateur a accès à Internet, vous pouvez intégrer PowerShell Gallery à l’aide des paramètres -Proxy.
  • Vous pouvez également télécharger le module manuellement et l’installer sur votre ordinateur ou l’utiliser directement.

Chacune de ces options est décrite dans les instructions détaillées.

L’Agent du service Application Insights prend-il en charge les applications ASP.NET Core ?

Oui. Dans l’agent Application Insights 2.0.0 et versions ultérieures, les applications ASP.NET Core hébergées dans IIS sont prises en charge.

Comment vérifier que l’activation a réussi ?

  • Vous pouvez utiliser la cmdlet Get-ApplicationInsightsMonitoringStatus pour vérifier que l’activation a réussi.

  • Utilisez les métriques en temps réel pour déterminer rapidement si votre application envoie les données de télémétrie.

  • Vous pouvez également utiliser Log Analytics pour répertorier tous les rôles de cloud qui envoient des données de télémétrie :

    union * | summarize count() by cloud_RoleName, cloud_RoleInstance
    

Comment obtenir un relais proxy ?

Pour obtenir un relais proxy, configurez un proxy au niveau de l’ordinateur ou au niveau de l’application. Consultez DefaultProxy.

Exemple de fichier Web.config :

<system.net>
    <defaultProxy>
    <proxy proxyaddress="http://xx.xx.xx.xx:yyyy" bypassonlocal="true"/>
    </defaultProxy>
</system.net>

Résolution des problèmes

Consultez l’article sur la résolution des problèmes dédié.

Tester la connectivité entre votre hôte d’application et le service d’ingestion

Les SDK et les agents Application Insights envoient de la télémétrie à ingérer en tant qu’appels REST à nos points de terminaison d’ingestion. Vous pouvez tester la connectivité de votre serveur web ou de votre machine hôte d’application vers les points de terminaison de service d’ingestion en utilisant des clients du Representational State Transfer (REST) bruts à partir de commandes PowerShell ou curl. Consultez Résoudre les problèmes de télémétrie d’application manquante dans Azure Monitor Application Insights.

Étapes suivantes

Affichez vos données de télémétrie :

Ajoutez des données de télémétrie :

En faire plus avec Application Insights Agent :