Pular para o conteúdo principal
Página não listada
Esta página não está listada. Mecanismos de busca não armazenarão nenhuma informação, e somente usuários que possuam o link direto poderão acessá-la
Última atualização em

What is App Analítica?

info

Visualização

Esse recurso está na Prévia privada. Para testar, entre em contato com seu ponto de contato do Databricks.

App Analytics helps app owners understand which pages people visit, which actions they take, and how the app performs in their browsers. Use the Analítica page for your Databricks app to explore usage, investigate browser desempenho, and inspect recent events.

O dashboard combina eventos que seu aplicativo envia com informações de acesso ao aplicativo coletadas pelo Databricks. Você não precisa de uma biblioteca de cliente específica para enviar eventos de analítica. Qualquer produtor que siga o esquema de eventos pode fornecê-los.

Requisitos​

Acesso à analítica de aplicativos e configuração de telemetria têm requisitos separados.

Configurar telemetria​

Enable app telemetry and redeploy the app before sending analíticas events. For supported regions, destination-table requirements, and configuration permissions, see Requirements and Enable app telemetry.

A telemetria cria ou reutiliza a tabela otel_logs no catálogo e no esquema selecionados. Se você configurar um prefixo de tabela, use a tabela <prefix>_otel_logs correspondente.

Ver analítica​

The person opening Analytics must have the following access:

  • CAN MANAGE no aplicativo.
  • USE CATALOG no catálogo, USE SCHEMA no esquema e SELECT na tabela de Logs de telemetria.
  • Acesso SQL e CAN USE no SQL warehouse usado para query a tabela.

O acesso ao aplicativo não concede automaticamente acesso à tabela de telemetria ou ao warehouse. Consulte Configurar permissões para um Databricks app.

Open analítica and complete setup​

  1. Abra a página de detalhes do seu aplicativo.
  2. Selecione Analítica na navegação do aplicativo.
  3. Selecione um SQL warehouse para query a tabela de telemetria.
  4. Se a configuração estiver incompleta, siga a página de integração para configurar a telemetria, enviar eventos e verificar se os eventos chegaram. Consulte Começar com a analítica de App.

A analítica exibe uma página de permissão dedicada quando não é possível acessar o aplicativo ou suas fontes de dados. Siga as orientações para o recurso que precisa de acesso. Dependendo da permissão ausente, solicite acesso à tabela ou copie a solicitação de acesso para o proprietário do recurso. Após a concessão do acesso, verifique novamente. Um erro de permissão não significa que você precise configurar a telemetria novamente.

A página de integração e a página de permissão abordam condições diferentes. A integração ajuda você a configurar a telemetria e a receber seus primeiros eventos. A página de permissão ajuda você a obter acesso a recursos que já podem estar configurados.

Explore o dashboard​

Selecione um intervalo de tempo e um warehouse para sua análise. As tabs Visão geral e Web Vitals mostram data histórica do intervalo selecionado. Use o refresh para recuperar resultados atualizados.

Overview​

A tab Visão geral mostra exibições de página, sessões, ações rastreadas, páginas por sessão e visualizadores únicos. Ele também mostra o tráfego ao longo do tempo, páginas visitadas com frequência e ações registradas com frequência.

A captura de tela a seguir mostra Top pages e Top actions , incluindo a ação Analyze .

Top pages and Top actions in Analytics, with an Analyze link beside each recorded action.

As sessões e os visualizadores únicos medem coisas diferentes:

  • Sessions : janelas de atividade de analítica identificadas por session_id. Uma sessão não é uma pessoa. O esquema de eventos torna session_id opcional. A análise baseada em sessões depende do fornecimento por parte dos produtores.
  • Visualizadores únicos : Informações de visualizadores dos logs de acesso do aplicativo, separados do esquema de eventos de analítica personalizado. O envio de eventos de analítica não cria uma identidade de usuário.

