otel-cli

OpenTelemetry 链路与命令追踪

补充说明

otel-cli 通过 OTLP 发送 span，适合给 shell 脚本、CI 步骤和一次性命令加追踪。它不替代 SDK，主要用于轻量埋点和验证 Collector。

常用示例

otel-cli status
otel-cli exec --service build --name compile -- ./build.sh
otel-cli span --service deploy --name release --start now --end now
otel-cli span start --service app --name request
otel-cli span end --service app --name request
otel-cli span --endpoint http://otel-collector:4317 --service app --name test

易错点与排错

• 需要可用的 OTLP endpoint；默认地址不通时会静默失败或超时。
• gRPC（4317）和 HTTP（4318）协议不同；--protocol 要和 Collector 匹配。
• span start 和 span end 要成对使用，否则 span 不完整或一直未结束。
• 采样、认证和 TLS 配置要覆盖；生产 Collector 通常不是明文端口。
• span 属性和资源标签要统一命名，便于后端筛选。
• otel-cli 不是长期运行的 agent；不要把它当 Collector 或 SDK 用。
• 命令执行失败时仍要发送错误状态；脚本里要处理退出码。

相关命令

• opentelemetry-collector — Collector 服务
• promtool — Prometheus 规则
• logcli — Loki 查询