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

2025-06-24T23:57:20Z

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

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

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

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

Конфигурация мониторинга — это полезная нагрузка '''JSON''', определяющая детали соединения, учетные данные и наборы функций, которые вы хотите отслеживать.

Пример полезной нагрузки для активации расширения '''Oracle SQL''':
{| class="wikitable"
|[

{

"value": {

"enabled": true,

"description": "My Oracle SQL extension",

"version": "0.1.1",

"featureSets": [

"io",

"cpu",

],

"sqlOracleRemote": {

"licenseAccepted": true,

"endpoints": [

{

"host": "sqlserver.org",

"port": 1521,

"databaseIdentifier": "serviceName",

"authentication": {

"scheme": "basic",

"username": "admin",

"password": "password"

},

"serviceName": "some-serviceName"

"ssl": false

}

]

}

},

"scope": "ag_group-default"

}

]
|}
Когда у вас будет готово начальное расширение '''YAML''', упакуйте его, подпишите и загрузите в среду Ключ-АСТРОМ. Подробности см. в разделе [[Жизненный цикл расширений 2.0|Управление жизненным циклом расширения]].

Мастер активации расширения на базе Ключ-АСТРОМ содержит динамически обновляемую полезную нагрузку '''JSON''' с вашей конфигурацией мониторинга.

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

Используйте конечную точку схемы расширения '''GET'''.

Отправьте следующий запрос:
{| class="wikitable"
|curl -X GET "{env-id}.live.astromkey.com/api/v2/extensions/{extension-name}/{extension-version}/schema" \

-H "accept: application/json; charset=utf-8" \

-H "Authorization: Api-Token {api-token}"
|}
Обязательно замените <code>{extension-name}</code> и <code>{extension-version}</code>значениями из вашего файла расширения '''YAML'''. Успешный вызов возвращает схему '''JSON'''.

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

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

При определении группы АктивногоШлюза используйте следующий формат:
{| class="wikitable"
|"scope": "ag_group-<ActiveGate-group-name>",
|}
Замените <code><ActiveGate-group-name></code> фактическим именем.

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

== Описание ==
Понятное для человека описание особенностей данной конфигурации мониторинга.

== Включено ==
Если установлено значение <code>true</code>, конфигурация активируется, и Ключ-АСТРОМ немедленно начинает мониторинг.

== Конечные точки ==
В одной конфигурации мониторинга в разделе можно определить до '''20 000''' конечных точек <code>SQLOracleRemote</code>.
{| class="wikitable"
|"sqlOracleRemote": {

"licenseAccepted": true,

"endpoints": [

{

"host": "sqlserver.org",

"port": 1521,

"databaseIdentifier": "serviceName",

"authentication": {

"scheme": "basic",

"username": "admin",

"password": "password"

},

"serviceName": "some-serviceName"

"ssl": false

}

]

}

}
|}

=== Драйвер Oracle JDBC ===
Источник данных '''Oracle SQL''' требует драйвер '''Oracle JDBC''', распространяемый Ключ-АСТРОМ. Устанавливая свойство <code>licenceAccepted</code> в <code>true</code>, вы указываете, что прочитали и приняли лицензионное соглашение Ключ-АСТРОМ по распространению '''Oracle JDBC Driver'''.

Чтобы определить сервер базы данных '''Oracle''', добавьте в раздел следующие данные <code>endpoints</code>:

* Хост
* Пор
* Идентификатор базы данных, <code>serviceName</code> либо <code>sid</code>.
* Учетные данные аутентификации

Версия драйвера '''Oracle JDBC''', поставляемая с фреймворком Расширения, — <code>ojdbc11</code>.

== Аутентификация ==
Данные аутентификации, передаваемые в '''API''' Ключ-АСТРОМ при активации конфигурации мониторинга, запутываются, и их невозможно получить.

=== Хранилище учетных данных ===
Тип аутентификации хранилища учетных данных обеспечивает более безопасный подход к использованию расширений путем безопасного хранения и управления учетными данными пользователя. Чтобы использовать это, вы должны быть владельцем учетных данных и иметь хранилище учетных данных, которое соответствует следующим критериям:

* Тип учетных данных — Пользователь и пароль
* Область действия учетных данных — включены синтетические (в случае использования внешнего хранилища) и области аутентификации расширения.
* Доступ владельца разрешен только для владельцев учетных данных.

{| class="wikitable"
|"authentication": {

"scheme": "basic",

"useCredentialVault": true,

"credentialVaultId": "some-credential-vault-id"

}
|}

