경보 조치

범주 등록 정보는 정의 중인 경보 조치 유형을 결정합니다. 각 범주에는 자체 등록 정보 세트가 정의되어 있습니다.

지원되는 범주:

• ad

• all

• appliance_software

• backup

• cluster

• custom

• hardware

• hardware_faults

• ndmp

• network

• replication

• replication_source

• replication_target

• restore

• scrk

• shadow

• smf

• thresholds

• zfs_pool

표 8  경보 조치 "ad"

등록 정보 유형 설명 active_directory_degraded 부울 필터는 active_directory_degraded 이벤트 [true 또는 false]와 일치해야 합니다. smb_kerberos_client_authentication_degraded 부울 필터는 mb_kerberos_client_authentication_degraded 이벤트 [true 또는 false]와 일치해야 합니다.

표 9  경보 조치 "all"

등록 정보 유형 설명 all_defects 부울 필터는 all_defects 이벤트 [true, false]와 일치해야 합니다. service_alerts 부울 필터는 service_alerts 이벤트 [true, false]와 일치해야 합니다. all_hardware_faults 부울 필터는 all_hardware_faults 이벤트 [true, false]와 일치해야 합니다.

표 10  경보 조치 "appliance software"

등록 정보 유형 설명 obstacles_to_system_software_update 부울 필터는 obstacles_to_system_software_update 이벤트 [true, false]와 일치해야 합니다. operating_system_kernel_panic 부울 필터는 operating_system_kernel_panic 이벤트 [true 또는 false]와 일치해야 합니다.

표 11  경보 조치 backup

등록 정보 유형 설명 backup_finished 부울 필터는 backup_finished 이벤트 [true 또는 false]와 일치해야 합니다. backup_started 부울 필터는 backup_started 이벤트 [true 또는 false]와 일치해야 합니다.

표 12  경보 조치 "cluster"

등록 정보 유형 설명 cluster_i /o_link_down 부울 필터는 cluster_i /o_link_down 이벤트 [true 또는 false]와 일치해야 합니다. cluster_i /o_link_failed 부울 필터는 cluster_i /o_link_failed 이벤트 [true 또는 false]와 일치해야 합니다. cluster_i /o_link_up 부울 필터는 cluster_i /o_link_up 이벤트 [true 또는 false]와 일치해야 합니다. unexpected_peer_error_occurred 부울 필터는 unexpected_peer_error_occurred 이벤트 [true 또는 false]와 일치해야 합니다. communication_t o_peer_lost 부울 필터는 communication_to_peer_lost 이벤트 [true 또는 false]와 일치해야 합니다. cluster_peer_panicked 부울 필터는 cluster_peer_panicked 이벤트 [true 또는 false]와 일치해야 합니다. failed_to_set_s p_root_password_on_cluster_peer 부울 필터는 failed_to_set_sp_root_password_on_cluster_peer 이벤트 [true 또는 false]와 일치해야 합니다. cluster_rejoin_failed_on_peer 부울 필터는 cluster_rejoin_failed_on_peer 이벤트 [true 또는 false]와 일치해야 합니다. cluster_rejoin_mismatch_on_peer 부울 필터는 cluster_rejoin_mismatch_on_peer 이벤트 [true 또는 false]와 일치해야 합니다. cluster_rejoin_completed_on_peer 부울 필터는 cluster_rejoin_completed_on_peer 이벤트 [true 또는 false]와 일치해야 합니다. cluster_peer_lost_communication_token 부울 필터는 cluster_peer_lost_communication_token 이벤트 [true 또는 false]와 일치해야 합니다. cluster_rejoin _failed 부울 필터는 cluster_rejoin_failed 이벤트 [true 또는 false]와 일치해야 합니다. cluster_rejoin_mismatch 부울 필터는 cluster_rejoin_mismatch 이벤트 [true 또는 false]와 일치해야 합니다. cluster_rejoin_completed 부울 필터는 cluster_rejoin_completed 이벤트 [true 또는 false]와 일치해야 합니다. cluster_takeover_complete 부울 필터는 cluster_takeover_complete 이벤트 [true 또는 false]와 일치해야 합니다. resource_import_failed_during_cluster_takeover 부울 필터는 resource_import_failed_during_cluster_takeover 이벤트 [true 또는 false]와 일치해야 합니다. local_cluster_communication_token_lost 부울 필터는 local_cluster_communication_token_lost 이벤트 [true 또는 false]와 일치해야 합니다.

표 13  경보 조치 "custom"

등록 정보 유형 설명 patterns 기본값 FMA 이벤트 patterns

표 14  경보 조치 "hardware"

등록 정보 유형 설명 fibre_channel_port_down 부울 필터는 fibre_channel_port_down 이벤트 [true 또는 false]와 일치해야 합니다. multiple_transient_fibre_channel_port_status _changes 부울 필터는 multiple_transient_fibre_channel_port _status_changes 이벤트 [true 또는 false]와 일치해야 합니다. transient_fibre_channel_port_status_change 부울 필터는 transient_fibre_channel_port_status_change 이벤트 [true 또는 false]와 일치해야 합니다. fibre_channel_port_up 부울 필터는 fibre_channel_port_up 이벤트 [true 또는 false]와 일치해야 합니다. network_port_down 부울 필터는 network_port_down 이벤트 [true 또는 false]와 일치해야 합니다. network_port_up 부울 필터는 network_port_up 이벤트 [true 또는 false]와 일치해야 합니다. chassis_connected_to_system 부울 필터는 chassis_connected_to_system 이벤트 [true 또는 false]와 일치해야 합니다. chassis_removed 부울 필터는 chassis_removed 이벤트 [true 또는 false]와 일치해야 합니다. hardware_component_inserted 부울 필터는 hardware_component_inserted 이벤트 [true 또는 false]와 일치해야 합니다. hardware_component_removed 부울 필터는 hardware_component_removed 이벤트 [true 또는 false]와 일치해야 합니다. disk_inserted 부울 필터는 disk_inserted 이벤트 [true 또는 false]와 일치해야 합니다. disk_removed 부울 필터는 disk_removed 이벤트 [true 또는 false]와 일치해야 합니다. i/o_path_added 부울 필터는 i/o_path_added 이벤트 [true 또는 false]와 일치해야 합니다. i/o_path_removed 부울 필터는 i/o_path_removed 이벤트 [true 또는 false]와 일치해야 합니다. service_processor_offline_or_unavailable 부울 필터는 service_processor_offline_or_unavailable 이벤트 [true 또는 false]와 일치해야 합니다. service_processor_online_after_outage 부울 필터는 service_processor_online_after_outage 이벤트 [true 또는 false]와 일치해야 합니다. failed_to_set_root_password_on_service_processor 부울 필터는 failed_to_set_root_password_on_service_processor 이벤트 [true 또는 false]와 일치해야 합니다.

표 15  경보 조치 "hardware_faults"

등록 정보 유형 설명 all_hardware_faults 부울 필터는 all_hardware_faults 이벤트 [true 또는 false]와 일치해야 합니다.

표 16  경보 조치 "ndmp"

등록 정보 유형 설명 invalid_ndmp_restore 부울 필터는 invalid_ndmp_restore 이벤트 [true 또는 false]와 일치해야 합니다. backup_finished 부울 필터는 backup_finished 이벤트 [true 또는 false]와 일치해야 합니다. backup_started 부울 필터는 backup_started 이벤트 [true 또는 false]와 일치해야 합니다. restore_finished 부울 필터는 restore_finished 이벤트 [true 또는 false]와 일치해야 합니다. restore_started 부울 필터는 restore_started 이벤트 [true 또는 false]와 일치해야 합니다.

표 17  경보 조치 "network"

