133 lines
3.7 KiB
Markdown
133 lines
3.7 KiB
Markdown
---
|
||
id: extend-http-default
|
||
title: HTTP协议系统默认解析方式
|
||
sidebar_label: 系统默认解析方式
|
||
---
|
||
> HTTP接口调用获取响应数据后，用HertzBeat默认的解析方式去解析响应数据。
|
||
|
||
**此需接口响应数据结构符合HertzBeat指定的数据结构规则**
|
||
|
||
### HertzBeat数据格式规范
|
||
注意⚠️ 响应数据为JSON
|
||
|
||
单层格式：key-value
|
||
```json
|
||
{
|
||
"metricName1": "metricValue",
|
||
"metricName2": "metricValue",
|
||
"metricName3": "metricValue",
|
||
"metricName4": "metricValue"
|
||
}
|
||
```
|
||
多层格式：数组里面套key-value
|
||
```json
|
||
[
|
||
{
|
||
"metricName1": "metricValue",
|
||
"metricName2": "metricValue",
|
||
"metricName3": "metricValue",
|
||
"metricName4": "metricValue"
|
||
},
|
||
{
|
||
"metricName1": "metricValue",
|
||
"metricName2": "metricValue",
|
||
"metricName3": "metricValue",
|
||
"metricName4": "metricValue"
|
||
}
|
||
]
|
||
```
|
||
样例：
|
||
查询自定义系统的CPU信息，其暴露接口为 `/metrics/cpu`，我们需要其中的`hostname,core,useage`指标
|
||
若只有一台虚拟机，其单层格式为:
|
||
```json
|
||
{
|
||
"hostname": "linux-1",
|
||
"core": 1,
|
||
"usage": 78.0,
|
||
"allTime": 200,
|
||
"runningTime": 100
|
||
}
|
||
```
|
||
若有多台虚拟机，其多层格式为:
|
||
```json
|
||
[
|
||
{
|
||
"hostname": "linux-1",
|
||
"core": 1,
|
||
"usage": 78.0,
|
||
"allTime": 200,
|
||
"runningTime": 100
|
||
},
|
||
{
|
||
"hostname": "linux-2",
|
||
"core": 3,
|
||
"usage": 78.0,
|
||
"allTime": 566,
|
||
"runningTime": 34
|
||
},
|
||
{
|
||
"hostname": "linux-3",
|
||
"core": 4,
|
||
"usage": 38.0,
|
||
"allTime": 500,
|
||
"runningTime": 20
|
||
}
|
||
]
|
||
```
|
||
|
||
**对应的监控配置定义文件YML可以配置为如下**
|
||
|
||
```yaml
|
||
# 此监控类型所属类别：service-应用服务监控 db-数据库监控 custom-自定义监控 os-操作系统监控
|
||
category: custom
|
||
# 监控应用类型(与文件名保持一致) eg: linux windows tomcat mysql aws...
|
||
app: example
|
||
name:
|
||
zh-CN: 模拟应用类型
|
||
en-US: EXAMPLE APP
|
||
# 参数映射map. 这些为输入参数变量，即可以用^_^host^_^的形式写到后面的配置中，系统自动变量值替换
|
||
# type是参数类型: 0-number数字, 1-string明文字符串, 2-secret加密字符串
|
||
# 强制固定必须参数 - host
|
||
configmap:
|
||
- key: host
|
||
type: 1
|
||
- key: port
|
||
type: 0
|
||
# 指标组列表
|
||
metrics:
|
||
# 第一个监控指标组 cpu
|
||
# 注意：内置监控指标有 (responseTime - 响应时间)
|
||
- name: cpu
|
||
# 指标组调度优先级(0-127)越小优先级越高,优先级低的指标组会等优先级高的指标组采集完成后才会被调度,相同优先级的指标组会并行调度采集
|
||
# 优先级为0的指标组为可用性指标组,即它会被首先调度,采集成功才会继续调度其它指标组,采集失败则中断调度
|
||
priority: 0
|
||
# 指标组中的具体监控指标
|
||
fields:
|
||
# 指标信息 包括 field名称 type字段类型:0-number数字,1-string字符串 instance是否为实例主键 unit:指标单位
|
||
- field: hostname
|
||
type: 1
|
||
instance: true
|
||
- field: usage
|
||
type: 0
|
||
unit: '%'
|
||
- field: core
|
||
type: 0
|
||
# 监控采集使用协议 eg: sql, ssh, http, telnet, wmi, snmp, sdk
|
||
protocol: http
|
||
# 当protocol为http协议时具体的采集配置
|
||
http:
|
||
# 主机host: ipv4 ipv6 域名
|
||
host: ^_^host^_^
|
||
# 端口
|
||
port: ^_^port^_^
|
||
# url请求接口路径
|
||
url: /metrics/cpu
|
||
# 请求方式 GET POST PUT DELETE PATCH
|
||
method: GET
|
||
# 是否启用ssl/tls,即是http还是https,默认false
|
||
ssl: false
|
||
# 响应数据解析方式: default-系统规则,jsonPath-jsonPath脚本,website-网站可用性指标监控
|
||
# 这里使用HertzBeat默认解析
|
||
parseType: default
|
||
```
|