衡石分析平台系统人员手册-数据预警

于 2025-06-22 19:29:41 发布
阅读量716 收藏 15
点赞数 7
CC 4.0 BY-SA版权
分类专栏： 使用手册 文章标签： java 前端 服务器
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.youkuaiyun.com/zandy1011/article/details/148831471

数据结构​

名称位置类型必选说明
titlebodystring是预警标题
appIdbodyinteger是预警所属 app id
dashboardIdbodyinteger是预警条件所选dashboard id
chartIdbodyinteger是预警条件所选chart id
optionsbodyobject是预警配置信息
» rulesbody[object]是预警触发条件，HE数组。可以有多个条件，每个条件为一个数组项。
»» kindbodystring否none
»» opbodystring否none
»» argsbody[object]否none
»»» kindbodystring否none
»»» opbodystring否none
»»» argsbody[object]否none
»»»» kindbodystring是none
»»»» opbodystring是none
»»»» typebodystring是none
» timingbodyobject是触发时机配置信息
»» cronTypebodystring是cronType表达式类型
»» cronDescbodystring是cron表达式
»» timeZonebodystring是时区
»» triggerTypebodystring是值为(CRON_JOB)
»» frequencybodystring是频率，值为(ALWAYS,ONLY_ONCE,ONCE_EVERYDAY)之一
» emailbodyobject否邮件推送配置
»» buildMessageAsOwnerbodyboolean否使用预警创建者的身份导出数据并生成消息内容
»» dashboardListbody[object]否推送仪表盘列表
»»» idbodyinteger否仪表盘id
»»» titlebodystring否仪表盘标题
»» bodyWithDashboardUrlbodyboolean否正文是否附加仪表盘链接
»» enabledbodyboolean否是否开启
»» bodyWithImagebodyboolean否正文是否附加仪表盘图片
»» compressAttachmentbodyboolean否是否压缩附加
»» receiverListbody[object]否衡石系统内接收者列表
»»» idbodyinteger否接收者id
»»» namebodystring否none
»»» loginNamebodystring否none
»»» receiverTypebodystring否接收人类型
»» emailSubjectbodystring否主题
»» defaultEmailSubjectbodystring否默认主题
»» emailContentBodybodystring否内容
»» defaultEmailContentBodybodystring否默认内容
»» tooLargeContentBodybodystring否附件内容过大时替换内容
»» defaultTooLargeContentBodybodystring否默认附件内容过大时替换内容
»» attachmentTypesbodystring否附件类型
»» emailAddressListbody[string]否邮箱地址列表
» webhookbodyobject否webhook推送配置
»» enabledbodyboolean否是否开启
»» urlbodystring否webhook推送目的地址
»» methodbodystring否HTTP请求类型
»» requestBodybodystring否请求体（仅支持json格式请求体）
»» headersbody[string]否请求头
» wecombodyobject否企业微信推送配置
»» buildMessageAsOwnerbodyboolean否使用预警创建者的身份导出数据并生成消息内容
»» dashboardListbody[object]否none
»»» idbodyinteger否none
»»» titlebodystring否none
»» bodyWithDashboardUrlbodyboolean否none
»» enabledbodyboolean否none
»» bodyWithImagebodyboolean否none
»» targetsbody[string]否企业微信用户id列表
»» receiverListbody[object]否衡石系统内接收者列表
»»» idbodyinteger否接收者id
»»» namebodystring否none
»»» loginNamebodystring否none
»»» receiverTypebodystring否接收人类型
»» subjectbodystring否消息主题
»» contentbodystring否消息内容
»» bodyCustomizedbodyboolean否是否开启自定义消息
»» defaultContentbodystring否默认消息内容
» feishubodyobject否飞书推送配置
»» buildMessageAsOwnerbodyboolean否使用预警创建者的身份导出数据并生成消息内容
»» dashboardListbody[object]否none
»»» idbodyinteger否none
»»» titlebodystring否none
»» bodyWithDashboardUrlbodyboolean否none
»» enabledbodyboolean否none
»» bodyWithImagebodyboolean否none
»» targetsbody[string]否飞书用户id列表
»» receiverListbody[object]否衡石系统内接收者列表
»»» idbodyinteger否接收者id
»»» namebodystring否none
»»» loginNamebodystring否none
»»» receiverTypebodystring否接收人类型
»» subjectbodystring否none
»» contentbodystring否none
»» bodyCustomizedbodyboolean否none
»» defaultContentbodystring否none
» dingtalkbodyobject否钉钉推送配置
»» buildMessageAsOwnerbodyboolean否使用预警创建者的身份导出数据并生成消息内容
»» dashboardListbody[object]否none
»»» idbodyinteger否none
»»» titlebodystring否none
»» bodyWithDashboardUrlbodyboolean否none
»» enabledbodyboolean否none
»» bodyWithImagebodyboolean否none
»» targetsbody[string]否钉钉用户id列表
»» receiverListbody[object]否衡石系统内接收者列表
»»» idbodyinteger否接收者id
»»» namebodystring否none
»»» loginNamebodystring否none
»»» receiverTypebodystring否接收人类型
»» subjectbodystring否none
»» contentbodystring否none
»» bodyCustomizedbodyboolean否none
»» defaultContentbodystring否none
errorPolicebodyobject是预警失败策略
» canPausebodyboolean是能否暂停任务，暂停任务后需手动重新启动。
» intervalbodyinteger是重试间隔时间，单位：分钟
» retryablebodyboolean是能否重试
» notifyUserbodyboolean是任务暂停后是否通知应用所有者
» retryTimesbodyinteger是重试总次数
» failureTimesbodyinteger是失败暂停阈值

