go应用在kubernetes中部署opentelemetry探针最稳路径是sidecar注入：需设privileged权限、共享pid namespace、指定otel_go_auto_target_exe绝对路径、保留符号表（禁用-ldflags="-s -w"），且tencent-opentelemetry-operator不支持go自动注入。
Go 应用在 Kubernetes 中部署本身不难，但加 OpenTelemetry 探针时容易卡在「半自动」这个模糊地带——它既不是纯代码侵入（像手动调 otelhttp.NewHandler），也不是真全自动（eBPF 方式对内核版本要求太高，5.4–5.14 且需特权）。实际落地时，最稳的路径是 sidecar 注入 + 静态二进制配合环境变量驱动。
用 sidecar 容器注入 Go 自动仪表化探针
OpenTelemetry 官方提供的 otel/autoinstrumentation-go 镜像是目前最成熟的半自动方案。它不修改你的 Go 二进制，而是在同一 Pod 内起一个特权容器，动态 patch 运行时符号表，拦截标准库 HTTP、database/sql 等调用。
关键点：
-
OTEL_GO_AUTO_TARGET_EXE必须指向你主容器中 Go 可执行文件的绝对路径（例如/app/main），不能是相对路径或软链接 - sidecar 必须设
securityContext.privileged: true，否则无法 ptrace 目标进程；Kubernetes 1.22+ 默认禁用，需提前在节点或 PodSecurityPolicy 中放行 - 目标 Go 二进制**不能 strip 符号表**（即编译时避免用
-ldflags="-s -w"），否则探针找不到函数入口，日志里会反复报failed to find symbol main.main - sidecar 和主容器要共享 PID namespace：在 Deployment 的
spec.template.spec下加shareProcessNamespace: true
为什么不用 tencent-opentelemetry-operator？
腾讯云的 tencent-opentelemetry-operator 对 Go 语言**不支持自动注入**。它的文档和源码明确列出支持语言为 Java、Python、Node.js、.NET —— Go 被排除在外。如果你看到配置里写了 env.GO_INSTR_VERSION，那是无效字段，Operator 启动时会忽略。
误配后果：
- Operator 会静默跳过你的 Go Deployment，不加任何探针容器
- APM 后台看不到服务拓扑，只有一堆孤立的 traceID（来自手动埋点或未 instrument 的组件）
- 排查时容易误判为 collector 配置问题，实际是 operator 根本没干活
探针与 Go 应用共存时的存活/就绪探针写法
sidecar 启动比 Go 主进程慢（通常多 2–5 秒），如果 livenessProbe 直接探测 Go 服务的 /health，可能因探针提前触发导致 Pod 反复重启。
针对 Kubernetes 仪表板和 Web UI 的浏览器自动化。适用于与 Kubernetes Dashboard、Grafana、ArgoCD UI 或其他 Web 界面交互。需要设置 MCP_BROWSER_ENABLED=true。
正确做法：
- 就绪探针（
readinessProbe）仍走 Go 应用自己的/ready，确保业务逻辑就绪 - 存活探针（
livenessProbe）改用 exec 方式，检查 sidecar 是否存活：command: ["sh", "-c", "kill -0 $(cat /var/run/otel-autoinst.pid) 2>/dev/null"] - 或者统一用 HTTP 探针，但让 Go 应用暴露一个复合健康端点，内部同时检查自身状态 +
http://localhost:8888/metrics（sidecar 默认暴露的指标端口）
别漏掉 initialDelaySeconds：sidecar 初始化需要时间，建议设为 40 秒以上，避免 probe 在 autoinstrumentation 完成前就失败。
Go 编译参数与探针兼容性必须对齐
自动仪表化依赖 Go 运行时的调试信息和符号表。以下编译选项会导致探针失效：
-
-ldflags="-s -w"：彻底剥离符号和调试信息 → 探针找不到函数地址 → trace 全是unknown_function -
CGO_ENABLED=0：没问题，静态链接不影响探针工作 -
-gcflags="-N -l"：关闭优化反而有利于探针定位，调试阶段推荐保留
生产环境折中方案：保留符号表（去掉 -s），但用 -w 去掉调试信息减小体积，足够满足探针需求又不至于让二进制膨胀太多。
真正容易被忽略的是：即使你用了正确的镜像和配置，只要 Go 二进制是用 go build -ldflags="-s" 打的包，OpenTelemetry 就永远看不到 span 名称 —— 这个坑没有报错，只有空 trace，排查成本极高。
