Перенос расширений JMX

Платформа расширений для JMX доступна с версии 1.213 и открывает новые возможности для визуализации и выполнения запросов к данным. Следуйте этому руководству, чтобы узнать, как использовать Visual Studio Code для автоматического преобразования расширений версии 1.0 в новый формат.

Предустановка

1. Выполните первоначальную настройку вашего редактора.
   • Для простоты в этом руководстве предполагается, что вы уже настроили редактор для первого использования. Если вы ранее не использовали Ключ-АСТРОМ Extensions для VS Code, следуйте нашему руководству по началу работы, чтобы завершить первоначальную настройку.
   • В этом руководстве предполагается, что у вас есть доступ к учётным данным разработчика. Если вы следовали руководству Начало работы, сохраните сгенерированные учётные данные в глобальных настройках VS Code. Пример показан на странице настроек.
2. Включите расширения JMX 2.0 в вашей среде Перейдите в Настройки > Предпочтения > Функции ЕдиногоАгента и включите Java Metric Extensions (JMX), затем перезапустите отслеживаемые процессы Java.

Конвертация расширения JMX в новый проект

Инициализируйте свое рабочее пространство

1. Создайте новую папку на своем компьютере и откройте ее в VS Code.
2. Нажмите F1, затем выберите команду Расширения Ключ-АСТРОМ: Инициализация рабочего пространства.
3. Далее выбираем из списка версию схемы 1.275.0
4. При появлении запроса о сертификатах выберите Использовать существующие.
5. При появлении запроса о типе проекта выберите JMX 1.0 Conversion.

Ваше рабочее пространство инициализировано, и вы готовы преобразовать старое расширение.

Конвертируйте свое расширение

1. Для конвертации необходимо загрузить расширение JMX 1.0. Вы можете найти файл .zip в локальной файловой системе или в подключённой среде Ключ-АСТРОМ. В рамках этого руководства мы сделаем последний вариант. Выберите удалённую загрузку plugin.json.
2. Теперь вам представлен список расширений вашего арендатора. Выберите, какое из них вы хотите преобразовать.
   • После выбора расширения вам может быть предложено ввести новое имя расширения, если старое слишком длинное.
3. Далее следует выбрать технологию, которая позволит автоматически настраивать страницы процессов. Выберите технологию, соответствующую вашему процессу Java. В противном случае выберите Все остальные.
4. При желании мы также можем отобразить эти данные на странице вашего хоста. Чтобы следовать этому руководству, выберите Да.

В результате преобразования будет сгенерирован новый манифест расширения в extension/extension.yaml.

Преобразование автономного расширения JMX

Если вы не хотите инициализировать новое рабочее пространство для своего проекта или уже работаете в зарегистрированном рабочем пространстве, вы можете запустить нашу автоматизацию как отдельную команду.

Нажмите F1 и выберите команду Ключ-АСТРОМ Расширения: Convert JMX. Этот рабочий процесс начинается с запроса на загрузку расширения и следует тем же шагам, что и описанные выше.

В конце ваш новый манифест будет помещен в extension/extension.yaml, или вам будет предложено указать место сохранения, если эта папка не существует в текущей открытой рабочей области.

Развертка и настройка нового расширения

Сборка и загрузка в Ключ-АСТРОМ

1. Создайте расширение, нажав F1, а затем выбрав команду Расширения Ключ-АСТРОМ: Сборка.
2. Затем выберите загрузку в Ключ-АСТРОМ, нажав Да .
3. Далее активируйте это расширение, нажав Да .

Добавить конфигурацию мониторинга

1. Откройте расширение либо из командной строки, либо из меню Расширения в Ключ-АСТРОМ.
2. Добавьте конфигурацию мониторинга, нажав на соответствующую кнопку.
3. Выберите хост, на котором запущен ваш процесс Java, затем нажмите Следующий шаг.
4. На следующей странице еще раз нажмите Следующий шаг, затем добавьте описание и нажмите Активировать.

После активации конфигурации мониторинга сбор данных начинается автоматически.

Найдите данные вашего расширения

Откройте страницу сведений об одном из хостов, на котором запущен отслеживаемый процесс Java. Вы увидите карточку (внизу) с заголовком, начинающимся с JMX Metrics.

На этой карточке выберите любой из перечисленных процессов. Затем нажмите ... и выберите Анализ метрик и логов.

На открывшейся странице вы увидите несколько карточек из вашего расширения.

Карточки на странице Процесс добавляются только в том случае, если вы выбрали технологию во время преобразования.