ktm dashboards widget-template

Afficher un template JSON de widget sur stdout

Utilisation

ktm dashboards widget-template <type> [flags]

Exemples

# Get a line chart template
ktm dashboards widget-template line

# Get a customDisplay template (includes script API docs in _metadata)
ktm dashboards widget-template customDisplay > custom.json

# Save to file for editing
ktm dashboards widget-template counter > widget.json

Arguments

Détails

Obtenir un template JSON prêt à remplir pour un type de widget de dashboard. Types disponibles : line, area, pie, repartitionChart, counter, title, table, customDisplay.

PRÉREQUIS POUR LES WIDGETS AVEC REQUÊTES (tous les types sauf title) :

1. ktm metrics query --operator <op> --query 'SHOW MEASUREMENTS'
2. ktm metrics query --operator <op> --query 'SHOW FIELD KEYS FROM "<measurement>"'
3. Remplir le template measurement et field avec des valeurs RÉELLES issues de ci-dessus. Les placeholders sont REJETÉS.

Le template inclut _metadata avec les contraintes de grille, les étapes de découverte de schéma et (pour customDisplay) la documentation de l'API script avec la référence des props et la structure responseList. Supprimez _metadata avant de soumettre à add-widget.

Les widgets customDisplay utilisent queries[] (PAS series[]), chartOptions (PAS chart_options), et nécessitent un script IIFE. Voir _metadata.notes pour l'API script complète.

LIMITE DE CALCUL : les scripts peuvent faire de la manipulation de données, des calculs, des statistiques simples et de la corrélation. Ils n'ont PAS accès au moteur statistique de la plateforme (EWMA, détection d'anomalies, burn-rate SLO). Ceux-ci nécessitent les outils MCP/CLI ou les agrégations InfluxQL. Ne pré-calculez PAS de valeurs avec les outils CLI pour les coder en dur dans le script : les widgets sont dynamiques et ré-interrogent quand l'utilisateur change la plage temporelle. Les données dynamiques doivent provenir de queries[].

Voir aussi

• ktm dashboards
• ktm metrics query
• ktm metrics

Et ensuite ?