警告しきい値

しきい値を設定して、カスタムの警告ウォッチを作成できます。次の表に、警告のしきい値を管理するための一般的なプロパティーを示します。詳細は、CLI のヘルプを参照してください。

表 7  警告しきい値

プロパティー 型 説明 uuid Default ウォッチの一意の識別子 (変更不可) です 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”] (変更不可) のみ警告を送信 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