43.3. Viewing and Customizing an Instance Overview #
An instance overview page displays a customizable dashboard with widgets containing various information about the instance.
You can add, edit, rearrange, and delete widgets. The configured layout is saved in the browser's local storage, restored between sessions, and shared across the overview pages of all instances. However, if you open PPEM in a different browser or on another device, the default layout will be displayed there.
43.3.1. Viewing an Instance Overview #
To view an instance overview:
In the navigation panel, go to Infrastructure → Instances.
Click the name of the instance.
The instance overview page will be displayed. By default, it contains the following widgets:
General information: Information about the instance environment, including the operating system, Postgres Pro and PPEM agent versions, the data directory, tablespaces and databases, and the agent connection string.
Instance: Performance and state of the instance, including its start time, replication role, workload and connection activity, buffer cache usage, WAL activity and archiving, and the data integrity state.
Server: Resource usage of the server where the instance runs, including the number of active instances, CPU and memory load, as well as the usage of the data directory file system.
The following charts:
Instance: Connections.
Instance: Transactions rate, pcs..
System: Memory usage, B.
System: CPU usage.
43.3.2. Customizing an Instance Overview #
43.3.2.1. Adding a Widget #
In the navigation panel, go to Infrastructure → Instances.
Click the name of the instance.
In the top-right corner of the page, click .
Click Add widget.
Select the widget type and data source.
The following widget types are available:
Table: A table with instance data, such as tables, indexes, roles, or sequences.
The available data sources:
Instance data
Tables
Indexes
Roles
Sequences
Chart: A chart that displays instance metrics.
The available data sources are represented by the list of charts that can be displayed for the instance.
Counters: The number of objects of a certain type, for example, tablespaces, databases, or active instances.
The available data sources: Counters.
Info table: Information about the instance, its server, and other data, presented as a table.
The available data sources:
General information
Server
Instance
Set the widget width.
Click Save in the new widget tile.
In the top-right corner of the page, click Save.
43.3.2.2. Editing a Widget #
In the navigation panel, go to Infrastructure → Instances.
Click the name of the instance.
In the top-right corner of the page, click .
Click on the widget.
Change the data source or width of the widget, and click Save. The widget type cannot be changed.
In the top-right corner of the page, click Save.
43.3.2.3. Rearranging Widgets #
In the navigation panel, go to Infrastructure → Instances.
Click the name of the instance.
In the top-right corner of the page, click .
To change the position of a widget, drag and drop it.
In the top-right corner of the page, click Save.
43.3.2.4. Deleting a Widget #
In the navigation panel, go to Infrastructure → Instances.
Click the name of the instance.
In the top-right corner of the page, click .
Click on the widget.
In the top-right corner of the page, click Save.
Note
If all widgets are deleted, the dashboard displays the Restore default widgets and Add widget buttons.