Практическое задание

Эта задача — шаг 1 курса «Мониторинг и метрики»

Экспортёр метрики

легко~7 мин

Prometheus забирает метрики по HTTP — со страницы /metrics сервера. Напиши /usr/local/bin/export-metric, который печатает метрику в формате Prometheus: строку app_up 1. Запусти его и сохрани вывод в /var/www/html/metrics — nginx уже запущен и отдаёт этот файл как http://localhost/metrics.

Скрипт удобно написать во вкладке «Редактор» (каталог /usr/local/bin виден в дереве файлов), а результат посмотреть во вкладке «Сайт»: на главной есть ссылка /metrics, после записи файла нажми «Обновить».

Что потренируешь:
  • prometheus
  • метрики
  • shell
  • chmod
  • редирект

Разбор темы

Текстовый формат экспозиции Prometheus предельно прост: одна метрика — одна строка имя_метрики значение, разделённые пробелом; сверху опционально идут строки-метаданные # HELP и # TYPE. Экспортёр в такой модели — это просто программа (здесь shell-скрипт с shebang), которая печатает эти строки в stdout, а сбор данных сводится к перенаправлению вывода в файл. Не забывай два момента: файл нужно сделать исполняемым через chmod +x, а редирект делать через > (перезапись), а не >>, чтобы строки не задваивались при повторных прогонах. Сам Prometheus приходит за этими строками по HTTP — обычно на путь /metrics, поэтому вывод экспортёра отдают веб-сервером или встроенным в приложение HTTP-обработчиком.

Что проверяется

  1. Скрипт исполняемый
  2. Скрипт печатает метрику
  3. /metrics отдаёт метрику

Как это выглядит