> 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). # Conexión de Azure Log Analytics Workspace ## Descripción general RealmJoin Portal puede mostrar posibles problemas con las actualizaciones de Windows, como [Retenciones de SafeGuard de Windows Update](https://docs.microsoft.com/en-us/windows/deployment/update/safeguard-holds) mediante la integración con [Informes de Windows Update for Business](https://learn.microsoft.com/en-us/windows/deployment/update/wufb-reports-overview). Además, RealmJoin Portal utilizará Log Analytics para almacenar información del registro de auditoría y archivar los datos de ejecución de Runbook más allá de los límites predeterminados de Azure Automation (actualmente 30 días). ## Componentes ### Registro de aplicación de Azure RealmJoin interactuará con ambos espacios de trabajo de Log Analytics mediante un [registro de aplicación de Entra ID](https://docs.microsoft.com/en-us/azure/active-directory/develop/app-objects-and-service-principals). {% hint style="info" %} Puede reutilizar el registro de aplicación "RealmJoin Runbook Management", que se crea cuando [runbooks de incorporación](/es/automatizacion/connecting-azure-automation.md). {% endhint %} Esta app se autenticará usando un ClientId y un ClientSecret. Actualmente no se admite el uso de un certificado o de una Managed Identity. Por favor, conceda a la app "**Lector de supervisión**" permisos en las cuentas de Log Analytics utilizadas para [Integración de informes de Windows Update for Business](#windows-update-for-business-reports-integration) y "**Colaborador de supervisión**" para los [registros de auditoría de RealmJoin](#realmjoin-audit-logs) cuenta de Log Analytics. RealmJoin también utilizará [Clave del espacio de trabajo del cliente](#customer-workspace-key) para escribir datos directamente en [registros de auditoría de RealmJoin](#realmjoin-audit-logs). ### Integración de informes de Windows Update for Business [Informes de Windows Update for Business](https://learn.microsoft.com/en-us/windows/deployment/update/wufb-reports-overview) debe configurarse en su entorno para aprovechar esta funcionalidad. Escribirá eventos relacionados con actualizaciones en un [Azure Log Analytics Workspace](https://docs.microsoft.com/en-us/azure/azure-monitor/logs/log-analytics-overview). RealmJoin puede leer los eventos de este Log Analytics Workspace y mostrarlos en la[ página de detalles del dispositivo](/es/ugd-management/user-list/device-details.md). {% hint style="info" %} Puede usar la misma cuenta de Log Analytics para ambos [Informes de Windows Update for Business](https://learn.microsoft.com/en-us/windows/deployment/update/wufb-reports-overview) y [registros de auditoría de RealmJoin](#realmjoin-audit-logs). Por favor, asigne "**Colaborador de supervisión**" permisos en este caso. {% endhint %} ### registros de auditoría de RealmJoin RealmJoin puede usar un espacio de trabajo de Log Analytics para almacenar sus propios registros de auditoría, así como archivar los registros de runbook después del período máximo de retención en Azure Automation (actualmente 30 días). Tenga en cuenta que, para almacenar registros durante más de 30 días, deberá modificar la [retención de datos predeterminada del espacio de trabajo](https://learn.microsoft.com/en-us/azure/azure-monitor/logs/data-retention-archive?tabs=portal-1%2Cportal-2), que también está configurada en 30 días de forma predeterminada. ## Configuración ### Parte 1 - Autenticación mediante un registro de aplicación de Azure 1. En Azure Portal, vaya a Microsoft Entra ID > Administrar > Registros de aplicaciones. 2. Seleccione la pestaña Todas las aplicaciones. 3. Elija el siguiente paso. {% tabs %} {% tab title="Integración de Runbook existente" %} Si ya ha [integrado con Azure Runbooks](/es/automatizacion/connecting-azure-automation.md), puede reutilizar su registro de aplicación existente. 1. Seleccione el registro de aplicación "RealmJoin Runbooks Management". 2. Vaya a Administrar > Certificados y secretos. 3. Seleccione la pestaña "Secretos de cliente". 4. Cree un nuevo secreto de cliente. * Establezca la descripción y la expiración según sus políticas internas de nomenclatura y seguridad. {% endtab %} {% tab title="Nuevo registro de aplicación" %} Si no ha integrado runbooks o prefiere un registro de aplicación independiente, haga lo siguiente: 1. Seleccione "Nuevo registro" 2. Proporcione un nombre
3. Registre la aplicación 4. Seleccione la aplicación 5. Vaya a Administrar > Certificados y secretos 6. Seleccione la pestaña "Secretos de cliente" 7. Cree un nuevo secreto de cliente * Establezca la descripción y la expiración según sus políticas internas de nomenclatura y seguridad {% endtab %} {% endtabs %} 8. Anote de forma segura el valor secreto para usarlo en [Parte 5](#part-4-connecting-realmjoin-and-azure-log-analytics-workspace). {% hint style="warning" %} Si abandona la página de Certificados y secretos, Azure ofuscará el secreto. El secreto no se podrá recuperar y será necesario crear uno nuevo. {% endhint %} ### Parte 2 - Creación de un Log Analytics Workspace 1. En Azure Portal, vaya a Log Analytics Workspace 2. Seleccione Crear 3. Proporcione un grupo de recursos, un nombre y una región según sea necesario 4. Vaya a la pestaña "Overview" 5. Anote lo siguiente para [Parte 5](#part-5-connecting-realmjoin-and-azure-log-analytics-workspace) 1. Nombre del grupo de recursos 2. Nombre del espacio de trabajo 3. ID del espacio de trabajo ### Parte 3 - Habilitación de informes de Windows Update for Business 1. En Azure Portal, vaya a Monitor > Libros de trabajo 2. Busque "informes de Windows Update for Business"
3. Configure su Subscription y el Workspace creado previamente. Si se prefiere un Workspace separado para los registros de RealmJoin y los informes de Windows Update for Business, cree un Workspace separado y vincúlelo en su lugar.\ ![](/files/b6d8e0b6f6554fdcca4b7178043eaa7caf0ff34b) 4. Guardar configuración {% hint style="warning" %} Los informes de Windows Update for Business pueden tardar hasta 24 horas en aplicarse {% endhint %} ### Parte 4 - Permisos de Azure 1. Vaya a la suscripción en la que reside su Log Analytics Workspace 2. Seleccione Control de acceso (IAM) 3. Agregue una asignación de rol 4. Conceda a su registro de aplicación permisos de Colaborador de supervisión
5. Revise y guarde la asignación de rol ### Parte 5 - Conexión de RealmJoin y Azure Log Analytics Workspace

Página de configuración de Log Analytics

1. En RealmJoin Portal, vaya a Configuración ![](/files/36207668f93acc309754ed8952cc17149328cecb) > Log Analytics 2. Rellene los campos:\ Detalles del Tenant * **TenantId:** Proporcione el ID del tenant de Entra ID. Encuéntrelo en la página de resumen de Entra ID
Detalles del registro de aplicación de Azure * **ClientId:** RealmJoin interactuará con el espacio de trabajo de LogAnalytics mediante un [Registro de aplicación de Azure](#azure-app-registration). Proporcione el ClientId/AppId y el secreto de la app para que RealmJoin pueda autenticarse.
* **ClientSecret:** Se usa con el ClientId para proporcionar acceso a RealmJoin. Este es el secreto creado en [Parte 1](#part-1-authentication-using-azure-app-registration).
Detalles del espacio de trabajo de Windows Update for Business * **ID del espacio de trabajo de Update Compliance:** Proporcione el [Informes de Windows Update for Business](#windows-update-for-business-reports-integration) ID del Log Analytics Workspace del que se recopilarán los datos. Detalles del espacio de trabajo * **ID de suscripción:** Proporcione el ID de suscripción de la [registros de auditoría de RealmJoin](#realmjoin-audit-logs) cuenta de Log Analytics. El ID de suscripción puede verse en la página de resumen de la suscripción. * **Grupo de recursos**: Proporcione el nombre del grupo de recursos de la [registros de auditoría de RealmJoin](#realmjoin-audit-logs) cuenta de Log Analytics. * **Nombre del espacio de trabajo:** Proporcione el nombre del espacio de trabajo de la [registros de auditoría de RealmJoin](#realmjoin-audit-logs) cuenta de Log Analytics. * **ID del espacio de trabajo del cliente:** Proporcione / cree un espacio de trabajo de Log Analytics para almacenar [datos de registro de auditoría y registros de runbook de RealmJoin](#realmjoin-audit-logs).
* **Clave del espacio de trabajo del cliente:** RealmJoin actuará como un agente de Log Analytics. Proporcione la "Primary Key" de este espacio de trabajo para permitir la escritura de datos en el espacio de trabajo. * La "Primary Key" puede obtenerse mediante distintos métodos: * [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` * [PowerShell](https://learn.microsoft.com/en-us/powershell/module/az.operationalinsights/get-azoperationalinsightsworkspacesharedkey?view=azps-14.6.0):\ `Get-AzOperationalInsightsWorkspaceSharedKey -ResourceGroupName "MyResourceGroup" -Name "MyWorkspace"` * [API REST](https://learn.microsoft.com/en-us/rest/api/loganalytics/shared-keys/get-shared-keys?view=rest-loganalytics-2025-07-01\&tabs=HTTP):\ `POST https://management.azure.com/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}/sharedKeys?api-version=2025-07-01` 3. Pulse **Guardar** después de completar todos los campos. El sistema le dará comentarios 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 dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` 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 optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.