bwsw/cs-pulse-server

cs-pulse-server镜像说明

镜像概述

cs-pulse-server是基于Scalatra框架的RESTful服务器，用于处理bwsw/cs-pulse-sensor的数据馈送，支持系统资源数据的聚合与查询。该镜像无需外部数据库（除InfluxDB），可通过Docker容器快速部署，适用于运维监控场景。

核心功能

1. 支持多种资源查询：提供CPU时间、RAM利用率、网络接口、磁盘利用率的RESTful GET接口；
2. 灵活的数据聚合：可配置时间范围（如15m、1h、1d）和聚合粒度（如1m、5m），满足不同分析需求；
3. 性能优化：通过Nginx实现请求缓存（默认10秒）和速率限制（默认20次/秒）；
4. JSON响应：所有查询结果以JSON格式返回，便于集成到其他系统；
5. 环境变量配置：支持通过环境变量设置InfluxDB连接信息、缓存时间等参数。

使用场景

适用于服务器或虚拟机的资源监控场景，可用于：

• 运维团队查询系统资源历史数据；
• 监控工具集成，获取CPU、内存、网络、磁盘的实时与聚合数据；
• 资源使用趋势分析，辅助容量规划。

配置说明

环境变量

• INFLUX_URL：InfluxDB服务地址（如http://localhost:8086/）；
• INFLUX_USER：InfluxDB用户名；
• INFLUX_PASSWORD：InfluxDB密码；
• INFLUX_DB：存储数据的InfluxDB数据库名；
• NGINX_CACHE_TIME：Nginx缓存时间（如15s）；
• NGINX_RATE_LIMIT：Nginx请求速率限制（如20次/秒）。

配置文件示例

hocon
pulse_config {
  influx {
    url =  "http://localhost:8086"
    url = ${?INFLUX_URL}
    username = "username"
    username = ${?INFLUX_USER}
    password = "password"
    password = ${?INFLUX_PASSWORD}
    database = "database"
    database = ${?INFLUX_DB}
  }
  scales = [
    { range = "15m", aggregation = ["1m", "5m"] },
    { range = "30m", aggregation = ["1m", "5m", "15m"] },
    { range = "1h", aggregation = ["1m", "5m", "15m"] },
    { range = "2h", aggregation = ["5m", "15m", "30m"] },
    { range = "4h", aggregation = ["5m", "15m", "30m", "1h"] },
    { range = "12h", aggregation = ["15m", "30m", "1h"] },
    { range = "1d", aggregation = ["30m", "1h"] },
    { range = "1w", aggregation = ["1h", "4h"] },
    { range = "30d", aggregation = ["4h", "1d"] },
    { range = "3h", aggregation = ["4m", "6m"] }
  ]
  shifts = ["m", "h", "d"]
}

Docker部署示例

拉取镜像

bash
docker pull bwsw/cs-pulse-server

运行容器

bash
docker run --restart=always -d --name pulse-server \
    -e INFLUX_URL=http://localhost:8086/ \
    -e INFLUX_USER=puls \
    -e INFLUX_PASSWORD=secret \
    -e INFLUX_DB=puls \
    -e NGINX_CACHE_TIME=15s \
    -e NGINX_RATE_LIMIT=20 \
    -v /path/to/app.conf:/etc/pulse/application.conf \
    -p 80:9090 bwsw/cs-pulse-server

请求示例

CPU时间查询

http
GET http://hostname/cputime/550e8400-e29b-41d4-a716-446655440000/1d/1h/1w

响应示例

json
{
    "measurement": "cputime",
    "uuid": "550e8400-e29b-41d4-a716-446655440000",
    "range": "1d",
    "aggregation": "1h",
    "shift": "1w",
    "results": [
        {"cpu": 50},
        {"cpu": 70},
        {"cpu": 40}
    ]
}