This page provides details on the limits that apply to using Cloud Logging.
Logging usage limits
Category | Maximum value |
---|---|
Size of a log entry | 256 KB1 |
Length of a log entry label key | 512 B2 |
Length of a log entry label value | 64 KB2 |
Number of export sinks | 200 per Cloud project |
Number of exclusion queries | 50 per sink |
Number of logs buckets | 10 per Cloud project |
Number of logs views | 10 per bucket |
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.Logging API quotas and limits
Category | Maximum value |
---|---|
API usage | To view your quotas, go to the API dashboard. Click an API and select Quotas. |
Lifetime of API page tokens | 24 hours |
Number of open live-tailing sessions per Cloud project | 10 |
Number of live-tailing entries returned per minute | 60,000 |
Size of an entries.write request | 10 MB |
Number of entries.write API calls | 120,000 per minute, per Cloud project1 |
Number of entries.list API calls | 1 per second, per Cloud project |
Number of Cloud projects or other resource names in a single entries.list API call | 100 |
1 Using log exclusions doesn't reduce this number because logs are excluded after the entries.write call is made.
Requesting more Cloud Logging API quota
You can request higher Logging API limits using the Google Cloud Console:
In the Quotas page, use the checkboxes to select Cloud Logging API, then click EDIT QUOTAS.
Billing must be enabled on the project in order to click the checkboxes.
In the Edit Quotas panel, complete the form with your Name, Email , and Phone details, then click Next.
In the Edit Quotas panel, select the service to expand the view, then edit the quotas in that service to your requested limit. Click Done.
Click Submit request.
The other limits described on this page are fixed.
For more information, go to Working with quotas.
Logs-based metrics
The following limits apply to your usage of user-defined logs-based metrics.
Category | Maximum value |
---|---|
Number of labels per metric | 10 |
Length of label value | 1,024 B |
Length of label description | 800 B |
Length of metric descriptors | 8,000 B |
Number of metric descriptors per Cloud project | 500 |
Number of active time series1 per metric | 30,000 |
Histogram buckets per custom distribution metric | 200 |
1A time series is active if you have written data points to it within the last 24 hours.
Logs retention periods
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:
Log bucket | Default retention period | Custom retention |
---|---|---|
_Required |
400 days | Not configurable |
_Default |
30 days | Configurable |
User-defined | 30 days | Configurable |
For the _Default
and user-defined log buckets, you can configure
Cloud Logging to retain your logs between
1 day and
3650 days. For information on setting retention
rules, see
Configuring custom retention.