割り当てと上限

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

Logging の取り込みとストレージの毎月の割り当てについては、Cloud Logging の料金概要をご覧ください。

Logging の料金の詳細については、Google Cloud のオペレーションスイートの料金: Cloud Logging をご覧ください。

Logging の使用量上限

Cloud Logging の使用量には次の上限が適用されます。これらの上限は固定されています。上限の引き上げまたは引き下げはできません。

カテゴリ	最大値
ログエントリのサイズ	256 KB¹
監査ログエントリのサイズ	512 KiB
ラベル数	ログエントリあたり 64 個
ログエントリラベルキーの長さ	512 B²
ログエントリラベルバリューの長さ	64 KB²
クエリの長さ	20,000 文字
クエリのファンアウト⁴	200 個のバケット
シンクの数	Cloud プロジェクトごとに 200 個³
シンク包含フィルタの長さ	20,000 文字
シンク除外フィルタの長さ	20,000 文字
除外フィルタの数	1 シンクあたり 50 件
バケット数	Cloud プロジェクトごとに 100 個^3,^4,⁵
カスタムインデックスフィールドの数	1 バケットあたり 20 件
ログビューの数	1 バケットあたり 30 件
ログバケットに取り込む最も古いタイムスタンプ⁶	30 日前
将来のタイムスタンプをログバケットに取り込む⁶	最大 1 日後

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

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

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

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

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

⁶ タイムスタンプがこれらの範囲外であるログエントリは、ログバケットから拒否されます。Logging API は、タイムスタンプが古いエントリを受け入れます。これらのエントリはシンクのエクスポート先に転送できますが、ログストレージには保存できません。タイムスタンプが 1 日以上あるエントリは Logging API によって拒否され、INVALID_ARGUMENT エラーが返されます。

Logging API の割り当てと上限

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

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

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

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

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

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

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

Google Cloud Console を使用して、Logging API の上限の引き上げまたは引き下げをリクエストできます。

[割り当て] ページで、チェックボックスを使用して [Cloud Logging API] を選択し、[割り当てを編集] をクリックします。

エラー Edit is not allowed for this quota が発生した場合は、サポートに連絡して割り当ての変更をリクエストします。また、チェックボックスをクリックするために、Cloud プロジェクトで課金を有効にする必要があります。
[割り当ての変更] パネルで、サービスを選択してビューを展開し、[新しい上限] フィールドと [リクエストの説明] フィールドに情報を入力します。[次へ] をクリックします。
[連絡先の詳細] パネルでフォームに入力します。
[リクエストを送信] をクリックします。

詳細については、割り当ての操作をご覧ください。

`entries.list` の使用を最適化

entries.list の想定される用途は、一致するログの検索です。entries.list の割り当てを使い切っている場合は、ログを効率的に読み取り、一覧表示するで、使用量を最適化するためのヒントをご覧ください。

ログベースの指標

ユーザー定義のログベースの指標の使用には、次の上限が適用されます。これらの上限は固定されています。上限の引き上げまたは引き下げはできません。

カテゴリ	最大値
ラベル数	1 指標あたり 10
ラベル値の長さ	1,024 B
ラベルの説明の長さ	800 B
フィルタの長さ	20,000 文字
指標記述子の長さ	8,000 B
指標記述子の数	Cloud プロジェクトごとに 500²
アクティブな時系列の数¹	1 指標あたり 30,000
ヒストグラムバケットの数	カスタム分布指標あたり200

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

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

ログの保持期間

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

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

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