アラート
ときにアラートイベントを送信するアラートルールを作成する。メトリックが定義されたしきい値を超えたアラートはとの両方でトリガーでき、メwarningThreshold``criticalThresholdトリック値が予想されるしきい値を下回るか超えた場合にアラートイベントをトリガーする。
Alertによってトリガーされたイベントを受信するには、選択したシンクでサブスクリプションを持っているストリームからイベントを受信できる必要がある。アラートによってトリガーされたイベントがカスタマーポータルまたはAPIで使用できない。
サポートされているメトリクスの一覧は、メトリクスのページを参照。
アラートを作成する
前提条件:アラートルールを追加するには、ポートリソースまたは接続リソースが接続され、メトリックが有効になっているストリームを作成する必要がある
- Portal
- API
-
_Observability_メニューからデータストリームをクリックする。
-
ストリームインベントリ_からストリームを選択する。
-
[Stream Details]ページの[Actions]ドロップダウンメニューから[*Add Alerts]をクリックする。
-
[Add Alert]ページで、ルールのパラメータを入力する。
- [Select a Metric]ドロップダウンから、[接続（Connection）]または[ポートメトリック（Port Metric）]を選択する。
- アラートに名前を付ける。
- アラートの説明を追加する（オプション）。
- オペランドの値（または）を選択する。
ABOVE``BELOW - ドロップダウンからウィンドウサイズを選択する。
- 警告しきい値フィールドで警告イベントをトリガーする値を設定する。
- 重要なイベントをトリガーする値を_Critical Threshold_フィールドに設定する。
-
[次へ]をクリックします。
-
リストからアラートを適用する接続またはポートを選択する。
-
「送信」をクリックします。
確認画面から、アラートにリソースを追加したり、アラートを受信するためのサブスクリプションをストリームに追加したり、別のアラートを追加したりできる。新しいアラートの詳細を表示するには'[View Alert Details]をクリック
アラートを作成するには、エンドポイントにリクエストを/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"
}
}
スマートアラートの作成-遅延
Metrosをアタッチしたストリームでは、レイテンシのしきい値のスマートアラートを作成できる。AIを活用したこれらのアラートは、機械学習を使用してメトロロケーション全体の履歴レイテンシデータを分析し、ベースラインパフォーマンスを確立し、スマートアラートしきい値を生成するため、手動でアラートを設定する必要がない。
- Portal
- API
スマートアラートルールを作成するには、アラートの作成と同じ手順を実行し、
-
[Select a Metric]ドロップダウン・メニューから[*Fabric Metro Latency]メトリックを選択する
-
アラートに名前と説明を付ける（オプション）。次へをクリックする。
-
スマートアラートルールを適用するメトロまたはメトロを選択する。
-
「送信」をクリックします。
アラートがアラートのリストに表示される
スマートアラートルールを作成するには、エンドポイントにリクエストを/fabric/v4/streams/{streamId}/alertRules送信する。POST
オブジェクト内でアラートを作成するMetro固有のメトリック、オブジェクト内のリソースとして追加するストリームに接続されているMetroをresourceSelector指定し、metricSelectorASを指定する。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_メニューからデータストリームをクリックする。
-
ストリームインベントリ_からストリームを選択する。
-
Alertsをクリックする。
アラートの詳細を取得するには、エンドポイントにリクエストを/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_メニューからデータストリームをクリックする。
-
ストリームインベントリ_からストリームを選択する。
-
Alertsをクリックする。
-
アラートのリストから、削除するオプションメニューをクリックし、アラートの削除をクリックする。
アラートを削除するには、エンドポイントにリクエストを/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"
}
}