SignalFx Gateway Prometheus remote write receiver ๐
The SignalFx Gateway Prometheus remote write receiver is the OTel native version of the SignalFx Prometheus remote-write gateway. The supported pipeline type is metrics
. See Process your data with pipelines for more information.
Get started ๐
Follow these steps to configure and activate the receiver:
Deploy the Splunk Distribution of the OpenTelemetry Collector to your host or container platform:
Configure the receiver as described in this doc.
Restart the Collector.
Default configuration ๐
To use the signalfxgatewayprometheusremotewritereceiver
receiver in the Splunk Distribution of the OpenTelemetry Collector, add the following to your config file:
receivers:
signalfxgatewayprometheusremotewritereceiver:
To complete the configuration, include the receiver in the required pipeline of the service
section of your configuration file. For example:
service:
pipelines:
metrics:
receivers: [signalfxgatewayprometheusremotewritereceiver]
Advanced configuration ๐
This receiver is configured through standard OpenTelemetry mechanisms. See Collector config go for more details.
You can configure the following parameters:
path
./metrics
by default. The path in which the receiver responds to Prometheusโ remote-write requests.buffer_size
.100
by default. Buffer for metric translations without blocking further write requests.Use the Collectorโs
confighttp
options to set up TLS and other features. See more at Collector config http .
endpoint
.localhost:19291
by default. Interface and port the receiver listens to.
Known limitations ๐
This receiver replicates the near-exact behavior of the SignalFx Prometheus remote-write gateway, with a few differences.
Differences with the Prometheus Remote-Write specification ๐
This behavior differs from the Prometheus remote-write specification version 1 in the following ways:
This receiver doesnโt remove suffixes, as this is performed by the Prometheus receiver.
This receiver transforms histograms into counters.
This receiver transforms quantiles (summaries) into gauges.
If the representation of a float can be expressed as an integer without loss, the receiver sets the representation of a float as an integer.
If the representation of a sample is NaN, the receiver reports an additional counter with the metric name
prometheus.total_NAN_sample
.If the representation of a sample is missing a metric name, the receiver reports an additional counter with the metric name
prometheus.total_bad_datapoints
.Any errors in parsing the request report an additional counter,
prometheus.invalid_request
.Metadata from
prompb.WriteRequest
is ignored.
Unsupported behavior from the SignalFx gateway ๐
The following behavior from SignalFx Gateway is not supported:
request_time.ns
is no longer reported.obsreport
handles similar functionality.drain_size
is no longer reported.obsreport
handles similar functionality.
Troubleshooting ๐
If you are a Splunk Observability Cloud customer and are not able to see your data in Splunk Observability Cloud, you can get help in the following ways.
Available to Splunk Observability Cloud customers
Submit a case in the Splunk Support Portal .
Contact Splunk Support .
Available to prospective customers and free trial users
Ask a question and get answers through community support at Splunk Answers .
Join the Splunk #observability user group Slack channel to communicate with customers, partners, and Splunk employees worldwide. To join, see Chat groups in the Get Started with Splunk Community manual.