La función Actions Real-time Logs muestra en tiempo real todos los registros del código personalizado de su cuenta. Esto incluye toda la salida de console.log y las excepciones. Estos registros resultan útiles para depurar sus Actions, scripts de base de datos personalizados y conexiones sociales personalizadas.
Al usar Actions Real-time Logs, tenga cuidado al registrar información confidencial. Por ejemplo, los parámetros que las funciones reciben como entrada para Actions, scripts de base de datos personalizados o conexiones sociales personalizadas pueden contener información confidencial explícita o implícita. Registrar objetos completos puede provocar la divulgación de información confidencial en los registros en tiempo real.Auth0 desaconseja enfáticamente estas prácticas. Le sugerimos que tenga claro qué objetos registra y que se asegure de no registrar información confidencial, además de evitar registrar explícitamente cualquier tipo de información confidencial.
Para ver los registros en tiempo real de tu código personalizado:
- Ve a Auth0 Dashboard > Monitoring > Actions Logs.
- Espera a que se conecte el flujo de registros. Los intentos de conexión se realizan automáticamente.
- Una vez establecida la conexión, las entradas de registro aparecen en el panel principal a medida que se generan.
El panel de Actions Real-time logs le permite supervisar la actividad del sistema a medida que sucede. Esto proporciona visibilidad en tiempo real sobre las Actions ejecutadas a través del Dashboard, lo que facilita identificar problemas, confirmar operaciones correctas o simplemente observar el comportamiento del sistema en tiempo real. Consulte a continuación una lista detallada de las funcionalidades disponibles actualmente en esta característica.
Transmisión de registros en tiempo real
Las entradas de registro se transmiten en tiempo real a medida que las genera Actions. Cada vez que se ejecuta una Action, la entrada de registro correspondiente aparece automáticamente en el panel de registros, sin necesidad de actualizar la página.
La parte superior del panel muestra el estado actual de la conexión entre su navegador y el flujo de registros. Esto le ayuda a confirmar si se están recibiendo registros de forma activa. Entre los estados habituales se incluyen:
| Estado | Descripción |
|---|
| Conectando con el flujo de registros… | Intentando establecer una conexión. |
| CONECTADO | Conectado correctamente y recibiendo registros. |
| DESCONECTADO | En este momento no está conectado al flujo. |
Funcionalidad de búsqueda
Use la barra de búsqueda en la parte superior del panel para filtrar las entradas del registro. Puede buscar por:
- Palabras clave o frases
- Códigos de error específicos
- Mensajes de registro exactos
Esto resulta especialmente útil al examinar grandes volúmenes de registros para encontrar una Action o un problema específicos.
Haz clic en el menú de Opciones de la esquina superior derecha del panel de registros para acceder a controles adicionales.
- Hora local: Alterna la visualización de las marcas temporales de las entradas de registro entre la hora predeterminada del servidor (a menudo UTC) y la hora local del navegador del usuario.
- Descargar: Te permite descargar los registros que se muestran actualmente como un archivo JSON para analizarlos sin conexión, compartirlos o archivarlos.
- Borrar registros: Borra todas las entradas de registro visibles actualmente en la ventana. Esto no elimina los registros del almacenamiento del sistema, solo de tu vista actual.
Cuando llegan entradas nuevas y quedan fuera de la vista, aparece un botón Ir al final en el panel de registros. Al hacer clic en él, saltará a la entrada de registro más reciente, lo que le permite mantenerse siempre al día con la actividad más reciente.
El siguiente ejemplo muestra cómo crear una Action genérica de Hello World, ejecutarla y usar Actions Real-time Logs para ver los resultados.
-
Siga las instrucciones de Escriba su primera Action para escribir una Action de Post Login con el siguiente ejemplo de código:
/**
* Controlador que se llamará durante la ejecución de un flujo PostLogin.
*
* @param {Event} event - Detalles sobre el usuario y el contexto en el que inicia sesión.
* @param {PostLoginAPI} api - Interfaz cuyos métodos pueden usarse para cambiar el comportamiento del inicio de sesión.
*/
exports.onExecutePostLogin = async (event, api) => {
console.log('Hello World!');
};
/**
* Controlador que se invocará cuando esta Action se reanude después de una redirección externa. Si la función
* onExecutePostLogin no realiza una redirección, esta función puede ignorarse sin problema.
*
* @param {Event} event - Detalles sobre el usuario y el contexto en el que inicia sesión.
* @param {PostLoginAPI} api - Interfaz cuyos métodos pueden usarse para cambiar el comportamiento del inicio de sesión.
*/
// exports.onContinuePostLogin = async (event, api) => {
// };
-
Abra una nueva pestaña y vaya a Auth0 Dashboard > Monitoring > Actions Logs
-
Cuando el flujo de registros esté conectado, vuelva al editor de Actions y ejecute una prueba.
-
Los resultados deberían aparecer en tiempo real en Actions Real-time Logs.
La siguiente tabla muestra las sentencias de consola de JavaScript compatibles con la función de registros en tiempo real:
| Sentencia | Descripción | Caso de uso |
|---|
console.log() | Registro de información de uso general. | Mensajes informativos básicos, valores de variables. |
console.info() | Mensajes informativos que destacan el progreso o el estado de la aplicación. | Informar sobre operaciones correctas, hitos de la aplicación. |
console.warn() | Indica posibles problemas o situaciones inesperadas que no son errores críticos. | Señalar problemas no críticos, funciones obsoletas. |
console.error() | Informa sobre errores que se han producido en la aplicación. | Indicar fallos, excepciones y problemas críticos. |
console.trace() | Muestra un seguimiento de pila con la secuencia de llamadas a funciones que conduce al punto actual. | Depurar flujos de llamadas complejos, comprender el origen de los problemas. |
Si tiene problemas de conectividad con Actions Real-time Logs, visite la sección de solución de problemas.