割り当てと上限

このページでは、Cloud Logging の使用量上限について詳しく説明します。

Logging の使用量上限

Cloud Logging の使用量には次の上限が適用されます。ログバケットとシンクの数の上限を除き、これらの上限は固定されていて、増減できません。

カテゴリ 最大値
LogEntry のサイズ 256 KB1
監査ログエントリのサイズ 512 KiB
ラベル数 LogEntry あたり 64 個
LogEntry ラベルキーの長さ 512 B2
LogEntry ラベル値の長さ 64 KB2
Logging クエリ言語クエリの長さ 20,000 文字
クエリのファンアウト4 200 個のバケット
シンクの数 Google Cloud プロジェクトごとに 200 個3
シンク包含フィルタの長さ 20,000 文字
シンク除外フィルタの長さ 20,000 文字
除外フィルタの数 1 シンクあたり 50 件
ログバケットの数 Google Cloud プロジェクトごとに 100 個3, 4, 5
カスタム インデックス フィールドの数 1 ログバケットあたり 20
ログビューの数 1 ログバケットあたり 30
ログバケットに保存できる最も古いタイムスタンプ 6 30 日前
ログバケットに保存できる将来のタイムスタンプ 6 今後の最大 1 日
リソースあたりのログスコープの数7 100
ログスコープに含まれるログビューとプロジェクトの数7 100
ログスコープに含まれるプロジェクト数7 5

1 このおおよその上限値は、実際の REST API リクエスト サイズではなく内部データサイズに基づいています。

2 Cloud Logging は、関連するログエントリが書き込まれる際に、サイズ超過のラベルキーと値を切り捨てます。

3 この上限は、請求先アカウント、フォルダ、組織にも適用され、階層型ではありません。たとえば、1 つの組織に複数の Google Cloud プロジェクトがある場合、Google Cloud プロジェクトごとに最大 200 個のシンクを構成できます。同じ組織で、組織レベルで最大 200 個のシンクを構成することもできます。

4 この上限は、リソースのログエントリを含めることができるバケットの最大数です。詳細については、クエリがエラーを返すをご覧ください。

5 この上限には削除保留中のバケットが含まれます。

6 これらの境界外のタイムスタンプを持つログエントリは、ログバケットから拒否されます。Logging API は、タイムスタンプが古いエントリを受け入れます。これらのエントリはシンクのエクスポート先に転送できますが、ログストレージには保存できません。Logging API は、タイムスタンプが今後 1 日を超えるエントリを拒否し、INVALID_ARGUMENT エラーを返します。

7 ログスコープは公開プレビュー版です。

Logging API の割り当てと上限

Logging API の使用には、次の上限が適用されます。Logging API の割り当てと上限の変更をリクエストできます。手順については、このページの Cloud Logging API の割り当て変更のリクエストをご覧ください。

カテゴリ 最大値
API の使用 割り当てを表示するには、API ダッシュボードに移動し、API を選択して [割り当て] を選択します。
API ページトークンの存続時間 24 時間
ライブテーリング セッション数 Google Cloud プロジェクトごとに 10 回3
返されるライブテーリング エントリ数 60,000/分
制限付きフィールドの数 1 バケットあたり 20 件
制限付きフィールドのサイズ 800 B
entries.write リクエストのサイズ 10 MB
entries.write リクエスト数 Google Cloud プロジェクトあたり毎分 120,000 回1, 3
entries.list リクエスト数 Google Cloud プロジェクトあたり毎分 60 回2, 3
1 つの
entries.write コマンドに含まれる異なるリソース名の数4		 1000
1 分あたりの制御リクエストの数5 600
1 日あたりの制御リクエスト数5 Google Cloud プロジェクトあたり 1,000 個
1 つの
entries.list リクエスト内の Google Cloud プロジェクトや他のリソース名の数		 100
同時コピー操作の数 Google Cloud プロジェクトごとに 1 回3
Pub/Sub トピックへのエクスポートの速度6 Google Cloud プロジェクト 1 件あたり毎分 60 GB

1 除外フィルタを使用しても、この数は減少しません。ログは entries.write リクエストの実行後に除外されるためです。

2 この値はデフォルト設定です。

3 この上限は、請求先アカウント、フォルダ、組織にも適用され、階層型ではありません。

4 ログエントリの logName フィールドは、ログエントリのリソース名を指定します。

