Instalación y uso de Antescope
Esta guía está dirigida al administrador de un sitio Moodle que quiere instalar Antescope, registrarlo contra Antescope Cloud y empezar a ver sus analíticas, sin ayuda del equipo de Antescope. No asume conocimiento previo de Antescope.
Nota sobre esta guía: fue redactada a partir del código real de los plugins y del servicio en cloud (versión interna
0.4.40,$plugin->version = 2026111500), y de una prueba de instalación completa, de cero, en un Moodle nuevo. Cuando algo no se pudo verificar en el código, se dice explícitamente en el texto en lugar de describir un comportamiento ideal.
En esta guía
1. Qué es Antescope
Antescope son dos plugins de Moodle que trabajan juntos:
logstore_antescope(un almacén de registros / "logstore"): captura los eventos del sitio (inicios de sesión, vistas de curso, matriculaciones, etc.), los anonimiza y los preagrega localmente, y los envía por HTTPS a Antescope Cloud.local_antescope(el "Dashboard"): se instala dentro de Moodle y muestra los resultados — KPIs de matriculación, accesos, docencia, rendimiento y compromiso — consultando esos resultados ya calculados en Antescope Cloud.
Ningún dato personal identificable sale del Moodle a través del canal de eventos: los eventos se envían con un identificador anónimo de usuario. La única excepción, importante y deliberada, es el email de contacto del administrador, que se envía una sola vez en el paso de registro (sección 4).
2. Requisitos previos
Verificados contra version.php de ambos plugins:
- Moodle 4.1 o superior (
$plugin->requires = 2022112800). Ambos plugins declaran el mismo requisito. - PHP: el propio requisito mínimo de Moodle 4.1 (el
version.phpde los plugins no agrega una cota de PHP adicional). En la prueba de instalación limpia se verificó funcionamiento sin errores ni advertencias sobre Moodle 5.0.1 + PHP 8.2 — es la combinación más moderna probada hasta ahora, pero no se probó el límite inferior exacto de PHP que soporta el código de los plugins en sí. - Acceso saliente HTTPS desde el servidor de Moodle hacia
api.antescope.com(o la URL de Antescope Cloud que se configure). El plugin se comunica por cURL desde el propio servidor web, no desde el navegador del administrador — si el servidor está detrás de un proxy o firewall que bloquea salidas HTTPS, ningún paso de los que siguen va a funcionar, y el síntoma típico es un error de conexión al intentar registrar el sitio (ver sección 7). - El cron de Moodle tiene que estar funcionando. Esto es imprescindible
y merece decirse con todas las letras: sin cron, Antescope no envía ni recibe
ningún dato, y el síntoma no es un error visible sino un dashboard vacío
sin ningún mensaje de alerta aparente. Todo el mecanismo de Antescope — la
activación del logstore, el envío periódico de eventos, la importación de historial,
las alertas por email — corre a través de tareas programadas de Moodle
(
admin/cli/cron.phpo el cron del sistema operativo que lo invoque). Si el administrador nunca configuró el cron de su Moodle (algo relativamente común en instalaciones pequeñas o de prueba), Antescope queda instalado pero completamente inerte. Para comprobarlo: Administración del sitio → Servidor → Tareas programadas, revisar quelogstore_antescope\task\sync_to_cloudtenga una "Próxima ejecución" en el futuro cercano, no muy en el pasado.
3. Instalación de los dos plugins (en orden correcto)
Los dos plugins se instalan por la interfaz web de Moodle, subiendo cada ZIP por separado (es el camino verificado y recomendado; ver nota sobre instalación por SSH al final de esta sección).
Paso 1 — instalar logstore_antescope primero
- Entra a Administración del sitio → Plugins → Instalar plugins (o
directamente a
admin/tool/installaddon/index.php). - Sube el archivo
logstore_antescope.zip. - Sigue el asistente de instalación/actualización de Moodle hasta el final ("Actualizar base de datos de Moodle ahora").
- El logstore de Antescope se habilita automáticamente al instalar — no hace falta ir a "Administrar almacenes de registro" para activarlo a mano.
- Inmediatamente después de instalar, en la pantalla de notificaciones del administrador
aparece un bloque "Completar configuración de Antescope" con un botón
que lleva directo al asistente de registro (sección 4). Si no genera ese bloque, se puede
llegar al mismo asistente entrando a
admin/tool/log/store/antescope/setup.php.
Paso 2 — instalar local_antescope (el Dashboard)
Repite el mismo procedimiento con local_antescope.zip.
Qué pasa si se instala en el orden incorrecto (local_antescope
antes de logstore_antescope, o sin tener logstore_antescope
instalado): Moodle rechaza la instalación y muestra un bloque "Dependencias ausentes
no disponibles" que nombra explícitamente el componente que falta
(logstore_antescope), con un botón que lleva directo al instalador de plugins
para subirlo.
Limitación conocida, no corregida: si en cambio se instala por línea de comandos (
admin/cli/upgrade.php --non-interactive), el mismo error se reduce a un mensaje genérico de dos líneas ("Falló la revisión de dependencias para local_antescope") que no dice qué plugin falta. Si tu instalación es por SSH/CLI y ves ese error, la causa casi siempre es que falta instalarlogstore_antescopeprimero.
Una vez instalados ambos en el orden correcto, los dos quedan con el mismo número de
versión interno ($plugin->version) — es la "dependencia en lockstep" del
proyecto: local_antescope no se instala si no encuentra exactamente esa
versión (o una posterior) de logstore_antescope.
Nota sobre instalación manual por SSH (no recomendada): si en lugar de la interfaz web alguien descomprime los ZIP a mano en el servidor, Moodle resuelve el destino final a partir del
$plugin->componentdeclarado en cadaversion.php, no del nombre de la carpeta — pero eso solo aplica cuando se usa el instalador real de Moodle. Esta guía asume el camino de la interfaz web, que es el soportado.
4. Registro del sitio contra Antescope Cloud
Después de instalar ambos plugins (o incluso solo el primero), el asistente de bienvenida
(setup.php) pide un solo dato: el email de contacto del
administrador — el nombre del sitio se toma automáticamente del nombre completo
configurado en Moodle y no es editable desde este asistente. El campo de email viene
prellenado con el email de soporte del sitio o, si no está configurado, con el email del
usuario que está haciendo la instalación.
Al hacer clic en el botón de registro ("Completar configuración de Antescope"), el plugin
envía una sola petición HTTPS a POST /api/v1/register con el nombre del sitio,
la URL del sitio y el email de contacto del administrador.
Sé explícito con quien evalúe esto desde el punto de vista de privacidad: el email del administrador sí se transmite a Antescope Cloud en este paso. Esto es intencional (sirve para que Antescope pueda contactar al responsable del sitio y para emitir la clave de API) y está documentado así en el proveedor de privacidad del plugin.
Si el registro tiene éxito, Antescope Cloud devuelve una clave de API y un
ID de sitio, que el plugin guarda automáticamente en
Administración del sitio → Plugins → Almacenes de registro → Antescope Cloud
Logstore (admin/settings.php?section=logsettingantescope). Desde esa
misma pantalla se puede cambiar la URL de la API cloud, pegar una clave de API manualmente,
configurar un email de alertas y configurar cuántos lotes de importación histórica correr
por cada ciclo de cron.
5. Qué esperar después de instalar
- El logstore empieza a capturar y agregar eventos localmente de inmediato, en cuanto queda instalado. Esto no depende del cron.
- La importación histórica se encola automáticamente al instalar — no hace falta iniciar nada a mano, aunque sí depende del cron para ejecutarse.
- El primer dato tarda en aparecer, y el tiempo varía. La tarea
programada normal de sincronización (
sync_to_cloud) corre cada 30 minutos, y tras una instalación nueva su primera ejecución no es inmediata. Antes de pensar que algo está roto, esperar un ciclo completo de cron (hasta 30 minutos) es lo esperable. - Mientras no hay datos todavía, el dashboard lo dice de forma tranquila, no alarmante, con un estado vacío informativo en vez de un error.
6. Importación histórica
Si el sitio Moodle ya tenía actividad antes de instalar Antescope, esa
actividad vive en la tabla de registros estándar de Moodle
(logstore_standard_log) y Antescope no la tiene todavía. Para eso existe la
importación histórica, que recorre los registros existentes, los agrega y
los sincroniza al cloud.
- Se dispara automáticamente al instalar el plugin, sin que el administrador tenga que iniciar nada.
- Se sigue desde
local/antescope/progress.php("Progreso de ingesta de datos"), con estado, barra de progreso, registros totales/procesados/pendientes y botones para pausar, reanudar o reiniciar. - Puede tardar mucho en un sitio con años de historial. La velocidad
depende de
batches_per_run(por defecto 1 lote por ciclo de cron).
7. Diagnóstico de problemas previsibles
El dashboard aparece vacío
Es, por lejos, el caso más frecuente, y casi siempre se debe a una de estas dos causas:
- El cron no está corriendo (ver sección 2).
- El período seleccionado no tiene datos, aunque el sitio sí los tenga — especialmente si la actividad del sitio es de hace meses, el período por defecto de 30 días devuelve casi nada. El dashboard detecta este caso y muestra un aviso con el rango de fechas que sí tiene datos.
La sincronización no avanza
Si el logstore está activo y el cron corre, pero no hay sincronización: revisa que la
clave de API esté configurada y no vacía, comprueba la conectividad saliente HTTPS, y
revisa el registro de ejecuciones de la tarea sync_to_cloud.
La clave de API es rechazada
El formulario de ajustes valida la clave contra el cloud al guardar y devuelve un mensaje específico según si la clave no existe, hay un problema de red, o el servicio respondió con un error inesperado.
El sitio no alcanza la API
Tanto el registro inicial como la sincronización periódica dependen de que el servidor de Moodle pueda abrir conexiones HTTPS salientes hacia la URL configurada. Si hay un proxy corporativo o firewall de salida que lo bloquea, tanto el registro como cada sincronización posterior van a fallar con errores de conexión.
8. Planes y qué incluye cada uno
Un sitio recién registrado queda en el plan free por defecto.
- free: solo el módulo 1 — Matriculación y Retención. El resto de los módulos se muestran bloqueados, sin alertas por email ni exportación.
- cloud: habilita los cinco módulos completos, además de alertas por email y exportación CSV/PDF.
La Auditoría de seguridad es un entitlement aparte, independiente del plan. El cambio de plan y la activación de la Auditoría no son autoservicio: hay que solicitarlo directamente al equipo de Antescope.
9. Privacidad
Qué se envía a Antescope Cloud:
- Eventos agregados y anonimizados: identificador anónimo de usuario, curso, categoría, nombre del evento, bucket de fecha/hora y conteo. Ningún nombre, email ni otro dato identificable viaja en este canal.
- Datos de registro del sitio (una sola vez, al registrar): nombre del sitio, URL del sitio y el email de contacto del administrador. Es el único punto del flujo donde se transmite un dato directamente identificable.
- Metadatos de plataforma (periódicos, para la Auditoría): versión y release de Moodle, nombre/URL del sitio, conteos totales de usuarios, cursos y matriculaciones, lista de plugins instalados, tipo de base de datos y versión de PHP. Sin datos de usuarios individuales.
Qué nunca sale del Moodle: la tabla local que vincula cada identificador anónimo con el usuario real de Moodle. Esa vinculación se resuelve únicamente en el servidor de Moodle y nunca se transmite.
Retención de datos (sección pendiente de cerrar): Antescope Cloud tiene un mecanismo de expiración de datos, con un período de retención configurable por sitio. La política de retención concreta que se va a comunicar a los clientes está siendo definida por el equipo de Antescope al momento de escribir esta guía, así que esta sección queda abierta deliberadamente.
10. Lo que no se pudo verificar para esta guía
- El límite inferior real de versión de PHP que soportan los plugins.
- El tiempo total que puede tomar una importación histórica en un sitio grande.
- El número final de meses de retención de datos que se va a comunicar a los clientes.
- El flujo completo bajo el plan cloud pagado en una instalación nueva de punta a punta.
- El flujo de alertas por email (tarea
send_alerts, que corre los lunes a las 8 AM) no se ejecutó durante la verificación de esta guía.