> 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. ## Información general RealmJoin Portal puede usar un Log Analytics Workspace en su propia suscripción de Azure para almacenar * sus **registro de auditoría** — cada acción realizada en el Portal, vea [Registro de auditoría](/es/supervision-y-registros/audit-log.md) * sus **registros operativos** * **registros de runbook**, archivados más allá de la retención máxima de Azure Automation (actualmente 30 días) Además, RealmJoin puede leer [Windows Update for Business Reports](https://learn.microsoft.com/en-us/windows/deployment/update/wufb-reports-overview) datos de un Log Analytics Workspace para mostrar posibles problemas con actualizaciones de Windows, como [Retenciones de salvaguarda de Windows Update](https://docs.microsoft.com/en-us/windows/deployment/update/safeguard-holds), en la [página de detalles del dispositivo](/es/ugd-management/user-list/device-details.md). Consulte [Windows Update for Business Reports](#windows-update-for-business-reports). El Log Analytics Workspace se configura con el [módulo de PowerShell de RealmJoin](/es/despliegue/onboarding-realmjoin-portal/advanced-setup.md). El Portal genera para usted un comando listo para copiar: no hay nada que rellenar manualmente. {% hint style="info" %} ¿Log Analytics ya está configurado para su tenant y usa la API Data Collector obsoleta? Entonces siga [la migración a la API de ingesta de registros](/es/supervision-y-registros/log-ingestion-api-migration.md) en su lugar: reutiliza su workspace existente y conserva sus registros existentes. {% endhint %} ## Componentes RealmJoin escribe sus registros a través de Azure Monitor **API de ingesta de registros**, basada en [Reglas de recopilación de datos (DCRs)](https://learn.microsoft.com/en-us/azure/azure-monitor/essentials/data-collection-rule-overview) y la autenticación de Microsoft Entra ID. Al ejecutar el comando de configuración se crea: * El **RealmJoin Azure Resources** Service Principal en su tenant de Entra ID (si aún no existe) * Un **Log Analytics Workspace** en el grupo de recursos que elija — o su Log Analytics Workspace existente, si especifica uno * Tres tablas personalizadas en ese workspace: `RJAuditLogs_CL`, `RJOperationalLogs_CL`, `RJRunbookLogs_CL` * Una Data Collection Rule 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: * **Lector de Log Analytics** en el workspace, para que el Portal pueda consultar sus registros * **Publicador de métricas de supervisión** en cada una de las tres Data Collection Rules, para que RealmJoin pueda escribir en ellas RealmJoin no recibe ningún otro permiso en su suscripción. No intervienen un registro de aplicación, un secreto de cliente ni una clave compartida del workspace. La implementación es idempotente: volver a ejecutar el mismo comando es seguro y solo aplica lo que falta. ## Requisitos previos ### En el RealmJoin Portal * Un rol que otorgue acceso al área de Configuración (`CanReadSettingsDetails`, consulte [Permisos disponibles](/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** para desplegar en él — el módulo no crea el grupo de recursos * Opcionalmente, un Log Analytics Workspace existente. Si no especifica uno, se crea un Log Analytics Workspace para usted en la región del grupo de recursos. ### En la máquina que ejecuta PowerShell * **PowerShell 5.1** o superior (Windows PowerShell o PowerShell 7) * Acceso a [PowerShell Gallery](https://www.powershellgallery.com/packages/RealmJoin) para instalar el módulo de RealmJoin * El `Az.Accounts`, `Az.Resources` y `Az.Automation` módulos — el módulo de RealmJoin los instala automáticamente en las versiones fijadas, para el usuario actual ### Permisos de la cuenta con la que inicia sesión * **Microsoft Entra ID:** permiso para crear Service Principals, por ejemplo *Administrador de aplicaciones*, *Administrador de aplicaciones en la nube* o *Administrador global*. Solo se necesita la primera vez, cuando el Service Principal de RealmJoin Azure Resources aún no existe. * **Suscripción de Azure:** permiso para desplegar en el grupo de recursos **y** para crear asignaciones de rol en él — por ejemplo *Propietario*, o *Colaborador* combinado con *Administrador de acceso de usuarios* / *Administrador de control de acceso basado en roles*. * El inicio de sesión se realiza a través de `Connect-AzAccount`, que usa la **Azure PowerShell** aplicación de primera parte. Los tenants que restringen el consentimiento del usuario pueden necesitar conceder primero el consentimiento de administrador a esa aplicación. {% hint style="warning" %} Ejecute el comando en una **recién abierta, local** sesión de PowerShell y evite **Azure Cloud Shell**. El módulo de RealmJoin requiere versiones exactas de los `Az.*` módulos. Si ya hay cargada una versión diferente en la sesión —que normalmente es 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 %} #### Prepare el grupo de recursos En el Azure Portal, cree o elija el grupo de recursos que debe contener el workspace. Anote su nombre y el ID de la suscripción en la que se encuentra. Si desea usar un **existente** Log Analytics Workspace, anote también su nombre. {% endstep %} {% step %} #### Copie el comando desde el RealmJoin Portal En el RealmJoin Portal, vaya a **Configuración → Log Analytics** (). La página indica que Log Analytics se administra mediante el módulo de PowerShell de RealmJoin y muestra un bloque de comandos. Use el **Copiar** botón 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 "" 6>&1 ``` Las primeras líneas instalan o actualizan el módulo de 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á ningún mensaje de progreso. {% endhint %} {% endstep %} {% step %} #### Agregue los parámetros de destino `Set-RJLogAnalyticsWorkspace` necesita saber dónde desplegar. Complete la última línea antes de ejecutarlo: ```powershell Set-RJLogAnalyticsWorkspace -ResourceGroupName "rg-realmjoin" -SubscriptionId "" -Token "" 6>&1 ``` * `-ResourceGroupName` es obligatorio. Si lo omite, PowerShell se lo pedirá. * `-SubscriptionId` es opcional: sin él, se usa la suscripción de su contexto actual de Azure, y se le pide que elija si hay varias disponibles. * `-WorkspaceName` es opcional. Páselo para definir el nombre de un nuevo workspace o para usar un **existente** workspace; de lo contrario, se crea uno nuevo con un nombre generado. {% endstep %} {% step %} #### Ejecute el comando Pegue el bloque en una nueva sesión de PowerShell y ejecútelo. El token es válido durante aproximadamente una hora — si ha caducado, vuelva a cargar la página de configuración y copie el comando de nuevo. Se le pedirá que inicie sesión con `Connect-AzAccount`. Si su cuenta tiene acceso a varios tenants o suscripciones, el módulo le pide que elija. La implementación informa entonces de cada recurso a medida que se crea: el Service Principal, el workspace, las tablas personalizadas, las Data Collection Rules y las asignaciones de rol. Una sola ejecución suele tardar unos minutos. {% hint style="info" %} ¿Quiere ver primero qué sucedería? Añada `-WhatIf` para una vista previa de What-If de Azure Resource Manager. Tenga en cuenta que iniciar sesión e instalar los `Az` módulos sigue ocurriendo, porque la vista previa necesita ambos. {% endhint %} {% hint style="info" %} **Cierre de sesión después:** el inicio de sesión de Azure permanece activo después de que el comando haya finalizado. Cuando termine, ejecute `Disconnect-AzAccount` para cerrar sesión de la sesión existente. {% endhint %} {% endstep %} {% step %} #### Verificar en el Portal Vuelva a **Configuración → Log Analytics** y seleccione **Actualizar**. La página ahora muestra la suscripción, el grupo de recursos, el nombre del workspace, el ID del workspace del cliente y el ID del Tenant como campos de solo lectura — a partir de ahora, estos parámetros los mantiene el módulo de PowerShell. En **Avanzado** puede revisar los puntos de conexión, los nombres de las reglas y los nombres de los flujos de las tres Data Collection Rules. Seleccione **Comprobar problemas de configuración** para verificar que todos los permisos de Azure requeridos estén presentes en el workspace y en cada Data Collection Rule. Después, abra el [Registro de auditoría](/es/supervision-y-registros/audit-log.md) o el [Registros de Runbook](/es/automatizacion/runbooks/runbook-logs.md) y confirme 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 registros durante más de 30 días, ajuste la [retención de datos del workspace](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 workspace 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: vuelva a ejecutarlo y las tablas y reglas se actualizan in situ. ## Windows Update for Business Reports [Windows Update for Business Reports](https://learn.microsoft.com/en-us/windows/deployment/update/wufb-reports-overview) (anteriormente Update Compliance) escribe eventos relacionados con actualizaciones en un Log Analytics Workspace. RealmJoin puede leer esos eventos y mostrarlos en la [página de detalles del dispositivo](/es/ugd-management/user-list/device-details.md). Esto es independiente del workspace en el que RealmJoin escribe sus propios registros. Puede apuntar RealmJoin al mismo workspace o a uno aparte. {% stepper %} {% step %} #### Habilitar Windows Update for Business Reports en Azure 1. En el Azure Portal, vaya a Monitor > Libros de trabajo 2. Busque "Windows Update for Business reports"
3. Establezca su Subscription y el Workspace que debe recibir los datos.\ ![](https://3832142177-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2FbpoMlLuJrekhPZpWKdM1%2Fimage.png?alt=media\&token=10a65dd5-fa55-413a-9e5c-7d6b93e09acd) 4. Guardar configuración {% hint style="warning" %} Windows Update for Business reports puede tardar hasta 24 horas en aplicarse. {% endhint %} {% endstep %} {% step %} #### Anote el ID del workspace Abra el workspace en Azure Portal y copie el **ID del workspace** (un GUID) de su página de información general. {% endstep %} {% step %} #### Introduzca el ID del workspace en el RealmJoin Portal Vaya a **Configuración → Cumplimiento de actualizaciones**, introduzca el ID del workspace y seleccione **Guardar**. Deje el campo vacío para deshabilitar la generación de informes de Safeguard Hold para este Tenant. {% endstep %} {% step %} #### Conceder acceso de lectura a RealmJoin Después de guardar, la página muestra un bloque de comandos. Concede al Service Principal de RealmJoin Azure Resources **Lector de Log Analytics** en ese workspace — no se despliega ni cambia nada más: ```powershell Grant-RJUpdateComplianceWorkspaceAccess -WorkspaceId "" 6>&1 ``` Si el workspace se encuentra en una suscripción diferente a la de su contexto actual de Azure, añada `-SubscriptionId ""`. Crear esta asignación de rol requiere permiso para administrar el acceso en el workspace, por ejemplo *Propietario* o *Administrador de acceso de usuarios*. {% endstep %} {% endstepper %} ## Configuración heredada (API Data Collector) {% hint style="danger" %} La configuración siguiente usa la API de Azure Monitor **API HTTP de recopilación de datos**, cuyo soporte Microsoft finaliza el **14 de septiembre de 2026**. Se documenta solo como referencia para Tenant configurados de esta manera en el pasado. No lo use para nuevas configuraciones — siga la [Configuración](#setup) anterior, o [migre una configuración existente](/es/supervision-y-registros/log-ingestion-api-migration.md). {% endhint %}
Mostrar la configuración heredada En esta ruta, RealmJoin se autenticaba con un registro de aplicación de Entra ID propiedad del cliente y la clave compartida del workspace, 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 el Azure Portal, vaya a Microsoft Entra ID > Administrar > Registros de aplicaciones. 2. Seleccione la pestaña Todas las aplicaciones. 3. Utilice de nuevo el registro de aplicación "RealmJoin Runbooks Management" creado cuando [incorporación de runbooks](/es/automatizacion/connecting-azure-automation.md), o seleccione "Nuevo registro" y registre una nueva aplicación. 4. En la aplicación, vaya a Administrar > Certificados y secretos, seleccione la pestaña "Secretos de cliente" y cree un nuevo secreto de cliente. Establezca la descripción y la caducidad según sus políticas internas de nomenclatura y seguridad. 5. Anote de forma segura el valor del secreto — si abandona la página, Azure lo ofusca y habrá que crear un nuevo secreto. **Parte 2 — Creación de un Log Analytics workspace** 1. En el Azure Portal, vaya a Log Analytics Workspace y seleccione Crear. 2. Proporcione un grupo de recursos, un nombre y una región según sea necesario. 3. En la pestaña "Información general", anote el nombre del grupo de recursos, el nombre del Log Analytics Workspace y el ID del Log Analytics Workspace. **Parte 3 — Permisos de Azure** 1. Vaya a la suscripción en la que reside su Log Analytics Workspace. 2. Seleccione Access Control (IAM) y agregue una asignación de rol. 3. Conceda a su registro de aplicación **Colaborador de supervisión** en el workspace usado para los registros de RealmJoin, y **Lector de supervisión** en un workspace usado solo para Windows Update for Business Reports. 4. Revise y guarde la asignación de rol. **Parte 4 — Conexión de RealmJoin y el workspace** En el RealmJoin Portal, vaya a Configuración > Log Analytics y complete los campos: * **TenantId** — su ID de tenant de Entra ID, de la página Información general de Entra ID * **ClientId** y **ClientSecret** — el registro de aplicación de la Parte 1 * **ID del workspace de Cumplimiento de actualizaciones** — el ID del workspace de Windows Update for Business Reports * **Subscription ID**, **Resource Group** y **Workspace Name** — del workspace de la Parte 2 * **ID del workspace del cliente** — el ID del workspace que almacena los datos de registro de auditoría y de runbook de RealmJoin * **Clave del workspace del cliente** — la "Primary Key" del Log Analytics Workspace, que permite a RealmJoin escribir datos. Puede obtenerse con el [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 le dará retroalimentación si todo funcionó.
--- # 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=&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.