Loading...

Logs et analytique

Qu'est-ce que Logpush ? Les logs d'accès du CDN dans vos propres systèmes

Dès qu'un CDN sert votre site, la plupart des requêtes n'atteignent jamais votre serveur, et leurs lignes de log non plus. La livraison de logs, souvent appelée Logpush, les ramène : le CDN écrit une ligne pour chaque requête à la périphérie et vous livre les fichiers, prêts pour vos outils de logs, votre SIEM ou votre archive. Ce guide explique ce que vous obtenez, ce que contient une ligne de log et comment cela fonctionne sur cdn.com.tr.

8 min de lecture Intermédiaire Mis à jour

Qu'est-ce que Logpush ? Les logs d'accès du CDN dans vos propres systèmes

Pourquoi les logs de votre origine ne racontent plus toute l'histoire

Avant un CDN, votre serveur web voyait chaque requête et l'écrivait dans son log d'accès. Avec un CDN, la périphérie répond elle-même aux requêtes en cache, souvent à la plupart d'entre elles, et votre serveur ne voit que ce qu'il a dû servir : les échecs de cache, les pages non cachables, les appels d'API. Ces requêtes arrivent elles aussi depuis des adresses de la périphérie, sauf si vous restituez l'adresse du visiteur à partir d'un en-tête, comme le montre le guide de l'IP réelle du visiteur.

Le relevé complet de qui a demandé quoi se trouve désormais à la périphérie. La livraison de logs vous l'envoie : chaque requête, succès ou échec de cache, avec l'adresse du visiteur, les temps de traitement et l'état du cache.

Ce que vous apporte la livraison de logs

Des réponses à des questions précises. Que s'est-il passé pour cette requête précise ? Quelles adresses ont téléchargé ce fichier ? Quand les erreurs 5xx ont-elles commencé, et sur quelles URL ? Les rapports résument ; les logs répondent.

Sécurité et investigations. Un SIEM met en corrélation les logs de la périphérie avec ceux de votre application, de votre pare-feu et de vos connexions, de sorte que vous pouvez suivre une attaque, un scraper ou un lien divulgué sur plusieurs jours.

Votre propre analytique. Chargez les lignes dans un entrepôt de données et construisez les rapports dont votre activité a besoin, par pays, réseau, appareil ou type de contenu.

Un historique que vous maîtrisez. Les fichiers vous appartiennent : conservez-les aussi longtemps que vos politiques l'exigent, dans le système que vous utilisez déjà.

Anatomie d'une ligne de log

Les services de livraison de logs écrivent en général du JSON Lines : un objet JSON complet par ligne, une ligne par requête, compressé en gzip. Ce format se lit en flux, se découpe et s'ajoute proprement, et tous les outils de logs le comprennent. Sur cdn.com.tr, une ligne contient ces champs :

