== Основные элементы Ключ-Астром ==
*[[Ключ-АСТРОМ Managed]]
* [[ЕдиныйАгент Ключ-АСТРОМ]]
* [[АктивныйШлюз Ключ-АСТРОМ]]
* [[Сетевые зоны]]
* [[Интеграции]]
*[[Уведомления]]

== <big>Ключ-Астром разворачивается на</big> ==
* Облачных платформах
** [[AWS]]
** Azure
***[[Интеграция ЕдиногоАгента в службу приложений Azure]]
** Google Cloud Platform
** VMware
** Heroku

* Контейнерных платформах
** [[Kubernetes/OpenShift]]
***[[Запуск мониторинга Kubernetes/OpenShift]]
***Включение API мониторинга
****[[Подключение своих кластеров Kubernetes/OpenShift к Ключ-АСТРОМ]]
***[[Предупреждение об общих проблемах Kubernetes / OpenShift]]
** [[Настройка Ключ-АСТРОМ на Cloud Foundry|Cloud Foundry]]
***[[Развёртка ЕдиногоАгента на Pivotal Web Services для мониторинга только приложений]]
** Docker
** Mesos

* Операционных системах
** AIX
** Linux (в том числе Astra Linux (Orel 2.12), RED OS (MUROM 7.2)
**Solaris
**Windows
**zOS
----
* Не удается установить ЕдиныйАгент на серверы приложений? Попробуйте безагентный мониторинг или расширение для браузера Real User Monitoring.
* Мониторите традиционное клиент-серверное приложение или Интернет вещей? Используйте Ключ-АСТРОМ OpenKit.
* Вам нужно круглосуточно контролировать доступность и производительность ваших приложений из любой точки мира? Установите синтетический мониторинг.

Файл:Managed-general-architecture-1892-448d089eed.png

2023-01-22T12:20:41Z

Lobanov:

Установка ЕдиногоАгента с помощью Puppet

2023-01-11T14:42:58Z

Lobanov: Новая страница: «<code>Предварительный просмотр</code> Ключ-АСТРОМ предоставляет модуль Puppet, который можно ис...»

<code>Предварительный просмотр</code>

Ключ-АСТРОМ предоставляет модуль Puppet, который можно использовать для организации развертывания ЕдиногоАгента в вашей среде. Модуль ЕдиногоАгента Puppet выпущен в виде предварительной версии.

== Требования ==

* Puppet 6.0+
* ЕдиныйАгент версии 1.199+
* Ключ-АСТРОМ версии 1.204+
* Сценарий доступа к файлам установщика ЕдиногоАгента

== Зависимости ==

* puppet/archive
* puppetlabs/powershell (for Windows deployment)
* puppetlabs/reboot

== Скачать модуль ЕдиногоАгента Puppet ==
1. Выберите «'''Развернуть Ключ-АСТРОМ'''» в меню навигации, а затем выберите «'''Начать установку'''».

2. Выберите '''модуль Puppet''', чтобы загрузить архив модуля.

Это безопасный архив, размещенный в вашей среде Ключ-АСТРОМ. Поместите полученный артефакт на свой серверный узел.

3. необязательно В Linux вы можете проверить подлинность архива, используя отдельно предоставленный файл подписи:

* Выберите '''Подпись''', чтобы загрузить файл <code>sig</code>.
* Убедитесь, что загруженный tar-архив модуля Puppet и файл подписи хранятся в одном каталоге.
* Перейдите в каталог, в котором вы сохранили файлы, и выполните следующую команду, заменив имена файлов фактическими именами загруженных файлов:

== Установите модуль Puppet ЕдиногоАгента ==
1. Сохраните tar-архив модуля в каталог на узле вашего сервера.

2. Чтобы установить модуль ASTROM-key/oneagent, перейдите в каталог, в котором вы сохранили tar-архив модуля, и выполните следующую команду:
puppet module install ASTROM-key-oneagent-puppet-1.0.0.20200101-060000.tar.gz
Модуль развертывает ЕдиныйАгент с использованием специальной конфигурации. Конфигурация гарантирует, что служба ЕдиногоАгента остается в рабочем состоянии. Дополнительные сведения см. в документации модуля Puppet.

== Настройка модуля Puppet ЕдиногоАгента ==
Модулю Puppet ЕдиногоАгента требуется доступ к соответствующим файлам установки ЕдиногоАгента.

* Если ваш серверный узел Puppet имеет доступ к вашей среде Ключ-АСТРОМ, вы можете настроить модуль для загрузки файлов установщика непосредственно из среды Ключ-АСТРОМ.
* Кроме того, вы можете самостоятельно загрузить файлы установщика с помощью веб-интерфейса Ключ-АСТРОМ и загрузить их на узел сервера. Это обеспечивает сценарий локальными копиями установщиков.

=== Вариант 1. Используйте прямую загрузку из среды Ключ-АСТРОМ. ===
Модуль использует Ключ-АСТРОМ Deployment API для загрузки установщиков для конкретной платформы на узлы агента Puppet. Вам нужно будет указать переменные для предоставления информации, необходимой для аутентификации вызова API в вашей среде:

* <code>environment_url</code>:
** '''Ключ-АСТРОМ SaaS''': <code><nowiki>https://{your-environment-id}.live.ruscomtech.ru</nowiki></code>
** '''Ключ-АСТРОМ''' '''Managed''': <code><nowiki>https://{ваш-домен}/e/{идентификатор-вашей-среды}</nowiki></code>
* <code>paas_token</code>
** Токен '''PaaS''' вашей среды

Например:
class { 'oneagent':
# Set environment variables
paas_token => 'abcdefjhij1234567890',
environment_url => '<nowiki>https://your-environment.live.ruscomtech.ru'</nowiki>,
# (...)
}
Дополнительные примеры см. в разделе Примеры.

=== Вариант 2. Используйте локальные установщики ===
Используйте веб-интерфейс Ключ-АСТРОМ для загрузки необходимых файлов установщика ЕдиногоАгента, а затем загрузите их в соответствующую точку подключения на узле сервера. Затем модуль Puppet загрузит установщики с сервера Puppet на узлы агента Puppet.

Используйте переменную local_installer, чтобы предоставить модулю путь к установщику в указанной точке монтирования. Для этого требуется настроенный файловый сервер на узле сервера.

Например:
class { 'oneagent':
# Set environment variables
local_installer => mounting_point/path/of/oneagent-linux-installer.sh
# (...)
}
Обратите внимание, что для Windows, Linux и AIX требуются специальные программы установки. Исходные имена установщиков, загруженные с Ключ-АСТРОМ, включают обозначения целевых платформ. Если вы меняете имена установщиков, убедитесь, что модуль может их различать.

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

== Переменные ==
Модуль Puppet ЕдиногоАгента поддерживает следующие переменные:
{| class="wikitable"
!Название
!Значение по умолчанию
!Описание
|-
|<code>environment_url</code>
|unset
|URL целевой среды Ключ-АСТРОМ (SaaS или Managed).
|-
|<code>paas_token</code>
|unset
|Токен PaaS, полученный со страницы установщика '''Развернуть''' '''Ключ-АСТРОМ'''.
|-
|<code>local_installer</code>
|unset
|Путь к установщику ЕдиногоАгента в настроенной точке подключения.
|-
|<code>installer_arch</code>
|unset
|Архитектура установщика ЕдиногоАгента
|-
|<code>version</code>
|<code>latest</code>
|Требуемая версия ЕдиногоАгента в виде <code>1.199.247.20200714-111723</code>. Дополнительные сведения см. в разделе, как составить список доступных версий установщика ЕдиногоАгента.
|-
|<code>download_dir</code>
|Linux/AIX: <code>$TEMP</code> or <code>/tmp</code>
Windows: <code>%TEMP%</code> or <code>C:\Windows\Temp</code>
|Каталог загрузки установщика. Каталог должен быть доступен модулю. Для Linux и AIX каталог не должен содержать пробелов.
|-
|<code>install_args</code>
|unset
|Параметры установки ЕдиногоАгента Ключ-АСТРОМ, определенные в виде списка элементов.
|-
|<code>platform_install_args</code>
|unset
|Дополнительный список параметров установки для конкретной платформы, добавляемый к `install_args' при запуске на соответствующей платформе.
|-
|<code>preserve_installer</code>
|<code>false</code>
|Возможность сохранить установщик на узле агента Puppet после развертывания.
|-
|<code>package_state</code>
|<code>present</code>
|Желаемое состояние пакета ЕдиногоАгента. Укажите <code>present</code> (текущую) или '''<code>latest</code>''' (последнюю) версию для установки. Укажите '''<code>absent</code>''' для удаления.
|-
|<code>validate_certs</code>
|<code>true</code>
|Возможность требовать сертификаты. Если установлено значение <code>false</code>, позволяет загружать ЕдиныйАгент с сервера с небезопасным SSL-сертификатом (истекшим сроком действия, самоподписанным и т. д.).
|-
|<code>proxy_server</code>
|unset
|Прокси-сервер, который будет использоваться для загрузки установщика ЕдиногоАгента.
|}

== Логирование ==
По умолчанию Puppet записывает сообщения в системный журнал (для хостов на базе Linux) или в журнал событий (для хостов на базе Windows). Однако Puppet можно настроить для хранения журналов, относящихся к конкретному развертыванию, в определенных файлах.

* Для Puppet Server вы можете настроить место ведения журнала, отредактировав файл /etc/puppetlabs/puppetlabs/logback.xml и заменив места, на которые указывают элементы <file>:

(...)
<appender name="F1" class="ch.qos.logback.core.FileAppender">
<file>/new/log/location</file>
(...)
Дополнительные сведения см. в разделе Конфигурация журнала.

* Для агентов Puppet отредактируйте файл puppet.conf и добавьте ключ файла журнала:

(...)
logdest=absolute_path_of_log_location.log
(...)
Расположение файла конфигурации зависит от операционной системы:

* <code>/etc/puppetlabs/puppet/puppet.conf</code> для систем Linux,
* <code>C:\ProgramData\PuppetLabs\puppet\etc\puppet.conf</code> для Windows.

Дополнительные сведения см. в разделах Настройка агента UNIX и Настройка агента Windows.

== Примеры ==
Этот пример манифеста:

* Загружает установщик ЕдиногоАгента определенной версии (<code>version</code>) и сохраняет его в пользовательском каталоге (<code>download_dir</code>).
* Указывает модулю развернуть ЕдиныйАгент на хостах Linux и Windows с заданной конфигурацией.
* Указывает модулю использовать архитектуру установщика <code>ppcle</code>.
* Использует <code>install_args</code> для передачи параметров установки ЕдиногоАгента, которые назначают хосты группе хостов <code>My.HostGroup_123-456</code> и сетевой зоне <code>my.network.zone</code>.

# Download OneAgent installer in specific version to a custom
# directory with additional OneAgent install parameters
$env_url = '<nowiki>https://abc12345.live.ruscomtech.ru'</nowiki>
$paas_token = 'abcdefghijk1234567890'
$install_args = [ '--set-host-group=My.HostGroup_123-456', '--set-network-zone=my.network.zone' ]
$preserve_installer = true
$version = '1.219.0.20210422-111723'
if $::osfamily == 'Windows' {
class { 'oneagent':
environment_url => $env_url,
paas_token => $paas_token,
preserve_installer => $preserve_installer,
install_args => $install_args,
platform_install_args => [ 'INSTALL_PATH=C:\\ASTROM-key', 'USER=LocalService' ],
download_dir => 'C:\\temp',
version => $version
}
} else {
class { 'oneagent':
environment_url => $env_url,
paas_token => $paas_token,
preserve_installer => $preserve_installer,
install_args => $install_args,
platform_install_args => [ 'INSTALL_PATH=/opt/ASTROM-key', 'USER=linux_user' ],
download_dir => '/tmp',
version => $version,
installer_arch => 'ppcle'
}
}
Вы можете найти больше примеров манифестов в каталоге примеров. Каталог содержит следующие манифесты:

* <code>local_installer.yml</code> — установка ЕдиногоАгента с помощью локальной программы установки.
* <code>advanced_config.yml</code> — установка ЕдиногоАгента с пользовательским путем установки и каталогом загрузки.
* <code>oneagentctl_config.yml</code> — конфигурация ЕдиногоАгента с помощью команды <code>oneagentctl</code>.

Если у вас возникли проблемы с путями при установке в Windows, ознакомьтесь с разделом «Форматирование пути для Windows» в документации Puppet.

Диагностика АктивногоШлюза

2022-12-05T14:50:17Z

Lobanov: Новая страница: «Вы можете выполнять полностью автоматизированное устранение неполадок АктивногоШлюза...»

Вы можете выполнять полностью автоматизированное устранение неполадок АктивногоШлюза для сред Ключ-Астром SaaS и управляемых сред, начиная с Ключ-Астром версии 1.224 и АктивногоШлюза версии 1.223.

Рабочий процесс позволяет:

* Автоматически определять проблему, связанную с АктивнымШлюзом, в высокодинамичных средах в определенный момент времени.
* Легко собирайте диагностические данные для определенного объекта и автоматически получайте потенциальные решения для обнаруженных аномалий.
* Быстро устраняйте распространенные проблемы самостоятельно, сокращая время, затрачиваемое на диагностику
* Напрямую предоставьте службе поддержки Ключ-Астром всю информацию, необходимую для диагностики проблемы.

== Требования ==

* Ключ-Астром версии 1.224+
* Ключ-Астром АктивныйШлюз версии 1.223+
* Просмотр разрешений среды конфиденциальных данных запроса
* Для АктивногоШлюза, сконфигурированного для поддержки нескольких сред, вы можете запускать диагностику АктивногоШлюза только в основной среде, как определено в конфигурации АктивногоШлюза.

== Анализировать автоматически ==
Эта процедура описывает процедуру по умолчанию: Ключ-Астром собирает диагностические данные для АктивногоШлюза и немедленно анализирует их.
Если вы предпочитаете собирать и просматривать данные, прежде чем вручную отправлять их в Ключ-Астром для анализа, см. раздел Сбор и проверка локально.

# В меню Ключ-Астром выберите '''Статус развертывани'''я > '''АктивныеШлюзы'''.
# Разверните запись АктивногоШлюза, которую вы хотите устранить, и выберите '''Запустить диагностику АктивногоШлюза'''.
# На странице '''запуска диагностики АктивногоШлюза Ключ-Астром''' кратко опишите, что с вашей точки зрения работает не так, как вы ожидаете.
# <code>необязательно</code>. По умолчанию для анализа собираются данные за 7 дней. Если вам нужно больше данных, выберите ссылку '''Дополнительные параметры''', измените количество дней и нажмите '''Применить'''.
# Выберите '''Начать анализ'''.

=== Что происходит дальше ===
Ключ-Астром делает следующее:

* Собирает диагностические данные за последние 7 дней (если вы не меняли значение по умолчанию) затронутого АктивнымШлюзом.
* Хранит собранные диагностические данные
* Загружает диагностические данные в корзину S3 в регионе AWS вашей среды для дальнейшего анализа.

'''Столбец''' Состояние описывает текущую фазу процесса.
'''Состояние''' не обновляется автоматически. Выберите '''Обновить''', чтобы проверить изменение состояния.

==== Сбор ====
Сбор данных продолжается. При сборе данных вы можете:

* '''Обновите страницу''', чтобы обновить прогресс.
* '''Отменить''' сбор диагностических данных.

==== Собрано ====
Ключ-Астром завершил сбор диагностических данных. После сбора данных вы можете:

* '''Анализ''', чтобы отправить собранные данные в Ключ-Астром для анализа.
* '''Загрузите''' собранные данные локально для проверки.
* '''Удалите''' проблему, включая собранные диагностические данные.

==== Выполняется отправка ====
Диагностические данные передаются в Ключ-Астром для анализа. При отправке данных вы можете:

* '''Обновите''' страницу, чтобы обновить прогресс.
* '''Загрузите''' собранные диагностические данные.
* '''Удалите''' проблему, включая собранные диагностические данные.

==== Отправлено в облако Ключ-Астром ====
Диагностические данные были переданы Ключ-Астром для анализа.

==== Анализ ====
Сейчас Ключ-Астром анализирует диагностические данные.

Анализируя данные, вы можете:

* '''Обновите''' страницу, чтобы обновить прогресс.
* '''Загрузите''' собранные диагностические данные.
* '''Удалите''' проблему, включая собранные диагностические данные.

==== Проанализировано ====
Анализ сделан. Количество связанных оповещений указано в скобках.

После анализа вы сможете:

* '''Загрузите''' собранные диагностические данные.
* '''Удалите''' проблему, включая собранные диагностические данные.

==== Выполняется удаление ====
Диагностические данные удаляются. При удалении данных вы можете:

* '''Обновите''' страницу, чтобы обновить прогресс.

==== Удалено ====
Диагностические данные были удалены. Ключ-Астром хранит лишь небольшой набор информации о том, кто, когда, где и почему были собраны диагностические данные.

==== Отменено ====
Процесс диагностики был отменен вручную до его завершения.

=== Просмотрите анализ Ключ-Астром ===
По завершении анализа Ключ-Астром отправляет результаты обратно в вашу среду. Если найдено потенциальное решение, Ключ-Астром перечисляет его в разделе '''Предупреждения'''.

== Соберите и просмотрите на месте ==
Эта процедура описывает, как собирать диагностические данные для АктивногоШлюза. Используйте этот вариант, если вы предпочитаете собирать и просматривать данные, прежде чем вручную отправлять их в Ключ-Астром для анализа.
Если вместо этого вы хотите собирать данные и автоматически отправлять их в Ключ-Астром для анализа, см. раздел Автоматический анализ.

# В меню Ключ-Астром выберите Статус развертывания > АктивныеШлюзы.
# Разверните запись АктивногоШлюза, которую вы хотите устранить, и выберите Запустить диагностику АктивногоШлюза.
# На странице '''Запуск диагностики АктивногоШлюза Ключ-Астром''' кратко опишите, что с вашей точки зрения работает не так, как вы ожидаете.
# Выберите ссылку Дополнительные параметры.
# Выберите и сохраните локально.
#* Пока вы здесь, вы также можете изменить количество дней сбора данных (по умолчанию = 7 дней).
# Выберите Применить.
# Выберите Начать сбор, чтобы собрать диагностические данные и сохранить их локально.

=== Что происходит дальше ===
Ключ-Астром сейчас:

* Собирает диагностические данные за последние 24 часа (если вы не меняли значение по умолчанию) затронутого АктивнымШлюзом.
* Хранит собранные диагностические данные

Столбец '''Состояние''' описывает текущую фазу процесса.
'''Состояние''' не обновляется автоматически. Выберите '''Обновить''', чтобы проверить изменение состояния.

==== Сбор ====
Сбор данных продолжается. При сборе данных вы можете:

* '''Обновите''' страницу, чтобы обновить прогресс.
* '''Отменить''' сбор диагностических данных.

==== Собрано ====
Ключ-Астром завершил сбор диагностических данных. После сбора данных вы можете:

* '''Анализ''', чтобы отправить собранные данные в Ключ-Астром для анализа.
* '''Загрузите''' собранные данные локально для проверки.
* '''Удалите''' проблему, включая собранные диагностические данные.

=== Что делать с собранными данными ===
Теперь, когда данные собраны, вы можете:

* '''Загрузите''' собранные данные.
** Вы можете просмотреть данные. См. Содержание диагностических данных для обзора того, что находится в загрузке.
** Вы можете добавить данные в свой тикет в службу поддержки.
* '''Проанализируйте''' данные.
* '''Удалите''' проблему, включая собранные диагностические данные.

=== Диагностика АктивногоШлюза в управляемых окружениях Ключ-Астром с воздушным зазором ===
В управляемой среде Ключ-Астром с воздушным зазором:

# Используйте параметр '''Хранить локально''' в разделе '''Дополнительные параметры''', как описано выше.
# После сбора диагностических данных вы можете добавить их в свой запрос в службу поддержки.
# Затем Ключ-Астром может получить диагностические данные из вашего запроса в службу поддержки, проанализировать их и автоматически отправить отзыв в службу поддержки Ключ-Астром об обнаруженных аномалиях.

На протяжении всего этого процесса применяются строгие меры защиты конфиденциальности данных, которые регистрируются.

== Содержание диагностических данных ==
Все собранные диагностические данные сжимаются в ZIP-файл <code>SupportArchive<ID number></code>, который включает следующие папки и файлы:
{| class="wikitable"
!Папка или файл
!Описание
|-
|<code>details.txt</code> (file)
|Содержит общую информацию о том, когда и где были собраны диагностические данные, а также архивную статистику.
|-
|<code>config</code> (folder)
|Содержит снимок каталога конфигурации АктивногоШлюза.
|-
|<code>debugui</code> (folder)
|Содержит снимок конфигурации внутренней среды, относящейся к АктивномуШлюзу.
|-
|<code>log</code> (folder)
|содержит снимок каталога журналов АктивногоШлюза.
|-
|<code>autoupdater</code> (folder)
|Содержит журналы службы AutoUpdater и модули установки RPM, Synthetic, zRemote.
|-
|<code>install</code> (folder)
|Содержит журналы установки АктивногоШлюза.
|-
|<code>zremote</code> (folder)
|Содержит zRemote, журналы наблюдения и файлы конфигурации агента.
|-
|<code>synthetic</code> (folder)
|Содержит файлы конфигурации и журналы АктивногоШлюза Synthetic.
|-
|<code>remotepluginmodule</code> (folder)
|Содержит журналы для расширений и агента, выполняющего их.
|}

== Конфиденциальность данных ==
В соответствии с региональными правилами защиты данных и конфиденциальности Ключ-Астром автоматически удаляет все диагностические данные через 30 дней после их сбора. Это относится к данным в вашей среде Ключ-Астром и в кластере Ключ-Астром.

Вы можете удалить собранные диагностические данные раньше. Для обеспечения прозрачности Ключ-Астром хранит лишь небольшой набор информации о том, кто, когда, где и почему были собраны диагностические данные.

Дополнительные сведения о конфиденциальности данных Ключ-Астром см. в разделе Сроки хранения данных.

== Исправление проблем ==
Статус: «Сбор диагностических данных был невозможен в течение 20 минут».

* Если Ключ-Астром не может собрать диагностические данные в течение 20 минут, она автоматически повторяет попытку.
* Если повторная попытка также не удалась, мы предлагаем вам связаться со службой поддержки Ключ-Астром через чат.

«Состояние» кажется замороженным.

* Состояние не обновляется автоматически. Выберите Обновить, чтобы проверить изменение состояния.

== Часто задаваемые вопросы ==
Могу ли я получить доступ к S3 напрямую или использовать свой собственный S3?

Нет, вы не можете получить доступ к S3 напрямую или использовать свой собственный.

Диагностические данные загружаются в корзину Ключ-Астром S3, настроенную Ключ-Астром для среды/кластера. Используемый сегмент S3 зависит от расположения среды/кластера.

Безопасность АктивногоШлюза

2022-12-05T14:28:13Z

Lobanov: /* Переходный период */

Начиная с Ключ-Астром версии 1.225, каждый АктивныйШлюз использует свой собственный уникальный токен АктивногоШлюза для разрешения в кластере Ключ-Астром.

В зависимости от состояния вашего развертывания, начиная с версии Ключ-Астром 1.246, вам, возможно, потребуется выполнить некоторые действия для миграции в безопасность на основе токенов АктивногоШлюза.

== Миграция в токены АктивногоШлюза ==
Чтобы перейти на безопасность на основе токенов АктивногоШлюза, начните с определения состояния использования токена АктивногоШлюза.

1. В меню Ключ-Астром перейдите в '''настройки''' и выберите «Предпочтения»> «Безопасность сети».

2. Просмотрите сообщения, отображаемые на странице '''безопасности сети''' и решайте любые проблемы, как описано ниже.

=== Никаких действий не требуется ===
Если Ключ-Астром отображает подобное сообщение:
Токены АктивныхШлюзов применяются автоматически в вашей среде. Только АктивныеШлюзы с действительными токенами АктивныхШлюзов могут подключаться к Ключ-АСТРОМ.

* Дополнительных действий не требуется. Безопасность АктивногоШлюза включена и все готово.
* Только АктивныеШлюзы с действительными токенами АктивногоШлюза могут подключаться к Ключ-Астром.

=== Исправить проблемы токена АктивногоШлюза ===
Если Ключ-Астром отображает подобное сообщение:
У вас имеется 1 АктивныйШлюз с недействительным токеном, который потеряет соединение с Ключ-АСТРОМ, если вы сейчас примените токены АктивныхШлюзов. Перейдите к статусу развёртывания, чтобы увидеть список АктивныхШлюзов и соответствующие проблемы.

* Токены АктивногоШлюза еще не применяются, а некоторые из ваших активных агентов используют недействительные токены.
* Вам нужно решить проблемы на основе статуса. В противном случае такие активные агенты потеряют связь после применения токенов АктивногоШлюза.

=== Необходимо немедленно применить токены АктивногоШлюза ===
Если Ключ-Астром отображает подобное сообщение:
Вы можете вручную применить токены АктивныхШлюзов прямо сейчас, чтобы мгновенно повысить безопасность сети.
Вы можете отменить применение в течение 30 дней.

* У вас есть возможность немедленно обеспечить соблюдение токенов АктивногоШлюза. Вы можете сделать это в любое время, независимо от того, сообщают ли ваши АктивныеШлюзы проблемы токена, но обязательно прочитайте ручное исполнение токенов АктивногоШлюза ниже. Все АктивныеШлюзы со статусом, отличным от действительного, потеряют связь с Ключ-Астром.

=== Типы токенов АктивногоШлюза ===
Токен АктивногоШлюза представлены в двух вариациях:

* '''Seed Токен''' - токен АктивногоШлюза Seed автоматически настроен на установщик АктивногоШлюза при загрузке установщика с помощью пользовательского интерфейса Ключ-Астром Web или Ключ-Астром API.
* '''Индивидуальный токен''' - в рамках первого соединения АктивногоШлюза с кластером Ключ-Астром начальный токен АктивногоШлюза Seed -токен заменяется автоматически генерируемым индивидуальным токеном АктивногоШлюза. Один и тот же установщик может использоваться несколько раз; Первоначальный токен АктивногоШлюза Seed Lever разрешается создавать несколько отдельных токенов АктивногоШлюза.

=== Структура токна АктивногоШлюза ===
Токена АктивногоШлюза состоит из трех частей, разделенных точками (.).

Пример:

<code>dt0g02.4KWZO5EF.XT47R5DRADJIZUFOX4UDNOKTSUSABGLN7XSMJG7UXHRXKNY4WLORH4OF4T75MG7E</code>
{| class="wikitable"
!Часть
!Имя
!Описание
|-
|1
|prefix
|Первая часть (<code>dt0g02</code> в примере выше) является префиксом токена. Он идентифицирует тип токена.
|-
|2
|public
|Вторая часть (<code>4KWZO5EF</code> в примере выше)-это 8-символьная общественная часть токена.

Вместе префикс и публичная часть составляют '''идентификатор токена'''.

Вы можете безопасно отобразить идентификатор токена в веб-пользовательском интерфейсе и использовать его в целях ведения журнала.
|-
|3
|secret
|Третья часть (<code>XT47R5DRADJIZUFOX4UDNOKTSUSABGLN7XSMJG7UXHRXKNY4WLORH4OF4T75MG7E</code> в примере выше)-это 64-символьная секретная часть токена.

Обратитесь к секретной части как пароль. Он не должен отображаться в интерфейсе Ключ-Астром Web (после начального создания) или храниться в файлах журнала.
|}

== Применение токенов АктивногоШлюза ==
Все ваши АктивныеШлюзы уже постепенно мигрировали для использования токенов АктивногоШлюза во время обновлений АктивногоШлюза, начиная с версии АктивногоШлюза 1.225.

Чтобы проверить, в каких из ваших АктивныхШлюзов уже включены токены АктивногоШлюза

# В меню Ключ-Астром перейдите в '''статус развертывания''' и выберите '''АктивныеШлюзы'''.
# Вы можете отфильтровать свои АктивныеШлюзы по следующим статусам токена АктивногоШлюза:
#* Отсутствующий
#* Истекает
#* Невалидный
#* Неизвестный
#* Действительный
#* Не поддерживается.

=== Автоматическое применение токенов АктивногоШлюза ===
Если все ваши АктивныеШлюзы готовы к безопасности сети на основе токенов в течение 30 дней, ваша среда автоматически переключается на сетевую безопасность на основе токенов АктивногоШлюза.

=== Ручное обеспечение токенов АктивногоШлюза ===
Если вы хотите ускорить процесс, и вы уверены, что в вашей среде есть только АктивныеШлюзы версии 1.225+, вы можете заставить переключать токены АктивногоШлюза, когда вы готовы.

1. В меню Ключ-Астром перейдите в '''настройки''' и выберите «Предпочтения»> «Безопасность сети».

2. Включите '''вручную применять аутентификацию токена АктивногоШлюза'''.

* Когда вы включаете '''вручную применять аутентификацию токена АктивногоШлюза''' и сохраняете свои изменения, все активные агенты со статусом, отличным от действительного, потеряют свою связь с Ключ-Астром.
* У вас есть максимум 30 дней после того, как был обнаружен последний невалидный токен для ухода из ручного обеспечения (чтобы отключить '''вручную применять аутентификацию токена АктивногоШлюза'''). Например, если последний невалидный токен был обнаружен 20 дней назад, у вас все еще есть 10 дней, чтобы уйти из ручного режима. После того, как переходный период закончился, переключатель будет отключен (так что вы не можете его выключить).

=== Переходный период ===
Переходный период в 30 дней предназначен для предотвращения потери данных от АкктивныхШлюзов, где новые токены еще не активированы в вашей среде.

В течение этого периода, если какая-либо попытка подключиться без токена АктивногоШлюза будет обнаружена:

* Применение токенов АктивногоШлюза не будет включено, и всем АктивнымШлюзам будет разрешено подключаться к кластеру Ключ-Астром (потребуются только токены арендатора).
* Переходный период сбрасывается на 30 дней - Применение токена АктивныйШлюза будет автоматически включаться не раньше, чем через 30 дней с этого момента.

== Состояние токена АктивногоШлюза ==
Если ваши АктивныеШлюзы не используют допустимые токены АктивногоШлюза, вы можете проверить, почему токены недействительны.

1. В меню Ключ-Астром перейдите к '''статусу развертывания''' и выберите '''АктивныеШлюзы'''.

2. Выберите '''Проверить статусы токенов АктивногоШлюза'''.

'''Примечание:''' Эта опция доступна только при наличии проблем с токенами АктивногоШлюза.

В зависимости от статуса вам может потребоваться выполнить некоторые действия для перехода к сетевой безопасности на основе токенов АктивногоШлюза.

=== Отсутствует ===
Версия АктивногоШлюза поддерживает токены АктивногоШлюза, но по-прежнему использует токен арендатора для связи. Создайте и настройте новый токен АктивногоШлюза.

=== Истекает ===
Срок действия токена АктивногоШлюза истекает через 30 или менее дней. Если в вашей среде принудительно используются токены АктивногоШлюза, ваш АктивныйШлюз потеряет соединение после истечения срока действия токена.

=== Невалидный ===
АктивныйШлюз настроен на использование токена АктивногоШлюза, но его формат недействителен. Создайте и настройте новый токен АктивногоШлюза.

=== Неизвестный ===
АктивныйШлюз настроен на использование токена АктивногоШлюза, и формат токена действителен, но токен не распознается кластером Ключ-Астром. Создайте и настройте новый токен АктивногоШлюза.

=== Действительный ===
АктивныйШлюз использует действительный токен АктивногоШлюза для аутентификации.

=== Неподдерживаемый ===
АктивныйШлюз версии 1.223 или более ранней; Сетевая безопасность на основе токенов АктивногоШлюза поддерживается для АктивногоШлюза версии 1.225+.

== Сгенерируйте и настройте токен АктивногоШлюза ==

* Если ваш АктивныйШлюз развернут как StatefulSet, вам необходимо сгенерировать токен АктивногоШлюза и добавить его в свою конфигурацию.

'''Заметки''':

* Исходный токен АктивногоШлюза нельзя использовать для контейнерных АктивногоШлюза.
* Токен АктивногоШлюза может совместно использоваться несколькими АктивнымиШлюзами в одной среде.

* Если ваш АктивныйШлюз развернут с помощью оператора Ключ-Астром, оператор Ключ-Астром обрабатывает токен авторизации. Начиная с Ключ-Астром Operator версии 0.9.0+, вы должны включить область создания токенов АктивногоШлюза (activeGateTokenManagement.create). Дополнительные сведения см. в разделе Начало работы с мониторингом Kubernetes/OpenShift.

Если у вас возникли проблемы с токеном АктивногоШлюза, см. раздел Устранение неполадок.

* Все АктивныеШлюзы на базе хоста, установленные через веб-интерфейс Ключ-Астром или API Ключ-Астром, уже имеют автоматически сгенерированный токен АктивногоШлюза. Однако иногда вам может понадобиться сгенерировать токен АктивногоШлюза и настроить его в файле authorization.properties.

=== Сгенерировать токен АктивногоШлюза ===
1. Создайте токен API. Выберите одну из следующих областей маркеров, чтобы ограничить доступ из соображений безопасности:

* '''Записать токены АктивногоШлюза'''
* '''Написать токены АктивногоШлюза'''

2. Сохраните токен.

'''Примечание''': отображается только один раз.

3. Используйте API токенов АктивногоШлюза — POST конечную точку токена для создания токена. Авторизуйте вызов с помощью только что созданного токена API. Например, следующая команда сгенерирует токен АктивногоШлюза со следующими параметрами:

* Тип АктивногоШлюза: <code>ENVIRONMENT</code>
* Срок действия токена АктивногоШлюза истекает через: <code>6 месяцев</code>
* Тип токена АктивногоШлюза: индивидуальный токен АктивногоШлюза (<code>seedToken</code> имеет значение false).

'''Команда''':
curl -X POST "https://{your-environment-id}.live.AstromKey<nowiki/>.com/api/v2/activeGateTokens" \
-H "Authorization: Api-Token {api-token}" \
-H "Accept: application/json; charset=utf-8" \
-H "Content-Type: application/json; charset=utf-8" \
-d "{
"name": "myToken",
"expirationDate": "now+6M",
"seedToken": false,
"activeGateType": "ENVIRONMENT"
}"
Замените:

* <code>{your-environment-id}</code> с идентификатором вашего окружения
* <code>{api-token}</code> с токеном API, установленным в одну из следующих областей действия: '''Создать токены АктивногоШлюза''' или '''Записать токены АктивногоШлюза'''.

Пример тела ответа:
{
"token": "dt0g01.4KWZO5EF.
XT47R5DRADJIZUFOX4UDNOKTSUSABGLN7XSMJG7UXHRXKNY4WLORH4OF4T75MG7E",
"expirationTimeEpoch": 1607096737302
}

=== Настроить токен в АктивномШлюзе на хосте ===
1. В каталоге конфигурации АктивногоШлюза найдите файл авторизации.properties.

2. Отредактируйте файл, добавив сгенерированный вами токен АктивногоШлюза в качестве значения свойства authToken. Например:
authToken = dt0g01.4KWZO5EF.XT47R5DRADJIZUFOX4UDNOKTSUSABGLN7XSMJG7UXHRXKNY4WLORH4OF4T75MG7E # present, if required
3. Перезапустите основную службу АктивногоШлюза.

== Уведомления об истечении срока действия токена АктивногоШлюза ==
Помимо настройки внутреннего механизма ротации токенов АктивногоШлюза до истечения срока их действия, вы можете настроить уведомления об истечении срока действия токенов АктивногоШлюза. Для этого создайте интеграцию уведомлений о проблемах (например, по электронной почте), используя встроенный профиль оповещения '''Значение по умолчанию для истечения срока действия токена АктивногоШлюза'''.

Для Ключ-Астром Managed контакты для экстренных случаев также получают уведомления об истечении срока действия токена.

Чтобы отключить уведомления

1. В меню Ключ-Астром выберите '''Статус развертывания''' > '''АктивныеШлюзы'''.

2. Выберите '''Дополнительно''' (…), затем выберите '''Настройки применения токена АктивногоШлюза'''.

3. Отключите '''Включить уведомления об истечении срока действия токенов АктивногоШлюза'''.

4. Выберите '''Сохранить изменения'''.

Безопасность АктивногоШлюза

2022-12-03T16:48:03Z

Lobanov:

Конфигурация АктивногоШлюза

2022-12-03T16:20:48Z

Lobanov: Новая страница: «Многие настройки конфигурации АктивногоШлюза (например, настройки подключения и прокси...»

Многие настройки конфигурации АктивногоШлюза (например, настройки подключения и прокси, Ciphers или настройки дампа памяти) хранятся в файлах custom.properties and launcheruserconfig.conf, которые расположены в каталоге конфигурации АктивногоШлюза. Свойства, перечисленные в файлах свойств, применимы как для АктивногоШлюза, так и для Cluster АктивногоШлюза.

== Настройки связи ==

=== Порты связи ===
Укажите пользовательские порты связи, на которых АктивныйШлюз прослушивает трафик от ЕдиногоАгента. Откройте эти порты в брандмауэре, если используется брандмауэр.

См. Раздел WebServer в конфигурации АктивногоШлюза.

=== Прокси для Communication АктивногоШлюза ===
Установите прокси для АктивногоШлюза, для общения с кластером Ключ-Астром или для использования модулями АктивногоШлюза, для конкретных потребностей мониторинга - например, для синтетического мониторинга или мониторинга AWS/VMware/Azure, Cloud Foundry или Kubernetes.

См. Настройте прокси для АктивногоШлюза.

=== Обратный прокси ===
Установите обратный прокси или балансировщик нагрузки, на пути от АктивногоШлюза до кластера Ключ-Астром. Это позволяет вашему АктивномуШлюзу подключаться к любому доступному узлу кластера, распространяя нагрузку между узлами.

См. Обратный прокси или балансировщик нагрузки для АктивногоШлюза.

=== Надежные сертификаты и пользовательские сертификаты ===
Укажите надежные сертификаты в надежном магазине ключей, которые будут использоваться АктивнымШлюзом для соединений, где АктивныйШлюз является клиентом: АктивныйШлюз подключается к другим компонентам Ключ-Астром (кластеры, серверы) или сторонних системах (например, VMware, Cloud Foundry, Kubernetes или OpenShift) Используя SSL-защищенные каналы. Магазин сертификатов корневого CA, поставляемый с Java, иногда недостаточен для покрытия всех необходимых вариантов использования. Поэтому вы можете предоставить настраиваемый список доверенных корневых сертификатов и настроить АктивныйШлюз, чтобы объединить их с по умолчанию.

См. Доверенные корневые сертификаты для АктивногоШлюза.

Укажите пользовательский сертификат, который будет обслуживаться АктивнымШлюзом: соединение с АктивнымШлюзом, от ЕдиныхАгентов или REST API, происходит по зашифрованному каналу HTTPS. АктивныйШлюз предоставляет сертификат аутентификации всем подключающим клиентам. В то время как экземпляры ЕдиногоАгента могут игнорировать обоснованность сертификатов АктивногоШлюза (в зависимости от конфигурации), подключения от клиентов браузера (например, Rum JavaScript) подтверждают, что имя хоста, указанное в сертификате, являются правильными, прежде чем отправлять данные.

См. Пользовательский сертификат SSL для АктивногоШлюза.

=== Ciphers ===
Укажите Ciphers, которые будут использоваться АктивнымШлюзом для безопасной связи.

См. Конфигурацию Ciphers для АктивногоШлюза.

== Другие настройки конфигурации ==

=== Модули АктивногоШлюза ===
Включите несколько модулей АктивногоШлюза для запуска отдельных процессов мониторинга.

См. Модули АктивногоШлюза.

=== Поддержка с мульти-окружений ===
Настройте один АктивныйШлюз для поддержки нескольких окружений.

См. Развертывание АктивногоШлюза для Мульти-Окружений.

=== Пользовательские параметры для процесса Java АктивногоШлюза ===
Чтобы перенести пользовательские параметры в процесс Java АктивногоШлюза, укажите параметры в файле конфигурации запуска запуска <code>launcheruserconfig.conf</code>.

См. Пользовательские параметры для процесса Java АктивногоШлюза.

=== Ограничения АктивногоШлюза ===
Установить пределы памяти АктивногоШлюза: ограничения использования памяти для АктивногоШлюза могут быть указаны в конфигурации как относительный (процент доступной оперативной памяти) и абсолютный рисунок.

Смотрите пределы памяти АктивногоШлюза.

Удаление АктивногоШлюза

2022-12-03T15:48:23Z

Lobanov: Новая страница: «АктивныйШлюз имеет специальную программу удаления. Вам нужно будет запустить его, чтобы...»

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

* В Windows:

Используйте панель управления Windows для удаления АктивногоШлюза.

* На Linux:

Перейдите в каталог/opt/dynatrace/gateway и, используя Root Rights, запустите сценарий uninstall.sh.

== После удаления ==
После удаления файлы журнала и часть конфигурации сохраняются в каталогах журнала АктивногоШлюза и конфигурации соответственно. Вам придется удалить эти файлы вручную.

Обновление АктивногоШлюза

2022-12-03T15:45:19Z

Lobanov: Новая страница: «Чтобы увидеть список установленных АктивныхШлюзов, выберите «Статус развертывания»> «А...»

Чтобы увидеть список установленных АктивныхШлюзов, выберите «Статус развертывания»> «Активные» из меню навигации. Для каждого АктивногоШлюза в списке дается текущая версия АктивногоШлюза и статус обновления (актуально, ожидает или в процессе).

'''ПРЕДУПРЕЖДЕНИЕ''' Значок желтого предупреждения указывает, что ваш АктивныйШлюз отстает более чем на пять версий. Вы должны обновить эти АктивныеШлюзы как можно скорее.

Чтобы управлять функциональностью обновления конкретного АктивногоШлюза в списке, выберите АктивныйШлюз, чтобы расширить детали:

* '''Автоматическое обновление'''

Чтобы использовать функцию Auto-Update, убедитесь, что автоматическое переключение обновлений для АктивногоШлюза включено. Это означает, что когда появится новая версия АктивногоШлюза, будет загружен новый пакет установки на конкретный хост, и будет установлена новая версия АктивногоШлюза. Это настройка по умолчанию для новых сред. Для существующих среда настройка остается неизменной.

Проверка доступности выполняется с 30-минутными интервалами.

* '''Обновление в один клик'''

Чтобы немедленно выполнить обновление, выберите «Обновление». Эта функциональность доступна только в том случае, если автоматическое переключение обновлений отключено для конкретного АктивногоШлюза.

* '''Ручная загрузка и обновление'''

ПРИМЕЧАНИЕ: АктивныеШлюзы в контейнерах развернуты и загружаются с использованием облачных инструментов. Например, Kubernetes использует пользовательские определения ресурсов.

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

* Установите среду АктивногоШлюза.
* Установите кластер АктивногоШлюза.

Во время обновления ваша конфигурация АктивногоШлюза сохраняется в <code>custom.properties</code> и <code>launcheruserconfig.conf</code> Эти два файла не будут перезаписаны во время обновления, но это хорошая практика, чтобы поддержать их, прежде чем обновлять АктивныйШлюз.

* См. Конфигурацию АктивногоШлюза для <code>Custom.Properties</code> свойств файла.
* См. Конфигурацию лаунчера АктивногоШлюза для <code>launcheruserconfig.conf</code> свойств.

== Статус обновления ==
Статус обновления для АктивногоШлюза, как указано на странице '''состояния развертывания''', может принять следующие значения:

'''Обновлено'''

Последняя доступная версия АктивногоШлюза установлена на соответствующем хосте.

'''Доступны обновления'''

Для этой версии АктивногоШлюза доступно обновление.

'''В ожидании обновления'''

Сразу после выбора '''Обновление АктивногоШлюза''' изменяется статус для обновления ожидания и остается в этом статусе до начала процесса обновления. Статус также может быть указан как <code>ожидающий</code>, если:

* Кластер в настоящее время обновляется.
* Было достигнуто максимальное количество загрузок одновременных обновлений, и АктивныйШлюз ждет возобновления загрузки.

'''Производится обновление'''

АктивныйШлюз запросил и загрузил новый пакет установки с сервера и в настоящее время находится в процессе его установки или повторного подключения к серверу.

'''Проблема при обновлении'''

В этом случае вы увидите старый номер версии, отображаемый для АктивногоШлюза.

Возможные проблемы:

* АктивныйШлюз загрузил новый установщик, но установка не была предпринята или не была выполнена успешно; Следовательно, АктивныйШлюз все еще находится в старой версии. Проверьте журналы АктивногоШлюза Auto-Updater и журналы установщиков по той причине, по которой установка не была предпринята или не удалась.
* АктивныйШлюз загрузил новый установщик, но затем не удалось повторно подключиться к серверу (был потерян). Проверьте журналы установщика АктивногоШлюза по причине, по которой установка не удалась.
* Для АктивногоШлюза нет установщиков.
* Обновление находится в приостановке, потому что - в другой среде - были проблемы с обновлением с предлагаемой версией АктивногоШлюза.

'''Неизвестный'''

Соединение с этим АктивнымШлюзом было потеряно, и статус не может быть определен.

Этот статус также может быть отображен, если АктивныйШлюз был успешно удален: в этом случае статус развертывания будет продолжать отображать удаленный АктивныйШлюз с состоянием обновления неизвестным в течение семи дней.

Запуск/остановка/перезапуск АктивногоШлюза

2022-12-03T14:53:10Z

Lobanov:

Чтобы запустить, остановить или перезапустить АктивныйШлюз, вам необходимо запустить, остановить или перезапустить соответствующие службы для Linux или службы для Windows, которые использует АктивныйШлюз, в зависимости от операционной системы, на которой установлен АктивныйШлюз. Фактические услуги также зависят от цели, для которой был установлен АктивныйШлюз, и от включенных функциональных модулей.

== Linux ==

=== Linux systemd (все поддерживаемые системы Linux, кроме RHEL 6.x и Ubuntu 14.04) ===
Вам потребуются привилегии суперпользователя для выполнения команд запуска, остановки или перезапуска служб АктивногоШлюза:

==== Запустите службу АктивногоШлюза ====
<code>systemctl start <имя службы></code>

==== Остановить службу АктивногоШлюза ====
<code>systemctl stop <имя службы></code>

==== Перезапустите службу АктивногоШлюза ====
<code>systemctl перезапустить <имя службы></code>

==== Запросить текущий статус службы АктивногоШлюза ====
<code>systemctl статус <имя службы></code>

=== Linux System V (RHEL 6.x и Ubuntu 14.04) ===
Вам потребуются привилегии суперпользователя для выполнения команд запуска, остановки или перезапуска служб АктивногоШлюза:

==== Запустить АктивныйШлюз ====
<code>service <имя службы> start</code>

==== Остановить АктивныйШлюз ====
<code>service <имя службы> stop</code>

==== Перезапустите АктивныйШлюз ====
<code>service <имя службы> restart</code>

==== Запросить текущий статус службы АктивныйШлюз ====
<code>service <имя службы> status</code>

== Windows ==
В Windows запуск и остановка служб АктивногоШлюза может быть выполнена с помощью Windows Task Manager, на вкладке Services. Вы также можете запустить и остановить службы АктивногоШлюза, используя команду:

==== Запустить ActiveGate ====
<code>net start "<service_Name>"</code>

Например:

<code>net start "AstromKey Gateway"</code>

==== Остановить ActiveGate ====
<code>net stop "<service_name>"</code>

Например:

<code>net stop "AstromKey Gateway"</code>

Запуск/остановка/перезапуск АктивногоШлюза

2022-12-03T10:25:08Z

Lobanov: Новая страница: «Чтобы запустить, остановить или перезапустить АктивныйШлюз, вам необходимо запустить, о...»

Мониторинг Kong Gateway

2022-11-27T15:05:28Z

Lobanov: Новая страница: «С Ключ-Астром вы можете получить возможность наблюдать за Kong Gateway и его управляемыми API. У...»

С Ключ-Астром вы можете получить возможность наблюдать за Kong Gateway и его управляемыми API. Узнайте, как отслеживать свой Kong Gateway и собирать метрики с помощью расширения Kong Prometheus.

== Предварительные требования ==

* Ваша версия Kong Gate поддерживается Ключ-Астром.
* OneAgent или Ключ-Астром Operator установлены и доступны для мониторинга вашего Kong Gateway.

Необходимая установка зависит от вашего приложения:
{| class="wikitable"
!Если ваше приложение работает
!См. инструкцию для
|-
|на виртуальной машине или на «голом железе»
|ЕдиныйАгент
|-
|как рабочая нагрузка в Kubernetes или OpenShift
|Ключ-Астром Operator
|}

== Трассировки ==
Чтобы начать трассировку приложений Kong, см. Инструментирование NGINX вручную.

== Метрики ==
Ключ-Астром может собирать метрики с помощью плагина Kong Prometheus. Таким образом, предполагается следующая конфигурация:
{| class="wikitable"
!Настройки
!Детали
|-
|Конечная точка служб Kong
|<code>/services</code>
|-
|Конечная точка Kong Routes
|<code>/routes</code>
|-
|Конечная точка плагинов Kong
|<code>/plugins</code>
|-
|Конечная точка метрик Prometheus
|<code>/metrics</code>
|-
|Порт HTTP прокси-сервера Kong
|<code>8000</code>
|-
|Порт HTTPS прокси-сервера Kong
|<code>8443</code>
|-
|HTTP-порт администратора Kong
|<code>8001</code>
|-
|Порт HTTPS администратора Kong
|<code>8444</code>
|}
Обязательно адаптируйте инструкции по установке к вашей фактической конфигурации.

== Включить плагин Prometheus на Kong ==
Чтобы включить плагин Prometheus в Kong, отправьте следующий запрос POST на конечную точку <code>/plugins</code>:
curl -X POST <nowiki>http://{HOST}:8001/plugins</nowiki> --data "name=prometheus"
Замените <code>{HOST}</code> вашим фактическим значением.

Чтобы проверить доступные метрики Kong, запросите конечную точку <code>/metrics</code>:
curl -i <nowiki>http://localhost:8001/metrics</nowiki>

== Собирайте метрики Prometheus ==
Плагин Prometheus — самый удобный способ сбора метрик Kong. Плагин находится в постоянном развитии, поэтому появляются все новые и новые показатели.

В настоящее время Ключ-Астром предлагает три подхода к сбору метрик Prometheus в зависимости от среды.

=== Kubernetes ===
В Kubernetes Ключ-Астром поддерживает парсинг любой конечной точки HTTP(s), предлагая метрики в формате OpenMetrics (например, экспортеры Prometheus). С помощью аннотаций, специфичных для Ключ-Астром, вы можете указать, какие модули или сервисы следует очищать.

Узнайте, как собирать метрики Prometheus в Kubernetes.

=== Использование расширения ===
Ключ-Астром предоставляет масштабируемые средства для получения метрик Prometheus напрямую из источника без использования Kubernetes. Это работает полностью автоматически и работает лучше всего, если ЕдиныйАгент установлен на компьютере, где создаются метрики Prometheus, но это также можно сделать полностью без агента, когда ЕдиныйАгент не может быть установлен на устройстве.

* Узнайте, как собирать метрики Prometheus без Kubernetes с помощью источника данных Extensions 2.0 Prometheus.
* Ознакомьтесь с нашими руководствами по Extensions 2.0.

Кроме того, следите за нашим центром Software Intelligence, где мы часто публикуем новые расширения.

=== Amazon Managed ===
Amazon предоставляет управляемый сервис для Prometheus, а Ключ-Астром предоставляет средства для сбора метрик непосредственно из него, если вам это нужно. Однако, как правило, было бы более рентабельно использовать один из других методов, описанных здесь, и избежать дополнительных затрат на сервис Amazon.

Узнайте, как собирать метрики Prometheus из Amazon Managed Service для Prometheus.

== Kong метрики ==
{| class="wikitable"
!Ключ метрики
!Описание
!Тип
|-
|<code>kong_bandwidth</code>
|Общая пропускная способность в байтах, потребляемая на услугу/маршрут в Kong
|counter
|-
|<code>kong_datastore_reachable</code>
|Хранилище данных доступно из Kong; 0 недоступен
|gauge
|-
|<code>kong_http_status</code>
|Коды состояния HTTP для каждой службы/маршрута в Kong
|counter
|-
|<code>kong_latency</code>
|Задержка, добавленная Kong, общее время запроса и задержка восходящего потока для каждой службы/маршрута в Kong
|histogram
|-
|
* <code>kong_latency_bucket</code>
* <code>kong_latency_count</code>
* <code>kong_latency_sum</code>
|
|gauge

counter

counter
|-
|<code>kong_memory_lua_shared_dict_bytes</code>
|Выделенные плиты в байтах в shared_dict
|gauge
|-
|<code>kong_memory_lua_shared_dict_total_bytes</code>
|Общая емкость в байтах shared_dict
|gauge
|-
|<code>kong_memory_workers_lua_vms_bytes</code>
|Выделенные байты в рабочей Lua VM
|gauge
|-
|<code>kong_nginx_http_current_connections</code>
|Количество HTTP-соединений
|gauge
|-
|<code>kong_nginx_metric_errors_total</code>
|Количество ошибок nginx-lua-prometheus
|counter
|-
|<code>kong_nginx_timers</code>
|Количество таймеров NGINX
|gauge
|}

Поддержка технологий

2022-11-27T14:51:48Z

Lobanov:

[[Платформа ЕдиныйАгент и матрица поддержки возможностей]]

[[Матрица поддержки Serverless вычислений]]

[[Жизненный цикл поддержки Kubernetes]]

[[Жизненный цикл поддержки OpenShift]]

[[Жизненный цикл поддержки для VMware Tanzu Application Service]]

[[Программное обеспечение]]

* [[Java]]
** [[Поддержка JVM]]
** [[Сборщик мусора G1 - Java 9]]
** [[Основные проблемы с памятью Java]]
* .[[NET]]
* [[Node.js]]
* [[PHP]]
** [[Поддерживаемые версии PHP]]
** [[Полный мониторинг PHP]]
** [[Видимость на уровне кода для PHP]]
** [[PHP-FPM мониторинг]]
* [[Go]]
** Служба поддержки
*** [[Поддерживаемые версии Go]]
*** [[Известные ограничения для поддержки Go]]
**Конфигурация и анализ
***[[Включить мониторинг Go]]
***[[Анализируйте показатели Go]]
***[[Сквозной мониторинг запросов]]
***[[Полная видимость на уровне кода]]
***[[Сервисы Custom Go]]
* [[NGINX]]
**[[Инструментирование кастомных сборок nginx]]
**[[Мониторинг Kong Gateway|Мониторинг Kong Gateway ]]
На этой странице перечислены все среды, технологии и версии, которые можно отслеживать с помощью Ключ-Астром. Этот список постоянно растет, поэтому заходите почаще. См. также, [[Конец объявлений о поддержке.]]

== Операционные системы ==
Вы можете установить ЕдиныйАгент в следующих операционных системах [[Linux]], [[Unix]], [[Windows]] и [[z/OS.]]

=== Linux ===
Ключ-Астром только тестирует и поддерживает установку ЕдиныйАгент в перечисленных ниже дистрибутивах и версиях Linux.

'''Примечание:''' Существуют определенные ограничения при развертывании ЕдиныйАгент на хосте Linux с подключенными дисками NFS. См. [[Раздел Устранение неполадок при установке ЕдиныйАгент.]]

'''Поддерживаемые архитектуры CPU:'''

*<code>x86-64</code> - 64-bit Intel/AMD
*<code>s390x</code> - 64-bit IBM Z mainframe
*<code>ppc64le</code> - 64-bit PowerPC
*<code>ARM64 (AArch64)</code> - 64-bit Linux ARM, including AWS Graviton processors
{| class="wikitable"
!Поддерживаемые ОС
!Версии
!Архитектура CPU
|-
|AlmaLinux
|8.6+
|ARM64 (AArch64), PPCLE, s390, x86-64
|-
| rowspan="1" |Alpine Linux (musl libc) for containers
|3.10 - 3.151
|x86-64
|-
| rowspan="1" |Amazon Linux
|2
|ARM64 (AArch64), x86-64
|-
| rowspan="1" |Amazon Linux AMI
|2014.03 - 2018.03
|x86-64
|-
| rowspan="1" |Bottlerocket
|1.x2
|x86-64
|-
| rowspan="1" |CentOS
| 7.x
|ARM64 (AArch64), PPCLE, x86-64
|-
| rowspan="1" |CentOS Stream
|8, 9
|ARM64 (AArch64), PPCLE, x86-64
|-
| rowspan="1" | Debian
| 8, 9, 10, 11
|
x86-64
|-
| rowspan="2" |EulerOS
|2.3, 2.5, 2.8
| x86-64
|-
|2.8
|
ARM64 (AArch64)
|-
| rowspan="1" |Fedora
|34, 35, 36
|x86-64
|-
| rowspan="1" |
Google Container-Optimized OS
|89 LTS4
|x86-64
|-
| rowspan="1" |Oracle Linux
| 6.x, 7.x, 8.x
|x86-64
|-
| rowspan="4" |Red Hat Enterprise Linux
|6.x, 7.x, 8.x, 9.x
| x86-64
|-
|7.x, 8.x, 9.x
|PPCLE
|-
|9.x, 7.4+, 8.x
|ARM64 (AArch64)
|-
| 9.x, 6.9+, 7.x, 8.x
| s390x
|-
| rowspan="1" |Red Hat Enterprise Linux CoreOS
|4.63, 4.73, 4.83, 4.93, 4.103, 4.113
|x86-64
|-
| rowspan="1" |Rocky Linux
|8.x, 9.x
|ARM64 (AArch64), x86-64
|-
| rowspan="3" |
SUSE Linux Enterprise Server
| 12.3, 12.4, 12.5, 15.0, 15.1, 15.2, 15.3
| x86-64, PPCLE
|-
|15.x
|ARM64 (AArch64)
|-
|12.3, 12.4, 12.5, 15.x
| s390x
|-
| rowspan="3" |Ubuntu
|
14.04 LTS, 16.04 LTS, 18.04 LTS, 20.04 LTS, 22.04 LTS, 21.10
|x86-64
|-
|16.04 LTS, 18.04 LTS, 20.04 LTS, 22.04 LTS, 21.10
|PPCLE
|-
|20.04 LTS, 22.04 LTS, 21.10, 18.04 LTS
|ARM64 (AArch64), s390x
|-
| rowspan="1" |openSUSE
|15.3
|PPCLE, x86-64
|}
1 Поддерживается только в контейнерах, которые отслеживаются в режиме полного стека OneAgent или в режиме мониторинга только для приложений (musl libc 1.1.14 - 1.2).

2 Поддерживается только с использованием инъекции только в приложение. Метрики узлов доступны с помощью Kubernetes Monitoring.

3 Поддерживается развертывание на основе контейнера с помощью оператора (см. OpenShift).

4 Поддерживается развертывание на основе контейнера через хранилище томов (см. GKE).

===Unix===
Ключ-Астром тестирует и обеспечивает поддержку установки ЕдиногоАгента в перечисленных ниже версиях [[AIX]] и [[Solaris]].

'''Поддерживаемые архитектуры CPU'''

* <code>x86</code> - 32-bit Intel/AMD
* <code>x86-64</code> - 64-bit Intel/AMD
*<code>POWER8</code> - 64-bit Power ISA
* <code>POWER9</code> - 64-bit Power ISA
* <code>SPARC</code>

{| class="wikitable"
!UNIX Система
! Версии
!Архитектура CPU
|-
| rowspan="1" | IBM AIX
| 7.1 TL51, 7.2 TL41, 7.2 TL51, 7.3 TL01, 6.1 TL9, SP9+2
|POWER8, POWER9
|-
|IBM AIX VIOS
|3.1.x3
|POWER8, POWER9
|-
| rowspan="1" |Solaris
|10 1/13+, 11.x
|SPARC, x86-64
|}
1Установка в разделах WPAR AIX не поддерживается.

2 Для AIX 6.1 автоматическое внедрение модуля кода отсутствует. Установка в разделах WPAR AIX не поддерживается.

3 Виртуальный сервер ввода-вывода, режим автовставки не поддерживается

===Windows===
Ключ-Астром только тестирует и поддерживает установку ЕдиногоАгента в перечисленных ниже версиях [[Windows]].

'''Поддерживаемые архитектуры CPU'''

* <code>x86-64</code> -64-bit Intel/AMD

{| class="wikitable"
! Windows Система
!Версии
!Архитектура CPU
|-
| rowspan="1" | Windows Desktop 10
|8.1, 19091, 20H21, 21H11, 15072, 16072, 18092, 21H22
|x86-64
|-
| rowspan="1" | Windows Desktop 11
| 21H2
|x86-64
|-
| rowspan="1" | Windows Server
|2008 R23, 20124, 2012 R24, 20165, 20195, 20225, 20H26
|x86-64
|-
| rowspan="1" |Windows Server - Nano
|All versions supported7
|x86-64
|}
1)Полугодовой канал Windows 10 (SAC), за исключением Windows 10 IoT.

2)Канал долгосрочного обслуживания Windows 10 (LTSC), за исключением Windows 10 IoT.

3)Начиная с ЕдиногоАгента версии 1.225, установщик подписывается с использованием алгоритма SHA-2. Следовательно, на хостах Windows 2008 R2 должна быть установлена поддержка подписи кода SHA-2: обновления KB4490628 и KB4474419.

4)Включая Windows Server Core.

5)Канал долгосрочного обслуживания (LTSC). Поддержка включает установку Server Core (требуется, чтобы OneAgent был установлен в автономном режиме) или отслеживание в сценарии только для приложений.

6)Полугодовой канал (SAC). Поддержка включает установку Server Core (OneAgent, установленный в автономном режиме) или отслеживание в сценарии только для приложений.

7)Ограниченная поддержка, основанная на совместимости с поддержкой Windows Server при использовании в качестве образа контейнера.

=== IBM z/OS ===
Ключ-Астром только тестирует и поддерживает установку модулей кода ЕдиногоАгента для технологий и версий, перечисленных ниже..
{| class="wikitable"
!Технология
!Версии
|-
|z/OS
|2.3, 2.4, 2.5
|-
|IBM MQ
|8.0, 9.0, 9.1
|-
|DB2
|11, 12
|-
|DL/I
|}

==== CICS ====
{| class="wikitable"
!Технология
!Версии
|-
|CICS Transaction Server
|5.1, 5.2, 5.3, 5.4, 5.5, 5.6, 6.1
|-
|CICS Transaction Gateway1 2
|9.0, 9.1, 9.2, 9.3
|-
|CICS SOAP over HTTP3
|
|-
|CICS DLI
|
|-
|CICS MQ Bridge
|
|}
1 Поддерживаются только протоколы EXCI и IPIC.

2 Конфигурация локального режима WAS не поддерживается.

3 Поддерживается только входящая трассировка.

==== IMS ====
{| class="wikitable"
!IBM IMS
!Versions
|-
|IMS 1 2
|13, 14, 15
|-
|IMS TM Resource Adapter
|13, 14, 15
|-
|IMS SOAP Gateway1
|3.2
|-
|IMS Connect API1
|3.2
|-
|IMS MQ Bridge1
|
|-
|IMS MQ Trigger Monitor
|}
1 Только входящая трассировка.

2 Отслеживание транзакций Fast Path поддерживается только для IMS 15.
{| class="wikitable"
!Database client
!Versions
|-
|IBM DB2
|11, 12
|-
|IBM IMS DB1
|
|}
1 Поддерживаются методы доступа к базе данных DL/I и Fast Path.
{| class="wikitable"
!Messaging client
!Versions
|-
|IBM MQ
|8.0, 9.0, 9.1, 9.2
|}

==== Java ====
{| class="wikitable"
!Виртуальная машина
!Версии
|-
|IBM JVM for z/OS
|7, 8
|-
|IBM Semeru for z/OS
|11
|}
{| class="wikitable"
!Технология
!Версии
|-
|IBM WebSphere Application Server
|8.5.5, 9.0
|-
|IBM WebSphere Liberty
|18, 19, 20, 21
|-
|IBM z/OS Connect Enterprise Edition 12
|3.0.30+
|-
|IBM CICS Transaction Gateway
|9.0, 9.1, 9.2, 9.3
|-
|IBM IMS SOAP Gateway
|3.2
|-
|IBM CICS SOAP
|
|-
|Apache HttpClient
|3.1, 4
|}
1 Поддерживается только автономная конфигурация z/OS Connect EE.

2 Поддерживаются только поставщики услуг CICS, IMS и IBM MQ.
{| class="wikitable"
!Database framework
!Versions
|-
|JDBC 1
|3, 4
|}
1 Поддерживаются только драйверы DB2 JDBC типов 2 и 4.
{| class="wikitable"
!Messaging client
!Versions
|-
|IBM MQ
|8.0, 9.0, 9.1, 9.2
|-
|JMS
|1.1
|}
{| class="wikitable"
!Monitoring framework
!Versions
|-
|JMX
|1.0+
|}

== Контейнеры ==
{| class="wikitable"
!Функции
!Версии
|-
|Автоинъекция в контейнер Docker (Глубокий мониторинг)1
|1.6+ (32 and 64 bit) glibc or musl-libc required
|-
|Автоинъекция в контейнер containerd (Глубокий мониторинг)
|1.1.2+ (32 and 64 bit) glibc or musl-libc required
|-
|Автоинъекция в контейнер CRI-O (глубокий мониторинг)
|1.12.5+ (32 and 64 bit) glibc or musl-libc required
|-
|Автоинъекция в контейнер Garden-RunC (Глубокий мониторинг)
|1.0.0+ (32 and 64 bit) glibc or musl-libc required
|-
|Автоинъекция в контейнер BOSH bpm (Глубокий мониторинг)
|0.11.0+
|-
|Показатели контейнера Docker1
|1.8, 1.9, 1.10, 1.11, 1.12, 1.13 RC2, 1.13.1, 17.03+ CE and EE
|}
1 Please see known limitations of Docker container monitoring.

== Гипервизоры ==
{| class="wikitable"
|AIX (LPAR)
|-
|Hyper-V
|-
|KVM
|-
|Nutanix AHV1
|-
|QEMU
|-
|Xen
|-
|VMware
|-
|AWS Nitro1
|}
1 Ключ-Астром обнаруживает гипервизор, но не использует специальную логику.

== Сетевые интерфейсы ==
{| class="wikitable"
|IEEE 802.3 Ethernet
|-
|IEEE 802.11 Wireless LAN
|-
|OpenVZ virtual network device (venet)
|}
Примечание:

* Поддерживаются как физические, так и виртуальные интерфейсы при условии, что им не назначен локальный адрес канала.
** Для IPv4: локальные адреса канала находятся в диапазоне от <code>169.254.1.0</code> до <code>169.254.254.255</code>.
** Для IPv6: локальные адреса канала находятся в диапазоне от <code>0xFE800000</code> до <code>0xFEBFFFFF</code>.
* Интерфейсы виртуального моста Ethernet не поддерживаются.
* Поддерживается связывание сетевого интерфейса.
* Для мониторинга трафика поддерживается только протокол TCP.

== Облачные платформы ==

=== AWS ===
{| class="wikitable"
!Amazon Web Services (AWS)
|-
|DynamoDB
|-
|Elastic Block Store (EBS)
|-
|Elastic Compute Cloud (EC2)
|-
|Elastic Load Balancing (ELB)
|-
|Lambda
|-
|Relational Database Service (RDS)
|-
|Simple Storage Service (S3)
|}

=== Microsoft Azure ===
{| class="wikitable"
!Вычислительный сервис
!Расширение для развертывания ЕдиногоАгента
!Интеграция Ключ-Астром с Azure Monitor
|-
|Virtual Machines
|VM-Extension1
|да
|-
|Virtual Machine Scale Set
|VM-Extension1
|да
|-
|Service Fabric
|VM-Extension1
|да
|-
|Azure Kubernetes Service (AKS)
|Operator-rollout2
|нет
|-
|Cloud-Services (Classic)
|Startup script
|нет
|-
|HDInsight
|Startup-Script
|да
|-
|App Service (Windows based)
|SiteExtension
|да
|-
|Azure Functions
|SiteExtension (Early Adopter release)
|да
|}
1 VM-Extension автоматизирует установку ЕдиногоАгента с помощью собственных средств автоматизации Azure. ЕдинйыйАгент также можно установить вручную или с помощью выбранного вами инструмента автоматизации.

2 Поды и узлы Windows не поддерживаются.
{| class="wikitable"
!Сервис платформы
!Поддержка модуля кода ЕдиногоАгента
!Интеграция Ключ-Астром с Azure Monitor
|-
|Blob-Storage
|HttpClient1
|да
|-
|Table-Storage
|HttpClient1
|да
|-
|Queue-Storage
|HttpClient1
|да
|-
|File-Storage
|Infrastructure monitoring
|да
|-
|Disk-Storage
|Infrastructure monitoring
|да
|-
|ServiceBus Queues and Topics
|Microsoft Azure Service Bus Client for .NET
|да
|-
|Load-Balancer
|Infrastructure monitoring
|да3
|-
|Application Gateway
|Trace-Context4
|да
|-
|API Management
|Trace-Context4, SDK5
|да
|-
|Azure SQL
|Supported database frameworks2
|да
|-
|Azure SQL Elastic Pool
|Supported database frameworks2
|да
|-
|Azure SQL Managed Instance
|Supported database frameworks2
|нет
|-
|SQL Data Warehouse
|Supported database frameworks2
|нет
|-
|SQL Server Stretch
|Supported database frameworks2
|нет
|-
|Azure DB for MySql
|Supported database frameworks2
|нет
|-
|Azure DB for PostgreSQL
|Supported database frameworks2
|нет
|-
|CosmosDB
|MongoDB API, Cassandra API, HttpClient1
|да
|-
|Redis Cache
|Supported client libraries
|да
|-
|Event Hubs
|SDK5
|да
|-
|IoT Hub
|Trace Context4, SDK5
|да
|}
1 Отслеживает HTTP-вызовы через поддержку HttpClient.

2 Отслеживайте вызовы базы данных через поддерживаемые платформы баз данных (например, ADO.NET или JDBC).

3 Доступно только для [https://docs.microsoft.com/en-us/azure/load-balancer/load-balancer-overview#why-use-standard-load-balancer стандартного балансировщика нагрузки]

4 Трассировка End-2-End через [https://www.w3.org/TR/trace-context/ контекст трассировки]

5 Трассировка End-2-End с помощью [https://github.com/Dynatrace/OneAgent-SDK SDK ЕдиногоАгента]

=== Облачная платформа Google ===
{| class="wikitable"
!Облачные сервисы Google
|-
|Google Kubernetes Engine
|-
|GKE Autopilot (only for automatic <code>applicationMonitoring</code>)
|-
|Google App Engine
|-
|Google Compute Engine
|}

=== VMware ===
{| class="wikitable"
!VMware
!Версии
|-
|ESXi host
|6.5, 6.7, 7.0
|-
|vCenter server
|6.5, 6.7, 7.0
|}

=== Heroku ===
{| class="wikitable"
!Features
!Версии
|-
|Stack
|Heroku-18
|-
|Stack
|Heroku-20 (default)
|}

== Контейнерные платформы ==

=== Kubernetes ===
Ключ-Астром поддерживает множество разновидностей Kubernetes и OpenShift. Поддерживаемые дистрибутивы управляются и управляются клиентами. Размещенные версии управляются облачными провайдерами.

==== Дистрибутивы ====

* Google Anthos
* Mirantis Kubernetes Engine 1
* Rancher 2.0
* Red Hat OpenShift Container Platform
* VMware Tanzu Kubernetes Grid Integrated Edition (formerly Pivotal Kubernetes Service)
* D2iQ Konvoy
* Oracle Container Engine for Kubernetes (OKE)1

1 Ограниченная поддержка на основе совместимости с вышестоящим Kubernetes.

==== Хостинг-версии ====

* Amazon Elastic Kubernetes Service
* Azure Kubernetes Service
* Google Kubernetes Engine
* RedHat OpenShift Service on AWS (ROSA) 1
* IBM Kubernetes Service 1
* OpenShift Dedicated 1
* SUSE Container as a Service platform 1
* GKE Autopilot 2

1 Ограниченная поддержка, основанная на совместимости с вышестоящим Kubernetes/OpenShift.

2 Только для автоматической конфигурации <code>applicationMonitoring</code>.

=== Cloud Foundry ===
{| class="wikitable"
!Сборки
!Версии
|-
|Java buildpack
|3.11+
|-
|PHP buildpack
|v4.3.34+
|-
|Staticfile buildpack
|v1.4.6+
|-
|Go buildpack
|v1.8.41+
|-
|.NET Core on Linux buildpack
|v3.1+
|-
|Node.js buildpack
|v1.6.10+ (требуется ЕдиныйАгент версии 1.131 или выше)
|-
|IBM WebSphere Liberty buildpack
|v3.9-20170419-1403+ См. известные проблему
|}

==== IBM Cloud Foundry ====
{| class="wikitable"
!Features
!Версии
|-
|IBM WebSphere Liberty buildpack
|v3.9-20170419-1403+ См. известную проблему
|}

==== Cloud Foundry ====
{| class="wikitable"
!Features
!Версии
|-
|Garden-runC
|v1.0.0+
|-
|BOSH BPM for platform process isolation
|v0.11.0+
|-
|Winc for Windows Server containers
|Windows server 1709+
|-
|VMware Tanzu Application Service (via BOSH add-on)
|См. модель поддержки для службы приложений Tanzu
|}

== Приложения, сервисы и базы данных ==

=== Java и Scala ===
Дополнительные сведения см. в разделе Поддержка/отказ от поддержки Ключ-Астром для версий Java.
{| class="wikitable"
!Виртуальные машины
!Версии
!Платформы
!Архитектуры ЦП
|-
| rowspan="1" |Amazon Corretto
|8 LTS, 11 LTS, 17 LTS
|Linux
|ARM64 (AArch64)
|-
| rowspan="1" |Azul Platform Core (Zulu)
|7, 8 LTS, 11 LTS, 17 LTS, 18
|Alpine Linux 64-bit, Linux, Windows
|x86-64
|-
| rowspan="1" |Azul Platform Prime (Zing)
|66, 76, 8 LTS6, 11 LTS6
|Alpine Linux 64-bit, Linux, Windows
|x86-64
|-
| rowspan="1" |Bellsoft Liberica
|8 LTS, 11 LTS, 17 LTS, 18
|Alpine Linux 64-bit, Linux, Solaris, Windows
|ARM64 (AArch64), PPCLE, SPARC, x86-64
|-
| rowspan="1" |Eclipse Temurin (a.k.a. 'Adoptium')
|8 LTS, 11 LTS, 17 LTS
|AIX, Linux, Windows
|ARM64 (AArch64), POWER8, POWER9, PPCLE, s390x, x86-64
|-
| rowspan="1" |Fujitsu
|5, 6, 8
|Windows
|x86-64
|-
| rowspan="1" |Graal JVM
|85, 115
|Linux, Windows
|x86-64
|-
| rowspan="1" |Hitachi
|5
|Windows
|x86-64
|-
| rowspan="1" |Huawei
|8
|Linux
|ARM64 (AArch64)
|-
| rowspan="1" |IBM JVM
|6, 7, 8 LTS
|AIX, Alpine Linux 64-bit, Linux, Windows
|POWER8, POWER9, PPCBE, PPCLE, s390x, x86-64
|-
| rowspan="1" |IBM Semeru
|8 LTS, 11 LTS, 17 LTS
|AIX, Linux, Windows
|ARM64 (AArch64), POWER8, POWER9, PPCLE, s390x, x86-64
|-
| rowspan="1" |Microsoft OpenJDK
|11 LTS, 17 LTS
|Linux, Windows
|ARM64 (AArch64), x86-64
|-
| rowspan="1" |OpenJ9
|0.81, 0.92, 0.103, 0.114
|Linux
|x86-64
|-
| rowspan="1" |OpenJDK
|6, 7, 8 LTS, 11 LTS, 17 LTS, 18
|Alpine Linux 64-bit, Linux, Windows
|x86-64
|-
| rowspan="1" |Oracle Hotspot JVM
|6, 7, 8 LTS, 11 LTS, 17 LTS, 18
|Alpine Linux 64-bit, Linux, Solaris, Windows
|ARM64 (AArch64), SPARC, x86-64
|-
| rowspan="1" |Oracle JRockit
|6
|Alpine Linux 64-bit, Linux, Solaris, Windows
|SPARC, x86-64
|-
| rowspan="1" |SAP JVM
|7, 8 LTS, 11 LTS, 17 LTS, 18
|Alpine Linux 64-bit, Linux, Windows
|x86-64
|-
| rowspan="1" |Scala
|2.11, 2.12, 2.13
|Alpine Linux 64-bit, Linux, Windows
|x86-64
|}
1 JDK8

2 JDK8, JDK10

3 JDK 11

4 JDK8, JDK11

5 Собственный образ GraalVM не поддерживается.

6 Ограниченная поддержка: Ключ-Астром может предоставлять поддержку только для проблем, которые могут быть воспроизведены на других JVM.
{| class="wikitable"
!Серверы приложений
!Версии
|-
|Apache TomEE
|1.x, 7.x, 8.x
|-
|Apache Tomcat
|6, 7, 8, 8.5, 9
|-
|Eclipse Glassfish
|5.1
|-
|Fujitsu Interstage
|121
|-
|Glassfish
|3.1.x, 4.x, 5.x
|-
|IBM WebSphere Application Server
|8.5.5, 9.0, 8.53
|-
|IBM WebSphere Liberty
|8.5.x - 22.x
|-
|JBoss Enterprise Application Platform
|7
|-
|Oracle WebLogic
|11g4, 12c4, 14c4
|-
|Payara
|4.x2, 5.x2
|-
|WildFly
|8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18-26
|}
1 Ограниченная поддержка: Полностью поддерживаемая базовая технология: Java

2 Ограниченная поддержка: Полностью поддерживаемая базовая технология: Glassfish

3 Начиная с версии ЕдиногоАгента 1.183, в WebSphere Application Server 8.5 поддерживается только Java 7.

4 10.3.x = 11g
{| class="wikitable"
!ESBs and SOA
!Версии
|-
|Apache Camel
|2.21+1
|-
|Apache OpenEJB
|3.1.x
|-
|Mule (HTTP Listener)
|3.5, 3.6, 3.7, 3.8, 3.9, 4.1.x - 4.5.x
|-
|Red Hat Fuse Standalone
|7.0+1
|-
|Red Hat Fuse on OpenShift
|7.0+1
|-
|TIBCO ActiveMatrix BusinessWorks
|5.8.2 - 5.142, 6.42, 6.52, 6.6 - 6.82
|}
1 Поддерживаются только коннекторы Apache Camel Undertow, Kafka и MongoDB.

2 Поддерживаются только рабочие процессы TIBCO, которые запускаются входящим запросом веб-службы, HTTP-запросом или сообщением JMS.
{| class="wikitable"
!Веб-фреймворк
!Версии
|-
|Akka Http client
|10.1, 10.0, 10.2, 10.4
|-
|Akka Http server
|10.1
|-
|Apache HttpAsyncClient
|4.0.x, 4.1.x
|-
|Apache HttpClient
|3.1, 4.x, 5.0.x, 5.1.x
|-
|Apache HttpCore
|4.x1, 5.x2
|-
|Elasticsearch
|1.73, 2.03, 2.13, 2.23
|-
|Grails
|3.x4
|-
|Java HttpUrlConnection
|Все версии поддерживаются
|-
|Java IMS Soap Gateway client
|3.2
|-
|Jetty HTTP client
|7, 8, 9, 10, 11
|-
|Jetty HTTP server
|7, 8, 9, 10
|-
|LinkerdD
|1.x
|-
|Netty
|3.10, 4.x
|-
|Ning Asynchronous HTTP Client
|1.8, 1.9
|-
|OkHttp
|3.x, 4.0.x - 4.3.x, 4.4.x - 4.10.x
|-
|Play Framework
|2.2 - 2.6, 2.7, 2.8
|-
|Reactor Netty HTTP Client
|0.8.x, 0.9.x, 1.0.x, 1.1.x
|-
|Reactor Netty HTTP Server
|0.6.x, 0.7.x, 0.8.x, 0.9.x, 1.0.x
|-
|Servlet Engine
|2.5, 3.0, 3.1, 4.0
|-
|Software AG WebMethods Integration Server
|9.05, 9.5 - 9.125, 10.0 - 10.55
|-
|Spring WebFlux
|5.x
|-
|Spring WebFlux WebClient
|5.x
|-
|undertow.io
|1.x6, 2.0.x - 2.2.x6
|}
1 поддерживается только синхронная обработка запросов

2 поддерживается только обработка запросов HTTP/1.1

3 В настоящее время поддерживается только веб-протокол, а не проприетарный протокол TCP.

4 только в сервлет-контейнере

5 Мониторинг Ключ-Астром ограничивается входящими веб-запросами, которые вызывают любую работу (бизнес-логику) в WebMethods.

6 В настоящее время Ключ-Астром может перехватывать входящие HTTP-запросы только в том случае, если undertow.io настроен на использование Servlet API.
{| class="wikitable"
!Threading
!Версии
|-
|CompletableFuture
|Все версии поддерживаются
|-
|Spring Integration
|5.1.x
|-
|reactor-core
|3.x
|}
{| class="wikitable"
!Веб-сервисы
!Версии
|-
|Apache Axis2
|1.6, 1.7, 1.8
|-
|Apache CXF
|2.x, 3.x
|-
|Hessian web services
|2.1, 3.1, 4.0
|-
|JAX-WS
|2.x
|-
|JBossWS (Wildfly)
|4.x1, 5.x2
|-
|Jersey
|1.x, 2.x
|-
|Play WS API
|2.2, 2.3, 2.4
|-
|REST web services via WINK framework
|1.2, 1.4
|-
|Spring Web Services
|2.x, 3.x
|}
1 Wildfly 8

2 Wildfly 8,9,10
{| class="wikitable"
!Фреймворки баз данных
!Версии
|-
|Cassandra (CQL3) - java-driver-core (ранее известный как 'cassandra-driver-core')
|2.1.1 - 3.5.x, 3.6.x - 3.11.x, 4.0.x - 4.15.x
|-
|Cassandra (Thrift)
|2.x
|-
|JDBC
|4+
|-
|Jedis Redis
|2.x, 3.x, 4.x
|-
|MongoDB Async driver
|3.0-3.6.4
|-
|MongoDB driver
|2.x, 3.0.x - 3.6.x, 3.7.x - 3.11.x, 3.12.x - 4.8.x
|}
{| class="wikitable"
!Messaging clients
!Версии
|-
|ActiveMQ
|4, 5
|-
|ActiveMQ Artemis
|1.x, 2.x
|-
|HornetQ
|2.2, 2.3, 2.4
|-
|IBM MQ client
|8.x, 9.x
|-
|JMS
|1.1, 2.0
|-
|Kafka
|1.0.x - 1.1.x, 2.0.x - 2.3.x, 2.4.x - 2.7.x, 2.8.x, 3.0.x - 3.3.x
|-
|RabbitMQ
|3.x
|-
|Software AG WebMethod Broker and Universal messaging via JMS
|Все версии поддерживаются
|-
|Spring AMQP
|1.5, 2.0, 2.1, 2.2, 2.3
|-
|Tibco EMS
|Все версии поддерживаются1
|}
1 Трассировка поддерживается только через JMS.
{| class="wikitable"
!Remoting frameworks
!Версии
|-
|Akka Remoting
|2.4, 2.5, 2.3, 2.6
|-
|Amazon AWS Lambda SDK
|1.x, 2.x
|-
|Apache Thrift
|0.7.x - 0.13.х
|-
|Glassfish RMI-IIOP
|Все версии поддерживаются
|-
|IBM JVM RMI-IIOP
|Все версии поддерживаются
|-
|JBoss Enterprise Application Platform - RMI-IIOP
|7
|-
|JBoss Enterprise Application Platform - Remoting
|7
|-
|Java CICS Transaction Gateway client
|9.0 - 9.2
|-
|Java IMS TM Resource Adapter
|Все версии поддерживаются
|-
|Java RMI-JRMP
|Все версии поддерживаются
|-
|OpenJDK/Oracle JVM RMI-IIOP
|Все версии поддерживаются
|-
|WebLogic RMI-IIOP
|Все версии поддерживаются
|-
|WebSphere Liberty RMI-IIOP
|Все версии поддерживаются
|-
|WebSphere RMI-IIOP
|Все версии поддерживаются
|-
|gRPC
|1.18 - 1.50
|}
{| class="wikitable"
!Monitoring frameworks
!Версии
|-
|OpenTelemetry
|1.0.x - 1.3.x, 1.4.x - 1.20.x
|-
|OpenTracing
|0.33, 0.32, 0.31
|}
{| class="wikitable"
!Logging frameworks
!Версии
|-
|Log4J2 (Apache)
|2.7.x - 2.12.x, 2.13.0, 2.13.1, 2.13.3, 2.14.x - 2.17.1, 2.17.2 - 2.19.x
|-
|Logback (QOS)
|1.х
|-
|java.util.logging
|Все версии поддерживаются
|}

=== .NET и .NET Core ===
Ключ-Астром поддерживает приложения .NET, написанные на C#. Доступна ограниченная поддержка приложений .NET, написанных на других языках, хотя она и не тестировалась явно.
{| class="wikitable"
!Runtime
!Версии
!Платформы
!Архитектуры ЦП
|-
| rowspan="2" |.NET and .NET Core
|2.01, 2.1, 2.2, 3.0, 3.1
|Alpine Linux 64-bit, Linux, Windows
|x86-64
|-
|5.02, 6.02
|Alpine Linux 64-bit, Linux, Windows
|ARM64 (AArch64), x86-64
|}
1 Ограниченная поддержка: Ключ-Астром может решать только те проблемы, которые можно воспроизвести в поддерживаемых версиях.

2 Alpine Linux (musl libc) на ARM64 (AArch64) не поддерживается.
{| class="wikitable"
!Web framework
!Версии
|-
|ASP.NET Core
|Все версии поддерживаются
|-
|ASP.NET Owin/Katana
|3.0.0+
|-
|HttpClient
|Все версии поддерживаются
|-
|HttpListener
|Все версии поддерживаются
|-
|HttpWebRequest
|Все версии поддерживаются
|}
{| class="wikitable"
!Web service
!Версии
|-
|Azure Functions
|2.x
|}
{| class="wikitable"
!Remoting framework
!Версии
|-
|gRPC
|2.23.2 - 2.29.0
|}
{| class="wikitable"
!Database framework
!Версии
|-
|ADO.NET
|SQL Server, SQL CE, Oracle using Oracle.DataAccess.dll
|-
|MongoDB .NET Driver
|2.3 - 2.7, 2.8 - 2.10
|}
{| class="wikitable"
!Messaging client
!Версии
|-
|.NET RabbitMQ client library
|4.0.0-6.2.1
|-
|Confluent Kafka client library
|1.4.0 - 1.5.3
|-
|IBM MQ client
|8.0 - 9.1
|-
|Microsoft Azure Service Bus Client for .NET
|2.0.0 - 4.0.0
|}
{| class="wikitable"
!Monitoring framework
!Версии
|-
|OpenTelemetry
|1.0.1
|}
{| class="wikitable"
!Logging framework
!Версии
|-
|Microsoft Logging Extensions
|3.0.0
|-
|Serilog
|2.9 - 2.11
|}

=== .NET Framework ===
Ключ-Астром поддерживает приложения .NET, написанные на C#. Доступна ограниченная поддержка приложений .NET, написанных на других языках, хотя она и не тестировалась явно.
{| class="wikitable"
!Runtime
!Версии
!Платформы
!Архитектуры ЦП
|-
| rowspan="1" |.NET Framework
|3.5 SP1, 41, 4.51, 4.5.11, 4.5.2 - 4.8
|Windows
|x86-64
|}
1 Ограниченная поддержка: Ключ-Астром может решать только те проблемы, которые можно воспроизвести в поддерживаемых версиях.
{| class="wikitable"
!Web framework
!Версии
|-
|ASP.NET
|Все версии поддерживаются
|-
|ASP.NET Core
|Все версии поддерживаются
|-
|ASP.NET Owin/Katana
|3.0.0 - 4.0.1
|-
|HttpClient
|Все версии поддерживаются
|-
|HttpListener
|Все версии поддерживаются
|-
|HttpWebRequest
|Все версии поддерживаются
|}
{| class="wikitable"
!Web service
!Версии
|-
|Service Fabric Reliable Services
|2.5-3.4
|}
{| class="wikitable"
!Remoting framework
!Версии
|-
|.NET Remoting
|Все версии поддерживаются
|-
|WCF
|Все версии поддерживаются
|}
{| class="wikitable"
!Database framework
!Версии
|-
|ADO.NET
|SQL Server, SQL CE, ODBC, OLEDB, Oracle using Oracle.DataAccess.dll
|-
|MongoDB .NET Driver
|2.3 - 2.7, 2.8 - 2.10
|}
{| class="wikitable"
!Messaging client
!Версии
|-
|.NET RabbitMQ client library
|3.3.5-6.2.1
|-
|Confluent Kafka client library
|1.4.0 - 1.5.3
|-
|IBM MQ client
|8.0 - 9.1
|-
|MSMQ Client
|Все версии поддерживаются
|-
|Microsoft Azure Service Bus Client for .NET
|2.0.0 - 3.1.1, 3.2.0 - 4.0.0
|}
{| class="wikitable"
!Monitoring framework
!Версии
|-
|OpenTelemetry
|1.0.1
|}
{| class="wikitable"
!Logging framework
!Версии
|-
|Microsoft Logging Extensions
|3.0.0
|-
|Serilog
|2.9 - 2.11
|}

=== C / C++ ===
См. SDK ЕдиногоАгента для C/C++ для пользовательских возможностей трассировки.

=== Go ===

* Поддержка 64-битных бинарных файлов Go, созданных только с помощью набора инструментов Golang.org.
* Политика выпуска Go поддерживает две последние основные версии Go.
* Дополнительные сведения см. в разделе Поддерживаемые версии Go.

{| class="wikitable"
!Go runtime versions
!Версии
!Платформы
!Архитектуры ЦП
|-
| rowspan="1" |Go
|1.15, 1.16, 1.17, 1.18
|Alpine Linux 64-bit, Linux, Windows
|x86-64
|}
{| class="wikitable"
!Web framework
!Версии
|-
|net/http
|Все версии поддерживаются
|}
{| class="wikitable"
!Database frameworks
!Версии
|-
|MySQL
|1.4.1, 1.5.0, 1.6.0
|-
|PostgreSQL (jackc/pgx)
|4.7 - 4.17
|-
|PostgreSQL (lib/pq)
|1.2.0, 1.3.0, 1.4.0 - 1.10.7
|}
{| class="wikitable"
!Remoting frameworks
!Версии
|-
|gRPC
|1.17 - 1.28, 1.29, 1.30 - 1.39, 1.40 - 1.50
|}
{| class="wikitable"
!Monitoring frameworks
!Версии
|-
|OpenTelemetry
|1.0 - 1.71, 1.8 - 1.11
|}
1 Поскольку существует стабильная версия OpenTelemetry, ЕдиныйАгент прекращает поддержку версий-кандидатов на выпуск.
{| class="wikitable"
!Logging frameworks
!Versions
|-
|Logrus
|1.7.1 - 1.91
|-
|Zap
|1.10 - 1.23
|}
1 Версии 1.7.0 и ниже не поддерживаются из-за проблемы состояния гонки во фреймворке Logrus.

'''Примечания:'''

Поддержка ограничена официальными стабильными выпусками Go.

В системах Linux двоичный файл приложения должен быть динамически связан, если только вы не используете статический мониторинг Go.

=== Node.js ===
Node.js следует графику выпуска долгосрочной поддержки (LTS). Дополнительные сведения см. в разделе Поддержка/отказ от поддержки Ключ-Астром для версий Node.js.
{| class="wikitable"
!Node.js versions
!Версии
!Платформы
!Архитектуры ЦП
|-
| rowspan="1" |Node.js
|12, 14, 16, 17, 181
|Alpine Linux 64-bit, Linux, Windows
|ARM64 (AArch64), PPCLE, x86-64
|}
1 Новые функции Node.js 18, помеченные как «экспериментальные», не поддерживаются.
{| class="wikitable"
!Web frameworks
!Версии
|-
|Express
|3, 4
|-
|HTTP, HTTPS
|Все версии поддерживаются
|-
|HTTP/2
|Все версии поддерживаются
|-
|hapi
|17+
|-
|restify
|2.x
|}
{| class="wikitable"
!Database frameworks
!Версии
|-
|Couchbase
|2.4.x, 2.5.x, 2.6.x, 3.x
|-
|IOredis
|4.x
|-
|MongoDB
|2.x, 3.x, 4.x
|-
|MySQL
|2.x
|-
|MySQL2
|1.6.x, 1.7.x, 2.x
|-
|PostgreSQL
|5.x, 6.x, 7.x, 8.x
|-
|Redis
|0.10, 0.12, 1.0, 2.5.x, 3.0.x, 4.x
|-
|SQLite3 (context passing only)
|<5, 5.1+2
|-
|mssql
|5.x, 6.x, 7.x, 8.x
|-
|oracledb
|5.x1
|}
1 Следующие API не поддерживаются: NoSQL, расширенная организация очередей, двухфазная фиксация и уведомление о непрерывном запросе.

2 Обратите внимание, что версии 5.0.x не поддерживаются.

{| class="wikitable"
!Messaging clients
!Версии
|-
|KafkaJs client library
|1.11 - 2.0
|-
|RabbitMQ
|0.2.x, 0.3.2, 0.4.2, 0.5.x, 0.6.x, 0.7.x, 0.8.x, 0.9.x
|}
{| class="wikitable"
!Remoting frameworks
!Версии
|-
|gRPC
|1.10 - 1.24
|-
|grpc-js
|1.x
|}
{| class="wikitable"
!Monitoring frameworks
!Версии
|-
|OpenTelemetry
|1.x
|}
{| class="wikitable"
!Cache
!Версии
|-
|Memcached
|2.2
|}
{| class="wikitable"
!Logging frameworks
!Версии
|-
|pino
|>=5.14.0, 6.x, 7.x, 8.х
|-
|winston
|3.x
|}

=== IBM App Connect Enterprise / IBM Integration Bus ===
{| class="wikitable"
!Versions
!Версии
!Платформы
!Архитектуры ЦП
|-
| rowspan="1" |IBM App Connect Enterprise
|11.0.0.4+, 12.0.3.0+
|AIX, Linux, Windows
|POWER8, POWER9, s390x, x86-64
|-
| rowspan="1" |IBM Integration Bus
|10.x
|AIX, Linux, Windows
|POWER8, POWER9, s390x, x86-64
|}
'''Примечания''':

* Поддерживается только 64-битная версия
* Мониторинг поддерживается для всех типов узлов
* Трассировка поддерживается для следующих типов узлов:
** IBM MQ: MQInput, MQOutput, MQReply
** JMS: JMSInput, JMSOutput
** HTTP: HTTPInput, HTTPReply, HTTPRequest, HTTPAsyncRequest, HTTPAsyncResponse
** ОТДЫХ: RESTRequest, RESTAsyncRequest, RESTAsyncResponse
** Веб-службы: SOAPInput, SOAPReply, SOAPRequest, SOAPAsyncRequest, SOAPAsyncResponse.
** Маршрутизация: Публикация
** Вычисления: Java
** База данных: DatabaseRetrieve, DatabaseRoute

=== PHP ===

* Linux (mod_php, FastCGI or PHP-FPM)
* Windows ЕдиныйАгент версии 1.165 (mod_php and PHP CGI)

{| class="wikitable"
!PHP versions
!Версии
!Платформы
!Архитектуры ЦП
|-
| rowspan="1" |PHP
|7.1 (Zend Engine 3.1),
7.2 (Zend Engine 3.2),

7.3 (Zend Engine 3.3),

7.4 (Zend Engine 3.4),

8.0 (Zend Engine 4.0),

8.1 (Zend Engine 4.1)1
|Alpine Linux 64-bit, Linux, Windows
|ARM64 (AArch64), x86-64
|}
1 Поддерживается PHP 8.1 (от RC1 до 8.1.x). Включите его с помощью переключателя Deep Monitoring «Включить мониторинг PHP 8.1 RC на каждом хосте».

'''Примечание''':

Подробную информацию о поддержке и прекращении поддержки см. в модели поддержки Ключ-Астром для приложений PHP.
{| class="wikitable"
!Database frameworks
!Версии
|-
|Microsoft Driver for PHP for SQL Server
|4.0-5.61
|-
|MongoDB PHP for Linux
|1.3+
|-
|MongoDB PHP for Windows
|1.3+
|-
|Oracle Database
|Все версии поддерживаются
|-
|PDO
|Все версии поддерживаются
|-
|PostgreSQL
|Все версии поддерживаются
|-
|mysql, mysqli
|Все версии поддерживаются
|-
|phpredis
|4.0.0+1
|-
|predis
|1.1.2+
|}
1 Поддерживается только для мониторинга PHP NG.
{| class="wikitable"
!Application platforms
!Версии
|-
|CakePHP
|Все версии поддерживаются
|-
|Drupal
|Все версии поддерживаются
|-
|Joomla
|Все версии поддерживаются
|-
|Laravel
|Все версии поддерживаются
|-
|Magento
|Все версии поддерживаются
|-
|Symfony
|Все версии поддерживаются
|-
|WordPress
|Все версии поддерживаются
|-
|Yii
|Все версии поддерживаются
|}
{| class="wikitable"
!Monitoring frameworks
!Версии
|-
|OpenTelemetry
|0.0.91, 0.0.101, 0.0.111, 0.0.121, 0.0.131, 0.0.141, 0.0.151
|}
1 OpenTelemetry для PHP находится на стадии альфа-версии и недостаточно стабилен для долгосрочной поддержки ЕдиногоАгента. Следовательно, мы можем поддерживать только последнюю версию OpenTelemetry для PHP, доступную на момент выпуска ЕдиногоАгента. Это изменится, когда OpenTelemetry для PHP достигнет стадии выпуска общедоступной версии.
{| class="wikitable"
!Cache
!Версии
|-
|Memcached
|3.0.0+1
|}
1 Поддерживается только для мониторинга PHP NG в Linux и Alpine Linux/MUSL.
{| class="wikitable"
!Logging frameworks
!Версии
|-
|Monolog
|2.3 - 2.4, 3.0
|}

=== Python ===
См. ЕдиныйАгент SDK для Python для пользовательских возможностей трассировки.

== Web servers ==

=== Apache HTTP ===
{| class="wikitable"
!Servers
!Версии
!Платформы
!Архитектуры ЦП
|-
| rowspan="1" |Apache HTTP Server
|2.01, 2.2, 2.4
|Alpine Linux 64-bit, Linux, Solaris, Windows
|ARM64 (AArch64), PPCLE, SPARC, x86-64
|-
| rowspan="1" |Fujitsu Interstage IHS
|122
|Windows
|x86-64
|-
| rowspan="3" |IBM HTTP Server
|7.0.x, 8.0.x
|AIX, Linux, Solaris, Windows
|POWER8, POWER9, PPCLE, SPARC, x86-64
|-
|8.5.x
|AIX, Linux, Solaris, Windows
|POWER8, POWER9, PPCBE, PPCLE, SPARC, s390x, x86-64
|-
|9.0.x
|AIX, Linux, Solaris, Windows
|POWER8, POWER9, PPCLE, SPARC, s390x, x86-64
|-
| rowspan="1" |Oracle HTTP Server
|11g, 12c
|Solaris
|SPARC
|}
1 устарело

2 Fujitsu основан на Apache 2.0 и поэтому уже устарел.

=== Microsoft IIS ===
{| class="wikitable"
!Servers
!Версии
!Платформы
!Архитектуры ЦП
|-
| rowspan="1" |Microsoft IIS
|7.0, 7.5, 8.0, 8.5, 10.0
|Windows
|x86-64
|}

=== Envoy ===
{| class="wikitable"
!Servers
!Версии
!Платформы
!Архитектуры ЦП
|-
| rowspan="1" |Envoy
|1.10.0+1
|Linux
|x86-64
|}
1 Сбор данных на основе Envoy OpenTracing API. Поддерживаются статически настроенные маршруты в файле конфигурации начальной загрузки. Динамически добавленные маршруты, то есть маршруты, добавленные после запуска envoy, не отслеживаются (это может произойти, например, в средах Istio).

=== NGINX ===
Поддержка, выраженная как NGINX 1.11.5+ и R11+, указывает на все последние версии NGINX. Стандартные источники пакетов NGINX регулярно обнаруживаются Ключ-Астром для поддержки последних двоичных файлов. Поддержка последних выпусков NGINX включена в следующие последующие выпуски ЕдиногоАгента (обычно в течение двух недель после каждого выпуска NGINX). Дополнительные сведения см. в разделе NGINX.
{| class="wikitable"
!Servers
!Версии
!Платформы
!Архитектуры ЦП
|-
| rowspan="1" |Kong Gateway
|2.1+
|Alpine Linux 64-bit, Linux
|x86-64
|-
| rowspan="2" |NGINX
|1.4 - 1.11.41
|Alpine Linux 64-bit, Linux
|x86-64
|-
|1.11.5+2
|Alpine Linux 64-bit, Linux
|ARM64 (AArch64), PPCLE, x86-64
|-
| rowspan="2" |NGINX Plus
|R1 - R102
|Alpine Linux 64-bit, Linux
|x86-64
|-
|R11+2
|Alpine Linux 64-bit, Linux
|ARM64 (AArch64), PPCLE, x86-64
|-
| rowspan="1" |OpenResty
|1.11.2.x3, 1.13.6.x3, 1.15.8.x3, 1.17.8.x3, 1.19.3.x3
|Alpine Linux 64-bit, Linux
|x86-64
|-
| rowspan="1" |Tengine
|1.4.2 - 2.2.3
|Alpine Linux 64-bit, Linux
|x86-64
|}
1 Пока конкретные используемые двоичные файлы находятся либо в списке поддерживаемых двоичных файлов, либо соответствующая отладочная информация доступна локально.

2 Последние версии обычно поддерживаются в течение 2 недель после последнего выпуска ЕдиногоАгента.

3 Поддерживается, пока двоичный файл находится в списке поддерживаемых двоичных файлов.

Для NGINX Ключ-Астром предоставляет информацию о:

Все поступающие запросы.

Исходящие запросы, которые исходят от одного из следующих:
{| class="wikitable"
!NGINX Modules
!Версии
|-
|ngx_http_fastcgi_module (fastcgi_pass)
|Все версии поддерживаются
|-
|ngx_http_grpc_module (grpc_pass)
|Все версии поддерживаются
|-
|ngx_http_memcached_module (memcached_pass)
|Все версии поддерживаются
|-
|ngx_http_proxy_module (proxy_pass)
|Все версии поддерживаются
|-
|ngx_http_scgi_module (scgi_pass)
|Все версии поддерживаются
|-
|ngx_http_uwsgi_module (uwsgi_pass)
|Все версии поддерживаются
|}
{| class="wikitable"
!Список дистрибутивов Linux для бинарных файлов NGINX
|-
|<nowiki>http://archive.ubuntu.com</nowiki>
|-
|<nowiki>http://archive.webtatic.com</nowiki>
|-
|<nowiki>http://dl.fedoraproject.org</nowiki>
|-
|<nowiki>http://download.opensuse.org</nowiki>
|-
|<nowiki>http://ftp.debian.org</nowiki>
|-
|<nowiki>http://nginx.org</nowiki>
|-
|<nowiki>http://packages.eu-west-1.amazonaws.com</nowiki>
|-
|<nowiki>http://security.debian.org</nowiki>
|-
|<nowiki>http://www.atomicorp.com</nowiki>
|-
|<nowiki>https://archives.dotdeb.org</nowiki>
|-
|<nowiki>https://buildpacks.cloudfoundry.org</nowiki>
|-
|<nowiki>https://copr-be.cloud.fedoraproject.org</nowiki>
|-
|<nowiki>https://oss-binaries.phusionpassenger.com</nowiki>
|-
|<nowiki>https://packages.dotdeb.org</nowiki>
|-
|<nowiki>https://packages.gitlab.com</nowiki>
|-
|<nowiki>https://plus-pkgs.nginx.com</nowiki>
|-
|<nowiki>https://pulp.inuits.eu</nowiki>
|}
Ключ-Астром поддерживает обновленный полный список поддерживаемых бинарных файлов NGINX.

==== Varnish Cache ====
Как мониторить Varnish Cache

== Мониторинг реального пользователя ==

=== Веб-мониторинг реальных пользователей ===

==== Браузеры ====
Поддерживаются все современные браузеры с поддержкой JavaScript и файлов cookie, но тестируются только указанные ниже браузеры.
{| class="wikitable"
!Браузеры
!Версии
|-
|Android Browser
|3 последние версии
|-
|Google Chrome
|3 последние версии (настольная и мобильная)
|-
|Microsoft Edge
|Последняя версия
|-
|Microsoft Internet Explorer
|8+1
|-
|Mozilla Firefox
|3 последние версии
|-
|Opera
|2 последние версии
|-
|Safari
|3 последние версии (OS X и iOS)
|}
1 Представление совместимости для версий Internet Explorer (IE) до 8 не поддерживается, за исключением IE11, в котором поддерживается представление совместимости для IE7. Однако мы по-прежнему внедряем наш RUM JavaScript на все страницы. Если вы не хотите, чтобы RUM JavaScript внедрялся в официально неподдерживаемые версии, вам необходимо определить соответствующие правила исключения браузера в настройках вашего приложения.

===== Браузеры для записи сеанса =====
{| class="wikitable"
!Браузеры
!Версии
|-
|Android Browser
|2 последние версии
|-
|Google Chrome
|3 последние версии (настольная и мобильная)
|-
|Microsoft Edge
|Последняя версия
|-
|Microsoft Internet Explorer
|111
|-
|Mozilla Firefox
|3 последние версии
|-
|Opera
|2 последние версии
|-
|Safari
|3 последние версии (OS X и iOS)
|}
1 Запись сеанса не поддерживается для IE11, для которого настроен режим совместимости с IE7.

==== Асинхронные запросы и одностраничные приложения ====
Ключ-Астром предлагает общую поддержку для каждого приложения через API XHR или Fetch(), но также предлагает специальную поддержку для перечисленных ниже фреймворков JavaScript.
{| class="wikitable"
!Базовая поддержка
|-
|Fetch API
|-
|XMLHttpRequest (XHR)
|}
{| class="wikitable"
!JavaScript феймворки
!Версии
|-
|AngularJS
|1.0 - 1.7
|-
|Angular
|2.x - 14.x
|-
|Dojo
|1.6.1 - 1.13.x
|-
|Ext JS
|3.4, 4, 5, 6.x
|-
|ICEfaces
|1.8, 2, 3
|-
|jQuery ( Backbone.js )
|1.3 - 1.12, 2.0 - 2.2, 3.0 - 3.6.x
|-
|MooTools
|1.4.5 - 1.6.0
|-
|Prototype
|1.7.x
|-
|Sencha Touch
|2.0 - 2.4
|}

==== Веб-серверы и приложения ====
На следующих веб-серверах и в приложениях ЕдиногоАгента предлагает поддержку автоматического внедрения RUM, доставки RUM JavaScript, пересылки маяков RUM и действия пользователя для корреляции распределенной трассировки.
{| class="wikitable"
!Веб-серверы и приложения
|-
|Apache HTTP Server
|-
|IBM HTTP Server
|-
|Java servlet-based web applications
|-
|Kestrel (ASP.NET Core applications)1
|-
|Microsoft IIS
|-
|NGINX
|-
|Node.js
|-
|Oracle HTTP Server
|}
1 Минимальные требуемые версии: .Net Core 3.1, .Net Standard 2.1, Microsoft.AspNetCore.Http.Abstractions 1.0.2 (для полного фреймворка)

=== Мониторинг реальных пользователей мобильных приложений ===
{| class="wikitable"
!Операционные системы
!Версии
|-
|Android
|5.0+ (API 21+)
|-
|iOS
|9+
|-
|tvOS
|11+
|}
{| class="wikitable"
!Фреймворки
!Версии
|-
|AFNetworking
|3.3
|-
|Alamofire
|5.+
|-
|Apache Cordova1
|9.+
|-
|OkHttp
|3.+2, 4.+2
|-
|Xamarin
|Xamarin.iOS, Xamarin.Android, Xamarin.Forms (.NET Standard 2.0+)
|-
|React Native
|0.59+
|-
|Flutter
|1.12.0+
|-
|UIKit
|Supported
|-
|SwiftUI
|2.0+
|}
1 Подробные требования см. на странице подключаемого модуля Ключ-Астром Cordova на сайте npm.

2 Включая библиотеки на основе OkHttp, такие как Retrofit 2.

=== OneAgent для iOS ===

* 32-битные устройства. ЕдиныйАгент для iOS 8.247 — последняя версия, поддерживающая 32-разрядные устройства.
* Xcode . Мы поддерживаем приложения, созданные с помощью Xcode 13+.

В частности, мы поддерживаем только те версии Xcode, которые Apple разрешает отправлять в App Store. По состоянию на апрель 2022 года все приложения iOS, отправляемые в App Store, должны быть созданы с использованием как минимум Xcode 13. Установите флажок «Отправьте свои приложения iOS в App Store» на сайте Apple Developer, чтобы узнать, какие версии Xcode поддерживаются в настоящее время.

=== Плагин Dynatrace Gradle ===

* Gradle версии 6.1.1+
* Плагин Android Gradle версии 4.0+

Для получения более подробной информации см. плагин Ключ-Астром для Android Gradle.

=== Ключ-Астром OpenKit ===
{| class="wikitable"
!Продукт
!Версии
|-
|Java
|7, 8, 11, 12
|-
|.NET
|Core 3.1, 5, 6
|-
|.NET Framework
|3.5, 4.6, 4.7, 4.8, 4.8.1
|-
|.NET Standard
|2.0
|-
|.NET UWP
|Supported
|-
|.NET PCL
|4.5
|-
|C/C++ Windows
|Visual Studio 2015, 2017, 2019, and 2022
|-
|C/C++ Linux
|GCC 5.0.0+ or CLang 3.8.0+
|-
|Node.js
|14+
|-
|JavaScript
|ES5+
|}
Вы можете просмотреть более подробную информацию на следующих справочных страницах.

Ключ-Астром OpenKit — Java

Ключ-Астром OpenKit — .NET

Ключ-Астром OpenKit — C/C++

Ключ-Астром OpenKit — JavaScript

== Расширения ==
Как правило, расширения Ключ-Астром работают только на физических или виртуальных хостах, а не в контейнерах, но проверяют страницы, зависящие от технологии, на наличие возможных исключений (например, Elasticsearch, HAProxy, Redis).

=== Единый Агент расширения ===
{| class="wikitable"
!Технологии
!Версии
|-
|ActiveMQ
|5.8.0+
|-
|Apache Solr
|6.x, 7.x, 8.x
|-
|Cassandra
|2.0+
|-
|CoreDNS
|1.0.0-1.6.9
|-
|CouchDB
|1.x
|-
|Couchbase
|4.3+
|-
|Elasticsearch
|2.3+
|-
|HAProxy
|1.7+1
|-
|Hadoop
|2.4.1+
|-
|Kafka
|0.9.0.1+
|-
|Memcached
|1.4.24+
|-
|Microsoft SQL Server
|20082, 20122, 20142, 20162, 20172
|-
|MongoDB
|2.6+
|-
|MySQL
|5.73
|-
|PHP-FPM
|Все версии поддерживаются
|-
|PostgreSQL
|9.4+
|-
|RabbitMQ
|3.4.0+4
|-
|Redis
|2.8+
|-
|Spark
|3.x
|-
|Tibco EMS
|8.0+
|-
|WSO2 API Manager
|2.4.0+
|}
1 Только в режиме Daemon-mode (опция -D).

2 Счетчики SQL Server должны быть доступны для пользователя, принадлежащего к группе пользователей системного монитора.

3 Включая Percona Server и MariaDB.

4 Начиная с версии ЕдиногоАгента 1.152 мы поддерживаем мониторинг RabbitMQ с включенным TLS. Для этого требуется RabbitMQ версии 3.6.4+, работающий с Erlang 19.3.6.8+.

=== Расширения АктивногоШлюза ===
{| class="wikitable"
!Технологии
!Версии
|-
|Citrix NetScaler
|10.5+
|-
|Citrix Virtual Apps and Desktops
|7.5.0+, 1912+
|-
|DataPower
|4.0+
|-
|F5 BIG-IP LTM
|11+
|-
|IBM MQ
|8.0+
|-
|IBM iSeries (AS/400) - Preview
|7.2+
|-
|Juniper Networks - Preview
|12.1+
|-
|MySQL
|5.71, 8.01
|-
|SAP ABAP platform
|7.31+
|-
|SAP HANA database
|1.0, 2.0
|-
|Windows Server
|2003+
|}
1 Включая Percona Server и MariaDB (10.1–10.5).

== Источники данных для приема метрик ==
{| class="wikitable"
!Технологии
!Версии
|-
|StatsD
|Все версии поддерживаются1
|}
1 Требуется ЕдиныйАгент EEC. Поддерживается в Windows и Linux и архитектуре ЦП x64.

== Приватные синтетические локации ==
См. Требования к частным синтетическим локациям.

== Уровни поддержки для сторонних технологий ==

=== Поддерживается ===
Мы оказываем поддержку при любых проблемах, непосредственно вызванных Ключ-Астром. Ключ-Астром имеет доступ к этой технологии и, как правило, может воспроизвести распространенные проблемы самостоятельно, но, возможно, потребуется настроить среду по запросу.

=== Ограниченная поддержка ===
Ключ-Астром обеспечивает поддержку ограниченного набора функций для конкретной технологии. В большинстве случаев Ключ-Астром не имеет доступа к технологиям с ограниченной поддержкой. При любых проблемах служба поддержки Ключ-Астром сможет вам помочь, если она сможет воспроизвести проблему в полностью поддерживаемой технологии, которая является основой для ограниченной поддержки.

Ручное инструментирование среды выполнения (NGINX)

2022-11-27T14:50:28Z

Lobanov: Новая страница: «Модуль кода NGINX опирается на заблаговременные предположения об объявлениях внутренних...»

Модуль кода NGINX опирается на заблаговременные предположения об объявлениях внутренних структур данных NGINX и их расположении в памяти во время его автоматического инструментирования. Если базовые объявления структуры данных исправлены (это означает, что исходный код, определяющий эти структуры, был изменен) и, следовательно, предварительные предположения недействительны, автоматическая инструментация, выполняемая модулем кода, может вызвать проблемы в NGINX из-за чтения из, или запись в неправильные части памяти.

Чтобы избежать такого сценария, модуль кода NGINX пытается обнаружить исправленные объявления структур данных NGINX. Если обнаружено исправленное объявление, модуль кода отключает автоматическое инструментирование и отображает следующую заметку на странице «Процесс» в веб-интерфейсе:
Примечание
В этом процессе были обнаружены несовместимые модули NGINX. Автоматическая аппаратура была отключена. Чтобы вручную настроить NGINX, см. Инструментирование среды выполнения вручную.

== Инструментировать пропатченный NGINX ==
Модуль кода NGINX может проверять объявления внутренней структуры данных NGINX при запуске (во время выполнения), вместо того чтобы полагаться на предварительные предположения. При таком подходе Ключ-Астром может без проблем оснастить пропатченный NGINX, но этот подход имеет некоторые ограничения, которые необходимо учитывать.

Примером пропатченного NGINX является Kong Gateway.

=== Ограничения инструментария времени выполнения ===

* Инструментарий времени выполнения зависит от символов отладки, доступных для двоичного файла NGINX, что не всегда так.
* Инструментарий времени выполнения добавляет заметную задержку запуска (10 секунд и более) в NGINX.
* Мой NGINX или Kong Pod в Kubernetes не запускается из-за тайм-аута:
** В облачных развертываниях настройте тайм-ауты запуска пода или контейнера, чтобы предотвратить истечение времени ожидания NGINX при запуске.
** Если NGINX или Kong Pod в Kubernetes не запускается, поищите в журналах упоминание о сбое тестов Liveness или Readiness и настройте начальные значения задержки, тайм-аута и порога сбоя этих тестов на достаточно высокие значения. Точная конфигурация зависит от развертывания.
* Инструментарий выполнения требует больше памяти во время запуска NGINX. Это более высокое пиковое потребление памяти может привести к тому, что поды будут уничтожены Kubernetes (или другими средами выполнения контейнеров) в случае строгих ограничений памяти. Пожалуйста, измените ограничения памяти, чтобы приспособиться к инструментам времени выполнения.

Чтобы вручную настроить пропатченный NGINX во время выполнения

1. Добавьте переменную среды <code>DT_NGINX_RUNTIME_INSTRUMENTATION</code> в ваш NGINX:
DT_NGINX_FORCE_RUNTIME_INSTRUMENTATION=on
2. Перезапустите NGINX, чтобы получить переменную окружения.

NGINX

2022-11-27T14:45:07Z

Lobanov: /* NGINX Plus metrics */

Для NGINX Ключ-Астром предоставляет информацию о:

* Все входящие запросы.
* Исходящие запросы, исходящие от одного из следующих:
** модуль ngx_http_proxy_module ( proxy_pass )
** модуль ngx_http_fastcgi_module (fastcgi_pass)
** модуль ngx_http_memcached_module (memcached_pass)
** модуль ngx_http_scgi_module (scgi_pass)
** модуль ngx_http_uwsgi_module (uwsgi_pass)|
* Захват расширенных показателей NGINX Plus.

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

В Ключ-Астром информационное сообщение появляется в деталях процесса NGINX, когда предпринимается попытка использовать неподдерживаемый двоичный файл или недоступен API для расширенных показателей NGINX Plus.
{| class="wikitable"
!Версия NGINX
!Выпущено вендором
!Конец поддержки вендором
!Первая поддерживаемая версия ЕдиногоАгена
!Последняя поддерживаемая версия ЕдиногоАгента
!Поддержка Ключ-Астром до
!Уровень поддержки Ключ-Астром
|-
|1.11.5+
| -
| -
|1.189
| -
| -
|Поддерживается1
|-
|1.11.5+
| -
| -
|1.169
| -
| -
|Поддерживается1
|-
|1.11.5+
| -
| -
|1.145
| -
| -
|Поддерживается1
|-
|1.4 - 1.11.4
| -
| -
| -
| -
| -
|Поддерживается2
|}
1 Последние версии обычно поддерживаются в течение 2 недель после последнего выпуска ЕдиногоАгента.

2 Пока конкретные используемые двоичные файлы находятся либо в списке поддерживаемых двоичных файлов, либо соответствующая отладочная информация доступна локально.
{| class="wikitable"
!Версия NGINX Plus
!Выпущено вендором
!Конец поддержки вендором
!Первая поддерживаемая версия ЕдиногоАгена
!Последняя поддерживаемая версия ЕдиногоАгента
!Поддержка Ключ-Астром до
!Уровень поддержки Ключ-Астром
|-
|R11+
| -
| -
|1.189
| -
| -
|Поддерживается1
|-
|R11+
| -
| -
|1.169
| -
| -
|Поддерживается1
|-
|R11+
| -
| -
|1.145
| -
| -
|Поддерживается1
|-
|R1 - R10
| -
| -
| -
| -
| -
|Поддерживается2
|}
1 Последние версии обычно поддерживаются в течение 2 недель после последнего выпуска ЕдиногоАгента.

2 Пока конкретные используемые двоичные файлы находятся либо в списке поддерживаемых двоичных файлов, либо соответствующая отладочная информация доступна локально.
{| class="wikitable"
!Версия Tengine
!Выпущено вендором
!Конец поддержки вендором
!Первая поддерживаемая версия ЕдиногоАгена
!Последняя поддерживаемая версия ЕдиногоАгента
!Поддержка Ключ-Астром до
!Уровень поддержки Ключ-Астром
|-
|1.4.2 - 2.2.3
| -
| -
|1.173
| -
| -
|Поддерживается
|}
{| class="wikitable"
!Версия OpenResty
!Выпущено вендором
!Конец поддержки вендором
!Первая поддерживаемая версия ЕдиногоАгена
!Последняя поддерживаемая версия ЕдиногоАгента
!Поддержка Ключ-Астром до
!Уровень поддержки Ключ-Астром
|-
|1.19.3.x
| -
| -
| -
| -
| -
|Поддерживается1
|-
|1.17.8.x
| -
| -
| -
| -
| -
|Поддерживается1
|-
|1.15.8.x
| -
| -
| -
| -
| -
|Поддерживается1
|-
|1.13.6.x
| -
| -
| -
| -
| -
|Поддерживается1
|-
|1.11.2.x
| -
| -
| -
| -
| -
|Ограниченно2
|}
1 Последние версии обычно поддерживаются в течение 2 недель после последнего выпуска ЕдиногоАгента.

2 Поддерживается, пока двоичный файл находится в списке поддерживаемых двоичных файлов.

=== Поддержка NGINX 1.11.5+, NGINX Plus R11+ ===
Стандартные источники пакетов NGINX регулярно обнаруживаются Ключ-Астром для поддержки новейших двоичных файлов.

Поддержка последних выпусков NGINX включена в следующие последующие выпуски одного агента (обычно в течение двух недель после каждого выпуска NGINX). Поддержка новейшего API NGINX Plus может отличаться от поддержки двоичных файлов NGINX.

=== Поддержка NGINX 1.4 - 1.11.4, NGINX Plus R1 - R10 ===
ЕдиныйАгент использует отладочную информацию NGINX из пакетов NGINX для инструментирования NGINX. Стандартные источники пакетов NGINX регулярно обнаруживаются Ключ-Астром для поддержки новых двоичных файлов.

Вот список поддерживаемых двоичных файлов, для которых Ключ-Астром имеет доступную отладочную информацию:

=== Поддержка Tengine ===
Движок основан на NGINX и предоставляет некоторые расширенные возможности.

== Показатели HTTP-соединения NGINX ==
Метриками HTTP-соединения являются:

* Количество вновь поступающих соединений, принятых для обработки или отброшенных
* Количество открытых в данный момент подключений (активно выполняющих операции ввода-вывода чтения/записи или ожидающих подключения к сети)

Чтобы ЕдиныйАгент сообщал о показателях HTTP-соединения, вам необходимо создать NGINX с помощью http_stub_status_module.

=== Как собрать NGINX с помощью http_stub_status_module ===
Используйте параметр конфигурации <code>--with-http_stub_status_module</code>.

=== Как проверить, был ли двоичный файл NGINX собран с помощью http_stub_status_module ===
Вызовите nginx -V в вашей командной строке. Это вернет параметры конфигурации NGINX. Убедитесь, что выходные данные содержат параметр <code>--with-http_stub_status_module</code>.

== NGINX Plus metrics ==
Метрики NGINX Plus захватываются из NGINX Plus Status API (до R15) или NGINX Plus API (R16 +).

API должен быть включен и доступен для ЕдиногоАгента. Если API защищен аутентификацией NGINX, убедитесь, что он доступен с локального хоста для запросов HTTP-GET.

== См. также ==
[[Ручное инструментирование среды выполнения (NGINX)|Ручное инструментирование среды выполнения]]

[[Мониторинг Kong Gateway]]

2022-11-24T17:06:27Z

Lobanov:

2022-11-21T17:27:20Z

Lobanov: /* Ячейки */

На этой странице описывается, какие функции и возможности доступны в различных вариантах бессерверных сервисов вычислений для функций (FaaS).

Ключ к столбцам и ячейкам

==== Столбцы ====
{| class="wikitable"
!Заголовок
!Описание
|-
|Метрики и метаданные облачной платформы
|Ключ-Астром имеет интеграцию с облачным провайдером для сбора метрик и метаданных на уровне платформы.
|-
|Журналы
|Ключ-Астром собирает журналы ресурсов и/или приложений.
|-
|Распределенная трассировка
|Ключ-Астром поддерживает распределенную трассировку для этих сервисов либо путем специальной интеграции, либо через OpenTelemetry.
|-
|Автоматическая трассировка
|Ключ-Астром обеспечивает автоматическую готовую трассировку без изменения кода.
|-
|OpenTelemetry/Расширение трассировки
|Ключ-Астром предоставляет возможность улучшить трассировку с помощью OpenTelemetry, собственных SDK и пользовательских сервисов.
|-
|Пользовательские показатели
|Ключ-Астром предоставляет возможность добавлять пользовательские метрики через API, OpenTelemetry, Spring Micrometer и многие другие средства.
|-
|Автоматический RUM
|Ключ-Астром обеспечивает готовый мониторинг реальных пользователей без необходимости внесения изменений в код.
|-
|Безагентный RUM
|Ключ-Астром обеспечивает безагентную интеграцию для мониторинга реальных пользователей.
|}

==== Ячейки ====
{| class="wikitable"
|-
|GA
|Общедоступный и полностью поддерживаемый.
|-
|Превью
|Эти функции находятся на завершающей стадии разработки и готовы к предварительному просмотру. Функции предварительного просмотра не готовы к продакшену и официально не поддерживаются.
|-
|В перспективе
|Функция или технологическая поддержка, которая либо включена в дорожную карту, либо может быть рассмотрена по запросу.
|-
|Не планируется
|Функция или технологическая поддержка, которую Ключ-Астром в настоящее время не планирует использовать.
|-
|n/a
|Нет поддержки
|}

== AWS Lambda ==
{| class="wikitable"
!Язык
!Метрики и метаданные облачной платформы
!Журналы
!Распределенная трассировка
!Автоматическая трассировка
!OpenTelemetry/Расширение трассировки
!Пользовательские показатели
!Автоматический RUM
!Безагентный RUM
|-
| colspan="9" |
==== Классическое развертывание4 ====
|-
|Python
|GA
|GA
|GA
|GA1
|GA
|GA
|GA1
|n/a
|-
|Java
|GA
|GA
|GA
|GA1
|GA
|GA
|GA1
|n/a
|-
|Node.js
|GA
|GA
|GA
|GA1
|GA
|GA
|GA1
|n/a
|-
|.NET Core
|GA
|GA
|GA3
|В перспективе
|GA3
|GA
|В перспективе
|GA
|-
|GoLang
|GA
|GA
|GA
|В перспективе
|GA
|GA
|В перспективе
|GA
|-
| colspan="9" |
==== Образы контейнеров4 ====
|-
|Python
|GA
|GA
|GA
|GA2
|GA
|GA
|GA2
|n/a
|-
|Java
|GA
|GA
|GA
|GA2
|GA
|GA
|GA2
|n/a
|-
|Node.js
|GA
|GA
|GA
|GA2
|GA
|GA
|GA2
|n/a
|-
|.NET Core
|GA
|GA
|GA3
|В перспективе
|GA3
|GA
|В перспективе
|GA
|-
|GoLang
|GA
|GA
|GA
|В перспективе
|GA
|GA
|В перспективе
|GA
|}
1 Требуется интеграция расширения Ключ-Астром через Ключ-Астром Lambda Layer. Поддерживаемые среды выполнения: Python 3.8 и 3.9, Java 8 и 11, Nodes.js 12 и 14.

2 Требуется интеграция расширения Ключ-Астром в образ контейнера.

3 Отследить AWS Lambda .Net Core

4 Поддерживаются как 64-разрядные архитектуры ARM (процессоры AWS Graviton2), так и 64-разрядные архитектуры x86.

== Azure Functions ==
{| class="wikitable"
!Язык
!Метрики и метаданные облачной платформы
!Журналы
!Распределенная трассировка
!Автоматическая трассировка
!OpenTelemetry/Расширение трассировки
!Пользовательские показатели
!Автоматический RUM
!Безагентный RUM
|-
| colspan="9" |
==== План AppService на базе Windows или среда службы приложений ====
|-
|.NET Core
|GA
|GA
|GA
|GA1
|GA
|GA
|В перспективе
|GA
|-
|Java
|GA
|GA
|GA
|В перспективе
|GA
|GA
|В перспективе
|GA
|-
|Node.js
|GA
|GA
|GA
|В перспективе
|GA
|GA
|В перспективе
|GA
|-
|Python
|GA
|GA
|GA
|В перспективе
|GA
|GA
|В перспективе
|GA
|-
| colspan="9" |
==== План службы приложений на базе Linux или среда службы приложений ====
|-
|.NET Core
|GA
|GA
|GA
|GA2
|GA
|GA
|В перспективе
|GA
|-
|Java
|GA
|GA
|GA
|В перспективе
|GA
|GA
|В перспективе
|GA
|-
|Node.js
|GA
|GA
|GA
|В перспективе
|GA
|GA
|В перспективе
|GA
|-
|Python
|GA
|GA
|GA
|В перспективе
|GA
|GA
|В перспективе
|GA
|-
| colspan="9" |
==== Потребительский или Премиум-план ====
|-
|.NET Core
|GA
|GA
|GA3
|В перспективе
|GA
|GA
|В перспективе
|GA
|-
|Java
|GA
|GA
|GA
|В перспективе
|GA
|GA
|В перспективе
|GA
|-
|Node.js
|GA
|GA
|GA
|В перспективе
|GA
|GA
|В перспективе
|GA
|-
|Python
|GA
|GA
|GA
|В перспективе
|GA
|GA
|В перспективе
|GA
|}
1 Требуется интеграция ЕдиногоАгента через расширение сайта Ключ-Астром для служб приложений Azure.

2 Требуется интеграция ЕдиногоАгента в AppServices для Linux и контейнеров.

3 Отслеживание функций Azure в плане потребления Azure

== Runtimes ==
{| class="wikitable"
!Язык
!Распределенная трассировка
!Автоматическая трассировка
|-
| colspan="3" |
==== Runtime v1 ====
|-
|Все языки
|GA
|Не планируется
|-
| colspan="3" |
==== Runtime v2 ====
|-
|.NET Core1
|GA
|GA2
|-
|Другие языки
|GA
|В перспективе
|-
| colspan="3" |
==== Runtime v3-v4 ====
|-
|.NET Core1
|GA
|GA2
|-
|.Net Core, Isolated-Process
|GA
|В перспективе
|-
|Другие языки
|GA
|В перспективе
|}
1 Функции, написанные на C# (библиотеки классов), сценарии C# (.csx) и F# (.fsx), которые выполняются в внутрипроцессной модели.

2 Ограничено функциями, развернутыми в AppService-Plan/Appservice-Environment или Kubernetes.

== Фреймворки ==
{| class="wikitable"
!Язык
!Распределенная трассировка
!Автоматическая трассировка
|-
| colspan="3" |
==== Durable Functions ====
|-
|.NET Core
|Превью1
|В перспективе
|-
|Other languages
|n/a1
|В перспективе
|}
1 Пакет SDK для устойчивых функций имеет бета-поддержку распределенной трассировки для .NET Core с использованием Application-Insights.

== Google Cloud Functions ==
{| class="wikitable"
!Язык
!Метрики и метаданные облачной платформы
!Журналы
!Распределенная трассировка
!Автоматическая трассировка
!OpenTelemetry/Расширение трассировки
!Пользовательские показатели
!Автоматический RUM
!Безагентный RUM
|-
|Python
|GA
|GA
|GA
|В перспективе
|GA
|GA
|В перспективе
|GA
|-
|GoLang
|GA
|GA
|GA
|В перспективе
|GA
|GA
|В перспективе
|GA
|-
|.NET Core
|GA
|GA
|GA
|В перспективе
|GA
|GA
|В перспективе
|GA
|-
|Java
|GA
|GA
|GA
|В перспективе
|GA
|GA
|В перспективе
|GA
|-
|Node.js
|GA
|GA
|GA1
|В перспективе
|GA
|GA
|В перспективе
|GA
|}
1 Отслеживание функций Google, написанных на Node.js