diff --git a/.github/workflows/fitracer-java.yml b/.github/workflows/fitracer-java.yml new file mode 100644 index 000000000..31e35f599 --- /dev/null +++ b/.github/workflows/fitracer-java.yml @@ -0,0 +1,35 @@ +name: FITracer Java guide + +on: + pull_request: + paths: + - src/pages/docs/sdk/tracing/fitracer.mdx + - examples/sdk/fitracer-java/** + - .github/workflows/fitracer-java.yml + +permissions: + contents: read + +jobs: + snippet: + name: FITracer Java snippet (released SDK 1.0.1) + runs-on: ubuntu-latest + timeout-minutes: 10 + defaults: + run: + working-directory: examples/sdk/fitracer-java + steps: + - uses: actions/checkout@v4 + - uses: actions/setup-java@v4 + with: + distribution: temurin + java-version: '17' + - uses: actions/setup-python@v5 + with: + python-version: '3.12' + - name: Install the OTLP decoder + run: python -I -m pip install -r requirements-test.txt + - name: Extract and compile both snippets against Maven Central + run: python -I snippet_test.py --compile-only + - name: Execute the guide with loopback-only networking + run: sudo env "PATH=$PATH" unshare --net sh -c 'ip link set lo up; python -I snippet_test.py --run-only' diff --git a/.github/workflows/fitracer-typescript.yml b/.github/workflows/fitracer-typescript.yml new file mode 100644 index 000000000..a22d35d9e --- /dev/null +++ b/.github/workflows/fitracer-typescript.yml @@ -0,0 +1,43 @@ +name: FITracer TypeScript guide + +on: + pull_request: + paths: + - src/pages/docs/sdk/tracing/fitracer.mdx + - examples/sdk/fitracer-typescript/** + - .github/workflows/fitracer-typescript.yml + +permissions: + contents: read + +jobs: + snippet: + name: FITracer snippet (OTel ${{ matrix.otel }}) + runs-on: ubuntu-latest + strategy: + fail-fast: false + matrix: + otel: ['2.0.1', '2.12.0'] + defaults: + run: + working-directory: examples/sdk/fitracer-typescript + steps: + - uses: actions/checkout@v4 + - uses: actions/setup-node@v4 + with: + node-version: '20' + - name: Install current locked dependencies + if: matrix.otel == '2.12.0' + run: npm ci --ignore-scripts --no-audit --no-fund + - name: Install the supported OpenTelemetry floor + if: matrix.otel == '2.0.1' + run: | + npm pkg set 'devDependencies.@opentelemetry/context-async-hooks=2.0.1' + npm pkg set 'overrides.@opentelemetry/context-async-hooks=2.0.1' \ + 'overrides.@opentelemetry/core=2.0.1' \ + 'overrides.@opentelemetry/resources=2.0.1' \ + 'overrides.@opentelemetry/sdk-trace-base=2.0.1' \ + 'overrides.@opentelemetry/sdk-trace-node=2.0.1' + npm install --ignore-scripts --no-audit --no-fund + - name: Type-check and execute the guide with loopback-only networking + run: sudo env "PATH=$PATH" unshare --net sh -c 'ip link set lo up; npm test' diff --git a/examples/sdk/fitracer-java/.gitignore b/examples/sdk/fitracer-java/.gitignore new file mode 100644 index 000000000..9280984ee --- /dev/null +++ b/examples/sdk/fitracer-java/.gitignore @@ -0,0 +1,2 @@ +target/ +__pycache__/ diff --git a/examples/sdk/fitracer-java/pom.xml b/examples/sdk/fitracer-java/pom.xml new file mode 100644 index 000000000..0bdfe2ae8 --- /dev/null +++ b/examples/sdk/fitracer-java/pom.xml @@ -0,0 +1,34 @@ + + 4.0.0 + com.futureagi.docs + fitracer-java-snippet + 1.0.0 + + 17 + UTF-8 + + + + com.futureagi + traceai-java-core + 1.0.1 + + + + ${project.build.directory}/snippet-source + + + org.apache.maven.plugins + maven-compiler-plugin + 3.13.0 + + + org.apache.maven.plugins + maven-dependency-plugin + 3.8.1 + + + + diff --git a/examples/sdk/fitracer-java/requirements-test.txt b/examples/sdk/fitracer-java/requirements-test.txt new file mode 100644 index 000000000..b249dfdea --- /dev/null +++ b/examples/sdk/fitracer-java/requirements-test.txt @@ -0,0 +1,2 @@ +opentelemetry-proto==1.38.0 +protobuf==6.32.1 diff --git a/examples/sdk/fitracer-java/snippet_test.py b/examples/sdk/fitracer-java/snippet_test.py new file mode 100644 index 000000000..d78d55bbf --- /dev/null +++ b/examples/sdk/fitracer-java/snippet_test.py @@ -0,0 +1,181 @@ +"""Compile the page's Java snippets against Maven Central and inspect exported OTLP. + +Run: python -I snippet_test.py +CI separates --compile-only (dependency downloads) from --run-only (loopback only). +Application services are synthetic fixtures; no tracing implementation is replaced. +""" + +import argparse +import gzip +import http.server +import json +import os +from pathlib import Path +import re +import subprocess +import threading +import unittest + +from opentelemetry.proto.collector.trace.v1.trace_service_pb2 import ExportTraceServiceRequest + +ROOT = Path(__file__).resolve().parent +TARGET = ROOT / "target" +PAGE = ROOT.parents[2] / "src/pages/docs/sdk/tracing/fitracer.mdx" + + +def compile_snippets(): + tab = PAGE.read_text().split('')[1].split('')[0] + blocks = [re.sub(r"^ ", "", block, flags=re.M) + for block in re.findall(r"```java\n(.*?)```", tab, re.S)] + if len(blocks) != 2: + raise AssertionError("Expected both lambda and manual Java examples") + imports = sorted(set(re.findall(r"^import .+;", "\n".join(blocks), re.M))) + bodies = [re.sub(r"^import .+;\n", "", block, flags=re.M) for block in blocks] + # Keep the documented operations unchanged. Supply only application context + # and deterministic services in place of external vector/LLM/tool calls. + source = "\n".join(imports) + """ +public class GuideExample { + static class VectorDb { String search(String question) { return "synthetic document"; } } + static class Llm { + String generate(String question, String docs) { return "synthetic answer"; } + } + static String executeTool(String input) { return "synthetic tool output"; } + static void manual(ai.traceai.FITracer tracer) { + String inputJson = "synthetic tool input"; +""" + bodies[1] + """ + } + public static void main(String[] args) { + ai.traceai.TraceAI.initFromEnvironment(); + try { + String question = "What is Python?"; + VectorDb vectorDb = new VectorDb(); + Llm llm = new Llm(); +""" + bodies[0] + """ + if (!"synthetic answer".equals(result)) throw new AssertionError(result); + if (io.opentelemetry.api.trace.Span.current().getSpanContext().isValid()) + throw new AssertionError("Callback scope leaked after trace returned"); + manual(tracer); + } finally { + ai.traceai.TraceAI.shutdown(); + } + } +} +""" + directory = TARGET / "snippet-source" + directory.mkdir(parents=True, exist_ok=True) + (directory / "GuideExample.java").write_text(source) + subprocess.run([ + "mvn", "-B", "-f", str(ROOT / "pom.xml"), "compile", + "dependency:build-classpath", "-Dmdep.outputFile=target/classpath.txt", + ], check=True, timeout=300) + + +class JavaSnippetTest(unittest.TestCase): + def test_exported_spans(self): + requests = [] + + class Collector(http.server.BaseHTTPRequestHandler): + def log_message(self, *args): + pass + + def do_POST(self): + if self.headers.get("Transfer-Encoding", "").lower() == "chunked": + chunks = [] + while True: + size = int(self.rfile.readline().split(b";", 1)[0], 16) + if size == 0: + while self.rfile.readline().strip(): + pass + break + chunks.append(self.rfile.read(size)) + self.rfile.read(2) + body = b"".join(chunks) + else: + body = self.rfile.read(int(self.headers["Content-Length"])) + if self.headers.get("Content-Encoding") == "gzip": + body = gzip.decompress(body) + requests.append((self.path, self.headers, ExportTraceServiceRequest.FromString(body))) + self.send_response(200) + self.send_header("Content-Type", "application/x-protobuf") + self.send_header("Content-Length", "0") + self.end_headers() + + server = http.server.ThreadingHTTPServer(("127.0.0.1", 0), Collector) + thread = threading.Thread(target=server.serve_forever, daemon=True) + thread.start() + # Never consume ambient credentials, endpoints, or privacy settings. + env = {key: value for key, value in os.environ.items() + if not key.startswith(("FI_", "OTEL_"))} + env.update(FI_BASE_URL=f"http://127.0.0.1:{server.server_port}", + FI_API_KEY="synthetic-api-key", FI_SECRET_KEY="synthetic-secret-key", + FI_PROJECT_NAME="my-project") + try: + classpath = str(TARGET / "classes") + os.pathsep + (TARGET / "classpath.txt").read_text().strip() + subprocess.run(["java", "-cp", classpath, "GuideExample"], env=env, + check=True, timeout=60) + finally: + server.shutdown() + server.server_close() + thread.join() + + def attrs(entries): + return {entry.key: getattr(entry.value, entry.value.WhichOneof("value")) + for entry in entries} + + spans = [] + self.assertTrue(requests, "Published exporter must send OTLP before shutdown returns") + for path, headers, request in requests: + self.assertEqual(path, "/tracer/v1/traces") + self.assertEqual(headers["X-Api-Key"], "synthetic-api-key") + self.assertEqual(headers["X-Secret-Key"], "synthetic-secret-key") + self.assertEqual(headers["Content-Type"], "application/x-protobuf") + for resource in request.resource_spans: + self.assertEqual(attrs(resource.resource.attributes)["project_name"], "my-project") + for scope in resource.scope_spans: + spans.extend(scope.spans) + self.assertCountEqual([span.name for span in spans], + ["rag-pipeline", "retrieve", "generate", "tool-call"]) + by_name = {span.name: span for span in spans} + parent = by_name["rag-pipeline"] + self.assertFalse(parent.parent_span_id) + for name, kind in [("rag-pipeline", "CHAIN"), ("retrieve", "RETRIEVER"), + ("generate", "LLM"), ("tool-call", "TOOL")]: + span = by_name[name] + self.assertEqual(attrs(span.attributes)["gen_ai.span.kind"], kind.lower()) + self.assertEqual(attrs(span.attributes)["fi.span.kind"], kind) + self.assertEqual(span.status.code, 1, name) + self.assertGreaterEqual(span.end_time_unix_nano, span.start_time_unix_nano) + self.assertGreater(span.start_time_unix_nano, 0) + for name in ("retrieve", "generate"): + self.assertEqual(by_name[name].trace_id, parent.trace_id) + self.assertEqual(by_name[name].parent_span_id, parent.span_id) + self.assertFalse(by_name["tool-call"].parent_span_id) + self.assertNotEqual(by_name["tool-call"].trace_id, parent.trace_id) + self.assertEqual(attrs(parent.attributes)["input.value"], "What is Python?") + self.assertEqual(attrs(parent.attributes)["output.value"], "synthetic answer") + self.assertEqual(attrs(by_name["retrieve"].attributes)["input.value"], "What is Python?") + self.assertEqual(attrs(by_name["retrieve"].attributes)["output.value"], "synthetic document") + generated = attrs(by_name["generate"].attributes) + self.assertEqual(json.loads(generated["gen_ai.input.messages"]), [ + {"role": "system", "content": "Answer using the context."}, + {"role": "user", "content": "What is Python?"}, + ]) + self.assertEqual(json.loads(generated["gen_ai.output.messages"]), [ + {"role": "assistant", "content": "synthetic answer"}, + ]) + self.assertEqual(generated["gen_ai.usage.input_tokens"], 50) + self.assertEqual(generated["gen_ai.usage.output_tokens"], 200) + self.assertEqual(attrs(by_name["tool-call"].attributes)["output.value"], "synthetic tool output") + print("Published Java SDK exported retrieve, generate, rag-pipeline, tool-call with correct parentage") + + +if __name__ == "__main__": + parser = argparse.ArgumentParser(description=__doc__) + mode = parser.add_mutually_exclusive_group() + mode.add_argument("--compile-only", action="store_true") + mode.add_argument("--run-only", action="store_true") + args = parser.parse_args() + if not args.run_only: + compile_snippets() + if not args.compile_only: + unittest.main(argv=[__file__], verbosity=2) diff --git a/examples/sdk/fitracer-typescript/package-lock.json b/examples/sdk/fitracer-typescript/package-lock.json new file mode 100644 index 000000000..5bde42a7f --- /dev/null +++ b/examples/sdk/fitracer-typescript/package-lock.json @@ -0,0 +1,1015 @@ +{ + "name": "fitracer-typescript-doc-test", + "version": "0.0.0", + "lockfileVersion": 3, + "requires": true, + "packages": { + "": { + "name": "fitracer-typescript-doc-test", + "version": "0.0.0", + "devDependencies": { + "@opentelemetry/api": "1.9.0", + "@opentelemetry/context-async-hooks": "2.12.0", + "@traceai/fi-core": "1.1.0", + "@types/node": "22.15.29", + "typescript": "5.9.3" + } + }, + "node_modules/@grpc/grpc-js": { + "version": "1.14.7", + "resolved": "https://registry.npmjs.org/@grpc/grpc-js/-/grpc-js-1.14.7.tgz", + "integrity": "sha512-W4W/fcBMGRVtG6dW2c7cw2mnpS3hvbBd+oQXjh2iYFTZDk1JJmcNqkM5KSaPubQpamlUUurrlb7G1s9NJeERmQ==", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "@grpc/proto-loader": "^0.8.0", + "@js-sdsl/ordered-map": "^4.4.2" + }, + "engines": { + "node": ">=12.10.0" + } + }, + "node_modules/@grpc/grpc-js/node_modules/@grpc/proto-loader": { + "version": "0.8.1", + "resolved": "https://registry.npmjs.org/@grpc/proto-loader/-/proto-loader-0.8.1.tgz", + "integrity": "sha512-wtF6h+DY6M3YaDBPAmvuuA6jV8Sif9MjtOI5euKFWRgCDl5PeDpPsHR9u2l6St5ceY8AZgoNDww5+HvEsXFsGg==", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "lodash.camelcase": "^4.3.0", + "long": "^5.0.0", + "protobufjs": "^7.5.5", + "yargs": "^17.7.2" + }, + "bin": { + "proto-loader-gen-types": "build/bin/proto-loader-gen-types.js" + }, + "engines": { + "node": ">=6" + } + }, + "node_modules/@grpc/proto-loader": { + "version": "0.7.15", + "resolved": "https://registry.npmjs.org/@grpc/proto-loader/-/proto-loader-0.7.15.tgz", + "integrity": "sha512-tMXdRCfYVixjuFK+Hk0Q1s38gV9zDiDJfWL3h1rv4Qc39oILCu1TRTDt7+fGUI8K4G1Fj125Hx/ru3azECWTyQ==", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "lodash.camelcase": "^4.3.0", + "long": "^5.0.0", + "protobufjs": "^7.2.5", + "yargs": "^17.7.2" + }, + "bin": { + "proto-loader-gen-types": "build/bin/proto-loader-gen-types.js" + }, + "engines": { + "node": ">=6" + } + }, + "node_modules/@js-sdsl/ordered-map": { + "version": "4.4.2", + "resolved": "https://registry.npmjs.org/@js-sdsl/ordered-map/-/ordered-map-4.4.2.tgz", + "integrity": "sha512-iUKgm52T8HOE/makSxjqoWhe95ZJA1/G1sYsGev2JDKUSS14KAgg1LHb+Ba+IPow0xflbnSkOsZcO08C7w1gYw==", + "dev": true, + "license": "MIT", + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/js-sdsl" + } + }, + "node_modules/@opentelemetry/api": { + "version": "1.9.0", + "resolved": "https://registry.npmjs.org/@opentelemetry/api/-/api-1.9.0.tgz", + "integrity": "sha512-3giAOQvZiH5F9bMlMiv8+GSPMeqg0dbaeo58/0SlA9sxSqZhnUtxzX9/2FzyhS9sWQf5S0GJE0AKBrFqjpeYcg==", + "dev": true, + "license": "Apache-2.0", + "engines": { + "node": ">=8.0.0" + } + }, + "node_modules/@opentelemetry/api-logs": { + "version": "0.202.0", + "resolved": "https://registry.npmjs.org/@opentelemetry/api-logs/-/api-logs-0.202.0.tgz", + "integrity": "sha512-fTBjMqKCfotFWfLzaKyhjLvyEyq5vDKTTFfBmx21btv3gvy8Lq6N5Dh2OzqeuN4DjtpSvNT1uNVfg08eD2Rfxw==", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "@opentelemetry/api": "^1.3.0" + }, + "engines": { + "node": ">=8.0.0" + } + }, + "node_modules/@opentelemetry/context-async-hooks": { + "version": "2.12.0", + "resolved": "https://registry.npmjs.org/@opentelemetry/context-async-hooks/-/context-async-hooks-2.12.0.tgz", + "integrity": "sha512-iK/1nD7mmZVkuYjVjkdFBiCvzntJdFny1S3CYbUYyOq7V5enL6XX+gJ7eh965L1LnS11VA8mQ7Ej/ck04SB0MQ==", + "dev": true, + "license": "Apache-2.0", + "engines": { + "node": "^18.19.0 || >=20.6.0" + }, + "peerDependencies": { + "@opentelemetry/api": ">=1.0.0 <1.10.0" + } + }, + "node_modules/@opentelemetry/core": { + "version": "2.12.0", + "resolved": "https://registry.npmjs.org/@opentelemetry/core/-/core-2.12.0.tgz", + "integrity": "sha512-1HsSAuvT4/my0QrXWsyXFdWjKaPeCHsismKZgEEIb8NK13LP6DrMRlsUbvD/0F9mDWK3xDom9AMv3IscxgOnOQ==", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "@opentelemetry/semantic-conventions": "^1.29.0" + }, + "engines": { + "node": "^18.19.0 || >=20.6.0" + }, + "peerDependencies": { + "@opentelemetry/api": ">=1.0.0 <1.10.0" + } + }, + "node_modules/@opentelemetry/exporter-trace-otlp-grpc": { + "version": "0.202.0", + "resolved": "https://registry.npmjs.org/@opentelemetry/exporter-trace-otlp-grpc/-/exporter-trace-otlp-grpc-0.202.0.tgz", + "integrity": "sha512-d5wLdbNA3ahpSeD0I34vbDFMTh4vPsXemH0bKDXLeCVULCAjOJXuZmEiuRammiDgVvvX7CAb/IGLDz8d2QHvoA==", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "@grpc/grpc-js": "^1.7.1", + "@opentelemetry/core": "2.0.1", + "@opentelemetry/otlp-exporter-base": "0.202.0", + "@opentelemetry/otlp-grpc-exporter-base": "0.202.0", + "@opentelemetry/otlp-transformer": "0.202.0", + "@opentelemetry/resources": "2.0.1", + "@opentelemetry/sdk-trace-base": "2.0.1" + }, + "engines": { + "node": "^18.19.0 || >=20.6.0" + }, + "peerDependencies": { + "@opentelemetry/api": "^1.3.0" + } + }, + "node_modules/@opentelemetry/exporter-trace-otlp-grpc/node_modules/@opentelemetry/core": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/@opentelemetry/core/-/core-2.0.1.tgz", + "integrity": "sha512-MaZk9SJIDgo1peKevlbhP6+IwIiNPNmswNL4AF0WaQJLbHXjr9SrZMgS12+iqr9ToV4ZVosCcc0f8Rg67LXjxw==", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "@opentelemetry/semantic-conventions": "^1.29.0" + }, + "engines": { + "node": "^18.19.0 || >=20.6.0" + }, + "peerDependencies": { + "@opentelemetry/api": ">=1.0.0 <1.10.0" + } + }, + "node_modules/@opentelemetry/exporter-trace-otlp-grpc/node_modules/@opentelemetry/resources": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/@opentelemetry/resources/-/resources-2.0.1.tgz", + "integrity": "sha512-dZOB3R6zvBwDKnHDTB4X1xtMArB/d324VsbiPkX/Yu0Q8T2xceRthoIVFhJdvgVM2QhGVUyX9tzwiNxGtoBJUw==", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "@opentelemetry/core": "2.0.1", + "@opentelemetry/semantic-conventions": "^1.29.0" + }, + "engines": { + "node": "^18.19.0 || >=20.6.0" + }, + "peerDependencies": { + "@opentelemetry/api": ">=1.3.0 <1.10.0" + } + }, + "node_modules/@opentelemetry/exporter-trace-otlp-grpc/node_modules/@opentelemetry/sdk-trace-base": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/@opentelemetry/sdk-trace-base/-/sdk-trace-base-2.0.1.tgz", + "integrity": "sha512-xYLlvk/xdScGx1aEqvxLwf6sXQLXCjk3/1SQT9X9AoN5rXRhkdvIFShuNNmtTEPRBqcsMbS4p/gJLNI2wXaDuQ==", + "deprecated": "Use @opentelemetry/sdk-trace package", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "@opentelemetry/core": "2.0.1", + "@opentelemetry/resources": "2.0.1", + "@opentelemetry/semantic-conventions": "^1.29.0" + }, + "engines": { + "node": "^18.19.0 || >=20.6.0" + }, + "peerDependencies": { + "@opentelemetry/api": ">=1.3.0 <1.10.0" + } + }, + "node_modules/@opentelemetry/exporter-trace-otlp-http": { + "version": "0.202.0", + "resolved": "https://registry.npmjs.org/@opentelemetry/exporter-trace-otlp-http/-/exporter-trace-otlp-http-0.202.0.tgz", + "integrity": "sha512-/hKE8DaFCJuaQqE1IxpgkcjOolUIwgi3TgHElPVKGdGRBSmJMTmN/cr6vWa55pCJIXPyhKvcMrbrya7DZ3VmzA==", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "@opentelemetry/core": "2.0.1", + "@opentelemetry/otlp-exporter-base": "0.202.0", + "@opentelemetry/otlp-transformer": "0.202.0", + "@opentelemetry/resources": "2.0.1", + "@opentelemetry/sdk-trace-base": "2.0.1" + }, + "engines": { + "node": "^18.19.0 || >=20.6.0" + }, + "peerDependencies": { + "@opentelemetry/api": "^1.3.0" + } + }, + "node_modules/@opentelemetry/exporter-trace-otlp-http/node_modules/@opentelemetry/core": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/@opentelemetry/core/-/core-2.0.1.tgz", + "integrity": "sha512-MaZk9SJIDgo1peKevlbhP6+IwIiNPNmswNL4AF0WaQJLbHXjr9SrZMgS12+iqr9ToV4ZVosCcc0f8Rg67LXjxw==", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "@opentelemetry/semantic-conventions": "^1.29.0" + }, + "engines": { + "node": "^18.19.0 || >=20.6.0" + }, + "peerDependencies": { + "@opentelemetry/api": ">=1.0.0 <1.10.0" + } + }, + "node_modules/@opentelemetry/exporter-trace-otlp-http/node_modules/@opentelemetry/resources": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/@opentelemetry/resources/-/resources-2.0.1.tgz", + "integrity": "sha512-dZOB3R6zvBwDKnHDTB4X1xtMArB/d324VsbiPkX/Yu0Q8T2xceRthoIVFhJdvgVM2QhGVUyX9tzwiNxGtoBJUw==", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "@opentelemetry/core": "2.0.1", + "@opentelemetry/semantic-conventions": "^1.29.0" + }, + "engines": { + "node": "^18.19.0 || >=20.6.0" + }, + "peerDependencies": { + "@opentelemetry/api": ">=1.3.0 <1.10.0" + } + }, + "node_modules/@opentelemetry/exporter-trace-otlp-http/node_modules/@opentelemetry/sdk-trace-base": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/@opentelemetry/sdk-trace-base/-/sdk-trace-base-2.0.1.tgz", + "integrity": "sha512-xYLlvk/xdScGx1aEqvxLwf6sXQLXCjk3/1SQT9X9AoN5rXRhkdvIFShuNNmtTEPRBqcsMbS4p/gJLNI2wXaDuQ==", + "deprecated": "Use @opentelemetry/sdk-trace package", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "@opentelemetry/core": "2.0.1", + "@opentelemetry/resources": "2.0.1", + "@opentelemetry/semantic-conventions": "^1.29.0" + }, + "engines": { + "node": "^18.19.0 || >=20.6.0" + }, + "peerDependencies": { + "@opentelemetry/api": ">=1.3.0 <1.10.0" + } + }, + "node_modules/@opentelemetry/otlp-exporter-base": { + "version": "0.202.0", + "resolved": "https://registry.npmjs.org/@opentelemetry/otlp-exporter-base/-/otlp-exporter-base-0.202.0.tgz", + "integrity": "sha512-nMEOzel+pUFYuBJg2znGmHJWbmvMbdX5/RhoKNKowguMbURhz0fwik5tUKplLcUtl8wKPL1y9zPnPxeBn65N0Q==", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "@opentelemetry/core": "2.0.1", + "@opentelemetry/otlp-transformer": "0.202.0" + }, + "engines": { + "node": "^18.19.0 || >=20.6.0" + }, + "peerDependencies": { + "@opentelemetry/api": "^1.3.0" + } + }, + "node_modules/@opentelemetry/otlp-exporter-base/node_modules/@opentelemetry/core": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/@opentelemetry/core/-/core-2.0.1.tgz", + "integrity": "sha512-MaZk9SJIDgo1peKevlbhP6+IwIiNPNmswNL4AF0WaQJLbHXjr9SrZMgS12+iqr9ToV4ZVosCcc0f8Rg67LXjxw==", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "@opentelemetry/semantic-conventions": "^1.29.0" + }, + "engines": { + "node": "^18.19.0 || >=20.6.0" + }, + "peerDependencies": { + "@opentelemetry/api": ">=1.0.0 <1.10.0" + } + }, + "node_modules/@opentelemetry/otlp-grpc-exporter-base": { + "version": "0.202.0", + "resolved": "https://registry.npmjs.org/@opentelemetry/otlp-grpc-exporter-base/-/otlp-grpc-exporter-base-0.202.0.tgz", + "integrity": "sha512-yIEHVxFA5dmYif7lZbbB66qulLLhrklj6mI2X3cuGW5hYPyUErztEmbroM+6teu/XobBi9bLHid2VT4NIaRuGg==", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "@grpc/grpc-js": "^1.7.1", + "@opentelemetry/core": "2.0.1", + "@opentelemetry/otlp-exporter-base": "0.202.0", + "@opentelemetry/otlp-transformer": "0.202.0" + }, + "engines": { + "node": "^18.19.0 || >=20.6.0" + }, + "peerDependencies": { + "@opentelemetry/api": "^1.3.0" + } + }, + "node_modules/@opentelemetry/otlp-grpc-exporter-base/node_modules/@opentelemetry/core": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/@opentelemetry/core/-/core-2.0.1.tgz", + "integrity": "sha512-MaZk9SJIDgo1peKevlbhP6+IwIiNPNmswNL4AF0WaQJLbHXjr9SrZMgS12+iqr9ToV4ZVosCcc0f8Rg67LXjxw==", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "@opentelemetry/semantic-conventions": "^1.29.0" + }, + "engines": { + "node": "^18.19.0 || >=20.6.0" + }, + "peerDependencies": { + "@opentelemetry/api": ">=1.0.0 <1.10.0" + } + }, + "node_modules/@opentelemetry/otlp-transformer": { + "version": "0.202.0", + "resolved": "https://registry.npmjs.org/@opentelemetry/otlp-transformer/-/otlp-transformer-0.202.0.tgz", + "integrity": "sha512-5XO77QFzs9WkexvJQL9ksxL8oVFb/dfi9NWQSq7Sv0Efr9x3N+nb1iklP1TeVgxqJ7m1xWiC/Uv3wupiQGevMw==", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "@opentelemetry/api-logs": "0.202.0", + "@opentelemetry/core": "2.0.1", + "@opentelemetry/resources": "2.0.1", + "@opentelemetry/sdk-logs": "0.202.0", + "@opentelemetry/sdk-metrics": "2.0.1", + "@opentelemetry/sdk-trace-base": "2.0.1", + "protobufjs": "^7.3.0" + }, + "engines": { + "node": "^18.19.0 || >=20.6.0" + }, + "peerDependencies": { + "@opentelemetry/api": "^1.3.0" + } + }, + "node_modules/@opentelemetry/otlp-transformer/node_modules/@opentelemetry/core": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/@opentelemetry/core/-/core-2.0.1.tgz", + "integrity": "sha512-MaZk9SJIDgo1peKevlbhP6+IwIiNPNmswNL4AF0WaQJLbHXjr9SrZMgS12+iqr9ToV4ZVosCcc0f8Rg67LXjxw==", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "@opentelemetry/semantic-conventions": "^1.29.0" + }, + "engines": { + "node": "^18.19.0 || >=20.6.0" + }, + "peerDependencies": { + "@opentelemetry/api": ">=1.0.0 <1.10.0" + } + }, + "node_modules/@opentelemetry/otlp-transformer/node_modules/@opentelemetry/resources": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/@opentelemetry/resources/-/resources-2.0.1.tgz", + "integrity": "sha512-dZOB3R6zvBwDKnHDTB4X1xtMArB/d324VsbiPkX/Yu0Q8T2xceRthoIVFhJdvgVM2QhGVUyX9tzwiNxGtoBJUw==", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "@opentelemetry/core": "2.0.1", + "@opentelemetry/semantic-conventions": "^1.29.0" + }, + "engines": { + "node": "^18.19.0 || >=20.6.0" + }, + "peerDependencies": { + "@opentelemetry/api": ">=1.3.0 <1.10.0" + } + }, + "node_modules/@opentelemetry/otlp-transformer/node_modules/@opentelemetry/sdk-trace-base": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/@opentelemetry/sdk-trace-base/-/sdk-trace-base-2.0.1.tgz", + "integrity": "sha512-xYLlvk/xdScGx1aEqvxLwf6sXQLXCjk3/1SQT9X9AoN5rXRhkdvIFShuNNmtTEPRBqcsMbS4p/gJLNI2wXaDuQ==", + "deprecated": "Use @opentelemetry/sdk-trace package", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "@opentelemetry/core": "2.0.1", + "@opentelemetry/resources": "2.0.1", + "@opentelemetry/semantic-conventions": "^1.29.0" + }, + "engines": { + "node": "^18.19.0 || >=20.6.0" + }, + "peerDependencies": { + "@opentelemetry/api": ">=1.3.0 <1.10.0" + } + }, + "node_modules/@opentelemetry/resources": { + "version": "2.12.0", + "resolved": "https://registry.npmjs.org/@opentelemetry/resources/-/resources-2.12.0.tgz", + "integrity": "sha512-+rSRoOdln6NhXTVcBdHSlZxJDNzwxadeweK2ltZO3tVtfp6aklABc06xclDk6ovRR+EiGgIcSbh/6NgjFhnb3A==", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "@opentelemetry/core": "2.12.0", + "@opentelemetry/semantic-conventions": "^1.29.0" + }, + "engines": { + "node": "^18.19.0 || >=20.6.0" + }, + "peerDependencies": { + "@opentelemetry/api": ">=1.3.0 <1.10.0" + } + }, + "node_modules/@opentelemetry/sdk-logs": { + "version": "0.202.0", + "resolved": "https://registry.npmjs.org/@opentelemetry/sdk-logs/-/sdk-logs-0.202.0.tgz", + "integrity": "sha512-pv8QiQLQzk4X909YKm0lnW4hpuQg4zHwJ4XBd5bZiXcd9urvrJNoNVKnxGHPiDVX/GiLFvr5DMYsDBQbZCypRQ==", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "@opentelemetry/api-logs": "0.202.0", + "@opentelemetry/core": "2.0.1", + "@opentelemetry/resources": "2.0.1" + }, + "engines": { + "node": "^18.19.0 || >=20.6.0" + }, + "peerDependencies": { + "@opentelemetry/api": ">=1.4.0 <1.10.0" + } + }, + "node_modules/@opentelemetry/sdk-logs/node_modules/@opentelemetry/core": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/@opentelemetry/core/-/core-2.0.1.tgz", + "integrity": "sha512-MaZk9SJIDgo1peKevlbhP6+IwIiNPNmswNL4AF0WaQJLbHXjr9SrZMgS12+iqr9ToV4ZVosCcc0f8Rg67LXjxw==", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "@opentelemetry/semantic-conventions": "^1.29.0" + }, + "engines": { + "node": "^18.19.0 || >=20.6.0" + }, + "peerDependencies": { + "@opentelemetry/api": ">=1.0.0 <1.10.0" + } + }, + "node_modules/@opentelemetry/sdk-logs/node_modules/@opentelemetry/resources": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/@opentelemetry/resources/-/resources-2.0.1.tgz", + "integrity": "sha512-dZOB3R6zvBwDKnHDTB4X1xtMArB/d324VsbiPkX/Yu0Q8T2xceRthoIVFhJdvgVM2QhGVUyX9tzwiNxGtoBJUw==", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "@opentelemetry/core": "2.0.1", + "@opentelemetry/semantic-conventions": "^1.29.0" + }, + "engines": { + "node": "^18.19.0 || >=20.6.0" + }, + "peerDependencies": { + "@opentelemetry/api": ">=1.3.0 <1.10.0" + } + }, + "node_modules/@opentelemetry/sdk-metrics": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/@opentelemetry/sdk-metrics/-/sdk-metrics-2.0.1.tgz", + "integrity": "sha512-wf8OaJoSnujMAHWR3g+/hGvNcsC16rf9s1So4JlMiFaFHiE4HpIA3oUh+uWZQ7CNuK8gVW/pQSkgoa5HkkOl0g==", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "@opentelemetry/core": "2.0.1", + "@opentelemetry/resources": "2.0.1" + }, + "engines": { + "node": "^18.19.0 || >=20.6.0" + }, + "peerDependencies": { + "@opentelemetry/api": ">=1.9.0 <1.10.0" + } + }, + "node_modules/@opentelemetry/sdk-metrics/node_modules/@opentelemetry/core": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/@opentelemetry/core/-/core-2.0.1.tgz", + "integrity": "sha512-MaZk9SJIDgo1peKevlbhP6+IwIiNPNmswNL4AF0WaQJLbHXjr9SrZMgS12+iqr9ToV4ZVosCcc0f8Rg67LXjxw==", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "@opentelemetry/semantic-conventions": "^1.29.0" + }, + "engines": { + "node": "^18.19.0 || >=20.6.0" + }, + "peerDependencies": { + "@opentelemetry/api": ">=1.0.0 <1.10.0" + } + }, + "node_modules/@opentelemetry/sdk-metrics/node_modules/@opentelemetry/resources": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/@opentelemetry/resources/-/resources-2.0.1.tgz", + "integrity": "sha512-dZOB3R6zvBwDKnHDTB4X1xtMArB/d324VsbiPkX/Yu0Q8T2xceRthoIVFhJdvgVM2QhGVUyX9tzwiNxGtoBJUw==", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "@opentelemetry/core": "2.0.1", + "@opentelemetry/semantic-conventions": "^1.29.0" + }, + "engines": { + "node": "^18.19.0 || >=20.6.0" + }, + "peerDependencies": { + "@opentelemetry/api": ">=1.3.0 <1.10.0" + } + }, + "node_modules/@opentelemetry/sdk-trace": { + "version": "2.12.0", + "resolved": "https://registry.npmjs.org/@opentelemetry/sdk-trace/-/sdk-trace-2.12.0.tgz", + "integrity": "sha512-ImVuRQ6faOsTi1Wna88s2avgrrf/iDgXPigIeynkUhjstMuoQUDOJXgkez2j1mlU4btjXcXBGa+q7qKFYR3GsA==", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "@opentelemetry/core": "2.12.0", + "@opentelemetry/resources": "2.12.0", + "@opentelemetry/semantic-conventions": "^1.29.0" + }, + "engines": { + "node": "^18.19.0 || >=20.6.0" + }, + "peerDependencies": { + "@opentelemetry/api": ">=1.3.0 <1.10.0" + } + }, + "node_modules/@opentelemetry/sdk-trace-base": { + "version": "2.12.0", + "resolved": "https://registry.npmjs.org/@opentelemetry/sdk-trace-base/-/sdk-trace-base-2.12.0.tgz", + "integrity": "sha512-JOERgZCxRM06FEJ5kEWxlSRChah6MmXDx3KwCruqEv/iEyLkTokCSemf2y1w8oIHtfrr8EVTpzebq/31vn2Cpg==", + "deprecated": "Use @opentelemetry/sdk-trace package", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "@opentelemetry/core": "2.12.0", + "@opentelemetry/resources": "2.12.0", + "@opentelemetry/sdk-trace": "2.12.0", + "@opentelemetry/semantic-conventions": "^1.29.0" + }, + "engines": { + "node": "^18.19.0 || >=20.6.0" + }, + "peerDependencies": { + "@opentelemetry/api": ">=1.3.0 <1.10.0" + } + }, + "node_modules/@opentelemetry/sdk-trace-node": { + "version": "2.12.0", + "resolved": "https://registry.npmjs.org/@opentelemetry/sdk-trace-node/-/sdk-trace-node-2.12.0.tgz", + "integrity": "sha512-9DufH1IlmQMoKAfot5y/FhTP1RnmhLb5K6eKmJO/bvzPjYwPAazoiAUbTZFdPbqxOXN0FEbhZx/e6SB1Og4jmg==", + "deprecated": "Use @opentelemetry/sdk-trace package", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "@opentelemetry/context-async-hooks": "2.12.0", + "@opentelemetry/core": "2.12.0", + "@opentelemetry/sdk-trace-base": "2.12.0" + }, + "engines": { + "node": "^18.19.0 || >=20.6.0" + }, + "peerDependencies": { + "@opentelemetry/api": ">=1.0.0 <1.10.0" + } + }, + "node_modules/@opentelemetry/semantic-conventions": { + "version": "1.44.0", + "resolved": "https://registry.npmjs.org/@opentelemetry/semantic-conventions/-/semantic-conventions-1.44.0.tgz", + "integrity": "sha512-E3JkOlMBi3N8OGGkbl7tFyqk2MAS6/lySRZBK3Mu7AzjF1fT8oIChH9ChE48SUWzDn9Kdwta+G/p5LJ4xW4CLQ==", + "dev": true, + "license": "Apache-2.0", + "engines": { + "node": ">=14" + } + }, + "node_modules/@protobuf-ts/grpc-transport": { + "version": "2.11.1", + "resolved": "https://registry.npmjs.org/@protobuf-ts/grpc-transport/-/grpc-transport-2.11.1.tgz", + "integrity": "sha512-l6wrcFffY+tuNnuyrNCkRM8hDIsAZVLA8Mn7PKdVyYxITosYh60qW663p9kL6TWXYuDCL3oxH8ih3vLKTDyhtg==", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "@protobuf-ts/runtime": "^2.11.1", + "@protobuf-ts/runtime-rpc": "^2.11.1" + }, + "peerDependencies": { + "@grpc/grpc-js": "^1.6.0" + } + }, + "node_modules/@protobuf-ts/runtime": { + "version": "2.11.1", + "resolved": "https://registry.npmjs.org/@protobuf-ts/runtime/-/runtime-2.11.1.tgz", + "integrity": "sha512-KuDaT1IfHkugM2pyz+FwiY80ejWrkH1pAtOBOZFuR6SXEFTsnb/jiQWQ1rCIrcKx2BtyxnxW6BWwsVSA/Ie+WQ==", + "dev": true, + "license": "(Apache-2.0 AND BSD-3-Clause)" + }, + "node_modules/@protobuf-ts/runtime-rpc": { + "version": "2.11.1", + "resolved": "https://registry.npmjs.org/@protobuf-ts/runtime-rpc/-/runtime-rpc-2.11.1.tgz", + "integrity": "sha512-4CqqUmNA+/uMz00+d3CYKgElXO9VrEbucjnBFEjqI4GuDrEQ32MaI3q+9qPBvIGOlL4PmHXrzM32vBPWRhQKWQ==", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "@protobuf-ts/runtime": "^2.11.1" + } + }, + "node_modules/@protobufjs/aspromise": { + "version": "1.1.2", + "resolved": "https://registry.npmjs.org/@protobufjs/aspromise/-/aspromise-1.1.2.tgz", + "integrity": "sha512-j+gKExEuLmKwvz3OgROXtrJ2UG2x8Ch2YZUxahh+s1F2HZ+wAceUNLkvy6zKCPVRkU++ZWQrdxsUeQXmcg4uoQ==", + "dev": true, + "license": "BSD-3-Clause" + }, + "node_modules/@protobufjs/base64": { + "version": "1.1.2", + "resolved": "https://registry.npmjs.org/@protobufjs/base64/-/base64-1.1.2.tgz", + "integrity": "sha512-AZkcAA5vnN/v4PDqKyMR5lx7hZttPDgClv83E//FMNhR2TMcLUhfRUBHCmSl0oi9zMgDDqRUJkSxO3wm85+XLg==", + "dev": true, + "license": "BSD-3-Clause" + }, + "node_modules/@protobufjs/codegen": { + "version": "2.0.5", + "resolved": "https://registry.npmjs.org/@protobufjs/codegen/-/codegen-2.0.5.tgz", + "integrity": "sha512-zgXFLzW3Ap33e6d0Wlj4MGIm6Ce8O89n/apUaGNB/jx+hw+ruWEp7EwGUshdLKVRCxZW12fp9r40E1mQrf/34g==", + "dev": true, + "license": "BSD-3-Clause" + }, + "node_modules/@protobufjs/eventemitter": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/@protobufjs/eventemitter/-/eventemitter-1.1.1.tgz", + "integrity": "sha512-vW1GmwMZNnL+gMRaovlh9yZX74kc+TTU3FObkkurpMaRtBfLP3ldjS9KQWlwZgraRE0+dheEEoAxdzcJQ8eXZg==", + "dev": true, + "license": "BSD-3-Clause" + }, + "node_modules/@protobufjs/fetch": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/@protobufjs/fetch/-/fetch-1.1.1.tgz", + "integrity": "sha512-GpptLrs57adMSuHi3VNj0mAF8dwh36LMaYF6XyJ6JMWlVsc+t42tm1HSEDmOs3A8fC9yyeisgLhsTVQokOZ0zw==", + "dev": true, + "license": "BSD-3-Clause", + "dependencies": { + "@protobufjs/aspromise": "^1.1.1" + } + }, + "node_modules/@protobufjs/float": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/@protobufjs/float/-/float-1.0.2.tgz", + "integrity": "sha512-Ddb+kVXlXst9d+R9PfTIxh1EdNkgoRe5tOX6t01f1lYWOvJnSPDBlG241QLzcyPdoNTsblLUdujGSE4RzrTZGQ==", + "dev": true, + "license": "BSD-3-Clause" + }, + "node_modules/@protobufjs/path": { + "version": "1.1.2", + "resolved": "https://registry.npmjs.org/@protobufjs/path/-/path-1.1.2.tgz", + "integrity": "sha512-6JOcJ5Tm08dOHAbdR3GrvP+yUUfkjG5ePsHYczMFLq3ZmMkAD98cDgcT2iA1lJ9NVwFd4tH/iSSoe44YWkltEA==", + "dev": true, + "license": "BSD-3-Clause" + }, + "node_modules/@protobufjs/pool": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/@protobufjs/pool/-/pool-1.1.0.tgz", + "integrity": "sha512-0kELaGSIDBKvcgS4zkjz1PeddatrjYcmMWOlAuAPwAeccUrPHdUqo/J6LiymHHEiJT5NrF1UVwxY14f+fy4WQw==", + "dev": true, + "license": "BSD-3-Clause" + }, + "node_modules/@protobufjs/utf8": { + "version": "1.1.2", + "resolved": "https://registry.npmjs.org/@protobufjs/utf8/-/utf8-1.1.2.tgz", + "integrity": "sha512-b1UQwcEZ4yCnMCD8DAL1VlbvBJE9/IX4FTIp7BG1xYpf29SLazLSrqUkj4w7Y5y7cCVP6E5tcqqcI0xemPkHug==", + "dev": true, + "license": "BSD-3-Clause" + }, + "node_modules/@traceai/fi-core": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/@traceai/fi-core/-/fi-core-1.1.0.tgz", + "integrity": "sha512-+htTaMf60j5K8klCVE3urVs2qfF3tCeg4zcqSKlKMppwJupf9E5Z/suC9S1LyaO8SyMTCDl2kLSRyFQnmBGLJg==", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "@grpc/grpc-js": "^1.13.4", + "@grpc/proto-loader": "^0.7.15", + "@opentelemetry/api": "^1.9.0", + "@opentelemetry/context-async-hooks": "^2.0.1", + "@opentelemetry/core": "^2.0.1", + "@opentelemetry/exporter-trace-otlp-grpc": "^0.202.0", + "@opentelemetry/exporter-trace-otlp-http": "^0.202.0", + "@opentelemetry/resources": "^2.0.1", + "@opentelemetry/sdk-trace-base": "^2.0.1", + "@opentelemetry/sdk-trace-node": "^2.0.1", + "@opentelemetry/semantic-conventions": "^1.34.0", + "@protobuf-ts/grpc-transport": "^2.11.0", + "@protobuf-ts/runtime": "^2.11.0", + "@protobuf-ts/runtime-rpc": "^2.11.0", + "@traceai/fi-semantic-conventions": "^1.0.0", + "uuid": "^11.1.0" + } + }, + "node_modules/@traceai/fi-semantic-conventions": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/@traceai/fi-semantic-conventions/-/fi-semantic-conventions-1.0.0.tgz", + "integrity": "sha512-P+idlTaWs5YBURzUcJ8dPut9Y32I8E2FxMJfQbU8xISoWOW2xX6w5+Ri7Xt0Ve/NJ6XvbgMqojN3aGH3ZJBaLw==", + "dev": true, + "dependencies": { + "@opentelemetry/api": "^1.9.0", + "uuid": "^11.1.0" + } + }, + "node_modules/@types/node": { + "version": "22.15.29", + "resolved": "https://registry.npmjs.org/@types/node/-/node-22.15.29.tgz", + "integrity": "sha512-LNdjOkUDlU1RZb8e1kOIUpN1qQUlzGkEtbVNo53vbrwDg5om6oduhm4SiUaPW5ASTXhAiP0jInWG8Qx9fVlOeQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "undici-types": "~6.21.0" + } + }, + "node_modules/ansi-regex": { + "version": "5.0.1", + "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-5.0.1.tgz", + "integrity": "sha512-quJQXlTSUGL2LH9SUXo8VwsY4soanhgo6LNSm84E1LBcE8s3O0wpdiRzyR9z/ZZJMlMWv37qOOb9pdJlMUEKFQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/ansi-styles": { + "version": "4.3.0", + "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-4.3.0.tgz", + "integrity": "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==", + "dev": true, + "license": "MIT", + "dependencies": { + "color-convert": "^2.0.1" + }, + "engines": { + "node": ">=8" + }, + "funding": { + "url": "https://github.com/chalk/ansi-styles?sponsor=1" + } + }, + "node_modules/cliui": { + "version": "8.0.1", + "resolved": "https://registry.npmjs.org/cliui/-/cliui-8.0.1.tgz", + "integrity": "sha512-BSeNnyus75C4//NQ9gQt1/csTXyo/8Sb+afLAkzAptFuMsod9HFokGNudZpi/oQV73hnVK+sR+5PVRMd+Dr7YQ==", + "dev": true, + "license": "ISC", + "dependencies": { + "string-width": "^4.2.0", + "strip-ansi": "^6.0.1", + "wrap-ansi": "^7.0.0" + }, + "engines": { + "node": ">=12" + } + }, + "node_modules/color-convert": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz", + "integrity": "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "color-name": "~1.1.4" + }, + "engines": { + "node": ">=7.0.0" + } + }, + "node_modules/color-name": { + "version": "1.1.4", + "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.4.tgz", + "integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==", + "dev": true, + "license": "MIT" + }, + "node_modules/emoji-regex": { + "version": "8.0.0", + "resolved": "https://registry.npmjs.org/emoji-regex/-/emoji-regex-8.0.0.tgz", + "integrity": "sha512-MSjYzcWNOA0ewAHpz0MxpYFvwg6yjy1NG3xteoqz644VCo/RPgnr1/GGt+ic3iJTzQ8Eu3TdM14SawnVUmGE6A==", + "dev": true, + "license": "MIT" + }, + "node_modules/escalade": { + "version": "3.2.0", + "resolved": "https://registry.npmjs.org/escalade/-/escalade-3.2.0.tgz", + "integrity": "sha512-WUj2qlxaQtO4g6Pq5c29GTcWGDyd8itL8zTlipgECz3JesAiiOKotd8JU6otB3PACgG6xkJUyVhboMS+bje/jA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6" + } + }, + "node_modules/get-caller-file": { + "version": "2.0.5", + "resolved": "https://registry.npmjs.org/get-caller-file/-/get-caller-file-2.0.5.tgz", + "integrity": "sha512-DyFP3BM/3YHTQOCUL/w0OZHR0lpKeGrxotcHWcqNEdnltqFwXVfhEBQ94eIo34AfQpo0rGki4cyIiftY06h2Fg==", + "dev": true, + "license": "ISC", + "engines": { + "node": "6.* || 8.* || >= 10.*" + } + }, + "node_modules/is-fullwidth-code-point": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/is-fullwidth-code-point/-/is-fullwidth-code-point-3.0.0.tgz", + "integrity": "sha512-zymm5+u+sCsSWyD9qNaejV3DFvhCKclKdizYaJUuHA83RLjb7nSuGnddCHGv0hk+KY7BMAlsWeK4Ueg6EV6XQg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/lodash.camelcase": { + "version": "4.3.0", + "resolved": "https://registry.npmjs.org/lodash.camelcase/-/lodash.camelcase-4.3.0.tgz", + "integrity": "sha512-TwuEnCnxbc3rAvhf/LbG7tJUDzhqXyFnv3dtzLOPgCG/hODL7WFnsbwktkD7yUV0RrreP/l1PALq/YSg6VvjlA==", + "dev": true, + "license": "MIT" + }, + "node_modules/long": { + "version": "5.3.2", + "resolved": "https://registry.npmjs.org/long/-/long-5.3.2.tgz", + "integrity": "sha512-mNAgZ1GmyNhD7AuqnTG3/VQ26o760+ZYBPKjPvugO8+nLbYfX6TVpJPseBvopbdY+qpZ/lKUnmEc1LeZYS3QAA==", + "dev": true, + "license": "Apache-2.0" + }, + "node_modules/protobufjs": { + "version": "7.6.6", + "resolved": "https://registry.npmjs.org/protobufjs/-/protobufjs-7.6.6.tgz", + "integrity": "sha512-dYDWdjSl5RNb7SgPxGQcRU+GtvP7s2fpkrY0r432PcOIaZ0/rBcxEZnQN67iJhFuQiVw754JDoPruPCNdGsbjg==", + "dev": true, + "hasInstallScript": true, + "license": "BSD-3-Clause", + "dependencies": { + "@protobufjs/aspromise": "^1.1.2", + "@protobufjs/base64": "^1.1.2", + "@protobufjs/codegen": "^2.0.5", + "@protobufjs/eventemitter": "^1.1.1", + "@protobufjs/fetch": "^1.1.1", + "@protobufjs/float": "^1.0.2", + "@protobufjs/path": "^1.1.2", + "@protobufjs/pool": "^1.1.0", + "@protobufjs/utf8": "^1.1.1", + "@types/node": ">=13.7.0", + "long": "^5.3.2" + }, + "engines": { + "node": ">=12.0.0" + } + }, + "node_modules/require-directory": { + "version": "2.1.1", + "resolved": "https://registry.npmjs.org/require-directory/-/require-directory-2.1.1.tgz", + "integrity": "sha512-fGxEI7+wsG9xrvdjsrlmL22OMTTiHRwAMroiEeMgq8gzoLC/PQr7RsRDSTLUg/bZAZtF+TVIkHc6/4RIKrui+Q==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/string-width": { + "version": "4.2.3", + "resolved": "https://registry.npmjs.org/string-width/-/string-width-4.2.3.tgz", + "integrity": "sha512-wKyQRQpjJ0sIp62ErSZdGsjMJWsap5oRNihHhu6G7JVO/9jIB6UyevL+tXuOqrng8j/cxKTWyWUwvSTriiZz/g==", + "dev": true, + "license": "MIT", + "dependencies": { + "emoji-regex": "^8.0.0", + "is-fullwidth-code-point": "^3.0.0", + "strip-ansi": "^6.0.1" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/strip-ansi": { + "version": "6.0.1", + "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-6.0.1.tgz", + "integrity": "sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A==", + "dev": true, + "license": "MIT", + "dependencies": { + "ansi-regex": "^5.0.1" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/typescript": { + "version": "5.9.3", + "resolved": "https://registry.npmjs.org/typescript/-/typescript-5.9.3.tgz", + "integrity": "sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw==", + "dev": true, + "license": "Apache-2.0", + "bin": { + "tsc": "bin/tsc", + "tsserver": "bin/tsserver" + }, + "engines": { + "node": ">=14.17" + } + }, + "node_modules/undici-types": { + "version": "6.21.0", + "resolved": "https://registry.npmjs.org/undici-types/-/undici-types-6.21.0.tgz", + "integrity": "sha512-iwDZqg0QAGrg9Rav5H4n0M64c3mkR59cJ6wQp+7C4nI0gsmExaedaYLNO44eT4AtBBwjbTiGPMlt2Md0T9H9JQ==", + "dev": true, + "license": "MIT" + }, + "node_modules/uuid": { + "version": "11.1.1", + "resolved": "https://registry.npmjs.org/uuid/-/uuid-11.1.1.tgz", + "integrity": "sha512-vIYxrBCC/N/K+Js3qSN88go7kIfNPssr/hHCesKCQNAjmgvYS2oqr69kIufEG+O4+PfezOH4EbIeHCfFov8ZgQ==", + "dev": true, + "funding": [ + "https://github.com/sponsors/broofa", + "https://github.com/sponsors/ctavan" + ], + "license": "MIT", + "bin": { + "uuid": "dist/esm/bin/uuid" + } + }, + "node_modules/wrap-ansi": { + "version": "7.0.0", + "resolved": "https://registry.npmjs.org/wrap-ansi/-/wrap-ansi-7.0.0.tgz", + "integrity": "sha512-YVGIj2kamLSTxw6NsZjoBxfSwsn0ycdesmc4p+Q21c5zPuZ1pl+NfxVdxPtdHvmNVOQ6XSYG4AUtyt/Fi7D16Q==", + "dev": true, + "license": "MIT", + "dependencies": { + "ansi-styles": "^4.0.0", + "string-width": "^4.1.0", + "strip-ansi": "^6.0.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/chalk/wrap-ansi?sponsor=1" + } + }, + "node_modules/y18n": { + "version": "5.0.8", + "resolved": "https://registry.npmjs.org/y18n/-/y18n-5.0.8.tgz", + "integrity": "sha512-0pfFzegeDWJHJIAmTLRP2DwHjdF5s7jo9tuztdQxAhINCdvS+3nGINqPd00AphqJR/0LhANUS6/+7SCb98YOfA==", + "dev": true, + "license": "ISC", + "engines": { + "node": ">=10" + } + }, + "node_modules/yargs": { + "version": "17.7.3", + "resolved": "https://registry.npmjs.org/yargs/-/yargs-17.7.3.tgz", + "integrity": "sha512-GZtjxm/J/4TSxuL3FNYjCmLktBTnIw/rVmKSIyKeYAZpmJB2ig9VauCC5xsa82GNKVKDAqpOn3KVzNt0zmrU0g==", + "dev": true, + "license": "MIT", + "dependencies": { + "cliui": "^8.0.1", + "escalade": "^3.1.1", + "get-caller-file": "^2.0.5", + "require-directory": "^2.1.1", + "string-width": "^4.2.3", + "y18n": "^5.0.5", + "yargs-parser": "^21.1.1" + }, + "engines": { + "node": ">=12" + } + }, + "node_modules/yargs-parser": { + "version": "21.1.1", + "resolved": "https://registry.npmjs.org/yargs-parser/-/yargs-parser-21.1.1.tgz", + "integrity": "sha512-tVpsJW7DdjecAiFpbIB1e3qxIQsE6NoPc5/eTdrbbIC4h0LVsWhnoa3g+m2HclBIujHzsxZ4VJVA+GUuc2/LBw==", + "dev": true, + "license": "ISC", + "engines": { + "node": ">=12" + } + } + } +} diff --git a/examples/sdk/fitracer-typescript/package.json b/examples/sdk/fitracer-typescript/package.json new file mode 100644 index 000000000..78d03737a --- /dev/null +++ b/examples/sdk/fitracer-typescript/package.json @@ -0,0 +1,16 @@ +{ + "name": "fitracer-typescript-doc-test", + "private": true, + "version": "0.0.0", + "description": "Offline executable tests for the TypeScript FITracer guide", + "scripts": { + "test": "node --test snippet.test.cjs" + }, + "devDependencies": { + "@opentelemetry/api": "1.9.0", + "@opentelemetry/context-async-hooks": "2.12.0", + "@traceai/fi-core": "1.1.0", + "@types/node": "22.15.29", + "typescript": "5.9.3" + } +} diff --git a/examples/sdk/fitracer-typescript/snippet.test.cjs b/examples/sdk/fitracer-typescript/snippet.test.cjs new file mode 100644 index 000000000..334ab5933 --- /dev/null +++ b/examples/sdk/fitracer-typescript/snippet.test.cjs @@ -0,0 +1,188 @@ +const assert = require('node:assert/strict'); +const { mkdtempSync, readFileSync, rmSync, writeFileSync } = require('node:fs'); +const http = require('node:http'); +const { join, resolve } = require('node:path'); +const { setTimeout: delay } = require('node:timers/promises'); +const { test } = require('node:test'); +const ts = require('typescript'); +const { context, trace } = require('@opentelemetry/api'); +const { setSession, setUser, setMetadata, setTags } = require('@traceai/fi-core'); + +const page = resolve(__dirname, '../../../src/pages/docs/sdk/tracing/fitracer.mdx'); +const attrs = (entries = []) => Object.fromEntries(entries.map(({ key, value }) => [ + key, value.stringValue ?? value.arrayValue?.values.map(v => v.stringValue), +])); + +// No vendor calls or credentials: the published exporter sends real OTLP to loopback. +// Run under the OS network sandbox in addition to this test-only endpoint configuration. +test('TypeScript guide exports contextual, private, completed spans', async (t) => { + const tab = readFileSync(page, 'utf8').split('')[1].split('')[0]; + const blocks = [...tab.matchAll(/```typescript\n([\s\S]*?)```/g)]; + assert.equal(blocks.length, 1, 'test the complete customer-facing example'); + const source = blocks[0][1].replace(/^ /gm, ''); + assert.equal(source.match(/void main\(\);/g)?.length, 1); + + const temp = mkdtempSync(join(__dirname, '.snippet-')); + t.after(() => rmSync(temp, { recursive: true, force: true })); + const filename = join(temp, 'example.ts'); + writeFileSync(filename, source); + const options = { + target: ts.ScriptTarget.ES2022, + module: ts.ModuleKind.Node16, + moduleResolution: ts.ModuleResolutionKind.Node16, + strict: true, + skipLibCheck: true, + noEmit: true, + types: ['node'], + }; + const program = ts.createProgram([filename], options); + const diagnostics = ts.getPreEmitDiagnostics(program); + assert.equal(diagnostics.length, 0, ts.formatDiagnostics(diagnostics, { + getCurrentDirectory: () => __dirname, + getCanonicalFileName: f => f, + getNewLine: () => '\n', + })); + + const requests = []; + const server = http.createServer((req, res) => { + const chunks = []; + req.on('data', chunk => chunks.push(chunk)); + req.on('end', () => { + requests.push({ path: req.url, headers: req.headers, body: Buffer.concat(chunks).toString() }); + res.writeHead(200, { 'content-type': 'application/json' }); + res.end('{}'); + }); + }); + await new Promise(resolve => server.listen(0, '127.0.0.1', resolve)); + t.after(() => new Promise(resolve => server.close(resolve))); + // Do not consume ambient credentials, privacy flags, or OTLP endpoints. + const saved = {}; + for (const key of Object.keys(process.env)) { + if (/^(FI_|OTEL_)/.test(key)) { + saved[key] = process.env[key]; + delete process.env[key]; + } + } + process.env.FI_BASE_URL = `http://127.0.0.1:${server.address().port}`; + process.env.FI_API_KEY = 'synthetic-api-key'; + process.env.FI_SECRET_KEY = 'synthetic-secret-key'; + t.after(() => { + for (const key of Object.keys(process.env)) if (/^(FI_|OTEL_)/.test(key)) delete process.env[key]; + Object.assign(process.env, saved); + }); + + // Keep the snippet intact, except expose its entry point rather than auto-running it. + const loadable = source.replace('void main();', 'export { main, getPolicy, provider, tracer, contextManager };'); + const compiled = ts.transpileModule(loadable, { + compilerOptions: { target: ts.ScriptTarget.ES2022, module: ts.ModuleKind.CommonJS }, + }).outputText; + const executable = join(temp, 'example.cjs'); + writeFileSync(executable, compiled); + const { main, getPolicy, provider, tracer, contextManager } = require(executable); + t.after(async () => { + await provider.shutdown(); + contextManager.disable(); + context.disable(); + trace.disable(); + }); + + function wireSpans() { + return requests.flatMap(request => { + assert.equal(request.path, '/tracer/v1/traces'); + assert.match(request.headers['content-type'], /application\/json/); + assert.equal(request.headers['x-api-key'], 'synthetic-api-key'); + assert.equal(request.headers['x-secret-key'], 'synthetic-secret-key'); + return JSON.parse(request.body).resourceSpans.flatMap(resource => { + assert.equal(attrs(resource.resource.attributes).project_name, 'my-project'); + return resource.scopeSpans.flatMap(scope => scope.spans); + }); + }); + } + function requestContext(id) { + return setUser(setSession(context.active(), { sessionId: `sess-${id}` }), { userId: `user-${id}` }); + } + + await t.test('old raw-tracer pattern loses attributes, bypasses privacy, and leaks unfinished work', async () => { + const raw = provider.getTracer('old-guide'); + context.with(requestContext('raw'), () => { + raw.startActiveSpan('old-success', span => { + span.setAttribute('input.value', 'synthetic private input'); + span.end(); + }); + assert.throws(() => raw.startActiveSpan('old-error', () => { + throw new Error('synthetic failure before span.end'); + }), /synthetic failure/); + }); + await provider.forceFlush(); + const spans = wireSpans(); + assert.equal(spans.length, 1); + assert.equal(attrs(spans[0].attributes)['session.id'], undefined); + assert.equal(attrs(spans[0].attributes)['user.id'], undefined); + assert.equal(attrs(spans[0].attributes)['input.value'], 'synthetic private input'); + }); + + await t.test('concurrent async requests preserve parentage and isolate context', async () => { + const start = wireSpans().length; + await Promise.all(['a', 'b'].map(id => context.with( + setTags(setMetadata(requestContext(id), { route: 'policies' }), ['custom']), + () => tracer.startActiveSpan(`request-${id}`, async parent => { + try { + await delay(5); + assert.equal(trace.getActiveSpan().spanContext().spanId, parent.spanContext().spanId); + assert.equal(await getPolicy('returns'), 'Returns are accepted within 30 days.'); + } finally { + parent.end(); + } + }), + ))); + await provider.forceFlush(); + const spans = wireSpans().slice(start); + assert.equal(spans.length, 4, 'one parent and one child per request, no duplicate spans'); + for (const id of ['a', 'b']) { + const parent = spans.find(span => span.name === `request-${id}`); + const child = spans.find(span => span.name === 'get-policy' && span.traceId === parent.traceId); + assert.equal(child.parentSpanId, parent.spanId); + assert.equal(child.status.code, 1); + assert.ok(BigInt(child.endTimeUnixNano) >= BigInt(child.startTimeUnixNano)); + const attributes = attrs(child.attributes); + assert.equal(attributes['session.id'], `sess-${id}`); + assert.equal(attributes['user.id'], `user-${id}`); + assert.equal(attributes['gen_ai.span.kind'], 'TOOL'); + assert.equal(attributes['input.value'], '__REDACTED__'); + assert.equal(attributes['output.value'], '__REDACTED__'); + assert.equal(attributes.metadata, JSON.stringify({ route: 'policies' })); + assert.deepEqual(JSON.parse(attributes['tag.tags']), ['custom']); + } + assert.notEqual(spans.find(s => s.name === 'request-a').traceId, spans.find(s => s.name === 'request-b').traceId); + assert.equal(trace.getActiveSpan(), undefined); + }); + + await t.test('failed awaited work is rethrown and exports one private error span', async () => { + const start = wireSpans().length; + await assert.rejects(context.with(requestContext('error'), () => getPolicy('unknown')), /Unknown policy topic/); + await provider.forceFlush(); + const spans = wireSpans().slice(start); + assert.equal(spans.length, 1); + const span = spans[0]; + assert.equal(span.name, 'get-policy'); + assert.equal(span.status.code, 2); + assert.ok(!span.status.message); + assert.equal(attrs(span.attributes)['error.type'], 'Error'); + assert.equal(attrs(span.attributes)['session.id'], 'sess-error'); + assert.equal(attrs(span.attributes)['input.value'], '__REDACTED__'); + assert.equal(span.events.length, 1); + assert.equal(span.events[0].name, 'exception'); + assert.deepEqual(attrs(span.events[0].attributes), { 'exception.type': 'Error' }); + assert.ok(!JSON.stringify(span).includes('Unknown policy topic')); + assert.ok(BigInt(span.endTimeUnixNano) > 0n); + }); + + await t.test('the full documented entry point flushes before exit', async () => { + const start = wireSpans().length; + await main(); + const spans = wireSpans().slice(start); + assert.equal(spans.length, 1); + assert.equal(attrs(spans[0].attributes)['session.id'], 'sess-123'); + assert.equal(attrs(spans[0].attributes)['user.id'], 'user-456'); + }); +}); diff --git a/src/pages/docs/sdk/tracing/fitracer.mdx b/src/pages/docs/sdk/tracing/fitracer.mdx index c4fc9c5d2..61ab29216 100644 --- a/src/pages/docs/sdk/tracing/fitracer.mdx +++ b/src/pages/docs/sdk/tracing/fitracer.mdx @@ -86,69 +86,107 @@ All languages share the same span kinds: ``` - TypeScript uses OpenTelemetry's standard `startActiveSpan` pattern: + Wrap your provider's tracer with `FITracer` to apply context attributes and privacy settings to custom spans. `startActiveSpan` uses OpenTelemetry's callback pattern; await your work and end the span in `finally`, including when the work fails. - ```typescript - import { trace } from "@opentelemetry/api"; + For a Node.js application, install the packages below and set `FI_API_KEY` and `FI_SECRET_KEY` as described in [Set up tracing](/docs/sdk/tracing/set-up-tracing). This example uses `@traceai/fi-core` 1.1.0 or later and OpenTelemetry 2.x. - const tracer = trace.getTracer("my-app"); + ```bash + npm install "@traceai/fi-core@^1.1.0" "@opentelemetry/api@^1.9.0" "@opentelemetry/context-async-hooks@^2.0.1" + ``` - // Manual span creation - tracer.startActiveSpan("rag-pipeline", (span) => { - span.setAttribute("gen_ai.span.kind", "CHAIN"); - span.setAttribute("input.value", question); + ```typescript + import { context, SpanStatusCode } from "@opentelemetry/api"; + import { AsyncLocalStorageContextManager } from "@opentelemetry/context-async-hooks"; + import { FITracer, ProjectType, register, setSession, setUser } from "@traceai/fi-core"; + + // Initialize once at application startup, before handling requests. + const contextManager = new AsyncLocalStorageContextManager().enable(); + context.setGlobalContextManager(contextManager); + const provider = register({ + projectName: "my-project", + projectType: ProjectType.OBSERVE, + }); + const tracer = new FITracer({ + tracer: provider.getTracer("my-app"), + traceConfig: { hideInputs: true, hideOutputs: true, hideErrorDetails: true }, + }); - const docs = retrieve(question); - const result = generate(question, docs); + async function getPolicy(topic: string): Promise { + return tracer.startActiveSpan("get-policy", async (span) => { + try { + span.setAttribute("gen_ai.span.kind", "TOOL"); + span.setAttribute("input.value", topic); + + const policies = new Map([["returns", "Returns are accepted within 30 days."]]); + const policy = await Promise.resolve(policies.get(topic)); + if (!policy) throw new Error("Unknown policy topic"); + + span.setAttribute("output.value", policy); + span.setStatus({ code: SpanStatusCode.OK }); + return policy; + } catch (error) { + span.recordException(error instanceof Error ? error : String(error)); + span.setStatus({ code: SpanStatusCode.ERROR }); + throw error; + } finally { + span.end(); + } + }); + } - span.setAttribute("output.value", result); - span.end(); - return result; - }); + async function main() { + const requestContext = setUser( + setSession(context.active(), { sessionId: "sess-123" }), + { userId: "user-456" }, + ); + try { + const policy = await context.with(requestContext, () => getPolicy("returns")); + console.log(policy); + } finally { + // Flush and close the exporter when this short-lived script finishes. + await provider.shutdown(); + contextManager.disable(); + } + } + + void main(); ``` - Context management functions let you set session, user, and metadata: + In Future AGI, open **my-project** and inspect the `get-policy` span. It has `session.id` and `user.id`, while input, output, and error text are hidden by the example's privacy settings. Change those settings only for content you intend to collect. If the lookup fails, the span records the failure and the caller still receives the error. - ```typescript - import { - setSession, setUser, setMetadata, setTags, - getAttributesFromContext - } from "@traceai/fi-core"; - import { context } from "@opentelemetry/api"; - - const ctx = setSession(context.active(), { sessionId: "sess-123" }); - const ctx2 = setUser(ctx, { userId: "user-456" }); - - context.with(ctx2, () => { - // All spans created here inherit session and user - tracer.startActiveSpan("operation", (span) => { - // span automatically gets session.id and user.id - span.end(); - }); - }); - ``` + `setSession`, `setUser`, `setMetadata`, and `setTags` return a context containing the values you supply. Activate that context with `context.with`. **Spans created through `FITracer.startActiveSpan`** copy those values into span attributes, including across awaited work when a context manager is enabled. Raw OpenTelemetry spans do not automatically copy these attributes or apply `FITracer` masking. + + + If your application already has an OpenTelemetry provider and context manager, reuse them instead of initializing another pair. Wrap the existing provider's tracer with `FITracer`. In a server, shut down the provider only when the application exits, not after each request. + - Java offers both lambda-based and manual span creation: + Java offers both lambda-based and manual span creation. First initialize `TraceAI` using the Java example in [Register a tracer provider](/docs/sdk/tracing/register). The `trace` callback takes no arguments; use `Span.current()` inside it to access the active span. ```java import ai.traceai.FITracer; import ai.traceai.FISpanKind; + import ai.traceai.TraceAI; + import io.opentelemetry.api.trace.Span; + import java.util.List; FITracer tracer = TraceAI.getTracer(); // Lambda-based - auto-manages span lifecycle - String result = tracer.trace("rag-pipeline", FISpanKind.CHAIN, (span) -> { + String result = tracer.trace("rag-pipeline", FISpanKind.CHAIN, () -> { + Span span = Span.current(); tracer.setInputValue(span, question); - String docs = tracer.trace("retrieve", FISpanKind.RETRIEVER, (rSpan) -> { + String docs = tracer.trace("retrieve", FISpanKind.RETRIEVER, () -> { + Span rSpan = Span.current(); tracer.setInputValue(rSpan, question); var retrieved = vectorDb.search(question); tracer.setOutputValue(rSpan, tracer.toJson(retrieved)); return retrieved; }); - String answer = tracer.trace("generate", FISpanKind.LLM, (lSpan) -> { + String answer = tracer.trace("generate", FISpanKind.LLM, () -> { + Span lSpan = Span.current(); tracer.setInputMessages(lSpan, List.of( tracer.message("system", "Answer using the context."), tracer.message("user", question) @@ -170,7 +208,7 @@ All languages share the same span kinds: ```java import io.opentelemetry.api.trace.Span; - import io.opentelemetry.context.Context; + import io.opentelemetry.api.trace.StatusCode; Span span = tracer.startSpan("tool-call", FISpanKind.TOOL); try {