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

URI

/v2/threshold/createThreshold.json

Method

POST

参数说明

网站监控任务例子:

$array = array(

     'task_id' => ‘1234’,  任务id

     'task_sort'=>‘0’,  任务类型(0:网站 1:服务器 2:服务 7:全景)

     'setting' => array(

                     array(

                            'metric'   => '1',

                            'cond'   => '1',

                            'value'   => '5000',

                            'unit'   => '1',

                            'status'   => '0',(0:开启  1:暂停)

                            'retry'   => '1',

                               ‘monitor_set’=> ‘1’,

                               ‘monitor_count’ => ‘2’(任意监测点告警数)

                     ),

                        ........

              ),

);

说明:

当monitor_set设置为1时 ,需设置monitor_count。

当monitor_set设置为2时 ,不需设置monitor_count。但需设置dev参数,即‘dev’ => array(monitor1,monitor2,....),‘dev’参数是指你指定的监测点的一个数组。

当monitor_set 设置为3时,monitor_count和dev都不需要设置

$post_data =   array('data'=>json_encode($array));

curl_setopt($ch, CURLOPT_POSTFIELDS,   $post_data);

 

服务器监控任务例子:

$array = array(

              'task_id'   => '123',

              'task_sort'   => '1',

              'setting'   => array(

                     array(

                            'type'   => 'cup',

                            'metric'   => '10',

                            'cond'   => '1',

                            'value'   => '85',

                            'unit'   => '3',

                            'status'   => '0',

                            'retry'   => '2',

                     ),

                        .........

              ),

       );  

$post_data =   array('data'=>json_encode($array));

curl_setopt($ch, CURLOPT_POSTFIELDS,   $post_data);

说明:

服务器监控任务时需要指定给那种类型的snmp任务设置自定义告警规则,即上面的type字段。

Window操作系统服务器的SNMP任务类型有:

     'cpu_windows' => 'CPU使用率',

     'mem_windows' => '内存使用率',

     'netio' => '网络流量',

     'diskstore' => '磁盘空间使用率',

     'procsum' => '系统进程数'

Linux操作系统服务器的SNMP任务类型有:

     'cpu' => 'CPU使用率',

     'load' => 'CPU负载',

     'mem' => '内存使用率',

     'diskio' => '磁盘I/O',

     'netio' => '网络流量',

     'diskstore' => '磁盘空间使用率',

     'procsum' => '系统进程数'

只有当您的服务器已经添加了相应类型的snmp任务后,自定义告警规则才能创建成功。

当type设置成netio,diskio或diskstore是需要设置‘dev’参数,‘dev’参数代表的是你选择的磁盘或网卡,服务器的磁盘和网卡可通过服务器API中的server_disk和server_netio获得。

 

服务监控任务例子:

$array = array(

   ‘task_id’ => ‘1234’,  任务id

   ‘task_sort’=>‘2’,  任务类型(0:网站 1:服务器 2:服务 7:全景)

   'setting'   => array(

                     array(

                            'metric'   => '1',

                            'cond'   => '1',

                            'value'   => '5000',

                            'unit'   => '1',

                            'status'   => '0',(0:开启  1:暂停)

                            'retry'   => '1',

                     ),

                        ........

              ),

);

$post_data = array('data'=>json_encode($array));

curl_setopt($ch, CURLOPT_POSTFIELDS,   $post_data);

结果(json)

th_id=>[1,2....]告警规则ID,

error_code=>返回码

error_description=>返回消息

一个例子:

curl -H "application/x-www-form-urlencoded" --data 'data={"task_id":"705431","task_sort":"0","setting":[{"metric":"1","cond":"1","value":"2000","unit":"1","status":"0","retry":"1","monitor_set":"1","monitor_count":"5"}]}' "https://api.jiankongbao.com/v2/threshold/createThreshold.json?access_token=86154772570397e891f2639736f3b657c1ff40d5"

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

返回结果:

{
   "error_code": 200,
   "error_description": "提交成功"
}