oracle enterprise manager plug-in for postgresql - s3.amazonaws.com · click test connection to...

27
ORACLE ENTERPRISE MANAGER PLUG-IN FOR PostgreSQL User Guide

Upload: ngodieu

Post on 23-Aug-2018

318 views

Category:

Documents


3 download

TRANSCRIPT

Page 1: ORACLE ENTERPRISE MANAGER PLUG-IN FOR PostgreSQL - s3.amazonaws.com · Click Test Connection to ensure Enterprise Manager can connect to the specified database. 3. Click OK to save

ORACLE ENTERPRISE MANAGER PLUG-IN FOR

PostgreSQLUser Guide

Page 2: ORACLE ENTERPRISE MANAGER PLUG-IN FOR PostgreSQL - s3.amazonaws.com · Click Test Connection to ensure Enterprise Manager can connect to the specified database. 3. Click OK to save

2 Oracle Enterprise Manager Plug-in for PostgreSQL User Guide

NOTE: This document supports the version of each product listed, as well as all subsequent versions, until a new edition replaces it.

You can find the most up-to-date technical documentation on the Blue Medora support site at: http://support.bluemedora.com.

The Blue Medora website also provides the latest product updates. If you have comments about this documentation, submit your feedback to: [email protected].

1. Platforms and Versions Supported . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31.1 Oracle Enterprise Manager (OEM) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31.2 PostgreSQL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31.3 Oracle Management Agent (OMA) Operating Systems . . . . . . . . . . . . . . . . . . . 31.4 Oracle Management Server (OMS) Operating Systems . . . . . . . . . . . . . . . . . . 31.5 PostgreSQL Database Operating System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

2. Prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32.1 Monitoring Connectivity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32.2 PostgreSQL Monitoring Setup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

3. Install and Configure the Plug-in . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43.1 Importing the OPAR File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43.2 Deploying the Plug-in on a Management Server (OMS) . . . . . . . . . . . . . . . . . 53.3 Deploying the Plug-in on Management Agent (OMA) . . . . . . . . . . . . . . . . . . . . . 6

4. Setting Up a Target . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74.1 Adding Targets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74.2 Specifying Target Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

5. Adding a License . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

6. Monitoring Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126.1 Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126.2 Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136.3 Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146.4 Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156.5 Indices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166.6 Queries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

7. Appendix I: Metrics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

8. Appendix II: Revision Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

TABLE OF CONTENTS

Page 3: ORACLE ENTERPRISE MANAGER PLUG-IN FOR PostgreSQL - s3.amazonaws.com · Click Test Connection to ensure Enterprise Manager can connect to the specified database. 3. Click OK to save

3 Oracle Enterprise Manager Plug-in for PostgreSQL User Guide

1. Platforms and Versions Supported1.1 Oracle Enterprise Manager (OEM)

• Oracle Enterprise Manager Cloud Control 12c (12.1.0.3.0+)

• Oracle Enterprise Manager Cloud Control 13c (13.1.0.0.0+)

1.2 PostgreSQL

• PostgreSQL versions 9.3 – 9.6, 10

1.3 Oracle Management Agent (OMA) Operating Systems

• Microsoft Windows (64 bit) supported by the OMA

• Linux (64 bit) supported by the OMA

1.4 Oracle Management Server (OMS) Operating Systems

• All Oracle-supported OMS platforms

1.5 PostgreSQL Database Operating System

• All PostgreSQL-supported platforms (for remote monitoring)

2. PrerequisitesNOTE: Refer to: https://support.bluemedora.com/s/article/Prerequisites-Guide-EM-Plugin-for-PostgreSQL for more detailed information about the necessary prerequisites for this plug-in.

2.1 Monitoring Connectivity

• Create a PostgreSQL user, with permission to the databases to be monitored.

NOTE: For security, an administrative-level monitoring user (i.e., “super user”) is required to view the SQL text or queryid of queries executed by other users. A warning icon will be displayed on the plug-in’s home page if a read-only user is used. Tablespace data also requires an administrative-level monitoring user.

• Enable remote access for the new user.

