diff --git a/README-RDS.md b/README-RDS.md new file mode 100644 index 00000000..cfead357 --- /dev/null +++ b/README-RDS.md @@ -0,0 +1,38 @@ +# Using Postgres-Exporter with AWS:RDS + +### When using postgres-exporter with Amazon Web Services' RDS, the + rolname "rdsadmin" and datname "rdsadmin" must be excluded. + +I had success running docker container 'wrouesnel/postgres_exporter:latest' +with queries.yaml as the PG_EXPORTER_EXTEND_QUERY_PATH. errors +mentioned in issue#335 appeared and I had to modify the +'pg_stat_statements' query with the following: +`WHERE t2.rolname != 'rdsadmin'` + +Running postgres-exporter in a container like so: + ``` + DBNAME='postgres' + PGUSER='postgres' + PGPASS='psqlpasswd123' + PGHOST='name.blahblah.us-east-1.rds.amazonaws.com' + docker run --rm --detach \ + --name "postgresql_exporter_rds" \ + --publish 9187:9187 \ + --volume=/etc/prometheus/postgresql-exporter/queries.yaml:/var/lib/postgresql/queries.yaml \ + -e DATA_SOURCE_NAME="postgresql://${PGUSER}:${PGPASS}@${PGHOST}:5432/${DBNAME}?sslmode=disable" \ + -e PG_EXPORTER_EXCLUDE_DATABASES=rdsadmin \ + -e PG_EXPORTER_DISABLE_DEFAULT_METRICS=true \ + -e PG_EXPORTER_DISABLE_SETTINGS_METRICS=true \ + -e PG_EXPORTER_EXTEND_QUERY_PATH='/var/lib/postgresql/queries.yaml' \ + wrouesnel/postgres_exporter + ``` + +### Expected changes to RDS: ++ see stackoverflow notes + (https://stackoverflow.com/questions/43926499/amazon-postgres-rds-pg-stat-statements-not-loaded#43931885) ++ you must also use a specific RDS parameter_group that includes the following: + ``` + shared_preload_libraries = "pg_stat_statements,pg_hint_plan" + ``` ++ lastly, you must reboot the RDS instance. + diff --git a/queries.yaml b/queries.yaml index 76a91245..18abd65b 100644 --- a/queries.yaml +++ b/queries.yaml @@ -134,7 +134,7 @@ pg_database: description: "Disk space used by the database" pg_stat_statements: - query: "SELECT t2.rolname, t3.datname, queryid, calls, total_time / 1000 as total_time_seconds, min_time / 1000 as min_time_seconds, max_time / 1000 as max_time_seconds, mean_time / 1000 as mean_time_seconds, stddev_time / 1000 as stddev_time_seconds, rows, shared_blks_hit, shared_blks_read, shared_blks_dirtied, shared_blks_written, local_blks_hit, local_blks_read, local_blks_dirtied, local_blks_written, temp_blks_read, temp_blks_written, blk_read_time / 1000 as blk_read_time_seconds, blk_write_time / 1000 as blk_write_time_seconds FROM pg_stat_statements t1 join pg_roles t2 on (t1.userid=t2.oid) join pg_database t3 on (t1.dbid=t3.oid)" + query: "SELECT t2.rolname, t3.datname, queryid, calls, total_time / 1000 as total_time_seconds, min_time / 1000 as min_time_seconds, max_time / 1000 as max_time_seconds, mean_time / 1000 as mean_time_seconds, stddev_time / 1000 as stddev_time_seconds, rows, shared_blks_hit, shared_blks_read, shared_blks_dirtied, shared_blks_written, local_blks_hit, local_blks_read, local_blks_dirtied, local_blks_written, temp_blks_read, temp_blks_written, blk_read_time / 1000 as blk_read_time_seconds, blk_write_time / 1000 as blk_write_time_seconds FROM pg_stat_statements t1 JOIN pg_roles t2 ON (t1.userid=t2.oid) JOIN pg_database t3 ON (t1.dbid=t3.oid) WHERE t2.rolname != 'rdsadmin'" master: true metrics: - rolname: