このページでは、Cloud Logging を取得して使用し、Memorystore for Memcached インスタンスのメンテナンス ログをクエリして表示する方法について説明します。
定期メンテナンスのログを表示する
Google Cloud コンソールを使用して、定期メンテナンスのログをクエリして表示できます。
コンソール
Google Cloud コンソールで、[ログ エクスプローラ] ページに移動します。
ページ上部で Google Cloud プロジェクトを選択します。
期間メニューから、メンテナンス ログのクエリを実行する範囲を選択します。たとえば、過去 30 日間に Memorystore for Memcached がキャプチャしたログをクエリできます。
クエリビルダーに次のコード行を追加します。
logName="projects/PROJECT_NAME/logs/maintenance.googleapis.com%2Factivity_log" labels.activity_type_name="CloudMemcacheRolloutAdvanced"
PROJECT_NAME は、実際のGoogle Cloud プロジェクト名で置き換えます。
[クエリを実行] をクリックします。定期メンテナンスのログが表示されます。
進行中のメンテナンスのログを表示する
Google Cloud コンソールを使用して、進行中のメンテナンスのログをクエリして表示できます。
コンソール
Google Cloud コンソールで、[ログ エクスプローラ] ページに移動します。
ページ上部で Google Cloud プロジェクトを選択します。
期間メニューから、メンテナンス ログのクエリを実行する範囲を選択します。たとえば、過去 30 日間に Memorystore for Memcached がキャプチャしたログをクエリできます。
クエリビルダーに次のコード行を追加します。
logName="projects/PROJECT_NAME/logs/maintenance.googleapis.com%2Factivity_log" labels.activity_type_name="CloudMemcacheRolloutInProgress" labels.is_completed="false"
PROJECT_NAME は、実際のGoogle Cloud プロジェクト名で置き換えます。
[クエリを実行] をクリックします。進行中のメンテナンスのログが表示されます。
完了したメンテナンスのログを表示する
Google Cloud コンソールを使用して、完了したメンテナンスのログをクエリして表示できます。
コンソール
Google Cloud コンソールで、[ログ エクスプローラ] ページに移動します。
ページ上部で Google Cloud プロジェクトを選択します。
期間メニューから、メンテナンス ログのクエリを実行する範囲を選択します。たとえば、過去 30 日間に Memorystore for Memcached がキャプチャしたログをクエリできます。
クエリビルダーに次のコード行を追加します。
logName="projects/PROJECT_NAME/logs/maintenance.googleapis.com%2Factivity_log" labels.activity_type_name="CloudMemcacheRolloutInProgress" labels.is_completed="true"
PROJECT_NAME は、実際のGoogle Cloud プロジェクト名で置き換えます。
[クエリを実行] をクリックします。完了したメンテナンスのログが表示されます。
キャンセルされたメンテナンスのログを表示する
Google Cloud コンソールを使用して、キャンセルされたメンテナンスのログをクエリして表示できます。
コンソール
Google Cloud コンソールで、[ログ エクスプローラ] ページに移動します。
ページ上部で Google Cloud プロジェクトを選択します。
期間メニューから、メンテナンス ログのクエリを実行する範囲を選択します。たとえば、過去 30 日間に Memorystore for Memcached がキャプチャしたログをクエリできます。
クエリビルダーに次のコード行を追加します。
logName="projects/PROJECT_NAME/logs/maintenance.googleapis.com%2Factivity_log" labels.activity_type_name="CloudMemcacheRolloutCanceled"
PROJECT_NAME は、実際のGoogle Cloud プロジェクト名で置き換えます。
[クエリを実行] をクリックします。キャンセルされたメンテナンスのログが表示されます。
トラブルシューティング
このセクションでは、メンテナンス ログを表示しようとしたときに発生する可能性のある問題と、それらの問題を解決するためのガイダンスを示します。
Cloud Logging で _Default シンクを無効にする
Logging では、すべてのプロジェクト、フォルダ、組織に次のシンクがあります。
_Required: 監査ログをキャプチャして、_Requiredバケットに保存します。このシンクを無効にしたり削除したりすることはできません。また、バケット内のログのデフォルトの保持期間は 400 日です。
_Default:_Requiredシンクでキャプチャされないメンテナンス ログを含む、Memorystore for Memcached ログを転送します。_Defaultシンクは、これらのログを_Defaultバケットに保存します。_Defaultシンクは削除できませんが、無効にして_Defaultバケットへのログの転送を停止できます。また、バケット内のログのデフォルトの保持期間は 30 日間です。
_Default シンクを無効にすると、Logging はシンク内のすべてのログ（maintenance.googleapis.com/activity_log を含む）を削除します。maintenance.googleapis.com/activity_log は、Logging のすべてのメンテナンス アクティビティに関連付けられています。その結果、Logging はシンクにログを保存できなくなります。
_Default シンクを無効にしたかどうかを確認する手順は次のとおりです。
gcloud logging sinks describeコマンドを使用します。gcloud logging sinks describe _Default --project=PROJECT_ID
PROJECT_ID は、シンクを含む Google Cloud プロジェクトの ID またはプロジェクト番号に置き換えます。
出力で、
disabledパラメータの値を確認します。値がtrueの場合は、シンクが無効になっているため、再度有効にする必要があります。
シンクを再度有効にするには、次の操作を行います。
gcloud logging sinks updateコマンドを使用します。gcloud logging sinks update _Default --no-disabled --project=PROJECT_ID
シンクが有効になっていることを確認するには、
gcloud logging sinks describeコマンドを使用します。gcloud logging sinks describe _Default --project=PROJECT_ID
出力で、
disabledパラメータの値がfalseであることを確認します。シンクを再度有効にしました。
シンク フィルタが正しく構成されていない
Logging では、シンクをカスタマイズして、 Google Cloud プロジェクトに保存するログを制御できます。これを行うには、シンクに含めるログのタイプを指定するフィルタを作成します。
少なくとも 1 つのシンクで、ログ ID が maintenance.googleapis.com/activity_log のログを含めるフィルタを構成しない場合、Logging はこれらのログをドロップします。これらのログは Logging のすべてのメンテナンス アクティビティに関連付けられているため、メンテナンス ログを表示することはできません。
シンクフィルタが正しく構成されているかどうかを確認するには、次の操作を行います。
gcloud logging sinks listコマンドを使用します。gcloud logging sinks list --project=PROJECT_ID
PROJECT_ID は、シンクを含むGoogle Cloud プロジェクトの ID またはプロジェクト番号に置き換えます。
FILTER列を調べて、LOG_ID("maintenance.googleapis.com/activity_log")フィルタが含まれているかどうかを確認します。このフィルタが表示されない場合や、このログを除外するより広範なフィルタ（(NOT LOG_ID("cloudaudit.googleapis.com/activity_log)")など）がある場合は、すべてのシンクをカスタマイズして、ログ ID がmaintenance.googleapis.com/activity_logのログを削除しています。この問題を解決するには、メンテナンス ログを含めるようにシンクを作成または更新する必要があります。
--log-filterパラメータには、フィルタとしてLOG_ID("maintenance.googleapis.com/activity_log")を指定します。