警报阀值

可设置阈值以创建定制警报监视。下表列出了用于管理警报阈值的典型属性。有关完整参考，请参见 CLI 帮助。

表 3-2  警报阀值

属性 类型 描述 uuid Default 监视的唯一标识符 ("immutable") statname AnalyticsStatistics 要监视的统计数据 ["cpu.utilization"、"arc.accesses"、"arc.size"、"arc.l2_bytes"、"arc.l2_accesses"、"arc.l2_size"、"syscap.bytesused"、"syscap.percentused"、"repl.bytes"、"repl.ops"、"shadow.kilobytes"、"shadow.ops"、"shadow.requests"、"io.bytes"、"io.ops"、"datalink.kilobytes"、"nic.kilobytes"、"net.kilobytes"、"ftp.kilobytes"、"fc.bytes"、"fc.ops"、"http.reqs"、"ndmp.bytes"、"ndmp.diskkb"、"ndmp.ops"、"nfs2.bytes"、"nfs2.ops"、"nfs3.bytes"、"nfs3.ops"、"nfs4.bytes"、"nfs4.ops"、"sftp.kilobytes"、"smb.ops"、"srp.bytes"、"srp.ops"、"iscsi.bytes"、"iscsi.ops"] type ChooseOne 当 stat 超出限制 (normal) 或低于限制 (inverted) 时是否要发布警报 ["normal"、"inverted"] limit PositiveInteger 限制统计信息的值 minpost Duration 发布警报前必须保持的最短时间条件 days ChooseOne 仅在特定日期发布警报 ["all"、"weekdays"、"weekends"] window_start TimeOfDay 仅在 window_start 与 window_end 之间发布警报 ["none"、"00:00"、"00:30"、"01:00"、"01:30"、"02:00"、"02:30"、"03:00"、"03:30"、"04:00"、"04:30"、"05:00"、"05:30"、"06:00"、"06:30"、"07:00"、"07:30"、"08:00"、"08:30"、"09:00"、"09:30"、"10:00"、"10:30"、"11:00"、"11:30"、"12:00"、"12:30"、"13:00"、"13:30"、"14:00"、"14:30"、"15:00"、"15:30"、"16:00"、"16:30"、"17:00"、"17:30"、"18:00"、"18:30"、"19:00"、"19:30"、"20:00"、"20:30"、"21:00"、"21:30"、"22:00"、"22:30"、"23:00"、"23:30"] window_end TimeOfDay 仅在 window_start 与 window_end 之间发布警报 ["none"、"00:00"、"00:30"、"01:00"、"01:30"、"02:00"、"02:30"、"03:00"、"03:30"、"04:00"、"04:30"、"05:00"、"05:30"、"06:00"、"06:30"、"07:00"、"07:30"、"08:00"、"08:30"、"09:00"、"09:30"、"10:00"、"10:30"、"11:00"、"11:30"、"12:00"、"12:30"、"13:00"、"13:30"、"14:00"、"14:30"、"15:00"、"15:30"、"16:00"、"16:30"、"17:00"、"17:30"、"18:00"、"18:30"、"19:00"、"19:30"、"20:00"、"20:30"、"21:00"、"21:30"、"22:00"、"22:30"、"23:00"、"23:30"] ("immutable") frequency Duration 重新发布之前的最短时间 minclear Duration 重新发布 "all clear" 警报之前的最短正常时间

列出警报阈值

列出所有配置的警报阈值。

请求示例：

GET /api/alert/v1/thresholds HTTP/1.1
Authorization: Basic abcd123MWE=
Host: zfssa.example.com:215
Accept: application/json

响应示例：

HTTP/1.1 200 OK
Date: Tue, 27 Aug 2013 17:38:40 GMT
X-Zfssa-Appliance-Api: 1.0
Content-Type: application/json
Content-Length: 689

{
    "thresholds": [
        {
            "days": "all",
            "frequency": 300,
            "href": "/api/alert/v1/thresholds/
                     bec758cb-346e-6a7d-c211-b320c09ef6a6",
            "limit": 500,
            "minclear": 300,
            "minpost": 300,
            "statname": "cpu.utilization",
            "threshold": "threshold-000",
            "type": "normal",
            "uuid": "bec758cb-346e-6a7d-c211-b320c09ef6a6",
            "window_end": 0,
            "window_start": -1
        },
        {
            "days": "all",
            "frequency": 300,
            "href": "/api/alert/v1/thresholds/
                     475799d8-32c8-6ff6-882c-aa3b66e3a5a2",
            "limit": 100000,
            "minclear": 600,
            "minpost": 300,
            "statname": "datalink.kilobytes",
            "threshold": "threshold-001",
            "type": "normal",
            "uuid": "475799d8-32c8-6ff6-882c-aa3b66e3a5a2",
            "window_end": 300,
            "window_start": 1200
        }
    ]
}

获取警报阈值

列出单个警报阈值的属性。

请求示例：

GET /api/alert/v1/thresholds/1b15d405-75c4-4c0c-e0f6-8a108165b874
    HTTP/1.1
Authorization: Basic abcd123MWE=
Host: zfssa.example.com:215
Accept: application/json

结果示例：

HTTP/1.1 200 OK
X-Zfssa-Appliance-Api: 1.0
Content-Type: application/json
Content-Length: 363

{
    "threshold": {
        "days": "weekdays",
        "frequency": 300,
        "href": "/api/alert/v1/thresholds/
                 1b15d405-75c4-4c0c-e0f6-8a108165b874",
        "limit": 100000,
        "minclear": 300,
        "minpost": 300,
        "statname": "datalink.kilobytes",
        "type": "normal",
        "uuid": "1b15d405-75c4-4c0c-e0f6-8a108165b874",
        "window_end": 0,
        "window_start": -1
    }
}

创建警报阈值

创建警报阈值。

请求示例：

POST /api/alert/v1/thresholds HTTP/1.1
Host: zfs-storage.example.com
X-Auth-User: root
X-Auth-Key: letmein
Content-Type: application/json
Content-Length: 50

{"statname": "datalink.kilobytes", "limit": 100000}

响应示例：

HTTP/1.1 201 Created
X-Zfssa-Appliance-Api: 1.0
Content-Type: application/json
Content-Length: 321
Location: /api/alert/v1/thresholds
          /1b15d405-75c4-4c0c-e0f6-8a108165b874

{
    "threshold": {
        "href": "/api/alert/v1/alerts/thresholds
                 /1b15d405-75c4-4c0c-e0f6-8a108165b874",
        ...
    }
}

修改警报阈值

修改指定的警报阈值的任何属性。

请求示例：

PUT /api/alert/v1/thresholds/1b15d405-75c4-4c0c-e0f6-8a108165b874
    HTTP/1.1
Authorization: Basic abcd123MWE=
Host: zfssa.example.com:215

{"days":"weekdays"}

响应示例：

HTTP/1.1 202 Accepted
X-Zfssa-Appliance-Api: 1.0
Content-Type: application/json
Content-Length: 326

{
    "threshold": {
        "days": "weekdays",
        ...
    }
}

删除警报阈值

删除指定的警报阈值。

请求示例：

DELETE /api/alert/v1/thresholds/475799d8-32c8-6ff6-882c-aa3b66e3a5a2
       HTTP/1.1
Authorization: Basic abcd123MWE=
Host: zfssa.example.com:215

响应示例：

HTTP/1.1 204 No Content
X-Zfssa-Appliance-Api: 1.0