forge app-trace
Trace requests through an app's services.
Command
forge app-trace <appId> [--follow] [--since <duration>]
Arguments
| Name | Type | Required | Notes |
|---|---|---|---|
| string | yes | App ID |
Flags
| Flag | Type | Default | Notes |
|---|---|---|---|
| bool | | Continue tracing new requests |
| string | — | Time window (e.g. , , ) |
Examples
Trace recent requests:
forge app-trace app_xxxxx --since 5m
Follow new requests:
forge app-trace app_xxxxx --follow
Errors
| Exit code | Meaning |
|---|---|
| 0 | Success |
| 1 | Failed |
Pitfalls
- Service mesh — tracing requires the app's services to be instrumented with distributed tracing headers.
- Time window --
accepts durations in the format--since
(minutes),5m
(hours), or1h
(days).24h
See also
{auto-injected}
Tested against
{auto-injected}