# Collecte des statistiques d'utilisation

TRL collecte des statistiques d'utilisation anonymes afin d'aider les mainteneurs à comprendre quels formateurs, quelles architectures de modèles et quelles configurations matérielles sont utilisés dans la pratique. Ces données guident les décisions de priorisation concernant les fonctionnalités à développer et celles à déprécier.

## Ce qui est collecté

Un seul ping est envoyé à chaque fois qu'un formateur est instancié. La charge utile contient :

- Version de TRL (par exemple `1.5.0`)
- Nom de la classe Trainer, signalé uniquement s'il s'agit d'un trainer défini par TRL (par exemple `SFTTrainer`, `GRPOTrainer`). Les sous-classes personnalisées de l'utilisateur sont signalées comme `other`.
- Architecture du modèle, signalée uniquement s'il s'agit d'un type de modèle connu de [`transformers`](https://github.com/huggingface/transformers) (par exemple `llama`, `qwen3`). Les architectures personnalisées ou privées sont signalées comme `other`.
- Si [PEFT](https://github.com/huggingface/peft) est utilisé
- Comment le jeu de données d’entraînement a été chargé : `hub` (téléchargé depuis le Hub), `files` (lu via un constructeur basé sur des fichiers tel que `json` ou `csv` — cela couvre également les dépôts du Hub contenant des fichiers json/csv bruts), `memory` (construit dans le processus, par exemple `Dataset.from_dict`) ou `other`. Le nom et le chemin du jeu de données ne sont jamais collectés.
- Backend distribué (`deepspeed`, `fsdp`, `ddp` ou `none`)
- Taille du monde, par paliers (`1`, `2-8`, `9-64`, `65+`)
- Type d'accélérateur (`cuda`, `xpu`, `npu`, `mlu`, `mps`, `cpu`)
- Nom du modèle de GPU (par exemple `NVIDIA H100 80GB HBM3`), si disponible

Aucun nom de jeu de données, chemin de fichier, identifiant de modèle, valeur d'hyperparamètre ou autre donnée fournie par l'utilisateur n'est collecté. Comme pour toute requête HTTP, l'adresse IP source et les en-têtes HTTP standard sont visibles par le serveur.

La télémétrie n'est pas envoyée dans les environnements CI (c'est-à-dire lorsque la variable d'environnement `CI` est définie), ni en mode hors ligne.

## Comment se désinscrire

Définissez l'une des variables d'environnement suivantes pour désactiver la télémétrie :

```bash
export HF_HUB_DISABLE_TELEMETRY=1   # disables telemetry for all HF libraries
export HF_HUB_OFFLINE=1             # disables all network calls to the Hub
```

## Pourquoi cela est utile

Sans données d’utilisation, les mainteneurs n’ont aucun moyen de savoir quelles parties de la bibliothèque sont importantes pour les utilisateurs. La télémétrie nous permet de répondre à des questions telles que :

- Quels formateurs sont largement adoptés et lesquels peuvent être dépréciés en toute sécurité ?
- Quelles architectures de modèles sont le plus souvent affinées avec TRL, afin que nous puissions prioriser leur prise en charge ?
- Quelles configurations matérielles les utilisateurs utilisent-ils, afin que nous puissions les tester et les optimiser ?

Si vous trouvez TRL utile, laisser la télémétrie activée est un moyen peu coûteux de nous aider à l'améliorer.

