このページの内容は Apigee に適用されます。Apigee ハイブリッドには適用されません。
Apigee Edge のドキュメントを表示する。
Apigee リソースの使用状況の表示とモニタリングに使用できるツールがいくつかあります。このトピックでは、課金管理者または組織管理者が次のことを行う方法について説明します。
- Metrics Explorer でリソースの使用状況を表示する
- Cloud Monitoring アラートを構成する
- 請求先アカウントごとのリソース使用状況の表示
- Cloud Audit Logging でリソースをモニタリングする
組織リソースの使用状況を表示してアラートを構成するには、次のロールが必要です。
- Apigee 組織管理者(
roles/apigee.admin
) - ログ閲覧者
(roles/logging.viewer
) - 請求先アカウント閲覧者 (
roles/billing.viewer
)
Metrics Explorer でリソースの使用状況を表示する
Metrics Explorer を使用すると、従量課金制の料金プランで費用を決定するための主要な属性である Apigee リソースの使用状況を確認できます。特定の指標とフィルタを選択すると、Apigee プロキシ / 共有フローのデプロイ ユニット、Apigee アクティブ環境、またはその両方の使用状況レポートを生成できます。
Apigee の指標とその有効な値の詳細については、Google Cloud の指標ページの apigee をご覧ください。
Apigee プロキシ / 共有フローのデプロイ ユニットの使用状況
Metrics Explorer の UI
Metrics Explorer で Apigee プロキシ / 共有フローのデプロイ ユニットの使用状況を表示する手順は次のとおりです。
- Google Cloud コンソールで [モニタリング] > [Metrics Explorer] ページを開きます。
- [指標を選択] ペインで、[指標] メニューを開き、フィルタバーに「
Apigee
」と入力します。サブメニューを使用して、リソースタイプ、カテゴリ、指標を選択します。
- [有効なリソース] メニューで、[Apigee proxy] を選択します。
- [有効な指標カテゴリ] メニューで、[Proxy] を選択します。
- [有効な指標] メニューで、[Apigee プロキシの詳細] を選択します。
- [適用] をクリックします。
- [フィルタ] セクションで次の操作を行います。
- [グループ] メニューを使用して、[リソースラベル] でグループ化します。プロキシのデプロイの種類と環境別にグループ化するには、リストのオプションから
proxy_deployment_type
とenv
の両方を選択します。 - [OK] をクリックしてフィルタを適用します。
- [グループ] メニューを使用して、[リソースラベル] でグループ化します。プロキシのデプロイの種類と環境別にグループ化するには、リストのオプションから
- [グループ化関数] メニューから [カウント] を選択します。
MQL
MQL クエリを使用して Apigee プロキシ/共有フローのデプロイ ユニットの使用状況を表示する手順は次のとおりです。
- Google Cloud コンソールで [モニタリング] > [Metrics Explorer] ページを開きます。
- [指標を選択] ペインのツールバーで、[コードエディタ] を選択します。
- MQL を使用するには:
- 言語切り替えボタンの [MQL] を選択します。
- 次のクエリをクエリエディタに入力します。
fetch apigee.googleapis.com/Proxy | metric 'apigee.googleapis.com/proxy/details' | group_by [metric.proxy_deployment_type, resource.env]
PromQL
PromQL クエリを使用して Apigee プロキシ / 共有フローのデプロイ ユニットの使用状況を表示する手順は次のとおりです。
- Google Cloud コンソールで [モニタリング] > [Metrics Explorer] ページを開きます。
- [指標を選択] ペインのツールバーで、[コードエディタ] を選択します。
- PromQL を使用するには:
- 言語切り替えボタンの [PromQL] を選択します。
- 次のクエリをクエリエディタに入力します。
count(apigee_googleapis_com:proxy_details{monitored_resource="apigee.googleapis.com/Proxy"}) by (proxy_deployment_type, env)
Apigee のアクティブな環境の使用状況
Metrics Explorer の UI
Metrics Explorer で Apigee アクティブ環境の使用状況を表示する手順は次のとおりです。
- Google Cloud コンソールで [モニタリング] > [Metrics Explorer] ページを開きます。
- [指標を選択] ペインで、[指標] メニューを開き、フィルタバーに「
Apigee
」と入力します。サブメニューを使用して、リソースタイプ、カテゴリ、指標を選択します。
- [有効なリソース] メニューで、[Apigee 環境] を選択します。
- [アクティブな指標カテゴリ] メニューで、[環境] を選択します。
- [アクティブな指標] メニューで、[Apigee アクティブ環境] を選択します。
- [適用] をクリックします。
- [フィルタ] セクションで次の操作を行います。
- [グループ] メニューを使用して、[リソースラベル] でグループ化します。環境タイプ別にグループ化するには、リストのオプションから [
type
] を選択します。 - [OK] をクリックしてフィルタを適用します。
- [グループ] メニューを使用して、[リソースラベル] でグループ化します。環境タイプ別にグループ化するには、リストのオプションから [
- [グループ化関数] メニューから [カウント] を選択します。
MQL
MQL クエリを使用して Apigee アクティブ環境の使用状況を表示する手順は次のとおりです。
- Google Cloud コンソールで [モニタリング] > [Metrics Explorer] ページを開きます。
- [指標を選択] ペインのツールバーで、[コードエディタ] を選択します。
- MQL を使用するには:
- 言語切り替えボタンの [MQL] を選択します。
- 次のクエリをクエリエディタに入力します。
fetch apigee.googleapis.com/Environment | metric 'apigee.googleapis.com/environment/active' | group_by [metric.type, resource.env]
PromQL
PromQL クエリを使用して Apigee アクティブ環境の使用状況を表示する手順は次のとおりです。
- Google Cloud コンソールで [モニタリング] > [Metrics Explorer] ページを開きます。
- [指標を選択] ペインのツールバーで、[コードエディタ] を選択します。
- PromQL を使用するには:
- 言語切り替えボタンの [PromQL] を選択します。
- 次のクエリをクエリエディタに入力します。
count(apigee_googleapis_com:environment_active{monitored_resource="apigee.googleapis.com/Environment"}) by (env, type)
Standard API 呼び出しと Extensible API 呼び出し
Metrics Explorer の UI
Metrics Explorer で環境別の Standard API 呼び出しと Extensible API 呼び出しを表示するには、次の手順に沿って操作します。
- Google Cloud コンソールで [モニタリング] > [Metrics Explorer] ページを開きます。
- [指標を選択] ペインで、[指標] メニューを開き、フィルタバーに「
Apigee
」と入力します。サブメニューを使用して、リソースタイプ、カテゴリ、指標を選択します。
- [有効なリソース] メニューで、[Apigee 環境] を選択します。
- [アクティブな指標カテゴリ] メニューで、[環境] を選択します。
- [有効な指標] メニューで、[Apigee 環境 API 呼び出し数] を選択します。
- [適用] をクリックします。
- [フィルタ] セクションで次の操作を行います。
- [グループ] メニューを使用して、[リソースラベル] でグループ化します。環境タイプ別にグループ化するには、リストのオプションから [
proxy_deployment_type
] を選択します。 - [OK] をクリックしてフィルタを適用します。
- [グループ] メニューを使用して、[リソースラベル] でグループ化します。環境タイプ別にグループ化するには、リストのオプションから [
- グループ化関数メニューから [合計] を選択します。
MQL
MQL クエリを使用して、環境ごとの Standard API 呼び出しと Extensible API 呼び出しを表示するには、次の手順に沿って操作します。
- Google Cloud コンソールで [モニタリング] > [Metrics Explorer] ページを開きます。
- [指標を選択] ペインのツールバーで、[コードエディタ] を選択します。
- MQL を使用するには:
- 言語切り替えボタンの [MQL] を選択します。
- 次のクエリをクエリエディタに入力します。
fetch apigee.googleapis.com/Environment | metric 'apigee.googleapis.com/environment/api_call_count' | delta(1m) | group_by [metric.proxy_deployment_type, resource.env, resource.location]
PromQL
PromQL クエリを使用して、環境別の Standard API 呼び出しと Extensible API 呼び出しを表示するには、次の手順に沿って操作します。
- Google Cloud コンソールで [モニタリング] > [Metrics Explorer] ページを開きます。
- [指標を選択] ペインのツールバーで、[コードエディタ] を選択します。
- PromQL を使用するには:
- 言語切り替えボタンの [PromQL] を選択します。
- 次のクエリをクエリエディタに入力します。
sum(delta(apigee_googleapis_com:environment_api_call_countmonitored_resource="apigee.googleapis.com/Environment"}[1m])) by (proxy_deployment_type,env,location)
指標のダッシュボードを作成する
[グラフ] タブの Metrics Explorer のグラフィカルな出力は、ゲージ指標を表します。つまり、グラフ上の各ポイントは、測定時に各リージョンのすべての環境における Apigee インスタンスのリソース使用率を記録しています。
[リソースと指標] を選択してデータのビューを構成したら、後で参照できるようにデータをカスタム ダッシュボードに保存できます。選択したビューを保存するには:
- [エクスプローラ] タブのグラフペインで [グラフを保存] ボタンをクリックします。
- [グラフを保存] ダイアログで、次の情報を入力します。
- グラフタイトル フィールド: グラフの名前を入力するか、提案されたタイトルを使用します。
- [ダッシュボード] プルダウン: 既存のダッシュボードを選択するか、[新しいダッシュボード] を選択して、新しいダッシュボードを作成して名前を付けます。選択したダッシュボードにグラフが保存されます。
- [保存] をクリックします。
保存したら、Google Cloud コンソールの [ダッシュボードの概要] ページに移動し、選択したダッシュボードを表示すると、グラフにアクセスできます。
Cloud Monitoring を使用したカスタムビューの作成と管理の詳細については、ダッシュボードとグラフをご覧ください。
Cloud Monitoring アラートを構成する
Cloud Monitoring で Apigee リソースの使用状況に関する指標レポートを構成すると、指標ベースのアラート ポリシーを有効にできます。アラート ポリシーを構成して、従量課金制プランに関連するリソース使用量をモニタリングし、潜在的な問題をタイムリーに認識させることができます。詳細については、アラートの仕組みをご覧ください。
指標ベースのアラート ポリシーは、Google Cloud コンソール、Cloud Monitoring API、または Google Cloud CLI を使用して Google Cloud プロジェクトに追加できます。Google Cloud コンソールを使用する場合は、Cloud Monitoring の [アラート] ページから、推奨アラートを有効にしたり、カスタム アラートを構成したりできます。
指標ベースのアラート ポリシーの作成に必要な一般的な手順については、指標しきい値のアラート ポリシーを作成するをご覧ください。特にリソースの使用状況に基づいてアラート ポリシーを構成するには、アラート ポリシーを作成するの手順に沿って操作します。
前のセクションで使用したものと同じ指標とフィルタを使用して、リソース使用状況のアラートをカスタマイズできます。たとえば、Apigee プロキシの使用状況に基づいてアラートを作成するには、次の操作を行います。
- Google Cloud コンソールで [Monitoring] > [アラート] ページを開きます。
- [+ Create Policy] をクリックします。
- [通知ポリシーの作成] ペインの [指標を選択] セクションで、フィルタバーに「
Apigee
」と入力し、サブメニューを使用してリソースタイプ、カテゴリ、指標を選択します。- [有効なリソース] メニューで、[Apigee proxy] を選択します。
- [有効な指標カテゴリ] メニューで、[Proxy] を選択します。
- [有効な指標] メニューで、[Apigee プロキシの詳細] を選択します。
- [フィルタの追加] セクションの [グループ化] メニューを使用して、リソースラベルでグループ化します。プロキシのデプロイの種類と環境別にグループ化するには、リストのオプションから
proxy_deployment_type
とenv
の両方を選択します。
Apigee のアクティブ環境の使用状況に基づくアラートを作成するには、Apigee 環境の使用状況の表示に使用する指標とフィルタを選択します。
請求先アカウントごとのリソース使用状況の表示
請求先アカウントごとにリソース使用状況を表示する手順は次のとおりです。
- Google Cloud コンソールで [リポジトリ] ページを開きます。
- 請求先アカウントが複数ある場合は、[リンクされた請求先アカウントに移動] を選択して、現行プロジェクトの請求先アカウントを表示します。別の請求先アカウントを確認するには、[請求先アカウントを管理] を選択し、表示するアカウントを選択します。
- レポートを選択します。
- [フィルタ] メニューがまだ開いていない場合は、[フィルタを表示] をクリックします。
- [期間] フィールドで [使用日] を選択して、特定の期間の請求の現在のスナップショットを表示します。または、[請求月] を選択して、特定の請求書で請求された使用量を表示します。
- [グループ条件] > [SKU] の順に選択します。
- [Services] プルダウン リストから [Apigee] を選択します。請求に含まれる SKU のリストが表示されます。
- SKU のリストをフィルタするには、[SKU] プルダウン リストから表示する SKU を選択します。
これらの SKU のいずれかの使用状況が 0 の場合、[グループ条件] > [SKU] プルダウン メニューには表示されません。
Cloud Audit Logging でリソースの使用状況をモニタリングする
Cloud Audit Logs を使用して、従量課金制に影響するリソース使用量をモニタリングできます。関連する監査ログを表示する手順は次のとおりです。
- Google Cloud コンソールで [ログ エクスプローラ] ページを開きます。
- [クエリ] の検索バーを使用して、次の課金対象リソースに影響するイベントを検索します。
- 環境が接続されたインスタンス
google.cloud.apigee.v1.InstanceService.CreateInstanceAndAttachments
を作成します - インスタンスとそのアタッチメントを更新します。
google.cloud.apigee.v1.InstanceService.UpdateInstanceAndAttachments
- 環境が接続されているインスタンスを削除します。
google.cloud.apigee.v1.InstanceService.DeleteInstance
- インスタンス アタッチメントを作成します。
google.cloud.apigee.v1.InstanceAttachmentService.CreateInstanceAttachment
- インスタンスのアタッチメントを削除します。
google.cloud.apigee.v1.InstanceAttachmentService.DeleteInstanceAttachment
- プロキシをデプロイします。
google.cloud.apigee.v1.DeploymentService.DeployApiProxy
- プロキシのデプロイを解除します。
google.cloud.apigee.v1.DeploymentService.UndeployApiProxy
- 共有フローをデプロイします。
google.cloud.apigee.v1.DeploymentService.DeploySharedFlow
- 共有フローのデプロイを解除します。
google.cloud.apigee.v1.DeploymentService.UndeploySharedFlow
- Apigee API Analytics または Advanced API Security アドオンを有効 / 無効にします。
google.cloud.apigee.v1.EnvironmentAddons.SetAddonEnablement
たとえば、次のサンプルクエリを入力します。
resource.type="audited_resource" resource.labels.method="google.cloud.apigee.v1.InstanceService.CreateInstanceAndAttachments" resource.labels.service="apigee.googleapis.com"
Cloud Audit Logging を使用して Apigee リソースをモニタリングする方法の詳細については、Apigee 監査ロギングの情報をご覧ください。
- 環境が接続されたインスタンス