Introducing the PromQL Receiver for the Splunk OpenTelemetry Collector

Observability Antoine Toulme

Key takeaways

  1. Prometheus is often more than a metrics endpoint—it is also a powerful query and aggregation engine.
  2. With the new PromQL receiver, the Splunk OpenTelemetry Collector can periodically execute PromQL queries against Prometheus or Thanos and convert the results into OpenTelemetry metrics.
  3. This makes it possible to collect a focused view of your telemetry without ingesting every underlying time series into the Collector.

How It Works

The receiver sends each configured query to the Prometheus-compatible /api/v1/query endpoint at the configured collection interval. Returned samples are converted into OpenTelemetry metrics:

For example, the following configuration queries a Prometheus server every 30 seconds:

promql-1.png

The receiver uses the Collector’s standard HTTP client configuration, including TLS settings and supported authentication extensions, making it suitable for secured Prometheus and Thanos deployments.

Why Use PromQL in the Collector?

The PromQL receiver is useful when you want to:

This is different from the standard Prometheus receiver, which scrapes /metrics endpoints.

Development Status

We introduced the PromQL receiver in the Splunk OpenTelemetry Collector under PR #8011 and it is available in release 0.160.0 forward.

The receiver is considered feature-complete and ready for field testing. We aim to mature this receiver quickly and donate it to OpenTelemetry. To this end, we have opened an issue here. If you are interested in supporting or helping with this donation, please feel free to like and comment.

Want to talk about OpenTelemetry? Join me every Monday at 8:30am PT/11:30am ET for Observability HQ when I lead an OpenTelemetry drop-in. You can also meet me and the other Splunk maintainers and contributors at Kubecon North America in Salt Lake City in November. Pop into an Observability HQ and we’ll give you a 20% off discount code for Kubecon!

Related Articles

Introducing Our New SOAR Integrations: Why Panorama and FortiManager Users Should Be Excited
Security
1 Minute Read

Introducing Our New SOAR Integrations: Why Panorama and FortiManager Users Should Be Excited

The Splunk SOAR team shares more on the latest firewall management apps introduced in Splunk SOAR 6.2.
Splunk Ranked Number 1 in the 2025 Gartner® Critical Capabilities for Security Information and Event Management Use Cases
Security
1 Minute Read

Splunk Ranked Number 1 in the 2025 Gartner® Critical Capabilities for Security Information and Event Management Use Cases

Splunk has been ranked as the #1 SIEM solution in all three Use Cases for the second consecutive time in the 2025 Gartner® Critical Capabilities for Security Information and Event Management report.
Active Directory Discovery Detection: Threat Research Release, September 2021
Security
15 Minute Read

Active Directory Discovery Detection: Threat Research Release, September 2021

In this blog post, we’ll walk you through this analytic story, demonstrate how we can simulate these attacks using PoshC2 & PurpleSharp to then collect and analyze the resulting telemetry to test our detections.