observability-toolkit 2.0.0 → 2.1.0

package/dist/tools/ingest-traces.js

@@ -0,0 +1,164 @@
+/**
+ * obs_ingest_traces — Push complete OTel traces to the cloud backend.
+ *
+ * Accepts resourceSpans with service metadata and grouped spans,
+ * encodes as OTLP protobuf, and POSTs to the ingest worker.
+ * Mirrors obs_ingest_spans but operates at the trace (resourceSpans) level.
+ */
+import { z } from 'zod';
+import { MAX_SPAN_NAME_LENGTH, spanKindNumericSchema, TraceIdSchema, SpanIdSchema } from '../lib/core/shared-schemas.js';
+import { SPAN_KIND } from '../lib/core/constants-otel.js';
+import { encodeTracesProtobuf } from '../lib/exports/otlp-proto-encode.js';
+import { ISO_DATE_LENGTH, MAX_NAME_LENGTH, getApiKey, OBTOOL_INGEST_URL, HOOKS_TELEMETRY_DIR } from '../lib/core/constants.js';
+import { BYTES } from '../lib/core/units.js';
+import { mkdir, appendFile } from 'fs/promises';
+import { join } from 'path';
+import { INGEST_TIMEOUT_MS } from './ingest-constants.js';
+const MAX_SPANS_PER_SCOPE = 100;
+const MAX_SCOPE_SPANS = 10;
+const MAX_RESOURCE_SPANS = 10;
+const MAX_VERSION_LENGTH = 50;
+/** OTLP status code enum */
+const STATUS_CODE = {
+    UNSET: 0,
+    OK: 1,
+    ERROR: 2,
+};
+const attributeValueSchema = z.union([z.string().max(BYTES.KB), z.number(), z.boolean()]);
+const spanSchema = z.object({
+    traceId: TraceIdSchema,
+    spanId: SpanIdSchema,
+    parentSpanId: SpanIdSchema.optional(),
+    name: z.string().min(1).max(MAX_SPAN_NAME_LENGTH),
+    kind: spanKindNumericSchema.default(SPAN_KIND.INTERNAL),
+    startTimeNs: z.string().regex(/^\d+$/, 'Must be numeric nanosecond timestamp'),
+    endTimeNs: z.string().regex(/^\d+$/, 'Must be numeric nanosecond timestamp'),
+    statusCode: z.int().min(0).max(STATUS_CODE.ERROR).default(STATUS_CODE.OK),
+    statusMessage: z.string().max(MAX_NAME_LENGTH).optional(),
+    attributes: z.record(z.string(), attributeValueSchema).default({}),
+});
+const scopeSpansSchema = z.object({
+    scope: z.object({
+        name: z.string().min(1).max(MAX_SPAN_NAME_LENGTH),
+        version: z.string().max(MAX_VERSION_LENGTH).optional(),
+    }).optional(),
+    spans: z.array(spanSchema).min(1).max(MAX_SPANS_PER_SCOPE),
+});
+const resourceSpansSchema = z.object({
+    resource: z.object({
+        attributes: z.record(z.string(), attributeValueSchema).default({}),
+    }).default({ attributes: {} }),
+    serviceName: z.string().min(1).max(MAX_SPAN_NAME_LENGTH).default('observability-toolkit'),
+    scopeSpans: z.array(scopeSpansSchema).min(1).max(MAX_SCOPE_SPANS),
+});
+export const ingestTracesSchema = z.object({
+    resourceSpans: z.array(resourceSpansSchema).min(1).max(MAX_RESOURCE_SPANS),
+    backend: z.enum(['cloud', 'local']).default('cloud'),
+});
+function toOTLPKeyValues(attrs) {
+    return Object.entries(attrs).map(([key, val]) => ({
+        key,
+        value: typeof val === 'string' ? { stringValue: val }
+            : typeof val === 'number' ? (Number.isInteger(val) ? { intValue: String(val) } : { doubleValue: val })
+                : { boolValue: val },
+    }));
+}
+function buildOTLPExport(input) {
+    return {
+        resourceSpans: input.resourceSpans.map(rs => ({
+            resource: {
+                attributes: [
+                    { key: 'service.name', value: { stringValue: rs.serviceName } },
+                    ...toOTLPKeyValues(rs.resource.attributes),
+                ],
+            },
+            scopeSpans: rs.scopeSpans.map(ss => ({
+                scope: ss.scope ? { name: ss.scope.name, version: ss.scope.version } : undefined,
+                spans: ss.spans.map(s => ({
+                    traceId: s.traceId,
+                    spanId: s.spanId,
+                    ...(s.parentSpanId ? { parentSpanId: s.parentSpanId } : {}),
+                    name: s.name,
+                    kind: s.kind,
+                    startTimeUnixNano: s.startTimeNs,
+                    endTimeUnixNano: s.endTimeNs,
+                    status: {
+                        code: s.statusCode,
+                        ...(s.statusMessage ? { message: s.statusMessage } : {}),
+                    },
+                    attributes: toOTLPKeyValues(s.attributes),
+                })),
+            })),
+        })),
+    };
+}
+function countSpans(input) {
+    return input.resourceSpans.reduce((sum, rs) => sum + rs.scopeSpans.reduce((s2, ss) => s2 + ss.spans.length, 0), 0);
+}
+async function postToIngest(binary) {
+    if (!OBTOOL_INGEST_URL) {
+        return { ok: false, status: 0, message: 'OBTOOL_INGEST_URL not configured' };
+    }
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), INGEST_TIMEOUT_MS);
+    try {
+        const res = await fetch(`${OBTOOL_INGEST_URL}/v1/traces`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/x-protobuf',
+                ...(getApiKey() ? { Authorization: `Bearer ${getApiKey()}` } : {}),
+            },
+            body: binary,
+            signal: controller.signal,
+        });
+        return { ok: res.ok, status: res.status, message: res.ok ? 'accepted' : await res.text() };
+    }
+    catch (err) {
+        return { ok: false, status: 0, message: err instanceof Error ? err.message : 'unknown error' };
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+async function writeToLocal(input) {
+    try {
+        const dir = HOOKS_TELEMETRY_DIR;
+        await mkdir(dir, { recursive: true });
+        const date = new Date().toISOString().slice(0, ISO_DATE_LENGTH);
+        const filePath = join(dir, `traces-${date}.jsonl`);
+        const lines = input.resourceSpans.flatMap(rs => rs.scopeSpans.flatMap(ss => ss.spans.map(s => JSON.stringify({
+            ...s,
+            serviceName: rs.serviceName,
+            scopeName: ss.scope?.name,
+        })))).join('\n') + '\n';
+        await appendFile(filePath, lines);
+        return { ok: true, path: filePath };
+    }
+    catch (err) {
+        return { ok: false, path: '', error: err instanceof Error ? err.message : String(err) };
+    }
+}
+export async function ingestTraces(input) {
+    const otlpExport = buildOTLPExport(input);
+    const binary = encodeTracesProtobuf(otlpExport);
+    const spanCount = countSpans(input);
+    if (input.backend === 'cloud') {
+        const result = await postToIngest(binary);
+        if (result.ok) {
+            return { backend: 'cloud', spans: spanCount, resources: input.resourceSpans.length, status: result.status };
+        }
+        return { backend: 'cloud', error: result.message, status: result.status };
+    }
+    const local = await writeToLocal(input);
+    if (!local.ok) {
+        return { backend: 'local', error: local.error };
+    }
+    return { backend: 'local', spans: spanCount, path: local.path };
+}
+export const ingestTracesTool = {
+    name: 'obs_ingest_traces',
+    description: 'Push complete OTel traces (resourceSpans) to the cloud backend via OTLP protobuf or local JSONL. Accepts full trace structure with resource attributes, service name, instrumentation scopes, and span hierarchies.',
+    inputSchema: ingestTracesSchema,
+    handler: ingestTraces,
+};
+//# sourceMappingURL=ingest-traces.js.map

package/dist/tools/ingest-traces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ingest-traces.js","sourceRoot":"","sources":["../../src/tools/ingest-traces.ts"],"names":[],"mappings":"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"}

package/dist/tools/ingest-traces.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Unit tests for ingest-traces tool
+ */
+export {};
+//# sourceMappingURL=ingest-traces.test.d.ts.map

package/dist/tools/ingest-traces.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ingest-traces.test.d.ts","sourceRoot":"","sources":["../../src/tools/ingest-traces.test.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/tools/ingest-traces.test.js

@@ -0,0 +1,483 @@
+/**
+ * Unit tests for ingest-traces tool
+ */
+import { describe, it, beforeEach, afterEach, vi } from 'vitest';
+import assert from 'node:assert';
+import { ingestTraces, ingestTracesSchema } from './ingest-traces.js';
+import { generateHexId } from '../lib/exports/export-utils.js';
+import { OTLP_SPAN_ID_LENGTH, OTLP_TRACE_ID_LENGTH } from '../lib/core/constants.js';
+import { NANOSECONDS_PER_MILLISECOND_BIGINT, COST_DECIMAL_PLACES } from '../lib/core/units.js';
+const VALID_TRACE_ID = generateHexId(OTLP_TRACE_ID_LENGTH);
+const VALID_SPAN_ID = generateHexId(OTLP_SPAN_ID_LENGTH);
+const NOW_NS = String(BigInt(Date.now()) * NANOSECONDS_PER_MILLISECOND_BIGINT);
+const END_NS = String(BigInt(NOW_NS) + NANOSECONDS_PER_MILLISECOND_BIGINT * BigInt(COST_DECIMAL_PLACES));
+describe('ingestTraces', () => {
+    let prevIngestUrl;
+    let prevApiKey;
+    beforeEach(() => {
+        prevIngestUrl = process.env.OBTOOL_INGEST_URL;
+        prevApiKey = process.env.OBTOOL_API_KEY;
+        delete process.env.OBTOOL_INGEST_URL;
+        delete process.env.OBTOOL_API_KEY;
+    });
+    afterEach(() => {
+        if (prevIngestUrl === undefined)
+            delete process.env.OBTOOL_INGEST_URL;
+        else
+            process.env.OBTOOL_INGEST_URL = prevIngestUrl;
+        if (prevApiKey === undefined)
+            delete process.env.OBTOOL_API_KEY;
+        else
+            process.env.OBTOOL_API_KEY = prevApiKey;
+        vi.restoreAllMocks();
+    });
+    describe('schema validation', () => {
+        it('accepts valid trace with single span', () => {
+            const result = ingestTracesSchema.safeParse({
+                resourceSpans: [{
+                        serviceName: 'test-service',
+                        resource: { attributes: {} },
+                        scopeSpans: [{
+                                scope: { name: 'test-scope', version: '1.0.0' },
+                                spans: [{
+                                        traceId: VALID_TRACE_ID,
+                                        spanId: VALID_SPAN_ID,
+                                        name: 'test.operation',
+                                        startTimeNs: NOW_NS,
+                                        endTimeNs: END_NS,
+                                        attributes: {},
+                                    }],
+                            }],
+                    }],
+            });
+            assert.ok(result.success);
+        });
+        it('accepts trace with multiple spans and resources', () => {
+            const childSpanId = generateHexId(OTLP_SPAN_ID_LENGTH);
+            const result = ingestTracesSchema.safeParse({
+                resourceSpans: [{
+                        serviceName: 'test-service',
+                        resource: { attributes: { 'deployment.environment': 'test' } },
+                        scopeSpans: [{
+                                scope: { name: 'test-scope', version: '1.0.0' },
+                                spans: [
+                                    {
+                                        traceId: VALID_TRACE_ID,
+                                        spanId: VALID_SPAN_ID,
+                                        name: 'root.operation',
+                                        kind: 1,
+                                        statusCode: 1,
+                                        startTimeNs: NOW_NS,
+                                        endTimeNs: END_NS,
+                                        attributes: { 'test.type': 'root' },
+                                    },
+                                    {
+                                        traceId: VALID_TRACE_ID,
+                                        spanId: childSpanId,
+                                        parentSpanId: VALID_SPAN_ID,
+                                        name: 'child.operation',
+                                        kind: 1,
+                                        statusCode: 1,
+                                        startTimeNs: NOW_NS,
+                                        endTimeNs: END_NS,
+                                        attributes: { 'test.type': 'child' },
+                                    },
+                                ],
+                            }],
+                    }],
+            });
+            assert.ok(result.success);
+        });
+        it('rejects empty resourceSpans array', () => {
+            const result = ingestTracesSchema.safeParse({ resourceSpans: [] });
+            assert.ok(!result.success);
+        });
+        it('rejects more than 10 resourceSpans', () => {
+            const spans = Array(11).fill({
+                serviceName: 'test-service',
+                resource: { attributes: {} },
+                scopeSpans: [{
+                        scope: { name: 'test-scope', version: '1.0.0' },
+                        spans: [{
+                                traceId: VALID_TRACE_ID,
+                                spanId: VALID_SPAN_ID,
+                                name: 'test.operation',
+                                kind: 1,
+                                statusCode: 1,
+                                startTimeNs: NOW_NS,
+                                endTimeNs: END_NS,
+                                attributes: {},
+                            }],
+                    }],
+            });
+            const result = ingestTracesSchema.safeParse({ resourceSpans: spans });
+            assert.ok(!result.success);
+        });
+        it('rejects invalid span kind', () => {
+            const result = ingestTracesSchema.safeParse({
+                resourceSpans: [{
+                        serviceName: 'test-service',
+                        resource: { attributes: {} },
+                        scopeSpans: [{
+                                scope: { name: 'test-scope', version: '1.0.0' },
+                                spans: [{
+                                        traceId: VALID_TRACE_ID,
+                                        spanId: VALID_SPAN_ID,
+                                        name: 'test.operation',
+                                        kind: 999, // Invalid kind
+                                        startTimeNs: NOW_NS,
+                                        endTimeNs: END_NS,
+                                        attributes: {},
+                                    }],
+                            }],
+                    }],
+            });
+            assert.ok(!result.success);
+        });
+        it('rejects invalid status code', () => {
+            const result = ingestTracesSchema.safeParse({
+                resourceSpans: [{
+                        serviceName: 'test-service',
+                        resource: { attributes: {} },
+                        scopeSpans: [{
+                                scope: { name: 'test-scope', version: '1.0.0' },
+                                spans: [{
+                                        traceId: VALID_TRACE_ID,
+                                        spanId: VALID_SPAN_ID,
+                                        name: 'test.operation',
+                                        statusCode: 999, // Invalid status code
+                                        startTimeNs: NOW_NS,
+                                        endTimeNs: END_NS,
+                                        attributes: {},
+                                    }],
+                            }],
+                    }],
+            });
+            assert.ok(!result.success);
+        });
+        it('defaults serviceName to observability-toolkit', () => {
+            const result = ingestTracesSchema.safeParse({
+                resourceSpans: [{
+                        resource: { attributes: {} },
+                        scopeSpans: [{
+                                scope: { name: 'test-scope', version: '1.0.0' },
+                                spans: [{
+                                        traceId: VALID_TRACE_ID,
+                                        spanId: VALID_SPAN_ID,
+                                        name: 'test.operation',
+                                        startTimeNs: NOW_NS,
+                                        endTimeNs: END_NS,
+                                        attributes: {},
+                                    }],
+                            }],
+                    }],
+            });
+            assert.ok(result.success);
+            assert.strictEqual(result.data.resourceSpans[0].serviceName, 'observability-toolkit');
+        });
+        it('defaults span kind to INTERNAL', () => {
+            const result = ingestTracesSchema.safeParse({
+                resourceSpans: [{
+                        serviceName: 'test-service',
+                        resource: { attributes: {} },
+                        scopeSpans: [{
+                                scope: { name: 'test-scope', version: '1.0.0' },
+                                spans: [{
+                                        traceId: VALID_TRACE_ID,
+                                        spanId: VALID_SPAN_ID,
+                                        name: 'test.operation',
+                                        startTimeNs: NOW_NS,
+                                        endTimeNs: END_NS,
+                                        attributes: {},
+                                    }],
+                            }],
+                    }],
+            });
+            assert.ok(result.success);
+            assert.strictEqual(result.data.resourceSpans[0].scopeSpans[0].spans[0].kind, 1);
+        });
+        it('defaults backend to cloud', () => {
+            const result = ingestTracesSchema.safeParse({
+                resourceSpans: [{
+                        serviceName: 'test-service',
+                        resource: { attributes: {} },
+                        scopeSpans: [{
+                                scope: { name: 'test-scope', version: '1.0.0' },
+                                spans: [{
+                                        traceId: VALID_TRACE_ID,
+                                        spanId: VALID_SPAN_ID,
+                                        name: 'test.operation',
+                                        startTimeNs: NOW_NS,
+                                        endTimeNs: END_NS,
+                                        attributes: {},
+                                    }],
+                            }],
+                    }],
+            });
+            assert.ok(result.success);
+            assert.strictEqual(result.data.backend, 'cloud');
+        });
+    });
+    describe('backend selection', () => {
+        it('uses local backend when backend=local', async () => {
+            const result = await ingestTraces({
+                backend: 'local',
+                resourceSpans: [{
+                        serviceName: 'test-service',
+                        resource: { attributes: {} },
+                        scopeSpans: [{
+                                scope: { name: 'test-scope', version: '1.0.0' },
+                                spans: [{
+                                        traceId: VALID_TRACE_ID,
+                                        spanId: VALID_SPAN_ID,
+                                        name: 'test.operation',
+                                        kind: 1,
+                                        statusCode: 1,
+                                        startTimeNs: NOW_NS,
+                                        endTimeNs: END_NS,
+                                        attributes: {},
+                                    }],
+                            }],
+                    }],
+            });
+            assert.ok(result && typeof result === 'object');
+            assert.strictEqual(result.backend, 'local');
+            assert.strictEqual(result.spans, 1);
+        });
+        it('cloud backend handles missing config gracefully', async () => {
+            const result = await ingestTraces({
+                backend: 'cloud',
+                resourceSpans: [{
+                        serviceName: 'test-service',
+                        resource: { attributes: {} },
+                        scopeSpans: [{
+                                scope: { name: 'test-scope', version: '1.0.0' },
+                                spans: [{
+                                        traceId: VALID_TRACE_ID,
+                                        spanId: VALID_SPAN_ID,
+                                        name: 'test.operation',
+                                        kind: 1,
+                                        statusCode: 1,
+                                        startTimeNs: NOW_NS,
+                                        endTimeNs: END_NS,
+                                        attributes: {},
+                                    }],
+                            }],
+                    }],
+            });
+            assert.ok(result && typeof result === 'object');
+            assert.strictEqual(result.backend, 'cloud');
+            assert.ok(result.error || result.status);
+        });
+    });
+    describe('span counting', () => {
+        it('counts single span correctly', async () => {
+            const result = await ingestTraces({
+                backend: 'local',
+                resourceSpans: [{
+                        serviceName: 'test-service',
+                        resource: { attributes: {} },
+                        scopeSpans: [{
+                                scope: { name: 'test-scope', version: '1.0.0' },
+                                spans: [{
+                                        traceId: VALID_TRACE_ID,
+                                        spanId: VALID_SPAN_ID,
+                                        name: 'test.operation',
+                                        kind: 1,
+                                        statusCode: 1,
+                                        startTimeNs: NOW_NS,
+                                        endTimeNs: END_NS,
+                                        attributes: {},
+                                    }],
+                            }],
+                    }],
+            });
+            assert.strictEqual(result.spans, 1);
+        });
+        it('counts multiple spans across scopes', async () => {
+            const spanId2 = generateHexId(OTLP_SPAN_ID_LENGTH);
+            const spanId3 = generateHexId(OTLP_SPAN_ID_LENGTH);
+            const result = await ingestTraces({
+                backend: 'local',
+                resourceSpans: [{
+                        serviceName: 'test-service',
+                        resource: { attributes: {} },
+                        scopeSpans: [
+                            {
+                                scope: { name: 'scope1', version: '1.0.0' },
+                                spans: [
+                                    {
+                                        traceId: VALID_TRACE_ID,
+                                        spanId: VALID_SPAN_ID,
+                                        name: 'op1',
+                                        kind: 1,
+                                        statusCode: 1,
+                                        startTimeNs: NOW_NS,
+                                        endTimeNs: END_NS,
+                                        attributes: {},
+                                    },
+                                    {
+                                        traceId: VALID_TRACE_ID,
+                                        spanId: spanId2,
+                                        name: 'op2',
+                                        kind: 1,
+                                        statusCode: 1,
+                                        startTimeNs: NOW_NS,
+                                        endTimeNs: END_NS,
+                                        attributes: {},
+                                    },
+                                ],
+                            },
+                            {
+                                scope: { name: 'scope2', version: '1.0.0' },
+                                spans: [{
+                                        traceId: VALID_TRACE_ID,
+                                        spanId: spanId3,
+                                        name: 'op3',
+                                        kind: 1,
+                                        statusCode: 1,
+                                        startTimeNs: NOW_NS,
+                                        endTimeNs: END_NS,
+                                        attributes: {},
+                                    }],
+                            },
+                        ],
+                    }],
+            });
+            assert.strictEqual(result.spans, 3);
+        });
+        it('counts spans across multiple resources', async () => {
+            const traceId2 = generateHexId(OTLP_TRACE_ID_LENGTH);
+            const spanId2 = generateHexId(OTLP_SPAN_ID_LENGTH);
+            const spanId3 = generateHexId(OTLP_SPAN_ID_LENGTH);
+            const result = await ingestTraces({
+                backend: 'local',
+                resourceSpans: [
+                    {
+                        serviceName: 'service1',
+                        resource: { attributes: {} },
+                        scopeSpans: [{
+                                scope: { name: 'scope1', version: '1.0.0' },
+                                spans: [{
+                                        traceId: VALID_TRACE_ID,
+                                        spanId: VALID_SPAN_ID,
+                                        name: 'op1',
+                                        kind: 1,
+                                        statusCode: 1,
+                                        startTimeNs: NOW_NS,
+                                        endTimeNs: END_NS,
+                                        attributes: {},
+                                    }],
+                            }],
+                    },
+                    {
+                        serviceName: 'service2',
+                        resource: { attributes: {} },
+                        scopeSpans: [{
+                                scope: { name: 'scope2', version: '1.0.0' },
+                                spans: [
+                                    {
+                                        traceId: traceId2,
+                                        spanId: spanId2,
+                                        name: 'op2',
+                                        kind: 1,
+                                        statusCode: 1,
+                                        startTimeNs: NOW_NS,
+                                        endTimeNs: END_NS,
+                                        attributes: {},
+                                    },
+                                    {
+                                        traceId: traceId2,
+                                        spanId: spanId3,
+                                        name: 'op3',
+                                        kind: 1,
+                                        statusCode: 1,
+                                        startTimeNs: NOW_NS,
+                                        endTimeNs: END_NS,
+                                        attributes: {},
+                                    },
+                                ],
+                            }],
+                    },
+                ],
+            });
+            assert.strictEqual(result.spans, 3);
+            assert.ok(result.path);
+        });
+    });
+    describe('import regression checks', () => {
+        it('has correct exports', () => {
+            assert.ok(typeof ingestTraces === 'function');
+            assert.ok(ingestTracesSchema);
+        });
+        it('can import COST_DECIMAL_PLACES from units module (regression check)', async () => {
+            // This ensures we import from the correct module, as fixed in test-ingest-traces.ts
+            const { COST_DECIMAL_PLACES: costDecimalPlaces } = await import('../lib/core/units.js');
+            assert.ok(typeof costDecimalPlaces === 'number');
+            assert.ok(costDecimalPlaces > 0);
+        });
+        it('can import all required constants', async () => {
+            const { OTLP_TRACE_ID_LENGTH: traceIdLen, OTLP_SPAN_ID_LENGTH: spanIdLen } = await import('../lib/core/constants.js');
+            const { NANOSECONDS_PER_MILLISECOND_BIGINT: nsPerMs } = await import('../lib/core/units.js');
+            assert.ok(typeof traceIdLen === 'number');
+            assert.ok(typeof spanIdLen === 'number');
+            assert.ok(typeof nsPerMs === 'bigint');
+        });
+    });
+    describe('resource and scope handling', () => {
+        it('accepts scope with version info', async () => {
+            const result = await ingestTraces({
+                backend: 'local',
+                resourceSpans: [{
+                        serviceName: 'test-service',
+                        resource: { attributes: {} },
+                        scopeSpans: [{
+                                scope: { name: 'test-scope', version: '1.0.0' },
+                                spans: [{
+                                        traceId: VALID_TRACE_ID,
+                                        spanId: VALID_SPAN_ID,
+                                        name: 'test.operation',
+                                        kind: 1,
+                                        statusCode: 1,
+                                        startTimeNs: NOW_NS,
+                                        endTimeNs: END_NS,
+                                        attributes: {},
+                                    }],
+                            }],
+                    }],
+            });
+            assert.ok(result && typeof result === 'object');
+            assert.strictEqual(result.backend, 'local');
+        });
+        it('accepts resource attributes', async () => {
+            const result = await ingestTraces({
+                backend: 'local',
+                resourceSpans: [{
+                        serviceName: 'test-service',
+                        resource: {
+                            attributes: {
+                                'deployment.environment': 'test',
+                                'service.instance.id': 'instance-1',
+                            },
+                        },
+                        scopeSpans: [{
+                                scope: { name: 'test-scope', version: '1.0.0' },
+                                spans: [{
+                                        traceId: VALID_TRACE_ID,
+                                        spanId: VALID_SPAN_ID,
+                                        name: 'test.operation',
+                                        kind: 1,
+                                        statusCode: 1,
+                                        startTimeNs: NOW_NS,
+                                        endTimeNs: END_NS,
+                                        attributes: {},
+                                    }],
+                            }],
+                    }],
+            });
+            assert.ok(result && typeof result === 'object');
+            assert.strictEqual(result.backend, 'local');
+        });
+    });
+});
+//# sourceMappingURL=ingest-traces.test.js.map