ログバケットを構成する

Google Cloud コンソール

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

1. Google Cloud コンソールで、[ログストレージ] ページに移動します。

   [ログストレージ] に移動

   検索バーを使用してこのページを検索する場合は、小見出しが [Logging] である結果を選択します。

2. [ログバケットの作成] をクリックします。

3. バケットの [名前] と [説明] を入力します。

4. 省略可: バケットをアップグレードすると、Log Analytics を使用できます。

   1. [アップグレードして Log Analytics を使用する] を選択します。

      Log Analytics を使用するようにバケットをアップグレードすると、SQL クエリを使用して [Log Analytics] ページでログをクエリできます。ログ エクスプローラを使用してログを引き続き表示することもできます。

   2. 省略可: BigQuery でログを表示するには、[このバケットにリンクする新しい BigQuery データセットを作成する] を選択して、一意のデータセット名を入力します。

      このオプションを選択すると、BigQuery はログバケットに保存されているデータを読み取ることができます。BigQuery インターフェースでクエリして、ログデータを結合したり、Looker Studio や Looker などの他のツールからデータにアクセスしたりできるようになりました。

5. 省略可: ログのストレージ リージョンを選択するには、[ログのバケット リージョンを選択] メニューをクリックしてリージョンを選択します。リージョンを選択しない場合は、global リージョンが使用されます。つまり、ログはサポートされている任意のリージョンに物理的に配置できます。

6. 省略可: バケット内のログにカスタム保持期間を設定するには、[次] をクリックします。

   [保持期間] フィールドに、Cloud Logging でログを保持する日数を入力します（1～3,650 日）。保持期間をカスタマイズしない場合、デフォルトの 30 days になります。

   バケットを作成した後にバケットを更新して、カスタム保持を適用するともできます。

7. [バケットを作成] をクリックします。

   これらのオプションが選択されている場合は、ログバケットの作成後に、Logging によってバケットがアップグレードされ、データセット リンクが作成されます。

   これらの手順が完了するまでしばらく時間がかかることがあります。

gcloud

ログバケットのみを作成するには、gcloud logging buckets create コマンドを実行します。ログ分析を使用するようにログバケットをアップグレードする場合は、--enable-analytics フラグと --async フラグを指定し、変数 LOCATION が サポートされているリージョンに設定されていることを確認します。

gcloud logging buckets create BUCKET_ID --location=LOCATION --enable-analytics --async OPTIONAL_FLAGS

--async フラグを使用して、コマンドを非同期にします。非同期メソッドの出力は Operation オブジェクトで、メソッドの進行状況に関する情報が格納されています。メソッドが完了すると、Operation オブジェクトにステータスが含まれます。詳細については、非同期 API メソッドをご覧ください。

ログ分析を使用するようにログバケットをアップグレードしない場合は、--enable-analytics フラグと --async フラグを省略します。

たとえば、global リージョンで BUCKET_ID my-bucket のバケットを作成する場合、コマンドは次のようになります。

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

たとえば、global のロケーションに BUCKET_ID my-upgraded-bucket のバケットを作成し、Log Analytics を使用するようにログバケットをアップグレードする場合、コマンドは次のようになります。

gcloud logging buckets create my-upgraded-bucket --location global \
      --description "My first upgraded bucket" \
      --enable-analytics --retention-days=45

REST

バケットを作成するには、projects.locations.buckets.create メソッドまたは projects.locations.buckets.createAsync メソッドを使用します。次のように、メソッドの引数を準備します。

1. parent パラメータを、バケットを作成するリソース（projects/PROJECT_ID/locations/LOCATION）に設定します。

   変数 LOCATION は、ログを保存するリージョンを指します。

   たとえば、リージョン global にプロジェクト my-project 用のバケットを作成する場合、parent パラメータは次のようになります: projects/my-project/locations/global

2. bucketId パラメータを設定します（例: my-bucket）。

