アラート
場合にアラートイベントを送信するアラートルールを作成します。メトリックが定義されたしきい値を超えたアラートは、との両方でトリガーできwarningThreshold``criticalThreshold、メトリック値が予想しきい値を下回った場合、または超えた場合にアラートイベントをトリガーします。
アラートによってトリガーされたイベントを受信するには、サブスクリプションがあるストリームから、選択したシンクでイベントを受信できる必要があります。アラートによってトリガーされたイベントは、カスタマーポータルまたは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"
}
}
スマートアラートの作成 - 遅延
都市圏を接続しているストリームの場合、レイテンシしきい値のスマートアラートを作成できます。AIを活用したこれらのアラートは、機械学習を使用して都市圏の拠点全体の履歴レイテンシデータを分析し、ベースラインパフォーマンスを確立し、スマートアラートしきい値を生成するため、手動でアラートを構成する必要がありません。
- Portal
- API
スマートアラートルールを作成するには、アラートの作成と同じ手順に従い、以下を行います。
-
__[Select a Metric]ドロップダウンメニューから**[Fabric Metro Latency]メ**トリックを選択します。
-
アラートに名前と説明を付けます（任意）。［次へ］をクリックします。
-
スマートアラートルールを適用する都市圏を選択します。
-
[送信]をクリックする
アラートのリストにアラートが表示されます。
スマートアラートルールを作成するには、エンドポイントにリクエストを/fabric/v4/streams/{streamId}/alertRules送信します。POST
オブジェクト内でアラートを作成する都市圏固有のメトリクス、オブジェクト内のリソースとして追加するストリームに接続されている都市圏をresourceSelector指定し、metricSelectorとしてを指定します。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"
}
}