Capacity Manager v8

PEM's Capacity Manager analyzes collected statistics (metrics) to generate a graph or table that displays the historical usage statistics of an object, and can project the anticipated usage statistics for an object. You can configure Capacity Manager to collect and analyze metrics for a specific:

  • Host/operating system
  • EDB Postgres Advanced Server or PostgreSQL server
  • Database
  • Database object (table, index, function etc).

You can tailor the content of the Capacity Manager report by choosing a specific metric (or metrics) to include in the report, the time range over which the metrics were gathered, and a high or low threshold for the metrics analyzed. You can also specify a start and end date for the Capacity Manager report. If the end date of the report specifies a time in the future, Capacity Manager will analyze the historical usage of the selected object to extrapolate the projected object usage in the future.

To open Capacity Manager, select the Capacity Manager... option from the Management menu in the PEM client window; the Capacity Manager wizard opens, displaying a tree control on the Metrics tab.

Capacity Manager dialog

Expand the tree control on the Metrics tab to select the metrics that will be included in the Capacity Manager report.

When defining report options, you can specify an aggregation method for each selected metric. The aggregation method determines how Capacity Manager will analyze the data points within the sampling period to reduce the data to a more visually meaningful quantity within a report (if required). The aggregation method can instruct Capacity Manager to compute an average of the data within a time period, the high or low value, or the first sampled value.

Use the Options tab to specify additional report details.

When defining the boundaries of a Capacity Manager report, specify the starting date and time, and an end boundary. The end boundary can be a point in time or a threshold boundary (when the data meets a specified criteria). If the sample contains more data points than the number of points specified by the cm_data_points_per_report configuration parameter, Capacity Manager applies the aggregation method to calculate a reduced number of graph points for the report.

Report Templates

You can save a report definition as a template for future reports. Capacity Manager report templates may be accessed by all PEM users. To save a report definition as a template:

  1. Use the Metrics and Options tabs to define your report.
  2. Click the Save button to open the Save Template dialog.
  3. Provide a report name in the Title field, select a location to store the template in the tree control.
  4. Click OK.

When creating a report, you can use the Load Template button to browse and open an existing template. Once opened, the report definition may be modified if required, and optionally saved again, either as a new template, or overwriting the original template. Use the Manage Templates button open a dialog that allows you to rename or remove unwanted templates.

Available Metrics

Please Note that the available metrics will vary by platform, and are subject to change. The available metrics may include the metrics described in the table below:

