Обновление OneAgent

Материал из Dynatrace

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 в этой группе узлов.
      • Текущая глобальная настройка отображается в скобках в этой строке.
      • Чтобы перейти на страницу глобальной конфигурации, выберите глобальную ссылку.
  • Автоматические обновления при первой же возможности
    • Обновляйте все экземпляры 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. Опишите период обслуживания:

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

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.