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:

Install the Collector for Linux with the installer script

Install the Collector for Windows with the installer script

Install the Collector for Kubernetes using Helm

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.

This page was last updated on Dec 12, 2024.

Related Topics