O que é App Analytics?

Importante

Esta funcionalidade está em Pré-visualização Privada. Para experimentar, contacte o seu contacto do Azure Databricks.

A Análise de Aplicações ajuda os proprietários de aplicações a perceber que páginas as pessoas visitam, que ações tomam e como a aplicação se comporta nos seus navegadores. Use a página de Análise da sua aplicação Databricks para explorar o uso, investigar o desempenho do navegador e inspecionar eventos recentes.

O painel combina eventos que a sua aplicação envia com a informação de acesso à aplicação recolhida pelo Azure Databricks. Não precisas de uma biblioteca cliente específica para enviar eventos analíticos. Qualquer produtor que siga o esquema de eventos pode fornecê-los.

Requisitos

O acesso à App Analytics e a configuração de telemetria têm requisitos separados.

Configurar telemetria

Ativa a telemetria da aplicação e reimplementa a aplicação antes de enviar eventos analíticos. Para regiões suportadas, requisitos da tabela de destino e permissões de configuração, consulte Requisitos e Ativar telemetria da aplicação.

A telemetria cria ou reutiliza a tabela otel_logs no catálogo e no esquema que selecionar. Se configurares um prefixo de tabela, usa a tabela correspondente <prefix>_otel_logs .

Ver análise

A pessoa que abre Analytics deve ter o seguinte acesso:

  • CAN MANAGE na aplicação.
  • USE CATALOG no catálogo, USE SCHEMA no esquema e SELECT na tabela de registos de telemetria.
  • Acesso SQL e CAN USE no armazém de dados SQL utilizado para consultar a tabela.

O acesso à aplicação não concede automaticamente acesso à respetiva tabela de telemetria nem ao respetivo armazém de dados. Consulte Configurar permissões para um aplicativo Databricks.

Análise Aberta e configuração completa

  1. Abra a página de detalhes da sua aplicação.
  2. Selecione Análise na navegação da aplicação.
  3. Selecione um armazenamento SQL para consultar 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. Veja Comece com App Analytics.

As análises mostram uma página de permissões dedicada quando não consegues aceder à aplicação ou às suas fontes de dados. Siga as orientações do recurso que necessita de acesso. Dependendo da permissão em falta, solicite acesso à tabela ou copie o pedido de acesso para o proprietário do recurso. Depois de conceder o acesso, verifique novamente. Um erro de permissão não significa que precises de configurar a telemetria novamente.

A página de integração e a página de permissão abordam condições diferentes. O onboarding ajuda a configurar a telemetria e a receber os primeiros eventos. A página de permissões ajuda-te a obter acesso a recursos que possam já estar configurados.

Explore o painel de controlo

Selecione um intervalo temporal e um armazém para a sua pesquisa. Os separadores Descrição geral e Web Vitals mostram dados históricos para o intervalo selecionado. Utilize Atualizar para obter os resultados atualizados.

Descrição geral

O separador Descrição geral mostra visualizações de página, sessões, ações monitorizadas, páginas por sessão e visitantes únicos. Também mostra o tráfego ao longo do tempo, páginas frequentemente visitadas e ações registadas frequentemente.

A captura de ecrã seguinte mostra as principais páginas e ações principais, incluindo a ação Analisar .

Páginas principais e ações principais em Analytics, com um link para Analisar ao lado de cada ação registada.

As sessões e os espectadores únicos medem métricas diferentes:

  • Sessões: Janelas de atividade 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 dos produtores que a fornecem.
  • Espectadores únicos: Informações dos espectadores provenientes dos registos de acesso da aplicação, separadas do esquema personalizado de eventos de análise. Enviar eventos analíticos não cria uma identidade de utilizador.

Para uma ação rastreada, selecione Analisar para inspecionar o seu volume, sessões, rotas e ações circundantes. Quando o Genie Code estiver disponível, use a passagem para continuar a investigação. Revise o enunciado preparado no Código Genie antes de o submeter.

Web Vitals

O separador Web Vitals mostra medições de desempenho do navegador, distribuições de classificações, tendências e resultados ao nível da rota. Selecione uma métrica para inspecionar os seus limiares e o tamanho da amostra.

O percentil padrão é o 75.º percentil (p75): 75% das amostras têm um valor igual ou inferior. Também pode selecionar p50, p90 ou p99 na vista detalhada da métrica.

A captura de ecrã seguinte mostra a vista detalhada de Largest Contentful Paint (LCP).

Detalhe de Largest Contentful Paint que mostra o percentil selecionado, a contagem de amostras, a avaliação e os limiares.

Os Core Web Vitals são LCP, Interação com a Próxima Pintura (INP) e Mudança de Layout Cumulativa (CLS). A página inclui também First Contentful Paint (FCP) e Time to First Byte (TTFB). Consulte as regras Web Vital.

Trate os resultados com base em menos de 30 amostras como indicativos. Um valor apresentado não estabelece uma tendência fiável.

Eventos em Direto

O separador Eventos ao Vivo recupera periodicamente eventos recentes. Use os seus filtros para inspecionar tipos de eventos, nomes e rotas, e abra um evento para visualizar os seus detalhes.

Esta vista utiliza um buffer de eventos limitado. Não é uma exportação exaustiva da tabela de telemetria. Para análise histórica para além dos eventos apresentados, consulta diretamente a tabela.

Recolha de eventos analíticos

A sua aplicação deve enviar os seguintes tipos de eventos para preencher a análise de utilização e desempenho do navegador:

Tipo de evento O que regista
action Uma interação ou resultado nomeado, como uma exportação de relatório.
page_view Uma visita a uma rota de candidatura.
web_vital Uma medição de desempenho do navegador.

Ativar a telemetria não instrumenta automaticamente as rotas ou ações de negócio da sua aplicação. Adicione instrumentação ou use um produtor que implemente o esquema do evento. Veja Comece com App Analytics.

O diagrama seguinte mostra o percurso para eventos analíticos gerados por aplicações. A informação do visualizador utiliza uma fonte separada de acesso à aplicação.

Fluxo de eventos analíticos do navegador através do backend da aplicação e do coletor até ao Unity Catalog e ao dashboard.

  1. O navegador envia um evento para o backend da tua aplicação.
  2. O backend exporta um registo de log OpenTelemetry (OTel) para o coletor em execução juntamente com a aplicação.
  3. O coletor escreve o registo em otel_logs no Unity Catalog.
  4. A Analytics consulta a tabela usando um SQL warehouse.

Utilize o endpoint e o transporte suportados pelo ambiente de execução da sua aplicação. Não exponhas o coletor diretamente aos navegadores. Para as variáveis de ambiente injetadas, veja Variáveis de ambiente de telemetria de aplicação.

Limitações e tratamento de dados

Eventos de análise de dados apoiam a análise de produtos. Não são registos de transações autoritativos nem registos de auditoria de segurança. A entrega é o melhor esforço, para que os eventos possam ser perdidos ou entregues mais do que uma vez.

Limpe nomes de eventos, caminhos e propriedades antes de os enviar. Não inclua credenciais, dados pessoais ou texto introduzido pelo utilizador. A filtragem do lado da consulta não remove dados sensíveis que um produtor já tenha escrito na tabela de telemetria subjacente.

A ingestão de telemetria e as consultas SQL warehouse utilizam recursos da plataforma. Para detalhes de faturação por telemetria, consulte Preços.

Recursos adicionais

  • Última atualização a