Quand et où : ts (l'heure, ISO 8601 avec décalage), edge et edge_port (l'adresse et le port de la périphérie auxquels le visiteur s'est connecté).

Qui : client_ip et client_port (l'adresse du visiteur et son port source), country, asn (le réseau du visiteur), user_agent et referer.

Quoi : method, scheme, host, uri et protocol.

Comment cela s'est passé : status, bytes (octets du corps envoyés), cache (HIT, MISS et les autres états du cache), request_time (secondes passées par la périphérie sur la requête) et origin_time (secondes mises par votre origine, - en cas de HIT).

Le port source compte plus qu'il n'y paraît. Sur les réseaux mobiles et derrière un CGNAT, de nombreux visiteurs partagent une même adresse publique ; seuls l'adresse, le port et l'heure réunis désignent une connexion précise.

Une requête, une ligne (coupée ici pour la lecture)

{"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 sur cdn.com.tr

Les logs d'accès s'activent par un interrupteur sur la page Journaux d'accès de votre compte CDN, et un seul interrupteur couvre tous les domaines que le compte sert via la périphérie. Une fois la livraison activée, chaque serveur de périphérie collecte vos requêtes et envoie un fichier JSON Lines compressé en gzip toutes les cinq minutes ; les premiers fichiers apparaissent en une dizaine de minutes environ.

Les fichiers sont regroupés par jour (UTC), et chacun couvre cinq minutes d'un serveur de périphérie. Téléchargez des fichiers isolés ou une journée entière depuis le panneau, ou travaillez en ligne de commande : cdnctl logs pull récupère une journée et, relancé, seulement les nouveaux fichiers ; cdnctl logs grep ne télécharge que les fichiers d'une fenêtre de temps et les filtre sur votre ordinateur par IP, code de statut, chemin et plus encore. Les liens de téléchargement pointent uniquement vers le dossier propre à votre compte et expirent au bout de 15 minutes. Les propriétaires et les éditeurs activent et désactivent la livraison ; tous les rôles de l'équipe peuvent lister et télécharger.

Les fichiers sont conservés 30 jours, puis supprimés automatiquement. Pour un historique plus long, récupérez-les régulièrement dans votre propre archive, comme indiqué plus bas. Le guide des logs d'accès détaille chaque étape.

Masquage des IP

Les logs d'accès contiennent des données personnelles : l'adresse IP d'un visiteur peut identifier une personne, et en tant que propriétaire du site vous êtes le responsable du traitement de ces logs. Décidez avant d'activer la livraison si vous avez besoin des adresses complètes.

Avec le masquage des IP activé, la périphérie n'écrit que la partie réseau de chaque adresse : une adresse IPv4 conserve ses trois premiers octets (198.51.100.0, le /24) et une adresse IPv6 ses trois premiers groupes (le /48). C'est suffisant pour les statistiques par pays, par réseau et sur les abus, et cela garde les visiteurs individuels hors de vos fichiers, tandis que le port source continue de distinguer les connexions. Lorsque vous avez besoin des adresses complètes, pour des investigations ou une obligation de conservation, laissez le masquage désactivé et limitez le nombre de personnes pouvant lire les fichiers.

Faire entrer les logs dans votre SIEM ou votre archive

Considérez la fenêtre de 30 jours comme un tampon de livraison et votre propre stockage comme la source de référence. Il suffit d'une tâche planifiée qui récupère les nouveaux fichiers, et comme cdnctl logs pull ne télécharge que les fichiers que vous n'avez pas encore, l'exécuter toutes les heures ne coûte presque rien.

À partir de là, envoyez les fichiers là où ils doivent aller : vers Elasticsearch ou OpenSearch avec Filebeat ou Logstash, dans BigQuery ou ClickHouse en JSON, vers l'entrée fichier de votre SIEM, ou vers un stockage objet avec une règle de cycle de vie pour la conservation à long terme. Pour une archive infalsifiable, enregistrez une somme de contrôle de chaque fichier, ou signez-le, dès son arrivée.

Récupérer les nouveaux fichiers chaque heure, puis les interroger

# crontab: today's new files every hour, yesterday's last files after midnight (UTC days)
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

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

# one network in a time window, straight from the 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 lit les logs de la périphérie

Équipes de sécurité

Les requêtes de la périphérie dans le SIEM, à côté des événements de pare-feu et de connexion, pour suivre une attaque dès la première sonde.

Support et débogage

Le statut exact, l'état du cache et les temps de la requête dont se plaint un client, en quelques secondes.

Archives et audits

Un historique complet des requêtes dans votre propre stockage, conservé aussi longtemps que vos politiques l'exigent.

Comment le mettre en place

Guides pas à pas dans le centre d'aide :

FAQ Logpush

Quelle est la différence entre Logpush et les rapports d'analytique ?

Les rapports agrègent les requêtes, la bande passante et le taux de cache dans le temps. Les logs conservent chaque requête avec ses propres champs : vous pouvez ainsi répondre à des questions qu'aucun rapport n'avait prévues, et garder les données dans vos propres systèmes.

En combien de temps les logs arrivent-ils ?

Chaque serveur de périphérie envoie un fichier toutes les cinq minutes. Après l'activation de la livraison, les premiers fichiers apparaissent en une dizaine de minutes environ.

Combien de temps les fichiers de logs sont-ils conservés ?

Trente jours, puis ils sont supprimés automatiquement. Récupérez-les régulièrement dans votre propre stockage pour garder un historique plus long ; cdnctl logs pull ne télécharge que les nouveaux fichiers, donc des exécutions fréquentes coûtent peu.

Quel fuseau horaire les fichiers utilisent-ils ?

Les fichiers sont regroupés par jour UTC. Chaque ligne porte son propre horodatage en ISO 8601 avec le décalage, de sorte que vos outils peuvent le convertir dans n'importe quel fuseau horaire.

Puis-je garder les IP complètes des visiteurs hors des fichiers ?

Oui. Avec le masquage des IP activé, les adresses IPv4 conservent leur réseau /24 et les adresses IPv6 leur /48 : les fichiers ne contiennent donc aucune adresse complète de visiteur.

Quels domaines Logpush couvre-t-il ?

Tous les domaines que votre compte CDN sert via la périphérie. Un seul interrupteur sur le compte les couvre tous, succès et échecs de cache confondus.