Télémétrie

Les commandes instrumentées de mistral envoient par défaut des statistiques d'utilisation du produit, notamment les commandes d'apps et les commandes principales init, dev et deploy. Chacune enregistre un événement à son démarrage et un autre à sa fin.

Chaque événement enregistre la commande, par exemple apps.deploy, la version de la CLI, l'identifiant de l'app quand la commande s'exécute dans une app, et un identifiant aléatoire pour l'exécution. L'événement de fin ajoute la durée, le résultat (success, error ou cancelled) et, en cas d'échec, un type d'erreur.

Les événements sont envoyés avec l'identifiant d'authentification utilisé par la commande, votre clé API ou votre connexion : Mistral les rattache ainsi à votre compte, à votre organisation et à votre espace de travail. La CLI n'enregistre jamais votre code, le contenu ou le chemin de vos fichiers, vos variables d'environnement, les URL de registre ni vos identifiants.

init, apps init, workflows init, ainsi que apps capability add, select et remove, enregistrent aussi les capacités de l'app après la commande, celles ajoutées et retirées et, sauf pour remove, celles demandées. Les capacités du registre officiel de Mistral sont enregistrées sous la forme kind/id, par exemple backend/workflows. Les autres capacités sont seulement comptées. Quand une commande échoue, ces champs décrivent la modification tentée. Les confirmations refusées et les commandes qui ne modifient rien n'enregistrent aucun de ces champs.

init, apps init et workflows init enregistrent aussi laquelle des trois commandes s'est exécutée et comment les capacités ont été choisies :

Les événements sont conservés dans un fichier telemetry-outbox.json de taille limitée, situé dans le répertoire de configuration de la CLI, et envoyés à https://api.mistral.ai/v1/datalake/events pendant la commande et à sa fin, avec une attente d'au plus 3 secondes à la sortie. Une commande sans identifiant d'authentification laisse ses événements à une commande ultérieure. La boîte d'envoi conserve au maximum 100 événements ou 1 Mio et supprime les événements au bout de sept jours. Les identifiants d'authentification ne sont jamais écrits dans la boîte d'envoi.

Les échecs de télémétrie ne modifient pas le résultat de la commande. Les événements qui ne peuvent pas être transmis restent dans la boîte d'envoi en attendant qu'une commande ultérieure retente leur envoi, dans la limite de sa taille et de sa durée de rétention.

Pour vous désabonner au niveau d'un processus ou d'un environnement donné, affectez une valeur non vide à l'une des variables d'environnement prises en charge :

export MISTRAL_TELEMETRY_OPT_OUT=1
# Or use the standard convention:
export DO_NOT_TRACK=1

export MISTRAL_TELEMETRY_OPT_OUT=1
# Or use the standard convention:
export DO_NOT_TRACK=1

Pour un désabonnement permanent, ajoutez telemetryOptOut à config.json :

{
  "telemetryOptOut": true
}

{
  "telemetryOptOut": true
}

Se désabonner interrompt la collecte de nouvelles données de télémétrie et supprime les événements en attente lors de la prochaine exécution d'une commande instrumentée.

Pour désactiver toutes les requêtes sortantes automatiques, en plus de celles requises par la commande elle-même, définissez :

export MISTRAL_DISABLE_FLAG_REFRESH=1
export MISTRAL_DISABLE_UPDATE_CHECK=1
export MISTRAL_TELEMETRY_OPT_OUT=1

export MISTRAL_DISABLE_FLAG_REFRESH=1
export MISTRAL_DISABLE_UPDATE_CHECK=1
export MISTRAL_TELEMETRY_OPT_OUT=1

MISTRAL_DISABLE_FLAG_REFRESH désactive l'actualisation automatique de la disponibilité des fonctionnalités, MISTRAL_DISABLE_UPDATE_CHECK désactive la vérification des versions GitHub et MISTRAL_TELEMETRY_OPT_OUT (ou DO_NOT_TRACK) désactive les statistiques d'utilisation du produit.