@opentelemetry/instrumentation-net

OpenTelemetry Net module Instrumentation for Node.js

This module provides instrumentation of outgoing connections for net. Supports both TCP and IPC connections.

Installation

npm install --save @opentelemetry/instrumentation-net

Usage

const { NodeTracerProvider } = require('@opentelemetry/node');
const { NetInstrumentation } = require('@opentelemetry/instrumentation-net');
const { registerInstrumentations } = require('@opentelemetry/instrumentation');

const provider = new NodeTracerProvider();
provider.register();

registerInstrumentations({
  instrumentations: [
    new NetInstrumentation(),
    // other instrumentations
  ],
});

Attributes added to connect spans

• net.transport: IP.TCP, pipe or Unix
• net.peer.name: host name or the IPC file path

For TCP:

• net.peer.ip
• net.peer.port
• net.host.ip
• net.host.port

Useful links

• For more information on OpenTelemetry, visit: https://opentelemetry.io/
• For more about OpenTelemetry JavaScript: https://github.com/open-telemetry/opentelemetry-js
• For help or feedback on this project, join us in GitHub Discussions

License

Apache 2.0 - See LICENSE for more information.

Changelog

0.24.0

:bug: Bug Fix

• #573 chore: fixing express example (@obecny)

:rocket: Enhancement

• opentelemetry-browser-extension-autoinjection, opentelemetry-host-metrics, opentelemetry-id-generator-aws-xray, opentelemetry-test-utils
  • #594 chore: update core deps to 0.24.0 (@dyladan)
• opentelemetry-host-metrics
  • #570 fix(package.json): publish source maps (@blumamir)
• Other
  • #571 fix(instrumentation-hapi): change root span name to route name (@CptSchnitz)
  • #566 feat(aws-lambda): added eventContextExtractor config option (@prsnca)

:house: Internal

• #592 chore(deps): upgrade @types/pino to be compatible with latest sonic-stream types (@legendecas)
• #583 style: use single quotes everywhere and add a rule to eslint (@CptSchnitz)
• #549 chore: enable typescript 4.3 option noImplicitOverride (@Flarna)

Committers: 8

• Amir Blum (@blumamir)
• Bartlomiej Obecny (@obecny)
• Daniel Dyla (@dyladan)
• Daniel Hermon (@syncush)
• Gerhard Stöbich (@Flarna)
• Ofer Adelstein (@CptSchnitz)
• Yaron (@prsnca)
• legendecas (@legendecas)