Dynatrace - Вклад [ru]

Настройка прокси АктивногоШлюза

2022-09-28T20:07:48Z

RGolovanov:

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

== Свойства конфигурации прокси ==
Конфигурация прокси АктивногоШлюза состоит из следующих настроек. В зависимости от типа связи, для которой вы хотите использовать (или отключить) прокси, следующие свойства конфигурации могут появиться в разных разделах конфигурации вашей конфигурации АктивногоШлюза.
{| class="wikitable"
!Свойство
!Описание
|-
|<code>proxy-server</code>
|Адрес сервера (имя хоста или IP-адрес)
|-
|<code>proxy-port</code>
|Порт (необязательно)

Если оставить пустым, используется порт <code>8080</code> по умолчанию.
|-
|<code>proxy-user</code>
|Имя пользователя (необязательно)
|-
|<code>proxy-domain</code>
|Домен пользователя в случае аутентификации NTLM
|-
|<code>proxy-password</code>
|Пароль (необязательно)

Пароль, указанный в свойстве <code>proxy-password</code>, обфусцируется после перезапуска АктивногоШлюза, а замаскированный пароль сохраняется в свойстве <code>proxy-password-encr</code>.
|-
|<code>proxy-off</code>
|Если установлено значение <code>true</code>, прокси отключается для определенного типа связи.
|-
|<code>proxy-non-proxy-hosts</code>
|Список хостов, для связи с которыми АктивныйШлюз не должен использовать прокси

Хосты в списке должны быть разделены символом <code>|</code> персонажи. Вы также можете использовать звездочку <code>*</code> в качестве подстановочного знака для соответствия любой строке. Может быть только один подстановочный знак в начале или в конце имени хоста. Например, <code>proxy-non-proxy-hosts=*.foo.com|localhost</code> указывает, что каждый хост в домене <code>foo.com</code> и <code>localhost</code> должен быть доступен напрямую, даже если указан прокси-сервер. Полное описание допустимого синтаксиса см. в синтаксисе параметра <code>http.nonProxyHosts</code> в свойствах сети.
|}

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

* Отредактируйте файл <code>custom.properties</code> в каталоге конфигурации АктивногоШлюза.
* Укажите параметры прокси в соответствующем разделе конфигурации файла <code>custom.properties</code>, в зависимости от того, для каких целей вы хотите использовать прокси (см. примеры ниже). Например:

<code>[http.client]
proxy-server=127.0.0.1
proxy-port=8080
# basic authentication credentials
proxy-user=username
proxy-password=password</code>

* Сохраните файл <code>custom.properties</code>.
* Перезапустите основную службу АктивногоШлюза. Обратите внимание, что после перезапуска службы пароль прокси, указанный вами в конфигурации, шифруется и перемещается из свойства <code>proxy-password</code> в <code>proxy-password-encr</code>.

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

=== Прокси для всего исходящего трафика ===
[[Файл:ПроксиАктивногоШлюзаДляВсегоТрафика.png]]

Следующая конфигурация охватывает наиболее распространенный случай указания параметров прокси-сервера для исходящего соединения АктивногоШлюза как с кластером Ключ-Астром, так и с отслеживаемыми технологиями, такими как AWS, VMware или Azure.

Укажите параметры, связанные с прокси, в разделе <code>[http.client]</code> файла <code>custom.properties</code>, включая параметры, связанные с аутентификацией, если это необходимо:
<code>[http.client]
proxy-server=127.0.0.1
proxy-port=8080
# basic authentication credentials
proxy-user=username
proxy-password=password</code>

=== Прокси только для кластера ===
[[Файл:ПроксиАктивногоШлюзаДляКластера.png]]

Чтобы настроить прокси специально для кластера, позволяя исходящему мониторинговому трафику напрямую подключаться к отслеживаемым технологиям, задайте настройки прокси в разделе <code>[http.client.internal]</code> конфигурации АктивногоШлюза.
<code>[http.client.internal]
proxy-server=127.0.0.1
proxy-port=8080
# basic authentication credentials
proxy-user=username
proxy-password=password</code>
'''Примечание:'''

Для корректной работы связи АктивногоШлюза после указания вышеперечисленных настроек вам потребуется повторить настройки связи без прокси в <code>http.client.internal</code> или <code>http.client.external</code> и/или вам потребуется создать разделы <code>http.client.internal</code> или <code>http.client.external</code>.

=== Прокси для исходящего трафика с прямым подключением к кластеру ===
[[Файл:ПроксиАктивногоШлюзаДляКластераИТрафика.png]]

Чтобы настроить прокси специально для исходящего трафика мониторинга, но оставить прямое подключение к кластеру:

* Укажите конфигурацию прокси в разделе <code>[http.client]</code> файла <code>custom.properties</code>.
* Отключите прокси в разделе <code>[http.client.internal]</code>.

<code>[http.client]
proxy-server=127.0.0.1
proxy-port=8080
# basic authentication credentials
proxy-user=username
proxy-password=password

[http.client.internal]
proxy-off=true</code>
'''Примечание:'''

Для корректной работы связи АктивногоШлюза после указания вышеперечисленных настроек вам потребуется повторить настройки связи без прокси в <code>http.client.internal</code> или <code>http.client.external</code> и/или вам потребуется создать разделы <code>http.client.internal</code> или <code>http.client.external</code>.

== Расширенные сценарии настройки прокси для АктивногоШлюза ==
Чтобы настроить прокси '''для исходящих подключений''' из АктивногоШлюза, то есть для подключений к отслеживаемым технологиям или к кластеру, отредактируйте файл <code>custom.properties</code> и задайте свойства в соответствующем разделе. В зависимости от раздела конфигурации, в котором указаны свойства, прокси (и другие параметры связи) влияют только на выбранные типы соединений:

* <code>[http.client]</code> — настройки прокси для всех исходящих соединений АктивногоШлюза, включая кластер и все отслеживаемые технологии.
* <code>[http.client.internal]</code> — настройки прокси специально для связи с кластером. Эти настройки переопределяют настройки, указанные в <code>[http.client]</code>.
* <code>[http.client.external]</code> — настройки прокси специально для отслеживаемых технологий: CloudFoundry, Kubernetes, приватный синтетический мониторинг. Эти настройки переопределяют настройки, указанные в <code>[http.client]</code>.
* <code>[<technology name>]</code> — настройки прокси специально для конкретной отслеживаемой технологии, например <code>cloudfoundry_monitoring</code>, <code>kubernetes_monitoring</code>, <code>synthetic</code>. Эти параметры переопределяют параметры, указанные в <code>[http.client]</code> и <code>[http.client.external]</code>. Обратите внимание, что настройки для многих из этих технологий можно указать совместно в <code>[http.client.external]</code>.

=== Прокси для Kubernetes, Cloud Foundry и Синтетики ===
Вы можете указать настройки прокси сразу для нескольких отслеживаемых технологий. Настройки, указанные в разделе <code>http.client.external</code>, влияют на Kubernetes, CloudFoundry и приватный синтетический мониторинг (этот набор может быть расширен в будущем):
<code>[http.client.external]
proxy-server=127.0.0.1
proxy-port=8080
# basic authentication credentials
proxy-user=username
proxy-password=password</code>
'''Примечание:'''

Для корректной работы связи АктивногоШлюза после указания вышеперечисленных настроек вам потребуется повторить настройки связи без прокси в <code>http.client.internal</code> или <code>http.client.external</code> и/или вам потребуется создать разделы <code>http.client.internal</code> или <code>http.client.external</code>.

=== Разные настройки прокси для Kubernetes, Cloud Foundry и Синтетики ===
Вы также можете указать выделенные настройки прокси для конкретной отслеживаемой технологии:

* Cloud Foundry в разделе <code>cloudfoundry_monitoring</code>
* Kubernetes в разделе <code>kubernetes_monitoring</code>
* Приватный синтетический мониторинг в разделе <code>synthetic</code>

<code>[kubernetes_monitoring]
proxy-server=127.0.0.1
proxy-port=8080
# basic authentication credentials
proxy-user=username
proxy-password=password</code>

== Текущие ограничения ==

=== Повторение настроек связи в <code>[http.client.internal]</code> или <code>[http.client.external]</code>. ===
При указании конфигурации прокси в <code>[http.client.internal]</code> или <code>[http.client.external]</code> обратите внимание, что эти разделы затрагивают различные аспекты связи, а не только прокси. При создании любого из этих разделов обязательно сначала скопируйте содержимое существующего раздела <code>[http.client]</code> из файла <code>configuration.properties</code> (и настройте его соответствующим образом):

* Откройте файл <code>config.properties</code> и скопируйте все свойства из раздела <code>[http.client]</code> в файл <code>custom.properties</code>, раздел <code>[http.client.internal]</code> или <code>[http.client.external]</code> (в зависимости от ситуации).
* Если в файле <code>custom.properties</code> есть раздел <code>[http.client]</code>, используйте перечисленные там значения, чтобы перезаписать указанные выше значения (значения, которые вы только что скопировали из <code>config.properties</code>).

<code>[http.client.external]
# proxy settings as specific to http.client.external:
proxy-server=127.0.0.1
proxy-port=8080
# basic authentication credentials
proxy-user=username
proxy-password=password
# communication settings copied from existing configuration:
connection-timeout=5000
socket-timeout=20000
connection-request-timeout=5000
idle-connection-timeout=15000
max-total-connections=256
max-connections-per-route=32
certificate-validation=yes
hostname-verification=yes</code>

Схемы подключения АктивныхШлюзов

2022-09-28T20:05:28Z

