5.3. System Configuration #
This section explains how to view PPEM summary information, as well as how to manage agents and tags.
5.3.1. Viewing PPEM Summary Information #
In the navigation panel, go to About PPEM.
The following blocks will be displayed:
Platform: Information about the server where the manager is installed.
The following parameters are displayed:
Platform: The architecture of the server CPU.
Kernel: The Linux kernel version.
System: The version of the operating system installed on the server.
Nodename: The FQDN of the server.
Manager: Information about the manager.
The following parameters are displayed:
Version: The manager version.
Configuration: The path to the server catalog where the
ppem-manager.ymlconfiguration file is located.
Repository: Information about the repository.
The following parameters are displayed:
Version: The repository version.
Connection: The connection string for connecting to the repository database.
Useful links: Links to the Postgres Pro official documentation.
5.3.2. Agents #
This section explains how to manage agents. It includes the following instructions:
For more information about agents, refer to Architecture.
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.
Enter 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.
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.
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.
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.
5.3.3. Tags #
Tags are unique labels that can be assigned to instances when creating and editing instances. You can filter instances by assigned tags.
This section explains how to manage tags. It includes the following instructions:
Creating a Tag
In the navigation panel, go to Settings.
In the top-right corner of the page, click Add tag.
Enter parameters of the new tag (parameters marked with an asterisk are required):
Description.
Display name.
Click Add.
Viewing Tags
In the navigation panel, go to Settings.
The table of tags with the following columns will be displayed:
Description.
Display name.
Actions.
For more information about available actions, refer to other instructions in this section.
Editing a Tag
In the navigation panel, go to Settings.
Click
next to the tag. Edit tag parameters.
Click Save.
Deleting a Tag
Important
Deleted tags cannot be restored.
To delete a tag:
In the navigation panel, go to Settings.
Click
next to the tag. Click Delete.