Saltar al contenido principal
Para ofrecer a nuestros clientes la solución más confiable y escalable, Auth0 ha dejado obsoleto el motor de búsqueda de registros del inquilino v2 en favor de la v3. Auth0 migra de forma proactiva a los clientes a quienes no les afecta este cambio, mientras que notifica a quienes podrían verse afectados para que opten por la v3 durante el período de gracia indicado.

​
Funcionalidades afectadas

Se verá afectado si cumple todos los criterios siguientes:
  • Inquilinos creados el 21 de mayo de 2019 o antes
  • Inquilinos alojados en la nube pública de Auth0 en las regiones de AU o EU
  • Usar el endpoint GET /api/v2/logs o el endpoint GET /api/v2/users/{user_id}/logs con el parámetro include_totals=true o el parámetro q.
  • Paginar más de 1000 resultados.
  • Usar la Extensión de administración delegada. Las versiones anteriores de la extensión seguirán funcionando después de que su Tenant se migre a Logs Search Engine v3; sin embargo, es posible que observe que los totales de la paginación sean incorrectos al consultar los logs. La actualización a la versión 3.7 de la extensión soluciona este problema.
Los siguientes inquilinos no se ven afectados:
  • Inquilinos en la nube en la región de EE. UU. La región de EE. UU. ya se ha migrado por completo y ya utiliza Search Engine v3.
  • Inquilinos de Private Cloud (la migración para los clientes de Private Cloud comenzará más adelante).
  • Inquilinos en la nube en las regiones de EU y AU que:
    • No usan en absoluto los endpoints GET /api/v2/logs o GET /api/v2/users/{user_id}/logs de Management API.
    • Consumen los logs únicamente desde la sección Logs del Dashboard.
    • Usan el GET /api/v2/logs endpoint con el método by checkpoint (mediante el parámetro from).
    • Consumen logs mediante cualquiera de las extensiones del Dashboard Auth0 Logs to External Service (que usan el método by checkpoint).

​
Verificar la migración de consultas

Auth0 genera solo un registro del mismo tipo y con la misma descripción cada 60 minutos. No importa cuántas llamadas haga a los endpoints afectados con funcionalidades obsoletas, seguirá viendo un solo registro por cada funcionalidad obsoleta cada hora. Si implementa cambios en sus consultas, tendrá que esperar 60 minutos antes de poder determinar de forma concluyente que la ausencia de nuevos registros depnote significa que el comportamiento obsoleto se ha eliminado de su código. Puede buscar en los registros del inquilino lo siguiente para identificar consultas que provocarían errores después de migrar a v3: type:depnote AND description:*logs* Estas entradas de registro incluyen un campo description que especifica el comportamiento obsoleto que está utilizando. También puede revisar los campos details.request.path y client_name para ver qué aplicación está llamando a GET /api/v2/logs o GET /api/v2/users/{user_id}/logs.

​
Cambios

Los cambios incompatibles son menores, pero debe revisar sus consultas para asegurarse de que los resultados que obtiene sean los esperados. Los cambios incompatibles están relacionados con:
  • Cuando tu inquilino se migre a logs v3, cambiará el valor del campo total que se devuelve en el resultado resumido al llamar a GET /api/v2/logs o GET /api/v2/users/{user_id}/logs. Cuando buscas logs con el motor de búsqueda v2, el campo totals de los resultados indica la cantidad de logs que coinciden con la consulta proporcionada. Sin embargo, en v3, el campo totals indica cuántos logs se devuelven en la página (de forma similar a lo que devuelve el campo length). Para evitar posibles interrupciones, si tu aplicación depende del campo total para la paginación, debes actualizar la lógica para gestionar este cambio adecuadamente.
  • Ya existe un límite de 100 logs por solicitud. Cuando tu inquilino se migre a logs v3, solo podrás paginar hasta un máximo de 1.000 resultados de búsqueda, por lo que las llamadas que superen los 1.000 resultados devolverán un error. Para evitar posibles interrupciones, debes revisar tus consultas para no alcanzar este límite o gestionar los errores según corresponda.

​
validación del parámetro q

  • La sintaxis de consulta al usar el parámetro q en GET /api/v2/logs presenta cambios menores que deben tenerse en cuenta. Cuando su inquilino se migre a logs v3, esta validación se aplicará y esta consulta devolverá un error. Para evitar posibles interrupciones, debe revisar sus consultas para asegurarse de que cumplan con la sintaxis de consulta admitida.
  • El parámetro q incluye un campo no válido. Cuando su inquilino se migre a logs v3, esta validación se aplicará y esta llamada devolverá un error. Para evitar posibles interrupciones, debe revisar sus consultas para asegurarse de que solo incluyan campos en los que se pueda buscar.

​
Habilitar la búsqueda en los registros del inquilino v3

Tras revisar tus consultas, puedes habilitar Tenant Logs Search Engine v3 desde el Dashboard.
  1. Ve a Tenant Settings > Advanced.
  2. Desplázate hacia abajo hasta Migrations.
  3. Desactiva el interruptor Legacy Logs Search V2. Al desactivarlo, se inhabilita el motor de búsqueda de registros v2 obsoleto y se fuerza el uso del motor de búsqueda v3. Si no ves el interruptor Legacy Logs Search V2, ya se te migró a v3. No es necesario realizar ninguna otra acción.
Si necesitas ayuda con la migración, contáctanos mediante el Support Center.

​
Más información