Amazon CloudFront Edges in AWStats

CloudFront Edges in AWStats

Here's a quick breakdown of how to get the usage of your different Amazon CloudFront Edge locations within AWStats. I confess that I get some crazy pleasure from collecting statistics, still though, bandwidth usage is of interest in this case, as well as hits and that it can be interesting to see which regions most of the visitors come from.

I use the cluster functionality in AWStats to display the CloudFront Edges, as can be seen in the screenshot to the right.

I'm running AWStats on an Ubuntu server and this guide assumes that you are already collecting your CloudFront logs to a server and processes them with AWStats. If not, check out my other article dealing with that.

Let's work with our hypothetical CloudFront distribution named

In Ubuntu AWStats stores the configurations files in /etc/awstats/ so I will assume there is a file located there named


which processes the CloudFront log already.

If you have configured the above .conf file properly for CloudFront, %cluster is collected in the LogFormat which contains all information needed to be able to display the edges. So now we only need to tell AWStats to start using that information.

First in the, enable cluster statistics by finding ShowClusterStats=0 and change it to:


And then continue down to the plugin section and uncomment


Now we only need to tell AWStats the name of the edges, so they make sense when checking the statistics later on. In AWStats DirData directory, create a file named clusterinfo.[your AWStats config name].txt

Which in our example would be


This file shall contain a tab separated list of cluster numbers and then a text to display for each cluster. At the time of writing this article this is the complete list to paste into that file for all available CloudFront Edges. If Amazon adds more edges in the future they will have to be added at that time.

DFW3    USA: Dallas/Fort Worth, TX
EWR2 USA: Newark, NJ
IAD2 USA: Ashburn, VA
JAX1 USA: Jacksonville, FL
JFK1 USA: New York, NY
LAX1 USA: Los Angeles, CA
MIA3 USA: Miami, FL
SEA4 USA: Seattle, WA
SFO4 USA: Palo Alto, CA
STL2 USA: St. Louis, MO
AMS1 Europe: Amsterdam
DUB2 Europe: Dublin
FRA2 Europe: Frankfurt
LHR3 Europe: London
HKG1 Asia: Hong Kong
NRT4 Asia: Tokyo
SIN2 Asia: Singapore

Okay, that's it, the next time AWStats updates the statistics output you should start getting Edge usage outputted in the Cluster section, like in the screenshot above.