AI 摘要：本文详细介绍了在 Node.js 应用中使用 Pino 进行生产级日志记录的全面指南。Pino 作为一种高效且快速的日志库，以其 JSON 格式输出和与现代可观测性平台的兼容性而著称。文章涵盖了 Pino 的核心功能、日志级别管理、字段自定义、上下文日志记录、序列化器和敏感数据处理、日志路由以及与 Node.js 框架和 OpenTelemetry 的集成方法。

• 引言：介绍了 Pino 自 2014 年以来的广泛应用，强调其高性能和灵活配置，Fastify 框架默认使用的日志工具。提供了安装和基本使用示例，展示了 JSON 格式输出和通过 pino-pretty 美化日志。
• Pino 日志级别：详细说明了 Pino 支持的标准日志级别（trace, debug, info, warn, error, fatal）及其对应的数值表示，默认级别为 info，并提供了通过环境变量调整日志级别的方法。
• 自定义日志级别输出：展示了如何将数值级别格式化为字符串输出，并提到后续与 OpenTelemetry 日志数据模型的集成。
• 调整 Pino 默认日志字段：介绍了如何修改默认日志字段（如时间格式、字段重命名），以及通过 formatters 自定义绑定字段（pid, hostname）或添加全局元数据（如应用版本）。
• 捕获事件和错误详情：讲解了上下文日志记录的重要性，展示了如何在 HTTP 请求中添加详细信息，并符合 OpenTelemetry 语义约定；同时介绍了如何记录 Node.js 错误及其堆栈信息。
• 使用 Pino 序列化器塑造日志：介绍了序列化器的功能，用于转换日志对象中的特定属性，包括内置序列化器（err, req, res）和自定义序列化器的创建方法。
• 敏感数据的编辑或移除：提供了使用 redact 选项自动审查或移除日志中敏感数据（如密码、信用卡信息）的方法，并支持自定义审查内容或完全移除字段。
• 使用 Pino 传输路由日志：讲解了如何通过 transport 功能将日志输出到文件或多个目标（如控制台、文件、OTLP 端点），并提及同步日志和支持的传输生态。
• 与 Node.js 框架集成：展示了 Pino 在 Fastify（默认集成，支持请求上下文追踪）和 Express（通过 pino-http 中间件）中的使用方法，包括自动日志记录和自定义配置。
• 与 OpenTelemetry 集成：介绍了通过 pino-opentelemetry-transport 将 Pino 日志转换为 OpenTelemetry 格式并发送到 OTLP 端点，支持与分布式追踪的相关性，并解决语义约定问题。

Dash0

Production-Grade Logging in Node.js with Pino · Dash0

This article explores Pinos core features integration with popular Nodejs frameworks and setting up a productiongrade logging pipeline with OpenTelemetry