Метрики Tarantool¶

Общая статистика¶

Тип метрик: gauge.

Эти метрики помогают отслеживать текущее состояние экземпляра Tarantool, включая его время с момента запуска, режим доступа и системное время.

• tnt_cfg_current_time – системное время экземпляра в формате Unix timestamp. Используется для проверки синхронизации времени между серверами. Расхождение во времени может вызвать проблемы с репликацией и логами;

• tnt_info_uptime – время работы экземпляра в секундах. Позволяет выявить незапланированные перезапуски. Регулярный сброс значения может свидетельствовать о сбоях;

• tnt_read_only – режим доступа экземпляра. Используется для контроля режима работы экземпляра. Если мастер-сервер перешёл в read-only, это приводит к отказу в записи.

Общая статистика использования памяти¶

Тип метрик: gauge.

• tnt_info_memory_data – объем памяти в байтах, используемый для хранения данных (кортежей). Резкое увеличение значения метрики может указывать на рост объёма данных;

• tnt_info_memory_index – объем памяти в байтах, используемый для индексации данных. Увеличение значения метрики может указывать на увеличение количества индексов или их размера;

• tnt_info_memory_lua – объем памяти в байтах, используемый средой выполнения Lua-кода; Резкое увеличение значения метрики может свидетельствовать о не оптимизированном коде;

• tnt_info_memory_cache – объем памяти в байтах, используемый для кэширования данных в движке базы данных vinyl;

• tnt_info_memory_net – объем памяти в байтах, используемый для буферов сетевого ввода/вывода. Метрика важна для отслеживания потребления памяти, связанного с сетевыми операциями, такими как передача данных между узлами в кластере;

• tnt_info_memory_tx – объем памяти в байтах, используемый активными транзакциями. Эта метрика помогает отслеживать количество памяти, потребляемое в процессе выполнения транзакций;

Статистика использования памяти для распределения slab¶

Распределение slab – это ключевой механизм хранения кортежей в Tarantool. Метрики этого раздела помогают отслеживать:

• суммарное использование памяти;

• фрагментацию памяти;

• доступную и фактически занятую память.

Тип метрик: gauge.

Статистика использования памяти в конкретных спейсах¶

Все метрики, за исключением tnt_space_index_bsize, имеют два тега:

• name – имя спейса;

• engine – движок базы данных, используемый для этого спейса.

Тип метрик: gauge.

• tnt_space_bsize{name,engine} – объем памяти в байтах, который занимает спейс, включая все кортежи и ключи индексов;

• tnt_space_index_bsize{name,index_name} – объем памяти в байтах, занятый под индексы. Метрика также имеет тег index_name – название индекса;

• tnt_space_total_bsize{name,engine} – суммарный объем памяти в байтах для спейса, включая все кортежи, ключи индексов и индексы (суммарное значение tnt_space_bsize + tnt_space_total_bsize);

• tnt_vinyl_tuples{name,engine} – количество кортежей для спейса на движке vinyl. Эта метрика отключена по умолчанию и может быть включена только при настройке глобальной переменной: rawset(_G, 'include_vinyl_count', true).

Статистика сетевой активности¶

Мониторинг нагрузки сети, пиков использования и падения трафика. Метрики имеют тег thread, который отображает сетевую статистику для каждого потока.

Информация о файберах¶

Тип метрик: gauge.

• tnt_fiber_amount – общее количество активных файберов. В статистике учитываются только файберы, которые ещё не завершились. Завершённые файберы, уже очищенные сборщиком мусора, в эту метрику не попадают;

• tnt_fiber_csw – количество переключений контекста для всех активных файберов. Метрика отслеживает только файберы, которые ещё не завершились, поэтому она может становиться немонотонной, если файбер завершился и был очищен до того, как попал в статистику;

• tnt_fiber_memalloc – общий объем памяти в байтах, выделенный под файберы;

• tnt_fiber_memused – объем памяти в байтах, используемый файберами.

Статистика входящих запросов (по типу запросов)¶

Тип метрики: counter.

• tnt_stats_op_total{operation} – общее количество запросов данного типа с момента запуска экземпляра. Метрика имеет тег operation – тип входящего запроса, приходящего по бинарному протоколу. Возможные типы запроса:

  • auth – запросы на аутентификацию;

  • call – запросы на выполнение хранимой процедуры;

  • delete – запросы на удаление;

  • error – запросы, завершившиеся с ошибкой;

  • eval – запросы на выполнение Lua-кода;

  • execute – выполнение SQL-запросов;

  • insert – запросы на вставку;

  • prepare – запросы SQL prepare;

  • replace – запросы на замену;

  • select – запросы на поиск;

  • update – запросы на обновление;

  • upsert – запрос на обновление или вставку.

Информация о репликации¶

Текущий статус репликации. Тип метрик: gauge.

• tnt_info_lsn – LSN (log sequence number) , регистрационный номер в журнале данного экземпляра;

• tnt_info_vclock{id} – значение LSN из пары id: lsn в векторных часах, где id – идентификатор экземпляра в наборе реплик, lsn – регистрационный номер в журнале. Метрика имеет тег id – идентификатор экземпляра в наборе реплик;

• tnt_replication_lsn{id,type} – LSN экземпляра Tarantool. Метрика имеет теги:

  • id – идентификатор экземпляра в наборе реплик;

  • type – тип. Возможные значения: master, replica;

