gcloud: Thu Feb 23 10:13:49 UTC 2023

gcloud/beta/run/jobs/executions/help

@@ -28,6 +28,9 @@ GCLOUD WIDE FLAGS
 GROUPS
     GROUP is one of the following:
 
+     logs
+        (BETA) Read logs for Cloud Run jobs executions.
+
      tasks
         (BETA) View and manage your Cloud Run jobs tasks.
 

gcloud/beta/run/jobs/executions/logs/help

@@ -0,0 +1,45 @@
+NAME
+    gcloud beta run jobs executions logs - read logs for Cloud Run jobs
+        executions
+
+SYNOPSIS
+    gcloud beta run jobs executions logs COMMAND [--region=REGION]
+        [GCLOUD_WIDE_FLAG ...]
+
+DESCRIPTION
+    (BETA) Read logs for Cloud Run jobs executions.
+
+EXAMPLES
+    To tail logs for a job execution, run:
+
+        $ gcloud beta run jobs executions logs tail my-job-execution
+
+    To read logs for a job execution, run:
+
+        $ gcloud beta run jobs executions logs read my-job-execution
+
+FLAGS
+     --region=REGION
+        Region in which the resource can be found. Alternatively, set the
+        property [run/region].
+
+GCLOUD WIDE FLAGS
+    These flags are available to all commands: --help.
+
+    Run $ gcloud help for details.
+
+COMMANDS
+    COMMAND is one of the following:
+
+     read
+        (BETA) Read logs for Cloud Run job executions.
+
+     tail
+        (BETA) Tail logs for Cloud Run job executions.
+
+NOTES
+    This command is currently in beta and might change without notice. This
+    variant is also available:
+
+        $ gcloud alpha run jobs executions logs
+

gcloud/beta/run/jobs/executions/logs/read

@@ -0,0 +1,84 @@
+NAME
+    gcloud beta run jobs executions logs read - read logs for Cloud Run job
+        executions
+
+SYNOPSIS
+    gcloud beta run jobs executions logs read EXECUTION
+        [--freshness=FRESHNESS; default="1d"] [--log-filter=LOG_FILTER]
+        [--order=ORDER; default="desc"] [--region=REGION] [--limit=LIMIT]
+        [GCLOUD_WIDE_FLAG ...]
+
+DESCRIPTION
+    (BETA) gcloud beta run jobs executions logs read reads log entries. Log
+    entries matching --log-filter are returned according to the specified
+    --order. If the log entries come from multiple logs, then entries from
+    different logs might be intermingled in the results.
+
+EXAMPLES
+    To read log entries from for a Cloud Run job execution, run:
+
+        $ gcloud beta run jobs executions logs read my-job-execution
+
+    To read log entries with severity ERROR or higher, run:
+
+        $ gcloud beta run jobs executions logs read my-job-execution \
+            --log-filter="severity>=ERROR"
+
+    To read log entries written in a specific time window, run:
+
+        $ gcloud beta run jobs executions logs read my-job-execution \
+            --log-filter='timestamp<="2015-05-31T23:59:59Z" AND
+         timestamp>="2015-05-31T00:00:00Z"'
+
+    To read up to 10 log entries in your job payloads that include the word
+    SearchText and format the output in JSON format, run:
+
+        $ gcloud beta run jobs executions logs read my-job-execution \
+            --log-filter="textPayload:SearchText" --limit=10 --format=json
+
+    Detailed information about filters can be found at:
+    https://cloud.google.com/logging/docs/view/advanced_filters
+
+POSITIONAL ARGUMENTS
+     EXECUTION
+        Name for a Cloud Run job execution.
+
+FLAGS
+     --freshness=FRESHNESS; default="1d"
+        Return entries that are not older than this value. Works only with DESC
+        ordering and filters without a timestamp. See $ gcloud topic datetimes
+        for information on duration formats.
+
+     --log-filter=LOG_FILTER
+        Filter expression that specifies the log entries to return. Detailed
+        information about filters can be found at:
+        https://cloud.google.com/logging/docs/view/logging-query-language
+
+     --order=ORDER; default="desc"
+        Ordering of returned log entries based on timestamp field. ORDER must
+        be one of: desc, asc.
+
+     --region=REGION
+        Region in which the resource can be found. Alternatively, set the
+        property [run/region].
+
+LIST COMMAND FLAGS
+     --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.
+
+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 alpha run jobs executions logs read
+

gcloud/beta/run/jobs/executions/logs/tail

@@ -0,0 +1,54 @@
+NAME
+    gcloud beta run jobs executions logs tail - tail logs for Cloud Run job
+        executions
+
+SYNOPSIS
+    gcloud beta run jobs executions logs tail EXECUTION
+        [--log-filter=LOG_FILTER] [--region=REGION] [GCLOUD_WIDE_FLAG ...]
+
+DESCRIPTION
+    (BETA) gcloud beta run jobs executions logs tail tails log-entries for a
+    particular Cloud Run job exeuction in real time. The log entries are
+    formatted for consumption in a terminal.
+
+EXAMPLES
+    To tail log entries for a Cloud Run job exeuction, run:
+
+        $ gcloud beta run jobs executions logs tail my-job-execution
+
+    To tail log entries with severity ERROR or higher, run:
+
+        $ gcloud beta run jobs executions logs tail my-job-execution \
+            --log-filter="severity>=ERROR"
+
+    Detailed information about filters can be found at:
+    https://cloud.google.com/logging/docs/view/advanced_filters
+
+POSITIONAL ARGUMENTS
+     EXECUTION
+        Name for a Cloud Run job.
+
+FLAGS
+     --log-filter=LOG_FILTER
+        Filter expression that specifies the log entries to return. Detailed
+        information about filters can be found at:
+        https://cloud.google.com/logging/docs/view/logging-query-language
+
+     --region=REGION
+        Region in which the resource can be found. Alternatively, set the
+        property [run/region].
+
+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 alpha run jobs executions logs tail
+