> For the complete documentation index, see [llms.txt](https://docs.realmjoin.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.realmjoin.com/es/supervision-y-registros/log-analytics.md).

# Conectando Azure Log Analytics Workspace

Conecta un Azure Log Analytics Workspace a RealmJoin Portal con el módulo de PowerShell de RealmJoin para almacenar registros de auditoría, operativos y de runbook en tu propio Tenant.

## Resumen

RealmJoin Portal puede usar un Log Analytics Workspace en tu propia suscripción de Azure para almacenar

* su **registro de auditoría** — cada acción realizada en el Portal, vea [Audit Log](https://docs.realmjoin.com/es/supervision-y-registros/audit-log.md)
* su **registros operativos**
* **registros de runbooks**, archivados más allá del período máximo de retención de Azure Automation (actualmente 30 días)

El espacio de trabajo se configura con la [módulo PowerShell de RealmJoin](https://docs.realmjoin.com/es/despliegue/onboarding-realmjoin-portal/advanced-setup.md). El Portal genera un comando listo para copiar — no hay nada que completar manualmente.

{% hint style="info" %}
¿Ya está configurado Log Analytics para tu tenant y usa la obsoleta Data Collector API? Entonces sigue [Migrando a la API de ingesta de registros](https://docs.realmjoin.com/es/supervision-y-registros/log-ingestion-api-migration.md) en su lugar — reutiliza tu espacio de trabajo existente y conserva tus registros existentes.
{% endhint %}

## Componentes

RealmJoin escribe sus registros a través de Azure Monitor **API de ingesta de registros**, basado en [Reglas de recopilación de datos (DCRs)](https://learn.microsoft.com/en-us/azure/azure-monitor/essentials/data-collection-rule-overview) y autenticación de Microsoft Entra ID. Ejecutar el comando de configuración crea:

* Los **RealmJoin Azure Resources** Service Principal en tu tenant de Entra ID (si aún no existe)
* Una **espacio de trabajo de Log Analytics** en el grupo de recursos que elijas — o tu espacio de trabajo existente, si indicas uno
* Tres tablas personalizadas en ese espacio de trabajo: `RJAuditLogs_CL`, `RJOperationalLogs_CL`, `RJRunbookLogs_CL`
* Una Regla de recopilación de datos por tabla (`dcr-rj-aud-logs-*`, `dcr-rj-op-logs-*`, `dcr-rj-rb-logs-*`), cada una con su propio punto de conexión de ingesta directa
* Exactamente dos tipos de asignación de roles para RealmJoin, y nada más que eso:
  * **Log Analytics Reader** on the workspace, so the Portal can query your logs
  * **Monitoring Metrics Publisher** on each of the three Data Collection Rules, so RealmJoin can write to them

RealmJoin no recibe ningún otro permiso en tu suscripción. No intervienen registros de aplicación, secretos de cliente ni claves compartidas del espacio de trabajo. La implementación es idempotente — volver a ejecutar el mismo comando es seguro y solo aplica lo que falta.

## Requisitos previos

### En el Portal de RealmJoin

* Un rol que concede acceso al área de Configuración (`CanReadSettingsDetails`, consulta [Permisos disponibles](https://docs.realmjoin.com/es/administracion-y-configuracion/permission/custom-roles/available-permissions.md)). La página de configuración genera el comando de configuración, incluido un token de incorporación de corta duración.

### En Azure

* Una suscripción de Azure y un **grupo de recursos existente** en el que implementar — el módulo no crea el grupo de recursos
* Opcionalmente, un espacio de trabajo de Log Analytics existente. Si no indicas uno, se crea un espacio de trabajo para ti en la región del grupo de recursos.

### En la máquina que ejecuta PowerShell

* **PowerShell 5.1** o posterior (Windows PowerShell o PowerShell 7)
* Acceso a la [PowerShell Gallery](https://www.powershellgallery.com/packages/RealmJoin) para instalar el módulo RealmJoin
* Los `Az.Accounts`, `Az.Resources` y `Az.Automation` módulos — el módulo RealmJoin los instala automáticamente en las versiones fijadas, para el usuario actual

### Permisos de la cuenta con la que inicias sesión

* **Microsoft Entra ID:** permiso para crear Service Principals, por ejemplo *Application Administrator*, *Cloud Application Administrator* o *Global Administrator*. Solo se necesita la primera vez, cuando el Service Principal RealmJoin Azure Resources aún no existe.
* **Suscripción de Azure:** permiso para implementar en el grupo de recursos **y** para crear asignaciones de roles en él — por ejemplo *Owner*, o *Contributor* combinado con *User Access Administrator* / *Role Based Access Control Administrator*.
* El inicio de sesión se realiza a través de `Connect-AzAccount`, que usa la aplicación de primera parte **Azure PowerShell** . Los tenants que restringen el consentimiento del usuario pueden necesitar conceder primero consentimiento de administrador a esa aplicación.

{% hint style="warning" %}
Ejecuta el comando en una **recién abierta, local** sesión de PowerShell y evita **Azure Cloud Shell**. El módulo RealmJoin requiere versiones exactas de los `módulos Az.*` módulos. Si ya hay cargada otra versión en la sesión — que suele ser el caso en Cloud Shell — el módulo se detiene con un conflicto de versiones que solo puede resolverse abriendo una nueva sesión.
{% endhint %}

## Configuración

{% stepper %}
{% step %}

#### Prepara el grupo de recursos

En Azure Portal, crea o elige el grupo de recursos que debe albergar el espacio de trabajo. Anota su nombre y el ID de la suscripción en la que reside.

Si quieres usar un **workspace existente** espacio de trabajo de Log Analytics, anota también su nombre.
{% endstep %}

{% step %}

#### Copia el comando desde RealmJoin Portal

En RealmJoin Portal, navega a **Configuración → Log Analytics** (<https://portal.realmjoin.com/settings/log-analytics-configuration>).

La página indica que Log Analytics se administra mediante el módulo de PowerShell de RealmJoin y muestra un bloque de comandos. Usa el **botón Copiar** para copiarlo.

```powershell
$latest = [version](Find-Module RealmJoin -Repository PSGallery -ErrorAction Stop).Version
if (-not (Get-Module -ListAvailable RealmJoin | Where-Object Version -ge $latest)) {
    Install-Module RealmJoin -Force -AllowClobber -ErrorAction Stop
}
Import-Module RealmJoin -Force
Set-RJLogAnalyticsWorkspace -Token "<Token>" 6>&1
```

Las primeras líneas instalan o actualizan el módulo RealmJoin y lo importan. `Set-RJLogAnalyticsWorkspace` realiza la implementación y registra el resultado con RealmJoin usando el `-Token`.

{% hint style="info" %}
**Acerca de `6>&1`:** estos comandos informan de su progreso en el flujo de información de PowerShell. La `6>&1` redirección muestra esa salida en la consola — sin ella no verás ningún mensaje de progreso.
{% endhint %}
{% endstep %}

{% step %}

#### Agrega los parámetros de destino

`Set-RJLogAnalyticsWorkspace` necesita saber dónde implementar. Completa la última línea antes de ejecutarlo:

```powershell
Set-RJLogAnalyticsWorkspace -ResourceGroupName "rg-realmjoin" -SubscriptionId "<SubscriptionId>" -Token "<Token>" 6>&1
```

* `-ResourceGroupName` es obligatorio. Si lo omites, PowerShell te lo solicitará.
* `-SubscriptionId` es opcional — sin él, se usa la suscripción de tu contexto actual de Azure, y se te pide elegir si hay varias disponibles.
* `-WorkspaceName` es opcional. Pásalo para definir el nombre de un nuevo espacio de trabajo o para usar un **workspace existente** espacio de trabajo; de lo contrario, se crea uno nuevo con un nombre generado.
  {% endstep %}

{% step %}

#### Ejecuta el comando

Pega el bloque en una nueva sesión de PowerShell y ejecútalo. El token es válido durante aproximadamente una hora — si ha caducado, vuelve a cargar la página de configuración y copia el comando de nuevo.

Se te pedirá iniciar sesión con `Connect-AzAccount`. Si tu cuenta tiene acceso a varios tenants o suscripciones, el módulo te pedirá que elijas.

La implementación informa entonces de cada recurso a medida que se crea: el Service Principal, el espacio de trabajo, las tablas personalizadas, las reglas de recopilación de datos y las asignaciones de roles. Una sola ejecución suele tardar unos minutos.

{% hint style="info" %}
¿Quieres ver primero qué ocurriría? Añade `-WhatIf` para obtener una vista previa What-If de Azure Resource Manager. Ten en cuenta que iniciar sesión e instalar los `módulo Az` módulos sigue ocurriendo, porque la vista previa necesita ambas cosas.
{% endhint %}

{% hint style="info" %}
**Cerrar sesión después:** el inicio de sesión de Azure sigue activo después de que el comando haya terminado. Cuando hayas terminado, ejecuta `Disconnect-AzAccount` para cerrar la sesión activa.
{% endhint %}
{% endstep %}

{% step %}

#### Verificar en el Portal

Vuelve a **Configuración → Log Analytics** y selecciona **Actualizar**.

La página ahora muestra la suscripción, el grupo de recursos, el nombre del espacio de trabajo, el ID del espacio de trabajo del cliente y el ID de Tenant como campos de solo lectura — estas configuraciones serán mantenidas por el módulo de PowerShell a partir de ahora. Debajo de **Avanzado** puedes revisar los puntos de conexión, los nombres de regla y los nombres de flujo de las tres Reglas de recopilación de datos.

Seleccione **Comprobar problemas de configuración** para verificar que todos los permisos de Azure requeridos estén presentes en el workspace y en cada Regla de recopilación de datos.

Después, abre el [Audit Log](https://docs.realmjoin.com/es/supervision-y-registros/audit-log.md) o la [Runbook Logs](https://docs.realmjoin.com/es/automatizacion/runbooks/runbook-logs.md) y confirma que aparecen entradas. Azure necesita unos minutos para poner disponibles las tablas personalizadas recién creadas.
{% endstep %}
{% endstepper %}

## Retención de datos

{% hint style="warning" %}
Para conservar los registros durante más de 30 días, ajusta la [retención de datos del espacio de trabajo](https://learn.microsoft.com/en-us/azure/azure-monitor/logs/data-retention-archive?tabs=portal-1%2Cportal-2) en Azure. Tanto el valor predeterminado del espacio de trabajo como la retención de Azure Automation son de 30 días.
{% endhint %}

## Mantener el esquema actualizado

Si RealmJoin amplía el esquema de registros en una versión futura, la página de configuración muestra un aviso de que el esquema de Log Analytics implementado está desactualizado, junto con el comando para actualizarlo. Ese es el **mismo** `Set-RJLogAnalyticsWorkspace` comando — ejecútalo de nuevo y las tablas y reglas se actualizan in situ.

## Configuración heredada (Data Collector API)

{% hint style="danger" %}
La configuración siguiente usa Azure Monitor **API HTTP Data Collector**, cuyo soporte Microsoft finaliza el **14 de septiembre de 2026**. Se documenta solo como referencia para tenants que se configuraron de esta manera en el pasado. No lo uses para nuevas configuraciones — sigue el [Configuración](#setup) anterior, o [migra una configuración existente](https://docs.realmjoin.com/es/supervision-y-registros/log-ingestion-api-migration.md).
{% endhint %}

<details>

<summary>Mostrar la configuración heredada</summary>

En esta ruta, RealmJoin se autenticaba con un registro de aplicación de Entra ID propiedad del cliente y con la clave compartida del espacio de trabajo, y escribía en las tablas `AuditLogs_CL`, `OperationalLogs_CL` y `RunbookLogs_CL`.

**Parte 1 — Autenticación mediante un registro de aplicación de Azure**

1. En Azure Portal, navega a Microsoft Entra ID > Administrar > Registros de aplicaciones.
2. Selecciona la pestaña Todas las aplicaciones.
3. O bien reutiliza el registro de aplicación "RealmJoin Runbooks Management" creado cuando [runbooks de incorporación](https://docs.realmjoin.com/es/automatizacion/connecting-azure-automation.md), o selecciona "Nuevo registro" y registra una nueva aplicación.
4. En la aplicación, navega a Administrar > Certificados y secretos, selecciona la pestaña "Secretos de cliente" y crea un nuevo secreto de cliente. Establece la descripción y la expiración según tus políticas internas de nomenclatura y seguridad.
5. Anota de forma segura el valor del secreto — si sales de la página, Azure lo ofusca y tendrás que crear un nuevo secreto.

**Parte 2 — Creación de un espacio de trabajo de Log Analytics**

1. En Azure Portal, navega a Log Analytics Workspace y selecciona Crear.
2. Proporciona un grupo de recursos, un nombre y una región según se requiera.
3. En la pestaña "Resumen", anota el nombre del grupo de recursos, el nombre del espacio de trabajo y el ID del espacio de trabajo.

**Parte 3 — Permisos de Azure**

1. Navega a la suscripción en la que reside tu espacio de trabajo de Log Analytics.
2. Selecciona Control de acceso (IAM) y agrega una asignación de rol.
3. Concede a tu registro de aplicación **Colaborador de supervisión** en el espacio de trabajo usado para los registros de RealmJoin.
4. Revisa y guarda la asignación de rol.

**Parte 4 — Conexión de RealmJoin y el espacio de trabajo**

En RealmJoin Portal, navega a Configuración > Log Analytics y completa los campos:

* **TenantId** — el ID de Tenant de Entra ID, desde la página Overview de Entra ID
* **ClientId** y **ClientSecret** — el registro de aplicación de la Parte 1
* **ID de suscripción**, **Grupo de recursos** y **Nombre del espacio de trabajo** — del espacio de trabajo de la Parte 2
* **Id del espacio de trabajo del cliente** — el ID del espacio de trabajo que almacena los datos de auditoría y registros de runbook de RealmJoin
* **Clave del espacio de trabajo del cliente** — la "Primary Key" del espacio de trabajo, que permite a RealmJoin escribir datos. Se puede obtener con la [Azure CLI](https://learn.microsoft.com/en-us/cli/azure/monitor/log-analytics/workspace?view=azure-cli-latest#az-monitor-log-analytics-workspace-get-shared-keys) (`az monitor log-analytics workspace get-shared-keys --resource-group MyResourceGroup --workspace-name MyWorkspace`) o con [PowerShell](https://learn.microsoft.com/en-us/powershell/module/az.operationalinsights/get-azoperationalinsightsworkspacesharedkey?view=azps-14.6.0) (`Get-AzOperationalInsightsWorkspaceSharedKey -ResourceGroupName "MyResourceGroup" -Name "MyWorkspace"`).

Pulse **Guardar** después de completar todos los campos. El sistema te muestra una respuesta si todo funcionó.

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.realmjoin.com/es/supervision-y-registros/log-analytics.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