RGolovanov: Новая страница: «В зависимости от ваших конкретных требований АктивныйШлюз можно использовать в '''Ключ-А...»

В зависимости от ваших конкретных требований АктивныйШлюз можно использовать в '''Ключ-Астром''' '''SaaS''' или '''Managed'''. Ключ-Астром Managed имеет [[Развертывания Managed|несколько сценариев развёртывания]].

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

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

[[Файл:АктивныеШлюзы-SaaS.png]]

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

[[Файл:АктивныеШлюзы-Managed.png]]

== Использование портов ==

* АктивныйШлюз Окружения принимает соединения на порт 9999.
* АктивныйШлюз Кластера принимает соединения на порт 9999.
* Кластер SaaS получает соединения через порт 443.
* Кластер Ключ-Астром Managed (встроенный АктивныйШлюз) принимает соединения через порт 443.

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

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

== Иерархия соединений ==
АктивныеШлюзы существуют в следующей иерархии:

* Уровень 1 — АктивныеШлюзы Окружения
* Уровень 2 — АктивныеШлюзы Кластера
* Уровень 3 — Встроенные в кластер АктивныеШлюзы.

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

'''Примечание'''. АктивныеШлюзы окружения по умолчанию подключаются напрямую к кластеру (если не используются настраиваемые сетевые зоны). Это устраняет промежуточный этап подключения к АктивномШлюзу Кластера. Подключение через АктивныйШлюз Кластера необходимо организовать, если кластер недоступен напрямую. Например, если АктивныйШлюз Окружения находится в другой сети или в другом центре обработки данных.

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

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

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

На приведенной ниже диаграмме показаны все возможные варианты размещения прокси и балансировщика загрузки (обратного прокси) для развертывания АктивногоШлюза. Для простоты прямые подключения на этой диаграмме не показаны. Альтернативные подключения (которые подключаются через один или несколько прокси-серверов или балансировщиков загрузки) показаны пунктирными линиями.

* Если между ЕдинымиАгентами и АктивнымиШлюзами есть балансировщик загрузки, вы должны указать адрес балансировщика загрузки в качестве свойства <code>dnsEntryPoint</code> в конфигурации АктивногоШлюза.
* Если между АктивнымШлюзом и следующей конечной точкой связи, через которую должен проходить трафик, есть балансировщик загрузки, настройте <code>seedServerUrl</code> и <code>ignoreClusterRuntimeInfo</code>.
* Если для доступа к кластеру или любому из отслеживаемых облаков используется прокси-сервер, настройте прокси-сервер.

[[Файл:АктивныеШлюзыБалансировщикиЗагрузки.png]]

Файл:АктивныеШлюзыБалансировщикиЗагрузки.png

2022-09-28T20:02:09Z

RGolovanov:

АктивныеШлюзыБалансировщикиЗагрузки

Файл:АктивныеШлюзы-Managed.png

2022-09-28T19:35:04Z

RGolovanov:

АктивныеШлюзы-Managed

Файл:АктивныйШлюз-Managed.png

2022-09-28T19:34:00Z

RGolovanov:

АктивныйШлюз-Managed

Файл:АктивныеШлюзы-SaaS.png

2022-09-28T19:28:32Z

RGolovanov:

АктивныеШлюзы-SaaS

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

2022-09-28T19:16:16Z

RGolovanov: Новая страница: «== Linux == {| class="wikitable" !'''Цель каталога''' !'''Путь по умолчанию'''Путь относительно параметра ус...»

== Linux ==
{| class="wikitable"
!'''Цель каталога'''
!'''Путь по умолчанию'''Путь относительно параметра установки
!'''Требования к дисковому пространству'''(если размер не указан, предположим, что он меньше 1 МБ)
|-
|Исполняемые файлы АктивногоШлюза, библиотеки и связанные файлы
|<code>/opt/AstromKey/gateway</code><code><INSTALL>/gateway</code>
|300 МБ
|-
|Конфигурация АктивногоШлюза
|<code>/var/lib/AstromKey/gateway/config</code><code><CONFIG>/gateway/config</code>
|
|-
|SSL-папка АктивногоШлюза
|<code>/var/lib/AstromKey/gateway/ssl</code><code><CONFIG>/gateway/ssl</code>
|
|-
|Временные файлы АктивногоШлюза
|<code>/var/tmp/AstromKey/gateway</code><code><TEMP>/gateway</code>
|4 ГБ (включая 3 ГБ для кэшированных установщиков ЕдиныхАгентов и образов контейнеров)
|-
|Логи АктивногоШлюза
|<code>/var/log/AstromKey/gateway</code><code><LOG>/gateway</code>
|500 МБ
|-
|Файлы дампа, загруженные в АктивныйШлюз ЕдинымАгентом
|<code>/var/lib/AstromKey/gateway/dump</code>
|Функциональность отключена по умолчанию. При активации может принимать настраиваемый максимальный размер: по умолчанию 100 ГБ.
|-
|Каталог пакетов АктивногоШлюза для загрузки установщика автоматического обновления
|<code>/var/lib/AstromKey/packages</code><code><PACKAGES_DIR></code>
|500 МБ
|-
|Исполняемые файлы расширений 1.0 и 2.0 АктивногоШлюза, библиотеки и связанные файлы
|<code>/opt/AstromKey/remotepluginmodule</code><code><INSTALL>/remotepluginmodule</code>
|350 МБ
|-
|Конфигурация расширений 1.0 и 2.0 АктивногоШлюза, журналы, кеш, рабочая область во время выполнения
|<code>/var/lib/AstromKey/remotepluginmodule</code><code><CONFIG>/remotepluginmodule</code>
|2 ГБ (для журналов и аварийных дампов)
|-
|Каталог загрузки расширений АктивногоШлюза
|<code>/opt/AstromKey/remotepluginmodule/plugin_deployment/</code>
|В зависимости от загруженных расширений
|-
|zRemote исполняемые файлы, библиотеки и связанные файлы
|<code>/opt/AstromKey/zremote</code>Использование каталогов не по умолчанию не поддерживается.
|50 МБ
|-
|zRemote редактируемая пользователем постоянная конфигурация,
zRemote Рабочая область удаленного выполнения, отчеты о сбоях
|<code>/var/lib/AstromKey/zremote/agent</code>Использование каталогов не по умолчанию не поддерживается.
|50 МБ
|-
|Логи zRemote
|<code>/var/lib/AstromKey/zremote/log</code>Установка АктивногоШлюзас zRemote в каталоги, отличные от каталогов по умолчанию, не поддерживается.
|200 МБ
|-
|Частные синтетические исполняемые файлы, библиотеки и связанные файлы
|<code>/opt/AstromKey/synthetic</code><code><INSTALL>/synthetic</code>
|270 МБ
|-
|Приватные синтетические логи
|<code>/var/log/AstromKey/synthetic</code><code><LOG>/synthetic/log</code>
|1 ГБ
|-
|Частные синтетические временные файлы
|<code>/var/tmp/AstromKey/synthetic</code>
|20 ГБ, в том числе
1 ГБ для <code>/var/tmp/AstromKey/synthetic/cache</code> и

1 ГБ для <code>/var/tmp/AstromKey/synthetic/screenshots</code>
|-
|Автообновление
|<code>/opt/AstromKey/autoupdater</code><code><INSTALL>/autoupdater</code>
|Включено в оценку исполняемых файлов АктивногоШлюза
|-
|Логи автообновления
|<code>/var/log/AstromKey/autoupdater</code><code><LOG>/autoupdater</code>
|200 МБ
|}

== Windows ==
'''Примечание'''. В Windows каталог %PROGRAMDATA% обычно скрыт для непривилегированных пользователей. Поэтому вы не можете выбрать его, просматривая папки. Вместо этого, чтобы получить доступ к папке, вставьте путь к папке непосредственно в поле адреса Проводника Windows.
{| class="wikitable"
!'''Цель каталога'''
!'''Путь по умолчанию'''Путь относительно параметра установки
!'''Требования к дисковому пространству'''(если размер не указан, предположим, что он меньше 1 МБ)
|-
|Исполняемые файлы АктивногоШлюза, библиотеки и связанные файлы
|<code>%PROGRAMFILES%\AstromKey\gateway</code><code><INSTALL>\gateway</code>
|300 МБ
|-
|Конфигурация АктивногоШлюза
|<code>%PROGRAMDATA%\AstromKey\gateway\config</code>
|
|-
|SSL-папка АктивногоШлюза
|<code>%PROGRAMDATA%\AstromKey\gateway\ssl</code>
|
|-
|Временные файлы АктивногоШлюза
|<code>%PROGRAMDATA%\AstromKey\gateway\tmp</code>
|4 ГБ (включая 3 ГБ для кэшированных установщиков ЕдиныхАгентов и образов контейнеров)
|-
|Логи АктивногоШлюза
|<code>%PROGRAMDATA%\AstromKey\gateway\log</code>
|500 МБ
|-
|Файлы дампа, загруженные в АктивныйШлюз ЕдинымАгентом
|<code>%PROGRAMDATA%\AstromKey\gateway\dump</code>
|Функциональность отключена по умолчанию. При активации может принимать настраиваемый максимальный размер: по умолчанию 100 ГБ.
|-
|Каталог пакетов АктивногоШлюза для загрузки установщика автоматического обновления
|<code>%PROGRAMDATA%\AstromKey\packages</code>
|500 МБ
|-
|Исполняемые файлы расширений 1.0 и 2.0 АктивногоШлюза, библиотеки и связанные файлы
|<code>%PROGRAMFILES%\AstromKey\remotepluginmodule</code>
|350 МБ
|-
|Конфигурация расширений 1.0 и 2.0 АктивногоШлюза, журналы, кеш, рабочая область во время выполнения
|<code>%PROGRAMDATA%\AstromKey\remotepluginmodule</code>
|2 ГБ (для логов и аварийных дампов)
|-
|Каталог загрузки расширений АктивногоШлюза
|<code>%PROGRAMFILES%\AstromKey\remotepluginmodule\plugin_deployment</code>
|В зависимости от загруженных расширений
|-
|zRemote исполняемые файлы, библиотеки и связанные файлы
|<code>%PROGRAMFILES%\AstromKey\zremote</code>
|50 МБ
|-
|zRemote редактируемая пользователем постоянная конфигурация,
zRemote Рабочая область удаленного выполнения, отчеты о сбоях
|<code>%PROGRAMDATA%\AstromKey\zremote\agent</code>
|50 МБ
|-
|Логи zRemote
|<code>%PROGRAMDATA%\AstromKey\zremote\log</code>
|200 МБ
|-
|Частные синтетические исполняемые файлы, библиотеки и связанные файлы
|<code>%PROGRAMFILES%\AstromKey\synthetic</code>
|270 МБ
|-
|Приватные синтетические логи
|<code>%PROGRAMDATA%\AstromKey\synthetic\log</code>
|1 ГБ
|-
|Частные синтетические временные файлы
|<code>%PROGRAMDATA%\AstromKey\synthetic</code>
|20 ГБ, в том числе
1 ГБ для <code>/var/tmp/AstromKey/synthetic/cache</code> и

1 ГБ для <code>/var/tmp/AstromKey/synthetic/screenshots</code>
|-
|Автообновление
|<code>%PROGRAMFILES%\AstromKey\gateway</code>Относительно параметра установки: <code><INSTALL>\gateway</code>
|Включено в оценку исполняемых файлов АктивногоШлюза
|-
|Логи автообновления
|<code>%PROGRAMDATA%\AstromKey\autoupdater\log</code>
|200 МБ
|}

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

2022-09-28T19:15:00Z

RGolovanov:

== Требования к установке ==

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

* 4 ГБ свободного места на диске для установки АктивногоШлюза и расширений, настройки и журналов для автоматического обновления.
* 4 ГБ для кэшированных установщиков АктивногоШлюза и ЕдиногоАгента и образов контейнеров — если их нужно будет хранить.
* Место для файлов дампа — если их нужно будет сохранить. Эта функция отключена по умолчанию, но ее можно включить в конфигурации АктивногоШлюза. Максимальный размер дискового пространства настраивается — по умолчанию 100 ГБ.
* Место для загрузки расширений — в зависимости от используемых расширений.
* 2 ГБ оперативной памяти (рекомендуется 4 ГБ).
* 1 двухъядерный процессор.

Для больших сред вам может понадобиться машина с дополнительным процессором и памятью.

=== Требования к пространству по каталогам ===
{| class="wikitable"
!'''Каталог верхнего уровня'''
!'''Требования к дисковому пространству'''
|-
|Исполняемые файлы АктивногоШлюза и автообновления, библиотеки и сопутствующие файлы

стандартный каталог: <code>%PROGRAMFILES%\AstromKey\gateway</code>

относительно параметра установки: <code><INSTALL>\gateway</code>
|300 МБ
|-
|Конфигурация АктивногоШлюза и связанные каталоги

Для АктивногоШлюза Окружения он также содержит конфигурацию Extensions 1.0 и Extensions 2.0.

стандартный каталог: <code>%PROGRAMDATA%\AstromKey</code>

относительно параметра установки: <code><CONFIG></code>
|2 МБ
|-
|Только для АктивногоШлюза Окружения: Исполняемые файлы Extensions 1.0 и Extensions 2.0, библиотеки и связанные файлы по умолчанию: <code>%PROGRAMFILES%\AstromKey\remotepluginmodule</code>

относительно параметра установки: <code><INSTALL>\remotepluginmodule</code>
|350 МБ
|-
|Журналы АктивныхШлюзов и автообновления

стандартный каталог: <code>%PROGRAMDATA%\AstromKey</code>

параметр установки: <code><LOG></code>
|1.2 ГБ
|-
|Временные файлы АктивногоШлюза

default: <code>%PROGRAMDATA%\AstromKey\gateway\tmp</code>

путь относительно параметра установки: <code><TEMP>\gateway</code>
|4 ГБ (включая 3 ГБ для кэшированных установщиков OneAgent и образов контейнеров)
|-
|Файлы дампа, загруженные в АктивныйШлюз ЕдинымАгентом

<code>%PROGRAMDATA%\AstromKey\gateway\dump</code>
|Функциональность отключена по умолчанию, не настраивается во время установки.

При активации может принимать настраиваемый максимальный размер: по умолчанию 100 ГБ.
|-
|Только для АктивногоШлюза Окружения: журналы расширений 1.0 и 2.0 АктивногоШлюза, кэш, рабочая область во время выполнения

стандартный каталог: <code>%PROGRAMDATA%\AstromKey\remotepluginmodule</code>

путь относительно параметра установки: <code><CONFIG>\remotepluginmodule</code>
|2 ГБ
|-
|Только для АктивногоШлюза Окружения: Каталог загрузки расширений

стандартный каталог: <code>%PROGRAMFILES%\AstromKey\remotepluginmodule\plugin_deployment</code>

путь относительно параметра установки: <code><INSTALL>\remotepluginmodule\plugin_deployment</code>
|В зависимости от загруженных расширений
|}

=== Поддерживаемые операционные системы ===
{| class="wikitable"
!Дистрибутив Linux
!Версии
!Архитектуры ЦП
|-
| rowspan="1" |Windows
|8.1, 10
|x86-64
|-
| rowspan="1" |Windows Server
|2012, 2012 R2, 2016, 2019, 2022
|x86-64
|}

=== Системные требования ===

* АктивныйШлюз поддерживает только операционные системы, работающие на архитектуре x86-64 (64-битные Intel/AMD).
* Убедитесь, что у вас правильная конфигурация сетевого порта.
* Установка АктивногоШлюза не поддерживается в Windows с отключенной учетной записью <code>NT AUTHORITY\LocalService</code>.

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

* Мониторинг инфраструктуры
* Мониторинг логов
* Полный стек мониторинга 3 экземпляров Apache Tomcat
* Полный стек мониторинга 2 экземпляров HTTP-сервера Apache

{| class="wikitable"
!Размер машины
!Количество хостов
|-
|c4.large
|450
|-
|c4.xlarge
|900
|-
|c4.2xlarge
|1200
|}
Экземпляры машин С4:
{| class="wikitable"
!Машина
!vCPU
!Память (ГБ)
!Хранилище
!Выделенная пропускная способность EBS (Мбит/с)
!Производительность сети
|-
|c4.large
|2
|3.75
|EBS-Only
|500
|Умеренная
|-
|c4.xlarge
|4
|7.5
|EBS-Only
|750
|Высокая
|-
|c4.2xlarge
|8
|15
|EBS-Only
|1,000
|Высокая
|}

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

=== Разрешите подключения через брандмауэр ===
Убедитесь, что настройки вашего брандмауэра разрешают связь с Ключом-Астром.

В зависимости от политики вашего брандмауэра вам может потребоваться явно разрешить определенные исходящие соединения.

АктивныйШлюз обычно прослушивает (принимает входящие соединения) порт <code>9999</code> и взаимодействует с Ключом-Астром (устанавливает исходящие соединения) через порт <code>443</code>.

=== Установка ===

# Войдите в Ключ-Астром, выберите '''Развернуть Ключ-Астром''' в меню навигации и выберите '''Установить АктивныйШлюз'''.
# На странице '''Установка АктивногоШлюза Окружения''' выберите '''Windows'''.
# Выберите [https://doc.ruscomtech.ru/index.php/%D0%A6%D0%B5%D0%BB%D0%B8%20%D0%90%D0%BA%D1%82%D0%B8%D0%B2%D0%BD%D0%BE%D0%B3%D0%BE%D0%A8%D0%BB%D1%8E%D0%B7%D0%B0 цель АктивногоШлюза].
# Предоставьте PaaS-токен. Он необходим для загрузки установщика АктивногоШлюза из вашей среды. Если у вас нет токена PaaS, вы можете создать его прямо в пользовательском интерфейсе. Токен автоматически добавляется к командам загрузки и установки, которые вы будете использовать позже.
# Скачайте установщик по скопированной cmd-команде или по ссылке.
# Запустите установщик '''с правами администратора'''.

==== Конфигурация установки ====
Вы можете добавить дополнительные параметры в команду установки, чтобы настроить установку. Например, чтобы установить АктивныйШлюз в другой каталог, используйте параметр <code>INSTALL=<путь></code>:
<code>C:\ AstromKey-ActiveGate-Windows-x86-1.0.0.exe '''INSTALL=D:\hosted_app\AstromKey'''</code>

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

Чтобы проверить статус установки, выберите '''Показать статус развертывания''' и перейдите на вкладку '''АктивныеШлюзы'''.
==Стандартные настройки установщика==
Если вы не укажете какие-либо параметры во время установки АктивногоШлюза для настройки параметров, будут применены следующие параметры по умолчанию.
===Каталоги===
{| class="wikitable"
!'''Цель каталога'''
!'''Путь по умолчанию'''Путь относительно параметра установки
!'''Требования к дисковому пространству'''(если размер не указан, предположим, что он меньше 1 МБ)
|-
|Исполняемые файлы АктивногоШлюза, библиотеки и связанные файлы
|<code>%PROGRAMFILES%\AstromKey\gateway</code><code><INSTALL>\gateway</code>
|300 МБ
|-
|Конфигурация АктивногоШлюза
|<code>%PROGRAMDATA%\AstromKey\gateway\config</code>
|
|-
|SSL-папка АктивногоШлюза
|<code>%PROGRAMDATA%\AstromKey\gateway\ssl</code>
|
|-
|Временные файлы АктивногоШлюза
|<code>%PROGRAMDATA%\AstromKey\gateway\tmp</code>
|4 ГБ (включая 3 ГБ для кэшированных установщиков ЕдиныхАгентов и образов контейнеров)
|-
|Логи АктивногоШлюза
|<code>%PROGRAMDATA%\AstromKey\gateway\log</code>
|500 МБ
|-
|Файлы дампа, загруженные в АктивныйШлюз ЕдинымАгентом
|<code>%PROGRAMDATA%\AstromKey\gateway\dump</code>
|Функциональность отключена по умолчанию. При активации может принимать настраиваемый максимальный размер: по умолчанию 100 ГБ.
|-
|Каталог пакетов АктивногоШлюза для загрузки установщика автоматического обновления
|<code>%PROGRAMDATA%\AstromKey\packages</code>
|500 МБ
|-
|Исполняемые файлы расширений 1.0 и 2.0 АктивногоШлюза, библиотеки и связанные файлы
|<code>%PROGRAMFILES%\AstromKey\remotepluginmodule</code>
|350 МБ
|-
|Конфигурация расширений 1.0 и 2.0 АктивногоШлюза, журналы, кеш, рабочая область во время выполнения
|<code>%PROGRAMDATA%\AstromKey\remotepluginmodule</code>
|2 ГБ (для логов и аварийных дампов)
|-
|Каталог загрузки расширений АктивногоШлюза
|<code>%PROGRAMFILES%\AstromKey\remotepluginmodule\plugin_deployment</code>
|В зависимости от загруженных расширений
|-
|zRemote исполняемые файлы, библиотеки и связанные файлы
|<code>%PROGRAMFILES%\AstromKey\zremote</code>
|50 МБ
|-
|zRemote редактируемая пользователем постоянная конфигурация,
zRemote Рабочая область удаленного выполнения, отчеты о сбоях
|<code>%PROGRAMDATA%\AstromKey\zremote\agent</code>
|50 МБ
|-
|Логи zRemote
|<code>%PROGRAMDATA%\AstromKey\zremote\log</code>
|200 МБ
|-
|Частные синтетические исполняемые файлы, библиотеки и связанные файлы
|<code>%PROGRAMFILES%\AstromKey\synthetic</code>
|270 МБ
|-
|Приватные синтетические логи
|<code>%PROGRAMDATA%\AstromKey\synthetic\log</code>
|1 ГБ
|-
|Частные синтетические временные файлы
|<code>%PROGRAMDATA%\AstromKey\synthetic</code>
|20 ГБ, в том числе
1 ГБ для <code>/var/tmp/AstromKey/synthetic/cache</code> и

1 ГБ для <code>/var/tmp/AstromKey/synthetic/screenshots</code>
|-
|Автообновление
|<code>%PROGRAMFILES%\AstromKey\gateway</code>

Относительно параметра установки: <code><INSTALL>\gateway</code>
|Включено в оценку исполняемых файлов АктивногоШлюза
|-
|Логи автообновления
|<code>%PROGRAMDATA%\AstromKey\autoupdater\log</code>
|200 МБ
|}
===Службы===
{| class="wikitable"
|'''Название компонента'''
|'''Наименование службы'''
|'''Учетная запись пользователя'''
|'''Описание'''
|-
|АктивныйШлюз
|<code>AstromKeygateway</code>
|<code>Local Service</code>
|Основной сервис АктивногоШлюза. Присутствует для всех целей и функциональных модулей.
|-
|Автообновление АктивногоШлюза
|<code>AstromKeyautoupdater</code>
|<code>Local Service</code>
|Сервис автоматического обновления. Присутствует для всех целей и функциональных модулей АктивногоШлюза.
|-
|Расширения 1.0 (удаленный подключаемый модуль)
|<code>remotepluginmodule</code>
|<code>Local Service</code>
|Сервис для функционального модуля Extensions 1.0. Присутствует на АктивныхШлюзах, установленных для мониторинга маршрутизации. Эта служба будет активной или неактивной в зависимости от конфигурации — настройки по умолчанию см. в описании модуля.
|-
|Расширения 2.0
|<code>extensionsmodule</code>
|<code>Local Service</code>
|Сервис для функционального модуля Extensions 2.0. Присутствует на АктивныхШлюзах, установленных для мониторинга маршрутизации. Эта служба будет активной или неактивной в зависимости от конфигурации — настройки по умолчанию см. в описании модуля.
|-
|zRemote
|<code>zremote</code>
|<code>Local Service</code>
|Сервис для функционального модуля zRemote. Присутствует на АктивныхШлюзах, установленных с целью маршрутизации трафика z/OS в Ключ-Астром.
|-
|Синтетика
|<code>vuc</code>
|<code>Local Service</code>
|Сервис для Синтетического функционального модуля. Присутствует на АктивныхШлюзах, установленных для запуска синтетических мониторов из частной локации.
|}
===Использование портов===
По умолчанию АктивныйШлюз:
*получает соединения от ЕдиныхАгентов или других АктивныхШлюзов через порт 9999
*получает API Ключ-Астром на порт 9999
*подключается к SaaS или Managed-кластеру через порт 443

== Пользовательские настройки установщика ==
Вам не нужно указывать какие-либо параметры для команды установки, если только вам не нужно настроить такие параметры, как расположение каталогов, конфигурация прокси-сервера, сертификаты SSL и т. д. Для настройки таких параметров можно использовать параметры командной строки и переменные среды.

=== Синтаксис команды установки ===
<code>AstromKey-ActiveGate-Windows-x86-<version>.exe [<parameter1>=<value1>] [<parameter2>=<value2>] ...</code>
Пробелы между именем параметра и значением параметра (вокруг знака <code>=</code>) не допускаются в синтаксисе команды.

=== Конфигурация прокси ===
Конфигурация прокси должна быть указана в следующем формате. Это позволит настроить прокси АктивногоШлюза для всех исходящих соединений (в разделе конфигурации <code>http.client</code>):
<code>PROXY=<схема_прокси><пользователь>:<пароль>@<сервер>:<порт></code>
Где:

* Все компоненты необязательны, кроме <code><server></code>.
* Если не указаны ни <code><пользователь></code>, ни <code><пароль></code>, то символ @ следует опустить.
* <code><пароль></code> можно указать, только если указано имя пользователя.
* ':' после <code><user></code> можно указать, даже если часть пароля пуста.
* <code><схема_прокси></code> не является обязательной и может быть <code>"http://"</code> или <code>"https://"</code>.
* <code><пользователь></code> является необязательным.
* <code><server></code> может быть IP-адресом или DNS-именем, но не путем. Например, если указано «1.2.3.4/textaferslash», будет извлечена только часть IP («1.2.3.4»). Косая черта и следующий за ней текст будут игнорироваться.
* <code><порт></code> является необязательным.

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

Для этого вам необходимо:

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

Такие параметры конфигурации можно указать во время установки АктивногоШлюза, задав следующие параметры командной строки программе установки:
<code>IGNORE_CLUSTER_RUNTIME_INFO=true SERVER=<адрес_обратного_прокси></code>
Кроме того, вы можете настроить АктивныйШлюз после установки, внеся изменения в конфигурацию АктивногоШлюза.

=== Каталог установки ===
Абсолютный путь к каталогу установки можно указать либо в пользовательском интерфейсе установщика, либо в командной строке (версия АктивногоШлюза 1.232+). Эта папка будет использоваться для установки исполняемых файлов и библиотек АктивногоШлюза.
<code>C:\AstromKey-ActiveGate-Windows-x86-1.0.0.exe INSTALL=D:\hosted_app\AstromKey</code>
Сохраняет установочные файлы в указанном каталоге. Значение по умолчанию для этого параметра (если оно не указано) — <code>/opt/AstromKey</code>. Этот параметр не разрешен во время обновления.

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

Таким образом вы можете указать прокси-сертификат ЦС (сертификат, который будет использоваться при подключении АктивногоШлюза к кластеру). Это позволяет установить соединение с кластером во время установки, позволяя программе установки АктивногоШлюза загрузить и установить любые необходимые дополнительные возможности.

Пароль сертификата указывается в виде файла, из которого считывается пароль.

Абсолютный путь к расположению настраиваемых доверенных корневых сертификатов для добавления:
<code>CA_CERTIFICATE_FILE=<path></code>
Абсолютный путь к местоположению файла, содержащего пароль сертификата:
<code>CA_CERTIFICATE_PASSWORD_FILE=<path></code>
Пример команды:mple:
<code>C:\AstromKey-ActiveGate-Windows-x86-<version>.exe CA_CERTIFICATE_FILE=D:\Users\Fred\myCert.jks CA_CERTIFICATE_PASSWORD_FILE=D:\Users\Fred\myPwd.txt</code>

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

Пароль сертификата указывается в виде файла, из которого считывается пароль.

Абсолютный путь к местоположению сертификата аутентификации, который АктивныйШлюз предоставляет подключающимся клиентам, ЕдинымАгентам, или подключениям из браузерных клиентов (таких как RUM JavaScript):
<code>CERTIFICATE_FILE=<path></code>
Абсолютный путь к местоположению файла, содержащего пароль сертификата, для сертификата аутентификации, который АктивныйШлюз предоставляет подключающимся клиентам:
<code>CERTIFICATE_PASSWORD_FILE=<path></code>
Пример команды:
<code>C:\AstromKey-ActiveGate-Windows-x86-<version>.exe CERTIFICATE_FILE=D:\Users\Fred\myCert.jks CERTIFICATE_PASSWORD_FILE=D:\Users\Fred\myPwd.txt</code>

=== Сетевая зона ===
<code>--set-network-zone=<name></code>
Определяет сетевую зону, к которой принадлежит АктивныйШлюз. Он может принадлежать только одной сетевой зоне. Имя сетевой зоны представляет собой строку буквенно-цифровых символов, дефисов <code>(-)</code>, знаков подчеркивания <code>(_)</code> и точек <code>(.)</code>. Точки используются в качестве разделителей, поэтому вы не должны использовать точку в качестве первого символа имени сетевой зоны. Длина строки ограничена 256 символами.

Этот параметр не разрешен во время обновления.

=== Группа ===
<code>--set-group=<name></code>
Определяет группу АктивныхШлюзов, к которой принадлежит АктивныйШлюз. АктивныйШлюз может принадлежать только одной группе. Имя группы АктивныхШлюзов представляет собой строку буквенно-цифровых символов, дефисов (-), знаков подчеркивания (_) и точек (.). Точки используются в качестве разделителей, поэтому вы не должны использовать точку в качестве первого символа имени группы. Длина строки ограничена 256 символами. Вы можете использовать группы АктивныхШлюзов для выполнения массовых действий на ваших АктивныхШлюзах, таких как управление расширениями 2.0, работающими на АктивныхШлюзах.

Этот параметр не разрешен во время обновления.

=== Время соединения ===
<code>ASTROMKEY_ACTIVEGATE_SERVER_CONNECTION_TIMEOUT=<seconds></code>
Определяет максимальное количество секунд (по умолчанию: <code>120</code>), в течение которых программа установки будет ожидать подключения к кластеру. В развертываниях Linux этот параметр необходимо использовать как переменную среды.

Время ожидания соединения, указанное в переменной среды <code>ASTROMKEY_ACTIVEGATE_SERVER_CONNECTION_TIMEOUT=<секунды></code>, используется на двух этапах установки:

* При загрузке дополнительных (необязательных) возможностей.
* При ожидании соединения с кластером в конце установки АктивныхШлюзов: это соединение затем используется АктивнымШлюзом во время его нормальной работы.

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

Чтобы проверить успешность установки и подключения, войдите в AstromKey, в разделе '''Настройки''' выберите '''Статус развертывания''', а затем перейдите на вкладку '''АктивныеШлюзы'''.

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

2022-09-28T19:14:41Z

RGolovanov: /* Стандартные настройки установщика */

== Требования к установке ==

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

* 4 ГБ свободного места на диске для установки АктивногоШлюза и расширений, настройки и журналов для автоматического обновления.
* 4 ГБ для кэшированных установщиков АктивногоШлюза и ЕдиногоАгента и образов контейнеров — если их нужно будет хранить.
* Место для файлов дампа — если их нужно будет сохранить. Эта функция отключена по умолчанию, но ее можно включить в конфигурации АктивногоШлюза. Максимальный размер дискового пространства настраивается — по умолчанию 100 ГБ.
* Место для загрузки расширений — в зависимости от используемых расширений.
* 2 ГБ оперативной памяти (рекомендуется 4 ГБ).
* 1 двухъядерный процессор.

Для больших сред вам может понадобиться машина с дополнительным процессором и памятью.

=== Требования к пространству по каталогам ===
{| class="wikitable"
!'''Каталог верхнего уровня'''
!'''Требования к дисковому пространству'''
|-
|Исполняемые файлы АктивногоШлюза и автообновления, библиотеки и сопутствующие файлы

стандартный каталог: <code>/opt/AstromKey</code>

относительно параметра установки: <code><INSTALL></code>
|300 МБ
|-
|Конфигурация АктивногоШлюза и связанные каталоги

Для АктивногоШлюза Окружения он также содержит конфигурацию Extensions 1.0 и Extensions 2.0.

стандартный каталог: <code>/var/lib/AstromKey</code>

относительно параметра установки: <code><CONFIG></code>
|2 МБ
|-
|Только для АктивногоШлюза Окружения: Исполняемые файлы Extensions 1.0 и Extensions 2.0, библиотеки и связанные файлы по умолчанию: <code>/opt/AstromKey/remotepluginmodule</code>

относительно параметра установки: <code><INSTALL>/remotepluginmodule</code>
|350 МБ
|-
|Журналы АктивныхШлюзов и автообновления

стандартный каталог: <code>/var/log/AstromKey</code>

параметр установки: <code><LOG></code>
|700 MB
|-
|Каталог пакетов АктивногоШлюза для загрузки установщика автоматического обновления

стандартный каталог: <code>/var/lib/AstromKey/packages</code>

параметр установки: <code><PACKAGES_DIR></code>
|500 MB
|-
|Временные файлы АктивногоШлюза

default: <code>/var/tmp/AstromKey/gateway</code>

путь относительно параметра установки: <code><TEMP>/gateway</code>
|4 ГБ (включая 3 ГБ для кэшированных установщиков OneAgent и образов контейнеров)
|-
|Файлы дампа, загруженные в АктивныйШлюз ЕдинымАгентом

<code>/var/lib/AstromKey/gateway/dump</code>
|Функциональность отключена по умолчанию, не настраивается во время установки.

При активации может принимать настраиваемый максимальный размер: по умолчанию 100 ГБ.
|-
|Только для АктивногоШлюза Окружения: журналы расширений 1.0 и 2.0 АктивногоШлюза, кэш, рабочая область во время выполнения

стандартный каталог: <code>/var/lib/AstromKey/remotepluginmodule</code>

путь относительно параметра установки: <code><CONFIG>/remotepluginmodule</code>
|2 ГБ
|-
|Только для АктивногоШлюза Окружения: Каталог загрузки расширений

стандартный каталог: <code>/opt/AstromKey/remotepluginmodule/plugin_deployment</code>

путь относительно параметра установки: <code><INSTALL>/remotepluginmodule/plugin_deployment</code>
|В зависимости от загруженных расширений
|}

=== Поддерживаемые операционные системы ===
{| class="wikitable"
!Дистрибутив Linux
!Версии
!Архитектуры ЦП
|-
| rowspan="1" |Amazon Linux 2
|Поддерживаются все версии
|x86-64
|-
| rowspan="1" |Amazon Linux AMI
|2018.3
|x86-64
|-
| rowspan="1" |CentOS
|7.9
|x86-64
|-
| rowspan="1" |Oracle Linux
|7.9, 8.4
|x86-64
|-
| rowspan="1" |Red Hat Enterprise Linux
|7.9, 8.2, 8.4, 8.6, 9.0
|x86-64
|-
| rowspan="1" |SUSE Enterprise Linux
|15.1, 15.2, 15.3
|x86-64
|-
| rowspan="1" |Ubuntu
|14.04, 16.04, 18.04, 20.04, 22.04
|x86-64
|}

=== Системные требования ===

* АктивныйШлюз поддерживает только операционные системы, работающие на архитектуре x86-64 (64-битные Intel/AMD).
* Убедитесь, что у вас правильная конфигурация сетевого порта.
* Ваша операционная система должна обрабатывать не менее 500 000 открытых файлов для пользователя <code>dtuserag</code>. Чтобы просмотреть системный лимит, выполните следующую команду: <code>[user@host]# cat /proc/sys/fs/file-max</code>. Кроме того, возможно, вы проверили слишком много открытых файлов в Linux.
* В вашей операционной системе должно быть не менее 20 000 процессов, доступных пользователю <code>dtuserag</code>. Чтобы просмотреть ограничение системы, выполните следующую команду: <code>[user@host]# cat /proc/sys/kernel/pid_max</code>.
* Программа установки АктивногоШлюза не поддерживает ACL (список управления доступом). Правила ACL могут запретить доступ к каталогам и файлам, созданным установщиком, из-за чего АктивныйШлюз не запустится. Если вы используете ACL, правила, относящиеся к каталогам установки, определенным в следующих параметрах, должны быть отключены: <code>INSTALL=↵CONFIG=↵LOG=↵TEMP=↵PACKAGES_DIR=</code>

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

* Мониторинг инфраструктуры
* Мониторинг логов
* Полный стек мониторинга 3 экземпляров Apache Tomcat
* Полный стек мониторинга 2 экземпляров HTTP-сервера Apache

{| class="wikitable"
!Размер машины
!Количество хостов
|-
|c4.large
|450
|-
|c4.xlarge
|900
|-
|c4.2xlarge
|1200
|}
Экземпляры машин С4:
{| class="wikitable"
!Машина
!vCPU
!Память (ГБ)
!Хранилище
!Выделенная пропускная способность EBS (Мбит/с)
!Производительность сети
|-
|c4.large
|2
|3.75
|EBS-Only
|500
|Умеренная
|-
|c4.xlarge
|4
|7.5
|EBS-Only
|750
|Высокая
|-
|c4.2xlarge
|8
|15
|EBS-Only
|1,000
|Высокая
|}

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

=== Разрешите подключения через брандмауэр ===
Убедитесь, что настройки вашего брандмауэра разрешают связь с Ключом-Астром.

В зависимости от политики вашего брандмауэра вам может потребоваться явно разрешить определенные исходящие соединения.

АктивныйШлюз обычно прослушивает (принимает входящие соединения) порт <code>9999</code> и взаимодействует с Ключом-Астром (устанавливает исходящие соединения) через порт <code>443</code>.

=== Установка ===

# Войдите в Ключ-Астром, выберите '''Развернуть Ключ-Астром''' в меню навигации и выберите '''Установить АктивныйШлюз'''.
# На странице '''Установка АктивногоШлюза Окружения''' выберите '''Linux'''.
# Выберите [[Цели АктивногоШлюза|цель АктивногоШлюза]].
# Предоставьте PaaS-токен. Он необходим для загрузки установщика АктивногоШлюза из вашей среды. Если у вас нет токена PaaS, вы можете создать его прямо в пользовательском интерфейсе. Токен автоматически добавляется к командам загрузки и установки, которые вы будете использовать позже.
# Скачайте установщик по скопированной <code>wget</code>-команде или по ссылке.
# Проверьте подпись. Дождитесь завершения загрузки. Затем проверьте подпись, скопировав команду из второго текстового поля '''Проверить подпись''' и вставив ее в окно терминала.
# Скопируйте команду установки АктивногоШлюза с указанной целью в терминал.

==== Конфигурация установки ====
Вы можете добавить дополнительные параметры в команду установки, чтобы настроить установку. Например, чтобы установить АктивныйШлюз в другой каталог, используйте параметр <code>INSTALL=<путь></code>:
<code>[root@host]# /bin/bash AstromKey-ActiveGate-Linux-x86-1.0.0.sh '''INSTALL=/hosted_app/AstromKey'''</code>

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

Чтобы проверить статус установки, выберите '''Показать статус развертывания''' и перейдите на вкладку '''АктивныеШлюзы'''.

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

=== Каталоги ===
{| class="wikitable"
!'''Цель каталога'''
!'''Путь по умолчанию'''Путь относительно параметра установки
!'''Требования к дисковому пространству'''(если размер не указан, предположим, что он меньше 1 МБ)
|-
|Исполняемые файлы АктивногоШлюза, библиотеки и связанные файлы
|<code>/opt/AstromKey/gateway</code>

<code><INSTALL>/gateway</code>
|300 МБ
|-
|Конфигурация АктивногоШлюза
|<code>/var/lib/AstromKey/gateway/config</code>

<code><CONFIG>/gateway/config</code>
|
|-
|SSL-папка АктивногоШлюза
|<code>/var/lib/AstromKey/gateway/ssl</code>

<code><CONFIG>/gateway/ssl</code>
|
|-
|Временные файлы АктивногоШлюза
|<code>/var/tmp/AstromKey/gateway</code>

<code><TEMP>/gateway</code>
|4 ГБ (включая 3 ГБ для кэшированных установщиков ЕдиныхАгентов и образов контейнеров)
|-
|Логи АктивногоШлюза
|<code>/var/log/AstromKey/gateway</code>

<code><LOG>/gateway</code>
|500 МБ
|-
|Файлы дампа, загруженные в АктивныйШлюз ЕдинымАгентом
|<code>/var/lib/AstromKey/gateway/dump</code>
|Функциональность отключена по умолчанию. При активации может принимать настраиваемый максимальный размер: по умолчанию 100 ГБ.
|-
|Каталог пакетов АктивногоШлюза для загрузки установщика автоматического обновления
|<code>/var/lib/AstromKey/packages</code>

<code><PACKAGES_DIR></code>
|500 МБ
|-
|Исполняемые файлы расширений 1.0 и 2.0 АктивногоШлюза, библиотеки и связанные файлы
|<code>/opt/AstromKey/remotepluginmodule</code>

<code><INSTALL>/remotepluginmodule</code>
|350 МБ
|-
|Конфигурация расширений 1.0 и 2.0 АктивногоШлюза, журналы, кеш, рабочая область во время выполнения
|<code>/var/lib/AstromKey/remotepluginmodule</code>

<code><CONFIG>/remotepluginmodule</code>
|2 ГБ (для журналов и аварийных дампов)
|-
|Каталог загрузки расширений АктивногоШлюза
|<code>/opt/AstromKey/remotepluginmodule/plugin_deployment/</code>
|В зависимости от загруженных расширений
|-
|zRemote исполняемые файлы, библиотеки и связанные файлы
|<code>/opt/AstromKey/zremote</code>

Использование каталогов не по умолчанию не поддерживается.
|50 МБ
|-
|zRemote редактируемая пользователем постоянная конфигурация,

zRemote Рабочая область удаленного выполнения, отчеты о сбоях
|<code>/var/lib/AstromKey/zremote/agent</code>

Использование каталогов не по умолчанию не поддерживается.
|50 МБ
|-
|Логи zRemote
|<code>/var/lib/AstromKey/zremote/log</code>

Установка АктивногоШлюзас zRemote в каталоги, отличные от каталогов по умолчанию, не поддерживается.
|200 МБ
|-
|Частные синтетические исполняемые файлы, библиотеки и связанные файлы
|<code>/opt/AstromKey/synthetic</code>

<code><INSTALL>/synthetic</code>
|270 МБ
|-
|Приватные синтетические логи
|<code>/var/log/AstromKey/synthetic</code>

<code><LOG>/synthetic/log</code>
|1 ГБ
|-
|Частные синтетические временные файлы
|<code>/var/tmp/AstromKey/synthetic</code>
|20 ГБ, в том числе

1 ГБ для <code>/var/tmp/AstromKey/synthetic/cache</code> и

1 ГБ для <code>/var/tmp/AstromKey/synthetic/screenshots</code>
|-
|Автообновление
|<code>/opt/AstromKey/autoupdater</code>

<code><INSTALL>/autoupdater</code>
|Включено в оценку исполняемых файлов АктивногоШлюза
|-
|Логи автообновления
|<code>/var/log/AstromKey/autoupdater</code>

<code><LOG>/autoupdater</code>
|200 МБ
|}

=== Службы ===
{| class="wikitable"
|'''Название компонента'''
|'''Наименование службы'''
|'''Учетная запись пользователя'''
|'''Описание'''
|-
|АктивныйШлюз
|<code>AstromKeygateway</code>
|по умолчанию: <code>dtuserag</code>

настраивается во время установки
|Основной сервис АктивногоШлюза. Присутствует для всех целей и функциональных модулей.
|-
|Автообновление АктивногоШлюза
|<code>AstromKeyautoupdater</code>
|<code>root</code>
|Сервис автоматического обновления. Присутствует для всех целей и функциональных модулей АктивногоШлюза.
|-
|Расширения 1.0 (удаленный подключаемый модуль)
|<code>remotepluginmodule</code>
|как и для АктивногоШлюза
|Сервис для функционального модуля Extensions 1.0. Присутствует на АктивныхШлюзах, установленных для мониторинга маршрутизации. Эта служба будет активной или неактивной в зависимости от конфигурации — настройки по умолчанию см. в описании модуля.
|-
|Расширения 2.0
|<code>extensionsmodule</code>
|как и для АктивногоШлюза
|Сервис для функционального модуля Extensions 2.0. Присутствует на АктивныхШлюзах, установленных для мониторинга маршрутизации. Эта служба будет активной или неактивной в зависимости от конфигурации — настройки по умолчанию см. в описании модуля.
|-
|zRemote
|<code>zremote</code>
|как и для АктивногоШлюза
|Сервис для функционального модуля zRemote. Присутствует на АктивныхШлюзах, установленных с целью маршрутизации трафика z/OS в Ключ-Астром.
|-
|Синтетика
|<code>vuc</code>
|как и для АктивногоШлюза
|Сервис для Синтетического функционального модуля. Присутствует на АктивныхШлюзах, установленных для запуска синтетических мониторов из частной локации.
|}

=== Пользователь, работающий со службой АктивногоШлюза ===
По умолчанию программа установки АктивногоШлюза использует пользователя <code>dtuserag</code> для запуска службы АктивногоШлюза. Этому пользователю не требуются привилегии root.

Если пользователь <code>dtuserag</code> еще не существует в системе, программа установки создаст его.

=== Использование портов ===
По умолчанию АктивныйШлюз:

* получает соединения от ЕдиныхАгентов или других АктивныхШлюзов через порт 9999
* получает API Ключ-Астром на порт 9999
* подключается к SaaS или Managed-кластеру через порт 443

== Пользовательские настройки установщика ==
Вам не нужно указывать какие-либо параметры для команды установки, если только вам не нужно настроить такие параметры, как расположение каталогов, конфигурация прокси-сервера, сертификаты SSL и т. д. Для настройки таких параметров можно использовать параметры командной строки и переменные среды.

=== Синтаксис команды установки ===
<code>AstromKey-ActiveGate-Linux-x86-<version>.sh [<параметр_1>=<значение_1>] [<параметр_2>=<значение_2>] ...</code>
Пробелы между именем параметра и значением параметра (вокруг знака <code>=</code>) не допускаются в синтаксисе команды.

=== Конфигурация прокси ===
Конфигурация прокси должна быть указана в следующем формате. Это позволит настроить прокси АктивногоШлюза для всех исходящих соединений (в разделе конфигурации <code>http.client</code>):
<code>PROXY=<схема_прокси><пользователь>:<пароль>@<сервер>:<порт></code>
Где:

* Все компоненты необязательны, кроме <code><server></code>.
* Если не указаны ни <code><пользователь></code>, ни <code><пароль></code>, то символ @ следует опустить.
* <code><пароль></code> можно указать, только если указано имя пользователя.
* ':' после <code><user></code> можно указать, даже если часть пароля пуста.
* <code><схема_прокси></code> не является обязательной и может быть <code>"http://"</code> или <code>"https://"</code>.
* <code><пользователь></code> является необязательным.
* <code><server></code> может быть IP-адресом или DNS-именем, но не путем. Например, если указано «1.2.3.4/textaferslash», будет извлечена только часть IP («1.2.3.4»). Косая черта и следующий за ней текст будут игнорироваться.
* <code><порт></code> является необязательным.

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

Для этого вам необходимо:

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

Такие параметры конфигурации можно указать во время установки АктивногоШлюза, задав следующие параметры командной строки программе установки:
<code>--ignore-cluster-runtime-info SERVER=<адрес_обратного_прокси></code>
Кроме того, вы можете настроить АктивныйШлюз после установки, внеся изменения в конфигурацию АктивногоШлюза.

=== Пользователь службы АктивногоШлюза ===
Чтобы указать пользователя, запускающего службу АктивногоШлюза, укажите следующую опцию командной строки:
<code>USER=<user></code>
Установщик создает пользователя, если он еще не существует в системе и ему не требуются привилегии root. Если параметр не указан, установщик создает пользователя <code>dtuserag</code> для запуска службы АктивногоШлюза. Однако вы можете использовать <code>USER=root</code>, чтобы заставить службу работать от имени пользователя root. Примечание: параметр <code>USER=root</code> не поддерживается при установке синтетического АктивногоШлюза.

=== Ограничения для расположения каталогов и точек монтирования ===
<code><настраиваемый_каталог>/gateway</code>, то есть <code>INSTALL/gateway,</code> <code>CONFIG/gateway,</code> <code>LOG/gateway</code>, <code>TEMP/gateway</code>, <code>PACKAGES_DIR/gateway</code>, не может быть родительским для другого настраиваемого каталога, то есть <code>INSTALL</code>, <code>CONFIG</code>, <code>TEMP</code>, <code>LOG</code> или <code>PACKAGED_DIR</code>.

Например, не указывайте:
<code>INSTALL=/AstromKey
LOG=/AstromKey/gateway/logs
CONFIG=/AstromKey/gateway/config
TEMP=/AstromKey/gateway/tmp</code>
Также не указывайте:
<code>CONFIG=/var/lib/AstromKey
PACKAGES_DIR=/var/lib/AstromKey/gateway/packages</code>
Однако разрешен общий родитель, например:
<code>INSTALL=/example/apps
CONFIG=/example/configs
LOG=/example/logs
TEMP=/example/tmp</code>

==== Точки монтирования ====
В процессе установки АктивныйШлюз создает подкаталоги в своих каталогах верхнего уровня. Если вы использовали параметры <code>INSTALL</code> или <code>CONFIG</code> для указания путей, АктивныйШлюз создаст свои подкаталоги по указанным путям. Не создавайте точки монтирования для этих подкаталогов, созданных установщиком. Вы можете монтировать только каталоги верхнего уровня по умолчанию или указанные вами каталоги верхнего уровня.

Например, если вы указали следующий параметр <code>INSTALL</code>:
<code>INSTALL=/opt/MyActiveGate</code>
Программа установки АктивногоШлюза создаст подкаталог <code>gateway</code> в указанном вами пути установки: <code>/opt/MyActiveGate/gateway</code>

Как результат:

* Точка монтирования <code>/opt/MyActiveGate</code> '''КОРРЕКТНА'''.
* Точка монтирования <code>/opt/MyActiveGate/gateway</code> '''НЕКОРРЕКТНА'''.

==== Использование <code>/temp</code> или <code>/tmp</code> ====
Из-за возможной автоматической очистки мы рекомендуем вам не использовать каталоги <code>/temp</code> или <code>/tmp</code> или их подкаталоги для установки АктивногоШлюза или хранения каких-либо данных, сгенерированных или используемых АктивнымШлюзом.

=== Каталог установки ===
<code>INSTALL=<directory></code>
Сохраняет установочные файлы в указанном каталоге. Значение по умолчанию для этого параметра (если оно не указано) — <code>/opt/AstromKey</code>. Этот параметр не разрешен во время обновления.

=== Каталог для хранения загруженных пакетов ===
<code>PACKAGES_DIR=<directory></code>
Сохраняет установочные файлы дополнительных возможностей в указанном каталоге. Значение по умолчанию для этого параметра (если не указано) — <code>/var/lib/AstromKey/packages</code>. Не разрешено во время обновления.

=== Каталог логов ===
<code>LOG=<directory></code>
Сохраняет файлы журналов в указанном каталоге. Значение по умолчанию для этого параметра (если не указано) — <code>/var/log/AstromKey</code>. Не разрешено во время обновления.

=== Каталог конфигурации ===
<code>CONFIG=<directory></code>
Сохраняет файлы конфигурации в указанном каталоге. Значение по умолчанию для этого параметра (если не указано) — <code>/var/lib/AstromKey</code>. Не разрешено во время обновления.

=== Временный каталог ===
<code>TEMP=<directory></code>
Указывает временный каталог, который будет использоваться АктивнымШлюзом. Значение по умолчанию для этого параметра (если не указано) — <code>/var/tmp/AstromKey</code>. Не разрешено во время обновления.

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

Таким образом вы можете указать прокси-сертификат ЦС (сертификат, который будет использоваться при подключении АктивногоШлюза к кластеру). Это позволяет установить соединение с кластером во время установки, позволяя программе установки АктивногоШлюза загрузить и установить любые необходимые дополнительные возможности.

Пароль сертификата указывается в виде файла, из которого считывается пароль.

Абсолютный путь к расположению настраиваемых доверенных корневых сертификатов для добавления:
<code>--ca-certificate-file=<path></code>
Абсолютный путь к местоположению файла, содержащего пароль сертификата:
<code>--ca-certificate-password-file=<path></code>
Пример команды:mple:
<code>[root@host]# ./AstromKey-ActiveGate-Linux-1.217.sh --ca-certificate-file=/home/fred/myCert.jks --ca-certificate-password-file=/home/fred/myPwd.txt</code>

==== Ограничения для указания SSL-сертификата ====
Прямое указание SSL-сертификата для АктивногоШлюза неприменимо для АктивногоШлюза Кластера. Не пытайтесь настроить SSL-сертификаты непосредственно на АктивномШлюзе Кластера. Если вы это сделаете, сертификат будет перезаписан автоматическим управлением Для АктивныхШлюзов Кластера вы должны загрузить свои сертификаты с помощью Консоли Менеджмента Кластера или REST API Кластера v1.

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

Пароль сертификата указывается в виде файла, из которого считывается пароль.

Абсолютный путь к местоположению сертификата аутентификации, который АктивныйШлюз предоставляет подключающимся клиентам, ЕдинымАгентам, или подключениям из браузерных клиентов (таких как RUM JavaScript):
<code>--certificate-file=<path></code>
Абсолютный путь к местоположению файла, содержащего пароль сертификата, для сертификата аутентификации, который АктивныйШлюз предоставляет подключающимся клиентам:
<code>--certificate-password-file=<path></code>
Пример команды:
<code>[root@host]# ./AstromKey-ActiveGate-Linux-1.217.sh --certificate-file=/home/fred/myCert.jks --certificate-password-file=/home/fred/myPwd.txt</code>

=== Сетевая зона ===
<code>--set-network-zone=<name></code>
Определяет сетевую зону, к которой принадлежит АктивныйШлюз. Он может принадлежать только одной сетевой зоне. Имя сетевой зоны представляет собой строку буквенно-цифровых символов, дефисов <code>(-)</code>, знаков подчеркивания <code>(_)</code> и точек <code>(.)</code>. Точки используются в качестве разделителей, поэтому вы не должны использовать точку в качестве первого символа имени сетевой зоны. Длина строки ограничена 256 символами.

Этот параметр не разрешен во время обновления.

=== Группа ===
<code>--set-group=<name></code>
Определяет группу АктивныхШлюзов, к которой принадлежит АктивныйШлюз. АктивныйШлюз может принадлежать только одной группе. Имя группы АктивныхШлюзов представляет собой строку буквенно-цифровых символов, дефисов (-), знаков подчеркивания (_) и точек (.). Точки используются в качестве разделителей, поэтому вы не должны использовать точку в качестве первого символа имени группы. Длина строки ограничена 256 символами. Вы можете использовать группы АктивныхШлюзов для выполнения массовых действий на ваших АктивныхШлюзах, таких как управление расширениями 2.0, работающими на АктивныхШлюзах.

Этот параметр не разрешен во время обновления.

=== Время соединения ===
<code>AstromKey_ACTIVEGATE_SERVER_CONNECTION_TIMEOUT=<seconds></code>
Определяет максимальное количество секунд (по умолчанию: <code>120</code>), в течение которых программа установки будет ожидать подключения к кластеру. В развертываниях Linux этот параметр необходимо использовать как переменную среды.

Время ожидания соединения, указанное в переменной среды <code>ASTROMKEY_ACTIVEGATE_SERVER_CONNECTION_TIMEOUT=<секунды></code>, используется на двух этапах установки:

* При загрузке дополнительных (необязательных) возможностей.
* При ожидании соединения с кластером в конце установки АктивныхШлюзов: это соединение затем используется АктивнымШлюзом во время его нормальной работы.

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

Чтобы проверить успешность установки и подключения, войдите в AstromKey, в разделе '''Настройки''' выберите '''Статус развертывания''', а затем перейдите на вкладку '''АктивныеШлюзы'''.

Например:
<code>[root@host]# export ASTROMKEY_ACTIVEGATE_SERVER_CONNECTION_TIMEOUT=240
[root@host]# AstromKey-ActiveGate-Linux-x86-1.0.0.sh <... other parameters></code>
или вы можете использовать комбинированные команды в одной строке. Например:

<code>[root@host]# export ASTROMKEY_ACTIVEGATE_SERVER_CONNECTION_TIMEOUT=240 ; AstromKey-ActiveGate-Linux-x86-1.0.0.sh <... other parameters></code>

Развертывание АктивногоШлюза в нескольких средах

2022-09-28T19:12:31Z

RGolovanov: Новая страница: «Если вы настроили несколько сред мониторинга, установка и обслуживание нескольких Акти...»

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

Такая конфигурация значительно снижает затраты на обслуживание и настройку. Благодаря этой функции вам не нужно развертывать несколько АктивныхШлюзов и настраивать параметры брандмауэра для каждого дополнительного АктивногоШлюза Окружения. Мультисредовые АктивныеШлюзы способны обрабатывать весь трафик из всех сред, с которыми они связаны.<blockquote>Ограничения

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

* '''Подключения к средам из разных кластеров'''
* Перенаправления трафика z/OS в Ключ-Астром с помощью модуля zRemote
* Мониторинга удаленных технологий с помощью расширений, включая платформу Расширения 1.0 и Расширения 2.0.
* Выполнения мониторов из частных синтетических местоположений
* Запуска анализа базы данных
* Подключения к Ключу-Астром с помощью AWS PrivateLink.

Все остальные функции АктивныхШлюзов поддерживаются.</blockquote>

== Настройка АктивногоШлюза для поддержки нескольких сред ==

=== Отключение и удаление сред ===
'''Убедитесь, что модули АктивногоШлюза, несовместимые с работой в нескольких средах, отключены.'''

Только один из следующих модулей может присутствовать на АктивномШлюзе. Отключение и удаление этих модулей допустимо:

* Расширения 1.0 — отключено в разделе <code>[rpm]</code>
* Расширения 2.0 — отключено в разделе <code>[extension_controller]</code>
* zRemote — отключено в разделе <code>[zremote]</code>
* Синтетика 1.0 — отключена в разделе <code>[синтетика]</code>

Чтобы отключить модули, найдите файл <code>custom.properties</code> в каталоге конфигурации и убедитесь, что для соответствующих свойств конфигурации установлено значение <code>false</code>:
<code>[rpm]
rpm_enabled = false

[zremote]
zremote_enabled = false

[synthetic]
synthetic_enabled = false

[extension_controller]
extension_controller_enabled = false</code>
'''Убедитесь, что модули АктивногоШлюза, несовместимые с работой в нескольких средах, удалены.'''

Для Linux — выполните одну из следующих команд в зависимости от того, какой модуль необходимо удалить. Если вы сомневаетесь, выполните все команды: Если команды будут найдены, соответствующие модули будут удалены. Если команды не найдены, значит модули отсутствуют:
<code>sudo /opt/AstromKey/remotepluginmodule/uninstall.sh
sudo /opt/AstromKey/zremote/uninstall.sh
sudo /opt/AstromKey/synthetic/uninstall.sh</code>

* Для Windows: найдите и удалите следующие приложения, если они установлены:
** '''AstromKey Remote Plugin Module'''
** '''AstromKey ZRemote'''
** '''AstromKey Synthetic'''

=== Конфигурация авторизации среды ===
'''В каталоге конфигурации АктивногоШлюза найдите файл <code>authorization.properties</code> и ознакомьтесь с его содержимым.'''

В файле перечислены сведения для каждой среды, идентифицированные идентификатором среды: <code>tenantToken</code> и, при необходимости, свойствами авторизации.

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

Формат записей в author.properties:
<code>[<environment_ID>]
tenantToken = <tenant_token>
mainTenant = true # ID среды, из которой был загружен АктивныйШлюз
authToken = <authorization_token> # если требуется</code>
Например:
<code>[mySampleEnv]
tenantToken = abcdevjhij1234567890
authToken = dt0g01.HVMTLRLZ.1234567890ZYXWVUTSRQPONMLKJIHGFEDCBA01234567890ABCDEFGHIGKLMNOPQ
mainTenant = true</code>
<blockquote>'''Примечание'''

Из соображений безопасности вы больше не можете найти <code><tenant_token></code> в веб-интерфейсе.</blockquote>

=== Добавление новых сред ===
'''Чтобы добавить больше сред, добавьте новые разделы в файл <code>authorization.properties</code>.'''

Перечислите каждую среду, которую вы хотите поддерживать в АктивномШлюзе. Используйте следующий формат:
<code>[<environment_ID>]
tenantToken = <tenant_token>

[<environment_ID>]
tenantToken = <tenant_token></code>
Например:
<code>[mySampleEnv]
tenantToken = abcdevjhij1234567890

[myAnotherEnv]
tenantToken = 0987654321jijvedcba</code>
<blockquote>Обеспечьте согласованную конфигурацию

Для корректной работы необходимо убедиться, что:

* Все среды, которые должны поддерживаться одной и той же средой АктивногоШлюза, работают в одном и том же кластере.
* Основная среда, связанная со свойством конфигурации <code>mainTenant</code>, настроена правильно. Неправильная конфигурация основной среды приведет к '''отклонению АктивногоШлюза во всех настроенных средах''': в журналах АктивногоШлюза будет зарегистрирована ошибка с информацией о том, что конфигурация <code>mainTenant</code> неверна, а АктивныйШлюз не будет отображаться на страницах состояния развертывания на любой из сред.
</blockquote>

=== Сохранение и перезапуск АктивногоШлюза ===
Сохраните файл <code>authorization.properties</code> и перезапустите основной сервис АктивногоШлюза. Убедитесь, что новые среды успешно добавлены.

Файл журнала АктивногоШлюза должен содержать запись с указанием количества сред, с которыми работает АктивныйШлюз, например:
<code>Working mode is set to MULTITENANT with 5 tenant(s).</code>
Если в сообщении журнала не указано количество сред, которые вы пытались настроить, проверьте файл журнала на наличие записей, указывающих на ошибку в файле <code>authorization.properties</code>. Сообщения об ошибках появляются в таком виде:
<code>Error during parsing config file `...\conf\authorization.properties` - invalid configuration: ...</code>

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

2022-09-28T18:46:19Z

RGolovanov: Новая страница: «Компоненты Ключ-Астром обмениваются данными через SSL, использующий шифры для шифрования...»

Компоненты Ключ-Астром обмениваются данными через SSL, использующий шифры для шифрования HTTP-запросов. Не все доступные шифры в настоящее время считаются достаточно безопасными. Поэтому по умолчанию исключаются некоторые шифры (например, все MD5, все RC4, все DES, все DSS).

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

== Настройка шифров ==

=== Сканирование шифров ===

* Сканируйте поддерживаемые шифры с помощью Nmap. Результатом сканирования будет список, подобный следующему:

<code>PORT STATE SERVICE
9999/tcp open abyss
| ssl-enum-ciphers:
| TLSv1.2:
| ciphers:
| TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384 (secp256r1) - A
| TLS_DHE_RSA_WITH_AES_256_CBC_SHA256 (dh 2048) - A
| TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256 (secp256r1) - A
| TLS_DHE_RSA_WITH_AES_128_CBC_SHA256 (dh 2048) - A
| TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 (secp256r1) - A
| TLS_DHE_RSA_WITH_AES_256_GCM_SHA384 (dh 2048) - A
| TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256 (secp256r1) - A
| TLS_DHE_RSA_WITH_AES_128_GCM_SHA256 (dh 2048) - A
| compressors:
| NULL
| cipher preference: server
|_ least strength: A</code>

=== Исключение шифров ===

* Исключите нежелательные шифры, перечислив их в файле <code>custom.properties</code>. Мы поддерживаем только исключения шаблонов, поэтому в приведенном ниже примере исключение <code>TLS_DHE_RSA_WITH_AES_256_CBC_SHA</code> также исключает <code>TLS_DHE_RSA_WITH_AES_256_CBC_SHA384</code>. В следующем примере показано, как исключить шифры ECDHE из приведенного выше списка:

<code>[com.compuware.apm.webserver]
excluded-ciphers = TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384,TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256,TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384,TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256</code>
Проблема с этим подходом заключается в том, что список становится длинным, и поэтому его трудно поддерживать, если OpenSSL изменяется. Более надежным/динамичным способом является использование подшаблона, как показано в примере ниже.
<code>[com.compuware.apm.webserver]
excluded-ciphers = TLS_ECDHE_</code>
В этом примере будут исключены все имена шифров, содержащие строку <code>TLS_ECDHE_</code>. Этот шаблон исключит дополнительные шифры, если базовый список изменится, например, из-за обновлений OpenSSL.

Чтобы исключить шаблон суффикса, завершите строку шаблона символом <code>$</code>. Чтобы исключить SHA без исключения <code>SHA256</code>, укажите <code>SHA$</code> в качестве шаблона. Например:
<code>[com.compuware.apm.webserver]
excluded-ciphers = TLS_RSA_WITH,_SHA$</code>
Кроме того, вы можете определить, какие шифры вы хотите включить.
<code>[com.compuware.apm.webserver]
included-ciphers = _ECDHE_</code>
Как правило, вы определяете либо включенные, либо исключенные шифры, но не оба.

Обратите внимание, что '''если шифр был определен в списке как включенных, так и исключенных, он будет считаться исключенным — ''исключение имеет приоритет над включением'''''.

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

2022-09-28T18:16:57Z

RGolovanov:

Могут быть ситуации, когда необходимо добавить дополнительные сертификаты в хранилище сертификатов АктивногоШлюза.

=== Добавление сертификатов во время установки АктивногоШлюза ===
При желании дополнительные доверенные корневые сертификаты можно указать во время установки АктивногоШлюза, указав параметры установки для [[Установка АктивногоШлюза на Linux|Linux]] или [[Установка АктивногоШлюза на Windows|Windows]].

== Убедитесь, нужен ли вам сертификат ЦС ==
АктивныйШлюз подключается к другим компонентам Ключа-Астром (кластерам, серверам) или сторонним системам (таким как VMware, Cloud Foundry, Kubernetes или OpenShift) с использованием защищенных SSL каналов. Встроенного хранилища АктивногоШлюза (набор сертификатов по умолчанию, поставляемый с Java), иногда недостаточно для покрытия всех необходимых вариантов использования. Это может произойти, если, например, сертификат был выдан внутри вашей организации для прокси-сервера, принимающего SSL-трафик. Также возможно, что некоторые серверы в вашей организации, к которым АктивныйШлюз должен подключаться, генерируют и используют самоподписанные сертификаты, и ваша организация не заменила их официальными сертификатами.

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

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

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

== Подготовка сертификатов ==
Прежде чем добавлять сертификат в АктивныйШлюз, его необходимо получить и поместить в файл <code>ca.cert</code>.

'''Следующая общая информация о сертификатах ЦС может помочь вам определить необходимые сертификаты:'''

Условия доверенного соединения SSL:

* Между сертификатами, представленными сервером (конечная точка API), и сертификатами, присутствующими в хранилище доверенных сертификатов АктивногоШлюза, должна быть создана полная цепочка сертификатов.
* Корневой сертификат цепочки должен быть включен в хранилище доверенных сертификатов АктивногоШлюза вместе с любыми другими сертификатами, НЕ представленными конечной точкой сервера/API.

Чтобы увидеть, какие сертификаты предоставляет конечная точка, вы можете использовать следующую команду:
<code>openssl s_client -connect <API_ENDPOINT>:<PORT> -showcerts -servername <API_ENDPOINT_HOSTNAME></code>
'''Примечание:'''

Некоторые приложения (например, OpenShift) могут предоставлять разные сертификаты в зависимости от SNI. АктивныйШлюз установит сконфигурированное имя хоста конечной точки в SNI.

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

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

Например, конечная точка запроса <code>openssl</code> к этому серверу возвращает только сертификат сервера, а не корневой сертификат. Вы знаете, что этот сервер представляет только сертификат сервера, а не корневой сертификат, поскольку в сообщении об ошибке говорится, что невозможно получить сертификат локального эмитента. При наличии корневого сертификата в сообщении об ошибке будет указано «<code>Самозаверяющий сертификат в цепочке сертификатов</code>». Чтобы создать действительное SSL-соединение с этой конечной точкой, необходимо отдельно получить корневой сертификат.

Например:
<code>openssl s_client -connect localhost:6443
CONNECTED(00000005)
depth=0 CN = kube-apiserver
verify error:num=20:unable to get local issuer certificate
verify return:1
depth=0 CN = kube-apiserver
verify error:num=21:unable to verify the first certificate
verify return:1
---
Certificate chain
0 s:CN = apiserver
i:CN = AstromKeyRootAuth
---
Server certificate
-----BEGIN CERTIFICATE-----
MDIDYGCCAkigAwIBAgJIJ8SQ/FcmJiYwDQZJKoZIhvcNAQESBQAwFTETMBEGA1UE
AxMKa3ViZXJuZXRlczAeFw0yMTAxMjcxOTM1MDhaFw0yMjAxMjcxOTM1MDhaMBkx
FzAVBgNVBAMTDmt1YmUtYXBpc2VydmVyMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8A
MIIBCgKSAQEA15BVGULXSXZAM6a4Y7lR6JfSBOXIAq1sCoydH2AdhzqHu0mXj+Fd
sooRQ46f7bySZvMGFfLupmaAzH5kVJOVDQ2WoHPYVzAEhDji+SUBOi99AC0tevEa
ONLdkLGzR//2u8XND0iiswsGkK3yaNyPwCVnOnA3c4O32waMoM1VI9XGuNSqqfQF
6XUx8sGHG5bNVzfHOXh5CBJZ5JReDhW/J8CbPElYJPJaQcSpTVFx5ReTQqBLeBSy
eWyCwqMj/jAnKzpPffO478If/Uc8I5vS8zi2yPhYJhKqD0m1b96hH0slXKho25Ip
gpu4cIw03mQZMK558W4d6ccww/OvMbpKQQIDAQABo4GvMIGsMA4GA1UdDwEB/wQE
AwIFoDATBgNVHSUEDDAKBgfrBgEFBQcDATSBhAYDVR0RBH0we4IPamstazhzLWNs
b25lLTAwggprdWJlcm5ldGVzghJrdWJlcm5ldGVzLmRlZmF1bHSCFmt1YmVybmV0
ZXMuZGVmYXVsdC5zdmOCAGt1YmVybmV0ZXMuZGVmYXVsdC5zdmMuY2x1c3Rlci5s
b2NhbIcECmAAAYcErBcSvDANBgkqhkiG9w0BAQsFAAOCAQEAdmOq/Sp74xiLCa14
EI/9v7jUG+GqjD3HPpj/oXIdLHg6HA4nixxcxwnWAf2RAMVXBYn7qTDU6x7W5M+t
6M0uaCe8Od8oKjOKeQ31dfMpPbLYprKmcnuBriiN5gjfghINZKaZlGlX0GkBC9Ts
THYbmWfXfvfsX2xfpc4J0esfK+BafllEimCx8blnw1uY7CiCedEANePT+J5Q+m9L
m5pu7Qz/B4JDHLIJBArhFTBM6IIF6DhoqGUXM1XXqMlTVBpxz2vhf0N/HxcTaEBa
VWu7GZbk5mCYhngmRJ8PJ3uA8yajDT2muWm/la5oOI/GeuTgR98tqjXOXmz2NjvE
Zng1CA==
-----END CERTIFICATE-----
subject=CN = kube-apiserver

issuer=CN = kubernetes

---
Acceptable client certificate CA names
CN = kubernetes</code>
Приведенный ниже сертификат является примером корневого сертификата для вышеуказанного сертификата сервера. Убедитесь, что вы добавляете в свои хранилища доверенных сертификатов только те корневые сертификаты, которым вы доверяете.

Например:
<code>cat ca.crt | openssl x509 -text -noout
Certificate:
Data:
Version: 3 (0x2)
Serial Number: 0 (0x0)
Signature Algorithm: sha256WithRSAEncryption
Issuer: CN = kubernetes
Validity
Not Before: Jan 27 19:35:08 2021 GMT
Not After : Jan 25 19:35:08 2031 GMT
Subject: CN = kubernetes
Subject Public Key Info:</code>
Вы можете видеть, что это корневой сертификат, который вам нужен, потому что субъект и эмитент идентичны, и они совпадают с эмитентом сертификата сервера, показанного выше ('kube-apiserver').

== Создание хранилища доверенных сертификатов из сертификата ЦС ==
Создайте дополнительное хранилище доверенных сертификатов, содержащее только ваши сертификаты ЦС, которые будут объединены в АктивномШлюзе во время выполнения со встроенным хранилищем доверенных сертификатов JDK. Хранилище доверия должно быть в формате <code>PKCS12</code>. Форматы OpenSSL не поддерживаются, поэтому используйте команду <code>keytool</code> для выполнения преобразования. После преобразования вы должны поместить сертификат в каталог SSL АктивногоШлюза .

'''Примечание'''. Если вы импортируете несколько сертификатов, убедитесь, что вы указали уникальный псевдоним для каждого импортируемого сертификата. Если вы используете один и тот же псевдоним для каждого сертификата, все ранее использовавшиеся сертификаты будут перезаписаны.

Примеры для Linux создания файла PKCS12 из файла CRT или файла PEM и размещения его либо непосредственно в каталоге SSL АктивногоШлюза, либо в текущем каталоге для последующего копирования:
<code>/opt/AstromKey/gateway/jre/bin/keytool -import -file ca.crt -alias dt_k8s_api -storetype pkcs12 -keystore /var/lib/AstromKey/gateway/ssl/mytrusted.p12</code>
или
<code>/opt/AstromKey/gateway/jre/bin/keytool -import -file dt_k8s_api.pem -alias myCertAuthority -storetype pkcs12 -keystore mytrusted.p12</code>

=== Проверка разрешений ===
Для Linux проверьте, что пользователь АктивногоШлюза, для которого был установлен АктивныйШлюз (по умолчанию <code>dtuser</code>), имеет права на запись в каталог SSL АктивногоШлюза (по умолчанию <code>/var/lib/AstromKey/gateway/ssl</code>) и что у пользователя есть права на чтение для созданного хранилища доверия.

== Настройка АктивногоШлюза для использования хранилища доверенных сертификатов ==
Чтобы настроить АктивныйШлюз для использования пользовательского файла хранилища доверенных сертификатов <code>mytrusted.p12</code>, убедитесь, что файл хранилища доверенных сертификатов находится в каталоге SSL АктивногоШлюза, а затем добавьте следующие записи в файл <code>custom.properties</code> в каталоге конфигурации АктивногоШлюза:
<code>[collector]
trustedstore = mytrusted.p12
# the following entries are optional
trustedstore-password = changeit
trustedstore-type = PKCS12</code>
Вы можете отобразить настроенный список псевдонимов и описания сертификатов с помощью команды <code>keytool -list</code> в новом хранилище доверенных сертификатов.

Например:
<code># /opt/AstromKey/gateway/jre/bin/keytool -list -keystore /var/lib/AstromKey/gateway/ssl/mytrusted.p12
Enter keystore password:
Keystore type: PKCS12
Keystore provider: SUN
Your keystore contains 1 entry
dt_k8s_api, Apr 26, 2020,
trustedCertEntry,
Certificate fingerprint (SHA-256): 08:18:9A:F2:29:31:0D:64:F0:1F:93:A1:CC:2E:A9:21:E9:DA:40:82:9B:A8:71:B7:A4:2C:6D:8C:B3:90:31:31</code>
<blockquote>Зашифрованный пароль

Пароль будет удален и зашифрован при перезапуске службы АктивногоШлюза.</blockquote>

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

Если все настроено правильно, в журнале АктивногоШлюза должна быть запись следующего содержания:
<code>Custom certificate configuration created successfully.</code>

== Исправление проблем ==
АктивныйШлюз регистрирует свои действия, связанные с вышеуказанной конфигурацией. Настроенное хранилище доверенных сертификатов не будет использоваться (и конфигурация хранилища доверенных сертификатов останется неизменной), если выполняется любое из следующих условий:

* Указано системное свойство <code>javax.net.ssl.trustStore</code>. Если это свойство указано, оно имеет приоритет над конфигурацией АктивногоШлюза.
* Настроенное хранилище доверенных сертификатов не может быть прочитано с использованием настроенного пути, пароля и типа.
* Объединенную конфигурацию нельзя записать в файл <code>ssl/runtime.cacerts</code>.

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

2022-09-28T18:15:32Z

RGolovanov: Новая страница: «Могут быть ситуации, когда необходимо добавить дополнительные сертификаты в хранилище...»

Могут быть ситуации, когда необходимо добавить дополнительные сертификаты в хранилище сертификатов АктивногоШлюза.

=== Добавление сертификатов во время установки АктивногоШлюза ===
При желании дополнительные доверенные корневые сертификаты можно указать во время установки АктивногоШлюза, указав параметры установки для [[Установка АктивногоШлюза на Linux|Linux]] или [[Установка АктивногоШлюза на Windows|Windows]].

== Определите, нужно ли вам добавить сертификат ЦС в АктивныйШлюз ==
АктивныйШлюз подключается к другим компонентам Ключа-Астром (кластерам, серверам) или сторонним системам (таким как VMware, Cloud Foundry, Kubernetes или OpenShift) с использованием защищенных SSL каналов. Встроенного хранилища АктивногоШлюза (набор сертификатов по умолчанию, поставляемый с Java), иногда недостаточно для покрытия всех необходимых вариантов использования. Это может произойти, если, например, сертификат был выдан внутри вашей организации для прокси-сервера, принимающего SSL-трафик. Также возможно, что некоторые серверы в вашей организации, к которым АктивныйШлюз должен подключаться, генерируют и используют самоподписанные сертификаты, и ваша организация не заменила их официальными сертификатами.

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

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

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

== Подготовка сертификатов ЦС в файле ==
Прежде чем добавлять сертификат в АктивныйШлюз, его необходимо получить и поместить в файл <code>ca.cert</code>.

'''Следующая общая информация о сертификатах ЦС может помочь вам определить необходимые сертификаты:'''

Условия доверенного соединения SSL:

* Между сертификатами, представленными сервером (конечная точка API), и сертификатами, присутствующими в хранилище доверенных сертификатов АктивногоШлюза, должна быть создана полная цепочка сертификатов.
* Корневой сертификат цепочки должен быть включен в хранилище доверенных сертификатов АктивногоШлюза вместе с любыми другими сертификатами, НЕ представленными конечной точкой сервера/API.

Чтобы увидеть, какие сертификаты предоставляет конечная точка, вы можете использовать следующую команду:
<code>openssl s_client -connect <API_ENDPOINT>:<PORT> -showcerts -servername <API_ENDPOINT_HOSTNAME></code>
'''Примечание:'''

Некоторые приложения (например, OpenShift) могут предоставлять разные сертификаты в зависимости от SNI. АктивныйШлюз установит сконфигурированное имя хоста конечной точки в SNI.

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

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

Например, конечная точка запроса <code>openssl</code> к этому серверу возвращает только сертификат сервера, а не корневой сертификат. Вы знаете, что этот сервер представляет только сертификат сервера, а не корневой сертификат, поскольку в сообщении об ошибке говорится, что невозможно получить сертификат локального эмитента. При наличии корневого сертификата в сообщении об ошибке будет указано «<code>Самозаверяющий сертификат в цепочке сертификатов</code>». Чтобы создать действительное SSL-соединение с этой конечной точкой, необходимо отдельно получить корневой сертификат.

Например:
<code>openssl s_client -connect localhost:6443
CONNECTED(00000005)
depth=0 CN = kube-apiserver
verify error:num=20:unable to get local issuer certificate
verify return:1
depth=0 CN = kube-apiserver
verify error:num=21:unable to verify the first certificate
verify return:1
---
Certificate chain
0 s:CN = apiserver
i:CN = AstromKeyRootAuth
---
Server certificate
-----BEGIN CERTIFICATE-----
MDIDYGCCAkigAwIBAgJIJ8SQ/FcmJiYwDQZJKoZIhvcNAQESBQAwFTETMBEGA1UE
AxMKa3ViZXJuZXRlczAeFw0yMTAxMjcxOTM1MDhaFw0yMjAxMjcxOTM1MDhaMBkx
FzAVBgNVBAMTDmt1YmUtYXBpc2VydmVyMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8A
MIIBCgKSAQEA15BVGULXSXZAM6a4Y7lR6JfSBOXIAq1sCoydH2AdhzqHu0mXj+Fd
sooRQ46f7bySZvMGFfLupmaAzH5kVJOVDQ2WoHPYVzAEhDji+SUBOi99AC0tevEa
ONLdkLGzR//2u8XND0iiswsGkK3yaNyPwCVnOnA3c4O32waMoM1VI9XGuNSqqfQF
6XUx8sGHG5bNVzfHOXh5CBJZ5JReDhW/J8CbPElYJPJaQcSpTVFx5ReTQqBLeBSy
eWyCwqMj/jAnKzpPffO478If/Uc8I5vS8zi2yPhYJhKqD0m1b96hH0slXKho25Ip
gpu4cIw03mQZMK558W4d6ccww/OvMbpKQQIDAQABo4GvMIGsMA4GA1UdDwEB/wQE
AwIFoDATBgNVHSUEDDAKBgfrBgEFBQcDATSBhAYDVR0RBH0we4IPamstazhzLWNs
b25lLTAwggprdWJlcm5ldGVzghJrdWJlcm5ldGVzLmRlZmF1bHSCFmt1YmVybmV0
ZXMuZGVmYXVsdC5zdmOCAGt1YmVybmV0ZXMuZGVmYXVsdC5zdmMuY2x1c3Rlci5s
b2NhbIcECmAAAYcErBcSvDANBgkqhkiG9w0BAQsFAAOCAQEAdmOq/Sp74xiLCa14
EI/9v7jUG+GqjD3HPpj/oXIdLHg6HA4nixxcxwnWAf2RAMVXBYn7qTDU6x7W5M+t
6M0uaCe8Od8oKjOKeQ31dfMpPbLYprKmcnuBriiN5gjfghINZKaZlGlX0GkBC9Ts
THYbmWfXfvfsX2xfpc4J0esfK+BafllEimCx8blnw1uY7CiCedEANePT+J5Q+m9L
m5pu7Qz/B4JDHLIJBArhFTBM6IIF6DhoqGUXM1XXqMlTVBpxz2vhf0N/HxcTaEBa
VWu7GZbk5mCYhngmRJ8PJ3uA8yajDT2muWm/la5oOI/GeuTgR98tqjXOXmz2NjvE
Zng1CA==
-----END CERTIFICATE-----
subject=CN = kube-apiserver

issuer=CN = kubernetes

---
Acceptable client certificate CA names
CN = kubernetes</code>
Приведенный ниже сертификат является примером корневого сертификата для вышеуказанного сертификата сервера. Убедитесь, что вы добавляете в свои хранилища доверенных сертификатов только те корневые сертификаты, которым вы доверяете.

Например:
<code>cat ca.crt | openssl x509 -text -noout
Certificate:
Data:
Version: 3 (0x2)
Serial Number: 0 (0x0)
Signature Algorithm: sha256WithRSAEncryption
Issuer: CN = kubernetes
Validity
Not Before: Jan 27 19:35:08 2021 GMT
Not After : Jan 25 19:35:08 2031 GMT
Subject: CN = kubernetes
Subject Public Key Info:</code>
Вы можете видеть, что это корневой сертификат, который вам нужен, потому что субъект и эмитент идентичны, и они совпадают с эмитентом сертификата сервера, показанного выше ('kube-apiserver').

== Создание хранилища доверенных сертификатов из сертификата ЦС ==
Создайте дополнительное хранилище доверенных сертификатов, содержащее только ваши сертификаты ЦС, которые будут объединены в АктивномШлюзе во время выполнения со встроенным хранилищем доверенных сертификатов JDK. Хранилище доверия должно быть в формате <code>PKCS12</code>. Форматы OpenSSL не поддерживаются, поэтому используйте команду <code>keytool</code> для выполнения преобразования. После преобразования вы должны поместить сертификат в каталог SSL АктивногоШлюза .

'''Примечание'''. Если вы импортируете несколько сертификатов, убедитесь, что вы указали уникальный псевдоним для каждого импортируемого сертификата. Если вы используете один и тот же псевдоним для каждого сертификата, все ранее использовавшиеся сертификаты будут перезаписаны.

Примеры для Linux создания файла PKCS12 из файла CRT или файла PEM и размещения его либо непосредственно в каталоге SSL АктивногоШлюза, либо в текущем каталоге для последующего копирования:
<code>/opt/AstromKey/gateway/jre/bin/keytool -import -file ca.crt -alias dt_k8s_api -storetype pkcs12 -keystore /var/lib/AstromKey/gateway/ssl/mytrusted.p12</code>
или
<code>/opt/AstromKey/gateway/jre/bin/keytool -import -file dt_k8s_api.pem -alias myCertAuthority -storetype pkcs12 -keystore mytrusted.p12</code>

=== Проверка разрешений ===
Для Linux проверьте, что пользователь АктивногоШлюза, для которого был установлен АктивныйШлюз (по умолчанию <code>dtuser</code>), имеет права на запись в каталог SSL АктивногоШлюза (по умолчанию <code>/var/lib/AstromKey/gateway/ssl</code>) и что у пользователя есть права на чтение для созданного хранилища доверия.

== Настройка АктивногоШлюза для использования хранилища доверенных сертификатов ==
Чтобы настроить АктивныйШлюз для использования пользовательского файла хранилища доверенных сертификатов <code>mytrusted.p12</code>, убедитесь, что файл хранилища доверенных сертификатов находится в каталоге SSL АктивногоШлюза, а затем добавьте следующие записи в файл <code>custom.properties</code> в каталоге конфигурации АктивногоШлюза:
<code>[collector]
trustedstore = mytrusted.p12
# the following entries are optional
trustedstore-password = changeit
trustedstore-type = PKCS12</code>
Вы можете отобразить настроенный список псевдонимов и описания сертификатов с помощью команды <code>keytool -list</code> в новом хранилище доверенных сертификатов.

Например:
<code># /opt/AstromKey/gateway/jre/bin/keytool -list -keystore /var/lib/AstromKey/gateway/ssl/mytrusted.p12
Enter keystore password:
Keystore type: PKCS12
Keystore provider: SUN
Your keystore contains 1 entry
dt_k8s_api, Apr 26, 2020,
trustedCertEntry,
Certificate fingerprint (SHA-256): 08:18:9A:F2:29:31:0D:64:F0:1F:93:A1:CC:2E:A9:21:E9:DA:40:82:9B:A8:71:B7:A4:2C:6D:8C:B3:90:31:31</code>
<blockquote>Зашифрованный пароль

Пароль будет удален и зашифрован при перезапуске службы АктивногоШлюза.</blockquote>

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

Если все настроено правильно, в журнале АктивногоШлюза должна быть запись следующего содержания:
<code>Custom certificate configuration created successfully.</code>

== Исправление проблем ==
АктивныйШлюз регистрирует свои действия, связанные с вышеуказанной конфигурацией. Настроенное хранилище доверенных сертификатов не будет использоваться (и конфигурация хранилища доверенных сертификатов останется неизменной), если выполняется любое из следующих условий:

* Указано системное свойство <code>javax.net.ssl.trustStore</code>. Если это свойство указано, оно имеет приоритет над конфигурацией АктивногоШлюза.
* Настроенное хранилище доверенных сертификатов не может быть прочитано с использованием настроенного пути, пароля и типа.
* Объединенную конфигурацию нельзя записать в файл <code>ssl/runtime.cacerts</code>.

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

2022-09-28T17:45:43Z

RGolovanov: Новая страница: «<blockquote>'''Не применимо к АктивномуШлюзу Кластера''' Прямая загрузка SSL-сертификата в Актив...»

<blockquote>'''Не применимо к АктивномуШлюзу Кластера'''

Прямая загрузка SSL-сертификата в АктивныйШлюз неприменима для АктивногоШлюза Кластера. Не пытайтесь настроить SSL-сертификаты непосредственно на АктивныйШлюз Кластера. Если вы сделаете это, сертификат будет перезаписан автоматическим управлением Dynatrace. Для АктивныхШлюзов Кластера вы должны загрузить свои сертификаты с помощью Cluster Management Console или Cluster REST API v1.</blockquote>Подключение к АктивномуШлюзу из OneAgents или REST API происходит по зашифрованному каналу HTTPS. АктивныйШлюз предоставляет самозаверяющий сертификат аутентификации всем подключающимся клиентам. В то время как экземпляры OneAgent могут игнорировать действительность сертификатов АктивныхШлюзов (в зависимости от конфигурации), подключения от клиентов браузера (например, RUM JavaScript) перед отправкой данных проверяют правильность имени хоста, указанного в сертификате.

'''АктивныйШлюз может обслуживать пользовательский сертификат вместо сертификата по умолчанию. Чтобы настроить это, вам нужен файл в формате PKCS#12, который содержит закрытый ключ и соответствующую цепочку сертификатов.'''

