このページは Apigee と Apigee ハイブリッドに適用されます。
Apigee Edge ドキュメントを表示する
API Monitoring の主な目的の 1 つは、トラフィックやレイテンシの急増など、異常なイベントやパターンを知らせることです。このようなイベントを追跡するため、アラートを設定できます。アラートは、指定されたイベントが発生したときにトリガーされます。アラートをトリガーする実際のイベントは、インシデントと呼ばれます。
アラートには特定のルールを設定できます。たとえば、プロキシでレスポンス コード 500(内部サービスエラー)が発生した場合にトリガーすることもできます。アラート対象のインシデントが発生したら、Google Cloud コンソールの [アラート] ページの [インシデント] ペインで詳細を確認できます。
特定のアラートがトリガーされたときに通知を受け取るには、アラートの通知を設定します。インシデントが発生すると、詳細な調査のために Google Cloud コンソールと Apigee UI へのリンクを含むイベントの概要が記載された通知が送信されます。
API Monitoring には、次の 2 種類のアラートがあります。
- 指標ベースのアラート: API 指標の変更によってトリガーされます。
- ログベースのアラート: Cloud Logging によって保存された API データに基づきます。
指標ベースのアラート
指標ベースのアラートは、API データの指標が指定されたレベルに達した場合、または急速に変化し始めた場合にトリガーされます。2 つの主なプロパティを使用してアラートルールを定義します。
- 指標: アラートをトリガーする数量(リクエストの数など)。
- しきい値: アラートをトリガーするために必要な指標のレベル。
次のセクションでは、指標ベースのアラートの例を示します。
プロキシのレスポンス コード 500 のアラート
次の例では、レスポンス コード 500(内部サーバーエラー)が返されたときのアラートを作成しています。どのレスポンス コードにも、同様のアラートを作成できます。
アラートを作成するには、まず次の手順を行います。
Google Cloud コンソールで [通知ポリシーを作成] ページを開きます。
- [指標を選択] をクリックします。
- [アクティブなリソースと指標のみを表示] をオフにします。
注: 組織に最近の API トラフィック データが存在しない場合は、このオプションを選択しない限り、次のステップの指標は表示されません。
- 次のように指標を選択します。
- 次のコードをコピーして、[指標を選択してください] フィールドに貼り付けます。
apigee.googleapis.com/proxyV2/response_count
- [Apigee proxy (v2)] を選択します。
- 右側に表示されたペインで、[Proxyv2] を選択します。
- 右側のペインで、[Apigee proxy response cumulative count] を選択します。
- [適用] をクリックします。
- 次のコードをコピーして、[指標を選択してください] フィールドに貼り付けます。
- レスポンス コードのフィルタを次のように追加します。
- [フィルタを追加] をクリックします。
- [Filter] フィールドをクリックし、プルダウン メニューから [response_code] を選択します。
- [Comparator] で [=] を選択します。
- [Value] フィールドに「500」と入力します。
- [完了] をクリックします。
アラート トリガーを構成する
アラートをトリガーするイベントを構成するには、まず左側のペインで [トリガーの設定] をクリックします。以下の手順に沿って操作を行います。
- [Condition Types] で [Threshold] を選択します。
- [Alert trigger] フィールドで、[任意の時系列の違反] を選択します。
- [しきい値の位置] フィールドで、[しきい値より上] を選択します。
- [しきい値] フィールドに「1」と入力します。
この設定では、コード 500 のレスポンスが返されるとアラートがトリガーされます。
[NEXT] をクリックして [Configure notifications and finalize alert] ペインを開きます。
アラートの通知を設定する
[Configure notifications and finalize alert] ペインで、アラートがトリガーされたときに送信される通知を設定できます。手順は次のとおりです。
[通知チャンネル] フィールドをクリックします。メールアドレスや SMS 番号など、通知用のチャネルをすでに作成している場合は、[通知チャンネル] でチャネルを選択できます。
それ以外の場合は、[Manage Notification Channels] を選択して、チャネルを追加する必要があります。[通知チャンネル] ペインが開き、1 つ以上のチャネルを追加できます。詳細については、通知チャンネルを管理するをご覧ください。完了したら、[Configure notifications and finalize alert] ペインに戻ります。
注: 新しいチャネルを作成した後に、[Manage Notification Channels] の横にある更新ボタンをクリックしなければならない場合があります。 1 つ以上の通知チャネルを選択したら、[OK] をクリックします。
- [Documentation] フィールドには、通知と一緒に送信されるメッセージを追加できます。たとえば、メッセージにアラートの理由を追加することも、対応方法を説明するドキュメントへのリンクを含めることもできます。
- [Next] をクリックして、アラートの詳細を確認します。問題がなければ、[ポリシーを作成] をクリックしてアラート ポリシーを作成します。
条件の追加: プロキシの HTTP POST リクエストに対するレスポンス コード 500 のアラート
1 つのアラートに対して複数の条件を作成できます。たとえば、前のセクションで説明したプロキシのレスポンス コード 500 のアラートに、HTTP POST リクエストに対してのみアラートがトリガーされるという条件を追加できます。この場合、前の例と同じ手順を行いますが、ステップ 8 の後に、次のように別のフィルタを追加します。
- [フィルタを追加] をクリックします。
- [フィルタ] フィールドをクリックし、プルダウン リストから [method HTTP method] を選択します。
- [コンパレータ] フィールドで [=] を選択します。
- [値] に「POST」と入力します。
- [完了] をクリックします。
その後で、アラート トリガーを構成するの手順に進みます。完了後、プロキシが HTTP POST リクエストから 500 レスポンス コードを受信すると、アラートがトリガーされます。
関連する例については、レスポンス コードと HTTP メソッドの組み合わせに関するアラートをご覧ください。
インシデントの詳細の表示
アラートをトリガーする API イベントは、インシデントと呼ばれます。最近のインシデントの詳細は、Google Cloud コンソールの [アラート] ページで確認できます。
指標とフィルタ
このセクションでは、指標ベースのアラートの作成に使用できる指標とフィルタについて説明します。
指標
指標は、アラートをトリガーする量で、たとえばリクエストの数を表します。下の表に使用可能な指標を示します。
指標 | 説明 |
---|---|
apigee.googleapis.com/proxyv2/request_count |
Apigee API プロキシが受信したリクエストの合計数。 |
apigee.googleapis.com/proxyv2/response_count |
Apigee API プロキシによって返されるレスポンスの合計数。 |
apigee.googleapis.com/proxyv2/latencies_percentile |
リクエストに対するすべての API ポリシー レスポンスのパーセンタイル。 |
フィルタ
フィルタを使用すると、API データのサブセットに対してアラートを作成できます。フィルタでは、サブセットを定義する条件を指定します。たとえば、1 つのプロキシのデータに基づいてアラートを作成できます。
次のフィルタから選択できます。
フィルタ | 説明 | フィルタを適用できる指標 |
---|---|---|
env |
データの環境。 | すべて |
location |
データの場所。 | すべて |
proxy_name |
データのプロキシ。 | すべて |
runtime_version |
データのランタイム バージョン。 | すべて |
instance_id |
データのインスタンス ID。 | すべて |
method |
データの HTTP メソッド。 | すべて |
response_code |
データの HTTP レスポンス コード。 | apigee.googleapis.com/proxyv2/response_count |
fault_code |
データの障害コード。 | apigee.googleapis.com/proxyv2/response_count |
fault_source |
データの障害発生元。 | apigee.googleapis.com/proxyv2/response_count |
percentile |
Apigee プロキシ レスポンス レイテンシのパーセンタイル。 | apigee.googleapis.com/proxyv2/latencies_percentile |
ログベースのアラート
前のセクションで説明した指標ベースのアラートに加えて、Cloud Logging によって保存された API をモニタリングするログベースのアラートを作成することもできます。
ログベースのアラートの設定
以下の例は、ログベースのアラートの設定方法を示しています。詳細については、ログ エクスプローラでクエリを作成するをご覧ください。
- Google Cloud コンソールでログ エクスプローラを開きます。
- ログ エクスプローラの右側にある [クエリを表示] を選択します。
- [クエリ] ペインで、次の例のようなクエリを入力します。
resource.type="apigee.googleapis.com/Environment" logName="projects/<project_id>/logs/apigee.googleapis.com%2Fanomaly_event"
- [クエリを実行] をクリックします。結果は、[アラートの対象となるログエントリが返されることを確認する] に表示されます。
- [クエリ] ペインで [アラートを作成] をクリックします。
- [ログベースのアラート ポリシーの作成] ダイアログの手順に沿って、アラートを作成します。詳細については、ログベースのアラートの構成をご覧ください。