SchemaStore项目metricshub.json配置文件规范更新解析

在SchemaStore项目中，metricshub.json作为监控工具MetricsHub的核心配置文件，其JSON Schema定义近期经历了一次重要更新。本文将深入解析此次更新的技术细节，帮助开发者更好地理解和使用新版配置文件。

日志级别配置优化

原配置文件中loggerLevel属性的"off"级别定义存在不明确问题，现已修正。同时，默认日志级别从"error"调整为更合理的默认值。日志级别现在支持以下标准选项：

• off：完全关闭日志输出
• error：仅显示错误信息
• warn：显示警告及以上级别
• info：显示常规信息及以上级别
• debug：显示调试信息及以上级别

状态集压缩策略

新增stateSetCompression配置项，支持两种压缩策略：

1. suppressZeros：自动压缩零值数据，减少输出体积
2. none：保持原始数据，不做任何压缩处理

补丁目录配置

patchDirectory配置项现在明确要求使用字符串类型路径，支持相对或绝对路径指定补丁文件存放位置。

连接器扩展机制

additionalConnectors配置项进行了重大重构，采用更灵活的结构化定义方式：

"additionalConnectors": {
  "CustomConnector1": {
    "uses": "BaseConnector",
    "variables": {
      "timeout": "30",
      "retries": "3"
    },
    "force": false
  }
}

关键特性包括：

• uses属性指定基础连接器类型（可选，默认为自定义ID）
• variables支持参数覆写
• force标志控制是否强制覆盖同名连接器（默认true）

监控过滤器示例

monitorFilters配置项现在提供标准数组结构示例，开发者可以参照示例配置多个过滤条件：

"monitorFilters": [
  {
    "type": "regex",
    "pattern": ".*_total$",
    "action": "exclude"
  },
  {
    "type": "prefix",
    "value": "http_",
    "action": "include"
  }
]

主机名解析策略

resolveHostnameToFqdn配置项的默认值从true调整为false，这意味着：

• 默认情况下不再自动将主机名解析为FQDN全称
• 需要完全限定域名时必须显式设置为true

JDBC连接配置规范

新增了完整的JDBC配置Schema，支持以下参数：

• driverClassName：JDBC驱动类名
• url：数据库连接字符串
• username：数据库用户名
• password：数据库密码（建议使用加密形式）
• connectionProperties：额外的连接属性键值对

重试间隔配置修正

retryIntervals配置项从原先的模糊定义调整为明确的整数数组格式：

"retryIntervals": [1000, 3000, 5000]

表示首次重试间隔1秒，第二次3秒，第三次5秒的渐进式重试策略。

升级建议

对于现有用户升级到新版配置：

1. 检查loggerLevel配置，确保使用标准级别
2. 显式设置resolveHostnameToFqdn以避免行为变更
3. 将retryIntervals转换为数组格式
4. 考虑使用新的stateSetCompression优化数据传输
5. 按照新规范重构additionalConnectors配置

这些改进使MetricsHub配置更加规范明确，同时提供了更强的灵活性和可扩展性，为复杂监控场景提供了更好的支持。