1
0
Fork 0
mirror of https://github.com/imjasonh/gcloud-help synced 2026-07-08 18:45:13 +00:00
gcloud-help/gcloud/beta/debug/logpoints/list
2022-03-01 04:29:52 +00:00

100 lines
3.9 KiB
Text

NAME
gcloud beta debug logpoints list - list the debug logpoints for a Cloud
Debugger debug target (debuggee)
SYNOPSIS
gcloud beta debug logpoints list [ID ...] [--no-all-users]
[--include-inactive=INCLUDE_INACTIVE; default=300]
[--location=LOCATION-REGEXP] [--target=(ID|DESCRIPTION_REGEXP)]
[--filter=EXPRESSION] [--limit=LIMIT] [--sort-by=[FIELD,...]]
[GCLOUD_WIDE_FLAG ...]
DESCRIPTION
(BETA) gcloud beta debug logpoints list is used to display the debug
logpoints for a Cloud Debugger debug target (debuggee). By default all
active logpoints are returned. To obtain older, expired logoints, specify
the --include-inactive option.
EXAMPLES
To list the active and recently completed debug logpoints of the debug
target (debuggee), run:
$ gcloud beta debug logpoints list --target=<debuggee_id>
To list all (both active and inactive) logpoints of the debug target
(debuggee), run:
$ gcloud beta debug logpoints list --target=<debuggee_id> \
--include-inactive=unlimited
To list logpoints only created by the current user (by default all users
are returned) of the debug target (debuggee), run:
$ gcloud beta debug logpoints list --target=<debuggee_id> \
--no-all-users
POSITIONAL ARGUMENTS
[ID ...]
Zero or more logpoint resource identifiers. The specified logpoints
will be listed.
FLAGS
--all-users
If false, display only logpoints created by the current user. Enabled
by default, use --no-all-users to disable.
--include-inactive=INCLUDE_INACTIVE; default=300
Include logpoints which failed or expired in the last INCLUDE_INACTIVE
seconds. If the value is "unlimited", all failed or expired logpoints
will be included.
--location=LOCATION-REGEXP
A regular expression to match against logpoint locations. All logpoints
matching this value will be listed. You may specify --location multiple
times.
EXAMPLE:
gcloud beta debug logpoints list \
--location foo.py:[1-3] --location bar.py:4
--target=(ID|DESCRIPTION_REGEXP)
The debug target. It may be a target ID or name obtained from 'debug
targets list', or it may be a regular expression uniquely specifying a
debuggee based on its description or name. For App Engine projects, if
not specified, the default target is the most recent deployment of the
default module and version.
LIST COMMAND FLAGS
--filter=EXPRESSION
Apply a Boolean filter EXPRESSION to each resource item to be listed.
If the expression evaluates True, then that item is listed. For more
details and examples of filter expressions, run $ gcloud topic filters.
This flag interacts with other flags that are applied in this order:
--flatten, --sort-by, --filter, --limit.
--limit=LIMIT
Maximum number of resources to list. The default is unlimited. This
flag interacts with other flags that are applied in this order:
--flatten, --sort-by, --filter, --limit.
--sort-by=[FIELD,...]
Comma-separated list of resource field key names to sort by. The
default order is ascending. Prefix a field with ``~'' for descending
order on that field. This flag 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 help for details.
NOTES
This command is currently in beta and might change without notice. This
variant is also available:
$ gcloud debug logpoints list