Перевод статьи подготовлен для студентов курса «Инфраструктурная платформа на основе Kubernetes» в образовательном проекте OTUS.
Введение
Уже какое-то время я экспериментирую с созданием информационных панелей Grafana для администрирования Kubernetes. Как владельцу и администратору нескольких кластеров Kubernetes мне хотелось получить визуальное представление некоторых показателей. Во-первых, мне нужны нормальные информационные панели Grafana для компонентов Kubernetes Control Plane и Node: kube-api, kube-scheduler, kube-controller-manager, а также kubelet и kube-proxy. Во-вторых, получившиеся панели хотелось бы выложить на GitHub, чтобы остальные могли оставлять предложения и отчеты об ошибках (issues), посылать запросы на принятие изменений (pull requests), обновлять панели (git pull) и помогать мне в работе над ними.
Публикация информационных панелей Grafana
Сейчас панели Grafana в основном публикуются на странице grafana.com/dashboards. Чтобы получить нужную панель, надо найти ее на странице, скопировать идентификатор и импортировать его в локальный экземпляр Grafana. Хотя импорт информационных панелей реализован относительно просто, опыт показывает, что большинству пользователей неудобно с ними работать. На то есть несколько причин.
Во-первых, люди пользуются разными селекторами меток для указания целей мониторинга в Prometheus. Во-вторых, в новых версиях экспортеров Prometheus и приложений для обращения к метрикам имена метрик постоянно меняются и удаляются. В-третьих, найти действительно качественные информационные панели крайне тяжело — никогда не знаешь, что в конечном итоге получишь после импорта. Выбрав панель, приходится прочесывать все графики и править метрики вместе с селекторами меток — а это большой объем ручной работы.
Проект Monitoring Mixins
Я нашел очень классный проект под названием Monitoring Mixins. По сути это своеобразная экосистема, призванная побороть все наболевшие проблемы панелей. Идея пришла в голову Фредерику Бранчику (Frederic Branczyk), и именно он написал исходный дизайн-документ, с которым я настоятельно рекомендую ознакомиться. Более того, он продумал реальный механизм обновления информационных панелей и их извлечения из различных репозиториев GitHub. Этот механизм весьма похож на go get , и мне он очень понравился. Здесь вы можете прочесть краткое описание менеджера пакетов jsonnet-bundler, использующего этот механизм. Огромное спасибо Фредерику за полезные разработки!
Пакет Kubernetes Grafana Mixin
Если вы дочитали до этого места, можете немного передохнуть и насладиться красивыми картинками.
Сервер API
Менеджер контроллеров
Планировщик
Кублет (агент узла)
Kube Proxy
Использование пакета Kubernetes Grafana Mixin
Сначала вам нужно установить jsonnet и jsonnet-bundler.
Jsonnet
Если вы работаете в macOS, можете воспользоваться командой brew install jsonnet. В противном случае лучше скомпилировать этот компонент самостоятельно.
Jsonnet Bundler
Импорт панелей
Создайте новый каталог для проекта и войдите в него командой cd .
Установите mixin:
Теперь создайте новый файл config.libsonnet.
После этого импортируется информационная панель и перезапишутся селекторы задач (job).
Исправьте селекторы меток Prometheus в соответствии с вашей средой.
Теперь создайте каталог dashboards . И наконец, запустите jsonnet, чтобы скомпилировать config.libsonnet:
Вам выведется следующий список:
Результат
Выведите содержимое каталога информационных панелей.
Добавление информационных панелей в Grafana
Я уже говорил, что настоятельно рекомендую размещать панели через файлы конфигурации. Подробнее узнать о том, как это делается, можно в документации по Grafana.
С другой стороны, ничто вам не мешает открыть интерфейс Grafana и добавить панели через него.
Обновление информационных панелей
Со временем панели будут меняться. Чтобы их обновить, достаточно следующей команды:
На сегодня это все.
Надеюсь, вам понравятся мои информационные панели. В отдельной статье я расскажу о том, как я их создавал и почему сделал именно такими, поэтому обязательно подписывайтесь на обновления. Подписчики видят мои работы первыми, еще до публикации.
Мне также крайне интересны ваши отзывы. Если вы использовали мои панели, оцените, насколько они оказались вам полезны, или поделитесь, если они выручили вас в реальной рабочей ситуации. Просто оставьте комментарий!
Кстати, если вы хотите поблагодарить меня за старания, можете посмотреть мой открытый список желаний и купить мне, например, хорошую книжку.
Я очень ценю качественные проекты с открытыми исходниками. Пакет kubernetes-grafana-mixin доступен по разрешительной лицензии Apache 2 . Если вам понравился проект, оцените его на Github!
24 июня приглашаем на день открытых дверей курса «Инфраструктурная платформа на основе Kubernetes».
Не упустите отличную возможность узнать подробнее о программе курса, особенностях онлайн-формата и перспективах, которые ждут выпускников после обучения.
Преподаватель: Юрий Игнатов — ведущий инженер Express42.
ЗАПИСАТЬСЯ
