Checks

Vigile dispositivos con checks (CPU, disco, memoria, ping, servicio de Windows, registro de eventos, script): umbrales, fallos seguidos, intervalos, ejecución, restablecimiento, historial y alertas.

Qué es y cuándo usarlo

Un check es una prueba que el agente ejecuta en el dispositivo a intervalos regulares: si el disco está demasiado lleno, si la CPU o la memoria están demasiado ocupadas, si un host responde al ping, si un servicio de Windows está en ejecución, si se ha escrito un evento en un registro de eventos de Windows, si un script devuelve éxito. El agente envía cada resultado a SONAR, que marca el check como Passing o como fallido con una severidad, conserva un historial de ejecuciones y genera una alerta cuando un check falla un número determinado de veces seguidas.

Los checks se definen en un dispositivo, en su pestaña CHECKS, o en una política de automatización, que los aplica a cada dispositivo que la hereda. Use las políticas para los checks que necesita todo dispositivo de un mismo tipo, y los checks de dispositivo para las excepciones.

Antes de empezar

• Un rol con List Checks para ver los checks, Manage Checks para añadirlos, editarlos, eliminarlos y restablecerlos, y Run Checks para Run Checks Now. Están en el grupo Checks & Monitoring de Admin Center › Roles.

• Acceso al cliente o al sitio del dispositivo.

• Para un check de script, el script en Management › Scripts, compatible con la plataforma del dispositivo. Un check de script falla cuando el script termina con un código distinto de 0, salvo que ese código figure como informativo o de advertencia.

• En un dispositivo, Linux y macOS ofrecen Ping Check y Script Check. Los otros cinco tipos son para dispositivos Windows.

Pasos

Añadir un check a un dispositivo

1. Abra Dashboard › Sysadmin, seleccione el dispositivo y abra su pestaña CHECKS.

2. Haga clic en New y elija el tipo: Disk Space Check, Ping Check, CPU Load Check, Memory Check, Windows Service Check, Script Check o Event Log Check.

3. Rellene el formulario (vea la referencia de campos de cada tipo).

4. Fije Number of consecutive failures before alert: cuántos resultados fallidos seguidos generan una alerta.

5. Deje Run this check every (seconds) en 0 para seguir el intervalo de checks del propio dispositivo, o fije un valor solo para este check.

6. Haga clic en Save.

7. En la fila del check, marque las columnas SMS Alert, Email Alert y Dashboard Alert de los canales que deben usarse cuando falle.

Para añadir checks a muchos dispositivos a la vez, añádalos a una política: abra Management › Automations, seleccione la política y use su pestaña Checks. Los formularios son los mismos, y los formularios de política ofrecen los siete tipos.

Ejecutar los checks ahora

Haga clic en Run Checks Now en la pestaña CHECKS, o elija Run Checks en el menú de acciones del dispositivo. El agente ejecuta todos sus checks de inmediato en lugar de esperar al siguiente intervalo. La confirmación dice Checks will now be run on <device>.

Restablecer un check fallido

Un restablecimiento marca un check fallido como correcto y resuelve su alerta abierta, sin esperar al siguiente resultado.

• Un check: haga clic en él con el botón derecho y elija Reset Check Status. La confirmación dice The check status was reset.

• Todos los checks del dispositivo: haga clic en Reset All Checks Status y confirme. La confirmación dice All checks status were reset.

Si el problema persiste, la siguiente ejecución vuelve a fallar y se abre una alerta nueva.

Ver el historial de ejecuciones

Haga clic en Show Run History en la columna More Info del check. El gráfico representa cada resultado durante Last 24 Hours, Last 7 Days, Last 30 Days o Everything:

• Los checks de CPU, memoria y disco representan el porcentaje, con las líneas de Warning Threshold y Error Threshold. Los checks de disco representan el espacio libre.

• Los checks de ping, servicio, registro de eventos y script representan Passing o Failing. Al pasar el puntero sobre un punto de un check de script se muestran su código de retorno, su salida y su tiempo de ejecución.

El historial se conserva durante el número de días fijado en Admin Center › Settings › Retention (vea Retención de datos).

Editar o eliminar

Haga doble clic en un check del dispositivo, o haga clic en él con el botón derecho y elija Edit o Delete. Los checks que proceden de una política muestran el icono de escudo (This check is managed by a policy) y se cambian en la política.

Cómo se evalúan los resultados

