Установка Java-агента

Следуйте приведённым ниже шагам для установки Java-агента.

1. Нажмите «Новое приложение» (New Application) в правом верхнем углу страницы «Обзор» (Overview).

2. Загрузите соответствующий агент и нажмите «Далее» (Next).

3. В соответствии с инструкцией вы можете выбрать автоматическую или ручную установку.

1) Автоматическая установка (поддерживаются JBoss, GlassFish, Jetty и Tomcat)

Выберите среду вашей системы: Windows, Linux или Mac.

a. Windows:

ОткройтеAltynview-agent-java.zip

Скопируйте каталог Altynview в корневой каталог сервера приложений.

Выполните в командной строке следующие команды:

cd Altynview

java -jar Altynview-agent-java.jar install

b. Linux or Mac

Распакуйте установочный пакет в корневой каталог сервера приложений:

 unzip Altynview-agent-java-lastest.zip -d /path/to/appserver/

Перейдите в каталог Altynview и выполните автоматический установщик:

cd /path/to/appserver/Altynview

java -jar Altynview-agent-java.jar install

2）Ручная установка

Распакуйте установочный пакет в корневой каталог сервера приложений (рекомендуется) либо укажите каталог для хранения директории Altynview и файла Altynview.properties. </ br>
Добавьте следующую строку в скрипт запуска сервера приложений:

-javaagent:/path/to/Altynview/Altynview-agent-java.jar

4. После завершения установки подождите около 5 минут. Когда данные начнут поступать в систему Altynview Server, ваше приложение появится в списке приложений на странице «Обзор» (Overview).

5. Если в течение нескольких минут вы не видите данные производительности приложения, возможно, установка выполнена некорректно. Вы можете получить помощь следующими способами:

1）Выполнить ручную установку, запустить скрипты развертывания и ознакомиться с документом ; «Java agent installation documentation»

2）Обратиться в техническую поддержку:support@networkbench.com

Настройка пользовательской установки вручную в XML-файле:

1. Обзор

Java-агент поддерживает пользовательский мониторинг в виде XML-файлов. Каждый XML-файл является базовой единицей, из которой Java-агент считывает пользовательские конфигурации. Чтобы XML-файл конфигурации вступил в силу, его необходимо поместить в каталог extensions в корневом каталоге Java-агента. В этом каталоге может одновременно находиться несколько конфигурационных файлов, и все они будут считаны. Если метод класса настроен несколько раз, будет применена конфигурация, считанная первой. Не рекомендуется повторно задавать правила для одних и тех же методов. В версиях агента начиная с 2016 года данный каталог создаётся автоматически. Если каталог отсутствует или был удалён, его можно создать вручную. Структура каталогов выглядит следующим образом:

2. Структура и элементы XML-файла

Базовая структура документа пользовательского мониторинга выглядит следующим образом:

Элементы документа пользовательского мониторинга:

instrumentation: Набор конфигураций. Базовый элемент пользовательского мониторинга. Может содержать несколько точек конфигурации.

pointcut: Точка конфигурации, используется для настройки класса или интерфейса. Может содержать элементы className, interfaceName, method.

className/interfaceName: Имя целевого класса или интерфейса. Значение указывается в виде имя пакета + имя класса.

method：Целевой метод мониторинга. Может настраиваться по типу возвращаемого значения, типам параметров или как метод без параметров. Может содержать элементы parameters и returnType.

parameters: Формальные параметры целевого метода. Можно настроить от 0 до нескольких параметров, каждый параметр задаётся внутри тега type.

returnType：Тип возвращаемого значения целевого метода. Может быть указан только один. Тип может быть примитивным или объектным.

Примечание: Примитивные типы данных: byte, short, int, long, float, double, boolean, char. Для остальных типов необходимо указывать полное имя класса, например: com.Altynview.test.Person, java.lang.String.

3. Пример конфигурации

В приведённом ниже примере пользовательская конфигурация мониторинга, заданная на стороне отчётов в консоли, преобразуется в XML-конфигурацию. Эффект эквивалентен. Поскольку конфигурация относится к демонстрационному приложению и включает интерфейсы, сущностные классы и бизнес-логику, вы можете обратиться к разделу использования консоли [custom embed code] (http://help.Altynview.com:81/server/html/ Zidingyifangfajiankong.html), Здесь данный материал подробно не рассматривается.

Расширенная XML-конфигурация:

В приведённом выше примере XML-конфигурации вы можете увидеть дополнительные параметры в тегах pointcut и instrumentation, такие как actionStartPoint, metricPrefix. Ниже приведено краткое описание этих параметров.

metricPrefix：Методы, настроенные в текущем XML-файле, будут отнесены к категории, указанной в metricPrefix. Сценарий использования: классифицировать серию методов текущей XML-конфигурации как бизнес A, а методы другого XML-файла — как бизнес B. Таким образом, в отчётах можно увидеть производительность методов, сгруппированных по бизнесу.
Значение по умолчанию: metricPrefix = Custom.

actionStartPoint：Используется для пометки метода как отдельного действия (background action или web action), В некоторых open-source компонентах или фреймворках, которые плохо поддерживаются Java-агентом, отдельные методы могут представлять бизнес-запрос, но не иметь родительского Action. При установке actionStartPoint = true, текущий метод будет помечен как Action.

excludeFromActionTrace: При значении true трассировка Action не будет содержать текущий метод пользовательского мониторинга, и связанные с ним данные производительности не будут отображаться на странице деталей трассировки в отчётах. Значение по умолчанию Default excludeFromActionTrace = false.

ignoreAction: При значении true данные производительности текущего Web Action не будут собираться, и Web Action, вызвавший метод, не будет отображаться в процессе веб-приложения на стороне отчётов. Значение по умолчанию: ignoreAction = false.

<NameAction />: <nameAction /> позволяет использовать имя текущего метода в формате WebAction + className + methodName в качестве имени Web Action. Примеры приведены ниже: