Trackio documentation
Lancement du tableau de bord
Lancement du tableau de bord
Lancement d'un tableau de bord local
Vous pouvez lancer le tableau de bord en exécutant :
trackio show
import trackio
trackio.show()Charger un projet spécifique
Vous pouvez également fournir un nom de project facultatif en tant qu'argument pour charger directement un projet spécifique :
trackio show --project "my-project"import trackio
trackio.show(project="my-project")Utiliser un frontend personnalisé
Vous pouvez remplacer le tableau de bord intégré par votre propre répertoire de frontend statique. Le répertoire n’a besoin que d’un fichier index.html ; votre frontend peut appeler l’API Trackio existante sous /api/*.
Le flux de travail prévu est le suivant :
- Exécutez
trackio show --frontend ./my-trackio-frontend. - Demandez à votre LLM de modifier les fichiers dans ce répertoire.
- Gardez le navigateur ouvert pendant que Trackio recharge le frontend en direct à mesure que ces fichiers changent.
Si le répertoire passé à --frontend n'existe pas, ou s'il existe mais est vide, Trackio copie automatiquement le frontend de démarrage, affiche un message indiquant qu'il l'a fait, puis sert ce répertoire. Le starter est un modèle complet en HTML/CSS/JS pur : il appelle l'API Trackio, charge les projets et les exécutions, récupère les valeurs des métriques et dessine des graphiques simples que vous pouvez remplacer par votre propre interface utilisateur.
Les points de terminaison HTTP actuellement disponibles sont :
POST /api/get_run_mutation_statusPOST /api/upload_db_to_spacePOST /api/bulk_upload_mediaPOST /api/logPOST /api/bulk_logPOST /api/bulk_log_systemPOST /api/bulk_alertPOST /api/get_alertsPOST /api/get_metric_valuesPOST /api/get_runs_for_projectPOST /api/get_metrics_for_runPOST /api/get_all_projectsPOST /api/get_project_summaryPOST /api/get_run_summaryPOST /api/get_system_metrics_for_runPOST /api/get_system_logsPOST /api/get_system_logs_batchPOST /api/get_snapshotPOST /api/get_logsPOST /api/get_logs_batchPOST /api/get_tracesPOST /api/query_projectPOST /api/get_settingsPOST /api/get_project_filesPOST /api/delete_runPOST /api/rename_runPOST /api/force_syncPOST /api/uploadpour les téléversements de fichiers multipart utilisés par les flux liés aux médias et aux fichiers
Pour lire les fichiers stockés renvoyés par l’API, Trackio sert également GET /file?path=....
trackio show --frontend ./my-trackio-frontend
import trackio
trackio.show(frontend_dir="./my-trackio-frontend")Si le répertoire frontend fourni n'est pas vide mais est invalide, Trackio revient au modèle de démarrage fourni.
Définir un frontend par défaut persistant
Si vous souhaitez que le même frontend personnalisé soit utilisé par défaut par trackio show, trackio sync et les flux de déploiement, enregistrez-le dans la configuration persistante de Trackio :
trackio config set frontend ./my-trackio-frontendRéinitialisez-le avec :
trackio config unset frontendPersonnalisation des couleurs des graphiques
Vous pouvez personnaliser la palette de couleurs utilisée pour les lignes du graphique en fournissant l'argument color_palette. Cela est utile si vous souhaitez correspondre à l'identité visuelle de votre organisation ou si vous avez des préférences de couleurs spécifiques.
trackio show --color-palette "#FF0000,#00FF00,#0000FF"import trackio
trackio.show(color_palette=["#FF0000", "#00FF00", "#0000FF"])Les couleurs seront utilisées en boucle lors de l’affichage de plusieurs exécutions. Vous pouvez fournir autant de couleurs que vous le souhaitez, ou aussi peu.
Activer l’accès à distance
Par défaut, le tableau de bord est lié à 127.0.0.1 (localhost), ce qui signifie qu’il ne peut être accédé que depuis la même machine. Pour autoriser l’accès à distance depuis d’autres machines du réseau, utilisez l’option --host :
trackio show --host 0.0.0.0
import trackio
trackio.show(host="0.0.0.0")Ceci est particulièrement utile lorsque vous exécutez Trackio sur un serveur distant ou dans un environnement conteneurisé où vous devez accéder au tableau de bord depuis une autre machine.
Lancement d'un tableau de bord dans Jupyter Notebooks
Vous pouvez également lancer le tableau de bord directement dans un Jupyter Notebook. Utilisez simplement la même commande que ci-dessus :
import trackio
trackio.show()Consultez le cahier de démonstration.
Update on GitHub