アラート
アラート・ルールを作成して、メトリック が定義されたしきい値を超えたときにアラート・イベントを送信します。アラートは warningThreshold と criticalThreshold の両方でトリガーすることができ、メトリック値が予想されるしきい値を下回ったり上回ったりした場合にアラートイベントをトリガーします。
アラートによってトリガーされるイベントを受信するには、選択したシンクでサブスクリプションを持つストリームからイベントを受信できる必要があります。アラートによってトリガーされるイベントは、カスタマー・ポータルや API では利用できません。
サポートされているメトリクスのリストを表示するには、Metrics ページを参照してください。
アラートの作成
前提条件警告ルールを追加するには、ポートまたは接続リソースが接続され、メトリックが有効になっているストリームが作成されている必要があります。
- Portal
- API
-
Observability_メニューから、Data Streams をクリックします。
-
Stream Inventory_からストリームを選択します。

-
ストリームの詳細]ページの[アクション]ドロップダウンメニューから、[アラートの追加] をクリックします。

-
Add Alert_ ページで、ルールのパラメータを入力します。
- Select a Metric_ ドロップダウンから接続またはポートメトリックを選択します。
- アラートに名前を付けましょう。
- アラートの説明を追加します(オプション)。
- オペランドの値を選択します:
ABOVEまたはBELOW。 - ウィンドウのサイズをドロップダウンから選択します。
- 警告しきい値_フィールドに警告イベントをトリガーするための値を設定します。
- Critical Threshold_フィールドにクリティカルイベントをトリガーするための値を設定します。

-
クリック次へ
-
リストからアラートを適用する接続またはポートを選択します。

-
クリック送信.
確認画面では、アラートにリソースを追加したり、アラートを受信するためにストリームにサブスクリプションを追加したり、別のアラートを追加したりできます。新しいアラートの詳細を表示するには、アラートの詳細を表示 をクリックします。

アラートを作成するには、/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"
}
}
スマートアラートの作成 - 遅延
添付メトロ](API-managing-assets.mdx)があるストリームでは、レイテンシしきい値のスマートアラートを作成できます。これらのAIを搭載したアラートは、機械学習を使用してメトロロケーション全体の過去のレイテンシーデータを分析し、ベースラインパフォーマンスを確立してスマートアラートしきい値を生成するため、手動によるアラート設定が不要になります。
- Portal
- API
スマートアラートルールを作成するには、アラートの作成と同じ手順に従ってください:
-
Select a Metric_ ドロップダウンメニューから、Fabric Metro Latency メトリックを選択します。
-
アラートに名前と説明(オプション)を付けます。次へ をクリックします。

-
スマートアラートルールを適用するメトロまたはメトロを選択します。

-
クリック送信
アラートのリストにアラートが表示されます。

スマートアラートルールを作成するには、/fabric/v4/streams/{streamId}/alertRules エンドポイントに POST リクエストを送信します。
metricSelector オブジェクトにアラートを作成するメトロ固有のメトリックを指定し、resourceSelector オブジェクトにリソースとして追加するストリームに接続されているメトロを指定し、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
ストリームのアラートリストを見るには:
-
Observability_メニューから、Data Streams をクリックします。
-
Stream Inventory_からストリームを選択します。

-
アラート をクリックしてください。

アラートの詳細を取得するには、/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
アラートを削除するには
-
Observability_メニューから、Data Streams をクリックします。
-
Stream Inventory_からストリームを選択します。

-
アラート をクリックしてください。
-
アラートのリストから、削除するアラートのオプションメニューをクリックし、アラートの削除 をクリックします。

アラートを削除するには、/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"
}
}