Cette traduction automatique est fournie pour votre commodité.
En cas d'incohérence entre la version anglaise et la version traduite, la version anglaise prévaudra. Veuillez visiter cette page pour plus d'informations.
Ce document n’est pas destiné à être lu comme un document autonome. Pour obtenir des instructions d'installation, consultez Installation de l'agent .NET.
Profileur .NET de Microsoft
L'agent .NET de New Relic s'appuie sur l'API de profilage Microsoft pour signaler les données de votre application .NET.
Les solutions monitoring .NET autres que New Relic peuvent utiliser cette API de profilage. Mais un seul service à la fois peut utiliser le profileur. Cela signifie que si vous avez utilisé un service monitoring .NET dans le passé et que vous ne l'avez pas complètement désactivé/supprimé, le profileur peut toujours être utilisé, ce qui entraînera des conflits de profileur lorsque vous tenterez d'activer l'agent.NET.
.NET Framework ou .NET Core/.NET 5+ (32 bits) : NewRelicDotNetAgent_VERSION_x86.zip
.NET Framework ou .NET Core/.NET 5+ (64 bits) : NewRelicDotNetAgent_VERSION_x64.zip
Décompressez le dossier de l'agent à l'emplacement souhaité.
Définissez les variables d’environnement pour le processus que vous souhaitez monitorer.
Prudence
Nous ne recommandons pas de définir ces variables d’environnement globalement. La définition de ces variables d'environnement de manière globale peut entraîner l'instrumentation de tous les processus .NET exécutés sur le système et leur signalement à New Relic. Si vous installez l'agent manuellement, nous pensons que vous disposez des moyens de définir ces variables d'environnement uniquement pour les processus que vous souhaitez monitorer.
Pour .NET Framework, les variables suivantes sont requises :
Redémarrez votre application. Si vous utilisez IIS, redémarrez IIS.
Si votre application reçoit du trafic, les données devraient apparaître dans quelques minutes. Si ce n’est pas le cas, consultez Aucune donnée n’apparaît.
Besoin d'instrumentation personnalisée
Après l’installation d’un agent.NET, la plupart des frameworks application .NET signaleront automatiquement les données à votre compte New Relic . (Voir compatibilité framework d'application : .NET framework | .NET Core.)
Si votre application .NET utilise un framework d'application qui n'est pas automatiquement instrumenté, ou si l'application n'a pas de framework (comme une application console), après l'installation, vous devrez configurer manuellement l'instrumentation de votre application. Voici les étapes à suivre pour y parvenir :
votre instrument application pour définir quelle activité est signalée à New Relic.
Variables d'environnement liées à l'installation
L’installation d’un agent .NET nécessite la définition de variables d’environnement. Pour certaines procédures d'installation (comme pour les applications .NET hébergées par IIS), ces variables d'environnement sont définies automatiquement. Pour les autres procédures d'installation, vous devrez les définir manuellement. Pour voir les variables d’environnement requises pour .NET Framework et l’application .NET Core, consultez Variables d’environnement.
Pour une installation nécessitant de définir manuellement des variables d'environnement, vous pouvez également définir d'autres optionsconfiguration via des variables d'environnement. Voici un aperçu de deux paramètres couramment utilisés :
License key. La variable d'environnement pour définir est :
App nameIl est recommandé de définir un nom d'application significatif , mais vous pouvez également le définir après l'installation. La variable d'environnement est :
Les programmes d'installation scriptables sont des archives ZIP contenant un script PowerShell pour l'installation de l'agent.NET. Il existe une archive zip distincte pour .NET Framework par rapport à .NET Core.
Important
Nous vous recommandons d'utiliser le programme d'installation MSI plutôt que le programme d'installation scriptable. Si vous souhaitez automatiser votre installation, pensez à exécuter le programme d'installation MSI depuis la ligne de commande.
Important
À partir de la version 10.0.0 de l'agent .NET, les programmes d'installation scriptables ne sont plus disponibles. Cette documentation reste destinée aux clients qui souhaitent utiliser le programme d'installation scriptable d'une version plus ancienne.
Pour utiliser le programme d'installation scriptable pour installer l'agent .NET pour une application .NET Framework :
Assurez-vous que vous disposez des droits d’administrateur pour votre groupe d’administrateurs Windows. Pour plus de détails à ce sujet, consultez la documentation sur les autorisations.
Téléchargez le package programme d'installation scriptable pour .NET Framework à partir du site de téléchargement. En téléchargeant ou en utilisant l'un de ces packages, vous acceptez les termes de la licence.
Décompressez le package.
Ouvrez un shell de commande et accédez au dossier du package décompressé.
Pour une installation simple sans options, utilisez cette commande :
bash
$
.\install.cmd -LicenseKey YOUR_LICENSE_KEY
Pour installer avec une ou plusieurs options supplémentaires, utilisez le format ci-dessous. Voir le tableau ci-dessous pour une description des options d'installation.
Si votre application reçoit du trafic, les données devraient apparaître dans quelques minutes. Si ce n’est pas le cas, consultez Aucune donnée n’apparaît.
Options d'installation
Description
LicenseKey
Required. Votre .
NoIISReset
Facultatif. Utilisez cette option pour empêcher le programme d’installation de lancer une réinitialisation IIS.
Important
Si vous utilisez cette option, vous devez effectuer une réinitialisation IIS manuellement avant que New Relic ne démarre une application hébergée par IIS.
InstrumentAll
Facultatif. Par défaut, l'agent .NET instrumentera toutes les applications hébergées par IIS. Utilisez cette option pour activer instrumentation d’autres types d’applications .NET.
InstallPath
Facultatif. Utilisez cette option pour choisir un emplacement d’installation différent. L'emplacement d'installation par défaut est C:\Program Files\New Relic.
Désinstallation de l'agent avec le programme de désinstallation scriptable :
Conseil
Vous pouvez ajouter l’option Force au script de désinstallation pour forcer une désinstallation sans demander de redémarrer IIS.
Exécutez la commande suivante pour désinstaller l’agent .NET :
Notez que les droits d'administrateur dans un shell élevé sont requis (en particulier pour sélectionner un répertoire log personnalisé et effectuer une réinitialisation IISR).
Prudence
Pour des raisons de sécurité, il est nécessaire d'exécuter le script installAgent.ps1 comme indiqué ci-dessous, en ajoutant ./ au nom du fichier de script, plutôt qu'en ajoutant powershell au script. Si vous exécutez le script en ajoutant powershell et que l'un de vos arguments fournis (tels que le chemin d'installation ou le chemin log personnalisé) contient des espaces, ces arguments seront corrompus, ce qui entraînerait l'installation de agent à un emplacement autre que l'emplacement prévu, ce qui pourrait être non sécurisé.
Pour utiliser le programme d'installation scriptable pour installer l'agent .NET pour une application.NET Core :
Assurez-vous que vous disposez des droits d’administrateur pour votre groupe d’administrateurs Windows. Pour plus de détails à ce sujet, consultez la documentation sur les autorisations
Téléchargez le agent du programme d'installation scriptable de .NET package à partir du site de téléchargement .NET agent . En téléchargeant ou en utilisant l'un de ces packages, vous acceptez les termes de la licence.
Décompressez le package à l’emplacement souhaité.
Ouvrez un shell de commande et accédez au dossier du package décompressé.
Vous pouvez installer l'agent localement ou globalement :
Pour une installation simple, sans options, utilisez cette commande :
bash
$
./installAgent.ps1 -destinationPATH-installType global -licenseKey YOUR_LICENSE_KEY \
Pour installer avec une ou plusieurs options supplémentaires, utilisez la même commande avec les options souhaitées. Pour les descriptions des options, voir le tableau ci-dessous.
L'installation globale instrumentera tous les processus .NET Core sur votre système. Choisissez l'installation globale uniquement si vous souhaitez monitorer tous les processus .NET Core.
Pour une installation simple sans options, utilisez cette commande :
bash
$
./installAgent.ps1 -destinationPATH-installType global -licenseKey YOUR_LICENSE_KEY \
Pour installer avec une ou plusieurs options supplémentaires, utilisez la même commande avec les options souhaitées. Pour les descriptions des options, voir le tableau ci-dessous.
Si votre application reçoit du trafic, les données devraient apparaître dans quelques minutes. Si ce n’est pas le cas, consultez Aucune donnée n’apparaît.
Options d'installation
Description
Destination
Required. L'emplacement où l'agent est installé. Cela peut être un chemin absolu ou relatif. Les guillemets d'accompagnement sont obligatoires.
InstallType
Required. Détermine s'il s'agit d'une installation locale (spécifique à l'application) ou globale (à l'échelle du système).
LicenseKey
Required. Votre .
AppName
Facultatif. Définit le nom de l’application par défaut associé à votre installation d’agent.
LogDir
Facultatif. Définit un emplacement de logging personnalisé pour l'agent. Par défaut, l'agent place le répertoire du log dans le répertoire d'installation.
X86
Facultatif. Installe la version 32 bits de l'agent plutôt que la version 64 bits. New Relic does not recommend installe la version 32 bits de l'agent à l'échelle mondiale.
ResetIIS
Facultatif. Exécute un iisreset après l'installation.
Important
Utilisez ceci uniquement si votre application .NET Core est hébergée via un proxy inverse IIS.
Force
Facultatif. Force le processus d'installation à écraser une installation précédente ou à installer dans un dossier existant.
Prudence
Cela écrase toutes les personnalisations de configuration. New Relic recommande de sauvegarder votre fichier configuration et tous les fichiers instrumentation personnalisés avant de forcer une surinstallation.
Help
Facultatif. Affiche les informations d'utilisation de ce script.