> **Can't find what you're looking for?** Use `search_docs` on the docs MCP server at `https://www.getfoundry.sh/api/mcp` to find what you need.
>
> **Have feedback?** Use `submit_feedback` on the same MCP server.

## Tracing

Configuration for decoding and rendering execution traces produced by `forge test`,
`forge script`, `cast call`, and `cast run`.

Define these settings under `[profile.<name>.tracing]`:

```toml
[profile.default.tracing]
verbosity = 3
compact_labels = true
trace_depth = 10
decode_internal = true
external_identification_timeout = 5

[profile.default.tracing.labels]
"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045" = "vitalik.eth"
```

CLI trace options override or extend these values for the current command. The
legacy `[labels]` and profile-level `labels` settings are deprecated; move them
to `[profile.<name>.tracing.labels]`.

### Fields

#### `verbosity`

* Type: integer
* Default: 0

The minimum verbosity used when rendering traces. A command's `-v` flags can
increase, but not decrease, this value.

#### `labels`

* Type: table mapping addresses to strings
* Default: empty

Labels addresses in decoded traces. Labels passed with `--label` or `--labels`
extend this table and take precedence for duplicate addresses.

#### `disable_labels`

* Type: boolean
* Default: false

Disables address labels in rendered traces.

#### `compact_labels`

* Type: boolean
* Default: false

Hides an address in trace parameters when a label is available, displaying only
the label.

#### `trace_depth`

* Type: integer
* Default: none

Limits the maximum depth of rendered traces.

#### `decode_internal`

* Type: boolean
* Default: false

Identifies internal functions and decodes their stack parameters. Dynamic values
stored in memory are decoded only when Foundry can match a single function.

#### `external_identification_timeout`

* Type: integer
* Default: 5

Sets the cumulative time budget, in seconds, for identifying contracts in traces
through Sourcify and Etherscan. Once the budget is exhausted, Foundry renders
the trace with any identification results it has already received.

Set this value to `0` to disable all external trace identification, including
OpenChain signature lookups. You can also pass
`--disable-external-identification` to disable it for a single command. Neither
setting prevents Foundry from downloading compiler versions.