Relatórios de uso
Os Relatórios de uso mostram quem usa o quê no seu espaço de trabalho: quais telas, painéis, aplicativos e notebooks os membros abrem, quantos membros voltam e para onde vão em seguida. Use-os para ver o que seus membros adotam, quais painéis e aplicativos justificam o investimento e em que ponto as pessoas abandonam um processo.
Abra-os em Relatórios de uso, em Insights, na barra lateral da guia Identidade. Eles abrem como uma página dentro de Identidade, ao lado da barra lateral, e não em uma janela separada.
Quem pode ver
Seção intitulada “Quem pode ver”Os Relatórios de uso exigem a mesma permissão que o Log de segurança: identity.security_log.read. Sem ela, o item da barra lateral não é exibido, e um membro que abrir o relatório mesmo assim vê um aviso de que não tem acesso.
Os relatórios mostram o uso por membro nestes lugares: a guia Membros, as listas de membros que você abre a partir de Conteúdo e Visão geral, e as exportações Atividade diária por membro e Primeiro uso, que incluem IDs de membros. Todo o resto é contado de forma agregada entre os membros. Conceda a permissão apenas a quem deve ver a atividade individual. A abertura do uso de um membro é, em si, registrada; consulte Privacidade e auditoria.
O que é contado
Seção intitulada “O que é contado”Os Relatórios de uso combinam cinco áreas. Escolha uma em Área ou deixe em Todas as áreas.
| Área | O que é registrado |
|---|---|
| Aplicativo PlaidCloud | As telas que os membros abrem e as ações que realizam no aplicativo. |
| Painéis | Visualizações de painéis e gráficos. |
| Aplicativos | Visitas aos aplicativos e o tempo que os membros passam em cada um. |
| Servidores de notebook | Tempo que os membros passam em sessões de servidor de notebook. |
| Notebooks | Os notebooks que os membros abrem e salvam. |
Servidores de notebook e notebooks são áreas separadas, então você pode escolher qualquer uma delas. Aplicativos são uma área única. Os eventos de notebook são registrados somente para notebooks executados na imagem de notebook padrão. Uma imagem personalizada não os informa.
Eventos e áreas aparecem com nomes legíveis, como Notebook aberto, Aplicativo de servidor visitado e Aplicativo de navegador visitado, e não como códigos internos. As visitas a apps Dash e a apps WASM aparecem como Visitas a apps na coluna Área. Escolher Aplicativos em Área os exclui; deixe Área em Todas as áreas para incluí-los. Um painel ou aplicativo que foi excluído depois aparece como Painel excluído ou App excluído.
Ler os relatórios
Seção intitulada “Ler os relatórios”A barra na parte superior da página contém os filtros. Cada guia é carregada quando você a abre pela primeira vez e novamente quando você muda um filtro.
| Filtro | O que faz |
|---|---|
| Área | Limita o relatório a uma área. Fica oculto em Funil, que escolhe uma área para cada etapa, e em Exportações, que tem a própria escolha. |
| Grupo | Limita o relatório aos membros de um grupo de segurança. Consulte Restringir a um grupo. |
| Intervalo de datas | Últimos 7 dias, Últimos 30 dias, Últimos 90 dias, Últimos 180 dias, Este mês, Mês anterior ou Personalizado… para uma data inicial e final de até 180 dias. |
| Atualizar | Carrega os números novamente (F5). Atualizado mostra quando foram carregados pela última vez. |
O intervalo de datas é compartilhado por todas as guias, e a guia em que você estava e o intervalo que escolheu são salvos nas configurações da sua conta, então a página reabre onde você a deixou em qualquer computador. Mudar o intervalo recarrega a guia em que você está e as demais guias quando você as abre. Cada guia tem as próprias explicações: aponte para um título ou número para ler o que ele significa.
Enquanto uma guia carrega, você vê um indicador de carregamento em vez de uma página em branco. Se um relatório não puder ser carregado, a guia mostra o motivo com Tentar novamente e Copiar detalhes. Quando um intervalo não tem atividade, a guia sugere tentar um intervalo maior. Para abrir uma linha, clique duas vezes nela ou selecione-a e pressione Enter. Voltar retorna do item aberto para a lista.
Visão geral
Seção intitulada “Visão geral”Os números principais do intervalo, cada um com uma seta e uma porcentagem que mostram a variação em relação ao período anterior de mesma duração:
| Número | Significado |
|---|---|
| Membros ativos | Membros com qualquer atividade. |
| Novos membros | Membros vistos pela primeira vez no intervalo. Aparece como um traço quando o intervalo começa antes do início da coleta, porque não é possível saber os primeiros usos anteriores. |
| Membros recorrentes | Membros ativos que foram vistos pela primeira vez antes do intervalo. |
| Minutos de atividade | Estimado: cinco minutos para cada período de cinco minutos com qualquer ação ou visualização. |
| Minutos de aplicativo aberto | Tempo em que aplicativos e servidores de notebook ficaram abertos, incluindo o tempo ocioso. Contado separadamente dos minutos de atividade. |
| Eventos | Tudo o que foi registrado. |
Os eventos que não podem ser associados a um membro são contados separadamente, em uma linha abaixo dos números. Eles contam como eventos, não como membros.
Destaques lista até quatro itens que merecem atenção, cada um com um link para onde você pode ver mais:
- Uma alta ou queda de 10% ou mais nos membros ativos em comparação com o período anterior.
- O número de membros que não estiveram ativos no intervalo. Selecione-o para abrir a lista de membros inativos.
- O número de painéis e aplicativos que ninguém abriu. Selecione-o para abrir Conteúdo com os não utilizados primeiro.
- O item mais usado, quando pelo menos cinco membros o usaram.
Um destaque só aparece quando tem algo a dizer. Quando o PlaidCloud não consegue calcular uma contagem, o destaque fica oculto em vez de mostrar 0, e, se nada se sobressair, você vê Nenhuma mudança relevante neste intervalo.
Mais usados lista cada tela, painel, gráfico ou item com a respectiva área, evento, número de membros e Alcance, a parcela dos membros ativos que o usaram no intervalo. O seletor de colunas adiciona Eventos e Eventos não vinculados a um membro. Por mês (todo o histórico) mostra os membros ativos, a média de membros diários e a Fidelização (usuários diários/mensais) de cada mês, com uma observação quando o mês ainda está em andamento ou só foi coberto em parte. A fidelização é a média de membros ativos por dia dividida pelos membros ativos no mês, então um valor maior significa que as pessoas voltam em mais dias.
Atividade
Seção intitulada “Atividade”Membros ativos por período Diário, Semanal ou Mensal, além de Retenção por primeira semana: para cada semana em que membros apareceram pela primeira vez, o Tamanho da coorte e a parcela desses membros ainda ativos em cada semana seguinte. Um período marcado com asterisco não está inteiramente dentro do intervalo.
Caminhos
Seção intitulada “Caminhos”As transições mais frequentes entre telas, como Passou de, Passou para e Vezes percorrido, entre áreas. Os caminhos cobrem no máximo os últimos 30 dias.
Membros
Seção intitulada “Membros”Mostrar alterna entre duas listas:
- Ativo tem uma linha para cada membro visto no intervalo: nome, nome de usuário, dias ativos, eventos, minutos de atividade, minutos de aplicativo aberto e quando foi visto pela primeira e pela última vez. Abra uma linha para ver os eventos por dia desse membro e o que ele usou.
- Inativo lista os membros atuais sem atividade no intervalo, com a data em que se tornaram membros e quando foram vistos pela última vez. Nenhum registro significa nenhuma atividade no histórico mantido, que é de no máximo 25 meses e apenas desde o início da coleta. Baixe a lista com Baixar CSV. Inativo significa sem atividade em qualquer área, então ignora Área. Um membro removido do espaço de trabalho ou desativado não é listado nem contado.
Conteúdo
Seção intitulada “Conteúdo”Cada painel, aplicativo e notebook com o respectivo Tipo, Membros, Alcance, Aberturas, Minutos de aplicativo aberto (somente aplicativos), uma Tendência semanal e quando foi Último uso. Escolha um Tipo para restringir a lista ou selecione Ocultar não utilizados para omitir itens que ninguém abriu. Abra uma linha para ver os membros que usaram o item e baixe qualquer uma das listas com Baixar CSV. Uma observação abaixo da lista informa quais tipos ainda não são coletados ou só foram coletados a partir de uma data posterior. Se os nomes dos painéis e dos aplicativos não puderem ser consultados, um aviso informa Names are unavailable right now, so items nobody used are not listed. Os itens que foram usados continuam aparecendo.
Restringir a um grupo
Seção intitulada “Restringir a um grupo”Grupo limita Visão geral, Conteúdo e a lista Inativo aos membros de um grupo de segurança. Escolha Todos para remover o limite. Digite na caixa para pesquisar os grupos do espaço de trabalho. O relatório usa a participação atual no grupo, não a de quando a atividade ocorreu, e informa isso ao lado do filtro.
- Os membros Ativo, Atividade, Caminhos e Exportações não são restringidos. O filtro fica desativado nessas guias e explica o motivo.
- Por mês não é exibido para um grupo, porque o histórico mensal é mantido para todos.
- Um grupo sem membros, ou que não existe mais, retorna resultados vazios e um aviso que informa isso, não um erro.
- Se você não puder ler os grupos de segurança do espaço de trabalho, o filtro não é oferecido.
Exportações
Seção intitulada “Exportações”Baixe um resumo como CSV. Escolha o Resumo e um Intervalo de datas e, em seguida, selecione Baixar CSV. O intervalo é de até 25 meses.
| Resumo | Conteúdo |
|---|---|
| Atividade diária | Membros e eventos de cada dia, área, evento e assunto. |
| Atividade diária por membro | O mesmo para cada membro, com IDs de membros. |
| Adoção mensal | Membros e eventos de cada mês, área, evento e assunto. |
| Membros ativos por mês | Membros ativos de cada mês e área. |
| Primeiro uso | Quando cada membro usou cada área pela primeira vez, com IDs de membros. |
A exportação usa a área que você escolheu acima das guias. Um resumo grande é baixado em lotes de até 50.000 linhas, e a página os combina em um único arquivo. Se o arquivo ficar maior do que a página consegue montar, ela salva o que tem e avisa que o arquivo está incompleto: escolha um intervalo menor para obter o restante.
Toda exportação grava uma entrada no Log de segurança registrando quem exportou qual resumo, o intervalo e o número de linhas. Um resumo que abrange vários lotes grava uma entrada para cada lote.
Para colocar esses números em uma tabela em um agendamento, use a etapa Get Workspace Usage.
Veja quantos membros percorrem uma sequência de etapas. Uma etapa é um evento de uma das áreas, para um assunto específico, ou Qualquer assunto. O funil usa o intervalo de datas que você escolheu, até os últimos 90 dias, e informa quando encurta um intervalo maior.
- Selecione Adicionar etapa e escolha a área, o evento e o assunto de cada etapa. Um funil tem de 2 a 6 etapas.
- Escolha o Tempo permitido entre etapas: 1, 6, 24, 72 ou 168 horas.
- Selecione Executar funil.
O resultado mostra, para cada etapa, quantos membros chegaram a ela, a parcela dos que começaram e o tempo mediano desde a etapa anterior. Cada etapa, exceto a última, mostra quantos membros pararam ali. A última etapa mostra quantos concluíram o funil. As etapas podem misturar áreas, então você pode acompanhar um membro desde uma tela do PlaidCloud até um painel. Funis recentes reabre um funil que você executou antes. Uma lista de etapas só oferece eventos registrados no intervalo.
Uso não atribuído
Seção intitulada “Uso não atribuído”Alguns eventos não podem ser associados a um membro do PlaidCloud. Eles contam em Eventos e em Eventos não atribuídos, mas nunca nas contagens de membros. Os principais casos:
- Uma conta do Superset criada dentro do Superset em vez de pelo PlaidCloud.
- Uma visualização de um painel incorporado, que não tem usuário do Superset.
- Atividade de aplicativos e de servidores de notebook que os logs da plataforma não conseguem associar a um membro. A atribuição vem desses logs, então trate-a como a melhor estimativa possível.
Uma grande parcela não atribuída em uma área significa que as contagens de membros dela estão subestimadas.
Quando o histórico começa
Seção intitulada “Quando o histórico começa”O histórico começa quando a coleta de uso é ativada no seu espaço de trabalho, e um dia ou mês anterior a isso não mostra atividade. O primeiro mês com dados é marcado como parcial.
O Panel e o JupyterHub são lidos dos logs da plataforma, que são mantidos por cerca de 90 dias. Quando a coleta começa, essas duas áreas preenchem no máximo esse período de histórico anterior. O Superset preenche a partir dos próprios logs, por até 180 dias. Somente o aplicativo PlaidCloud começa do zero quando a coleta começa.
Os Relatórios de uso mantêm os eventos brutos por 180 dias, e é por isso que o maior intervalo é de 180 dias, e mantêm os resumos mensais por 25 meses. Quando um membro é removido fora do PlaidCloud, por exemplo por meio de SCIM ou Keycloak, o uso bruto dele expira após 180 dias e o registro de primeiro uso após 25 meses. Um intervalo que começa antes dos 180 dias de atividade detalhada mostra um aviso em vez da lista de membros inativos, porque o detalhe necessário para saber quem esteve ausente não existe mais.
Privacidade e auditoria
Seção intitulada “Privacidade e auditoria”Algumas visualizações do uso de membros identificados são, em si, auditadas. Estas ações gravam uma entrada no Log de segurança registrando quem a realizou:
- Abrir o perfil de uso de um membro.
- Abrir ou baixar a lista Inativo.
- Abrir ou baixar os membros que usaram um item em Conteúdo.
- Baixar a lista de Conteúdo.
- Abrir Visão geral ou Conteúdo restrito a um grupo.
- Toda exportação, conforme descrito em Exportações.
A lista Ativo em Membros não é registrada.
Apagar o uso de um membro
Seção intitulada “Apagar o uso de um membro”Um administrador do espaço de trabalho (ou superusuário) com a permissão identity.security_log.read pode apagar o uso de um membro e parar de coletá-lo, e depois suspender o apagamento. Apagar e restaurar exigem essa permissão e essa função. Essas duas ações estão disponíveis somente pela API REST.
| Ação | Solicitação |
|---|---|
| Apagar | DELETE /rest/v1/identity/usage/users/{user_id} |
| Restaurar | DELETE /rest/v1/identity/usage/users/{user_id}/erasure |
Apagar remove os eventos e o registro de primeiro uso do membro e, a partir desse momento, os relatórios e as exportações deixam o membro de fora. O uso dele não é coletado novamente, e o histórico lido depois dos logs do Panel e do JupyterHub também é descartado. Se a remoção não puder ser concluída de imediato, a resposta informa isso e a próxima manutenção horária a conclui.
Restaurar suspende o apagamento para que a nova atividade volte a ser coletada. Isso não recupera o que foi apagado.
Ambas as ações gravam uma entrada no Log de segurança.