AMD GPUs

The collector monitors AMD GPUs directly from the Linux kernel’s sysfs and hwmon interfaces. No ROCm, no user-space libraries, and no additional drivers are needed beyond the standard AMDGPU kernel module.

Requirements

Linux with the amdgpu kernel driver
Kernel 5.x+ (sysfs/hwmon paths are stable from 5.x onwards)

Collected metrics

Metric	Description
`hw.gpu.utilization`	Compute utilization (0.0–1.0)
`hw.gpu.memory.utilization`	Memory controller utilization (0.0–1.0)
`hw.gpu.memory.limit`	Total VRAM (bytes)
`hw.gpu.memory.usage`	Used VRAM (bytes)
`hw.gpu.memory.free`	Free VRAM (bytes)
`hw.gpu.temperature`	Die temperature (°C)
`hw.gpu.fan_speed`	Fan speed (RPM)
`hw.gpu.power.draw`	Current power draw (W)
`hw.gpu.power.limit`	Power cap (W)
`hw.gpu.energy.consumed`	Cumulative energy (J)

Docker

docker run -d \
  --name otel-gpu-collector \
  --device /dev/kfd:/dev/kfd \
  --device /dev/dri:/dev/dri \
  --pid=host \
  -e OTEL_SERVICE_NAME=my-app \
  -e OTEL_RESOURCE_ATTRIBUTES='deployment.environment=production' \
  -e OTEL_EXPORTER_OTLP_ENDPOINT=http://otel-collector:4318 \
  ghcr.io/openlit/otel-gpu-collector:latest

--pid=host is required for per-process GPU attribution (cmdline, PID, zombie state).

Docker Compose

services:
  otel-gpu-collector:
    image: ghcr.io/openlit/otel-gpu-collector:latest
    pid: host
    environment:
      OTEL_SERVICE_NAME: my-app
      OTEL_RESOURCE_ATTRIBUTES: deployment.environment=production
      OTEL_EXPORTER_OTLP_ENDPOINT: http://otel-collector:4318
    devices:
      - /dev/kfd:/dev/kfd
      - /dev/dri:/dev/dri
    restart: always

Kubernetes (DaemonSet)

apiVersion: apps/v1
kind: DaemonSet
metadata:
  name: otel-gpu-collector
  namespace: monitoring
spec:
  selector:
    matchLabels:
      app: otel-gpu-collector
  template:
    metadata:
      labels:
        app: otel-gpu-collector
    spec:
      hostPID: true
      containers:
        - name: collector
          image: ghcr.io/openlit/otel-gpu-collector:latest
          env:
            - name: OTEL_SERVICE_NAME
              value: gpu-collector
            - name: OTEL_RESOURCE_ATTRIBUTES
              value: deployment.environment=production
            - name: OTEL_EXPORTER_OTLP_ENDPOINT
              value: http://otel-collector.monitoring.svc.cluster.local:4318
          securityContext:
            privileged: false
          volumeMounts:
            - name: sys
              mountPath: /sys
              readOnly: true
            - name: dri
              mountPath: /dev/dri
      volumes:
        - name: sys
          hostPath:
            path: /sys
        - name: dri
          hostPath:
            path: /dev/dri

Docker --pid=host (or Kubernetes hostPID: true) and /dev/dri are required for per-process GPU attribution via DRM fdinfo.

Metrics reference

Full metrics list with types, units, and attributes

Configuration

All environment variables and defaults

Getting Started

Core Features

Integrations

Destinations

Requirements

Collected metrics

Docker

Docker Compose

Kubernetes (DaemonSet)

Metrics reference

Configuration

​Requirements

​Collected metrics

​Docker

​Docker Compose

​Kubernetes (DaemonSet)

Metrics reference

Configuration

Requirements

Collected metrics

Docker

Docker Compose

Kubernetes (DaemonSet)