telemetry

README

modusgraph-telemetry

An OpenTelemetry-backed tracer for the modusgraph typed client. The typed client traces every database operation through a pluggable typed.Tracer (a no-op by default); this package provides the OpenTelemetry implementation.

Install

modusgraph-telemetry depends on a fork of modusGraph published under a different import path. Go does not propagate replace directives to consumers, so your project must declare the same one:

// go.mod
require (
    github.com/mlwelles/modusgraph-telemetry v0.1.0
    github.com/matthewmcneely/modusgraph v0.0.0-00010101000000-000000000000
)

replace github.com/matthewmcneely/modusgraph => github.com/mlwelles/modusGraph v0.5.0-dev-mlwelles-20260604c

Usage

Install the tracer once at startup, after configuring your OpenTelemetry SDK and exporter:

import (
    "github.com/matthewmcneely/modusgraph/typed"
    telemetry "github.com/mlwelles/modusgraph-telemetry"
)

func main() {
    // ... configure your OpenTelemetry SDK / exporter ...
    typed.SetTracer(telemetry.New())
}

Each typed database operation then emits a modusgraph.<op> client span carrying the Dgraph database semantic attributes db.system=dgraph, db.operation.name, and db.collection.name. With no SDK installed in the process the spans are no-ops.

License

Apache-2.0. See LICENSE and NOTICE.

Documentation

Overview

Package telemetry provides an OpenTelemetry-backed tracer for the modusgraph typed client. The typed client traces every database operation through a pluggable typed.Tracer; install this implementation once at startup:

typed.SetTracer(telemetry.New())

With no OpenTelemetry SDK installed in the process the spans are no-ops; configuring an SDK and exporter is the application's job.

Index

• func New() typed.Tracer

Functions

func New

func New() typed.Tracer

New returns a typed.Tracer backed by the global OpenTelemetry tracer provider.