Alertes avec seuil

Langue :

Une alerte avec seuil est une alerte personnalisée dans laquelle un seuil est défini pour une statistique d'analyse donnée, et l'action d'alerte est exécutée lorsque la valeur de la statistique dépasse ou est inférieure à ce seuil. Reportez-vous également au Guide de la fonction d’analyse des systèmes Oracle ZFS Storage Appliance, version OS8.8.x.

Le tableau suivant décrit les propriétés à paramétrer pour spécifier la statistique d'analyse, définir le seuil de cette dernière et indiquer à quel moment les actions d'alerte seront exécutées pour cette alerte avec seuil.

Table 11 Propriétés des alertes avec seuil

Propriété	Type	Description
`statname`	AnalyticsStatistics	Obligatoire. Statistique d'analyse à surveiller.
`limit`	PositiveInteger	Obligatoire. Valeur de seuil qui déclenche l'alerte. Pourcentage ou nombre d'octets, d'opérations, d'accès ou de demandes par seconde.
`type`	ChooseOne	Définit la manière dont la valeur de seuil (`limit`) est comparée à la valeur de statistique actuelle. `normal` – Valeur de statistique actuelle qui dépasse la valeur de seuil. Il s'agit de la valeur par défaut. `normal` – Valeur de statistique actuelle qui se situe sous la valeur de seuil.
`minpost`	Duration	Durée en secondes pendant laquelle la valeur de statistique doit rester dans la condition de seuil avant que l'action d'alerte soit exécutée. La valeur par défaut est de cinq minutes.
`days`	ChooseOne	Jours où ces alertes doivent être envoyées : `all` (tous les jours), `weekdays` ou `weekends`. La valeur par défaut est `all`.
`window_start` `window_end`	TimeOfDay	Fenêtre de temps pendant laquelle cette action d'alerte sera exécutée. Spécifiez des heures entre 00:00 et 23:30 UTC par incréments de 30 minutes. Pour exécuter cette action d'alerte chaque fois que les conditions sont réunies, spécifiez `none` pour l'heure de début ou l'heure de fin. Les valeurs par défaut sont `none` pour `window_start` et `00:00` pour `window_end`.
`frequency`	Duration	Durée en secondes entre les réexécutions de l'action d'alerte tant que la valeur de statistique reste dans la condition de seuil. La valeur par défaut est de cinq minutes.
`minclear`	Duration	Durée en secondes pendant laquelle la valeur de statistique doit rester en dehors de la condition de seuil avant que l'action d'alerte de suivi soit exécutée. La valeur par défaut est de cinq minutes.

Enumération d'alertes avec seuil

La demande suivante énumère tous les alertes avec seuil configurées.

Exemple de demande :

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

Exemple de résultat :

HTTP/1.1 200 OK
Date: Tue, 15 Oct 2019 10:38:40 GMT
X-Zfssa-Appliance-Api: 1.0
Content-Type: application/json
Content-Length: 689

{
    "thresholds": [
        {
            "uuid": "threshold-uuid1",
            "statname": "cpu.utilization",
            "type": "normal",
            "limit": 80,
            "minpost": 300,
            "days": "weekdays",
            "window_start": "08:00",
            "window_end": "19:30",
            "frequency": 300,
            "minclear": 300,
            "threshold": "threshold-000",
            "href": "/api/alert/v1/thresholds/threshold-uuid1"
        },
        {
            "uuid": "threshold-uuid2",    
            "statname": "cap.meta_percentused[pool]",
            "type": "normal",
            "limit": 85,
            "minpost": 300,
            "days": "all",
            "window_start": "none",
            "window_end": "00:00",
            "frequency": 0,
            "minclear": 0,
            "threshold": "threshold-001",
            "href": "/api/alert/v1/thresholds/threshold-uuid2"       
        }
    ]
}

Utilisez la demande suivante pour énumérer toutes les propriétés de l'alerte avec seuil spécifiée seulement.

GET /api/alert/v1/thresholds/threshold-uuid HTTP/1.1

Création d'une alerte avec seuil

Cet exemple crée une alerte avec seuil pour l'événement dont le débit de liaison de données dépasse 100000 Ko. Toutes les autres propriétés ont des valeurs par défaut.

Pour créer une alerte avec seuil personnalisée, l'utilisateur doit disposer de l'autorisation allow_configure dans la portée alert.

Exemple de demande :

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

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

Exemple de résultat :

HTTP/1.1 201 Created
X-Zfssa-Appliance-Api: 1.0
Content-Type: application/json
Content-Length: 321
Location: /api/alert/v1/thresholds/threshold-uuid

{
    "threshold": {
        "href": "/api/alert/v1/thresholds/threshold-uuid",
        "uuid": "threshold-uuid",
        "statname": "datalink.kilobytes",
        "type": "normal",
        "limit": 100000,
        "minpost": 300,
        "days": "all",
        "window_start": "none",
        "window_end": "00:00",
        "frequency": 300,
        "minclear": 300
    }
}

Modification d'une alerte avec seuil

Cette commande permet de modifier les propriétés de l'alerte avec seuil spécifiée.

Exemple de demande :

PUT /api/alert/v1/thresholds/threshold-uuid HTTP/1.1
Authorization: Basic Tm8gcGVla2luZyE=
Host: zfs-storage.example.com:215

{"days": "weekdays", "minpost": 120}

Exemple de résultat :

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

{
    "threshold": {
        "href": "/api/alert/v1/thresholds/threshold-uuid",
        "uuid": "threshold-uuid",
        "statname": "datalink.kilobytes",
        "type": "normal",
        "limit": 100000,
        "minpost": 120,
        "days": "weekdays",
        "window_start": "none",
        "window_end": "00:00",
        "frequency": 300,
        "minclear": 300
    }
}

Suppression d'une alerte avec seuil

Supprime l'alerte avec seuil spécifiée.

Exemple de demande :

DELETE /api/alert/v1/thresholds/threshold-uuid HTTP/1.1
Authorization: Basic Tm8gcGVla2luZyE=
Host: zfs-storage.example.com:215

Exemple de résultat :

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