Loading...

Logs y analítica

¿Qué es Logpush? Los logs de acceso del CDN en sus propios sistemas

Cuando un CDN sirve su sitio, la mayoría de las solicitudes nunca llegan a su servidor, y sus líneas de log tampoco. La entrega de logs, a menudo llamada Logpush, se las devuelve: el CDN escribe una línea por cada solicitud en el edge y le entrega los archivos, listos para sus herramientas de logs, su SIEM o su archivo. Esta guía explica qué obtiene, qué contiene una línea de log y cómo funciona en cdn.com.tr.

8 min de lectura Intermedio Actualizado

¿Qué es Logpush? Los logs de acceso del CDN en sus propios sistemas

Por qué los logs de su origen ya no cuentan toda la historia

Antes de un CDN, su servidor web veía todas las solicitudes y las escribía en su log de acceso. Con un CDN, el edge responde él mismo a las solicitudes en caché, a menudo la mayoría, y su servidor ve solo lo que tuvo que servir: fallos de caché, páginas no almacenables en caché, llamadas a la API. Esas solicitudes también llegan desde direcciones del edge, a menos que restaure la dirección del visitante a partir de una cabecera, como muestra la guía de la IP real del visitante.

El registro completo de quién pidió qué vive ahora en el edge. La entrega de logs le envía ese registro: cada solicitud, acierto o fallo, con la dirección del visitante, los tiempos y el estado de la caché.

Qué le da la entrega de logs

Respuestas a preguntas concretas. ¿Qué pasó con esta solicitud en particular? ¿Qué direcciones descargaron este archivo? ¿Cuándo empezaron los errores 5xx y en qué URL? Los informes resumen; los logs responden.

Seguridad e investigaciones. Un SIEM correlaciona los logs del edge con los de su aplicación, su firewall y sus inicios de sesión, de modo que puede seguir un ataque, un scraper o un enlace filtrado a lo largo de días.

Su propia analítica. Cargue las líneas en un data warehouse y construya los informes que su negocio necesita, por país, red, dispositivo o tipo de contenido.

Un registro que usted controla. Los archivos son suyos: consérvelos el tiempo que exijan sus políticas, en el sistema que ya usa.

Anatomía de una línea de log

Los servicios de entrega de logs suelen escribir JSON Lines: un objeto JSON completo por línea, una línea por solicitud, comprimido con gzip. El formato se procesa en streaming, se divide y se añade sin problemas, y todas las herramientas de logs lo leen. En cdn.com.tr una línea lleva estos campos:

Cuándo y dónde: ts (la hora, ISO 8601 con desfase), edge y edge_port (la dirección y el puerto del edge al que se conectó el visitante).

Quién: client_ip y client_port (la dirección y el puerto de origen del visitante), country, asn (la red del visitante), user_agent y referer.

Qué: method, scheme, host, uri y protocol.

Cómo fue: status, bytes (bytes del cuerpo enviados), cache (HIT, MISS y los demás estados de caché), request_time (segundos que el edge dedicó a la solicitud) y origin_time (segundos que tardó su origen, - en un acierto de caché).

El puerto de origen importa más de lo que parece. En redes móviles y detrás de CGNAT, muchos visitantes comparten una misma dirección pública; solo la dirección, el puerto y la hora juntos señalan una conexión concreta.

Una solicitud, una línea (partida aquí para facilitar la lectura)

{"ts":"2026-11-20T11:03:07+00:00","edge":"203.0.113.10","edge_port":"443",
 "client_ip":"198.51.100.7","client_port":"53114","method":"GET","scheme":"https",
 "host":"www.example.com","uri":"/products/42","protocol":"HTTP/2.0",
 "status":200,"bytes":18342,"cache":"HIT","request_time":0.004,"origin_time":"-",
 "referer":"https://www.example.com/","user_agent":"Mozilla/5.0 ...",
 "country":"TR","asn":64500}

Logpush en cdn.com.tr

Los logs de acceso son un interruptor en la página Registros de acceso de su cuenta de CDN, y un solo interruptor cubre todos los dominios que la cuenta sirve a través del edge. Con la entrega activada, cada edge recoge sus solicitudes y sube un archivo JSON Lines comprimido con gzip cada cinco minutos; los primeros archivos aparecen en unos diez minutos.

Los archivos se agrupan por día (UTC) y cada uno cubre cinco minutos de un edge. Descargue archivos sueltos o un día completo desde el panel, o trabaje desde la línea de comandos: cdnctl logs pull descarga un día y, si se ejecuta de nuevo, solo los archivos nuevos; cdnctl logs grep descarga únicamente los archivos de una ventana de tiempo y los filtra en su ordenador por IP, código de estado, ruta y más. Los enlaces de descarga apuntan solo a la carpeta propia de su cuenta y caducan a los 15 minutos. Los propietarios y editores activan y desactivan la entrega; todos los roles del equipo pueden listar y descargar.

