Skip to content

armgit / eve

Public Imported from GitHub
0

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.ts
index 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.tsx
index 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.json
index 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.ts
new file mode 100644
index 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.ts
index 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.ts
index 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",