Alertas de umbral

Idioma:

Una alerta de umbral es una alerta personalizada en la cual se define un umbral para una estadística de análisis en particular, y la acción de alerta se ejecuta cuando el valor de la estadística está fuera de ese umbral. Consulte también Guía de análisis de Oracle® ZFS Storage Appliance versión OS8.8.x.

En la siguiente tabla, se describen las propiedades que se deben definir para especificar la estadística de análisis, definir el umbral para esa estadística y definir cuándo se ejecutarán las acciones de alerta para esa alerta de umbral.

Tabla 11 Propiedades de alertas de umbral

Propiedad	Tipo	Descripción
`statname`	AnalyticsStatistics	Necesario. La estadística de análisis que desea supervisa
`limit`	PositiveInteger	Necesario. El valor de umbral que activa la alerta. El porcentaje o la cantidad de bytes, operaciones, accesos o solicitudes por segundo.
`type`	ChooseOne	Cómo comparar el valor umbral ( `límite` ) al valor estadístico actual. `normal`: el valor estadístico actual supera el valor de umbral. Este es el valor por defecto. `invertido`: el valor estadístico actual está por debajo del valor de umbral.
`minpost`	Duración	Cantidad de tiempo en segundos en que el valor de la estadística debe permanecer en la condición de umbral antes de ejecutar la acción de alerta. El valor por defecto es cinco minutos.
`days`	ChooseOne	Cuándo se deben enviar estas alertas: `all` días, `weekdays`, o `weekends` . El valor por defecto es `all`.
`window_start` `window_end`	TimeOfDay	La ventana de tiempo durante la cual debe ejecutarse esta acción de alerta. Especifique horas desde las 00:00 hasta las 23:30 UTC, en incrementos de 30 minutos. Para ejecutar esta acción de alerta en cualquier momento en que se cumplan las condiciones, especifique `none` como hora de inicio u hora de finalización. Los valores por defecto son `none` para `window_start` y `00:00` para `window_end`.
`frequency`	Duración	Cantidad de tiempo en segundos entre reejecuciones de la acción de alerta cuando el valor de la estadística permanece en la condición de umbral. El valor por defecto es cinco minutos.
`minclear`	Duración	Cantidad de tiempo en segundos en que el valor de la estadística debe permanecer fuera de la condición de umbral antes de ejecutar la acción de alerta. El valor por defecto es cinco minutos.

Enumerar alertas de umbral

En la siguiente solicitud, se enumeran todas las alertas de umbral configuradas.

Ejemplo de solicitud:

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

Resultado de ejemplo:

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

Utilice la siguiente solicitud para enumerar todas las propiedades solo para la alerta de umbral especificada.

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

Crear una alerta de umbral

En este ejemplo, se crea una alerta de umbral para los casos en que los bytes de enlace de datos por segundo superan los 100 000 KB. Todas las demás propiedades tienen valores por defecto.

Para crear una alerta de umbral personalizada, el usuario debe tener la autorización allow_configure en el ámbito de alert.

Ejemplo de solicitud:

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}

Resultado de ejemplo:

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

Modificar una alerta de umbral

Utilice este comando para modificar las propiedades de la alerta de umbral especificada.

Ejemplo de solicitud:

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

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

Resultado de ejemplo:

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

Suprimir una alerta de umbral

Suprima la alerta de umbral especificada.

Ejemplo de solicitud:

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

Resultado de ejemplo:

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