Filtrar dados usando atributos

No Monitoramento de desempenho, é possível usar atributos para segmentar dados de desempenho e se concentrar na atividade do seu app em diferentes cenários reais.

Depois de clicar no nome de um trace na tabela de traces (na parte inferior do painel Desempenho), é possível clicar em várias telas para conhecer mais um trace e detalhar as métricas de interesse. Na maioria das páginas, também é possível usar o botão Filtrar (no canto superior à esquerda da tela) para filtrar os dados por atributo. Por exemplo:

Uma imagem dos dados do Monitoramento de desempenho do Firebase sendo filtrada por atributos

Filtre por URL da página para visualizar dados de uma página específica do site.
Filtre por Tipo de conexão vigente para saber como uma conexão 3G afeta o app.
Filtre por País para garantir que o local do banco de dados não está afetando uma região específica.

Atributos padrão

O Monitoramento de desempenho coleta automaticamente uma variedade de atributos padrão, dependendo do tipo de trace.

Além desses atributos padrão, é possível criar atributos personalizados nos traces de código personalizado para segmentar dados por categorias específicas no app. Por exemplo, em um jogo, é possível segmentar os dados por fase.

Atributos padrão coletados para apps da Web

Por padrão, todos os traces para apps da Web coletam os seguintes atributos:

Navegador
País
Tipo de conexão vigente
URL da página
Status de service worker
Estado de visibilidade

Como coletar dados do usuário

Coleta de dados do usuário: o Monitoramento de desempenho não coleta informações de identificação pessoal (PII) como nomes, endereços de e-mail ou números de telefone. Os desenvolvedores podem coletar dados extras usando o Monitoramento de desempenho ao criar atributos personalizados em traces de código personalizados. Esses dados não devem conter informações que identifiquem um indivíduo para o Google.

Veja um exemplo de mensagem de registro que não contém informações de identificação pessoal:

trace.putAttribute("experiment", "A");

Veja um exemplo que contém informações de identificação pessoal (não use este tipo de atributo personalizado no app):

trace.putAttribute("email", user.getEmailAddress());

Os dados que expõem informações de identificação pessoal estão sujeitos a exclusão sem aviso prévio.

Criar atributos personalizados

Crie atributos personalizados em qualquer um dos traces de código personalizado instrumentados.

Use a API Trace do Monitoramento de desempenho para adicionar atributos personalizados aos traces de código personalizados.

Para usar atributos personalizados, adicione códigos ao app que definam o atributo e o associem a um trace de código personalizado específico. É possível definir o atributo personalizado a qualquer momento entre o início e a interrupção do trace.

Observações:

Os nomes dos atributos personalizados precisam atender aos seguintes requisitos: não ter espaço em branco no início ou no fim, não ter caractere sublinhado no início (_) e ter, no máximo, 32 caracteres.
Cada trace de código personalizado pode registrar até cinco atributos personalizados.
Não use atributos personalizados que contenham informações que identifiquem um indivíduo para o Google.
Saiba mais sobre essa diretriz
Coleta de dados do usuário: o Monitoramento de desempenho não coleta informações de identificação pessoal (PII) como nomes, endereços de e-mail ou números de telefone. Os desenvolvedores podem coletar dados extras usando o Monitoramento de desempenho ao criar atributos personalizados em traces de código personalizados. Esses dados não devem conter informações que identifiquem um indivíduo para o Google.

Veja um exemplo de mensagem de registro que não contém informações de identificação pessoal:
```
trace.putAttribute("experiment", "A");
```
Veja um exemplo que contém informações de identificação pessoal (não use este tipo de atributo personalizado no app):
```
trace.putAttribute("email", user.getEmailAddress());
```
Os dados que expõem informações de identificação pessoal estão sujeitos a exclusão sem aviso prévio.

Versão 9 para a Web

import { trace } from "firebase/performance";

const t = trace(perf, "test_trace");
t.putAttribute("experiment", "A");

// Update scenario
t.putAttribute("experiment", "B");

// Reading scenario
const experimentValue = t.getAttribute("experiment");

// Delete scenario
t.removeAttribute("experiment");

// Read attributes
const traceAttributes = t.getAttributes();perf_add_custom_attributes.js

Versão 8 para a Web

const trace = perf.trace("test_trace");
trace.putAttribute("experiment", "A");

// Update scenario
trace.putAttribute("experiment", "B");

// Reading scenario
const experimentValue = trace.getAttribute("experiment");

// Delete scenario
trace.removeAttribute("experiment");

// Read attributes
const traceAttributes = trace.getAttributes();index.js