环境数据

环境数据部分显示整个IBX以及机笼所在冷却区域的近乎实时的温度和湿度状况。您可以使用此部分来监控这些条件。

提示

冷却区是数据中心的一个区域，由公共机械基础设施支持。

提示

要指定温度是以华氏度还是摄氏度显示，请参阅用户首选项。

温度和湿度数据

Portal

如果您的组织购买了环境传感器，您可以在此页面上查看机柜和笼子级别的温度和湿度数据。

要查看此信息，请在仪表板上的 IBX 的环境图块中选择所有区域或特定区域。

本页显示。

• IBX 外的当前温度和湿度

• IBX 内所有冷却区的平均温度和湿度

• 冷却区内所有环境传感器的温度和湿度中值

  我们使用中值读数，是因为冷却区的传感器安装在不同的位置，用于监控和管理冷却装置的运行以及现场设备产生的热负荷。这些位置包括热风回风口、冷风分配区、天花板附近区域以及机笼内区域。

• 不同时间段的环境状况趋势，如现在与昨天相比，现在与上周相比，现在与上个月相比等。

• 一个创建自定义警报的选项

• 能够查看、定制和导出环境数据的趋势

API

如果您正在使用 API，则必须提交身份验证令牌，请参阅 API 身份验证 以获取说明。

要查看温度和湿度数据，请向 /environment/v1/current 端点发送 GET 请求。请在请求中将您的账号和 IBX 位置信息作为查询参数指定。

示例 cURL 请求：

curl -X GET 'https://api.equinix.com/environment/v1/current?accountNo=<your_account_no>&ibx=<ibx_code>&levelType=IBX&levelValue=<ibx_code>'
-H 'Authorization: Bearer <token>'

要进一步筛选数据，请使用 levelType 以及支持的值之一：IBX、ZONE、CAGE 或 SENSOR，并提供匹配的 levelValue。

示例 cURL 请求：

curl -X GET 'https://api.equinix.com/environment/v1/current?accountNo=<your_account_no>&ibx=<ibx_code>&levelType=CAGE&levelValue=<cage_id>'
-H 'Authorization: Bearer <token>'

注意

如果您不知道 IBX 代码、区域或笼位 ID​​，请使用 /smartview/v1/hierarchy/location 端点检索您的位置层次结构数据。

冷却区数据

Portal

要查看特定冷却区域内的温度和湿度，请从IBX中的下拉列表中选择它。

注意

这些环境读数只适用于安装了环境传感器的笼子/柜子。

API

要查看冷却区域数据，请向 /environment/v1/current 端点发送 GET 请求。请在请求中将您的账号和 IBX 位置信息作为查询参数指定。

示例 cURL 请求：

curl -X GET 'https://api.equinix.com/environment/v1/current?accountNo=<your_account_no>&ibx=<ibx_code>&levelType=ZONE&levelValue=<zone_id>'
-H 'Authorization: Bearer <token>'

响应返回指定位置的当前环境读数，包括温度、湿度和读数时间戳等值。

示例回答（已截断）：

{
  "temperature": 72.5,
  "humidity": 45.2,
  "timestamp": "2024-05-01T14:30:00Z"
}

要进一步筛选特定笼子的数据，请使用 levelType=CAGE 并将笼子 ID 作为 levelValue。

示例 cURL 请求：

curl -X GET 'https://api.equinix.com/environment/v1/current?accountNo=<your_account_no>&ibx=<ibx_code>&levelType=CAGE&levelValue=<cage_id>'
-H 'Authorization: Bearer <token>'

数据趋势

Portal

切换到图表视图，以图形格式查看趋势和任务中的数据。

从图表下方的下拉筛选器中选择最多五个冷却区域或机柜，以图形方式比较其环境条件。系统会同步两个图表之间的选择。

选择一个时间范围，从最近一天、一周或一个月的数据中选择你要查看的趋势。要定制日期范围，请使用日历。

API

要查看 7 天对比数据，请向 /environmental/v1/current 端点发送 GET 请求。请在请求中将您的账号和 IBX 位置信息作为查询参数指定。

示例 cURL 请求：

curl -X GET 'https://api.equinix.com/environment/v1/trending?accountNo=<your_account_no>&ibx=<ibx_code>&levelType=ibx&levelValue=<ibx_code>&interval=<interval>&fromDate=<epoch_timestamp_milliseconds>&toDate=<epoch_timestamp_milliseconds>'
-H 'Authorization: Bearer <token>'

示例 cURL 请求：

curl -X GET 'https://api.equinix.com/environment/v1/trending?accountNo=<your_account_no>&ibx=<ibx_code>&levelType=cabinet&levelValue=<cabinet_id>&interval=<interval>&fromDate=<epoch_timestamp_milliseconds>&toDate=<epoch_timestamp_milliseconds>'
-H 'Authorization: Bearer <token>'

生成报告

导出数据集的配置趋势来创建一个报告。你可以从用于生成趋势的数据中生成一个PDF文件。

在页面下方，您可以创建特定报告或查看所有最近生成的报告、高级报告和已保存的模板。

有关所有生成报告的详细信息，请参阅报告。