Environment Variables for Profiling

Stack: torch-spyre (new, Inductor-based).

Variables that affect profile capture, telemetry, and observability. Debug-oriented variables (TORCH_SPYRE_DEBUG, TORCH_COMPILE_DEBUG, TORCHINDUCTOR_FORCE_DISABLE_CACHES, INDUCTOR_PROVENANCE, TORCH_TRACE) live under Debugging.

Logging

Variable	Effect
`SPYRE_INDUCTOR_LOG=1`	Deprecated. Use `TORCH_LOGS="spyre.inductor:INFO"`. Enables Spyre-specific Inductor logging
`SPYRE_INDUCTOR_LOG_LEVEL=DEBUG`	Deprecated. Set the level in `TORCH_LOGS` (e.g. `spyre.inductor:DEBUG`). Sets Spyre Inductor log verbosity
`SPYRE_LOG_FILE=path/to/file.log`	Deprecated. Mapped to the top-level `spyre` logger file handler. Redirects Spyre Inductor log output to a file
`TORCH_LOGS="spyre.inductor:DEBUG"`	Preferred logging control. Accepts `spyre.*` namespaces (`spyre`, `spyre.inductor`, `spyre.inductor.codegen`, and so on)
`TORCH_LOGS="+inductor"`	Verbose PyTorch Inductor logging
`TORCH_SPYRE_DOWNCAST_WARN=0`	Suppress `int64 → int32` downcast warnings

Compiler configuration

Variable	Effect
`SENCORES=<1..32>`	Number of Spyre cores to target (default 32)

Device enumeration

Read by torch-spyre (spyre_device_enum.cpp) at startup to discover the Spyre devices visible to the process.

Variable	Effect
`PCIDEVICE_IBM_COM_AIU_PF`	Comma-separated list of PCI bus IDs assigned to the container (set by the OpenShift AIU operator or manually)
`AIU_WORLD_RANK_<N>`	PCI bus ID bound to rank `N`
`SPYRE_DEVICES`	Comma-separated list of device indices to use (e.g., `0,2,3`); overrides the default enumeration
`LOCAL_RANK`	Per-process rank set by `torchrun`; used to select the device for each child process

Runtime / driver (for `aiu-smi` and `aiu-trace-analyzer`)

Variable	Effect
`SENLIB_DEVEL_CONFIG_FILE=<path>`	Point the Spyre driver (`senlib`) at a config file enabling hardware-counter collection; required for `aiu-smi`
`DTCOMPILER_KEEP_EXPORT=true`	Keep compiler export directories around after a run; required for `aiu-smi` to report `rsvmem` and for `aiu-trace-analyzer` post-processing
`DEEPRT_EXPORT_DIR=<dir>`	Where the runtime / compiler write export artifacts; set to the same path in the workload and monitoring shells
`DTCOMPILER_EXPORT_DIR=<dir>`	Override the compiler export location (defaults to CWD when unset)
`DT_DEEPRT_VERBOSE=0`	Quiet runtime logs when capturing traces for `aiu-trace-analyzer`

Quick-reference recipes

`aiu-smi` workload shell

export DTCOMPILER_KEEP_EXPORT=true
export SENLIB_DEVEL_CONFIG_FILE=$HOME/.local/etc/senlib_config_aiusmi.json
# Optional: co-locate compiler exports and aiu-smi lookups
export DEEPRT_EXPORT_DIR=$PWD

`aiu-smi` monitoring shell (run in parallel)

export DEEPRT_EXPORT_DIR=$PWD   # matches the workload shell
aiu-smi