Skip to main content

Google Cloud Pub Sub

Export metrics to Google Cloud Pub/Sub Service

Setup

Prerequisites

  • First install install Google Cloud Platform C++ Client Libraries
  • Pub/Sub support is also dependent on the dependencies of those libraries, like protobuf, protoc, and grpc
  • Next, Netdata should be re-installed from the source. The installer will detect that the required libraries are now available.

Configuration

File

The configuration file name for this integration is exporting.conf.

You can edit the configuration file using the edit-config script from the Netdata config directory.

cd /etc/netdata 2>/dev/null || cd /opt/netdata/etc/netdata
sudo ./edit-config exporting.conf

Options

The following options can be defined for this exporter.

Config options
NameDescriptionDefaultRequired
enabledEnables or disables an exporting connector instance (yes/no).noyes
destinationAccepts a space separated list of hostnames, IPs (IPv4 and IPv6) and ports to connect to. Netdata will use the first available to send the metrics.pubsub.googleapis.comyes
usernameUsername for HTTP authenticationmy_usernameno
passwordPassword for HTTP authenticationmy_passwordno
data sourceSelects the kind of data that will be sent to the external database. (as collected/average/sum)no
hostnameThe hostname to be used for sending data to the external database server.[global].hostnameno
prefixThe prefix to add to all metrics.Netdatano
update everyFrequency of sending sending data to the external database, in seconds.10no
buffer on failuresThe number of iterations (update every seconds) to buffer data, when the external database server is not available.10no
timeout msThe timeout in milliseconds to wait for the external database server to process the data.2 update_every 1000no
send hosts matchingHosts filter. Determines which hosts will be sent to the external database. The syntax is simple patterns.localhost *no
send charts matchingOne or more space separated patterns (use * as wildcard) checked against both chart id and chart name.*no
send names instead of idsControls the metric names Netdata should send to the external database (yes/no).no
send configured labelsControls if host labels defined in the [host labels] section in netdata.conf should be sent to the external database (yes/no).no
send automatic labelsControls if automatically created labels, like _os_name or _architecture should be sent to the external database (yes/no).no
destination

The format of each item in this list, is: [PROTOCOL:]IP[:PORT].

  • PROTOCOL can be udp or tcp. tcp is the default and only supported by the current exporting engine.
  • IP can be XX.XX.XX.XX (IPv4), or [XX:XX...XX:XX] (IPv6). For IPv6 you can to enclose the IP in [] to separate it from the port.
  • PORT can be a number of a service name. If omitted, the default port for the exporting connector will be used.

Example IPv4:

destination = pubsub.googleapis.com

When multiple servers are defined, Netdata will try the next one when the previous one fails.

update every

Netdata will add some randomness to this number, to prevent stressing the external server when many Netdata servers send data to the same database. This randomness does not affect the quality of the data, only the time they are sent.

buffer on failures

If the server fails to receive the data after that many failures, data loss on the connector instance is expected (Netdata will also log it).

send hosts matching

Includes one or more space separated patterns, using * as wildcard (any number of times within each pattern). The patterns are checked against the hostname (the localhost is always checked as localhost), allowing us to filter which hosts will be sent to the external database when this Netdata is a central Netdata aggregating multiple hosts.

A pattern starting with ! gives a negative match. So to match all hosts named *db* except hosts containing *child*, use !*child* *db* (so, the order is important: the first pattern matching the hostname will be used - positive or negative).

send charts matching

A pattern starting with ! gives a negative match. So to match all charts named apps. except charts ending in reads, use !reads apps. (so, the order is important: the first pattern matching the chart id or the chart name will be used, positive or negative). There is also a URL parameter filter that can be used while querying allmetrics. The URL parameter has a higher priority than the configuration option.

send names instead of ids

Netdata supports names and IDs for charts and dimensions. Usually IDs are unique identifiers as read by the system and names are human friendly labels (also unique). Most charts and metrics have the same ID and name, but in several cases they are different : disks with device-mapper, interrupts, QoS classes, statsd synthetic charts, etc.

Examples

Basic configuration
  • Set the destination option to a Pub/Sub service endpoint. pubsub.googleapis.com is the default one.
  • Create the credentials JSON file by following Google Cloud's authentication guide.
  • The user running the Agent (typically netdata) needs read access to google_cloud_credentials.json, which you can set chmod 400 google_cloud_credentials.json; chown netdata google_cloud_credentials.json
  • Set the credentials file option to the full path of the file.
[pubsub:my_instance]
enabled = yes
destination = pubsub.googleapis.com
credentials file = /etc/netdata/google_cloud_credentials.json
project id = my_project
topic id = my_topic


Do you have any feedback for this page? If so, you can open a new issue on our netdata/learn repository.