inspect trace
List and read execution traces.
Inspect includes a TRACE log-level which is right below the HTTP and INFO log levels (so not written to the console by default). However, TRACE logs are always recorded to a separate file, and the last 10 TRACE logs are preserved. The ‘trace’ command provides ways to list and read these traces.
Learn more about execution traces at https://inspect.aisi.org.uk/tracing.html.
Usage
inspect trace [OPTIONS] COMMAND [ARGS]...Subcommands
| list | List all trace files. |
| dump | Dump a trace file to stdout (as a JSON array of log records). |
| http | View all HTTP requests in the trace log. |
| anomalies | Look for anomalies in a trace file (never completed or cancelled actions). |
inspect trace list
List all trace files.
Usage
inspect trace list [OPTIONS]Options
| Name | Type | Description | Default |
|---|---|---|---|
--json |
boolean | Output listing as JSON | False |
--help |
boolean | Show this message and exit. | False |
inspect trace dump
Dump a trace file to stdout (as a JSON array of log records).
Usage
inspect trace dump [OPTIONS] [TRACE_FILE]Options
| Name | Type | Description | Default |
|---|---|---|---|
--filter |
text | Filter (applied to trace message field). | None |
--help |
boolean | Show this message and exit. | False |
inspect trace http
View all HTTP requests in the trace log.
Usage
inspect trace http [OPTIONS] [TRACE_FILE]Options
| Name | Type | Description | Default |
|---|---|---|---|
--filter |
text | Filter (applied to trace message field). | None |
--failed |
boolean | Show only failed HTTP requests (non-200 status) | False |
--help |
boolean | Show this message and exit. | False |
inspect trace anomalies
Look for anomalies in a trace file (never completed or cancelled actions).
Usage
inspect trace anomalies [OPTIONS] [TRACE_FILE]Options
| Name | Type | Description | Default |
|---|---|---|---|
--filter |
text | Filter (applied to trace message field). | None |
--all |
boolean | Show all anomolies including errors and timeouts (by default only still running and cancelled actions are shown). | False |
--help |
boolean | Show this message and exit. | False |