0.40.0 • Published 10 months ago

@opentelemetry/instrumentation-dns v0.40.0

Weekly downloads
4
License
Apache-2.0
Repository
github
Last release
10 months ago

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

MaturityComponent OwnerCompatibility
UnmaintainedN/AAPI 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:

OptionsTypeDescription
ignoreHostnamesIgnoreMatcher \| 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.