scout trace
List and read execution traces.
Inspect Scout 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.
Usage
scout trace [OPTIONS] COMMAND [ARGS]...Options
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
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). |
scout trace list
List all trace files.
Usage
scout trace list [OPTIONS]Options
| Name | Type | Description | Default |
|---|---|---|---|
--json |
boolean | Output listing as JSON | False |
--help |
boolean | Show this message and exit. | False |
Subcommands
scout trace dump
Dump a trace file to stdout (as a JSON array of log records).
Usage
scout trace dump [OPTIONS] [TRACE_FILE]Options
| Name | Type | Description | Default |
|---|---|---|---|
--filter |
text | Filter (applied to trace message field). | |
--help |
boolean | Show this message and exit. | False |
Subcommands
scout trace http
View all HTTP requests in the trace log.
Usage
scout trace http [OPTIONS] [TRACE_FILE]Options
| Name | Type | Description | Default |
|---|---|---|---|
--filter |
text | Filter (applied to trace message field). | |
--failed |
boolean | Show only failed HTTP requests (non-200 status) | False |
--help |
boolean | Show this message and exit. | False |
Subcommands
scout trace anomalies
Look for anomalies in a trace file (never completed or cancelled actions).
Usage
scout trace anomalies [OPTIONS] [TRACE_FILE]Options
| Name | Type | Description | Default |
|---|---|---|---|
--filter |
text | Filter (applied to trace message field). | |
--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 |