41.3. Агенты #
За подробной информацией об агентах обратитесь к Главе 3.
41.3.1. Добавление агента #
После установки на сервере агент автоматически создаётся в веб-приложении. Если этого не произошло, установленный агент можно добавить вручную.
Чтобы добавить агент:
В навигационной панели перейдите в Инфраструктура → Агенты.
В правом верхнем углу страницы нажмите Добавить агент.
Укажите параметры нового агента (помеченные звёздочкой параметры являются обязательными):
Имя.
Сервер: сетевой адрес сервера, на котором установлен агент.
Порт: номер порта, на котором сервер прослушивает входящие подключения.
Протокол: протокол, используемый агентом.
Возможные значения:
http
https
Примечание
На основании параметров Сервер, Порт и Протокол автоматически формируется URL для подключения агента к менеджеру.
Нажмите Сохранить.
41.3.2. Просмотр агентов #
В навигационной панели перейдите в Инфраструктура → Агенты.
Отобразится таблица агентов со следующими столбцами:
Агент: уникальное имя агента.
Если агент был создан в веб-приложении автоматически, имя генерируется на основании имени хоста сервера, на котором установлен агент.
Слева от имени агента отображается индикатор его статуса. Статус можно просмотреть, наведя курсор на имя агента.
Возможные статусы:
online: агент работает штатно.stopped: служба агента была остановлена.unknown: статус агента неизвестен.not_responding: не удаётся связаться со службой агента.
URL: URL для подключения агента к менеджеру.
Ключ аутентификации: ключ, который агент использует для аутентификации при подключении к менеджеру.
Версия.
Если версия агента отличается от версии менеджера, отображается соответствующее предупреждение.
Действия.
За подробной информацией о доступных действиях обратитесь к другим инструкциям в этом разделе.
41.3.3. Редактирование агента #
По умолчанию агенты автоматически обновляют информацию о себе и внесённые изменения со временем перезаписываются.
Автоматическое обновление можно отключить, задав true для параметра collectors.instances.disabled в файле конфигурации агента ppem-agent.yml.
Чтобы отредактировать агент:
В навигационной панели перейдите в Инфраструктура → Агенты.
Нажмите рядом с агентом.
Отредактируйте параметры агента.
Нажмите Сохранить.
41.3.4. Удаление агента #
Важно
После удаления агента из веб-приложения его также необходимо удалить на сервере. В противном случае агент снова будет автоматически создан в веб-приложении.
Чтобы удалить агент:
В навигационной панели перейдите в Инфраструктура → Агенты.
Нажмите рядом с агентом.
Нажмите Удалить.
41.3. Agents #
For more information about agents, refer to Chapter 3.
41.3.1. Adding an Agent #
Once installed on the server, the agent is automatically created in the web application. If this does not happen, you can add the installed agent manually.
To add an agent:
In the navigation panel, go to Infrastructure → Agents.
In the top-right corner of the page, click Add agent.
Specify parameters of the new agent (parameters marked with an asterisk are required):
Name.
Server: The network address of the server where the agent is installed.
Port: The port number that the server uses to listen for incoming connections.
Protocol: The protocol used by the agent.
Possible values:
http
https
Note
The URL for connecting the agent to the manager is generated automatically based on the Server, Port, and Protocol parameters.
Click Save.
41.3.2. Viewing Agents #
In the navigation panel, go to Infrastructure → Agents.
The table of agents with the following columns will be displayed:
Agent: The unique name of the agent.
If the agent is automatically created in the web application, the name is generated based on the host name of the server where the agent is installed.
The agent status indicator is displayed to the left of the agent name. You can view the status by hovering over the agent name.
Possible statuses:
online: The agent is working normally.stopped: The agent service was stopped.unknown: The agent status is unknown.not_responding: Failed to access the agent service.
URL: The URL for connecting the agent to the manager.
Authentication key: The key that the agent uses to authenticate when connecting to the manager.
Version.
If the agent version differs from the manager version, the corresponding warning is displayed.
Actions.
For more information about available actions, refer to other instructions in this section.
41.3.3. Editing an Agent #
By default, agents automatically update their information, so the changes you make get overwritten over time.
You can disable the automatic update by setting the collectors.instances.disabled parameter to true in the ppem-agent.yml agent configuration file.
To edit an agent:
In the navigation panel, go to Infrastructure → Agents.
Click next to the agent.
Edit agent parameters.
Click Save.
41.3.4. Deleting an Agent #
Important
After deleting the agent from the web application, you must also delete it from the server. Otherwise, the agent will be automatically recreated in the web application.
To delete an agent:
In the navigation panel, go to Infrastructure → Agents.
Click next to the agent.
Click Delete.