등록 정보 유형 설명 datalink_failed 부울 필터는 datalink_failed 이벤트 [true 또는 false]와 일치해야 합니다. datalink_ok 부울 필터는 datalink_ok 이벤트 [true 또는 false]와 일치해야 합니다. network_port_down 부울 필터는 network_port_down 이벤트 [true 또는 false]와 일치해야 합니다. network_port_up 부울 필터는 network_port_up 이벤트 [true 또는 false]와 일치해야 합니다. ip_address_conflict 부울 필터는 ip_address_conflict 이벤트 [true 또는 false]와 일치해야 합니다. ip_address_conflict_resolved 부울 필터는 ip_address_conflict_resolved 이벤트 [true 또는 false]와 일치해야 합니다. ip_interface_degraded 부울 필터는 ip_interface_degraded 이벤트 [true 또는 false]와 일치해야 합니다. ip_interface_failed 부울 필터는 ip_interface_failed 이벤트 [true 또는 false]와 일치해야 합니다. ip_interface_ok 부울 필터는 ip_interface_ok 이벤트와 [true 또는 false]와 일치해야 합니다.

표 18  경보 조치 "replication"

등록 정보 유형 설명 receive_failed_(unsupported _version) 부울 필터는 receive_failed_(unsupported_version) 이벤트 [true 또는 false]와 일치해야 합니다. receive_failed_(cancelled) 부울 필터는 receive_failed_(cancelled) 이벤트 [true 또는 false]와 일치해야 합니다. receive_failed_(all_others) 부울 필터는 receive_failed_(all_others) 이벤트 [true 또는 false]와 일치해야 합니다. receive_failed_(out_of_space) 부울 필터는 receive_failed_(out_of_space) 이벤트 [true 또는 false]와 일치해야 합니다. receive_failed_(package_not _upgraded) 부울 필터는 receive_failed_(package_not_upgraded) 이벤트 [true 또는 false]와 일치해야 합니다. receive_finished 부울 필터는 receive_finished 이벤트 [true 또는 false]와 일치해야 합니다. receive_started 부울 필터는 receive_started 이벤트 [true 또는 false]와 일치해야 합니다. send_failed_(unsupported_version) 부울 필터는 send_failed_(unsupported_version) 이벤트 [true 또는 false]와 일치해야 합니다. send_failed_(cancelled) 부울 필터는 send_failed_(cancelled) 이벤트 [true 또는 false]와 일치해야 합니다. send_failed_(all_others) 부울 필터는 send_failed_(all_others) 이벤트 [true 또는 false]와 일치해야 합니다. send_failed_(connectivity) 부울 필터는 send_failed_(connectivity) 이벤트 [true 또는 false]와 일치해야 합니다. send_failed_(out_of_space) 부울 필터는 send_failed_(out_of_space) 이벤트 [true 또는 false]와 일치해야 합니다. send_failed_(remote _verification) 부울 필터는 send_failed_(remote_verification) 이벤트 [true 또는 false]와 일치해야 합니다. send_finished 부울 필터는 send_finished 이벤트 [true 또는 false]와 일치해야 합니다. send_skipped_(already_running) 부울 필터는 send_skipped_(already_running) 이벤트 [true 또는 false]와 일치해야 합니다. send_started 부울 필터는 send_started 이벤트 [true 또는 false]와 일치해야 합니다.

표 19  경보 조치 "replication_source"

등록 정보 유형 설명 send_failed_(unsupported_version) 부울 필터는 send_failed_(unsupported_version) 이벤트 [true 또는 false]와 일치해야 합니다. send_failed_(cancelled) 부울 필터는 send_failed_(cancelled) 이벤트 [true 또는 false]와 일치해야 합니다. send_failed_(all_others) 부울 필터는 send_failed_(all_others) 이벤트 [true 또는 false]와 일치해야 합니다. send_failed_(connectivity) 부울 필터는 send_failed_(connectivity) 이벤트 [true 또는 false]와 일치해야 합니다. send_failed_(out_of_space) 부울 필터는 send_failed_(out_of_space) 이벤트 [true 또는 false]와 일치해야 합니다. send_failed_(remote_verification) 부울 필터는 send_failed_(remote_verification) 이벤트 [true 또는 false]와 일치해야 합니다. send_finished 부울 필터는 send_finished 이벤트 [true 또는 false]와 일치해야 합니다. send_skipped_(already_running) 부울 필터는 send_skipped_(already_running) 이벤트 [true 또는 false]와 일치해야 합니다. send_started 부울 필터는 send_started 이벤트 [true 또는 false]와 일치해야 합니다.

