> 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/get-started/core-concepts.md).

# Conceptos fundamentales

El vocabulario de SONAR (clientes, sitios, dispositivos, estado, políticas, checks, tareas, alertas, empleados, roles) y cómo se relacionan los objetos.

Casi todas las pantallas de la consola son una lista de uno de los objetos siguientes. Entender cómo encajan hace que el resto de esta documentación se lea rápido, y algunos de ellos se confunden con facilidad: esos se señalan al final.

## La cadena, en una frase

Un **dispositivo** ejecuta el **agente** y pertenece a un **sitio** de un **cliente**; las **políticas de automatización** que le llegan a través de ese cliente y ese sitio le dan sus **checks** y sus **tareas**; un check que falla genera una **alerta**, que se gestiona según indica su **plantilla de alerta**; y cada cambio hecho en la consola se escribe en el **registro de auditoría** a nombre del **usuario de SONAR** que lo hizo.

## Cómo se organizan los dispositivos

### Cliente

El nivel superior del árbol: una organización cuyos equipos usted gestiona. Cada sitio, y por tanto cada dispositivo, pertenece exactamente a un cliente. Los clientes aparecen en el grupo **Clients** de la barra lateral de **Sysadmin** y se gestionan desde **Management › Clients**.

### Sitio

Una subdivisión de un cliente: una oficina, una sucursal, un departamento. Un dispositivo pertenece exactamente a un sitio. El instalador del agente siempre se genera para un sitio, así que el sitio decide dónde aparece un dispositivo nuevo.

### Dispositivo y agente

Un **dispositivo** es un equipo que ejecuta el **agente**. El dispositivo es el registro en la consola; el agente es el software en el equipo. Cada dispositivo tiene un **tipo**, **workstation** o **server**, que se elige al instalar el agente. El tipo decide qué política de automatización le da al dispositivo un cliente o un sitio, ya que cada uno de ellos puede tener una política para estaciones de trabajo y otra para servidores.

Los dispositivos aparecen en **Dashboard › Sysadmin**, y al seleccionar uno se abre el panel del dispositivo con sus pestañas. Vea [La lista de dispositivos](/es/sonar/administration/devices/device-list.md).

## Estado del dispositivo

El estado de un dispositivo es el tiempo transcurrido desde la última señal de vida (heartbeat) del agente, que este envía aproximadamente una vez por minuto mientras está conectado. **Last Response**, en la lista de dispositivos, muestra cuándo llegó esa última señal.

| Estado      | Significado                                                       | Umbral predeterminado    |
| ----------- | ----------------------------------------------------------------- | ------------------------ |
| **online**  | El agente ha informado dentro del umbral de offline               | No se aplica             |
| **offline** | Ninguna señal de vida durante más tiempo que el umbral de offline | 12 horas (720 minutos)   |
| **overdue** | Ninguna señal de vida durante más tiempo que el umbral de retraso | 30 días (43.200 minutos) |

Ambos umbrales se definen por dispositivo, en el cuadro de diálogo **Edit** del dispositivo, como **Offline after (minutes)** y **Overdue after (minutes)**. Lo que genera una alerta de disponibilidad es que un dispositivo pase a estar con retraso (overdue), cuando el dispositivo o su plantilla de alerta la solicitan; la alerta se resuelve cuando el dispositivo vuelve a informar.

Los contadores del dashboard **Home** y del **Clients overview** agrupan los dispositivos por franjas fijas de tiempo desde su último contacto (menos de 12 horas, más de 12 horas, más de 24 horas, más de 7 días, más de 30 días) y cuentan aparte los dispositivos en modo de mantenimiento. El Clients overview también cuenta por separado los dispositivos archivados.

### Modo de mantenimiento

Un interruptor en un dispositivo, o en todos los dispositivos de un sitio o de un cliente a la vez (**Enable Maintenance Mode** en el menú del dispositivo o en el árbol de clientes). Mientras un dispositivo está en modo de mantenimiento, no se genera ninguna alerta para él. Sus checks y tareas siguen ejecutándose, y se cuenta en **In Maintenance** en lugar de por su estado. Úselo para trabajos planificados, para que un servidor que usted está reiniciando no avise a nadie.

### Dispositivo archivado

**Archive Agent** indica al agente del equipo que se desinstale, lo que ocurre si el dispositivo está en línea en ese momento, y conserva el registro y el historial del dispositivo en la consola, contado en **Archived**. No se genera ninguna alerta para un dispositivo archivado. Desarchivarlo no reinstala el agente; para volver a gestionar ese equipo, instale el agente en él.