收件人类型​

字段值描述
USER用户
ORGANIZATION用户组
DEPARTMENT组织机构

邮件附件类型​

字段值描述
PNGpng文件
PDFpdf文件
EXCELexcel文件

接口说明​

创建数据预警条目​

创建属于特定应用的数据预警条目，一个APP最多创建20条预警条目

请求参数​

参考预警数据结构。

RequestResponse

http

POST /api/apps/{appId}/alert HTTP/1.1
Content-Type: application/json
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...

// Request Body:
{
  "title": "测试预警1",
  "appId": 128149,
  "dashboardId": 1,
  "chartId": 5,
  "options": {
    "rules": [
      {
        "kind": "function",
        "op": "and",
        "args": [
          {
            "kind": "function",
            "op": "!=",
            "args": [
              {
                "kind": "reference",
                "op": "u_32a8edf1946cd3c3_1",
                "type": "number"
              },
              {
                "kind": "constant",
                "op": "0",
                "type": "number"
              }
            ]
          }
        ]
      }
    ],
    "timing": {
      "cronType": "WEEKLY",
      "cronDesc": "0 0 0 ? * 1",
      "timeZone": "GMT+08:00",
      "triggerType": "CRON_JOB",
      "frequency": "ONLY_ONCE"
    },
    "email": {
      "enabled": true,
      "receiverList": [
        {
          "id": 26889,
          "name": "测试用户",
          "loginName": "test1",
          "receiverType": "USER"
        }
      ],
      "emailSubject": "",
      "emailContentBody": "指标已达预警阈值，请知晓并及时处理。<br /><br />预警规则被触发<br />id(求和) != 0<br />指标当前数据如下（只预览最多20条数据，可打开仪表盘链接查看详情）：<br />{{%%system.chart.data}}<br /><br />应用：{{%%system.app.title}}<br />仪表盘：{{%%system.dashboard.title}}<br />图表：{{%%system.chart.title}}<br />",
      "defaultEmailSubject": "【指标预警通知】{{%%system.dashboard.title}}：id",
      "defaultEmailContentBody": "指标已达预警阈值，请知晓并及时处理。<br /><br />预警规则被触发<br />id(求和) != 0<br />指标当前数据如下（只预览最多20条数据，可打开仪表盘链接查看详情）：<br />{{%%system.chart.data}}<br /><br />应用：{{%%system.app.title}}<br />仪表盘：{{%%system.dashboard.title}}<br />图表：{{%%system.chart.title}}<br />",
      "bodyWithDashboardUrl": true,
      "emailSubjectCustomized": false,
      "emailBodyCustomized": true
    },
    "webhook": {
      "enabled": true,
      "url": "https://www.baidu.com",
      "method": "POST",
      "headers": [],
      "requestBody": ""
    }
  },
  "errorPolice": {
    "canPause": true,
    "interval": 5,
    "retryable": true,
    "notifyUser": true,
    "retryTimes": 2,
    "failureTimes": 3
  }
}

