Dynatrace - Вклад [ru]

Развёртка OneAgent на IBM Cloud Foundry для мониторинга только приложений

2023-04-06T15:15:38Z

Lobanov: Новая страница: «Приложения, развернутые в Cloud Foundry, обычно запускаются с помощью пакетов сборки для конкр...»

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

Примечание. При развертывании в режиме только для приложений OneAgent отслеживает память, диск, ЦП и сетевые процессы только внутри контейнера. Показатели хоста не отслеживаются.

=== Предварительные требования ===
Создайте токен PaaS.

Просмотрите поддерживаемые приложения и версии.

=== Развернуть OneAgent ===

==== 1. Создайте службу Dynatrace в своей среде IBM Cloud Foundry. ====
Существует два способа определения экземпляра службы, выберите один из них:

===== Вариант 1. Создайте предоставляемую пользователем услугу =====
Создайте один экземпляр службы для Dynatrace с именем dynatrace в качестве подстроки, как в примере ниже. Затем вам будет предложено ввести идентификатор среды и токен API. Токен API соответствует упомянутому выше токену.

Dynatrace SaaS
cf cups dynatrace-service -p "environmentid, apitoken"
Dynatrace Managed
cf cups dynatrace-service -p "environmentid, apitoken, apiurl"
Параметр apiurl указывает конечную точку API вашего кластера Dynatrace и должен иметь значение https://<YourDynatraceClusterURL>/e/<environmentID>/api.

===== Вариант 2. Создайте экземпляр службы через брокера служб. =====
Если вы хотите хранить учетные данные Dynatrace централизованно, используйте брокера услуг. Для получения подробной информации посетите GitHub. Вам необходимо настроить и запустить брокер как приложение, добавить сервис-брокер в Cloud Foundry, разрешить доступ к сервису для пользователей и, наконец, создать экземпляр сервиса.

==== 2. Привяжите службу Dynatrace к своему приложению. ====
Вы можете привязать созданный сервис Dynatrace к своему приложению в файле manifest.yml. Если ваше приложение уже запущено, вам необходимо повторно разместить его.

В случае приложения Java, если вы выполняете развертывание в IBM Cloud Foundry, обязательно примите лицензии IBM, установив соответствующие переменные среды. Подробнее см. в файле readme пакета сборки.
---
applications:
- name: demo-helloworld
path: target/JavaHelloWorldApp.war
buildpack: <nowiki>https://github.com/cloudfoundry/ibm-websphere-liberty-buildpack.git</nowiki>
memory: 512M
instances: 1
host: hello-world-${random-word}
disk_quota: 1024M
services:
- dynatrace-service
env:
IBM_LIBERTY_LICENSE: <liberty-license-key>
IBM_JVM_LICENSE: <jvm-license-key>

==== 3. (необязательно) Настройте поток журналов OneAgent по умолчанию для Cloud Foundry. ====
По умолчанию журналы OneAgent записываются в стандартный поток ошибок Cloud Foundry. Все, что вам нужно сделать, это установить для переменной среды DT_LOGSTREAM значение stdout или stderr.
cf set-env APP_NAME DT_LOGSTREAM stdout

==== 4. (необязательно) Настройте адрес прокси. ====
Если в вашей среде используется прокси-сервер, вам необходимо установить переменную среды DT_PROXY для передачи учетных данных прокси-сервера в OneAgent, как показано ниже.
cf set-env <application> DT_PROXY <proxy address>

==== 5. (необязательно) Настройте сетевые зоны. ====
Вы можете настроить сетевые зоны двумя способами.

* Через <code>UserProvidedService</code>:

cf cups dynatrace-service -p "environmentid, apitoken, networkzone"

* В качестве переменной среды для каждого приложения:

cf set-env <application> DT_NETWORK_ZONE <your_network_zone>
Дополнительные сведения см. в разделе «Сетевые зоны».

Подключение своих кластеров Kubernetes/OpenShift к Ключ-АСТРОМ

2023-04-06T14:39:41Z

Lobanov:

Dynatrace версии 1.232+

== Предпосылки ==

# Настройте оператора Dynatrace.
# Установите значения АктивныйШлюз конфигурационного файла AstromkeyKube в соответствии со списком параметров . Примечание: Чтобы включить АктивныйШлюз, в <code>АктивныйШлюз</code>разделе добавьте <code>routing</code>и/или <code>kubernetes-monitoring</code>в <code>capabilities</code>. Пример:

<code>АктивныйШлюз:</code>

<code>capabilities:</code>

<code>- routing</code>

<code>- kubernetes-monitoring</code>

<code>...</code>

== Подключите свои кластеры и включите мониторинг ==
У вас есть два варианта:

* Подключите контейнерный АктивныйШлюз к локальной конечной точке API Kubernetes.
* Подключите контейнерный АктивныйШлюз к общедоступному URL-адресу API Kubernetes.

Инструкции для обоих вариантов см. ниже.

=== Подключитесь к локальной конечной точке API Kubernetes. ===
АктивныйШлюз версии 1.229+

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

* Dynatrace Operator версии 0.4+: Dynatrace Operator автоматически обрабатывает подключение к локальной конечной точке API Kubernetes.
* Версии Dynatrace Operator до v0.4.0: необходимо настроить подключение вручную .

Подробнее об обоих методах см. ниже.

Оператор Dynatrace версии 0.4.0+

Автоматическое подключение к локальной конечной точке API Kubernetes

# Помимо предварительных условий, необходимых для настройки мониторинга , обязательно включите разрешения на чтение объектов , чтение параметров и запись параметров (API v2) для вашего токена API.
# Убедитесь, что эта <code>kubernetes-monitoring</code>возможность включена в вашем пользовательском ресурсе AstromkeyKube.
# Добавьте следующую аннотацию (см. пример ниже).

<code>apiVersion: ruscomtech.ru/v1beta1
kind: AstromkeyKube
metadata:
name: astromkeykube
namespace: astromkey
annotations:
feature.ruscomtech.ru/automatic-kubernetes-api-monitoring: "true"
spec:
...
АктивныйШлюз:
capabilities:
- kubernetes-monitoring</code>
Примечание. После добавления этой аннотации имя кластера, отображаемое в Dynatrace, будет таким же, как и у пользовательского ресурса AstromkeyKube, для которого настроена аннотация. Начиная с Dynatrace Operator версии 0.7.0, вы можете изменить имя кластера, отображаемое в Dynatrace, также добавив <code>feature.ruscomtech.ru/automatic-kubernetes-api-monitoring-cluster-name: "custom-cluster-name"</code>аннотацию. Обязательно замените <code>"custom-cluster-name"</code>на желаемое имя кластера.

Пример:
<code>apiVersion: ruscomtech.ru/v1beta1
kind: AstromkeyKube
metadata:
name: AstromkeyKube
namespace: astromkey
annotations:
feature.ruscomtech.ru/automatic-kubernetes-api-monitoring: "true"
feature.ruscomtech.ru/automatic-kubernetes-api-monitoring-cluster-name: "custom-cluster-name"
spec:
...
АктивныйШлюз:
capabilities:
- kubernetes-monitoring</code>

# Примените свою конфигурацию.

Примечание. Чтобы отключить конфигурацию, удалите аннотацию.

=== Подключитесь к общедоступному API Kubernetes. ===
Чтобы подключиться к общедоступному API Kubernetes

# Получите URL-адрес API Kubernetes.

<code>kubectl config view --minify -o jsonpath='{.clusters[0].cluster.server}'</code>
Примечание. Если <code>enableIstio</code>в пользовательском ресурсе AstromkeyKube<code>true</code> установлено значение , используйте приведенную ниже команду, чтобы получить URL-адрес Kubernetes API:

<code>kubectl -n default get svc/kubernetes -o jsonpath='<nowiki>https://{.spec.clusterIP}'</nowiki></code>

2. Получите жетон носителя.
<code>kubectl get secret $(kubectl get sa astromkey-kubernetes-monitoring -o jsonpath='{.secrets[0].name}' -n astromkey) -o jsonpath='{.data.token}' -n astromkey | base64 --decode</code>
''Специальные инструкции для дистрибутивов Rancher для получения URL-адреса API и токена носителя''

Для дистрибутивов Rancher Kubernetes необходимо использовать токен носителя и URL -адрес API сервера Rancher , поскольку этот сервер управляет и защищает трафик к серверу API Kubernetes. Следуйте инструкциям ниже.

* Получите URL API Kubernetes .

<code>kubectl config view --minify -o jsonpath='{.clusters[0].cluster.server</code>

* Настройте пользователя.

В веб-интерфейсе Rancher либо создайте нового пользователя, либо используйте существующего пользователя для связи с токеном. Мы рекомендуем создать нового пользователя.

* Установите разрешения.

Убедитесь, что у пользователя есть права владельца или пользователя для кластера, который вы хотите отслеживать.

Рекомендуется: выберите «Пользовательские разрешения» и обязательно выберите эти две роли: «Просмотр всех проектов» и «Просмотр узлов » .

* Создайте ключ API.

Перейдите в API & Keys и создайте ключ либо для вашей конкретной учетной записи (введите имя кластера), либо для всех кластеров (введите No scope ). Из соображений безопасности мы рекомендуем выбрать первый вариант.

Примечание. Вновь созданные ключи отображают четыре поля. Обязательно используйте содержимое поля Bearer token для настройки подключения к API Kubernetes, описанного в следующем разделе.

3. В меню Dynatrace перейдите в Kubernetes и выберите Подключиться вручную .

4. На странице настроек мониторинга кластера Kubernetes укажите Имя , URL-адрес API Kubernetes и токен носителя для кластера Kubernetes.

Примечание. Для дистрибутивов Rancher вам потребуется токен носителя, созданный в веб-интерфейсе Rancher, как описано в разделе Специальные инструкции для дистрибутивов Rancher, чтобы получить URL-адрес API и токен носителя выше.

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

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

Развёртка OneAgent на Pivotal Web Services для мониторинга только приложений

2023-01-23T11:15:11Z

Lobanov:

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

Примечание. При развертывании в режиме только для приложений OneAgent отслеживает память, диск, ЦП и сетевые процессы только внутри контейнера. Показатели хоста не отслеживаются.

== Предпосылки ==

* Создайте токен PaaS .
* Просмотрите Поддерживаемые приложения и версии .

== Развернуть OneAgent ==

# Создайте службу Dynatrace в своей среде Cloud Foundry. Существует три способа определения экземпляра службы, выберите один из них: Вариант 1. Создайте предоставляемую пользователем услугу Создайте один экземпляр службы для Dynatrace с именем dynatrace в виде подстроки (например, dynatrace<code>-service</code>), используя приведенную ниже команду. Команда должна включать параметры <code>environmentid</code>и быть <code>apitoken</code>написана точно так, как показано ниже. После выполнения команды вам будет предложено ввести идентификатор среды и токен API. Токен API соответствует упомянутому выше токену PaaS. В приведенных ниже примерах кода используется <code>cf</code>интерфейс командной строки для взаимодействия с кластерами Cloud Foundry.

Dynatrace SaaS:

<code>cf cups dynatrace-service -p "environmentid, apitoken"</code>

Ключ -АСТРОМ Managed:
<code>cf cups dynatrace-service -p "environmentid, apitoken, apiurl"</code>
Параметр <code>apiurl</code>указывает конечную точку API вашего сервера Dynatrace и должен быть установлен на <code>https://<YourDynatraceServerURL>/e/<environmentID>/api</code>.

Вариант 2. Создайте экземпляр службы через брокера служб.

Если вы хотите хранить учетные данные Dynatrace централизованно, используйте брокера услуг. Для получения полной информации посетите GitHub . Вы должны настроить и запустить брокер как приложение, добавить сервис-брокер в Cloud Foundry, разрешить доступ к сервису для пользователей и, наконец, создать экземпляр сервиса.

Вариант 3. Создайте экземпляр службы через брокера служб в сети VMware Tanzu.

Если вы используете среду платформы VMware Tanzu, вы можете использовать плитку Dynatrace Service Broker в сети VMware Tanzu .

2. Привяжите сервис Dynatrace к вашему приложению

Вы можете привязать созданный сервис Dynatrace к вашему приложению в вашем <code>manifest.yml</code>файле. Если ваше приложение уже запущено, вам необходимо повторно разместить его.

См. приведенный ниже пример отправки приложения Java.

<code>---</code>

<code>applications:</code>

<code>- name: spring-music</code>

<code>memory: 768M</code>

<code>instances: 1</code>

<code>host: spring-music-${random-word}</code>

<code>path: spring-music.war</code>

<code>buildpack: <nowiki>https://github.com/cloudfoundry/java-buildpack.git</nowiki></code>

<code>services:</code>

<code>- dynatrace-service</code>

по желаниюНастройте поток журналов OneAgent по умолчанию для Cloud Foundry.

По умолчанию журналы OneAgent записываются в стандартный поток ошибок Cloud Foundry. Все, что вам нужно сделать, это установить переменную среды <code>DT_LOGSTREAM</code>в значение <code>stdout</code>или <code>stderr</code>.

Например:

<code>cf set-env APP_NAME DT_LOGSTREAM stdout</code>

по желаниюНастройте прокси-адрес.

Если в вашей среде используется прокси-сервер, вам необходимо установить <code>DT_PROXY</code>переменную среды для передачи учетных данных прокси-сервера в OneAgent, как показано ниже.

<code>cf set-env <application> DT_PROXY <proxy address></code>

по желаниюНастройте сетевые зоны.

Вы можете настроить сетевые зоны двумя способами.

* Через <code>UserProvidedService</code>:

<code>cf cups dynatrace-service -p "environmentid, apitoken, networkzone"</code>

* В качестве переменной среды для каждого приложения:

<code>cf set-env <application> DT_NETWORK_ZONE <your_network_zone></code>

Дополнительные сведения см. в разделе « Сетевые зоны» .

Развёртка ЕдиногоАгента на Pivotal Web Services для мониторинга только приложений

2023-01-23T11:13:20Z

Lobanov: Lobanov переименовал страницу Развёртка ЕдиногоАгента на Pivotal Web Services для мониторинга только приложений в Развёртка OneAgent на Pivotal Web Services для мониторинга только приложений

#перенаправление [[Развёртка OneAgent на Pivotal Web Services для мониторинга только приложений]]

2023-01-22T12:08:36Z

Lobanov: Lobanov переименовал страницу Устранение неполадок глубокого мониторинга ЕдиногоАгента в Устранение неполадок глубокого мониторинга OneAgent

#перенаправление [[Устранение неполадок глубокого мониторинга OneAgent]]

Устранение неполадок глубокого мониторинга OneAgent

2023-01-22T12:08:36Z

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

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

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

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

=== Параметры окружения ===
Чтобы включить или отключить функцию для всей среды

1. В меню Ключ-Астром перейдите в '''Настройки'''.

2. Выберите '''Настройки''' > '''Функции ЕдиногоАгента'''.

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

4. Разверните запись до:

* <code>необязательно</code> Просмотрите описание функции
* <code>необязательно</code> Метаданные обзора
* <code>необязательно</code> Перейдите по ссылке на соответствующие примечания к выпуску

5. При необходимости измените параметр '''Включено'''.

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

* '''Активируйте эту функцию также в ЕдиномАгенте, выполнив только минимальную версию Opt-In'''.
** Этот параметр активирует функцию с минимальной версией подписки при первом выпуске. Обычно вы можете активировать функцию, если она соответствует минимальной версии ЕдиногоАгента, но некоторые из них сначала выпускаются как дополнительные функции с минимальной версией. Это полезно, когда общая доступность (GA) функции ЕдиногоАгента больше, чем минимальная версия подписки. Если вы уже включили эту функцию во время подписки, вы по-прежнему можете использовать ЕдиныйАгент без обновления до новой версии GA.
* '''Инструментарий включен'''
** Эта настройка имеет немедленный эффект. Однако при перезапуске/запуске процесса функция не будет добавлена в ваше приложение. Это означает, что эта функция не повлияет на ваше приложение. Недостатком является то, что если вы снова включите эту функцию позже, вам нужно будет перезапустить затронутые процессы.

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

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

1. В меню Ключ-Астром перейдите к '''топологии Smartscape'''.

2. Выберите '''Процессы'''.

3. На карте топологии наведите указатель мыши на процесс и выберите значок ссылки, чтобы перейти на страницу сведений о процессе. Например:

4. На странице сведений о процессе выберите '''Дополнительно''' (…) > '''Настройки''', а затем перейдите на вкладку '''Особенности ЕдиногоАгента'''.

5. Выберите '''Добавить переопределение''', чтобы добавить параметр для конкретного процесса, который переопределяет параметр среды.

6. Введите строку поиска в поле '''Функция''', чтобы найти и выбрать функцию.

7. Установите необходимые переключатели для переопределения, а затем выберите '''Сохранить изменения'''.

Dynatrace OneAgent

2023-01-22T11:58:02Z

Lobanov: /* Оркестрация развертывания OneAgent */

OneAgent отвечает за сбор всех данных мониторинга в отслеживаемой среде. Для сбора всех необходимых данных мониторинга требуется один OneAgent для каждого хоста, даже если ваши хосты развернуты в контейнерах Docker, архитектурах микросервисов или облачной инфраструктуре.

Один экземпляр OneAgent может выполнять мониторинг всех типов объектов, включая серверы, приложения, службы, базы данных и многое другое. OneAgent предоставляет вам все необходимые показатели операционной и бизнес-производительности, от внешнего интерфейса до серверной части и всего, что между ними - облачные экземпляры, хосты, состояние сети, процессы и службы. OneAgent обнаруживает все процессы, запущенные на ваших хостах. На основании того, что он находит, OneAgent автоматически активирует инструментарий специально для вашего уникального стека приложений. Он также внедряет все теги, необходимые для мониторинга взаимодействия с пользователем, в HTML-код страниц вашего приложения. Новые компоненты автоматически настраиваются на лету.

OneAgent состоит из нескольких модулей кода, которые позволяют ему сразу же работать с большинством технологий. Чтобы узнать, какие модули кода поддерживаются для каждой платформы, см. Платформу OneAgent и матрицу поддержки возможностей. Чтобы узнать, какие версии поддерживаются для каждого модуля кода, см. OneAgent [[Поддержка_технологий|Поддерживаемые технологии и версии]].

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

* [[OneAgent требования к памяти]]

== Возможности ==

* [[OneAgent возможности мониторинга]]
* [[Как работает OneAgent]]

== Установка и эксплуатация ==

* Облачные платформы
** AWS
** Azure
** Google Cloud Platform
** VMware
** Heroku
* Контейнерные платформы
** Kubernetes
** OpenShift
** Cloud Foundry
** Docker
** Mesos
* Операционные системы
** AIX
** [[OneAgent в Linux|Linux]]
** Solaris
** [[OneAgent в Windows|Windows]]
** zOS

== Оркестрация развертывания OneAgent ==
Вы можете развернуть OneAgent в нужном масштабе, используя предоставленные Dynatrace сценарии оркестровки. В настоящее время Dynatrace предоставляет вам коллекцию Ansible. Мы работаем над поддержкой нескольких технологий оркестровки, но вы можете помочь нам расставить приоритеты. Выберите «Я использую другой тип сценария» на странице «Установка OneAgent», чтобы отправить отзыв.

* [[Установка OneAgent с помощью Ansible|Ansible]]
* [[Установка OneAgent с помощью Puppet|Puppet]]

== Смотрите также ==

* [[Адаптивное управление и контроль трафика]]
* [[Обновление OneAgent]]
* [[Механизм устаревания файлов OneAgent]]

== Исправление проблем ==

* [[Устранение неполадок глубокого мониторинга ЕдиногоАгента|Устранение неполадок глубокого мониторинга OneAgent]]
* [[Устранение сбоев в мониторинге]]
* [[Устранение неполадок при установке ЕдиногоАгента|Устранение неполадок при установке OneAgent]]
* [[Диагностика ЕдиногоАгента|Диагностика OneAgent]]

Механизм устаревания файлов OneAgent

2023-01-22T11:57:38Z

Lobanov:

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

* Минимальное необходимое пространство: 200 МБ * 3 = 600 МБ (журналы, оповещения, отчеты о сбоях).
* Требуемое пространство по умолчанию: 1 ГБ * 3 = 3 ГБ (журналы, оповещения, отчеты о сбоях).

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

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

== Данные времени выполнения ==
В отличие от файлов журналов, большие файлы данных времени выполнения, такие как сбои и дампы памяти, генерируются спонтанно и могут вызывать резкие скачки использования диска. Чтобы избежать этого, используйте параметр установки <code>DATA_STORAGE</code>, чтобы указать пользовательский каталог для больших данных времени выполнения. Найдите настраиваемый каталог на ресурсе, где ограничения по размеру диска не так критичны, как на диске, на котором установлен OneAgent.

Дополнительные сведения о настройке установки OneAgent см. в справке для конкретной ОС: [[ЕдиныйАгент настройка параметров установки в Linux|Linux]], [[Настройка установки ЕдиногоАгента в Windows|Windows]] или AIX.

== Аварийная уборка ==
В экстренной ситуации, когда свободное место на диске достигает порога <code>3%</code>, OneAgent удаляет все файлы из каталогов, управляемых механизмом устаревания, за исключением последних журналов установщика и журнала модуля ОС OneAgent.

== OneAgent Правила механизма устаревания ==
Механизм устаревания OneAgent гарантирует, что дисковое пространство, используемое OneAgent, постоянно находится в заданных пределах. Для этого к каталогам OneAgent применяется ряд правил. При необходимости вы можете обратиться в службу поддержки Dynatrace, чтобы изменить некоторые правила устаревания.

=== Каталог журналов ===

* Linux/AIX <code>/var/log/Dynatrace/oneagent</code>
* Windows <code>%PROGRAMDATA%\Dynatrace\oneagent\log</code>

Механизм устаревания файлов проверяет файлы и подкаталоги в основном каталоге журнала и удаляет самые старые файлы, когда:

* Общий размер каталога превышает 1 ГБ.
* Любой файл в этом каталоге старше 14 дней
* Каталог содержит более 1000 файлов (самые новые файлы сохраняются, старые файлы удаляются)

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

* <code>{log-dir}/process</code>
** Файлы удаляются при выполнении любого из следующих условий:
*** Файлы в этом каталоге занимают в общей сложности более 300 МБ.
*** Любой файл в этом каталоге старше 14 дней
*** Содержит более 1000 файлов.
* <code>{log-dir}/installer</code>
** Файлы удаляются при выполнении любого из следующих условий:
*** Файлы в этом каталоге занимают более 30 МБ.
*** Любой файл в этом каталоге старше 180 дней. В Windows файл driver.log сохраняется.
* <code>{log-dir}/dumpproc</code>
** Файлы удаляются при выполнении любого из следующих условий:
*** Файлы в этом каталоге занимают в общей сложности более 100 МБ.
*** Любой файл в этом каталоге старше 14 дней
*** Этот каталог содержит более 1000 файлов (самые новые файлы сохраняются, самые старые файлы удаляются)

=== Каталог хранения данных ===

* Linux/AIX <code>/var/lib/Dynatrace/oneagent/datastorage</code>
* Windows <code>%PROGRAMDATA%\Dynatrace\oneagent\datastorage</code>
* <code>{data_storage_dir}/supportalerts</code>
** Файлы удаляются при выполнении любого из следующих условий:
*** Этот каталог содержит более 10 файлов
*** Файлы в этом каталоге занимают более 1 ГБ.
*** Любой из файлов в этом каталоге старше 7 дней
* <code>{data_storage_dir}/memorydump</code>
** Файлы удаляются при выполнении любого из следующих условий:
*** Любой из файлов в этом каталоге старше 2 часов
*** Файлы в этом каталоге занимают более 20 ГБ.
* <code>{data_storage_dir}/crashreports</code>
** Файлы удаляются при выполнении любого из следующих условий:
*** О них уже сообщили Dynatrace.
*** Этот каталог содержит более 100 файлов
*** Файлы в этом каталоге занимают более 1 ГБ.
*** Любой из файлов в этом каталоге старше 3 дней

=== Каталог среды выполнения ===

* Linux/AIX <code>/var/lib/Dynatrace/onagent/agent/runtime</code>
* Windows <code>%PROGRAMDATA%\Dynatrace\oneagent\agent\runtime</code>
* Механизм устаревания файлов OneAgent проверяет подкаталоги, начинающиеся с <code>0x</code>. Проверки выполняются рекурсивно.
* Если каталог <code>0x*</code> содержит подкаталог дампа и все файлы в нем старше 3 дней, то подкаталог дампа удаляется.
* Если все файлы и каталоги в каталоге <code>0x*</code> старше 7 дней, весь каталог удаляется.
* Этот каталог также полностью очищается во время обновления OneAgent.

=== Каталог установки bin ===

* Linux/AIX <code>/opt/Dynatrace/oneagent/bin</code>
* Windows <code>%PROGRAMFILES%\Dynatrace\oneagent\bin</code>
* <code>{каталог установки}/bin</code>
** OneAgent развертывает ряд файловых артефактов в процессе обновления, особенно в случае внедряемых технологических модулей. Все файлы внедряемых модулей хранятся в версионных папках. Когда OneAgent активен, он выполняет очистку файлов в соответствии со следующими критериями:
*** Текущая используемая версия всегда сохраняется.
*** OneAgent сканирует все отслеживаемые процессы и определяет, какие библиотеки используются.
*** Затем список библиотек сравнивается с тем, что находится в каталоге bin, и все неиспользуемые двоичные файлы из каталогов 32 и 64 битности удаляются. Для двоичных файлов из каталога any механизм устаревания OneAgent сохраняет самые последние 11 версий, включая текущую версию и 10 самых последних предыдущих версий.

== Механизм устаревания для OneAgent в режиме мониторинга только для приложений ==
Если у вас нет доступа к уровню инфраструктуры, Dynatrace также предоставляет возможность мониторинга только приложений для Kubernetes, OpenShift, Pivotal Web Services, IBM Cloud Foundry или SAP Business Technology Platform.

Механизм устаревания в режиме мониторинга только для приложений управляет журналами модулей OneAgent. Все они расположены в соответствующих подкаталогах каталога журналов OneAgent по умолчанию:

* Linux/AIX <code>/var/log/Dynatrace/oneagent</code>
* Windows <code>%PROGRAMDATA%\Dynatrace\oneagent\log</code>

=== Ротация журнала ===
Каждый модуль OneAgent ограничивает количество журналов до 5. Размер каждого из этих 5 файлов ограничен 10 МБ.

=== Старение журнала ===
OneAgent очищает файлы журнала при запуске, когда:

* Файл журнала старше 14 дней
* Общий размер всех файлов журналов превышает 300 МБ.
* Существует более 1000 файлов журналов

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

Механизм устаревания файлов ЕдиногоАгента

2023-01-22T11:56:18Z

Lobanov: Lobanov переименовал страницу Механизм устаревания файлов ЕдиногоАгента в Механизм устаревания файлов OneAgent

#перенаправление [[Механизм устаревания файлов OneAgent]]

Механизм устаревания файлов OneAgent

2023-01-22T11:56:18Z

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

* Минимальное необходимое пространство: 200 МБ * 3 = 600 МБ (журналы, оповещения, отчеты о сбоях).
* Требуемое пространство по умолчанию: 1 ГБ * 3 = 3 ГБ (журналы, оповещения, отчеты о сбоях).

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

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

== Данные времени выполнения ==
В отличие от файлов журналов, большие файлы данных времени выполнения, такие как сбои и дампы памяти, генерируются спонтанно и могут вызывать резкие скачки использования диска. Чтобы избежать этого, используйте параметр установки <code>DATA_STORAGE</code>, чтобы указать пользовательский каталог для больших данных времени выполнения. Найдите настраиваемый каталог на ресурсе, где ограничения по размеру диска не так критичны, как на диске, на котором установлен ЕдиныйАгент.

Дополнительные сведения о настройке установки ЕдиногоАгента см. в справке для конкретной ОС: [[ЕдиныйАгент настройка параметров установки в Linux|Linux]], [[Настройка установки ЕдиногоАгента в Windows|Windows]] или AIX.

== Аварийная уборка ==
В экстренной ситуации, когда свободное место на диске достигает порога <code>3%</code>, ЕдиныйАгент удаляет все файлы из каталогов, управляемых механизмом устаревания, за исключением последних журналов установщика и журнала модуля ОС ЕдиногоАгента.

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

=== Каталог журналов ===

* Linux/AIX <code>/var/log/Dynatrace/oneagent</code>
* Windows <code>%PROGRAMDATA%\Dynatrace\oneagent\log</code>

Механизм устаревания файлов проверяет файлы и подкаталоги в основном каталоге журнала и удаляет самые старые файлы, когда:

* Общий размер каталога превышает 1 ГБ.
* Любой файл в этом каталоге старше 14 дней
* Каталог содержит более 1000 файлов (самые новые файлы сохраняются, старые файлы удаляются)

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

* <code>{log-dir}/process</code>
** Файлы удаляются при выполнении любого из следующих условий:
*** Файлы в этом каталоге занимают в общей сложности более 300 МБ.
*** Любой файл в этом каталоге старше 14 дней
*** Содержит более 1000 файлов.
* <code>{log-dir}/installer</code>
** Файлы удаляются при выполнении любого из следующих условий:
*** Файлы в этом каталоге занимают более 30 МБ.
*** Любой файл в этом каталоге старше 180 дней. В Windows файл driver.log сохраняется.
* <code>{log-dir}/dumpproc</code>
** Файлы удаляются при выполнении любого из следующих условий:
*** Файлы в этом каталоге занимают в общей сложности более 100 МБ.
*** Любой файл в этом каталоге старше 14 дней
*** Этот каталог содержит более 1000 файлов (самые новые файлы сохраняются, самые старые файлы удаляются)

=== Каталог хранения данных ===

* Linux/AIX <code>/var/lib/Dynatrace/oneagent/datastorage</code>
* Windows <code>%PROGRAMDATA%\Dynatrace\oneagent\datastorage</code>
* <code>{data_storage_dir}/supportalerts</code>
** Файлы удаляются при выполнении любого из следующих условий:
*** Этот каталог содержит более 10 файлов
*** Файлы в этом каталоге занимают более 1 ГБ.
*** Любой из файлов в этом каталоге старше 7 дней
* <code>{data_storage_dir}/memorydump</code>
** Файлы удаляются при выполнении любого из следующих условий:
*** Любой из файлов в этом каталоге старше 2 часов
*** Файлы в этом каталоге занимают более 20 ГБ.
* <code>{data_storage_dir}/crashreports</code>
** Файлы удаляются при выполнении любого из следующих условий:
*** О них уже сообщили Ключ-Астром.
*** Этот каталог содержит более 100 файлов
*** Файлы в этом каталоге занимают более 1 ГБ.
*** Любой из файлов в этом каталоге старше 3 дней

=== Каталог среды выполнения ===

* Linux/AIX <code>/var/lib/Dynatrace/onagent/agent/runtime</code>
* Windows <code>%PROGRAMDATA%\Dynatrace\oneagent\agent\runtime</code>
* Механизм устаревания файлов OneAgent проверяет подкаталоги, начинающиеся с <code>0x</code>. Проверки выполняются рекурсивно.
* Если каталог <code>0x*</code> содержит подкаталог дампа и все файлы в нем старше 3 дней, то подкаталог дампа удаляется.
* Если все файлы и каталоги в каталоге <code>0x*</code> старше 7 дней, весь каталог удаляется.
* Этот каталог также полностью очищается во время обновления ЕдиногоАгента .

=== Каталог установки bin ===

* Linux/AIX <code>/opt/Dynatrace/oneagent/bin</code>
* Windows <code>%PROGRAMFILES%\Dynatrace\oneagent\bin</code>
* <code>{каталог установки}/bin</code>
** ЕдиныйАгент развертывает ряд файловых артефактов в процессе обновления, особенно в случае внедряемых технологических модулей. Все файлы внедряемых модулей хранятся в версионных папках. Когда ЕдиныйАгент активен, он выполняет очистку файлов в соответствии со следующими критериями:
*** Текущая используемая версия всегда сохраняется.
*** OneAgent сканирует все отслеживаемые процессы и определяет, какие библиотеки используются.
*** Затем список библиотек сравнивается с тем, что находится в каталоге bin, и все неиспользуемые двоичные файлы из каталогов 32 и 64 битности удаляются. Для двоичных файлов из каталога any механизм устаревания ЕдиногоАгента сохраняет самые последние 11 версий, включая текущую версию и 10 самых последних предыдущих версий.

== Механизм устаревания для ЕдиногоАгента в режиме мониторинга только для приложений ==
Если у вас нет доступа к уровню инфраструктуры, Ключ-Астром также предоставляет возможность мониторинга только приложений для Kubernetes, OpenShift, Pivotal Web Services, IBM Cloud Foundry или SAP Business Technology Platform.

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

* Linux/AIX <code>/var/log/Dynatrace/oneagent</code>
* Windows <code>%PROGRAMDATA%\Dynatrace\oneagent\log</code>

=== Ротация журнала ===
Каждый модуль ЕдиногоАгента ограничивает количество журналов до 5. Размер каждого из этих 5 файлов ограничен 10 МБ.

=== Старение журнала ===
ЕдиныйАгент очищает файлы журнала при запуске, когда:

* Файл журнала старше 14 дней
* Общий размер всех файлов журналов превышает 300 МБ.
* Существует более 1000 файлов журналов

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

Обновление OneAgent

2023-01-22T11:56:08Z

Lobanov:

OneAgent имеет встроенный настраиваемый механизм автоматического обновления.

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

После автоматических обновлений OneAgent вам необходимо перезапустить все серверные процессы. Это связано с тем, что некоторые компоненты OneAgent продолжают работать в процессах, отслеживаемых Dynatrace (например, Java, .NET, Apache и IIS).

* Перед перезапуском эти процессы будут по-прежнему отслеживаться с помощью предыдущей версии OneAgent.
* После перезапуска эти процессы будут отслеживаться с помощью последней версии OneAgent.

=== Гибкие автоматические обновления OneAgent ===
По умолчанию глобальные автоматические обновления OneAgent включены, но это можно настроить на глобальном уровне, уровне группы хостов и уровне хоста. На каждом уровне вы можете выбрать одну из следующих стратегий обновления OneAgent:

* Обновляйтесь автоматически, независимо от периодов обслуживания.
* Автоматическое обновление в течение выбранного периода обслуживания.
* Не обновлять автоматически. При использовании этого параметра мы не уведомляем вас об устаревании экземпляров OneAgent.

Кроме того:

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

Параметры узла имеют приоритет над параметрами группы узлов, а параметры группы узлов имеют приоритет над глобальными параметрами.

=== Автоматические обновления OneAgent безопасны ===

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

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

* Уровень хоста
* Уровень группы хостов
* Уровень окружения

== Мониторинг обновлений OneAgent ==
Чтобы отслеживать обновления OneAgent, в меню Dynatrace выберите '''Настройки''' > '''Настройки''' > '''Обновления OneAgent:'''

* Проверьте или измените параметры автоматического обновления на уровне среды.
* Мониторинг состояния обновления для каждой операционной системы (Linux, AIX и Windows)
* Проверьте или измените статус автообновления реальной пользовательской библиотеки JavaScript, отслеживающей
** Мониторинг глобального обновления OneAgent
** Статусы обновления OneAgent

=== Мониторинг глобального обновления OneAgent ===
Для мониторинга обновлений OneAgent в масштабах всей среды выберите '''Настройки''' > '''Предпочтения''' > '''Обновления OneAgent'''.

'''Обновления OneAgent'''

Используйте этот раздел, чтобы проверить или изменить настройку уровня среды:

* '''Автоматические обновления при первой же возможности'''
** Обновляйте все экземпляры OneAgent автоматически, независимо от периодов обслуживания.
* '''Автоматические обновления во время периодов обслуживания'''
** Обновляйте все экземпляры OneAgent автоматически в течение выбранного периода обслуживания.
*** При выборе этого параметра отображается список доступных периодов обслуживания. Выберите один.
*** Чтобы настроить новый период обслуживания для обновлений OneAgent, выберите '''Настройки''' > '''Период обслуживания''' > '''Обновления OneAgent'''.
* '''Нет автоматических обновлений'''
** Не обновляйте все экземпляры OneAgent автоматически.

'''Статус автоматических обновлений'''

Используйте этот раздел, чтобы проверить состояние автоматических обновлений для каждой операционной системы. Для каждой операционной системы на этой странице отображается количество экземпляров OneAgent с разбивкой по статусу обновления OneAgent.

'''Библиотека JavaScript для мониторинга реальных пользователей'''

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

=== Статусы обновления OneAgent ===

* Несовместимо — автоматическое обновление невозможно. Для этого хоста/версии может потребоваться ручное обновление.
* Доступно обновление — для этой версии OneAgent доступно обновление.
* Подавлено — загрузка невозможна, поскольку для этого развертывания не поддерживается автоматическое обновление.
* Неизвестно — это может означать, например, что хост не найден или для него недоступно автообновление.
* Актуально — актуальна версия установщика.
* Выполняется обновление — этот хост запросил и загрузил установщик, но еще не подключился с ожидаемой новой версией.
* Ожидание обновления — для этого хоста настроено обновление.
* Проблема с обновлением. Возникла проблема при выполнении обновления. Пожалуйста, ознакомьтесь с деталями.
* Запланировано — обновление запланировано на время настроенного окна обновления.

== Настройка обновлений OneAgent ==
Вы можете настроить обновление OneAgent глобально, для каждой группы хостов и для каждого хоста.

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

Параметры обновления OneAgent на уровне группы хостов и на уровне хоста переопределяют эти глобальные параметры.

1. В меню Dynatrace выберите '''Настройки''' > '''Свойства''' > '''Обновления OneAgent'''.

2. Выберите один из вариантов обновления:

* '''Автоматические обновления при первой же возможности'''
** Обновляйте все агенты OneAgent автоматически, независимо от периодов обслуживания.
* '''Автоматические обновления во время периодов обслуживания'''
** Обновляйте все агенты OneAgent автоматически в течение выбранного периода обслуживания.
*** При выборе этого параметра отображается список доступных периодов обслуживания. Выберите один.
*** Чтобы настроить новый период обслуживания для обновлений OneAgent, выберите '''Настройки''' > '''Период''' '''обслуживания''' > '''Обновления''' '''OneAgent'''.
* '''Нет автоматических обновлений'''
** Не обновляйте OneAgent автоматически.

=== Настройка обновления группы узлов OneAgent ===
Параметры обновления OneAgent на уровне группы узлов переопределяют глобальные параметры и переопределяются параметрами на уровне хоста.

1. Откройте страницу '''настроек группы хостов'''.

Альтернативы доступа:

* Перейдите в '''Настройки''' > '''Мониторинг''' > '''Обзор мониторинга''', найдите любой хост в группе хостов, которую вы хотите настроить, и выберите имя группы хостов (не имя хоста).
* Перейдите в раздел '''Хосты''', откройте страницу хоста и разверните раздел '''Свойства и теги'''. Если узел принадлежит к группе, ссылка на него есть в разделе '''Группа хостов'''.
* Перейдите в раздел '''Статус развертывания''' > '''OneAgent'''. Если хост входит в группу хостов, под именем хоста отображается ссылка на страницу настроек группы хостов.

2. На странице '''настроек группы хостов''' выберите '''обновления OneAgent''' в левой части страницы.

3. Выберите один из вариантов обновления:

* '''Наследовать глобальные настройки обновления'''
** Следуйте глобальным параметрам обновления для обновления экземпляров OneAgent в этой группе узлов.
*** Текущая глобальная настройка отображается в скобках в этой строке.
*** Чтобы перейти на страницу глобальной конфигурации, выберите <code>глобальную</code> ссылку.
* '''Автоматические обновления при первой же возможности'''
** Обновляйте все экземпляры OneAgent в этой группе узлов автоматически, независимо от периодов обслуживания. Игнорировать глобальные настройки обновления.
* '''Автоматические обновления во время периодов обслуживания'''
** Автоматически обновляйте все экземпляры OneAgent в этой группе хостов в течение выбранного периода обслуживания. Игнорировать глобальные настройки обновления.
*** При выборе этого параметра отображается список доступных периодов обслуживания. Выберите один.
*** Чтобы настроить новый период обслуживания для обновлений OneAgent, выберите '''Настройки''' > '''Период обслуживания''' > '''Обновления OneAgent'''.
* '''Нет автоматических обновлений'''
** Не обновлять автоматически экземпляры OneAgent в этой группе хостов. Игнорировать глобальные настройки обновления.

=== Настройка обновления OneAgent на уровне хоста ===
Параметры обновления OneAgent на уровне хоста переопределяют параметры обновления OneAgent на глобальном уровне и уровне группы хостов.

1. Откройте страницу '''хост''' для хоста, который вы хотите настроить.

Варианты доступа:

* Выберите '''Хосты''' в меню навигации, а затем выберите хост.
* Перейдите в «'''Настройки'''» > «'''Мониторинг'''» > «'''Обзор мониторинга'''», выберите вкладку «'''Хосты'''», а затем выберите хост.

2. На странице '''хоста''' откройте меню обзора (…) и выберите «'''Настройки'''».

3. Выберите обновления OneAgent в левой части страницы.

4. Выберите один из вариантов обновления:

* '''Наследовать'''…
** Следуйте группе узлов или глобальным параметрам обновления для обновления этого агента OneAgent.
*** Если выбранный хост принадлежит к группе хостов, текущая настройка группы хостов отображается в скобках в этой строке, а имя группы является ссылкой на страницу конфигурации группы хостов.
*** Если выбранный хост не принадлежит к группе хостов, глобальный параметр отображается в скобках в этой строке, а «глобальный» — это ссылка на страницу глобальной конфигурации («'''Настройки'''» > «'''Предпочтения'''» > «'''Обновления''' '''OneAgent'''»).
* '''Автоматические обновления при первой же возможности'''
** Обновляйте этот OneAgent автоматически, независимо от периодов обслуживания. Игнорировать настройки обновления группы хостов.
* '''Автоматические обновления во время периодов обслуживания'''
** Обновляйте этот OneAgent автоматически в течение выбранного периода обслуживания. Игнорировать глобальные настройки обновления.
*** При выборе этого параметра отображается список доступных периодов обслуживания. Выберите один.
*** Чтобы настроить новый период обслуживания для обновлений OneAgent, выберите «'''Настройки'''» > «'''Период''' '''обслуживания'''» > «'''Обновления''' '''OneAgent'''».
* '''Нет автоматических обновлений'''
** Не обновляйте этот OneAgent автоматически. Игнорировать глобальные настройки обновления.

=== Вручную обновите OneAgent на отдельных хостах ===
Чтобы вручную обновить OneAgent, работающий на отдельном хосте:

1. В меню Dynatrace выберите «'''Настройки'''» > «'''Мониторинг'''» > «'''Обзор''' '''мониторинга'''».

2. Выберите вкладку '''Хосты'''.

3. Чтобы обновить OneAgent или загрузить последнюю версию, выберите «'''Обновить'''» рядом с именем интересующего вас хоста.
'''Примечание:''' Кнопка «'''Обновить'''» появляется только в том случае, если установленная версия OneAgent на определенном хосте устарела и является OneAgent с полным стеком. Эта кнопка не отображается при использовании PaaS и автономных экземпляров OneAgent.
4. Выберите '''Обновить сейчас'''.

Если кнопка «'''Обновить сейчас'''» отключена, у вас нет прав на загрузку установщика.

Кроме того, вы можете загрузить последнюю версию программы установки OneAgent, вручную скопировать ее на целевой хост и выполнить установку непосредственно на целевом хосте.
'''Примечание''': OneAgent не будет автоматически обновляться при первой установке. По умолчанию Dynatrace ждет 1440 минут (24 часа), прежде чем разрешать обновления на хостах EC2, и 120 минут (2 часа) на хостах, отличных от EC2.

=== Выберите версию OneAgent для установки на новые хосты. ===
Чтобы контролировать, какая версия OneAgent автоматически устанавливается на все новые хосты:

1. Выберите «'''Настройки'''» > «'''Настройки'''» > «'''Обновления''' '''OneAgent'''».

2. Выберите '''Без автоматических обновлений''', чтобы отключить автоматические обновления OneAgent.

3. В '''стандартной версии для всех новых хостов''' выберите версию OneAgent для установки на все новые хосты.
'''Примечание''': Выбранная версия OneAgent также используется для интеграции PaaS.

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

=== Список всех периодов обслуживания обновлений OneAgent ===
1. Выберите «'''Настройки'''» > «'''Период''' '''обслуживания'''» > «'''Обновления''' '''OneAgent'''».

2. Просмотрите список всех существующих периодов обслуживания обновлений OneAgent.

=== Включить или отключить период обслуживания обновлений OneAgent ===
1. Выберите «'''Настройки'''» > «'''Период''' '''обслуживания'''» > «'''Обновления''' '''OneAgent'''».

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

3. Включите или выключите переключатель.

=== Удалить период обслуживания обновлений OneAgent ===
1. Выберите «'''Настройки'''» > «'''Период''' '''обслуживания'''» > «'''Обновления''' '''OneAgent'''».

2. Найдите период обслуживания, который хотите удалить.

3. Выберите '''X''' в столбце '''Удалить'''.

=== Создайте или обновите окно обслуживания обновлений OneAgent ===
1. Выберите «'''Настройки'''» > «'''Период''' '''обслуживания'''» > «'''Обновления''' '''OneAgent'''».

2. Откройте окно обслуживания для редактирования:

* Чтобы создать новое окно обслуживания, выберите '''Создать период обслуживания'''.
* Чтобы отредактировать существующий период обслуживания, разверните '''Сведения''' о периоде обслуживания, который вы хотите изменить.

3. Задайте '''Name''' имя, под которым вы хотите указать этот период обслуживания в веб-интерфейсе и API Dynatrace.

4. Опишите период обслуживания:

* Чтобы указать один неповторяющийся период обслуживания:
** Установите '''Повторение''' на <code>один раз</code>
** Установите '''Время обновления''' на одну дату и время для обновления OneAgent.
* Чтобы запланировать период обслуживания каждые x дней:
** Установите '''Повторение''' на <code>Ежедневные интервалы</code>
** Установите '''Каждые x дней''' на количество дней между обновлениями (<code>1</code> = каждый день, <code>2</code> = каждые два дня, <code>3</code> = каждые три дня и т. д.)
** Установите '''Время обновления''' на время в течение указанных дней, когда вы хотите обновить OneAgent.
* Чтобы запланировать период обслуживания каждые x недель в определенные дни недели:
** Установите '''Повторение''' на <code>Еженедельные интервалы</code>
** Включите каждый день недели, который вы хотите добавить в период обслуживания.
** Установите '''Каждые x недель''' количество недель между обновлениями (<code>1</code> = каждую неделю, <code>2</code> = каждые две недели, <code>3</code> = каждые три недели и т. д.)
** Установите '''Время обновления''' на время в течение указанных дней, когда вы хотите обновить OneAgent.
* Чтобы запланировать период обслуживания каждые x месяцев в определенный день месяца:
** Установите '''Повторение''' на Ежемесячные интервалы
** Установите '''День месяца''' на день месяца, в который нужно обновить OneAgent.
** Установите '''Каждые x месяцев''' количество месяцев между обновлениями (<code>1</code> = каждый месяц, <code>2</code> = каждые два месяца, <code>3</code> = каждые три месяца и т. д.)

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

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

=== Применение окна обслуживания обновлений OneAgent ===
Вы можете применить период обслуживания обновлений OneAgent к автоматическим обновлениям на уровне среды, группы хостов или хостов.

'''Окружение'''

1. Выберите «'''Настройки'''» > «'''Обновления''' '''OneAgent'''».

2. Выберите '''Автоматические обновления во время периодов обслуживания'''.

3. Когда список отобразится, выберите период обслуживания, который вы хотите применить на этом уровне.

'''Группа хостов'''

1. Выберите «'''Настройки'''» > «'''Мониторинг'''» > «'''Обзор мониторинга'''».

2. Найдите любой хост, входящий в группу хостов, которую вы хотите настроить.

3. Выберите имя группы хостов (не имя хоста).

4. На странице '''настроек группы хостов''' выберите обновления OneAgent в левой части страницы.

5. Выберите '''Автоматические обновления во время периодов обслуживания'''.

6. Когда список отобразится, выберите период обслуживания, который вы хотите применить на этом уровне.

'''Хост'''

1. Откройте страницу '''Хост''' для хоста, который вы хотите настроить.

Варианты доступа:

* Выберите '''Хосты''' в меню навигации, а затем выберите хост.
* Перейдите в «'''Настройки'''» > «'''Мониторинг'''» > «'''Обзор''' '''мониторинга'''», выберите вкладку «'''Хосты'''», а затем выберите хост.

2. На странице '''хоста''' откройте меню обзора (…) и выберите «'''Настройки'''».

3. Выберите '''обновления OneAgent''' в левой части страницы.

4. Выберите '''Автоматические обновления во время периодов обслуживания'''.

5. Когда список отобразится, выберите период обслуживания, который вы хотите применить на этом уровне.
API
Эквиваленты API см. в разделе [[OneAgent конфигурации API]].

== Отключить автоматические обновления ==
Мы не рекомендуем отключать автоматические обновления OneAgent. Для устранения неполадок вы можете временно отключить автоматические обновления с помощью веб-интерфейса Dynatrace в меню «'''Настройки'''» > «'''Настройки'''» > «'''Обновления''' '''OneAgent'''». Однако если у вас очень строгие правила развертывания программного обеспечения, вы можете навсегда отключить автоматические обновления с помощью интерфейса командной строки OneAgent.

Обновление ЕдиногоАгента

2023-01-22T11:52:25Z

Lobanov: Lobanov переименовал страницу Обновление ЕдиногоАгента в Обновление OneAgent

#перенаправление [[Обновление OneAgent]]

Обновление OneAgent

2023-01-22T11:52:25Z

Lobanov: Lobanov переименовал страницу Обновление ЕдиногоАгента в Обновление OneAgent

ЕдиныйАгент имеет встроенный настраиваемый механизм автоматического обновления.

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

После автоматических обновлений ЕдиногоАгента вам необходимо перезапустить все серверные процессы. Это связано с тем, что некоторые компоненты ЕдиногоАгента продолжают работать в процессах, отслеживаемых Ключ-Астром (например, Java, .NET, Apache и IIS).

* Перед перезапуском эти процессы будут по-прежнему отслеживаться с помощью предыдущей версии ЕдиногоАгента.
* После перезапуска эти процессы будут отслеживаться с помощью последней версии ЕдиногоАгента.

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

* Обновляйтесь автоматически, независимо от периодов обслуживания.
* Автоматическое обновление в течение выбранного периода обслуживания.
* Не обновлять автоматически. При использовании этого параметра мы не уведомляем вас об устаревании экземпляров ЕдиногоАгента.

Кроме того:

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

Параметры узла имеют приоритет над параметрами группы узлов, а параметры группы узлов имеют приоритет над глобальными параметрами.

=== Автоматические обновления ЕдиногоАгента безопасны ===

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

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

* Уровень хоста
* Уровень группы хостов
* Уровень окружения

== Мониторинг обновлений ЕдиногоАгента ==
Чтобы отслеживать обновления ЕдиногоАгента, в меню Ключ-Астром выберите '''Настройки''' > '''Настройки''' > '''Обновления ЕдиногоАгента:'''

* Проверьте или измените параметры автоматического обновления на уровне среды.
* Мониторинг состояния обновления для каждой операционной системы (Linux, AIX и Windows)
* Проверьте или измените статус автообновления реальной пользовательской библиотеки JavaScript, отслеживающей
** Мониторинг глобального обновления ЕдиногоАгента
** Статусы обновления ЕдиногоАгента

=== Мониторинг глобального обновления ЕдиногоАгента ===
Для мониторинга обновлений ЕдиногоАгента в масштабах всей среды выберите '''Настройки''' > '''Предпочтения''' > '''Обновления ЕдиногоАгента'''.

'''Обновления ЕдиногоАгента'''

Используйте этот раздел, чтобы проверить или изменить настройку уровня среды:

* '''Автоматические обновления при первой же возможности'''
** Обновляйте все экземпляры ЕдиногоАгента автоматически, независимо от периодов обслуживания.
* '''Автоматические обновления во время периодов обслуживания'''
** Обновляйте все экземпляры ЕдиногоАгента автоматически в течение выбранного периода обслуживания.
*** При выборе этого параметра отображается список доступных периодов обслуживания. Выберите один.
*** Чтобы настроить новый период обслуживания для обновлений ЕдиногоАгента , выберите '''Настройки''' > '''Период обслуживания''' > '''Обновления ЕдиногоАгента'''.
* '''Нет автоматических обновлений'''
** Не обновляйте все экземпляры ЕдиногоАгента автоматически.

'''Статус автоматических обновлений'''

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

'''Библиотека JavaScript для мониторинга реальных пользователей'''

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

=== Статусы обновления ЕдиногоАгента ===

* Несовместимо — автоматическое обновление невозможно. Для этого хоста/версии может потребоваться ручное обновление.
* Доступно обновление — для этой версии ЕдиногоАгента доступно обновление.
* Подавлено — загрузка невозможна, поскольку для этого развертывания не поддерживается автоматическое обновление.
* Неизвестно — это может означать, например, что хост не найден или для него недоступно автообновление.
* Актуально — актуальна версия установщика.
* Выполняется обновление — этот хост запросил и загрузил установщик, но еще не подключился с ожидаемой новой версией.
* Ожидание обновления — для этого хоста настроено обновление.
* Проблема с обновлением. Возникла проблема при выполнении обновления. Пожалуйста, ознакомьтесь с деталями.
* Запланировано — обновление запланировано на время настроенного окна обновления.

== Настройка обновлений ЕдиногоАгента ==
Вы можете настроить обновление ЕдиногоАгента глобально, для каждой группы хостов и для каждого хоста.

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

Параметры обновления ЕдиногоАгента на уровне группы хостов и на уровне хоста переопределяют эти глобальные параметры.

1. В меню Ключ-Астром выберите '''Настройки''' > '''Свойства''' > '''Обновления OneAgent'''.

2. Выберите один из вариантов обновления:

* '''Автоматические обновления при первой же возможности'''
** Обновляйте все агенты ЕдиногоАгента автоматически, независимо от периодов обслуживания.
* '''Автоматические обновления во время периодов обслуживания'''
** Обновляйте все агенты ЕдиногоАгента автоматически в течение выбранного периода обслуживания.
*** При выборе этого параметра отображается список доступных периодов обслуживания. Выберите один.
*** Чтобы настроить новый период обслуживания для обновлений ЕдиногоАгента , выберите '''Настройки''' > '''Период''' '''обслуживания''' > '''Обновления''' '''ЕдиногоАгента'''.
* '''Нет автоматических обновлений'''
** Не обновляйте ЕдиныйАгент автоматически.

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

1. Откройте страницу '''настроек группы хостов'''.

Альтернативы доступа:

* Перейдите в '''Настройки''' > '''Мониторинг''' > '''Обзор мониторинга''', найдите любой хост в группе хостов, которую вы хотите настроить, и выберите имя группы хостов (не имя хоста).
* Перейдите в раздел '''Хосты''', откройте страницу хоста и разверните раздел '''Свойства и теги'''. Если узел принадлежит к группе, ссылка на него есть в разделе '''Группа хостов'''.
* Перейдите в раздел '''Статус развертывания''' > '''ЕдиныйАгент'''. Если хост входит в группу хостов, под именем хоста отображается ссылка на страницу настроек группы хостов.

2. На странице '''настроек группы хостов''' выберите '''обновления ЕдиногоАгента''' в левой части страницы.

3. Выберите один из вариантов обновления:

* '''Наследовать глобальные настройки обновления'''
** Следуйте глобальным параметрам обновления для обновления экземпляров ЕдиногоАгента в этой группе узлов.
*** Текущая глобальная настройка отображается в скобках в этой строке.
*** Чтобы перейти на страницу глобальной конфигурации, выберите <code>глобальную</code> ссылку.
* '''Автоматические обновления при первой же возможности'''
** Обновляйте все экземпляры ЕдиногоАгента в этой группе узлов автоматически, независимо от периодов обслуживания. Игнорировать глобальные настройки обновления.
* '''Автоматические обновления во время периодов обслуживания'''
** Автоматически обновляйте все экземпляры ЕдиногоАгента в этой группе хостов в течение выбранного периода обслуживания. Игнорировать глобальные настройки обновления.
*** При выборе этого параметра отображается список доступных периодов обслуживания. Выберите один.
*** Чтобы настроить новый период обслуживания для обновлений ЕдиногоАгента , выберите '''Настройки''' > '''Период обслуживания''' > '''Обновления ЕдиногоАгента'''.
* '''Нет автоматических обновлений'''
** Не обновлять автоматически экземпляры ЕдиногоАгента в этой группе хостов. Игнорировать глобальные настройки обновления.

=== Настройка обновления ЕдиногоАгента на уровне хоста ===
Параметры обновления ЕдиногоАгента на уровне хостапереопределяют параметры обновления ЕдиногоАгента на глобальном уровне и уровне группы хостов.

1. Откройте страницу '''хост''' для хоста, который вы хотите настроить.

Варианты доступа:

* Выберите '''Хосты''' в меню навигации, а затем выберите хост.
* Перейдите в «'''Настройки'''» > «'''Мониторинг'''» > «'''Обзор мониторинга'''», выберите вкладку «'''Хосты'''», а затем выберите хост.

2. На странице '''хоста''' откройте меню обзора (…) и выберите «'''Настройки'''».

3. Выберите обновления ЕдиногоАгента в левой части страницы.

4. Выберите один из вариантов обновления:

* '''Наследовать'''…
** Следуйте группе узлов или глобальным параметрам обновления для обновления этого агента ЕдиногоАгента.
*** Если выбранный хост принадлежит к группе хостов, текущая настройка группы хостов отображается в скобках в этой строке, а имя группы является ссылкой на страницу конфигурации группы хостов.
*** Если выбранный хост не принадлежит к группе хостов, глобальный параметр отображается в скобках в этой строке, а «глобальный» — это ссылка на страницу глобальной конфигурации («'''Настройки'''» > «'''Предпочтения'''» > «'''Обновления''' '''ЕдиногоАгента'''»).
* '''Автоматические обновления при первой же возможности'''
** Обновляйте этот ЕдиногоАгента автоматически, независимо от периодов обслуживания. Игнорировать настройки обновления группы хостов.
* '''Автоматические обновления во время периодов обслуживания'''
** Обновляйте этот ЕдиныйАгент автоматически в течение выбранного периода обслуживания. Игнорировать глобальные настройки обновления.
*** При выборе этого параметра отображается список доступных периодов обслуживания. Выберите один.
*** Чтобы настроить новый период обслуживания для обновлений ЕдиногоАгента, выберите «'''Настройки'''» > «'''Период''' '''обслуживания'''» > «'''Обновления''' '''ЕдиногоАгента'''».
* '''Нет автоматических обновлений'''
** Не обновляйте этот ЕдиныйАгент автоматически. Игнорировать глобальные настройки обновления.

=== Вручную обновите ЕдиныйАгент на отдельных хостах ===
Чтобы вручную обновить ЕдиныйАгент, работающий на отдельном хосте:

1. В меню Ключ-Астром выберите «'''Настройки'''» > «'''Мониторинг'''» > «'''Обзор''' '''мониторинга'''».

2. Выберите вкладку '''Хосты'''.

3. Чтобы обновить ЕдиныйАгент или загрузить последнюю версию, выберите «'''Обновить'''» рядом с именем интересующего вас хоста.
'''Примечание:''' Кнопка «'''Обновить'''» появляется только в том случае, если установленная версия ЕдиногоАгента на определенном хосте устарела и является ЕдинымАгентом с полным стеком. Эта кнопка не отображается при использовании PaaS и автономных экземпляров ЕдиногоАгента.
4. Выберите '''Обновить сейчас'''.

Если кнопка «'''Обновить сейчас'''» отключена, у вас нет прав на загрузку установщика.

Кроме того, вы можете загрузить последнюю версию программы установки ЕдиногоАгента, вручную скопировать ее на целевой хост и выполнить установку непосредственно на целевом хосте.
'''Примечание''': ЕдиныйАгент не будет автоматически обновляться при первой установке. По умолчанию Ключ-Астром ждет 1440 минут (24 часа), прежде чем разрешать обновления на хостах EC2, и 120 минут (2 часа) на хостах, отличных от EC2.

=== Выберите версию ЕдиногоАгента для установки на новые хосты. ===
Чтобы контролировать, какая версия ЕдиногоАгента автоматически устанавливается на все новые хосты:

1. Выберите «'''Настройки'''» > «'''Настройки'''» > «'''Обновления''' '''ЕдиногоАгента'''».

2. Выберите '''Без автоматических обновлений''', чтобы отключить автоматические обновления ЕдиногоАгента.

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

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

=== Список всех периодов обслуживания обновлений ЕдиногоАгента ===
1. Выберите «'''Настройки'''» > «'''Период''' '''обслуживания'''» > «'''Обновления''' '''ЕдиногоАгента'''».

2. Просмотрите список всех существующих периодов обслуживания обновлений ЕдиногоАгента.

=== Включить или отключить период обслуживания обновлений ЕдиногоАгента ===
1. Выберите «'''Настройки'''» > «'''Период''' '''обслуживания'''» > «'''Обновления''' '''ЕдиногоАгента'''».

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

3. Включите или выключите переключатель.

=== Удалить период обслуживания обновлений ЕдиногоАгента ===
1. Выберите «'''Настройки'''» > «'''Период''' '''обслуживания'''» > «'''Обновления''' '''ЕдиногоАгента'''».

2. Найдите период обслуживания, который хотите удалить.

3. Выберите '''X''' в столбце '''Удалить'''.

=== Создайте или обновите окно обслуживания обновлений ЕдиногоАгента ===
1. Выберите «'''Настройки'''» > «'''Период''' '''обслуживания'''» > «'''Обновления''' '''ЕдиногоАгента'''».

2. Откройте окно обслуживания для редактирования:

* Чтобы создать новое окно обслуживания, выберите '''Создать период обслуживания'''.
* Чтобы отредактировать существующий период обслуживания, разверните '''Сведения''' о периоде обслуживания, который вы хотите изменить.

3. Задайте '''Name''' имя, под которым вы хотите указать этот период обслуживания в веб-интерфейсе и API Ключ-Астром.

4. Опишите период обслуживания:

* Чтобы указать один неповторяющийся период обслуживания:
** Установите '''Повторение''' на <code>один раз</code>
** Установите '''Время обновления''' на одну дату и время для обновления ЕдиногоАгента.
* Чтобы запланировать период обслуживания каждые x дней:
** Установите '''Повторение''' на <code>Ежедневные интервалы</code>
** Установите '''Каждые x дней''' на количество дней между обновлениями (<code>1</code> = каждый день, <code>2</code> = каждые два дня, <code>3</code> = каждые три дня и т. д.)
** Установите '''Время обновления''' на время в течение указанных дней, когда вы хотите обновить ЕдиныйАгент.
* Чтобы запланировать период обслуживания каждые x недель в определенные дни недели:
** Установите '''Повторение''' на <code>Еженедельные интервалы</code>
** Включите каждый день недели, который вы хотите добавить в период обслуживания.
** Установите '''Каждые x недель''' количество недель между обновлениями (<code>1</code> = каждую неделю, <code>2</code> = каждые две недели, <code>3</code> = каждые три недели и т. д.)
** Установите '''Время обновления''' на время в течение указанных дней, когда вы хотите обновить ЕдиныйАгент.
* Чтобы запланировать период обслуживания каждые x месяцев в определенный день месяца:
** Установите '''Повторение''' на Ежемесячные интервалы
** Установите '''День месяца''' на день месяца, в который нужно обновить ЕдиныйАгент.
** Установите '''Каждые x месяцев''' количество месяцев между обновлениями (<code>1</code> = каждый месяц, <code>2</code> = каждые два месяца, <code>3</code> = каждые три месяца и т. д.)

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

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

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

'''Окружение'''

1. Выберите «'''Настройки'''» > «'''Обновления''' '''ЕдиногоАгента'''».

2. Выберите '''Автоматические обновления во время периодов обслуживания'''.

3. Когда список отобразится, выберите период обслуживания, который вы хотите применить на этом уровне.

'''Группа хостов'''

1. Выберите «'''Настройки'''» > «'''Мониторинг'''» > «'''Обзор мониторинга'''».

2. Найдите любой хост, входящий в группу хостов, которую вы хотите настроить.

3. Выберите имя группы хостов (не имя хоста).

4. На странице '''настроек группы хостов''' выберите обновления ЕдиногоАгента в левой части страницы.

5. Выберите '''Автоматические обновления во время периодов обслуживания'''.

6. Когда список отобразится, выберите период обслуживания, который вы хотите применить на этом уровне.

'''Хост'''

1. Откройте страницу '''Хост''' для хоста, который вы хотите настроить.

Варианты доступа:

* Выберите '''Хосты''' в меню навигации, а затем выберите хост.
* Перейдите в «'''Настройки'''» > «'''Мониторинг'''» > «'''Обзор''' '''мониторинга'''», выберите вкладку «'''Хосты'''», а затем выберите хост.

2. На странице '''хоста''' откройте меню обзора (…) и выберите «'''Настройки'''».

3. Выберите '''обновления ЕдиногоАгента''' в левой части страницы.

4. Выберите '''Автоматические обновления во время периодов обслуживания'''.

5. Когда список отобразится, выберите период обслуживания, который вы хотите применить на этом уровне.
API
Эквиваленты API см. в разделе [[ЕдиныйАгент конфигурации API]].

== Отключить автоматические обновления ==
Мы не рекомендуем отключать автоматические обновления ЕдиногоАгента . Для устранения неполадок вы можете временно отключить автоматические обновления с помощью веб-интерфейса Ключ-Астром в меню «'''Настройки'''» > «'''Настройки'''» > «'''Обновления''' '''ЕдиногоАгента'''». Однако если у вас очень строгие правила развертывания программного обеспечения, вы можете навсегда отключить автоматические обновления с помощью интерфейса командной строки ЕдиногоАгента .

Адаптивное управление и контроль трафика

2023-01-22T11:51:56Z

Lobanov: /* Высокоточная распределенная трассировка Dynatrace */

'''''[[Применение Ключ-АСТРОМ|Применение Dynatrace]] / [https://doc.ruscomtech.ru/index.php/%D0%9F%D1%80%D0%B8%D0%BC%D0%B5%D0%BD%D0%B5%D0%BD%D0%B8%D0%B5_%D0%9A%D0%BB%D1%8E%D1%87-%D0%90%D0%A1%D0%A2%D0%A0%D0%9E%D0%9C#.D0.A1.D0.B5.D1.80.D0.B2.D0.B8.D1.81.D1.8B Сервисы] / Распределенная трассировка по технологии PurePath® /'''''

'''''Адаптивное управление и контроль трафика'''''

Ключевой особенностью Dynatrace является возможность распределенной трассировки PurePath® . Одна распределенная трассировка PurePath представляет собой полную сквозную распределенную трассировку.

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

Все это предоставляется автоматически, без дополнительной настройки, с распределенной трассировкой Dynatrace. Трассировка на основе технологии PurePath также является одним из основных компонентов, позволяющих Davis®, Dynatrace AI, выполнять автоматическое базовое определение и анализ первопричин. В поддержку этого распределенная трассировка Dynatrace обеспечивает высочайший уровень детализации и точности данных на рынке.

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

Благодаря высокой точности отслеживания Dynatrace в большинстве случаев фиксирует каждую распределенную транзакцию. В частности, при больших объемах обращений уровни с одной точкой входа могут обрабатывать больше запросов, чем это. Постоянный захват всех трассировок в таких ситуациях может привести к увеличению требований к пропускной способности сети. Для этого Dynatrace OneAgent предоставляет встроенный ограничитель. Каждому контролируемому OneAgent процессу разрешается запускать заданное количество распределенных трассировок в минуту. Этот лимит можно назвать квотой.
[[Файл:Oneagent-adaptive-traffic-management-pipe-748-5b04a011d8.png|центр|мини|574x574пкс]]

Как только квота распределенных трассировок достигнута, OneAgent применяет интеллектуальный механизм, который максимально эффективно использует отслеживаемый трафик. Такой подход называется «адаптивное управление трафиком».

== SaaS vs Managed — адаптивное управление трафиком версии 1 и версии 2 ==

=== Версия 1 — Dynatrace Managed ===
В версии 1 адаптивного управления трафиком каждому процессу разрешено запускать фиксированное количество 1000 новых распределенных трассировок в минуту. Эта версия в настоящее время используется по умолчанию и активна для большинства управляемых кластеров Dynatrace . Это хорошо работает, но имеет недостаток. Если в вашей архитектуре есть точка входа с большим объемом (например, балансировщик нагрузки или NGINX), которая превышает это значение, ваш трафик будет ограничен там. Кроме того, такое поведение также приводит к отправке трафика в Dynatrace, который может реагировать резко в зависимости от трафика вашего приложения.

=== Версия 2 — Dynatrace SaaS ===
В версии 2 адаптивного управления трафиком ограничение каждого процесса автоматически адаптируется и настраивается таким образом, что общий допустимый объем вызовов службы в минуту отправляется в Dynatrace независимо от архитектуры вашего приложения.

* Допустимый объем в минуту основан на активно используемых хост-устройствах в данной среде: 250 вызовов полного обслуживания <code>x</code> активных хост-устройств .
* Допустимый объем масштабируется с вашей лицензией, гарантируя справедливую стоимость для всех наших клиентов.

Пример. Средняя среда, состоящая из 50 хостов по 32 ГБ каждый (100 хост-модулей), будет обрабатывать до 25 000 вызовов полного обслуживания в минуту.

Преимущества этой системы:

* Точки входа с большим объемом могут отправлять больше трассировок, поскольку управление трафиком осуществляется на основе общего объема, отправляемого в среду Dynatrace.
* Приложения с малым объемом делят неиспользуемый объем транзакций с приложениями с большим объемом, которым он необходим.
* Хосты инфраструктуры не отправляют трассировки, но увеличивают общий допустимый объем.
* Сетевой трафик, отправляемый в Dynatrace, менее скачкообразный, так как трафик управляется на основе общего объема.

Эта версия в настоящее время активна во всех средах Dynatrace SaaS .

== Адаптивное управление трафиком на Dynatrace OneAgent ==
Адаптивное управление трафиком гарантирует, что каждый OneAgent регистрирует минимальное количество новых распределенных трассировок каждую минуту, тем самым ограничивая объем отправляемых данных. В то же время он гарантирует, что все важные трассировки будут полностью зафиксированы и что для более частых, но менее важных запросов поддерживается статистически достоверный набор трассировок.

Для этого OneAgent вычисляет список самых популярных запросов, которые запускаются каждую минуту. Типичные приложения не имеют равномерного распределения запросов. Скорее, есть несколько типов запросов, которые составляют большую часть трафика (например, запросы изображений или проверки статуса), среднее количество важных запросов и большое количество уникальных URL-адресов. Основываясь на списке самых популярных запросов, OneAgent захватывает трафик таким образом, что запросы с наибольшим объемом захватываются реже (тем самым избегая захвата «большего количества одинаковых»), в то время как каждый уникальный или редкий запрос захватывается.

В следующей таблице представлен такой пример расчета топ-запросов вместе с соответствующими коэффициентами охвата.
{| class="wikitable"
!Запрос
!Количество запросов, обработанных приложением
!Фактор захвата
!Захваченные распределенные трассировки
|-
|URI А
|900
|1/2
|450
|-
|URI Б
|440
|1/2
|220
|-
|URI С
|250
|1
|250
|-
|URI Д
|60
|1
|60
|-
|50 других URI
|100
|1
|100
|-
|
|
|
|
|-
|Общее количество:
|1500
|
|1080
|}
В этом примере OneAgent будет захватывать чуть более 1000 запросов в минуту, так как в данном примере это настроенный целевой номер запроса. URI C, D и 50 других URI захватываются каждый раз, в то время как A и B захватываются только в 50% случаев. Тем не менее, OneAgent по-прежнему отслеживает эти запросы от начала до конца более 600 раз в минуту.

Почти во всех случаях вы не заметите такого поведения. Dynatrace сохраняет информацию о скорости захвата и соответственно рассчитывает время отклика, пропускную способность и частоту ошибок. Все диаграммы и сервисный анализ показывают экстраполированные данные, основанные на исходной частоте захвата. Dynatrace AI по-прежнему имеет более чем достаточно данных (больше, чем любое другое решение APM), чтобы предоставить вам полезную информацию и подробный анализ основных причин обнаруженных проблем. Вы можете увидеть это поведение, если посмотрите на отдельную распределенную трассировку в списке распределенных трассировок, где указано <code>3 more like this</code>. Это указывает на то, что запрос был перехвачен один раз, в то время как было еще три таких же запроса, которые были обработаны отслеживаемым приложением, но не были включены в анализ.

При таком подходе адаптивное управление трафиком значительно экономит полосу пропускания сети, а в случае Dynatrace Managed — драгоценные ресурсы ЦП, памяти, сети и хранилища, которые в противном случае потребовались бы для обработки и хранения этих данных.

== Мониторинг адаптивного управления трафиком ==
'''Dynatrace версии 1.232+'''

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

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

[[Файл:adap2.png]]

Необходимые метрические выражения, используемые для построения этой информационной панели, перечислены ниже:
{| class="wikitable"
!Значение
!Выражение метрики
|-
|Вызовы с полным обслуживанием, полученные кластером
|<code>dsfm:server.service_calls.received:splitBy():sum:auto:rate(1m)</code>
|-
|Вызовы с полным обслуживанием обрабатываются OneAgent
|<code>dsfm:oneagent.service_calls.processed:splitBy():sum:auto:rate(1m)</code>
|-
|Максимально допустимый полный сервисный вызов / мин
|<code>dsfm:server.service_calls.maximum_allowed_per_minute:splitBy():avg:auto:auto</code>
|-
|Скорость захвата OneAgent
|<code>(dsfm:server.service_calls.received:splitBy():sum:auto)/</code><code>(dsfm:</code><code>oneagent</code><code>.service_calls.processed:splitBy():sum:auto)*(100)</code>
|}
Это используемые показатели
{| class="wikitable"
!Метрика самоконтроля
!Описание
|-
|<code>dsfm:oneagent.service_calls.processed</code>
|Количество вызовов с полным обслуживанием, обработанных OneAgent.
|-
|<code>dsfm:server.service_calls.received</code>
|Количество вызовов с полным обслуживанием, полученных кластером Dynatrace.
|-
|<code>dsfm:server.service_calls.maximum_allowed_per_minute</code>
|Максимально допустимое количество вызовов с полным обслуживанием в минуту в зависимости от вашей лицензии.
|}

== Адаптивное снижение нагрузки в Dynatrace Managed ==
Благодаря простоте развертывания OneAgent инструментирование новых приложений, хостов или даже больших дополнительных сред не составляет труда. Клиенты часто подключают к Dynatrace сотни хостов и приложений в день. Это, конечно, значительно увеличивает количество распределенных трассировок, которые обрабатываются кластером Dynatrace Managed.

Иногда первоначальные соображения по размеру управляемых узлов и кластеров Dynatrace недостаточны для поддержки такого объема; кластеру, управляемому Dynatrace, может не хватать необходимого оборудования для обработки всех дополнительных входящих данных. Чтобы защитить работоспособность и целостность вашей среды мониторинга в таких ситуациях, Dynatrace Managed использует адаптивное снижение нагрузки на входящие трассировки, чтобы гарантировать, что мониторинг остается стабильным, пока для анализа собирается статистически достоверный набор запросов.

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

Новые распределенные трассировки, поступающие из сред с самым высоким трафиком по отношению к назначенным им хост-устройствам (т. е. трафик/хост-модуль), сначала обрабатываются для снижения нагрузки. В этих средах Dynatrace Managed пропускает полную обработку распределенной трассировки. Это происходит случайным образом и уменьшает количество распределенных трассировок, которые обрабатываются поэтапно. В то же время сохраняется статистическая достоверность всех метрик, диаграмм, базовых показателей и событий, поскольку Dynatrace знает количество пропущенных распределенных трассировок. Это полностью прозрачно для вас, поскольку Dynatrace создает событие и отображает сообщение в пользовательском интерфейсе кластера.

[[Файл:adap3.png]]

Как и в случае с управлением трафиком OneAgent, сокращение объема обрабатываемых данных учитывается прозрачным образом. Это успешно защитит ваш кластер от всплесков трафика. Если такие ситуации единичны, тот факт, что не все данные обрабатываются, не оказывает негативного влияния на ваш мониторинг. Dynatrace AI никак не затрагивается и не выдает предупреждения. Все данные диаграмм на основе сервисов прозрачно корректируются (без видимых изменений), и это учитывается во всех аналитических представлениях. Вы не увидите разницы в диаграммах или данных анализа вызовов службы, если вы не смотрите на один PurePath. Единственное место, где это видно, — это список распределенных трассировок, в котором отображается сообщение типа <code>x more like this</code>.

Целевыми являются только те среды, которые имеют большой объем трафика по сравнению с назначенными им хостами. Все остальные среды остаются незатронутыми.

Если адаптивное снижение нагрузки задействуется только время от времени, чтобы покрыть пики, все, что вам нужно знать, это то, что это не должно быть долгосрочным решением. Хотя адаптивное управление трафиком OneAgent активно формирует трафик, описанная здесь функция существует только в качестве защиты. Например, спорадический инцидент ALR, который происходит раз в неделю в течение 15 минут, не обязательно означает, что кластер перегружен. Это может быть вызвано необычным скачком нагрузки или временным сбоем в сети.

Если адаптивное снижение нагрузки используется на постоянной основе в течение более длительных периодов (более 15 минут) и особенно в ситуациях, когда ALR активен все время, тот факт, что не все данные обрабатываются, может подорвать ваш мониторинг, метрики и общие данные. качественный. Чтобы предотвратить такой сценарий, вам нужно выбрать один из двух доступных вариантов. Вы можете добавить дополнительное оборудование и новый узел кластера Dynatrace Managed.предоставить вашему управляемому кластеру Dynatrace необходимые ресурсы для обработки дополнительных данных. Или вы можете уменьшить входящий трафик, настроив параметры управления трафиком для OneAgent среды. Вы также можете рассмотреть эти варианты в адаптивном управлении трафиком, когда вам недостаточно статистической корректности сбора данных и вам нужна более высокая точность данных.

== Адаптивное управление захватом ==
В Dynatrace Managed вы можете определить целевое количество недавно отслеживаемых распределенных трассировок точек входа, захватываемых на процесс в минуту.

[[Файл:adap4.png]]

По умолчанию число вновь отслеживаемых распределенных трассировок точек входа, захваченных на процесс в минуту, составляет 1000, что уже является большим числом. Изменение этого параметра может быть полезно в некоторых ситуациях. У вас может быть среда нагрузочного тестирования, которая потребляет слишком много сетевых, дисковых и ЦП ресурсов в вашем управляемом кластере Dynatrace, и вы предпочитаете использовать эту среду для производственного мониторинга. Вы можете уменьшить точность распределенной трассировки среды и, таким образом, уменьшить процент отслеживаемого входящего трафика. Другими словами, тесты могут обеспечить достаточную степень детализации данных даже после сокращения количества трасс до 500 или 100 в минуту.

Уменьшая количество захваченных распределенных трассировок, вы не меняете ни метрики, ни функции анализа службы. За пределами самого списка распределенных трасс это изменение учитывается прозрачным образом и учитывается во всех анализах.

В качестве альтернативы вы можете увеличить количество распределенных трассировок точек входа, захватываемых на процесс в минуту в наиболее важных средах, чтобы получить еще более высокую точность, чем по умолчанию. Верхний предел составляет 100 000 новых сквозных запросов/процессов/мин. Это эффективно указывает OneAgent захватывать все запросы. Это полезно, когда вам нужно обеспечить захват даже редких запросов в средах с большим объемом.

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

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

Перейдите в « Настройки » > « Мониторинг службы на стороне сервера» > « Глубокий мониторинг» .

[[Файл:adap5.png]]

Как видите, эта функция дополнительно позволяет администратору среды сократить количество распределенных трассировок во всей среде. Это полезно для уменьшения объема сетевого трафика, создаваемого OneAgent во всей среде.

== Часто задаваемые вопросы ==
''Как адаптивное управление трафиком влияет на графики, базовые показатели и оповещения?''

Короткий ответ: нисколько.

Формирование трафика учитывается прозрачно и выполняется таким образом, чтобы обеспечить статистическую достоверность при захвате редких запросов с высокой вероятностью. На всех диаграммах показано общее реальное количество запросов, обрабатываемых вашим приложением, а также весь специальный анализ, который вы можете выполнить. Это не влияет на Dynatrace AI. Единственное место, где видно это формирование трафика, — это список распределенных трассировок, в котором отображается сообщение вроде <code>x more like this</code>.

''Почему я не могу найти свой запрос?''

Если размер вашего управляемого кластера Dynatrace недостаточен или интересующий вас конкретный запрос исходит от уровня с большим объемом (более 1000 запросов в минуту), Dynatrace может не зафиксировать запрос. OneAgent делает все возможное, чтобы захватить все уникальные запросы, но есть ограничения на то, что можно сделать. Мы продолжим работать над совершенствованием этого механизма. Вы можете уменьшить объем производимого трафика, исключив из захвата неважные запросы; это делается с помощью атрибутов веб-запроса и правил исключения URL-адресов. Такой подход оставляет больше места для важных запросов.

Если это важно для вас, вы также можете увеличить количество захваченных распределенных трассировок в Dynatrace Managed.

''Что такое полный сервисный вызов?''

Полный сервисный вызов — это вызов на стороне сервера, который запускает распределенную трассировку, сервисный вызов на уровне глубокого мониторинга или настраиваемые сервисные вызовы. Внешние вызовы (такие как вызовы базы данных, внешние веб-запросы или вообще любые непрозрачные вызовы службы) не являются вызовами полного обслуживания, поэтому они не учитываются в вашем лимите трафика. Dynatrace считает все запросы к службам веб-запросов и веб-служб (кроме внешних), службам RMI, службам обмена сообщениями и пользовательским службам.

''Что такое активная хост-единица?''

Активные хост-устройства — это хост-устройства, используемые в данный момент и подключенные к среде (а не хост-устройства, назначенные среде).

''Каково минимальное количество вызовов полного обслуживания/мин в данной среде?''

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

''Каково минимальное и максимальное количество следов, которые может создать процесс?''

Система автоматически адаптирует OneAgent между 50–50 000 трассировок в минуту, чтобы соответствовать общему объему трафика, достигающему системы Dynatrace

Адаптивное управление и контроль трафика

2023-01-22T11:50:53Z

Lobanov:

'''''[[Применение Ключ-АСТРОМ|Применение Dynatrace]] / [https://doc.ruscomtech.ru/index.php/%D0%9F%D1%80%D0%B8%D0%BC%D0%B5%D0%BD%D0%B5%D0%BD%D0%B8%D0%B5_%D0%9A%D0%BB%D1%8E%D1%87-%D0%90%D0%A1%D0%A2%D0%A0%D0%9E%D0%9C#.D0.A1.D0.B5.D1.80.D0.B2.D0.B8.D1.81.D1.8B Сервисы] / Распределенная трассировка по технологии PurePath® /'''''

'''''Адаптивное управление и контроль трафика'''''

Ключевой особенностью Dynatrace является возможность распределенной трассировки PurePath® . Одна распределенная трассировка PurePath представляет собой полную сквозную распределенную трассировку.

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

Все это предоставляется автоматически, без дополнительной настройки, с распределенной трассировкой Dynatrace. Трассировка на основе технологии PurePath также является одним из основных компонентов, позволяющих Davis®, Dynatrace AI, выполнять автоматическое базовое определение и анализ первопричин. В поддержку этого распределенная трассировка Dynatrace обеспечивает высочайший уровень детализации и точности данных на рынке.

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

Благодаря высокой точности отслеживания Dynatrace в большинстве случаев фиксирует каждую распределенную транзакцию. В частности, при больших объемах обращений уровни с одной точкой входа могут обрабатывать больше запросов, чем это. Постоянный захват всех трассировок в таких ситуациях может привести к увеличению требований к пропускной способности сети. Для этого Dynatrace OneAgent предоставляет встроенный ограничитель. Каждому контролируемому OneAgent процессу разрешается запускать заданное количество распределенных трассировок в минуту. Этот лимит можно назвать квотой.

Как только квота распределенных трассировок достигнута, OneAgent применяет интеллектуальный механизм, который максимально эффективно использует отслеживаемый трафик. Такой подход называется «адаптивное управление трафиком».

== SaaS vs Managed — адаптивное управление трафиком версии 1 и версии 2 ==

=== Версия 1 — Dynatrace Managed ===
В версии 1 адаптивного управления трафиком каждому процессу разрешено запускать фиксированное количество 1000 новых распределенных трассировок в минуту. Эта версия в настоящее время используется по умолчанию и активна для большинства управляемых кластеров Dynatrace . Это хорошо работает, но имеет недостаток. Если в вашей архитектуре есть точка входа с большим объемом (например, балансировщик нагрузки или NGINX), которая превышает это значение, ваш трафик будет ограничен там. Кроме того, такое поведение также приводит к отправке трафика в Dynatrace, который может реагировать резко в зависимости от трафика вашего приложения.

=== Версия 2 — Dynatrace SaaS ===
В версии 2 адаптивного управления трафиком ограничение каждого процесса автоматически адаптируется и настраивается таким образом, что общий допустимый объем вызовов службы в минуту отправляется в Dynatrace независимо от архитектуры вашего приложения.

* Допустимый объем в минуту основан на активно используемых хост-устройствах в данной среде: 250 вызовов полного обслуживания <code>x</code> активных хост-устройств .
* Допустимый объем масштабируется с вашей лицензией, гарантируя справедливую стоимость для всех наших клиентов.

Пример. Средняя среда, состоящая из 50 хостов по 32 ГБ каждый (100 хост-модулей), будет обрабатывать до 25 000 вызовов полного обслуживания в минуту.

Преимущества этой системы:

* Точки входа с большим объемом могут отправлять больше трассировок, поскольку управление трафиком осуществляется на основе общего объема, отправляемого в среду Dynatrace.
* Приложения с малым объемом делят неиспользуемый объем транзакций с приложениями с большим объемом, которым он необходим.
* Хосты инфраструктуры не отправляют трассировки, но увеличивают общий допустимый объем.
* Сетевой трафик, отправляемый в Dynatrace, менее скачкообразный, так как трафик управляется на основе общего объема.

Эта версия в настоящее время активна во всех средах Dynatrace SaaS .

== Адаптивное управление трафиком на Dynatrace OneAgent ==
Адаптивное управление трафиком гарантирует, что каждый OneAgent регистрирует минимальное количество новых распределенных трассировок каждую минуту, тем самым ограничивая объем отправляемых данных. В то же время он гарантирует, что все важные трассировки будут полностью зафиксированы и что для более частых, но менее важных запросов поддерживается статистически достоверный набор трассировок.

Для этого OneAgent вычисляет список самых популярных запросов, которые запускаются каждую минуту. Типичные приложения не имеют равномерного распределения запросов. Скорее, есть несколько типов запросов, которые составляют большую часть трафика (например, запросы изображений или проверки статуса), среднее количество важных запросов и большое количество уникальных URL-адресов. Основываясь на списке самых популярных запросов, OneAgent захватывает трафик таким образом, что запросы с наибольшим объемом захватываются реже (тем самым избегая захвата «большего количества одинаковых»), в то время как каждый уникальный или редкий запрос захватывается.

В следующей таблице представлен такой пример расчета топ-запросов вместе с соответствующими коэффициентами охвата.
{| class="wikitable"
!Запрос
!Количество запросов, обработанных приложением
!Фактор захвата
!Захваченные распределенные трассировки
|-
|URI А
|900
|1/2
|450
|-
|URI Б
|440
|1/2
|220
|-
|URI С
|250
|1
|250
|-
|URI Д
|60
|1
|60
|-
|50 других URI
|100
|1
|100
|-
|
|
|
|
|-
|Общее количество:
|1500
|
|1080
|}
В этом примере OneAgent будет захватывать чуть более 1000 запросов в минуту, так как в данном примере это настроенный целевой номер запроса. URI C, D и 50 других URI захватываются каждый раз, в то время как A и B захватываются только в 50% случаев. Тем не менее, OneAgent по-прежнему отслеживает эти запросы от начала до конца более 600 раз в минуту.

Почти во всех случаях вы не заметите такого поведения. Dynatrace сохраняет информацию о скорости захвата и соответственно рассчитывает время отклика, пропускную способность и частоту ошибок. Все диаграммы и сервисный анализ показывают экстраполированные данные, основанные на исходной частоте захвата. Dynatrace AI по-прежнему имеет более чем достаточно данных (больше, чем любое другое решение APM), чтобы предоставить вам полезную информацию и подробный анализ основных причин обнаруженных проблем. Вы можете увидеть это поведение, если посмотрите на отдельную распределенную трассировку в списке распределенных трассировок, где указано <code>3 more like this</code>. Это указывает на то, что запрос был перехвачен один раз, в то время как было еще три таких же запроса, которые были обработаны отслеживаемым приложением, но не были включены в анализ.

При таком подходе адаптивное управление трафиком значительно экономит полосу пропускания сети, а в случае Dynatrace Managed — драгоценные ресурсы ЦП, памяти, сети и хранилища, которые в противном случае потребовались бы для обработки и хранения этих данных.

== Мониторинг адаптивного управления трафиком ==
'''Dynatrace версии 1.232+'''

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

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

[[Файл:adap2.png]]

Необходимые метрические выражения, используемые для построения этой информационной панели, перечислены ниже:
{| class="wikitable"
!Значение
!Выражение метрики
|-
|Вызовы с полным обслуживанием, полученные кластером
|<code>dsfm:server.service_calls.received:splitBy():sum:auto:rate(1m)</code>
|-
|Вызовы с полным обслуживанием обрабатываются OneAgent
|<code>dsfm:oneagent.service_calls.processed:splitBy():sum:auto:rate(1m)</code>
|-
|Максимально допустимый полный сервисный вызов / мин
|<code>dsfm:server.service_calls.maximum_allowed_per_minute:splitBy():avg:auto:auto</code>
|-
|Скорость захвата OneAgent
|<code>(dsfm:server.service_calls.received:splitBy():sum:auto)/</code><code>(dsfm:</code><code>oneagent</code><code>.service_calls.processed:splitBy():sum:auto)*(100)</code>
|}
Это используемые показатели
{| class="wikitable"
!Метрика самоконтроля
!Описание
|-
|<code>dsfm:oneagent.service_calls.processed</code>
|Количество вызовов с полным обслуживанием, обработанных OneAgent.
|-
|<code>dsfm:server.service_calls.received</code>
|Количество вызовов с полным обслуживанием, полученных кластером Dynatrace.
|-
|<code>dsfm:server.service_calls.maximum_allowed_per_minute</code>
|Максимально допустимое количество вызовов с полным обслуживанием в минуту в зависимости от вашей лицензии.
|}

== Адаптивное снижение нагрузки в Dynatrace Managed ==
Благодаря простоте развертывания OneAgent инструментирование новых приложений, хостов или даже больших дополнительных сред не составляет труда. Клиенты часто подключают к Dynatrace сотни хостов и приложений в день. Это, конечно, значительно увеличивает количество распределенных трассировок, которые обрабатываются кластером Dynatrace Managed.

Иногда первоначальные соображения по размеру управляемых узлов и кластеров Dynatrace недостаточны для поддержки такого объема; кластеру, управляемому Dynatrace, может не хватать необходимого оборудования для обработки всех дополнительных входящих данных. Чтобы защитить работоспособность и целостность вашей среды мониторинга в таких ситуациях, Dynatrace Managed использует адаптивное снижение нагрузки на входящие трассировки, чтобы гарантировать, что мониторинг остается стабильным, пока для анализа собирается статистически достоверный набор запросов.

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

Новые распределенные трассировки, поступающие из сред с самым высоким трафиком по отношению к назначенным им хост-устройствам (т. е. трафик/хост-модуль), сначала обрабатываются для снижения нагрузки. В этих средах Dynatrace Managed пропускает полную обработку распределенной трассировки. Это происходит случайным образом и уменьшает количество распределенных трассировок, которые обрабатываются поэтапно. В то же время сохраняется статистическая достоверность всех метрик, диаграмм, базовых показателей и событий, поскольку Dynatrace знает количество пропущенных распределенных трассировок. Это полностью прозрачно для вас, поскольку Dynatrace создает событие и отображает сообщение в пользовательском интерфейсе кластера.

[[Файл:adap3.png]]

Как и в случае с управлением трафиком OneAgent, сокращение объема обрабатываемых данных учитывается прозрачным образом. Это успешно защитит ваш кластер от всплесков трафика. Если такие ситуации единичны, тот факт, что не все данные обрабатываются, не оказывает негативного влияния на ваш мониторинг. Dynatrace AI никак не затрагивается и не выдает предупреждения. Все данные диаграмм на основе сервисов прозрачно корректируются (без видимых изменений), и это учитывается во всех аналитических представлениях. Вы не увидите разницы в диаграммах или данных анализа вызовов службы, если вы не смотрите на один PurePath. Единственное место, где это видно, — это список распределенных трассировок, в котором отображается сообщение типа <code>x more like this</code>.

Целевыми являются только те среды, которые имеют большой объем трафика по сравнению с назначенными им хостами. Все остальные среды остаются незатронутыми.

Если адаптивное снижение нагрузки задействуется только время от времени, чтобы покрыть пики, все, что вам нужно знать, это то, что это не должно быть долгосрочным решением. Хотя адаптивное управление трафиком OneAgent активно формирует трафик, описанная здесь функция существует только в качестве защиты. Например, спорадический инцидент ALR, который происходит раз в неделю в течение 15 минут, не обязательно означает, что кластер перегружен. Это может быть вызвано необычным скачком нагрузки или временным сбоем в сети.

Если адаптивное снижение нагрузки используется на постоянной основе в течение более длительных периодов (более 15 минут) и особенно в ситуациях, когда ALR активен все время, тот факт, что не все данные обрабатываются, может подорвать ваш мониторинг, метрики и общие данные. качественный. Чтобы предотвратить такой сценарий, вам нужно выбрать один из двух доступных вариантов. Вы можете добавить дополнительное оборудование и новый узел кластера Dynatrace Managed.предоставить вашему управляемому кластеру Dynatrace необходимые ресурсы для обработки дополнительных данных. Или вы можете уменьшить входящий трафик, настроив параметры управления трафиком для OneAgent среды. Вы также можете рассмотреть эти варианты в адаптивном управлении трафиком, когда вам недостаточно статистической корректности сбора данных и вам нужна более высокая точность данных.

== Адаптивное управление захватом ==
В Dynatrace Managed вы можете определить целевое количество недавно отслеживаемых распределенных трассировок точек входа, захватываемых на процесс в минуту.

[[Файл:adap4.png]]

По умолчанию число вновь отслеживаемых распределенных трассировок точек входа, захваченных на процесс в минуту, составляет 1000, что уже является большим числом. Изменение этого параметра может быть полезно в некоторых ситуациях. У вас может быть среда нагрузочного тестирования, которая потребляет слишком много сетевых, дисковых и ЦП ресурсов в вашем управляемом кластере Dynatrace, и вы предпочитаете использовать эту среду для производственного мониторинга. Вы можете уменьшить точность распределенной трассировки среды и, таким образом, уменьшить процент отслеживаемого входящего трафика. Другими словами, тесты могут обеспечить достаточную степень детализации данных даже после сокращения количества трасс до 500 или 100 в минуту.

Уменьшая количество захваченных распределенных трассировок, вы не меняете ни метрики, ни функции анализа службы. За пределами самого списка распределенных трасс это изменение учитывается прозрачным образом и учитывается во всех анализах.

В качестве альтернативы вы можете увеличить количество распределенных трассировок точек входа, захватываемых на процесс в минуту в наиболее важных средах, чтобы получить еще более высокую точность, чем по умолчанию. Верхний предел составляет 100 000 новых сквозных запросов/процессов/мин. Это эффективно указывает OneAgent захватывать все запросы. Это полезно, когда вам нужно обеспечить захват даже редких запросов в средах с большим объемом.

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

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

Перейдите в « Настройки » > « Мониторинг службы на стороне сервера» > « Глубокий мониторинг» .

[[Файл:adap5.png]]

Как видите, эта функция дополнительно позволяет администратору среды сократить количество распределенных трассировок во всей среде. Это полезно для уменьшения объема сетевого трафика, создаваемого OneAgent во всей среде.

== Часто задаваемые вопросы ==
''Как адаптивное управление трафиком влияет на графики, базовые показатели и оповещения?''

Короткий ответ: нисколько.

Формирование трафика учитывается прозрачно и выполняется таким образом, чтобы обеспечить статистическую достоверность при захвате редких запросов с высокой вероятностью. На всех диаграммах показано общее реальное количество запросов, обрабатываемых вашим приложением, а также весь специальный анализ, который вы можете выполнить. Это не влияет на Dynatrace AI. Единственное место, где видно это формирование трафика, — это список распределенных трассировок, в котором отображается сообщение вроде <code>x more like this</code>.

''Почему я не могу найти свой запрос?''

Если размер вашего управляемого кластера Dynatrace недостаточен или интересующий вас конкретный запрос исходит от уровня с большим объемом (более 1000 запросов в минуту), Dynatrace может не зафиксировать запрос. OneAgent делает все возможное, чтобы захватить все уникальные запросы, но есть ограничения на то, что можно сделать. Мы продолжим работать над совершенствованием этого механизма. Вы можете уменьшить объем производимого трафика, исключив из захвата неважные запросы; это делается с помощью атрибутов веб-запроса и правил исключения URL-адресов. Такой подход оставляет больше места для важных запросов.

Если это важно для вас, вы также можете увеличить количество захваченных распределенных трассировок в Dynatrace Managed.

''Что такое полный сервисный вызов?''

Полный сервисный вызов — это вызов на стороне сервера, который запускает распределенную трассировку, сервисный вызов на уровне глубокого мониторинга или настраиваемые сервисные вызовы. Внешние вызовы (такие как вызовы базы данных, внешние веб-запросы или вообще любые непрозрачные вызовы службы) не являются вызовами полного обслуживания, поэтому они не учитываются в вашем лимите трафика. Dynatrace считает все запросы к службам веб-запросов и веб-служб (кроме внешних), службам RMI, службам обмена сообщениями и пользовательским службам.

''Что такое активная хост-единица?''

Активные хост-устройства — это хост-устройства, используемые в данный момент и подключенные к среде (а не хост-устройства, назначенные среде).

''Каково минимальное количество вызовов полного обслуживания/мин в данной среде?''

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

''Каково минимальное и максимальное количество следов, которые может создать процесс?''

Система автоматически адаптирует OneAgent между 50–50 000 трассировок в минуту, чтобы соответствовать общему объему трафика, достигающему системы Dynatrace

Файл:Oneagent-adaptive-traffic-management-pipe-748-5b04a011d8.png

2023-01-22T11:50:15Z

Lobanov:

Dynatrace OneAgent

2023-01-22T11:43:11Z

Lobanov: /* Оркестрация развертывания OneAgent */

OneAgent отвечает за сбор всех данных мониторинга в отслеживаемой среде. Для сбора всех необходимых данных мониторинга требуется один OneAgent для каждого хоста, даже если ваши хосты развернуты в контейнерах Docker, архитектурах микросервисов или облачной инфраструктуре.

Один экземпляр OneAgent может выполнять мониторинг всех типов объектов, включая серверы, приложения, службы, базы данных и многое другое. OneAgent предоставляет вам все необходимые показатели операционной и бизнес-производительности, от внешнего интерфейса до серверной части и всего, что между ними - облачные экземпляры, хосты, состояние сети, процессы и службы. OneAgent обнаруживает все процессы, запущенные на ваших хостах. На основании того, что он находит, OneAgent автоматически активирует инструментарий специально для вашего уникального стека приложений. Он также внедряет все теги, необходимые для мониторинга взаимодействия с пользователем, в HTML-код страниц вашего приложения. Новые компоненты автоматически настраиваются на лету.

OneAgent состоит из нескольких модулей кода, которые позволяют ему сразу же работать с большинством технологий. Чтобы узнать, какие модули кода поддерживаются для каждой платформы, см. Платформу OneAgent и матрицу поддержки возможностей. Чтобы узнать, какие версии поддерживаются для каждого модуля кода, см. OneAgent [[Поддержка_технологий|Поддерживаемые технологии и версии]].

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

* [[OneAgent требования к памяти]]

== Возможности ==

* [[OneAgent возможности мониторинга]]
* [[Как работает OneAgent]]

== Установка и эксплуатация ==

* Облачные платформы
** AWS
** Azure
** Google Cloud Platform
** VMware
** Heroku
* Контейнерные платформы
** Kubernetes
** OpenShift
** Cloud Foundry
** Docker
** Mesos
* Операционные системы
** AIX
** [[OneAgent в Linux|Linux]]
** Solaris
** [[OneAgent в Windows|Windows]]
** zOS

== Оркестрация развертывания OneAgent ==
Вы можете развернуть OneAgent в нужном масштабе, используя предоставленные Dynatrace сценарии оркестровки. В настоящее время Dynatrace предоставляет вам коллекцию Ansible. Мы работаем над поддержкой нескольких технологий оркестровки, но вы можете помочь нам расставить приоритеты. Выберите «Я использую другой тип сценария» на странице «Установка OneAgent», чтобы отправить отзыв.

* [[Установка OneAgent с помощью Ansible|Ansible]]
* [[Установка OneAgent с помощью Puppet|Puppet]]

== Смотрите также ==

* [[Адаптивное управление и контроль трафика]]
* [[Обновление ЕдиногоАгента|Обновление OneAgent]]
* [[Механизм устаревания файлов ЕдиногоАгента|Механизм устаревания файлов OneAgent]]

== Исправление проблем ==

* [[Устранение неполадок глубокого мониторинга ЕдиногоАгента|Устранение неполадок глубокого мониторинга OneAgent]]
* [[Устранение сбоев в мониторинге]]
* [[Устранение неполадок при установке ЕдиногоАгента|Устранение неполадок при установке OneAgent]]
* [[Диагностика ЕдиногоАгента|Диагностика OneAgent]]

Установка OneAgent в Windows

2023-01-22T11:42:52Z

Lobanov:

На этой странице описано, как загрузить и установить Dynatrace OneAgent в Windows.

* Если вы являетесь клиентом Dynatrace SaaS, перейдите на , нажмите Вход в систему SaaS и войдите в систему, используя имя пользователя и пароль, которые вы получили от Dynatrace в своем электронном письме с подтверждением регистрации.
* Если вы являетесь клиентом, управляемым Dynatrace, откройте Консоль управления кластером и выберите среду, которую вы хотите отслеживать.

Затем продолжайте выполнять описанные ниже шаги по установке.

==== '''Требования и предварительные условия''' ====

* Вам нужны [[ЕдиныйАгент Безопасность в Windows|права администратора]] для серверов, на которых будет установлен OneAgent, а также для изменения настроек брандмауэра (необходимо только в том случае, если ваша внутренняя политика маршрутизации может препятствовать доступу программного обеспечения Dynatrace в Интернет).
* Вам нужны разрешения и учетные данные для перезапуска всех ваших служб приложений.
* Вам также необходимо проверить [[ЕдиныйАгент Требования к дисковому пространству в Windows|требования к дисковому пространству]].
* Хосту, на котором вы устанавливаете OneAgent, требуется не менее 200 МБ оперативной памяти.
* Установка OneAgent не поддерживается на сетевых точках подключения хранилища, управляемых такими стандартами, как NFS или iSCSI.
* Все узлы, подлежащие мониторингу, должны иметь возможность отправлять данные в кластер Dynatrace. В зависимости от того, выполняется ли развертывание Dynatrace в SaaS или в управляемой среде, а также от конфигурации сети и параметров безопасности, вы можете либо предоставить прямой доступ к кластеру Dynatrace, либо настроить ActiveGate.
* Мы рекомендуем вам удалить любой существующий драйвер <code>WinPcap</code>, чтобы разрешить установку <code>Npcap</code> — сделайте это во всех версиях Windows, за исключением <code>Windows Server 2019 build 1809 без исправления KB4571748</code>.

==== '''Удалите драйвер WinPcap, чтобы разрешить установку Npcap''' ====
Если у вас установлен драйвер <code>WinPcap</code>, мы рекомендуем вам удалить его перед установкой OneAgent и позволить установщику OneAgent установить соответствующий драйвер захвата пакетов, который поставляется вместе с установщиком OneAgent: <code>Npcap</code> является рекомендуемым драйвером захвата пакетов для OneAgent, за исключением Windows Server 20191. Вам необходимо вручную удалить <code>WinPcap</code>, так как установщик OneAgent — с параметрами по умолчанию - не будет автоматически заменять его на <code>Npcap</code>.

Чтобы установить рекомендуемый драйвер захвата пакетов, используйте параметр драйвера захвата пакетов по умолчанию при установке OneAgent (авто) или не указывайте никаких параметров драйвера захвата пакетов: с этими настройками установщик OneAgent установит <code>Npcap</code> (или <code>WinPcap</code> для Windows Server 2019), если только <code>Npcap</code> или <code>WinPcap</code> уже не установлены в системе.

OneAgent также может работать с существующими установками <code>Npcap</code>.

<code>Npcap</code> является преемником <code>WinPcap</code> и лучше всего подходит для анализа сети Dynatrace. Драйвер <code>Npcap</code>, поставляемый с установщиком OneAgent, упакован таким образом, что его файлы библиотек DLL легко интегрируются с программным обеспечением Dynatrace, что позволяет выполнять автоматические обновления. Драйвер <code>Npcap</code> устанавливается с флагом <code>/admin_only</code>, который ограничивает доступ к драйверу <code>Npcap</code> только для администраторов. Для получения дополнительной информации см. Руководство пользователя <code>Npcap</code> Для <code>WinPcap</code> таких ограничений нет.

1 Установщик OneAgent по умолчанию установит <code>Npcap</code>, за исключением <code>Windows Server 2019 build 1809 без исправления KB4571748</code>, где по соображениям совместимости будет установлен <code>WinPcap</code>.