## Automatización

### Política de automatización

Un conjunto con nombre de **checks** y **tareas** (y, opcionalmente, una política de actualizaciones y una plantilla de alerta) que usted define una vez y asigna a muchos dispositivos. Las políticas se gestionan en **Management › Automations** y se asignan con **Assign Automation Policy**, en un dispositivo, un sitio o un cliente.

Un dispositivo recibe, del nivel más específico al más general:

1. la política asignada al propio dispositivo;
2. la **Workstation Policy** o la **Server Policy** del sitio, según el tipo de dispositivo;
3. la política para estaciones de trabajo o para servidores del cliente;
4. la política predeterminada para estaciones de trabajo o para servidores, definida en **Admin Center › Settings**, en **Defaults**.

**Block policy inheritance** en un dispositivo, un sitio o un cliente impide que se apliquen los niveles superiores. Cuando un check propio del dispositivo y un check de una política miden lo mismo (el mismo disco, el mismo servicio), prevalece el check del dispositivo, salvo que la política esté marcada como **Enforced**, en cuyo caso prevalece el check de la política. Las tareas no se fusionan: el dispositivo ejecuta sus propias tareas y las de todas las políticas que le llegan.

Vea [Políticas de automatización](/es/sonar/administration/automation/automation-policies.md).

### Check

Una medición que el agente toma de forma programada, con un resultado de éxito o fallo: **CPU Load Check**, **Memory Check**, **Disk Space Check**, **Ping Check**, **Windows Service Check**, **Event Log Check**, **Script Check**. Un check que falla un número determinado de veces seguidas genera una alerta. Los resultados están en la pestaña **Checks** del dispositivo. Vea [Checks](/es/sonar/administration/automation/checks.md).

### Tarea

Una tarea automatizada: una secuencia de comandos y scripts que el agente ejecuta de forma programada (**Daily**, **Weekly**, **Monthly**, **Run Once**) o cuando falla un check (**On check failure**), una vez cuando la tarea llega por primera vez a un dispositivo (**Onboarding**), o solo cuando usted la inicia (**Manual**). Los resultados están en la pestaña **Tasks** del dispositivo. Vea [Tareas automatizadas](/es/sonar/administration/automation/automated-tasks.md).

### Script

Un fragmento de código reutilizable guardado en **Management › Scripts** (PowerShell, Batch, Python, Shell, Nushell o Deno) que usted ejecuta en un dispositivo, en muchos dispositivos, como check o como paso de una tarea. Vea [Biblioteca de scripts](/es/sonar/administration/automation/scripts.md).

## Alertas

### Alerta

Un registro de que algo requiere atención: un dispositivo pasó a estar con retraso, un check falló o una tarea falló. Cada alerta tiene una gravedad (**Informational**, **Warning** o **Error**) y permanece abierta hasta que se resuelve, ya sea sola, cuando el check vuelve a pasar o el dispositivo regresa, o a mano. La campana del encabezado muestra las alertas activas más recientes.

### Plantilla de alerta

Las reglas que deciden qué ocurre cuando una alerta se abre y cuando se resuelve: quién recibe un correo electrónico o un SMS, si la alerta se muestra en la consola y qué script o solicitud web se ejecuta como acción. Las plantillas se gestionan desde el botón **Alerts** del encabezado y se asignan a un cliente, un sitio o una política de automatización, o se definen como predeterminadas en **Admin Center › Settings**.

La plantilla vigente para un dispositivo es la más específica: la de la política del dispositivo, luego la del sitio, luego la del cliente y luego la predeterminada. En los niveles de sitio y de cliente, una plantilla que trae la política de automatización asignada tiene prioridad sobre una asignada directamente. Vea [Alertas y plantillas de alerta](/es/sonar/administration/automation/alerts.md).

## Personas y acceso

### Usuario de SONAR

Una persona que inicia sesión en la consola. Los usuarios de SONAR se gestionan en **Admin Center › Users**, inician sesión con una contraseña y un segundo factor, y tienen un **rol** cada uno. Todo lo que cambian se escribe en el registro de auditoría a su nombre.

### Rol

