C++ 中的可观测性：面向专业人士的追踪、指标和日志

深入你的 C++ 代码内部：为什么可观测性不是奢侈品，而是必需品

想象一下：你启动了一个高负载的 C++ 服务。一小时、两小时、一天过去了——一切运行顺畅。然后突然——砰！——用户抱怨速度变慢，而你只能猜测：瓶颈在哪里？在内存？在网络？还是有人忘了释放资源？没有可观测性系统，你就像一艘舷窗被封死的船长。你感觉出了问题，但看不到具体是什么。

C++ 中的可观测性就是你的潜望镜和雷达系统。它不仅仅是日志记录，而是三大支柱：追踪、指标和日志。在本文中，我们将通过实际代码示例逐一剖析它们，展示如何让 C++ 与 OpenTelemetry 和 Prometheus 协同工作，并提供生产环境下的现成方案。开始吧！

可观测性的三大支柱：追踪、指标、日志

在深入代码之前，让我们明确定义这些概念的区别以及它们如何相互补充。许多人将可观测性与简单的日志记录混为一谈——这是错误的。这就像拿手电筒和探照灯系统相比。

\n
• 日志是事件。“发生了什么？”（例如，“用户已登录”或“数据库连接错误”）。它们很详细，但如果没有上下文可能毫无用处。
\n
• 指标是数字。“有多少？”（每秒请求数、CPU 使用率、响应时间）。它们是聚合的，显示趋势。
\n
• 追踪是请求的路径。“具体是如何发生的？”（从进入服务到调用数据库再到响应客户端）。它是连接日志和指标的纽带。
\n

理想的 C++ 可观测性是：当你查看仪表盘时，能在 10 秒内理解异常发生的地点、时间和原因。没有它，你将在生产环境中玩猜谜游戏。

C++ 中的追踪：如何集成 OpenTelemetry

我们从最强大但也最复杂的工具——追踪开始。OpenTelemetry 是遥测数据收集的事实标准。在 C++ 中，它的支持不如 Go 或 Java 丰富，但运行稳定。

假设我们有一个简单的 C++ HTTP 服务器（使用概念而非特定库）。我们需要跟踪每个请求的处理时间以及内部发生的调用。

在 C++ 中配置 OpenTelemetry

首先安装依赖项。在 CMakeLists.txt 中添加：

find_package(opentelemetry-cpp REQUIRED)\ntarget_link_libraries(my_app PRIVATE opentelemetry::api opentelemetry::exporter_ostream)

现在创建追踪器和 span（span 是工作单元）。这是一个最小示例：

#include <opentelemetry/trace/provider.h>\n#include <opentelemetry/exporters/ostream/span_exporter.h>\n#include <opentelemetry/sdk/trace/tracer_provider.h>\n#include <opentelemetry/sdk/trace/simple_processor.h>\n\nnamespace trace_api = opentelemetry::trace;\nnamespace trace_sdk = opentelemetry::sdk::trace;\nnamespace trace_exporter = opentelemetry::exporter::trace;\n\nvoid init_tracer() {\n    auto exporter = std::unique_ptr<trace_sdk::SpanExporter>(\n        new trace_exporter::OStreamSpanExporter(std::cout));\n    auto processor = std::unique_ptr<trace_sdk::SpanProcessor>(\n        new trace_sdk::SimpleSpanProcessor(std::move(exporter)));\n    auto provider = std::make_shared<trace_sdk::TracerProvider>(std::move(processor));\n    trace_api::Provider::SetTracerProvider(provider);\n}\n\nvoid process_request(const std::string& user_id) {\n    auto tracer = trace_api::Provider::GetTracerProvider()->GetTracer("my_service");\n    auto span = tracer->StartSpan("process_request");\n    span->SetAttribute("user.id", user_id);\n\n    // 模拟工作\n    std::this_thread::sleep_for(std::chrono::milliseconds(100));\n\n    span->End();\n}\n\nint main