Evalúa trazas registradas con OpenTelemetry.

Envía a Mibo las ejecuciones registradas de tu aplicación mediante OpenTelemetry. Evalúa las respuestas y acciones de cada traza con las comprobaciones que configures.

Empieza gratis Explorar casos de prueba

Conecta mediante OTLP sobre HTTP

Envía las trazas directamente a Mibo o mantén tu backend actual, como Langfuse, Datadog o LangSmith, y añade Mibo con un Collector. Los ejemplos de abajo muestran ambas configuraciones.

Solo MiboVarios destinos

Envía trazas directamente desde tu aplicación instrumentada a Mibo.

export OTEL_EXPORTER_OTLP_TRACES_PROTOCOL=http/protobuf
export OTEL_EXPORTER_OTLP_TRACES_ENDPOINT=https://api.mibo-ai.com/public/traces
export OTEL_EXPORTER_OTLP_TRACES_HEADERS='x-api-key=<YOUR_API_KEY>'
export OTEL_SERVICE_NAME='your-service-name'

Envía trazas a un OpenTelemetry Collector y configúralo para que las reenvíe a Mibo y a tu destino actual.

Exportador de la aplicación

export OTEL_EXPORTER_OTLP_TRACES_PROTOCOL=http/protobuf
export OTEL_EXPORTER_OTLP_TRACES_ENDPOINT=http://127.0.0.1:4318/v1/traces
export OTEL_SERVICE_NAME='your-service-name'

Configuración del Collector

receivers:
  otlp:
    protocols:
      http:
        endpoint: 127.0.0.1:4318
exporters:
  otlp_http/mibo:
    traces_endpoint: https://api.mibo-ai.com/public/traces
    headers:
      x-api-key: ${env:MIBO_API_KEY}
  otlp_http/other:
    traces_endpoint: '<YOUR_OTHER_OTLP_HTTP_TRACES_ENDPOINT>'
service:
  pipelines:
    traces:
      receivers: [otlp]
      exporters: [otlp_http/mibo, otlp_http/other]

Define MIBO_API_KEY en el entorno del Collector. El otro destino puede necesitar sus propias credenciales. 127.0.0.1 requiere que la aplicación y el Collector compartan un espacio de red. Ajusta las cabeceras del exportador para el Collector; las variables de endpoint admiten una sola URL, no una lista separada por comas.

También puedes configurar varios exportadores en tu SDK.

Usa OTLP sobre HTTP con protobuf (recomendado) o JSON. Sustituye el marcador de la clave API antes de enviar trazas. La documentación explica la configuración de cada SDK.

Ejemplos por framework

Conecta a Mibo la instrumentación que ya tienes. Cada ejemplo define la URL completa de trazas, tu clave API y el nombre del servicio.

Vercel AI SDK 7OpenLLMetry PythonOpenLLMetry TypeScript

Con AI SDK 7, registra la integración OpenTelemetry de @ai-sdk/otel y define telemetry en cada llamada. El exportador lee la URL de trazas, la clave y el nombre del servicio del entorno.

Variables de entorno

export OTEL_SERVICE_NAME=your-service-name
export OTEL_EXPORTER_OTLP_TRACES_ENDPOINT=https://api.mibo-ai.com/public/traces
export OTEL_EXPORTER_OTLP_TRACES_HEADERS=x-api-key=<YOUR_API_KEY>
export OTEL_METRICS_EXPORTER=none
export OTEL_LOGS_EXPORTER=none

import { OpenTelemetry } from "@ai-sdk/otel";
import { OTLPTraceExporter } from "@opentelemetry/exporter-trace-otlp-proto";
import { NodeSDK } from "@opentelemetry/sdk-node";
import { generateText, registerTelemetry } from "ai";

const sdk = new NodeSDK({ traceExporter: new OTLPTraceExporter() });
sdk.start();
registerTelemetry(new OpenTelemetry({ agentSpanName: "functionId" }));

const { text } = await generateText({
  model,
  prompt,
  telemetry: { functionId: "support-agent" },
});
await sdk.shutdown();

AI SDK 6 y la integración LegacyOpenTelemetry emiten solo atributos ai.*. Mibo solo puede comprobar esas trazas por tiempo y tokens.

Pasa un exportador OTLP HTTP a Traceloop.init. app_name pasa a ser el nombre del servicio. Las apps de LangChain y LangGraph usan esta misma configuración: OpenLLMetry instrumenta LangChain.

import os
from opentelemetry.exporter.otlp.proto.http.trace_exporter import OTLPSpanExporter
from traceloop.sdk import Traceloop

Traceloop.init(
    app_name="your-service-name",
    exporter=OTLPSpanExporter(
        endpoint="https://api.mibo-ai.com/public/traces",
        headers={"x-api-key": os.environ["MIBO_API_KEY"]},
    ),
)

Mantén activo el registro de contenido: TRACELOOP_TRACE_CONTENT=false elimina la entrada y la respuesta que Mibo necesita. Las versiones antiguas escriben gen_ai.prompt.0.content y gen_ai.completion.0.content, que Mibo no lee.

Pasa un exportador OTLP a initialize. appName pasa a ser el nombre del servicio. Instala el exportador de la misma línea de OpenTelemetry que el SDK, como @0.203 para el SDK 0.27.

import { OTLPTraceExporter } from "@opentelemetry/exporter-trace-otlp-proto";
import * as traceloop from "@traceloop/node-server-sdk";
import OpenAI from "openai";

traceloop.initialize({
  appName: "your-service-name",
  exporter: new OTLPTraceExporter({
    url: "https://api.mibo-ai.com/public/traces",
    headers: { "x-api-key": process.env.MIBO_API_KEY || "" },
  }),
  instrumentModules: { openAI: OpenAI },
});

Usa la URL completa de trazas

Los exportadores añaden /v1/traces solo a la variable genérica OTEL_EXPORTER_OTLP_ENDPOINT. Define OTEL_EXPORTER_OTLP_TRACES_ENDPOINT o la opción de URL del propio exportador.

Atributos que lee Mibo

Las comprobaciones node_call se comparan con los nombres de los spans. Las de la respuesta y de las llamadas a herramientas leen gen_ai.output.messages o gen_ai.response.text, y gen_ai.tool.name.

Otras instrumentaciones GenAI

Su documentación registra el contenido con OTEL_SEMCONV_STABILITY_OPT_IN=gen_ai_latest_experimental y OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT=span_only. Mibo no las ha verificado de extremo a extremo.

Menos de 10 MB por petición

Reduce el tamaño del lote si se rechaza una petición por ser demasiado grande.

De la traza a la evaluación

Envía una traza

Exporta una ejecución por OTLP/HTTP protobuf o JSON. Incluye la respuesta y las acciones necesarias para tus comprobaciones.

Crea un borrador con IA

Selecciona una traza completada. La IA crea un borrador con la evidencia disponible; revisa y guarda las comprobaciones sugeridas.

Evalúa las siguientes trazas

Envía más trazas y examina los resultados de tus comprobaciones configuradas.