@oleus/sdk

@oleus/sdk

Node.js observability agent for the Oleus platform — tracing, metrics, logs, events, and auto-instrumentation in one init().

npm install @oleus/sdk

// At the very top of your entrypoint, before other imports:
import { init, runJob, oleusApolloPlugin } from '@oleus/sdk'

init({
  service:  'rondo-worker',
  endpoint: 'https://oleus.example.com/otlp',
  apiKey:   process.env.OLEUS_INGEST_KEY,   // per-app bearer key
})

Auto-instrumented when installed: http/https, fetch, Express, pg, mysql2, neo4j-driver (statement category only — never query text), Redis (ioredis + node-redis), @grpc/grpc-js. Plugins for modules you don't have are skipped.

Apollo Server (3 and 4) registers explicitly:

new ApolloServer({ typeDefs, resolvers, plugins: [oleusApolloPlugin()] })

Cron/background jobs get spans, duration metrics, and absence alerting ("job silent > 15 min") via:

cron.schedule('* * * * *', () => runJob('livescore-poller', pollScores))

Uncaught exceptions and unhandled rejections are captured by default (captureUncaught / captureUnhandled to opt out).