ConnXL Docs

Operar

Registros y exportaciones

Cada llamada de función que ejecuta un agent se reporta de vuelta como un evento de uso — nunca los datos, solo los metadatos. El panel agrupa esos eventos en analíticas que puedes leer en pantalla o descargar como una hoja de cálculo. Esta página también cubre el visor de registros del proceso del agent, aparte, para diagnosticar una función rota.

7 min de lectura

Dos cosas distintas comparten el nombre "Registros"

Las analíticas de uso (abajo) son la página Telemetry/Logs: recuentos de llamadas agregados, latencia y usuarios principales en una ventana móvil — para entender cómo se usa tu complemento. Los registros del proceso del agent, más abajo en esta página, son otra cosa distinta: una cola en vivo de la propia salida de debug/info/error del agent — para diagnosticar por qué acaba de fallar una llamada de función. Si estás persiguiendo una función rota ahora mismo, ve directamente a esa sección.

Qué muestran las analíticas

Las páginas de Telemetry y Logs cubren una ventana móvil (30 días por defecto, ajustable):

  • Uso diario — llamadas y errores por día, y el volumen de datos movido, para que puedas ver los periodos de mucha actividad de un vistazo.
  • Top de funciones — las funciones más llamadas, ordenadas por número de ejecuciones, con recuento de errores.
  • Funciones más lentas — ordenadas por latencia, para señalarte qué optimizar.
  • Top de usuarios — los usuarios finales más activos, mostrados como domain · hash (por ejemplo acme.com · 7a3f…).

Los correos en crudo nunca llegan al panel

La identidad de un usuario se reduce a su dominio de correo más un hash SHA-256 de un solo sentido antes de salir del agent. Puedes distinguir a dos usuarios y ver su dominio, pero el panel nunca guarda ni muestra una dirección en crudo.

Exportar

Hay dos formas de sacar los datos del panel.

  • Exportación rápida .xlsx — descarga la ventana de analíticas actual como un libro con tres hojas: Uso diario, Top de funciones y Top de usuarios. Se genera al instante.
  • Exportación de registros async — para una extracción más grande, solicita una exportación y el backend la construye en segundo plano. Aparece en la lista de exportaciones cuando está lista, y descargas el .xlsx terminado desde ahí.

Las analíticas son por complemento

Lo que ves está filtrado a los complementos de tu organización y a la ventana que elijas, así que una exportación es una instantánea fiel de exactamente lo que hay en pantalla.

Registros del proceso del agent

Este es el otro "Registros" — un panel de diagnóstico en vivo en la página Agent del entorno, no las analíticas de arriba. Mientras las analíticas de uso te dicen cuánto se usa tu complemento, este te dice qué estaba haciendo el propio agent, línea a línea, justo antes de que algo se rompiera.

  • Se trae bajo demanda, no es un historial persistido. Al hacer clic en el panel se envía al agent un comando get_logs por su canal de control, y el agent responde con hasta 500 de sus líneas más recientes, guardadas en un buffer circular en memoria — es una cola de ahora mismo, no un archivo consultable que se remonte semanas atrás.
  • Filtros por nivel — chips de debug / info / error acotan las líneas ya traídas, en el cliente.
  • Depurado antes de que salga siquiera del agent. Los valores sensibles (secretos, cadenas de conexión, tokens) se eliminan dentro del propio agent al entrar las líneas al buffer circular — el panel solo muestra texto ya depurado, nunca redacta nada al recibirlo.
  • Qué réplica respondió — si el entorno ejecuta varias réplicas, responde una cualquiera en vivo y una nota al pie indica su hostname, así sabes de qué proceso son los registros que estás viendo.
  • Requiere que el agent del entorno esté en línea (la misma condición que enviar cualquier otro comando), y está limitado a admins como el resto de los controles de runtime.

Úsalo cuando una función concreta acaba de fallar

Las analíticas de uso te dicen que una función está fallando; los registros del proceso del agent te dicen por qué — la excepción real o el error de conexión con el que se topó el agent al ejecutarla. Consulta Solución de problemas para el resto de la guía de "cómo arreglo X".

En esta página