统计卡片
统计卡片允许你显示实体的统计值。
对于支持统计的传感器,系统每5分钟收集一次统计数据。它会保留传感器在特定时期的最小值
、最大值
和平均值
,或者计量实体的总和
。
如果你的传感器不支持统计功能,请检查以下内容。
温度传感器的统计卡片截图。
要将统计卡片添加到你的用户界面:
-
在屏幕右上角,选择编辑按钮。
- 如果这是你首次编辑仪表板,会出现编辑仪表板对话框。
- 通过编辑仪表板,你将接管这个仪表板的控制权。
- 这意味着当新的仪表板元素可用时,它将不再自动更新。
- 一旦你接管控制权,你将无法让这个特定的仪表板恢复自动更新。不过,你可以创建一个新的默认仪表板。
- 要继续,在对话框中,选择三点菜单,然后选择接管控制。
- 如果这是你首次编辑仪表板,会出现编辑仪表板对话框。
-
添加卡片并自定义操作和功能到你的仪表板。
此卡片的所有选项都可以通过用户界面进行配置,但如果你想要更多的时间段选项,你将需要在yaml
中定义它们。
配置变量
type 字符串 必填
statistic
entity 字符串 必填
具有统计功能的传感器的实体ID,或外部统计ID
stat_type 字符串 必填
要渲染的统计类型。min
(最小值), max
(最大值), mean
(平均值), change
(变化值)
name 字符串 (可选,默认:实体名称)
实体名称。
icon 字符串 (可选)
覆盖图标。
unit 字符串 (可选)
给数据的测量单位。
默认:实体提供的测量单位。
period 映射 必填
用于计算的时间段。见下文。
theme 字符串 (可选)
使用任何已加载的主题覆盖此卡片的主题。有关主题的更多信息,请参阅前端文档。
footer 映射 (可选)
要渲染的底部小部件。参见页脚文档。
collection_key 字符串 (可选)
如果使用时间段:energy_date_selection
,你可以设置一个自定义键来匹配energy-date-selection
卡片的可选键。这通常不是必需的,但如果在同一视图上使用多个日期选择卡片,则可能很有用。参见能源文档。
示例
或者,可以使用YAML配置卡片:
type: statistic
entity: sensor.energy_consumption
period:
calendar:
period: month
stat_type: change
时间段选项
可以通过4种不同的方式配置时间段:
日历
使用带有当前周期偏移的固定周期。
配置变量
period 字符串 必填
要使用的周期。day
(日), week
(周), month
(月), year
(年)
offset 整数 (可选)
当前周期的偏移量,0表示当前周期,-1表示上一个周期。
示例,上个月的能源消耗变化:
type: statistic
entity: sensor.energy_consumption
period:
calendar:
period: month
offset: -1
stat_type: change
固定时间段
指定一个固定的时间段,开始和结束是可选的。
示例,2022年的变化:
type: statistic
entity: sensor.energy_consumption
period:
fixed_period:
start: 2022-01-01
end: 2022-12-31
stat_type: change
示例,不指定开始或结束的所有时间变化:
type: statistic
entity: sensor.energy_consumption
period:
fixed_period:
stat_type: change
滚动窗口
示例,1小时10分钟5秒的时间段,结束于现在之前的2小时20分钟10秒:
type: statistic
entity: sensor.energy_consumption
period:
rolling_window:
duration:
hours: 1
minutes: 10
seconds: 5
offset:
hours: -2
minutes: -20
seconds: -10
stat_type: change
动态日期选择
当放置在有能源日期选择卡片的视图上时,统计卡片可以链接显示从日期选择卡片上选择的时间段的数据。
日期选择器时间段的示例:
type: statistic
entity: sensor.energy_consumption
period: energy_date_selection
stat_type: change