Avalie traces registrados com OpenTelemetry.

Envie ao Mibo as execuções registradas da sua aplicação pelo OpenTelemetry. Avalie as respostas e ações de cada trace com as verificações que você configurar.

Comece grátis Explorar casos de teste

Conecte via OTLP sobre HTTP

Envie traces direto para o Mibo ou mantenha seu backend atual, como Langfuse, Datadog ou LangSmith, e adicione o Mibo com um Collector. Os exemplos abaixo mostram as duas configurações.

Somente MiboVários destinos

Envie traces diretamente da sua aplicação instrumentada para o 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'

Envie traces a um OpenTelemetry Collector e configure-o para encaminhá-los ao Mibo e ao seu destino atual.

Exportador da aplicação

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'

Configuração do 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]

Defina MIBO_API_KEY no ambiente do Collector. O outro destino pode precisar de credenciais próprias. 127.0.0.1 exige que a aplicação e o Collector compartilhem o mesmo namespace de rede. Ajuste os cabeçalhos do exportador para o Collector; variáveis de endpoint aceitam uma URL, não uma lista separada por vírgulas.

Você também pode configurar vários exportadores no seu SDK.

Use OTLP sobre HTTP com protobuf (recomendado) ou JSON. Substitua o marcador da chave de API antes de enviar traces. A documentação explica a configuração de cada SDK.

Exemplos por framework

Conecte ao Mibo a instrumentação que você já tem. Cada exemplo define a URL completa de traces, sua chave de API e o nome do serviço.

Vercel AI SDK 7OpenLLMetry PythonOpenLLMetry TypeScript

No AI SDK 7, registre a integração OpenTelemetry do @ai-sdk/otel e defina telemetry em cada chamada. O exportador lê a URL de traces, a chave e o nome do serviço do ambiente.

Variáveis de ambiente

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();

O AI SDK 6 e a integração LegacyOpenTelemetry emitem só atributos ai.*. O Mibo só consegue verificar esses traces por tempo e tokens.

Passe um exportador OTLP HTTP para Traceloop.init. app_name vira o nome do serviço. Apps de LangChain e LangGraph usam esta mesma configuração: o OpenLLMetry instrumenta o 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"]},
    ),
)

Mantenha o registro de conteúdo ativo: TRACELOOP_TRACE_CONTENT=false remove a entrada e a resposta de que o Mibo precisa. Versões antigas gravam gen_ai.prompt.0.content e gen_ai.completion.0.content, que o Mibo não lê.

Passe um exportador OTLP para initialize. appName vira o nome do serviço. Instale o exportador da mesma linha do OpenTelemetry que o SDK, como @0.203 para o 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 },
});

Use a URL completa de traces

Os exportadores acrescentam /v1/traces só à variável genérica OTEL_EXPORTER_OTLP_ENDPOINT. Defina OTEL_EXPORTER_OTLP_TRACES_ENDPOINT ou a opção de URL do próprio exportador.

Atributos que o Mibo lê

Verificações node_call são comparadas com os nomes dos spans. As da resposta e de chamadas de ferramentas leem gen_ai.output.messages ou gen_ai.response.text, e gen_ai.tool.name.

Outras instrumentações GenAI

A documentação delas registra o conteúdo com OTEL_SEMCONV_STABILITY_OPT_IN=gen_ai_latest_experimental e OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT=span_only. O Mibo não as verificou de ponta a ponta.

Menos de 10 MB por requisição

Reduza o tamanho do lote se uma requisição for recusada por ser grande demais.

Do trace à avaliação

Envie um trace

Exporte uma execução por OTLP/HTTP protobuf ou JSON. Inclua a resposta e as ações necessárias para suas verificações.

Crie um rascunho com IA

Selecione um trace concluído. A IA cria um rascunho com as evidências disponíveis; revise e salve as verificações sugeridas.

Avalie os próximos traces

Envie mais traces e examine os resultados das verificações configuradas.