The Open Framework for Building Agents
docs: add Oodle instrumentation registry item (#5247)
Colton Paddenf6bba398ecbd
diff --git a/apps/docs/lib/integrations/data.ts b/apps/docs/lib/integrations/data.tsindex 9e672f476..899d3a1f4 100644--- a/apps/docs/lib/integrations/data.ts+++ b/apps/docs/lib/integrations/data.ts@@ -2652,6 +2652,38 @@ export default otelIntegration({\`\`\``,configure: `Create a write key in the Raindrop dashboard and expose it as \`RAINDROP_WRITE_KEY\`. Raindrop's Vercel AI SDK integration picks up the AI SDK spans eve emits on every turn. See the [OpenTelemetry guide](/docs/observability/otel) for trace topology and content policy.`,},+ oodle: {+ logo: "oodle",+ docsHref: "https://docs.oodle.ai/integrations/agent-observability/eve",+ keywords: ["otel", "opentelemetry", "tracing", "observability", "agent observability", "otlp"],+ install: `Add Oodle instrumentation from eve's registry. Oodle ingests OTLP directly:++\`\`\`bash+eve add instrumentation/oodle+\`\`\``,++ quickStart: `Create \`agent/instrumentation/oodle.ts\` and send traces to Oodle's OTLP endpoint with your API key and instance ID:++\`\`\`ts+// agent/instrumentation/oodle.ts+import { OTLPHttpProtoTraceExporter } from "@vercel/otel";+import { otelIntegration } from "eve/instrumentation/otel";++export default otelIntegration({+ exportPolicy: {+ span: () => ({ redact: true, inputs: true, outputs: true }),+ },+ traceExporter: new OTLPHttpProtoTraceExporter({+ url: \`https://\${process.env.OODLE_OTLP_ENDPOINT}/v1/traces\`,+ headers: {+ "X-API-KEY": process.env.OODLE_API_KEY!,+ "X-OODLE-INSTANCE": process.env.OODLE_INSTANCE!,+ },+ }),+});+\`\`\``,+ configure: `Open Oodle’s eve integration tile to get your OTLP collector domain, API key, and instance ID. Set \`OODLE_OTLP_ENDPOINT\` to the domain only, without a scheme or path; the template adds \`https://\` and \`/v1/traces\`. Set \`OODLE_API_KEY\` and \`OODLE_INSTANCE\` to the supplied values. The registry template redacts inputs and outputs before export. See [Oodle’s eve guide](https://docs.oodle.ai/integrations/agent-observability/eve) for Oodle setup and the [OpenTelemetry guide](/docs/observability/otel) for trace topology and content policy.`,+ },jaeger: {logo: "jaeger",docsHref: "/docs/observability/otel",diff --git a/apps/docs/lib/integrations/logos.tsx b/apps/docs/lib/integrations/logos.tsxindex f6b821df8..b5c893238 100644--- a/apps/docs/lib/integrations/logos.tsx+++ b/apps/docs/lib/integrations/logos.tsx@@ -833,6 +833,21 @@ const raindropLogo = (props: LogoProps) => (</svg>);+const oodleLogo = (props: LogoProps) => (+ <svg fill="none" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg" {...props}>+ <path+ clipRule="evenodd"+ d="M 5.889 11.293 C 5.19 11.735 4.602 12.264 4.123 12.878 C 3.342 13.864 2.951 15.028 2.951 16.371 C 2.951 17.714 3.342 18.887 4.123 19.889 C 4.905 20.875 5.979 21.64 7.346 22.184 C 8.714 22.728 10.264 23 11.998 23 C 13.756 23 15.306 22.728 16.649 22.184 C 18.016 21.64 19.09 20.875 19.872 19.889 C 20.653 18.887 21.044 17.714 21.044 16.371 C 21.044 15.028 20.653 13.864 19.872 12.878 C 19.394 12.244 18.794 11.703 18.072 11.252 V 14.23 C 18.445 14.772 18.631 15.387 18.631 16.077 C 18.631 16.932 18.345 17.679 17.772 18.318 C 17.199 18.945 16.411 19.433 15.409 19.779 C 15.056 19.903 14.683 20.005 14.291 20.084 C 13.584 20.311 12.82 20.425 11.998 20.425 C 11.173 20.425 10.412 20.311 9.716 20.084 C 9.322 20.005 8.946 19.903 8.587 19.779 C 7.584 19.433 6.796 18.945 6.223 18.318 C 5.65 17.679 5.364 16.932 5.364 16.077 C 5.364 15.409 5.539 14.81 5.889 14.281 V 11.293Z"+ fill="currentColor"+ fillRule="evenodd"+ />+ <rect fill="currentColor" height="16.882" rx="0.968" width="1.936" x="6.945" y="4.752" />+ <rect fill="currentColor" height="14.885" rx="0.968" width="1.936" x="9.668" y="6.748" />+ <rect fill="currentColor" height="16.882" rx="0.968" width="1.936" x="12.391" y="4.752" />+ <rect fill="currentColor" height="20.634" rx="0.968" width="1.936" x="15.114" y="1" />+ </svg>+);+const shopifyLogo = (props: LogoProps) => (<svg fill="none" viewBox="0 0 109.5 124.5" xmlns="http://www.w3.org/2000/svg" {...props}><path@@ -871,6 +886,7 @@ export const logos = {braintrust: braintrustLogo,jaeger: jaegerLogo,raindrop: raindropLogo,+ oodle: oodleLogo,kernel: kernelLogo,upstash: upstashLogo,arcana: arcanaLogo,diff --git a/apps/docs/registry.json b/apps/docs/registry.jsonindex d9dc32ca3..e507f035a 100644--- a/apps/docs/registry.json+++ b/apps/docs/registry.json@@ -3484,6 +3484,27 @@}]},+ {+ "name": "instrumentation/oodle",+ "type": "registry:item",+ "title": "Oodle",+ "description": "Send agent traces to Oodle over OpenTelemetry.",+ "dependencies": [+ "@vercel/otel"+ ],+ "envVars": {+ "OODLE_OTLP_ENDPOINT": "",+ "OODLE_API_KEY": "",+ "OODLE_INSTANCE": ""+ },+ "files": [+ {+ "path": "registry/instrumentation/oodle.ts",+ "type": "registry:file",+ "target": "agent/instrumentation/oodle.ts"+ }+ ]+ },{"name": "instrumentation/jaeger","type": "registry:item",diff --git a/apps/docs/registry/instrumentation/oodle.ts b/apps/docs/registry/instrumentation/oodle.tsnew file mode 100644index 000000000..f4d69d333--- /dev/null+++ b/apps/docs/registry/instrumentation/oodle.ts@@ -0,0 +1,15 @@+import { OTLPHttpProtoTraceExporter } from "@vercel/otel";+import { otelIntegration } from "eve/instrumentation/otel";++export default otelIntegration({+ exportPolicy: {+ span: () => ({ redact: true, inputs: true, outputs: true }),+ },+ traceExporter: new OTLPHttpProtoTraceExporter({+ url: `https://${process.env.OODLE_OTLP_ENDPOINT}/v1/traces`,+ headers: {+ "X-API-KEY": process.env.OODLE_API_KEY!,+ "X-OODLE-INSTANCE": process.env.OODLE_INSTANCE!,+ },+ }),+});diff --git a/apps/docs/scripts/validate-instrumentation-registry.ts b/apps/docs/scripts/validate-instrumentation-registry.tsindex aaac65595..87725682a 100644--- a/apps/docs/scripts/validate-instrumentation-registry.ts+++ b/apps/docs/scripts/validate-instrumentation-registry.ts@@ -25,6 +25,7 @@ const registrySlugsByCatalogSlug: Readonly<Record<string, string>> = {"honeycomb-instrumentation": "honeycomb",arize: "arize",raindrop: "raindrop",+ oodle: "oodle",jaeger: "jaeger",};diff --git a/packages/eve-catalog/src/index.ts b/packages/eve-catalog/src/index.tsindex 288ff3f95..cf93c509c 100644--- a/packages/eve-catalog/src/index.ts+++ b/packages/eve-catalog/src/index.ts@@ -976,6 +976,13 @@ export const INTEGRATIONS: readonly IntegrationEntry[] = [tagline: "Send agent traces to Raindrop to detect and debug AI product issues.",surfaces: { scaffoldable: false, registry: true, gallery: true },},+ {+ slug: "oodle",+ name: "Oodle",+ kind: "instrumentation",+ tagline: "Send agent traces to Oodle over OpenTelemetry.",+ surfaces: { scaffoldable: false, registry: true, gallery: true },+ },{slug: "jaeger",name: "Jaeger",