Skip to content

Latest commit

 

History

History
115 lines (80 loc) · 2.9 KB

postgresql.asciidoc

File metadata and controls

115 lines (80 loc) · 2.9 KB
Raw

PostgreSQL module

This module periodically fetches metrics from PostgreSQL servers.

Default metricsets are activity, bgwriter and database.

Module-specific configuration notes

When configuring the hosts option, you must use Postgres URLs of the following format:

[postgres://][user:pass@]host[:port][?options]

The URL can be as simple as:

- module: postgresql
  hosts: ["postgres://localhost"]

Or more complex like:

- module: postgresql
  hosts: ["postgres://localhost:40001?sslmode=disable", "postgres://otherhost:40001"]

You can also separately specify the username and password using the respective configuration options. Usernames and passwords specified in the URL take precedence over those specified in the username and password config options.

- module: postgresql
  metricsets: ["status"]
  hosts: ["postgres://localhost:5432"]
  username: root
  password: test

Compatibility

This module was tested with PostgreSQL 9.5.3 and is expected to work with all versions >= 9.

Example configuration

The PostgreSQL module supports the standard configuration options that are described in [configuration-metricbeat]. Here is an example configuration:

metricbeat.modules:
- module: postgresql
  enabled: true
  metricsets:
    # Stats about every PostgreSQL database
    - database

    # Stats about the background writer process's activity
    - bgwriter

    # Stats about every PostgreSQL process
    - activity

  period: 10s

  # The host must be passed as PostgreSQL URL. Example:
  # postgres://localhost:5432?sslmode=disable
  # The available parameters are documented here:
  # https://godoc.org/github.com/lib/pq#hdr-Connection_String_Parameters
  hosts: ["postgres://localhost:5432"]

  # Username to use when connecting to PostgreSQL. Empty by default.
  #username: user

  # Password to use when connecting to PostgreSQL. Empty by default.
  #password: pass

Metricsets

The following metricsets are available: