@aws/aws-distro-opentelemetry-node-autoinstrumenta

AWS Distro for OpenTelemetry (ADOT) NodeJS Auto-Instrumentation

Install this package into your NodeJS project with:

npm install --save @aws/aws-distro-opentelemetry-node-autoinstrumentation

Run your application with ADOT NodeJS with:

node --require '@aws/aws-distro-opentelemetry-node-autoinstrumentation/register' your-application.js

Sample Environment Variables for Application Signals

export OTEL_RESOURCE_ATTRIBUTES=service.name=example-application-service-name
export OTEL_AWS_APPLICATION_SIGNALS_ENABLED=true
export OTEL_AWS_APPLICATION_SIGNALS_EXPORTER_ENDPOINT=http://localhost:4316/v1/metrics
export OTEL_EXPORTER_OTLP_PROTOCOL=http/protobuf
export OTEL_EXPORTER_OTLP_TRACES_ENDPOINT=http://localhost:4316/v1/traces
export OTEL_TRACES_EXPORTER=console,otlp
export OTEL_TRACES_SAMPLER=xray
export OTEL_TRACES_SAMPLER_ARG=endpoint=http://localhost:2000,polling_interval=300

General Recommendations

Environment Variable	Description	Example
`OTEL_EXPORTER_OTLP_PROTOCOL`	Leave unset so that ADOT JS will use a recommended OTLP protocol	`http/protobuf`
`OTEL_PROPAGATORS`	Leave unset so that ADOT JS will use a recommended list of propagators	`xray,tracecontext,b3,b3multi`
`OTEL_NODE_DISABLED_INSTRUMENTATIONS`	Leave unset so that ADOT JS will disable a recommended list of instrumentations	`fs,dns`
`OTEL_NODE_RESOURCE_DETECTORS`	Leave unset so that ADOT JS will use a recommended list of Resource Detectors. If set, `env` should be at the end of the list	`aws,env`