2.3 KiB
title, sidebar_label, description
| title | sidebar_label | description |
|---|---|---|
| Gauge Card | Gauge | The Gauge card is a basic card that allows visually seeing sensor data. |
The Gauge card is a basic card that allows visually seeing sensor data.
Screenshot of the Gauge card.
To add the Gauge card to your user interface, click the Lovelace menu (three dots at the top right of the screen) and then Edit Dashboard. Click the plus button in the bottom right corner and select Gauge from the card picker. All options for this card can be configured via the user interface.
Alternatively, the card can be configured using YAML:
type: gauge
entity: sensor.cpu_usage
{% configuration %}
type:
required: true
description: gauge
type: string
entity:
required: true
description: "Entity id to show"
type: string
name:
required: false
description: Name of Gauge Entity
type: string
default: Entity Name
unit:
required: false
description: Unit of Measurement given to data
type: string
default: "Unit Of Measurement given by entity"
theme:
required: false
description: Set to any theme within themes.yaml
type: string
min:
required: false
description: Minimum value for graph
type: integer
default: 0
max:
required: false
description: Maximum value for graph
type: integer
default: 100
severity:
required: false
description: Allows setting of colors for different numbers
type: map
keys:
green:
required: true
description: Value from which to start green color
type: integer
yellow:
required: true
description: Value from which to start yellow color
type: integer
red:
required: true
description: Value from which to start red color
type: integer
{% endconfiguration %}
Examples
Title and Unit of Measurement Example:
type: gauge
name: CPU Usage
unit: '%'
entity: sensor.cpu_usage
Screenshot of the gauge card with custom title and unit of measurement.
Define the severity map:
type: gauge
name: With Severity
unit: '%'
entity: sensor.cpu_usage
severity:
green: 0
yellow: 45
red: 85