L'agent Node.js de New Relic collecte les données clés d'intervalle de temps métrique de la machine virtuelle Node.js (V8). Ces métriques vous donnent des informations détaillées sur le comportement de la VM Node.js et vous aident à améliorer les performances de votre application. L'agent collecte également les métriques du processeur, qui sont souvent analysées avec les métriques de récupération de place (GC).
Ce dont vous avez besoin
New Relic nécessite un module natif supplémentaire pour collecter les données d'intervalle de temps métrique Node.js VM liées au garbage collection, à la mémoire et au processeur. À partir de Node.js v6.1.0 le module natif n'est pas obligé de collecter les métriques CPU, car l'agent New Relic Node.js les collecte avec process.cpuUsage().
Le module natif peut être utilisé avec :
- New Relic Node.js version 1.35.1 ou supérieure
- Node.js v4 ou supérieur
- npm v2.0.0 ou supérieur
Pour compiler le module natif sur votre plateforme de déploiement, suivez les procédures du packagenode-gyp . Les prérequis pour installer les modules Node.js natifs incluent :
plateforme | Prérequis |
|---|---|
Unix/Linux | Python (v2.7 recommandé, v3.xx non pris en charge), make, compilateur C/C++ (tel que GCC) |
macOS | Python (v2.7 recommandé, v3.xx non pris en charge), Xcode |
Windows | Python (v2.7 recommandé, v3.xx non pris en charge), environnement de build Visual C++ |
Si vous rencontrez des problèmes lors de l'installation de notre agent Node.js, suivez les procédures de dépannage d'installation .
Installer le module natif
À partir de la version 2.0.0 de l'agent New Relic Node.js, le module natif est devenu une dépendance facultative qui tente de s'installer automatiquement.
Lors de l'installation, le module natif tente d'abord de se construire à partir de la source sur la machine cible. Si la construction échoue, Node.js génère une trace d'appels vers la console que vous pouvez généralement ignorer. Pour les environnements Linux exécutant des versions prises en charge de Node, l'agent tente ensuite de télécharger et d'installer un binaire pré-construit.
Il est possible d'empêcher l'agent de tenter de télécharger et d'installer un binaire pré-construit. Au lieu de cela, il tentera uniquement de construire le module natif. Pour ce faire, définissez la variable d’environnement NR_NATIVE_METRICS_NO_DOWNLOAD sur true avant l’installation avec npm ou Yarn.
$export NR_NATIVE_METRICS_NO_DOWNLOAD=true$npm install @newrelic/native-metrics$yarn add @newrelic/native-metricsVous pouvez également utiliser l'indicateur --no-download qui fonctionne avec npm.
$npm install @newrelic/native-metrics --no-downloadSi la construction échoue avec l'indicateur NR_NATIVE_METRICS_NO_DOWNLOAD=true ou --no-download défini, le module natif facultatif ne sera pas installé.
Si les deux variables d'environnement sont définies, NR_NATIVE_METRICS_NO_BUILD remplacera NR_NATIVE_METRICS_NO_DOWNLOAD.
Si vous utilisez une ancienne version, effectuez une mise à niveau vers la dernière version de l'agent ou installez le module natif manuellement :
Assurez-vous qu'une version prise en charge de Node.js est installée. Recommandation : utilisez la dernière version LTS. N'utilisez pas de versions inférieures à la version minimale prise en charge pour le module
@newrelic/native-metrics(v4 ou supérieure).Pour obtenir toutes les métriques actuellement disponibles, assurez-vous que vous exécutez le module
newrelicpour l'agent 1.37.0 ou supérieur.Windows users: Exécutez la commande suivante :
bash$npm install --global windows-build-toolsSi cette étape ne fonctionne pas, suivez l'option 2 du module node-gyp sur GitHub pour obtenir des instructions d'installation manuelle.
Pour installer le module de métriques natif, utilisez l’une de ces méthodes :
Exécutez la commande
npm install @newrelic/native-metrics --save.OU
Ajoutez le module au fichier
package.jsonde votre application.
Redémarrez votre application.
L'agent Node.js détecte automatiquement si le module de métriques natif est installé et commence à l'utiliser. Si vous souhaitez éviter complètement l'installation du module natif, vous pouvez utiliser les arguments npm ou Yarn suivants.
$npm install newrelic --no-optional$yarn add newrelic --ignore-optionalBinaires pré-construits
Pour ignorer l'étape de construction et tenter uniquement de télécharger un binaire pré-compilé, et pour éviter de voir des erreurs de construction dans la console, définissez la variable d'environnement NR_NATIVE_METRICS_NO_BUILD sur true avant l'installation.
$export NR_NATIVE_METRICS_NO_BUILD=trueSi vous travaillez derrière un pare-feu, vous pouvez mettre en cache les binaires prédéfinis en définissant les variables d'environnement NR_NATIVE_METRICS_DOWNLOAD_HOST et NR_NATIVE_METRICS_REMOTE_PATH avant l'installation.
$export NR_NATIVE_METRICS_DOWNLOAD_HOST=http://your-internal-cache/$export NR_NATIVE_METRICS_REMOTE_PATH=path/to/download/folder/Une fois les variables d'environnement définies, l'installation peut alors se poursuivre.
$npm install @newrelic/native-metrics$yarn add @newrelic/native-metricsAfficher les données de la machine virtuelle Node.js
Pour afficher des graphiques organisés avec les données de la machine virtuelle Node.js, accédez à one.newrelic.com > All capabilities > APM & services > (select an app) > Node VMs. Pour plus d'informations, consultez la page des statistiques des machines virtuelles Node.js.
Les données sont également disponibles en métriques et événement.
Détails de mesure
Conseil
Toutes les données ne peuvent pas être collectées dans toutes les versions de Node.js. En général, vous obtiendrez les données les plus complètes si vous utilisez la version LTS la plus récente de Node.