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 Collector | De dónde sale |
|---|---|
| Momento | timeUnixNano, si no observedTimeUnixNano, si no cuando llegó |
| Nivel | severityNumber: 1–8 debug, 9–12 info, 13–16 warning, 17–20 error, 21–24 critical. Sin él, severityText; si no, info |
| Mensaje | El cuerpo (si no es texto, como JSON) |
| Origen | El nombre del instrumentation scope |
| Servicio | service.name del recurso |
| Entorno | deployment.environment.name, si no deployment.environment |
| Versión | service.version |
| Servidor | host.name, si no service.instance.id |
| Solicitud | El traceId: las líneas de una traza se agrupan como las de una solicitud |
| Usuario | El atributo user.id, si no enduser.id |
| Metadatos | Los 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.