gcloud beta logging read Stay organized with collections Save and categorize content based on your preferences.
- NAME
- gcloud beta logging read - read log entries
- SYNOPSIS
gcloud beta logging read[LOG_FILTER][--freshness=FRESHNESS; default="1d"][--order=ORDER; default="desc"][--billing-account=BILLING_ACCOUNT_ID|--folder=FOLDER_ID|--organization=ORGANIZATION_ID|--project=PROJECT_ID][--resource-names=[RESOURCE,…] |--bucket=BUCKET--location=LOCATION--view=VIEW][--limit=LIMIT][GCLOUD_WIDE_FLAG …]
- DESCRIPTION
(BETA)gcloud beta logging read reads log entries. Log entriesmatchinglog-filterare returned in order of decreasing timestamps,most-recent entries first. If the log entries come from multiple logs, thenentries from different logs might be intermingled in the results.- EXAMPLES
- To read log entries from Google Compute Engine instances, run:
gcloudbetaloggingread"resource.type=gce_instance"To read log entries with severity ERROR or higher, run:
gcloudbetaloggingread"severity>=ERROR"To read log entries written in a specific time window, run:
gcloudbetaloggingread'timestamp<="2015-05-31T23:59:59Z" ANDtimestamp>="2015-05-31T00:00:00Z"'To read up to 10 log entries in your project's syslog log from Compute Engineinstances containing payloads that include the word
SyncAddressandformat the output inJSONformat, run:gcloudbetaloggingread"resource.type=gce_instance AND logName=projects/[PROJECT_ID]/logs/syslog AND textPayload:SyncAddress"--limit=10--format=jsonTo read a log entry from a folder, run:
gcloudbetaloggingread"resource.type=global"--folder=[FOLDER_ID]--limit=1To read a log entry from a global log bucket, run:
gcloudbetaloggingread--bucket=<bucket-id>--location=[LOCATION]--limit=1To read a log entry from the global
_Requiredlog bucket using thebucket's_Defaultlog view:gcloudbetaloggingread""--bucket=_Required--location=global--view=_Default--limit=1To read a log entry from a log bucket using the bucket's
_AllLogslog view:gcloudbetaloggingread""--bucket=[BUCKET_ID]--location=[LOCATION]--view=_AllLogs--limit=1To read a log entry from a log bucket using a custom log view that you havecreated for the bucket:
gcloudbetaloggingread""--bucket=[BUCKET_ID]--location=[LOCATION]--view=[VIEW_ID]--limit=1To read log entries from multiple resources, specify them as a comma-delimetedsequence with --resource-names. Each resource name can be specified either as atop-level resource (e.g., projects/[PROJECT_ID], folders/[FOLDER_ID], etc.) oras a Log View resource (e.g.,projects/[PROJECT_ID]/locations/[LOCATION]/buckets/[BUCKET_NAME]/views/[VIEW_ID]).
gcloudbetaloggingread""--resource-names=[RESOURCE-1],[RESOURCE-2] - POSITIONAL ARGUMENTS
- [
LOG_FILTER] - Filter expression that specifies the log entries to return. Detailed informationabout filters can be found at:https://cloud.google.com/logging/docs/view/logging-query-language
- [
- FLAGS
--freshness=FRESHNESS; default="1d"- Return entries that are not older than this value. Works only with DESC orderingand filters without a timestamp. See $gcloud topic datetimes forinformation on duration formats.
--order=ORDER; default="desc"- Ordering of returned log entries based on timestamp field.
ORDERmust be one of:desc,asc. - At most one of these can be specified:
--billing-account=BILLING_ACCOUNT_ID- Billing account of the log entries to read.
--folder=FOLDER_ID- Folder of the log entries to read.
--organization=ORGANIZATION_ID- Organization of the log entries to read.
--project=PROJECT_ID- Project of the log entries to read.
The Google Cloud project ID to use for this invocation. If omitted, then thecurrent project is assumed; the current project can be listed using
gcloudconfig list --format='text(core.project)'and can be set usinggcloud config set project PROJECTID.--projectand its fallbackcore/projectproperty playtwo roles in the invocation. It specifies the project of the resource to operateon. It also specifies the project for API enablement check, quota, and billing.To specify a different project for quota and billing, use--billing-projectorbilling/quota_projectproperty.
- At most one of these can be specified:
--resource-names=[RESOURCE,…]- Resource name(s) to read logs from. A resource can either be an top-levelresource (e.g., "projects/my-project") or a full log view resource path (e.g.,"projects/my-project/locations/my-location/buckets/my-bucket/views/my-view").Multiple resources can be specified, separated by a comma.
- Or at least one of these can be specified:
- These arguments are used in conjunction with the parent to construct a viewresource.
--bucket=BUCKET- Id of the log bucket. If this argument is provided then
--locationand--viewmust also be specified.This flag argument must be specified if any of the other arguments in this groupare specified.
--location=LOCATION- Location of the log bucket. If this argument is provided then
--bucketand--viewmust also be specified.This flag argument must be specified if any of the other arguments in this groupare specified.
--view=VIEW- Id of the view. If this argument is provided then
--locationand--bucketmust also be specified.This flag argument must be specified if any of the other arguments in this groupare specified.
- LIST COMMAND FLAGS
--limit=LIMIT- Maximum number of resources to list. The default is
unlimited. Thisflag interacts with other flags that are applied in this order:--flatten,--sort-by,--filter,--limit.
- GCLOUD WIDE FLAGS
- These flags are available to all commands:
--access-token-file,--account,--billing-project,--configuration,--flags-file,--flatten,--format,--help,--impersonate-service-account,--log-http,--project,--quiet,--trace-token,--user-output-enabled,--verbosity.Run
$gcloud helpfor details. - NOTES
- This command is currently in beta and might change without notice. Thesevariants are also available:
gcloudloggingreadgcloudalphaloggingread
Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2026-01-21 UTC.