Check	Falla cuando	Severidad
CPU Load	La media de las últimas 15 muestras supera un umbral	Error por encima de Error Threshold (%); si no, Warning por encima de Warning Threshold (%)
Memory	Igual que la CPU, para el uso de memoria	Igual que la CPU
Disk Space	El espacio libre está por debajo de un umbral, o el disco no existe	Error por debajo de Error Threshold Remaining (%) o si falta el disco; si no, Warning por debajo de Warning Threshold Remaining (%)
Ping	El host no responde	La Alert Severity del check
Windows Service	El servicio no está en ejecución (vea las opciones de aprobación)	La Alert Severity del check
Event Log	Log contains: se encuentran al menos Number of events found before alert eventos coincidentes. Log does not contain: se encuentran menos	La Alert Severity del check
Script	El código de salida no es 0	Informational o Warning si el código está en la lista correspondiente; si no, Error

Un umbral que se deja en 0 no se evalúa. Debe fijarse al menos un umbral.

Cuando un check sigue fallando durante Number of consecutive failures before alert resultados, SONAR genera una alerta de check. Dónde se entrega depende de la configuración SMS Alert, Email Alert y Dashboard Alert del check y de la plantilla de alerta que se aplica al dispositivo; una plantilla de alerta puede forzar esta configuración, y la fila del check muestra entonces Setting is overridden by alert template: <name>. El primer resultado correcto resuelve la alerta. Vea Alertas y plantillas de alerta.

Un check también puede iniciar una tarea automatizada cuando falla: cree una tarea con el disparador On check failure y seleccione el check. La tarea aparece en la columna Assigned Tasks del check. Vea Tareas automatizadas.

Qué debe ver

Cada fila de check muestra las tres columnas de alerta, un icono de política para los checks de política (o This check is overriden by a policy cuando un check de política del mismo tipo sustituye a un check del dispositivo), el estado (Passing, Informational, Warning o Error), Description, More Info, Last Run y Assigned Tasks. Last Run muestra Never hasta el primer resultado.

More Info contiene el último detalle: la carga media, el uso del disco, el estado del servicio, el resumen del ping, los primeros caracteres de la salida de un script (haga clic en él para ver Script Output) o Last Output para los registros de eventos (haga clic en él para ver la lista de eventos encontrados).

Cómo verificar que funcionó

1. Haga clic en Run Checks Now, espere unos segundos y haga clic en el botón de actualizar de la pestaña. Last Run muestra la hora actual y el estado refleja el resultado.

2. Abra Show Run History y compruebe que el nuevo punto está ahí.

3. Para probar las alertas, haga fallar el check a propósito, por ejemplo con un check de disco cuyo Warning Threshold Remaining (%) esté por encima del espacio libre actual y con Number of consecutive failures before alert en 1. Tras la siguiente ejecución, el CHECKS STATUS del dispositivo en la lista de dispositivos cambia y la alerta aparece en la vista general Alerts, si el check o su plantilla de alerta activa el canal del panel.

4. Restablezca el umbral, vuelva a ejecutar los checks y confirme que la alerta se ha resuelto.

Errores comunes

Síntoma	Causa	Solución
New aparece atenuado con You don't have permission for this action	El rol no tiene Manage Checks	Añada el permiso
Warning Threshold or Error Threshold need to be set	Los dos umbrales están en 0	Fije al menos uno
Warning Threshold must be less than Error Threshold	Advertencia de CPU o memoria por encima del error	La CPU y la memoria suben hacia el umbral de error; fije la advertencia más baja
Warning Threshold must be more than Error Threshold	Advertencia de disco por debajo del error	Los umbrales de disco son de espacio libre; fije la advertencia más alta
A disk check for Drive <disk> already exists!	El dispositivo o la política ya comprueba ese disco	Edite el check existente
A cpuload check for this agent already exists / A memory check for this agent already exists	Solo un check de CPU y uno de memoria por dispositivo o política	Edite el check existente
Please enter a valid IP address or domain name	El destino del ping no es una dirección IP ni un nombre de dominio	Corrija Hostname or IP
Invalid Event ID	El ID de evento está vacío o no es un número	Introduzca un número, o * para todos los ID de evento
Checks are already running on <device>	Ya hay una ejecución en curso	Espere y actualice
Unable to contact the agent	El dispositivo está fuera de línea	Los checks vuelven a ejecutarse cuando se reconecta
El formulario de un check de script solo muestra un mensaje breve	Ningún script es compatible con la plataforma del dispositivo	Añada o ajuste un script en Management › Scripts
No hay alerta aunque el check falla	Menos fallos que el número configurado, o ningún canal activado en el check o en la plantilla de alerta	Compruebe Number of consecutive failures before alert y las columnas de alerta