Los archivos se conservan 30 días y después se eliminan automáticamente. Para un historial más largo, llévelos a su propio archivo de forma programada, como se muestra más abajo. La guía de logs de acceso recoge todos los pasos.

Enmascaramiento de IP

Los logs de acceso contienen datos personales: la dirección IP de un visitante puede identificar a una persona y, como propietario del sitio, usted es el responsable del tratamiento de estos logs. Decida antes de activar la entrega si necesita las direcciones completas.

Con el enmascaramiento de IP activado, el edge escribe solo la parte de red de cada dirección: una dirección IPv4 conserva sus tres primeros octetos (198.51.100.0, el /24) y una dirección IPv6 sus tres primeros grupos (el /48). Eso basta para estadísticas de país, red y abuso, y mantiene a los visitantes individuales fuera de sus archivos, mientras que el puerto de origen sigue distinguiendo las conexiones. Cuando necesite las direcciones completas, para investigaciones o por una obligación de conservación de registros, deje el enmascaramiento desactivado y restrinja quién puede leer los archivos.

Llevar los logs a su SIEM o archivo

Trate la ventana de 30 días como un búfer de entrega y su propio almacenamiento como el registro. Basta con una tarea programada que descargue los archivos nuevos y, como cdnctl logs pull descarga solo los archivos que aún no tiene, ejecutarla cada hora cuesta casi nada.

Desde ahí, envíe los archivos adonde correspondan: a Elasticsearch u OpenSearch con Filebeat o Logstash, a BigQuery o ClickHouse como JSON, a la entrada de archivos de su SIEM, o a un almacenamiento de objetos con una regla de ciclo de vida para la retención a largo plazo. Para un archivo a prueba de manipulaciones, registre una suma de comprobación de cada archivo, o fírmelo, a medida que llega.

Descargue los archivos nuevos cada hora y luego consúltelos

# crontab: los archivos nuevos de hoy cada hora, los últimos de ayer tras medianoche (días UTC)
ACCOUNT_UUID=your-account-uuid
0 * * * *  cdnctl logs pull --account $ACCOUNT_UUID --out /var/log/cdn
20 0 * * * cdnctl logs pull --account $ACCOUNT_UUID --day $(date -u -d yesterday +\%F) --out /var/log/cdn

# errores 5xx con hora, host y URL
zcat /var/log/cdn/*.jsonl.gz | jq -r 'select(.status >= 500) | [.ts, .host, .uri, .status] | @tsv'

# una red en una ventana de tiempo, directamente desde la CLI
cdnctl logs grep --account $ACCOUNT_UUID --from "2026-11-20 14:00" --to "2026-11-20 15:00" --ip 198.51.100.0/24 --format table

Quién lee los logs del edge

Equipos de seguridad

Las solicitudes del edge en el SIEM junto a los eventos del firewall y de inicio de sesión, para seguir un ataque desde la primera sonda.

Soporte y depuración

El estado exacto, el estado de la caché y los tiempos de la solicitud de la que se queja un cliente, en segundos.

Archivos y auditorías

Un historial completo de solicitudes en su propio almacenamiento, conservado el tiempo que exijan sus políticas.

Cómo configurarlo

Guías paso a paso en el centro de ayuda:

Preguntas frecuentes sobre Logpush

¿Cuál es la diferencia entre Logpush y los informes de analítica?

Los informes agregan solicitudes, ancho de banda y ratio de caché a lo largo del tiempo. Los logs conservan cada solicitud con sus propios campos, de modo que puede responder preguntas que ningún informe anticipó y mantener los datos en sus propios sistemas.

¿Con qué rapidez llegan los logs?

Cada edge sube un archivo cada cinco minutos. Tras activar la entrega, los primeros archivos aparecen en unos diez minutos.

¿Cuánto tiempo se conservan los archivos de log?

Treinta días; después se eliminan automáticamente. Llévelos a su propio almacenamiento de forma programada para conservar un historial más largo; cdnctl logs pull descarga solo los archivos nuevos, así que ejecutarlo con frecuencia es barato.

¿Qué zona horaria usan los archivos?

Los archivos se agrupan por día UTC. Cada línea lleva su propia marca de tiempo en ISO 8601 con el desfase, de modo que sus herramientas pueden convertirla a cualquier zona horaria.

¿Puedo mantener las IP completas de los visitantes fuera de los archivos?

Sí. Con el enmascaramiento de IP activado, las direcciones IPv4 conservan su red /24 y las IPv6 su /48, de modo que los archivos no contienen direcciones completas de visitantes.

¿Qué dominios cubre Logpush?

Todos los dominios que su cuenta de CDN sirve a través del edge. Un solo interruptor en la cuenta los cubre todos, aciertos y fallos de caché por igual.