3. 次のいずれかを行います。

   • ログバケットを作成して、ログ分析を使用するようにログバケットをアップグレードするには:

     1. LogBucket.analyticsEnabled ブール値を true に設定します。

     2. 非同期メソッド projects.locations.buckets.createAsync を呼び出してバケットを作成します。

        非同期メソッドに対するレスポンスは、Operation オブジェクトです。このオブジェクトには、メソッドの進行状況に関する情報が格納されています。メソッドが完了すると、Operation オブジェクトにステータスが含まれます。詳細については、非同期 API メソッドをご覧ください。

        createAsync メソッドが完了するまでに数分かかります。このメソッドでは、analyticsEnabled ブール値が true に設定されていても、エラー メッセージが生成されず、エラーも発生しません。

   • それ以外の場合は、同期メソッド projects.locations.buckets.create を呼び出してバケットを作成します。

Google Cloud コンソール

バケットのプロパティを更新する手順は次のとおりです。

1. Google Cloud コンソールで、[ログストレージ] ページに移動します。

   [ログストレージ] に移動

   検索バーを使用してこのページを検索する場合は、小見出しが [Logging] である結果を選択します。

2. 更新するバケットで、more_vert [その他] をクリックします。

3. [バケットの編集] を選択します。

4. 必要に応じてバケットを編集します。

5. [バケットの更新] をクリックします。

gcloud

バケットのプロパティを更新するには、gcloud logging buckets update コマンドを実行します。

gcloud logging buckets update BUCKET_ID --location=LOCATION UPDATED_ATTRIBUTES

次に例を示します。

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

REST

バケットのプロパティを更新するには、Logging API で projects.locations.buckets.patch を使用します。

Google Cloud コンソール

Log Analytics を使用するように既存のバケットをアップグレードするには、次の操作を行います。

1. Google Cloud コンソールで、[ログストレージ] ページに移動します。

   [ログストレージ] に移動

   検索バーを使用してこのページを検索する場合は、小見出しが [Logging] である結果を選択します。

2. アップグレードするバケットを見つけます。

3. [Log Analytics を使用可能] 列に [アップグレード] と表示されたら、ログバケットをアップグレードして Log Analytics を使用できます。[アップグレード] をクリックします。

   ダイアログが開きます。[確認] をクリックします。

gcloud

Log Analytics を使用するようにログバケットをアップグレードするには、gcloud logging buckets update コマンドを実行します。--enable-analytics フラグを設定する必要があります。そして、--async フラグを含めることもおすすめします。

gcloud logging buckets update BUCKET_ID --location=LOCATION --enable-analytics --async

--async フラグを使用して、コマンドを非同期にします。非同期メソッドの出力は Operation オブジェクトで、メソッドの進行状況に関する情報が格納されています。メソッドが完了すると、Operation オブジェクトにステータスが含まれます。詳細については、非同期 API メソッドをご覧ください。

REST

ログ分析を使用するようにログバケットをアップグレードするには、Cloud Logging API の projects.locations.buckets.updateAsync メソッドを使用します。

次のように、メソッドの引数を準備します。

1. LogBucket.analyticsEnabled ブール値を true に設定します。
2. コマンドのクエリ パラメータには updateMask=analyticsEnabled を使用します。

非同期メソッドに対するレスポンスは、Operation オブジェクトです。このオブジェクトには、メソッドの進行状況に関する情報が格納されています。メソッドが完了すると、Operation オブジェクトにステータスが含まれます。詳細については、非同期 API メソッドをご覧ください。

updateAsync の完了には数分かかることがあります。

Google Cloud コンソール

既存のログバケットの BigQuery データセットへのリンクを作成するには、次の操作を行います。

1. Google Cloud コンソールで、[ログストレージ] ページに移動します。

   [ログストレージ] に移動

   検索バーを使用してこのページを検索する場合は、小見出しが [Logging] である結果を選択します。

2. ログバケットを見つけ、[Log Analytics を使用可能] 列に [開く] が表示されていることを確認します。

   この列に[アップグレード] と表示される場合、ログバケットは Log Analytics を使用するようにアップグレードされていません。Log Analytics を構成します。

   1. [アップグレード] をクリックします。
   2. ダイアログで [確認] をクリックします。

   アップグレードが完了したら、次のステップに進みます。