표 20  경보 조치 "replication_target"

등록 정보 유형 설명 receive_failed_(unsupported_verrsion) 부울 필터는 receive_failed_(unsupported_version) 이벤트 [true 또는 false]와 일치해야 합니다. receive_failed_(cancelled) 부울 필터는 receive_failed_(cancelled) 이벤트 [true 또는 false]와 일치해야 합니다. receive_failed _(all_others) 부울 필터는 receive_failed_(all_others) 이벤트 [true 또는 false]와 일치해야 합니다. receive_failed _(out_of_space) 부울 필터는 receive_failed_(out_of_space) 이벤트 [true 또는 false]와 일치해야 합니다. receive_failed_(package_not_upgraded) 부울 필터는 receive_failed_(package_not_upgraded) 이벤트 [true 또는 false]와 일치해야 합니다. receive_finished 부울 필터는 receive_finished 이벤트 [true 또는 false]와 일치해야 합니다. receive_started 부울 필터는 receive_started 이벤트 [true 또는 false]와 일치해야 합니다.

표 21  경보 조치 "restore"

등록 정보 유형 설명 restore_finished 부울 필터는 restore_finished 이벤트 [true 또는 false]와 일치해야 합니다. restore_started 부울 필터는 restore_started 이벤트 [true 또는 false]와 일치해야 합니다.

표 22  경보 조치 "scrk"

등록 정보 유형 설명 support_bundle_build_failed 부울 필터는 support_bundle_build_failed 이벤트 [true 또는 false]와 일치해야 합니다. support_bundle_sent 부울 필터는 support_bundle_sent 이벤트 [true 또는 false]와 일치해야 합니다. support_bundle _upload_failed 부울 필터는 support_bundle_upload_failed 이벤트 [true 또는 false]와 일치해야 합니다. an_update_is_available_on_my_oracle_support. 부울 필터는 an_update_is_available_on_my_oracle_support. 이벤트 [true 또는 false]와 일치해야 합니다. no_updates_available. 부울 필터는 no_updates_available. 이벤트 [true 또는 false]와 일치해야 합니다. the_appliance_failed_to_verify _if_an_update_i s_available. 부울 필터는 the_appliance_failed_to_verify_if_an_u pdate_is_available. 이벤트 [true 또는 false]와 일치해야 합니다.

표 23  경보 조치 "shadow"

등록 정보 유형 설명 shadow_migration_complete 부울 필터는 shadow_migration_complete 이벤트 [true 또는 false]와 일치해야 합니다.

표 24  경보 조치 "smf"

등록 정보 유형 설명 service_failures 부울 필터는 service_failures 이벤트 [true 또는 false]와 일치해야 합니다.

표 25  경보 조치 "thresholds"

등록 정보 유형 설명 thresholdid 기본값 경보가 일치해야 하는 워치의 UUID

표 26  경보 조치 "zfs_pool"

등록 정보 유형 설명 resilver_finished 부울 필터는 resilver_finished 이벤트 [true 또는 false]와 일치해야 합니다. resilver_started 부울 필터는 resilver_started 이벤트 [true 또는 false]와 일치해야 합니다. scrub_finished 부울 필터는 scrub_finished 이벤트 [true 또는 false]와 일치해야 합니다. scrub_started 부울 필터는 scrub_started 이벤트 [true 또는 false]와 일치해야 합니다. hot_spare_activated 부울 필터는 hot_spare_activated 이벤트 [true 또는 false]와 일치해야 합니다.

경보 조치 나열

경보 조치 나열 명령은 모든 경보 조치를 나열합니다. 단일 리소스에 대한 데이터를 가져오려면 HTTP GET 요청을 지정된 경보 조치 리소스의 href 등록 정보에 전송합니다.

경보 조치를 가져오는 요청의 예:

GET /api/alert/v1/actions HTTP/1.1
Authorization: Basic abcd123MWE=
Host: zfs-storage.example.com:215
Accept: application/json

응답 예:

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

