警报
创建告警规则,以便在指标超过设定的阈值时发送告警事件。告警可以基于“警告阈值”和“严重阈值”触发,即当指标值低于或高于预期阈值时触发告警事件。
要接收由警报触发的事件,您需要能够从您订阅的流中接收事件,并且该流必须存储在您选择的接收器中。由警报触发的事件无法在客户门户或 API 中获取。
要查看支持的指标列表,请参阅指标页面。
创建警报
前提条件:要添加告警规则,您必须已创建包含端口和/或连接资源且启用了指标的流。
- Portal
- API
-
从“可观测性”菜单中,单击“数据流”。
-
从_流清单_中选择一个流。

-
在“流详情”页面上,从“操作”下拉菜单中,单击“添加提醒”。

-
在“添加警报”页面上,输入规则的参数。
- 从“选择指标”下拉菜单中选择连接或端口指标。
- 给你的提醒命名。
- 添加警报描述(可选)。
- 选择操作数值:
ABOVE或BELOW。 - 从下拉菜单中选择窗口大小。
- 在“警告阈值”字段中设置触发警告事件的值。
- 在“临界阈值”字段中设置触发临界事件的值。

-
点击下一步
-
从列表中选择要应用警报的连接或端口。

-
点击提交。
在确认页面,您可以为提醒添加更多资源,添加订阅以接收提醒,或添加其他提醒。要查看新提醒的详细信息,请点击查看提醒详情。

要创建警报,请向 /fabric/v4/streams/{streamId}/alertRules 端点发送 POST 请求。
示例 cURL 请求:
curl -X 'POST' 'https://api.equinix.com/fabric/v4/streams/<streamId>/alertRules' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <Bearer Token>' \
-d '{
"type": "METRIC_ALERT",
"name": "<alert_rule_name>",
"description": "<alert_rule_desc>",
"enabled": "true",
"metricSelector": {
"include": [
"equinix.fabric.port.bandwidth_tx.usage"
]
},
"resourceSelector": {
"include": [
"/fabric/v4/ports/780d384f-2eb6-4c07-ac89-ea106ca12814"
]
},
"detectionMethod": {
"type": "THRESHOLD",
"operand": "ABOVE",
"windowSize": "PT5M",
"warningThreshold": 200000,
"criticalThreshold": 300000
}
}'
示例响应:
{
"href": "https://api.equinix.com/fabric/v4/streams/128cfe7c-e24f-4b1b-8a4f-680cd650c46c/alertRules/28da40d8-09bf-49f2-a02d-af34210f275e",
"uuid": "128cfe7c-e24f-4b1b-8a4f-680cd650c46c",
"type": "METRIC_ALERT",
"name": "<alert_rule_name>",
"description": "<alert_rule_name>",
"state": "ACTIVE",
"enabled": true,
"metricSelector": {
"include": [
"equinix.fabric.port.bandwidth_tx.usage"
]
},
"resourceSelector": {
"include": [
"/fabric/v4/ports/780d384f-2eb6-4c07-ac89-ea106ca12814"
]
},
"detectionMethod": {
"type": "THRESHOLD",
"operand": "ABOVE",
"windowSize": "PT5M",
"warningThreshold": 200000,
"criticalThreshold": 300000
}
"changeLog": {
"createdBy": "testuser",
"createdDateTime": "2025-02-04T23:17:54.323427936Z"
}
}
创建智能警报 - 延迟
对于已连接 Metro 的 Stream,您可以创建延迟阈值智能警报。这些由 AI 驱动的警报会利用机器学习分析您所有 Metro 位置的历史延迟数据,从而建立基准性能并生成智能警报阈值,无需手动配置警报。
- Portal
- API
要创建智能警报规则,请按照创建警报中的相同步骤操作,然后:
-
从“选择指标”下拉菜单中选择“Fabric Metro Latency”指标。
-
为您的提醒命名并添加描述(可选)。点击下一步。

-
选择一个或多个城市,并应用智能警报规则。

