IKuznetsov: Новая страница: «[https://www.graalvm.org/latest/getting-started/ GraalVM Native Image] разработан для достижения высокой производитель...»

2025-07-23T16:04:33Z

Новая страница: «[https://www.graalvm.org/latest/getting-started/ GraalVM Native Image] разработан для достижения высокой производитель...»

Новая страница

[https://www.graalvm.org/latest/getting-started/ GraalVM Native Image] разработан для достижения высокой производительности при запуске приложений, написанных на '''Java''' и других языках, путём предварительной компиляции кода '''Java''' в нативные образы. Скомпилированные с помощью '''AOT''' нативные образы содержат только необходимый во время выполнения код '''Java''' и исключают всё остальное из библиотек и фреймворков.

Ключ-АСТРОМ обеспечивает сквозную распределенную трассировку для ваших нативных приложений '''Java''', предварительно скомпилированных в виде образа '''GraalVM Native Image''', работающих в виртуализированных, контейнеризированных и '''K8s'''-средах. Ключ-АСТРОМ автоматически обнаруживает службы ваших нативных приложений '''Java''' и визуализирует их зависимости от веб-сайта до контейнеров, инфраструктуры и облака. Ключ-АСТРОМ диагностирует аномалии в режиме реального времени с помощью ИИ и определяет первопричину, вплоть до неисправного кода. Метрики производительности дают представление об использовании памяти, сборке мусора и потоках.

Поддерживаемые технологии распределенной трассировки см. в разделе [[Поддержка технологий|Java Native Image]] .

Для наблюдения за Ключ-АСТРОМ '''GraalVM Native Image''' требуется лицензия '''Full-Stack Monitoring''' .

== Начать ==
Модуль Ключ-АСТРОМ '''GraalVM Native Image''' состоит из модуля сборки и модуля времени выполнения . Модуль времени сборки должен присутствовать во время сборки '''Native Image'''. Модуль времени выполнения должен присутствовать при запуске '''Native Image''' для сбора телеметрических данных.

* Для обеспечения совместимости оба модуля должны быть одной и той же версии.
* Никаких изменений в коде вашего приложения вносить не требуется.

=== Интегрируйте Ключ-АСТРОМ в свой проект ===

==== Проекты Maven ====
Интеграция Ключ-АСТРОМ в проект Maven

1. Добавьте в ваш файл <code>pom.xml</code> следующее :
{| class="wikitable"
|<profile>

<id>astromkey-native</id>

<build>

<plugins>

<plugin>

<groupId>com.astromkey.buildtools.graalnative</groupId>

<artifactId>astromkey-native-maven-plugin</artifactId>

<version>2.0.1</version>

<executions>

<execution>

<goals>

<goal>setup-build-agent</goal>

<goal>copy-runtime-agent</goal>

</goals>

<configuration>

<agentDownload>

<environmentUrl>ENVIRONMENT_URL</environmentUrl>

<apiToken>API_TOKEN</apiToken>

</agentDownload>

</configuration>

</execution>

</executions>

<extensions>true</extensions>

</plugin>

</plugins>

</build>

</profile>
|}
Замените <code>ENVIRONMENT_URL</code>и <code>API_TOKEN</code> в соответствии с вашей средой Ключ-АСТРОМ:

* <code>ENVIRONMENT_URL</code>— это URL-адрес среды мониторинга Ключ-АСТРОМ .
* <code>API_TOKEN</code>— это ваш токен доступа, который может быть предоставлен, например, с помощью переменной среды <code><apiToken>${env.DT_API_TOKEN}</apiToken></code>. Для этого токена доступа требуется область загрузки PaaS-интеграции — установщик . Чтобы узнать, как сгенерировать токен, см. раздел [[Токен доступа|Сгенерировать токен доступа]].

Это автоматически загрузит и использует последнюю версию модуля '''GraalVM Native Image''', доступную в вашей среде. Чтобы использовать конкретную версию модуля '''GraalVM Native Image''', добавьте <code><agentVersion>AGENT_VERSION</agentVersion></code> в конфигурацию <code>agentDownload</code>.

Кроме того, вы также можете вручную загрузить модуль GraalVM Native Image и использовать
{| class="wikitable"
|<configuration>

<agentZip>PATH_TO_DOWNLOADED_ZIP</agentZip>

</configuration>
|}
Чтобы настроить плагин Ключ-АСТРОМ, замените <code>PATH_TO_DOWNLOADED_ZIP</code> абсолютным или относительным путём к загруженному ZIP-файлу.

2. Запустите <code>mvnw package -Pnative -Pastromkey-native</code>. Это позволит создать образ '''Native''', включающий Ключ-АСТРОМ. Профиль <code>native</code> добавляет [https://graalvm.github.io/native-build-tools/latest/maven-plugin.html#configuration-registering-plugin плагин '''Maven''' для сборки образа '''GraalVM Native'''] .

Как правило, полученный '''Native Image''' будет доступен в папке <code>target</code>. Помимо '''Native Image''', там будет папка <code>astromkey</code>. Она необходима для мониторинга во время выполнения. Если вы хотите запустить '''Native Image''' на другом компьютере, скопируйте папку <code>astromkey</code> вместе с '''Native Image'''.

==== Проекты Gradle ====
{| class="wikitable"
|Предустановка

* Gradle 8.4+ работает на поддерживаемой JVM или собственном образе Java версии 17+.
* К вашему проекту <code>org.graalvm.buildtools:native-gradle-plugin</code> применен плагин Gradle версии 0.10+.
|}
Интеграция Ключ-АСТРОМ в проект Gradle

1. Добавьте следующий код в <code>settings.gradle</code>:
{| class="wikitable"
|pluginManagement {

repositories {

mavenCentral()

}

}
|}
Добавьте следующий код в <code>build.gradle</code>:
{| class="wikitable"
|plugins {

id 'com.astromkey.buildtools.graalnative' version '2.0.0'

}

astromkey {

agentDownload {

environmentUrl = "ENVIRONMENT_URL"

apiToken = "API_TOKEN"

}

}
|}
Замените <code>ENVIRONMENT_URL</code> и <code>API_TOKEN</code> в соответствии с вашей средой Ключ-АСТРОМ:

* <code>ENVIRONMENT_URL</code>— это URL-адрес среды мониторинга Ключ-АСТРОМ .
* <code>API_TOKEN</code>— это ваш токен доступа, который может быть предоставлен, например, с помощью переменной среды <code>System.getenv("DT_API_TOKEN")</code>. Для этого токена доступа требуется область загрузки PaaS-интеграции — установщик . Чтобы узнать, как сгенерировать токен, см. раздел [[Токен доступа|Сгенерировать токен доступа]].

Это автоматически загрузит и использует последнюю версию модуля '''GraalVM Native Image''', доступную в вашей среде. Чтобы использовать конкретную версию модуля '''GraalVM Native Image''', добавьте <code>agentVersion = "AGENT_VERSION"</code> в конфигурацию <code>agentDownload</code>.

Кроме того, вы также можете вручную загрузить модуль '''GraalVM Native Image''' и использовать
{| class="wikitable"
|astromkey {

agentZip = "PATH_TO_DOWNLOADED_ZIP"

}
|}
Чтобы настроить плагин Ключ-АСТРОМ, замените <code>PATH_TO_DOWNLOADED_ZIP</code> абсолютным или относительным путём к загруженному ZIP-файлу.

3. Запустите <code>gradlew astromkeyNativeCompile</code> для создания собственного образа, включая Ключ-АСТРОМ.

Как правило, полученный '''Native Image''' находится в папке <code>build/native/nativeCompile</code>. Помимо '''Native Image''', эта папка содержит папку <code>astromkey</code>. Она необходима для мониторинга во время выполнения. Если вы хотите запустить '''Native Image''' на другом компьютере, скопируйте папку <code>astromkey</code> вместе с '''Native Image'''.

==== Ручная загрузка модуля GraalVM Native Image ====
Вы также можете вручную загрузить модуль '''GraalVM Native Image''' из Ключ-АСТРОМ ЕдиныйАгент Deployment API для вашей целевой платформы.

Пример вызова '''API''' с использованием <code>curl</code>:
{| class="wikitable"
|curl -X GET "$DT_TENANT_URL/api/v1/deployment/installer/agent/$OS_TYPE/paas/latest?flavor=default&arch=$ARCH&bitness=64&include=java-graal-native&skipMetadata=true" -H "accept: application/octet-stream" -H "Authorization: Api-Token $DT_API_TOKEN" -o agent.zip
|}

Замените <code>$DT_TENANT_URL</code>, <code>$OS_TYPE</code>, <code>$ARCH</code>, и <code>$DT_API_TOKEN</code> значениями вашей среды Ключ-АСТРОМ.

* <code>$DT_TENANT_URL</code>— это URL-адрес вашей среды Ключ-АСТРОМ.
* <code>$OS_TYPE</code> может быть <code>unix</code> или <code>windows</code>.
* <code>$ARCH</code> может быть <code>x86</code> или <code>arm</code>, тогда как <code>arm</code> доступно только для типа ОС <code>unix</code>.
* <code>$DT_API_TOKEN</code> ваш токен доступа, связанный с интеграцией PaaS — область загрузки установщика. Чтобы узнать, как сгенерировать токен, см. раздел [[Токен доступа|Сгенерировать токен доступа]].

=== Активировать наблюдаемость Ключ-АСТРОМ ===
Если у вас уже установлен ЕдиныйАгент или вы используете Ключ-АСТРОМ '''Operator''' для '''Kubernetes''', данные подключения Ключ-АСТРОМ применяются автоматически и активируется возможность наблюдения за собственным образом '''GraalVM'''.

Чтобы активировать функцию наблюдения Ключ-АСТРОМ во время выполнения, определите параметры подключения Ключ-АСТРОМ с помощью переменных среды <code>DT_TENANT</code>, <code>DT_TENANTTOKEN</code>, и <code>DT_CONNECTION_POINT</code>. Пример для Ключ-АСТРОМ SaaS:
{| class="wikitable"
|export DT_TENANT=$DT_TENANT_ID

export DT_TENANTTOKEN=$DT_TENANTTOKEN

export DT_CONNECTION_POINT=$DT_CONNECTION_POINT

./$YOUR_APP_NAME
|}

Замените <code>$DT_TENANT_ID</code>, <code>$DT_TENANTTOKEN</code>, и <code>$DT_CONNECTION_POINT</code> данными вашего подключения Ключ-АСТРОМ. Замените <code>$YOUR_APP_NAME</code> именем вашего приложения.

Вы можете получить данные о подключении, выполнив команду '''Просмотр информации о подключении для вызова API ЕдиногоАгента'''. В ответе необходимо указать следующие поля:

* '''tenantUUID''' для <code>$DT_TENANT_ID</code>
* '''tenantToken''' для <code>$DT_TENANTTOKEN</code>
* '''communicationEndpoints''' для <code>$DT_CONNECTION_POINT</code>

== Конфигурация плагина ==

=== Плагин Maven ===
Плагин Maven настраивается через профиль <code>astromkey-native</code> в файле <code>pom.xml</code>. Например:
{| class="wikitable"
|<configuration>

<agentDownload>

<environmentUrl>${env.DT_TENANT_URL}</environmentUrl>

<apiToken>${env.DT_API_TOKEN}</apiToken>

</agentDownload>

<agentOptions>loglevelcon=info</agentOptions>

</configuration>
|}

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

* <code>agentDownload</code> используется для настройки автоматической загрузки модуля '''GraalVM Native Image''':
** <code>environmentUrl</code> указывает URL-адрес среды мониторинга Ключ-АСТРОМ .
** <code>apiToken</code> указывает токен доступа с интеграцией PaaS — область загрузки установщика. Чтобы узнать, как сгенерировать токен, см. раздел [[Токен доступа|Сгенерировать токен доступа]].
** <code>agentVersion</code> указывает версию модуля '''GraalVM Native Image'''. Если не указано, используется последняя версия модуля '''GraalVM Native Image'''.
* <code>agentZip</code> задает абсолютный или относительный путь к загруженному вручную ZIP-файлу.
* <code>agentOptions</code> определяет параметры модуля времени сборки Ключ-АСТРОМ (необязательно).

Доступны следующие варианты <code>agentOptions</code>:

* <code>loglevelcon</code> устанавливает уровень ведения журнала консоли. Возможные значения: <code>off</code> (по умолчанию), <code>severe</code>, <code>warning</code>, и <code>info</code>.
* <code>agentconfigpath</code> задает абсолютный путь к файлу конфигурации '''JSON''' (см. следующий раздел).

=== Плагин Gradle ===
Плагин '''Gradle''' настраивается через блок <code>astromkey</code> в <code>build.gradle</code>. Например:
{| class="wikitable"
|astromkey {

agentDownload {

environmentUrl = System.getenv("DT_TENANT_URL")

apiToken = System.getenv("DT_API_TOKEN")

}

agentOptions="loglevelcon=info"

}
|}

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

* <code>agentDownload</code> используется для настройки автоматической загрузки модуля '''GraalVM Native Image''':
** <code>environmentUrl</code> указывает URL-адрес среды мониторинга Ключ-АСТРОМ .
** <code>apiToken</code> указывает токен доступа с интеграцией PaaS — область загрузки установщика. Чтобы узнать, как сгенерировать токен, см. раздел [[Токен доступа|Сгенерировать токен доступа]].
** <code>agentVersion</code> указывает версию модуля '''GraalVM Native Image'''. Если не указано, используется последняя версия модуля '''GraalVM Native Image'''.
* <code>agentZip</code> задает абсолютный или относительный путь к загруженному вручную ZIP-файлу.
* <code>agentOptions</code> определяет параметры модуля времени сборки Ключ-АСТРОМ (необязательно).

Доступны следующие варианты <code>agentOptions</code>:

* <code>loglevelcon</code> устанавливает уровень ведения журнала консоли. Возможные значения: <code>off</code> (по умолчанию), <code>severe</code>, <code>warning</code>, и <code>info</code>.
* <code>agentconfigpath</code> задает абсолютный путь к файлу конфигурации '''JSON''' (см. следующий раздел).

== Конфигурация модуля GraalVM Native Image ==

=== Модуль времени сборки ===
Модуль сборки Ключ-АСТРОМ предварительно настроен с рекомендуемыми настройками. При необходимости вы можете переопределить значения по умолчанию с помощью '''JSON'''-файла конфигурации во время сборки. Например:
{| class="wikitable"
|{

"enabledSensors": [

"servlet"

]

}
|}
Доступны следующие (точки контроля) <code>enabledSensors</code>:

* <code>servlet</code>: Входящие HTTP-запросы через Servlet API
* <code>netty</code>: Входящие HTTP-запросы через Netty
* <code>httpclient</code>: Исходящие HTTP-запросы
* <code>threading</code>: Распространение контекста для потоков и исполнителей
* <code>mongo</code>: Вызовы базы данных MongoDB

Чтобы отключить, удалите <code>enabledSensors</code> из списка.

=== Модуль выполнения ===

==== Режим FIPS ====
Режим '''FIPS''' по умолчанию отключен. Чтобы включить режим '''FIPS''' для модуля среды выполнения, удалите файл <code>agent/dt_fips_disabled.flag</code> в папке <code>astromkey</code> рядом с исходным образом.

== Известные ограничения ==
Ожидается, что в версиях '''GraalVM 17.0.12+''', '''21.0.4+''' и '''22.0.2+''' это больше не понадобится.

Если вы используете '''Spring RestTemplate''' и получаете несвязанные трассировки, попробуйте следующий обходной путь.

=== Проекты Maven ===
Настройте в вашем файле <code>pom.xml</code>:
{| class="wikitable"
|<jvmArgs>

<arg>--add-opens=java.base/sun.net.www.protocol.http=ALL-UNNAMED</arg>

<arg>--add-opens=java.base/java.net=ALL-UNNAMED</arg>

<arg>--add-exports=java.base/sun.net.www=ALL-UNNAMED</arg>

</jvmArgs>
|}
Для справки см. [https://graalvm.github.io/native-build-tools/latest/maven-plugin.html#configuration-options плагин Maven для построения образа GraalVM Native].

=== Проекты Gradle ===
Настройте в вашем файле <code>build.gradle</code>:
{| class="wikitable"
|graalvmNative {

binaries {

main {

jvmArgs.addAll(

'--add-opens', 'java.base/sun.net.www.protocol.http=ALL-UNNAMED',

'--add-opens', 'java.base/java.net=ALL-UNNAMED',

'--add-exports', 'java.base/sun.net.www=ALL-UNNAMED'

)

}

}

}
|}

GraalVM Native Image - История изменений

IKuznetsov: Новая страница: «[https://www.graalvm.org/latest/getting-started/ GraalVM Native Image] разработан для достижения высокой производитель...»