==== '''Повторная установка или ремонт установки''' ====
Установщик OneAgent для Windows не поддерживает операции <code>изменения</code> и <code>восстановления</code>. Вы не можете переустановить OneAgent, используя ту же версию установщика, которая использовалась для установки текущего установленного OneAgent. Чтобы переустановить OneAgent, сначала удалите его или просто установите более новую версию.

==== '''Установка''' ====
1. В меню Dynatrace выберите пункт '''Развернуть Dynatrace'''.

2. Нажмите кнопку '''Начать установку''' и выберите Windows.

3. Предоставьте токен PaaS. Токен необходим для загрузки установщика OneAgent из вашей среды. Если у вас нет токена PaaS, вы можете сгенерировать его прямо в пользовательском интерфейсе. Маркер автоматически добавляется к команде загрузки, которую вы будете использовать позже.

4. Загрузите установщик. Есть два варианта:
*Выберите '''Загрузить установщик OneAgent''', чтобы загрузить установщик для Windows (EXE-файл) для установки на одном сервере.
*Загрузите через командную строку Windows. Скопируйте и запустите команду. Примечание: эта команда будет работать только с PowerShell 3.0 и TLS 1.2 (или более поздней версии)

===== '''Развертывание групповой политики?''' =====
Загрузите установщик OneAgent, предоставленный в виде EXE-файла, и запустите его с параметром --unpack-msi, чтобы извлечь пакет MSI и установочный пакетный файл. При желании вы можете указать существующий путь. Если вы пропустите путь, файлы будут сохранены в рабочем каталоге. Например:

<code>C:\Downloads\Dynatrace-OneAgent-Windows.exe --unpack-msi "C:\installers"</code>

При использовании параметра <code>--unpack-msi</code> никакие другие [[Настройка установки ЕдиногоАгента в Windows|параметры установки]] не допускаются. Добавьте параметр <code>--quiet</code>, чтобы запустить извлечение пакета MSI в тихом режиме. Используйте параметр <code>--help</code> для отображения всплывающего окна со списком доступных параметров. Скопируйте и вставьте пакет MSI и пакетный файл при настройке групповой политики для установки Dynatrace. Установка по умолчанию должна работать в большинстве случаев, но если вам нужно ее настроить, вы можете изменить параметры установки. Затем вам необходимо создать точку распространения, назначить пакет (пакет MSI OneAgent с параметрами), указать команду для установки пакета MSI в режиме автоматической установки и опубликовать свою политику.

5. <code>необязательно</code> Настройте свою установку

На этом этапе пользовательский интерфейс Dynatrace позволяет вам настроить установку OneAgent: вы можете указать ряд настроек в интерактивном режиме на экране. На основе ваших записей будет сгенерирована и отображена команда установки для использования на следующем этапе установки (см. Ниже).

Вы можете:

*Установить сетевую зону для этого хоста.
*Организовать свои хосты в группы хостов, если ваша среда сегментирована (например, на разработку и продакшен).
*Переопределить автоматически определяемое имя хоста. Это полезно в больших и динамичных средах, где определенные имена узлов могут быть неинтуитивными или часто меняться.
*Применить теги к хосту, чтобы организовать ваши отслеживаемые среды осмысленным образом.
*Включить мониторинг инфраструктуры вместо мониторинга полного стека.
*Отключить [[Мониторинг логов]].
'''Если требуются дополнительные настройки, вы можете указать [[Настройка установки ЕдиногоАгента в Windows|дополнительные параметры в командной строке]]'''

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

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

===== '''Что происходит во время установки?''' =====
OneAgent - это набор специализированных служб, которые были настроены специально для вашей среды мониторинга. Роль этих служб заключается в мониторинге различных аспектов ваших хостов, включая аппаратное обеспечение, операционную систему и прикладные процессы.

В процессе установки установщик:

* Устанавливает исполняемый код и библиотеки, используемые OneAgent.
* Создает записи в реестре Windows, которые запускают OneAgent как <code>СИСТЕМНУЮ</code> службу. Кроме того, устройство <code>oneagentmon</code> и (опционально) <code>Npcap</code> или <code>WinPcap</code> устанавливаются для обеспечения лучшей интеграции с операционной системой и облегчения сбора сетевой статистики.
* Проверяет глобальные настройки прокси-сервера системы.
* Проверяет наличие подключения к серверу Dynatrace или ActiveGate (если вы установили ActiveGate и загрузили установщик OneAgent после того, как АктивныйШлюх был подключен к Dynatrace).
* <code>OneAgent 1.193 и более ранних</code> версий Создает своего собственного пользователя (<code>dtuser</code>) для запуска расширений OneAgent. Этот пользователь является членом группы пользователей '''мониторинга производительности''' и может входить в систему только как служба. Пароль генерируется случайным образом во время установки и хранится в зашифрованном виде. Вы не можете изменить пароль. В целях безопасности пользователю <code>dtuser</code> не разрешается:
** Доступ к компьютеру из сети.
** Войдите в систему как пакетное задание.
** Войдите в систему локально.
** Войдите в систему через службы удаленного рабочего стола.
** <code>dtuser</code> необходим для правильной работы Dynatrace, поэтому вы не должны его удалять. Если по какой-либо причине <code>dtuser</code> был удален, следующее обновление воссоздаст его заново.
* <code>OneAgent 1.195+</code> Для новых установок OneAgent 1.195+ для запуска расширений OneAgent используется <code>учетная запись LocalSystem</code> по умолчанию. Краткое описание изменений, внесенных в вашу систему в результате установки OneAgent, см. в разделе [[OneAgent Безопасность в Windows|Безопасность OneAgent в Windows]].

==== '''Установка завершена!''' ====
Отлично, настройка завершена! Теперь вы можете ознакомиться с вашей новой средой мониторинга. Если вы являетесь клиентом SaaS, вы можете получить доступ к своей среде мониторинга в любое время, перейдя на веб-сайт Dynatrace и нажав кнопку входа в систему в правом верхнем углу. Если вы являетесь клиентом, управляемым Dynatrace, вы можете получить доступ к своей среде мониторинга через Консоль управления кластером.

И последнее: чтобы отслеживать ваши процессы, вам нужно их перезапустить. В любое время вы можете проверить, какие процессы не отслеживаются и нуждаются в перезапуске. Просто выберите Статус развертывания в меню навигации, перейдите на вкладку Все хосты или Недавно подключенные хосты и разверните интересующий вас хост.

OneAgent Безопасность в Windows

2023-01-22T11:42:25Z

Lobanov:

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

==== '''Разрешения''' ====
OneAgent требует права администратора в Windows как для установки, так и для работы.

==== '''Установка''' ====
Установщику OneAgent требуются права администратора для:

* Создание службы OneAgent.
* Изменение определенных разделов реестра.
* Установка WinPcap.
* Установка устройства oneagentmon.

==== '''Операция''' ====
OneAgent требует прав администратора для:

* Список всех процессов.
* Получения статистики памяти для всех процессов.
* Чтения командной строки и среды каждого процесса.
* Просмотра описания исполняемых файлов.
* Чтения конфигурации приложений для Apache и IIS
* Просмотра списка библиотек, загруженных для каждого процесса.
* Чтения разделов реестра Windows.
* Чтения домена приложений .NET для .NET 2.0, 3.0 и 3.5.
* Мониторинга сетевого трафика.
* Разбора исполняемых файлов для обнаружения Go.
* Сбора данных мониторинга, связанных с контейнерами Docker.

==== '''Изменения в операционной системе''' ====
OneAgent выполняет следующие изменения в вашей системе:

===== '''Установка''' =====
Установщик OneAgent изменяет следующие аспекты вашей системы:

* Начиная с версии 1.195, учетная запись пользователя не создается для запуска расширений OneAgent. Вместо этого используется привилегированная системная учетная запись NT AUTHORITY\SYSTEM. Дополнительные сведения см. в разделе [[Настройка установки OneAgent в Windows|настраиваемый пользователь OneAgent]].
* Создается служба Dynatrace OneAgent.
* Программа Dynatrace OneAgent регистрируется в программе установки Windows.
* устанавливается драйвер oneagentmon и создается устройство OneAgentMon. Это необходимо для обеспечения автоматического внедрения в процессы.
* устанавливается WinPcap
* Создаются поддеревья реестра:

===== '''Операция''' =====
Каждый раз, когда служба Docker обнаруживается и группируется, <code>dtuser</code> добавляется в список управления доступом <code>\\.\pipe\docker_engine</code> с правами <code>GENERIC_ALL</code>.

==== '''Добавленны файлы''' ====

===== '''Установка''' =====
Установщик OneAgent добавляет в вашу систему следующие файлы:

* Двоичные файлы и файлы конфигурации OneAgent сохраняются в <code>%PROGRAMFILES%\Dynatrace\oneagent.</code> Обратите внимание, что вы можете изменить местоположение, используя параметр INSTALL_PATH.
* Временные файлы установщика сохраняются в <code>C:\AI_RecycleBin</code>. Папка будет удалена после завершения установки.

===== '''Операция''' =====

* Временные файлы OneAgent и конфигурация среды выполнения сохраняются в <code>%PROGRAMDATA%\Dynatrace\oneagent\runtime</code>.
* Постоянная конфигурация OneAgent сохраняется в <code>%PROGRAMDATA%\Dynatrace\oneagent\config</code>.
* Большие данные во время выполнения, такие как дампы памяти, сохраняются в <code>%PROGRAMDATA%\Dynatrace\oneagent\datastorage</code>. Обратите внимание, что вы можете изменить расположение больших данных во время выполнения, используя параметр DATA_STORAGE.

==== '''Системные журналы, загруженные OneAgent''' ====
OneAgent загружает системные журналы безопасности, системы и приложений за последние 14 дней, чтобы Dynatrace могла диагностировать проблемы, которые могут быть вызваны условиями в вашей среде. Чаще всего такие проблемы связаны с глубоким мониторингом или автоматическими обновлениями.

===== '''Отмена доступа к системным журналам''' =====
Чтобы отменить доступ к системным журналам, используйте команду <code>oneagentctl</code> с параметром <code>--set-system-logs-access-enabled</code>, установленным в значение <code>false</code>.

Дополнительные сведения см. в разделе [[Настройка OneAgent через интерфейс командной строки]]

==== '''Глобально доступные для записи каталоги''' ====
[[OneAgent Требования к дисковому пространству в Windows|Структура каталогов OneAgent]] содержит глобально доступные для записи каталоги (каталоги, в которые группа пользователей <code>Everyone</code> может записывать, изменять или выполнять). Изменение этих разрешений пользователями не поддерживается.

===== '''Механизм инъекций OneAgent''' =====
Такие разрешения для выбранного набора каталогов необходимы для успешного внедрения OneAgent в процессы на отслеживаемых хостах. Когда OneAgent внедряется в процесс, модуль кода, ответственный за внедрение, выполняется в контексте исходного внедренного процесса. Следовательно, пользователям, под управлением которых выполняются эти процессы, необходимо разрешить запись в структуру каталогов OneAgent, что является причиной глобальных разрешений на запись, которые позволяют это.

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

===== '''Безопасность системы''' =====
Мы знаем, что глобальные разрешения на чтение и запись в каталогах OneAgent помечаются эвристикой проверки безопасности, но мы можем заверить вас, что они полностью безопасны.

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

==== '''Подписание установщика''' ====
Установщик OneAgent подписан на один или несколько корневых сертификатов DigiCert. Для систем с регулярным обслуживанием Windows проверяет, что установщик OneAgent был опубликован проверенным издателем.

Если ваша система под управлением Windows была отключена от сети с марта 2021 года или дольше, Windows не сможет проверить установщик, а издатель установщика OneAgent будет отображаться как Неизвестный издатель при попытке установки или обновления. В таком случае вам необходимо загрузить последнюю версию сертификата из корневых сертификатов DigiCert и добавить его в свою систему. Среди всех сертификатов DigiCert глобальный корневой сертификат DigiCert G3 является обязательным для успешной проверки установщика OneAgent.

* См. раздел [https://docs.microsoft.com/en-us/dotnet/framework/wcf/feature-details/how-to-view-certificates-with-the-mmc-snap-in Как: Просмотр сертификатов с помощью оснастки MMC] в Microsoft docs, чтобы узнать, какие корневые сертификаты установлены в вашей системе.
* Загрузите последние корневые сертификаты из [https://www.digicert.com/kb/digicert-root-certificates.htm корневых сертификатов DigiCert].

===== '''Windows 2008 R2''' =====
Начиная с версии 1.225 OneAgent, установщик подписывается с использованием алгоритма SHA-2. Следовательно, на хостах Windows 2008 R2 должна быть установлена поддержка подписи кода SHA-2. Если вы используете Центр обновления Windows, обновления были предложены вам автоматически (KB4474419 и KB4490628). Однако, если ваша система Windows 2008 R2 не поддерживает проверку установщиков, подписанных SHA-2, автоматическое обновление и установка OneAgent не будут работать, если <code>Applocker</code> настроен на блокировку неизвестных издателей и / или могут отображаться предупреждения о безопасности. Дополнительные сведения см. в объявлении Microsoft [https://support.microsoft.com/en-us/topic/2019-sha-2-code-signing-support-requirement-for-windows-and-wsus-64d1c82d-31ee-c273-3930-69a4cde8e64f 2019 о требованиях к поддержке подписи кода SHA-2 для Windows и WSUS].

2023-01-22T11:32:39Z

Lobanov: Lobanov переименовал страницу ЕдиныйАгент в Windows в OneAgent в Windows

Вы можете установить ЕдиныйАгент в Windows с помощью установщика, предоставленного в виде самораспаковывающегося EXE-файла (для установки на одном сервере), а также в виде пакета MSI для развертывания групповой политики. Для получения аналитической информации о поддерживаемых возможностях ЕдиногоАгента для Windows см. [[Платформа ЕдиныйАгент и матрица поддержки возможностей|матрицу поддержки платформы и возможностей ЕдиногоАгента]]. Чтобы узнать о поддерживаемых версиях Windows, проверьте поддерживаемые ЕдинымАгентом [[Поддержка технологий|технологии и версии]].

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

* [[ЕдиныйАгент Требования к дисковому пространству в Windows|Требования к дисковому пространству]]
* [[ЕдиныйАгент Безопасность в Windows|Безопасность ЕдиногоАгента]]
* [[Установка ЕдиногоАгента в Windows|Установка ЕдиногоАгента]]
* [[Настройка установки ЕдиногоАгента в Windows|Настройка установки]]
* [[Как передать прокси-адрес во время установки ЕдиногоАгента в Windows|Как передать прокси-адрес]]

==== '''Операции''' ====

* [[ЕдиныйАгент Требования к дисковому пространству в Windows|Файлы и журналы ЕдиногоАгента]]
* [[Обновление ЕдиногоАгента КлючАстром в Windows|Обновление ЕдиногоАгента]]
* [[ЕдиныйАгент остановка/перезапуск в Windows|Остановить/перезапустить ЕдиныйАгент]]
* [[Удаление ЕдиногоАгента Ключ-Астром в Windows|Удалить ЕдиныйАгент]]

==== '''Смотрите также''' ====

* [[ЕдиныйАгент настройка через интерфейс командной строки|Настройка ЕдиногоАгента через интерфейс командной строки]]
* Устранение неполадок