2025.3.4
首页 ▸ Integrations ▸

HP 综合灯控（ILO）

hp_ilo integration集成将 Home Assistant 与您的设备、服务等连接和集成。 [Learn more] 允许您对服务器的 HP ILO（综合灯控）传感器进行 API 调用，并在 Home Assistant 传感器中使用这些数据。

如果 ILO 或指定的 jsonpath 查询只返回单个值（例如，温度或状态），则该值将放入状态字段。如果返回一个数据结构，它将放置在 ilo_data 属性中。

有关可以从这些传感器检索的更多详细信息，请参阅 python-hpilo 文档。

配置

要在您的安装中使用此集成，请将以下内容添加到您的 configuration.yamlconfiguration.yaml 文件是 Home Assistant 的主要配置文件。它列出了要加载的集成及其特定配置。在某些情况下，需要直接在 configuration.yaml 文件中手动编辑配置。大多数集成可以在 UI 中配置。 [Learn more] 文件中。 在更改了configuration.yamlconfiguration.yaml 文件是 Home Assistant 的主要配置文件。它列出了要加载的集成及其特定配置。在某些情况下，需要直接在 configuration.yaml 文件中手动编辑配置。大多数集成可以在 UI 中配置。 [Learn more] 文件后，重启 Home Assistant 以应用更改。 该集成现在显示在集成页面的 设置 > 设备与服务 下。其实体在集成卡片上以及实体标签上列出。

# 示例 configuration.yaml 条目
sensor:
  - platform: hp_ilo
    host: IP_ADDRESS 或 HOSTNAME
    username: YOUR_USERNAME
    password: YOUR_PASSWORD
    monitored_variables:
      - name: 传感器名称
        sensor_type: 传感器类型

Configuration Variables

Looking for your configuration file?
host string Required

可以访问 ILO 的主机名或 IP 地址。

port string (Optional, default: 443)

可以访问 ILO 的端口。

username string Required

用于连接到 ILO 的用户名。

password string Required

用于连接到 ILO 的密码。

monitored_variables list (Optional, default: 默认为空列表（不创建任何传感器）。)

从 ILO 数据创建的传感器。

name string Required

传感器名称。

sensor_type string Required

传感器类型，必须是以下指定的有效传感器类型之一。

unit_of_measurement string (Optional)

传感器的计量单位。

value_template template (Optional)

当在这里指定 Jinja2 模板时，创建的传感器将输出模板结果。可以用 ilo_data 变量引用 ILO 响应。

有效的传感器类型：

  • server_name: 获取此 iLO 管理的服务器名称。
  • server_fqdn: 获取此 iLO 管理的服务器 fqdn。
  • server_host_data: 获取描述主机的 SMBIOS 记录。
  • server_oa_info: 获取封闭机箱的板载管理员信息。
  • server_power_status: 服务器是否开启。
  • server_power_readings: 获取当前值、最小值、最大值和平均功率读数。
  • server_power_on_time: 服务器开机多少分钟前（非重置计数器，类似于已使用的小时数）。
  • server_asset_tag: 获取服务器资产标签。
  • server_uid_status: 获取 UID 灯的状态。
  • server_health: 获取服务器健康信息。
  • network_settings: 获取 iLO 网络设置。

示例

为了获取两个传感器报告 CPU 风扇速度和环境进气温度，以及 HP Microserver Gen8 上 server_health 的转储，您可以在您的 configuration.yamlconfiguration.yaml 文件是 Home Assistant 的主要配置文件。它列出了要加载的集成及其特定配置。在某些情况下，需要直接在 configuration.yaml 文件中手动编辑配置。大多数集成可以在 UI 中配置。 [Learn more] 文件中使用以下内容

sensor:
  - platform: hp_ilo
    host: IP_ADDRESS 或 HOSTNAME
    username: YOUR_USERNAME
    password: YOUR_PASSWORD
    monitored_variables:
      - name: CPU 风扇速度
        sensor_type: server_health
        unit_of_measurement: "%"
        value_template: '{{ ilo_data.fans["Fan 1"].speed[0] }}'
      - name: 进气温度
        sensor_type: server_health
        unit_of_measurement: "°C"
        value_template: '{{ ilo_data.temperature["01-Inlet Ambient"].currentreading[0] }}'
      - name: 服务器健康
        sensor_type: server_health
        value_template: '{{ ilo_data.health_at_a_glance }}'

硬件具体信息

Note

并非所有硬件都支持所有值。

HP Microserver Gen8

在此硬件上，您应避免使用以下传感器类型作为 monitored_variables: 以防止错误。

  • server_oa_info
  • server_power_readings
  • server_power_on_time

相关主题