5 毎日の制御リクエストの割り当ては、除外とシンクの作成および更新のための API リクエストに適用されます。1 分あたりの制御リクエストの割り当ては、毎日の制御リクエストの割り当てに含まれるすべてのリクエストに加えて、ログの削除とログベース指標の管理のための API リクエストにも適用されます。

6 エクスポートのレートが割り当てを超えると、エラーがログエントリに記録されます。summary フィールドはシンク構成エラーを示し、エラーコードは topic_over_quota として表示されます。

Cloud Logging API の割り当て変更のリクエスト

Google Cloud コンソールを使用して、Logging API の上限の引き上げまたは引き下げをリクエストできます。詳細については、割り当ての表示と管理をご覧ください。

エラー Edit is not allowed for this quota が発生した場合は、サポートに連絡して割り当ての変更をリクエストします。また、チェックボックスをクリックするために、Google Cloud プロジェクトで課金を有効にする必要があります。

entries.list の使用量を最適化する

entries.list の想定される用途は、一致するログの検索です。この方法は、ログエントリを大量に取得するためのものではありません。entries.list 割り当てが常に不足している場合は、次のオプションを検討してください。

  • Cloud Logging API を効果的に使用していることを確認します。詳細については、API の使用を最適化するをご覧ください。

  • 分析するログエントリが entries.list 割り当てを超えていることが事前にわかっている場合は、サポートされている宛先にログをエクスポートするようにログシンクを構成します。

  • Logging の外部でログエントリを分析するには、Logging にすでに存在するログエントリを Cloud Storage バケットに遡ってコピーします。ログを Cloud Storage バケットにコピーすると、Logging の外部の監査者とログエントリを共有し、Cloud Storage でスクリプトを実行できます。

  • Logging 内でログエントリを集計して分析するには、ログエントリをログバケットに保存し、そのログバケットをアップグレードして Log Analytics を使用できるようにします。これらの手順については、ログバケットを構成するをご覧ください。

    ログ分析では、BigQuery 標準 SQL を使用してログエントリをクエリできます。

ログベースの指標

ユーザー定義のログベースの指標の使用には、次の上限が適用されます。 指標記述子の数を除き、これらの上限は固定されていて、増減できません。

カテゴリ 最大値
ラベル数 1 指標あたり 10
ラベル値の長さ 1,024 B
ラベルの説明の長さ 800 B
フィルタの長さ1 20,000 文字
指標記述子の長さ 8,000 B
指標記述子の数 Google Cloud プロジェクトあたり 500 個2
アクティブな時系列の数3 1 指標あたり 30,000
ヒストグラム バケットの数 カスタム分布指標あたり200
データの保持 Cloud Monitoring: データの保持をご覧ください。

1 各ログベースの指標にはフィルタが含まれています。ログエントリがフィルタと一致すると、ログエントリがカウントされます。フィルタは、Logging クエリ言語を使用して定義します。

2 この上限は、請求先アカウント、フォルダ、組織にも適用され、階層型ではありません。

3 過去 24 時間以内に時系列にデータポイントが書き込まれた場合、その時系列はアクティブです。

監査ロギング

監査ログの最大サイズは次の表のとおりです。これらの値は、シンク デスティネーションに必要な容量を見積もるのに役立ちます。

監査ログのタイプ 最大サイズ
Admin Activity 512 KiB
Data Access 512 KiB
システム イベント 512 KiB
ポリシー拒否 512 KiB

ログの保持期間

Cloud Logging の保持期間は、バケットに含まれるログの種類や、別の場所からコピーされたかどうかにかかわらず、ログバケットに適用されます。保持に関する情報は次のとおりです。

バケット デフォルトの保持期間 カスタム保持
_Required 400 日 構成不可
_Default 30 日 構成可能
ユーザー定義 30 日 構成可能

_Default とユーザー定義のログバケットについては、1～3,650 日の範囲でログを保持するように Cloud Logging を構成できます。保持ルールの設定については、カスタム保持の構成をご覧ください。

料金

Cloud Logging では、サポートされている宛先へのログの転送で料金を請求されることはありませんが、宛先での料金が発生する場合があります。_Required ログバケットを除き、Cloud Logging では、ログバケットへのログのストリーミングと、ログバケットのデフォルト保持期間よりも長いストレージの料金が請求されます。

Cloud Logging では、ログのコピー、ログスコープの定義、またはログ エクスプローラまたは [ログ分析] ページを介して発行されたクエリには課金されません。

詳細については、次のドキュメントをご覧ください。