Actions d'alerte

La propriété de catégorie détermine le type d'action d'alerte défini. Chaque catégorie possède son propre ensemble de propriétés définies.

Les catégories prises en charge sont :

• ad

• all

• appliance_software

• backup

• cluster

• custom

• hardware

• hardware_faults

• ndmp

• network

• replication

• replication_source

• replication_target

• restore

• scrk

• shadow

• smf

• thresholds

• zfs_pool

Table 8  Actions d'alerte "ad"

Propriété Type Description active_directory_degraded Boolean Le filtre doit correspondre aux événements active_directory_degraded [true ou false] smb_kerberos_client_authentication_degraded Boolean Le filtre doit correspondre aux événements mb_kerberos_client_authentication_degraded [true ou false]

Table 9  Actions d'alerte "all"

Propriété Type Description all_defects Boolean Le filtre doit correspondre aux événements all_defects [true, false] service_alerts Boolean Le filtre doit correspondre aux événements service_alerts [true, false] all_hardware_faults Boolean Le filtre doit correspondre aux événements all_hardware_faults [true, false]

Table 10  Actions d'alerte "logiciel d'appareil"

Propriété Type Description obstacles_to_system_software_update Boolean Le filtre doit correspondre aux événements obstacles_to_system_software_update [true, false] operating_system_kernel_panic Boolean Le filtre doit correspondre aux événements operating_system_kernel_panic [true ou false]

Table 11  Actions d'alerte "backup"

Propriété Type Description backup_finished Boolean Le filtre doit correspondre aux événements backup_finished [true ou false] backup_started Boolean Le filtre doit correspondre aux événements backup_started [true ou false]

Table 12  Actions d'alerte "cluster"

Propriété Type Description cluster_i /o_link_down Boolean Le filtre doit correspondre aux événements cluster_i /o_link_down [true ou false] cluster_i /o_link_failed Boolean Le filtre doit correspondre aux événements cluster_i /o_link_failed [true ou false] cluster_i /o_link_up Boolean Le filtre doit correspondre aux événements cluster_i /o_link_up [true ou false] unexpected_peer_error_occurred Boolean Le filtre doit correspondre aux événements unexpected_peer_error_occurred [true ou false] communication_t o_peer_lost Boolean Le filtre doit correspondre aux événements communication_to_peer_lost [true ou false] cluster_peer_panicked Boolean Le filtre doit correspondre aux événements cluster_peer_panicked [true ou false] failed_to_set_s p_root_password_on_cluster_peer Boolean Le filtre doit correspondre aux événements failed_to_set_sp_root_password_on_cluster_peer [true ou false] cluster_rejoin_failed_on_peer Boolean Le filtre doit correspondre aux événements cluster_rejoin_failed_on_peer [true ou false] cluster_rejoin_mismatch_on_peer Boolean Le filtre doit correspondre aux événements cluster_rejoin_mismatch_on_peer [true ou false] cluster_rejoin_completed_on_peer Boolean Le filtre doit correspondre aux événements cluster_rejoin_completed_on_peer [true ou false] cluster_peer_lost_communication_token Boolean Le filtre doit correspondre aux événements cluster_peer_lost_communication_token [true ou false] cluster_rejoin _failed Boolean Le filtre doit correspondre aux événements cluster_rejoin_failed [true ou false] cluster_rejoin_mismatch Boolean Le filtre doit correspondre aux événements cluster_rejoin_mismatch [true ou false] cluster_rejoin_completed Boolean Le filtre doit correspondre aux événements cluster_rejoin_completed [true ou false] cluster_takeover_complete Boolean Le filtre doit correspondre aux événements cluster_takeover_complete [true ou false] resource_import_failed_during_cluster_takeover Boolean Le filtre doit correspondre aux événements resource_import_failed_during_cluster_takeover [true ou false] local_cluster_communication_token_lost Boolean Le filtre doit correspondre aux événements local_cluster_communication_token_lost [true ou false]

Table 13  Actions d'alerte "custom"

Propriété Type Description patterns Default Modèles d'événement FMA

Table 14  Actions d'alerte "hardware"

Propriété Type Description fibre_channel_port_down Boolean Le filtre doit correspondre aux événements fibre_channel_port_down [true ou false] multiple_transient_fibre_channel_port_status _changes Boolean Le filtre doit correspondre aux événements multiple_transient_fibre_channel_port _status_changes [true ou false] transient_fibre_channel_port_status_change Boolean Le filtre doit correspondre aux événements transient_fibre_channel_port_status_change [true or false] fibre_channel_port_up Boolean Le filtre doit correspondre aux événements fibre_channel_port_up [true ou false] network_port_down Boolean Le filtre doit correspondre aux événements network_port_down [true ou false] network_port_up Boolean Le filtre doit correspondre aux événements network_port_up [true ou false] chassis_connected_to_system Boolean Le filtre doit correspondre aux événements chassis_connected_to_system [true ou false] chassis_removed Boolean Le filtre doit correspondre aux événements chassis_removed [true ou false] hardware_component_inserted Boolean Le filtre doit correspondre aux événements hardware_component_inserted [true ou false] hardware_component_removed Boolean Le filtre doit correspondre aux événements hardware_component_removed [true ou false] disk_inserted Boolean Le filtre doit correspondre aux événements disk_inserted [true ou false] disk_removed Boolean Le filtre doit correspondre aux événements disk_removed [true ou false] i/o_path_added Boolean Le filtre doit correspondre aux événements i/o_path_added [true ou false] i/o_path_removed Boolean Le filtre doit correspondre aux événements i/o_path_removed [true ou false] service_processor_offline_or_unavailable Boolean Le filtre doit correspondre aux événements service_processor_offline_or_unavailable [true ou false] service_processor_online_after_outage Boolean Le filtre doit correspondre aux événements service_processor_online_after_outage [true ou false] failed_to_set_root_password_on_service_processor Boolean Le filtre doit correspondre aux événements failed_to_set_root_password_on_service_processor [true ou false]

