ログバケットを構成する

このドキュメントでは、 Google Cloud コンソール、Google Cloud CLI、Logging API を使用して Cloud Logging バケットを作成して管理する方法について説明します。また、Google Cloud プロジェクト レベルでログバケットを作成して管理する手順についても説明します。フォルダまたは組織のレベルではログバケットを作成できません。Cloud Logging は、フォルダと組織のレベルで _Default と _Required のバケットを自動的に作成します。

バケットのコンセプトの概要については、転送と保存の概要: ログバケットをご覧ください。

このドキュメントでは、顧客管理の暗号鍵（CMEK）を使用するログバケットの作成方法については説明しません。このトピックの詳細については、ログストレージに CMEK を構成するをご覧ください。

始める前に

ログバケットを使用する前に、次のことを行う必要があります。

• Google Cloud プロジェクトを構成します。

  1. Verify that billing is enabled for your Google Cloud project.

  2. ログバケットの作成、アップグレード、リンクに必要な権限を取得するには、プロジェクトに対するログ構成書き込み（roles/logging.configWriter）の IAM ロールを付与するように管理者へ依頼してください。ロールの付与については、プロジェクト、フォルダ、組織に対するアクセス権の管理をご覧ください。

     必要な権限は、カスタムロールや他の事前定義ロールから取得することもできます。

     権限とロールの完全なリストについては、IAM によるアクセス制御をご覧ください。

• ログの保存がサポートされているリージョンを確認します。

• Select the tab for how you plan to use the samples on this page:

  Console

  When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

  gcloud

  Google Cloud CLI をインストールし、フェデレーション ID を使用して gcloud CLI にログインします。 ログイン後、次のコマンドを実行して Google Cloud CLI を初期化します。

  gcloud init

  REST

  このページの REST API サンプルをローカル開発環境で使用するには、gcloud CLI に指定した認証情報を使用します。

  Google Cloud CLI をインストールし、フェデレーション ID を使用して gcloud CLI にログインします。 ログイン後、次のコマンドを実行して Google Cloud CLI を初期化します。

  gcloud init

  詳細については、 Google Cloud 認証ドキュメントの REST を使用して認証するをご覧ください。

  Google Cloud CLI または Cloud Logging API を使用してログバケットを作成または管理する場合は、LogBucket のフォーマット要件を確認してください。

バケットを作成する

Google Cloud プロジェクトあたり最大 100 個のバケットを作成できます。

Google Cloud プロジェクトにユーザー定義のログバケットを作成するには、次の操作を行います。

gcloud logging buckets create BUCKET_ID --location=LOCATION

gcloud logging buckets create my-bucket --location global --description "My first bucket"

バケットを作成したら、ログエントリをバケットに転送するシンクを作成し、ログビューを構成して、新しいバケットのログにアクセスできるユーザーとアクセス可能なログを制御します。バケットを更新して、カスタム保持と制限付きフィールドを構成することもできます。

バケットを管理する

このセクションでは、Google Cloud CLI または Google Cloud コンソールでログバケットを管理する方法について説明します。

バケットを更新する

gcloud logging buckets update BUCKET_ID --location=LOCATION UPDATED_ATTRIBUTES

gcloud logging buckets update my-bucket --location=global --description "Updated description"

バケットをロックする

更新されないようにバケットをロックすると、バケットの保持ポリシーもロックされます。保持ポリシーがロックされると、バケット内のすべてのログエントリがバケットの保持期間を満了するまでバケットを削除できません。ロックされたログバケットを含むプロジェクトが誤って削除されないようにするには、プロジェクトにリーエンを追加します。詳しくは、リーエンによるプロジェクトの保護をご覧ください。

他のユーザーがログバケットを更新または削除できないようにするには、バケットをロックします。バケットをロックする手順は次のとおりです。

gcloud logging buckets update BUCKET_ID --location=LOCATION --locked

gcloud logging buckets update my-bucket --location=global --locked

バケットを一覧表示する

Google Cloud プロジェクトに関連付けられたログバケットを一覧表示し、保持設定などの詳細を確認するには、次のようにします。

gcloud logging buckets list

gcloud logging buckets describe _Default --location=global

バケットの詳細を表示する

単一ログバケットの詳細を表示するには、次の操作を行います。

gcloud logging buckets describe _Default --location=global

バケットを削除する

次のいずれかの条件を満たすログバケットを削除できます。

• ログバケットがロック解除されている。
• ログバケットがロックされており、ログバケット内のすべてのログエントリがバケットの保持期間を満たしている。

更新されないようにロックされたログバケットに、バケットの保持期間を満たしていないログエントリが保存されている場合、そのログバケットを削除することはできません。

削除コマンドを実行すると、ログバケットは DELETE_REQUESTED 状態に移行し、7 日間その状態を維持します。この間、Logging は引き続きログをログバケットに転送します。ログエントリをバケットに転送するログシンクを削除または変更すると、ログバケットへのログの転送を停止できます。

DELETE_REQUESTED 状態のログバケットと同じ名前を使用して、新しいログバケットを作成することはできません。

ログバケットを削除するには、次の操作を行います。

gcloud logging buckets delete BUCKET_ID --location=LOCATION

削除したバケットを復元する

