Skip to content

Latest commit

 

History

History
69 lines (58 loc) · 3.3 KB

README.md

File metadata and controls

69 lines (58 loc) · 3.3 KB

nanometer

Библиотека для сбора данных и отправки их в Graphite.

Зачем?

Потому что Exometer не гарантирует доставку данных и не умеет в авторесет счётчиков (поэтому умеет терять данные напрочь), а StatsD написан на node.js, а мы не очень хотим конвертировать в текст и потом сразу обратно.

Как пользоваться?

  1. Запустите приложение.

  2. Используйте вызовы:

    • nanometer:count(Name, Delta),
    • nanometer:meter(Name, Delta),
    • nanometer:gauge(Name, Number),
    • nanometer:histogram(Name, Number[, Options]),
    • nanometer:time(Name, fun() -> .. end[, Options])

    где Name - список из атомов, бинарников или целых чисел.

    Время измеряется в микросекундах так, как это делает модуль timer.

    Опции гистограмм:

    • accuracy: точность перцентилей в процентах.
    • percentiles: перцентили, которые будут отправляться на сервер.
    • min_lifetime: время в миллисекундах (или infinity), в течение которого гистограмма будет игнорировать сбросы.
    • debug: отсылать ли статистику.

  3. Репортер будет коллекционировать все ваши метрики и отправлять на сервер. Те метрики, которые удалось отправить, будут сбрасываться. Те, которые не удалось, будут накапливаться.

  4. Наслаждайтесь метриками, которые ведут себя разумно и никуда не теряются!

Отсылаемые данные

  • для счётчиков: count - счёт с последней отсылки, rate - изменение счёта в секунду.
  • для уровней: value - общая сумма за всё время.
  • для шкал: value - значение шкалы.
  • для гистограмм: все заявленные перцентили плюс отладочная статистика: 
    {count, количество точек}
{size, размер хранилища}
{capacity, максимальный достигнутый размер хранилища}
{compressions, количество произведённых сжатий}
  • для всех типов, кроме meter, external: ms_since_reset.

Настройка репортера

{nanometer, [
  {reporter, [
    {address, {Host, Port}}},
    {prefix, "prefix.as.iodata.without.trailing.dot"},
    {period, PeriodInMs},
    {packet_size, FullPacketSizeToSend},
    {tcp_options, GenTcpConnectOptions}
  ]}
]}

Кроме того

Настройки гистограмм по умолчанию можно указать в переменной приложения histogram_options.

Автор