Quarkus 中动态禁用 OpenTelemetry 日志采集的完整指南-java教程-PHP中文网

Quarkus 中动态禁用 OpenTelemetry 日志采集的完整指南

在 Quarkus 2.x 应用中，可通过环境变量 OTEL_LOGS_EXPORTER=none 或 OTEL_JAVAAGENT_LOGGING=none 在运行时禁用 OpenTelemetry 的日志信号导出或 SDK 自身诊断日志，同时保持 trace ID 和 span ID 的跨服务透传能力。

在 quarkus 2.x 应用中，可通过环境变量 otel_logs_exporter=none 或 otel_javaagent_logging=none 在运行时禁用 opentelemetry 的日志信号导出或 sdk 自身诊断日志，同时保持 trace id 和 span id 的跨服务透传能力。

OpenTelemetry 在 Quarkus 中默认支持 traces、metrics 和 logs 三大信号（signals）。但实际生产中，你可能仅需分布式追踪能力（即传播 trace ID/span ID），而无需采集和导出日志数据——尤其当某服务处于高吞吐链路中，日志导出会带来额外资源开销或敏感信息暴露风险。

✅ 正确的禁用方式（按场景区分）

禁用 OpenTelemetry 日志信号（logs）的采集与导出（推荐首选）：
此操作不影响 trace/metrics，也不干扰 trace 上下文传播（如 traceparent header 仍正常透传）：
```
OTEL_LOGS_EXPORTER=none
# 或在 application.properties 中（仅对构建时生效，不推荐用于 runtime 切换）
# quarkus.opentelemetry.logs.exporter=none
```
⚠️ 注意：OTEL_LOGS_EXPORTER=none 是 OpenTelemetry SDK 标准配置，Quarkus 2.13+ 原生支持。若使用较旧版本，请升级至 Quarkus ≥ 2.13.0.Final 以确保兼容性。

夸克扫描王 - 转Office Alibaba-Quark-Transoffice
由夸克扫描王提供的文件格式转换工具。当用户需要将图片、截图或扫描件转换为 Office 文档（Word/Excel）或 PDF 时，使用此技能。适用于包含复杂表格、合同或图文混排内容的图片或扫描件，可尽量还原原始版式并生成可编辑文档。即使用户未明确提到格式转换，只要用户的需求涉及将图片内容转换为可编辑文档（如 .docx、.xlsx 或 .pdf），也应触发此技能。请勿用于提取纯文本或识别文字内容、图像增强处理或从零创建文档

下载
禁用 OpenTelemetry Java Agent 自身的内部诊断日志（如启动警告、采样决策日志等）：
这类日志仅用于调试 agent 行为，不参与业务信号采集，关闭后不影响 trace propagation：
```
OTEL_JAVAAGENT_LOGGING=none
# 某些 JVM 环境需加引号以避免 shell 解析异常：
OTEL_JAVAAGENT_LOGGING="none"
```

? 配置示例（Kubernetes / Docker / CLI）

# Kubernetes deployment snippet
env:
- name: OTEL_LOGS_EXPORTER
  value: "none"
- name: OTEL_JAVAAGENT_LOGGING
  value: "none"

# 启动 Quarkus 原生镜像时
java -Dquarkus.profile=prod \
     -Dotel.logs.exporter=none \
     -Dotel.javaagent.logging=none \
     -jar myapp-runner.jar

? 验证是否生效

检查应用启动日志中是否不再出现 LoggingSpanExporter 或 OtlpLogRecordExporter 初始化信息；
发送带 traceparent 的请求，确认下游服务仍能正确解析并延续 trace context；
使用 /q/health 或 /q/metrics 端点验证 traces 仍在上报（如通过 Jaeger/Otel Collector），而 logs 相关指标（如 otel.logs.recorded）应为 0。

? 关键总结

OTEL_LOGS_EXPORTER=none 禁用的是 OpenTelemetry 定义的日志信号导出管道，是标准、安全、可逆的运行时开关；
OTEL_JAVAAGENT_LOGGING=none 仅关闭 agent 内部日志，不影响任何业务信号；
二者均可在容器环境、K8s ConfigMap、JVM 参数中动态注入，真正实现“零代码修改”的运行时调控；
不要混淆 logging.level.io.opentelemetry=OFF —— 这是 SLF4J 日志级别控制，无法阻止 OTel SDK 创建并导出 log records，属于无效方案。

通过上述配置，你可在服务网格中精细化管控可观测性数据粒度，在保障全链路追踪能力的同时，按需裁剪日志负载。