opensciencegrid/gracc-osg-reports

GRACC OSG Reports Docker镜像文档

镜像概述

gracc-osg-reports Docker镜像是用于运行一组报告工具的容器化解决方案，这些工具从Open Science Grid (OSG)监控系统GRACC收集并向OSG利益相关者展示数据。该报告工具集此前与底层库https://github.com/opensciencegrid/gracc-reporting%E4%B8%80%E8%B5%B7%E6%89%93%E5%8C%85%EF%BC%8C%E7%8E%B0%E5%88%86%E7%A6%BB%E4%B8%BA%E7%8B%AC%E7%AB%8B%E9%A1%B9%E7%9B%AE%EF%BC%8C%E4%BB%A5%E6%94%AF%E6%8C%81%E6%8A%A5%E5%91%8A%E6%88%96%E4%BE%9D%E8%B5%96%E5%BA%93%E7%9A%84%E7%8B%AC%E7%AB%8B%E5%BC%80%E5%8F%91%E3%80%82

核心功能与特性

主要功能

• 提供多种预定义报告，满足OSG利益相关者对监控数据的不同需求
• 支持灵活配置报告参数，包括时间范围、报告类型、输出方式等
• 集成日志功能，可指定日志文件位置或默认输出到stdout

关键特性

• 独立运行：通过Docker容器化，无需单独安装gracc-osg-reports及依赖库
• 灵活配置：支持通过命令行参数指定配置文件(-c)、模板文件(-T)、日志文件(-L)
• 调试支持：提供dryrun(-d，测试模式)、no email(-n，不发送邮件)、verbose(-v，详细输出)等标志
• 多报告类型：包含项目使用报告、缺失项目报告、站点使用报告等多种报告工具

使用场景

• OSG项目管理员查看特定项目的资源使用情况
• 站点管理员监控本站点的资源贡献数据
• OSG运营团队跟踪探针状态及 opportunistic 计算资源提供情况
• 利益相关者定期获取GRACC系统生成的各类统计报告

使用方法

镜像获取

bash
docker pull opensciencegrid/gracc-osg-reports:2.0

运行容器

以交互方式运行容器并进入shell：

bash
docker run -it opensciencegrid/gracc-osg-reports:2.0 /bin/sh

报告运行示例

容器内报告工具安装于/opt/gracc-osg-reports，可直接执行以下命令运行各类报告：

OSG项目使用报告

bash
# 示例1：指定时间范围和项目，测试模式运行
osgprojectreport -s 2016-12-06 -e 2016-12-13 -r OSG-Connect -d -v -n

# 示例2：查看XD项目的缺失项目情况
osgprojectreport -s 2016-12-06 -e 2016-12-13 -r XD -d -v -n

缺失项目报告

bash
osgmissingprojects -s 2016-12-06 -e 2017-01-31 -r XD -d -n -v

每站点使用报告

bash
osgpersitereport -s 2016/10/01 -d -v -n

OSG Flocking报告

bash
osgflockingreport -s 2016-11-09 -e 2016-11-16 -d -v -n

探针状态报告（过去两天未报告的Gratia探针）

bash
osgprobereport -d -n -v

Opportunistic Hours顶级提供者报告（新闻报告）

• 按月统计：

  bash
  osgtopoppusagereport -m 2 -N 20 -d -v -n
  

• 按指定日期范围统计：

  bash
  osgtopoppusagereport -s "2016-12-01" -e "2017-02-01" -N 20 -d -v -n
  

配置说明

命令行参数

所有报告工具支持以下通用参数：

自定义配置

镜像包含Dockerfile和docker-compose文件，可根据实际需求修改以适应不同部署环境。如需调整报告的默认行为，可通过修改配置文件或模板文件实现。