> 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

## Resumen

RealmJoin Portal puede mostrar posibles problemas con las actualizaciones de Windows como [Bloqueos de SafeGuard de Windows Update](https://docs.microsoft.com/en-us/windows/deployment/update/safeguard-holds) al integrarse con [Windows Update for Business Reports](https://learn.microsoft.com/en-us/windows/deployment/update/wufb-reports-overview).

Además, RealmJoin Portal usará Log Analytics para almacenar la información del Audit Log 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 a través de 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 [se ejecutan los runbooks de incorporación](/es/automatizacion/connecting-azure-automation.md).
{% endhint %}

Esta aplicación se autenticará mediante un ClientId y un ClientSecret. El uso de un certificado o de Managed Identity no está compatible actualmente.

Conceda a la aplicación "**Lector de supervisión**" permisos en las cuentas de Log Analytics utilizadas para [integración de Windows Update for Business Reports](#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á la [clave del espacio de trabajo del cliente](#customer-workspace-key) para escribir datos directamente en [los registros de auditoría de RealmJoin](#realmjoin-audit-logs).

### integración de Windows Update for Business Reports

[Windows Update for Business Reports](https://learn.microsoft.com/en-us/windows/deployment/update/wufb-reports-overview) debe configurarse en su entorno para aprovechar esta característica. Escribirá los eventos relacionados con las 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 Azure 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 [Windows Update for Business Reports](https://learn.microsoft.com/en-us/windows/deployment/update/wufb-reports-overview) y [los registros de auditoría de RealmJoin](#realmjoin-audit-logs). Asigne "**Colaborador de supervisión**" permisos en este caso.
{% endhint %}

### los registros de auditoría de RealmJoin

RealmJoin puede usar un espacio de trabajo de Log Analytics para almacenar sus propios registros de auditoría y también archivar los registros de runbook después de la retención máxima 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 Azure App Registration

1. En el Azure Portal, vaya a Microsoft Entra ID > Administrar > Registros de aplicaciones.
2. Seleccione la pestaña Todas las aplicaciones.
3. Elija su siguiente paso.

{% tabs %}
{% tab title="Integración existente de Runbook" %}
Si ya ha [integrado 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 "Client Secrets".
4. Cree un nuevo secreto de cliente.
   * Establezca la descripción y la expiración de acuerdo con 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 "New Registration"

2. Proporcione un nombre<br>

   <figure><img src="/files/8ed13b29839caa4d79f1b227e64082ab1fa57be4" alt=""><figcaption></figcaption></figure>

3. Registre la aplicación

4. Seleccione la aplicación

5. Vaya a Administrar > Certificados y secretos

6. Seleccione la pestaña "Client Secrets"

7. Cree un nuevo secreto de cliente
   * Establezca la descripción y la expiración de acuerdo con sus políticas internas de nomenclatura y seguridad
     {% endtab %}
     {% endtabs %}

8. Anote de forma segura el valor del secreto para usarlo en [Parte 5](#part-4-connecting-realmjoin-and-azure-log-analytics-workspace).

{% hint style="warning" %}
Alejarse de la página de Certificados y secretos hará que Azure ofusque el secreto. El secreto no se podrá recuperar y habrá que crear uno nuevo.
{% endhint %}

### Parte 2 - Creación de un espacio de trabajo de Log Analytics

1. En el Azure Portal, vaya a Log Analytics Workspace
2. Seleccione Crear
3. Proporcione un grupo de recursos, nombre y región según sea necesario
4. Vaya a la pestaña "Overview"
5. Tenga en cuenta 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 Windows Update for Business Reports

1. En el Azure Portal, vaya a Monitor > Workbooks
2. Busque "Windows Update for Business reports"<br>

   <figure><img src="/files/36f78cd9d6c50d7d3fc3a09ee1429314e10ddbb9" alt=""><figcaption></figcaption></figure>
3. Establezca su suscripción y el espacio de trabajo creado previamente. Si se prefiere un espacio de trabajo independiente para los registros de RealmJoin y los informes de Windows Update for Business, cree un espacio de trabajo independiente y vincúlelo en su lugar.\
   ![](/files/b6d8e0b6f6554fdcca4b7178043eaa7caf0ff34b)
4. Guardar configuración

{% hint style="warning" %}
Windows Update for Business reports puede 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. Otorgue a su registro de aplicación permisos de Colaborador de supervisión<br>

   <figure><img src="/files/e337cc9726789d48b91bff4c47c0527b06225c9a" alt=""><figcaption></figcaption></figure>
5. Revise y guarde la asignación de rol

### Parte 5 - Conexión de RealmJoin y Azure Log Analytics Workspace

<figure><img src="/files/cfa72e75a2d1ba7e9c443a57007a57ec5094e3b6" alt=""><figcaption><p>Página de configuración de Log Analytics</p></figcaption></figure>

1. En el RealmJoin Portal, vaya a Configuración ![](/files/36207668f93acc309754ed8952cc17149328cecb) > Log Analytics
2. Rellene los campos:\
   Detalles del Tenant

   * **TenantId:** Proporcione el ID de tenant de su Entra ID. Encuéntrelo en la página de información general de Entra ID<br>

     <figure><img src="/files/8f4d820cad9fda42ee0a3a133ccc3489450c2d75" alt=""><figcaption></figcaption></figure>

   Detalles del registro de aplicación de Azure

   * **ClientId:** RealmJoin interactuará con el espacio de trabajo de Log Analytics mediante un [Registro de aplicación de Azure](#azure-app-registration). Proporcione el ClientId/AppId y el secreto de la aplicación para que RealmJoin pueda autenticarse.<br>

     <figure><img src="/files/23d24336f661ca8b875d094b2e6da098c604bc4f" alt=""><figcaption></figcaption></figure>
   * **ClientSecret:** Se usa junto con el ClientId para proporcionar acceso a RealmJoin. Este es el secreto creado en [Parte 1](#part-1-authentication-using-azure-app-registration).<br>

     <figure><img src="/files/630d211f74c3d1eac14983d8f71652597bc41456" alt=""><figcaption></figcaption></figure>

   Detalles del espacio de trabajo de Windows Update for Business

   * **ID del espacio de trabajo de Update Compliance:** Proporcione el [Windows Update for Business Reports](#windows-update-for-business-reports-integration) ID del Log Analytics Workspace del que recopilar datos.

   Detalles del espacio de trabajo

   * **ID de suscripción:** Proporcione el ID de suscripción de la [los registros de auditoría de RealmJoin](#realmjoin-audit-logs) cuenta de Log Analytics. El ID de suscripción se puede ver en la página de información general de la suscripción.
   * **Grupo de recursos**: Proporcione el nombre del grupo de recursos de la [los 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 [los 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 [los datos de los registros de auditoría de RealmJoin y de los registros de runbook](#realmjoin-audit-logs).<br>

     <figure><img src="/files/f6a1027464d9e0fac805575d19cf4788d911a639" alt=""><figcaption></figcaption></figure>
   * **Clave del espacio de trabajo del cliente:** RealmJoin actuará como un agente para 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" se puede obtener 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á confirmació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 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=<question>&goal=<endgoal>
```

`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.
