This page provides details on the limits that apply to using Cloud Logging.
Logging usage limits
The following limits apply to the usage of Cloud Logging. With the exception of the limits on the number of log buckets and sinks, these limits are fixed; you can't increase or decrease them.
Category | Maximum value |
---|---|
Size of a
LogEntry |
256 KB1 |
Size of an audit log entry | 512 KiB |
Number of labels | 64 per LogEntry |
Length of a LogEntry label key |
512 B2 |
Length of a LogEntry label value |
64 KB2 |
Length of a Logging query language query | 20,000 characters |
Query fanout4 | 200 buckets |
Number of sinks | 200 per Trusted Cloud project3 |
Length of a sink inclusion filter | 20,000 characters |
Length of a sink exclusion filter | 20,000 characters |
Number of exclusion filters | 50 per sink |
Number of log buckets | 100 per Trusted Cloud project3,4,5 |
Number of custom indexed fields | 20 per log bucket |
Number of log views | 30 per log bucket |
Oldest timestamp that can be stored in log buckets6 | Determined by the default retention period of the log bucket. For a custom log bucket with the default retention period, this value is 30 days in the past. |
Future timestamp that can be stored in log buckets6 | Up to 1 day in the future |
Number of log scopes per resource | 100 |
Number of log views and projects included in a log scope | 100 |
Number of projects included in a log scope | 5 |
1 This approximate limit is based on internal data sizes, not
the actual REST API request size.
2 Cloud Logging truncates oversized label keys and values when
their associated log entry is written.
3 This limit also applies to billing accounts, folders, and
organizations and isn't hierarchical. For example, if you have multiple
Trusted Cloud projects in an organization, then you could configure up to
200 sinks for each Trusted Cloud project; for that
same organization, you could also configure up to 200
sinks at the organization level.
4 This limit is the maximum number of buckets that might contain
log entries for a resource. For more information, see
Query returns an error.
5 This limit includes buckets that are
pending deletion.
6 Log entries with timestamps outside of these boundaries are
rejected from log buckets. The Logging API accepts entries with older
timestamps, and those entries can be routed to sink destinations but not
stored in log storage. The Logging API rejects entries with timestamps
more than 1 day in the future and returns an
INVALID_ARGUMENT
error.
7This feature is in Public Preview.
Logging API quotas and limits
The following limits apply to your usage of the Logging API. You can request changes to your Logging API quotas and limits; for instructions, see Requesting changes to Cloud Logging API quota on this page.
Category | Maximum value |
---|---|
API usage | To view your quotas, go to the API dashboard, select an API, and then select Quotas. |
Lifetime of API page tokens | 24 hours |
Size of an entries.write request |
10 MB |
Number of entries.write requestsQuota being replaced; for more information, see Per-region ingestion quotas |
120,000 per minute, per Trusted Cloud project1, 3; unlimited after August 4, 2025; quota removed after August 11, 2025 |
Rate of entries.write requests,
by regionQuotas being added; for more information, see Per-region ingestion quotas |
4.8 GB per minute, per Trusted Cloud project, in the regions
asia-east1 ,
asia-northeast1 ,
asia-southeast1 ,
asia-south1 ,
europe-west1 ,
europe-west2 ,
europe-west3 ,
europe-west4 ,
us-central1 ,
us-east4 ,
us-west1
1, 3300 MB per minute, per Trusted Cloud project, in all remaining regions1, 3 |
Number of entries.list requests |
60 per minute, per Trusted Cloud project2, 3 |
Number of different resource names in a single entries.write command4 |
1000 |
Control requests5 per minute | 600 |
Control requests5 per day | 1,000 per Trusted Cloud project |
Number of Trusted Cloud projects or other resource names in a single entries.list request |
100 |
Rate of exports to a Pub/Sub topic6 | 60 GB per minute per Trusted Cloud project |
1 Using exclusion filters doesn't reduce
this number because logs are excluded after the entries.write
request is made.
2This value is the default setting.
3 This limit also applies to billing accounts, folders, and
organizations and isn't hierarchical.
4 The logName
field of a log entry specifies
the log entry's resource name.
5 The daily control-request quota applies to API requests
for creating and updating exclusions and sinks. The
per-minute control-request quota applies to everything also included in
the daily control-request quota, plus API requests for deleting logs and
managing log-based metrics.
6 If the rate of exports exceeds the quota, then the error is
recorded in a log entry. The summary field indicates sink configuration error
and the error code is listed as topic_over_quota
.
Per-region ingestion quotas
Starting on August 4, 2025, Cloud Logging
quotas will limit, on a per-Trusted Cloud project basis, the volume of data written
to an ingestion region. On August 4, 2025,
Cloud Logging will stop limiting the number of
API entries.write
requests from a Trusted Cloud project. This change is intended
to improve isolation and protect regional resources from ingestion overload.
The following table shows the default quota for each region:
Ingestion region | Default value |
---|---|
asia-east1 ,
asia-northeast1 ,
asia-southeast1 ,
asia-south1 ,
europe-west1 ,
europe-west2 ,
europe-west3 ,
europe-west4 ,
us-central1 ,
us-east4 ,
us-west1
|
4.8 GB per minute, per Trusted Cloud project |
All remaining regions | 300 MB per minute, per Trusted Cloud project |
The default values for the regional quotas exceed the ingestion volumes of most users. However, if before August 4, 2025, your project's ingestion volume from a region in the previous six or more months is close to or above the default quota for that region, then your initial quota includes an automatic, one-time increase. Therefore, your quotas might be higher than the defaults in the preceding table.
You can review your regional quotas before August 4, 2025, but the quotas aren't enforced until after that date. For information about reviewing quotas, see Review your Logging quotas.
On August 4, 2025, the quota for the
number of entries.write
requests will be changed to unlimited.
On August 11, 2025, the quota for the
number of entries.write
requests will be removed.
If you exceed a regional quota after August 4, 2025, your write requests to the Cloud Logging API might be rejected with a "resource exhausted" error message. For recommendations to help you avoid exceeding quotas, see Manage and monitor your Logging quotas.
Review your Cloud Logging API quotas
To review your Cloud Logging API quotas, do the following:
-
In the Trusted Cloud console, go to the Quotas & System Limits page:
If you use the search bar to find this page, then select the result whose subheading is IAM & Admin.
- Filter the list of quotas for the Cloud Logging API service.
Request changes to Cloud Logging API quota
You can request higher or lower Logging API limits using the Trusted Cloud console. For more information, see View and manage quotas.
Manage and monitor your Cloud Logging API quotas
To prevent service disruptions caused by exceeding quotas, you can do the following:
- Use automatic quota adjustment to monitor your quota usage and request increases for you. For more information, see Quota adjuster.
- Create alerts on quotas to notify you about usage. For more information, see Set up quota alerts.
Optimize usage of entries.list
The expected usage of entries.list
is to search for
matching logs. This method isn't intended for high-volume retrieval of
log entries. If
you're regularly exhausting your entries.list
quota, then consider the
following options:
Ensure that you are using the Cloud Logging API effectively. For more information, see Optimize usage of the API.
If you know in advance that the log entries you want to analyze exceed the
entries.list
quota, then configure a log sink to export your logs to a supported destination.
Audit logging
The maximum sizes of audit logs are shown in the following table. These values can help you estimate the space you need in your sink destinations.
Audit log type | Maximum size |
---|---|
Admin Activity | 512 KiB |
Data Access | 512 KiB |
System Event | 512 KiB |
Policy Denied | 512 KiB |
Logs retention periods
The following Cloud Logging retention periods apply to log buckets, regardless of which types of logs are included in the bucket or whether they were copied from another location. The retention information is as follows:
Bucket | Default retention period |
---|---|
_Required |
400 days |
_Default |
30 days |
User-defined | 30 days |