ktm dashboards add-widget

Ajouter un widget à un dashboard depuis un fichier JSON ou stdin

Utilisation

ktm dashboards add-widget <uid> [flags]

Exemples

# Add widget from a file (auto-positioned)
ktm dashboards add-widget abc123 --json widget.json

# Pipe from template
ktm dashboards widget-template title | ktm dashboards add-widget abc123 --json -

# With explicit position and size
ktm dashboards add-widget abc123 --json widget.json --x 0 --y 0 --w 24 --h 1

# Full-width chart
ktm dashboards add-widget abc123 --json chart.json --w 24 --h 8

Arguments

Flags

Détails

Valide une définition de widget et l'ajoute à la disposition du dashboard.

Le JSON du widget est la section data (même format que la sortie de widget-template, sans _metadata). Utilisez --json pour spécifier un fichier ou "-" pour lire depuis stdin.

DISPOSITION DE GRILLE : 24 colonnes, 30px de hauteur par ligne, compaction verticale.

• Pleine largeur : --w 24. Moitié : --w 12. Quart : --w 6.
• x + w doit être <= 24. Les widgets ne peuvent pas se chevaucher.
• Omettez --x et --y pour le positionnement automatique (remplit les espaces de gauche à droite, de haut en bas).
• Tailles par défaut par type : charts/tables/custom 6x8, counter 6x3, title 6x2.

PATTERNS DE DISPOSITION :

• Ligne de KPI : 2-4 counters. --w 12 pour 2, --w 8 pour 3, --w 6 pour 4.
• Paire de charts : 2 charts côte à côte, --w 12 chacun.
• Séparateur de section : title --w 24 --h 2, puis contenu en dessous.

customDisplay : nécessite un script IIFE, utilise queries[] et non series[], script de 20Ko max. Les scripts peuvent calculer (ratios, stats, corrélation) mais ne disposent pas du moteur statistique de la plateforme (EWMA, détection d'anomalies, SLO). Utilisez InfluxQL ou les outils MCP/CLI pour ceux-ci. Ne codez pas en dur des valeurs pré-calculées : les widgets sont dynamiques et ré-interrogent lors des changements de plage temporelle. Exécutez validate-widget ou consultez widget-template _metadata.notes pour la documentation de l'API script.

Voir aussi

• ktm dashboards

Et ensuite ?