Oracle Enterprise Manager Plugin for

PostgreSQL User Guide

Version 12.1.0.1.0
April 2014

Oracle Enterprise Manager Plugin for PostgreSQL

Information in this document, including URL and other Internet Web site references,
is subject to change without notice. Unless otherwise noted, the companies,
organizations, products, domain names, e-mail addresses, logos, people, places, and
events depicted in examples herein are fictitious. No association with any real
company, organization, product, domain name, e-mail address, logo, person, place,
or event is intended or should be inferred.

Complying with all applicable copyright laws is the responsibility of the user.
Without limiting the rights under copyright, no part of this document may be
reproduced, stored in or introduced into a retrieval system, or transmitted in any
form or by any means (electronic, mechanical, photocopying, recording, or
otherwise), or for any purpose, without the express written permission of Blue
Medora LLC.

Blue Medora LLC may have patents, patent applications, trademarks, copyrights, or
other intellectual property rights covering subject matter in this document. Except
as expressly provided in any written license agreement from Blue Medora LLC, the
furnishing of this document does not give you any license to these patents,
trademarks, copyrights, or other intellectual property.

© 2014 Blue Medora LLC. All rights reserved.

PostgreSQL and the "Slonik" logo are trademarks of the PostgreSQL

Community Association of Canada, and are used here with permission.

Oracle Enterprise Manager Plugin for PostgreSQL

Versions and Platforms Supported ..............................................................................4
Prerequisites...............................................................................................................5
Monitoring Connectivity ........................................................................................................................................5
PostgreSQL Monitoring Setup .............................................................................................................................5
Setting Up A Target .....................................................................................................6
Plugin Installation ....................................................................................................................................................6
Target Properties......................................................................................................................................................6
Monitoring the Database ............................................................................................7
Overview ......................................................................................................................................................................7
Configuration..............................................................................................................................................................8
Database .......................................................................................................................................................................9
Tables ......................................................................................................................................................................... 10
Indices ........................................................................................................................................................................ 11
Queries ....................................................................................................................................................................... 12

Oracle Enterprise Manager Plugin for PostgreSQL

Versions and Platforms Supported
Oracle Enterprise Manager Cloud Control 12c (12.1.0.3.0+)

Supported PostgreSQL versions

PostgreSQL versions 9.0 – 9.3

Supported Oracle Management Agent (OMA) Operating Systems:

Microsoft Windows (64 bit) supported by the OMA
Linux (64 bit) support by the OMA

Supported Oracle Management Server (OMS) Operating Systems:

All Oracle supported OMS platforms

Supported PostgreSQL Database OS:

All PostgreSQL supported (for remote monitoring)

Oracle Enterprise Manager Plugin for PostgreSQL

Prerequisites

Monitoring Connectivity
● Create a PostgreSQL user, with permission to the databases to be monitored
● Enable remote access for the new user
o Update hba.conf file to allow Enterprise Manager IP to remotely
connect as the new user (see
http://www.postgresql.org/docs/9.3/static/auth-pg-hba-conf.html)

PostgreSQL Statistics Setup

● Enable statistics monitoring
o pg_stat views are available in the “primary” database (see
http://www.postgresql.org/docs/9.3/static/monitoring-stats.html)
● Install PostgreSQL SQL Statements extension
o Verify pg_stat_statements extension installed (see
http://www.postgresql.org/docs/9.3/static/pgstatstatements.html)
o Verify pg_stat_statements view is available in the “primary” database

Oracle Enterprise Manager Plugin for PostgreSQL

Setting Up A Target

Plugin Installation
Perform the following tasks to install your PostgreSQL plugin.
● Import the OPAR using the emcli utility (see Oracle documentation)
● Deploy plugin on OMS
● Deploy plugin on OMA (PostgreSQL plugin supports remote or local
monitoring)
● Add targets for each PostgreSQL instance

Target Properties

Target Property Description

Database Host Host name of PostgreSQL server
Database Login Monitoring user name
Name
Database Login Monitoring user password
Password
Database Port PostgreSQL port number (default is 5432)
Primary Database The plugin requires a “primary” database to connect to
(default is ‘postgres’)

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.

Oracle Enterprise Manager Plugin for PostgreSQL

Monitoring Features
The Oracle Enterprise Manager Plugin 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.

Overview

This page provides insight into overall health of the databases on the server.
● Target Status
● Monitoring Status
● Incidents
● Backends
● Replication
● Background Writer

Oracle Enterprise Manager Plugin for PostgreSQL

Configuration

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

Oracle Enterprise Manager Plugin for PostgreSQL

Database

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

Oracle Enterprise Manager Plugin for PostgreSQL

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.

Oracle Enterprise Manager Plugin for PostgreSQL

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.

Oracle Enterprise Manager Plugin for PostgreSQL

Queries

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

Oracle Enterprise Manager Plugin for PostgreSQL