akka optimize training capacity device-hours
Report the device-hours claims held in a period
Synopsis
Report the device-hours that GPU claims held between two instants, one row per pool or per endpoint.
A claim counts its devices from when the scheduler granted them until it released them, and a claim still held counts until now. Every time is one the scheduler recorded, so a figure does not change with how often it is read.
KEY is the pool’s key, or with --by endpoint the endpoint’s id. POOL is, for an endpoint, the pool its devices were counted in last. DEVICE HOURS is devices multiplied by the hours they were held in the period. HELD says whether the pool or the endpoint holds devices now.
--from and --to are ISO-8601 instants, such as 2026-10-01T00:00:00Z. --to defaults to now and --from to a day before --to. They are at most 366 days apart. --by is pool, the default, which counts every claim, or endpoint, which counts the claims of endpoints alone.
akka optimize training capacity device-hours [flags]
Examples
# The last day, by pool
akka optimize training capacity device-hours
# One month, by endpoint
akka optimize training capacity device-hours --from 2026-10-01T00:00:00Z --to 2026-11-01T00:00:00Z --by endpoint
# The endpoints holding devices now
akka optimize training capacity device-hours --by endpoint --jq '.rows[] | select(.held) | .key'
Options
--by string Count by pool or by endpoint (default pool)
--from string Count from this ISO-8601 instant (default a day before --to)
-h, --help help for device-hours
--to string Count until this ISO-8601 instant (default now)
Options inherited from parent commands
--cache-file string location of cache file (default "~/.akka/cache.yaml")
--config string location of config file (default "~/.akka/config.yaml")
--context string configuration context to use
--disable-prompt Disable all interactive prompts when running akka commands. If input is required, defaults will be used, or an error will be raised.
This is equivalent to setting the environment variable AKKA_DISABLE_PROMPTS to true.
--force Skip the confirmation prompt
--jq string Filter the JSON output with a jq expression
--json string Output JSON with only these fields; --json= lists the fields a command offers
--no-color Print without color or a redrawn progress line, as NO_COLOR does
-o, --output string set output format to one of [text,json,json-compact,go-template=] (default "text")
--page-mode string the mode for paging, either paged, buffered or auto. (default "auto")
-q, --quiet set quiet output (helpful when used as part of a script)
--region string Region to use if the project has more than one region
--timeout duration client command timeout (default 10s)
--trainer-url string Trainer service URL (default TRAINER_URL, then AKKA_OPTIMIZE_URL, then a local dev-mode service, then http://localhost:9001)
--use-grpc-web use grpc-web when talking to Akka APIs. This is useful when behind corporate firewalls that decrypt traffic but don't support HTTP/2.
--verbose set verbose output
SEE ALSO
-
akka optimize training capacity - Report what holds the GPU pools