Surveillance sans agent de Node.js (aperçu public)

Modifier en ligne

Grâce au collecteur sans serveur d' Instana, vous pouvez surveiller vos applications Node.js sur des serveurs sans avoir à installer l'agent hôte d' Instana. Vous pouvez également surveiller les environnements sans serveur pour lesquels Instana ne propose pas de package d' npm.

Pour plus d'informations sur la surveillance de l' Node.js sur AWS Lambda, AWS Fargate ou Google Cloud, consultez la section « Options de surveillance ».

Limitations

Modifier en ligne

À l'heure actuelle, le package de collecteur sans serveur d' Instana ne prend pas en charge les fonctionnalités suivantes :

  • AutoProfile
  • Collecte des métriques

Mise en place d'un suivi

Modifier en ligne

Pour configurer la surveillance des applications Node.js, suivez les étapes suivantes :

  1. Installer le collecteur sans serveur d' Instana
  2. Activer le collecteur sans serveur
  3. Configurer le collecteur sans serveur

Une fois que vous avez installé, activé et configuré le collecteur sans serveur, vous pouvez consulter les traces dans l'interface utilisateur d' Instana. Pour plus d'informations, voir la corrélation de l'EUM.

Activation du collecteur sans serveur

Modifier en ligne

Une fois le collecteur sans serveur installé, activez-le dans l'application.

CommonJS

Modifier en ligne

Si l'application utilise CommonJS, activez le collecteur sans serveur en utilisant l'une des méthodes suivantes :

NODE_OPTIONS
Modifier en ligne

Pour activer le collecteur sans serveur en utilisant cette méthode, exécutez la commande suivante :

ENV NODE_OPTIONS="--require ./node_modules/@instana/serverless-collector/src/index.js"
Manuel require
Modifier en ligne

Pour activer le collecteur sans serveur en utilisant cette méthode, exécutez la commande suivante :

// Do not use () at the end!
require('@instana/serverless-collector');

// All other require statements must be done after the serverless collector is initialized.

// const express = require('express');

ECMAScript

Modifier en ligne

Si l'application utilise ECMAScript, activez le collecteur sans serveur comme suit :

  • Exécutez la commande suivante (sous Node.js, 18.19 et versions ultérieures) :

    
ENV NODE_OPTIONS="--import ./node_modules/@instana/serverless-collector/esm-register.mjs"

Vous pouvez également inclure le drapeau load lorsque vous exécutez la commande de démarrage de Node.js.

Configuration du collecteur sans serveur

Modifier en ligne

Une fois le collecteur sans serveur installé et activé, vous devez le configurer pour qu'il transmette les segments collectés au backend d' Instana.

Pour configurer le collecteur sans serveur afin qu'il envoie les segments collectés au backend Instana, définissez les variables d'environnement suivantes :

  1. INSTANA_ENDPOINT_URL : Copiez le point de terminaison de surveillance sans serveur correspondant à la région de votre serveur et définissez-le comme variable INSTANA_ENDPOINT_URL d'environnement.
  2. INSTANA_AGENT_KEY : Dans le menu de navigation de l'interface utilisateur d' Instana, cliquez sur Plus > Agents > Installer des agents. Choisissez une plateforme sans serveur, copiez la clé fournie et définissez-la comme variable INSTANA_AGENT_KEY d'environnement.

corrélation de la surveillance des utilisateurs finaux (EUM)

Modifier en ligne

Une fois que vous avez installé, activé et configuré le collecteur sans serveur avec succès, le traçage est activé par défaut. Pour consulter la corrélation du backend d' Instana, procédez comme suit dans l'interface utilisateur d' Instana :

  1. Créez un site web pour votre interface utilisateur.
  2. Une fois que votre application Node.js est configurée, en cours d'exécution et reçoit du trafic, accédez à Applications > Services dans l'interface utilisateur d' Instana, puis vérifiez que les traces s'affichent bien sur le tableau de bord.
  3. Dans le menu de navigation de l'interface utilisateur d' Instana, cliquez sur « Sites Web et applications mobiles », puis sélectionnez votre site Web.
  4. Sur le tableau de bord de votre site web, cliquez sur Requêtes HTTP > Analyser les requêtes HTTP.
  5. Visualisez la trace du backend en choisissant une requête spécifique.