Cambiar umbrales y desactivar comprobaciones
Cada comprobación parte de la línea base de su entrada del catálogo. La cambias donde tiene sentido: en una entidad, para que todos los recursos que están debajo la sigan, o en un recurso concreto que es la excepción. Esta guía muestra ambas formas, cómo volver a los valores heredados y cómo desactivar una comprobación o uno de sus niveles.
Antes de empezar
- Para cambiar una comprobación en un recurso, necesitas el rol Editor o uno superior en la entidad del recurso.
- Para establecer un valor predeterminado de una entidad, necesitas el rol Administrador de entidad en esa entidad.
- Conoce de dónde vienen los valores: la línea base, luego cada entidad desde la raíz hacia abajo y, por último, el recurso. Gana el valor más específico. Consulta Umbrales y líneas base.
Establece los valores lo más arriba posible en el árbol y modifica solo las excepciones. Un valor predeterminado establecido una vez en Ciguapa Inc. › Producción cubre todos los servidores que se agreguen allí más adelante.
Cómo se escribe un nivel
Cada comprobación tiene un nivel de Advertencia y un nivel Crítico. Cada nivel tiene:
| Parte | Valores |
|---|---|
| Operador | >, >=, <, <=, ==, !=, in, not_in, matches |
| Valor | Un número en la unidad de la comprobación, que se muestra junto al campo, o una lista para in y not_in |
| Durante | Opcional. Cuánto tiempo debe mantenerse la condición antes de que se abra la alerta, como 30s, 15m, 1h o 1d. Absorbe los picos breves; la recuperación es inmediata |
Algunas comprobaciones comparan estados en lugar de un valor con límites, por ejemplo el estado de una réplica de un grupo de disponibilidad. Sus reglas vienen del catálogo, y el editor lo indica en lugar de mostrar niveles.
Cambiar un umbral en un recurso
- Abre el recurso y selecciona la pestaña Comprobaciones. Usa Buscar comprobaciones o Solo problemas para encontrar la comprobación.
- Selecciona el icono del lápiz, Editar, en la fila de la comprobación. El cuadro de diálogo muestra el id de la comprobación, su línea base y los niveles actuales.
- Para cada nivel que quieras cambiar, deja seleccionada la opción Este nivel genera alertas y escribe el Operador, el Valor y, si hace falta, Durante. Por ejemplo, para Page life expectancy (
sqlserver.ple_seconds) ensql-ventas-01, establece el Nivel de advertencia en<900durante10m. - Selecciona Guardar.
La fila muestra ahora los niveles nuevos marcados (este recurso). Los niveles que no cambiaste conservan sus valores heredados.
Para volver a los valores heredados, abre de nuevo el cuadro de diálogo y selecciona Volver a los umbrales heredados. El botón solo aparece cuando el recurso tiene valores propios.
Establecer un valor predeterminado para una entidad
- Abre Configuración › Entidades.
- Abre el menú de acciones de la entidad, por ejemplo Producción, y selecciona Umbrales predeterminados. El panel enumera las comprobaciones que esta entidad establece por sí misma; hereda todas las demás.
- En Definir un predeterminado para una comprobación, elige la comprobación, por ejemplo CPU utilization (SQL process) (
sqlserver.cpu_percent), y selecciona Agregar. - Para cada nivel, elige:
- Heredar: conserva lo que viene de arriba.
- Definir aquí: escribe el Operador, el Valor y Durante, por ejemplo
>75durante15m. - Desactivar aquí: este nivel no genera alertas en esta entidad ni en las que están debajo.
- Selecciona Guardar.
Todos los recursos que están debajo de la entidad usan ahora el valor predeterminado, salvo que una entidad inferior o el recurso lo cambien. En la pestaña Comprobaciones de cada recurso, el nivel muestra la entidad de la que proviene.
Para quitar un valor predeterminado, selecciona el icono de la papelera junto a él, Quitar el predeterminado de esa comprobación. Los recursos que están debajo vuelven a heredar de más arriba.
Desactivar una comprobación
En un recurso, abre la pestaña Comprobaciones y desactiva la comprobación en la columna Activa, o desmarca La comprobación se ejecuta en el cuadro de diálogo de la comprobación. La comprobación deja de ejecutarse en ese recurso y aparece como Inactiva, para que nadie olvide que existe. Vuelve a activarla de la misma forma.
Para que una comprobación deje de generar alertas en toda una entidad, abre sus Umbrales predeterminados, agrega la comprobación y establece tanto el Nivel de advertencia como el Nivel crítico en Desactivar aquí. La comprobación sigue ejecutándose y registrando valores en todos los recursos que están debajo, pero allí no genera alertas. Úsalo para comprobaciones que no tienen sentido en una rama, como las de servidores de informes donde no hay ningún servidor de informes.
Cambiar la frecuencia con que se ejecuta una comprobación
En el cuadro de diálogo de la comprobación, escribe un Intervalo de 10s a 7d, por ejemplo 30s, 5m o 1h. Déjalo vacío para usar el intervalo del catálogo, que el campo muestra. La fila marca un intervalo cambiado como modificado.
Hacerlo con la API
Cada cambio mediante la API sigue los mismos roles y se escribe en el registro de auditoría. $BASE es https://<your server>/api/v1 y H contiene tu token; consulta Inicio rápido: agregar una instancia de SQL Server con la API.
| Tarea | Solicitud |
|---|---|
| Ver los niveles efectivos y de dónde viene cada uno | GET /resources/{id}/checks |
| Establecer niveles en un recurso | PATCH /resources/{id}/checks/{check_id} con thresholds |
| Volver a los niveles heredados | El mismo PATCH con "thresholds": null |
| Desactivar o activar una comprobación | El mismo PATCH con "enabled": false o true |
| Cambiar el intervalo | El mismo PATCH con "interval_seconds", de 10 a 604800 |
| Ver los valores predeterminados propios de una entidad | GET /entities/{id}/thresholds |
| Establecer un valor predeterminado de una entidad | PUT /entities/{id}/thresholds/{check_id} |
| Quitar un valor predeterminado de una entidad | DELETE /entities/{id}/thresholds/{check_id} |
Las claves que puede llevar la modificación de un nivel son warn, crit, expect, window y sigma. Una clave establecida en null desactiva esa parte en ese nivel.
# one resource: warn when page life expectancy stays under 900 s for 10 minutes
curl -s "${H[@]}" -X PATCH "$BASE/resources/$SQL01/checks/sqlserver.ple_seconds" \
-d '{"thresholds": {"warn": {"op": "<", "value": 900, "for": "10m"}}}' | jq .thresholds
# the Production entity: CPU warning above 75% for 15 minutes, no critical level
curl -s "${H[@]}" -X PUT "$BASE/entities/$PROD/thresholds/sqlserver.cpu_percent" \
-d '{"warn": {"op": ">", "value": 75, "for": "15m"}, "crit": null}'