• tnt_replication_lag{id,stream} – значение лага репликации в секундах. Метрика имеет теги:

  • id – идентификатор экземпляра в наборе реплик;

  • stream – тип. Возможные значения: downstream, upstream;

• tnt_replication_status{id,stream} – принимает значение 1 при статусе репликации follow, иначе – 0. Значение 0 может указывать на проблемы с репликацией, например, потерю связи с мастером или сбои в сети. Метрика имеет теги:

  • id – идентификатор экземпляра в наборе реплик;

  • stream – тип. Возможные значения: downstream, upstream.

Информация о синхронной репликации¶

Текущее состояние синхронной репликации. Тип метрик: gauge.

• tnt_synchro_queue_owner – ID экземпляра, который является лидером синхронной репликации в текущий момент;

• tnt_synchro_queue_term – текущий терм очереди;

• tnt_synchro_queue_len – количество транзакций, собирающих подтверждения в текущий момент;

• tnt_synchro_queue_busy – значение 1, если очередь обрабатывает системный запрос (CONFIRM/ROLLBACK/PROMOTE/DEMOTE), иначе – 0.

Информация о выборах лидера¶

Текущее состояние узла в наборе реплик относительно выборов лидера. Тип метрик: gauge.

• tnt_election_state – состояние узла во время выборов лидера. Когда выборы включены, узел доступен для записи только в состоянии лидера. Возможные значения:

  • 0 (follower) – все узлы, не являющиеся лидерами (реплики);

  • 1 (candidate) – узлы, начавшие новый раунд выборов (кандидаты);

  • 2 (leader) – узел, набравший необходимый кворум голосов (лидер);

• tnt_election_vote – ID узла, за который голосует текущий узел. Принимает значение 0, если узел еще не проголосовал в текущем терме;

• tnt_election_leader – ID узла, который является лидером в текущем терме. Принимает значение 0, если узлу недоступна информация о лидере в текущем терме;

• tnt_election_term – текущий терм выборов;

• tnt_election_leader_idle – время в секундах с момента последнего взаимодействия с известным лидером.

Статистика использования памяти для среды выполнения Lua-кода¶

Тип метрик: gauge.

• tnt_runtime_lua – объем динамической памяти сборщика мусора в Lua в байтах;

• tnt_runtime_used – объем памяти в байтах, используемый Lua в данный момент;

• tnt_runtime_tuple – объем памяти в байтах, используемый для кортежей (кроме кортежей memtx и vinyl).

Метрики LuaJIT¶

Общая статистика JIT, работа сборщика мусора Lua и статистика выделения (аллокации) памяти.

Статистика CPU¶

Информация об использовании процессора. Метрики доступны только для Linux. Тип метрик: gauge.

• tnt_cpu_number – общее количество процессоров, сконфигурированных операционной системой;

• tnt_cpu_time – процессорное время хоста в секундах;

• tnt_cpu_thread{kind,thread_name,thread_pid,file_name} – процессорное время потока Tarantool. Метрика имеет теги:

  • kind – вид. Возможные значения: user, system;

  • thread_name – имя потока. Возможные значения: tarantool, wal, iproto, coio;

  • thread_pid – PID (process ID), идентификатор потока;

  • file_name – имя файла точки входа, например, init.lua;

• tnt_cpu_user_time – использованное пользовательское время процессора в секундах;

• tnt_cpu_system_time – использованное системное время процессора в секундах.

Статистика работы движка vinyl¶

Информация о работе движка vinyl. Тип метрик: gauge.

Статистика цикла событий¶

Информация о потоке транзакций цикла событий в момент сбора метрик. Тип метрик: gauge.

• tnt_ev_loop_time – время цикла событий в миллисекундах;

• tnt_ev_loop_prolog_time – время пролога цикла событий в миллисекундах;

• tnt_ev_loop_epilog_time – время эпилога цикла событий в миллисекундах.

Статистика памяти транзакционного менеджера memtx¶

Статистика памяти memtx MVCC. Менеджер транзакций memtx включает в себя:

• транзакции;

• механизм MVCC.

Тип метрик: gauge.

Конфигурация Tarantool¶

Информация о конфигурации Tarantool.

Тип метрик: gauge.

• tnt_config_alerts{level} – количество ошибок, возникших при применении текущей конфигурации экземпляра. Метрика имеет тег level – это уровень критичности ошибки. Возможные значения тега:

  • error – критические ошибки;

  • warn – другие ошибки;

• tnt_config_status{status, alias} – статус применения текущей конфигурации экземпляра. Метрика имеет следующие теги:

  • status – возможное имя статуса. Текущий статус имеет значение метрики 1, неактивные статусы имеют значение метрики 0;

  # HELP tnt_config_status Tarantool 3 configuration status
  # TYPE tnt_config_status gauge
  tnt_config_status{status="reload_in_progress",alias="router-001-a"} 0
  tnt_config_status{status="uninitialized",alias="router-001-a"} 0
  tnt_config_status{status="check_warnings",alias="router-001-a"} 0
  tnt_config_status{status="ready",alias="router-001-a"} 1
  tnt_config_status{status="check_errors",alias="router-001-a"} 0
  tnt_config_status{status="startup_in_progress",alias="router-001-a"} 0
  

  Например, этот набор метрик означает, что текущая конфигурация для router-001-a готова.

  • alias – имя экземпляра, на котором собирается метрика.