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;",[],[152,179],{"_106":186,"_98":187,"_153":188,"_155":154,"_156":137,"_157":136,"_158":159,"_108":189,"_103":31,"_161":173,"_163":190,"_164":27,"_165":-5,"_166":191,"_101":192},"5ada3cf6-4272-11f0-bf0a-76b3cceeab13","traces.ts","43497a8c-0865-4274-9512-75fd55b817ab",["D",1749171936578],"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;",[],[152,187],{"_106":194,"_98":195,"_153":196,"_155":154,"_156":137,"_157":136,"_158":159,"_108":197,"_103":31,"_161":173,"_163":198,"_164":27,"_165":-5,"_166":199,"_101":200},"5ada42c8-4272-11f0-bf0a-76b3cceeab13","types.ts","8e1d35f5-d8e1-4a10-abd9-55ae6fe50a06",["D",1749171936578],"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 };",[],[152,195],[152],{"_106":203,"_98":204,"_153":205,"_155":-5,"_156":137,"_157":136,"_158":159,"_108":206,"_103":31,"_161":162,"_163":-5,"_164":27,"_165":-5,"_166":207,"_101":255},"5ada5560-4272-11f0-bf0a-76b3cceeab13","db","7556376c-bb49-40eb-a5ad-aeb56551d20e",["D",1749171936578],[208,216,224,232,240,248],{"_106":209,"_98":210,"_153":211,"_155":205,"_156":137,"_157":136,"_158":159,"_108":212,"_103":31,"_161":173,"_163":213,"_164":27,"_165":-5,"_166":214,"_101":215},"5ada4ba6-4272-11f0-bf0a-76b3cceeab13","client.ts","cca8d450-ecde-40d8-a3c0-2aeef2921f94",["D",1749171936578],"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});",[],[204,210],{"_106":217,"_98":218,"_153":219,"_155":205,"_156":137,"_157":136,"_158":159,"_108":220,"_103":31,"_161":173,"_163":221,"_164":27,"_165":-5,"_166":222,"_101":223},"5ada4d36-4272-11f0-bf0a-76b3cceeab13","constants.ts","67c1f3ab-b333-4b6e-80ff-b84a437627ae",["D",1749171936578],"/**\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\";",[],[204,218],{"_106":225,"_98":226,"_153":227,"_155":205,"_156":137,"_157":136,"_158":159,"_108":228,"_103":31,"_161":173,"_163":229,"_164":27,"_165":-5,"_166":230,"_101":231},"5ada4ea8-4272-11f0-bf0a-76b3cceeab13","migrate.ts","893d59c4-01fd-4577-9243-8822a3d4d1d6",["D",1749171936578],"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};",[],[204,226],{"_106":233,"_98":234,"_153":235,"_155":205,"_156":137,"_157":136,"_158":159,"_108":236,"_103":31,"_161":173,"_163":237,"_164":27,"_165":-5,"_166":238,"_101":239},"5ada507e-4272-11f0-bf0a-76b3cceeab13","queries.ts","d90e3b0c-4932-4ce0-8b6a-b4c429670093",["D",1749171936578],"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}",[],[204,234],{"_106":241,"_98":242,"_153":243,"_155":205,"_156":137,"_157":136,"_158":159,"_108":244,"_103":31,"_161":173,"_163":245,"_164":27,"_165":-5,"_166":246,"_101":247},"5ada5218-4272-11f0-bf0a-76b3cceeab13","schema.ts","bc051a45-ca9c-4e68-bbd8-3371d152a00c",["D",1749171936578],"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});",[],[204,242],{"_106":249,"_98":195,"_153":250,"_155":205,"_156":137,"_157":136,"_158":159,"_108":251,"_103":31,"_161":173,"_163":252,"_164":27,"_165":-5,"_166":253,"_101":254},"5ada53da-4272-11f0-bf0a-76b3cceeab13","43c14b70-3542-4fcf-9aaf-c9f88aa68a1a",["D",1749171936578],"import type { LibSQLDatabase } from \"../deps/drizzle.ts\";\nimport type * as schema from \"./schema\";\n\nexport type DBType = LibSQLDatabase;",[],[204,195],[204],{"_106":257,"_98":258,"_153":259,"_155":-5,"_156":137,"_157":136,"_158":159,"_108":260,"_103":31,"_161":162,"_163":-5,"_164":27,"_165":-5,"_166":261,"_101":286},"5ada6168-4272-11f0-bf0a-76b3cceeab13","deps","5b5a92ba-f017-4b9e-95a5-0caea3d601f2",["D",1749171936578],[262,270,278],{"_106":263,"_98":264,"_153":265,"_155":259,"_156":137,"_157":136,"_158":159,"_108":266,"_103":31,"_161":173,"_163":267,"_164":27,"_165":-5,"_166":268,"_101":269},"5ada5722-4272-11f0-bf0a-76b3cceeab13","drizzle.ts","9502ff3c-1e53-4138-8766-6b7c4211d889",["D",1749171936578],"// 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 };",[],[258,264],{"_106":271,"_98":272,"_153":273,"_155":259,"_156":137,"_157":136,"_158":159,"_108":274,"_103":31,"_161":173,"_163":275,"_164":27,"_165":-5,"_166":276,"_101":277},"5ada5c04-4272-11f0-bf0a-76b3cceeab13","fiberplane.ts","95307c6d-3910-4799-96ca-2154683520fe",["D",1749171936578],"// 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 };",[],[258,272],{"_106":279,"_98":280,"_153":281,"_155":259,"_156":137,"_157":136,"_158":159,"_108":282,"_103":31,"_161":173,"_163":283,"_164":27,"_165":-5,"_166":284,"_101":285},"5ada5eac-4272-11f0-bf0a-76b3cceeab13","hono.ts","cbceabcb-5f63-40d1-8ffa-584fdbb5bbaa",["D",1749171936578],"/**\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 };",[],[258,280],[258],{"_106":288,"_98":289,"_153":290,"_155":-5,"_156":137,"_157":136,"_158":159,"_108":291,"_103":31,"_161":162,"_163":-5,"_164":27,"_165":-5,"_166":292,"_101":316},"5ada7234-4272-11f0-bf0a-76b3cceeab13","otel","c35bf565-471a-4ae7-98e6-640a9b80644b",["D",1749171936578],[293,301,309],{"_106":294,"_98":295,"_153":296,"_155":290,"_156":137,"_157":136,"_158":159,"_108":297,"_103":31,"_161":173,"_163":298,"_164":27,"_165":-5,"_166":299,"_101":300},"5ada632a-4272-11f0-bf0a-76b3cceeab13","schemas.ts","e5ab9330-7974-4bf2-a40e-ea05da9e9612",["D",1749171936578],"// 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 };",[],[289,295],{"_106":302,"_98":303,"_153":304,"_155":290,"_156":137,"_157":136,"_158":159,"_108":305,"_103":31,"_161":173,"_163":306,"_164":27,"_165":-5,"_166":307,"_101":308},"5ada64b0-4272-11f0-bf0a-76b3cceeab13","transformExport.ts","dfe0df22-1b4c-47e0-bfa0-e1f0d686a41c",["D",1749171936578],"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};",[],[289,303],{"_106":310,"_98":195,"_153":311,"_155":290,"_156":137,"_157":136,"_158":159,"_108":312,"_103":31,"_161":173,"_163":313,"_164":27,"_165":-5,"_166":314,"_101":315},"5ada7086-4272-11f0-bf0a-76b3cceeab13","017a75f7-c62b-4051-9d79-63a22904d616",["D",1749171936578],"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}",[],[289,195],[289],{"_106":318,"_98":319,"_153":320,"_155":-5,"_156":137,"_157":136,"_158":159,"_108":321,"_103":31,"_161":322,"_163":323,"_164":27,"_165":-5,"_166":324,"_101":325},"5ada73c4-4272-11f0-bf0a-76b3cceeab13","README.md","a697fa27-84df-462c-b855-289baaa31a5b",["D",1749171936578],"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",[],[319],{"_106":327,"_98":328,"_153":329,"_155":-5,"_156":137,"_157":136,"_158":159,"_108":330,"_103":31,"_161":331,"_163":332,"_164":27,"_165":-5,"_166":333,"_101":334},"5ada76da-4272-11f0-bf0a-76b3cceeab13","index.ts","c2d66e8a-1de2-4805-8152-dc8388966463",["D",1749171936578],"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}",[],[328],{"_106":336,"_98":337,"_153":338,"_155":-5,"_156":137,"_157":136,"_158":159,"_108":339,"_103":31,"_161":173,"_163":340,"_164":27,"_165":-5,"_166":341,"_101":342},"5ada7874-4272-11f0-bf0a-76b3cceeab13","logger.ts","8dcefed1-eca3-4997-826e-ef261ab5a08f",["D",1749171936578],"/**\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};",[],[337],{"_106":344,"_98":345,"_153":346,"_155":-5,"_156":137,"_157":136,"_158":159,"_108":347,"_103":31,"_161":173,"_163":348,"_164":27,"_165":-5,"_166":349,"_101":350},"5ada79d2-4272-11f0-bf0a-76b3cceeab13","openapi.ts","75ef2403-1e9d-4751-862e-56ffabf2936e",["D",1749171936578],"/**\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}",[],[345],"files",[150,168,177,185,193,202,208,216,224,232,240,248,256,262,270,278,287,293,301,309,317,326,335,343],"counts",{"_355":31,"_356":136,"_357":31,"_358":136},"pulls","branches","forks","envVars","contents",[],{"_106":169,"_98":170,"_153":171,"_155":154,"_156":137,"_157":136,"_158":159,"_108":362,"_103":31,"_161":173,"_163":174,"_164":27,"_165":-5,"_101":363},["D",1749171936578],[152,170],"upstreamProject",{"_106":366,"_98":99,"_114":367,"_115":-5,"_112":113,"_21":368},"517259dc-f65a-11ef-9da1-569c3dd06744","Receive traces from @fiberplane/hono-otel, and store in sqlite",{"_96":369,"_132":370},"fiberplane","https://img.clerk.com/eyJ0eXBlIjoicHJveHkiLCJzcmMiOiJodHRwczovL2ltYWdlcy5jbGVyay5kZXYvdXBsb2FkZWQvaW1nXzJ0OXJLaXVodjZKMUU4QnFhODNCVkJ4aVRQSyJ9","upstreamBranch",{"_106":140,"_108":373,"_374":375,"_98":42,"_138":366,"_103":142,"_139":-5,"_141":-5,"_376":377,"_110":-5,"_130":27,"_112":113,"_147":369,"_146":99},["D",1740805324568],"updatedAt",["D",1740836480150],"lockfileKey","1744643555298-esm.town_v_fiberplane_OpenTelemetryCollector@277-main","emptyEnvVars","isNew","routes/_app.x.$handle.$name.code.$",{"_96":97,"_98":99,"_100":42,"_103":-7,"_101":102,"_104":382,"_148":386,"_351":459,"_322":460,"_359":462,"_463":464,"_467":27,"_468":-5,"_469":-5,"_470":-5,"_471":472},{"_106":107,"_98":99,"_108":383,"_110":-5,"_111":27,"_112":113,"_114":-5,"_115":-5,"_12":116,"_117":-5,"_118":27,"_119":-5,"_120":31,"_121":122,"_123":122,"_124":125,"_126":125,"_127":125,"_128":122,"_129":122,"_130":27,"_21":384,"_134":385},["D",1749171936578],{"_96":97,"_132":133},{"_103":136,"_98":42,"_106":137,"_138":107,"_139":140,"_141":142,"_143":113,"_144":145,"_146":99,"_147":97},[387,402,423,435,447,450,453,456],{"_106":151,"_98":152,"_153":154,"_155":-5,"_156":137,"_157":136,"_158":159,"_108":160,"_103":31,"_161":162,"_163":-5,"_164":27,"_165":-5,"_166":388,"_101":401},[389,392,395,398],{"_106":169,"_98":170,"_153":171,"_155":154,"_156":137,"_157":136,"_158":159,"_108":172,"_103":31,"_161":173,"_163":174,"_164":27,"_165":-5,"_166":390,"_101":391},[],[152,170],{"_106":178,"_98":179,"_153":180,"_155":154,"_156":137,"_157":136,"_158":159,"_108":181,"_103":31,"_161":173,"_163":182,"_164":27,"_165":-5,"_166":393,"_101":394},[],[152,179],{"_106":186,"_98":187,"_153":188,"_155":154,"_156":137,"_157":136,"_158":159,"_108":189,"_103":31,"_161":173,"_163":190,"_164":27,"_165":-5,"_166":396,"_101":397},[],[152,187],{"_106":194,"_98":195,"_153":196,"_155":154,"_156":137,"_157":136,"_158":159,"_108":197,"_103":31,"_161":173,"_163":198,"_164":27,"_165":-5,"_166":399,"_101":400},[],[152,195],[152],{"_106":203,"_98":204,"_153":205,"_155":-5,"_156":137,"_157":136,"_158":159,"_108":206,"_103":31,"_161":162,"_163":-5,"_164":27,"_165":-5,"_166":403,"_101":422},[404,407,410,413,416,419],{"_106":209,"_98":210,"_153":211,"_155":205,"_156":137,"_157":136,"_158":159,"_108":212,"_103":31,"_161":173,"_163":213,"_164":27,"_165":-5,"_166":405,"_101":406},[],[204,210],{"_106":217,"_98":218,"_153":219,"_155":205,"_156":137,"_157":136,"_158":159,"_108":220,"_103":31,"_161":173,"_163":221,"_164":27,"_165":-5,"_166":408,"_101":409},[],[204,218],{"_106":225,"_98":226,"_153":227,"_155":205,"_156":137,"_157":136,"_158":159,"_108":228,"_103":31,"_161":173,"_163":229,"_164":27,"_165":-5,"_166":411,"_101":412},[],[204,226],{"_106":233,"_98":234,"_153":235,"_155":205,"_156":137,"_157":136,"_158":159,"_108":236,"_103":31,"_161":173,"_163":237,"_164":27,"_165":-5,"_166":414,"_101":415},[],[204,234],{"_106":241,"_98":242,"_153":243,"_155":205,"_156":137,"_157":136,"_158":159,"_108":244,"_103":31,"_161":173,"_163":245,"_164":27,"_165":-5,"_166":417,"_101":418},[],[204,242],{"_106":249,"_98":195,"_153":250,"_155":205,"_156":137,"_157":136,"_158":159,"_108":251,"_103":31,"_161":173,"_163":252,"_164":27,"_165":-5,"_166":420,"_101":421},[],[204,195],[204],{"_106":257,"_98":258,"_153":259,"_155":-5,"_156":137,"_157":136,"_158":159,"_108":260,"_103":31,"_161":162,"_163":-5,"_164":27,"_165":-5,"_166":424,"_101":434},[425,428,431],{"_106":263,"_98":264,"_153":265,"_155":259,"_156":137,"_157":136,"_158":159,"_108":266,"_103":31,"_161":173,"_163":267,"_164":27,"_165":-5,"_166":426,"_101":427},[],[258,264],{"_106":271,"_98":272,"_153":273,"_155":259,"_156":137,"_157":136,"_158":159,"_108":274,"_103":31,"_161":173,"_163":275,"_164":27,"_165":-5,"_166":429,"_101":430},[],[258,272],{"_106":279,"_98":280,"_153":281,"_155":259,"_156":137,"_157":136,"_158":159,"_108":282,"_103":31,"_161":173,"_163":283,"_164":27,"_165":-5,"_166":432,"_101":433},[],[258,280],[258],{"_106":288,"_98":289,"_153":290,"_155":-5,"_156":137,"_157":136,"_158":159,"_108":291,"_103":31,"_161":162,"_163":-5,"_164":27,"_165":-5,"_166":436,"_101":446},[437,440,443],{"_106":294,"_98":295,"_153":296,"_155":290,"_156":137,"_157":136,"_158":159,"_108":297,"_103":31,"_161":173,"_163":298,"_164":27,"_165":-5,"_166":438,"_101":439},[],[289,295],{"_106":302,"_98":303,"_153":304,"_155":290,"_156":137,"_157":136,"_158":159,"_108":305,"_103":31,"_161":173,"_163":306,"_164":27,"_165":-5,"_166":441,"_101":442},[],[289,303],{"_106":310,"_98":195,"_153":311,"_155":290,"_156":137,"_157":136,"_158":159,"_108":312,"_103":31,"_161":173,"_163":313,"_164":27,"_165":-5,"_166":444,"_101":445},[],[289,195],[289],{"_106":318,"_98":319,"_153":320,"_155":-5,"_156":137,"_157":136,"_158":159,"_108":321,"_103":31,"_161":322,"_163":323,"_164":27,"_165":-5,"_166":448,"_101":449},[],[319],{"_106":327,"_98":328,"_153":329,"_155":-5,"_156":137,"_157":136,"_158":159,"_108":330,"_103":31,"_161":331,"_163":332,"_164":27,"_165":-5,"_166":451,"_101":452},[],[328],{"_106":336,"_98":337,"_153":338,"_155":-5,"_156":137,"_157":136,"_158":159,"_108":339,"_103":31,"_161":173,"_163":340,"_164":27,"_165":-5,"_166":454,"_101":455},[],[337],{"_106":344,"_98":345,"_153":346,"_155":-5,"_156":137,"_157":136,"_158":159,"_108":347,"_103":31,"_161":173,"_163":348,"_164":27,"_165":-5,"_166":457,"_101":458},[],[345],[387,389,392,395,398,402,404,407,410,413,416,419,423,425,428,431,435,437,440,443,447,450,453,456],{"_106":169,"_98":170,"_153":171,"_155":154,"_156":137,"_157":136,"_158":159,"_108":362,"_103":31,"_161":173,"_163":174,"_164":27,"_165":-5,"_101":461},[152,170],[],"upstream",{"_106":140,"_108":465,"_374":466,"_98":42,"_138":366,"_103":142,"_139":-5,"_141":-5,"_376":377,"_110":-5,"_130":27,"_112":113,"_147":369,"_146":99},["D",1740805324568],["D",1740836480150],"showCompareCallout","pull","ahead","behind","templates",[473,488],{"_106":474,"_98":475,"_108":476,"_110":-5,"_111":27,"_112":113,"_114":477,"_115":478,"_12":479,"_117":480,"_118":159,"_119":481,"_120":482,"_121":122,"_123":122,"_124":125,"_126":125,"_127":125,"_128":122,"_129":122,"_130":27,"_21":483,"_134":486},"8e7382ae-d835-11ef-bbbf-e6cdfca9ef9f","markdownBlogStarter",["D",1737491000655],"Starter template for a markdown blog","https://imagedelivery.net/iHX6Ovru0O7AjmyT5yZRoA/44a31e5c-3e8a-48a8-d067-5785c0b08200/square512","a0bf3b31-15a5-4d5c-880e-4b1e22c9bc18","a4a9ad14-d835-11ef-8351-e6cdfca9ef9f",167,8,{"_96":484,"_132":485},"stevekrouse","https://images.clerk.dev/uploaded/img_2PqHa2Gsy93xQrjh2w78Xu0cChW.jpeg",{"_106":487,"_98":42,"_103":481,"_138":474,"_139":-5,"_141":-5},"8e73c264-d835-11ef-bbbf-e6cdfca9ef9f",{"_106":489,"_98":490,"_108":491,"_110":-5,"_111":27,"_112":113,"_114":492,"_115":-5,"_12":493,"_117":494,"_118":159,"_119":495,"_120":496,"_121":122,"_123":122,"_124":125,"_126":125,"_127":125,"_128":122,"_129":122,"_130":27,"_21":497,"_134":500},"96102714-f528-11ef-aa68-569c3dd06744","reactHonoStarter",["D",1740674013689],"Starter template with client-side React & Hono server","c9143560-63b6-444f-8f9f-e2647fabe09f","a9b2b20a-f528-11ef-9e98-569c3dd06744",39,9,{"_96":498,"_132":499},"std","https://img.clerk.com/eyJ0eXBlIjoicHJveHkiLCJzcmMiOiJodHRwczovL2ltYWdlcy5jbGVyay5kZXYvdXBsb2FkZWQvaW1nXzJVaVhpQ1BId3dscVpBbkdZVWlMNjJtcjkxWS5wbmcifQ",{"_106":501,"_98":42,"_103":502,"_138":489,"_139":-5,"_141":-5},"961078ea-f528-11ef-aa68-569c3dd06744",67,"routes/_app","actionData","errors"]