smpio/ps-report

ps-report镜像说明

镜像概述

ps-report是一个守护进程镜像，用于定期采集系统中运行进程的信息，并将cgroup相关数据持久化到PostgreSQL数据库。它解决了OOM事件仅显示PID和进程名而无容器名的问题，帮助用户在Linux容器集群环境中快速定位OOM事件根源。

核心功能

• 定期收集所有运行进程的详细信息
• 将cgroup数据发送至PostgreSQL数据库存储
• 支持自定义轮询间隔、数据库连接URL和主机名前缀

使用场景

适用于Linux容器集群环境中，需要分析OOM事件与容器关联关系的场景，帮助运维人员高效排查内存不足问题。

配置说明

镜像支持以下命令行参数：

• -db-url string：PostgreSQL数据库连接URL（必填）
• -hostname string：Redis键前缀使用的主机名（默认值：docker-desktop）
• -poll-interval uint：进程信息轮询间隔（单位：秒，默认值：60）

部署示例

Docker Run命令

bash
docker run --pid=host \
  docker.xuanyuan.run/smpio/ps-report \
  -db-url "postgres://username:password@db-host:5432/ps_report_db" \
  -hostname "cluster-node-01" \
  -poll-interval 30

注意：必须添加--pid=host参数以使用主机PID命名空间，确保进程信息采集的完整性。