=== Настройка во время установки ===
Эту конфигурацию также можно применить во время установки АктивногоШлюза, указав параметры установки для установок [[Установка АктивногоШлюза на Linux|Linux]] или [[Установка АктивногоШлюза на Windows|Windows]].

== Настройка пользовательского сертификата ==
Чтобы настроить АктивныйШлюз для использования пользовательского сертификата

# Скопируйте файл сертификата в каталог ssl и установите правильные разрешения. В Linux убедитесь, что разрешения скопированного файла сертификата включают пользователя АктивногоШлюза, которого вы назначили для запуска службы АктивногоШлюза. Если вы не указали пользовательского пользователя во время установки, пользователем по умолчанию будет <code>dtuserag</code>. В Windows убедитесь, что учетная запись <code>LocalService</code> имеет разрешения на доступ к скопированному файлу сертификата.
# Добавьте следующие записи в файл <code>custom.properties</code> в каталоге конфигурации АктивногоШлюза.

<code>[com.compuware.apm.webserver]
certificate-file = certificate-file.p12
certificate-password = password
certificate-alias = friendly-name</code>
Вам необходимо добавить указанные выше записи в раздел <code>[com.compuware.apm.webserver]</code>. Если в вашем файле <code>custom.properties</code> уже есть такой раздел, просто добавьте свойства в раздел. Если раздела нет, то создайте и заголовок раздела.

Пароль сертификата, который вы указываете в свойстве <code>certificate-password</code>, будет запутан после перезапуска основной службы АктивногоШлюза. Запутанный пароль хранится в свойстве <code>certificate-password-encr</code>, а исходное свойство удаляется.

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

'''Значение <code>certificate-alias</code> должно быть указано в нижнем регистре'''.

Если у сертификата нет понятного имени, вы можете опустить свойство <code>certificate-alias</code>.

== Управление сертификатами через REST API ==
Сертификатами можно управлять удаленно через REST API. Подготовьте файл сертификата <code>PKCS#12</code>, и вы можете загрузить его в АктивныйШлюз с помощью REST.<blockquote>'''Токен авторизации'''

Токен API необходим для авторизации. Токены API могут предоставляться через заголовки HTTP или другими способами.

Токен API, используемый для следующих действий, должен иметь разрешение <code>ActiveGate Certificate Management</code>.</blockquote>

=== Загрузить и активировать сертификат ===
Следующая точка REST загружает и активирует выбранный файл сертификата. Пароль для файла должен совпадать с паролем для ключей, содержащихся в файле, и они должны быть указаны в пользовательском HTTP-заголовке <code>X-Password</code>.

<code>curl <nowiki>https://{address</nowiki> of ActiveGate}:{port}/e/{environment ID}/api/v1/certificate/{certificate file name} -H"Authorization: Api-Token {token}" -H"X-Password: {password}" -T {path to certificate file}</code>

* Порт настраивается, по умолчанию 9999.
* Путь к файлу сертификата может быть просто именем локального файла или полным путем.
* Имя сертификата, указанное в URL-адресе, не обязательно должно совпадать с именем файла.

<code>curl <nowiki>https://myActiveGate:9999/e/myEnvironmentId/api/v1/certificate/cert.p12</nowiki> -H"Authorization: Api-Token 123abc" -H"X-Password: myPassword" -T cert.p12</code>
Если вызов API выполнен успешно, ответ HTTP будет <code>200</code> с описанием содержимого файла активированного сертификата в формате JSON.

Если вызов API завершится неудачно, ответом HTTP будет код ошибки <code>4xx</code> или <code>5xx</code> с обычным текстовым сообщением.

=== Замена активного сертификата ===
Вы не можете заменить активный сертификат с помощью этой конечной точки. Операция вернет <code>HTTP 403 Forbidden</code>. Чтобы заменить активный сертификат, загрузите новый сертификат под другим именем, а затем удалите старый сертификат.ld certificate.

=== Удаление сертификата ===
<code>curl -XDELETE <nowiki>https://myActiveGate:9999/e/myEnvironmentId/api/v1/certificate/cert.p12</nowiki> -H"Authorization: Api-Token 123abc"</code>
Если сертификат удален успешно, вызов API ответит кодом HTTP <code>200</code> без содержимого.

Если файл с указанным именем не существует, вызов API ответит кодом HTTP <code>404 Not found</code>.

Если файл сертификата в настоящее время используется, вызов API ответит кодом HTTP <code>403 Forbidden</code>.

=== Активация сертификата ===
<code>curl -XPOST <nowiki>https://myActiveGate:9999/e/myEnvironmentId/api/v1/certificate/cert.p12/activate</nowiki> -H"Authorization: Api-Token 123abc" -d"{\"password\":\"pass\"}"</code>

<code>curl -XPOST <nowiki>https://myActiveGate:9999/e/myEnvironmentId/api/v1/certificate/cert.p12/activate</nowiki> -H"Authorization: Api-Token 123abc" -H"X-Password: pass"</code>
Если сертификат успешно активирован, вызов API ответит кодом HTTP <code>200</code> с описанием содержимого файла активированного сертификата в формате JSON.

Если запрошенный файл сертификата не существует в АктивномШлюзе, вызов API ответит кодом HTTP <code>404</code>.

Если предоставленный пароль не совпадает, вызов API отвечает кодом HTTP <code>400</code>.

=== Список всех сертификатов ===
<code>curl <nowiki>https://myActiveGate:9999/e/myEnvironmentId/api/v1/certificate/list</nowiki> -H"Authorization: Api-Token 123abc"</code>
Если активное хранилище ключей есть в списке, его запись будет содержать дополнительные сведения.

Пример ответа:
<code>[
{
"name":"cert_demo.p12"

},
{ "name":"cert.p12",
"desc":[ {
"alias":"local",
"description":"Subject:CN=myActiveGate;Valid from:Fri Feb 15 13:16:58 CET 2019;Valid to:Sat Feb 15 13:16:58 CET 2020;Serial number:71d275dd3983c3cb9382437275dd3983c3cb93dbca"

},
{
"alias":"dynatrace",
"description":"Subject:CN=*.clients.dynatrace.org;Valid from:Thu Feb 21 10:06:03 CET 2019;Valid to:Fri Feb 21 10:06:03 CET 2020;Serial number:6dc7008ab269ecebeed03652ce08ab269ecebeeeb33"

}

]

},
{
"name":"cert_key_1.p12"

}
]</code>

=== Описание сертификата ===
Этот вызов API возвращает описание выбранного файла в формате JSON.
<code>curl <nowiki>https://myActiveGate:9999/e/myEnvironmentId/api/v1/certificate/cert.p12/list</nowiki> -H"Authorization: Api-Token 123abc" -H"X-Password: pass"</code>

<code>curl -XPOST <nowiki>https://myActiveGate:9999/e/myEnvironmentId/api/v1/certificate/cert.p12/list</nowiki> -H"Authorization: Api-Token 123abc" -H"X-Password: pass"</code>

<code>curl -XPOST <nowiki>https://myActiveGate:9999/e/myEnvironmentId/api/v1/certificate/cert.p12/list</nowiki> -H"Authorization: Api-Token 123abc" -d"{\"password\":\"pass\"}"</code>
Если запрошенный файл сертификата не существует в АктивномШлюзе, вызов API ответит кодом HTTP <code>404</code>.

Если пароль не совпадает, вызов API отвечает кодом HTTP <code>400</code>.

Пример ответа:
<code>{ "name":"cert.p12",
"desc":[ {
"alias":"local",
"description":"Subject:CN=myActiveGate;Valid from:Fri Feb 15 13:16:58 CET 2019;Valid to:Sat Feb 15 13:16:58 CET 2020;Serial number:7137275dd398c4182437275dd3983c3cb93dbca"

},
{
"alias":"dynatrace",
"description":"Subject:CN=*.clients.dynatrace.org;Valid from:Thu Feb 21 10:06:03 CET 2019;Valid to:Fri Feb 21 10:06:03 CET 2020;Serial number:6d2ce08ab269ecebeee7f1bd03652ce08ab269ecebeeeb33"

}

]
}</code>

=== Исправление проблем ===
Когда файл сертификата и пароль указаны, АктивныйШлюз пытается использовать заданную конфигурацию.

* Если файл или пароль отсутствуют, АктивныйШлюз молча вернется к конфигурации по умолчанию. Запись в журнале в обоих случаях одинакова.
* Если АктивныйШлюз попытается использовать сконфигурированный сертификат и определит, что конфигурация непригодна для использования, он будет использовать SSL-сертификат по умолчанию и сделает следующую запись в журнале:

<code>UTC WARNING [<1>] [CollectorImpl] Unusable custom SSL config, falling back to default.</code>
АктивныйШлюз дополнительно регистрирует причину, по которой он не может использовать настроенный сертификат. Например, если псевдоним не соответствует содержимому файла, АктивныйШлюз запишет в лог-файл запись:
<code>UTC SEVERE [<1>] [SSLEnvironment] missing configured-alias entry in keystore:/var/lib/dynatrace/gateway/config/../ssl/cert-file.p12, available aliases: available-alias,</code>

== Создание файла сертификата для тестирования ==
Чтобы создать файл самоподписанного сертификата <code>PKCS#12</code> для тестирования,

* Сгенерируйте ключ и самоподписанный сертификат:

<code>openssl req -x509 -newkey rsa:4096 -keyout key.pem -out cert.pem -days 365 -subj "/CN=localhost"</code>

* Преобразуйте сгенерированные файлы в формат <code>PKCS#12</code>, устанавовив понятное имя <code>-name friendly-name</code> в нижнем регистре:

<code>openssl pkcs12 -export -inkey key.pem -in cert.pem -out cert_key.p12</code>

== Известные ограничения и поддержка нескольких сертификатов ==

* Пароль для файла <code>PKCS#12</code> должен совпадать с паролем для ключа, содержащегося в этом файле. Не используйте параметр <code>-twopass</code> в команде <code>openssl pkcs12</code>.
* Невозможно использовать несколько файлов сертификатов: может быть только один файл сертификата АктивногоШлюза, хотя файл может содержать несколько сертификатов и ключей.

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

2022-09-28T17:17:51Z

RGolovanov:

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

Для этого вам необходимо:

* Указать адрес обратного прокси-сервера/балансировщика нагрузки.
* Убедиться, что АктивныйШлюз будет игнорировать любую дополнительную информацию о целевом адресе, отправленную из кластера Ключ-Астром, и, таким образом, будет подключаться только к указанному вами адресу. [[Файл:Бз для АктивногоШлюза. .png]]

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

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

* Остановите АктивныйШлюз и отредактируйте файл <code>custom.properties</code> в каталоге конфигурации АктивногоШлюза.
* Чтобы АктивныйШлюз игнорировал информацию о подключении, полученную от кластера Ключ-Астром, добавьте или измените параметр <code>ignoreClusterRuntimeInfo</code> в <code>[connectivity]</code> разделе <code>custom.properties</code> файл:

<code>[connectivity]
ignoreClusterRuntimeInfo = true</code>

* Укажите адрес обратного прокси: Добавьте параметр <code>seedServerUrl</code> в <code>[collector]</code> раздел <code>custom.properties</code> файл в следующем формате:

<code>seedServerUrl = https://<REVERSE_PROXY>:<REVERSE_PROXY_PORT>/communication</code>
<code>[collector]
seedServerUrl = <nowiki>https://my.reverse-proxy.com:443/communication</nowiki></code>
'''Укажите несколько адресов:'''

Параметр может быть одним значением или списком через запятую целевых адресов, к которым подключается АктивныйШлюз.
<code>[collector]
seedServerUrl = <nowiki>https://my.reverse-proxy-1.com:443/communication,https://my.reverse-proxy-2.com:443/communication</nowiki></code>

* Сохраните файл <code>custom.properties</code> и перезапустите основную службу АктивногоШлюза.

Файл:Бз для АктивногоШлюза. .png

2022-09-28T17:17:24Z

RGolovanov:

Бз для АктивногоШлюза.

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

2022-09-28T17:10:52Z

RGolovanov:

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

Для этого вам необходимо:

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

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

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

* Остановите АктивныйШлюз и отредактируйте файл <code>custom.properties</code> в каталоге конфигурации АктивногоШлюза.
* Чтобы АктивныйШлюз игнорировал информацию о подключении, полученную от кластера Ключ-Астром, добавьте или измените параметр <code>ignoreClusterRuntimeInfo</code> в <code>[connectivity]</code> разделе <code>custom.properties</code> файл:

<code>[connectivity]
ignoreClusterRuntimeInfo = true</code>

* Укажите адрес обратного прокси: Добавьте параметр <code>seedServerUrl</code> в <code>[collector]</code> раздел <code>custom.properties</code> файл в следующем формате:

<code>seedServerUrl = https://<REVERSE_PROXY>:<REVERSE_PROXY_PORT>/communication</code>
<code>[collector]
seedServerUrl = <nowiki>https://my.reverse-proxy.com:443/communication</nowiki></code>
'''Укажите несколько адресов:'''

Параметр может быть одним значением или списком через запятую целевых адресов, к которым подключается АктивныйШлюз.
<code>[collector]
seedServerUrl = <nowiki>https://my.reverse-proxy-1.com:443/communication,https://my.reverse-proxy-2.com:443/communication</nowiki></code>

* Сохраните файл <code>custom.properties</code> и перезапустите основную службу АктивногоШлюза.

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

2022-09-28T17:06:57Z

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

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

Для этого вам необходимо:

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

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

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

# Остановите АктивныйШлюз и отредактируйте файл <code>custom.properties</code> в каталоге конфигурации АктивногоШлюза.
# Чтобы АктивныйШлюз игнорировал информацию о подключении, полученную от кластера Ключ-Астром, добавьте или измените параметр <code>ignoreClusterRuntimeInfo</code> в <code>[connectivity]</code> разделе <code>custom.properties</code> файл:

<code>[connectivity]
ignoreClusterRuntimeInfo = true</code>
Укажите адрес обратного прокси: Добавьте параметр <code>seedServerUrl</code> в <code>[collector]</code> раздел <code>custom.properties</code> файл в следующем формате:

<code>seedServerUrl = https://<REVERSE_PROXY>:<REVERSE_PROXY_PORT>/communication</code>
<code>[collector]
seedServerUrl = <nowiki>https://my.reverse-proxy.com:443/communication</nowiki></code>
'''Укажите несколько адресов:'''

Параметр может быть одним значением или списком через запятую целевых адресов, к которым подключается АктивныйШлюз.
<code>[collector]
seedServerUrl = <nowiki>https://my.reverse-proxy-1.com:443/communication,https://my.reverse-proxy-2.com:443/communication</nowiki></code>
Сохраните файл <code>custom.properties</code> и перезапустите основную службу АктивногоШлюза.

Настройка прокси АктивногоШлюза

2022-09-28T16:38:54Z

RGolovanov:

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

== Свойства конфигурации прокси ==
Конфигурация прокси АктивногоШлюза состоит из следующих настроек. В зависимости от типа связи, для которой вы хотите использовать (или отключить) прокси, следующие свойства конфигурации могут появиться в разных разделах конфигурации вашей конфигурации АктивногоШлюза.
{| class="wikitable"
!Свойство
!Описание
|-
|<code>proxy-server</code>
|Адрес сервера (имя хоста или IP-адрес)
|-
|<code>proxy-port</code>
|Порт (необязательно)

Если оставить пустым, используется порт <code>8080</code> по умолчанию.
|-
|<code>proxy-user</code>
|Имя пользователя (необязательно)
|-
|<code>proxy-domain</code>
|Домен пользователя в случае аутентификации NTLM
|-
|<code>proxy-password</code>
|Пароль (необязательно)

Пароль, указанный в свойстве <code>proxy-password</code>, обфусцируется после перезапуска АктивногоШлюза, а замаскированный пароль сохраняется в свойстве <code>proxy-password-encr</code>.
|-
|<code>proxy-off</code>
|Если установлено значение <code>true</code>, прокси отключается для определенного типа связи.
|-
|<code>proxy-non-proxy-hosts</code>
|Список хостов, для связи с которыми АктивныйШлюз не должен использовать прокси

Хосты в списке должны быть разделены символом <code>|</code> персонажи. Вы также можете использовать звездочку <code>*</code> в качестве подстановочного знака для соответствия любой строке. Может быть только один подстановочный знак в начале или в конце имени хоста. Например, <code>proxy-non-proxy-hosts=*.foo.com|localhost</code> указывает, что каждый хост в домене <code>foo.com</code> и <code>localhost</code> должен быть доступен напрямую, даже если указан прокси-сервер. Полное описание допустимого синтаксиса см. в синтаксисе параметра <code>http.nonProxyHosts</code> в свойствах сети.
|}

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

