IPVS and Thanos Integration

Input and output integration overview

The IPVS plugin is designed to collect metrics related to IPVS virtual and real servers on Linux systems.

This plugin sends metrics from Telegraf to Thanos using the Prometheus remote write protocol over HTTP, allowing efficient and scalable ingestion into Thanos Receive components.

Integration details

IPVS

The IPVS plugin gathers metrics about IPVS virtual and real servers using the Linux kernel netlink socket interface. As a component specifically designed for Linux, it tracks performance related to IP virtual servers, allowing users to monitor various attributes such as active connections, packet statistics, and byte counts. Key metrics include those for both virtual and real servers, facilitating a comprehensive view of server performance. The plugin also requires the Telegraf process to run with appropriate permissions, typically as root or a user with specific capabilities for proper operation.

Thanos

Telegraf’s HTTP plugin can send metrics directly to Thanos via its Remote Write-compatible Receive component. By setting the data format to prometheusremotewrite, Telegraf can serialize metrics into the same protobuf-based format used by native Prometheus clients. This setup enables high-throughput, low-latency metric ingestion into Thanos, facilitating centralized observability at scale. It is particularly useful in hybrid environments where Telegraf is collecting metrics from systems outside Prometheus’ native reach, such as SNMP devices, Windows hosts, or custom apps, and streams them directly to Thanos for long-term storage and global querying.

Configuration

IPVS

[[inputs.ipvs]]
  # no configuration

Thanos

[[outputs.http]]
  ## Thanos Receive endpoint for remote write
  url = "http://thanos-receive.example.com/api/v1/receive"

  ## HTTP method
  method = "POST"

  ## Data format set to Prometheus remote write
  data_format = "prometheusremotewrite"

  ## Optional headers (authorization, etc.)
  # [outputs.http.headers]
  #   Authorization = "Bearer YOUR_TOKEN"

  ## Optional TLS configuration
  # tls_ca = "/path/to/ca.pem"
  # tls_cert = "/path/to/cert.pem"
  # tls_key = "/path/to/key.pem"
  # insecure_skip_verify = false

  ## Request timeout
  timeout = "10s"

Input and output integration examples

IPVS

1. Load Balancing Performance Monitoring: Use the IPVS plugin to monitor the performance of a load balancing setup in a Linux environment where IPVS is implemented. By collecting metrics such as byte counts, packet rates, and active connections, administrators can gain real-time insights into server performance, allowing for proactive adjustments to load distribution strategies and ensuring that no individual server becomes a bottleneck.

2. Automated Alerting for Connection Thresholds: Integrate the metrics collected by the IPVS plugin with an alerting system to automatically notify administrators when active connections exceed or fall below specified thresholds. This use case enables dynamic scaling of backend resources, optimizing application performance and resource utilization, while minimizing the risk of sudden service disruptions.

3. Historical Performance Trend Analysis: Store the metrics gathered by the IPVS plugin in a time-series database for historical analysis. By analyzing trends over time, organizations can identify patterns in server performance, correlate them with application usage spikes, and make informed decisions regarding infrastructure upgrades or maintenance schedules to better handle peak loads.

Thanos

1. Agentless Cloud Monitoring: Deploy Telegraf agents across cloud VMs to collect system and application metrics, then stream them directly into Thanos using Remote Write. This provides centralized observability without requiring Prometheus nodes at each location.

2. Scalable Windows Host Monitoring: Use Telegraf on Windows machines to collect OS-level metrics and send them via Remote Write to Thanos Receive. This enables observability across heterogeneous environments with native Prometheus support only on Linux.

3. Cross-Region Metrics Federation: Telegraf agents in multiple geographic regions can push data to region-local Thanos Receivers using this plugin. From there, Thanos can deduplicate and query metrics globally, reducing latency and network egress costs.

4. Integrating Third-Party Data into Thanos: Collect metrics from custom telemetry sources such as REST APIs or proprietary logs using Telegraf inputs and forward them to Thanos via Remote Write. This brings non-native data into a Prometheus-compatible, long-term analytics pipeline.

Feedback

Thank you for being part of our community! If you have any general feedback or found any bugs on these pages, we welcome and encourage your input. Please submit your feedback in the InfluxDB community Slack.