3. ログバケットで、[展開]more_vert　をクリックし、[バケットを編集] をクリックします。

   [ログバケットを編集] ダイアログが開きます。

4. [このバケットにリンクする新しい BigQuery データセットを作成する] を選択し、新しいデータセットの名前を入力します。

   データセット名は、Google Cloud プロジェクトごとに一意である必要があります。既存のデータセットの名前を入力すると、次のエラーを受信します。Dataset name must be unique in the selected region.

5. [完了]、[バケットを更新] の順にクリックします。

   Logging の [ログストレージ] ページにリンクされたデータセット名が表示されてから BigQuery がデータセットを認識するまでに数分かかることがあります。

gcloud

ログ分析を使用するようにアップグレードされたログバケットのリンクされたデータセットを作成するには、gcloud logging links create コマンドを実行します。

gcloud logging links create LINK_ID --bucket=BUCKET_ID --location=LOCATION

指定した LINK_ID は BigQuery データセットの名前として使用されます。このフィールドの値は、Google Cloud プロジェクトで一意である必要があります。

links create コマンドは非同期です。非同期メソッドの出力は Operation オブジェクトで、メソッドの進行状況に関する情報が格納されています。メソッドが完了すると、Operation オブジェクトにステータスが含まれます。詳細については、非同期 API メソッドをご覧ください。

links create コマンドが完了するまでに数分かかります。

たとえば、次のコマンドは、my-bucket という名前のログバケットに mylink という名前のリンク済みデータセットを作成します。

gcloud logging links create mylink --bucket=my-bucket --location=global

データセット名は、Google Cloud プロジェクトごとに一意である必要があります。既存のデータセットと同じ名前のデータセットを作成しようとすると、次のエラーを受信します。

BigQuery dataset with name "LINK_ID" already exists.

Log Analytics を使用するようにアップグレードされていないログバケットに対して、リンクされたデータセットを作成しようとすると、次のエラーが報告されます。

A link can only be created for an analytics-enabled bucket.

REST

アップグレードされた既存のログバケットに対してリンクされた BigQuery データセットを作成するには、Log Analytics を使用します。Cloud Logging API の非同期 projects.locations.buckets.links.create メソッドを呼び出します。

次のように、メソッドの引数を準備します。

1. create コマンドのリクエスト本文を作成します。リクエスト本文は Link オブジェクトの形式です。
2. コマンドのクエリ パラメータには linkId=LINK_ID を使用します。指定した LINK_ID は BigQuery データセットの名前として使用されます。このフィールドの値は、Google Cloud プロジェクトで一意である必要があります。

非同期メソッドに対するレスポンスは、Operation オブジェクトです。このオブジェクトには、メソッドの進行状況に関する情報が格納されています。メソッドが完了すると、Operation オブジェクトにステータスが含まれます。詳細については、非同期 API メソッドをご覧ください。

links.create メソッドが完了するまでに数分かかります。

データセット名は、Google Cloud プロジェクトごとに一意である必要があります。既存のデータセットと同じ名前のデータセットを作成しようとすると、次のエラーを受信します。

BigQuery dataset with name "LINK_ID" already exists.

Log Analytics を使用するようにアップグレードされていないログバケットに対して、リンクされたデータセットを作成しようとすると、次のエラーが報告されます。

A link can only be created for an analytics-enabled bucket.

Google Cloud コンソール

Google Cloud コンソールでは、ログバケットのロックはサポートされていません。

gcloud

バケットをロックするには、--locked フラグを指定して gcloud logging buckets update コマンドを実行します。

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

次に例を示します。

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

REST

バケットの属性をロックするには、Logging API で projects.locations.buckets.patch を使用します。locked パラメータを true に設定します。

Google Cloud コンソール

Google Cloud コンソールで、[ログストレージ] ページに移動します。

[ログストレージ] に移動

検索バーを使用してこのページを検索する場合は、小見出しが [Logging] である結果を選択します。

