31.2. Agents #
For more information about agents, refer to Chapter 3.
31.2.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.
Host: 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 Host, Port, and Protocol parameters.
Click Save.
31.2.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.
31.2.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.
31.2.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.