Skip to content

grpc plugin

The grpc plugin provides an RPC interface to submit values to or query values from collectd based on the open source gRPC framework. It exposes an end-point for dispatching values to the daemon.

Plugin name grpc
Configuration collectd.conf(5)

Configuration

Configuration options · from collectd.conf(5)

See this section in the full configuration reference

The grpc plugin provides an RPC interface to submit values to or query values from collectd based on the open source gRPC framework. It exposes an end-point for dispatching values to the daemon.

The gRPC homepage can be found at https://grpc.io/.

Server Host Port

The Server statement sets the address of a server to which to send metrics via the DispatchValues function.

The argument Host may be a hostname, an IPv4 address, or an IPv6 address.

Optionally, Server may be specified as a configuration block which supports the following options:

EnableSSL false|true
Whether to require SSL for outgoing connections. Default: false.
SSLCACertificateFile Filename
SSLCertificateFile Filename
SSLCertificateKeyFile Filename
Filenames specifying SSL certificate and key material to be used with SSL connections.
Listen Host Port

The Listen statement sets the network address to bind to. When multiple statements are specified, the daemon will bind to all of them. If none are specified, it defaults to 0.0.0.0:50051.

The argument Host may be a hostname, an IPv4 address, or an IPv6 address.

Optionally, Listen may be specified as a configuration block which supports the following options:

EnableSSL true|false
Whether to enable SSL for incoming connections. Default: false.
SSLCACertificateFile Filename
SSLCertificateFile Filename
SSLCertificateKeyFile Filename
Filenames specifying SSL certificate and key material to be used with SSL connections.
VerifyPeer true|false
When enabled, a valid client certificate is required to connect to the server. When disabled, a client certifiacte is not requested and any unsolicited client certificate is accepted. Enabled by default.