保存报警日志

POST

/api/Alarm/AddAlarmLogs

Alarm

关键词：
报警日志、报警阈值。

使用场景：
保存所有系统中产生的报警日志。比如实测数据或预测数据超出报警配置中的阈值设定值，需要保存产生的报警数据时。

请求参数

Body 参数application/json

array of:

alarmTime

string <date-time>

必需

创建报警日志的当前时刻

predictionTime

string <date-time>

必需

预警时间，实测数据预警是使用的当前时刻，预测数据预警使用的是预测时间

pointType

integer <int32>

必需

点位的预警类型，对应的是AlarmTypeEnum，0：在线预警；1：加药预警；2：模拟结果预警；3：水量优化试算水质结果阈值；4：进出水设计值配置

extInfo

string | null

可选

扩展信息，生化池，可为空，或填写1/2/3/4等具体的池子数值编号

indicator

string

指标编码

必需

>= 1 字符

pointName

string | null

可选

点位中文名称，预留字段，可不填写

nodeCode

string

必需

点位代码，若该条报警是针对模型点位，那么这里给具体在模型中存在的模型点位。若该条报警是针对在线数据的，那么这里给具体在IOT服务中存在的设备名称。

>= 1 字符

grade

integer <int32>

必需

报警等级，目前已存在0,1,2三种定义，0：超出预警阈值，1：超出尾水标准，2：进水波动超过预警阈值。

value

number <double>

必需

报警时的指标数值，包含指标的实测数值和预测数值。

message

string

报警提示信息。

必需

>= 1 字符

alarmType

enum<integer> <int32>

必需

报警类型，目前已存在0,1,2,3,4五种定义，0：在线预警；1：加药预警；2：模拟结果预警；3：水量优化试算水质结果阈值；4：进出水设计值配置。

枚举值:

01234

示例

[
    {
        "alarmTime": "2025-03-06T15:14:55.906Z",
        "predictionTime": "2025-03-07T15:14:55.906Z",
        "pointType": 0,
        "extInfo": "",
        "indicator": "TSS",
        "pointName": "",
        "nodeCode": ".sensor_out.TSS",
        "grade": 1,
        "value": 183.67221,
        "message": "超出尾水标准 正常范围[0,10],当前值183.67221;",
        "alarmType": 2
    },
    {
        "alarmTime": "2025-03-06T15:14:55.906Z",
        "predictionTime": "2025-03-07T15:14:55.906Z",
        "pointType": 0,
        "extInfo": "",
        "indicator": "TP",
        "pointName": "",
        "nodeCode": ".sensor_out.TP",
        "grade": 0,
        "value": 4.745655,
        "message": "超出预警阈值 正常范围[0,0.4],当前值4.745655;",
        "alarmType": 2
    }
]

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://online-products.dhichina.cn/gateway/wwtp-paas-service/api/Alarm/AddAlarmLogs' \
--header 'Content-Type: application/json' \
--data-raw '[
    {
        "alarmTime": "2025-03-06T15:14:55.906Z",
        "predictionTime": "2025-03-07T15:14:55.906Z",
        "pointType": 0,
        "extInfo": "",
        "indicator": "TSS",
        "pointName": "",
        "nodeCode": ".sensor_out.TSS",
        "grade": 1,
        "value": 183.67221,
        "message": "超出尾水标准 正常范围[0,10],当前值183.67221;",
        "alarmType": 2
    },
    {
        "alarmTime": "2025-03-06T15:14:55.906Z",
        "predictionTime": "2025-03-07T15:14:55.906Z",
        "pointType": 0,
        "extInfo": "",
        "indicator": "TP",
        "pointName": "",
        "nodeCode": ".sensor_out.TP",
        "grade": 0,
        "value": 4.745655,
        "message": "超出预警阈值 正常范围[0,0.4],当前值4.745655;",
        "alarmType": 2
    }
]'

返回响应

🟢200成功

application/json

Success

Body

object {0}

示例

成功示例异常示例

{
    "status": true,
    "code": "000000",
    "message": null,
    "traceId": null
}

更新报警配置信息

删除报警日志