Table 15  Actions d'alerte "hardware_faults"

Propriété Type Description all_hardware_faults Boolean Le filtre doit correspondre aux événements all_hardware_faults [true ou false]

Table 16  Actions d'alerte "ndmp"

Propriété Type Description invalid_ndmp_restore Boolean Le filtre doit correspondre aux événements invalid_ndmp_restore [true ou false] backup_finished Boolean Le filtre doit correspondre aux événements backup_finished [true ou false] backup_started Boolean Le filtre doit correspondre aux événements backup_started [true ou false] restore_finished Boolean Le filtre doit correspondre aux événements restore_finished [true ou false] restore_started Boolean Le filtre doit correspondre aux événements restore_started [true ou false]

Table 17  Actions d'alerte "network"

Propriété Type Description datalink_failed Boolean Le filtre doit correspondre aux événements datalink_failed [true ou false] datalink_ok Boolean Le filtre doit correspondre aux événements datalink_ok [true ou false] network_port_down Boolean Le filtre doit correspondre aux événements network_port_down [true ou false] network_port_up Boolean Le filtre doit correspondre aux événements network_port_up [true ou false] ip_address_conflict Boolean Le filtre doit correspondre aux événements ip_address_conflict [true ou false] ip_address_conflict_resolved Boolean Le filtre doit correspondre aux événements ip_address_conflict_resolved [true ou false] ip_interface_degraded Boolean Le filtre doit correspondre aux événements ip_interface_degraded [true ou false] ip_interface_failed Boolean Le filtre doit correspondre aux événements ip_interface_failed [true ou false] ip_interface_ok Boolean Le filtre doit correspondre aux événements ip_interface_ok [true ou false]

Table 18  Actions d'alerte "replication"

Propriété Type Description receive_failed_(unsupported _version) Boolean Le filtre doit correspondre aux événements receive_failed_(unsupported_version) [true ou false] receive_failed_(cancelled) Boolean Le filtre doit correspondre aux événements receive_failed_(cancelled) [true ou false] receive_failed_(all_others) Boolean Le filtre doit correspondre aux événements receive_failed_(all_others) [true ou false] receive_failed_(out_of_space) Boolean Le filtre doit correspondre aux événements receive_failed_(out_of_space) [true ou false] receive_failed_(package_not _upgraded) Boolean Le filtre doit correspondre aux événements receive_failed_(package_not_upgraded) [true ou false] receive_finished Boolean Le filtre doit correspondre aux événements receive_finished [true ou false] receive_started Boolean Le filtre doit correspondre aux événements receive_started [true ou false] send_failed_(unsupported_version) Boolean Le filtre doit correspondre aux événements send_failed_(unsupported_version) [true ou false] send_failed_(cancelled) Boolean Le filtre doit correspondre aux événements send_failed_(cancelled) [true ou false] send_failed_(all_others) Boolean Le filtre doit correspondre aux événements send_failed_(all_others) [true ou false] send_failed_(connectivity) Boolean Le filtre doit correspondre aux événements send_failed_(connectivity) [true ou false] send_failed_(out_of_space) Boolean Le filtre doit correspondre aux événements send_failed_(out_of_space) [true ou false] send_failed_(remote _verification) Boolean Le filtre doit correspondre aux événements send_failed_(remote_verification) [true ou false] send_finished Boolean Le filtre doit correspondre aux événements send_finished [true ou false] send_skipped_(already_running) Boolean Le filtre doit correspondre aux événements send_skipped_(already_running) [true ou false] send_started Boolean Le filtre doit correspondre aux événements send_started [true ou false]

Table 19  Actions d'alerte "replication_source"