• Update the pg_hba.conf file to allow Enterprise Manager IP to remotely connect as the new user (Refer to: http://www.postgresql.org/docs/9.3/static/auth-pg-hba-conf.html)

2.2 PostgreSQL Monitoring Setup

• Enable statistics monitoring.

• Verify pg_stat views are available in the “primary” database (Refer to: http://www.postgresql.org/docs/9.3/static/monitoring-stats.html)

• Install PostgreSQL SQL Statements extension.

• Verify pg_stat_statements extension is installed (Refer to: http://www.postgresql.org/docs/9.3/static/pgstatstatements.html)

• Verify pg_stat_statements view is available in the “primary” database

NOTE: The “primary” database is the only location SQL statements statistics are collected from, since any location pg_stat_statements is queried from will return data about statements run in all databases.

WARNING: Ensure pg_stat_statements is viewable from the “primary” database, otherwise no query statistics will be collected.

Page 4: ORACLE ENTERPRISE MANAGER PLUG-IN FOR PostgreSQL - s3.amazonaws.com · Click Test Connection to ensure Enterprise Manager can connect to the specified database. 3. Click OK to save

4 Oracle Enterprise Manager Plug-in for PostgreSQL User Guide

3. Install and Configure the Plug-in3.1 Importing the OPAR File

1. Log in to the emcli utility with the login command and enter the password when prompted:

emcli login -username=sysman

2. Ensure emcli is synchronized with the sync command:

emcli sync

3. View emcli configuration information with the status command:

emcli status

4. Import the OPAR file with the import update command:

emcli import_update -file=”<path to .opar file>” -omslocal

5. From Enterprise Manager, navigate to (Setup) Ò Extensibility Ò Self Update.

6. Click Check Updates.

7. Select the Plug-in folder from the Self Update page and confirm the PostgreSQL plug-in has been downloaded successfully. Refer to Figure 1.

Figure 1: Self Update Page

Page 5: ORACLE ENTERPRISE MANAGER PLUG-IN FOR PostgreSQL - s3.amazonaws.com · Click Test Connection to ensure Enterprise Manager can connect to the specified database. 3. Click OK to save

5 Oracle Enterprise Manager Plug-in for PostgreSQL User Guide

3.2 Deploying the Plug-in on a Management Server (OMS)

1. From Enterprise Manager, navigate to (Setup) Ò Extensibility Ò Plug-ins.

2. Expand the Databases folder and select the PostgreSQL plug-in.

3. From the Actions menu, select Deploy On Ò Management Servers.

4. Follow the on-screen instructions to complete the process.

Figure 2: Deploy on Management Server

Page 6: ORACLE ENTERPRISE MANAGER PLUG-IN FOR PostgreSQL - s3.amazonaws.com · Click Test Connection to ensure Enterprise Manager can connect to the specified database. 3. Click OK to save

6 Oracle Enterprise Manager Plug-in for PostgreSQL User Guide

3.3 Deploying the Plug-in on Management Agent (OMA)

1. From Enterprise Manager, navigate to (Setup) Ò Extensibility Ò Plug-ins.

2. Expand the Databases folder and select the PostgreSQL plug-in.

3. From the Actions menu, select Deploy On Ò Management Agent.

4. Follow the on-screen instructions to complete the process.

Figure 3: Deploy on Management Agent

Page 7: ORACLE ENTERPRISE MANAGER PLUG-IN FOR PostgreSQL - s3.amazonaws.com · Click Test Connection to ensure Enterprise Manager can connect to the specified database. 3. Click OK to save

7 Oracle Enterprise Manager Plug-in for PostgreSQL User Guide

4. Setting Up a Target4.1 Adding Targets

1. From Enterprise Manager, navigate to (Setup) Ò Add Target Ò Add Targets Manually.

2. From the Add Targets Manually page, select Add Target Declaratively.

Figure 4: Add Targets Manually Page

3. Enter the host name. You can type it in or search for it by clicking on the magnifying glass.

4. Select ‘PostgreSQL Database’ for Target Type.

5. Click Add to specify target properties.

Figure 5: Add Target Declaratively Window

Page 8: ORACLE ENTERPRISE MANAGER PLUG-IN FOR PostgreSQL - s3.amazonaws.com · Click Test Connection to ensure Enterprise Manager can connect to the specified database. 3. Click OK to save

8 Oracle Enterprise Manager Plug-in for PostgreSQL User Guide

4.2 Specifying Target Properties

1. Enter the following information on the Add: PostgreSQL Database page:

TARGET PROPERTY DESCRIPTION

Database Hostname Host name of PostgreSQL server

Database Login Name Monitoring user name

Database Login Password Monitoring user password

Database Port PostgreSQL port number (default = 5432)

Primary Database The plug-in requires a “primary” database to connect to (default = ‘postgres’)

2. Click Test Connection to ensure Enterprise Manager can connect to the specified database.

3. Click OK to save your target.

Figure 6: Specify Target Properties

Page 9: ORACLE ENTERPRISE MANAGER PLUG-IN FOR PostgreSQL - s3.amazonaws.com · Click Test Connection to ensure Enterprise Manager can connect to the specified database. 3. Click OK to save

9 Oracle Enterprise Manager Plug-in for PostgreSQL User Guide

5. Adding a License

1. Navigate to (Setup) ÒProvisioning and Patching Ò Software Library.

Figure 7: Setup ÒProvisioning and Patching Ò Software Library

2. In the Software Library: Administration window, click the Software Library link.

Figure 8: Software Library: Administration

3. In the Software Library window, click the the Actions drop-down menu, then select Create Folder.

Figure 9: Software Library: Administration

Page 10: ORACLE ENTERPRISE MANAGER PLUG-IN FOR PostgreSQL - s3.amazonaws.com · Click Test Connection to ensure Enterprise Manager can connect to the specified database. 3. Click OK to save

10 Oracle Enterprise Manager Plug-in for PostgreSQL User Guide

4. In the Create Folder window, enter a descriptive name for the folder that will hold your plugin license(s) (e.g., Licenses), then click OK.

Figure 10: Create Folder window

5. Back in the Software Library window, highlight the folder you just created in the list, then click the Actions drop-menu menu again and select Create Entity Ò Component.

Figure 11: Actions Ò Create Entity Ò Component

Page 11: ORACLE ENTERPRISE MANAGER PLUG-IN FOR PostgreSQL - s3.amazonaws.com · Click Test Connection to ensure Enterprise Manager can connect to the specified database. 3. Click OK to save

11 Oracle Enterprise Manager Plug-in for PostgreSQL User Guide

6. In the Create Entity: Component dialog box, keep the default “Generic Component” selection, then click Continue.

Figure 12: Create Entity: Component window

7. In the Create Generic Component: Describe window that appears:

• Name: Enter a name for your license. (NOTE: Your name must include the word “License” in it.)

• Description: Copy your Blue Medora license key here.

• Click Save to save your license.

Figure 13: Create Generic Component: Describe window

NOTE: The following error pop-up message will occur if a loaded target does not have sufficient licensing, or if no license has been added.

Figure 14: Licensing Error

Page 12: ORACLE ENTERPRISE MANAGER PLUG-IN FOR PostgreSQL - s3.amazonaws.com · Click Test Connection to ensure Enterprise Manager can connect to the specified database. 3. Click OK to save

12 Oracle Enterprise Manager Plug-in for PostgreSQL User Guide

6. Monitoring FeaturesThe Oracle Enterprise Manager Plug-in for PostgreSQL provides monitoring of nearly 200 key metrics for a PostgreSQL instance. Thresholds and metric history are available for each PostgreSQL instance, as well as advanced custom views of the instance and individual databases. These views present large amounts of complex data in an easy-to-consume manner, allowing the user to quickly identify database performance and configuration issues.

6.1 Overview

The Overview page provides insight into the overall health of the databases on the server.

• Target Status

• Monitoring Status

• Incidents

• Backends

• Replication

• Background Writer

Figure 15: Overview Page

Page 13: ORACLE ENTERPRISE MANAGER PLUG-IN FOR PostgreSQL - s3.amazonaws.com · Click Test Connection to ensure Enterprise Manager can connect to the specified database. 3. Click OK to save

13 Oracle Enterprise Manager Plug-in for PostgreSQL User Guide

6.2 Configuration

This page provides insight into current configurations of the database, including current, next boot, and reset values.

Figure 16: Configuration Page

Page 14: ORACLE ENTERPRISE MANAGER PLUG-IN FOR PostgreSQL - s3.amazonaws.com · Click Test Connection to ensure Enterprise Manager can connect to the specified database. 3. Click OK to save

14 Oracle Enterprise Manager Plug-in for PostgreSQL User Guide

6.3 Database

The Database page provides a per database view of connected backends, database growth, deadlocks as well as other useful metrics.

Figure 17: Database Page

Page 15: ORACLE ENTERPRISE MANAGER PLUG-IN FOR PostgreSQL - s3.amazonaws.com · Click Test Connection to ensure Enterprise Manager can connect to the specified database. 3. Click OK to save

15 Oracle Enterprise Manager Plug-in for PostgreSQL User Guide

6.4 Tables

The Tables page provides details on tables within a specific database. A breakdown of table size is given as well as top table metrics and graphs specific to the tables you are interested in.

Figure 18: Tables Page

Page 16: ORACLE ENTERPRISE MANAGER PLUG-IN FOR PostgreSQL - s3.amazonaws.com · Click Test Connection to ensure Enterprise Manager can connect to the specified database. 3. Click OK to save

16 Oracle Enterprise Manager Plug-in for PostgreSQL User Guide

6.5 Indices

The Indices page provides details into indices within a specific database and their size. Quickly being able to find and observe metric history for an index is one of the main features of this page.

Figure 19: Indices Page

Page 17: ORACLE ENTERPRISE MANAGER PLUG-IN FOR PostgreSQL - s3.amazonaws.com · Click Test Connection to ensure Enterprise Manager can connect to the specified database. 3. Click OK to save

17 Oracle Enterprise Manager Plug-in for PostgreSQL User Guide

6.6 Queries

The Queries page provides insight into a query’s current and historical performance.

Figure 20: Queries Page

Page 18: ORACLE ENTERPRISE MANAGER PLUG-IN FOR PostgreSQL - s3.amazonaws.com · Click Test Connection to ensure Enterprise Manager can connect to the specified database. 3. Click OK to save

18 Oracle Enterprise Manager Plug-in for PostgreSQL User Guide

7. Appendix I: MetricsThe OEM Plug-in for PostgreSQL collects the metrics indicated in the following table.

METRIC LABEL TYPE DESCRIPTION

Backend Metrics

process_id Process ID NUMBER Process ID of this backend

database_id Database ID NUMBER OID of the database this backed is connected to.

database_name Database Name STRING Name of the database this backend is connected to.

user_id User ID NUMBER OID of the user logged into this backend.

user_name User Name STRING Name of the user logged into this backend.

application_name Application Name STRING Name of the application that is connected to this backend.

client_address Client Address STRING IP address of the client connected to this backend.

client_hostname Client Hostname STRING Host name of the connected client as reported by a reverse DNS lookup of the Client Address.

client_port Client Port NUMBER TCP port number that the client is using for communication with this backend.

backend_start_time Backend Start Time STRING Time when this process was started.

Database Metrics

database_id Database ID NUMBER OID of the database.

database_name Database Name STRING Name of the database.

database_size Database Size NUMBER Size of the database in bytes.

num_backends Backends Connected NUMBER Number of backends currently connected to this database.

xact_commit Committed Transactions NUMBER Number of transactions in this database that have been committed.

xact_rollback Rolled Back Transactions NUMBER Number of transactions in this database that have been rolled back.

blocks_read Blocks Read NUMBER Number of disk blocks read for this database.

blocks_hit Blocks Hit NUMBER Number of disk blocks found for this database and already in the PostgreSQL buffer cache.

block_read_time Block Read Time NUMBER Milliseconds spent reading data file blocks by backends in this database.

block_write_time Block Write Time NUMBER Milliseconds spent writing data file blocks by backends in this database.

rows_returned Rows Returned NUMBER Number of rows returned by queries in this database.

rows_fetched Rows Fetched NUMBER Number of rows fetched by queries in this database.

Page 19: ORACLE ENTERPRISE MANAGER PLUG-IN FOR PostgreSQL - s3.amazonaws.com · Click Test Connection to ensure Enterprise Manager can connect to the specified database. 3. Click OK to save

19 Oracle Enterprise Manager Plug-in for PostgreSQL User Guide

METRIC LABEL TYPE DESCRIPTION

rows_inserted Rows Inserted NUMBER Number of rows inserted by queries in this database.

rows_updated Rows Updated NUMBER Number of rows updated by queries in this database.

rows_deleted Rows Deleted NUMBER Number of rows deleted by queries in this database.

total_rows_accessed Rows Accessed NUMBER Number of rows accessed by queries in this database.

temp_files Temporary Files NUMBER Number of temporary files created by queries in this database.

temp_bytes Temporary Bytes NUMBER Number of temporary bytes used by queries in this database.

deadlocks Deadlocks NUMBER Number of deadlocks detected in this database.

conflicts Queries Cancelled NUMBER Number of queries cancelled due to conflicts with recovery in this database.

conflicts_tablespace Conflicts due to Dropped Tablespaces

NUMBER Number of queries in this database that have been canceled due to dropped tablespaces.

conflicts_lock Conflicts due to Lock Timeouts

NUMBER Number of queries in this database that have been canceled due to lock timeouts.

conflicts_snapshot Conflicts due to Old Snapshots

NUMBER Number of queries in this database that have been canceled due to old snapshots.

conflicts_buffer_pinned Conflicts due to Pinned Buffers

NUMBER Number of queries in this database that have been canceled due to pinned buffers.

conflicts_deadlock Conflicts due to Deadlocks NUMBER Number of queries in this database that have been canceled due to deadlocks.

transaction_age Transaction Unfrozen Age NUMBER Age of the first Unfrozen Transaction ID in the database Used to determine need for vacuum.

is_template Is Template DB STRING Represents if the database is a PostgreSQL Template database.

database_size_megabytes Database Size (MB) NUMBER Size of the database in megabytes.

SQL Statement Metrics

statement_hash Statement Hash STRING MD5 hash of the SQL statement text.

query_statement SQL Statement STRING The text of the SQL statement run.

user_id User ID NUMBER OID of the user who executed the statement.

user_name User Name STRING Name of the user who executed the statement.

database_id Database ID NUMBER OID of the database in which the statement was executed.

database_name Database Name STRING Name of the database in which the statement was executed.

Page 20: ORACLE ENTERPRISE MANAGER PLUG-IN FOR PostgreSQL - s3.amazonaws.com · Click Test Connection to ensure Enterprise Manager can connect to the specified database. 3. Click OK to save

20 Oracle Enterprise Manager Plug-in for PostgreSQL User Guide

METRIC LABEL TYPE DESCRIPTION

call_count Call Count NUMBER The Number of times the SQL statement has been executed.

execution_time Execution Time NUMBER The time spent in the statment in milliseconds.

row_count Row Result Count NUMBER Number of rows retrieved or affected by the statement.

shared_blocks_hit Shared Blocks Hit NUMBER Number of shared block cache hits by the statement.

shared_blocks_read Shared Blocks Read NUMBER Number of shared blocks read by the statement.

shared_blocks_dirtied Shared Blocks Dirtied NUMBER Number of shared blocks dirtied by the statement.

shared_blocks_written Shared Blocks Written NUMBER Number of shared blocks written by the statement.

local_blocks_hit Local Blocks Hit NUMBER Number of local block cache hits by the statement.

local_blocks_read Local Blocks Read NUMBER Number of local blocks read by the statement.

local_blocks_dirtied Local Blocks Dirtied NUMBER Number of local blocks dirtied by the statement.

local_blocks_written Local Blocks Written NUMBER Number of local blocks written by the statement.

temp_blocks_read Temp Blocks Read NUMBER Number of temp blocks read by the statement.

temp_blocks_written Temp Blocks Written NUMBER Number of temp blocks written by the statement.

block_read_time Block Read Time NUMBER Time the statement spent reading blocks in milliseconds.

block_write_time Block Write Time NUMBER Time the statement spend writting blocks in milliseconds.

Table Metrics

database_id Database ID NUMBER OID of the database in which this table exists.

database_name Database Name STRING Name of the database in which this table exists.

table_id Table ID NUMBER OID of the table.

table_name Table Name STRING Name of this table.

table_size Table Size NUMBER Size of the table in bytes.

schema_name Schema Name STRING Name of the schema that this table is in.

sequential_scans Sequential Scans NUMBER Number of sequential scans initiated on this table.

rows_fetched_sequential Rows Fetched by Sequential Scans

NUMBER Number of live rows fetched by sequential scans.

index_scans Index Scans NUMBER Number of index scans initiated on this table.

rows_fetched_index Rows Fetched by Index Scans

NUMBER Number of live rows fetched by index scans.

Page 21: ORACLE ENTERPRISE MANAGER PLUG-IN FOR PostgreSQL - s3.amazonaws.com · Click Test Connection to ensure Enterprise Manager can connect to the specified database. 3. Click OK to save

21 Oracle Enterprise Manager Plug-in for PostgreSQL User Guide

METRIC LABEL TYPE DESCRIPTION

total_rows_fetched Rows Fetched NUMBER Number of rows fetched.

rows_inserted Rows Inserted NUMBER Number of rows inserted.

rows_updated Rows Updated NUMBER Number of rows updated.

rows_deleted Rows Deleted NUMBER Number of rows deleted.

rows_hot_updated Rows Hot Updated NUMBER Number of rows HOT updated (i.e.,with no separate index update required).

total_rows_accessed Rows Accessed NUMBER Number of rows accessed by queries in this database.

live_rows Live Rows NUMBER Estimated number of live rows.

dead_rows Dead Rows NUMBER Estimated number of dead rows.

last_vacuum_time Last Vacuum Time STRING Last time at which this table was manually vacuumed (not counting VACUUM FULL).

last_autovacuum_time Last Auto-Vacuum Time STRING Last time at which this table was vacuumed by the autovacuum daemon.

last_analyze_time Last Analyze Time STRING Last time at which this table was manually analyzed.

last_autoanalyze_time Last Auto-Analyze Time STRING Last time at which this table was analyzed by the autovacuum daemon.

vacuum_count Vacuum Count NUMBER Number of times this table has been manually vacuumed (not counting VACUUM FULL).

autovacuum_count Auto-Vacuum Count NUMBER Number of times this table has been vacuumed by the autovacuum daemon.

analyze_count Analyze Count NUMBER Number of times this table has been manually analyzed.

autoanalyze_count Auto-Analyze Count NUMBER Number of times this table has been analyzed by the autovacuum daemon.

heap_blocks_read Heap Blocks Read NUMBER Number of disk blocks read from this table.

heap_blocks_hit Heap Blocks Hit NUMBER Number of buffer hits in this table.

index_blocks_read Index Blocks Read NUMBER Number of disk blocks read from all indexes on this table.

index_blocks_hit Index Blocks Hit NUMBER Number of buffer hits in all indexes on this table.

toast_blocks_read Toast Blocks Read NUMBER Number of disk blocks read from this table’s TOAST table (if any).

toast_blocks_hit Toast Blocks Hit NUMBER Number of buffer hits in this table’s TOAST table (if any).

toast_index_blocks_read Toast Index Blocks Read NUMBER Number of disk blocks read from this table’s TOAST table index (if any).

toast_index_blocks_hit Toast Index Blocks Hit NUMBER Number of buffer hits in this table’s TOAST table index (if any).

table_type Table Type STRING Type of table (System or User).

table_size_megabytes Table Size (MB) NUMBER Size of the table in megabytes.

Index Metrics

Page 22: ORACLE ENTERPRISE MANAGER PLUG-IN FOR PostgreSQL - s3.amazonaws.com · Click Test Connection to ensure Enterprise Manager can connect to the specified database. 3. Click OK to save

22 Oracle Enterprise Manager Plug-in for PostgreSQL User Guide

METRIC LABEL TYPE DESCRIPTION

database_id Database ID NUMBER OID of the database in which this index exists.

database_name Database Name STRING Name of the database in which this index exists.

index_id Index ID NUMBER OID of the index.

index_name Index Name STRING Name of this index.

index_size Index Size NUMBER Size of the index in bytes.

table_id Table ID NUMBER OID of the table for this index.

table_name Table Name STRING Name of the table for this index.

schema_name Schema Name STRING Name of the schema this index is in.

index_scans Index Scans NUMBER Number of index scans initiated on this index.

index_entries_read Index Entries Read NUMBER Number of index entries returned by scans on this index.

table_rows_fetched Table Rows Fetched NUMBER Number of live table rows fetched by simple index scans using this index.

disk_blocks_read Disk Blocks Read NUMBER Number of disk blocks read from this index.

disk_blocks_hit Disk Blocks Hit NUMBER Number of buffer hits in this index.

index_type Index Type STRING Type of index (System or User).

index_size_megabytes Index Size (MB) NUMBER Size of the index in megabytes.

Sequence Metrics

database_id Database ID NUMBER OID of the database in which this sequence belongs.

database_name Database Name STRING Name of the database in which this sequence belongs.

sequence_id Sequence ID NUMBER OID of the sequence.

sequence_name Sequence Name STRING Name of this sequence.

schema_name Schema Name STRING Name of the schema this sequence is in.

blocks_read Blocks Read NUMBER Number of disk blocks read from this sequence.

blocks_hit Blocks Hit NUMBER Number of buffer bits in this sequence.

sequence_type Sequence Type STRING Type of sequence (System or User).

Trigger Metrics

database_id Database ID NUMBER OID of the database this trigger is in.

database_name Database Name STRING Name of the Database to find the trigger.

table_id Table ID NUMBER OID of the table this trigger is on.

trigger_name T Trigger Name STRING rigger name (must be unique among triggers of same table).

function_id Function ID STRING OID of funciton to call.

enabled Enabled State STRING Controls in which session replication mode the trigger fires.

Page 23: ORACLE ENTERPRISE MANAGER PLUG-IN FOR PostgreSQL - s3.amazonaws.com · Click Test Connection to ensure Enterprise Manager can connect to the specified database. 3. Click OK to save

23 Oracle Enterprise Manager Plug-in for PostgreSQL User Guide

METRIC LABEL TYPE DESCRIPTION

is_internal Is Internal STRING Represents if it is internally generated.

User Function Metrics

function_id Function ID NUMBER OID of a function.

function_name Function Name STRING Name of this function.

schema_name Schema Name STRING Name of the schema this function is in.

calls Calls NUMBER Number of times this function has been called.

total_time Total Time NUMBER Total time spent in this function and all other functions called by it in milliseconds.

self_time Self Time NUMBER Total time spent in this function itself not including other functions called by it, in milliseconds.

Prepared Transaction Metrics

transaction_id Transaction ID STRING Numeric ID of the prepared transaction.

global_id Global Transaction ID STRING Global transaction identifier that was assigned to the transaction.

prepared_time Prepared Time STRING Time transaction was prepared for commit.

owner Owner STRING Name of the Owner that executed the transaction.

database Database Name STRING Name of the database in which the transaction was executed.

Replication Metrics

process_id Process ID NUMBER Process ID of a WAL sender process.

user_id User ID NUMBER OID of the user logged into this WAL sender process.

user_name User Name STRING Name of the user logged into this WAL sender process.

application_name Application Name STRING Name of the application that is connected to this WAL sender.

client_address Client Address STRING IP address of the client connected to this WAL sender.

client_hostname Client Hostname STRING Host name of the connected client as reported by a reverse DNS lookup of the Client Address.

client_port Client Port NUMBER TCP port number that the client is using for communication with this WAL sender.

backend_start Backend Start Time STRING Time when this process was started when the client connected to this WAL sender.

state State STRING Current WAL sender state.

sent_location Sent Location STRING Last transaction log position sent on this connection.

write_location Write Location STRING Last transaction log position written to disk by this standby server.

Page 24: ORACLE ENTERPRISE MANAGER PLUG-IN FOR PostgreSQL - s3.amazonaws.com · Click Test Connection to ensure Enterprise Manager can connect to the specified database. 3. Click OK to save

24 Oracle Enterprise Manager Plug-in for PostgreSQL User Guide

METRIC LABEL TYPE DESCRIPTION

flush_location Flush Location STRING Last transaction log position flushed to disk by this standby server.

replay_location Replay Location STRING Last transaction log position replayed into the database on this standby server.

sync_priority Sync Priority NUMBER Priority of this standby server for being chosen as the synchronous standby.

sync_state Sync State STRING Synchronous state of this standby server.

Background Writer Metrics

checkpoints_timed Scheduled Checkpoints Performed

NUMBER Number of scheduled checkpoints that have been performed.

checkpoints_requested Requested Checkpoints Performed

NUMBER Number of requested checkpoints that have been performed.

checkpoint_write_time Checkpoint Write Time NUMBER Total amount of time that has been spent in the portion of checkpoint processing where files are written to disk in milliseconds.

checkpoint_sync_time Checkpoint Sync Time NUMBER Total amount of time that has been spent in the portion of checkpoint processing where files are synchronized to disk in milliseconds.

buffers_checkpoint Buffers Written NUMBER Number of buffers written during checkpoints.

buffers_cleaned Buffers Cleaned NUMBER Number of buffers written by the background writer.

maxwritten_clean Max-Written Clean NUMBER Number of times the background writer stopped a cleaning scan because it had written too many buffers.

buffers_backend Buffers Written to Backend NUMBER Number of buffers written directly by a backend.

buffers_backend_fsync Buffers Backend fsync NUMBER Number of times a backend had to execute its own fsync call (normally the background writer handles those even when the backend does its own write).

buffers_allocated Buffers Allocated NUMBER Number of buffers allocated.

Runtime Configuration Metrics

name_hash Name Hash STRING MD5 hash of parameter name.

name Name STRING Run-time configuration parameter name.

value Value STRING Current value of the parameter.

unit Unit STRING Implicit unit of the parameter.

category Category STRING Logical group of the parameter.

description Description STRING A brief description of the parameter.

context Context STRING The context required to set the parameter’s value.

type Value Type STRING Parameter type (bool enum integer or string)

Page 25: ORACLE ENTERPRISE MANAGER PLUG-IN FOR PostgreSQL - s3.amazonaws.com · Click Test Connection to ensure Enterprise Manager can connect to the specified database. 3. Click OK to save

25 Oracle Enterprise Manager Plug-in for PostgreSQL User Guide

METRIC LABEL TYPE DESCRIPTION

valid_values Valid Values STRING Allowable values for the configuration parameter.

source Source STRING Source of the current parameter value.

source_file Source File STRING Configuration file the current value was set in.

boot_value Boot Value STRING Parameter value assumed at server startup if the parameter is not otherwise set.

reset_value Reset Value STRING Value that RESET would reset the parameter to in the current session.

Page 26: ORACLE ENTERPRISE MANAGER PLUG-IN FOR PostgreSQL - s3.amazonaws.com · Click Test Connection to ensure Enterprise Manager can connect to the specified database. 3. Click OK to save

26 Oracle Enterprise Manager Plug-in for PostgreSQL User Guide

8. Appendix II: Revision NotesThis user guide is updated with each release of the product, or when necessary. The following table provides its revision history.

REVISION DATE DESCRIPTION

REV-05 May 11, 2018 • Updated PostgreSQL support to include version 10 in section “1. Platforms and Versions Supported”

• Added section “5. Adding a License”• Updated screenshots throughout guide• Updated style to new Blue Medora brand standards

REV-04 November 8, 2017 • Updated PostgreSQL support from 9.0 – 9.4+ to 9.3 – 9.6+ in section “1. Platforms and Versions Supported”

• Updated link to PostgreSQL Prerequisites knowledge article on Blue Medora’s Support Portal in section “2. Prerequisites”

• Updated screenshots throughout guide• Added section “6. Appendix I: Metrics”

REV-03 January 2017 • Noted in Prerequisites section that a PostgreSQL “super user” is required to collect both tablespace and query data.

REV-02 July 2016 • Updated Platforms and Versions Supported section to include Oracle Enterprise Manager Cloud Control 13c compatibility

• Updated Prerequisites section to include a support link and notes about pg_stat_statements

• Added Install and Configure the Plug-in section• Updated Setting Up a Target section to include detailed information about

how to add targets

REV-01 July 2015 Initial release.

Page 27: ORACLE ENTERPRISE MANAGER PLUG-IN FOR PostgreSQL - s3.amazonaws.com · Click Test Connection to ensure Enterprise Manager can connect to the specified database. 3. Click OK to save

Copyright © 2018 Blue Medora Inc. All rights reserved. U.S. and international copyright and intellectual property laws protect this product. Blue Medora is a registered trademark or trademark of Blue Medora in the United States and/or other jurisdictions.

PostgreSQL and the “Slonik” logo are trademarks of the PostgreSQL Community Association of Canada, and are used here with permission.

Blue Medora 3225 N Evergreen Dr. NE Suite 103 Grand Rapids, MI 49525

www.bluemedora.com

You can find the most up-to-date technical documentation on the Blue Medora support site at: http://support.bluemedora.com.

The Blue Medora website also provides the latest product updates. If you have comments about this documentation, submit your feedback to: [email protected].