Metric NameDescription
# Dead TuplesThe number of dead tuples in the selected table.
# Dead Tuples+The cumulative number of dead tuples in the selected table.
# Heap Tuples Fetched by Index ScansThe number of heap tuples fetched by index scans.
# Heap Tuples Fetched by Index Scans+The cumulative number of heap tuples fetched by index scans.
# Idle Backends+The cumulative number of currently idle backend clients.
# Index ScansThe number of index scans performed on the specified object.
# Index Scans+The cumulative number of index scans performed on the specified object.
# Index Tuples ReadThe number of index tuples read.
# Index Tuples Read+The cumulative number of index tuples read.
# Live TuplesThe number of tuples visible to transactions.
# Live Tuples+The cumulative number of tuples visible to transactions.
# Pages Estimated by ANALYZEThe number of pages estimated by ANALYZE.
# Pages Estimated by ANALYZE+The cumulative number of pages estimated by ANALYZE.
# Sequential ScansThe number of sequential scans performed on the specific table.
# Sequential Scans+The cumulative number of sequential scans performed on the specific table.
# Sequential Scan TuplesThe number of tuples sequentially scanned in the specific table.
# Sequential Scan Tuples+The cumulative number of tuples sequentially scanned in the specific table.
# Tuples DeletedThe number of tuples deleted.
# Tuples Deleted+The cumulative number of tuples deleted.
# Tuples Estimated by ANALYZEThe number of live (visible) tuples estimated by ANALYZE.
# Tuples Estimated by ANALYZE+The cumulative number of live tuples estimated by ANALYZE.
# Tuples HOT UpdatedThe number of tuples HOT updated. In a HOT update, the new tuple resides in the same block as the original tuple and the tuples share an index entry.
# Tuples HOT Updated+The cumulative number of tuples HOT updated.
# Tuples InsertedThe number of tuples inserted into the specified table.
# Tuples Inserted+The cumulative number of tuples inserted into the specified table.
# Tuples UpdatedThe number of tuples updated in the selected table.
# Tuples Updated+The cumulative number of tuples updated in the selected table.
Blocks HitThe number of blocks found in the cache.
Blocks Hit+The cumulative number of blocks found in the cache.
Blocks ReadThe number of blocks read.
Blocks Read+The cumulative number of blocks read.
Blocks Read from InfiniteCacheThe number of blocks read from InfiniteCache.
Blocks Read from InfiniteCache+The cumulative number of blocks read from InfiniteCache.
Blocks WrittenThe number of blocks written.
Blocks Written+The cumulative number of blocks written.
Buffers AllocatedThe number of buffers allocated.
Buffers Allocated+The cumulative number of buffers allocated.
Buffers Written - BackendsThe number of buffer blocks written to disk by server processes (processes connected to a client application).
Buffers Written - Backends+The cumulative number of buffer blocks written to disk by server processes.
Buffers Written - CheckpointThe number of blocks written to disk by the checkpoint process.
Buffers Written - Checkpoint+The cumulative number of blocks written to disk by the checkpoint process.
Buffers Written - Cleaning ScanThe number of blocks written to disk by the autovacuum process.
Buffers Written - Cleaning Scan+The cumulative number of blocks written to disk by the autovacuum process.
Bytes Received (KB)The number of bytes received from the client (in kilobytes).
Bytes Received (KB)+The cumulative number of bytes received (in kilobytes).
Bytes Sent (KB)The number of bytes sent to the client (in kilobytes).
Bytes Sent (KB)+The cumulative number of bytes sent (in kilobytes).
Checkpoints - TimedThe number of checkpoint operations triggered by the checkpoint interval.
Checkpoints - Timed+The cumulative number of checkpoint operations triggered by the checkpoint interval.
Checkpoints - UntimedThe number of checkpoint operations triggered by checkpoint size.
Checkpoints - Untimed+The cumulative number of checkpoint operations triggered by checkpoint size.
Database Size (MB)The size of the specified database (in megabytes).
Free RAM MemoryThe amount of free RAM memory (in megabytes).
Free Swap MemoryThe amount of free swap space on disk (in megabytes).
Heap Blocks HitThe number of heap blocks found in the cache.
Heap Blocks Hit+The cumulative number of heap blocks found in the cache.
Heap Blocks ReadThe number of heap blocks read.
Heap Blocks Read+The cumulative number of heap blocks read.
Index Blocks HitThe number of index blocks found in the cache.
Index Blocks Hit+The cumulative number of index blocks found in the cache.
Index Blocks ReadThe number of index blocks read.
Index Blocks Read+The cumulative number of index blocks read.
Index Size (MB)The size of the specified index (in megabytes).
In Packets DiscardsThe number of inbound packets discarded.
In Packets Discards+The cumulative number of inbound packets discarded.
In Packets ErrorsThe number of inbound packets that contain errors.
In Packets Errors+The cumulative number of inbound packets that contain errors.
Link Bandwidth (Mbit/s)The speed of the network adapter (in megabits per second).
Load Average - 15 MinuteCPU saturation (in percent) - 15 minute sampling average.
Load Average - 1 MinuteCPU saturation (in percent) - 1 minute sampling average.
Load Average - 5 MinuteCPU saturation (in percent) - 5 minute sampling average.
Load PercentageCPU saturation in percent.
Number of Prepared Transactions+The cumulative number of prepared transactions.
Number of WAL Files+The cumulative number of write-ahead log files.
Out Packets DiscardsThe number of outbound packets discarded.
Out Packets Discards+The cumulative number of outbound packets discarded.
Out Packets ErrorsThe number of outbound packets that contain errors.
Out Packets Errors+The cumulative number of outbound packets that contain errors.
Packets ReceivedThe number of packets received.
Packets Received+The cumulative number of packets received.
Packets SentThe number of packets sent.
Packets Sent+The cumulative number of packets sent.
Size (MB)The total size of the disk (in megabytes).
Size of Indexes (MB)The size of indexes on the specified table (in megabytes).
Space Available (MB)The current disk space available (in megabytes).
Space Used (MB)The current disk space used (in megabytes).
Table Size (MB)The size of the specified table (in megabytes).
Tablespace Size (MB)The size of the specified tablespace (in megabytes).
Temp Buffers (MB)The size of temporary buffers (in megabytes).
Toast Blocks HitThe number of TOAST blocks found in the cache.
Toast Blocks Hit+The cumulative number of TOAST blocks found in the cache.
Toast Blocks ReadThe number of TOAST blocks read.
Toast Blocks Read+The cumulative number of TOAST blocks read.
Total RAM MemoryThe total amount of RAM memory on the system (in megabytes).
Total Swap MemoryThe total amount of swap space on the system (in megabytes).
Total Table Size w/Indexes and ToastThe total size of the specified table (including indexes and associated oversized attributes).
Transactions AbortedThe number of aborted transactions.
Transactions Aborted+The cumulative number of aborted transactions.
Transactions CommittedThe number of committed transactions.
Transactions Committed+The cumulative number of committed transactions.
Tuples DeletedThe number of tuples deleted from the specified table.
Tuples Deleted+The cumulative number of tuples deleted from the specified table.
Tuples Estimated by ANALYZEThe number of visible tuples in the specified table.
Tuples Estimated by ANALYZE+The cumulative number of visible tuples in the specified table.
Tuples FetchedThe number of tuples fetched from the specified table.
Tuples Fetched+The cumulative number of tuples fetched from the specified table.
Tuples HOT UpdatedThe number of tuples HOT updated. In a HOT update, the new tuple resides in the same block as the original tuple and the tuples share an index entry.
Tuples HOT Updated+The cumulative number of tuples HOT updated. In a HOT update, the new tuple resides in the same block as the original tuple and the tuples share an index entry.
Tuples InsertedThe number of tuples inserted into the specified table.
Tuples Inserted+The cumulative number of tuples inserted into the specified table.
Tuples ReturnedThe number of tuples returned in result sets.
Tuples Returned+The cumulative number of tuples returned in result sets.
Tuples UpdatedThe number of tuples updated in the specified table.
Tuples Updated+The cumulative number of tuples updated in the specified table.
WAL Segment Size (MB)The segment size of the write-ahead log (in megabytes).

Note: The '+' following the name of a metric signifies that the data for the metric is gathered cumulatively; those metrics that are not followed by the '+' sign are collected as a 'point-in-time' value.

capacity_manager_metrics capacity_manager_options