Conectar fuentes de logs

Envía los logs de tu servidor y de tu CDN al seguimiento de rastreadores de IA.

El fragmento de seguimiento informa de lo que corre en un navegador o en tu servidor, pero muchos bots de IA descargan páginas sin llegar a ejecutar JavaScript. Las fuentes de logs cierran ese hueco: conecta los logs de tu CDN o de tu servidor y cada petición relevante para IA se contabiliza, con su propia etiqueta de origen para que puedas distinguir las visitas provenientes de logs de las que vienen del fragmento.

Solo se almacenan las peticiones relevantes para IA. Se conservan los rastreadores de IA conocidos, los agentes de tipo bot y las visitas referidas por asistentes de IA; el resto del tráfico se descarta al llegar y nunca se escribe en ninguna parte. Los niveles de verificación se aplican a las visitas provenientes de logs exactamente igual que a las del fragmento.

Todas las fuentes de logs se autentican con una clave de ingesta de logs, distinta de las claves de tu fragmento de seguimiento y que solo puede enviar logs. Encontrarás todo lo que sigue en Rastreadores de IA, luego Instalar, en el panel Fuentes de logs.

Cloudflare (un clic)

La vía más rápida para sitios detrás del proxy de Cloudflare. Crea un token de API con exactamente tres permisos: Workers Scripts Edit, Zone Read y Workers Routes Edit. Pega el token y tu dominio, y Citlyze despliega un pequeño Worker en tu zona y lo conecta a la ruta de tu dominio.

El Worker es estrictamente de paso: nunca lee ni modifica los cuerpos de las peticiones ni de las respuestas, y ante cualquier error interno deja pasar el tráfico, así que tu sitio nunca se ve afectado. Informa de los metadatos de la petición (ruta, estado, user agent, IP, referente, país) después de que la respuesta se haya servido. El token se usa una sola vez para la configuración y nunca se almacena.

Dos notas:

La ruta solo se activa en registros DNS con proxy (nube naranja).
En el plan gratuito de Workers, las peticiones comparten una cuota diaria. La opción de prefiltro hace que el Worker informe solo de los user agents de IA, lo que ahorra cuota pero implica que los rastreadores registrados después se pierden hasta que redespliegues el Worker.

¿Prefieres no pegar un token? Elige la opción manual y Citlyze genera el mismo código del Worker para que lo pegues tú mismo en el panel de Cloudflare.

Para zonas con muchísimo tráfico, Cloudflare Logpush encaja mejor: crea un destino HTTP que apunte a tu URL de ingesta con la clave como parámetro key= de la URL, y Citlyze filtra los lotes enviados de la misma manera.

Vercel (log drain)

Pega un token de Vercel y Citlyze crea un log drain que transmite los logs de peticiones automáticamente. Limítalo a un proyecto o deja el proyecto vacío para cubrir todo el equipo. El token se guarda cifrado con un único propósito: eliminar el drain cuando te desconectes. La ingesta en sí se autentica con la clave de ingesta de logs incrustada en la URL del drain.

Webhook genérico

Cualquier sistema que pueda hacer POST de JSON puede enviar logs. Manda lotes de hasta 500 entradas al endpoint de ingesta con tu clave de ingesta de logs en la cabecera X-API-Key. Cada entrada lleva marca de tiempo, método, URL, estado y user agent, más IP del cliente, referente y país opcionales. El contrato completo está en la referencia de la API de ingesta de logs.

Subida de archivos

Para una carga histórica puntual, pega un fragmento de tus logs de acceso directamente en la pestaña Subida. Se admiten dos formatos: CSV con fila de cabeceras (las cabeceras habituales de las exportaciones de CDN se reconocen automáticamente) y el formato de log combinado de Apache/Nginx. Las entradas de más de 30 días se omiten, y el resumen te dice cuántas líneas se analizaron, se almacenaron y se descartaron.

Otras CDN

Los usuarios de CloudFront y Akamai pueden llegar hoy al mismo endpoint a través del contrato del webhook genérico: apunta una función Lambda@Edge, un destino HTTPS de DataStream o cualquier herramienta de envío de logs a la URL de ingesta con tu clave. Los flujos nativos de un clic para estos proveedores llegarán según la demanda.

Cómo leer los resultados

Las visitas provenientes de logs aparecen en las mismas vistas de rastreadores de IA y tráfico de IA que las visitas del fragmento. La API pública expone el origen en cada fila, así que las exportaciones pueden separar lo que vio el fragmento de lo que vieron tus logs.