Пользовательские названия хостов

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

Однако обнаруженные имена хостов могут быть неинтуитивными или запутанными, особенно в крупных и динамических развертываниях, которые включают часто меняющиеся экземпляры хостов и имена (например, в AWS, Azure или Google Cloud).

Чтобы помочь вам в этом, Ключ-АСТРОМ позволяет переименовывать хосты вручную и программно, чтобы в веб-интерфейсе Ключ-АСТРОМ вы видели более понятные названия.

Эта функция позволяет вам применить к хосту более читабельное и полезное отображаемое название.

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

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

Переименовать один хост вручную

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

1. Перейдите в раздел Хосты (последняя версия Ключ-АСТРОМ) и выберите хост.
2. На странице сведений о хосте выберите Дополнительно ( … ) > Настройки в правом верхнем углу.
3. На странице Общие введите новое имя хоста .

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

Автоматически переименовать несколько хостов

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

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

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

1. Перейдите в Настройки > Мониторинг > Именование хостов .
2. На странице Именование хоста выберите Добавить новое правило .
3. Введите название правила .
4. Задайте формат имени хоста , который вы хотите отобразить. Это может быть:
   • Статический текст, который вы вводите или вставляете в поле.
   • Заполнители, которые вы выбираете из списка, который автоматически отображается при выборе в поле редактирования. Пример: введите CPU cores = и выберите заполнитель {Host:CpuCores} из списка в поле редактирования. Это сгенерирует имя хоста CPU cores = 8 для хоста с 8 ядрами процессора.
5. необязательный В разделе Правило применяется к объектам, соответствующим следующим свойствам , присвойте свое правило к определенной группе хостов или технологии.
   • Выберите группу хостов, чтобы применить правило только к хостам в выбранной группе хостов.
   • Выберите технологию, чтобы применить правило только к хостам, работающим под управлением выбранной технологии, например Kubernetes или OpenShift.
6. необязательный В разделе Условия используйте списки для создания условия для правила именования. Пример: применить это правило только к хостам Windows
   • Выберите OS type
   • Выберите equals
   • Выберите Windows Чтобы добавить еще одно условие, выберите Добавить условие и повторите этот шаг.
7. Выберите Предварительный просмотр , чтобы вывести список соответствующих объектов по текущему имени и новому имени , которое будет отображаться после применения правила.
   • Если правило все еще требует доработки, отредактируйте его, а затем снова нажмите Предварительный просмотр, чтобы увидеть изменения.
   • Если вас устраивает список предварительного просмотра, выберите Создать правило .
8. необязательный Чтобы добавить еще одно правило, повторите процедуру.

Переименовать с помощью инструмента командной строки

ЕдиныйАгент версии 1.189+

Используйте командную строку oneagentctl с параметром --set-host-name, чтобы переопределить автоматически обнаруженное имя хоста. Имя хоста не должно содержать символы <, >, &, CR или LF. Максимальная длина имени — 256 символов.

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

Чтобы изменить имя хоста:

• Linux или AIX : ./oneagentctl --set-host-name=myhostname
• Windows : .\oneagentctl.exe --set-host-name=myhostname

Чтобы вернуться к автоматически обнаруженному имени хоста, задайте для параметра --set-host-name пустое значение, например : --set-host-name="". Например:

• Linux или AIX : ./oneagentctl --set-host-name=""
• Windows : .\oneagentctl.exe --set-host-name=""

Изменение может не отразиться в веб-интерфейсе Ключ-АСТРОМ в течение 6 минут.

Использование --set-host-name требует перезапуска ЕдиногоАгента. Добавьте --restart-service к команде для автоматического перезапуска ЕдиногоАгента (версия 1.189+) или остановки и запуска процесса ЕдиногоАгента вручную. Инструкции для конкретных ОС см. в разделах Linux , Windows или AIX.

Чтобы отобразить имя хоста:

• Linux или AIX : ./oneagentctl --get-host-name
• Windows : .\oneagentctl.exe --get-host-name

Для получения дополнительной информации oneagentctl см. раздел Настройка ЕдиногоАгента через интерфейс командной строки.

Переименовать с помощью файла конфигурации

ЕдиныйАгент версии 1.187 и более ранних

Используйте файл конфигурации только для ЕдиногоАгента версии 1.187 и более ранних. Для более поздних версий используйте командную строку oneagentctl, как описано в предыдущем разделе.

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

1. Создайте простой файл hostname.conf на контролируемом хосте (должен быть ЕдиныйАгент версии 1.187 или более ранней).
   • Для Windows создайте файл в формате Unicode %PROGRAMDATA%\dynatrace\oneagent\agent\config. Обратите внимание, что кодировка Unicode недоступна в Windows.
   • Для Linux создайте файл в /var/lib/dynatrace/oneagent/agent/config
2. Создайте правило именования хостов в файле hostname.conf: Пример:

My App Server

После перезапуска службы ЕдиногоАгента Ключ-АСТРОМ подберет новое имя хоста и применит его. Обратите внимание, что имя хоста, введенное на странице настроек хоста , имеет приоритет над именем, сохранённым в файле конфигурации hostname.conf.