> For the complete documentation index, see [llms.txt](https://wiki.datadike.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.datadike.com/es/sonar/administration/automation/checks.md). # 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](/es/sonar/administration/automation/automation-policies.md), 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 `. ### 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](/es/sonar/administration/settings/retention.md)). ### 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: `. El primer resultado correcto resuelve la alerta. Vea [Alertas y plantillas de alerta](/es/sonar/administration/automation/alerts.md). 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](/es/sonar/administration/automation/automated-tasks.md). ## 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 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 ` | 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](/es/sonar/reference/script-variables.md) | 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](/es/sonar/administration/automation/automation-policies.md) * [Alertas y plantillas de alerta](/es/sonar/administration/automation/alerts.md) * [Tareas automatizadas](/es/sonar/administration/automation/automated-tasks.md) * [Detalles del dispositivo](/es/sonar/administration/devices/device-details.md) * [Retención de datos](/es/sonar/administration/settings/retention.md)