portworx/temporalio-charts

Custom Temporal Charts for PDS SM Docker镜像文档

1. 镜像概述

本Docker镜像专为PDS SM（Planetary Data System Service Management）设计，提供自定义时间图表功能，旨在实现时间序列数据的可视化与分析。通过集成定制化图表展示能力，支持PDS SM环境中时间相关数据的直观呈现与集成分析需求。

2. 核心功能与特性

2.1 核心功能

• 自定义图表配置：支持用户根据需求定义图表类型（折线图、柱状图、面积图等）、时间范围及数据维度
• 时间序列数据处理：兼容标准时间序列数据格式，支持数据解析、过滤与聚合
• PDS SM集成：提供与PDS SM系统的接口适配，支持数据自动同步与展示

2.2 关键特性

• 轻量化部署：基于Docker容器化设计，简化部署与环境依赖管理
• 可扩展图表库：支持集成第三方图表组件，扩展可视化能力
• 配置驱动：通过配置文件定义图表参数，无需代码开发即可实现定制化展示

3. 使用场景与适用范围

3.1 典型使用场景

• PDS SM系统监控数据可视化：展示服务运行状态、资源利用率等时间序列指标
• 历史数据趋势分析：分析PDS SM相关业务数据的长期变化趋势
• 定制化报表生成：生成符合特定格式要求的时间图表报表

3.2 适用范围

• PDS SM环境运维与管理人员
• 需要对PDS相关时间序列数据进行可视化分析的用户
• 需快速部署时间图表功能的PDS SM集成场景

4. 使用方法与配置说明

4.1 基本部署（Docker Run）

bash
docker run -d \
  --name pds-sm-temporal-charts \
  -p 8080:8080 \
  -v ./config:/app/config \
  -e PDS_SM_API_URL="http://pds-sm-service:8080/api" \
  your-registry/custom-temporal-charts-pds-sm:latest

4.2 环境变量配置

4.3 图表配置文件格式

配置文件采用YAML格式，存放于CHART_CONFIG_DIR指定目录下，示例：

yaml
# 示例: system_metrics.yaml
chartId: "system-metrics-001"
title: "PDS SM服务资源监控"
type: "line"  # 图表类型：line, bar, area
timeRange: 
  start: "-24h"  # 相对时间范围
  end: "now"
dataSource:
  type: "api"
  url: "/metrics/system"  # PDS SM API路径（基于PDS_SM_API_URL）
  params:
    serviceId: "pds-core-service"
series:
  - name: "CPU使用率"
    field: "cpu_usage"
    unit: "%"
    color: "#ff6b6b"
  - name: "内存使用率"
    field: "mem_usage"
    unit: "%"
    color: "#4ecdc4"

4.4 访问与使用

容器启动后，通过以下地址访问图表界面：
http://<容器IP或主机名>:8080

界面功能包括：

• 图表列表展示
• 图表详情查看与交互（缩放、时间范围调整）
• 配置文件上传与更新

5. 数据集成说明

本镜像通过以下方式与PDS SM系统集成：

1. 基于PDS_SM_API_URL调用PDS SM提供的时间序列数据API
2. 支持通过配置文件定义数据请求参数与字段映射
3. 数据缓存机制：默认缓存最近1小时数据，减少API请求频次

注：需确保PDS SM系统已启用时间序列数据API接口，具体规范请参考PDS SM开发文档。