3. 配置文件使用说明

3.1. 默认配置文件

MXMACA SDK安装完成后，默认配置文件为/opt/maca/etc/default-counters.csv。

表 3.1 默认配置文件表头说明

名称

可修改

含义

metric id

否

指标ID，用于识别指标的唯一标识符

metric type

否

指标类别，如Gauge

metric name

是

指标名称，可根据实际需要修改

metric description

是

指标描述，可根据实际需要修改

label

是

指标标签，用于筛选指标所需展示的信息

只能更改名称，不能更改顺序及增删
表 3.2 默认配置文件中mx_chip_hotspot_temp指标示例

# Format: metric id

metric type

metric name

metric description

label

# temperature

chip_hotspot_temp

Gauge

mx_chip_hotspot_temp

Chip hotspot temperature

deviceId, uuid, exported_pod, exported_namespace, exported_container, Hostname, driver_version, bios_version, modelName.

3.2. 修改配置文件

3.2.1. 自定义指标集

操作步骤

  1. 打开mx-exporter.xxx.tgz压缩包解压后的mx-exporter/config/default-counters.csv。

  2. 在不需要监控的指标行前加“#”注释，保存文件。

  3. 运行 mx-exporter -c 指定文件。

  4. 看到抓取的指标中，不包含已经注释掉的指标信息。

3.2.2. 修改指标名称、指标描述及标签

操作步骤

  1. 打开mx-exporter.xxx.tgz压缩包解压后的mx-exporter/config/default-counters.csv。

  2. 修改 metric name、metric description 及 label 列信息，保存文件。

  3. 运行 mx-exporter -c 指定文件。

  4. 看到抓取的指标中，指标名称、指标描述及指标标签已更改为期望的内容。

    备注

    • 修改标签时只能更改名称，不能更改顺序及增删。

    • 修改指标名称及标签的规范，请参考Prometheus相关文档。

示例

以 mx_chip_hotspot_temp 指标为例，修改如下：

指标名称mx_chip_hotspot_temp修改为metax_chip_hotspot_temp
指标描述Chip hotspot temperature修改为Metax Chip hotspot temperature
指标标签deviceId修改为mx_deviceId
指标标签modelName修改为mx_modelName

运行mx-exporter后，得到的数据显示如下：

#HELP metax_chip_hotspot_temp Metax Chip hotspot temperature
#TYPE metax_chip_hotspot_temp gauge
metax_chip_hotspot_temp\ {Hostname="xx",bios_version="1.16.0.0", mx_modelName\ ="MXC500", mx_deviceId\ ="0",driver_version="2.6.0",exported_container="",exported_namespace="",exported_pod="",uuid="xx"} 35.75