# アラート 場合にアラートイベントを送信するアラートルールを作成します。[メトリックが](https://docs.equinix.com/ja/observability/streaming-data/metrics.md)定義されたしきい値を超えたアラートは、との両方でトリガーでき`warningThreshold``criticalThreshold`、メトリック値が予想しきい値を下回った場合、または超えた場合にアラートイベントをトリガーします。 > **メモ** > > アラートによってトリガーされたイベントを受信するには、サブスクリプションがあるストリームから、選択したシンクでイベントを受信できる必要があります。アラートによってトリガーされたイベントは、カスタマーポータルまたはAPIでは利用できません。 サポートされているメトリクスのリストを表示するには、[メトリクス](https://docs.equinix.com/ja/observability/streaming-data/metrics.md)ページを参照してください。 ## アラートの作成[​](#アラートの作成 "への直接リンクアラートの作成") 前提条件:アラートルールを追加するには、ポートリソースや接続リソースが接続され、メトリックが有効になっているストリームを作成する必要があります * Portal * API 1. \[\_可視性]\_メニューの\[**データストリーム]を**クリックする。 2. \_ストリームインベントリ\_からストリームを選択します。 ![](https://docs.equinix.com/ja/assets/images/stream-inventory-49d715a84f2a27ab0ad7065aa1b5a12c.png) 3. \_[ストリームの詳細]\_ページで、[\_アクション]ドロップダウンメニュー\_から[**アラートの追加]を**クリックします。 ![](https://docs.equinix.com/ja/assets/images/alerts-add-alert-d701c09d768421435f2fd8270e33d51e.png) 4. \_[アラートの追加]\_ページで、ルールのパラメータを入力します。 * \_[メトリクスを選択]\_ドロップダウンから接続またはポートメトリクスを選択します。 * アラートに名前を付けましょう。 * アラートの説明を追加します(オプション)。 * オペランド値を選択します。`ABOVE`または。`BELOW` * ウィンドウのサイズをドロップダウンから選択します。 * *[警告しきい値*]フィールドで、警告イベントをトリガーする値を設定します。 * \_[クリティカルしきい値]\_フィールドで、クリティカルイベントをトリガーする値を設定します。 ![](https://docs.equinix.com/ja/assets/images/alerts-add-details-1260da4bcd4f5900148fd838e9078239.png) 5. **[次へ]を**クリック 6. リストからアラートを適用する接続またはポートを選択します。 ![](https://docs.equinix.com/ja/assets/images/alerts-add-resources-9a1f936ea57fccc5f180adc048bf93c5.png) 7. **\[送信]を**クリックします。 確認画面から、アラートにリソースを追加したり、アラートを受信するためのサブスクリプションをストリームに追加したり、別のアラートを追加したりできます。新しいアラートの詳細を表示するには、[**アラートの詳細を表示]を**クリックします。 ![](https://docs.equinix.com/ja/assets/images/alerts-confirmation-56da2a51526d3a408d68aab8e685f88d.png) アラートを作成するには、エンドポイントにリクエストを[`/fabric/v4/streams/{streamId}/alertRules`](https://docs.equinix.com/ja/api-catalog/fabricv4/stream-alert-rules/createstreamalertrules.md)送信します。`POST` サンプルcURLリクエスト: ``` curl -X 'POST' 'https://api.equinix.com/fabric/v4/streams//alertRules' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer ' \ -d '{ "type": "METRIC_ALERT", "name": "", "description": "", "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": "", "description": "", "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" } } ``` ### スマートアラートの作成 - 遅延[​](#スマートアラートの作成---遅延 "への直接リンクスマートアラートの作成 - 遅延") [都市圏を接続している](https://docs.equinix.com/ja/observability/streaming-data/api-managing-assets.md)ストリームの場合、レイテンシしきい値のスマートアラートを作成できます。AIを活用したこれらのアラートは、機械学習を使用して都市圏の拠点全体の履歴レイテンシデータを分析し、ベースラインパフォーマンスを確立し、スマートアラートしきい値を生成するため、手動でアラートを構成する必要がありません。 * Portal * API スマートアラートルールを作成するには、[アラートの作成と](#creating-an-alert)同じ手順に従い、以下を行います。 1. \_\_\[Select a Metric]ドロップダウンメニューから\*\*\[Fabric Metro Latency]メ\*\*トリックを選択します。 2. アラートに名前と説明を付けます(任意)。**[次へ]を**クリックします。 ![](https://docs.equinix.com/ja/assets/images/alerts-smart-latency-c42d0ce4f3d56c8da9eb3c2a622cebdc.png) 3. スマートアラートルールを適用する都市圏を選択します。 ![](https://docs.equinix.com/ja/assets/images/alerts-smart-metro-afc211583d4ddce8b1c986af8654b5cf.png) 4. **\[送信]を**クリックする アラートのリストにアラートが表示されます。 ![](https://docs.equinix.com/ja/assets/images/alerts-smart-list-4f495a14e11fe1257c1d0aff55e77dee.png) スマートアラートルールを作成するには、エンドポイントにリクエストを[`/fabric/v4/streams/{streamId}/alertRules`](https://docs.equinix.com/ja/api-catalog/fabricv4/stream-alert-rules/createstreamalertrules.md)送信します。`POST` オブジェクト内でアラートを作成する都市圏固有のメトリクス、オブジェクト内のリソースとして追加するストリームに接続されている都市圏を`resourceSelector`指定し、`metricSelector`としてを指定します。`detectionMethod.type``OUTLIER` ``` curl -X 'POST' 'https://api.equinix.com/fabric/v4/streams//alertRules' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer ' \ -d '{ "type": "METRIC_ALERT", "name": "", "description": "", "enabled": true, "metricSelector": { "include": [ "equinix.fabric.metro._.latency" ] }, "resourceSelector": { "include": [ "/fabric/v4/metros/{metro_code}" ] }, "detectionMethod": { "type": "OUTLIER" } }' ``` ## アラートの取得[​](#アラートの取得 "への直接リンクアラートの取得") * Portal * API ストリームのアラートリストを見るには: 1. \[\_可視性]\_メニューの\[**データストリーム]を**クリックする。 2. \_ストリームインベントリ\_からストリームを選択します。 ![](https://docs.equinix.com/ja/assets/images/stream-inventory-49d715a84f2a27ab0ad7065aa1b5a12c.png) 3. [アラート]をクリックします。\*\*\*\* ![](https://docs.equinix.com/ja/assets/images/alerts-list-5524a9aad0ccf5b74a49a4966b74d92e.png) アラートの詳細を取得するには、エンドポイントにリクエストを[`/fabric/v4/streams/{streamId}/alertRules/{alertRuleId}`](https://docs.equinix.com/ja/api-catalog/fabricv4/stream-alert-rules/getstreamalertrulebyuuid.md)送信します。`GET` サンプルcURLリクエスト: ``` curl -X 'GET' 'https://api.equinix.com/fabric/v4/streams//alertRules/' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer ' ``` 回答例 ``` { "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": "", "description": "", "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 アラートを削除するには 1. \[\_可視性]\_メニューの\[**データストリーム]を**クリックする。 2. \_ストリームインベントリ\_からストリームを選択します。 ![](https://docs.equinix.com/ja/assets/images/stream-inventory-49d715a84f2a27ab0ad7065aa1b5a12c.png) 3. [アラート]をクリックします。\*\*\*\* 4. アラートのリストから、削除するオプションメニューをクリックし、**アラートの削除をクリックします。** ![](https://docs.equinix.com/ja/assets/images/alerts-remove-fdea58374bc7c8af0e287139377896d9.png) アラートを削除するには、エンドポイントにリクエストを[`/fabric/v4/streams/{streamId}/alertRules/{alertRuleId}`](https://docs.equinix.com/ja/api-catalog/fabricv4/stream-alert-rules/deletestreamalertrulebyuuid.md)送信します。`DELETE` サンプルcURLリクエスト: ``` curl -X DELETE 'https://api.equinix.com/fabric/v4/streams//alertRules/' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer ' ``` 回答例 ``` { "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": "", "description": "", "state": "INACTIVE", "enabled": true, "metricName": "equinix.fabric.port.bandwidth_tx.usage", "resourceSelector": { "include": [ "*/ports/" ] }, "windowSize": "PT15M", "operand": "ABOVE", "warningThreshold": "43000000", "criticalThreshold": "45000000", "changeLog": { "createdBy": "testuser", "createdDateTime": "2025-02-04T23:17:54.323427936Z" } } ```