ktm metrics resource-usage

Get device resource usage broken down by hour and 5-minute intervals

Usage

ktm metrics resource-usage [flags]

Examples

# Hourly usage for two SIMs over one day
ktm metrics resource-usage --operator acme --resources 0612345678,0698765432 --start 2024-01-01T00:00:00Z --end 2024-01-02T00:00:00Z

# 5-minute granularity
ktm metrics resource-usage --operator acme --resources 0612345678 --aggregation 5m --start 2024-01-01T00:00:00Z --end 2024-01-01T06:00:00Z

Flags

Flag	Type	Default	Description
`--aggregation`	string	`1h`	Time aggregation bucket (e.g. '1h', '5m')
`--end`	string		End time in ISO 8601 format (e.g. '2024-01-02T00:00:00Z')
`--operator`	string		Operator slug (= InfluxDB database name)
`--resources`	string		Comma-separated device IDs
`--start`	string		Start time in ISO 8601 format (e.g. '2024-01-01T00:00:00Z')

Details

Get device resource usage broken down by time intervals.

Returns usage percentage per resource, broken down by the specified aggregation window (default 1h). Use for analyzing device utilization patterns over time.

This queries the "resource_usage" measurement in InfluxDB. Device IDs correspond to resources discovered via 'ktm resources list' (SIM: national_msisdn, web-agent: hostname, smartphone: UUID).

Maximum recommended time range: 90 days.

Global flags (--output, --debug, --host, …) apply to every command. See the command reference overview.

What's next?

All commands

Browse the full CLI reference.

Get started

Install the CLI and authenticate.