* Отредактируйте файл <code>custom.properties</code> в каталоге конфигурации АктивногоШлюза.
* Укажите параметры прокси в соответствующем разделе конфигурации файла <code>custom.properties</code>, в зависимости от того, для каких целей вы хотите использовать прокси (см. примеры ниже). Например:

<code>[http.client]
proxy-server=127.0.0.1
proxy-port=8080
# basic authentication credentials
proxy-user=username
proxy-password=password</code>

* Сохраните файл <code>custom.properties</code>.
* Перезапустите основную службу АктивногоШлюза. Обратите внимание, что после перезапуска службы пароль прокси, указанный вами в конфигурации, шифруется и перемещается из свойства <code>proxy-password</code> в <code>proxy-password-encr</code>.

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

=== Настройки прокси АктивногоШлюза для всего исходящего трафика ===
[[Файл:ПроксиАктивногоШлюзаДляВсегоТрафика.png]]

Следующая конфигурация охватывает наиболее распространенный случай указания параметров прокси-сервера для исходящего соединения АктивногоШлюза как с кластером Ключ-Астром, так и с отслеживаемыми технологиями, такими как AWS, VMware или Azure.

Укажите параметры, связанные с прокси, в разделе <code>[http.client]</code> файла <code>custom.properties</code>, включая параметры, связанные с аутентификацией, если это необходимо:
<code>[http.client]
proxy-server=127.0.0.1
proxy-port=8080
# basic authentication credentials
proxy-user=username
proxy-password=password</code>

=== Настройки прокси АктивногоШлюза только для кластера ===
[[Файл:ПроксиАктивногоШлюзаДляКластера.png]]
Чтобы настроить прокси специально для кластера, позволяя исходящему мониторинговому трафику напрямую подключаться к отслеживаемым технологиям, задайте настройки прокси в разделе <code>[http.client.internal]</code> конфигурации АктивногоШлюза.
<code>[http.client.internal]
proxy-server=127.0.0.1
proxy-port=8080
# basic authentication credentials
proxy-user=username
proxy-password=password</code>
'''Примечание:'''

Для корректной работы связи АктивногоШлюза после указания вышеперечисленных настроек вам потребуется повторить настройки связи без прокси в <code>http.client.internal</code> или <code>http.client.external</code> и/или вам потребуется создать разделы <code>http.client.internal</code> или <code>http.client.external</code>.

=== Прокси-сервер АктивногоШлюза для исходящего трафика мониторинга с прямым подключением к кластеру ===
[[Файл:ПроксиАктивногоШлюзаДляКластераИТрафика.png]]

Чтобы настроить прокси специально для исходящего трафика мониторинга, но оставить прямое подключение к кластеру:

* Укажите конфигурацию прокси в разделе <code>[http.client]</code> файла <code>custom.properties</code>.
* Отключите прокси в разделе <code>[http.client.internal]</code>.

<code>[http.client]
proxy-server=127.0.0.1
proxy-port=8080
# basic authentication credentials
proxy-user=username
proxy-password=password

[http.client.internal]
proxy-off=true</code>
'''Примечание:'''

Для корректной работы связи АктивногоШлюза после указания вышеперечисленных настроек вам потребуется повторить настройки связи без прокси в <code>http.client.internal</code> или <code>http.client.external</code> и/или вам потребуется создать разделы <code>http.client.internal</code> или <code>http.client.external</code>.

== Расширенные сценарии настройки прокси для АктивногоШлюза ==
Чтобы настроить прокси '''для исходящих подключений''' из АктивногоШлюза, то есть для подключений к отслеживаемым технологиям или к кластеру, отредактируйте файл <code>custom.properties</code> и задайте свойства в соответствующем разделе. В зависимости от раздела конфигурации, в котором указаны свойства, прокси (и другие параметры связи) влияют только на выбранные типы соединений:

* <code>[http.client]</code> — настройки прокси для всех исходящих соединений АктивногоШлюза, включая кластер и все отслеживаемые технологии.
* <code>[http.client.internal]</code> — настройки прокси специально для связи с кластером. Эти настройки переопределяют настройки, указанные в <code>[http.client]</code>.
* <code>[http.client.external]</code> — настройки прокси специально для отслеживаемых технологий: CloudFoundry, Kubernetes, приватный синтетический мониторинг. Эти настройки переопределяют настройки, указанные в <code>[http.client]</code>.
* <code>[<technology name>]</code> — настройки прокси специально для конкретной отслеживаемой технологии, например <code>cloudfoundry_monitoring</code>, <code>kubernetes_monitoring</code>, <code>synthetic</code>. Эти параметры переопределяют параметры, указанные в <code>[http.client]</code> и <code>[http.client.external]</code>. Обратите внимание, что настройки для многих из этих технологий можно указать совместно в <code>[http.client.external]</code>.

=== Прокси АктивногоШлюза для Kubernetes, CloudFoundry и частного синтетического мониторинга ===
Вы можете указать настройки прокси сразу для нескольких отслеживаемых технологий. Настройки, указанные в разделе <code>http.client.external</code>, влияют на Kubernetes, CloudFoundry и приватный синтетический мониторинг (этот набор может быть расширен в будущем):
<code>[http.client.external]
proxy-server=127.0.0.1
proxy-port=8080
# basic authentication credentials
proxy-user=username
proxy-password=password</code>
'''Примечание:'''

Для корректной работы связи АктивногоШлюза после указания вышеперечисленных настроек вам потребуется повторить настройки связи без прокси в <code>http.client.internal</code> или <code>http.client.external</code> и/или вам потребуется создать разделы <code>http.client.internal</code> или <code>http.client.external</code>.

=== Разные прокси для Kubernetes, CloudFoundry и частный синтетический мониторинг ===
Вы также можете указать выделенные настройки прокси для конкретной отслеживаемой технологии:

* Cloud Foundry в разделе <code>cloudfoundry_monitoring</code>
* Kubernetes в разделе <code>kubernetes_monitoring</code>
* Приватный синтетический мониторинг в разделе <code>synthetic</code>

<code>[kubernetes_monitoring]
proxy-server=127.0.0.1
proxy-port=8080
# basic authentication credentials
proxy-user=username
proxy-password=password</code>

== Текущие ограничения ==

=== Повторение настроек связи в <code>[http.client.internal]</code> или <code>[http.client.external]</code>. ===
При указании конфигурации прокси в <code>[http.client.internal]</code> или <code>[http.client.external]</code> обратите внимание, что эти разделы затрагивают различные аспекты связи, а не только прокси. При создании любого из этих разделов обязательно сначала скопируйте содержимое существующего раздела <code>[http.client]</code> из файла <code>configuration.properties</code> (и настройте его соответствующим образом):

* Откройте файл <code>config.properties</code> и скопируйте все свойства из раздела <code>[http.client]</code> в файл <code>custom.properties</code>, раздел <code>[http.client.internal]</code> или <code>[http.client.external]</code> (в зависимости от ситуации).
* Если в файле <code>custom.properties</code> есть раздел <code>[http.client]</code>, используйте перечисленные там значения, чтобы перезаписать указанные выше значения (значения, которые вы только что скопировали из <code>config.properties</code>).

<code>[http.client.external]
# proxy settings as specific to http.client.external:
proxy-server=127.0.0.1
proxy-port=8080
# basic authentication credentials
proxy-user=username
proxy-password=password
# communication settings copied from existing configuration:
connection-timeout=5000
socket-timeout=20000
connection-request-timeout=5000
idle-connection-timeout=15000
max-total-connections=256
max-connections-per-route=32
certificate-validation=yes
hostname-verification=yes</code>

Файл:ПроксиАктивногоШлюзаДляКластераИТрафика.png

2022-09-28T16:38:42Z

RGolovanov:

ПроксиАктивногоШлюзаДляКластераИТрафика

Файл:ПроксиАктивногоШлюзаДляКластера.png

2022-09-28T16:33:22Z

RGolovanov:

ПроксиАктивногоШлюзаДляКластера

Файл:ПроксиАктивногоШлюзаДляВсегоТрафика.png

2022-09-28T16:31:29Z

RGolovanov:

ПроксиАктивногоШлюзаДляВсегоТрафика

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

2022-09-28T16:21:37Z

RGolovanov:

== Требования к установке ==

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

* 4 ГБ свободного места на диске для установки АктивногоШлюза и расширений, настройки и журналов для автоматического обновления.
* 4 ГБ для кэшированных установщиков АктивногоШлюза и ЕдиногоАгента и образов контейнеров — если их нужно будет хранить.
* Место для файлов дампа — если их нужно будет сохранить. Эта функция отключена по умолчанию, но ее можно включить в конфигурации АктивногоШлюза. Максимальный размер дискового пространства настраивается — по умолчанию 100 ГБ.
* Место для загрузки расширений — в зависимости от используемых расширений.
* 2 ГБ оперативной памяти (рекомендуется 4 ГБ).
* 1 двухъядерный процессор.

Для больших сред вам может понадобиться машина с дополнительным процессором и памятью.

=== Требования к пространству по каталогам ===
{| class="wikitable"
!'''Каталог верхнего уровня'''
!'''Требования к дисковому пространству'''
|-
|Исполняемые файлы АктивногоШлюза и автообновления, библиотеки и сопутствующие файлы

стандартный каталог: <code>%PROGRAMFILES%\AstromKey\gateway</code>

относительно параметра установки: <code><INSTALL>\gateway</code>
|300 МБ
|-
|Конфигурация АктивногоШлюза и связанные каталоги

Для АктивногоШлюза Окружения он также содержит конфигурацию Extensions 1.0 и Extensions 2.0.

стандартный каталог: <code>%PROGRAMDATA%\AstromKey</code>

относительно параметра установки: <code><CONFIG></code>
|2 МБ
|-
|Только для АктивногоШлюза Окружения: Исполняемые файлы Extensions 1.0 и Extensions 2.0, библиотеки и связанные файлы по умолчанию: <code>%PROGRAMFILES%\AstromKey\remotepluginmodule</code>

относительно параметра установки: <code><INSTALL>\remotepluginmodule</code>
|350 МБ
|-
|Журналы АктивныхШлюзов и автообновления

стандартный каталог: <code>%PROGRAMDATA%\AstromKey</code>

параметр установки: <code><LOG></code>
|1.2 ГБ
|-
|Временные файлы АктивногоШлюза

default: <code>%PROGRAMDATA%\AstromKey\gateway\tmp</code>

путь относительно параметра установки: <code><TEMP>\gateway</code>
|4 ГБ (включая 3 ГБ для кэшированных установщиков OneAgent и образов контейнеров)
|-
|Файлы дампа, загруженные в АктивныйШлюз ЕдинымАгентом

<code>%PROGRAMDATA%\AstromKey\gateway\dump</code>
|Функциональность отключена по умолчанию, не настраивается во время установки.

При активации может принимать настраиваемый максимальный размер: по умолчанию 100 ГБ.
|-
|Только для АктивногоШлюза Окружения: журналы расширений 1.0 и 2.0 АктивногоШлюза, кэш, рабочая область во время выполнения

стандартный каталог: <code>%PROGRAMDATA%\AstromKey\remotepluginmodule</code>

путь относительно параметра установки: <code><CONFIG>\remotepluginmodule</code>
|2 ГБ
|-
|Только для АктивногоШлюза Окружения: Каталог загрузки расширений

стандартный каталог: <code>%PROGRAMFILES%\AstromKey\remotepluginmodule\plugin_deployment</code>

путь относительно параметра установки: <code><INSTALL>\remotepluginmodule\plugin_deployment</code>
|В зависимости от загруженных расширений
|}

=== Поддерживаемые операционные системы ===
{| class="wikitable"
!Дистрибутив Linux
!Версии
!Архитектуры ЦП
|-
| rowspan="1" |Windows
|8.1, 10
|x86-64
|-
| rowspan="1" |Windows Server
|2012, 2012 R2, 2016, 2019, 2022
|x86-64
|}

=== Системные требования ===

* АктивныйШлюз поддерживает только операционные системы, работающие на архитектуре x86-64 (64-битные Intel/AMD).
* Убедитесь, что у вас правильная конфигурация сетевого порта.
* Установка АктивногоШлюза не поддерживается в Windows с отключенной учетной записью <code>NT AUTHORITY\LocalService</code>.

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

* Мониторинг инфраструктуры
* Мониторинг логов
* Полный стек мониторинга 3 экземпляров Apache Tomcat
* Полный стек мониторинга 2 экземпляров HTTP-сервера Apache

{| class="wikitable"
!Размер машины
!Количество хостов
|-
|c4.large
|450
|-
|c4.xlarge
|900
|-
|c4.2xlarge
|1200
|}
Экземпляры машин С4:
{| class="wikitable"
!Машина
!vCPU
!Память (ГБ)
!Хранилище
!Выделенная пропускная способность EBS (Мбит/с)
!Производительность сети
|-
|c4.large
|2
|3.75
|EBS-Only
|500
|Умеренная
|-
|c4.xlarge
|4
|7.5
|EBS-Only
|750
|Высокая
|-
|c4.2xlarge
|8
|15
|EBS-Only
|1,000
|Высокая
|}

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

=== Разрешите подключения через брандмауэр ===
Убедитесь, что настройки вашего брандмауэра разрешают связь с Ключом-Астром.

В зависимости от политики вашего брандмауэра вам может потребоваться явно разрешить определенные исходящие соединения.

АктивныйШлюз обычно прослушивает (принимает входящие соединения) порт <code>9999</code> и взаимодействует с Ключом-Астром (устанавливает исходящие соединения) через порт <code>443</code>.

=== Установка ===

# Войдите в Ключ-Астром, выберите '''Развернуть Ключ-Астром''' в меню навигации и выберите '''Установить АктивныйШлюз'''.
# На странице '''Установка АктивногоШлюза Окружения''' выберите '''Windows'''.
# Выберите [https://doc.ruscomtech.ru/index.php/%D0%A6%D0%B5%D0%BB%D0%B8%20%D0%90%D0%BA%D1%82%D0%B8%D0%B2%D0%BD%D0%BE%D0%B3%D0%BE%D0%A8%D0%BB%D1%8E%D0%B7%D0%B0 цель АктивногоШлюза].
# Предоставьте PaaS-токен. Он необходим для загрузки установщика АктивногоШлюза из вашей среды. Если у вас нет токена PaaS, вы можете создать его прямо в пользовательском интерфейсе. Токен автоматически добавляется к командам загрузки и установки, которые вы будете использовать позже.
# Скачайте установщик по скопированной cmd-команде или по ссылке.
# Запустите установщик '''с правами администратора'''.

==== Конфигурация установки ====
Вы можете добавить дополнительные параметры в команду установки, чтобы настроить установку. Например, чтобы установить АктивныйШлюз в другой каталог, используйте параметр <code>INSTALL=<путь></code>:
<code>C:\ AstromKey-ActiveGate-Windows-x86-1.0.0.exe '''INSTALL=D:\hosted_app\AstromKey'''</code>

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

Чтобы проверить статус установки, выберите '''Показать статус развертывания''' и перейдите на вкладку '''АктивныеШлюзы'''.
==Стандартные настройки установщика==
Если вы не укажете какие-либо параметры во время установки АктивногоШлюза для настройки параметров, будут применены следующие параметры по умолчанию.
===Каталоги===
{| class="wikitable"
!'''Цель каталога'''
!'''Путь по умолчанию'''Путь относительно параметра установки
!'''Требования к дисковому пространству'''(если размер не указан, предположим, что он меньше 1 МБ)
|-
|Исполняемые файлы АктивногоШлюза, библиотеки и связанные файлы
|<code>%PROGRAMFILES%\AstromKey\gateway</code><code><INSTALL>\gateway</code>
|300 МБ
|-
|Конфигурация АктивногоШлюза
|<code>%PROGRAMDATA%\AstromKey\gateway\config</code>
|
|-
|SSL-папка АктивногоШлюза
|<code>%PROGRAMDATA%\AstromKey\gateway\ssl</code>
|
|-
|Временные файлы АктивногоШлюза
|<code>%PROGRAMDATA%\AstromKey\gateway\tmp</code>
|4 ГБ (включая 3 ГБ для кэшированных установщиков ЕдиныхАгентов и образов контейнеров)
|-
|Логи АктивногоШлюза
|<code>%PROGRAMDATA%\AstromKey\gateway\log</code>
|500 МБ
|-
|Файлы дампа, загруженные в АктивныйШлюз ЕдинымАгентом
|<code>%PROGRAMDATA%\AstromKey\gateway\dump</code>
|Функциональность отключена по умолчанию. При активации может принимать настраиваемый максимальный размер: по умолчанию 100 ГБ.
|-
|Каталог пакетов АктивногоШлюза для загрузки установщика автоматического обновления
|<code>%PROGRAMDATA%\AstromKey\packages</code>
|500 МБ
|-
|Исполняемые файлы расширений 1.0 и 2.0 АктивногоШлюза, библиотеки и связанные файлы
|<code>%PROGRAMFILES%\AstromKey\remotepluginmodule</code>
|350 МБ
|-
|Конфигурация расширений 1.0 и 2.0 АктивногоШлюза, журналы, кеш, рабочая область во время выполнения
|<code>%PROGRAMDATA%\AstromKey\remotepluginmodule</code>
|2 ГБ (для логов и аварийных дампов)
|-
|Каталог загрузки расширений АктивногоШлюза
|<code>%PROGRAMFILES%\AstromKey\remotepluginmodule\plugin_deployment</code>
|В зависимости от загруженных расширений
|-
|zRemote исполняемые файлы, библиотеки и связанные файлы
|<code>%PROGRAMFILES%\AstromKey\zremote</code>
|50 МБ
|-
|zRemote редактируемая пользователем постоянная конфигурация,
zРабочая область удаленного выполнения, отчеты о сбоях
|<code>%PROGRAMDATA%\AstromKey\zremote\agent</code>
|50 МБ
|-
|Логи zRemote
|<code>%PROGRAMDATA%\AstromKey\zremote\log</code>
|200 МБ
|-
|Частные синтетические исполняемые файлы, библиотеки и связанные файлы
|<code>%PROGRAMFILES%\AstromKey\synthetic</code>
|270 МБ
|-
|Приватные синтетические логи
|<code>%PROGRAMDATA%\AstromKey\synthetic\log</code>
|1 ГБ
|-
|Частные синтетические временные файлы
|<code>%PROGRAMDATA%\AstromKey\synthetic</code>
|20 ГБ, в том числе
1 ГБ для <code>/var/tmp/AstromKey/synthetic/cache</code> и

1 ГБ для <code>/var/tmp/AstromKey/synthetic/screenshots</code>
|-
|Автообновление
|<code>%PROGRAMFILES%\AstromKey\gateway</code>

Относительно параметра установки: <code><INSTALL>\gateway</code>
|Включено в оценку исполняемых файлов АктивногоШлюза
|-
|Логи автообновления
|<code>%PROGRAMDATA%\AstromKey\autoupdater\log</code>
|200 МБ
|}
===Службы===
{| class="wikitable"
|'''Название компонента'''
|'''Наименование службы'''
|'''Учетная запись пользователя'''
|'''Описание'''
|-
|АктивныйШлюз
|<code>AstromKeygateway</code>
|<code>Local Service</code>
|Основной сервис АктивногоШлюза. Присутствует для всех целей и функциональных модулей.
|-
|Автообновление АктивногоШлюза
|<code>AstromKeyautoupdater</code>
|<code>Local Service</code>
|Сервис автоматического обновления. Присутствует для всех целей и функциональных модулей АктивногоШлюза.
|-
|Расширения 1.0 (удаленный подключаемый модуль)
|<code>remotepluginmodule</code>
|<code>Local Service</code>
|Сервис для функционального модуля Extensions 1.0. Присутствует на АктивныхШлюзах, установленных для мониторинга маршрутизации. Эта служба будет активной или неактивной в зависимости от конфигурации — настройки по умолчанию см. в описании модуля.
|-
|Расширения 2.0
|<code>extensionsmodule</code>
|<code>Local Service</code>
|Сервис для функционального модуля Extensions 2.0. Присутствует на АктивныхШлюзах, установленных для мониторинга маршрутизации. Эта служба будет активной или неактивной в зависимости от конфигурации — настройки по умолчанию см. в описании модуля.
|-
|zRemote
|<code>zremote</code>
|<code>Local Service</code>
|Сервис для функционального модуля zRemote. Присутствует на АктивныхШлюзах, установленных с целью маршрутизации трафика z/OS в Ключ-Астром.
|-
|Синтетика
|<code>vuc</code>
|<code>Local Service</code>
|Сервис для Синтетического функционального модуля. Присутствует на АктивныхШлюзах, установленных для запуска синтетических мониторов из частной локации.
|}
===Использование портов===
По умолчанию АктивныйШлюз:
*получает соединения от ЕдиныхАгентов или других АктивныхШлюзов через порт 9999
*получает API Ключ-Астром на порт 9999
*подключается к SaaS или Managed-кластеру через порт 443

== Пользовательские настройки установщика ==
Вам не нужно указывать какие-либо параметры для команды установки, если только вам не нужно настроить такие параметры, как расположение каталогов, конфигурация прокси-сервера, сертификаты SSL и т. д. Для настройки таких параметров можно использовать параметры командной строки и переменные среды.

=== Синтаксис команды установки ===
<code>AstromKey-ActiveGate-Windows-x86-<version>.exe [<parameter1>=<value1>] [<parameter2>=<value2>] ...</code>
Пробелы между именем параметра и значением параметра (вокруг знака <code>=</code>) не допускаются в синтаксисе команды.

=== Конфигурация прокси ===
Конфигурация прокси должна быть указана в следующем формате. Это позволит настроить прокси АктивногоШлюза для всех исходящих соединений (в разделе конфигурации <code>http.client</code>):
<code>PROXY=<схема_прокси><пользователь>:<пароль>@<сервер>:<порт></code>
Где:

* Все компоненты необязательны, кроме <code><server></code>.
* Если не указаны ни <code><пользователь></code>, ни <code><пароль></code>, то символ @ следует опустить.
* <code><пароль></code> можно указать, только если указано имя пользователя.
* ':' после <code><user></code> можно указать, даже если часть пароля пуста.
* <code><схема_прокси></code> не является обязательной и может быть <code>"http://"</code> или <code>"https://"</code>.
* <code><пользователь></code> является необязательным.
* <code><server></code> может быть IP-адресом или DNS-именем, но не путем. Например, если указано «1.2.3.4/textaferslash», будет извлечена только часть IP («1.2.3.4»). Косая черта и следующий за ней текст будут игнорироваться.
* <code><порт></code> является необязательным.

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

Для этого вам необходимо:

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

Такие параметры конфигурации можно указать во время установки АктивногоШлюза, задав следующие параметры командной строки программе установки:
<code>IGNORE_CLUSTER_RUNTIME_INFO=true SERVER=<адрес_обратного_прокси></code>
Кроме того, вы можете настроить АктивныйШлюз после установки, внеся изменения в конфигурацию АктивногоШлюза.

=== Каталог установки ===
Абсолютный путь к каталогу установки можно указать либо в пользовательском интерфейсе установщика, либо в командной строке (версия АктивногоШлюза 1.232+). Эта папка будет использоваться для установки исполняемых файлов и библиотек АктивногоШлюза.
<code>C:\AstromKey-ActiveGate-Windows-x86-1.0.0.exe INSTALL=D:\hosted_app\AstromKey</code>
Сохраняет установочные файлы в указанном каталоге. Значение по умолчанию для этого параметра (если оно не указано) — <code>/opt/AstromKey</code>. Этот параметр не разрешен во время обновления.

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

Таким образом вы можете указать прокси-сертификат ЦС (сертификат, который будет использоваться при подключении АктивногоШлюза к кластеру). Это позволяет установить соединение с кластером во время установки, позволяя программе установки АктивногоШлюза загрузить и установить любые необходимые дополнительные возможности.

Пароль сертификата указывается в виде файла, из которого считывается пароль.

Абсолютный путь к расположению настраиваемых доверенных корневых сертификатов для добавления:
<code>CA_CERTIFICATE_FILE=<path></code>
Абсолютный путь к местоположению файла, содержащего пароль сертификата:
<code>CA_CERTIFICATE_PASSWORD_FILE=<path></code>
Пример команды:mple:
<code>C:\AstromKey-ActiveGate-Windows-x86-<version>.exe CA_CERTIFICATE_FILE=D:\Users\Fred\myCert.jks CA_CERTIFICATE_PASSWORD_FILE=D:\Users\Fred\myPwd.txt</code>

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

Пароль сертификата указывается в виде файла, из которого считывается пароль.

Абсолютный путь к местоположению сертификата аутентификации, который АктивныйШлюз предоставляет подключающимся клиентам, ЕдинымАгентам, или подключениям из браузерных клиентов (таких как RUM JavaScript):
<code>CERTIFICATE_FILE=<path></code>
Абсолютный путь к местоположению файла, содержащего пароль сертификата, для сертификата аутентификации, который АктивныйШлюз предоставляет подключающимся клиентам:
<code>CERTIFICATE_PASSWORD_FILE=<path></code>
Пример команды:
<code>C:\AstromKey-ActiveGate-Windows-x86-<version>.exe CERTIFICATE_FILE=D:\Users\Fred\myCert.jks CERTIFICATE_PASSWORD_FILE=D:\Users\Fred\myPwd.txt</code>

=== Сетевая зона ===
<code>--set-network-zone=<name></code>
Определяет сетевую зону, к которой принадлежит АктивныйШлюз. Он может принадлежать только одной сетевой зоне. Имя сетевой зоны представляет собой строку буквенно-цифровых символов, дефисов <code>(-)</code>, знаков подчеркивания <code>(_)</code> и точек <code>(.)</code>. Точки используются в качестве разделителей, поэтому вы не должны использовать точку в качестве первого символа имени сетевой зоны. Длина строки ограничена 256 символами.

Этот параметр не разрешен во время обновления.

=== Группа ===
<code>--set-group=<name></code>
Определяет группу АктивныхШлюзов, к которой принадлежит АктивныйШлюз. АктивныйШлюз может принадлежать только одной группе. Имя группы АктивныхШлюзов представляет собой строку буквенно-цифровых символов, дефисов (-), знаков подчеркивания (_) и точек (.). Точки используются в качестве разделителей, поэтому вы не должны использовать точку в качестве первого символа имени группы. Длина строки ограничена 256 символами. Вы можете использовать группы АктивныхШлюзов для выполнения массовых действий на ваших АктивныхШлюзах, таких как управление расширениями 2.0, работающими на АктивныхШлюзах.

Этот параметр не разрешен во время обновления.

=== Время соединения ===
<code>ASTROMKEY_ACTIVEGATE_SERVER_CONNECTION_TIMEOUT=<seconds></code>
Определяет максимальное количество секунд (по умолчанию: <code>120</code>), в течение которых программа установки будет ожидать подключения к кластеру. В развертываниях Linux этот параметр необходимо использовать как переменную среды.

Время ожидания соединения, указанное в переменной среды <code>ASTROMKEY_ACTIVEGATE_SERVER_CONNECTION_TIMEOUT=<секунды></code>, используется на двух этапах установки:

* При загрузке дополнительных (необязательных) возможностей.
* При ожидании соединения с кластером в конце установки АктивныхШлюзов: это соединение затем используется АктивнымШлюзом во время его нормальной работы.

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

Чтобы проверить успешность установки и подключения, войдите в AstromKey, в разделе '''Настройки''' выберите '''Статус развертывания''', а затем перейдите на вкладку '''АктивныеШлюзы'''.

Направление трафика ЕдиногоАгента

2022-09-28T16:20:46Z

RGolovanov:

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

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

=== Маршрутизация сообщений (модуль Routing) ===

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

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

==== Аутентификация ====
АктивныйШлюз аутентифицирует запросы ЕдиныхАгентов (подтверждение SSL и аутентификация по идентификатору среды).

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

=== Дампы памяти (модуль Memory Dumps) ===
Дампы памяти поступают от ЕдиныхАгентов и, таким образом, могут рассматриваться как часть функции маршрутизации АктивныхШлюзов.

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

== Мониторинг облачных сред и удаленных технологий ==

==== AWS-мониторинг (модуль AWS) ====
Мониторинг сервисов AWS — ресурсоемкая задача. Поэтому для мониторинга более 2000 ресурсов AWS необходимо установить АктивныйШлюз и настроить мониторинг AWS.

==== Мониторинг Cloud Foundry (модуль Cloud Foundry) ====
Чтобы подключить свои фонды Cloud Foundry к Ключу-Астром, вам необходимо установить АктивныйШлюз, чтобы дополнить метрики Cloud Foundry на уровне процессов и хостов, собранные ЕдинымиАгентами, дополнительными метаданными и метриками, полученными из Cloud Foundry API. Эта интеграция позволяет вам использовать обзорную страницу Cloud Foundry, а также автоматическое обнаружение ваших организаций Cloud Foundry в дополнение к другим свойствам процесса Cloud Foundry, таким как <code>пространство</code>, <code>идентификатор пространства</code>, <code>приложение</code>, <code>идентификатор приложени</code>я и <code>индекс экземпляра</code>.

==== Мониторинг Kubernetes/OpenShift (модуль Kubernetes) ====
Чтобы подключить кластеры Kubernetes/OpenShift к Ключу-Астром и воспользоваться преимуществами специальной страницы обзора Kubernetes/OpenShift, вам необходимо запустить Активный Шлюз версии 1.163+ в своей среде.

==== Мониторинг Azure (модуль Azure) ====
Для интеграции данных мониторинга Azure требуется выделенный АктивныйШлюз для опроса метаданных и метрик из API Azure. Эта интеграция позволяет осуществлять мониторинг служб Azure (особенно для облачных служб, где мы не можем установить ЕдиныхАгентов), а также осуществлять мониторинг через пользовательский интерфейс.

==== Мониторинг с помощью расширения АктивногоШлюза (модули Расширения 1.0, Расширения 2.0) ====
С расширениями АктивныхШлюзов вы можете распространить мониторинг на любую удаленную технологию, предоставляющую интерфейс, где установка ЕдиныхАгентов невозможна. Например, технологии PaaS, сетевые устройства или облачные технологии. Расширения АктивныхШлюзов (также известные как удаленные плагины) выполняются на АктивныхШлюзах и могут получать метрики и информацию о топологии из удаленных источников, тем самым полностью интегрируя удаленный мониторинг технологий в Ключ-Астром Smartscape и обнаружение проблем. В настоящее время эта возможность предлагается только в АктивныхШлюзах Окружения.

==== Информация о базе данных Oracle (модуль Анализ Базы Данных) ====
Инсайты по базам данных добавляют взгляд на инфраструктуру к мониторингу вашей базы данных. С помощью дополнительных данных, получаемых с уровня базы данных, вы можете решить проблемы с производительностью, глубоко укоренившиеся в базе данных.

==== Мониторинг виртуализированной инфраструктуры (модуль VMware) ====
АктивныйШлюз может опросить ваш vCenter или автономные хосты ESXi, чтобы получить информацию обо всех важных ресурсах, которые серверы ESXi предоставляют вашим виртуальным машинам (например, об использовании ЦП, потреблении памяти и действиях, связанных с хранилищем данных, на вашей платформе VMware). Чтобы получить эту информацию, Ключу-Астром необходим компонент, установленный в вашей среде, который имеет доступ к vCenter API.

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

АктивныйШлюз поддерживает вызовы ко всем конечным точкам версий v1 и v2 API-интерфейсов конфигурации и среды.

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

==== Прием метрик (модуль API HTTP-метрик) ====
Прием метрик предоставляет вам простой способ передать любые пользовательские метрики в Ключ-Астром. Вы можете дополнительно уточнить свои показатели по категориям.

==== Прием трассировки OpenTelemetry (модуль OTLP Ingest) ====
Вы можете отправлять данные трассировки OpenTelemetry (трассы и интервалы) в формате OTLP в Ключ-Астром через API, доступный на АктивномШлюзе. Полученные диапазоны интегрируются в распределенные трассировки PurePath®.

==== Real User Monitoring (модуль Beacon Forwarder) ====
Инфраструктура Ключ-Астром может использоваться в качестве конечной точки маяка по умолчанию для безагентного мониторинга ваших приложений. Автоматически внедряемые приложения отправляют маяк обратно на веб-сервер клиента, минуя необходимость в стороннем домене. Однако при необходимости такие приложения также могут использовать инфраструктуру в качестве конечной точки для сигналов мониторинга RUM.

Настройка прокси АктивногоШлюза

2022-09-28T16:19:44Z

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

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

== Свойства конфигурации прокси ==
Конфигурация прокси АктивногоШлюза состоит из следующих настроек. В зависимости от типа связи, для которой вы хотите использовать (или отключить) прокси, следующие свойства конфигурации могут появиться в разных разделах конфигурации вашей конфигурации АктивногоШлюза.
{| class="wikitable"
!Свойство
!Описание
|-
|<code>proxy-server</code>
|Адрес сервера (имя хоста или IP-адрес)
|-
|<code>proxy-port</code>
|Порт (необязательно)

Если оставить пустым, используется порт <code>8080</code> по умолчанию.
|-
|<code>proxy-user</code>
|Имя пользователя (необязательно)
|-
|<code>proxy-domain</code>
|Домен пользователя в случае аутентификации NTLM
|-
|<code>proxy-password</code>
|Пароль (необязательно)

Пароль, указанный в свойстве <code>proxy-password</code>, обфусцируется после перезапуска АктивногоШлюза, а замаскированный пароль сохраняется в свойстве <code>proxy-password-encr</code>.
|-
|<code>proxy-off</code>
|Если установлено значение <code>true</code>, прокси отключается для определенного типа связи.
|-
|<code>proxy-non-proxy-hosts</code>
|Список хостов, для связи с которыми АктивныйШлюз не должен использовать прокси

Хосты в списке должны быть разделены символом <code>|</code> персонажи. Вы также можете использовать звездочку <code>*</code> в качестве подстановочного знака для соответствия любой строке. Может быть только один подстановочный знак в начале или в конце имени хоста. Например, <code>proxy-non-proxy-hosts=*.foo.com|localhost</code> указывает, что каждый хост в домене <code>foo.com</code> и <code>localhost</code> должен быть доступен напрямую, даже если указан прокси-сервер. Полное описание допустимого синтаксиса см. в синтаксисе параметра <code>http.nonProxyHosts</code> в свойствах сети.
|}

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

* Отредактируйте файл <code>custom.properties</code> в каталоге конфигурации АктивногоШлюза.
* Укажите параметры прокси в соответствующем разделе конфигурации файла <code>custom.properties</code>, в зависимости от того, для каких целей вы хотите использовать прокси (см. примеры ниже). Например:

<code>[http.client]
proxy-server=127.0.0.1
proxy-port=8080
# basic authentication credentials
proxy-user=username
proxy-password=password</code>

* Сохраните файл <code>custom.properties</code>.
* Перезапустите основную службу АктивногоШлюза. Обратите внимание, что после перезапуска службы пароль прокси, указанный вами в конфигурации, шифруется и перемещается из свойства <code>proxy-password</code> в <code>proxy-password-encr</code>.

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

=== Настройки прокси АктивногоШлюза для всего исходящего трафика ===

Следующая конфигурация охватывает наиболее распространенный случай указания параметров прокси-сервера для исходящего соединения АктивногоШлюза как с кластером Ключ-Астром, так и с отслеживаемыми технологиями, такими как AWS, VMware или Azure.

Укажите параметры, связанные с прокси, в разделе <code>[http.client]</code> файла <code>custom.properties</code>, включая параметры, связанные с аутентификацией, если это необходимо:
<code>[http.client]
proxy-server=127.0.0.1
proxy-port=8080
# basic authentication credentials
proxy-user=username
proxy-password=password</code>

=== Настройки прокси АктивногоШлюза только для кластера ===
Чтобы настроить прокси специально для кластера, позволяя исходящему мониторинговому трафику напрямую подключаться к отслеживаемым технологиям, задайте настройки прокси в разделе <code>[http.client.internal]</code> конфигурации АктивногоШлюза.
<code>[http.client.internal]
proxy-server=127.0.0.1
proxy-port=8080
# basic authentication credentials
proxy-user=username
proxy-password=password</code>
'''Примечание:'''

Для корректной работы связи АктивногоШлюза после указания вышеперечисленных настроек вам потребуется повторить настройки связи без прокси в <code>http.client.internal</code> или <code>http.client.external</code> и/или вам потребуется создать разделы <code>http.client.internal</code> или <code>http.client.external</code>.

=== Прокси-сервер АктивногоШлюза для исходящего трафика мониторинга с прямым подключением к кластеру ===
Чтобы настроить прокси специально для исходящего трафика мониторинга, но оставить прямое подключение к кластеру:

* Укажите конфигурацию прокси в разделе <code>[http.client]</code> файла <code>custom.properties</code>.
* Отключите прокси в разделе <code>[http.client.internal]</code>.

<code>[http.client]
proxy-server=127.0.0.1
proxy-port=8080
# basic authentication credentials
proxy-user=username
proxy-password=password

[http.client.internal]
proxy-off=true</code>
'''Примечание:'''

Для корректной работы связи АктивногоШлюза после указания вышеперечисленных настроек вам потребуется повторить настройки связи без прокси в <code>http.client.internal</code> или <code>http.client.external</code> и/или вам потребуется создать разделы <code>http.client.internal</code> или <code>http.client.external</code>.

== Расширенные сценарии настройки прокси для АктивногоШлюза ==
Чтобы настроить прокси '''для исходящих подключений''' из АктивногоШлюза, то есть для подключений к отслеживаемым технологиям или к кластеру, отредактируйте файл <code>custom.properties</code> и задайте свойства в соответствующем разделе. В зависимости от раздела конфигурации, в котором указаны свойства, прокси (и другие параметры связи) влияют только на выбранные типы соединений:

* <code>[http.client]</code> — настройки прокси для всех исходящих соединений АктивногоШлюза, включая кластер и все отслеживаемые технологии.
* <code>[http.client.internal]</code> — настройки прокси специально для связи с кластером. Эти настройки переопределяют настройки, указанные в <code>[http.client]</code>.
* <code>[http.client.external]</code> — настройки прокси специально для отслеживаемых технологий: CloudFoundry, Kubernetes, приватный синтетический мониторинг. Эти настройки переопределяют настройки, указанные в <code>[http.client]</code>.
* <code>[<technology name>]</code> — настройки прокси специально для конкретной отслеживаемой технологии, например <code>cloudfoundry_monitoring</code>, <code>kubernetes_monitoring</code>, <code>synthetic</code>. Эти параметры переопределяют параметры, указанные в <code>[http.client]</code> и <code>[http.client.external]</code>. Обратите внимание, что настройки для многих из этих технологий можно указать совместно в <code>[http.client.external]</code>.

=== Прокси АктивногоШлюза для Kubernetes, CloudFoundry и частного синтетического мониторинга ===
Вы можете указать настройки прокси сразу для нескольких отслеживаемых технологий. Настройки, указанные в разделе <code>http.client.external</code>, влияют на Kubernetes, CloudFoundry и приватный синтетический мониторинг (этот набор может быть расширен в будущем):
<code>[http.client.external]
proxy-server=127.0.0.1
proxy-port=8080
# basic authentication credentials
proxy-user=username
proxy-password=password</code>
'''Примечание:'''

Для корректной работы связи АктивногоШлюза после указания вышеперечисленных настроек вам потребуется повторить настройки связи без прокси в <code>http.client.internal</code> или <code>http.client.external</code> и/или вам потребуется создать разделы <code>http.client.internal</code> или <code>http.client.external</code>.

=== Разные прокси для Kubernetes, CloudFoundry и частный синтетический мониторинг ===
Вы также можете указать выделенные настройки прокси для конкретной отслеживаемой технологии:

* Cloud Foundry в разделе <code>cloudfoundry_monitoring</code>
* Kubernetes в разделе <code>kubernetes_monitoring</code>
* Приватный синтетический мониторинг в разделе <code>synthetic</code>

<code>[kubernetes_monitoring]
proxy-server=127.0.0.1
proxy-port=8080
# basic authentication credentials
proxy-user=username
proxy-password=password</code>

== Текущие ограничения ==

=== Повторение настроек связи в <code>[http.client.internal]</code> или <code>[http.client.external]</code>. ===
При указании конфигурации прокси в <code>[http.client.internal]</code> или <code>[http.client.external]</code> обратите внимание, что эти разделы затрагивают различные аспекты связи, а не только прокси. При создании любого из этих разделов обязательно сначала скопируйте содержимое существующего раздела <code>[http.client]</code> из файла <code>configuration.properties</code> (и настройте его соответствующим образом):

* Откройте файл <code>config.properties</code> и скопируйте все свойства из раздела <code>[http.client]</code> в файл <code>custom.properties</code>, раздел <code>[http.client.internal]</code> или <code>[http.client.external]</code> (в зависимости от ситуации).
* Если в файле <code>custom.properties</code> есть раздел <code>[http.client]</code>, используйте перечисленные там значения, чтобы перезаписать указанные выше значения (значения, которые вы только что скопировали из <code>config.properties</code>).

<code>[http.client.external]
# proxy settings as specific to http.client.external:
proxy-server=127.0.0.1
proxy-port=8080
# basic authentication credentials
proxy-user=username
proxy-password=password
# communication settings copied from existing configuration:
connection-timeout=5000
socket-timeout=20000
connection-request-timeout=5000
idle-connection-timeout=15000
max-total-connections=256
max-connections-per-route=32
certificate-validation=yes
hostname-verification=yes</code>

Параметры АктивногоШлюза

2022-09-27T13:27:24Z

RGolovanov:

== Основные правила работы с конфигурацией АктивногоШлюза ==

=== Файлы конфигурации АктивногоШлюза ===
Многие параметры конфигурации АктивногоШлюза (например, параметры подключения и прокси-сервера, шифры или параметры дампа памяти) хранятся в файлах свойств <code>config.properties</code> и <code>custom.properties</code>, которые расположены в каталоге конфигурации АктивногоШлюза. Свойства, перечисленные в файлах свойств, применимы для АктивныхШлюзов Окружений и Кластера.

Файлы <code>config.properties</code> и <code>custom.properties</code> разделены на секции. Каждое название раздела заключено в квадратные скобки, например:
<code>[collector]
MSGrouter = true
restInterface = true
DumpSupported = false</code>

=== config.properties ===
Файл конфигурации <code>config.properties</code> содержит параметры установки АктивногоШлюза по умолчанию и не может быть изменен. Примечание: Этот файл конфигурации перезаписывается при каждом обновлении АктивногоШлюза.

=== custom.properties ===
Настройки, хранящиеся в <code>custom.properties</code>, переопределяют соответствующие настройки в <code>config.properties</code>, и во время обновления файл копируется в новую версию АктивногоШлюза.

Файлы конфигурации разбиты на <code>[разделы]</code>, которые указаны в квадратных скобках.

Чтобы указать настраиваемые параметры в <code>custom.properties</code>, введите имена разделов и включите соответствующие свойства в эти разделы.

Вы можете использовать файл <code>config.txt</code> в качестве справки при добавлении пользовательских настроек в файл <code>custom.properties</code>. Файл <code>config.txt</code>, который также находится в каталоге конфигурации АктивногоШлюза, не используется АктивныйШлюз, однако содержит справочный список возможных свойств конфигурации. Кроме того, вы можете сначала найти соответствующий раздел в файле <code>config.properties</code>, а затем скопировать заголовок раздела вместе с именами нужных свойств в <code>custom.properties</code>.

После этого вы можете изменить записи в разделе по мере необходимости.

=== launcheruserconfig.conf ===
Средство запуска АктивногоШлюза — это наблюдающий процесс, который запускает виртуальную машину Java для вашего АктивногоШлюза. Конфигурация лаунчера хранится в файле <code>launcheruserconfig.conf</code> в каталоге конфигурации АктивногоШлюза. Он содержит свойства и параметры запуска, которые передаются виртуальной машине Java.

Файл <code>launcheruserconfig.conf</code> сохраняется во время обновлений АктивногоШлюза.

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

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

* Настройки ограничения памяти могут быть комбинацией:
** <code>-java.xmx.relative_part</code> — процента доступной оперативной памяти
** <code>-java.xmx.absolute_part</code> — абсолютного значения объема памяти в МБ.

Например:
<code># Xmx settings 83% of available RAM + 0 MB
-java.xmx.absolute_part=0
-java.xmx.relative_part=83
-healthcheck.heartbeat.portrange=60100:60200
-arguments_section.jvm
-Dsomecustomproperty=value</code>

== Диапазон портов АктивногоШлюза ==
Средство запуска АктивногоШлюза отслеживает процесс АктивногоШлюза на локальном контрольном порту. Этот порт выбирается программой запуска из предопределенного диапазона портов, указанного в конфигурации программы запуска. Программа запуска находит свободный порт в заданном диапазоне, а затем передает номер порта процессу АктивногоШлюза.

По умолчанию программа запуска будет использовать порты выше 50000 для мониторинга пульса. Для некоторых развертываний может потребоваться настроить для этой цели другие порты. Чтобы указать диапазон портов, который должен использовать модуль запуска АктивногоШлюза, добавьте или измените свойство <code>-healthcheck.heartbeat.portrange</code> в файле конфигурации модуля запуска <code>launcheruserconfig.conf</code>, как в примере ниже.
<code># Xmx settings 80% of available RAM + 0 MB
-java.xmx.absolute_part=0
-java.xmx.relative_part=83
-healthcheck.heartbeat.portrange=60100:60200
-arguments_section.jvm
-Dsomecustomproperty=value</code>

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

* Все строки после <code>-arguments_section.jvm</code> передаются в качестве аргументов JVM. Таким образом, указав опции <code>-D</code>, вы можете указать аргументы для АктивногоШлюза.

Например:
<code># Xmx settings 80% of available RAM + 0 MB
-java.xmx.absolute_part=0
-java.xmx.relative_part=83
-healthcheck.heartbeat.portrange=60100:60200
-arguments_section.jvm
-Dsomecustomproperty=value</code>

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

Модуль активен, если соответствующее свойство конфигурации указано со значением <code>true</code> в разделе конфигурации, посвященном модулю. Обратите внимание, однако, что вы не можете включить все модули, используя <code>custom.properties</code>, просто изменив значение свойства: если вы установили свой АктивныйШлюз, чтобы он служил в качестве частного синтетического местоположения или для мониторинга мейнфрейма, и вам нужно изменить цель вашего АктивногоШлюза , вам необходимо переустановить АктивныйШлюз.

Каждый модуль имеет соответствующий раздел в конфигурации

В дополнение к разделам конфигурации, предназначенным для определенных функций АктивногоШлюза, каждый модуль АктивногоШлюза имеет собственный раздел в файлах конфигурации АктивногоШлюза. Настройки, указанные в этом разделе, относятся именно к этому модулю. Это относится, например, к настройкам прокси. Однако не все настройки можно повторить таким образом и указать для модуля: каждый раздел модуля имеет только ограниченное количество принимаемых опций. '''НЕ копируйте параметры конфигурации между разделами, если только это не указано специально'''.

=== Модуль AWS ===
AWS-мониторинг

'''Раздел: [aws_monitoring]'''
{| class="wikitable"
!Свойство
!Описание
|-
|<code>aws_monitoring_enabled</code>
|Включает модуль мониторинга AWS. Возможные значения: <code>true</code> или <code>false</code>.
|}

=== Модуль Azure ===
Мониторинг Microsoft Azure

'''Раздел: [azure_monitoring]'''
{| class="wikitable"
!Свойство
!Описание
|-
|<code>azure_monitoring_enabled</code>
|Включает модуль Microsoft Azure. Возможные значения: <code>true</code> или <code>false</code>.
|}

=== Модуль Cloud Foundry ===
Мониторинг Cloud Foundry

'''Раздел: [cloudfoundry_monitoring]'''
{| class="wikitable"
!Свойство
!Описание
|-
|<code>cloudfoundry_monitoring_enabled</code>
|Включает модуль Cloud Foundry. Возможные значения: <code>true</code> или <code>false</code>.
|}
Этот раздел может содержать настройки прокси для связи с Cloud Foundry. Если в этом разделе указано <code>proxy-off=true</code>, то прокси для связи с Cloud Foundry отсутствует. Если он содержит свойство <code>proxy-host</code>, то для мониторинга Cloud Foundry будет использоваться именно этот прокси, а не прокси, указанный в <code>[http.client.external]</code>.

'''Примечание'''. Если у вас есть раздел <code>[cloudfoundry_monitoring]</code> в вашем файле <code>custom.properties</code>, вам также необходимо иметь раздел <code>[http.client.external]</code>, где вы должны указать все остальные параметры связи <code>.rs</code>, которые будут использоваться для связи Cloud Foundry.

=== Модуль Kubernetes ===
Мониторинг Kubernetes

'''Раздел: [kubernetes_monitoring]'''
{| class="wikitable"
!Свойство
!Описание
|-
|<code>kubernetes_monitoring_enabled</code>
|Включает модуль мониторинга Kubernetes. Возможные значения: <code>true</code> или <code>false</code>.
|}
Этот раздел может содержать параметры прокси-сервера для связи с Kubernetes, а также другие параметры, связанные с тонкой настройкой параметров связи для мониторинга Kubernetes.

Если в этом разделе указано <code>proxy-off=true</code>, то прокси для связи с Kubernetes отсутствует. Если он содержит свойство <code>proxy-host</code>, то для мониторинга Kubernetes будет использоваться именно этот прокси, а не прокси, указанный в <code>[http.client.external]</code>.

'''Примечание'''. Если у вас есть раздел <code>[kubernetes_monitoring]</code> в файле <code>custom.properties</code>, вам также потребуется раздел <code>[http.client.external]</code>, в котором вы должны указать все остальные параметры связи, которые будут использоваться для связи Kubernetes.

=== Модуль Мониторинга логов ===
'''Раздел: [log_analytics_collector]'''
{| class="wikitable"
!Свойство
!Описание
|-
|<code>log_analytics_collector_enabled</code>
|Включает модуль мониторинга логов. Возможные значения: <code>true</code> или <code>false</code>.
|}
'''Раздел: [generic_ingest]'''

В частности, для мониторинга журналов при настройке универсального приема журналов можно настроить свойства очереди данных журнала. Вы можете указать временную папку, в которой будут храниться данные журнала очереди (по умолчанию это временная папка, настроенная в настоящее время в вашей системе), и изменить максимальный размер очереди, которая будет использоваться в этой папке (размер по умолчанию — 300 МБ).
{| class="wikitable"
!Свойство
!Значение по умолчанию
!Описание
|-
|<code>disk_queue_path</code>
|Текущая общесистемная временная папка
|Указывает путь к временной папке, в которой будут храниться данные журнала, поставленные в очередь.
|-
|<code>disk_queue_max_size_mb</code>
|300 МБ
|Задает максимальный размер данных журнала в очереди, которые можно хранить во временной папке.
|}

=== Модуль VMware ===
Мониторинг VMware

'''Раздел: [vmware_monitoring]'''
{| class="wikitable"
!Свойство
!Описание
|-
|<code>vmware_monitoring_enabled</code>
|Включает модуль мониторинга VMware. Возможные значения: <code>true</code> или <code>false</code>.
|}

=== Модуль Анализа БД ===
Информация о базе данных Oracle

'''Раздел: [dbAgent]'''
{| class="wikitable"
!Свойство
!Описание
|-
|<code>dbAgent_enabled</code>
|Включает модуль анализа базы данных Oracle. Возможные значения: <code>true</code> или <code>false</code>.
|}

=== Модуль Расширений 1.0 ===
'''Раздел: [rpm]'''
{| class="wikitable"
!Свойство
!Описание
|-
|<code>rpm_enabled</code>
|Включает модуль удаленных плагинов, который используется для запуска расширений АктивногоШлюза. Возможные значения: <code>true</code> или <code>false</code>.
|}

=== Модуль Расширений 2.0 ===
'''Раздел: [extension_controller]'''
{| class="wikitable"
!Свойство
!Описание
|-
|<code>extension_controller_enabled</code>
|Включает модуль Расширений 2.0. Возможные значения: <code>true</code> или <code>false</code>.
|}

=== Модуль zRemote ===
Установка модуля zRemote для мониторинга z/OS.

'''Раздел: [zremote]'''
{| class="wikitable"
!Свойство
!Описание
|-
|<code>zremote_enabled</code>
|Включает модуль zRemote. Возможные значения: <code>true</code> или <code>false</code>.
|}

=== Модуль Синтетики ===
Синтетические мониторы из частных синтетических локаций

'''Раздел: [synthetic]'''

Настройки прокси для синтетического мониторинга. Если в этом разделе указано <code>proxy-off=true</code>, то прокси для Синтетического мониторинга нет. Если он содержит свойство <code>proxy-host</code>, то этот прокси будет использоваться для синтетического мониторинга, а не прокси, указанный в <code>[http.client.external]</code> (или в <code>[http.client]</code>, если <code>[http.client.external]</code> не определено).

'''Примечание'''. Если у вас есть раздел <code>[synthetic]</code> в вашем файле <code>custom.properties</code>, у вас может быть раздел <code>[http.client.external]</code>, в котором вы должны указать все остальные параметры связи, которые будут использоваться для синтетического мониторинга. Кроме того, вы можете указать остальные параметры связи в разделе <code>[http.client]</code>.

'''Однако, если вы создаете раздел <code>[http.client.external]</code>, вы должны указать там все параметры связи. В противном случае параметры связи для отслеживаемых сред (Cloud Foundry, Kubernetes или Synthetic Monitoring) вернутся к заводским значениям по умолчанию.'''

Обратите внимание, что изменение свойства <code>synthetic_enabled</code> работает только в том случае, если вы установили АктивныйШлюз для запуска синтетических мониторов из частного местоположения. Если вы установили АктивныйШлюз для маршрутизации трафика, мониторинга облачных сред или мониторинга удаленных технологий с помощью расширений или мониторинга мейнфрейма, вам необходимо переустановить АктивныйШлюз, чтобы использовать его для синтетического мониторинга.
{| class="wikitable"
!Свойство
!Значение по умолчанию
!Описание
|-
|<code>synthetic_enabled</code>
|<code>false</code> в режиме развертывания '''по умолчанию'''
<code>true</code> в режиме развертывания '''Синтетический мониторинг'''
|Позволяет АктивномуШлюзу выполнять мониторы из частных синтетических местоположений.
|-
|<code>synthetic_autoinstall</code>
|<code>true</code> для автоматического обновления движка Синтетики
|Автоматически устанавливается в <code>true</code> во время установки для синтетических АктивныхШлюзов.
|-
|<code>proxy-server</code>
|unset
|Адрес прокси-сервера
|-
|<code>proxy-port</code>
|unset
|Порт прокси (числовой)
|-
|<code>proxy-user</code>
|unset
|Имя пользователя прокси (необязательно)
|-
|<code>proxy-password</code>
|unset
|Пароль прокси (необязательно)
Пароль, указанный в свойстве <code>proxy-password</code>, обфусцируется после перезапуска АктивногоШлюза, а замаскированный пароль сохраняется в свойстве <code>proxy-password-encr</code>.
|-
|<code>proxy-off</code>
|unset
|Отключить прокси-связь между АктивнымШлюзом и тестируемым ресурсом.
|-
|<code>proxy-non-proxy-hosts</code>
|unset
|Не использовать прокси при общении с этими хостами.
|}
'''Важно'''

Мы рекомендуем вам не изменять значение свойства <code>synthetic_autoupgrade_chromium</code> в <code>custom.properties</code>, поскольку ваши изменения могут быть перезаписаны.

<code>synthetic_autoupgrade_chromium</code> для автообновления Chromium можно определить на уровне местоположения (для местоположений с АктивнымиШлюзами Окружений) либо через веб-интерфейс, либо с помощью вызова PUT API местоположения API синтетических местоположений v2. Для АктивногоШлюза Кластера это свойство можно настроить с помощью вызова PUT (Ключ-АстромManaged) API Кластера v2. Это свойство не определено для АктивныхШлюзов, которые не были назначены местоположению. Для Activates, назначенных местоположению, значением по умолчанию является <code>true</code>.

=== Модуль Beacon Forwarder ===
Использование АктивногоШлюза для реального мониторинга пользователей

'''Раздел: [beacon_forwarder]'''
{| class="wikitable"
!Свойство
!Описание
|-
|<code>beacon_forwarder_enabled</code>
|Включает модуль Beacon Forwarder. Возможные значения: <code>true</code> или <code>false</code>.
|}

=== Модуль API HTTP-метрик ===
Прием метрик: простой способ передать любые пользовательские метрики в Ключ-Астром

'''Раздел: [metrics_ingest]'''
{| class="wikitable"
!Свойство
!Описание
|-
|<code>metrics_ingest_enabled</code>
|Включает модуль HTTP Metric API, который упрощает прием метрик. Возможные значения: <code>true</code> или <code>false</code>.
|}

=== Модуль Дампов памяти ===
Запуск и загрузка дампов памяти

'''Раздел: [collector]'''
{| class="wikitable"
!Свойство
!Описание
|-
|<code>DumpSupported</code>
|Включает модуль дампов памяти. Возможные значения: <code>true</code> или <code>false</code>.
|}
Когда в вашем приложении возникают утечки памяти или большое количество объектов, важно получить дампы памяти, чтобы вы могли проанализировать эти проблемы. В производственных средах это часто становится проблемой, когда вы не можете войти в среду и у вас нет других средств запуска дампов памяти. Ключ-Астром позволяет вам запускать и безопасно загружать дампы памяти в инструмент анализа по вашему выбору.

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

'''Раздел: [collector]'''
{| class="wikitable"
!Свойство
!Описание
|-
|<code>MSGrouter</code>
|Включает модуль маршрутизации ЕдиныхАгентов, который направляет трафик ЕдиныхАгентов и другого АктивногоШлюза через Ключ-Астром. Возможные значения: <code>true</code> или <code>false</code>.
|}

=== Модуль OTLP-приёма ===
Этот модуль создает конечную точку на АктивномШлюзе, которая может получать данные трассировки OpenTelemetry (трассы и интервалы) в формате OTLP.

'''Раздел: [otlp_ingest]'''
{| class="wikitable"
!Свойство
!Описание
|-
|<code>otlp_ingest_enabled</code>
|Включает модуль приема OTLP, который упрощает прием трассировки OpenTelemetry. Возможные значения: <code>true</code> или <code>false</code>.
|}

=== Модуль REST API ===
'''Раздел: [collector]'''

Вы можете использовать АктивныйШлюз для доступа к API Ключ-Астром. АктивныйШлюз поддерживает вызовы всех конечных точек конфигурации и среды API в версиях v1 и v2. Чтобы получить доступ к API Ключ-Астром с помощью АктивногоШлюза, используйте URL-адрес в следующем формате: <nowiki>https://{ваш-АктивныйШлюз-домен}/e/{идентификатор</nowiki> вашей среды}/api/...
{| class="wikitable"
!Свойство
!Описание
|-
|<code>restInterface</code>
|Включает модуль REST API, упрощающий доступ к API Ключ-Астром с помощью REST. Возможные значения: <code>true</code> или <code>false</code>.
|}

