Oracle Enterprise Manager Plugin for PostgreSQL User Guide

Version 13.2.2.0.0 September 2019

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. © 2019 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 Statistics Setup 5

Setting Up A Target 6 Plugin Installation 6 Target Properties 6

Monitoring Features 7 Overview 7 Configuration 8 Database 9 Tables 10 Indexes 11 Queries 12

Oracle Enterprise Manager Plugin for PostgreSQL

 

Versions and Platforms Supported Oracle Enterprise Manager Cloud Control 13c (13.2.0.0.0+)

Supported PostgreSQL versions

PostgreSQL versions 9.3 – 11 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 https://www.postgresql.org/docs/11/auth-pg-hba-conf.html)

PostgreSQL Statistics Setup ● Enable statistics monitoring

o pg_stat views are available in the “primary” database (see https://www.postgresql.org/docs/11/monitoring-stats.html)

● Install PostgreSQL SQL Statements extension o Verify pg_stat_statements extension installed (see

https://www.postgresql.org/docs/11/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 Name

Monitoring user name

Database Login Password

Monitoring user 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

 Indexes

The Indexes page provides details into indexes 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