Récupération des logs d'accès depuis l'API

Modifié le Mer, 22 Janv. à 9:03 H

L'API de Fasterize vous permet de récupérer les logs d'accès de votre compte des sept derniers jours, disponibles au format JSON ou Apache.

Pour utiliser cette fonctionnalité, veuillez contacter notre support afin d'obtenir votre token d'API. Assurez-vous également de disposer de l'identifiant de configuration, accessible dans la console Fasterize via Accueil > Websites, puis dans la colonne Config ID de la ligne correspondant à votre domaine.

L'URL de l'API correspondante aux logs d'accès est https://api.fasterize.com/v2/configs/$config_id/logs.

Paramétrage

Il existe différents paramètres :

from : secondes depuis l'époque unix
to : secondes depuis l'époque unix
domain : liste des domaines ciblés
onlySeoVisit : filtre les logs des visiteurs en provenance d'un moteur de recherche (Google, Bing, Baidu, Yandex)
onlySearchBot : filtre les logs provenant du trafic des bots des moteurs de recherche (Google, Bing, Baidu, Yandex)
format : json ou apache

Remarque importante

Dans notre cas, les logs fournis par l’API proviennent de l'ingestion des logs de CloudFront.
Le système de récupération des logs CloudFront a un délai d'environ 30 minutes par rapport au temps réel.

En l'absence du paramètre 'from', la réponse renvoie aucun logs.
N'hésitez pas à ajuster vos paramètres en conséquence pour obtenir des résultats pertinents.

Si vous souhaitez récupérer les logs des 15 dernières minutes :
Soustrayez 900 secondes (= 15 minutes) du timestamp actuel.

Pour obtenir cette valeur, vous pouvez utiliser un convertisseur de timestamp Unix, comme celui disponible sur le site https://www.unixtimestamp.com

Utilisez la valeur comme argument pour le paramètre from dans votre URL pour récupérer les logs des 15 dernières minutes.

Exemple d'appel à l'API

# Récupérer les logs des quinze dernières minutes

curl "https://api.fasterize.com/v2/configs/$config_id/logs?from=$timestamp_unix" -H"Authorization:$myApiToken"

# Récupérer les logs de la veille

from=$(date -d "yesterday 00:00:00" '+%s')

to=$(date -d "yesterday 23:59:59" '+%s')

curl "https://api.fasterize.com/v2/configs/${configID}/logs?from=${from}&to=${to}" -H"Authorization:${token}"

Format de la réponse

Chaque log est constitué des champs suivants :

client_ip (adresse IPv4 du client),
content_length
content_type
domain
fstrz_flags (voir la liste des champs)
method
protocol
referer
response_time (in msec)
status
timestamp
url
user_agent
user_agent_class (mobile / desktop_recent / tablet / bot / old)

Exemple :

{
  "client_ip":"217.167.19.73",
  "content_length":40945,
  "content_type":"text/html;charset=UTF-8",
  "domain":"www.nocibe.fr",
  "fstrz_flags":"o",
  "method":"GET",
  "protocol":"http",
  "referer":"",
  "request_id":"42024b74-f79f-4173-91b5-c2c9f236c57d",
  "response_time":1.552,
  "status":"200",
  "timestamp":"2017-04-10T15:38:18.830Z",
  "url":"/giorgio-armani-si-gel-douche-p-206477",
  "user_agent":"Screaming Frog SEO Spider/7.2","user_agent_class":"desktop_recent"
}

Apache Combined Log Format

Le format de logs Apache utilisé est le format combined :

LogFormat "%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-agent}i\""

Ce format est le seul supporté par des outils d'analyse SEO tels que Screaming Frog Log Analyser.