割り当てと上限

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

Logging の使用量上限

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

Category 最大値
ログエントリのサイズ 256 KB1
監査ログエントリのサイズ 512 KiB
ラベル数 ログエントリあたり 64 個
ログエントリ ラベルキーの長さ 512 B2
ログエントリ ラベルバリューの長さ 64 KB2
クエリの長さ 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 日まで

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

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

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

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

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

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

Logging API の割り当てと上限

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

Category 最大値
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 エクスポート率が割り当てを超えると、エラーがログエントリに記録されます。概要フィールドはシンク構成エラーを示し、エラーコードは topic_over_quota として一覧表示されます。

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

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

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

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

  2. [割り当ての変更] パネルで、サービスを選択してビューを展開し、[新しい上限] フィールドと [リクエストの説明] フィールドに情報を入力します。[次へ] をクリックします。

  3. [連絡先の詳細] パネルでフォームに入力します。

  4. [リクエストを送信] をクリックします。

詳細については、割り当ての表示と管理をご覧ください。

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

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

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

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

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

  • Logging 内のログエントリを集計して分析するには、ログ分析を使用するようにログバケットを作成またはアップグレードします。ログ分析では、BigQuery 標準 SQL を使用してログエントリをクエリできます。

ログベースの指標

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

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

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

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

ログの保持期間

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

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

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

料金

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

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

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