xe-exporter

This has been tested on a B60 only!

A high-performance Prometheus and OpenTelemetry exporter for Intel Arc GPUs (Battlemage and Alchemist) using the modern Linux xe kernel driver.

Features

• OTel Native: Built using the OpenTelemetry Go SDK for unified metrics.
• Dual Export: Supports both Prometheus (/metrics endpoint) and OTLP gRPC push.
• Real-time Monitoring: Collects VRAM, frequency, power, fan speeds, and GPU utilization.
• Systemd Ready: Includes a pre-configured service file for easy deployment.

Metrics

Metric Name	Description	Labels
xe_gpu_vram_total_bytes	Total VRAM capacity	card, vram
xe_gpu_vram_used_bytes	Current VRAM allocation	card, vram
xe_gpu_gt_usage_percent	GPU GT utilization percent	card, gt
xe_gpu_frequency_actual_mhz	Actual clock speed	card, gt
xe_gpu_frequency_requested_mhz	Requested clock speed	card, gt
xe_gpu_power_watts	Power draw (card/package)	card, type
xe_gpu_fan_rpm	Fan speed	card, fan

Requirements

• Linux Kernel 6.8+ with the xe driver enabled.
• Intel Arc GPU (e.g., B60, A770).
• Go 1.26+ (for building from source).
• Root Privileges: Required to read metrics from debugfs.

Installation

1. Build from source

make build
sudo make install

2. Setup as a Service

sudo make setup-service

Configuration

The exporter is configured via /etc/default/xe-exporter.

To modify options like the Prometheus port or OTLP endpoint:

1. Edit /etc/default/xe-exporter:

# /etc/default/xe-exporter
XE_EXPORTER_OPTS="-prom-port 9101 -otlp-endpoint my-otel-collector:4317"

2. Restart the service:

sudo systemctl restart xe-exporter

The following flags are available:

• -prom-port: Port for Prometheus metrics (default: 9101)
• -enable-prom: Enable/disable Prometheus endpoint (default: true)
• -otlp-endpoint: OTLP gRPC endpoint (e.g., localhost:4317)
• -debug: Enable verbose collection logging (default: false)

Prometheus Configuration

To scrape metrics from this exporter, add the following job to your prometheus.yml:

scrape_configs:
  - job_name: 'xe-exporter'
    static_configs:
      - targets: ['localhost:9101']
    scrape_interval: 2s

OpenTelemetry Configuration (OTLP)

If you prefer pushing metrics to an OTel Collector, enable the OTLP flag in the configuration file:

# /etc/default/xe-exporter
XE_EXPORTER_OPTS="-otlp-endpoint my-otel-collector:4317"

License

MIT