С помощью плагина«cdn-stats» от G-Core Labs в Grafana можно отображать статистику CDN по:
- Total Traffic — общему объёму трафика — трафик от источника до CDN или Шилдинга + от Шилдинга до CDN + от CDN до пользователей;
- Byte cache Hit Ratio — доле кешированного трафика — 1-(трафик от источника до CDN или Шилдинга / трафик от CDN до пользователей);
- Edges Traffic — трафику от CDN-серверов — трафик от Шилдинга до CDN + от CDN до пользователей;
- Shield Traffic — трафику от Шилдинга — трафик от Шилдинга до CDN;
- Origin Traffic — трафику от источника — трафик от источника до CDN или Шилдинга;
- Total Requests — количеству запросов к CDN;
- 2xx, 3xx, 4xx, 5xx Responses — количеству 2xx, 3xx, 4xx и 5xx ответов;
- Bandwidth — ширине полосы — вычисляется на основании трафика от источника до CDN или Шилдинга + от Шилдинга до CDN + от CDN до пользователей;
- Cache Hit Ratio — доле отправки кешированного контента — ответы с кешированным контентом / количество запросов к CDN;
- Shield traffic ratio — эффективности работы Шилдинга — на сколько больше трафика отправлено с Шилдинга, чем с источника — (трафик от Шилдинга до CDN - трафик от источника до Шилдинга) / трафик от Шилдинга до CDN;
Для удобного отображения данных можно сгруппировать метрики по следующим параметрам:
- Clients — клиенты;
- Resource — CDN-ресурсы;
- Region — регионы;
- Country — страны;
- Data — дата-центры;
- Vhost — персональный домен.
Важно! Плагин предназначен для Grafana версии 7.0 и выше.
Что нужно, чтобы настроить получение статистики CDN в Grafana:
- Grafana версии 7.0 и выше.
- Скачать и установить плагин от G-Core Labs.
- Настроить Дашборд для удобного отображения информации.
Видеоинструкции шагов настройки:
- Скачать и установить плагин от G-Core Labs.
- Настроить Дашборд для удобного отображения информации по CDN-ресурсам.
Скачать и установить плагин
Скачайте файл «gcorelabs-cdn-stats-datasource-1.0.8.zip» с последней версией плагина в GitHub.
Обратите внимание! Цифры в названии файла (1.0.8) означают версию плагина и могут меняться в зависимости от обновлений.
Распакуйте содержимое архива в папку плагинов Grafana. По умолчанию это папка установки Grafana\grafana\data\plugins
Перезапустите и авторизуйтесь в Grafana.
Нажмите на знак шестеренки в меню слева, чтобы открыть раздел «Configuration», выберите «Data Sources».
Нажмите «Add Data Source», чтобы добавить новый ресурс для загрузки данных.
Найдите плагин «cdn-stats» от G-Core Labs и нажмите «Select» для выбора этого плагина.
Откроются настройки плагина. В разделе «Auth» добавьте перманентный API-токен.
Получить токен можно в личном кабинете. Для этого перейдите в «Профиль» -> «API-токены»-> «Создать токен».
Вставьте полученный API-токен в поле «API token» в формате: APIKey {полученный API-токен}.
Например: APIKey 7711$eyJ0eXAiOiJKV
Нажмите «Save & Test».
Если всё сделано правильно, отобразятся сообщения «Datasource updated» и «You successfully authenticated as {Имя}»:
Видеоинструкция шага «Скачать и установить плагин»
Настроить Дашборд
Нажмите на «+» в меню слева, чтобы открыть раздел «Create», выберите «Dashboard» для добавления нового дашборда.
В открывшемся окне нажмите «Add an empty panel» для создания новой панели.
Убедитесь, что в разделе «Query» в качестве источника данных установлен «cdn-stats».
Выберите необходимые метрику, гранулярность и группировку (можно выбрать несколько).
В поле «Legend» по умолчанию отображаются значения поля «Group by» и название метрики:
Вы можете настроить формат вывода легенды данных.
Задайте удобное имя метрики и в скобках{{}} укажите параметры, заданные в поле «Group by».
Например, для настроек выше можно задать следующий формат: «Количество трафика — {{resource}}».
Откройте настройки Дашборда, нажав на шестеренку в правом верхнем углу.
Перейдите в раздел «Variables» и нажмите «Add variable», чтобы добавить переменную. С её помощью можно фильтровать данные на графике.
Например, чтобы иметь возможность фильтровать ресурсы, необходимо выполнить следующие настройки и нажать «Update»:
- Name - задайте имя переменной (обязательно).
- Values for - выберите значение для переменной: resourceID (ресурсы).
- Sort - задайте порядок сортировки элементов (опционально)
- Selection Options - задайте вид выделения элементов (опционально)
-
- Multi-value - возможность выбора нескольких элементов.
- Include All option - возможность выбрать все элементы, отметив значение «All».
-
Вернитесь к Дашборду, нажав стрелочку в левом верхнем углу экрана.
Привяжите переменную к Дашборду. Для этого укажите её имя в поле «Resources» блока «Filters (comma separated)».
Важно! Поставьте «$» перед именем переменной.
Готово. Теперь можно выбирать, данные каких ресурсов отображаются на графике.
Сохраните Дашборд. Для этого нажмите «Save» в правом верхнем углу панели.