@bastani/atomic-telemetry 0.0.0-stage → 0.9.88
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/LICENSE +22 -0
- package/NOTICE.md +13 -0
- package/README.md +65 -2
- package/dist/index.d.ts +286 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +19 -0
- package/dist/index.js.map +1 -0
- package/dist/memory.d.ts +71 -0
- package/dist/memory.d.ts.map +1 -0
- package/dist/memory.js +329 -0
- package/dist/memory.js.map +1 -0
- package/dist/metrics.d.ts +78 -0
- package/dist/metrics.d.ts.map +1 -0
- package/dist/metrics.js +14 -0
- package/dist/metrics.js.map +1 -0
- package/dist/noop.d.ts +9 -0
- package/dist/noop.d.ts.map +1 -0
- package/dist/noop.js +30 -0
- package/dist/noop.js.map +1 -0
- package/dist/render.d.ts +8 -0
- package/dist/render.d.ts.map +1 -0
- package/dist/render.js +65 -0
- package/dist/render.js.map +1 -0
- package/dist/testing/conformance.d.ts +4 -0
- package/dist/testing/conformance.d.ts.map +1 -0
- package/dist/testing/conformance.js +388 -0
- package/dist/testing/conformance.js.map +1 -0
- package/dist/testing/index.d.ts +3 -0
- package/dist/testing/index.d.ts.map +1 -0
- package/dist/testing/index.js +2 -0
- package/dist/testing/index.js.map +1 -0
- package/dist/testing/types.d.ts +19 -0
- package/dist/testing/types.d.ts.map +1 -0
- package/dist/testing/types.js +2 -0
- package/dist/testing/types.js.map +1 -0
- package/package.json +65 -4
package/dist/memory.js
ADDED
|
@@ -0,0 +1,329 @@
|
|
|
1
|
+
import { NOOP_TELEMETRY_CONTEXT } from "./noop.js";
|
|
2
|
+
function carrierId(carrier) {
|
|
3
|
+
return `${carrier["pi-memory-scope"]}:${carrier["pi-memory-span"]}`;
|
|
4
|
+
}
|
|
5
|
+
// The clock of span times: wall-clock milliseconds at microsecond resolution, from the monotonic high-resolution
|
|
6
|
+
// clock anchored to the wall clock (`telemetryNow`, also Chord's SQLite store's).
|
|
7
|
+
/**
|
|
8
|
+
* How far the anchored clock may part from `Date.now()` before it is anchored anew: more than `Date.now()`'s own
|
|
9
|
+
* truncation to whole milliseconds, less than any step worth following (a wall clock set, a sleep the monotonic clock
|
|
10
|
+
* did not count).
|
|
11
|
+
*/
|
|
12
|
+
const TOLERANCE_MS = 10;
|
|
13
|
+
/** The wall-clock time of `performance.now()`'s zero; `performance.timeOrigin` until the first step is followed. */
|
|
14
|
+
let anchor = performance.timeOrigin;
|
|
15
|
+
/**
|
|
16
|
+
* Now as milliseconds since the epoch, rounded to the microsecond: `performance.now()` (monotonic, sub-millisecond)
|
|
17
|
+
* plus an anchor to the wall clock. While the two agree within 10 ms, times in one process keep their order and
|
|
18
|
+
* spacing to the microsecond; past that the clock follows `Date.now()` again, at whole milliseconds. Every adapter
|
|
19
|
+
* of this package and Chord's SQLite store stamp span starts with it, so their times agree.
|
|
20
|
+
*/
|
|
21
|
+
export function telemetryNow() {
|
|
22
|
+
const clock = performance.now();
|
|
23
|
+
const wall = Date.now();
|
|
24
|
+
if (Math.abs(anchor + clock - wall) > TOLERANCE_MS)
|
|
25
|
+
anchor = wall - clock;
|
|
26
|
+
return microseconds(anchor + clock);
|
|
27
|
+
}
|
|
28
|
+
/** `ms` rounded to the microsecond, as span times are. */
|
|
29
|
+
function microseconds(ms) {
|
|
30
|
+
return Math.round(ms * 1000) / 1000;
|
|
31
|
+
}
|
|
32
|
+
// Identity survives settlement without exposing backend IDs on the generic context contract.
|
|
33
|
+
const contextCarriers = new WeakMap();
|
|
34
|
+
function copyAttributes(attributes) {
|
|
35
|
+
return Object.fromEntries(Object.entries(attributes ?? {})
|
|
36
|
+
.filter(([, value]) => value !== undefined)
|
|
37
|
+
.map(([name, value]) => [name, Array.isArray(value) ? [...value] : value]));
|
|
38
|
+
}
|
|
39
|
+
function copyLink(link) {
|
|
40
|
+
const context = contextCarriers.get(link.context);
|
|
41
|
+
return context ? { context: { ...context }, attributes: copyAttributes(link.attributes) } : undefined;
|
|
42
|
+
}
|
|
43
|
+
function copyStatus(status) {
|
|
44
|
+
if (status.status === "ok")
|
|
45
|
+
return { status: "ok" };
|
|
46
|
+
return status.error
|
|
47
|
+
? { status: "error", error: { name: status.error.name, message: status.error.message } }
|
|
48
|
+
: { status: "error" };
|
|
49
|
+
}
|
|
50
|
+
function createSpan(state, parent, options) {
|
|
51
|
+
const name = options.name;
|
|
52
|
+
const attributes = copyAttributes(options.attributes);
|
|
53
|
+
const links = [];
|
|
54
|
+
for (const link of options.links ?? []) {
|
|
55
|
+
const copy = copyLink(link);
|
|
56
|
+
if (copy)
|
|
57
|
+
links.push(copy);
|
|
58
|
+
}
|
|
59
|
+
const id = state.nextSpanId++;
|
|
60
|
+
return {
|
|
61
|
+
startedMs: telemetryNow(),
|
|
62
|
+
clock: performance.now(),
|
|
63
|
+
id,
|
|
64
|
+
parentId: parent?.localId ?? null,
|
|
65
|
+
context: {
|
|
66
|
+
"pi-memory-scope": state.scope,
|
|
67
|
+
"pi-memory-span": String(id),
|
|
68
|
+
"pi-memory-trace": parent?.context["pi-memory-trace"] ?? `${state.scope}:${id}`,
|
|
69
|
+
},
|
|
70
|
+
parentContext: parent ? { ...parent.context } : null,
|
|
71
|
+
links,
|
|
72
|
+
name,
|
|
73
|
+
attributes,
|
|
74
|
+
events: [],
|
|
75
|
+
status: { status: "ok" },
|
|
76
|
+
explicitStatus: false,
|
|
77
|
+
settled: false,
|
|
78
|
+
};
|
|
79
|
+
}
|
|
80
|
+
function startInertSpan(state, options, callback) {
|
|
81
|
+
return NOOP_TELEMETRY_CONTEXT.startSpan(options, (noop) => callback({
|
|
82
|
+
...noop,
|
|
83
|
+
metrics: state.metrics,
|
|
84
|
+
propagation: state.propagation,
|
|
85
|
+
startSpan: (childOptions, childCallback) => startInertSpan(state, childOptions, childCallback),
|
|
86
|
+
}));
|
|
87
|
+
}
|
|
88
|
+
async function startInMemorySpan(state, parent, options, callback) {
|
|
89
|
+
if (parent?.span?.settled)
|
|
90
|
+
return startInertSpan(state, options, callback);
|
|
91
|
+
const recordedSpan = createSpan(state, parent, options);
|
|
92
|
+
state.spans.push(recordedSpan);
|
|
93
|
+
const span = {
|
|
94
|
+
metrics: state.metrics,
|
|
95
|
+
propagation: state.propagation,
|
|
96
|
+
startSpan: (childOptions, childCallback) => startInMemorySpan(state, { context: recordedSpan.context, localId: recordedSpan.id, span: recordedSpan }, childOptions, childCallback),
|
|
97
|
+
addLink(link) {
|
|
98
|
+
if (recordedSpan.settled)
|
|
99
|
+
return;
|
|
100
|
+
const copy = copyLink(link);
|
|
101
|
+
if (copy)
|
|
102
|
+
recordedSpan.links.push(copy);
|
|
103
|
+
},
|
|
104
|
+
addEvent(name, attributes) {
|
|
105
|
+
if (recordedSpan.settled)
|
|
106
|
+
return;
|
|
107
|
+
recordedSpan.events.push({
|
|
108
|
+
name,
|
|
109
|
+
timeMs: microseconds(performance.now() - recordedSpan.clock),
|
|
110
|
+
attributes: copyAttributes(attributes),
|
|
111
|
+
});
|
|
112
|
+
},
|
|
113
|
+
setAttributes(attributes) {
|
|
114
|
+
if (recordedSpan.settled)
|
|
115
|
+
return;
|
|
116
|
+
recordedSpan.attributes = { ...recordedSpan.attributes, ...copyAttributes(attributes) };
|
|
117
|
+
},
|
|
118
|
+
setStatus(status) {
|
|
119
|
+
if (recordedSpan.settled)
|
|
120
|
+
return;
|
|
121
|
+
recordedSpan.status = copyStatus(status);
|
|
122
|
+
recordedSpan.explicitStatus = true;
|
|
123
|
+
},
|
|
124
|
+
};
|
|
125
|
+
contextCarriers.set(span, recordedSpan.context);
|
|
126
|
+
try {
|
|
127
|
+
return await callback(span);
|
|
128
|
+
}
|
|
129
|
+
catch (error) {
|
|
130
|
+
if (!recordedSpan.explicitStatus)
|
|
131
|
+
recordedSpan.status =
|
|
132
|
+
error instanceof Error
|
|
133
|
+
? { status: "error", error: { name: error.name, message: error.message } }
|
|
134
|
+
: { status: "error" };
|
|
135
|
+
throw error;
|
|
136
|
+
}
|
|
137
|
+
finally {
|
|
138
|
+
recordedSpan.settled = true;
|
|
139
|
+
recordedSpan.endedMs = microseconds(recordedSpan.startedMs + performance.now() - recordedSpan.clock);
|
|
140
|
+
recordedSpan.endSequence = state.nextEndSequence++;
|
|
141
|
+
}
|
|
142
|
+
}
|
|
143
|
+
function createMeasurementRecorder(state, kind, name, options) {
|
|
144
|
+
const description = options?.description;
|
|
145
|
+
const unit = options?.unit;
|
|
146
|
+
const boundaries = kind === "histogram" && options?.boundaries !== undefined ? [...options.boundaries] : undefined;
|
|
147
|
+
const metadata = {
|
|
148
|
+
kind,
|
|
149
|
+
name,
|
|
150
|
+
...(description === undefined ? {} : { description }),
|
|
151
|
+
...(unit === undefined ? {} : { unit }),
|
|
152
|
+
...(boundaries === undefined ? {} : { boundaries }),
|
|
153
|
+
};
|
|
154
|
+
return (value, attributes, context) => {
|
|
155
|
+
const carrier = context === undefined ? undefined : contextCarriers.get(context);
|
|
156
|
+
state.measurements.push({
|
|
157
|
+
intervalMs: Math.floor(Date.now() / 10_000) * 10_000,
|
|
158
|
+
measurement: {
|
|
159
|
+
...metadata,
|
|
160
|
+
value,
|
|
161
|
+
attributes: copyAttributes(attributes),
|
|
162
|
+
context: carrier ? { ...carrier } : null,
|
|
163
|
+
},
|
|
164
|
+
});
|
|
165
|
+
};
|
|
166
|
+
}
|
|
167
|
+
/**
|
|
168
|
+
* Backend-neutral reference implementation that records spans in process memory.
|
|
169
|
+
* Create a fresh instance to isolate tests or independent recording scopes.
|
|
170
|
+
*/
|
|
171
|
+
export class InMemoryTelemetryContext {
|
|
172
|
+
metrics = this;
|
|
173
|
+
propagation = this;
|
|
174
|
+
state = {
|
|
175
|
+
metrics: this,
|
|
176
|
+
propagation: this,
|
|
177
|
+
scope: crypto.randomUUID(),
|
|
178
|
+
spans: [],
|
|
179
|
+
measurements: [],
|
|
180
|
+
nextSpanId: 1,
|
|
181
|
+
nextEndSequence: 1,
|
|
182
|
+
};
|
|
183
|
+
startSpan(options, callback) {
|
|
184
|
+
return startInMemorySpan(this.state, undefined, options, callback);
|
|
185
|
+
}
|
|
186
|
+
/** Returns a detached carrier for a known span or extracted parent, including settled spans. */
|
|
187
|
+
inject(context) {
|
|
188
|
+
const carrier = contextCarriers.get(context);
|
|
189
|
+
return carrier ? { ...carrier } : undefined;
|
|
190
|
+
}
|
|
191
|
+
/** Missing or non-string carrier identities fall back to this recorder's root context. */
|
|
192
|
+
extract(carrier) {
|
|
193
|
+
const scope = carrier?.["pi-memory-scope"];
|
|
194
|
+
const span = carrier?.["pi-memory-span"];
|
|
195
|
+
const traceId = carrier?.["pi-memory-trace"];
|
|
196
|
+
if (typeof scope !== "string" || typeof span !== "string" || typeof traceId !== "string")
|
|
197
|
+
return this;
|
|
198
|
+
const context = { "pi-memory-scope": scope, "pi-memory-span": span, "pi-memory-trace": traceId };
|
|
199
|
+
const localId = scope === this.state.scope ? Number(span) : null;
|
|
200
|
+
const parent = {
|
|
201
|
+
metrics: this,
|
|
202
|
+
propagation: this,
|
|
203
|
+
startSpan: (options, callback) => startInMemorySpan(this.state, { context, localId }, options, callback),
|
|
204
|
+
};
|
|
205
|
+
contextCarriers.set(parent, context);
|
|
206
|
+
return parent;
|
|
207
|
+
}
|
|
208
|
+
counter(name, options) {
|
|
209
|
+
return { add: createMeasurementRecorder(this.state, "counter", name, options) };
|
|
210
|
+
}
|
|
211
|
+
upDownCounter(name, options) {
|
|
212
|
+
return { add: createMeasurementRecorder(this.state, "upDownCounter", name, options) };
|
|
213
|
+
}
|
|
214
|
+
histogram(name, options) {
|
|
215
|
+
return { record: createMeasurementRecorder(this.state, "histogram", name, options) };
|
|
216
|
+
}
|
|
217
|
+
storedSpans() {
|
|
218
|
+
return this.state.spans
|
|
219
|
+
.filter((span) => span.settled)
|
|
220
|
+
.map((span) => ({
|
|
221
|
+
id: carrierId(span.context),
|
|
222
|
+
traceId: span.context["pi-memory-trace"],
|
|
223
|
+
...(span.parentContext ? { parentId: carrierId(span.parentContext) } : {}),
|
|
224
|
+
name: span.name,
|
|
225
|
+
startedMs: span.startedMs,
|
|
226
|
+
endedMs: span.endedMs,
|
|
227
|
+
attributes: copyAttributes(span.attributes),
|
|
228
|
+
events: span.events.map((event) => ({
|
|
229
|
+
name: event.name,
|
|
230
|
+
timeMs: event.timeMs,
|
|
231
|
+
attributes: copyAttributes(event.attributes),
|
|
232
|
+
})),
|
|
233
|
+
links: span.links.map((link) => ({
|
|
234
|
+
traceId: link.context["pi-memory-trace"],
|
|
235
|
+
spanId: carrierId(link.context),
|
|
236
|
+
attributes: copyAttributes(link.attributes),
|
|
237
|
+
})),
|
|
238
|
+
status: copyStatus(span.status),
|
|
239
|
+
}))
|
|
240
|
+
.sort((a, b) => a.startedMs - b.startedMs || (a.id < b.id ? -1 : a.id > b.id ? 1 : 0));
|
|
241
|
+
}
|
|
242
|
+
async getTrace(traceId) {
|
|
243
|
+
const spans = this.storedSpans().filter((span) => span.traceId === traceId);
|
|
244
|
+
return spans.length ? { traceId, spans } : undefined;
|
|
245
|
+
}
|
|
246
|
+
async findTraces(query = {}) {
|
|
247
|
+
const limit = query.limit ?? 20;
|
|
248
|
+
const after = query.cursor === undefined ? undefined : JSON.parse(query.cursor);
|
|
249
|
+
const grouped = new Map();
|
|
250
|
+
for (const span of this.storedSpans()) {
|
|
251
|
+
let trace = grouped.get(span.traceId);
|
|
252
|
+
if (!trace) {
|
|
253
|
+
trace = { traceId: span.traceId, spans: [] };
|
|
254
|
+
grouped.set(span.traceId, trace);
|
|
255
|
+
}
|
|
256
|
+
trace.spans.push(span);
|
|
257
|
+
}
|
|
258
|
+
const matches = [...grouped.values()]
|
|
259
|
+
.filter((trace) => {
|
|
260
|
+
const first = trace.spans[0];
|
|
261
|
+
return ((query.name === undefined || first.name === query.name) &&
|
|
262
|
+
(query.startMin === undefined || first.startedMs >= query.startMin) &&
|
|
263
|
+
(query.startMax === undefined || first.startedMs <= query.startMax) &&
|
|
264
|
+
(!after || first.startedMs < after[0] || (first.startedMs === after[0] && trace.traceId > after[1])) &&
|
|
265
|
+
(!query.errors || trace.spans.some((span) => span.status.status === "error")) &&
|
|
266
|
+
(!query.attributes ||
|
|
267
|
+
trace.spans.some((span) => Object.entries(query.attributes).every(([key, value]) => span.attributes[key] === value))));
|
|
268
|
+
})
|
|
269
|
+
.sort((a, b) => b.spans[0].startedMs - a.spans[0].startedMs ||
|
|
270
|
+
(a.traceId < b.traceId ? -1 : a.traceId > b.traceId ? 1 : 0));
|
|
271
|
+
const traces = matches.slice(0, limit);
|
|
272
|
+
const last = traces.at(-1);
|
|
273
|
+
return {
|
|
274
|
+
traces,
|
|
275
|
+
...(matches.length > limit ? { cursor: JSON.stringify([last.spans[0].startedMs, last.traceId]) } : {}),
|
|
276
|
+
};
|
|
277
|
+
}
|
|
278
|
+
/** Read raw measurements as count-one rows, without changing getMetrics() snapshots. */
|
|
279
|
+
async findMetrics(query) {
|
|
280
|
+
return this.state.measurements
|
|
281
|
+
.filter(({ intervalMs, measurement }) => measurement.name === query.name &&
|
|
282
|
+
(query.startMin === undefined || intervalMs >= query.startMin) &&
|
|
283
|
+
(query.startMax === undefined || intervalMs <= query.startMax) &&
|
|
284
|
+
Object.entries(query.attributes ?? {}).every(([key, value]) => measurement.attributes[key] === value))
|
|
285
|
+
.map(({ intervalMs, measurement }) => ({
|
|
286
|
+
intervalMs,
|
|
287
|
+
name: measurement.name,
|
|
288
|
+
kind: measurement.kind,
|
|
289
|
+
...(measurement.unit === undefined ? {} : { unit: measurement.unit }),
|
|
290
|
+
attributes: copyAttributes(measurement.attributes),
|
|
291
|
+
count: 1,
|
|
292
|
+
sum: measurement.value,
|
|
293
|
+
min: measurement.value,
|
|
294
|
+
max: measurement.value,
|
|
295
|
+
}));
|
|
296
|
+
}
|
|
297
|
+
/** Returns detached measurements in recording order, without aggregation. */
|
|
298
|
+
getMetrics() {
|
|
299
|
+
return this.state.measurements.map(({ measurement }) => ({
|
|
300
|
+
...measurement,
|
|
301
|
+
...(measurement.boundaries === undefined ? {} : { boundaries: [...measurement.boundaries] }),
|
|
302
|
+
attributes: copyAttributes(measurement.attributes),
|
|
303
|
+
context: measurement.context ? { ...measurement.context } : null,
|
|
304
|
+
}));
|
|
305
|
+
}
|
|
306
|
+
/** Returns detached snapshots in span-start order. */
|
|
307
|
+
getSpans() {
|
|
308
|
+
return this.state.spans.map((span) => ({
|
|
309
|
+
id: span.id,
|
|
310
|
+
parentId: span.parentId,
|
|
311
|
+
context: { ...span.context },
|
|
312
|
+
parentContext: span.parentContext ? { ...span.parentContext } : null,
|
|
313
|
+
links: span.links.map((link) => ({
|
|
314
|
+
context: { ...link.context },
|
|
315
|
+
attributes: copyAttributes(link.attributes),
|
|
316
|
+
})),
|
|
317
|
+
name: span.name,
|
|
318
|
+
attributes: copyAttributes(span.attributes),
|
|
319
|
+
events: span.events.map((event) => ({
|
|
320
|
+
name: event.name,
|
|
321
|
+
attributes: copyAttributes(event.attributes),
|
|
322
|
+
})),
|
|
323
|
+
status: copyStatus(span.status),
|
|
324
|
+
settled: span.settled,
|
|
325
|
+
...(span.endSequence === undefined ? {} : { endSequence: span.endSequence }),
|
|
326
|
+
}));
|
|
327
|
+
}
|
|
328
|
+
}
|
|
329
|
+
//# sourceMappingURL=memory.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"memory.js","sourceRoot":"","sources":["../src/memory.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n\tMetricQuery,\n\tSpanAttributes,\n\tSpanLink,\n\tSpanOptions,\n\tSpanStatus,\n\tStoredMetric,\n\tStoredSpan,\n\tStoredTrace,\n\tTelemetryCarrier,\n\tTelemetryContext,\n\tTelemetryPropagation,\n\tTelemetrySpan,\n\tTelemetryStore,\n\tTraceQuery,\n} from \"./index.ts\";\nimport type {\n\tHistogramOptions,\n\tInstrumentOptions,\n\tTelemetryCounter,\n\tTelemetryHistogram,\n\tTelemetryMetrics,\n\tTelemetryUpDownCounter,\n} from \"./metrics.ts\";\nimport { NOOP_TELEMETRY_CONTEXT } from \"./noop.ts\";\n\nexport interface RecordedTelemetryEvent {\n\treadonly name: string;\n\treadonly attributes: Readonly<SpanAttributes>;\n}\n\nexport interface RecordedTelemetryLink {\n\treadonly context: Readonly<TelemetryCarrier>;\n\treadonly attributes: Readonly<SpanAttributes>;\n}\n\nexport interface RecordedTelemetrySpan {\n\treadonly id: number;\n\t/** Local parent ID, or null for roots and parents owned by another recorder. */\n\treadonly parentId: number | null;\n\treadonly context: Readonly<TelemetryCarrier>;\n\treadonly parentContext: Readonly<TelemetryCarrier> | null;\n\treadonly links: readonly RecordedTelemetryLink[];\n\treadonly name: string;\n\treadonly attributes: Readonly<SpanAttributes>;\n\treadonly events: readonly RecordedTelemetryEvent[];\n\treadonly status: SpanStatus;\n\treadonly settled: boolean;\n\treadonly endSequence?: number;\n}\n\nexport interface RecordedTelemetryMeasurement {\n\treadonly kind: \"counter\" | \"upDownCounter\" | \"histogram\";\n\treadonly name: string;\n\treadonly description?: string;\n\treadonly unit?: string;\n\treadonly boundaries?: readonly number[];\n\treadonly value: number;\n\treadonly attributes: Readonly<SpanAttributes>;\n\treadonly context: Readonly<TelemetryCarrier> | null;\n}\n\ninterface MutableRecordedTelemetryEvent {\n\ttimeMs: number;\n\tname: string;\n\tattributes: SpanAttributes;\n}\n\ninterface MutableRecordedTelemetrySpan {\n\tstartedMs: number;\n\tclock: number;\n\tendedMs?: number;\n\tid: number;\n\tparentId: number | null;\n\tcontext: TelemetryCarrier;\n\tparentContext: TelemetryCarrier | null;\n\tlinks: RecordedTelemetryLink[];\n\tname: string;\n\tattributes: SpanAttributes;\n\tevents: MutableRecordedTelemetryEvent[];\n\tstatus: SpanStatus;\n\texplicitStatus: boolean;\n\tsettled: boolean;\n\tendSequence?: number;\n}\n\ninterface InMemoryParent {\n\tcontext: TelemetryCarrier;\n\tlocalId: number | null;\n\tspan?: MutableRecordedTelemetrySpan;\n}\n\nfunction carrierId(carrier: Readonly<TelemetryCarrier>): string {\n\treturn `${carrier[\"pi-memory-scope\"]}:${carrier[\"pi-memory-span\"]}`;\n}\n\n// The clock of span times: wall-clock milliseconds at microsecond resolution, from the monotonic high-resolution\n// clock anchored to the wall clock (`telemetryNow`, also Chord's SQLite store's).\n\n/**\n * How far the anchored clock may part from `Date.now()` before it is anchored anew: more than `Date.now()`'s own\n * truncation to whole milliseconds, less than any step worth following (a wall clock set, a sleep the monotonic clock\n * did not count).\n */\nconst TOLERANCE_MS = 10;\n\n/** The wall-clock time of `performance.now()`'s zero; `performance.timeOrigin` until the first step is followed. */\nlet anchor = performance.timeOrigin;\n\n/**\n * Now as milliseconds since the epoch, rounded to the microsecond: `performance.now()` (monotonic, sub-millisecond)\n * plus an anchor to the wall clock. While the two agree within 10 ms, times in one process keep their order and\n * spacing to the microsecond; past that the clock follows `Date.now()` again, at whole milliseconds. Every adapter\n * of this package and Chord's SQLite store stamp span starts with it, so their times agree.\n */\nexport function telemetryNow(): number {\n\tconst clock = performance.now();\n\tconst wall = Date.now();\n\tif (Math.abs(anchor + clock - wall) > TOLERANCE_MS) anchor = wall - clock;\n\treturn microseconds(anchor + clock);\n}\n\n/** `ms` rounded to the microsecond, as span times are. */\nfunction microseconds(ms: number): number {\n\treturn Math.round(ms * 1000) / 1000;\n}\n\n// Identity survives settlement without exposing backend IDs on the generic context contract.\nconst contextCarriers = new WeakMap<TelemetryContext, TelemetryCarrier>();\n\ninterface InMemoryTelemetryState {\n\tmetrics: TelemetryMetrics;\n\tpropagation: TelemetryPropagation;\n\tscope: string;\n\tspans: MutableRecordedTelemetrySpan[];\n\tmeasurements: { intervalMs: number; measurement: RecordedTelemetryMeasurement }[];\n\tnextSpanId: number;\n\tnextEndSequence: number;\n}\n\nfunction copyAttributes(attributes?: SpanAttributes): SpanAttributes {\n\treturn Object.fromEntries(\n\t\tObject.entries(attributes ?? {})\n\t\t\t.filter(([, value]) => value !== undefined)\n\t\t\t.map(([name, value]) => [name, Array.isArray(value) ? [...value] : value]),\n\t);\n}\n\nfunction copyLink(link: SpanLink): RecordedTelemetryLink | undefined {\n\tconst context = contextCarriers.get(link.context);\n\treturn context ? { context: { ...context }, attributes: copyAttributes(link.attributes) } : undefined;\n}\n\nfunction copyStatus(status: SpanStatus): SpanStatus {\n\tif (status.status === \"ok\") return { status: \"ok\" };\n\treturn status.error\n\t\t? { status: \"error\", error: { name: status.error.name, message: status.error.message } }\n\t\t: { status: \"error\" };\n}\n\nfunction createSpan(\n\tstate: InMemoryTelemetryState,\n\tparent: InMemoryParent | undefined,\n\toptions: SpanOptions,\n): MutableRecordedTelemetrySpan {\n\tconst name = options.name;\n\tconst attributes = copyAttributes(options.attributes);\n\tconst links: RecordedTelemetryLink[] = [];\n\tfor (const link of options.links ?? []) {\n\t\tconst copy = copyLink(link);\n\t\tif (copy) links.push(copy);\n\t}\n\tconst id = state.nextSpanId++;\n\treturn {\n\t\tstartedMs: telemetryNow(),\n\t\tclock: performance.now(),\n\t\tid,\n\t\tparentId: parent?.localId ?? null,\n\t\tcontext: {\n\t\t\t\"pi-memory-scope\": state.scope,\n\t\t\t\"pi-memory-span\": String(id),\n\t\t\t\"pi-memory-trace\": parent?.context[\"pi-memory-trace\"] ?? `${state.scope}:${id}`,\n\t\t},\n\t\tparentContext: parent ? { ...parent.context } : null,\n\t\tlinks,\n\t\tname,\n\t\tattributes,\n\t\tevents: [],\n\t\tstatus: { status: \"ok\" },\n\t\texplicitStatus: false,\n\t\tsettled: false,\n\t};\n}\n\nfunction startInertSpan<T>(\n\tstate: InMemoryTelemetryState,\n\toptions: SpanOptions,\n\tcallback: (span: TelemetrySpan) => T | Promise<T>,\n): Promise<T> {\n\treturn NOOP_TELEMETRY_CONTEXT.startSpan(options, (noop) =>\n\t\tcallback({\n\t\t\t...noop,\n\t\t\tmetrics: state.metrics,\n\t\t\tpropagation: state.propagation,\n\t\t\tstartSpan: <Result>(\n\t\t\t\tchildOptions: SpanOptions,\n\t\t\t\tchildCallback: (span: TelemetrySpan) => Result | Promise<Result>,\n\t\t\t) => startInertSpan(state, childOptions, childCallback),\n\t\t}),\n\t);\n}\n\nasync function startInMemorySpan<T>(\n\tstate: InMemoryTelemetryState,\n\tparent: InMemoryParent | undefined,\n\toptions: SpanOptions,\n\tcallback: (span: TelemetrySpan) => T | Promise<T>,\n): Promise<T> {\n\tif (parent?.span?.settled) return startInertSpan(state, options, callback);\n\n\tconst recordedSpan = createSpan(state, parent, options);\n\tstate.spans.push(recordedSpan);\n\n\tconst span: TelemetrySpan = {\n\t\tmetrics: state.metrics,\n\t\tpropagation: state.propagation,\n\t\tstartSpan: <Result>(\n\t\t\tchildOptions: SpanOptions,\n\t\t\tchildCallback: (child: TelemetrySpan) => Result | Promise<Result>,\n\t\t) =>\n\t\t\tstartInMemorySpan(\n\t\t\t\tstate,\n\t\t\t\t{ context: recordedSpan.context, localId: recordedSpan.id, span: recordedSpan },\n\t\t\t\tchildOptions,\n\t\t\t\tchildCallback,\n\t\t\t),\n\t\taddLink(link) {\n\t\t\tif (recordedSpan.settled) return;\n\t\t\tconst copy = copyLink(link);\n\t\t\tif (copy) recordedSpan.links.push(copy);\n\t\t},\n\t\taddEvent(name, attributes) {\n\t\t\tif (recordedSpan.settled) return;\n\t\t\trecordedSpan.events.push({\n\t\t\t\tname,\n\t\t\t\ttimeMs: microseconds(performance.now() - recordedSpan.clock),\n\t\t\t\tattributes: copyAttributes(attributes),\n\t\t\t});\n\t\t},\n\t\tsetAttributes(attributes) {\n\t\t\tif (recordedSpan.settled) return;\n\t\t\trecordedSpan.attributes = { ...recordedSpan.attributes, ...copyAttributes(attributes) };\n\t\t},\n\t\tsetStatus(status) {\n\t\t\tif (recordedSpan.settled) return;\n\t\t\trecordedSpan.status = copyStatus(status);\n\t\t\trecordedSpan.explicitStatus = true;\n\t\t},\n\t};\n\n\tcontextCarriers.set(span, recordedSpan.context);\n\n\ttry {\n\t\treturn await callback(span);\n\t} catch (error) {\n\t\tif (!recordedSpan.explicitStatus)\n\t\t\trecordedSpan.status =\n\t\t\t\terror instanceof Error\n\t\t\t\t\t? { status: \"error\", error: { name: error.name, message: error.message } }\n\t\t\t\t\t: { status: \"error\" };\n\t\tthrow error;\n\t} finally {\n\t\trecordedSpan.settled = true;\n\t\trecordedSpan.endedMs = microseconds(recordedSpan.startedMs + performance.now() - recordedSpan.clock);\n\t\trecordedSpan.endSequence = state.nextEndSequence++;\n\t}\n}\n\nfunction createMeasurementRecorder(\n\tstate: InMemoryTelemetryState,\n\tkind: RecordedTelemetryMeasurement[\"kind\"],\n\tname: string,\n\toptions?: HistogramOptions,\n): (value: number, attributes?: SpanAttributes, context?: TelemetryContext) => void {\n\tconst description = options?.description;\n\tconst unit = options?.unit;\n\tconst boundaries = kind === \"histogram\" && options?.boundaries !== undefined ? [...options.boundaries] : undefined;\n\tconst metadata = {\n\t\tkind,\n\t\tname,\n\t\t...(description === undefined ? {} : { description }),\n\t\t...(unit === undefined ? {} : { unit }),\n\t\t...(boundaries === undefined ? {} : { boundaries }),\n\t};\n\treturn (value, attributes, context) => {\n\t\tconst carrier = context === undefined ? undefined : contextCarriers.get(context);\n\t\tstate.measurements.push({\n\t\t\tintervalMs: Math.floor(Date.now() / 10_000) * 10_000,\n\t\t\tmeasurement: {\n\t\t\t\t...metadata,\n\t\t\t\tvalue,\n\t\t\t\tattributes: copyAttributes(attributes),\n\t\t\t\tcontext: carrier ? { ...carrier } : null,\n\t\t\t},\n\t\t});\n\t};\n}\n\n/**\n * Backend-neutral reference implementation that records spans in process memory.\n * Create a fresh instance to isolate tests or independent recording scopes.\n */\nexport class InMemoryTelemetryContext\n\timplements TelemetryContext, TelemetryPropagation, TelemetryMetrics, TelemetryStore\n{\n\treadonly metrics: TelemetryMetrics = this;\n\treadonly propagation: TelemetryPropagation = this;\n\tprivate readonly state: InMemoryTelemetryState = {\n\t\tmetrics: this,\n\t\tpropagation: this,\n\t\tscope: crypto.randomUUID(),\n\t\tspans: [],\n\t\tmeasurements: [],\n\t\tnextSpanId: 1,\n\t\tnextEndSequence: 1,\n\t};\n\n\tstartSpan<T>(options: SpanOptions, callback: (span: TelemetrySpan) => T | Promise<T>): Promise<T> {\n\t\treturn startInMemorySpan(this.state, undefined, options, callback);\n\t}\n\n\t/** Returns a detached carrier for a known span or extracted parent, including settled spans. */\n\tinject(context: TelemetryContext): TelemetryCarrier | undefined {\n\t\tconst carrier = contextCarriers.get(context);\n\t\treturn carrier ? { ...carrier } : undefined;\n\t}\n\n\t/** Missing or non-string carrier identities fall back to this recorder's root context. */\n\textract(carrier: TelemetryCarrier | undefined): TelemetryContext {\n\t\tconst scope = carrier?.[\"pi-memory-scope\"];\n\t\tconst span = carrier?.[\"pi-memory-span\"];\n\t\tconst traceId = carrier?.[\"pi-memory-trace\"];\n\t\tif (typeof scope !== \"string\" || typeof span !== \"string\" || typeof traceId !== \"string\") return this;\n\t\tconst context = { \"pi-memory-scope\": scope, \"pi-memory-span\": span, \"pi-memory-trace\": traceId };\n\t\tconst localId = scope === this.state.scope ? Number(span) : null;\n\t\tconst parent: TelemetryContext = {\n\t\t\tmetrics: this,\n\t\t\tpropagation: this,\n\t\t\tstartSpan: <T>(options: SpanOptions, callback: (span: TelemetrySpan) => T | Promise<T>) =>\n\t\t\t\tstartInMemorySpan(this.state, { context, localId }, options, callback),\n\t\t};\n\t\tcontextCarriers.set(parent, context);\n\t\treturn parent;\n\t}\n\n\tcounter(name: string, options?: InstrumentOptions): TelemetryCounter {\n\t\treturn { add: createMeasurementRecorder(this.state, \"counter\", name, options) };\n\t}\n\n\tupDownCounter(name: string, options?: InstrumentOptions): TelemetryUpDownCounter {\n\t\treturn { add: createMeasurementRecorder(this.state, \"upDownCounter\", name, options) };\n\t}\n\n\thistogram(name: string, options?: HistogramOptions): TelemetryHistogram {\n\t\treturn { record: createMeasurementRecorder(this.state, \"histogram\", name, options) };\n\t}\n\n\tprivate storedSpans(): StoredSpan[] {\n\t\treturn this.state.spans\n\t\t\t.filter((span) => span.settled)\n\t\t\t.map((span) => ({\n\t\t\t\tid: carrierId(span.context),\n\t\t\t\ttraceId: span.context[\"pi-memory-trace\"]!,\n\t\t\t\t...(span.parentContext ? { parentId: carrierId(span.parentContext) } : {}),\n\t\t\t\tname: span.name,\n\t\t\t\tstartedMs: span.startedMs,\n\t\t\t\tendedMs: span.endedMs!,\n\t\t\t\tattributes: copyAttributes(span.attributes),\n\t\t\t\tevents: span.events.map((event) => ({\n\t\t\t\t\tname: event.name,\n\t\t\t\t\ttimeMs: event.timeMs,\n\t\t\t\t\tattributes: copyAttributes(event.attributes),\n\t\t\t\t})),\n\t\t\t\tlinks: span.links.map((link) => ({\n\t\t\t\t\ttraceId: link.context[\"pi-memory-trace\"]!,\n\t\t\t\t\tspanId: carrierId(link.context),\n\t\t\t\t\tattributes: copyAttributes(link.attributes),\n\t\t\t\t})),\n\t\t\t\tstatus: copyStatus(span.status),\n\t\t\t}))\n\t\t\t.sort((a, b) => a.startedMs - b.startedMs || (a.id < b.id ? -1 : a.id > b.id ? 1 : 0));\n\t}\n\n\tasync getTrace(traceId: string): Promise<StoredTrace | undefined> {\n\t\tconst spans = this.storedSpans().filter((span) => span.traceId === traceId);\n\t\treturn spans.length ? { traceId, spans } : undefined;\n\t}\n\n\tasync findTraces(query: TraceQuery = {}): Promise<{ traces: readonly StoredTrace[]; cursor?: string }> {\n\t\tconst limit = query.limit ?? 20;\n\t\tconst after = query.cursor === undefined ? undefined : (JSON.parse(query.cursor) as [number, string]);\n\t\tconst grouped = new Map<string, { traceId: string; spans: StoredSpan[] }>();\n\t\tfor (const span of this.storedSpans()) {\n\t\t\tlet trace = grouped.get(span.traceId);\n\t\t\tif (!trace) {\n\t\t\t\ttrace = { traceId: span.traceId, spans: [] };\n\t\t\t\tgrouped.set(span.traceId, trace);\n\t\t\t}\n\t\t\ttrace.spans.push(span);\n\t\t}\n\t\tconst matches = [...grouped.values()]\n\t\t\t.filter((trace) => {\n\t\t\t\tconst first = trace.spans[0]!;\n\t\t\t\treturn (\n\t\t\t\t\t(query.name === undefined || first.name === query.name) &&\n\t\t\t\t\t(query.startMin === undefined || first.startedMs >= query.startMin) &&\n\t\t\t\t\t(query.startMax === undefined || first.startedMs <= query.startMax) &&\n\t\t\t\t\t(!after || first.startedMs < after[0] || (first.startedMs === after[0] && trace.traceId > after[1])) &&\n\t\t\t\t\t(!query.errors || trace.spans.some((span) => span.status.status === \"error\")) &&\n\t\t\t\t\t(!query.attributes ||\n\t\t\t\t\t\ttrace.spans.some((span) =>\n\t\t\t\t\t\t\tObject.entries(query.attributes!).every(([key, value]) => span.attributes[key] === value),\n\t\t\t\t\t\t))\n\t\t\t\t);\n\t\t\t})\n\t\t\t.sort(\n\t\t\t\t(a, b) =>\n\t\t\t\t\tb.spans[0]!.startedMs - a.spans[0]!.startedMs ||\n\t\t\t\t\t(a.traceId < b.traceId ? -1 : a.traceId > b.traceId ? 1 : 0),\n\t\t\t);\n\t\tconst traces = matches.slice(0, limit);\n\t\tconst last = traces.at(-1)!;\n\t\treturn {\n\t\t\ttraces,\n\t\t\t...(matches.length > limit ? { cursor: JSON.stringify([last.spans[0]!.startedMs, last.traceId]) } : {}),\n\t\t};\n\t}\n\n\t/** Read raw measurements as count-one rows, without changing getMetrics() snapshots. */\n\tasync findMetrics(query: MetricQuery): Promise<readonly StoredMetric[]> {\n\t\treturn this.state.measurements\n\t\t\t.filter(\n\t\t\t\t({ intervalMs, measurement }) =>\n\t\t\t\t\tmeasurement.name === query.name &&\n\t\t\t\t\t(query.startMin === undefined || intervalMs >= query.startMin) &&\n\t\t\t\t\t(query.startMax === undefined || intervalMs <= query.startMax) &&\n\t\t\t\t\tObject.entries(query.attributes ?? {}).every(([key, value]) => measurement.attributes[key] === value),\n\t\t\t)\n\t\t\t.map(({ intervalMs, measurement }) => ({\n\t\t\t\tintervalMs,\n\t\t\t\tname: measurement.name,\n\t\t\t\tkind: measurement.kind,\n\t\t\t\t...(measurement.unit === undefined ? {} : { unit: measurement.unit }),\n\t\t\t\tattributes: copyAttributes(measurement.attributes),\n\t\t\t\tcount: 1,\n\t\t\t\tsum: measurement.value,\n\t\t\t\tmin: measurement.value,\n\t\t\t\tmax: measurement.value,\n\t\t\t}));\n\t}\n\n\t/** Returns detached measurements in recording order, without aggregation. */\n\tgetMetrics(): readonly RecordedTelemetryMeasurement[] {\n\t\treturn this.state.measurements.map(({ measurement }) => ({\n\t\t\t...measurement,\n\t\t\t...(measurement.boundaries === undefined ? {} : { boundaries: [...measurement.boundaries] }),\n\t\t\tattributes: copyAttributes(measurement.attributes),\n\t\t\tcontext: measurement.context ? { ...measurement.context } : null,\n\t\t}));\n\t}\n\n\t/** Returns detached snapshots in span-start order. */\n\tgetSpans(): readonly RecordedTelemetrySpan[] {\n\t\treturn this.state.spans.map((span) => ({\n\t\t\tid: span.id,\n\t\t\tparentId: span.parentId,\n\t\t\tcontext: { ...span.context },\n\t\t\tparentContext: span.parentContext ? { ...span.parentContext } : null,\n\t\t\tlinks: span.links.map((link) => ({\n\t\t\t\tcontext: { ...link.context },\n\t\t\t\tattributes: copyAttributes(link.attributes),\n\t\t\t})),\n\t\t\tname: span.name,\n\t\t\tattributes: copyAttributes(span.attributes),\n\t\t\tevents: span.events.map((event) => ({\n\t\t\t\tname: event.name,\n\t\t\t\tattributes: copyAttributes(event.attributes),\n\t\t\t})),\n\t\t\tstatus: copyStatus(span.status),\n\t\t\tsettled: span.settled,\n\t\t\t...(span.endSequence === undefined ? {} : { endSequence: span.endSequence }),\n\t\t}));\n\t}\n}\n"]}
|
|
@@ -0,0 +1,78 @@
|
|
|
1
|
+
import type { ExactTelemetryAttributes, InferRequiredAndOptionalAttributes, SpanAttributes, TelemetryContext, TelemetrySchemaDefinition, TelemetryStartAttributeDefinition } from "./index.ts";
|
|
2
|
+
export interface InstrumentOptions {
|
|
3
|
+
description?: string;
|
|
4
|
+
unit?: string;
|
|
5
|
+
}
|
|
6
|
+
export interface HistogramOptions extends InstrumentOptions {
|
|
7
|
+
/** Bucket hints; callers supply finite, strictly increasing values. */
|
|
8
|
+
boundaries?: readonly number[];
|
|
9
|
+
}
|
|
10
|
+
export interface TelemetryCounter {
|
|
11
|
+
add(value: number, attributes?: SpanAttributes): void;
|
|
12
|
+
}
|
|
13
|
+
export interface TelemetryUpDownCounter {
|
|
14
|
+
add(value: number, attributes?: SpanAttributes): void;
|
|
15
|
+
}
|
|
16
|
+
export interface TelemetryHistogram {
|
|
17
|
+
record(value: number, attributes?: SpanAttributes, context?: TelemetryContext): void;
|
|
18
|
+
}
|
|
19
|
+
/**
|
|
20
|
+
* Optional adapter capability with synchronous factories and recording methods.
|
|
21
|
+
* Typed inputs are trusted; callers supply finite measurements and nonnegative counter increments.
|
|
22
|
+
* Malformed input behavior is unspecified.
|
|
23
|
+
*/
|
|
24
|
+
export interface TelemetryMetrics {
|
|
25
|
+
counter(name: string, options?: InstrumentOptions): TelemetryCounter;
|
|
26
|
+
upDownCounter(name: string, options?: InstrumentOptions): TelemetryUpDownCounter;
|
|
27
|
+
histogram(name: string, options?: HistogramOptions): TelemetryHistogram;
|
|
28
|
+
}
|
|
29
|
+
export type TelemetryMetricAttributeDefinition = TelemetryStartAttributeDefinition & {
|
|
30
|
+
cardinality?: "low";
|
|
31
|
+
};
|
|
32
|
+
export type TelemetryMetricDefinition = {
|
|
33
|
+
description: string;
|
|
34
|
+
unit?: string;
|
|
35
|
+
attributes: Record<string, TelemetryMetricAttributeDefinition>;
|
|
36
|
+
} & ({
|
|
37
|
+
kind: "counter" | "upDownCounter";
|
|
38
|
+
boundaries?: never;
|
|
39
|
+
} | {
|
|
40
|
+
kind: "histogram";
|
|
41
|
+
boundaries?: readonly number[];
|
|
42
|
+
});
|
|
43
|
+
type MetricKind = TelemetryMetricDefinition["kind"];
|
|
44
|
+
type MetricSchemas = readonly [TelemetrySchemaDefinition, ...TelemetrySchemaDefinition[]];
|
|
45
|
+
type MetricsOf<Schema extends TelemetrySchemaDefinition> = Schema extends {
|
|
46
|
+
metrics: infer Metrics extends Record<string, TelemetryMetricDefinition>;
|
|
47
|
+
} ? Metrics : Record<never, never>;
|
|
48
|
+
type MetricNames<Schema extends TelemetrySchemaDefinition, Kind extends MetricKind> = Schema extends TelemetrySchemaDefinition ? {
|
|
49
|
+
[Name in keyof MetricsOf<Schema>]: MetricsOf<Schema>[Name] extends {
|
|
50
|
+
kind: Kind;
|
|
51
|
+
} ? Name : never;
|
|
52
|
+
}[keyof MetricsOf<Schema>] & string : never;
|
|
53
|
+
type MetricByName<Schema extends TelemetrySchemaDefinition, Name extends string> = Schema extends TelemetrySchemaDefinition ? Name extends keyof MetricsOf<Schema> ? MetricsOf<Schema>[Name] : never : never;
|
|
54
|
+
type DuplicateMetricNames<Schemas extends readonly TelemetrySchemaDefinition[], Seen extends string = never> = Schemas extends readonly [
|
|
55
|
+
infer Schema extends TelemetrySchemaDefinition,
|
|
56
|
+
...infer Rest extends readonly TelemetrySchemaDefinition[]
|
|
57
|
+
] ? Extract<keyof MetricsOf<Schema>, Seen> | DuplicateMetricNames<Rest, Seen | (keyof MetricsOf<Schema> & string)> : never;
|
|
58
|
+
type MetricAttributes<Definition extends TelemetryMetricDefinition> = InferRequiredAndOptionalAttributes<Definition["attributes"]>;
|
|
59
|
+
type MeasurementArguments<Definition extends TelemetryMetricDefinition, Attributes extends MetricAttributes<Definition>> = {
|
|
60
|
+
[Name in keyof Definition["attributes"]]: Definition["attributes"][Name]["required"] extends true ? Name : never;
|
|
61
|
+
}[keyof Definition["attributes"]] extends never ? [attributes?: ExactTelemetryAttributes<MetricAttributes<Definition>, Attributes>] : [attributes: ExactTelemetryAttributes<MetricAttributes<Definition>, Attributes>];
|
|
62
|
+
export type SchemaTelemetryCounter<Definition extends TelemetryMetricDefinition> = {
|
|
63
|
+
add<const Attributes extends MetricAttributes<Definition> = MetricAttributes<Definition>>(value: number, ...args: MeasurementArguments<Definition, Attributes>): void;
|
|
64
|
+
};
|
|
65
|
+
export type SchemaTelemetryHistogram<Definition extends TelemetryMetricDefinition> = {
|
|
66
|
+
record<const Attributes extends MetricAttributes<Definition> = MetricAttributes<Definition>>(value: number, ...args: [...MeasurementArguments<Definition, Attributes>, context?: TelemetryContext]): void;
|
|
67
|
+
};
|
|
68
|
+
export interface TypedTelemetryMetrics<Schemas extends MetricSchemas> {
|
|
69
|
+
counter<Name extends MetricNames<Schemas[number], "counter">>(name: Name): SchemaTelemetryCounter<MetricByName<Schemas[number], Name>>;
|
|
70
|
+
upDownCounter<Name extends MetricNames<Schemas[number], "upDownCounter">>(name: Name): SchemaTelemetryCounter<MetricByName<Schemas[number], Name>>;
|
|
71
|
+
histogram<Name extends MetricNames<Schemas[number], "histogram">>(name: Name): SchemaTelemetryHistogram<MetricByName<Schemas[number], Name>>;
|
|
72
|
+
}
|
|
73
|
+
/** Bind instrument names, kinds, metadata, and exact measurement attributes to one or more schemas. */
|
|
74
|
+
export declare function createTypedMetrics<const Schemas extends MetricSchemas>(metrics: TelemetryMetrics, schemas: Schemas & ([DuplicateMetricNames<Schemas>] extends [never] ? unknown : {
|
|
75
|
+
readonly "duplicate telemetry metric names": DuplicateMetricNames<Schemas>;
|
|
76
|
+
})): TypedTelemetryMetrics<Schemas>;
|
|
77
|
+
export {};
|
|
78
|
+
//# sourceMappingURL=metrics.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../src/metrics.ts"],"names":[],"mappings":"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"}
|
package/dist/metrics.js
ADDED
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
/** Bind instrument names, kinds, metadata, and exact measurement attributes to one or more schemas. */
|
|
2
|
+
export function createTypedMetrics(metrics, schemas) {
|
|
3
|
+
const definitions = new Map();
|
|
4
|
+
for (const schema of schemas) {
|
|
5
|
+
for (const [name, definition] of Object.entries(schema.metrics ?? {}))
|
|
6
|
+
definitions.set(name, definition);
|
|
7
|
+
}
|
|
8
|
+
return {
|
|
9
|
+
counter: (name) => metrics.counter(name, definitions.get(name)),
|
|
10
|
+
upDownCounter: (name) => metrics.upDownCounter(name, definitions.get(name)),
|
|
11
|
+
histogram: (name) => metrics.histogram(name, definitions.get(name)),
|
|
12
|
+
};
|
|
13
|
+
}
|
|
14
|
+
//# sourceMappingURL=metrics.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"metrics.js","sourceRoot":"","sources":["../src/metrics.ts"],"names":[],"mappings":"AA+HA,uGAAuG;AACvG,MAAM,UAAU,kBAAkB,CACjC,OAAyB,EACzB,OAGmF;IAEnF,MAAM,WAAW,GAAG,IAAI,GAAG,EAAqC,CAAC;IACjE,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC9B,KAAK,MAAM,CAAC,IAAI,EAAE,UAAU,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC;YAAE,WAAW,CAAC,GAAG,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAC1G,CAAC;IACD,OAAO;QACN,OAAO,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACvE,aAAa,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,OAAO,CAAC,aAAa,CAAC,IAAI,EAAE,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACnF,SAAS,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,EAAE,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;KAC9B,CAAC;AAChD,CAAC","sourcesContent":["import type {\n\tExactTelemetryAttributes,\n\tInferRequiredAndOptionalAttributes,\n\tSpanAttributes,\n\tTelemetryContext,\n\tTelemetrySchemaDefinition,\n\tTelemetryStartAttributeDefinition,\n} from \"./index.ts\";\n\nexport interface InstrumentOptions {\n\tdescription?: string;\n\tunit?: string;\n}\n\nexport interface HistogramOptions extends InstrumentOptions {\n\t/** Bucket hints; callers supply finite, strictly increasing values. */\n\tboundaries?: readonly number[];\n}\n\nexport interface TelemetryCounter {\n\tadd(value: number, attributes?: SpanAttributes): void;\n}\n\nexport interface TelemetryUpDownCounter {\n\tadd(value: number, attributes?: SpanAttributes): void;\n}\n\nexport interface TelemetryHistogram {\n\trecord(value: number, attributes?: SpanAttributes, context?: TelemetryContext): void;\n}\n\n/**\n * Optional adapter capability with synchronous factories and recording methods.\n * Typed inputs are trusted; callers supply finite measurements and nonnegative counter increments.\n * Malformed input behavior is unspecified.\n */\nexport interface TelemetryMetrics {\n\tcounter(name: string, options?: InstrumentOptions): TelemetryCounter;\n\tupDownCounter(name: string, options?: InstrumentOptions): TelemetryUpDownCounter;\n\thistogram(name: string, options?: HistogramOptions): TelemetryHistogram;\n}\n\nexport type TelemetryMetricAttributeDefinition = TelemetryStartAttributeDefinition & { cardinality?: \"low\" };\n\nexport type TelemetryMetricDefinition = {\n\tdescription: string;\n\tunit?: string;\n\tattributes: Record<string, TelemetryMetricAttributeDefinition>;\n} & ({ kind: \"counter\" | \"upDownCounter\"; boundaries?: never } | { kind: \"histogram\"; boundaries?: readonly number[] });\n\ntype MetricKind = TelemetryMetricDefinition[\"kind\"];\ntype MetricSchemas = readonly [TelemetrySchemaDefinition, ...TelemetrySchemaDefinition[]];\n\ntype MetricsOf<Schema extends TelemetrySchemaDefinition> = Schema extends {\n\tmetrics: infer Metrics extends Record<string, TelemetryMetricDefinition>;\n}\n\t? Metrics\n\t: Record<never, never>;\n\ntype MetricNames<\n\tSchema extends TelemetrySchemaDefinition,\n\tKind extends MetricKind,\n> = Schema extends TelemetrySchemaDefinition\n\t? {\n\t\t\t[Name in keyof MetricsOf<Schema>]: MetricsOf<Schema>[Name] extends { kind: Kind } ? Name : never;\n\t\t}[keyof MetricsOf<Schema>] &\n\t\t\tstring\n\t: never;\n\ntype MetricByName<\n\tSchema extends TelemetrySchemaDefinition,\n\tName extends string,\n> = Schema extends TelemetrySchemaDefinition\n\t? Name extends keyof MetricsOf<Schema>\n\t\t? MetricsOf<Schema>[Name]\n\t\t: never\n\t: never;\n\ntype DuplicateMetricNames<\n\tSchemas extends readonly TelemetrySchemaDefinition[],\n\tSeen extends string = never,\n> = Schemas extends readonly [\n\tinfer Schema extends TelemetrySchemaDefinition,\n\t...infer Rest extends readonly TelemetrySchemaDefinition[],\n]\n\t? Extract<keyof MetricsOf<Schema>, Seen> | DuplicateMetricNames<Rest, Seen | (keyof MetricsOf<Schema> & string)>\n\t: never;\n\ntype MetricAttributes<Definition extends TelemetryMetricDefinition> = InferRequiredAndOptionalAttributes<\n\tDefinition[\"attributes\"]\n>;\n\ntype MeasurementArguments<\n\tDefinition extends TelemetryMetricDefinition,\n\tAttributes extends MetricAttributes<Definition>,\n> = {\n\t[Name in keyof Definition[\"attributes\"]]: Definition[\"attributes\"][Name][\"required\"] extends true ? Name : never;\n}[keyof Definition[\"attributes\"]] extends never\n\t? [attributes?: ExactTelemetryAttributes<MetricAttributes<Definition>, Attributes>]\n\t: [attributes: ExactTelemetryAttributes<MetricAttributes<Definition>, Attributes>];\n\nexport type SchemaTelemetryCounter<Definition extends TelemetryMetricDefinition> = {\n\tadd<const Attributes extends MetricAttributes<Definition> = MetricAttributes<Definition>>(\n\t\tvalue: number,\n\t\t...args: MeasurementArguments<Definition, Attributes>\n\t): void;\n};\n\nexport type SchemaTelemetryHistogram<Definition extends TelemetryMetricDefinition> = {\n\trecord<const Attributes extends MetricAttributes<Definition> = MetricAttributes<Definition>>(\n\t\tvalue: number,\n\t\t...args: [...MeasurementArguments<Definition, Attributes>, context?: TelemetryContext]\n\t): void;\n};\n\nexport interface TypedTelemetryMetrics<Schemas extends MetricSchemas> {\n\tcounter<Name extends MetricNames<Schemas[number], \"counter\">>(\n\t\tname: Name,\n\t): SchemaTelemetryCounter<MetricByName<Schemas[number], Name>>;\n\tupDownCounter<Name extends MetricNames<Schemas[number], \"upDownCounter\">>(\n\t\tname: Name,\n\t): SchemaTelemetryCounter<MetricByName<Schemas[number], Name>>;\n\thistogram<Name extends MetricNames<Schemas[number], \"histogram\">>(\n\t\tname: Name,\n\t): SchemaTelemetryHistogram<MetricByName<Schemas[number], Name>>;\n}\n\n/** Bind instrument names, kinds, metadata, and exact measurement attributes to one or more schemas. */\nexport function createTypedMetrics<const Schemas extends MetricSchemas>(\n\tmetrics: TelemetryMetrics,\n\tschemas: Schemas &\n\t\t([DuplicateMetricNames<Schemas>] extends [never]\n\t\t\t? unknown\n\t\t\t: { readonly \"duplicate telemetry metric names\": DuplicateMetricNames<Schemas> }),\n): TypedTelemetryMetrics<Schemas> {\n\tconst definitions = new Map<string, TelemetryMetricDefinition>();\n\tfor (const schema of schemas) {\n\t\tfor (const [name, definition] of Object.entries(schema.metrics ?? {})) definitions.set(name, definition);\n\t}\n\treturn {\n\t\tcounter: (name: string) => metrics.counter(name, definitions.get(name)),\n\t\tupDownCounter: (name: string) => metrics.upDownCounter(name, definitions.get(name)),\n\t\thistogram: (name: string) => metrics.histogram(name, definitions.get(name)),\n\t} as unknown as TypedTelemetryMetrics<Schemas>;\n}\n"]}
|
package/dist/noop.d.ts
ADDED
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
import type { TelemetryPropagation, TelemetrySpan } from "./index.ts";
|
|
2
|
+
import type { TelemetryMetrics } from "./metrics.ts";
|
|
3
|
+
/** Shared instruments that never inspect or retain metadata, measurements, or contexts. */
|
|
4
|
+
export declare const NOOP_TELEMETRY_METRICS: TelemetryMetrics;
|
|
5
|
+
/** Shared propagation capability that neither inspects nor retains its inputs. */
|
|
6
|
+
export declare const NOOP_TELEMETRY_PROPAGATION: TelemetryPropagation;
|
|
7
|
+
/** Shared telemetry context used when an application does not provide one. */
|
|
8
|
+
export declare const NOOP_TELEMETRY_CONTEXT: TelemetrySpan;
|
|
9
|
+
//# sourceMappingURL=noop.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"noop.d.ts","sourceRoot":"","sources":["../src/noop.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAe,oBAAoB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACnF,OAAO,KAAK,EAAwC,gBAAgB,EAA0B,MAAM,cAAc,CAAC;AAUnH,2FAA2F;AAC3F,eAAO,MAAM,sBAAsB,EAAE,gBAInC,CAAC;AAEH,kFAAkF;AAClF,eAAO,MAAM,0BAA0B,EAAE,oBAGvC,CAAC;AAaH,8EAA8E;AAC9E,eAAO,MAAM,sBAAsB,EAAE,aAAiC,CAAC"}
|
package/dist/noop.js
ADDED
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
async function startNoopSpan(_options, callback) {
|
|
2
|
+
return callback(noopTelemetrySpan);
|
|
3
|
+
}
|
|
4
|
+
const noopCounter = Object.freeze({ add: () => { } });
|
|
5
|
+
const noopUpDownCounter = Object.freeze({ add: () => { } });
|
|
6
|
+
const noopHistogram = Object.freeze({ record: () => { } });
|
|
7
|
+
/** Shared instruments that never inspect or retain metadata, measurements, or contexts. */
|
|
8
|
+
export const NOOP_TELEMETRY_METRICS = Object.freeze({
|
|
9
|
+
counter: () => noopCounter,
|
|
10
|
+
upDownCounter: () => noopUpDownCounter,
|
|
11
|
+
histogram: () => noopHistogram,
|
|
12
|
+
});
|
|
13
|
+
/** Shared propagation capability that neither inspects nor retains its inputs. */
|
|
14
|
+
export const NOOP_TELEMETRY_PROPAGATION = Object.freeze({
|
|
15
|
+
inject: () => undefined,
|
|
16
|
+
extract: () => NOOP_TELEMETRY_CONTEXT,
|
|
17
|
+
});
|
|
18
|
+
const noopTelemetrySpan = {
|
|
19
|
+
metrics: NOOP_TELEMETRY_METRICS,
|
|
20
|
+
propagation: NOOP_TELEMETRY_PROPAGATION,
|
|
21
|
+
startSpan: startNoopSpan,
|
|
22
|
+
addLink: () => { },
|
|
23
|
+
addEvent: () => { },
|
|
24
|
+
setAttributes: () => { },
|
|
25
|
+
setStatus: () => { },
|
|
26
|
+
};
|
|
27
|
+
Object.freeze(noopTelemetrySpan);
|
|
28
|
+
/** Shared telemetry context used when an application does not provide one. */
|
|
29
|
+
export const NOOP_TELEMETRY_CONTEXT = noopTelemetrySpan;
|
|
30
|
+
//# sourceMappingURL=noop.js.map
|
package/dist/noop.js.map
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"noop.js","sourceRoot":"","sources":["../src/noop.ts"],"names":[],"mappings":"AAGA,KAAK,UAAU,aAAa,CAAI,QAAqB,EAAE,QAAiD;IACvG,OAAO,QAAQ,CAAC,iBAAiB,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,WAAW,GAAqB,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,GAAE,CAAC,EAAE,CAAC,CAAC;AACvE,MAAM,iBAAiB,GAA2B,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,GAAE,CAAC,EAAE,CAAC,CAAC;AACnF,MAAM,aAAa,GAAuB,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,GAAE,CAAC,EAAE,CAAC,CAAC;AAE9E,2FAA2F;AAC3F,MAAM,CAAC,MAAM,sBAAsB,GAAqB,MAAM,CAAC,MAAM,CAAC;IACrE,OAAO,EAAE,GAAG,EAAE,CAAC,WAAW;IAC1B,aAAa,EAAE,GAAG,EAAE,CAAC,iBAAiB;IACtC,SAAS,EAAE,GAAG,EAAE,CAAC,aAAa;CAC9B,CAAC,CAAC;AAEH,kFAAkF;AAClF,MAAM,CAAC,MAAM,0BAA0B,GAAyB,MAAM,CAAC,MAAM,CAAC;IAC7E,MAAM,EAAE,GAAG,EAAE,CAAC,SAAS;IACvB,OAAO,EAAE,GAAG,EAAE,CAAC,sBAAsB;CACrC,CAAC,CAAC;AAEH,MAAM,iBAAiB,GAAkB;IACxC,OAAO,EAAE,sBAAsB;IAC/B,WAAW,EAAE,0BAA0B;IACvC,SAAS,EAAE,aAAa;IACxB,OAAO,EAAE,GAAG,EAAE,GAAE,CAAC;IACjB,QAAQ,EAAE,GAAG,EAAE,GAAE,CAAC;IAClB,aAAa,EAAE,GAAG,EAAE,GAAE,CAAC;IACvB,SAAS,EAAE,GAAG,EAAE,GAAE,CAAC;CACnB,CAAC;AACF,MAAM,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC;AAEjC,8EAA8E;AAC9E,MAAM,CAAC,MAAM,sBAAsB,GAAkB,iBAAiB,CAAC","sourcesContent":["import type { SpanOptions, TelemetryPropagation, TelemetrySpan } from \"./index.ts\";\nimport type { TelemetryCounter, TelemetryHistogram, TelemetryMetrics, TelemetryUpDownCounter } from \"./metrics.ts\";\n\nasync function startNoopSpan<T>(_options: SpanOptions, callback: (span: TelemetrySpan) => T | Promise<T>): Promise<T> {\n\treturn callback(noopTelemetrySpan);\n}\n\nconst noopCounter: TelemetryCounter = Object.freeze({ add: () => {} });\nconst noopUpDownCounter: TelemetryUpDownCounter = Object.freeze({ add: () => {} });\nconst noopHistogram: TelemetryHistogram = Object.freeze({ record: () => {} });\n\n/** Shared instruments that never inspect or retain metadata, measurements, or contexts. */\nexport const NOOP_TELEMETRY_METRICS: TelemetryMetrics = Object.freeze({\n\tcounter: () => noopCounter,\n\tupDownCounter: () => noopUpDownCounter,\n\thistogram: () => noopHistogram,\n});\n\n/** Shared propagation capability that neither inspects nor retains its inputs. */\nexport const NOOP_TELEMETRY_PROPAGATION: TelemetryPropagation = Object.freeze({\n\tinject: () => undefined,\n\textract: () => NOOP_TELEMETRY_CONTEXT,\n});\n\nconst noopTelemetrySpan: TelemetrySpan = {\n\tmetrics: NOOP_TELEMETRY_METRICS,\n\tpropagation: NOOP_TELEMETRY_PROPAGATION,\n\tstartSpan: startNoopSpan,\n\taddLink: () => {},\n\taddEvent: () => {},\n\tsetAttributes: () => {},\n\tsetStatus: () => {},\n};\nObject.freeze(noopTelemetrySpan);\n\n/** Shared telemetry context used when an application does not provide one. */\nexport const NOOP_TELEMETRY_CONTEXT: TelemetrySpan = noopTelemetrySpan;\n"]}
|
package/dist/render.d.ts
ADDED
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
import type { StoredSpan } from "./index.ts";
|
|
2
|
+
/**
|
|
3
|
+
* Render stored spans as a chronological forest, treating absent parents as roots. Lengths of time are milliseconds to
|
|
4
|
+
* the microsecond. Control characters in ids, names, attribute keys and error messages are escaped (attribute values
|
|
5
|
+
* are JSON).
|
|
6
|
+
*/
|
|
7
|
+
export declare function renderTrace(spans: readonly StoredSpan[]): string;
|
|
8
|
+
//# sourceMappingURL=render.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../src/render.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAkB,UAAU,EAAE,MAAM,YAAY,CAAC;AAsB7D;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,UAAU,EAAE,GAAG,MAAM,CA4ChE"}
|