Cyberpower UPS JSON解析至InfluxDB/Grafana：电池状态解析难题

嘿，这个问题我之前帮朋友处理过类似的，核心就是带逗号的字符串值在某些解析工具里容易被误处理，咱们一步步来搞定它：

先确认JSON格式是否标准 #

首先得确保你的Cyberpower UPS代理输出的是标准JSON——比如电池状态字段必须用双引号包裹，像这样：

{
  "battery_status": "Normal, Fully Charged",
  "load_percent": 50,
  "battery_voltage": 13.2
}

如果代理输出的是单引号或者没加引号的格式，那先得修复代理的输出，不然任何解析工具都会出问题。

针对Telegraf（InfluxDB常用采集工具）的解决方案 #

如果你是用Telegraf来采集数据导入InfluxDB，大概率是配置里的小问题导致的。默认情况下Telegraf的json插件会正确解析带逗号的字符串，但要注意这几点：

• 不要把battery_status加到tag_keys里（标签值一般不建议带特殊字符，而且会被当成标签处理可能有分割问题），把它作为字段采集就好。
• 检查你的Telegraf配置，确保没有开启类似csv_tag_fields这种会分割字符串的选项。

示例正确配置：

[[inputs.http]]
  urls = ["http://your-ups-proxy-ip:port/your-endpoint"]
  data_format = "json"
  # 把需要作为标签的字段放这里，比如UPS名称
  tag_keys = ["ups_device_name"]
  # 明确指定要采集的字段，确保包含battery_status
  fieldpass = ["battery_status", "load_percent", "battery_voltage"]

这样配置后，Telegraf会把battery_status作为完整的字符串字段写入InfluxDB，不管里面有没有逗号。

用脚本预处理JSON（比如jq） #

如果你的采集流程里有脚本环节，可以用jq来预处理JSON，把逗号替换成其他符号（比如分号），避免解析工具误判：

# 假设从代理获取JSON并处理后输出
curl http://your-ups-proxy-url/json | jq '.battery_status = (.battery_status | gsub(",", ";"))'

处理后battery_status就变成了"Normal; Fully Charged"，完全不会有解析问题，而且语义也不会丢失。

自定义代码解析（比如Python） #

如果是自己写代码解析JSON，那完全不用担心——标准的JSON解析器会正确处理带逗号的字符串值。比如Python代码示例：

import json
import requests
from influxdb_client import InfluxDBClient, Point

# 获取UPS JSON数据
response = requests.get("http://your-ups-proxy-url/json")
ups_data = response.json()

# 提取电池状态
battery_status = ups_data.get("battery_status", "unknown")

# 写入InfluxDB
with InfluxDBClient(url="http://your-influxdb-url:8086", token="your-token", org="your-org") as client:
    write_api = client.write_api()
    point = Point("ups_metrics") \
        .tag("ups_name", "Cyberpower_XYZ") \
        .field("battery_status", battery_status) \
        .field("load_percent", ups_data["load_percent"])
    write_api.write(bucket="your-bucket", record=point)

这里battery_status会被完整读取为字符串，不管里面有没有逗号，直接写入InfluxDB即可。

最后验证 #

导入后在Grafana里查询的时候，直接用battery_status字段就行，它会显示完整的字符串值，不管是Discharging还是Normal, Fully Charged。

内容的提问来源于stack exchange，提问作者eptesicus