version: "1.1.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.1.0/intel-gpu-1.1.0.tar.gz"
  headlamp/plugin/archive-checksum: sha256:e212381f38c331383604b06f6552997fcba5c8b42a3bd828e3b43ed3e5028448
  headlamp/plugin/version-compat: ">=0.20.0"
  headlamp/plugin/distro-compat: "in-cluster,web,app"