> 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-ingestion-api-migration.md).

# Migrando a la API de ingesta de registros

Microsoft está retirando la API de Log Analytics HTTP Data Collector. Migra RealmJoin a la API de ingesta de registros basada en DCR con el módulo de PowerShell de RealmJoin.

## Resumen

RealmJoin escribe sus registros de auditoría, operativos y de runbook en tu propio Log Analytics Workspace. Hasta ahora lo hacía a través de Azure Monitor **API HTTP Data Collector**, que se autentica con la clave compartida del workspace.

Microsoft deja de dar soporte a esa API el **14 de septiembre de 2026**. Su sucesora es la **API de ingesta de registros** (llamada *API de ingesta de registros* en el Portal de RealmJoin), que se basa 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 en lugar de una clave compartida. RealmJoin la admite, y el cambio se realiza con el [módulo PowerShell de RealmJoin](https://docs.realmjoin.com/es/despliegue/onboarding-realmjoin-portal/advanced-setup.md).

{% hint style="info" %}
Esta página solo se aplica si [Log Analytics](https://docs.realmjoin.com/es/supervision-y-registros/log-analytics.md) ya está configurado para tu tenant. Si no lo está, no hay nada que migrar — la misma página de configuración ofrece un comando que configura de inmediato un workspace en la API de ingesta de registros. Aun así, recomendamos configurarlo, para que tus registros de auditoría, operativos y de runbook se almacenen en tu propio tenant.
{% endhint %}

### ¿Se romperá algo en la fecha de retirada?

Lo más probable es que no pase nada. La documentación actual de Microsoft describe una *deprecación* suave: los puntos de conexión antiguos ya no tendrán soporte a partir de esa fecha, pero no dejarán de aceptar datos, y la ingesta seguirá funcionando mientras los clientes usen TLS 1.2 o una versión posterior. La formulación más estricta del anuncio original de 2023 —que los puntos de conexión simplemente dejarían de estar disponibles— está desfasada.

No obstante, se recomienda migrar: la ruta antigua no tiene soporte, depende de una clave compartida y no recibe más correcciones.

### Qué cambia

{% columns %}
{% column %}

#### Antes — Data Collector API

* Autenticación con el workspace **clave compartida** ("Customer Workspace Key")
* Una **registro de aplicación de Entra ID propiedad del cliente** con un secreto de cliente
* Tablas `AuditLogs_CL`, `OperationalLogs_CL`, `RunbookLogs_CL`
* Configurado manualmente en el Portal
  {% endcolumn %}

{% column %}

#### Después — Log Ingestion API

* Autenticación con **Microsoft Entra ID**, sin clave compartida
* Los **RealmJoin Azure Resources** Service Principal, con ámbito en el workspace y sus reglas
* Tablas `RJAuditLogs_CL`, `RJOperationalLogs_CL`, `RJRunbookLogs_CL`
* Implementado y mantenido por el módulo PowerShell de RealmJoin
  {% endcolumn %}
  {% endcolumns %}

La migración reutiliza tu **workspace existente** , así que tus registros existentes permanecen donde están. RealmJoin consulta las tablas antigua y nueva en paralelo, lo que significa que los datos históricos siguen visibles en el Portal después de la migración.

### Qué implementa la migración

Ejecutar el comando de migración en tu suscripción crea:

* Los **RealmJoin Azure Resources** Service Principal en tu tenant de Entra ID (si aún no existe)
* Tres tablas personalizadas en tu workspace existente: `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. 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 migración, incluido un token de incorporación de corta duración.

### En la máquina que ejecuta PowerShell

* **PowerShell 7** o posterior
* 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 del workspace **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="info" %}
El grupo de recursos y el workspace de Log Analytics ya existen en tu caso — la migración no los crea. Los comandos del Portal vienen precompletados con tu suscripción actual, el grupo de recursos y el nombre del workspace.
{% endhint %}

## Dónde ejecutar los comandos

Ejecuta los comandos en una **sesión local de PowerShell** en una estación de trabajo administrativa — del mismo modo en que ejecutarías el script de incorporación de RealmJoin.

{% hint style="warning" %}
Usa una **recién abierta** sesión de PowerShell y evita **Azure Cloud Shell**. El módulo RealmJoin requiere versiones exactas de los `módulos Az.*` Si ya hay cargada en la sesión una versión diferente de un `módulo Az` , lo cual suele ocurrir en Cloud Shell, el módulo no puede recuperarse y se detiene con un mensaje de conflicto de versiones. Cerrar la sesión y abrir una nueva lo resuelve.
{% endhint %}

No se requiere una sesión elevada ("Ejecutar como administrador"): los módulos se instalan con `-Scope CurrentUser`.

## Migración

{% stepper %}
{% step %}

#### Abre la configuración de Log Analytics en el Portal

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

Mientras tu tenant siga en la API Data Collector, la página muestra el aviso **"Migrar a la API de ingesta de registros (Recomendado)"** junto con un bloque de comandos listo para copiar. Usa el **botón Copiar** para copiarlo.
{% endstep %}

{% step %}

#### Comprueba el comando copiado

El comando tiene este aspecto, con tus propios valores rellenados:

```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 -ResourceGroupName "<ResourceGroupName>" -WorkspaceName "<WorkspaceName>" -SubscriptionId "<SubscriptionId>" -Token "<Token>" 6>&1
```

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

{% hint style="warning" %}
Asegúrate de que `-ResourceGroupName`, `-WorkspaceName` y `-SubscriptionId` están presentes y apuntan a tu **workspace existente** workspace. Si `-WorkspaceName` falta, el módulo crea un **nuevo** workspace en lugar de migrar el existente, y tus registros antiguos y nuevos terminan en lugares distintos. Agrega manualmente el parámetro que falte si es necesario.
{% endhint %}

{% 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 %}

#### 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, 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` a `Set-RJLogAnalyticsWorkspace` 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 configuración de la API de ingesta de registros — suscripción, grupo de recursos, nombre del workspace, ID del workspace del cliente e ID del tenant — como campos de solo lectura, ya que estas configuraciones pasan a ser mantenidas por el módulo PowerShell a partir de ahora. En **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.
{% endstep %}

{% step %}

#### Confirmar que llegan los registros

Abre [Audit Log](https://docs.realmjoin.com/es/supervision-y-registros/audit-log.md), el [Runbook Logs](https://docs.realmjoin.com/es/automatizacion/runbooks/runbook-logs.md) o los registros operativos y confirma que aparecen nuevas entradas. Las entradas existentes de antes de la migración también siguen visibles.

{% hint style="info" %}
Azure necesita unos minutos para poner a disposición una tabla personalizada recién creada y su regla. Si no llega nada de inmediato, espera un poco y actualiza.
{% endhint %}
{% endstep %}
{% endstepper %}

## Después de la migración

### Conserva por ahora el registro de aplicación antiguo

Las entradas históricas de `AuditLogs_CL`, `OperationalLogs_CL` y `RunbookLogs_CL` siguen leyéndose con tu **registro de aplicación y secreto de cliente existentes**. El Portal consulta las tablas antigua y nueva en paralelo.

{% hint style="warning" %}
No elimines el registro de aplicación y sigue renovando su secreto de cliente mientras todavía quieras ver los datos de registro anteriores a la migración. Solo la **clave compartida del workspace** ya no es necesaria para RealmJoin — ya no se usa para escribir.
{% endhint %}

Una vez que los datos antiguos hayan caducado de la [retención del workspace](https://learn.microsoft.com/en-us/azure/azure-monitor/logs/data-retention-archive?tabs=portal-1%2Cportal-2), puedes eliminar el registro de aplicación.

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

## Solución de problemas

<details>

<summary>"El módulo RealmJoin está desactualizado - la ejecución no puede continuar"</summary>

Cada cmdlet verifica una vez por sesión que estás ejecutando la versión publicada más reciente del módulo. Instala la versión actual, luego cierra la sesión y abre una nueva:

```powershell
Install-Module -Name RealmJoin -Force -Scope CurrentUser
```

</details>

<details>

<summary>Se informa de un conflicto de versiones de un módulo</summary>

Un `módulos Az.*` módulo en una versión distinta de aquella que fija el módulo RealmJoin ya está cargado en la sesión. Esto no se puede solucionar dentro de la sesión en curso — cierra PowerShell, abre una nueva sesión y vuelve a ejecutar el comando. Esta es también la razón para no usar Azure Cloud Shell.

</details>

<details>

<summary>"Necesita aprobación del administrador" o un error de consentimiento durante el inicio de sesión</summary>

El inicio de sesión usa la **Azure PowerShell** aplicación de primera parte. Si tu tenant restringe el consentimiento del usuario, un administrador tendrá que conceder una vez el consentimiento de administrador a esa aplicación.

</details>

<details>

<summary>La implementación falla al crear asignaciones de roles</summary>

Crear las *Log Analytics Reader* y *Monitoring Metrics Publisher* asignaciones requiere un rol que pueda administrar el acceso — por ejemplo *Owner*, *User Access Administrator* o *Role Based Access Control Administrator* en el grupo de recursos o la suscripción. *Contributor* por sí solo no es suficiente.

Las asignaciones de roles que ya existen se detectan y se omiten, así que volver a ejecutar el comando después de corregir los permisos es seguro.

</details>

<details>

<summary>La implementación falla con un error sobre la región del workspace</summary>

La implementación se dirige a la región del grupo de recursos. Si tu workspace existente está en una región distinta de la de su grupo de recursos, Azure rechaza el cambio, porque la ubicación de un workspace existente no se puede modificar. En ese caso, ponte en contacto con el soporte de RealmJoin.

</details>

<details>

<summary>El token ya no se acepta</summary>

El token de incorporación del comando generado tiene corta duración (aproximadamente una hora). Vuelve a cargar **Configuración → Log Analytics** en el Portal, copia el comando de nuevo y ejecútalo otra vez. La propia implementación de Azure es idempotente, así que una segunda ejecución no hace daño.

</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-ingestion-api-migration.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.
