Skip to content
grafOS docs

grafos profile

Program-level resource profiler: flame graphs, lease timelines, data-flow diagrams, waste reports.

grafos profile

Resource profiling: record, report, flamegraph, timeline, waste, sensitivity


Usage: grafos profile [OPTIONS] <COMMAND>


Commands:
  record       Record resource spans from a running program's metrics endpoint
  report       Generate all visualizations from a recording
  flamegraph   Generate flame graph from a recording
  timeline     Generate lease timeline from a recording
  waste        Show waste report from a recording
  sensitivity  Infer sensitivity profile from a recording
  help         Print this message or the help of the given subcommand(s)


Options:
      --fabric <FABRIC>  Fabric address (host:port). Overrides GRAFOS_FABRIC env var [env: GRAFOS_FABRIC=]
      --json             Output in JSON format for scripting
      --wide             Show additional columns in table output
      --no-color         Disable color output
      --pool <POOL>      Pool name (default: "default") [default: default]
  -h, --help             Print help
  -V, --version          Print version

grafos profile record

Record resource spans from a running program's metrics endpoint


Usage: grafos profile record [OPTIONS] --output <OUTPUT>


Options:
      --fabric <FABRIC>      Fabric address (host:port). Overrides GRAFOS_FABRIC env var [env: GRAFOS_FABRIC=]
  -o, --output <OUTPUT>      Output file for the recording
  -d, --duration <DURATION>  Duration in seconds to record [default: 30]
      --json                 Output in JSON format for scripting
      --wide                 Show additional columns in table output
      --no-color             Disable color output
      --pool <POOL>          Pool name (default: "default") [default: default]
  -h, --help                 Print help
  -V, --version              Print version

grafos profile report

Generate all visualizations from a recording


Usage: grafos profile report [OPTIONS] <FILE>


Arguments:
  <FILE>  Profile recording file


Options:
      --fabric <FABRIC>  Fabric address (host:port). Overrides GRAFOS_FABRIC env var [env: GRAFOS_FABRIC=]
      --format <FORMAT>  Output format: text or json [default: text]
      --json             Output in JSON format for scripting
      --wide             Show additional columns in table output
      --no-color         Disable color output
      --pool <POOL>      Pool name (default: "default") [default: default]
  -h, --help             Print help
  -V, --version          Print version

grafos profile flamegraph

Generate flame graph from a recording


Usage: grafos profile flamegraph [OPTIONS] <FILE>


Arguments:
  <FILE>  Profile recording file


Options:
      --fabric <FABRIC>  Fabric address (host:port). Overrides GRAFOS_FABRIC env var [env: GRAFOS_FABRIC=]
  -o, --output <OUTPUT>  Output HTML file
      --json             Output in JSON format for scripting
      --wide             Show additional columns in table output
      --no-color         Disable color output
      --pool <POOL>      Pool name (default: "default") [default: default]
  -h, --help             Print help
  -V, --version          Print version

grafos profile timeline

Generate lease timeline from a recording


Usage: grafos profile timeline [OPTIONS] <FILE>


Arguments:
  <FILE>  Profile recording file


Options:
      --fabric <FABRIC>  Fabric address (host:port). Overrides GRAFOS_FABRIC env var [env: GRAFOS_FABRIC=]
  -o, --output <OUTPUT>  Output HTML file
      --json             Output in JSON format for scripting
      --wide             Show additional columns in table output
      --no-color         Disable color output
      --pool <POOL>      Pool name (default: "default") [default: default]
  -h, --help             Print help
  -V, --version          Print version

grafos profile waste

Show waste report from a recording


Usage: grafos profile waste [OPTIONS] <FILE>


Arguments:
  <FILE>  Profile recording file


Options:
      --fabric <FABRIC>  Fabric address (host:port). Overrides GRAFOS_FABRIC env var [env: GRAFOS_FABRIC=]
      --json             Output in JSON format for scripting
      --wide             Show additional columns in table output
      --no-color         Disable color output
      --pool <POOL>      Pool name (default: "default") [default: default]
  -h, --help             Print help
  -V, --version          Print version

grafos profile sensitivity

Infer sensitivity profile from a recording


Usage: grafos profile sensitivity [OPTIONS] <FILE>


Arguments:
  <FILE>  Profile recording file


Options:
      --fabric <FABRIC>  Fabric address (host:port). Overrides GRAFOS_FABRIC env var [env: GRAFOS_FABRIC=]
      --json             Output in JSON format for scripting
      --wide             Show additional columns in table output
      --no-color         Disable color output
      --pool <POOL>      Pool name (default: "default") [default: default]
  -h, --help             Print help
  -V, --version          Print version