# Coleta de estatísticas de uso

O TRL coleta estatísticas de uso anônimas para ajudar os mantenedores a entender quais treinadores, arquiteturas de modelos e configurações de hardware são usados no mundo real. Esses dados informam as decisões de priorização sobre em quais recursos investir e quais descontinuar.

## O que é coletado

Um único ping é enviado cada vez que um trainer é instanciado. O payload contém:

- Versão do TRL (por exemplo, `1.5.0`)
- Nome da classe Trainer, reportado apenas se for um trainer definido pelo TRL (por exemplo, `SFTTrainer`, `GRPOTrainer`). Subclasses personalizadas do usuário são reportadas como `other`.
- Arquitetura do modelo, reportada apenas se for um tipo de modelo conhecido pelo [`transformers`](https://github.com/huggingface/transformers) (por exemplo, `llama`, `qwen3`). Arquiteturas personalizadas ou privadas são reportadas como `other`.
- Se o [PEFT](https://github.com/huggingface/peft) está em uso
- Como o conjunto de dados de treinamento foi carregado: `hub` (baixado do Hub), `files` (lido por meio de um construtor baseado em arquivos, como `json` ou `csv` — isso também abrange repositórios do Hub que contêm arquivos json/csv brutos), `memory` (construído no processo, por exemplo, `Dataset.from_dict`) ou `other`. O nome e o caminho do conjunto de dados nunca são coletados.
- Backend distribuído (`deepspeed`, `fsdp`, `ddp` ou `none`)
- Tamanho do mundo, em intervalos (`1`, `2-8`, `9-64`, `65+`)
- Tipo de acelerador (`cuda`, `xpu`, `npu`, `mlu`, `mps`, `cpu`)
- Nome do modelo de GPU (por exemplo, `NVIDIA H100 80GB HBM3`), quando disponível

Nos nomes de datasets, caminhos de arquivos, identificadores de modelos, valores de hiperparâmetros ou qualquer outro dado fornecido pelo usuário não são coletados. Como em qualquer solicitação HTTP, o IP de origem e os cabeçalhos HTTP padrão são visíveis para o servidor.

A telemetria não é enviada em ambientes de CI (ou seja, quando a variável de ambiente `CI` está definida), nem no modo offline.

## Como desativar

Defina uma das seguintes variáveis de ambiente para desativar a telemetria:

```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
```

## Por que isso ajuda

Sem dados de uso, os mantenedores não têm como saber quais partes da biblioteca são importantes para os usuários. A telemetria nos permite responder a perguntas como:

- Quais treinadores são amplamente adotados e quais podem ser descontinuados com segurança?
- Quais arquiteturas de modelos são mais frequentemente ajustadas com TRL, para que possamos priorizar seu suporte?
- Quais configurações de hardware os usuários estão utilizando, para que possamos testar e otimizar para elas?

Se você acha que o TRL é útil, deixar a telemetria ativada é uma forma de baixo custo de nos ajudar a melhorá-lo.

