JSON 整理与类型生成可运行案例
监控指标:从样本起草 Draft-07 Schema
从 监控指标 的样本推断字段与类型。样本无法证明全部必填项、合法范围和业务状态,发布前应补正常与异常样本,再用 Schema 校验工具核对。
试一试
在完整工具中打开 ↗示例工作台
JSON 整理与类型生成修改下方数据后重新运行
运行结果
{
"$schema": "http://json-schema.org/draft-07/schema#",
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"data": {
"type": "object",
"properties": {
"series": {
"type": "array",
"items": {
"type": "object",
"properties": {
"metricId": {
"type": "string"
},
"metricName": {
"type": "string"
},
"value": {
"type": "integer"
},
"healthy": {
"type": "boolean"
},
"unit": {
"type": "string"
},
"labels": {
"type": "object",
"properties": {
"region": {
"type": "string"
},
"routes": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"region",
"routes"
]
}
},
"required": [
"metricId",
"metricName",
"value",
"healthy",
"unit",
"labels"
]
}
},
"summary": {
"type": "object",
"properties": {
"total": {
"type": "integer"
},
"note": {
"type": "null"
}
},
"required": [
"total",
"note"
]
}
},
"required": [
"series",
"summary"
]
}
},
"required": [
"ok",
"data"
]
}原例已核验,可修改输入后重新运行。
⌘ / Ctrl + Enter 运行01
场景与操作说明
监控值需要结合单位和标签解释。两条同名指标若标签不同,不应直接相减;样本变化也不能证明发生了真实告警。
value 的单位由 unit 给出,本例只演示非负整数值。
- 核对 监控指标 的字段层级,保留 metricId 的字符串类型。
- 修改一项输入并运行,观察结果中的值或路径如何变化。
- 载入对照样本,复现下面的变化;恢复原例会替换当前输入。
02
对照样本
对照样本没有 series 元素,无法推断元素结构。比较两份 Schema,确认哪些约束来自样本证据,哪些仍需人工补充。
查看对照输入
{
"ok": true,
"data": {
"series": [],
"summary": {
"total": 2,
"note": null
}
}
}对照样本的实际结果
{
"$schema": "http://json-schema.org/draft-07/schema#",
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"data": {
"type": "object",
"properties": {
"series": {
"type": "array",
"items": {}
},
"summary": {
"type": "object",
"properties": {
"total": {
"type": "integer"
},
"note": {
"type": "null"
}
},
"required": [
"total",
"note"
]
}
},
"required": [
"series",
"summary"
]
}
},
"required": [
"ok",
"data"
]
}