Lo que un usuario de SONAR puede hacer en la consola: un conjunto de permisos, agrupados como **Agents**, **System**, **Automation & Tasks**, **Policies**, etc., más **Client & Site Access**, es decir, los **Allowed Clients** y **Allowed Sites** a los que el rol está limitado. Una lista vacía significa que se permiten todos los clientes, o todos los sitios. **Super User** lo concede todo. Los roles se gestionan en **Admin Center › Roles**. Vea [Roles y permisos](/es/sonar/administration/identities/roles.md).

### Empleado

Una persona que usa los equipos gestionados, no alguien que inicia sesión en la consola. SONAR crea un registro de empleado la primera vez que el módulo de productividad ve un nombre de usuario de Windows nuevo en una sesión, y usted lo completa con el nombre, el cargo, el departamento y los sitios en los que trabaja la persona. Un empleado puede tener varios nombres de usuario. Los empleados están en **Management › Employees**, y los **términos** de uso firmados asociados a ellos, en **Management › Terms**. Vea [Empleados](/es/sonar/administration/employees/employees.md).

### Política de acceso

Un conjunto de franjas horarias de inicio de sesión de Windows (por ejemplo, de lunes a viernes, de 08:00 a 18:00) asignado a dispositivos (un dispositivo, un sitio, un cliente o todos los dispositivos) y a usuarios (un nombre de usuario, un patrón de nombre de usuario o los empleados de un sitio). Para esos usuarios en esos dispositivos, el módulo de productividad bloquea un inicio de sesión fuera de la franja, avisa antes de que termine la franja y cierra la sesión del usuario cuando termina, según la configuración de la política. Los usuarios que ninguna política cubre no se ven afectados. Las políticas de acceso están en **Observability › Policies**. Vea [Políticas de acceso](/es/sonar/administration/access/access-policies.md).

### Solicitud de extensión

Una solicitud que un usuario final envía desde un equipo Windows para tener más tiempo fuera de su franja. Aparece en **Observability › Requests**, donde usted la aprueba o la deniega; una solicitud aprobada concede a ese usuario un permiso temporal. Vea [Solicitudes de extensión](/es/sonar/administration/access/requests.md).

## Registro de auditoría

El registro de lo que ocurrió a través de la consola: objetos creados, cambiados y eliminados, con sus valores antes y después; inicios de sesión; comandos y scripts ejecutados; acciones masivas; sesiones remotas. Está en **Reports & Audits › Audits**, y los registros de un dispositivo están en su pestaña **Audits**. La pestaña **History** del dispositivo guarda la salida de los comandos, scripts y tareas ejecutados en él. Vea [Registro de auditoría](/es/sonar/administration/audit/audit-trail.md).

## Distinciones que conviene tener claras

**Usuario de SONAR no es empleado.** Un usuario de SONAR inicia sesión en la consola y actúa sobre los dispositivos. Un empleado usa un equipo gestionado y nunca inicia sesión en la consola. La misma persona puede ser ambas cosas, con dos registros sin relación entre sí.

**Política de automatización no es política de acceso.** Una política de automatización da checks y tareas a los dispositivos: se ocupa del cuidado del equipo. Una política de acceso decide cuándo pueden las personas iniciar sesión en Windows: se ocupa del usuario. Se gestionan en lugares distintos (**Management › Automations** y **Observability › Policies**) y nunca se afectan entre sí.

**Check no es tarea.** Un check mide e informa de un éxito o un fallo; puede generar una alerta. Una tarea actúa: ejecuta comandos y scripts. Ambos se encuentran cuando una tarea se configura para ejecutarse **On check failure**, que es como un check que falla puede corregir su propia causa.

**Rol no es solo alcance de clientes.** Un rol concede acciones y a la vez las limita a sus clientes y sitios permitidos. Dar a alguien acceso a un cliente no le permite ejecutar scripts en él, salvo que el rol también conceda **Run Scripts**.

**Fuera de línea no es lo mismo que con retraso.** Fuera de línea significa que el dispositivo no ha informado desde hace un rato, como un portátil que se apaga por la noche. Con retraso significa que lleva ausente el tiempo suficiente para generar una alerta de disponibilidad.

## Páginas relacionadas

* [Arquitectura y componentes](/es/sonar/get-started/architecture.md): el software que hace funcionar estos objetos
* [Un recorrido por la consola](/es/sonar/get-started/console-tour.md): dónde está cada objeto
* [Incorpore su primer dispositivo](/es/sonar/get-started/first-device.md): el vocabulario en la práctica
* [Clientes y sitios](/es/sonar/administration/devices/clients-and-sites.md)
* [Glosario](/es/sonar/reference/glossary.md)