返回结果​
状态码状态码含义说明数据模型
200OK成功Inline

分页查询预警​

http

GET /api/apps/{appId}/alert/list HTTP/1.1
Accept: application/json
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...

请求参数​
名称位置类型必选说明
appIdpathstring是none
requestIdquerystring否none
offsetqueryLong否none
limitqueryLong否none

删除预警条目​

http

DELETE /api/apps/{appId}/alert/{alertId} HTTP/1.1
Accept: application/json
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...

请求参数​
名称位置类型必选说明
appIdpathstring是none
alertIdpathstring是none
requestIdquerystring否none

根据ID查询预警​

http

GET /api/apps/{appId}/alert/{alertId} HTTP/1.1
Accept: application/json
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...

请求参数​
名称位置类型必选说明
appIdpathstring是none
alertIdpathstring是none
requestIdquerystring否none

编辑数据预警条目​

编辑特定的预警条目

请求参数​
名称位置类型必选说明
appIdpathstring是none
alertIdpathstring是none
requestIdquerystring否none
bodybodyobject是none

RequestResponse

http

PUT /api/apps/{appId}/alert/{alertId} HTTP/1.1
Content-Type: application/json
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...

// Request Body:
{
  "title": "测试预警1",
  "appId": 128149,
  "dashboardId": 1,
  "chartId": 5,
  "options": {
    "rules": [
      {
        "kind": "function",
        "op": "and",
        "args": [
          {
            "kind": "function",
            "op": "!=",
            "args": [
              {
                "kind": "reference",
                "op": "u_32a8edf1946cd3c3_1",
                "type": "number"
              },
              {
                "kind": "constant",
                "op": "0",
                "type": "number"
              }
            ]
          }
        ]
      }
    ],
    "timing": {
      "cronType": "WEEKLY",
      "cronDesc": "0 0 0 ? * 1",
      "timeZone": "GMT+08:00",
      "triggerType": "CRON_JOB",
      "frequency": "ONLY_ONCE"
    },
    "email": {
      "enabled": true,
      "receiverList": [
        {
          "id": 26889,
          "name": "测试用户",
          "loginName": "test1",
          "receiverType": "USER"
        }
      ],
      "emailSubject": "",
      "emailContentBody": "指标已达预警阈值，请知晓并及时处理。<br /><br />预警规则被触发<br />id(求和) != 0<br />指标当前数据如下（只预览最多20条数据，可打开仪表盘链接查看详情）：<br />{{%%system.chart.data}}<br /><br />应用：{{%%system.app.title}}<br />仪表盘：{{%%system.dashboard.title}}<br />图表：{{%%system.chart.title}}<br />",
      "defaultEmailSubject": "【指标预警通知】{{%%system.dashboard.title}}：id",
      "defaultEmailContentBody": "指标已达预警阈值，请知晓并及时处理。<br /><br />预警规则被触发<br />id(求和) != 0<br />指标当前数据如下（只预览最多20条数据，可打开仪表盘链接查看详情）：<br />{{%%system.chart.data}}<br /><br />应用：{{%%system.app.title}}<br />仪表盘：{{%%system.dashboard.title}}<br />图表：{{%%system.chart.title}}<br />",
      "bodyWithDashboardUrl": true,
      "emailSubjectCustomized": false,
      "emailBodyCustomized": true
    },
    "webhook": {
      "enabled": true,
      "url": "https://www.baidu.com",
      "method": "POST",
      "headers": [],
      "requestBody": ""
    }
  },
  "errorPolice": {
    "canPause": true,
    "interval": 5,
    "retryable": true,
    "notifyUser": true,
    "retryTimes": 2,
    "failureTimes": 3
  }
}

