opencensus已停止维护，golang生态中不再推荐使用；因其存在view无法热更新、指标静默丢弃、高并发panic、exporter长期未适配新prometheus语义等问题，而opentelemetry修复了资源泄漏、采样不一致和线程安全等缺陷，并提供稳定生产级指标聚合能力。
OpenCensus 已停止维护，Golang 生态中不再推荐将其用作指标聚合器。2023 年底起，OpenCensus 与 OpenTracing 正式合并为 OpenTelemetry，所有新项目应直接使用 OpenTelemetry SDK —— 它兼容原有 OpenCensus 的指标模型（如 View、Measure），但修复了资源泄漏、采样不一致、导出器线程安全等长期问题。
为什么不能继续用 opencensus-go 做指标聚合？
你可能会看到旧文档里用 stats.Record + view.Register 聚合指标，但实际运行中容易遇到：
• view.Exporter 启动后无法热更新或重新注册，重启服务才能生效
• stats.Int64Measure 创建后若未显式绑定 View，指标数据会静默丢弃（无报错）
• Prometheus exporter 在高并发下出现 concurrent map iteration and map write panic（尤其在动态注册/注销 View 时）
• 所有内置 exporter（如 prometheus、stackdriver）已多年未更新，不支持 Prometheus 2.30+ 的 histogram bucket 语义
go.opencensus.io/stats/view 迁移到 go.opentelemetry.io/otel/metric 的最小改动点
不是重写，而是替换关键初始化和上报逻辑：
• 删除 import "go.opencensus.io/stats/view"，改用 import "go.opentelemetry.io/otel/metric"
• 原 view.Register() 替换为 meter := global.Meter("my-service") + counter := meter.NewInt64Counter("http.requests.total")
• 原 stats.Record(ctx, mLatency.M(123.4)) 改为 counter.Add(ctx, 1, metric.WithAttributes(attribute.String("status", "200")))
• 不再需要手动调用 view.SetReportingPeriod：OTel SDK 内置周期性采集，默认 10s，可通过 metric.WithPeriod 调整
• Prometheus endpoint 从 /metrics（需自行注册 prometheus.Handler()）变为直接复用 otelmetric.MustNewPrometheusExporter，自动注册到 http.ServeMux
初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
Go 应用启动时初始化 OTel 指标 SDK 的实操要点
避免常见卡点：
• 必须在 main() 开头尽早调用 otelmeter.MustNewPrometheusExporter，否则后续 global.Meter 返回空实现
• 若同时用 tracing 和 metrics，不要混用 otelsdktrace.NewTracerProvider 和 otelsdkmetric.NewMeterProvider 的独立资源；统一用 resource.NewWithAttributes 注入 service.name 等标签，否则 Prometheus label 对齐失败
• metric.WithAttributeSet 比 metric.WithAttributes 更高效，适合固定 label 组合（如 attribute.String("http.method", "GET")）
• 避免在 hot path 上重复调用 meter.NewInt64Counter：它返回的是可复用对象，应在 init 或 struct 初始化阶段创建一次
如何验证指标是否真正被聚合并导出？
别只看日志或进程存活：
• curl http://localhost:2222/metrics（假设 Prometheus exporter 绑定在此端口），确认输出含 # TYPE http_requests_total counter 及对应样本行
• 检查 http_requests_total{service_name="my-service",status="200"} 是否随请求递增，而非恒为 0
• 在代码中临时插入 log.Printf("metric provider: %+v", global.GetMeterProvider())，确认非 nil 且包含 exporter 字段
• 如果用 Kubernetes + Prometheus Operator，确保 ServiceMonitor 中 targetLabels 包含 service-name，否则指标不会被 scrape 到
OpenCensus 的指标路径看似简单，但真实压测或长周期运行时，聚合丢失、label 错位、Exporter hang 问题频发。OpenTelemetry 不是“另一个选择”，而是当前唯一能稳定支撑生产级指标采集的 Go SDK —— 迁移成本远低于排查三天没定位到的指标静默丢弃问题。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