[ログバケット] という名前のテーブルに、現在の Google Cloud プロジェクトに関連付けられているバケットが一覧表示されます。

この表には、各ログバケットの次の属性が一覧表示されます。

• 名前: ログバケットの名前。
• 説明: バケットの説明。
• 保持期間: Cloud Logging がバケットのデータを保存する日数。
• リージョン: バケットのデータが保存される地理的なロケーション。
• ステータス: バケットがロックされているか、ロック解除されているか。

Cloud Logging がバケットを削除保留にしている場合、テーブル エントリにwarning警告記号の注記が付けられます。

gcloud

gcloud logging buckets list コマンドを実行します。

gcloud logging buckets list

ログバケットの次の属性が表示されます。

• LOCATION: バケットのデータが保存されるリージョン。
• BUCKET_ID: ログバケットの名前。
• RETENTION_DAYS: Cloud Logging がバケットのデータを保存する日数。
• LIFECYCLE_STATE: Cloud Logging がバケットを削除保留中としているかどうかを示します。
• LOCKED: バケットがロックされているか、ロック解除されているか。
• CREATE_TIME: バケットが作成された日時を示すタイムスタンプ。
• UPDATE_TIME: バケットが最後に変更された日時を示すタイムスタンプ。

1 つのバケットの属性を表示することもできます。たとえば、global リージョンの _Default ログバケットの詳細を表示するには、gcloud logging buckets describe コマンドを実行します。

gcloud logging buckets describe _Default --location=global

REST

Google Cloud プロジェクトに関連付けられたログバケットを一覧表示するには、Logging API で projects.locations.buckets.list を使用します。

Google Cloud コンソール

Google Cloud コンソールで、[ログストレージ] ページに移動します。

[ログストレージ] に移動

検索バーを使用してこのページを検索する場合は、小見出しが [Logging] である結果を選択します。

ログバケットで [more_vertその他] をクリックし、次に [バケットの詳細を表示する] を選択します。

このダイアログには、ログバケットの次の属性が表示されます。

• 名前: ログバケットの名前。
• 説明: ログバケットの説明。
• 保持期間: Cloud Logging がバケットのデータを保存する日数。
• リージョン: バケットのデータが保存される地理的なロケーション。

• Log Analytics: Log Analytics を使用するようにバケットがアップグレードされているかどうかを示します。
• BigQuery 分析: BigQuery データセットがバケットにリンクされているかどうかを示します。
• BigQuery データセット: BigQuery データセットへのリンクを表示します。この BigQuery データセットが [BigQuery Studio] ページで開きます。BigQuery のリンクが有効になった日付も表示されます。

gcloud

gcloud logging buckets describe コマンドを実行します。

たとえば、次のコマンドは _Default バケットの詳細を報告します。

gcloud logging buckets describe _Default --location=global

ログバケットの次の属性が表示されます。

• createTime: バケットが作成された日時を示すタイムスタンプ。
• description: ログバケットの説明。
• lifecycleState: Cloud Logging がバケットを削除保留中としているかどうかを示します。
• name: ログバケットの名前。
• retentionDays: Cloud Logging がバケットのデータを保存する日数。
• updateTime: バケットが最後に変更された日時を示すタイムスタンプ。

REST

単一のログバケットの詳細を表示するには、Logging API で projects.locations.buckets.get を使用します。

Google Cloud コンソール

ログバケットを削除する方法は次のとおりです。

1. Google Cloud コンソールで、[ログストレージ] ページに移動します。

   [ログストレージ] に移動

   検索バーを使用してこのページを検索する場合は、小見出しが [Logging] である結果を選択します。

2. 削除するバケットを見つけて、more_vertその他アイコンをクリックします。

3. [BigQuery のリンクされたデータセット] 列にリンクが表示されている場合は、リンクされた BigQuery データセットを削除します。

   1. [バケットを編集] をクリックします。

   2. [このバケットにリンクする新しい BigQuery データセットを作成する] チェックボックスをオフにして、[完了] をクリックし、[バケットを更新] をクリックします。

      [ログストレージ] ページに戻り、削除するバケットの more_vert [その他] をクリックし、次の手順に進みます。

