@brizz/sdk 0.1.52 → 0.1.54
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +38 -0
- package/dist/chunk-DBN4NKIG.js +107 -0
- package/dist/{chunk-KFETJN5M.cjs → chunk-FQBVTIBR.cjs} +7 -0
- package/dist/{chunk-2T7OEV33.cjs → chunk-KGNFUQ6Z.cjs} +1 -1
- package/dist/{chunk-W7VSQ4KQ.js → chunk-MLMF2O5P.js} +1 -1
- package/dist/chunk-VZJNEST4.cjs +107 -0
- package/dist/{chunk-TEY6FAVZ.js → chunk-YGLDHCWC.js} +7 -0
- package/dist/google-genai-44O4QORJ.cjs +11 -0
- package/dist/{google-genai-T7I4FFIP.js → google-genai-PERR37LR.js} +2 -1
- package/dist/google-genai.cjs +3 -2
- package/dist/google-genai.js +2 -1
- package/dist/index.cjs +510 -107
- package/dist/index.js +486 -83
- package/dist/{mcp-MVZSP5NE.cjs → mcp-4M4XL46N.cjs} +39 -16
- package/dist/{mcp-TOZFTC5Y.js → mcp-KU7MFTOB.js} +29 -6
- package/dist/types/cjs/index.d.ts +1 -1
- package/dist/types/cjs/internal/config.d.ts +1 -0
- package/dist/types/cjs/internal/instrumentation/openai.d.ts +5 -0
- package/dist/types/cjs/internal/instrumentation/registry.d.ts +1 -0
- package/dist/types/cjs/internal/instrumentation/typesafe.d.ts +34 -0
- package/dist/types/cjs/internal/log/logging.d.ts +1 -0
- package/dist/types/cjs/internal/metric/metrics.d.ts +1 -0
- package/dist/types/cjs/internal/sdk.d.ts +3 -0
- package/dist/types/cjs/internal/trace/index.d.ts +1 -0
- package/dist/types/cjs/internal/trace/provider.d.ts +15 -0
- package/dist/types/cjs/internal/trace/tracing.d.ts +1 -0
- package/dist/types/esm/index.d.ts +1 -1
- package/dist/types/esm/internal/config.d.ts +1 -0
- package/dist/types/esm/internal/instrumentation/openai.d.ts +5 -0
- package/dist/types/esm/internal/instrumentation/registry.d.ts +1 -0
- package/dist/types/esm/internal/instrumentation/typesafe.d.ts +34 -0
- package/dist/types/esm/internal/log/logging.d.ts +1 -0
- package/dist/types/esm/internal/metric/metrics.d.ts +1 -0
- package/dist/types/esm/internal/sdk.d.ts +3 -0
- package/dist/types/esm/internal/trace/index.d.ts +1 -0
- package/dist/types/esm/internal/trace/provider.d.ts +15 -0
- package/dist/types/esm/internal/trace/tracing.d.ts +1 -0
- package/package.json +22 -15
- package/dist/google-genai-LMEZ62FB.cjs +0 -10
package/README.md
CHANGED
|
@@ -23,6 +23,8 @@ Traces popular AI libraries including OpenAI, Anthropic, Vercel AI SDK, and more
|
|
|
23
23
|
- [Environment Variables](#environment-variables)
|
|
24
24
|
- [Disable Span Export](#disable-span-export)
|
|
25
25
|
- [Dropping Spans](#dropping-spans)
|
|
26
|
+
- [Running Alongside Your Own OpenTelemetry Setup](#running-alongside-your-own-opentelemetry-setup)
|
|
27
|
+
- [Serverless (Cloud Run, Lambda)](#serverless-cloud-run-lambda)
|
|
26
28
|
- [Advanced Configuration](#advanced-configuration)
|
|
27
29
|
- [Testing & Development](#testing--development)
|
|
28
30
|
- [Package.json Examples](#packagejson-examples)
|
|
@@ -757,6 +759,7 @@ BRIZZ_APP_VERSION=1.0.0 # Application version
|
|
|
757
759
|
BRIZZ_ENVIRONMENT=production # Environment (dev, staging, prod)
|
|
758
760
|
BRIZZ_LOG_LEVEL=info # SDK log level
|
|
759
761
|
BRIZZ_DISABLE_SPAN_EXPORTER=true # Skip span export (see "Disable Span Export")
|
|
762
|
+
BRIZZ_SET_GLOBAL_TRACER_PROVIDER=false # Keep Brizz spans on their own provider (see below)
|
|
760
763
|
|
|
761
764
|
# OpenTelemetry Standard Variables
|
|
762
765
|
OTEL_SERVICE_NAME=my-service # Service name
|
|
@@ -806,6 +809,41 @@ await llm.invoke([new HumanMessage('Hello')], {
|
|
|
806
809
|
|
|
807
810
|
Both sync and async filters are supported. Exceptions are caught and the span passes through.
|
|
808
811
|
|
|
812
|
+
## Running Alongside Your Own OpenTelemetry Setup
|
|
813
|
+
|
|
814
|
+
If your app registers its own OpenTelemetry `TracerProvider` (for example, for an APM), pass
|
|
815
|
+
`setGlobalTracerProvider: false`:
|
|
816
|
+
|
|
817
|
+
```typescript
|
|
818
|
+
Brizz.initialize({ apiKey: 'your-api-key', setGlobalTracerProvider: false });
|
|
819
|
+
```
|
|
820
|
+
|
|
821
|
+
Brizz keeps its spans on its own provider and sends them to Brizz only. Your provider, propagator
|
|
822
|
+
and sampling stay as they are, and Brizz records every conversation even when your setup does not
|
|
823
|
+
sample the request.
|
|
824
|
+
|
|
825
|
+
Give an instrumentation you construct yourself Brizz's tracer provider:
|
|
826
|
+
|
|
827
|
+
```typescript
|
|
828
|
+
import { getTracerProvider } from '@brizz/sdk';
|
|
829
|
+
|
|
830
|
+
new LangChainInstrumentation({ tracerProvider: getTracerProvider() });
|
|
831
|
+
```
|
|
832
|
+
|
|
833
|
+
Or via env var: `BRIZZ_SET_GLOBAL_TRACER_PROVIDER=false`.
|
|
834
|
+
|
|
835
|
+
## Serverless (Cloud Run, Lambda)
|
|
836
|
+
|
|
837
|
+
Where CPU is throttled once the response is sent, queued telemetry may never leave the instance.
|
|
838
|
+
Await `Brizz.flush()` before responding:
|
|
839
|
+
|
|
840
|
+
```typescript
|
|
841
|
+
await Brizz.flush();
|
|
842
|
+
res.json(result);
|
|
843
|
+
```
|
|
844
|
+
|
|
845
|
+
On Cloud Run, enabling "CPU always allocated" works too.
|
|
846
|
+
|
|
809
847
|
## Advanced Configuration
|
|
810
848
|
|
|
811
849
|
```typescript
|
|
@@ -0,0 +1,107 @@
|
|
|
1
|
+
// src/internal/trace/provider.ts
|
|
2
|
+
import {
|
|
3
|
+
context,
|
|
4
|
+
createContextKey,
|
|
5
|
+
defaultTextMapGetter,
|
|
6
|
+
defaultTextMapSetter,
|
|
7
|
+
propagation,
|
|
8
|
+
trace
|
|
9
|
+
} from "@opentelemetry/api";
|
|
10
|
+
import { AsyncLocalStorageContextManager } from "@opentelemetry/context-async-hooks";
|
|
11
|
+
import { W3CTraceContextPropagator } from "@opentelemetry/core";
|
|
12
|
+
var STATE_KEY = /* @__PURE__ */ Symbol.for("brizz.sdk.tracerProvider");
|
|
13
|
+
function state() {
|
|
14
|
+
const holder = globalThis;
|
|
15
|
+
holder[STATE_KEY] ??= { privateProvider: null };
|
|
16
|
+
return holder[STATE_KEY];
|
|
17
|
+
}
|
|
18
|
+
var LazyTracer = class {
|
|
19
|
+
constructor(name, version, options) {
|
|
20
|
+
this.name = name;
|
|
21
|
+
this.version = version;
|
|
22
|
+
this.options = options;
|
|
23
|
+
}
|
|
24
|
+
name;
|
|
25
|
+
version;
|
|
26
|
+
options;
|
|
27
|
+
resolve() {
|
|
28
|
+
const provider = state().privateProvider ?? trace.getTracerProvider();
|
|
29
|
+
return provider.getTracer(this.name, this.version, this.options);
|
|
30
|
+
}
|
|
31
|
+
startSpan(name, options, ctx) {
|
|
32
|
+
return this.resolve().startSpan(name, options, ctx);
|
|
33
|
+
}
|
|
34
|
+
startActiveSpan = ((...args) => {
|
|
35
|
+
const tracer = this.resolve();
|
|
36
|
+
return Reflect.apply(tracer.startActiveSpan, tracer, args);
|
|
37
|
+
});
|
|
38
|
+
};
|
|
39
|
+
var BrizzTracerProvider = class {
|
|
40
|
+
tracers = /* @__PURE__ */ new Map();
|
|
41
|
+
getTracer(name, version, options) {
|
|
42
|
+
const key = `${name}@${version ?? ""}:${options?.schemaUrl ?? ""}`;
|
|
43
|
+
let tracer = this.tracers.get(key);
|
|
44
|
+
if (!tracer) {
|
|
45
|
+
tracer = new LazyTracer(name, version, options);
|
|
46
|
+
this.tracers.set(key, tracer);
|
|
47
|
+
}
|
|
48
|
+
return tracer;
|
|
49
|
+
}
|
|
50
|
+
};
|
|
51
|
+
var brizzTracerProvider = new BrizzTracerProvider();
|
|
52
|
+
function getTracerProvider() {
|
|
53
|
+
return brizzTracerProvider;
|
|
54
|
+
}
|
|
55
|
+
function bindToBrizz(instrumentation) {
|
|
56
|
+
instrumentation.setTracerProvider(brizzTracerProvider);
|
|
57
|
+
return instrumentation;
|
|
58
|
+
}
|
|
59
|
+
function setPrivateTracerProvider(provider) {
|
|
60
|
+
state().privateProvider = provider;
|
|
61
|
+
}
|
|
62
|
+
function isPrivateTracerProvider() {
|
|
63
|
+
return state().privateProvider !== null;
|
|
64
|
+
}
|
|
65
|
+
var PROBE_KEY = createContextKey("brizz.sdk.contextManagerProbe");
|
|
66
|
+
function contextManagerWorks() {
|
|
67
|
+
return context.with(
|
|
68
|
+
context.active().setValue(PROBE_KEY, true),
|
|
69
|
+
() => context.active().getValue(PROBE_KEY) === true
|
|
70
|
+
);
|
|
71
|
+
}
|
|
72
|
+
function ensureContextManager() {
|
|
73
|
+
if (contextManagerWorks()) {
|
|
74
|
+
return "existing";
|
|
75
|
+
}
|
|
76
|
+
const manager = new AsyncLocalStorageContextManager().enable();
|
|
77
|
+
if (context.setGlobalContextManager(manager) && contextManagerWorks()) {
|
|
78
|
+
return "installed";
|
|
79
|
+
}
|
|
80
|
+
manager.disable();
|
|
81
|
+
return "failed";
|
|
82
|
+
}
|
|
83
|
+
var w3cPropagator = new W3CTraceContextPropagator();
|
|
84
|
+
function injectTraceContext(ctx, carrier) {
|
|
85
|
+
if (isPrivateTracerProvider()) {
|
|
86
|
+
w3cPropagator.inject(ctx, carrier, defaultTextMapSetter);
|
|
87
|
+
} else {
|
|
88
|
+
propagation.inject(ctx, carrier);
|
|
89
|
+
}
|
|
90
|
+
}
|
|
91
|
+
function extractTraceContext(ctx, carrier) {
|
|
92
|
+
if (isPrivateTracerProvider()) {
|
|
93
|
+
return w3cPropagator.extract(ctx, carrier, defaultTextMapGetter);
|
|
94
|
+
}
|
|
95
|
+
return propagation.extract(ctx, carrier);
|
|
96
|
+
}
|
|
97
|
+
|
|
98
|
+
export {
|
|
99
|
+
brizzTracerProvider,
|
|
100
|
+
getTracerProvider,
|
|
101
|
+
bindToBrizz,
|
|
102
|
+
setPrivateTracerProvider,
|
|
103
|
+
isPrivateTracerProvider,
|
|
104
|
+
ensureContextManager,
|
|
105
|
+
injectTraceContext,
|
|
106
|
+
extractTraceContext
|
|
107
|
+
};
|
|
@@ -1,5 +1,8 @@
|
|
|
1
1
|
"use strict";Object.defineProperty(exports, "__esModule", {value: true});
|
|
2
2
|
|
|
3
|
+
var _chunkVZJNEST4cjs = require('./chunk-VZJNEST4.cjs');
|
|
4
|
+
|
|
5
|
+
|
|
3
6
|
var _chunkWC573FCIcjs = require('./chunk-WC573FCI.cjs');
|
|
4
7
|
|
|
5
8
|
// src/internal/instrumentation/google-genai.ts
|
|
@@ -8,6 +11,10 @@ var _instrumentationgooglegenerativeai = require('@traceloop/instrumentation-goo
|
|
|
8
11
|
var MODULE_NAME = "@google/genai";
|
|
9
12
|
var SUPPORTED_VERSIONS = [">=1.0.0 <3.0.0"];
|
|
10
13
|
var GoogleGenAIInstrumentation = class extends _instrumentationgooglegenerativeai.GenAIInstrumentation {
|
|
14
|
+
constructor(config) {
|
|
15
|
+
super(config);
|
|
16
|
+
this.setTracerProvider(_chunkVZJNEST4cjs.brizzTracerProvider);
|
|
17
|
+
}
|
|
11
18
|
/**
|
|
12
19
|
* Replace — not extend — upstream's module definition. Upstream returns a
|
|
13
20
|
* single definition for `@google/genai`; registering ours alongside it would
|
|
@@ -0,0 +1,107 @@
|
|
|
1
|
+
"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; } var _class; var _class2;// src/internal/trace/provider.ts
|
|
2
|
+
|
|
3
|
+
|
|
4
|
+
|
|
5
|
+
|
|
6
|
+
|
|
7
|
+
|
|
8
|
+
|
|
9
|
+
var _api = require('@opentelemetry/api');
|
|
10
|
+
var _contextasynchooks = require('@opentelemetry/context-async-hooks');
|
|
11
|
+
var _core = require('@opentelemetry/core');
|
|
12
|
+
var STATE_KEY = /* @__PURE__ */ Symbol.for("brizz.sdk.tracerProvider");
|
|
13
|
+
function state() {
|
|
14
|
+
const holder = globalThis;
|
|
15
|
+
holder[STATE_KEY] ??= { privateProvider: null };
|
|
16
|
+
return holder[STATE_KEY];
|
|
17
|
+
}
|
|
18
|
+
var LazyTracer = (_class = class {
|
|
19
|
+
constructor(name, version, options) {;_class.prototype.__init.call(this);
|
|
20
|
+
this.name = name;
|
|
21
|
+
this.version = version;
|
|
22
|
+
this.options = options;
|
|
23
|
+
}
|
|
24
|
+
|
|
25
|
+
|
|
26
|
+
|
|
27
|
+
resolve() {
|
|
28
|
+
const provider = _nullishCoalesce(state().privateProvider, () => ( _api.trace.getTracerProvider()));
|
|
29
|
+
return provider.getTracer(this.name, this.version, this.options);
|
|
30
|
+
}
|
|
31
|
+
startSpan(name, options, ctx) {
|
|
32
|
+
return this.resolve().startSpan(name, options, ctx);
|
|
33
|
+
}
|
|
34
|
+
__init() {this.startActiveSpan = ((...args) => {
|
|
35
|
+
const tracer = this.resolve();
|
|
36
|
+
return Reflect.apply(tracer.startActiveSpan, tracer, args);
|
|
37
|
+
})}
|
|
38
|
+
}, _class);
|
|
39
|
+
var BrizzTracerProvider = (_class2 = class {constructor() { _class2.prototype.__init2.call(this); }
|
|
40
|
+
__init2() {this.tracers = /* @__PURE__ */ new Map()}
|
|
41
|
+
getTracer(name, version, options) {
|
|
42
|
+
const key = `${name}@${_nullishCoalesce(version, () => ( ""))}:${_nullishCoalesce(_optionalChain([options, 'optionalAccess', _ => _.schemaUrl]), () => ( ""))}`;
|
|
43
|
+
let tracer = this.tracers.get(key);
|
|
44
|
+
if (!tracer) {
|
|
45
|
+
tracer = new LazyTracer(name, version, options);
|
|
46
|
+
this.tracers.set(key, tracer);
|
|
47
|
+
}
|
|
48
|
+
return tracer;
|
|
49
|
+
}
|
|
50
|
+
}, _class2);
|
|
51
|
+
var brizzTracerProvider = new BrizzTracerProvider();
|
|
52
|
+
function getTracerProvider() {
|
|
53
|
+
return brizzTracerProvider;
|
|
54
|
+
}
|
|
55
|
+
function bindToBrizz(instrumentation) {
|
|
56
|
+
instrumentation.setTracerProvider(brizzTracerProvider);
|
|
57
|
+
return instrumentation;
|
|
58
|
+
}
|
|
59
|
+
function setPrivateTracerProvider(provider) {
|
|
60
|
+
state().privateProvider = provider;
|
|
61
|
+
}
|
|
62
|
+
function isPrivateTracerProvider() {
|
|
63
|
+
return state().privateProvider !== null;
|
|
64
|
+
}
|
|
65
|
+
var PROBE_KEY = _api.createContextKey.call(void 0, "brizz.sdk.contextManagerProbe");
|
|
66
|
+
function contextManagerWorks() {
|
|
67
|
+
return _api.context.with(
|
|
68
|
+
_api.context.active().setValue(PROBE_KEY, true),
|
|
69
|
+
() => _api.context.active().getValue(PROBE_KEY) === true
|
|
70
|
+
);
|
|
71
|
+
}
|
|
72
|
+
function ensureContextManager() {
|
|
73
|
+
if (contextManagerWorks()) {
|
|
74
|
+
return "existing";
|
|
75
|
+
}
|
|
76
|
+
const manager = new (0, _contextasynchooks.AsyncLocalStorageContextManager)().enable();
|
|
77
|
+
if (_api.context.setGlobalContextManager(manager) && contextManagerWorks()) {
|
|
78
|
+
return "installed";
|
|
79
|
+
}
|
|
80
|
+
manager.disable();
|
|
81
|
+
return "failed";
|
|
82
|
+
}
|
|
83
|
+
var w3cPropagator = new (0, _core.W3CTraceContextPropagator)();
|
|
84
|
+
function injectTraceContext(ctx, carrier) {
|
|
85
|
+
if (isPrivateTracerProvider()) {
|
|
86
|
+
w3cPropagator.inject(ctx, carrier, _api.defaultTextMapSetter);
|
|
87
|
+
} else {
|
|
88
|
+
_api.propagation.inject(ctx, carrier);
|
|
89
|
+
}
|
|
90
|
+
}
|
|
91
|
+
function extractTraceContext(ctx, carrier) {
|
|
92
|
+
if (isPrivateTracerProvider()) {
|
|
93
|
+
return w3cPropagator.extract(ctx, carrier, _api.defaultTextMapGetter);
|
|
94
|
+
}
|
|
95
|
+
return _api.propagation.extract(ctx, carrier);
|
|
96
|
+
}
|
|
97
|
+
|
|
98
|
+
|
|
99
|
+
|
|
100
|
+
|
|
101
|
+
|
|
102
|
+
|
|
103
|
+
|
|
104
|
+
|
|
105
|
+
|
|
106
|
+
|
|
107
|
+
exports.brizzTracerProvider = brizzTracerProvider; exports.getTracerProvider = getTracerProvider; exports.bindToBrizz = bindToBrizz; exports.setPrivateTracerProvider = setPrivateTracerProvider; exports.isPrivateTracerProvider = isPrivateTracerProvider; exports.ensureContextManager = ensureContextManager; exports.injectTraceContext = injectTraceContext; exports.extractTraceContext = extractTraceContext;
|
|
@@ -1,3 +1,6 @@
|
|
|
1
|
+
import {
|
|
2
|
+
brizzTracerProvider
|
|
3
|
+
} from "./chunk-DBN4NKIG.js";
|
|
1
4
|
import {
|
|
2
5
|
logger
|
|
3
6
|
} from "./chunk-Y4HNUX3Q.js";
|
|
@@ -8,6 +11,10 @@ import { GenAIInstrumentation } from "@traceloop/instrumentation-google-generati
|
|
|
8
11
|
var MODULE_NAME = "@google/genai";
|
|
9
12
|
var SUPPORTED_VERSIONS = [">=1.0.0 <3.0.0"];
|
|
10
13
|
var GoogleGenAIInstrumentation = class extends GenAIInstrumentation {
|
|
14
|
+
constructor(config) {
|
|
15
|
+
super(config);
|
|
16
|
+
this.setTracerProvider(brizzTracerProvider);
|
|
17
|
+
}
|
|
11
18
|
/**
|
|
12
19
|
* Replace — not extend — upstream's module definition. Upstream returns a
|
|
13
20
|
* single definition for `@google/genai`; registering ours alongside it would
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
"use strict";Object.defineProperty(exports, "__esModule", {value: true});
|
|
2
|
+
|
|
3
|
+
|
|
4
|
+
var _chunkFQBVTIBRcjs = require('./chunk-FQBVTIBR.cjs');
|
|
5
|
+
require('./chunk-VZJNEST4.cjs');
|
|
6
|
+
require('./chunk-WC573FCI.cjs');
|
|
7
|
+
require('./chunk-OBGZSXTJ.cjs');
|
|
8
|
+
|
|
9
|
+
|
|
10
|
+
|
|
11
|
+
exports.GoogleGenAIInstrumentation = _chunkFQBVTIBRcjs.GoogleGenAIInstrumentation; exports.instrumentGoogleGenAI = _chunkFQBVTIBRcjs.instrumentGoogleGenAI;
|
package/dist/google-genai.cjs
CHANGED
|
@@ -1,8 +1,9 @@
|
|
|
1
1
|
"use strict";Object.defineProperty(exports, "__esModule", {value: true});
|
|
2
2
|
|
|
3
|
-
var
|
|
3
|
+
var _chunkFQBVTIBRcjs = require('./chunk-FQBVTIBR.cjs');
|
|
4
|
+
require('./chunk-VZJNEST4.cjs');
|
|
4
5
|
require('./chunk-WC573FCI.cjs');
|
|
5
6
|
require('./chunk-OBGZSXTJ.cjs');
|
|
6
7
|
|
|
7
8
|
|
|
8
|
-
exports.instrumentGoogleGenAI =
|
|
9
|
+
exports.instrumentGoogleGenAI = _chunkFQBVTIBRcjs.instrumentGoogleGenAI;
|