{
    "actions": [
        {
            "action": "actions-000",
            "category": "smf",
            "href": "/api/alert/v1/actions/actions-000",
            "service_failures": true
        },
        {
            "action": "actions-001",
            "category": "scrk",
            "href": "/api/alert/v1/actions/actions-001",
            "action-000": {
                    "handler": "snmp_trap",
                    "href": "/api/alert/v1/alerts/actions/actions-001
                             /action-000"
            },
            "action-001": {
                    "address": "Joe.Admin@acme.com",
                    "handler": "email",
                    "href": "/api/alert/v1/actions/actions-001
                             /action-001",
                    "subject": "Phone Home Alert"
            },
            "support_bundle_build_failed": true,
            "support_bundle_sent": true,
            "support_bundle_upload_failed": true
        },
        {
            "action": "actions-002",
            "category": "thresholds",
            "href": "/api/alert/v1/actions/actions-002",
            "action-000": {
                    "address": "Joe.Admin@acme.com",
                    "handler": "email",
                    "href": "/api/alert/v1/actions/actions-002
                             /action-000",
                    "subject": "CPU Busy Alert"
            },
            "thresholdid": "b182ca05-53d3-6604-b874-ec353335704d"
        }
    ]
}

경보 조치 가져오기

이 명령은 경보 조치 나열과 유사하지만 지정된 경보 조치만 반환합니다.

요청 예:

GET /api/alert/v1/actions/actions-002 HTTP/1.1

응답 예:

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

{
    "action": {
        "category": "thresholds",
        "href": "/api/alert/v1/actions/actions-002",
        "action-000": {
                "address": "Joe.Admin@acme.com",
                "handler": "email",
                "href": "/api/alert/v1/alerts/actions/actions-002
                         /action-000",
                "subject": "CPU Busy"
        },
        "thresholdid": "b182ca05-53d3-6604-b874-ec353335704d"
    }
}

경보 조치 만들기

JSON 객체를 포함하는 경보 조치 POST 요청을 만들 때 조치 등록 정보를 /api/alert/v1/alerts/actions로 전송해야 합니다. 만들 조치 유형을 선택하도록 범주 등록 정보를 설정해야 합니다. 지정된 시스템에서 사용 가능한 모든 범주 값은 CLI 설명서를 참조하십시오.

일반적으로 범주 값에는 다음이 포함됩니다.

"ad", "all", "appliance_software", "backup", "cluster", "custom",
"hardware", "hardware_faults", "ndmp", "network", "replication",
"replication_source", "replication_target", "restore", "scrk", "shadow",
"smf", "thresholds" or "zfs_pool"

요청 예:

POST /api/alert/v1/actions HTTP/1.1
Host: zfssa.example.com:215
X-Auth-Session: uerqghq84vbdv
Content-Type: application/json
Content-Length: 30

{"category": "hardware_faults"}

응답 예:

HTTP/1.1 201 Created
X-Zfssa-Appliance-Api: 1.0
Content-Type: application/json
Content-Length: 118
Location: /api/alert/v1/actions/actions-006

{
    "action": {
        "href": "/api/alert/v1/actions/actions-006",
        "category": "hardware_faults",
        "all_hardware_faults": true
    }
}

경보 조치 수정

HTTP PUT 요청을 전송하면 list 명령에서 반환된 일부 등록 정보를 수정할 수 있습니다.

요청 예:

PUT /api/alert/v1/actions/actions-001 HTTP/1.1
Host: zfssa.example.com:215
X-Auth-Session: uerqghq84vbdv
Content-Type: application/json
Content-Length: 30

{"support_bundle_sent": false}

응답 예:

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

{
    "action": {
        "href": "/api/alert/v1/actions/actions-001",
        "category": "scrk",
        "support_bundle_build_failed": true,
        "support_bundle_sent": false,
        "support_bundle_upload_failed": true
    }
}

경보 조치 삭제

HTTP DELETE 요청을 경보 조치 href 또는 조치 href에 전송하면 지정된 리소스가 삭제됩니다. 성공한 삭제 응답은 HTTP 상태 204(No Content)입니다.

요청 예:

DELETE /api/alert/v1/actions/actions-003 HTTP/1.1
Authorization: Basic abcd123MWE=
Host: zfssa.example.com:215

응답 예:

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