C++项目在CentOS如何日志管理

C++项目在 CentOS 的日志管理实践

一方案总览与选型

标准库直写：使用写文件，简单可控，适合小型工具或学习场景，生产环境建议引入更完善的库以获得日志级别、格式化、轮转、线程安全等能力。
第三方日志库：优先选用成熟库，如 spdlog、glog、Boost.Log、log4cpp。其中 spdlog 性能优秀、功能完备、易于集成；glog 稳定可靠、带 crash 处理；Boost.Log 功能最丰富但学习曲线较陡；log4cpp 传统稳定、配置灵活。
系统日志：对接 syslog/journald，便于集中化采集与运维联动。
日志轮转：应用内轮转（如按天/按大小）与系统级 logrotate 结合使用，避免单文件过大、便于保留策略统一。

二快速上手示例

标准库直写（最小可用）

要点：打开文件使用 std::ios_base::app 追加；每条日志带上时间戳；注意线程安全与文件打开失败处理。

示例：

#include <fstream>
#include <iostream>
#include <string>
#include <ctime>
#include <mutex>

std::mutex log_mtx;
void logMessage(const std::string& msg) {
    std::lock_guard<std::mutex> lk(log_mtx);
    std::ofstream of("app.log", std::ios_base::app);
    if (!of) { std::cerr << "无法打开日志文件\n"; return; }
    time_t now = time(nullptr);
    char buf[64];
    strftime(buf, sizeof(buf), "%F %T", localtime(&now));
    of << "[" << buf << "] " << msg << '\n';
}
int main() { logMessage("程序启动"); return 0; }

使用 spdlog（高性能、功能全）

安装（示例）：在 CentOS 7/8 可启用 EPEL 后安装开发包（若仓库提供），或从源码构建：

sudo yum install -y epel-release cmake gcc-c++
git clone https://github.com/gabime/spdlog.git
cd spdlog && mkdir build && cd build
cmake -DCMAKE_BUILD_TYPE=Release ..
make -j$(nproc) && sudo make install

示例（同步文件日志 + 控制台）：

#include "spdlog/spdlog.h"
#include "spdlog/sinks/basic_file_sink.h"
#include "spdlog/sinks/stdout_color_sinks.h"

int main() {
    auto file = spdlog::basic_logger_mt("file", "logs/app.log");
    auto console = spdlog::stdout_color_mt("console");
    spdlog::set_default_logger(file);
    spdlog::set_level(spdlog::level::debug);
    file->set_pattern("[%Y-%m-%d %H:%M:%S] [%l] %v");
    console->set_pattern("[%H:%M:%S] [%^%l%$] %v");

    SPDLOG_INFO("服务启动，版本={}", "1.2.3");
    SPDLOG_WARN("磁盘余量低: {}%", 6);
    SPDLOG_ERROR("初始化失败: {}", "配置缺失");
    return 0;
}

编译链接：

g++ -std=c++11 -O2 -o myapp main.cpp -lspdlog

写入 syslog/journald

使用 syslog API：

#include <syslog.h>
int main() {
    openlog("myapp", LOG_PID | LOG_CONS, LOG_USER);
    syslog(LOG_INFO, "服务启动，pid=%d", getpid());
    closelog();
    return 0;
}

使用 systemd-journal（需链接 libsystemd）：

#include <systemd/sd-journal.h>
int main() {
    sd_journal_send("MESSAGE=服务启动", "PRIORITY=%i", LOG_INFO, NULL);
    return 0;
}

作为 systemd 服务输出到 journal：

[Unit]
Description=My C++ App

[Service]
ExecStart=/usr/local/bin/myapp
StandardOutput=journal
StandardError=journal
SyslogIdentifier=myapp

[Install]
WantedBy=multi-user.target

查看：journalctl -u myapp.service -f。

三日志轮转与保留策略

应用内轮转（以 spdlog 为例）

按天轮转：

auto daily = spdlog::daily_logger_mt("daily", "logs/app.log", 2, 30); // 每日 02:30 切分
daily->set_level(spdlog::level::info);

按大小轮转（需包含对应 header，如 rotating_file_sink）：

// 示例：按 10MB、保留 7 个文件
// auto rotating = spdlog::rotating_logger_mt("rot", "logs/app.log", 10*1024*1024, 7);

系统级 logrotate（与程序解耦、集中管理）
- 新建配置 /etc/logrotate.d/myapp：
```
/var/log/myapp/*.log {
    daily
    rotate 7
    compress
    missingok
    notifempty
    create 0640 myapp myapp
    copytruncate
}
```
- 说明：生产上更推荐 copytruncate 以避免应用持有文件句柄导致轮转失败；若应用支持 reopen 信号（如 SIGHUP），也可使用 postrotate 执行 kill -HUP <pid> 触发重开。
- 测试：logrotate -d /etc/logrotate.d/myapp（干跑），logrotate -f /etc/logrotate.d/myapp（强制执行）。

四作为 systemd 服务时的日志最佳实践

将日志输出到 journal：在单元文件中设置 StandardOutput=journal、StandardError=journal，并用 SyslogIdentifier=your_app 统一标识；通过 journalctl -u your_app.service -f 实时查看。
结构化字段：使用 sd_journal_send 增加如 PRIORITY、MESSAGE、CODE_LINE、CODE_FUNC 等字段，便于检索与聚合。
避免重复落盘：若已接入 journal，通常不再同时写本地文件，减少 I/O 争用与磁盘占用。
权限与目录：确保运行用户对日志目录（如 /var/log/myapp）具备写权限，必要时在单元文件中配置 User=、Group=。

五性能与安全建议

选择异步日志：高并发/低延迟场景优先 spdlog 异步 或 g3log 等异步日志器，降低主线程阻塞；注意最坏情况延迟与队列满策略。
合理级别与采样：生产环境默认 INFO/WARN，调试期开启 DEBUG；对高频调试日志可采样或动态降级。
统一格式：包含 时间、级别、线程/协程ID、文件:行号、函数名、消息；便于检索与链路追踪。
可靠性：关键路径使用崩溃安全的日志器（如 g3log 可捕获致命错误）；确保日志目录与磁盘监控与告警到位。
资源控制：限制单个日志文件大小与保留天数；对外部系统（如 syslog）设置合适的缓冲与批量发送策略。

最新问答

相关标签