JMX коннектор#

JMX коннектор позволяет получать информацию о JMX (Java Management Extensions) всех узлов кластера CedrusData. JMX предоставляет информацию о Java-процессах в которых запущены узлы CedrusData. Данный функционал полезен для мониторинга и выявления различных проблем с кластером.

Коннектор так же может быть сконфигурирован для периодической выгрузки JMX информации и ее сохранении в памяти.

Конфигурация#

Для конфигурации JMX коннектора, создайте в директории etc/catalog файл <имя_каталога>.properties. Например, для создания каталога my_jmx необходимо создать файл my_jmx.properties. Добавьте в файл следующее содержимое:

connector.name=jmx

Для включения периодической выгрузки JMX информации добавьте следующие параметры (в качестве примера использованы таблицы java.lang:type=Runtime и trino.execution.scheduler:name=NodeScheduler):

connector.name=jmx
jmx.dump-tables=java.lang:type=Runtime,trino.execution.scheduler:name=NodeScheduler
jmx.dump-period=10s
jmx.max-entries=86400

dump-tables это разделенный запятыми список названий Managed Beans (MBean), который указывает, какие состояние каких MBeans будет считано. Периодичность сохранения в памяти определена параметром dump-period. Размер истории состояний ограничен параметром max-entries. Параметры dump-period и max-entries имеют значения по умолчанию 10s и 86400, соответственно.

Запятые в названиях MBeans должны быть экранированы (escape) c помощью двойного символа \:

connector.name=jmx
jmx.dump-tables=trino.memory:name=general\\,type=memorypool,trino.memory:name=reserved\\,type=memorypool

Удвоение символа \ обусловлено тем, что одиночный символ \ используется для обозначения переноса строки:

connector.name=jmx
jmx.dump-tables=trino.memory:name=general\\,type=memorypool,\
    trino.memory:name=reserved\\,type=memorypool

Работа с JMX коннектором#

JMX коннектор имеет две схемы.

Схема current содержит все MBeans каждого узла кластера CedrusData. Используйте команду SHOW TABLES для отображения всех доступных MBeans:

SHOW TABLES FROM jmx.current;

Имена MBeans могут содержать нестандартные для имен таблиц символы. Поэтому для обращения к таблице соответствующего MBean следует использовать двойные кавычки. Так, следующий запрос отображает версии JVM для каждого узла:

SELECT node, vmname, vmversion
FROM jmx.current."java.lang:type=runtime";
                 node                 |              vmname               | vmversion
--------------------------------------+-----------------------------------+-----------
 ddc4df17-0b8e-4843-bb14-1b8af1a7451a | Java HotSpot(TM) 64-Bit Server VM | 24.60-b09
(1 row)

Следующий запрос отображает информацию о файловых дескрипторах для каждого узла:

SELECT openfiledescriptorcount, maxfiledescriptorcount
FROM jmx.current."java.lang:type=operatingsystem";
 openfiledescriptorcount | maxfiledescriptorcount
-------------------------+------------------------
                     329 |                  10240
(1 row)

Символ * может быть использован совместно с именем таблицы в схеме current, позволяя опрашивать несколько MBeans в одном запросе. Следующий запрос отображает информацию обо всех доступных пулов памяти (memory pool) в кластере:

SELECT freebytes, node, object_name
FROM jmx.current."trino.memory:*type=memorypool*";
 freebytes  |  node   |                       object_name
------------+---------+----------------------------------------------------------
  214748364 | example | trino.memory:type=MemoryPool,name=reserved
 1073741825 | example | trino.memory:type=MemoryPool,name=general
  858993459 | example | trino.memory:type=MemoryPool,name=system
(3 rows)

Схема history содержит список таблиц, для которых сконфигурирована периодическая выгрузка. Исторические таблицы содержат все те же колонки, что и оригинальные таблицы, а так же дополнительную колонку timestamp, которая отображает время, в которое была произведена выгрузка:

SELECT "timestamp", "uptime" FROM jmx.history."java.lang:type=runtime";
        timestamp        | uptime
-------------------------+--------
 2016-01-28 10:18:50.000 |  11420
 2016-01-28 10:19:00.000 |  21422
 2016-01-28 10:19:10.000 |  31412
(3 rows)

Поддержка SQL команд#

Коннектор поддерживает общие команды и команды чтения данных.