---
title: "ktm metrics resource-usage"
description: "Obtenir l'utilisation des ressources d'appareils par intervalles d'une heure et de 5 minutes"
sidebarTitle: "resource-usage"
lastUpdated: "2026-09-23"
---

> **For AI agents:** the complete documentation index is at [llms.txt](/llms.txt). Append `.md` to any page URL for its markdown version.

{/* GENERATED FILE: do not edit by hand. Regenerate with: node scripts/generate.mjs */}

Obtenir l'utilisation des ressources d'appareils par intervalles d'une heure et de 5 minutes

## Utilisation

```bash
ktm metrics resource-usage [flags]
```

## Exemples

```bash
# 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 | Défaut | Description |
| --- | --- | --- | --- |
| `--aggregation` | string | `1h` | Fenêtre d'agrégation temporelle (ex. '1h', '5m') |
| `--end` | string |  | Heure de fin au format ISO 8601 (ex. '2024-01-02T00:00:00Z') |
| `--operator` | string |  | Slug de l'opérateur (= nom de base de données InfluxDB) |
| `--resources` | string |  | ID d'appareils séparés par des virgules |
| `--start` | string |  | Heure de début au format ISO 8601 (ex. '2024-01-01T00:00:00Z') |

## Détails

Obtenir l'utilisation des ressources d'appareils par intervalles de temps.

Retourne le pourcentage d'utilisation par ressource, ventilé par la fenêtre d'agrégation
spécifiée (défaut 1h). Utilisez cette commande pour analyser les patterns d'utilisation des appareils dans le temps.

Interroge le measurement "resource_usage" dans InfluxDB. Les ID d'appareils correspondent
aux ressources découvertes via 'ktm resources list' (SIM : national_msisdn,
web-agent : hostname, smartphone : UUID).

Plage temporelle maximale recommandée : 90 jours.

## Voir aussi

- [`ktm metrics`](/fr/cli/commands/metrics)
- [`ktm resources`](/fr/cli/commands/resources)

<Note>
  Les flags globaux (`--output`, `--debug`, `--host`, ...) s'appliquent à toutes les commandes. Voir la [présentation de la référence des commandes](/fr/cli/commands/overview).
</Note>

## Et ensuite ?

<Columns cols={2}>
  <Card title="Toutes les commandes" icon="terminal" href="/fr/cli/commands/overview">
    Parcourir la référence complète du CLI.
  </Card>
  <Card title="Premiers pas" icon="rocket" href="/fr/cli/getting-started">
    Installer le CLI et s'authentifier.
  </Card>
</Columns>