Fiberplane OpenTelemetry Trace Collector on ValTown

\n Visit /fp to view the Fiberplane API explorer.\n

\n\n\n\n`.trim());\n});\n\nexport default app;",[],[155,184],{"_108":193,"_100":194,"_156":195,"_158":157,"_159":143,"_160":196,"_162":123,"_110":197,"_105":198,"_164":178,"_166":199,"_167":27,"_168":-5,"_169":200,"_103":201},"35479f96-f679-11ef-a77c-569c3dd06744","traces.ts","4340ac56-f669-11ef-97cc-569c3dd06744",261,["D",1740818591704],9,"import * as schema from \"../db/schema.ts\";\nimport { and, desc, relations, sql } from \"../deps/drizzle.ts\";\nimport { Hono } from \"../deps/hono.ts\";\nimport { logger } from \"../logger.ts\";\nimport { OtelSpanSchema } from \"../otel/schemas.ts\";\nimport { transformExport } from \"../otel/transformExport.ts\";\nimport type { IExportTraceServiceRequest } from \"../otel/types.ts\";\nimport { authenticate } from \"./auth.ts\";\nimport type { AppType, TraceDetailSpansResponse, TraceListResponse } from \"./types.ts\";\n\nconst app = new Hono();\n\n/**\n * Set up token based authentication for all tracing routes\n */\napp.use(authenticate);\n\n/**\n * Fetch all traces.\n *\n * Limits response to 1000 most recent spans\n *\n * @TODO - Move grouping logic to sql query, similar to the otel-worker\n */\napp.get(\"/\", async ctx => {\n const db = ctx.get(\"db\");\n\n const spans = await db.query.otelSpans.findMany({\n where: sql`inner->>'scope_name' = 'fpx-tracer'`,\n orderBy: desc(sql`inner->>'end_time'`),\n limit: 1000,\n });\n\n const traceMap = new Map>();\n for (const span of spans) {\n const traceId = span.inner.trace_id;\n if (!traceId) {\n continue;\n }\n if (!traceMap.has(traceId)) {\n traceMap.set(traceId, []);\n }\n traceMap.get(traceId)?.push(span);\n }\n\n const traces = Array.from(traceMap.entries()).map(([traceId, spans]) => ({\n traceId,\n spans,\n }));\n\n const response: TraceListResponse = traces.map(({ traceId, spans }) => ({\n traceId,\n spans: spans.map(({ inner }) => OtelSpanSchema.parse(inner)),\n }));\n\n return ctx.json(response);\n});\n\n/**\n * Fetch all spans for a given trace.\n *\n * @TODO - Use similar sql query as the otel-worker\n */\napp.get(\"/:traceId/spans\", async ctx => {\n const traceId = ctx.req.param(\"traceId\");\n\n const db = ctx.get(\"db\");\n const traces = await db\n .select()\n .from(otelSpans)\n .where(\n and(\n sql`inner->>'scope_name' = 'fpx-tracer'`,\n sql`inner->>'trace_id' = ${traceId}`,\n ),\n );\n\n const response: TraceDetailSpansResponse = traces.map(({ inner }) => OtelSpanSchema.parse(inner));\n\n return ctx.json(response);\n});\n\n/**\n * Expects a JSON payload from @fiberplane/hono-otel\n */\napp.post(\"/\", async (ctx) => {\n const db = ctx.get(\"db\");\n const body: IExportTraceServiceRequest = await ctx.req.json();\n\n try {\n const tracesPayload = (await transformExport(body)).map(\n (span) =>\n ({\n inner: OtelSpanSchema.parse(span),\n spanId: span.span_id,\n traceId: span.trace_id,\n }) satisfies typeof schema.otelSpans.$inferInsert,\n );\n\n try {\n if (tracesPayload.length > 0) {\n await db.insert(schema.otelSpans).values(tracesPayload);\n }\n } catch (error) {\n logger.error(\"Error inserting trace\", error);\n return ctx.text(\"Error inserting trace\", 500);\n }\n\n return ctx.text(\"OK\");\n } catch (error) {\n logger.error(\"Error parsing trace data\", error);\n return ctx.text(\"Error parsing trace data\", 400);\n }\n});\n\nexport default app;",[],[155,194],{"_108":203,"_100":204,"_156":205,"_158":157,"_159":143,"_160":142,"_162":123,"_110":206,"_105":207,"_164":178,"_166":208,"_167":27,"_168":-5,"_169":209,"_103":210},"db9fedfc-f6a2-11ef-a502-569c3dd06744","types.ts","969af970-f663-11ef-b4b9-569c3dd06744",["D",1740836480150],16,"import type {\n TraceDetailSpansResponse,\n TraceListResponse,\n} from \"../deps/fiberplane.ts\";\nimport type { MiddlewareHandler } from \"../deps/hono.ts\";\nimport type { DBType } from \"../db/types.ts\";\n\n/**\n * Our Hono app type\n * \n * Optimisitically types the values we expect in our environment and context:\n *\n * - `Bindings` determines env vars, accessed via `c.env.NAME_OF_VAR` in api handlers\n * - `Variables` determines context vars, accessed via `c.get(\"NAME_OF_VAR\")` in api handlers\n */\nexport type AppType = {\n Bindings: {\n /**\n * Bearer token used to authenticate requests\n */\n AUTH_TOKEN: string;\n };\n Variables: {\n db: DBType;\n };\n};\n\nexport type AppMiddleware = MiddlewareHandler;\n\nexport type { TraceDetailSpansResponse, TraceListResponse };",[],[155,204],[155],{"_108":213,"_100":104,"_156":214,"_158":-5,"_159":143,"_160":177,"_162":123,"_110":215,"_105":126,"_164":165,"_166":-5,"_167":27,"_168":-5,"_169":216,"_103":276},"9cbeff30-f65a-11ef-9281-569c3dd06744","9a42da06-f65a-11ef-b0ab-569c3dd06744",["D",1740805450893],[217,227,237,247,257,267],{"_108":218,"_100":219,"_156":220,"_158":214,"_159":143,"_160":221,"_162":123,"_110":222,"_105":223,"_164":178,"_166":224,"_167":27,"_168":-5,"_169":225,"_103":226},"2cecd774-f667-11ef-afd0-569c3dd06744","client.ts","18435d20-f65d-11ef-9799-569c3dd06744",174,["D",1740810846746],7,"import { sqlite } from \"https://esm.town/v/std/sqlite\";\nimport { drizzle } from \"../deps/drizzle.ts\";\nimport * as schema from \"./schema.ts\";\nimport type { DBType } from \"./types.ts\";\n\n/**\n * The typed database client, allowing us to construct sql queries and\n * use Drizzle's ORM features against the ValTown sqlite database\n */\nexport const db: DBType = drizzle(sqlite as any, {\n schema,\n});",[],[104,219],{"_108":228,"_100":229,"_156":230,"_158":214,"_159":143,"_160":231,"_162":123,"_110":232,"_105":233,"_164":178,"_166":234,"_167":27,"_168":-5,"_169":235,"_103":236},"06742192-f667-11ef-a5e2-569c3dd06744","constants.ts","0282266c-f660-11ef-b120-569c3dd06744",173,["D",1740810782202],3,"/**\n * Since we can't rely on drizzle-kit to generate and apply migrations,\n * we centralize the table name for spans here, to reference it in both \n * the `schema.ts` file and the `migrate.ts` file.\n */\nexport const SPAN_TABLE_NAME = \"otel_spans\";",[],[104,229],{"_108":238,"_100":239,"_156":240,"_158":214,"_159":143,"_160":241,"_162":123,"_110":242,"_105":243,"_164":178,"_166":244,"_167":27,"_168":-5,"_169":245,"_103":246},"fb07b1ce-f662-11ef-a384-569c3dd06744","migrate.ts","91ab864e-f65b-11ef-991f-569c3dd06744",115,["D",1740809045049],6,"import { sqlite } from \"https://esm.town/v/std/sqlite\";\nimport { SPAN_TABLE_NAME } from \"./constants.ts\";\n\n/**\n * @NOTE - It is not straightforward how to use drizzle-kit to generate and apply migrations on ValTown\n * For this reason, we need to manually create the span table.\n *\n * @TODO - Add `start_time` and `end_time` columns\n */\nexport const migrateDatabase = async () => {\n await sqlite.execute(`\nCREATE TABLE IF NOT EXISTS \\`${SPAN_TABLE_NAME}\\` (\n \\`inner\\` text NOT NULL,\n\t\\`span_id\\` text NOT NULL,\n\t\\`trace_id\\` text NOT NULL\n);\n`);\n};",[],[104,239],{"_108":248,"_100":249,"_156":250,"_158":214,"_159":143,"_160":251,"_162":123,"_110":252,"_105":253,"_164":178,"_166":254,"_167":27,"_168":-5,"_169":255,"_103":256},"f7797bfa-f662-11ef-8dca-569c3dd06744","queries.ts","3445b1cc-f661-11ef-82f2-569c3dd06744",114,["D",1740809039083],4,"import type { DBType } from \"./types.ts\";\n\n/**\n * NOT IN USE\n *\n * @TODO - Implement query helper for grouping spans by trace_id and sorting by end_time\n *\n * @TODO - Need to implement `end_time` column for this query to work\n */\nexport function findTraces(db: DBType) {\n const REFERENCE QUERY = `\nSELECT trace_id, MAX(end_time) as end_time\nFROM spans\n{where_clause}\nGROUP BY trace_id\nORDER BY end_time DESC\nLIMIT {limit}\n`;\n}",[],[104,249],{"_108":258,"_100":259,"_156":260,"_158":214,"_159":143,"_160":261,"_162":123,"_110":262,"_105":263,"_164":178,"_166":264,"_167":27,"_168":-5,"_169":265,"_103":266},"524e2984-f6a1-11ef-aa65-569c3dd06744","schema.ts","a0be8c54-f65a-11ef-9281-569c3dd06744",276,["D",1740835820270],10,"import { integer, sqliteTable, text } from \"../deps/drizzle.ts\";\nimport { SPAN_TABLE_NAME } from \"./constants.ts\";\nimport { OtelSpan } from \"../otel/schemas.ts\";\n\nexport const otelSpans = sqliteTable(SPAN_TABLE_NAME, {\n inner: text(\"inner\", { mode: \"json\" }).$type().notNull(),\n spanId: text(\"span_id\").notNull(),\n traceId: text(\"trace_id\").notNull(),\n});",[],[104,259],{"_108":268,"_100":204,"_156":269,"_158":214,"_159":143,"_160":270,"_162":123,"_110":271,"_105":272,"_164":178,"_166":273,"_167":27,"_168":-5,"_169":274,"_103":275},"d4100252-f666-11ef-a600-569c3dd06744","f7b0986c-f65b-11ef-9265-569c3dd06744",172,["D",1740810697660],5,"import type { LibSQLDatabase } from \"../deps/drizzle.ts\";\nimport type * as schema from \"./schema\";\n\nexport type DBType = LibSQLDatabase;",[],[104,204],[104],{"_108":278,"_100":279,"_156":280,"_158":-5,"_159":143,"_160":281,"_162":123,"_110":282,"_105":126,"_164":165,"_166":-5,"_167":27,"_168":-5,"_169":283,"_103":311},"ce734080-f665-11ef-8cf9-569c3dd06744","deps","cbb2c0fa-f665-11ef-9ae5-569c3dd06744",153,["D",1740810258747],[284,293,302],{"_108":285,"_100":286,"_156":287,"_158":280,"_159":143,"_160":288,"_162":123,"_110":289,"_105":223,"_164":178,"_166":290,"_167":27,"_168":-5,"_169":291,"_103":292},"7d57442a-f666-11ef-9e63-569c3dd06744","drizzle.ts","dea14cc2-f665-11ef-950d-569c3dd06744",169,["D",1740810552164],"// Import drizzle deps with npm: specifier because exports don't get picked up properly by typescript when using esm.sh\nimport { drizzle, type LibSQLDatabase } from \"npm:drizzle-orm@0.39.3/libsql\";\nimport { and, desc, relations, sql } from \"npm:drizzle-orm@0.39.3\";\nimport { integer, sqliteTable, text } from \"npm:drizzle-orm@0.39.3/sqlite-core\";\n\nexport { drizzle };\nexport type { LibSQLDatabase };\nexport { and, desc, relations, sql };\nexport { integer, sqliteTable, text };",[],[279,286],{"_108":294,"_100":295,"_156":296,"_158":280,"_159":143,"_160":297,"_162":123,"_110":298,"_105":243,"_164":178,"_166":299,"_167":27,"_168":-5,"_169":300,"_103":301},"01d614ba-f66c-11ef-b844-569c3dd06744","fiberplane.ts","f4da52f4-f66a-11ef-99d2-569c3dd06744",219,["D",1740812921933],"// NOTE - Import fpx-types with `npm:` specified because exports don't _seem_ to\n// get picked up properly by typescript when using esm.sh\nimport {\n type OtelSpan,\n OtelSpanSchema,\n type TraceDetailSpansResponse,\n type TraceListResponse,\n} from \"npm:@fiberplane/fpx-types@0.0.13\";\n\nimport { createFiberplane } from \"https://esm.sh/@fiberplane/hono@0.4.4\";\n\nexport { OtelSpanSchema };\nexport type { OtelSpan, TraceDetailSpansResponse, TraceListResponse };\nexport { createFiberplane };",[],[279,295],{"_108":303,"_100":304,"_156":305,"_158":280,"_159":143,"_160":306,"_162":123,"_110":307,"_105":272,"_164":178,"_166":308,"_167":27,"_168":-5,"_169":309,"_103":310},"861b4dbc-f667-11ef-b307-569c3dd06744","hono.ts","60d5cb7e-f665-11ef-a5af-569c3dd06744",175,["D",1740810996367],"/**\n * Module that centralizes all Hono deps, to avoid using multiple imports of the library\n *\n * \"Why?\", you might ask.\n *\n * Well, Hono's type system freaks out if you import it multiple times,\n * so this avoids the case where one file accidentally imports a different version \n * (from esm.sh or npm)\n */\n\nimport { Hono, type MiddlewareHandler } from \"https://esm.sh/hono@4.7.0\";\nimport { cors } from \"https://esm.sh/hono@4.7.0/cors\";\nimport { HTTPException } from \"https://esm.sh/hono@4.7.0/http-exception\";\n\nexport { Hono, cors, type MiddlewareHandler, HTTPException };",[],[279,304],[279],{"_108":313,"_100":314,"_156":315,"_158":-5,"_159":143,"_160":316,"_162":123,"_110":317,"_105":126,"_164":165,"_166":-5,"_167":27,"_168":-5,"_169":318,"_103":346},"5862d856-f660-11ef-8789-569c3dd06744","otel","55ff6bba-f660-11ef-8e91-569c3dd06744",96,["D",1740807913185],[319,328,337],{"_108":320,"_100":321,"_156":322,"_158":315,"_159":143,"_160":323,"_162":123,"_110":324,"_105":253,"_164":178,"_166":325,"_167":27,"_168":-5,"_169":326,"_103":327},"326df9a8-f66c-11ef-a80f-569c3dd06744","schemas.ts","5d7d8e6e-f663-11ef-a6e9-569c3dd06744",223,["D",1740813003464],"// NOTE - Import fpx-types with `npm:` specified because exports don't _seem_ to\n// get picked up properly by typescript when using esm.sh\nimport { OtelSpanSchema } from \"../deps/fiberplane.ts\";\n\nexport { OtelSpanSchema };",[],[314,321],{"_108":329,"_100":330,"_156":331,"_158":315,"_159":143,"_160":332,"_162":123,"_110":333,"_105":198,"_164":178,"_166":334,"_167":27,"_168":-5,"_169":335,"_103":336},"64f9186e-f679-11ef-93b4-569c3dd06744","transformExport.ts","5c3a99c8-f660-11ef-8e90-569c3dd06744",265,["D",1740818671720],"import type {\n ESpanKind,\n EStatusCode,\n IAnyValue,\n IEvent,\n IExportTraceServiceRequest,\n IKeyValue,\n ILink,\n IStatus,\n OtelSpan,\n} from \"../types.ts\";\nimport { OtelSpanSchema } from \"./schemas.ts\";\n\n/**\n * Port of the Fiberplane rust code that transforms traces into the format we use in the Fiberplane UI.\n * (See: https://github.com/fiberplane/otel-worker)\n *\n * A few differences between this and the Rust version of the fiberplane/otel-worker:\n *\n * - The otel js library does not expose `traceFlags` or `flags` from what I can tell,\n * so that field is always blank.\n *\n * - `mapAttributes` simply returns the value, instead of an object whose key describes the attribute data type.\n * By convention, we only use string and number values. Complex values are serialized.\n */\nexport async function transformExport(\n tracesData: IExportTraceServiceRequest,\n): Promise> {\n const result: Array = [];\n\n for (const resourceSpan of tracesData.resourceSpans ?? []) {\n const resourceAttributes = resourceSpan.resource\n ? await mapAttributes(resourceSpan.resource.attributes)\n : null;\n\n for (const scopeSpan of resourceSpan.scopeSpans ?? []) {\n let scopeName: string | null = null;\n let scopeVersion: string | null = null;\n\n if (scopeSpan.scope) {\n scopeName = scopeSpan.scope.name ?? null;\n scopeVersion = scopeSpan.scope.version ?? null;\n }\n\n const scopeAttributes = scopeSpan.scope\n ? await mapAttributes(scopeSpan.scope.attributes ?? [])\n : null;\n\n for (const span of scopeSpan.spans ?? []) {\n const kind = convertToSpanKind(span.kind);\n\n const attributes = await mapAttributes(span.attributes);\n\n const startTime = new Date(Number(span.startTimeUnixNano) / 1e6);\n const endTime = new Date(Number(span.endTimeUnixNano) / 1e6);\n\n const parentSpanId = span.parentSpanId\n ? stringOrUintToString(span.parentSpanId)\n : null;\n\n const events = await Promise.all(\n span.events.map((event) => mapEvent(event)),\n );\n const links = await Promise.all(\n span.links.map((link) => mapLink(link)),\n );\n\n const traceId = stringOrUintToString(span.traceId);\n const spanId = stringOrUintToString(span.spanId);\n\n const name = span.name;\n const traceState = span.traceState;\n\n const spanInstance = OtelSpanSchema.parse(\n {\n trace_id: traceId,\n span_id: spanId,\n parent_span_id: parentSpanId,\n name,\n trace_state: traceState,\n kind,\n scope_name: scopeName,\n scope_version: scopeVersion,\n start_time: startTime,\n end_time: endTime,\n attributes,\n scope_attributes: scopeAttributes,\n resource_attributes: resourceAttributes,\n status: span.status ? mapStatus(span.status) : undefined,\n events,\n links,\n } satisfies MizuSpan,\n );\n\n result.push(spanInstance);\n }\n }\n }\n\n return result;\n}\n\ntype AttributeValuePrimitive = null | boolean | number | string | Uint8Array;\ntype AttributeValue =\n | AttributeValuePrimitive\n | AttributeValuePrimitive[]\n | Record;\n\nasync function mapAttributeValue(value: IAnyValue): Promise {\n if (!value) {\n return null;\n }\n if (value.stringValue !== undefined) {\n return value.stringValue;\n }\n if (value.boolValue !== undefined) {\n return value.boolValue;\n }\n if (value.intValue !== undefined) {\n return value.intValue;\n }\n if (value.doubleValue !== undefined) {\n return value.doubleValue;\n }\n if (value.bytesValue !== undefined) {\n return value.bytesValue;\n }\n if (value.arrayValue !== undefined) {\n // @ts-expect-error - By convention we don't actually nest values so don't need a recursive type\n return Promise.all(value.arrayValue.values.map(mapAttributeValue));\n }\n if (value.kvlistValue !== undefined) {\n // @ts-expect-error - By convention we don't actually nest values so don't need a recursive type\n return mapAttributes(value.kvlistValue.values);\n }\n return null;\n}\n\nasync function mapAttributes(\n attributes: IKeyValue[],\n): Promise> {\n const result: Record = {};\n for (const kv of attributes) {\n if (kv.key === \"exception.stacktrace\") {\n // HACK - convert stack trace if possible\n const value = kv.value ? await mapAttributeValue(kv.value) : null;\n if (typeof value === \"string\") {\n result[kv.key] = await transformStack(value);\n } else {\n result[kv.key] = value;\n }\n } else {\n result[kv.key] = kv.value ? await mapAttributeValue(kv.value) : null;\n }\n }\n\n return result;\n}\n\nasync function mapEvent(event: IEvent) {\n return {\n name: event.name,\n timestamp: new Date(Number(event.timeUnixNano) / 1e6),\n attributes: await mapAttributes(event.attributes),\n };\n}\n\nasync function mapLink(link: ILink) {\n return {\n trace_id: stringOrUintToString(link.traceId),\n span_id: stringOrUintToString(link.spanId),\n trace_state: link.traceState,\n attributes: await mapAttributes(link.attributes),\n };\n}\n\nfunction stringOrUintToString(id: string | Uint8Array) {\n return id instanceof Uint8Array\n ? Buffer.from(id).toString(\"hex\")\n : Buffer.from(id, \"hex\").toString(\"hex\");\n}\n\nfunction mapStatus(status: IStatus) {\n return {\n code: status.code,\n message: status.message ?? statusCodeToString(status.code),\n };\n}\n\nfunction statusCodeToString(statusCode: EStatusCode) {\n switch (statusCode) {\n case 0:\n return \"STATUS_CODE_UNSET\";\n case 1:\n return \"STATUS_CODE_OK\";\n case 2:\n return \"STATUS_CODE_ERROR\";\n default:\n return \"\";\n }\n}\n\n// Function to convert ESpanKind to SpanKind\nfunction convertToSpanKind(spanKind: ESpanKind): string {\n switch (spanKind) {\n case 1:\n return SpanKind.INTERNAL;\n case 2:\n return SpanKind.SERVER;\n case 3:\n return SpanKind.CLIENT;\n case 4:\n return SpanKind.PRODUCER;\n case 5:\n return SpanKind.CONSUMER;\n default:\n return \"Unspecified\";\n }\n}\n\n// NOTE - Copy-pasted\nconst SpanKind = {\n /** Default value. Indicates that the span is used internally. */\n INTERNAL: \"Internal\",\n /**\n * Indicates that the span covers server-side handling of an RPC or other\n * remote request.\n */\n SERVER: \"Server\",\n /**\n * Indicates that the span covers the client-side wrapper around an RPC or\n * other remote request.\n */\n CLIENT: \"Client\",\n /**\n * Indicates that the span describes producer sending a message to a\n * broker. Unlike client and server, there is no direct critical path latency\n * relationship between producer and consumer spans.\n */\n PRODUCER: \"Producer\",\n /**\n * Indicates that the span describes consumer receiving a message from a\n * broker. Unlike client and server, there is no direct critical path latency\n * relationship between producer and consumer spans.\n */\n CONSUMER: \"Consumer\",\n};",[],[314,330],{"_108":338,"_100":204,"_156":339,"_158":315,"_159":143,"_160":340,"_162":123,"_110":341,"_105":342,"_164":178,"_166":343,"_167":27,"_168":-5,"_169":344,"_103":345},"43f17e7c-f679-11ef-91f4-569c3dd06744","856869fc-f65a-11ef-a3bf-569c3dd06744",262,["D",1740818616306],11,"import type { OtelSpan } from \"../deps/fiberplane\";\nimport type {\n ESpanKind,\n EStatusCode,\n IAnyValue,\n IEvent,\n IExportTraceServiceRequest,\n IKeyValue,\n ILink,\n IStatus,\n} from \"https://esm.sh/@opentelemetry/otlp-transformer@0.55.0\";\n\nexport type { OtelSpan };\nexport type { ESpanKind, EStatusCode, IAnyValue, IEvent, IExportTraceServiceRequest, IKeyValue, ILink, IStatus };\nexport type {\n ESpanKind,\n EStatusCode,\n IAnyValue,\n IEvent,\n IExportTraceServiceRequest,\n IKeyValue,\n ILink,\n IStatus,\n}",[],[314,204],[314],{"_108":348,"_100":349,"_156":350,"_158":-5,"_159":143,"_160":351,"_162":123,"_110":352,"_105":353,"_164":354,"_166":355,"_167":27,"_168":-5,"_169":356,"_103":357},"6b2856cc-f69d-11ef-bb94-569c3dd06744","README.md","6605e5a0-f66c-11ef-b844-569c3dd06744",273,["D",1740834143978],14,"file","## What is this?\n\nYou're looking at a self-hosted OpenTelemetry tracing collector on ValTown, my friend!\n\nMore specifically, this is a service you can fork and run that receives traces from Hono APIs\nthat have been instrumented with `@fiberplane/hono-otel`.\n\nUnder the hood, it uses OpenTelemetry's javascript libraries to receive traces,\nthen it transforms and stores the tracing data in a sqlite db on ValTown.\n\nA Hono api exposes HTTP endpoints for receiving and querying traces,\nand we mount a Fiberplane API Playground to be able test the routes out.\n\n## Deploying this service\n\nAll you gotta do is:\n\n1. Fork this project\n2. Add a secure token to the environment variable `AUTH_TOKEN`\n\n## Connecting a Service\n\nCreate a Hono app, or fork the sample here:\n\nhttps://www.val.town/v/fiberplane/fiberplaneHonoTracingStarter\n\nThen, in your service, you'll just need to configure environment variables to point to your instance of the OpenTelemetry collector.\n\n```sh\nFIBERPLANE_OTEL_ENDPOINT=https://fiberplane--63a45c54f65a11efa403569c3dd06744.web.val.run/v1/traces\nFIBERPLANE_OTEL_TOKEN=secret-token-for-valtown-fiberplane-otel-collector\n```\n\n> The `FIBERPLANE_OTEL_TOKEN` in your connected service should be the same value that you configured as the `AUTH_TOKEN` in the collector.\n\n## Rough Edges\n\nDeno support can vary with OpenTelemetry's javascript libraries. We're working on improving things, but here are a few issues we've noticed:\n\n- Log statements are recorded twice",[],[349],{"_108":359,"_100":360,"_156":121,"_158":-5,"_159":143,"_160":361,"_162":123,"_110":362,"_105":363,"_164":364,"_166":365,"_167":27,"_168":-5,"_169":366,"_103":367},"5fd517e6-f671-11ef-9054-569c3dd06744","index.ts",259,["D",1740815227116],71,"http","import home from \"./app/home.ts\";\nimport traces from \"./app/traces.ts\";\nimport type { AppType } from \"./app/types.ts\";\nimport { db } from \"./db/client.ts\";\nimport { migrateDatabase } from \"./db/migrate.ts\";\nimport { createFiberplane } from \"./deps/fiberplane.ts\";\nimport { Hono, HTTPException } from \"./deps/hono.ts\";\nimport { getOpenAPISpec } from \"./openapi.ts\";\n\n// Migrate database on startup to make sure the proper table exists to store spans\nawait migrateDatabase();\n\nconst app = new Hono();\n\n/**\n * Middleware for setting up the database and storing it on the Hono app's context\n */\napp.use(async (ctx, next) => {\n ctx.set(\"db\", db);\n await next();\n});\n\n/** Mount the routes that handle tracing exports and queries */\napp.route(\"/v1/traces\", traces);\n\n/**\n * Mount the Fiberplane api playground\n * Visit /fp to view the UI\n */\napp.use(\n \"/fp/*\",\n createFiberplane({\n openapi: { content: JSON.stringify(getOpenAPISpec()) },\n }),\n);\n\napp.route(\"/\", home);\n\n// Unwrap and rethrow Hono errors as the original error\n// If you delete this, all errors will be \"Internal Server Error\"\napp.onError((err: unknown) => {\n if (err instanceof HTTPException) {\n return err.getResponse();\n }\n throw err;\n});\n\n/**\n * Export a function that wraps the incoming request,\n * then injects the Deno env vars into the Hono app befoe\n * executing the api entrypoint (`app.fetch`)\n */\nexport default async function(req: Request): Promise {\n const env = Deno.env.toObject();\n // NOTE - Adding the entire env object will also expose the following values to your api handlers:\n //\n // * `valtown`\n // * `VAL_TOWN_API_KEY`\n // * `VALTOWN_API_URL`\n //\n // If you don't want those values, remove them from the env object\n return app.fetch(req, env);\n}",[],[360],{"_108":369,"_100":370,"_156":371,"_158":-5,"_159":143,"_160":372,"_162":123,"_110":373,"_105":233,"_164":178,"_166":374,"_167":27,"_168":-5,"_169":375,"_103":376},"11b02446-f66e-11ef-ac05-569c3dd06744","logger.ts","342552e0-f65e-11ef-9ddd-569c3dd06744",240,["D",1740813807527],"/**\n * Logging interface, v simple\n */\nexport const logger = {\n info: console.log.bind(console),\n warn: console.warn.bind(console),\n error: console.error.bind(console),\n};",[],[370],{"_108":378,"_100":379,"_156":380,"_158":-5,"_159":143,"_160":381,"_162":123,"_110":382,"_105":198,"_164":178,"_166":383,"_167":27,"_168":-5,"_169":384,"_103":385},"6dd888f8-f66e-11ef-95b1-569c3dd06744","openapi.ts","f007451e-f65d-11ef-a23c-569c3dd06744",242,["D",1740813962142],"/**\n * A manually generated OpenAPI spec, to be able to use the Fiberplane library \n * with a better experience\n */\nexport function getOpenAPISpec() {\n return {\n openapi: \"3.0.0\",\n info: {\n title: \"Fiberplane OpenTelemetry Collector\",\n version: \"1.0.0\",\n },\n // TODO - Add auth scheme\n paths: {\n \"/v1/traces\": {\n get: {\n summary: \"Get traces\",\n description: \"Get traces\",\n responses: {\n 200: {\n description: \"OK\",\n },\n },\n },\n post: {\n summary: \"Export traces\",\n description: \"Export traces\",\n requestBody: {\n required: true,\n content: {\n \"application/json\": {\n schema: {\n /* any, for simplicity */\n type: \"object\",\n additionalProperties: true,\n },\n // This is what SHOULD allow us to easily send an example payload in the Fiberplane UI,\n // but that doesn't work right now bc there is not a valid schema definition\n // example: { ... }\n },\n },\n },\n responses: {\n 200: {\n description: \"OK\",\n },\n },\n },\n\n },\n \"/v1/traces/{traceId}/spans\": {\n get: {\n summary: \"Get spans\",\n description: \"Get spans\",\n responses: {\n 200: {\n description: \"OK\",\n },\n },\n },\n },\n },\n };\n}",[],[379],"files",[153,171,182,192,202,212,217,227,237,247,257,267,277,284,293,302,312,319,328,337,347,358,368,377],"counts",{"_390":31,"_391":126,"_392":126,"_393":126},"pulls","branches","forks","envVars","contents",[396,399,402,405,408,411],{"_108":218,"_100":219,"_156":220,"_158":214,"_159":143,"_160":221,"_162":123,"_110":397,"_105":223,"_164":178,"_166":224,"_167":27,"_168":-5,"_103":398},["D",1740810846746],[104,219],{"_108":228,"_100":229,"_156":230,"_158":214,"_159":143,"_160":231,"_162":123,"_110":400,"_105":233,"_164":178,"_166":234,"_167":27,"_168":-5,"_103":401},["D",1740810782202],[104,229],{"_108":238,"_100":239,"_156":240,"_158":214,"_159":143,"_160":241,"_162":123,"_110":403,"_105":243,"_164":178,"_166":244,"_167":27,"_168":-5,"_103":404},["D",1740809045049],[104,239],{"_108":248,"_100":249,"_156":250,"_158":214,"_159":143,"_160":251,"_162":123,"_110":406,"_105":253,"_164":178,"_166":254,"_167":27,"_168":-5,"_103":407},["D",1740809039083],[104,249],{"_108":258,"_100":259,"_156":260,"_158":214,"_159":143,"_160":261,"_162":123,"_110":409,"_105":263,"_164":178,"_166":264,"_167":27,"_168":-5,"_103":410},["D",1740835820270],[104,259],{"_108":268,"_100":204,"_156":269,"_158":214,"_159":143,"_160":270,"_162":123,"_110":412,"_105":272,"_164":178,"_166":273,"_167":27,"_168":-5,"_103":413},["D",1740810697660],[104,204],{"_108":213,"_100":104,"_156":214,"_158":-5,"_159":143,"_160":177,"_162":123,"_110":415,"_105":126,"_164":165,"_166":-5,"_167":27,"_168":-5,"_103":416},["D",1740805450893],[104],"upstreamProject","upstreamBranch","emptyEnvVars","isNew","routes/_app.x.$handle.$name.code.$",{"_98":99,"_100":101,"_102":42,"_105":-7,"_103":104,"_106":423,"_151":427,"_386":500,"_354":501,"_394":503,"_516":-5,"_517":27,"_518":-5,"_519":-5,"_520":-5,"_521":522},{"_108":109,"_100":101,"_110":424,"_112":-5,"_113":27,"_114":115,"_116":117,"_118":-5,"_12":119,"_120":121,"_122":123,"_124":-5,"_125":126,"_127":128,"_129":128,"_130":131,"_132":131,"_133":131,"_134":128,"_135":128,"_136":27,"_21":425,"_140":426},["D",1740805324568],{"_98":99,"_138":139},{"_105":142,"_100":42,"_108":143,"_144":109,"_145":-5,"_146":-5,"_147":-5,"_148":-5,"_149":101,"_150":99},[428,443,464,476,488,491,494,497],{"_108":154,"_100":155,"_156":157,"_158":-5,"_159":143,"_160":161,"_162":123,"_110":163,"_105":126,"_164":165,"_166":-5,"_167":27,"_168":-5,"_169":429,"_103":442},[430,433,436,439],{"_108":172,"_100":173,"_156":174,"_158":157,"_159":143,"_160":175,"_162":123,"_110":176,"_105":177,"_164":178,"_166":179,"_167":27,"_168":-5,"_169":431,"_103":432},[],[155,173],{"_108":183,"_100":184,"_156":185,"_158":157,"_159":143,"_160":186,"_162":123,"_110":187,"_105":188,"_164":178,"_166":189,"_167":27,"_168":-5,"_169":434,"_103":435},[],[155,184],{"_108":193,"_100":194,"_156":195,"_158":157,"_159":143,"_160":196,"_162":123,"_110":197,"_105":198,"_164":178,"_166":199,"_167":27,"_168":-5,"_169":437,"_103":438},[],[155,194],{"_108":203,"_100":204,"_156":205,"_158":157,"_159":143,"_160":142,"_162":123,"_110":206,"_105":207,"_164":178,"_166":208,"_167":27,"_168":-5,"_169":440,"_103":441},[],[155,204],[155],{"_108":213,"_100":104,"_156":214,"_158":-5,"_159":143,"_160":177,"_162":123,"_110":215,"_105":126,"_164":165,"_166":-5,"_167":27,"_168":-5,"_169":444,"_103":463},[445,448,451,454,457,460],{"_108":218,"_100":219,"_156":220,"_158":214,"_159":143,"_160":221,"_162":123,"_110":222,"_105":223,"_164":178,"_166":224,"_167":27,"_168":-5,"_169":446,"_103":447},[],[104,219],{"_108":228,"_100":229,"_156":230,"_158":214,"_159":143,"_160":231,"_162":123,"_110":232,"_105":233,"_164":178,"_166":234,"_167":27,"_168":-5,"_169":449,"_103":450},[],[104,229],{"_108":238,"_100":239,"_156":240,"_158":214,"_159":143,"_160":241,"_162":123,"_110":242,"_105":243,"_164":178,"_166":244,"_167":27,"_168":-5,"_169":452,"_103":453},[],[104,239],{"_108":248,"_100":249,"_156":250,"_158":214,"_159":143,"_160":251,"_162":123,"_110":252,"_105":253,"_164":178,"_166":254,"_167":27,"_168":-5,"_169":455,"_103":456},[],[104,249],{"_108":258,"_100":259,"_156":260,"_158":214,"_159":143,"_160":261,"_162":123,"_110":262,"_105":263,"_164":178,"_166":264,"_167":27,"_168":-5,"_169":458,"_103":459},[],[104,259],{"_108":268,"_100":204,"_156":269,"_158":214,"_159":143,"_160":270,"_162":123,"_110":271,"_105":272,"_164":178,"_166":273,"_167":27,"_168":-5,"_169":461,"_103":462},[],[104,204],[104],{"_108":278,"_100":279,"_156":280,"_158":-5,"_159":143,"_160":281,"_162":123,"_110":282,"_105":126,"_164":165,"_166":-5,"_167":27,"_168":-5,"_169":465,"_103":475},[466,469,472],{"_108":285,"_100":286,"_156":287,"_158":280,"_159":143,"_160":288,"_162":123,"_110":289,"_105":223,"_164":178,"_166":290,"_167":27,"_168":-5,"_169":467,"_103":468},[],[279,286],{"_108":294,"_100":295,"_156":296,"_158":280,"_159":143,"_160":297,"_162":123,"_110":298,"_105":243,"_164":178,"_166":299,"_167":27,"_168":-5,"_169":470,"_103":471},[],[279,295],{"_108":303,"_100":304,"_156":305,"_158":280,"_159":143,"_160":306,"_162":123,"_110":307,"_105":272,"_164":178,"_166":308,"_167":27,"_168":-5,"_169":473,"_103":474},[],[279,304],[279],{"_108":313,"_100":314,"_156":315,"_158":-5,"_159":143,"_160":316,"_162":123,"_110":317,"_105":126,"_164":165,"_166":-5,"_167":27,"_168":-5,"_169":477,"_103":487},[478,481,484],{"_108":320,"_100":321,"_156":322,"_158":315,"_159":143,"_160":323,"_162":123,"_110":324,"_105":253,"_164":178,"_166":325,"_167":27,"_168":-5,"_169":479,"_103":480},[],[314,321],{"_108":329,"_100":330,"_156":331,"_158":315,"_159":143,"_160":332,"_162":123,"_110":333,"_105":198,"_164":178,"_166":334,"_167":27,"_168":-5,"_169":482,"_103":483},[],[314,330],{"_108":338,"_100":204,"_156":339,"_158":315,"_159":143,"_160":340,"_162":123,"_110":341,"_105":342,"_164":178,"_166":343,"_167":27,"_168":-5,"_169":485,"_103":486},[],[314,204],[314],{"_108":348,"_100":349,"_156":350,"_158":-5,"_159":143,"_160":351,"_162":123,"_110":352,"_105":353,"_164":354,"_166":355,"_167":27,"_168":-5,"_169":489,"_103":490},[],[349],{"_108":359,"_100":360,"_156":121,"_158":-5,"_159":143,"_160":361,"_162":123,"_110":362,"_105":363,"_164":364,"_166":365,"_167":27,"_168":-5,"_169":492,"_103":493},[],[360],{"_108":369,"_100":370,"_156":371,"_158":-5,"_159":143,"_160":372,"_162":123,"_110":373,"_105":233,"_164":178,"_166":374,"_167":27,"_168":-5,"_169":495,"_103":496},[],[370],{"_108":378,"_100":379,"_156":380,"_158":-5,"_159":143,"_160":381,"_162":123,"_110":382,"_105":198,"_164":178,"_166":383,"_167":27,"_168":-5,"_169":498,"_103":499},[],[379],[428,430,433,436,439,443,445,448,451,454,457,460,464,466,469,472,476,478,481,484,488,491,494,497],{"_108":213,"_100":104,"_156":214,"_158":-5,"_159":143,"_160":177,"_162":123,"_110":415,"_105":126,"_164":165,"_166":-5,"_167":27,"_168":-5,"_103":502},[104],[504,506,508,510,512,514],{"_108":218,"_100":219,"_156":220,"_158":214,"_159":143,"_160":221,"_162":123,"_110":397,"_105":223,"_164":178,"_166":224,"_167":27,"_168":-5,"_103":505},[104,219],{"_108":228,"_100":229,"_156":230,"_158":214,"_159":143,"_160":231,"_162":123,"_110":400,"_105":233,"_164":178,"_166":234,"_167":27,"_168":-5,"_103":507},[104,229],{"_108":238,"_100":239,"_156":240,"_158":214,"_159":143,"_160":241,"_162":123,"_110":403,"_105":243,"_164":178,"_166":244,"_167":27,"_168":-5,"_103":509},[104,239],{"_108":248,"_100":249,"_156":250,"_158":214,"_159":143,"_160":251,"_162":123,"_110":406,"_105":253,"_164":178,"_166":254,"_167":27,"_168":-5,"_103":511},[104,249],{"_108":258,"_100":259,"_156":260,"_158":214,"_159":143,"_160":261,"_162":123,"_110":409,"_105":263,"_164":178,"_166":264,"_167":27,"_168":-5,"_103":513},[104,259],{"_108":268,"_100":204,"_156":269,"_158":214,"_159":143,"_160":270,"_162":123,"_110":412,"_105":272,"_164":178,"_166":273,"_167":27,"_168":-5,"_103":515},[104,204],"upstream","showCompareCallout","pull","ahead","behind","templates",[],"routes/_app","actionData","errors"]