# Configuración de la tarea Discovery

El asistente contiene cuatro pasos visibles.

### 1. Task definition

Se configuran los datos generales de la tarea Discovery:

- Nombre de la tarea.
- Grupo de agentes.
- Intervalo de ejecución.

Debe seleccionarse un grupo real de Pandora FMS. No se debe utilizar `All`, ya que el plugin rechaza identificadores de grupo vacíos o menores o iguales a cero.

### 2. Azure credentials

| Campo | Obligatorio | Descripción |
|---|---|---|
| **Tenant ID** | Sí | Tenant de Microsoft Entra ID. |
| **Client ID** | Sí | Identificador de la aplicación registrada. |
| **Client secret** | Sí | Secreto de la aplicación. |
| **API endpoint** | No | Vacío utiliza `https://management.azure.com`. Solo se modifica para nubes soberanas o entornos personalizados. |
| **Login endpoint** | No | Vacío utiliza `https://login.microsoftonline.com`. Solo se modifica para nubes soberanas o entornos personalizados. |

### 3. Azure event query and filters

| Campo | Valor predeterminado | Descripción |
|---|---:|---|
| **Event history in days** | `15` | Periodo consultado, entre 1 y 365 días. |
| **Azure API filter** | Vacío | Expresión enviada a Azure mediante `$filter`. |
| **Subscription allow regexp** | Vacío | Expresiones aplicadas al ID y al nombre de la suscripción. |
| **Region allow regexp** | Vacío | Regiones que puede aceptar el plugin. |
| **Service allow regexp** | Vacío | Servicios impactados que puede aceptar el plugin. |
| **Event type allow regexp** | Vacío | Tipos de evento permitidos. |
| **Status allow regexp** | Vacío | Estados regionales o generales permitidos. |
| **Level allow regexp** | Vacío | Niveles permitidos. |
| **Event search allow regexp** | Vacío | Al menos una expresión debe coincidir con el texto completo del evento. |
| **Event search deny regexp** | Vacío | Descarta los eventos que coincidan. |
| **First run events are new** | Desactivado | Si se activa, todos los eventos de la primera ejecución se consideran nuevos. |

### 4. Agents modules and execution

| Campo | Valor predeterminado | Descripción |
|---|---:|---|
| **Create agent per impacted region** | Activado | Crea un agente por cada región. Desactivado utiliza **Target agent**. |
| **Target agent** | `Azure Service Health Events` | Agente único utilizado cuando no se crea un agente por región. |
| **Agent prefix** | `Azure Service Health ` | Prefijo de los agentes regionales. |
| **Module prefix** | Vacío | Prefijo añadido al nombre final de los módulos. |
| **State modules** | Activado | Crea el módulo `Connection`. |
| **Event count modules** | Activado | Crea los cinco módulos de recuento. |
| **Event detail modules** | Activado | Crea `Events` y `New events`. |
| **Maximum event detail length** | `16000` | Máximo de caracteres de los módulos de detalle. El mínimo efectivo es 1000. |
| **Modules allow regexp** | Vacío | Solo crea módulos cuyo nombre final coincida. |
| **Modules deny regexp** | Vacío | Descarta módulos cuyo nombre final coincida. |
| **Write event log** | Activado | Habilita el registro JSONL. |
| **Maximum event log size** | `20` | Rota el log al alcanzar este tamaño. |
| **HTTP timeout** | `30` | Tiempo máximo por petición. Cero o un valor negativo se convierte en 30 segundos. |
| **Maximum retries** | `2` | Reintentos para HTTP 429 y errores temporales de Azure. |
| **Verify SSL certificates** | Activado | Debe permanecer activo en producción. |
| **Proxy URL** | Vacío | Proxy HTTP o HTTPS opcional. |
| **Mock Azure API URL** | Vacío | Campo reservado para pruebas; debe permanecer vacío en producción. |