== Наборы функций ==
Добавьте список наборов функций, которые вы хотите отслеживать. Чтобы сообщить обо всех наборах функций, добавьте <code>all</code>.
{| class="wikitable"
|"featureSets": [

"cpu",

"io"

]
|}

=== <code>topN</code> ===
Набор функций <code>topN</code> позволяет осуществлять мониторинг наиболее ресурсоемких запросов. Включено по умолчанию.
{| class="wikitable"
|"featureSets": [

"topN"

]
|}
Это группирует '''topN''' запросов по сущности. Запросы отображаются на странице событий и на странице унифицированного анализа для сущности сервера '''Oracle'''.

=== <code>multitenancy</code> ===
Набор функций <code>multitenancy</code> расширяет возможности мониторинга путем запроса и извлечения информации о контейнерных базах данных ('''CDB'''), подключаемых базах данных ('''PDB''') и службах, связанных с указанной базой данных в конфигурации мониторинга.
{| class="wikitable"
|"featureSets": [

"multitenancy"

]
|}

'''Пример навигации'''

Для навигации по структуре сущностей '''Oracle'''

# Перейдите в раздел '''Дашборды''' и откройте панель мониторинга '''Oracle Database Overview'''.
# В разделе '''Хосты''' на панели управления выберите хост из столбца '''Хост DB Oracle'''.
# На странице сервера '''DB Oracle''' выберите '''CDB'''.
# На странице '''CDB''' выберите подключаемую базу данных.
# На странице '''PDB''' перечислены услуги.

== Время ожидания тяжелого запроса ==
'''АктивныйШлюз версии 1.275+'''

Добавьте параметр <code>long-running-query-timeout</code> для настройки продолжительности тайм-аута для длительных '''SQL'''-запросов. Этот параметр необязателен, и если он не установлен, применяется тайм-аут по умолчанию в '''10 секунд'''.
{| class="wikitable"
|"vars": {

"long-running-query-timeout": null

}
|}

== SSL ==
'''АктивныйШлюз версии 1.251+'''

Включите '''SSL''', чтобы заставить источник данных проверить сертификат сервера и использовать шифрование '''SSL''' вместо собственного шифрования.
{| class="wikitable"
|"ssl": true
|}

==== Включить SSL без локального хранилища доверенных сертификатов ====
Когда SSL включен и цепочка сертификатов сервера публично проверяема (например, выпущена '''Azure''' или другими известными '''CA'''), нет необходимости вручную создавать '''truststore'''. Система автоматически будет доверять сертификату сервера на основе доверенных '''CA''' в среде.

Однако если вам необходимо использовать локальное хранилище доверенных сертификатов для сертификатов, не признанных во всем мире, или для дополнительных мер безопасности

# В директории АктивныхШлюзов <code>userdata</code>, где запущен источник данных '''SQL''', вручную создайте доверенное хранилище '''PKCS12''' с именем <code>sqlds_truststore</code> и паролем <code>sqlds_truststore</code>. Команда для создания хранилища доверенных сертификатов с помощью '''keytool''': <code>keytool -genkey -keystore sqlds_truststore -storepass sqlds_truststore -keyalg DSA</code>
#* Расположение директории <code>userdata</code>:
#** Windows : <code>%PROGRAMDATA%\astromkey\remotepluginmodule\agent\conf\userdata</code>
#** Unix : <code>/var/lib/astromkey/remotepluginmodule/agent/conf/userdata</code>
# Добавьте к нему сертификат сервера. Команда для импорта сертификата с помощью keytool: <code>keytool -import -keystore sqlds_truststore -file .\ora.crt -alias oracle</code>

==== Проверка SSL-сертификатов ====
'''АктивныйШлюз версии 1.269+'''

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

Включите эту опцию при подключении к базам данных с использованием пользовательских сертификатов.
{| class="wikitable"
|"validateCertificates": true
|}

== Потребление ресурсов ==
Потребление ресурсов зависит от количества конечных точек '''Oracle'''. Первая конечная точка потребляет '''110 МБ ОЗУ''' и '''0,1%–0,5% ЦП'''. Каждая последующая конечная точка потребляет '''0,5–1,0 МБ ОЗУ''' и '''~0,01% ЦП'''.
{| class="wikitable"
!Endpoints
!Average CPU
!Max CPU
!RAM (MB)
!Host (EC2 instance type)
|-
|100
|0.6%
|0.6% (spike at beginning)
|160
|XS (<code>c5.large</code>)
|-
|1
|0.1%
|0.5% (spike at beginning)
|110
|XS (<code>c5.large</code>)
|}

Конфигурация Oracle Database - История изменений

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