=== Раздел Адреса балансировщика нагрузки ===
'''Раздел: [connectivity]'''
{| class="wikitable"
!Свойство
!Значение по умолчанию
!Описание
|-
|<code>dnsEntryPoint</code>
|unset
|Точки входа для АктивногоШлюза (например, <code><nowiki>https://sg1.mydomain.com:9999</nowiki></code>). ЕдиныйАгент получает доступ к АктивномуШлюзу через этот URL-адрес (или список URL-адресов — значением этого свойства может быть список, разделенный запятыми). Если не задано, используется автоматически определяемая конечная точка. Эту запись можно использовать, если доступ к АктивномуШлюзу осуществляется, например, через внешний IP-адрес или балансировщик нагрузки. В зависимости от развертывания АктивногоШлюза убедитесь, что вы используете правильный префикс (<code>http</code> или <code>https</code>), иначе ваши ЕдиныеАгенты не смогут подключиться.

'''Примечание'''. Чтобы избежать ненужных DNS-запросов и повысить безопасность, вы можете пометить доменное имя как полное доменное имя (FQDN), добавив точку в конце URL-адреса. Например, <code>www.example.com</code> является абсолютным доменным именем.
|}

=== Раздел Сетевых зон ===
'''Раздел: [connectivity]'''
{| class="wikitable"
!Свойство
!Значение по умолчанию
!Описание
|-
|<code>networkZone</code>
|unset
|Определяет сетевую зону, к которой принадлежит АктивныйШлюз. АктивныйШлюз может принадлежать только одной сетевой зоне. Имя сетевой зоны представляет собой строку буквенно-цифровых символов, дефисов <code>(-)</code>, знаков подчеркивания <code>(_)</code> и точек <code>(.)</code>. Точки используются в качестве разделителей, поэтому вы не должны использовать точку в качестве первого символа имени сетевой зоны. Длина строки ограничена 256 символами.
После добавления или изменения этого параметра требуется перезапуск АктивногоШлюза. После перезапуска в Ключе-Астром автоматически создается сетевая зона.
|}

=== Раздел Групп ===
'''Раздел: [collector]'''
{| class="wikitable"
!Свойство
!Значение по умолчанию
!Описание
|-
|<code>group</code>
|unset
|Группа АктивныхШлюзов
|}

=== Раздел Файловый кэш АктивныхШлюзов ===
Требуется АктивныйШлюз версии 1.241+

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

Кэш файлов активируется автоматически при установке или обновлении АктивногоШлюза. Однако активация происходит только при соблюдении минимального требования к пространству в 512 МБ. Если минимальные требования к пространству не выполняются, кэширование автоматически деактивируется.

Файловый кеш можно настроить или отключить в конфигурации АктивногоШлюза, в файле <code>custom.properties</code>:

'''Раздел: [generic_filecache]'''
{| class="wikitable"
!Свойство
!Значение по умолчанию
!Описание
|-
|<code>generic_filecache_enabled</code>
|<code>true</code>
|Включает или отключает файловый кеш АктивногоШлюза. Возможные значения: <code>true</code> или <code>false</code>.
|-
|<code>generic_filecache_path</code>
|<code><ActiveGate temporary directory>/generic_filecache</code>
|Путь к каталогу файлового кэша АктивногоШлюза. Каталог будет создан, если он не существует (если это позволяют права доступа к файлу).
|-
|<code>generic_filecache_size</code>
|<code>2147483648</code> (2 ГБ)
|Размер файлового кеша АктивногоШлюза в байтах.

Файловый кэш АктивногоШлюза будет занимать не больше места, чем указано в конфигурации. Если доступное пространство меньше размера, указанного в конфигурации, АктивныйШлюз будет использовать доступное пространство.
|-
|<code>generic_filecache_max_age</code>
|<code>1209600000</code> (14 дней)
|Максимальный возраст файлов, хранящихся в файловом кэше АктивногоШлюза, в миллисекундах. Возраст файла отсчитывается с момента последнего использования файла (а не с момента загрузки/создания).

Если файл не используется для настроенного максимального возраста, файл будет автоматически удален. Файлы также удаляются из кеша до достижения максимального возраста, если для новых файлов недостаточно места. Файлы LRU (наименее использовавшиеся) удаляются первыми.
|}

=== Раздел [com.compuware.apm.webserver] ===
{| class="wikitable"
!Свойство
!Значение по умолчанию
!Описание
|-
|<code>port-ssl</code>
|<code>9999</code>
|Порт, через который АктивныйШлюз прослушивает трафик ЕдиныхАгентов — используется для HTTPS-соединения.
|-
|<code>port</code>
|unset
|Порт, на котором АктивныйШлюз прослушивает трафик от ЕдиныхАгентов — используется для HTTP-соединения. По умолчанию он отключен.
В Linux рекомендуется значение > 1024, чтобы гарантировать, что привилегии root не потребуются.
|-
|<code>ssl-protocols</code>
|<code>TLSv1.2</code>, версия Ключ-Астром 1.247+ <code>TLSv1.3</code>
|Поддерживаемые протоколы SSL. Может быть одним или списком значений, разделенных запятыми. Обратите внимание, что указание конкретной версии не означает автоматически поддержку всех предыдущих/младших версий, поэтому вам необходимо явно указать каждую версию.

Допустимые значения:
<code>TLSv1</code>, <code>TLSv1.1</code>, <code>TLSv1.2</code>, <code>TLSv1.3</code>

'''Примечание'''. Если вам требуется <code>TLSv1.1</code> или более ранняя версия, также включите <code>_SHA</code>, удалив его из списка исключенных шифров.
|-
|<code>excluded-ciphers</code>
|unset
|Список исключенных шифров. Шифры определяются подстрокой, соответствующих хотя бы части имени шифра, например: <code>excluded-ciphers = TLS_RSA_WITH,SHA$,TLS_ECDH</code>
|-
|<code>certificate-file</code>
|unset
|Путь к файлу <code>PKCS#12</code>, содержащему сертификаты, которые будут использоваться веб-сервером АктивногоШлюза.
|-
|<code>certificate-password</code>
|unset
|Пароль к файлу сертификата.
|-
|<code>certificate-alias</code>
|unset
|Понятное имя сертификата в файле <code>PKCS#12</code>.
|}

==== Работа через HTTPS против HTTP ====
По умолчанию АктивныйШлюз работает безопасным образом, обслуживая входящие запросы по протоколу HTTPS. Это определяется свойством конфигурации <code>port-ssl</code>, которое можно настроить в файле <code>custom.properties</code>. Однако, если вы хотите, чтобы АктивныйШлюз использовал <code>HTTP</code>, вы должны указать свойство порта в <code>custom.properties</code>.

Обратите внимание, что безопасный способ используется по умолчанию и является рекомендуемым. Однако вы можете выбрать вариант HTTP из соображений производительности. Например, если у вас перед АктивнымШлюзом Кластера установлен балансировщик нагрузки и если балансировщик нагрузки прерывает входящие внешние SSL-соединения (см. третий сценарий развертывания).

=== Раздел [http.client] ===
Параметры связи, используемые для мониторинга AWS/VMware/Azure и для связи с кластером (если они не переопределены в <code>[http.client.internal]</code>). В частности, этот раздел содержит свойства конфигурации, связанные с настройками прокси-сервера и тайм-аутами соединения.

=== Раздел [http.client.internal] ===
Настройки, относящиеся только к связи с кластером Ключ-Астром.

В частности, этот раздел может содержать свойства конфигурации, связанные с настройками прокси-сервера и тайм-аутами соединения.

'''Если этот раздел не существует, связь с кластером Ключ-Астром определяется настройками в разделе <code>[http.client]</code>'''. Однако, если раздел <code>[http.client.internal]</code> существует, в котором конкретный параметр связи не указан, то для связи с кластером значение этого параметра '''считается заводским по умолчанию''' (не унаследовано от <code>[http.client]</code>).

=== Раздел [http.client.external] ===
Настройки связи для конкретных модулей: Cloud Foundry, Kubernetes, а также для Синтетического Мониторинга.

В частности, этот раздел может содержать свойства конфигурации, связанные с настройками прокси-сервера и тайм-аутами соединения.

Если в этом разделе указано <code>proxy-off=true</code>, то прокси для модулей нет. Если он содержит свойство <code>proxy-host</code>, то этот прокси будет использоваться для модулей.

'''Примечание'''. Параметры связи, указанные в <code>[http.client]</code>, не всегда используются модулями по умолчанию: если конкретный параметр связи не указан в <code>[http.client.external]</code>, то этот параметр — для Cloud Foundry, Kubernetes или Синтетического Мониторинга. — вернется к заводскому значению по умолчанию, а не к значению, указанному в <code>[http.client]</code>.

Точно так же, если весь раздел <code>[http.client.external]</code> не существует, все параметры связи для Kubernetes и Cloud Foundry вернутся к заводским значениям по умолчанию; однако параметры синтетического мониторинга будут принимать значения, указанные в разделе <code>[http.client]</code>.

Параметры АктивногоШлюза

2022-09-27T13:16:24Z

RGolovanov:

== Основные правила работы с конфигурацией АктивногоШлюза ==

=== Файлы конфигурации АктивногоШлюза ===
Многие параметры конфигурации АктивногоШлюза (например, параметры подключения и прокси-сервера, шифры или параметры дампа памяти) хранятся в файлах свойств <code>config.properties</code> и <code>custom.properties</code>, которые расположены в каталоге конфигурации АктивногоШлюза. Свойства, перечисленные в файлах свойств, применимы для АктивныхШлюзов Окружений и Кластера.

Файлы <code>config.properties</code> и <code>custom.properties</code> разделены на секции. Каждое название раздела заключено в квадратные скобки, например:
<code>[collector]
MSGrouter = true
restInterface = true
DumpSupported = false</code>

=== config.properties ===
Файл конфигурации <code>config.properties</code> содержит параметры установки АктивногоШлюза по умолчанию и не может быть изменен. Примечание: Этот файл конфигурации перезаписывается при каждом обновлении АктивногоШлюза.

=== custom.properties ===
Настройки, хранящиеся в <code>custom.properties</code>, переопределяют соответствующие настройки в <code>config.properties</code>, и во время обновления файл копируется в новую версию ActiveGate.

Файлы конфигурации разбиты на <code>[разделы]</code>, которые указаны в квадратных скобках.

Чтобы указать настраиваемые параметры в <code>custom.properties</code>, введите имена разделов и включите соответствующие свойства в эти разделы.

Вы можете использовать файл <code>config.txt</code> в качестве справки при добавлении пользовательских настроек в файл <code>custom.properties</code>. Файл <code>config.txt</code>, который также находится в каталоге конфигурации ActiveGate, не используется ActiveGate, однако содержит справочный список возможных свойств конфигурации. Кроме того, вы можете сначала найти соответствующий раздел в файле <code>config.properties</code>, а затем скопировать заголовок раздела вместе с именами нужных свойств в <code>custom.properties</code>.

После этого вы можете изменить записи в разделе по мере необходимости.

=== launcheruserconfig.conf ===
Средство запуска ActiveGate — это наблюдающий процесс, который запускает виртуальную машину Java для вашего ActiveGate. Конфигурация лаунчера хранится в файле <code>launcheruserconfig.conf</code> в каталоге конфигурации ActiveGate. Он содержит свойства и параметры запуска, которые передаются виртуальной машине Java.

Файл <code>launcheruserconfig.conf</code> сохраняется во время обновлений ActiveGate.

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

== Ограничения памяти ActiveGate ==
Ограничения на использование памяти для ActiveGate можно указать в конфигурационном файле лаунчера <code>launcheruserconfig.conf</code>.

* Настройки ограничения памяти могут быть комбинацией:
** <code>-java.xmx.relative_part</code> — процента доступной оперативной памяти
** <code>-java.xmx.absolute_part</code> — абсолютного значения объема памяти в МБ.

Например:
<code># Xmx settings 83% of available RAM + 0 MB
-java.xmx.absolute_part=0
-java.xmx.relative_part=83
-healthcheck.heartbeat.portrange=60100:60200
-arguments_section.jvm
-Dsomecustomproperty=value</code>

== Диапазон портов ActiveGate ==
Средство запуска ActiveGate отслеживает процесс ActiveGate на локальном контрольном порту. Этот порт выбирается программой запуска из предопределенного диапазона портов, указанного в конфигурации программы запуска. Программа запуска находит свободный порт в заданном диапазоне, а затем передает номер порта процессу ActiveGate.

По умолчанию программа запуска будет использовать порты выше 50000 для мониторинга пульса. Для некоторых развертываний может потребоваться настроить для этой цели другие порты. Чтобы указать диапазон портов, который должен использовать модуль запуска ActiveGate, добавьте или измените свойство <code>-healthcheck.heartbeat.portrange</code> в файле конфигурации модуля запуска <code>launcheruserconfig.conf</code>, как в примере ниже.
<code># Xmx settings 80% of available RAM + 0 MB
-java.xmx.absolute_part=0
-java.xmx.relative_part=83
-healthcheck.heartbeat.portrange=60100:60200
-arguments_section.jvm
-Dsomecustomproperty=value</code>

== Пользовательские параметры для Java-процесса ActiveGate ==
Чтобы передать пользовательские параметры Java-процессу ActiveGate, укажите параметры в конфигурационном файле лаунчера launcheruserconfig.conf:

* Все строки после <code>-arguments_section.jvm</code> передаются в качестве аргументов JVM. Таким образом, указав опции <code>-D</code>, вы можете указать аргументы для ActiveGate.

Например:
<code># Xmx settings 80% of available RAM + 0 MB
-java.xmx.absolute_part=0
-java.xmx.relative_part=83
-healthcheck.heartbeat.portrange=60100:60200
-arguments_section.jvm
-Dsomecustomproperty=value</code>

== Модули и разделы ActiveGate ==
Различные функциональные возможности, предоставляемые ActiveGate, называются модулями. Когда вы устанавливаете ActiveGate для определенной цели, устанавливается или включается другой набор модулей.

Модуль активен, если соответствующее свойство конфигурации указано со значением <code>true</code> в разделе конфигурации, посвященном модулю. Обратите внимание, однако, что вы не можете включить все модули, используя <code>custom.properties</code>, просто изменив значение свойства: если вы установили свой ActiveGate, чтобы он служил в качестве частного синтетического местоположения или для мониторинга мейнфрейма, и вам нужно изменить цель вашего ActiveGate , вам необходимо переустановить ActiveGate.

Каждый модуль имеет соответствующий раздел в конфигурации

В дополнение к разделам конфигурации, предназначенным для определенных функций ActiveGate, каждый модуль ActiveGate имеет собственный раздел в файлах конфигурации ActiveGate. Настройки, указанные в этом разделе, относятся именно к этому модулю. Это относится, например, к настройкам прокси. Однако не все настройки можно повторить таким образом и указать для модуля: каждый раздел модуля имеет только ограниченное количество принимаемых опций. '''НЕ копируйте параметры конфигурации между разделами, если только это не указано специально'''.

=== Модуль AWS ===
AWS-мониторинг

'''Раздел: [aws_monitoring]'''
{| class="wikitable"
!Свойство
!Описание
|-
|<code>aws_monitoring_enabled</code>
|Включает модуль мониторинга AWS. Возможные значения: <code>true</code> или <code>false</code>.
|}

=== Модуль Azure ===
Мониторинг Microsoft Azure

'''Раздел: [azure_monitoring]'''
{| class="wikitable"
!Свойство
!Описание
|-
|<code>azure_monitoring_enabled</code>
|Включает модуль Microsoft Azure. Возможные значения: <code>true</code> или <code>false</code>.
|}

=== Модуль Cloud Foundry ===
Мониторинг Cloud Foundry

'''Раздел: [cloudfoundry_monitoring]'''
{| class="wikitable"
!Свойство
!Описание
|-
|<code>cloudfoundry_monitoring_enabled</code>
|Включает модуль Cloud Foundry. Возможные значения: <code>true</code> или <code>false</code>.
|}
Этот раздел может содержать настройки прокси для связи с Cloud Foundry. Если в этом разделе указано <code>proxy-off=true</code>, то прокси для связи с Cloud Foundry отсутствует. Если он содержит свойство <code>proxy-host</code>, то для мониторинга Cloud Foundry будет использоваться именно этот прокси, а не прокси, указанный в <code>[http.client.external]</code>.

'''Примечание'''. Если у вас есть раздел <code>[cloudfoundry_monitoring]</code> в вашем файле <code>custom.properties</code>, вам также необходимо иметь раздел <code>[http.client.external]</code>, где вы должны указать все остальные параметры связи <code>.rs</code>, которые будут использоваться для связи Cloud Foundry.

=== Модуль Kubernetes ===
Мониторинг Kubernetes

'''Раздел: [kubernetes_monitoring]'''
{| class="wikitable"
!Свойство
!Описание
|-
|<code>kubernetes_monitoring_enabled</code>
|Включает модуль мониторинга Kubernetes. Возможные значения: <code>true</code> или <code>false</code>.
|}
Этот раздел может содержать параметры прокси-сервера для связи с Kubernetes, а также другие параметры, связанные с тонкой настройкой параметров связи для мониторинга Kubernetes.

Если в этом разделе указано <code>proxy-off=true</code>, то прокси для связи с Kubernetes отсутствует. Если он содержит свойство <code>proxy-host</code>, то для мониторинга Kubernetes будет использоваться именно этот прокси, а не прокси, указанный в <code>[http.client.external]</code>.

'''Примечание'''. Если у вас есть раздел <code>[kubernetes_monitoring]</code> в файле <code>custom.properties</code>, вам также потребуется раздел <code>[http.client.external]</code>, в котором вы должны указать все остальные параметры связи, которые будут использоваться для связи Kubernetes.

=== Модуль Мониторинга логов ===
'''Раздел: [log_analytics_collector]'''
{| class="wikitable"
!Свойство
!Описание
|-
|<code>log_analytics_collector_enabled</code>
|Включает модуль мониторинга логов. Возможные значения: <code>true</code> или <code>false</code>.
|}
'''Раздел: [generic_ingest]'''

В частности, для мониторинга журналов при настройке универсального приема журналов можно настроить свойства очереди данных журнала. Вы можете указать временную папку, в которой будут храниться данные журнала очереди (по умолчанию это временная папка, настроенная в настоящее время в вашей системе), и изменить максимальный размер очереди, которая будет использоваться в этой папке (размер по умолчанию — 300 МБ).
{| class="wikitable"
!Свойство
!Значение по умолчанию
!Описание
|-
|<code>disk_queue_path</code>
|Текущая общесистемная временная папка
|Указывает путь к временной папке, в которой будут храниться данные журнала, поставленные в очередь.
|-
|<code>disk_queue_max_size_mb</code>
|300 МБ
|Задает максимальный размер данных журнала в очереди, которые можно хранить во временной папке.
|}

=== Модуль VMware ===
Мониторинг VMware

'''Раздел: [vmware_monitoring]'''
{| class="wikitable"
!Свойство
!Описание
|-
|<code>vmware_monitoring_enabled</code>
|Включает модуль мониторинга VMware. Возможные значения: <code>true</code> или <code>false</code>.
|}

=== Модуль Анализа БД ===
Информация о базе данных Oracle

'''Раздел: [dbAgent]'''
{| class="wikitable"
!Свойство
!Описание
|-
|<code>dbAgent_enabled</code>
|Включает модуль анализа базы данных Oracle. Возможные значения: <code>true</code> или <code>false</code>.
|}

=== Модуль Расширений 1.0 ===
'''Раздел: [rpm]'''
{| class="wikitable"
!Свойство
!Описание
|-
|<code>rpm_enabled</code>
|Включает модуль удаленных плагинов, который используется для запуска расширений ActiveGate. Возможные значения: <code>true</code> или <code>false</code>.
|}

=== Модуль Расширений 2.0 ===
'''Раздел: [extension_controller]'''
{| class="wikitable"
!Свойство
!Описание
|-
|<code>extension_controller_enabled</code>
|Включает модуль Расширений 2.0. Возможные значения: <code>true</code> или <code>false</code>.
|}

=== Модуль zRemote ===
Установка модуля zRemote для мониторинга z/OS.

'''Раздел: [zremote]'''
{| class="wikitable"
!Свойство
!Описание
|-
|<code>zremote_enabled</code>
|Включает модуль zRemote. Возможные значения: <code>true</code> или <code>false</code>.
|}

=== Модуль Синтетики ===
Синтетические мониторы из частных синтетических локаций

'''Раздел: [synthetic]'''

Настройки прокси для синтетического мониторинга. Если в этом разделе указано <code>proxy-off=true</code>, то прокси для Синтетического мониторинга нет. Если он содержит свойство <code>proxy-host</code>, то этот прокси будет использоваться для синтетического мониторинга, а не прокси, указанный в <code>[http.client.external]</code> (или в <code>[http.client]</code>, если <code>[http.client.external]</code> не определено).

'''Примечание'''. Если у вас есть раздел <code>[synthetic]</code> в вашем файле <code>custom.properties</code>, у вас может быть раздел <code>[http.client.external]</code>, в котором вы должны указать все остальные параметры связи, которые будут использоваться для синтетического мониторинга. Кроме того, вы можете указать остальные параметры связи в разделе <code>[http.client]</code>.

'''Однако, если вы создаете раздел <code>[http.client.external]</code>, вы должны указать там все параметры связи. В противном случае параметры связи для отслеживаемых сред (Cloud Foundry, Kubernetes или Synthetic Monitoring) вернутся к заводским значениям по умолчанию.'''

Обратите внимание, что изменение свойства <code>synthetic_enabled</code> работает только в том случае, если вы установили ActiveGate для запуска синтетических мониторов из частного местоположения. Если вы установили ActiveGate для маршрутизации трафика, мониторинга облачных сред или мониторинга удаленных технологий с помощью расширений или мониторинга мейнфрейма, вам необходимо переустановить ActiveGate, чтобы использовать его для синтетического мониторинга.
{| class="wikitable"
!Свойство
!Значение по умолчанию
!Описание
|-
|<code>synthetic_enabled</code>
|<code>false</code> в режиме развертывания '''по умолчанию'''
<code>true</code> в режиме развертывания '''Синтетический мониторинг'''
|Позволяет ActiveGate выполнять мониторы из частных синтетических местоположений.
|-
|<code>synthetic_autoinstall</code>
|<code>true</code> для автоматического обновления движка Синтетики
|Автоматически устанавливается в <code>true</code> во время установки для синтетических ActiveGate.
|-
|<code>proxy-server</code>
|unset
|Адрес прокси-сервера
|-
|<code>proxy-port</code>
|unset
|Порт прокси (числовой)
|-
|<code>proxy-user</code>
|unset
|Имя пользователя прокси (необязательно)
|-
|<code>proxy-password</code>
|unset
|Пароль прокси (необязательно)
Пароль, указанный в свойстве <code>proxy-password</code>, обфусцируется после перезапуска ActiveGate, а замаскированный пароль сохраняется в свойстве <code>proxy-password-encr</code>.
|-
|<code>proxy-off</code>
|unset
|Отключить прокси-связь между ActiveGate и тестируемым ресурсом.
|-
|<code>proxy-non-proxy-hosts</code>
|unset
|Не использовать прокси при общении с этими хостами.
|}
'''Важно'''

Мы рекомендуем вам не изменять значение свойства <code>synthetic_autoupgrade_chromium</code> в <code>custom.properties</code>, поскольку ваши изменения могут быть перезаписаны.

<code>synthetic_autoupgrade_chromium</code> для автообновления Chromium можно определить на уровне местоположения (для местоположений с Environment ActiveGates) либо через веб-интерфейс, либо с помощью вызова PUT API местоположения API синтетических местоположений v2. Для Cluster ActiveGates это свойство можно настроить с помощью вызова PUT a location (Dynatrace Managed) API Cluster API v2. Это свойство не определено для ActiveGate, которые не были назначены местоположению. Для Activates, назначенных местоположению, значением по умолчанию является <code>true</code>.

=== Модуль Beacon Forwarder ===
Использование ActiveGate для реального мониторинга пользователей

'''Раздел: [beacon_forwarder]'''
{| class="wikitable"
!Свойство
!Описание
|-
|<code>beacon_forwarder_enabled</code>
|Включает модуль Beacon Forwarder. Возможные значения: <code>true</code> или <code>false</code>.
|}

=== Модуль API HTTP-метрик ===
Прием метрик: простой способ передать любые пользовательские метрики в Ключ-Астром

'''Раздел: [metrics_ingest]'''
{| class="wikitable"
!Свойство
!Описание
|-
|<code>metrics_ingest_enabled</code>
|Включает модуль HTTP Metric API, который упрощает прием метрик. Возможные значения: <code>true</code> или <code>false</code>.
|}

=== Модуль Дампов памяти ===
Запуск и загрузка дампов памяти

'''Раздел: [collector]'''
{| class="wikitable"
!Свойство
!Описание
|-
|<code>DumpSupported</code>
|Включает модуль дампов памяти. Возможные значения: <code>true</code> или <code>false</code>.
|}
Когда в вашем приложении возникают утечки памяти или большое количество объектов, важно получить дампы памяти, чтобы вы могли проанализировать эти проблемы. В производственных средах это часто становится проблемой, когда вы не можете войти в среду и у вас нет других средств запуска дампов памяти. Dynatrace позволяет вам запускать и безопасно загружать дампы памяти в инструмент анализа по вашему выбору.

=== Модуль Маршрутизации ЕдиныхАгентов ===
ActiveGate знает о структуре времени выполнения вашей среды и направляет сообщения от агентов OneAgent на правильные конечные точки сервера. Он обрабатывает маршрутизацию сообщений, буферизацию, сжатие, аутентификацию и доступ к закрытым сетям.

'''Раздел: [collector]'''
{| class="wikitable"
!Свойство
!Описание
|-
|<code>MSGrouter</code>
|Включает модуль маршрутизации OneAgent, который направляет трафик OneAgent и другого ActiveGate через Ключ-Астром. Возможные значения: <code>true</code> или <code>false</code>.
|}

=== Модуль OTLP-приёма ===
Этот модуль создает конечную точку на ActiveGate, которая может получать данные трассировки OpenTelemetry (трассы и интервалы) в формате OTLP.

'''Раздел: [otlp_ingest]'''
{| class="wikitable"
!Свойство
!Описание
|-
|<code>otlp_ingest_enabled</code>
|Включает модуль приема OTLP, который упрощает прием трассировки OpenTelemetry. Возможные значения: <code>true</code> или <code>false</code>.
|}

=== Модуль REST API ===
'''Раздел: [collector]'''

Вы можете использовать ActiveGate для доступа к API Ключ-Астром. ActiveGate поддерживает вызовы всех конечных точек конфигурации и среды API в версиях v1 и v2. Чтобы получить доступ к API Ключ-Астром с помощью ActiveGate, используйте URL-адрес в следующем формате: <nowiki>https://{ваш-ActiveGate-домен}/e/{идентификатор</nowiki> вашей среды}/api/...
{| class="wikitable"
!Свойство
!Описание
|-
|<code>restInterface</code>
|Включает модуль REST API, упрощающий доступ к API Ключ-Астром с помощью REST. Возможные значения: <code>true</code> или <code>false</code>.
|}

=== Раздел Адреса балансировщика нагрузки ===
'''Раздел: [connectivity]'''
{| class="wikitable"
!Свойство
!Значение по умолчанию
!Описание
|-
|<code>dnsEntryPoint</code>
|unset
|Точки входа для ActiveGate (например, <code><nowiki>https://sg1.mydomain.com:9999</nowiki></code>). OneAgent получает доступ к ActiveGate через этот URL-адрес (или список URL-адресов — значением этого свойства может быть список, разделенный запятыми). Если не задано, используется автоматически определяемая конечная точка. Эту запись можно использовать, если доступ к ActiveGate осуществляется, например, через внешний IP-адрес или балансировщик нагрузки. В зависимости от развертывания ActiveGate убедитесь, что вы используете правильный префикс (<code>http</code> или <code>https</code>), иначе ваши агенты OneAgent не смогут подключиться.

'''Примечание'''. Чтобы избежать ненужных DNS-запросов и повысить безопасность, вы можете пометить доменное имя как полное доменное имя (FQDN), добавив точку в конце URL-адреса. Например, <code>www.example.com</code> является абсолютным доменным именем.
|}

=== Раздел Сетевых зон ===
'''Раздел: [connectivity]'''
{| class="wikitable"
!Свойство
!Значение по умолчанию
!Описание
|-
|<code>networkZone</code>
|unset
|Определяет сетевую зону, к которой принадлежит ActiveGate. ActiveGate может принадлежать только одной сетевой зоне. Имя сетевой зоны представляет собой строку буквенно-цифровых символов, дефисов <code>(-)</code>, знаков подчеркивания <code>(_)</code> и точек <code>(.)</code>. Точки используются в качестве разделителей, поэтому вы не должны использовать точку в качестве первого символа имени сетевой зоны. Длина строки ограничена 256 символами.
После добавления или изменения этого параметра требуется перезапуск ActiveGate. После перезапуска в Ключе-Астром автоматически создается сетевая зона.
|}

=== Раздел Групп ===
'''Раздел: [collector]'''
{| class="wikitable"
!Свойство
!Значение по умолчанию
!Описание
|-
|<code>group</code>
|unset
|Группа ActiveGate
|}

=== Раздел Файловый кэш АктивныхШлюзов ===
Требуется ActiveGate версии 1.241+

Файловый кэш ActiveGate уменьшает трафик между ActiveGate и кластером Dynatrace, позволяя агентам OneAgent загружать автоматические обновления из ActiveGate, а не из кластера.

Кэш файлов активируется автоматически при установке или обновлении ActiveGate. Однако активация происходит только при соблюдении минимального требования к пространству в 512 МБ. Если минимальные требования к пространству не выполняются, кэширование автоматически деактивируется.

Файловый кеш можно настроить или отключить в конфигурации ActiveGate, в файле <code>custom.properties</code>:

'''Раздел: [generic_filecache]'''
{| class="wikitable"
!Свойство
!Значение по умолчанию
!Описание
|-
|<code>generic_filecache_enabled</code>
|<code>true</code>
|Включает или отключает файловый кеш ActiveGate. Возможные значения: <code>true</code> или <code>false</code>.
|-
|<code>generic_filecache_path</code>
|<code><ActiveGate temporary directory>/generic_filecache</code>
|Путь к каталогу файлового кэша ActiveGate. Каталог будет создан, если он не существует (если это позволяют права доступа к файлу).
|-
|<code>generic_filecache_size</code>
|<code>2147483648</code> (2 ГБ)
|Размер файлового кеша ActiveGate в байтах.

Файловый кэш ActiveGate будет занимать не больше места, чем указано в конфигурации. Если доступное пространство меньше размера, указанного в конфигурации, ActiveGate будет использовать доступное пространство.
|-
|<code>generic_filecache_max_age</code>
|<code>1209600000</code> (14 дней)
|Максимальный возраст файлов, хранящихся в файловом кэше ActiveGate, в миллисекундах. Возраст файла отсчитывается с момента последнего использования файла (а не с момента загрузки/создания).

Если файл не используется для настроенного максимального возраста, файл будет автоматически удален. Файлы также удаляются из кеша до достижения максимального возраста, если для новых файлов недостаточно места. Файлы LRU (наименее использовавшиеся) удаляются первыми.
|}

=== Раздел [com.compuware.apm.webserver] ===
{| class="wikitable"
!Свойство
!Значение по умолчанию
!Описание
|-
|<code>port-ssl</code>
|<code>9999</code>
|Порт, через который ActiveGate прослушивает трафик OneAgent — используется для HTTPS-соединения.
|-
|<code>port</code>
|unset
|Порт, на котором ActiveGate прослушивает трафик от OneAgent — используется для HTTP-соединения. По умолчанию он отключен.
В Linux рекомендуется значение > 1024, чтобы гарантировать, что привилегии root не потребуются.
|-
|<code>ssl-protocols</code>
|<code>TLSv1.2</code>, версия Ключ-Астром 1.247+ <code>TLSv1.3</code>
|Поддерживаемые протоколы SSL. Может быть одним или списком значений, разделенных запятыми. Обратите внимание, что указание конкретной версии не означает автоматически поддержку всех предыдущих/младших версий, поэтому вам необходимо явно указать каждую версию.

Допустимые значения:
<code>TLSv1</code>, <code>TLSv1.1</code>, <code>TLSv1.2</code>, <code>TLSv1.3</code>

'''Примечание'''. Если вам требуется <code>TLSv1.1</code> или более ранняя версия, также включите <code>_SHA</code>, удалив его из списка исключенных шифров.
|-
|<code>excluded-ciphers</code>
|unset
|Список исключенных шифров. Шифры определяются подстрокой, соответствующих хотя бы части имени шифра, например: <code>excluded-ciphers = TLS_RSA_WITH,SHA$,TLS_ECDH</code>
|-
|<code>certificate-file</code>
|unset
|Путь к файлу <code>PKCS#12</code>, содержащему сертификаты, которые будут использоваться веб-сервером ActiveGate.
|-
|<code>certificate-password</code>
|unset
|Пароль к файлу сертификата.
|-
|<code>certificate-alias</code>
|unset
|Понятное имя сертификата в файле <code>PKCS#12</code>.
|}

==== Работа через HTTPS против HTTP ====
По умолчанию ActiveGate работает безопасным образом, обслуживая входящие запросы по протоколу HTTPS. Это определяется свойством конфигурации <code>port-ssl</code>, которое можно настроить в файле <code>custom.properties</code>. Однако, если вы хотите, чтобы ActiveGate использовал <code>HTTP</code>, вы должны указать свойство порта в <code>custom.properties</code>.

Обратите внимание, что безопасный способ используется по умолчанию и является рекомендуемым. Однако вы можете выбрать вариант HTTP из соображений производительности. Например, если у вас перед АктивнымШлюзом Кластера установлен балансировщик нагрузки и если балансировщик нагрузки прерывает входящие внешние SSL-соединения (см. третий сценарий развертывания).

=== Раздел [http.client] ===
Параметры связи, используемые для мониторинга AWS/VMware/Azure и для связи с кластером (если они не переопределены в <code>[http.client.internal]</code>). В частности, этот раздел содержит свойства конфигурации, связанные с настройками прокси-сервера и тайм-аутами соединения.

=== Раздел [http.client.internal] ===
Настройки, относящиеся только к связи с кластером Ключ-Астром.

В частности, этот раздел может содержать свойства конфигурации, связанные с настройками прокси-сервера и тайм-аутами соединения.

'''Если этот раздел не существует, связь с кластером Ключ-Астром определяется настройками в разделе <code>[http.client]</code>'''. Однако, если раздел <code>[http.client.internal]</code> существует, в котором конкретный параметр связи не указан, то для связи с кластером значение этого параметра '''считается заводским по умолчанию''' (не унаследовано от <code>[http.client]</code>).

=== Раздел [http.client.external] ===
Настройки связи для конкретных модулей: Cloud Foundry, Kubernetes, а также для Синтетического Мониторинга.

В частности, этот раздел может содержать свойства конфигурации, связанные с настройками прокси-сервера и тайм-аутами соединения.

Если в этом разделе указано <code>proxy-off=true</code>, то прокси для модулей нет. Если он содержит свойство <code>proxy-host</code>, то этот прокси будет использоваться для модулей.

'''Примечание'''. Параметры связи, указанные в <code>[http.client]</code>, не всегда используются модулями по умолчанию: если конкретный параметр связи не указан в <code>[http.client.external]</code>, то этот параметр — для Cloud Foundry, Kubernetes или Синтетического Мониторинга. — вернется к заводскому значению по умолчанию, а не к значению, указанному в <code>[http.client]</code>.

Точно так же, если весь раздел <code>[http.client.external]</code> не существует, все параметры связи для Kubernetes и Cloud Foundry вернутся к заводским значениям по умолчанию; однако параметры синтетического мониторинга будут принимать значения, указанные в разделе <code>[http.client]</code>.

Параметры АктивногоШлюза

2022-09-27T12:46:24Z

RGolovanov: Новая страница: «== Основные правила работы с конфигурацией АктивногоШлюза == === Файлы конфигурации ActiveGate...»

== Основные правила работы с конфигурацией АктивногоШлюза ==

=== Файлы конфигурации ActiveGate ===
Многие параметры конфигурации ActiveGate (например, параметры подключения и прокси-сервера, шифры или параметры дампа памяти) хранятся в файлах свойств <code>config.properties</code> и <code>custom.properties</code>, которые расположены в каталоге конфигурации ActiveGate. Свойства, перечисленные в файлах свойств, применимы для АктивныхШлюзов Окружений и Кластера.

Файлы <code>config.properties</code> и <code>custom.properties</code> разделены на секции. Каждое название раздела заключено в квадратные скобки, например:
<code>[collector]
MSGrouter = true
restInterface = true
DumpSupported = false</code>

=== config.properties ===
Файл конфигурации <code>config.properties</code> содержит параметры установки ActiveGate по умолчанию и не может быть изменен. Примечание: Этот файл конфигурации перезаписывается при каждом обновлении ActiveGate.

=== custom.properties ===
Настройки, хранящиеся в <code>custom.properties</code>, переопределяют соответствующие настройки в <code>config.properties</code>, и во время обновления файл копируется в новую версию ActiveGate.

Файлы конфигурации разбиты на <code>[разделы]</code>, которые указаны в квадратных скобках.

Чтобы указать настраиваемые параметры в <code>custom.properties</code>, введите имена разделов и включите соответствующие свойства в эти разделы.

Вы можете использовать файл <code>config.txt</code> в качестве справки при добавлении пользовательских настроек в файл <code>custom.properties</code>. Файл <code>config.txt</code>, который также находится в каталоге конфигурации ActiveGate, не используется ActiveGate, однако содержит справочный список возможных свойств конфигурации. Кроме того, вы можете сначала найти соответствующий раздел в файле <code>config.properties</code>, а затем скопировать заголовок раздела вместе с именами нужных свойств в <code>custom.properties</code>.

После этого вы можете изменить записи в разделе по мере необходимости.

=== launcheruserconfig.conf ===
Средство запуска ActiveGate — это наблюдающий процесс, который запускает виртуальную машину Java для вашего ActiveGate. Конфигурация лаунчера хранится в файле <code>launcheruserconfig.conf</code> в каталоге конфигурации ActiveGate. Он содержит свойства и параметры запуска, которые передаются виртуальной машине Java.

Файл <code>launcheruserconfig.conf</code> сохраняется во время обновлений ActiveGate.

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

== Ограничения памяти ActiveGate ==
Ограничения на использование памяти для ActiveGate можно указать в конфигурационном файле лаунчера <code>launcheruserconfig.conf</code>.

* Настройки ограничения памяти могут быть комбинацией:
** <code>-java.xmx.relative_part</code> — процента доступной оперативной памяти
** <code>-java.xmx.absolute_part</code> — абсолютного значения объема памяти в МБ.

Например:
<code># Xmx settings 83% of available RAM + 0 MB
-java.xmx.absolute_part=0
-java.xmx.relative_part=83
-healthcheck.heartbeat.portrange=60100:60200
-arguments_section.jvm
-Dsomecustomproperty=value</code>

== Диапазон портов ActiveGate ==
Средство запуска ActiveGate отслеживает процесс ActiveGate на локальном контрольном порту. Этот порт выбирается программой запуска из предопределенного диапазона портов, указанного в конфигурации программы запуска. Программа запуска находит свободный порт в заданном диапазоне, а затем передает номер порта процессу ActiveGate.

По умолчанию программа запуска будет использовать порты выше 50000 для мониторинга пульса. Для некоторых развертываний может потребоваться настроить для этой цели другие порты. Чтобы указать диапазон портов, который должен использовать модуль запуска ActiveGate, добавьте или измените свойство <code>-healthcheck.heartbeat.portrange</code> в файле конфигурации модуля запуска <code>launcheruserconfig.conf</code>, как в примере ниже.
<code># Xmx settings 80% of available RAM + 0 MB
-java.xmx.absolute_part=0
-java.xmx.relative_part=83
-healthcheck.heartbeat.portrange=60100:60200
-arguments_section.jvm
-Dsomecustomproperty=value</code>

== Пользовательские параметры для Java-процесса ActiveGate ==
Чтобы передать пользовательские параметры Java-процессу ActiveGate, укажите параметры в конфигурационном файле лаунчера launcheruserconfig.conf:

* Все строки после <code>-arguments_section.jvm</code> передаются в качестве аргументов JVM. Таким образом, указав опции <code>-D</code>, вы можете указать аргументы для ActiveGate.

Например:
<code># Xmx settings 80% of available RAM + 0 MB
-java.xmx.absolute_part=0
-java.xmx.relative_part=83
-healthcheck.heartbeat.portrange=60100:60200
-arguments_section.jvm
-Dsomecustomproperty=value</code>

== Модули ActiveGate ==
Различные функциональные возможности, предоставляемые ActiveGate, называются модулями. Когда вы устанавливаете ActiveGate для определенной цели, устанавливается или включается другой набор модулей.

Модуль активен, если соответствующее свойство конфигурации указано со значением <code>true</code> в разделе конфигурации, посвященном модулю. Обратите внимание, однако, что вы не можете включить все модули, используя <code>custom.properties</code>, просто изменив значение свойства: если вы установили свой ActiveGate, чтобы он служил в качестве частного синтетического местоположения или для мониторинга мейнфрейма, и вам нужно изменить цель вашего ActiveGate , вам необходимо переустановить ActiveGate.

Каждый модуль имеет соответствующий раздел в конфигурации

В дополнение к разделам конфигурации, предназначенным для определенных функций ActiveGate, каждый модуль ActiveGate имеет собственный раздел в файлах конфигурации ActiveGate. Настройки, указанные в этом разделе, относятся именно к этому модулю. Это относится, например, к настройкам прокси. Однако не все настройки можно повторить таким образом и указать для модуля: каждый раздел модуля имеет только ограниченное количество принимаемых опций. '''НЕ копируйте параметры конфигурации между разделами, если только это не указано специально'''.

=== AWS ===
AWS-мониторинг

'''Раздел: [aws_monitoring]'''
{| class="wikitable"
!Свойство
!Описание
|-
|<code>aws_monitoring_enabled</code>
|Включает модуль мониторинга AWS. Возможные значения: <code>true</code> или <code>false</code>.
|}

=== Azure ===
Microsoft Azure monitoring

'''Раздел: [azure_monitoring]'''
{| class="wikitable"
!Свойство
!Описание
|-
|<code>azure_monitoring_enabled</code>
|Включает модуль Microsoft Azure. Возможные значения: <code>true</code> или <code>false</code>.
|}

=== Module: Cloud Foundry ===
Cloud Foundry monitoring

'''Раздел: [cloudfoundry_monitoring]'''
{| class="wikitable"
!Свойство
!Описание
|-
|<code>cloudfoundry_monitoring_enabled</code>
|Включает модуль Cloud Foundry. Возможные значения: <code>true</code> или <code>false</code>.
|}
This section can contain proxy settings for communication with Cloud Foundry. If this section contains <code>proxy-off = true</code>, then there is no proxy for communication with Cloud Foundry. If it contains the <code>proxy-host</code> property, then this is the proxy to be used for Cloud Foundry monitoring, rather than the proxy specified in <code>[http.client.external]</code>.

'''Note:''' If you have a <code>[cloudfoundry_monitoring]</code> section in your <code>custom.properties</code> file, you also need to have an <code>[http.client.external]</code> section, where you should specify all the remaining communication parameters that are to be used for Cloud Foundry communication.

Set up proxy only for Cloud Foundry monitoring

=== Module: Kubernetes ===
Kubernetes monitoring

'''Раздел: [kubernetes_monitoring]'''
{| class="wikitable"
!Свойство
!Описание
|-
|<code>kubernetes_monitoring_enabled</code>
|Включает модуль мониторинга Kubernetes. Возможные значения: <code>true</code> или <code>false</code>.
|}
This section can contain proxy settings for communication with Kubernetes, along with other settings related to fine-tuning communication settings for Kubernetes monitoring.

If this section contains <code>proxy-off = true</code>, then there is no proxy for communication with Kubernetes. If it contains the <code>proxy-host</code> property, then this is the proxy to be used for Kubernetes monitoring, rather than the proxy specified in <code>[http.client.external]</code>.

'''Note:''' If you have a <code>[kubernetes_monitoring]</code> section in your <code>custom.properties</code> file, then you also need to have an <code>[http.client.external]</code> section, where you should specify all of the remaining communication parameters to be used for Kubernetes communication.

Set up proxy only for Kubernetes monitoring

=== Module: Log Monitoring ===
'''Раздел: [log_analytics_collector]'''
{| class="wikitable"
!Свойство
!Описание
|-
|<code>log_analytics_collector_enabled</code>
|Включает модуль мониторинга логов. Возможные значения: <code>true</code> или <code>false</code>.
|}
'''Раздел: [generic_ingest]'''

Specifically for Log Monitoring, when configuring Generic Log Ingest, you can customize the log data queue properties. You can specify the temporary folder where the queued log data will be stored (default is the temporary folder currently configured on your system) and, change the maximum size of the queue that will be used in that folder (default size is 300 MB).
{| class="wikitable"
!Свойство
!Значение по умолчанию
!Описание
|-
|<code>disk_queue_path</code>
|Текущая общесистемная временная папка
|Указывает путь к временной папке, в которой будут храниться данные журнала, поставленные в очередь.
|-
|<code>disk_queue_max_size_mb</code>
|300 МБ
|Задает максимальный размер данных журнала в очереди, которые можно хранить во временной папке.
|}

=== Module: VMware ===
VMware monitoring

'''Раздел: [vmware_monitoring]'''
{| class="wikitable"
!Свойство
!Описание
|-
|<code>vmware_monitoring_enabled</code>
|Включает модуль мониторинга VMware. Возможные значения: истина или ложь.
|}

=== Module: Database insights ===
Oracle database insights

'''Раздел: [dbAgent]'''
{| class="wikitable"
!Свойство
!Описание
|-
|<code>dbAgent_enabled</code>
|Enables Oracle database insights module. Possible values: <code>true</code> or <code>false</code>.
|}

=== Module: Extensions 1.0 ===
'''Раздел: [rpm]'''
{| class="wikitable"
!Свойство
!Описание
|-
|<code>rpm_enabled</code>
|Enables the Remote plugin module, which is used to run ActiveGate extensions. Possible values: <code>true</code> or <code>false</code>.
|}

=== Module: Extensions 2.0 ===
'''Раздел: [extension_controller]'''
{| class="wikitable"
!Свойство
!Описание
|-
|<code>extension_controller_enabled</code>
|Enables the Extensions 2.0 module. Possible values: <code>true</code> or <code>false</code>.
|}

=== Module: zRemote ===
Install the zRemote module for z/OS monitoring

'''Раздел: [zremote]'''
{| class="wikitable"
!Свойство
!Описание
|-
|<code>zremote_enabled</code>
|Enables the zRemote module. Possible values: <code>true</code> or <code>false</code>.
|}

=== Module: Synthetic ===
Synthetic monitors from private Synthetic locations

'''Раздел: [synthetic]'''

Proxy settings for Synthetic Monitoring. If this section contains <code>proxy-off = true</code>, then there is no proxy for Synthetic Monitoring. If it contains the <code>proxy-host</code> property, then this is the proxy to be used for Synthetic Monitoring, rather than the proxy specified in <code>[http.client.external]</code> (or in <code>[http.client]</code>, if <code>[http.client.external]</code> is not defined).

'''Note:''' If you have a <code>[synthetic]</code> section in your <code>custom.properties</code> file, you can have an <code>[http.client.external]</code> section, where you should specify all of the remaining communication parameters to be used for Synthetic Monitoring. Alternatively, you can specify the remaining communication settings in the <code>[http.client]</code> section.

'''However, if you do create the <code>[http.client.external]</code> section, you have to specify all of the communication parameters there. Otherwise, the communication parameters for monitored environments (Cloud Foundry, Kubernetes, or Synthetic Monitoring) will revert to their factory defaults.'''

To learn more about the proxy-related properties for a Synthetic-enabled ActiveGate, see Set up a proxy for private synthetic monitoring.

Note that changing the <code>synthetic_enabled</code> property only works if you installed the ActiveGate to run Synthetic monitors from a private location. If you installed the ActiveGate to route traffic, monitor cloud environments, or monitor remote technologies with extensions or monitor mainframe, you have to reinstall the ActiveGate to use it for Synthetic Monitoring. For more information, see Create a private Synthetic location.
{| class="wikitable"
!Свойство
!Значение по умолчанию
!Описание
|-
|<code>synthetic_enabled</code>
|<code>false</code> in the '''Default''' deployment mode
<code>true</code> in the '''Synthetic monitoring''' deployment mode
|Enables the ActiveGate to execute monitors from private Synthetic locations.
|-
|<code>synthetic_autoinstall</code>
|<code>true</code> to automatically update the Synthetic engine
|Automatically set to <code>true</code> at installation time for Synthetic-enabled ActiveGates.
|-
|<code>proxy-server</code>
|unset
|Proxy server address
|-
|<code>proxy-port</code>
|unset
|Proxy port (numeric)
|-
|<code>proxy-user</code>
|unset
|Proxy user name (optional)
|-
|<code>proxy-password</code>
|unset
|Proxy password (optional)
The password provided in the <code>proxy-password</code> property
is obfuscated following ActiveGate restart and the obfuscated password
is stored in the <code>proxy-password-encr</code> property.
|-
|<code>proxy-off</code>
|unset
|Disable proxy communication between ActiveGate and tested resource.
|-
|<code>proxy-non-proxy-hosts</code>
|unset
|Do not use proxy when communicating with these hosts.
|}
'''Important'''

We recommend that you not edit the value of the <code>synthetic_autoupgrade_chromium</code> property in <code>custom.properties</code> because your changes might be overwritten.

<code>synthetic_autoupgrade_chromium</code> for autoupdating Chromium can be defined at the location level (for locations with Environment ActiveGates) either via the web UI or by using the PUT a location API call of the Synthetic locations API v2. For Cluster ActiveGates, you can configure this property via the PUT a location (Dynatrace Managed) API call of the Cluster API v2. This property is not defined for ActiveGates that haven't been assigned to a location. For Activates assigned to a location, the default value is <code>true</code>.

=== Module: Beacon forwarder ===
Using ActiveGate for Real User Monitoring

'''Раздел: [beacon_forwarder]'''
{| class="wikitable"
!Свойство
!Описание
|-
|<code>beacon_forwarder_enabled</code>
|Enables the Beacon forwarder module. Possible values: <code>true</code> or <code>false</code>.
|}

=== Module: HTTP Metric API ===
Metric ingestion: a simple way to push any custom metrics to Dynatrace

'''Раздел: [metrics_ingest]'''
{| class="wikitable"
!Свойство
!Описание
|-
|<code>metrics_ingest_enabled</code>
|Enables HTTP Metric API module which facilitates metric ingestion. Possible values: <code>true</code> or <code>false</code>.
|}

=== Module: Memory dumps ===
Triggering and downloading of memory dumps

'''Раздел: [collector]'''
{| class="wikitable"
!Свойство
!Описание
|-
|<code>DumpSupported</code>
|Enables the memory dumps module. Possible values: <code>true</code> or <code>false</code>.
|}
When your application experiences memory leaks or high object churn, it’s important that you get memory dumps so you can analyze these issues. In production environments, this is often a challenge when you can’t log into the environment and you have no other means of triggering memory dumps. Dynatrace enables you to both trigger and securely download memory dumps to the analysis tool of your choice.

See Configure ActiveGate for memory dump storage.

=== Module: OneAgent routing ===
ActiveGate knows about the runtime structure of your Dynatrace environment and routes messages from OneAgents to the correct server endpoints. It handles message routing, buffering, compression, authentication and accessing of sealed networks.

'''Раздел: [collector]'''
{| class="wikitable"
!Свойство
!Описание
|-
|<code>MSGrouter</code>
|Enables the OneAgent routing module, which routes of OneAgent and other ActiveGate traffic through Dynatrace. Possible values: <code>true</code> or <code>false</code>.
|}

=== Module: OTLP Ingest ===
This module creates an endpoint on the ActiveGate that can receive OpenTelemetry trace data (traces and spans) in OTLP format. '''Раздел: [otlp_ingest]'''
{| class="wikitable"
!Свойство
!Описание
|-
|<code>otlp_ingest_enabled</code>
|Enables OTLP ingest module which facilitates OpenTelemetry trace ingest. Possible values: <code>true</code> or <code>false</code>.
|}

=== Module: REST API ===
'''Раздел: [collector]'''

You can use an ActiveGate to access the Dynatrace API. ActiveGate supports calls to all the Dynatrace API configuration and environment endpoints in both, v1 and v2 versions. To access the Dynatrace API using ActiveGate, use a URL in the following format: <code><nowiki>https://{your-ActiveGate-domain}/e/{your-environment-id}/api/</nowiki>...</code>
{| class="wikitable"
!Свойство
!Описание
|-
|<code>restInterface</code>
|Enables the REST API module, which facilitates access to Dynatrace API using REST. Possible values: <code>true</code> or <code>false</code>.
|}

=== Load balancer address ===
'''Раздел: [connectivity]'''
{| class="wikitable"
!Свойство
!Значение по умолчанию
!Описание
|-
|<code>dnsEntryPoint</code>
|unset
|The entry points for the ActiveGate (for example, <code><nowiki>https://sg1.mydomain.com:9999</nowiki></code>). Dynatrace OneAgent accesses the ActiveGate via this URL (or list of URLs—the value of this property can be a comma-separated list). If not set, an auto-detected endpoint is used. This entry can be used if the ActiveGate is accessed via, for example, an external IP address or load balancer. Depending on your ActiveGate deployment, make sure you use the right prefix (<code>http</code> or <code>https</code>) or your OneAgents won't be able to connect. '''Note''': To avoid unnecessary DNS requests and enhance security, you can mark a domain name as a fully qualified domain name (FQDN) by appending a dot to the end of the URL. For example, <code>www.example.com.</code> is an absolute domain name. See Trailing Dots in Domain Names for more details.
|}

=== Network zone ===
'''Раздел: [connectivity]'''
{| class="wikitable"
!Свойство
!Значение по умолчанию
!Описание
|-
|<code>networkZone</code>
|unset
|Defines the network zone to which the ActiveGate belongs. An ActiveGate can belong to only one network zone. The name of a network zone is a string of alphanumeric characters, hyphens (<code>-</code>), underscores (<code>_</code>), and dots (<code>.</code>). Dots are used as separators, so you must not use a dot as the first character of a network zone name. The length of the string is limited to 256 characters.
ActiveGate restart is required after adding or changing this parameter. After restart, a network zone is automatically created in Dynatrace.
|}

=== Group ===
'''Раздел: [collector]'''
{| class="wikitable"
!Свойство
!Значение по умолчанию
!Описание
|-
|<code>group</code>
|unset
|ActiveGate group
|}

=== ActiveGate file cache ===
ActiveGate version 1.241+

The ActiveGate file cache reduces traffic between the ActiveGate and the Dynatrace Cluster by allowing OneAgents to download automatic updates from the ActiveGate rather than the Cluster.

The file cache is activated automatically when ActiveGate is installed or updated. However, activation occurs only when the '''minimum space requirement of 512 MB''' is met. If the minimum space requirement is not met, caching is automatically deactivated.

The file cache can be fine-tuned or deactivated in ActiveGate configuration, in the <code>custom.properties</code> file:

'''Раздел: [generic_filecache]'''
{| class="wikitable"
!Свойство
!Значение по умолчанию
!Описание
|-
|<code>generic_filecache_enabled</code>
|<code>true</code>
|Enables or disables ActiveGate file cache. Possible values: <code>true</code> or <code>false</code>.
|-
|<code>generic_filecache_path</code>
|<code><ActiveGate temporary directory>/generic_filecache</code>
|Path of the ActiveGate file cache directory. The directory will be created if it does not exist (if the file permissions allow it).
|-
|<code>generic_filecache_size</code>
|<code>2147483648</code> (2 GB)
|The size of the ActiveGate file cache in bytes.

ActiveGate file cache will use no more space than specified in the configuration. If available space is less than the size specified in the configuration, ActiveGate will use the available space.
|-
|<code>generic_filecache_max_age</code>
|<code>1209600000</code> (14 days)
|The maximum file age for files stored in the ActiveGate file cache, in milliseconds. File age is counted from the time that a file was last used (not from upload/creation time).

If a file is not used for the configured maximum age, the file will be automatically removed. Files are also removed from the cache before their maximum age if there is insufficient space for new files. The LRU (least recently used) files are removed first.
|}

=== Раздел: [com.compuware.apm.webserver] ===
{| class="wikitable"
!Свойство
!Значение по умолчанию
!Описание
|-
|<code>port-ssl</code>
|<code>9999</code>
|The port where the ActiveGate listens for traffic from
OneAgent—used for the HTTPS connection. If you need to change the port value, see custom Plugin Module configuration
|-
|<code>port</code>
|unset
|The port where the ActiveGate listens for traffic from
OneAgent—used for the HTTP connection. It is disabled by default.
On Linux, a value > 1024 is recommended, to ensure no root
privileges are required.
|-
|<code>ssl-protocols</code>
|<code>TLSv1.2</code>, Dynatrace version 1.247+ <code>TLSv1.3</code>
|Supported SSL protocols. Can be one or a comma-separated list of values. Note that specifying a particular version does not automatically imply support for all the previous/lower versions—so you need to specify each version explicitly. The allowed values are:
<code>TLSv1</code>, <code>TLSv1.1</code>, <code>TLSv1.2</code>, <code>TLSv1.3</code>
'''Note:''' if you need <code>TLSv1.1</code> or earlier, also enable _SHA by removing it from the <code>excluded-ciphers</code> list—see below.
|-
|<code>excluded-ciphers</code>
|unset
|A list of excluded ciphers. Ciphers are defined by a substring
matching at least a part of the cipher name, for example:
<code>excluded-ciphers = TLS_RSA_WITH,SHA$,TLS_ECDH</code>
|-
|<code>certificate-file</code>
|unset
|Path of the <code>PKCS#12</code> file containing certificates to be used by the ActiveGate web server. Also see Configuration of custom SSL certificate on ActiveGate.
|-
|<code>certificate-password</code>
|unset
|Password for the certificate file.
|-
|<code>certificate-alias</code>
|unset
|Friendly name of the certificate in the <code>PKCS#12</code> file.
|}

==== Operating over HTTPS vs HTTP ====
By default, ActiveGate operates in a secure way, by servicing incoming requests using HTTPS. This is specified by the <code>port-ssl</code> configuration property, which can be customized in the <code>custom.properties</code> file. However, if you want ActiveGate to use HTTP, you must specify the <code>port</code> property in the <code>custom.properties</code>.

Note that the secure way is the default and recommended one. However, you might want to choose the HTTP option for performance reasons. For example, if you have a load balancer installed in front of a Cluster ActiveGate and if the load balancer terminates incoming external SSL connections (see the third deployment scenario).

=== Раздел: [http.client] ===
Communication settings used for AWS/VMware/Azure monitoring and for communicating with the Dynatrace Cluster (unless overridden in <code>[http.client.internal]</code>). In particular, this section contains configuration properties related to proxy settings and connection timeouts.

Specify common proxy settings for Dynatrace Cluster communication and AWS/VMware/Azure monitoring.

=== Раздел: [http.client.internal] ===
Settings specific to communication with the Dynatrace Cluster only.

In particular, this section can contain configuration properties related to proxy settings and connection timeouts.

'''If this section does not exist, communication with the Dynatrace Cluster is defined by the settings in the <code>[http.client]</code> section'''. However, if the <code>[http.client.internal]</code> section does exist in which a particular communication setting is not listed, then, for the purpose of communicating with the Dynatrace Cluster, the value of that setting is '''assumed to be its factory default''' (it is '''not''' inherited from <code>[http.client]</code>).

Set up proxy only for Dynatrace Cluster communication

=== Раздел: [http.client.external] ===
Communication settings for specific modules: Cloud Foundry, Kubernetes, and also for Synthetic Monitoring.

In particular, this section can contain configuration properties related to proxy settings and connection timeouts.

If this section contains <code>proxy-off = true</code>, then there is no proxy for the modules. If it contains the <code>proxy-host</code> property, then this is the proxy to be used for the modules.

'''Note:''' Communication settings specified in <code>[http.client]</code> are '''not always''' used as defaults for the modules: If a particular communication setting is '''not''' specified in <code>[http.client.external]</code>, then that setting—for Cloud Foundry, Kubernetes or Synthetic Monitoring—will revert to its factory default value, rather than to the value specified in <code>[http.client]</code>.

Similarly, if the entire <code>[http.client.external]</code> section does not exist, then all of the communication settings for Kubernetes and Cloud Foundry will revert to their factory default values; however, settings for Synthetic Monitoring will assume values as specified in the <code>[http.client]</code> section.

Specify common proxy settings for Cloud Foundry, Kubernetes, and Synthetic Monitoring

Dynatrace ActiveGate

2022-09-27T12:21:22Z

RGolovanov: /* Подробнее об АктивныхШлюзах */

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

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

== АктивныйШлюз осуществляет мониторинг ==
В дополнение к маршрутизации данных мониторинга, захваченных ЕдинымиАгентами, АктивныеШлюзы также может выполняют задачи мониторинга, используя API для запроса и мониторинга широкого спектра технологий.
Список отслеживаемых технологий не ограничен, но может динамически расширяться. Он включает в себя облачные технологии и технологии центров обработки данных, например, '''AWS''', '''VMware''', '''Azure''', '''Kubernetes''', '''OpenShift''', '''Cloud Foundry''', '''Google Cloud Platform''', '''Oracle''', '''SMTP''', '''WMI''', '''Prometheus''' и многие другие.
[[Файл:СхемаАктивныхШлюзов.png|центр|877x877пкс]]

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

* Если вы используете решение SaaS, вам нужно только установить АктивныйШлюз Окружения.
* Для развёртывания Ключ-Астром Managed обычно требуются оба типа АктивногоШлюза, хотя наиболее важным типом для развёртывания является АктивныйШлюз Кластера.

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

АктивныйШлюзможно развернуть обычным способом — на физическом или виртуальном хосте — это '''развертывание АктивногоШлюза на хосте'''. АктивныйШлюз, упакованный в контейнер, называется '''развертыванием АктивногоШлюза в контейнере'''.

== Подробнее об АктивныхШлюзах ==

* [[Цели АктивногоШлюза]]
** [[Направление трафика ЕдиногоАгента]]
** [[Запуск синтетических мониторов из частных локаций]]
** [[Установка модуля zRemote для мониторинга z/OS]]
* [[Установка АктивногоШлюза]]
** [[Установка АктивногоШлюза на Linux|Linux]]
** [[Установка АктивногоШлюза на Windows|Windows]]
** [[Установка АктивногоШлюза в Kubernetes|Kubernetes]]
** [[Установка АктивногоШлюза в OpenShift|OpenShift]]
* Конфигурация АктивногоШлюза
** [[Параметры АктивногоШлюза]]
** [[Настройка прокси АктивногоШлюза]]
** [[Обратный прокси (балансировщик загрузки) для АктивногоШлюза]]
** [[Пользовательский SSL-сертификат для АктивногоШлюза]]
** [[Доверенные корневые сертификаты для АктивногоШлюза]]
** [[Конфигурация шифра для АктивногоШлюза]]
** [[Развертывание АктивногоШлюза в нескольких средах]]
** [[Директории АктивногоШлюза]]
* Операции с АктивнымиШлюзами
** [[Запуск/остановка/перезапуск АктивногоШлюза]]
** [[Обновление АктивногоШлюза]]
** [[Удаление АктивногоШлюза]]
* Прочее
** [[Схемы подключения АктивныхШлюзов]]
** [[Группы АктивныхШлюзов]]
** [[Диагностика АктивногоШлюза]]
** [[Безопасность АктивногоШлюза]]

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

2022-09-27T12:10:13Z

RGolovanov:

== Требования к установке ==

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

* 4 ГБ свободного места на диске для установки АктивногоШлюза и расширений, настройки и журналов для автоматического обновления.
* 4 ГБ для кэшированных установщиков АктивногоШлюза и ЕдиногоАгента и образов контейнеров — если их нужно будет хранить.
* Место для файлов дампа — если их нужно будет сохранить. Эта функция отключена по умолчанию, но ее можно включить в конфигурации АктивногоШлюза. Максимальный размер дискового пространства настраивается — по умолчанию 100 ГБ.
* Место для загрузки расширений — в зависимости от используемых расширений.
* 2 ГБ оперативной памяти (рекомендуется 4 ГБ).
* 1 двухъядерный процессор.

Для больших сред вам может понадобиться машина с дополнительным процессором и памятью.

=== Требования к пространству по каталогам ===
{| class="wikitable"
!'''Каталог верхнего уровня'''
!'''Требования к дисковому пространству'''
|-
|Исполняемые файлы АктивногоШлюза и автообновления, библиотеки и сопутствующие файлы

стандартный каталог: <code>%PROGRAMFILES%\AstromKey\gateway</code>

относительно параметра установки: <code><INSTALL>\gateway</code>
|300 МБ
|-
|Конфигурация АктивногоШлюза и связанные каталоги

Для АктивногоШлюза Окружения он также содержит конфигурацию Extensions 1.0 и Extensions 2.0.

стандартный каталог: <code>%PROGRAMDATA%\AstromKey</code>

относительно параметра установки: <code><CONFIG></code>
|2 МБ
|-
|Только для АктивногоШлюза Окружения: Исполняемые файлы Extensions 1.0 и Extensions 2.0, библиотеки и связанные файлы по умолчанию: <code>%PROGRAMFILES%\AstromKey\remotepluginmodule</code>

относительно параметра установки: <code><INSTALL>\remotepluginmodule</code>
|350 МБ
|-
|Журналы АктивныхШлюзов и автообновления

стандартный каталог: <code>%PROGRAMDATA%\AstromKey</code>

параметр установки: <code><LOG></code>
|1.2 ГБ
|-
|Временные файлы АктивногоШлюза

default: <code>%PROGRAMDATA%\AstromKey\gateway\tmp</code>

путь относительно параметра установки: <code><TEMP>\gateway</code>
|4 ГБ (включая 3 ГБ для кэшированных установщиков OneAgent и образов контейнеров)
|-
|Файлы дампа, загруженные в АктивныйШлюз ЕдинымАгентом

<code>%PROGRAMDATA%\AstromKey\gateway\dump</code>
|Функциональность отключена по умолчанию, не настраивается во время установки.

При активации может принимать настраиваемый максимальный размер: по умолчанию 100 ГБ.
|-
|Только для АктивногоШлюза Окружения: журналы расширений 1.0 и 2.0 АктивногоШлюза, кэш, рабочая область во время выполнения

стандартный каталог: <code>%PROGRAMDATA%\AstromKey\remotepluginmodule</code>

путь относительно параметра установки: <code><CONFIG>\remotepluginmodule</code>
|2 ГБ
|-
|Только для АктивногоШлюза Окружения: Каталог загрузки расширений

стандартный каталог: <code>%PROGRAMFILES%\AstromKey\remotepluginmodule\plugin_deployment</code>

путь относительно параметра установки: <code><INSTALL>\remotepluginmodule\plugin_deployment</code>
|В зависимости от загруженных расширений
|}

=== Поддерживаемые операционные системы ===
{| class="wikitable"
!Дистрибутив Linux
!Версии
!Архитектуры ЦП
|-
| rowspan="1" |Windows
|8.1, 10
|x86-64
|-
| rowspan="1" |Windows Server
|2012, 2012 R2, 2016, 2019, 2022
|x86-64
|}

=== Системные требования ===

* АктивныйШлюз поддерживает только операционные системы, работающие на архитектуре x86-64 (64-битные Intel/AMD).
* Убедитесь, что у вас правильная конфигурация сетевого порта.
* Установка ActiveGate не поддерживается в Windows с отключенной учетной записью <code>NT AUTHORITY\LocalService</code>.

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

* Мониторинг инфраструктуры
* Мониторинг логов
* Полный стек мониторинга 3 экземпляров Apache Tomcat
* Полный стек мониторинга 2 экземпляров HTTP-сервера Apache

{| class="wikitable"
!Размер машины
!Количество хостов
|-
|c4.large
|450
|-
|c4.xlarge
|900
|-
|c4.2xlarge
|1200
|}
Экземпляры машин С4:
{| class="wikitable"
!Машина
!vCPU
!Память (ГБ)
!Хранилище
!Выделенная пропускная способность EBS (Мбит/с)
!Производительность сети
|-
|c4.large
|2
|3.75
|EBS-Only
|500
|Умеренная
|-
|c4.xlarge
|4
|7.5
|EBS-Only
|750
|Высокая
|-
|c4.2xlarge
|8
|15
|EBS-Only
|1,000
|Высокая
|}

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

=== Разрешите подключения через брандмауэр ===
Убедитесь, что настройки вашего брандмауэра разрешают связь с Ключом-Астром.

В зависимости от политики вашего брандмауэра вам может потребоваться явно разрешить определенные исходящие соединения.

АктивныйШлюз обычно прослушивает (принимает входящие соединения) порт <code>9999</code> и взаимодействует с Ключом-Астром (устанавливает исходящие соединения) через порт <code>443</code>.

=== Установка ===

# Войдите в Ключ-Астром, выберите '''Развернуть Ключ-Астром''' в меню навигации и выберите '''Установить АктивныйШлюз'''.
# На странице '''Установка АктивногоШлюза Окружения''' выберите '''Windows'''.
# Выберите [https://doc.ruscomtech.ru/index.php/%D0%A6%D0%B5%D0%BB%D0%B8%20%D0%90%D0%BA%D1%82%D0%B8%D0%B2%D0%BD%D0%BE%D0%B3%D0%BE%D0%A8%D0%BB%D1%8E%D0%B7%D0%B0 цель АктивногоШлюза].
# Предоставьте PaaS-токен. Он необходим для загрузки установщика АктивногоШлюза из вашей среды. Если у вас нет токена PaaS, вы можете создать его прямо в пользовательском интерфейсе. Токен автоматически добавляется к командам загрузки и установки, которые вы будете использовать позже.
# Скачайте установщик по скопированной cmd-команде или по ссылке.
# Запустите установщик '''с правами администратора'''.

==== Конфигурация установки ====
Вы можете добавить дополнительные параметры в команду установки, чтобы настроить установку. Например, чтобы установить АктивныйШлюз в другой каталог, используйте параметр <code>INSTALL=<путь></code>:
<code>C:\ AstromKey-ActiveGate-Windows-x86-1.0.0.exe '''INSTALL=D:\hosted_app\AstromKey'''</code>

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

Чтобы проверить статус установки, выберите '''Показать статус развертывания''' и перейдите на вкладку '''АктивныеШлюзы'''.
==Стандартные настройки установщика==
Если вы не укажете какие-либо параметры во время установки АктивногоШлюза для настройки параметров, будут применены следующие параметры по умолчанию.
===Каталоги===
{| class="wikitable"
!'''Цель каталога'''
!'''Путь по умолчанию'''Путь относительно параметра установки
!'''Требования к дисковому пространству'''(если размер не указан, предположим, что он меньше 1 МБ)
|-
|Исполняемые файлы АктивногоШлюза, библиотеки и связанные файлы
|<code>%PROGRAMFILES%\dynatrace\gateway</code><code><INSTALL>\gateway</code>
|300 МБ
|-
|Конфигурация АктивногоШлюза
|<code>%PROGRAMDATA%\dynatrace\gateway\config</code>
|
|-
|SSL-папка АктивногоШлюза
|<code>%PROGRAMDATA%\dynatrace\gateway\ssl</code>
|
|-
|Временные файлы АктивногоШлюза
|<code>%PROGRAMDATA%\dynatrace\gateway\tmp</code>
|4 ГБ (включая 3 ГБ для кэшированных установщиков ЕдиныхАгентов и образов контейнеров)
|-
|Логи АктивногоШлюза
|<code>%PROGRAMDATA%\dynatrace\gateway\log</code>
|500 МБ
|-
|Файлы дампа, загруженные в АктивныйШлюз ЕдинымАгентом
|<code>%PROGRAMDATA%\dynatrace\gateway\dump</code>
|Функциональность отключена по умолчанию. При активации может принимать настраиваемый максимальный размер: по умолчанию 100 ГБ.
|-
|Каталог пакетов АктивногоШлюза для загрузки установщика автоматического обновления
|<code>%PROGRAMDATA%\dynatrace\packages</code>
|500 МБ
|-
|Исполняемые файлы расширений 1.0 и 2.0 АктивногоШлюза, библиотеки и связанные файлы
|<code>%PROGRAMFILES%\dynatrace\remotepluginmodule</code>
|350 МБ
|-
|Конфигурация расширений 1.0 и 2.0 АктивногоШлюза, журналы, кеш, рабочая область во время выполнения
|<code>%PROGRAMDATA%\dynatrace\remotepluginmodule</code>
|2 ГБ (для логов и аварийных дампов)
|-
|Каталог загрузки расширений АктивногоШлюза
|<code>%PROGRAMFILES%\dynatrace\remotepluginmodule\plugin_deployment</code>
|В зависимости от загруженных расширений
|-
|zRemote исполняемые файлы, библиотеки и связанные файлы
|<code>%PROGRAMFILES%\dynatrace\zremote</code>
|50 МБ
|-
|zRemote редактируемая пользователем постоянная конфигурация,
zРабочая область удаленного выполнения, отчеты о сбоях
|<code>%PROGRAMDATA%\dynatrace\zremote\agent</code>
|50 МБ
|-
|Логи zRemote
|<code>%PROGRAMDATA%\dynatrace\zremote\log</code>
|200 МБ
|-
|Частные синтетические исполняемые файлы, библиотеки и связанные файлы
|<code>%PROGRAMFILES%\dynatrace\synthetic</code>
|270 МБ
|-
|Приватные синтетические логи
|<code>%PROGRAMDATA%\dynatrace\synthetic\log</code>
|1 ГБ
|-
|Частные синтетические временные файлы
|<code>%PROGRAMDATA%\dynatrace\synthetic</code>
|20 ГБ, в том числе
1 ГБ для <code>/var/tmp/AstromKey/synthetic/cache</code> и

1 ГБ для <code>/var/tmp/AstromKey/synthetic/screenshots</code>
|-
|Автообновление
|<code>%PROGRAMFILES%\dynatrace\gateway</code>

Относительно параметра установки: <code><INSTALL>\gateway</code>
|Включено в оценку исполняемых файлов АктивногоШлюза
|-
|Логи автообновления
|<code>%PROGRAMDATA%\dynatrace\autoupdater\log</code>
|200 МБ
|}
===Службы===
{| class="wikitable"
|'''Название компонента'''
|'''Наименование службы'''
|'''Учетная запись пользователя'''
|'''Описание'''
|-
|АктивныйШлюз
|<code>AstromKeygateway</code>
|<code>Local Service</code>
|Основной сервис АктивногоШлюза. Присутствует для всех целей и функциональных модулей.
|-
|Автообновление АктивногоШлюза
|<code>AstromKeyautoupdater</code>
|<code>Local Service</code>
|Сервис автоматического обновления. Присутствует для всех целей и функциональных модулей АктивногоШлюза.
|-
|Расширения 1.0 (удаленный подключаемый модуль)
|<code>remotepluginmodule</code>
|<code>Local Service</code>
|Сервис для функционального модуля Extensions 1.0. Присутствует на АктивныхШлюзах, установленных для мониторинга маршрутизации. Эта служба будет активной или неактивной в зависимости от конфигурации — настройки по умолчанию см. в описании модуля.
|-
|Расширения 2.0
|<code>extensionsmodule</code>
|<code>Local Service</code>
|Сервис для функционального модуля Extensions 2.0. Присутствует на АктивныхШлюзах, установленных для мониторинга маршрутизации. Эта служба будет активной или неактивной в зависимости от конфигурации — настройки по умолчанию см. в описании модуля.
|-
|zRemote
|<code>zremote</code>
|<code>Local Service</code>
|Сервис для функционального модуля zRemote. Присутствует на АктивныхШлюзах, установленных с целью маршрутизации трафика z/OS в Ключ-Астром.
|-
|Синтетика
|<code>vuc</code>
|<code>Local Service</code>
|Сервис для Синтетического функционального модуля. Присутствует на АктивныхШлюзах, установленных для запуска синтетических мониторов из частной локации.
|}
===Использование портов===
По умолчанию АктивныйШлюз:
*получает соединения от ЕдиныхАгентов или других АктивныхШлюзов через порт 9999
*получает API Ключ-Астром на порт 9999
*подключается к SaaS или Managed-кластеру через порт 443

== Пользовательские настройки установщика ==
Вам не нужно указывать какие-либо параметры для команды установки, если только вам не нужно настроить такие параметры, как расположение каталогов, конфигурация прокси-сервера, сертификаты SSL и т. д. Для настройки таких параметров можно использовать параметры командной строки и переменные среды.

=== Синтаксис команды установки ===
<code>AstromKey-ActiveGate-Windows-x86-<version>.exe [<parameter1>=<value1>] [<parameter2>=<value2>] ...</code>
Пробелы между именем параметра и значением параметра (вокруг знака <code>=</code>) не допускаются в синтаксисе команды.

=== Конфигурация прокси ===
Конфигурация прокси должна быть указана в следующем формате. Это позволит настроить прокси АктивногоШлюза для всех исходящих соединений (в разделе конфигурации <code>http.client</code>):
<code>PROXY=<схема_прокси><пользователь>:<пароль>@<сервер>:<порт></code>
Где:

* Все компоненты необязательны, кроме <code><server></code>.
* Если не указаны ни <code><пользователь></code>, ни <code><пароль></code>, то символ @ следует опустить.
* <code><пароль></code> можно указать, только если указано имя пользователя.
* ':' после <code><user></code> можно указать, даже если часть пароля пуста.
* <code><схема_прокси></code> не является обязательной и может быть <code>"http://"</code> или <code>"https://"</code>.
* <code><пользователь></code> является необязательным.
* <code><server></code> может быть IP-адресом или DNS-именем, но не путем. Например, если указано «1.2.3.4/textaferslash», будет извлечена только часть IP («1.2.3.4»). Косая черта и следующий за ней текст будут игнорироваться.
* <code><порт></code> является необязательным.

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

Для этого вам необходимо:

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

Такие параметры конфигурации можно указать во время установки АктивногоШлюза, задав следующие параметры командной строки программе установки:
<code>IGNORE_CLUSTER_RUNTIME_INFO=true SERVER=<адрес_обратного_прокси></code>
Кроме того, вы можете настроить АктивныйШлюз после установки, внеся изменения в конфигурацию АктивногоШлюза.

=== Каталог установки ===
Абсолютный путь к каталогу установки можно указать либо в пользовательском интерфейсе установщика, либо в командной строке (версия АктивногоШлюза 1.232+). Эта папка будет использоваться для установки исполняемых файлов и библиотек АктивногоШлюза.
<code>C:\AstromKey-ActiveGate-Windows-x86-1.0.0.exe INSTALL=D:\hosted_app\dynatrace</code>
Сохраняет установочные файлы в указанном каталоге. Значение по умолчанию для этого параметра (если оно не указано) — <code>/opt/AstromKey</code>. Этот параметр не разрешен во время обновления.

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

Таким образом вы можете указать прокси-сертификат ЦС (сертификат, который будет использоваться при подключении АктивногоШлюза к кластеру). Это позволяет установить соединение с кластером во время установки, позволяя программе установки АктивногоШлюза загрузить и установить любые необходимые дополнительные возможности.

Пароль сертификата указывается в виде файла, из которого считывается пароль.

Абсолютный путь к расположению настраиваемых доверенных корневых сертификатов для добавления:
<code>CA_CERTIFICATE_FILE=<path></code>
Абсолютный путь к местоположению файла, содержащего пароль сертификата:
<code>CA_CERTIFICATE_PASSWORD_FILE=<path></code>
Пример команды:mple:
<code>C:\AstromKey-ActiveGate-Windows-x86-<version>.exe CA_CERTIFICATE_FILE=D:\Users\Fred\myCert.jks CA_CERTIFICATE_PASSWORD_FILE=D:\Users\Fred\myPwd.txt</code>

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

Пароль сертификата указывается в виде файла, из которого считывается пароль.

Абсолютный путь к местоположению сертификата аутентификации, который АктивныйШлюз предоставляет подключающимся клиентам, ЕдинымАгентам, или подключениям из браузерных клиентов (таких как RUM JavaScript):
<code>CERTIFICATE_FILE=<path></code>
Абсолютный путь к местоположению файла, содержащего пароль сертификата, для сертификата аутентификации, который АктивныйШлюз предоставляет подключающимся клиентам:
<code>CERTIFICATE_PASSWORD_FILE=<path></code>
Пример команды:
<code>C:\Dynatrace-ActiveGate-Windows-x86-<version>.exe CERTIFICATE_FILE=D:\Users\Fred\myCert.jks CERTIFICATE_PASSWORD_FILE=D:\Users\Fred\myPwd.txt</code>

=== Сетевая зона ===
<code>--set-network-zone=<name></code>
Определяет сетевую зону, к которой принадлежит АктивныйШлюз. Он может принадлежать только одной сетевой зоне. Имя сетевой зоны представляет собой строку буквенно-цифровых символов, дефисов <code>(-)</code>, знаков подчеркивания <code>(_)</code> и точек <code>(.)</code>. Точки используются в качестве разделителей, поэтому вы не должны использовать точку в качестве первого символа имени сетевой зоны. Длина строки ограничена 256 символами.

Этот параметр не разрешен во время обновления.

=== Группа ===
<code>--set-group=<name></code>
Определяет группу АктивныхШлюзов, к которой принадлежит АктивныйШлюз. АктивныйШлюз может принадлежать только одной группе. Имя группы АктивныхШлюзов представляет собой строку буквенно-цифровых символов, дефисов (-), знаков подчеркивания (_) и точек (.). Точки используются в качестве разделителей, поэтому вы не должны использовать точку в качестве первого символа имени группы. Длина строки ограничена 256 символами. Вы можете использовать группы АктивныхШлюзов для выполнения массовых действий на ваших АктивныхШлюзах, таких как управление расширениями 2.0, работающими на АктивныхШлюзах.

Этот параметр не разрешен во время обновления.

=== Время соединения ===
<code>ASTROMKEY_ACTIVEGATE_SERVER_CONNECTION_TIMEOUT=<seconds></code>
Определяет максимальное количество секунд (по умолчанию: <code>120</code>), в течение которых программа установки будет ожидать подключения к кластеру. В развертываниях Linux этот параметр необходимо использовать как переменную среды.

Время ожидания соединения, указанное в переменной среды <code>ASTROMKEY_ACTIVEGATE_SERVER_CONNECTION_TIMEOUT=<секунды></code>, используется на двух этапах установки:

* При загрузке дополнительных (необязательных) возможностей.
* При ожидании соединения с кластером в конце установки АктивныхШлюзов: это соединение затем используется АктивнымШлюзом во время его нормальной работы.

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

Чтобы проверить успешность установки и подключения, войдите в AstromKey, в разделе '''Настройки''' выберите '''Статус развертывания''', а затем перейдите на вкладку '''АктивныеШлюзы'''.

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

2022-09-27T11:57:00Z

RGolovanov:

== Требования к установке ==

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

* 4 ГБ свободного места на диске для установки АктивногоШлюза и расширений, настройки и журналов для автоматического обновления.
* 4 ГБ для кэшированных установщиков АктивногоШлюза и ЕдиногоАгента и образов контейнеров — если их нужно будет хранить.
* Место для файлов дампа — если их нужно будет сохранить. Эта функция отключена по умолчанию, но ее можно включить в конфигурации АктивногоШлюза. Максимальный размер дискового пространства настраивается — по умолчанию 100 ГБ.
* Место для загрузки расширений — в зависимости от используемых расширений.
* 2 ГБ оперативной памяти (рекомендуется 4 ГБ).
* 1 двухъядерный процессор.

Для больших сред вам может понадобиться машина с дополнительным процессором и памятью.

=== Требования к пространству по каталогам ===
{| class="wikitable"
!'''Каталог верхнего уровня'''
!'''Требования к дисковому пространству'''
|-
|Исполняемые файлы АктивногоШлюза и автообновления, библиотеки и сопутствующие файлы

стандартный каталог: <code>/opt/AstromKey</code>

относительно параметра установки: <code><INSTALL></code>
|300 МБ
|-
|Конфигурация АктивногоШлюза и связанные каталоги

Для АктивногоШлюза Окружения он также содержит конфигурацию Extensions 1.0 и Extensions 2.0.

стандартный каталог: <code>/var/lib/AstromKey</code>

относительно параметра установки: <code><CONFIG></code>
|2 МБ
|-
|Только для АктивногоШлюза Окружения: Исполняемые файлы Extensions 1.0 и Extensions 2.0, библиотеки и связанные файлы по умолчанию: <code>/opt/AstromKey/remotepluginmodule</code>

относительно параметра установки: <code><INSTALL>/remotepluginmodule</code>
|350 МБ
|-
|Журналы АктивныхШлюзов и автообновления

стандартный каталог: <code>/var/log/AstromKey</code>

параметр установки: <code><LOG></code>
|700 MB
|-
|Каталог пакетов АктивногоШлюза для загрузки установщика автоматического обновления

стандартный каталог: <code>/var/lib/AstromKey/packages</code>

параметр установки: <code><PACKAGES_DIR></code>
|500 MB
|-
|Временные файлы АктивногоШлюза

default: <code>/var/tmp/AstromKey/gateway</code>

путь относительно параметра установки: <code><TEMP>/gateway</code>
|4 ГБ (включая 3 ГБ для кэшированных установщиков OneAgent и образов контейнеров)
|-
|Файлы дампа, загруженные в АктивныйШлюз ЕдинымАгентом

<code>/var/lib/AstromKey/gateway/dump</code>
|Функциональность отключена по умолчанию, не настраивается во время установки.

При активации может принимать настраиваемый максимальный размер: по умолчанию 100 ГБ.
|-
|Только для АктивногоШлюза Окружения: журналы расширений 1.0 и 2.0 АктивногоШлюза, кэш, рабочая область во время выполнения

стандартный каталог: <code>/var/lib/AstromKey/remotepluginmodule</code>

путь относительно параметра установки: <code><CONFIG>/remotepluginmodule</code>
|2 ГБ
|-
|Только для АктивногоШлюза Окружения: Каталог загрузки расширений

стандартный каталог: <code>/opt/AstromKey/remotepluginmodule/plugin_deployment</code>

путь относительно параметра установки: <code><INSTALL>/remotepluginmodule/plugin_deployment</code>
|В зависимости от загруженных расширений
|}

=== Поддерживаемые операционные системы ===
{| class="wikitable"
!Дистрибутив Linux
!Версии
!Архитектуры ЦП
|-
| rowspan="1" |Amazon Linux 2
|Поддерживаются все версии
|x86-64
|-
| rowspan="1" |Amazon Linux AMI
|2018.3
|x86-64
|-
| rowspan="1" |CentOS
|7.9
|x86-64
|-
| rowspan="1" |Oracle Linux
|7.9, 8.4
|x86-64
|-
| rowspan="1" |Red Hat Enterprise Linux
|7.9, 8.2, 8.4, 8.6, 9.0
|x86-64
|-
| rowspan="1" |SUSE Enterprise Linux
|15.1, 15.2, 15.3
|x86-64
|-
| rowspan="1" |Ubuntu
|14.04, 16.04, 18.04, 20.04, 22.04
|x86-64
|}

=== Системные требования ===

* АктивныйШлюз поддерживает только операционные системы, работающие на архитектуре x86-64 (64-битные Intel/AMD).
* Убедитесь, что у вас правильная конфигурация сетевого порта.
* Ваша операционная система должна обрабатывать не менее 500 000 открытых файлов для пользователя <code>dtuserag</code>. Чтобы просмотреть системный лимит, выполните следующую команду: <code>[user@host]# cat /proc/sys/fs/file-max</code>. Кроме того, возможно, вы проверили слишком много открытых файлов в Linux.
* В вашей операционной системе должно быть не менее 20 000 процессов, доступных пользователю <code>dtuserag</code>. Чтобы просмотреть ограничение системы, выполните следующую команду: <code>[user@host]# cat /proc/sys/kernel/pid_max</code>.
* Программа установки АктивногоШлюза не поддерживает ACL (список управления доступом). Правила ACL могут запретить доступ к каталогам и файлам, созданным установщиком, из-за чего АктивныйШлюз не запустится. Если вы используете ACL, правила, относящиеся к каталогам установки, определенным в следующих параметрах, должны быть отключены: <code>INSTALL=↵CONFIG=↵LOG=↵TEMP=↵PACKAGES_DIR=</code>

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

* Мониторинг инфраструктуры
* Мониторинг логов
* Полный стек мониторинга 3 экземпляров Apache Tomcat
* Полный стек мониторинга 2 экземпляров HTTP-сервера Apache

{| class="wikitable"
!Размер машины
!Количество хостов
|-
|c4.large
|450
|-
|c4.xlarge
|900
|-
|c4.2xlarge
|1200
|}
Экземпляры машин С4:
{| class="wikitable"
!Машина
!vCPU
!Память (ГБ)
!Хранилище
!Выделенная пропускная способность EBS (Мбит/с)
!Производительность сети
|-
|c4.large
|2
|3.75
|EBS-Only
|500
|Умеренная
|-
|c4.xlarge
|4
|7.5
|EBS-Only
|750
|Высокая
|-
|c4.2xlarge
|8
|15
|EBS-Only
|1,000
|Высокая
|}

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

=== Разрешите подключения через брандмауэр ===
Убедитесь, что настройки вашего брандмауэра разрешают связь с Ключом-Астром.

В зависимости от политики вашего брандмауэра вам может потребоваться явно разрешить определенные исходящие соединения.

АктивныйШлюз обычно прослушивает (принимает входящие соединения) порт <code>9999</code> и взаимодействует с Ключом-Астром (устанавливает исходящие соединения) через порт <code>443</code>.

=== Установка ===

# Войдите в Ключ-Астром, выберите '''Развернуть Ключ-Астром''' в меню навигации и выберите '''Установить АктивныйШлюз'''.
# На странице '''Установка АктивногоШлюза Окружения''' выберите '''Linux'''.
# Выберите [[Цели АктивногоШлюза|цель АктивногоШлюза]].
# Предоставьте PaaS-токен. Он необходим для загрузки установщика АктивногоШлюза из вашей среды. Если у вас нет токена PaaS, вы можете создать его прямо в пользовательском интерфейсе. Токен автоматически добавляется к командам загрузки и установки, которые вы будете использовать позже.
# Скачайте установщик по скопированной <code>wget</code>-команде или по ссылке.
# Проверьте подпись. Дождитесь завершения загрузки. Затем проверьте подпись, скопировав команду из второго текстового поля '''Проверить подпись''' и вставив ее в окно терминала.
# Скопируйте команду установки АктивногоШлюза с указанной целью в терминал.

==== Конфигурация установки ====
Вы можете добавить дополнительные параметры в команду установки, чтобы настроить установку. Например, чтобы установить АктивныйШлюз в другой каталог, используйте параметр <code>INSTALL=<путь></code>:
<code>[root@host]# /bin/bash AstromKey-ActiveGate-Linux-x86-1.0.0.sh '''INSTALL=/hosted_app/AstromKey'''</code>

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

Чтобы проверить статус установки, выберите '''Показать статус развертывания''' и перейдите на вкладку '''АктивныеШлюзы'''.

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

=== Каталоги ===
{| class="wikitable"
!'''Цель каталога'''
!'''Путь по умолчанию'''Путь относительно параметра установки
!'''Требования к дисковому пространству'''(если размер не указан, предположим, что он меньше 1 МБ)
|-
|Исполняемые файлы АктивногоШлюза, библиотеки и связанные файлы
|<code>/opt/AstromKey/gateway</code>

<code><INSTALL>/gateway</code>
|300 МБ
|-
|Конфигурация АктивногоШлюза
|<code>/var/lib/AstromKey/gateway/config</code>

<code><CONFIG>/gateway/config</code>
|
|-
|SSL-папка АктивногоШлюза
|<code>/var/lib/AstromKey/gateway/ssl</code>

<code><CONFIG>/gateway/ssl</code>
|
|-
|Временные файлы АктивногоШлюза
|<code>/var/tmp/AstromKey/gateway</code>

<code><TEMP>/gateway</code>
|4 ГБ (включая 3 ГБ для кэшированных установщиков ЕдиныхАгентов и образов контейнеров)
|-
|Логи АктивногоШлюза
|<code>/var/log/AstromKey/gateway</code>

<code><LOG>/gateway</code>
|500 МБ
|-
|Файлы дампа, загруженные в АктивныйШлюз ЕдинымАгентом
|<code>/var/lib/AstromKey/gateway/dump</code>
|Функциональность отключена по умолчанию. При активации может принимать настраиваемый максимальный размер: по умолчанию 100 ГБ.
|-
|Каталог пакетов АктивногоШлюза для загрузки установщика автоматического обновления
|<code>/var/lib/AstromKey/packages</code>

<code><PACKAGES_DIR></code>
|500 МБ
|-
|Исполняемые файлы расширений 1.0 и 2.0 АктивногоШлюза, библиотеки и связанные файлы
|<code>/opt/AstromKey/remotepluginmodule</code>

<code><INSTALL>/remotepluginmodule</code>
|350 МБ
|-
|Конфигурация расширений 1.0 и 2.0 АктивногоШлюза, журналы, кеш, рабочая область во время выполнения
|<code>/var/lib/AstromKey/remotepluginmodule</code>

<code><CONFIG>/remotepluginmodule</code>
|2 ГБ (для журналов и аварийных дампов)
|-
|Каталог загрузки расширений АктивногоШлюза
|<code>/opt/AstromKey/remotepluginmodule/plugin_deployment/</code>
|В зависимости от загруженных расширений
|-
|zRemote исполняемые файлы, библиотеки и связанные файлы
|<code>/opt/AstromKey/zremote</code>

Использование каталогов не по умолчанию не поддерживается.
|50 МБ
|-
|zRemote редактируемая пользователем постоянная конфигурация,

zРабочая область удаленного выполнения, отчеты о сбоях
|<code>/var/lib/AstromKey/zremote/agent</code>

Использование каталогов не по умолчанию не поддерживается.
|50 МБ
|-
|Логи zRemote
|<code>/var/lib/AstromKey/zremote/log</code>

Установка АктивногоШлюзас zRemote в каталоги, отличные от каталогов по умолчанию, не поддерживается.
|200 МБ
|-
|Частные синтетические исполняемые файлы, библиотеки и связанные файлы
|<code>/opt/AstromKey/synthetic</code>

<code><INSTALL>/synthetic</code>
|270 МБ
|-
|Приватные синтетические логи
|<code>/var/log/AstromKey/synthetic</code>

<code><LOG>/synthetic/log</code>
|1 ГБ
|-
|Частные синтетические временные файлы
|<code>/var/tmp/AstromKey/synthetic</code>
|20 ГБ, в том числе

1 ГБ для <code>/var/tmp/AstromKey/synthetic/cache</code> и

1 ГБ для <code>/var/tmp/AstromKey/synthetic/screenshots</code>
|-
|Автообновление
|<code>/opt/AstromKey/autoupdater</code>

<code><INSTALL>/autoupdater</code>
|Включено в оценку исполняемых файлов АктивногоШлюза
|-
|Логи автообновления
|<code>/var/log/AstromKey/autoupdater</code>

<code><LOG>/autoupdater</code>
|200 МБ
|}

=== Службы ===
{| class="wikitable"
|'''Название компонента'''
|'''Наименование службы'''
|'''Учетная запись пользователя'''
|'''Описание'''
|-
|АктивныйШлюз
|<code>AstromKeygateway</code>
|по умолчанию: <code>dtuserag</code>

настраивается во время установки
|Основной сервис АктивногоШлюза. Присутствует для всех целей и функциональных модулей.
|-
|Автообновление АктивногоШлюза
|<code>AstromKeyautoupdater</code>
|<code>root</code>
|Сервис автоматического обновления. Присутствует для всех целей и функциональных модулей АктивногоШлюза.
|-
|Расширения 1.0 (удаленный подключаемый модуль)
|<code>remotepluginmodule</code>
|как и для АктивногоШлюза
|Сервис для функционального модуля Extensions 1.0. Присутствует на АктивныхШлюзах, установленных для мониторинга маршрутизации. Эта служба будет активной или неактивной в зависимости от конфигурации — настройки по умолчанию см. в описании модуля.
|-
|Расширения 2.0
|<code>extensionsmodule</code>
|как и для АктивногоШлюза
|Сервис для функционального модуля Extensions 2.0. Присутствует на АктивныхШлюзах, установленных для мониторинга маршрутизации. Эта служба будет активной или неактивной в зависимости от конфигурации — настройки по умолчанию см. в описании модуля.
|-
|zRemote
|<code>zremote</code>
|как и для АктивногоШлюза
|Сервис для функционального модуля zRemote. Присутствует на АктивныхШлюзах, установленных с целью маршрутизации трафика z/OS в Ключ-Астром.
|-
|Синтетика
|<code>vuc</code>
|как и для АктивногоШлюза
|Сервис для Синтетического функционального модуля. Присутствует на АктивныхШлюзах, установленных для запуска синтетических мониторов из частной локации.
|}

=== Пользователь, работающий со службой АктивногоШлюза ===
По умолчанию программа установки АктивногоШлюза использует пользователя <code>dtuserag</code> для запуска службы АктивногоШлюза. Этому пользователю не требуются привилегии root.

Если пользователь <code>dtuserag</code> еще не существует в системе, программа установки создаст его.

=== Использование портов ===
По умолчанию АктивныйШлюз:

* получает соединения от ЕдиныхАгентов или других АктивныхШлюзов через порт 9999
* получает API Ключ-Астром на порт 9999
* подключается к SaaS или Managed-кластеру через порт 443

== Пользовательские настройки установщика ==
Вам не нужно указывать какие-либо параметры для команды установки, если только вам не нужно настроить такие параметры, как расположение каталогов, конфигурация прокси-сервера, сертификаты SSL и т. д. Для настройки таких параметров можно использовать параметры командной строки и переменные среды.

=== Синтаксис команды установки ===
<code>AstromKey-ActiveGate-Linux-x86-<version>.sh [<параметр_1>=<значение_1>] [<параметр_2>=<значение_2>] ...</code>
Пробелы между именем параметра и значением параметра (вокруг знака <code>=</code>) не допускаются в синтаксисе команды.

=== Конфигурация прокси ===
Конфигурация прокси должна быть указана в следующем формате. Это позволит настроить прокси АктивногоШлюза для всех исходящих соединений (в разделе конфигурации <code>http.client</code>):
<code>PROXY=<схема_прокси><пользователь>:<пароль>@<сервер>:<порт></code>
Где:

* Все компоненты необязательны, кроме <code><server></code>.
* Если не указаны ни <code><пользователь></code>, ни <code><пароль></code>, то символ @ следует опустить.
* <code><пароль></code> можно указать, только если указано имя пользователя.
* ':' после <code><user></code> можно указать, даже если часть пароля пуста.
* <code><схема_прокси></code> не является обязательной и может быть <code>"http://"</code> или <code>"https://"</code>.
* <code><пользователь></code> является необязательным.
* <code><server></code> может быть IP-адресом или DNS-именем, но не путем. Например, если указано «1.2.3.4/textaferslash», будет извлечена только часть IP («1.2.3.4»). Косая черта и следующий за ней текст будут игнорироваться.
* <code><порт></code> является необязательным.

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

Для этого вам необходимо:

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

Такие параметры конфигурации можно указать во время установки АктивногоШлюза, задав следующие параметры командной строки программе установки:
<code>--ignore-cluster-runtime-info SERVER=<адрес_обратного_прокси></code>
Кроме того, вы можете настроить АктивныйШлюз после установки, внеся изменения в конфигурацию АктивногоШлюза.

=== Пользователь службы АктивногоШлюза ===
Чтобы указать пользователя, запускающего службу АктивногоШлюза, укажите следующую опцию командной строки:
<code>USER=<user></code>
Установщик создает пользователя, если он еще не существует в системе и ему не требуются привилегии root. Если параметр не указан, установщик создает пользователя <code>dtuserag</code> для запуска службы АктивногоШлюза. Однако вы можете использовать <code>USER=root</code>, чтобы заставить службу работать от имени пользователя root. Примечание: параметр <code>USER=root</code> не поддерживается при установке синтетического АктивногоШлюза.

=== Ограничения для расположения каталогов и точек монтирования ===
<code><настраиваемый_каталог>/gateway</code>, то есть <code>INSTALL/gateway,</code> <code>CONFIG/gateway,</code> <code>LOG/gateway</code>, <code>TEMP/gateway</code>, <code>PACKAGES_DIR/gateway</code>, не может быть родительским для другого настраиваемого каталога, то есть <code>INSTALL</code>, <code>CONFIG</code>, <code>TEMP</code>, <code>LOG</code> или <code>PACKAGED_DIR</code>.

Например, не указывайте:
<code>INSTALL=/AstromKey
LOG=/AstromKey/gateway/logs
CONFIG=/AstromKey/gateway/config
TEMP=/AstromKey/gateway/tmp</code>
Также не указывайте:
<code>CONFIG=/var/lib/AstromKey
PACKAGES_DIR=/var/lib/AstromKey/gateway/packages</code>
Однако разрешен общий родитель, например:
<code>INSTALL=/example/apps
CONFIG=/example/configs
LOG=/example/logs
TEMP=/example/tmp</code>

==== Точки монтирования ====
В процессе установки АктивныйШлюз создает подкаталоги в своих каталогах верхнего уровня. Если вы использовали параметры <code>INSTALL</code> или <code>CONFIG</code> для указания путей, АктивныйШлюз создаст свои подкаталоги по указанным путям. Не создавайте точки монтирования для этих подкаталогов, созданных установщиком. Вы можете монтировать только каталоги верхнего уровня по умолчанию или указанные вами каталоги верхнего уровня.

Например, если вы указали следующий параметр <code>INSTALL</code>:
<code>INSTALL=/opt/MyActiveGate</code>
Программа установки АктивногоШлюза создаст подкаталог <code>gateway</code> в указанном вами пути установки: <code>/opt/MyActiveGate/gateway</code>

Как результат:

* Точка монтирования <code>/opt/MyActiveGate</code> '''КОРРЕКТНА'''.
* Точка монтирования <code>/opt/MyActiveGate/gateway</code> '''НЕКОРРЕКТНА'''.

==== Использование <code>/temp</code> или <code>/tmp</code> ====
Из-за возможной автоматической очистки мы рекомендуем вам не использовать каталоги <code>/temp</code> или <code>/tmp</code> или их подкаталоги для установки АктивногоШлюза или хранения каких-либо данных, сгенерированных или используемых АктивнымШлюзом.

=== Каталог установки ===
<code>INSTALL=<directory></code>
Сохраняет установочные файлы в указанном каталоге. Значение по умолчанию для этого параметра (если оно не указано) — <code>/opt/AstromKey</code>. Этот параметр не разрешен во время обновления.

=== Каталог для хранения загруженных пакетов ===
<code>PACKAGES_DIR=<directory></code>
Сохраняет установочные файлы дополнительных возможностей в указанном каталоге. Значение по умолчанию для этого параметра (если не указано) — <code>/var/lib/AstromKey/packages</code>. Не разрешено во время обновления.

=== Каталог логов ===
<code>LOG=<directory></code>
Сохраняет файлы журналов в указанном каталоге. Значение по умолчанию для этого параметра (если не указано) — <code>/var/log/AstromKey</code>. Не разрешено во время обновления.

=== Каталог конфигурации ===
<code>CONFIG=<directory></code>
Сохраняет файлы конфигурации в указанном каталоге. Значение по умолчанию для этого параметра (если не указано) — <code>/var/lib/AstromKey</code>. Не разрешено во время обновления.

=== Временный каталог ===
<code>TEMP=<directory></code>
Указывает временный каталог, который будет использоваться АктивнымШлюзом. Значение по умолчанию для этого параметра (если не указано) — <code>/var/tmp/AstromKey</code>. Не разрешено во время обновления.

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

Таким образом вы можете указать прокси-сертификат ЦС (сертификат, который будет использоваться при подключении АктивногоШлюза к кластеру). Это позволяет установить соединение с кластером во время установки, позволяя программе установки АктивногоШлюза загрузить и установить любые необходимые дополнительные возможности.

Пароль сертификата указывается в виде файла, из которого считывается пароль.

Абсолютный путь к расположению настраиваемых доверенных корневых сертификатов для добавления:
<code>--ca-certificate-file=<path></code>
Абсолютный путь к местоположению файла, содержащего пароль сертификата:
<code>--ca-certificate-password-file=<path></code>
Пример команды:mple:
<code>[root@host]# ./AstromKey-ActiveGate-Linux-1.217.sh --ca-certificate-file=/home/fred/myCert.jks --ca-certificate-password-file=/home/fred/myPwd.txt</code>

==== Ограничения для указания SSL-сертификата ====
Прямое указание SSL-сертификата для АктивногоШлюза неприменимо для АктивногоШлюза Кластера. Не пытайтесь настроить SSL-сертификаты непосредственно на АктивномШлюзе Кластера. Если вы это сделаете, сертификат будет перезаписан автоматическим управлением Для АктивныхШлюзов Кластера вы должны загрузить свои сертификаты с помощью Консоли Менеджмента Кластера или REST API Кластера v1.

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

Пароль сертификата указывается в виде файла, из которого считывается пароль.

Абсолютный путь к местоположению сертификата аутентификации, который АктивныйШлюз предоставляет подключающимся клиентам, ЕдинымАгентам, или подключениям из браузерных клиентов (таких как RUM JavaScript):
<code>--certificate-file=<path></code>
Абсолютный путь к местоположению файла, содержащего пароль сертификата, для сертификата аутентификации, который АктивныйШлюз предоставляет подключающимся клиентам:
<code>--certificate-password-file=<path></code>
Пример команды:
<code>[root@host]# ./AstromKey-ActiveGate-Linux-1.217.sh --certificate-file=/home/fred/myCert.jks --certificate-password-file=/home/fred/myPwd.txt</code>

=== Сетевая зона ===
<code>--set-network-zone=<name></code>
Определяет сетевую зону, к которой принадлежит АктивныйШлюз. Он может принадлежать только одной сетевой зоне. Имя сетевой зоны представляет собой строку буквенно-цифровых символов, дефисов <code>(-)</code>, знаков подчеркивания <code>(_)</code> и точек <code>(.)</code>. Точки используются в качестве разделителей, поэтому вы не должны использовать точку в качестве первого символа имени сетевой зоны. Длина строки ограничена 256 символами.

Этот параметр не разрешен во время обновления.

=== Группа ===
<code>--set-group=<name></code>
Определяет группу АктивныхШлюзов, к которой принадлежит АктивныйШлюз. АктивныйШлюз может принадлежать только одной группе. Имя группы АктивныхШлюзов представляет собой строку буквенно-цифровых символов, дефисов (-), знаков подчеркивания (_) и точек (.). Точки используются в качестве разделителей, поэтому вы не должны использовать точку в качестве первого символа имени группы. Длина строки ограничена 256 символами. Вы можете использовать группы АктивныхШлюзов для выполнения массовых действий на ваших АктивныхШлюзах, таких как управление расширениями 2.0, работающими на АктивныхШлюзах.

Этот параметр не разрешен во время обновления.

=== Время соединения ===
<code>AstromKey_ACTIVEGATE_SERVER_CONNECTION_TIMEOUT=<seconds></code>
Определяет максимальное количество секунд (по умолчанию: <code>120</code>), в течение которых программа установки будет ожидать подключения к кластеру. В развертываниях Linux этот параметр необходимо использовать как переменную среды.

Время ожидания соединения, указанное в переменной среды <code>ASTROMKEY_ACTIVEGATE_SERVER_CONNECTION_TIMEOUT=<секунды></code>, используется на двух этапах установки:

* При загрузке дополнительных (необязательных) возможностей.
* При ожидании соединения с кластером в конце установки АктивныхШлюзов: это соединение затем используется АктивнымШлюзом во время его нормальной работы.

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

Чтобы проверить успешность установки и подключения, войдите в AstromKey, в разделе '''Настройки''' выберите '''Статус развертывания''', а затем перейдите на вкладку '''АктивныеШлюзы'''.

Например:
<code>[root@host]# export ASTROMKEY_ACTIVEGATE_SERVER_CONNECTION_TIMEOUT=240
[root@host]# AstromKey-ActiveGate-Linux-x86-1.0.0.sh <... other parameters></code>
или вы можете использовать комбинированные команды в одной строке. Например:

<code>[root@host]# export ASTROMKEY_ACTIVEGATE_SERVER_CONNECTION_TIMEOUT=240 ; AstromKey-ActiveGate-Linux-x86-1.0.0.sh <... other parameters></code>

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

2022-09-27T11:28:00Z

RGolovanov: /* Каталоги */

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

2022-09-27T11:27:31Z

RGolovanov:

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

2022-09-27T11:14:51Z

RGolovanov:

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

2022-09-27T11:14:35Z

RGolovanov: Новая страница: «== Требования к установке == === Аппаратные требования === Вам нужна машина, предназначенная...»

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

2022-09-27T11:12:21Z

RGolovanov:

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

2022-09-27T11:09:01Z

RGolovanov:

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

2022-09-27T11:05:32Z

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

2022-09-27T10:32:18Z

RGolovanov: Новая страница: «Ключ-Астром предлагает два типа АктивногоШлюза: Окружения и Кластера. Если вы используе...»

Ключ-Астром предлагает два типа АктивногоШлюза: Окружения и Кластера. Если вы используете SaaS, вам нужно только установить АктивныйШлюз Окружения. Для развёртывания Ключа-Астром Managed обычно требуются оба типа АктивногоШлюза, хотя наиболее важным типом является АктивныйШлюз Кластера.

АктивныйШлюз Окружения может быть установлен:

* с помощью установщика на виртуальном или физическом хосте — это называется '''развертыванием на хосте''' ([[Установка АктивногоШлюза на Linux|Linux]], [[Установка АктивногоШлюза на Windows|Windows]]).
* в контейнере — это называется '''контейнерным развертыванием''' ([[Установка АктивногоШлюза в Kubernetes|Kubernetes]], [[Установка АктивногоШлюза в OpenShift|OpenShift]]).

Установка модуля zRemote для мониторинга z/OS

2022-09-27T10:28:25Z

RGolovanov: Новая страница: «Модуль zRemote обрабатывает двоичные данные, полученные от zLocal, и направляет эти данные, сжа...»

Модуль zRemote обрабатывает двоичные данные, полученные от zLocal, и направляет эти данные, сжатые и зашифрованные, через локальную среду АктивногоШлюза в Ключ-Астром. Таким образом, модуль zRemote переносит большую часть работы по обработке с модулей кода Java CICS, IMS и z/OS, связанную с инструментированием подсистем и приложений, на открытую систему.

== Модуль zRemote ==
Если модуль zRemote включен в АктивномШлюзе Окружения, никакие другие функциональные модули не могут быть включены. Модуль zRemote более требователен к системным и аппаратным требованиям.

== Мониторинг z/ОS ==
Для мониторинга LPAR z/OS, включая такие технологии, как CICS, IMS и Java, вам потребуется АктивныйШлюз Окружения с включенным модулем zRemote. Вы можете установить этот АктивныйШлюз Окружения в любой операционной системе Linux или Windows, которая поддерживается АктивнымиШлюзами. Необходимо учитывать лишь несколько дополнительных ограничений.

Для мониторинга z/OS вам потребуются оба следующих компонента:

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

Запуск синтетических мониторов из частных локаций

2022-09-27T10:25:23Z

RGolovanov: Новая страница: « '''Синтетические АктивныеШлюзы''' позволяют вам создавать частные синтетические локаци...»

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

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

Синтетические АктивныеШлюзы вместе с Синтетическим Движком и Chromium являются элементами частных синтетических локаций, то есть локаций в вашей частной сетевой инфраструктуре.

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

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

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

== Выполнение мониторов ==
Любой АктивныйШлюз с поддержкой Синтетики может работать '''как в браузере, так и в HTTP-мониторах'''.

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

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

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

* Измерять производительность и доступность внутренней веб-страницы.
* Измерять сложные внутренние приложения с помощью мониторов кликов в браузере.
* Измерять внешние ресурсы с помощью синтетических мониторов, запускаемых из внутренних локаций.
* Отслеживать API, как внутренние, так и внешние.

Направление трафика ЕдиногоАгента

2022-09-27T10:10:41Z

RGolovanov: Новая страница: «Функциональность, предлагаемая этими типами АктивныхШлюзов, зависит от функциональных...»

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

== Маршрутизация трафика ЕдиногоАгента ==
Dynatrace ActiveGate устанавливает присутствие компонента Ключа-Астром в вашей локальной сети. Таким образом, АктивныйШлюз позволяет сократить взаимодействие с Ключом-Астром до одной точки, доступной локально. Помимо удобства, это решение также оптимизирует объем трафика и упрощает сетевые подключения, а, следовательно, снижает затраты. Он также обеспечивает безопасность закрытых сетей.

=== Маршрутизация сообщений (модуль Routing) ===

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

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

==== Аутентификация ====
АктивныйШлюз аутентифицирует запросы ЕдиныхАгентов (подтверждение SSL и аутентификация по идентификатору среды).

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

=== Дампы памяти (модуль Memory Dumps) ===
Дампы памяти поступают от ЕдиныхАгентов и, таким образом, могут рассматриваться как часть функции маршрутизации АктивныхШлюзов.

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

== Мониторинг облачных сред и удаленных технологий ==

==== AWS-мониторинг (модуль AWS) ====
Мониторинг сервисов AWS — ресурсоемкая задача. Поэтому для мониторинга более 2000 ресурсов AWS необходимо установить АктивныйШлюз и настроить мониторинг AWS.

==== Мониторинг Cloud Foundry (модуль Cloud Foundry) ====
Чтобы подключить свои фонды Cloud Foundry к Ключу-Астром, вам необходимо установить АктивныйШлюз, чтобы дополнить метрики Cloud Foundry на уровне процессов и хостов, собранные ЕдинымиАгентами, дополнительными метаданными и метриками, полученными из Cloud Foundry API. Эта интеграция позволяет вам использовать обзорную страницу Cloud Foundry, а также автоматическое обнаружение ваших организаций Cloud Foundry в дополнение к другим свойствам процесса Cloud Foundry, таким как <code>пространство</code>, <code>идентификатор пространства</code>, <code>приложение</code>, <code>идентификатор приложени</code>я и <code>индекс экземпляра</code>.

==== Мониторинг Kubernetes/OpenShift (модуль Kubernetes) ====
Чтобы подключить кластеры Kubernetes/OpenShift к Ключу-Астром и воспользоваться преимуществами специальной страницы обзора Kubernetes/OpenShift, вам необходимо запустить Активный Шлюз версии 1.163+ в своей среде.

==== Мониторинг Azure (модуль Azure) ====
Для интеграции данных мониторинга Azure требуется выделенный АктивныйШлюз для опроса метаданных и метрик из API Azure. Эта интеграция позволяет осуществлять мониторинг служб Azure (особенно для облачных служб, где мы не можем установить ЕдиныхАгентов), а также осуществлять мониторинг через пользовательский интерфейс.

==== Мониторинг с помощью расширения ActiveGate (модули Расширения 1.0, Расширения 2.0) ====
С расширениями АктивныхШлюзов вы можете распространить мониторинг на любую удаленную технологию, предоставляющую интерфейс, где установка ЕдиныхАгентов невозможна. Например, технологии PaaS, сетевые устройства или облачные технологии. Расширения АктивныхШлюзов (также известные как удаленные плагины) выполняются на АктивныхШлюзах и могут получать метрики и информацию о топологии из удаленных источников, тем самым полностью интегрируя удаленный мониторинг технологий в Ключ-Астром Smartscape и обнаружение проблем. В настоящее время эта возможность предлагается только в АктивныхШлюзах Окружения.

==== Информация о базе данных Oracle (модуль Анализ Базы Данных) ====
Инсайты по базам данных добавляют взгляд на инфраструктуру к мониторингу вашей базы данных. С помощью дополнительных данных, получаемых с уровня базы данных, вы можете решить проблемы с производительностью, глубоко укоренившиеся в базе данных.

==== Мониторинг виртуализированной инфраструктуры (модуль VMware) ====
АктивныйШлюз может опросить ваш vCenter или автономные хосты ESXi, чтобы получить информацию обо всех важных ресурсах, которые серверы ESXi предоставляют вашим виртуальным машинам (например, об использовании ЦП, потреблении памяти и действиях, связанных с хранилищем данных, на вашей платформе VMware). Чтобы получить эту информацию, Ключу-Астром необходим компонент, установленный в вашей среде, который имеет доступ к vCenter API.

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

АктивныйШлюз поддерживает вызовы ко всем конечным точкам версий v1 и v2 API-интерфейсов конфигурации и среды.

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

==== Прием метрик (модуль API HTTP-метрик) ====
Прием метрик предоставляет вам простой способ передать любые пользовательские метрики в Dynatrace. Вы можете дополнительно уточнить свои показатели по категориям.

==== Прием трассировки OpenTelemetry (модуль OTLP Ingest) ====
Вы можете отправлять данные трассировки OpenTelemetry (трассы и интервалы) в формате OTLP в Ключ-Астром через API, доступный на АктивномШлюзе. Полученные диапазоны интегрируются в распределенные трассировки PurePath®.

==== Real User Monitoring (модуль Beacon Forwarder) ====
Инфраструктура Ключ-Астром может использоваться в качестве конечной точки маяка по умолчанию для безагентного мониторинга ваших приложений. Автоматически внедряемые приложения отправляют маяк обратно на веб-сервер клиента, минуя необходимость в стороннем домене. Однако при необходимости такие приложения также могут использовать инфраструктуру в качестве конечной точки для сигналов мониторинга RUM.

Dynatrace ActiveGate

2022-09-27T09:55:55Z

RGolovanov:

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

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

== АктивныйШлюз осуществляет мониторинг ==
В дополнение к маршрутизации данных мониторинга, захваченных ЕдинымиАгентами, АктивныеШлюзы также может выполняют задачи мониторинга, используя API для запроса и мониторинга широкого спектра технологий.
Список отслеживаемых технологий не ограничен, но может динамически расширяться. Он включает в себя облачные технологии и технологии центров обработки данных, например, '''AWS''', '''VMware''', '''Azure''', '''Kubernetes''', '''OpenShift''', '''Cloud Foundry''', '''Google Cloud Platform''', '''Oracle''', '''SMTP''', '''WMI''', '''Prometheus''' и многие другие.
[[Файл:СхемаАктивныхШлюзов.png|центр|877x877пкс]]

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

* Если вы используете решение SaaS, вам нужно только установить АктивныйШлюз Окружения.
* Для развёртывания Ключ-Астром Managed обычно требуются оба типа АктивногоШлюза, хотя наиболее важным типом для развёртывания является АктивныйШлюз Кластера.

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

АктивныйШлюзможно развернуть обычным способом — на физическом или виртуальном хосте — это '''развертывание АктивногоШлюза на хосте'''. АктивныйШлюз, упакованный в контейнер, называется '''развертыванием АктивногоШлюза в контейнере'''.

== Подробнее об АктивныхШлюзах ==

* [[Цели АктивногоШлюза]]
** [[Направление трафика ЕдиногоАгента]]
** [[Запуск синтетических мониторов из частных локаций]]
** [[Установка модуля zRemote для мониторинга z/OS]]
* [[Установка АктивногоШлюза]]
** [[Установка АктивногоШлюза на Linux|Linux]]
** [[Установка АктивногоШлюза на Windows|Windows]]
** [[Установка АктивногоШлюза в Kubernetes|Kubernetes]]
** [[Установка АктивногоШлюза в OpenShift|OpenShift]]
* [[Конфигурация АктивногоШлюза]]
** [[Параметры АктивногоШлюза]]
** [[Настройка прокси АктивногоШлюза]]
** [[Обратный прокси (балансировщик загрузки) для АктивногоШлюза]]
** [[Пользовательский SSL-сертификат для АктивногоШлюза]]
** [[Доверенные корневые сертификаты для АктивногоШлюза]]
** [[Конфигурация шифра для АктивногоШлюза]]
** [[Развертывание АктивногоШлюза в нескольких средах]]
** [[Директории АктивногоШлюза]]
* Операции с АктивнымиШлюзами
** [[Запуск/остановка/перезапуск АктивногоШлюза]]
** [[Обновление АктивногоШлюза]]
** [[Удаление АктивногоШлюза]]
* Прочее
** [[Схемы подключения АктивныхШлюзов]]
** [[Группы АктивныхШлюзов]]
** [[Диагностика АктивногоШлюза]]
** [[Безопасность АктивногоШлюза]]

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

2022-09-27T09:42:55Z

RGolovanov:

АктивныеШлюзы можно использовать для трех различных вариантов использования, которые мы называем '''целями''':

* [[Направление трафика ЕдиногоАгента|Направление трафика ЕдиныхАгентов в Ключ-Астром, отслеживание облачных сред или отслеживание удалённых технологий с помощью расширений]].
* [[Запуск синтетических мониторов из частных локаций]].
* [[Установка модуля zRemote для мониторинга z/OS]].

Каждая цель поставляется с различным подмножеством функциональных модулей. Модули не должны смешиваться между целями — такая реконфигурация не поддерживается.

=== Функциональность АктивныхШлюзов для мониторинга маршрутизации ===
{| class="wikitable"
|'''Функциональность'''
|'''Имя модуля'''
|'''Поддерживается при развертывании АктивногоШлюза <code>на хосте</code>'''
|'''Поддерживается при развертывании АктивногоШлюза <code>в контейнере</code>'''
|-
|Маршрутизация сообщений
|Маршрутизация ЕдиныхАгентов
|<nowiki>+</nowiki>
|<nowiki>+</nowiki>
|-
|Буферизация и сжатие
|Маршрутизация ЕдиныхАгентов
|<nowiki>+</nowiki>
|<nowiki>+</nowiki>
|-
|Аутентификация
|Маршрутизация ЕдиныхАгентов
|<nowiki>+</nowiki>
|<nowiki>+</nowiki>
|-
|Доступ к закрытым сетям
|Маршрутизация ЕдиныхАгентов
|<nowiki>+</nowiki>
|<nowiki>+</nowiki>
|-
|Дампы памяти
|Дампы памяти
|<nowiki>+</nowiki>
|—
|-
|AWS-мониторинг
|AWS
|<nowiki>+</nowiki>
|—
|-
|Мониторинг Cloud Foundry
|Cloud Foundry
|<nowiki>+</nowiki>
|—
|-
|Мониторинг Kubernetes/OpenShift
|Kubernetes
|<nowiki>+</nowiki>
|<nowiki>+</nowiki>
|-
|Мониторинг Azure
|Azure
|<nowiki>+</nowiki>
|—
|-
|Мониторинг с помощью расширения АктивногоШлюза
|Расширения 1.0, Расширения 2.0
|<nowiki>+</nowiki>
|—
|-
|Информация о базе данных Oracle
|Анализ базы данных
|<nowiki>+</nowiki>
|—
|-
|Мониторинг виртуализированной инфраструктуры
|VMware
|<nowiki>+</nowiki>
|—
|-
|API Ключ-Астром
|REST API
|<nowiki>+</nowiki>
|—
|-
|Мониторинг Логов
|Мониторинг Логов
|<nowiki>+</nowiki>
|—
|-
|Прием метрик
|API HTTP-Метрики
|<nowiki>+</nowiki>
|—
|-
|Прием трассировки OpenTelemetry
|OTLP ingest
|<nowiki>+</nowiki>
|—
|-
|Real User Monitoring
|Beacon forwarder
|<nowiki>+</nowiki>
|—
|}

=== Функциональность АктивныхШлюзов для синтетического мониторинга из частных локаций. ===
{| class="wikitable"
|'''Функциональность'''
|'''Имя модуля'''
|'''Поддерживается при развертывании АктивногоШлюза <code>на хосте</code>'''
|'''Поддерживается при развертывании АктивногоШлюза <code>в контейнере</code>'''
|-
|Выполнение частных HTTP-мониторов
|Synthetic
|<nowiki>+</nowiki>
|—
|-
|Выполнение приватных браузерных мониторов
|Synthetic
|<nowiki>+</nowiki>
|—
|}

=== Функциональность АктивныхШлюзов с модулем zRemote ===
{| class="wikitable"
|'''Функциональность'''
|'''Имя модуля'''
|'''Поддерживается при развертывании АктивногоШлюза <code>на хосте</code>'''
|'''Поддерживается при развертывании АктивногоШлюза <code>в контейнере</code>'''
|-
|Установка модуля zRemote для мониторинга z/OS.
|zRemote
|<nowiki>+</nowiki>
|—
|}

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

2022-09-27T09:39:57Z

RGolovanov: Новая страница: «АктивныеШлюзы можно использовать для трех различных вариантов использования, которые м...»

АктивныеШлюзы можно использовать для трех различных вариантов использования, которые мы называем '''целями''':

* [https://doc.ruscomtech.ru/index.php/%D0%9D%D0%B0%D0%BF%D1%80%D0%B0%D0%B2%D0%BB%D0%B5%D0%BD%D0%B8%D0%B5%20%D1%82%D1%80%D0%B0%D1%84%D0%B8%D0%BA%D0%B0%20%D0%95%D0%B4%D0%B8%D0%BD%D0%BE%D0%B3%D0%BE%D0%90%D0%B3%D0%B5%D0%BD%D1%82%D0%B0 Направление трафика ЕдиныхАгентов в Ключ-Астром, отслеживание облачных сред или отслеживание удалённых технологий с помощью расширений].
* [https://doc.ruscomtech.ru/index.php/%D0%97%D0%B0%D0%BF%D1%83%D1%81%D0%BA%20%D1%81%D0%B8%D0%BD%D1%82%D0%B5%D1%82%D0%B8%D1%87%D0%B5%D1%81%D0%BA%D0%B8%D1%85%20%D0%BC%D0%BE%D0%BD%D0%B8%D1%82%D0%BE%D1%80%D0%BE%D0%B2%20%D0%B8%D0%B7%20%D1%87%D0%B0%D1%81%D1%82%D0%BD%D1%8B%D1%85%20%D0%BB%D0%BE%D0%BA%D0%B0%D1%86%D0%B8%D0%B9. Запуск синтетических мониторов из частных локаций.]
* [https://doc.ruscomtech.ru/index.php/%D0%A3%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BA%D0%B0%20%D0%BC%D0%BE%D0%B4%D1%83%D0%BB%D1%8F%20zRemote%20%D0%B4%D0%BB%D1%8F%20%D0%BC%D0%BE%D0%BD%D0%B8%D1%82%D0%BE%D1%80%D0%B8%D0%BD%D0%B3%D0%B0%20z/OS. Установка модуля zRemote для мониторинга z/OS.]

Каждая цель поставляется с различным подмножеством функциональных модулей. Модули не должны смешиваться между целями — такая реконфигурация не поддерживается.

=== Функциональность АктивныхШлюзов для мониторинга маршрутизации ===
{| class="wikitable"
|'''Функциональность'''
|'''Имя модуля'''
|'''Поддерживается при развертывании АктивногоШлюза <code>на хосте</code>'''
|'''Поддерживается при развертывании АктивногоШлюза <code>в контейнере</code>'''
|-
|Маршрутизация сообщений
|Маршрутизация ЕдиныхАгентов
|<nowiki>+</nowiki>
|<nowiki>+</nowiki>
|-
|Буферизация и сжатие
|Маршрутизация ЕдиныхАгентов
|<nowiki>+</nowiki>
|<nowiki>+</nowiki>
|-
|Аутентификация
|Маршрутизация ЕдиныхАгентов
|<nowiki>+</nowiki>
|<nowiki>+</nowiki>
|-
|Доступ к закрытым сетям
|Маршрутизация ЕдиныхАгентов
|<nowiki>+</nowiki>
|<nowiki>+</nowiki>
|-
|Дампы памяти
|Дампы памяти
|<nowiki>+</nowiki>
|—
|-
|AWS-мониторинг
|AWS
|<nowiki>+</nowiki>
|—
|-
|Мониторинг Cloud Foundry
|Cloud Foundry
|<nowiki>+</nowiki>
|—
|-
|Мониторинг Kubernetes/OpenShift
|Kubernetes
|<nowiki>+</nowiki>
|<nowiki>+</nowiki>
|-
|Мониторинг Azure
|Azure
|<nowiki>+</nowiki>
|—
|-
|Мониторинг с помощью расширения АктивногоШлюза
|Расширения 1.0, Расширения 2.0
|<nowiki>+</nowiki>
|—
|-
|Информация о базе данных Oracle
|Анализ базы данных
|<nowiki>+</nowiki>
|—
|-
|Мониторинг виртуализированной инфраструктуры
|VMware
|<nowiki>+</nowiki>
|—
|-
|API Ключ-Астром
|REST API
|<nowiki>+</nowiki>
|—
|-
|Мониторинг Логов
|Мониторинг Логов
|<nowiki>+</nowiki>
|—
|-
|Прием метрик
|API HTTP-Метрики
|<nowiki>+</nowiki>
|—
|-
|Прием трассировки OpenTelemetry
|OTLP ingest
|<nowiki>+</nowiki>
|—
|-
|Real User Monitoring
|Beacon forwarder
|<nowiki>+</nowiki>
|—
|}

=== Функциональность АктивныхШлюзов для синтетического мониторинга из частных локаций. ===
{| class="wikitable"
|'''Функциональность'''
|'''Имя модуля'''
|'''Поддерживается при развертывании АктивногоШлюза <code>на хосте</code>'''
|'''Поддерживается при развертывании АктивногоШлюза <code>в контейнере</code>'''
|-
|Выполнение частных HTTP-мониторов
|Synthetic
|<nowiki>+</nowiki>
|—
|-
|Выполнение приватных браузерных мониторов
|Synthetic
|<nowiki>+</nowiki>
|—
|}

=== Функциональность АктивныхШлюзов с модулем zRemote ===
{| class="wikitable"
|'''Функциональность'''
|'''Имя модуля'''
|'''Поддерживается при развертывании АктивногоШлюза <code>на хосте</code>'''
|'''Поддерживается при развертывании АктивногоШлюза <code>в контейнере</code>'''
|-
|Установка модуля zRemote для мониторинга z/OS.
|zRemote
|<nowiki>+</nowiki>
|—
|}

Файл:СхемаАктивныхШлюзов.png

2022-09-27T09:17:17Z

RGolovanov:

СхемаАктивныхШлюзов

Планирование сетевых зон (установка)

2022-09-26T18:14:04Z

RGolovanov: Новая страница: «По завершении анализа переходите к следующему шагу — планированию сетевых зон. На этап...»

По завершении анализа переходите к следующему шагу — планированию сетевых зон.

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

Планирование сетевых зон (миграция)

2022-09-26T18:13:34Z

RGolovanov:

По завершении анализа переходите к следующему шагу — планированию сетевых зон.

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

Проверка развертывания сетевых зон (установка)

2022-09-26T18:12:39Z

RGolovanov: Новая страница: «По завершении развертывания убедитесь, что соединения работают должным образом, провер...»

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

* <code>SaaS</code> Используйте вызовы сетевых зон из API Окружений.
* <code>Managed</code> Используйте вызовы сетевых зон из API Кластера.

Проверка развертывания сетевых зон (миграция)

2022-09-26T18:12:29Z