API概述
API访问认证
API访问认证过程
API客户端注册
获取访问Token
用AccessToken访问
API设计说明
用户管理
列出所有用户
查询单个用户
创建用户
修改用户
暂停用户
开启用户
用户分组信息
修改URL回调通知
网站监控
网站监控任务列表
查看监控任务配置
查看任务监控数据
创建网站监控任务
可使用的监测点
监测点运营商
修改监控任务配置
开启/停止监控任务
获取响应时间分布
删除网站监控任务
网站监控分组列表
创建网站监控分组
分配监控任务到分组
创建站点企业分组
分配任务到企业分组
查看最近一次的数据
查看历史快照
企业分组任务列表
网站子账号任务列表
服务监控
服务监控任务列表
查看监控任务配置
查看任务监控数据
创建服务监控任务
修改监控任务配置
开启/停止监控任务
删除服务监控任务
服务监控分组列表
创建服务监控分组
分配监控任务到分组
创建企业分组
分配任务到企业分组
查看任务统计数据
子账号监控任务列表
服务器监控
服务器监控任务列表
查看监控任务配置
查看任务监控数据
创建服务器监控任务
修改监控任务配置
开启/停止监控任务
删除服务器监控任务
服务器监控分组列表
创建个人监控分组
创建企业服务器分组
分配监控任务到分组
分配任务到企业分组
统计服务器数量
获取告警的服务器
查看任务统计数据
获取服务器的磁盘
获取服务器的网卡
告警设置
故障历史查询
网站监控告警设置
服务监控告警设置
服务器监控告警设置
获取任务告警消息
获取消息的通知历史
获取自定义告警消息
插件管理
插件列表
创建采集器
删除采集器
采集器任务统计
自定义告警
获取自定义告警规则
查看自定义告警规则
创建自定义告警规则
修改自定义告警规则
删除自定义告警规则
API监控
API监控任务列表
查看任务监控数据
查看最近一次的数据
API监控任务可用率
API监控任务响应时间
API监控任务正确率
API监控任务故障历史

URI

/v2/server/allowlists.json?page=1

Method

GET

参数说明

Page: 页数(每页显示50条记录)

start_date:开始日期(Y-m-d  默认当天)

end_date:结束日期(Y-m-d  默认当天)

User_id:要查询的子账号user_id

结果(json)

最开始的数字键值为服务器任务ID

Cpu:

 cpu_used_percent->CPU当前使用率(最近5分钟)

       cpu_used_percent_day->CPU今日平均使用率

       cpu_used_percent_max->CPU今日最大使用率

Netio(网卡流量):

     键值->服务设备名称

            in(流入)=>[now->当前流量 avg-> 今日平均流量]

            out(流出) =>[now->当前流量 avg-> 今日平均流量]

Mem(内存):

       mem_used_percent->当前使用率(最近5分钟)

       mem_used_percent_day->今日平均使用率

       mem_used_percent_max->今日最大使用率

Load(负载):

       load_1_percent->最近1分钟平均负载

       load_5_percent->最近5分钟平均负载

       load_15_percent->最近15分钟平均负载

Diskstore(磁盘空间使用率):

     键值->磁盘分区名称

            used_percent->使用率

            used->已使用容量

            size->总容量

Diskio(磁盘IO):

     键值->磁盘分区

            Wb->磁盘当前写入速率

            Rb->磁盘当前读取速率

Procsum(系统进程数):

       sum->当前进程数

       sum_avg->当日平均进程数

task_name => 任务名称

server_ip => SNMP IP

private_ip => 服务器IP

frequency => 监控频率(分钟)

sys_type => 操作系统

status => 状态

status_led =>监控状态图片名字

status_str =>监控状态文字描述

上方为优化版API,以下为旧版API(可继续使用):

URI

/v2/server/lists.json?page=1

Method

GET

参数说明

Page是分页数   每页最多显示50条记录

结果(json)

最开始的数字键值为服务器任务ID

Cpu:

 cpu_used_percent->CPU当前使用率(最近5分钟)

       cpu_used_percent_day->CPU今日平均使用率

       cpu_used_percent_max->CPU今日最大使用率

Netio(网卡流量):

     键值->服务设备名称

            in(流入)=>[now->当前流量 avg-> 今日平均流量]

            out(流出) =>[now->当前流量 avg-> 今日平均流量]

Mem(内存):

       mem_used_percent->当前使用率(最近5分钟)

       mem_used_percent_day->今日平均使用率

       mem_used_percent_max->今日最大使用率

Load(负载):

       load_1_percent->最近1分钟平均负载

       load_5_percent->最近5分钟平均负载

       load_15_percent->最近15分钟平均负载