4. [バケットの削除] を選択します。

5. 確認パネルで [削除] をクリックします。

6. [ログストレージ] ページに、バケットが削除保留中であることを示すインジケータが表示されます。すべてのログを含むバケットは 7 日後に削除されます。

gcloud

ログバケットを削除するには、gcloud logging buckets delete コマンドを実行します。

gcloud logging buckets delete BUCKET_ID --location=LOCATION

ログバケットにリンクされた BigQuery データセットがある場合は、そのバケットを削除できません。

• ログバケットに関連付けられたリンクを一覧表示するには、gcloud logging links list コマンドを実行します。
• データセットを削除するには、gcloud logging links delete コマンドを実行します。

REST

バケットを削除するには、Logging API で projects.locations.buckets.delete を使用します。

ログバケットにリンクされた BigQuery データセットがある場合、そのバケットを削除するとエラーになります。ログバケットを削除する前に、リンクされたデータセットを削除する必要があります。

• ログバケットに関連付けられたリンクを一覧表示するには、projects.locations.buckets.links.list メソッドを実行します。
• リンクされたデータセットを削除するには、projects.locations.buckets.links.delete メソッドを実行します。

Google Cloud コンソール

削除保留中のログバケットを復元する手順は次のとおりです。

1. Google Cloud コンソールで、[ログストレージ] ページに移動します。

   [ログストレージ] に移動

   検索バーを使用してこのページを検索する場合は、小見出しが [Logging] である結果を選択します。

2. 復元するバケットで、[more_vertその他] をクリックし、[削除したバケットを復元する] を選択します。

3. 確認パネルで [復元] をクリックします。

4. ログストレージ ページで、削除が保留中であることを示すインジケータがログバケットから削除されます。

gcloud

削除保留中のログバケットを復元するには、gcloud logging buckets undelete コマンドを実行します。

gcloud logging buckets undelete BUCKET_ID --location=LOCATION

REST

削除保留中のバケットを復元するには、Logging API で projects.locations.buckets.undelete を使用します。

Google Cloud コンソール

1. Google Cloud コンソールで、[ログ エクスプローラ] ページに移動します。

   [ログ エクスプローラ] に移動

   検索バーを使用してこのページを検索する場合は、小見出しが [Logging] の結果を選択します。

2. ログ エクスプローラに表示されるログをカスタマイズするには、[範囲を絞り込む] をクリックしてオプションを選択します。たとえば、プロジェクトに保存されているログやログビューでログを表示できます。

3. [適用] をクリックします。[クエリ結果] ペインが選択したオプションに一致するログに再読み込みされます。

詳細については、ログ エクスプローラの概要: 範囲を絞り込むをご覧ください。

gcloud

ログバケットからログを読み取るには、gcloud logging read コマンドを使用し LOG_FILTER を追加してデータを選択します。

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

REST

ログバケットからログを読み取るには、entries.list メソッドを使用します。resourceNames を設定して適切なバケットとログビューを指定し、filter を設定してデータを選択します。

Google Cloud コンソール

ログバケットの保持期間を更新する手順は次のとおりです。

1. Google Cloud コンソールで、[ログストレージ] ページに移動します。

   [ログストレージ] に移動

   検索バーを使用してこのページを検索する場合は、小見出しが [Logging] である結果を選択します。

2. 更新するバケットで [more_vertその他] をクリックし、[バケットを編集する] を選択します。 。

3. [保持] フィールドに、Cloud Logging でログを保持する日数を入力します（1～3,650 日）。

4. [バケットの更新] をクリックします。新しい保持期間が [ログバケット] のリストに表示されます。

gcloud

ログバケットの保持期間を更新するには、RETENTION_DAYS の値を設定した後で、gcloud logging buckets update コマンドを実行します。

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

たとえば、global ロケーションの _Default バケットのログを 1 年間保持する場合、コマンドは次のようになります。

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