NAME

globus task event-list - List Events for a given Task

SYNOPSIS

globus task event-list [OPTIONS] TASK_ID

globus task event-list --filter-errors [OPTIONS] TASK_ID

globus task event-list --filter-non-errors [OPTIONS] TASK_ID

DESCRIPTION

The globus task event-list command shows the recent events for a running task. Most events of interest are fault events, which are errors which occurred on an endpoint but which are non-fatal to a task. For example, Permission Denied errors on an endpoint don’t cancel the task because they are often resolvable — at which point the task would retry succeed.

Events may be filtered using --filter-errors or --filter-non-errors, but these two options may not be used in tandem.

Note:Tasks older than one month may no longer have event log history. In this case, no events will be shown.

OPTIONS

--limit N

Restrict the event list to the last N events. Default is 10.

--filter-errors

Only show fault events.

--filter-non-errors

Only show non-fault events.

--map-http-status TEXT

Map non success HTTP response codes to exit codes other than 1. e.g. "--map-http-satus 403=0,404=0" would exit with 0 even if a 403 or 404 http error code was received. Valid exit codes are 0,1,50-99.

-F, --format [json|text]

Set the output format for stdout. Defaults to "text".

--jq, --jmespath EXPR

Supply a JMESPath expression to apply to json output. Takes precedence over any specified --format and forces the format to be json processed by this expression.

A full specification of the JMESPath language for querying JSON structures may be found at https://jmespath.org/

-h, --help

Show help text for this command.

-v, --verbose

Control the level of output.

Use -v or --verbose to show warnings and any additional text output.

Use -vv to add informative logging.

Use -vvv to add debug logging and full stack on any errors. (equivalent to -v --debug)

OUTPUT

When output is in text mode, the following fields are used:

  • Time

  • Code

  • Is Error

  • Details

EXAMPLES

Show why a task is paused, producing JSON output:

$ globus task pause-info TASK_ID --format JSON

EXIT STATUS

0 on success.

1 if a network or server error occurred, unless --map-http-status has been used to change exit behavior on http error codes.

2 if the command was used improperly.


© 2010- The University of Chicago Legal