可观测学堂

可观测技术指南

从概念、接入到生产治理,提供可执行、可验证的工程方法。

OpenTelemetry 语义约定:让遥测数据说同一种语言 cover
技术指南

OpenTelemetry 语义约定:让遥测数据说同一种语言

OpenTelemetry 语义约定(Semantic Conventions)统一了遥测属性与事件的命名规范(如 service.name、http.request.method),让不同语言、不同框架产出的数据可以互相对齐。

OpenTelemetry 敏感数据脱敏:在 Collector 中保护隐私数据 cover
技术指南

OpenTelemetry 敏感数据脱敏:在 Collector 中保护隐私数据

遥测数据常意外携带 Cookie、Token、用户信息等敏感数据。本文讲解用 OpenTelemetry Collector 的 attributes、redaction、transform 三种 processor 实现字段删除、…

OpenTelemetry 指标详解:Instruments、聚合与导出 cover
技术指南

OpenTelemetry 指标详解:Instruments、聚合与导出

OpenTelemetry Metrics 通过 Counter、UpDownCounter、Histogram、Observable Gauge 四种仪器采集指标,经聚合后由 Reader 导出。

OpenTelemetry vs Prometheus:定位、差异与协同 cover
技术指南

OpenTelemetry vs Prometheus:定位、差异与协同

OpenTelemetry 与 Prometheus 是可观测性领域最常见的两个开源项目,但定位不同:OTel 统一遥测数据的生产与传输,Prometheus 专注指标的抓取、存储与告警。本文系统对比两者,并给出共存与迁移建议。

OpenTelemetry 指标 vs Prometheus 指标:数据模型的深度对比 cover
技术指南

OpenTelemetry 指标 vs Prometheus 指标:数据模型的深度对比

OpenTelemetry 与 Prometheus 的指标数据模型在时间戳语义、累加方式、直方图结构上存在本质差异,直接影响速率计算与查询结果。本文深入对比两者数据模型,帮助你在迁移或混用时避开数值误读的坑。

OpenTelemetry Demo 实战:用官方微服务演示应用学 OTel cover
技术指南

OpenTelemetry Demo 实战:用官方微服务演示应用学 OTel

OpenTelemetry Demo(Astronomy Shop)是官方维护的多语言微服务演示应用,内置完整埋点,是学习 OTel 数据采集与导出的最佳实验场。本文讲解 Demo 架构、本地启动方法,以及如何把它的遥测数据导入观测云分析。

OpenTelemetry 上下文传播详解:traceparent 如何让 Trace 跨服务不断链 cover
技术指南

OpenTelemetry 上下文传播详解:traceparent 如何让 Trace 跨服务不断链

上下文传播是分布式追踪的生命线——没有它,每个服务都是一座孤岛。本文讲清 Trace Context 与 Span Context 的构成、W3C traceparent/tracestate 标准,以及 HTTP、gRPC、消息队…

OpenTelemetry 采样详解:头部采样与尾部采样怎么选 cover
技术指南

OpenTelemetry 采样详解:头部采样与尾部采样怎么选

全量采集链路在高并发下成本高企,采样是控制可观测性支出的核心手段。本文系统对比头部采样(Head-based)与尾部采样(Tail-based)的原理、优劣与 OpenTelemetry 实现方式,并给出结合观测云控制链路成本的落地建议。

OTTL 实战手册:10 个即用型遥测数据转换模式 cover
技术指南

OTTL 实战手册:10 个即用型遥测数据转换模式

OTTL(OpenTelemetry 转换语言)是 Collector 中处理遥测数据的瑞士军刀。

如何监控 OpenTelemetry Collector:管道健康、资源与错误三板斧 cover
技术指南

如何监控 OpenTelemetry Collector:管道健康、资源与错误三板斧

Collector 是可观测性管道的心脏,它一出问题,全公司的监控数据都会静默丢失。

OpenTelemetry 最佳实践:从自动埋点到采样策略的完整清单 cover
技术指南

OpenTelemetry 最佳实践:从自动埋点到采样策略的完整清单

OpenTelemetry 功能强大但配置项繁多,踩坑往往从"自由发挥"开始。本文总结四大类生产最佳实践——自动埋点起步、属性与上下文管理、Collector 部署模式、智能采样策略,帮助团队少走弯路,并给出观测云平台上的对应落地方式。

OpenTelemetry 对接 Prometheus 后端:OTLP 直推的配置与数据模型避坑 cover
技术指南

OpenTelemetry 对接 Prometheus 后端:OTLP 直推的配置与数据模型避坑

Prometheus 3.0 起原生支持 OTLP 接收,OpenTelemetry 指标可以直接推入 Prometheus。