Diskstore(磁盘空间使用率):

     键值->磁盘分区名称

            used_percent->使用率

            used->已使用容量

            size->总容量

Diskio(磁盘IO):

     键值->磁盘分区

            Wb->磁盘当前写入速率

            Rb->磁盘当前读取速率

Procsum(系统进程数):

       sum->当前进程数

       sum_avg->当日平均进程数

task_name => 任务名称

server_ip => SNMP IP

private_ip => 服务器IP

frequency => 监控频率(分钟)

sys_type => 操作系统

status => 状态

status_led =>监控状态图片名字

status_str =>监控状态文字描述

一个例子:

curl -s "https://api.jiankongbao.com/v2/server/lists.json?access_token=b540a79f5e707b6080ddd6ab77326a26faf16cc6&page=1"

说明:access_token通过获取访问token得到。

返回结果:

{
   "58833": {
       "cpu": {
           "cpu_used_percent": "14.1",
           "cpu_used_percent_day": "14.88",
           "cpu_used_percent_max": "27.6"
       },
       "load": {
           "load_1_percent": 7.9,
           "load_5_percent": 7.4,
           "load_15_percent": 8.2
       },
       "mem": {
           "mem_used_percent": "46.8",
           "mem_used_percent_day": "51.6",
           "mem_used_percent_max": "59.2"
       },
       "netio": {
           "lo": {
               "in": {
                   "now": "0.00 Mbps",
                   "avg": "0.00 Mbps"
               },
               "out": {
                   "now": "0.00 Mbps",
                   "avg": "0.00 Mbps"
               }
           },
           "eth0": {
               "in": {
                   "now": "4.91 Mbps",
                   "avg": "4.75 Mbps"
               },
               "out": {
                   "now": "1.57 Mbps",
                   "avg": "1.21 Mbps"
               }
           }
       },
       "diskstore": {
           "/": {
               "used_percent": "26.4",
               "used": "4.9G",
               "size": "18.4G"
           },
           "/boot": null,
           "/data": null,
           "/usr": null
       },
       "procsum": {
           "sum": 178,
           "sum_avg": "190"
       },
       "diskio": {
           "sda": {
               "wb": "154.91 KB/s",
               "rb": "0.00 KB/s"
           },
           "sda1": {
               "wb": "154.91 KB/s",
               "rb": "0.00 KB/s"
           },
           "sda2": {
               "wb": "0.00 KB/s",
               "rb": "0.00 KB/s"
           }
       },
       "task_name": "测试服务器1",
       "server_ip": "218.6.8.189",
       "private_ip": "192.168.1.1",
       "frequency": "2",
       "sys_type": "linux",
       "status": "开启"
   },
   "58834": {
       "cpu": {
           "cpu_used_percent": "32.3",
           "cpu_used_percent_day": "29.54",
           "cpu_used_percent_max": "39.9"
       },
       "load": {
           "load_1_percent": 29.3,
           "load_5_percent": 59.2,
           "load_15_percent": 66.4
       },
       "mem": {
           "mem_used_percent": "68.9",
           "mem_used_percent_day": "64.9",
           "mem_used_percent_max": "74.3"
       },
       "netio": {
           "lo": {
               "in": {
                   "now": "0.00 Mbps",
                   "avg": "0.00 Mbps"
               },
               "out": {
                   "now": "0.00 Mbps",
                   "avg": "0.00 Mbps"
               }
           },
           "eth0": {
               "in": {
                   "now": "3.31 Mbps",
                   "avg": "4.07 Mbps"
               },
               "out": {
                   "now": "0.53 Mbps",
                   "avg": "0.62 Mbps"
               }
           }
       },
       "diskstore": {
           "/": {
               "used_percent": "9.6",
               "used": "6.6G",
               "size": "68.3G"
           },
           "/boot": {
               "used_percent": "19.5",
               "used": "0.0G",
               "size": "0.1G"
           },
           "/data": null,
           "/usr": null
       },
       "procsum": {
           "sum": 223,
           "sum_avg": "220"
       },
       "diskio": {
           "sda": {
               "wb": "262.48 KB/s",
               "rb": "0.00 KB/s"
           },
           "sda1": {
               "wb": "0.00 KB/s",
               "rb": "0.00 KB/s"
           },
           "sda2": {
               "wb": "262.48 KB/s",
               "rb": "0.00 KB/s"
           },
           "dm-0": {
               "wb": "262.48 KB/s",
               "rb": "0.00 KB/s"
           },
           "dm-1": {
               "wb": "0.00 KB/s",
               "rb": "0.00 KB/s"
           }
       },
       "task_name": "服务器测试2",
       "server_ip": "218.61.8.10",
       "private_ip": "192.168.1.10",
       "frequency": "2",
       "sys_type": "linux",
       "status": "开启"
   }
}