BlueForge Docs

forge app-trace

Trace requests through an app's services.

Command

forge app-trace <appId> [--follow] [--since <duration>]

Arguments

NameTypeRequiredNotes
appId
stringyesApp ID

Flags

FlagTypeDefaultNotes
--follow
bool
false
Continue tracing new requests
--since
stringTime window (e.g.
5m
,
1h
,
24h
)

Examples

Trace recent requests:

forge app-trace app_xxxxx --since 5m

Follow new requests:

forge app-trace app_xxxxx --follow

Errors

Exit codeMeaning
0Success
1Failed

Pitfalls

  • Service mesh — tracing requires the app's services to be instrumented with distributed tracing headers.
  • Time window --
    --since
    accepts durations in the format
    5m
    (minutes),
    1h
    (hours), or
    24h
    (days).

See also

{auto-injected}

Tested against

{auto-injected}