Вклад в проект

Prometheus использует GitHub для управления обзорами запросов на вытягивание (pull requests).

• Если у вас есть тривиальное исправление или улучшение, создайте запрос на вытягивание, обращаясь (@...) к сопровождающему этого репозитория (см. MAINTAINERS.md) в описании запроса на вытягивание.

• Если вы планируете сделать что-то более сложное, сначала обсудите свои идеи в нашем списке рассылки (https://groups.google.com/forum/?fromgroups#!forum/prometheus-developers). Это позволит избежать ненужной работы и наверняка даст вам и нам много вдохновения.

• Соответствующие руководства по стилю кодирования — это Go Code Review Comments и раздел «Форматирование и стиль» книги Питера Бургона Go: Best Practices for Production Environments.

• Подписывайте свою работу, чтобы подтвердить, что ваши изменения были созданы вами или у вас есть право отправить их под нашей лицензией. Подробнее читайте на сайте https://developercertificate.org/. Добавляйте подпись к каждому сообщению коммита следующим образом:

    Signed-off-by: Random J Developer <example@example.com>

Руководство по реализации сборщика

Node Exporter не является универсальным агентом мониторинга. Его единственная цель — предоставлять метрики оборудования, а не метрики сервисов, за исключением текстового сборщика.

Метрики не должны преобразовываться таким образом, который зависит от оборудования и требует поддержки каких-либо специфичных для поставщика сопоставлений или условий. Например, если файл proc содержит магическое число 42 в качестве некоторого идентификатора, Node Exporter должен предоставить его как есть и не хранить сопоставление в коде, чтобы сделать его удобочитаемым. Вместо этого текстовый сборщик можно использовать для добавления статической метрики, которую можно объединить с метриками, предоставляемыми экспортером, чтобы получить удобочитаемый идентификатор.

Сборщик может только читать файлы /proc или /sys, использовать системные вызовы или локальные сокеты для получения метрик. Ему не требуются права суперпользователя. По соображениям производительности и надёжности выполнение внешних команд запрещено. Используйте вместо этого специальный экспортер или собирайте метрики через текстовый сборщик.

Node Exporter пытается поддерживать наиболее распространённые метрики оборудования. Для более экзотических метрик используйте текстовый сборщик или специальный Экспортер.