TRL documentation
Coleta de estatísticas de uso
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 comoother. - Arquitetura do modelo, reportada apenas se for um tipo de modelo conhecido pelo
transformers(por exemplo,llama,qwen3). Arquiteturas personalizadas ou privadas são reportadas comoother. - Se o 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, comojsonoucsv— 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) ouother. O nome e o caminho do conjunto de dados nunca são coletados. - Backend distribuído (
deepspeed,fsdp,ddpounone) - 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:
export HF_HUB_DISABLE_TELEMETRY=1 # disables telemetry for all HF libraries
export HF_HUB_OFFLINE=1 # disables all network calls to the HubPor 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.
Update on GitHub