Description

Cet agent Node.js est destiné uniquement à l’application Nudge d’Atakama-Technologies.
Il collecte des métriques OTLP mais les données de profilage (Profiler) ne sont pas activable dans cette version.

Prérequis

• Node.js >= 20.x (testé avec la version 20.11.1)
• Git (pour cloner le repository)
• PowerShell ou CMD pour Windows, Bash pour Linux/macOS

Versions

Utilisation des versions OpenTelemetry

• @opentelemetry/api : 1.9.0
• @opentelemetry/auto-instrumentations-node :
  • 0.55.2 : version native
  • 0.55.4-2 : version modifiée suite à des optimisations spécifiques à Atakama

Utilisation

• OpenTelemetry est utilisé pour la capture des requêtes, avec des modifications permettant d’assurer le lien (link) entre les métriques OTLP et le profilage

Installation

Pour la version NPM Se mettre dans le dossier racine de l'application cliente puis faire

• npm i agent.nodejs.nudge
• Lancez : node -r agent.nodejs.nudge app.js

Pour GITHUB Se mettre dans le dossier ou l'on souhaite installer l'agent et faire un git clone

• git clone https://github.com/atakama/nudge_NODEJS_Installer.git

Pour la version ZIP Télécharger sur le portal de Atakama : https://support-logiciels.atakama-technologies.com/pages/exec.php/url/url-to-nudge-jar?exec_module=itop-portal-base&exec_page=index.php&portal_id=itop-portal

• dézipper Puis installez les packages en cliquant sur l'une des 3 possibilités
• install.bat (Window)
• install.ps1 (Windows PowerShell)
• install.sh (Linux)

Modification de OpentTelemetry

Le package OpentTelemetry a été modifié pour l'agent NodeJS sur les auto-intrumentations suivantes:

• auto-instrumentation-node . Seul le package.json a été modifié pour pointer vers les repository instrumentation OTLP customisés.
• instrumentation-express . Modifié pour permettre de remonter les erreurs "catchées".
• instrumentation-http . Modifié pour permettre la liaison entre le profiler natif de NodeJS. Ce lien est repris sous le terme "link" dans les schémas OTLP.

Leur repository respectif

• https://github.com/atakama/nudge_NODEJS_OTEL-auto-instrumentations-node
• https://github.com/atakama/nudge_NODEJS_OTEL-instrumentations-express
• https://github.com/atakama/nudge_NODEJS_OTEL-instrumentations-http

Licence

© Atakama-Technologies 2018-2026. Utilisation réservée aux clients Atakama. Ne pas redistribuer.

Liens utiles d'origine OpenTelemetry

• For more information on OpenTelemetry, visit: https://opentelemetry.io/
• For more about OpenTelemetry JavaScript: https://github.com/open-telemetry/opentelemetry-js