Referencia de campos

Campos comunes

Campo	Qué hace	Valores aceptados	Predeterminado
Number of consecutive failures before alert	Resultados fallidos seguidos antes de que se genere una alerta	1 a 10	1
Run this check every (seconds)	Intervalo de este check. 0 usa el intervalo de checks del dispositivo, que se fija con Edit en el dispositivo	Segundos	0
Alert Severity	Solo ping, servicio y registro de eventos. Severidad del fallo	Informational, Warning, Error	Warning

Disk Space Check

Campo	Qué hace	Valores aceptados	Predeterminado
Disk	Unidad que se supervisa. En un dispositivo, la lista muestra sus unidades. No se puede cambiar después de guardar	Letra de unidad, de A: a Z:	Primera unidad
Warning Threshold Remaining (%)	Advertencia por debajo de este espacio libre	0 a 99	25
Error Threshold Remaining (%)	Error por debajo de este espacio libre	0 a 99	10

CPU Load Check y Memory Check

Campo	Qué hace	Valores aceptados	Predeterminado
Warning Threshold (%)	Advertencia por encima de esta media	0 a 99	70
Error Threshold (%)	Error por encima de esta media	0 a 99	90 para la CPU, 85 para la memoria

Ping Check

Campo	Qué hace	Valores aceptados	Predeterminado
Descriptive Name	Nombre que se muestra en Description	Texto	Vacío. Obligatorio
Hostname or IP	Destino al que se hace ping desde el dispositivo	IPv4, IPv6 o nombre de dominio	Vacío. Obligatorio

Windows Service Check

Campo	Qué hace	Valores aceptados	Predeterminado
Service	En un dispositivo, el servicio que se vigila, elegido entre los servicios del dispositivo. No se puede cambiar después de guardar	Un servicio	Primer servicio
Choose from defaults / Enter manually	Solo políticas. Elija de una lista de servicios comunes, o escriba Service Name y Display Name	Elección	Ninguno
PASS if service is in 'Start Pending' mode	Considera correcto un servicio que está arrancando	Activado o desactivado	Desactivado
PASS if service doesn't exist	Considera correcto un servicio que no existe, útil en las políticas	Activado o desactivado	Desactivado
Restart service if it's stopped	El agente inicia el servicio cuando lo encuentra detenido	Activado o desactivado	Desactivado

Event Log Check

Campo	Qué hace	Valores aceptados	Predeterminado
Descriptive Name	Nombre que se muestra en Description	Texto	Vacío. Obligatorio
Event log to query	Registro en el que se busca	Application, System, Security	Application
Fail When	Si encontrar eventos es un fallo o un éxito	Log contains, Log does not contain	Log contains
Event ID (Use * to match every event ID)	ID de evento que se busca	Un número, o *	Vacío. Obligatorio
Event source	Si se marca, solo coinciden los eventos de este origen	Texto	Desactivado
Message contains string	Si se marca, solo coinciden los eventos cuyo mensaje contiene el texto	Texto	Desactivado
How many previous days to search (Enter 0 for the entire log)	Ventana de búsqueda	0 a 9999	1
Event Type	Nivel de los eventos que se buscan	Information, Warning, Error, Success Audit, Failure Audit	Information
Number of events found before alert	Eventos coincidentes necesarios para que Log contains falle	Número entero	1

Script Check

El cuadro de diálogo se titula Add Policy Check (o Edit Policy Check) tanto en los dispositivos como en las políticas.

Campo	Qué hace	Valores aceptados	Predeterminado
Select script	Script que se ejecuta. No se puede cambiar después de guardar	Scripts de la biblioteca compatibles con la plataforma	Ninguno. Obligatorio
Policy Arguments (press Enter after typing each argument)	Argumentos que se pasan al script	Texto, con variables de script	Los valores predeterminados del script
Environment vars	Variables de entorno, como KEY=VALUE	Texto, con variables de script	Los valores predeterminados del script
Informational return codes	Códigos de salida que indican un fallo informativo	Números enteros	Ninguno
Warning return codes	Códigos de salida que indican una advertencia	Números enteros	Ninguno
Policy Timeout (seconds)	Tiempo máximo de ejecución del script	Segundos	El valor predeterminado del script

Páginas relacionadas

• Políticas de automatización

• Alertas y plantillas de alerta

• Tareas automatizadas

• Detalles del dispositivo

• Retención de datos