削除保留状態のバケットは、削除を取り消して復元できます。ログバケットの復元方法は次のとおりです。

gcloud logging buckets undelete BUCKET_ID --location=LOCATION

バケットに書き込む

ログバケットに直接ログを書き込むことはありません。代わりに、ログをGoogle Cloud リソース（ Google Cloud プロジェクト、フォルダ、または組織）に書き込みます。親リソースのシンクは、ログバケットを含む宛先にログを転送します。ログがシンクのフィルタと一致し、シンクにログをログバケットに転送する権限がある場合、シンクはログをログバケットの宛先に転送します。

バケットから読み取る

各ログバケットには、一連のログビューがあります。ログバケットからログを読み取るには、ログバケットのログビューへのアクセス権が必要です。ログビューを使用すると、ログバケットに保存されているログのサブセットに対してのみユーザーにアクセス権を付与できます。ログビューの構成方法と、特定のログビューへのアクセス権を付与する方法については、ログバケットのログビューを構成するをご覧ください。

ログバケットからログを読み取るには、次の操作を行います。

gcloud logging read LOG_FILTER --bucket=BUCKET_ID --location=LOCATION --view=LOG_VIEW_ID

フィルタリング構文の詳細については、Logging のクエリ言語をご覧ください。

カスタム保持を構成する

ログバケットを作成するときに、Cloud Logging でバケットのログが保存される期間をカスタマイズできます。保持期間は、ユーザー定義のログバケットと _Default ログバケットのそれぞれで構成できます。_Required ログバケットの保持期間は変更できません。

バケットの保持期間を短くすると、7 日間の猶予期間が設定されます。この間、期限切れのログは削除されません。期限切れのログに対してクエリの実行や表示はできませんが、この 7 日間にバケットの保持期間を延長することで、完全アクセス権を復元できます。猶予期間中に保存されたログは、保持費用に計上されます。

カスタム ログバケットまたは _Default ログバケットの保持期間を更新するには、次の操作を行います。

gcloud logging buckets update BUCKET_ID  --location=LOCATION --retention-days=RETENTION_DAYS

gcloud logging buckets update _Default --location=global --retention-days=365

バケットの保持期間を延長した場合、保持ルールはその保持期間の終了後に適用されます。過去に遡って適用はされることはありません。所定の保持期間が終了すると、ログの復元はできなくなります。

一般的な問題のトラブルシューティング

ログバケットの使用中に問題が発生した場合は、次のトラブルシューティング手順と一般的な質問に対する回答をご覧ください。

このバケットを削除できません。なぜですか？

バケットを削除するには、次の操作を行います。

• バケットを削除するための適切な権限があることを確認します。必要な権限のリストについては、IAM によるアクセス制御をご覧ください。

• バケットの属性を一覧表示して、バケットがロックされているかどうかを確認します。バケットがロックされている場合は、バケットの保持期間を確認します。ロックされたバケットを削除するには、そのバケット内のすべてのログがバケットの保持期間を満たしている必要があります。

どのサービス アカウントがバケットにログを転送するのですか？

ログをバケットに転送する IAM 権限がサービス アカウントにあるかどうかを確認するには、次の操作を行います。

1. Google Cloud コンソールで [IAM] ページに移動します。

   [IAM] に移動

   このページを検索バーで検索する場合は、小見出しが「IAM と管理」の結果を選択します。

2. [権限] タブで、ロール別に表示します。Google Cloud プロジェクトに関連付けられたすべての IAM ロールとプリンシパルを含む表が表示されます。

3. 表の [フィルタ] テキスト ボックス filter_list に「ログバケット書き込み」と入力します。

   ログバケット書き込みのロールを持つプリンシパルが表示されます。プリンシパルがサービス アカウントの場合、その ID には文字列 が含まれます。

4. 省略可: Google Cloud プロジェクトにログを転送できないようにサービス アカウントを削除する場合は、サービス アカウントのチェックボックス check_box_outline_blank をオンにして、[削除] をクリックします。

ログが _Default シンクから除外されていても Google Cloud プロジェクトのログが表示されるのはなぜですか？

組織全体のログを集約する一元化された Google Cloud プロジェクトのログバケットでログを表示している可能性があります。

ログ エクスプローラを使用してこれらのログにアクセスしていて、_Default シンクから除外したログが表示される場合は、ビューがGoogle Cloud プロジェクト レベルに設定されている可能性があります。

この問題を解決するには、[範囲を絞り込む] メニューで [ログビュー] を選択し、Google Cloud プロジェクトの _Default バケットに関連付けられているログビューを選択します。これで、除外されたログが表示されなくなります。

次のステップ

Logs Bucket API メソッドの詳細については、LogBucket リファレンス ドキュメントをご覧ください。

組織またはフォルダを管理している場合は、子リソースの _Default ログバケットと _Required ログバケットのロケーションを指定できます。ログバケットで CMEK を使用するかどうかと、_Default ログシンクの動作を構成することもできます。詳しくは、組織とフォルダのデフォルト設定を構成するをご覧ください。

ログバケットを使用して一般的なユースケースに対応する方法については、次のトピックをご覧ください。

• 組織のログを集約して保存する

• ログをリージョン化する