https://doc.ruscomtech.ru/index.php?action=history&feed=atom&title=%D0%98%D1%81%D1%82%D0%BE%D1%87%D0%BD%D0%B8%D0%BA_%D0%B4%D0%B0%D0%BD%D0%BD%D1%8B%D1%85_JMXИсточник данных JMX - История изменений2026-04-13T15:57:17ZИстория изменений этой страницы в викиMediaWiki 1.36.1https://doc.ruscomtech.ru/index.php?title=%D0%98%D1%81%D1%82%D0%BE%D1%87%D0%BD%D0%B8%D0%BA_%D0%B4%D0%B0%D0%BD%D0%BD%D1%8B%D1%85_JMX&diff=5350&oldid=prevIKuznetsov: Новая страница: «Ключ-АСТРОМ предоставляет фреймворк для создания метрик из '''wikipedia:Java_Management_Extensions|JMX MBeans...»2025-06-22T17:13:46Z<p>Новая страница: «Ключ-АСТРОМ предоставляет фреймворк для создания метрик из '''wikipedia:Java_Management_Extensions|JMX MBeans...»</p>
<p><b>Новая страница</b></p><div>Ключ-АСТРОМ предоставляет фреймворк для создания метрик из '''[[wikipedia:Java_Management_Extensions|JMX MBeans]]'''. Каждый процесс, отслеживаемый модулем кода '''Java''' ЕдиногоАгента, способен обрабатывать '''расширения JMX 2.0'''.<br />
<br />
Вам необходимо включить функцию '''Java Metric Extensions 2.0 (JMX)''' ЕдиногоАгента<br />
<br />
== Принцип работы ==<br />
'''[https://docs.oracle.com/en/java/javase/17/docs/api/java.management/javax/management/package-summary.html JMX]''' организует данные и функциональность объектно-ориентированным способом. Каждый процесс '''Java''' имеет [https://docs.oracle.com/en/java/javase/17/docs/api/java.management/java/lang/management/ManagementFactory.html#getPlatformMBeanServer сервер платформы '''MBean'''], который управляет набором объектов мониторинга, называемых '''MBeans'''.<br />
<br />
Каждый '''MBean''' имеет уникальное [https://docs.oracle.com/en/java/javase/17/docs/api/java.management/javax/management/ObjectName.html имя объекта]. Каждое имя объекта состоит из имени домена и списка ключевых свойств. Каждое ключевое свойство состоит из имени и (строкового) значения.<br />
<br />
'''JMX''' определяет стандартизированный синтаксис для записи этих имен объектов, например, <code>java.lang:type=GarbageCollector,name=YoungGen</code>. Каждый '''MBean''' имеет 0 или более атрибутов (см. [https://docs.oracle.com/en/java/javase/17/docs/api/java.management/javax/management/MBeanServer.html#getAttribute(javax.management.ObjectName,java.lang.String) MBeanServer::getAttribute]). Атрибуты могут быть любого типа '''Java''' (включая логические значения, числа и строки).<br />
<br />
Числовые атрибуты могут быть напрямую использованы для создания метрик в Ключ-АСТРОМ. Также возможно извлекать числовые значения из сложных атрибутов.<br />
<br />
== Предустановка ==<br />
Мы предполагаем следующее:<br />
<br />
* У вас есть достаточные знания в области '''JMX''' для создания расширения.<br />
* Вы знакомы с основными концепциями расширений 2.0 и общей структурой файла расширения '''YAML'''.<br />
<br />
== Поддерживаемые версии Ключ-АСТРОМ ==<br />
<br />
* Клюя-АСТРОМ версии 1.265+<br />
* ЕдиныйАгент версии 1.265+<br />
<br />
== Файл YAML с расширением JMX ==<br />
Начнем с минимального расширения JMX:<br />
{| class="wikitable"<br />
|# required extension metadata<br />
<br />
name: custom:com.example.jmx<br />
<br />
version: 1.0.0<br />
<br />
minDynatraceVersion: 1.265.0<br />
<br />
author:<br />
<br />
name: John Doe<br />
<br />
<nowiki>#</nowiki> optional metric metadata<br />
<br />
metrics:<br />
<br />
- key: com.example.jmx.thread_count<br />
<br />
metadata:<br />
<br />
displayName: Thread Count<br />
<br />
description: Number of active Java threads<br />
<br />
unit: Count<br />
<br />
<nowiki>#</nowiki> defines how to create metrics from JMX MBeans<br />
<br />
jmx:<br />
<br />
groups:<br />
<br />
- group: jvm<br />
<br />
subgroups:<br />
<br />
- subgroup: basic<br />
<br />
query: java.lang:type=Threading<br />
<br />
metrics:<br />
<br />
- key: com.example.jmx.thread_count<br />
<br />
type: gauge<br />
<br />
value: attribute:ThreadCount<br />
|}<br />
Первые две части вам уже должны быть знакомы, мы же сосредоточимся на разделе файла YAML <code>jmx</code>.<br />
<br />
Группы и подгруппы могут использоваться для совместного использования конфигурации между несколькими метриками. В нашем конкретном примере у нас есть только одна группа и одна подгруппа.<br />
<br />
== Извлечение метрик из MBeans ==<br />
Каждая подгруппа должна выбрать набор '''MBeans''', которые должны вносить вклад в метрику. Это делается с помощью поля <code>query</code> и следует стандартному [https://docs.oracle.com/en/java/javase/17/docs/api/java.management/javax/management/ObjectName.html синтаксису имени объекта '''JMX''']<br />
<br />
Здесь запрос <code>java.lang:type=Threading</code>. Он распадается на поиск компонента в домене <code>java.lang</code>, который имеет ровно одно свойство с именем <code>type</code> и значением <code>Threading</code>.<br />
<br />
Каждая подгруппа также должна определить по крайней мере одну метрику, которая должна быть извлечена из выбранных '''MBean'''. В нашем примере мы создаем метрику датчика Ключ-АСТРОМ <code>com.example.jmx.thread_count</code>, вызываемую путем запроса числового атрибута '''JMX''' <code>ThreadCount</code> из '''MBean''' <code>java.lang:type=Threading</code>.<br />
<br />
ЕдиныйАгент автоматически добавит в вашу метрику следующие измерения:<br />
<br />
* <code>dt.entity.process_group_instance</code><br />
* <code>dt.entity.process_group</code><br />
* <code>dt.entity.host</code><br />
* <code>dt.entity.container_group_instance</code><br />
* <code>dt.metrics.source</code><br />
* <code>dt.extension.config.id</code><br />
<br />
Более подробную информацию см. в [[Справка о источнике данных JMX|справочнике по источникам данных JMX]].</div>IKuznetsov