Files
privilegedescalation-engineer[bot] 46821c747c release: v1.0.0 (#21)
Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
2026-03-21 23:59:53 +00:00

106 lines
4.5 KiB
YAML

version: "1.0.0"
name: headlamp-intel-gpu
displayName: Intel GPU
description: >-
Headlamp plugin for Intel GPU device plugin visibility and monitoring.
Surfaces GpuDevicePlugin CRD status, GPU-capable nodes with capacity and
allocation, pods requesting Intel GPU resources, and injects Intel GPU
sections into native Node and Pod detail pages. Supports discrete (i915),
Xe, and integrated GPU nodes with graceful degradation when the device
plugin operator is not installed. Includes a Metrics page showing real-time
GPU power draw and TDP from node-exporter i915 hwmon metrics (discrete GPU
nodes only).
createdAt: "2026-02-18T00:00:00Z"
license: Apache-2.0
category: monitoring-logging
homeURL: https://github.com/privilegedescalation/headlamp-intel-gpu-plugin
appVersion: "0.35.0"
install: |
## Installation
### Prerequisites
1. [Headlamp](https://headlamp.dev) v0.20.0 or later
2. [Intel Device Plugins for Kubernetes](https://intel.github.io/intel-device-plugins-for-kubernetes/) operator installed in your cluster (required for GPU node discovery and CRD visibility)
### Install via Headlamp Plugin Catalog
1. Open Headlamp and navigate to **Settings → Plugin Catalog**
2. Search for **"Intel GPU"**
3. Click **Install** and restart Headlamp when prompted
The plugin is sourced directly from [ArtifactHub](https://artifacthub.io/packages/headlamp/headlamp/headlamp-intel-gpu).
## Usage
After installation, the Intel GPU plugin adds:
- An **Overview** page showing cluster-level GPU counts, type distribution (discrete/integrated/Xe/unknown), and pod allocation summary
- A **Nodes** page with per-node GPU capacity, allocatable counts, and allocation bars
- A **Pods** page listing GPU-requesting pods grouped by phase (Running/Pending/Failed)
- A **Device Plugins** page showing GpuDevicePlugin CRD status
- A **Metrics** page with real-time power draw and TDP from i915 hwmon metrics (discrete GPU nodes only)
- Injected GPU sections on native **Node** and **Pod** detail pages
The plugin degrades gracefully when the Intel Device Plugins operator is not installed.
For more information, see the [README](https://github.com/privilegedescalation/headlamp-intel-gpu-plugin/blob/main/README.md).
keywords:
- headlamp
- kubernetes
- intel
- gpu
- intel-gpu
- device-plugin
- i915
- xe
- monitoring
- node-feature-discovery
maintainers:
- name: privilegedescalation
email: chris@farhood.org
provider:
name: privilegedescalation
links:
- name: GitHub
url: https://github.com/privilegedescalation/headlamp-intel-gpu-plugin
- name: Issues
url: https://github.com/privilegedescalation/headlamp-intel-gpu-plugin/issues
- name: Intel Device Plugins for Kubernetes
url: https://intel.github.io/intel-device-plugins-for-kubernetes/
changes:
- kind: fixed
description: "Remove unsafe `as any` casts in NodeDetailSection"
- kind: fixed
description: "Fix MetricsPage fetch cancellation safety (prevent setState on unmounted component)"
- kind: fixed
description: "Fix typo gpuPluinPods → gpuPluginPods in data context"
- kind: changed
description: "Move extractJsonData utility to module scope to avoid recreation on every render"
- kind: removed
description: "Remove dead AppBarGpuBadge component"
- kind: fixed
description: "Fix appVersion mismatch and inaccurate metrics description in Artifact Hub metadata"
- kind: fixed
description: "Resolve ESLint/Prettier indent conflict by disabling ESLint indent rule (Prettier is formatting authority)"
screenshots:
- title: Overview — cluster GPU summary, operator status, and active workloads
url: https://raw.githubusercontent.com/privilegedescalation/headlamp-intel-gpu-plugin/main/docs/screenshots/01-overview.svg
- title: GPU Nodes — per-node GPU type, capacity, and allocation bars
url: https://raw.githubusercontent.com/privilegedescalation/headlamp-intel-gpu-plugin/main/docs/screenshots/02-nodes.svg
- title: Metrics — real-time GPU power draw and TDP utilization (discrete GPUs)
url: https://raw.githubusercontent.com/privilegedescalation/headlamp-intel-gpu-plugin/main/docs/screenshots/03-metrics.svg
annotations:
headlamp/plugin/archive-url: "https://github.com/privilegedescalation/headlamp-intel-gpu-plugin/releases/download/v1.0.0/intel-gpu-1.0.0.tar.gz"
headlamp/plugin/archive-checksum: sha256:93d6c531e7c12440c9625138f0645fc0c3521b574d0089492759699b324943f0
headlamp/plugin/version-compat: ">=0.20.0"
headlamp/plugin/distro-compat: "in-cluster,web,app"