Вы можете получать логи работы CDN-ресурса. Это платная опция. Для подключения напишите нам в чат или на support@gcorelabs.com. После активации опции вы сможете произвести необходимые настройки в Личном кабинете.
Мы используем два протокола для передачи логов: S3 и FTP. Хранилище для приема и хранения логов настраивается и поддерживается вами.
Как настроить передачу логов через S3
Если вы используете Amazon в качестве хранилища, укажите идентификатор ключа доступа AWS, секретный ключ доступа AWS и регион (не обязательно).
Если в качестве хранилища вы используете другой сервис, укажите Hostname, идентификатор ключа доступа, секретный ключ доступа. Если вы используете Яндекс.Облако или наше S3 хранилище, укажите Хост бакета.
Как настроить передачу логов через FTP
Укажите Hostname, логин, пароль и папку для загрузки (не обязательно).
Если вы хотите указать порт, добавьте его в поле Hostname по шаблону <hostname>:<port>.
Оба способа передачи логов позволяют получать логи как в одну директорию в вашем хранилище, так и в разные.
Пример пути до лог-файла:
s3://log-bucket-name/2019/08/20/15/nodename_primarycname.gcdn.co_access.log.gz
Формат лога
"$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" "[$responding_node]"
"$upstream_cache_status" "$upstream_response_length" "$upstream_addr"
"$gcdn_api_client_id" "$gcdn_api_resource_id" "$uid_got" "$uid_set"
"$geoip_city_country_code" "$geoip_city" "$shield_type" "$server_addr" "$server_port"
"$upstream_status" "-" "$upstream_connect_time" "$upstream_header_time"
"$shard_addr" "$geoip2_data_asnumber" "$connection" "$connection_requests";
Пример лога
"0.0.0.0" "-" "-" "[26/Apr/2019:09:47:40 +0000]" "GET /ContentCommon/images/image.png HTTP/1.1" "200" "1514283" "https://example.com/videos/10" "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" "1514848" "-" "http" "origin.cdn.com" "1.500" "0.445" "157" "-" "[kal]" "MISS" "10485760" "0.0.0.0:80" "2510" "7399" "-" "-" "KZ" "-" "shield_no" "0.0.0.0" "80" "206" "-" "0.000" "0.200" "0.0.0.0" "asnumber"
Переменные
| Переменная | Значение из примера |
Пояснение |
| $remote_addr | 0.0.0.0 |
IP пользователя |
| $remote_user | - |
Имя пользователя, использованное в Basic аутентификации |
| [$time_local] | [26/Apr/2019:09:47:40 +0000] |
Локальное время в Common Log Format |
| $request |
GET /ContentCommon/images/image.png HTTP/1.1 |
Тип HTTP-запроса, запрошенный путь к файлу, версия HTTP |
| $status |
200 |
Код ответа от edge-сервера |
| $body_bytes_sent |
1514283 |
Число байт, переданное клиенту, без учёта заголовка ответа |
| $http_referer |
https://example.com/videos/10 |
Реферал: с какого URL пришел пользователь |
| $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 |
User Agent, с которым обратился пользователь за файлом (браузер или иная программа) |
| $bytes_sent |
1514848 |
Число байт, переданное пользователю |
| $sent_http_content_size | - |
Значение HTTP заголовка Content-Size |
| $scheme | http |
Протокол запроса (http или https) |
| $host | cdn.example.com |
Имя хоста CDN ресурса из запроса |
| $request_time | 1.500 |
Время обработки запроса, прошедшее с момента чтения первых байт от клиента до момента записи в лог после отправки последних байт клиенту, в секундах с точностью до миллисекунд |
| $upstream_response_time | 0.445 |
Время, затраченное на получение ответа от источника, в секундах с точностью до миллисекунд. Время нескольких ответов указывается через запятые и двоеточия |
| $request_length | 157 |
Длина запроса (включая строку, заголовок и тело запроса) |
| $http_range | - |
Размер фрагмента файла при Range запросе |
| [$responding_node] | kal |
Имя ответившего CDN узла в нашей системе |
| $upstream_cache_status | MISS |
Статус запрошенного файла в кеше CDN: HIT – файл отдан из кеша STALE – файл устарел, так как источник не ответил или ответил не правильно при обновлении кеша UPDATING - файл устарел, так как файл находится в процессе обновления после поступившего ранее запроса REVALIDATED – в результате запуска директивы proxy_cache_revalidate установлено, что файл на источнике не изменился EXPIRED - срок жизни в кеше истек, но файл соответствует файлу с источника. Отправлен запрос на источник для повторного кеширования MISS – файл отдан не из кеша, проксирован с источника |
| $upstream_response_length | 10485760 |
Длина ответа, полученная от источника, хранится в байтах. Длины нескольких ответов разделяются запятыми и двоеточиями |
| $upstream_addr | 0.0.0.0:80 |
IP адрес источника и порт |
| $gcdn_api_client_id | 123 |
Ваш ID в системе |
| $gcdn_api_resource_id | 01 |
ID вашего CDN ресурса в системе |
| $uid_got | - |
Имя куки и полученный идентификатор пользователя |
| $uid_set | - |
Имя куки и выданный идентификатор пользователя |
| $geoip_country_code | KZ |
Код страны пользователя |
| $geoip_city | - |
Код города пользователя |
| $shield_type | shield_no |
Подключен ли шилдинг на этом ресурсе shield_old - включен shield_no - выключен |
| $server_addr | 0.0.0.0 |
IP адрес ответившей anycast зоны или edge-сервера |
| $server_port | 80 |
Порт, на который пришел запрос |
| $upstream_status | 206 |
Код ответа от источника |
| $upstream_connect_time | 0.000 |
Время, затраченное подключение к источнику, в секундах с точностью до миллисекунд. |
| $upstream_header_time | 0.200 |
Время, затраченное на получение заголовков ответа от источника, в секундах с точностью до миллисекунд. |
| $shard_addr | 0.0.0.0 |
IP адрес edge-сервера, который изначально принял запрос клиента при включенном шардинге у ресурса. |
| $geoip2_data_asnumber | asnumber |
Номер автономной системы откуда пришел запрос пользователя. |
| $connection | 2897494295 |
Порядковый номер соединения. |
| $connection_requests | 1 |
Текущее число запросов в соединении. |