TRL documentation

Coleta de estatísticas de uso

You are viewing v1.18.0 version. A newer version v1.18.1 is available.
Hugging Face's logo
Join the Hugging Face community

and get access to the augmented documentation experience

to get started

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 (por exemplo, llama, qwen3). Arquiteturas personalizadas ou privadas são reportadas como other.
  • 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, 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:

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.

Update on GitHub