This page is not yet available in English. Read it in Portuguese

Skip to content
Menu da documentação

CI e integrações

Traces de agentes por OTLP

Mande os spans dos seus agentes e aplicações de IA para a AIUBY por OTLP/HTTP em JSON e veja-os junto das sessões, com redação na entrada.

#Envio

Aponte o exportador OTLP/HTTP do seu SDK de OpenTelemetry para a rota abaixo, em JSON, com uma chave de escopo agents:trace.

env
OTEL_EXPORTER_OTLP_TRACES_ENDPOINT=https://aiuby.com/api/v1/otel/v1/traces
OTEL_EXPORTER_OTLP_TRACES_PROTOCOL=http/json
OTEL_EXPORTER_OTLP_TRACES_HEADERS=Authorization=Bearer%20aiuby_...

#O que é lido

  • O corpo segue resourceSpans[].scopeSpans[].spans[]. Os atributos gen_ai.* viram modelo e tokens.
  • session.id, gen_ai.conversation.id ou aiuby.session agrupam o span na sessão, ao lado das execuções de agentes da plataforma com a mesma chave de sessão.
  • Atributos com nome de credencial são descartados e os textos passam pela redação antes de gravar.

#Limites

  • Só JSON: OTLP em protobuf é recusado.
  • Até 2 MB por envio e 1.000 spans; span com identificador fora do formato é recusado e contado na resposta.
  • O custo do span externo não é calculado: a plataforma soma custo só das chamadas que passaram pelo Gateway.