返回结果​
状态码状态码含义说明数据模型
200OK成功Inline

验证预警条目​

验证预警配置

请求参数​
名称位置类型必选说明
appIdpathstring是none
requestIdquerystring否none
bodybodyobject是none

RequestResponse

http

POST /api/apps/{appId}/alert/validate HTTP/1.1
Content-Type: application/json
Cookie: csrf=183f1c4...; sid=26ee552d...; _USER_SESSION_ID=f2a01083...

// Request Body:
{
  "id": "123",
  "title": "测试预警1",
  "appId": 128149,
  "dashboardId": 1,
  "chartId": 5,
  "options": {
    "rules": [
      {
        "kind": "function",
        "op": "and",
        "args": [
          {
            "kind": "function",
            "op": "!=",
            "args": [
              {
                "kind": "reference",
                "op": "u_32a8edf1946cd3c3_1",
                "type": "number"
              },
              {
                "kind": "constant",
                "op": "0",
                "type": "number"
              }
            ]
          }
        ]
      }
    ],
    "timing": {
      "cronType": "WEEKLY",
      "cronDesc": "0 0 0 ? * 1",
      "timeZone": "GMT+08:00",
      "triggerType": "CRON_JOB",
      "frequency": "ONLY_ONCE"
    },
    "email": {
      "enabled": true,
      "receiverList": [
        {
          "id": 26889,
          "name": "测试用户",
          "loginName": "test1",
          "receiverType": "USER"
        }
      ],
      "emailSubject": "",
      "emailContentBody": "指标已达预警阈值，请知晓并及时处理。<br /><br />预警规则被触发<br />id(求和) != 0<br />指标当前数据如下（只预览最多20条数据，可打开仪表盘链接查看详情）：<br />{{%%system.chart.data}}<br /><br />应用：{{%%system.app.title}}<br />仪表盘：{{%%system.dashboard.title}}<br />图表：{{%%system.chart.title}}<br />",
      "defaultEmailSubject": "【指标预警通知】{{%%system.dashboard.title}}：id",
      "defaultEmailContentBody": "指标已达预警阈值，请知晓并及时处理。<br /><br />预警规则被触发<br />id(求和) != 0<br />指标当前数据如下（只预览最多20条数据，可打开仪表盘链接查看详情）：<br />{{%%system.chart.data}}<br /><br />应用：{{%%system.app.title}}<br />仪表盘：{{%%system.dashboard.title}}<br />图表：{{%%system.chart.title}}<br />",
      "bodyWithDashboardUrl": true,
      "emailSubjectCustomized": false,
      "emailBodyCustomized": true
    },
    "webhook": {
      "enabled": true,
      "url": "https://www.baidu.com",
      "method": "POST",
      "headers": [],
      "requestBody": ""
    }
  },
  "errorPolice": {
    "canPause": true,
    "interval": 5,
    "retryable": true,
    "notifyUser": true,
    "retryTimes": 2,
    "failureTimes": 3
  }
}

返回结果​
状态码状态码含义说明数据模型
200OK成功Inline

状态码 200

名称类型必选约束中文名说明
» versionstringtruenonenone
» codeintegertruenonenone
» msgstringtruenonenone
» chartDataStartTimeMillisintegertruenonenone
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值