Saltar al contenido principal

OpenTelemetry

Si tu aplicación ya manda sus logs con OpenTelemetry, puede mandarlos a Collector sin instalar ningún paquete de Collector, por OTLP/HTTP. Solo logs: las trazas y las métricas siguen yendo a donde van ahora.

Configurar el exportador​

Crea una clave de servidor en la configuración del proyecto y usa las variables de OpenTelemetry solo para logs:

OTEL_EXPORTER_OTLP_LOGS_ENDPOINT=https://app.clt.chrom.ar/otlp/v1/logs
OTEL_EXPORTER_OTLP_LOGS_PROTOCOL=http/protobuf
OTEL_EXPORTER_OTLP_LOGS_HEADERS=Authorization=Bearer%20clts_…

Escribe el espacio después de Bearer como %20: así lee OpenTelemetry los encabezados desde variables de entorno. Se aceptan protobuf y JSON, con o sin gzip.

Si tus logs pasan por un OpenTelemetry Collector, agrega Collector como un exportador otlphttp más de su pipeline de logs, con el mismo endpoint y el mismo encabezado. La Puesta en marcha del proyecto muestra la configuración completa en su pestaña OpenTelemetry.

Cómo se ve cada registro​

Cada registro de OpenTelemetry se vuelve una línea de log en Registros:

Campo en CollectorDe dónde sale
MomentotimeUnixNano, si no observedTimeUnixNano, si no cuando llegó
NivelseverityNumber: 1–8 debug, 9–12 info, 13–16 warning, 17–20 error, 21–24 critical. Sin él, severityText; si no, info
MensajeEl cuerpo (si no es texto, como JSON)
OrigenEl nombre del instrumentation scope
Servicioservice.name del recurso
Entornodeployment.environment.name, si no deployment.environment
Versiónservice.version
Servidorhost.name, si no service.instance.id
SolicitudEl traceId: las líneas de una traza se agrupan como las de una solicitud
UsuarioEl atributo user.id, si no enduser.id
MetadatosLos atributos del registro, los del recurso que no se usaron arriba, y span_id

Ponle nombre al servicio y al entorno (OTEL_RESOURCE_ATTRIBUTES=service.name=api,deployment.environment.name=production) para poder filtrar por ellos.

Límites​

La misma clave de servidor y el mismo presupuesto de líneas de log que los SDK. Hasta 10.000 registros y 10 MB por pedido. Los registros de más de 7 días atrás o de más de una hora en el futuro se rechazan. Si el proyecto pasó su presupuesto, Collector contesta 429 y el exportador reintenta solo. Ver Límites.