@opentelemetry/instrumentation-dns

v0.30.0
OpenTelemetry dns automatic instrumentation package.
dns instrumentation nodejs opentelemetry profiling tracing

OpenTelemetry DNS Instrumentation for Node.js

NPM Published Version Apache License

This module provides automatic instrumentation for the dns module, which may be loaded using the @opentelemetry/sdk-trace-node package and is included in the @opentelemetry/auto-instrumentations-node bundle.

If total installation size is not constrained, it is recommended to use the @opentelemetry/auto-instrumentations-node bundle with @opentelemetry/sdk-node for the most seamless instrumentation experience.

Compatible with OpenTelemetry JS API and SDK 1.0+.

Status

Maturity Component Owner Compatibility
Unmaintained N/A API 1.0+
SDK 1.0+

Installation

npm install --save @opentelemetry/instrumentation-dns

Supported Versions

  • Node.js >=14

Usage

const { NodeTracerProvider } = require('@opentelemetry/sdk-trace-node');
const { DnsInstrumentation } = require('@opentelemetry/instrumentation-dns');
const { registerInstrumentations } = require('@opentelemetry/instrumentation');

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

registerInstrumentations({
  instrumentations: [
    new DnsInstrumentation({
      // see under for available configuration
    }),
  ],
});

DNS Instrumentation Options

DNS instrumentation has currently one option. You can set the following:

Options Type Description
ignoreHostnames IgnoreMatcher | IgnoreMatcher[] DNS instrumentation will not trace all requests that match hostnames

Semantic Conventions

This package does not currently generate any attributes from semantic conventions.

Useful links

License

Apache 2.0 - See LICENSE for more information.

npm i @opentelemetry/[email protected]

Metadata

  • Apache-2.0
  • >=8.12.0
  • OpenTelemetry Authors
  • released 9/2/2022

Downloads