We can send you CDN resources logs. Contact us via chat or email to support@gcorelabs.com to enable the option (it is a paid feature). Once the feature is enabled you will be able to set it up in the Control Panel.
We use two protocols to deliver logs: S3 and FTP.
You should set up a storage on your side to start receiveing the logs.
S3
If you want to receive logs to your Amazon storage specify AWS Access Key ID, AWS Secret Access Key and Region (optional).
If you choose Other, fill in Hostname, AWS Access Key ID and AWS Secret Access Key.
FTP
Specify Hostname, Login, Password and Prepend folder (optional).
A port number can be added to your Hostname if needed: <hostname>:<port>.
Both delivery methods allow to put logs either in one bucket or into different buckets in your storage.
Log Format
'"$remote_addr" "-" "$remote_user" "[$time_local]" '
'"$request" "$status" "$body_bytes_sent" '
'"$http_referer" "$http_user_agent" '
'"$bytes_sent" "$sent_http_content_size" "$scheme" "$host" '
'"$request_time" "$upstream_response_time" "$request_length" "$http_range" '
'"datacenter" "$upstream_cache_status" "$upstream_response_length" "$upstream_addr" '
'"$gcdn_api_client_id" "$gcdn_api_resource_id" "$uid_got" "$uid_set" '
'"$geoip_country_code" "$geoip_city" "$shield_type" "$server_addr"';
Example Log
"127.0.0.1" "-" "-" "[14/Sep/2018:11:54:44 +0000]" "HEAD /ContentCommon/images/image.png HTTP/1.1" "200" "0" "-" "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_12_1) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/53.0.2785.116 YaBrowser/16.10.0.2309 Safari/537.36" "515" "-" "http" "origin.cdn.com" "1.100" "1.100" "191" "-" "[ix]" "MISS" "3333" "11.22.33.444:80" "123" "01" "-" "-" "-" "-" "shield_no" "127.0.0.1"
Fields
| Field | Example log value |
Description |
| $remote_addr | 127.0.0.1 |
IP address of the client |
| $remote_user | - |
user name supplied with the Basic authentication |
| [$time_local] | [14/Sep/2018:11:54:44 +0000] |
local time in the Common Log Format |
| $request |
HEAD /ContentCommon/images/image.png HTTP/1.1 |
HTTP request type, URL without a query string, HTTP version |
| $status |
200 |
response status |
| $body_bytes_sent |
0 |
number of bytes sent to a client, not counting the response header |
| $http_referer |
- |
referrer: specify the URI of the resource from which the Request-URI was obtained |
| $http_user_agent |
Mozilla/5.0 (Macintosh; Intel Mac OS X 10_12_1) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/53.0.2785.116 YaBrowser/16.10.0.2309 Safari/537.36 |
software (e.g., browser) used to request the content |
| $bytes_sent |
515 |
number of bytes sent to a client |
| $sent_http_content_size | - |
value of the HTTP Content-Size header |
| $scheme | http |
scheme (http or https) |
| $host | origin.cdn.com |
in priority order: hostname from the request line or hostname from the Host header or the server name |
| $request_time | 1.100 |
request processing time in seconds with a milliseconds resolution; time elapsed between the first bytes were read from the client and the log write after the last bytes were sent to the client |
| $upstream_response_time | 1.100 |
time spent on receiving the response from the upstream server; the time is kept in seconds with millisecond resolution. Times of several responses are separated by commas and colons |
| $request_length | 191 |
request length (including request line, header, and request body) |
| $http_range | - |
used for the slice module and VOD (video on demand) |
| [datacenter] | ix |
server name in our system |
| $upstream_cache_status | MISS |
status of accessing a response cache: HIT – cached STALE – cached but outdated, the renewal is in progress. Might indicate the origin unavailability MISS – not cached |
| $upstream_response_length | 3333 |
length of the response obtained from the upstream server; kept in bytes. Lengths of several responses are separated by commas and colons |
| $upstream_addr | 11.22.33.444:80 |
IP address and port of the upstream server |
| $gcdn_api_client_id | 123 |
your id in our system |
| $gcdn_api_resource_id | 01 |
your resource id in our system |
| $uid_got | - |
cookie name and identification received by a user |
| $uid_set | - |
cookie name and identification provided to a user |
| $geoip_country_code | - |
user’s country code |
| $geoip_city | - |
user’s city code |
| $shield_type | shield_no |
specifies if a shield is enabled or not |
| $server_addr | 127.0.0.1 |
IP address of the server |