-
点击提交
您的警报已显示在警报列表中。

要创建智能警报规则,请向 /fabric/v4/streams/{streamId}/alertRules 端点发送 POST 请求。
在 metricSelector 对象中指定要为其创建警报的 Metro 特定指标,在 resourceSelector 对象中指定要作为资源添加到流的 Metro,并将 detectionMethod.type 指定为 OUTLIER。
curl -X 'POST' 'https://api.equinix.com/fabric/v4/streams/<streamId>/alertRules' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <Bearer Token>' \
-d '{
"type": "METRIC_ALERT",
"name": "<alert_rule_name>",
"description": "<alert_rule_description>",
"enabled": true,
"metricSelector": {
"include": [
"equinix.fabric.metro.<metro_code>_<metro_code>.latency"
]
},
"resourceSelector": {
"include": [
"/fabric/v4/metros/{metro_code}"
]
},
"detectionMethod": {
"type": "OUTLIER"
}
}'
获取您的提醒
- Portal
- API
要查看流的警报列表:
-
从“可观测性”菜单中,单击“数据流”。
-
从_流清单_中选择一个流。

-
点击提醒。

要获取警报的详细信息,请向 /fabric/v4/streams/{streamId}/alertRules/{alertRuleId} 端点发送 GET 请求。
示例 cURL 请求:
curl -X 'GET' 'https://api.equinix.com/fabric/v4/streams/<streamId>/alertRules/<alertRuleId>' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <Bearer Token>'
示例响应:
{
"href": "https://api.equinix.com/fabric/v4/streams/128cfe7c-e24f-4b1b-8a4f-680cd650c46c/alertRules/28da40d8-09bf-49f2-a02d-af34210f275e",
"uuid": "128cfe7c-e24f-4b1b-8a4f-680cd650c46c",
"type": "METRIC_ALERT",
"name": "<alert_rule_name>",
"description": "<alert_rule_name>",
"state": "ACTIVE",
"enabled": true,
"metricSelector": {
"include": [
"equinix.fabric.port.bandwidth_tx.usage"
]
},
"resourceSelector": {
"include": [
"/fabric/v4/ports/780d384f-2eb6-4c07-ac89-ea106ca12814"
]
},
"detectionMethod": {
"type": "THRESHOLD",
"operand": "ABOVE",
"windowSize": "PT5M",
"warningThreshold": 200000,
"criticalThreshold": 300000
}
"changeLog": {
"createdBy": "testuser",
"createdDateTime": "2025-02-04T23:17:54.323427936Z"
}
}
删除提醒
- Portal
- API
删除提醒:
-
从“可观测性”菜单中,单击“数据流”。
-
从_流清单_中选择一个流。

-
点击提醒。
-
在警报列表中,单击要删除的警报的选项菜单,然后单击删除警报。

要删除警报,请向 /fabric/v4/streams/{streamId}/alertRules/{alertRuleId} 端点发送 DELETE 请求。
示例 cURL 请求:
curl -X DELETE 'https://api.equinix.com/fabric/v4/streams/<streamId>/alertRules/<alertRuleId>' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <Bearer Token>'
示例响应:
{
"href": "https://api.equinix.com/fabric/v4/streams/128cfe7c-e24f-4b1b-8a4f-680cd650c46c/alertRules/28da40d8-09bf-49f2-a02d-af34210f275e",
"uuid": "28da40d8-09bf-49f2-a02d-af34210f275e",
"type": "METRIC_ALERT",
"name": "<alert_rule_name>",
"description": "<alert_rule_name>",
"state": "INACTIVE",
"enabled": true,
"metricName": "equinix.fabric.port.bandwidth_tx.usage",
"resourceSelector": {
"include": [
"*/ports/<uuid>"
]
},
"windowSize": "PT15M",
"operand": "ABOVE",
"warningThreshold": "43000000",
"criticalThreshold": "45000000",
"changeLog": {
"createdBy": "testuser",
"createdDateTime": "2025-02-04T23:17:54.323427936Z"
}
}