このドキュメントでは、管理プロジェクトの指標スコープの構成方法について説明します。管理プロジェクトは、フォルダでアプリケーション モニタリングを有効にすると、 Google Cloud によって作成されます。管理プロジェクトには、Google Cloud Observability サービスに必要な構成情報が保存されます。このプロジェクトを使用して、アプリケーションのテレメトリーを表示します。
アプリ対応フォルダを使用していない場合、このドキュメントは適用されません。代わりに、指標スコープを構成するをご覧ください。
このページでは、指標スコープの割り当て使用量を表示する方法、割り当ての更新をリクエストする方法、管理プロジェクトの指標スコープを手動で更新する方法について説明します。
管理プロジェクトの指標スコープの管理方法
アプリ対応フォルダの場合、Google Cloud Observability は、アプリ対応フォルダ内のプロジェクトのリストを指標スコープ内のプロジェクトのリストと同期しようとします。たとえば、アプリ対応フォルダにプロジェクトを追加すると、そのプロジェクトを指標スコープに追加するコマンドが実行されます。
アプリ対応フォルダ内のプロジェクト数が指標スコープの割り当て（デフォルトは指標スコープあたり 375 個のプロジェクト）を超えない場合、Google Cloud Observability は指標スコープ内のプロジェクトのリストをアプリ対応フォルダ内のプロジェクトのリストと同期できます。たとえば、割り当てが指標スコープごとに 375 個のプロジェクトであるとします。アプリ対応フォルダに 100 個のプロジェクトが含まれている場合、指標スコープにはアプリ対応フォルダ内のすべてのプロジェクトが一覧表示されます。アプリ対応フォルダにプロジェクトを追加すると、それらのプロジェクトは指標スコープにも追加されます。
アプリ対応フォルダ内のプロジェクト数が指標スコープの割り当てを超えると、指標スコープ内のプロジェクトのリストに、アプリ対応フォルダ内のすべてのプロジェクトが含まれなくなります。たとえば、割り当てが指標スコープごとに 375 個のプロジェクトであり、アプリ対応フォルダに 380 個のプロジェクトがあるとします。375 個のプロジェクトが指標スコープに追加されると、割り当てが枯渇し、残り 5 個のプロジェクトの追加の試行は失敗します。そのため、一部のアプリケーション データは管理プロジェクトで使用できません。
指標スコープの割り当てが上限に達した場合は、次のいずれかを行うことができます。
指標スコープにリストされているプロジェクトを変更します。たとえば、他のプロジェクトを追加できるように、指標スコープから一部のプロジェクトを削除できます。
割り当ての増加をリクエストし、自動的に追加されなかったプロジェクトを手動で追加します。前の例では、指標スコープに追加できなかった 5 つのプロジェクトを手動で追加する必要があります。プロジェクトの最初の試行が失敗した場合、Google Cloud Observability はプロジェクトを指標スコープに追加する再試行を行いません。
どちらの場合も、指標スコープを手動で変更する必要があります。
始める前に
- 指標スコープについてよく知らない場合は、指標スコープの概要をご覧ください。
-
指標スコープの構成に必要な権限を取得するには、アプリ対応フォルダの管理プロジェクトと、指標スコープに追加または削除する各プロジェクトに対するモニタリング管理者 （
roles/monitoring.admin）IAM ロールを付与するよう管理者に依頼してください。ロールの付与については、プロジェクト、フォルダ、組織へのアクセス権の管理をご覧ください。
割り当て使用量を表示する
管理プロジェクトの指標スコープを手動で管理する必要がないように、アプリ管理用フォルダにプロジェクトを追加する前に、割り当てが利用可能であることを確認してください。このセクションでは、現在の割り当て使用量を確認する方法について説明します。
指標スコープの割り当て使用状況を表示する手順は次のとおりです。
-
Google Cloud コンソールで [settings 設定] ページに移動します。
検索バーを使用してこのページを検索する場合は、小見出しが [Monitoring] である結果を選択します。
- Google Cloud コンソールで、管理プロジェクトを選択します。
[指標スコープ] を選択します。
[指標スコープの割り当て] ペインには、割り当ての使用量と割り当てが表示されます。[指標スコープ] タブのアイコンの意味は次のとおりです。
エラーアイコン error は、割り当ての 90% 以上が使用されていることを示します。
警告アイコン warning は、割り当ての 70 ～ 90% が使用されていることを示します。
割り当ての増加をリクエストする
プロジェクトの指標スコープの割り当ての使用率が 70% を超えると、[指標スコープ] タブに警告アイコン warning またはエラーアイコン error が表示されます。デフォルトでは、指標スコープに 375 個のGoogle Cloud プロジェクトを含めることができます。割り当てを増やして、375 個を超える Google Cloud プロジェクトを指標スコープに追加すると、パフォーマンスの問題が発生する可能性があります。
割り当ての増加をリクエストするには:
-
Google Cloud コンソールで [settings 設定] ページに移動します。
検索バーを使用してこのページを検索する場合は、小見出しが [Monitoring] である結果を選択します。
- Google Cloud コンソールで、管理プロジェクトを選択します。
- [指標スコープ] を選択します。
[指標スコープの割り当て] ペインで、[割り当ての増加をリクエスト] を選択し、ダイアログを完了します。
「モニタリング対象プロジェクト / モニタリング指標スコープ」という名前の割り当ての増加をリクエストしてください。このタスクの詳細については、 Google Cloud コンソールを使用して割り当てを管理するをご覧ください。
割り当てが増加したら、プロジェクトを指標スコープに追加できます。
プロジェクトを指標スコープに追加する
プロジェクトを指標スコープに追加する手順は次のとおりです。
-
Google Cloud コンソールで [settings 設定] ページに移動します。
検索バーを使用してこのページを検索する場合は、小見出しが [Monitoring] である結果を選択します。
- Google Cloud コンソールで、管理プロジェクトを選択します。
[指標スコープ] を選択します。
[指標スコープ] タブには、現在のGoogle Cloud プロジェクトでモニタリングされているリソースが一覧表示されます。また、指標スコープに現在の Google Cloud プロジェクトが含まれる Google Cloud プロジェクトも一覧表示されます。
Google Cloud プロジェクトを指標スコープに追加するには:
- [Google Cloud プロジェクト] ペインで、[プロジェクトを追加] をクリックします。
[Google Cloud プロジェクトの追加] ダイアログで [プロジェクトを選択] をクリックして選択します。変更を保存するには、[プロジェクトを追加] をクリックします。
[設定] ページに戻ります。ページの表が更新されて、選択内容が表示されます。リストからGoogle Cloud プロジェクトを削除するには、[cancel プロジェクトを削除] をクリックします。
プロジェクトを指標スコープに追加した後、変更がすべての Monitoring システム全体に反映されるまで約 60 秒かかります。グラフやアラート ポリシーを作成する前に、60 秒以上待ちます。新しい指標を表示するには、 Google Cloud コンソール ページの更新が必要になる場合があります。
選択したプロジェクトの指標スコープが更新され、選択した Google Cloud プロジェクトが含まれるようになりました。
指標スコープからプロジェクトを削除する
パフォーマンスを向上させるため、または別のプロジェクトを追加できるように割り当てを解放するために、指標スコープからプロジェクトを削除する場合があります。たとえば、デフォルトでは、指標スコープに 375 個の Google Cloud プロジェクトを含めることができます。この割り当てを使い切った場合は、プロジェクトを 1 つ削除して、別のプロジェクトを追加できます。
プロジェクトを指標スコープから削除すると、そのプロジェクトに保存されている時系列データは、スコーピング プロジェクトを用いたグラフ化やモニタリングができなくなります。指標スコープからプロジェクトを削除しても、定義したグラフ、ダッシュボード、アラート ポリシー、稼働時間チェック、グループの構成は変更されません。ただし、グラフに表示される時系列とアラート ポリシーによってモニタリングされる時系列は変わる可能性があります。
現在の指標スコープからプロジェクトを削除するには、次のようにします。
-
Google Cloud コンソールで [settings 設定] ページに移動します。
検索バーを使用してこのページを検索する場合は、小見出しが [Monitoring] である結果を選択します。
- Google Cloud コンソールで、管理プロジェクトを選択します。
- [指標スコープ] を選択します。
- [Google Cloud プロジェクト] ペインで、削除するプロジェクトを選択し、[プロジェクトを削除] をクリックしてから、確認ダイアログを完了します。
指標スコープ内のプロジェクトを一覧表示する
指標スコープ内のリソースを一覧表示するには、次のようにします。
-
Google Cloud コンソールで [settings 設定] ページに移動します。
検索バーを使用してこのページを検索する場合は、小見出しが [Monitoring] である結果を選択します。
- Google Cloud コンソールで、管理プロジェクトを選択します。
[指標スコープ] を選択します。
[指標スコープ] タブには、現在のGoogle Cloud プロジェクトでモニタリングされているリソースが一覧表示されます。また、指標スコープに現在の Google Cloud プロジェクトが含まれる Google Cloud プロジェクトも一覧表示されます。