Monitorar atributos personalizados

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

O Monitoramento de desempenho fornece vários atributos padrão:

  • Para apps iOS e Android, os atributos padrão incluem versão do app, país, informações do sistema operacional, dispositivo, rádio e operadora.

  • Para apps da Web, os atributos padrão incluem navegador, país, tipo de conexão vigente, URL da página, status do service worker e estado de visibilidade.

Além desses atributos padrão, você também pode criar atributos personalizados nos traces personalizados para segmentar os dados por categorias específicas do seu app. Por exemplo, em um jogo, os dados podem ser segmentados por fase de jogo.

Como coletar dados do usuário

Criar atributos personalizados

Você pode usar atributos personalizados em traces específicos. Assim, é possível usá-los como filtros para seus dados de desempenho no Console do Firebase.

Para usar atributos personalizados, adicione código ao seu app definindo o atributo e aplicando-o a um trace específico. É possível defini-lo a qualquer momento entre o início e a interrupção do trace.

Observações:

  • A limitação é de cinco atributos personalizados por trace.

  • Os nomes dos atributos personalizados precisam atender aos seguintes requisitos: nenhum espaço em branco no início ou no final, nenhum caractere inicial de sublinhado (_) e comprimento máximo de 32 caracteres.

Swift

var trace = Performance.sharedInstance().trace(name:"myTrace")
trace.setValue("A", forAttribute: "experiment")

// Update scenario.
trace.setValue("B", forAttribute: "experiment")

// Reading scenario.
let experimentValue:String? = trace.valueForAttribute("experiment")

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

// Read attributes.
let attributes:[String, String] = trace.attributes;

Objective-C

FIRTrace *trace = [[FIRPerformance sharedInstance] traceWithName:@"myTrace"];
[trace setValue:@"A" forAttribute:@"experiment"];

// Update scenario.
[trace setValue:@"B" forAttribute:@"experiment"];

// Reading scenario.
NSString *experimentValue = [trace valueForAttribute:@"experiment"];

// Delete scenario.
[trace removeAttribute:@"experiment"];

// Read attributes.
NSDictionary <NSString *, NSString *> *attributes = [trace attributes];

Java

Trace trace = FirebasePerformance.getInstance().newTrace("test_trace");

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

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

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

// Read attributes.
Map<String, String> traceAttributes = trace.getAttributes();

Kotlin+KTX

val trace = FirebasePerformance.getInstance().newTrace("test_trace")

// Update scenario.
trace.putAttribute("experiment", "A")

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

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

// Read attributes.
val traceAttributes = trace.attributes

Web

const trace = performance.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();

Monitorar atributos personalizados

  1. No Console do Firebase, acesse o painel Desempenho.

  2. Clique na guia Traces.

  3. Cada um dos seus atributos personalizados tem um cartão que mostra os dados de desempenho desse segmento. Também é possível filtrar por atributos do cliente.