Skip to content

README.md

Latest commit

 

History

History
86 lines (58 loc) · 2.68 KB

README.md

File metadata and controls

86 lines (58 loc) · 2.68 KB
Raw

@inoxth/react-native-edot-tracer-provider

Manual instrumentation API for the React Native EDOT SDK. Provides an OpenTelemetry-compatible TracerProvider and MeterProvider for emitting custom spans and metrics from JavaScript that flow through the same native pipeline as auto-instrumentation.

Use this when the auto-instrumentation in @inoxth/react-native-edot-sdk doesn't cover the signal you need — e.g. business events, custom timings, domain-specific metrics.

Install

yarn add @inoxth/react-native-edot-tracer-provider

You also need the core SDK initialized first:

yarn add @inoxth/react-native-edot-sdk

See the SDK README for native setup (iOS pod install, Android Gradle plugin) and EdotReactNative.initialize(...).

Custom spans

import { getTracerProvider, SpanStatusCode } from '@inoxth/react-native-edot-tracer-provider';

const tracer = getTracerProvider().getTracer('checkout');

const span = tracer.startSpan('processPayment');
span.setAttribute('payment.method', 'credit_card');
span.setAttribute('payment.amount_cents', 4999);

try {
  await chargeCustomer();
  span.setStatus(SpanStatusCode.OK);
} catch (err) {
  if (err instanceof Error) span.recordException(err);
  span.setStatus(SpanStatusCode.ERROR);
  throw err;
} finally {
  span.end();
}

Manual spans created via tracer-provider are not auto-enriched with screen.name / screen.id — only auto-instrumentation (fetch, XHR, errors, interactions) reads the active view. If you need screen correlation on a custom span, stamp the attribute yourself.

Running code inside a span context

withSpanContext propagates the span as the active context for downstream OTel-aware code:

import { withSpanContext } from '@inoxth/react-native-edot-tracer-provider';

await withSpanContext(span, async () => {
  await fetchAccount();
});

Custom metrics

import { getMeterProvider } from '@inoxth/react-native-edot-tracer-provider';

const meter = getMeterProvider().getMeter('business');

const counter = meter.createCounter('orders_placed');
counter.add(1, { region: 'us-east' });

const histogram = meter.createHistogram('checkout_duration_ms');
histogram.record(842, { region: 'us-east' });

const queueDepth = meter.createUpDownCounter('orders_in_queue');
queueDepth.add(1);
queueDepth.add(-1);

The MeterProvider exports metrics on a periodic schedule (60s) using the same transport (http or grpc) configured for the SDK.

Requirements

License

MIT — see LICENSE.