Propriété Type Description send_failed_(unsupported_version) Boolean Le filtre doit correspondre aux événements send_failed_(unsupported_version) [true ou false] send_failed_(cancelled) Boolean Le filtre doit correspondre aux événements send_failed_(cancelled) [true ou false] send_failed_(all_others) Boolean Le filtre doit correspondre aux événements send_failed_(all_others) [true ou false] send_failed_(connectivity) Boolean Le filtre doit correspondre aux événements send_failed_(connectivity) [true ou false] send_failed_(out_of_space) Boolean Le filtre doit correspondre aux événements send_failed_(out_of_space) [true ou false] send_failed_(remote_verification) Boolean Le filtre doit correspondre aux événements send_failed_(remote_verification) [true ou false] send_finished Boolean Le filtre doit correspondre aux événements send_finished [true ou false] send_skipped_(already_running) Boolean Le filtre doit correspondre aux événements send_skipped_(already_running) [true ou false] send_started Boolean Le filtre doit correspondre aux événements send_started [true ou false]

Table 20  Actions d'alerte "replication_target"

Propriété Type Description receive_failed_(unsupported_verrsion) Boolean Le filtre doit correspondre aux événements receive_failed_(unsupported_version) [true ou false] receive_failed_(cancelled) Boolean Le filtre doit correspondre aux événements receive_failed_(cancelled) [true ou false] receive_failed _(all_others) Boolean Le filtre doit correspondre aux événements receive_failed_(all_others) [true ou false] receive_failed _(out_of_space) Boolean Le filtre doit correspondre aux événements receive_failed_(out_of_space) [true ou false] receive_failed_(package_not_upgraded) Boolean Le filtre doit correspondre aux événements receive_failed_(package_not_upgraded) [true ou false] receive_finished Boolean Le filtre doit correspondre aux événements receive_finished [true ou false] receive_started Boolean Le filtre doit correspondre aux événements receive_started [true ou false]

Table 21  Actions d'alerte "restore"

Propriété Type Description restore_finished Boolean Le filtre doit correspondre aux événements restore_finished [true ou false] restore_started Boolean Le filtre doit correspondre aux événements restore_started [true ou false]

Table 22  Actions d'alerte "scrk"

Propriété Type Description support_bundle_build_failed Boolean Le filtre doit correspondre aux événements support_bundle_build_failed [true ou false] support_bundle_sent Boolean Le filtre doit correspondre aux événements support_bundle_sent [true ou false] support_bundle _upload_failed Boolean Le filtre doit correspondre aux événements support_bundle_upload_failed [true ou false] an_update_is_available_on_my_oracle_support Boolean Le filtre doit correspondre aux événements an_update_is_available_on_my_oracle_support [true ou false] no_updates_available Boolean Le filtre doit correspondre aux événements no_updates_available [true ou false] the_appliance_failed_to_verify _if_an_update_is_available Boolean Le filtre doit correspondre aux événements the_appliance_failed_to_verify_if_an_u pdate_is_available [true ou false]

Table 23  Actions d'alerte "shadow"

Propriété Type Description shadow_migration_complete Boolean Le filtre doit correspondre aux événements shadow_migration_complete [true ou false]

Table 24  Actions d'alerte "smf"

Propriété Type Description service_failures Boolean Le filtre doit correspondre aux événements service_failures [true ou false]

Table 25  Actions d'alerte "thresholds"

Propriété Type Description thresholdid Default UUID du témoin auquel doivent correspondre les alertes

Table 26  Actions d'alerte "zfs_pool"

Propriété Type Description resilver_finished Boolean Le filtre doit correspondre aux événements resilver_finished [true ou false] resilver_started Boolean Le filtre doit correspondre aux événements resilver_started [true ou false] scrub_finished Boolean Le filtre doit correspondre aux événements scrub_finished [true ou false] scrub_started Boolean Le filtre doit correspondre aux événements scrub_started [true ou false] hot_spare_activated Boolean Le filtre doit correspondre aux événements hot_spare_activated [true ou false]

List Alert Actions

Cette commande répertorie toutes les actions d'alerte. Pour obtenir des données pour une même ressource, envoyez une demande GET HTTP à la propriété href de la ressource d'actions d'alerte donné.

Exemple de demande de la commande Get Alert Actions :

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

Exemple de réponse :

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 Alert Action

Cette commande fonctionne comme la commande List Alert Action, à la différence qu'elle renvoie uniquement l'action d'alerte spécifiée.

Exemple de demande :

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

Exemple de réponse :

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"
    }
}

Create Alert Action

Lorsque vous créez une demande POST d'action d'alerte contenant un objet JSON, vous devez envoyer les propriétés d'action vers /api/alert/v1/alerts/actions. Vous devez définir la propriété de la catégorie pour sélectionner le type d'action à créer. Reportez-vous à la documentation de la CLI pour connaître les valeurs de catégorie disponibles sur un système donné.

Les valeurs de catégorie incluent généralement :

"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"

Exemple de demande :

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"}

Exemple de réponse :

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
    }
}

Modify Alert Action

Vous pouvez modifier certaines des propriétés renvoyées par la commande list en envoyant une demande PUT HTTP.

Exemple de demande :

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}

Exemple de réponse :

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
    }
}

Delete Alert Action

L'envoi d'une demande DELETE HTTP vers une ou plusieurs actions d'alerte href de quelque type que ce soit entraîne la suppression de la ressource spécifiée. Une demande de suppression traitée avec succès affiche le code de statut HTTP 204 (No Content).

Exemple de demande :

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

Exemple de réponse :

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