WIP
NodeJS Instrumentation setup
If you'd like to benefit from the standard NodeJS instrumentations such as HTTP and gRPC, install and register them directly. This way you choose your dependencies and how they are configured.
For the full instrumentation suite, install the meta package:
meteor npm i --save @opentelemetry/auto-instrumentations-node @opentelemetry/instrumentation
Now you just need to configure the instrumentations.
For example, this server file disables fs
and also skips HTTP healthchecks:
1import { registerInstrumentations } from '@opentelemetry/instrumentation'; 2import { getNodeAutoInstrumentations } from '@opentelemetry/auto-instrumentations-node'; 3 4registerInstrumentations({ 5 instrumentations: [ 6 getNodeAutoInstrumentations({ 7 '@opentelemetry/instrumentation-http': { 8 ignoreIncomingRequestHook(req) { 9 if (req.url == '/healthz' || req.url == '/readyz') return true; 10 if (req.url?.startsWith('/sockjs/')) return true; 11 return false; 12 }, 13 }, 14 '@opentelemetry/instrumentation-fs': { 15 enabled: false, 16 }, 17 }), 18 ], 19});
Browser Setup
Optionally, you can import this package from your client entrypoint to gather in-browser telemetry including client-to-server DDP tracing.
This package will submit OpenTelemetry payloads over Meteor's existing DDP connection,
using your application server as a proxy,
instead of having every browser talking directly to your otelcol
endpoint and thus needing CORS configuration.
Example snippit for your client.ts
file:
1// Set up an OpenTelemetry provider using DDP submission and tracing 2// (required to have client-to-server DDP tracing) 3import 'meteor/danopia:opentelemetry'; 4 5// Register additional browser-side instrumentations 6// (optional) 7import { registerInstrumentations } from '@opentelemetry/instrumentation'; 8import { UserInteractionInstrumentation } from '@opentelemetry/instrumentation-user-interaction'; 9registerInstrumentations({ 10 instrumentations: [ 11 new UserInteractionInstrumentation(), 12 ], 13});
Example settings.json
OTLP environment variables are tolerated; for example, these variables will enable tracing:
OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4218 OTEL_SERVICE_NAME=
You can also enable this library and supply configuration via Meteor settings:
1{ 2 "packages": { 3 "danopia:opentelemetry": { 4 "enabled": true, 5 "serverResourceAttributes": { 6 "service.name": "my-app", 7 "deployment.environment": "local" 8 }, 9 "clientResourceAttributes": { 10 "service.name": "my-app-browser", 11 "deployment.environment": "local" 12 } 13 } 14 } 15}
Note that OpenTelemetry defines a number of environment variables such as
OTEL_EXPORTER_OTLP_ENDPOINT
and OTEL_RESOURCE_ATTRIBUTES
.
Since meteor-opentelemetry
submits traces thru DDP,
OpenTelemetry wants to treat client and server data similarly.
So it might be desirable to set resource attributes via Meteor settings:
1{ 2 "packages": { 3 "danopia:opentelemetry": { 4 "enabled": true, 5 "serverResourceAttributes": { 6 "service.name": "my-app", 7 "deployment.environment": "local" 8 }, 9 "clientResourceAttributes": { 10 "service.name": "my-app-browser", 11 "deployment.environment": "local" 12 } 13 } 14 } 15}