Filtrar registros e criar métricas com base em registros

Depois que os dados do Crashlytics e (opcionalmente) de sessões do Firebase forem exportados para o Cloud Logging, você poderá filtrar seus registros e criar métricas com base em registros. Ambos são úteis para visualizar, usar e analisar dados específicos.

Se ainda não fez isso, confira O que você pode fazer com seus dados? para ver uma lista completa e exemplos de como trabalhar com dados armazenados em Cloud Logging.

Filtrar seus registros com consultas

Filtrar seus registros é útil para visualizar dados específicos e reduzir os custos de armazenamento e análise. Você filtra os registros usando a LQL (linguagem de consulta do Logging).

Para saber como filtrar seus registros com consultas, acesse Amostra de consultas usando Logs Explorer e Como criar consultas de registros. A tabela abaixo descreve os campos disponíveis para essas consultas.

Exemplos de filtros

Para o Crashlytics, veja alguns exemplos de filtros iniciais para uma consulta:

  • Encontrar todas as falhas fatais de uma versão específica do app:

    logName="projects/PROJECT_ID/logs/firebasecrashlytics.googleapis.com%2Fevents"
jsonPayload.issue.errorType="FATAL"
jsonPayload.version.displayVersion="3.2.0"

  • Identifique falhas que ocorrem em um modelo de dispositivo específico (por exemplo, Pixel 6a):

    logName="projects/PROJECT_ID/logs/firebasecrashlytics.googleapis.com%2Fevents"
jsonPayload.device.model="Pixel 6a"

  • Pesquise um OutOfMemoryError específico em todos os eventos fatais:

    logName="projects/PROJECT_ID/logs/firebasecrashlytics.googleapis.com%2Fevents"
jsonPayload.issue.errorType="FATAL"
jsonPayload.issue.subtitle="java.lang.OutOfMemoryError"

  • Encontrar eventos para um ID de problema Crashlytics específico:

    logName="projects/PROJECT_ID/logs/firebasecrashlytics.googleapis.com%2Fevents"
jsonPayload.issue.id="ISSUE_ID"

Esquema de registro

Cada entrada de registro tem uma estrutura predefinida e campos que podem ser consultados (consulte LogEntry).

Saiba mais sobre o esquema de registros para dados exportados, incluindo dados do Crashlytics, dados de sessões do Firebase e registros do dispositivo.

Criar métricas com base em registros

É possível visualizar e criar métricas com base em registros e usá-las no Cloud Monitoring para criar gráficos, painéis e alertas personalizados.

  • Use métricas predefinidas do sistema que são registradas automaticamente, como o número de eventos de registro ocorridos em um período específico.

  • Crie métricas definidas pelo usuário para o projeto. Você pode contar o número de entradas de registro que correspondem a uma determinada consulta ou acompanhar valores específicos com as entradas de registro correspondentes. Você pode filtrar usando expressões regulares. Confira os preços das métricas definidas pelo usuário.

  • Use o Cloud Monitoring para registrar o número de entradas de registro que contêm mensagens específicas ou extrair informações de latência relatadas nas entradas de registro. Você pode usar essas métricas em gráficos e alertas personalizados.

Exemplos de métricas com base em registros

Confira dois exemplos de métricas com base em registros definidas pelo usuário que podem ser criadas com os dados exportados do Crashlytics e de sessões do Firebase:

  • Usando dados de Crashlytics:
    Crie uma métrica chamada firebase/crashlytics_events com um rótulo de errorType e defina-a como:

    logName="projects/PROJECT_ID/logs/firebasecrashlytics.googleapis.com%2Fevents"

  • Usando dados de sessões do Firebase:
    crie uma métrica chamada firebase/session_events com um rótulo de eventType e defina-a como:

    logName="projects/PROJECT_ID/logs/firebasecrashlytics.googleapis.com%2Fsession_events"

A seguir