Para uma ação rastreada, selecione Analyze para inspecionar seu volume, sessões, rotas e ações associadas. Quando o Genie Code estiver disponível, use a transferência para continuar investigando. Revise o prompt preparado no Genie Code antes de enviá-lo.

Web Vitals​

A Web Vitals tab exibe medições de desempenho do navegador, distribuições de classificação, tendências e resultados em nível de rota. Selecione uma métrica para inspecionar seus limites e tamanho da amostra.

O percentil default é o 75º percentil (p75): 75% das amostras têm um valor igual ou abaixo dele. Você também pode selecionar p50, p90 ou p99 na view de detalhes de métrica.

A captura de tela a seguir mostra a view de detalhes do Largest Contentful Paint (LCP).

Detalhe do Largest Contentful Paint mostrando o percentil selecionado, a contagem de amostras, a classificação e os limites.

As Core Web Vitals são LCP, Interaction to Next Paint (INP) e Cumulative Layout Shift (CLS). A página também inclui First Contentful Paint (FCP) e Time to First Byte (TTFB). Consulte Web Vital rules.

Trate os resultados baseados em menos de 30 amostras como indicativos. Um valor exibido não estabelece uma tendência confiável.

Live Events​

A guia Live Events recupera periodicamente eventos recentes. Use seus filtros para inspecionar tipos, nomes e rotas de eventos, e abra um evento para visualizar seus detalhes.

Esta view usa um buffer de eventos delimitado. Não é uma exportação exaustiva da tabela de telemetria. Para análises históricas além dos eventos exibidos, query a tabela diretamente.

Coletar eventos de analítica​

Seu aplicativo deve enviar os seguintes tipos de evento para popular a análise de uso e de desempenho do navegador:

Tipo de evento

O que ele registra

action

Uma interação ou resultado nomeado, como uma exportação de relatório.

page_view

Uma visita a uma rota de aplicativo.

web_vital

Uma medição de desempenho do navegador.

Tipo de evento

O que ele registra

action

Uma interação ou resultado nomeado, como uma exportação de relatório.

page_view

Uma visita a uma rota de aplicativo.

web_vital

Uma medição de desempenho do navegador.

A ativação de telemetria não instrumenta automaticamente as rotas do aplicativo ou as ações de negócios. Adicione instrumentação ou use um produtor que implemente o esquema de eventos. Consulte Comece com a analítica de aplicativos.

O diagrama a seguir mostra o caminho para eventos de analítica gerados por aplicativos. A informação do visualizador usa uma fonte de acesso a aplicativos separada.

O fluxo de eventos de analítica vai do navegador, passa pelo backend do aplicativo e pelo coletor, até o Unity Catalog e o dashboard.

  1. O navegador envia um evento para o backend do seu aplicativo.
  2. O back-end exporta um registro de log do OpenTelemetry (OTel) para o coletor em execução junto ao aplicativo.
  3. O coletor grava o registro em otel_logs no Unity Catalog.
  4. O Analytics consulta a tabela usando um SQL warehouse.

Use o Endpoint e o transporte suportados pelo seu Runtime de aplicativos. Não exponha o coletor diretamente aos navegadores. Para obter as variáveis de ambiente injetadas, consulte Variáveis de ambiente de telemetria do App.

Limitações e tratamento de dados​

Os eventos de analítica dão suporte à análise de produtos. Eles não são registros de transações oficiais nem logs de auditoria de segurança. A entrega é feita com base no melhor esforço, portanto, os eventos podem ser perdidos ou entregues mais de uma vez.

Sanitizar nomes de eventos, caminhos e propriedades antes de enviá-los. Não inclua credenciais, dados pessoais ou texto inserido pelo usuário. A filtragem no lado da query não remove dados confidenciais que um produtor já tenha gravado na tabela de telemetria subjacente.

Telemetry ingestion and SQL warehouse queries use platform recursos. For telemetry billing details, see preços.

Outros recursos​

Nesta página