Relatórios de utilização

Os Relatórios de utilização mostram quem utiliza o quê na área de trabalho: que ecrãs, painéis de controlo, aplicações e blocos de notas as pessoas abrem, quantas voltam e para onde vão a seguir. Utilize-os para perceber o que os membros adotam, que painéis de controlo e aplicações compensam e em que ponto as pessoas abandonam um processo.

Abra-os a partir do separador Identidade, junto ao Registo de segurança.

Quem os pode ver

Os Relatórios de utilização exigem a mesma permissão que o Registo de segurança: identity.security_log.read. Sem ela, o botão não é apresentado, e um membro que abra o relatório mesmo assim vê um aviso de que não tem acesso.

Os relatórios mostram a utilização por membro em dois locais: o separador Utilizadores e as exportações Atividade diária por membro e Primeira utilização, que incluem os identificadores dos membros. Tudo o resto é contabilizado de forma agregada. Conceda a permissão apenas a quem deve ver a atividade individual.

O que é contabilizado

Os Relatórios de utilização combinam cinco origens. Escolha uma em Origem ou deixe a opção Todas as origens.

Origem	O que é registado
Aplicação PlaidCloud	Os ecrãs que os membros abrem e as ações que realizam na aplicação.
Superset	Visualizações de painéis de controlo e de gráficos.
Aplicações Panel	Visitas às aplicações e o tempo que os membros passam em cada uma.
JupyterHub	O tempo que os membros passam em sessões do JupyterHub.
Blocos de notas Jupyter	Os blocos de notas que os membros abrem e guardam.

As sessões do JupyterHub e os blocos de notas Jupyter são origens distintas, pelo que pode escolher qualquer uma delas. As aplicações Panel são uma única origem. Os eventos dos blocos de notas só são registados para blocos de notas executados na imagem de bloco de notas predefinida. Uma imagem personalizada não os comunica.

Ler os relatórios

Escolha uma origem e um Intervalo de datas no topo da janela e, em seguida, selecione Atualizar. Os intervalos são os últimos 7, 30, 90 ou 180 dias. Cada separador é carregado quando o abre pela primeira vez e novamente quando altera a origem ou o intervalo.

Resumo geral

Os principais números do intervalo:

Número	Significado
Utilizadores ativos	Membros com qualquer atividade.
Novos utilizadores	Membros vistos pela primeira vez no intervalo.
Utilizadores recorrentes	Membros ativos que foram vistos pela primeira vez antes do intervalo.
Minutos ativos	Aproximado: cinco minutos por cada período com atividade.
Eventos	Tudo o que foi registado.
Eventos não atribuídos	Eventos aos quais não foi possível associar um membro. Contam como eventos, não como utilizadores.
Minutos de sessão	Tempo de sessão do Panel e do JupyterHub, contabilizado separadamente dos minutos ativos.

Adoção apresenta cada ecrã, painel de controlo, gráfico ou item com a respetiva origem, evento, número de utilizadores, percentagem de utilizadores ativos, eventos e eventos não atribuídos. Por mês mostra os utilizadores ativos, a média diária de utilizadores e a fidelização de cada mês, com uma nota quando o mês ainda está em curso, só parcialmente coberto ou é um instantâneo congelado.

Atividade

Utilizadores ativos por período Diário, Semanal ou Mensal, mais a Retenção por primeira semana: para cada semana em que os membros apareceram pela primeira vez, quantos regressaram em cada uma das semanas seguintes. Um período marcado com um asterisco não está totalmente contido no intervalo.

Percursos

As transições mais frequentes entre ecrãs, apresentadas como Passou de, Passou para e Vezes percorrido, entre aplicações e origens. Os percursos abrangem, no máximo, os últimos 30 dias.

Utilizadores

Uma linha por membro: nome, nome de utilizador, dias ativos, eventos, minutos ativos, minutos de sessão e quando foi visto pela primeira e pela última vez.

Exportações

Transfira um resumo em CSV. Escolha o Resumo e um Intervalo de datas até 25 meses e, em seguida, selecione Transferir CSV.

Resumo	Conteúdo
Atividade diária	Utilizadores e eventos por dia, origem, evento e assunto.
Atividade diária por membro	O mesmo por membro, com os identificadores dos membros.
Adoção mensal	Utilizadores e eventos por mês, origem, evento e assunto.
Utilizadores ativos mensais	Utilizadores ativos por mês e origem.
Primeira utilização	Quando cada membro utilizou cada origem pela primeira vez, com os identificadores dos membros.

A exportação utiliza a origem escolhida acima dos separadores. Um resumo grande é transferido em lotes de até 50 000 linhas, e a janela combina-os num único ficheiro. Se o ficheiro for maior do que a janela consegue criar, guarda o que tem e avisa que o ficheiro está incompleto: escolha um intervalo mais curto para obter o restante.

Cada exportação grava uma entrada no Registo de segurança com quem exportou que resumo, o intervalo e o número de linhas. Um resumo que abranja vários lotes grava uma entrada por lote.

Funil

Veja quantos membros percorrem uma sequência de passos. Um passo é um evento de uma das origens, para um determinado assunto, ou Qualquer assunto.

Selecione Adicionar passo e escolha a origem, o evento e o assunto de cada passo. Um funil tem de 2 a 6 passos.
Escolha o Tempo permitido entre passos: 1, 6, 24, 72 ou 168 horas.
Escolha um Intervalo de datas de 7, 30 ou 90 dias.
Selecione Executar funil.

O resultado mostra, para cada passo, quantos membros o alcançaram, a percentagem dos que começaram, quantos ficaram por ali e o tempo mediano desde o passo anterior. Os passos podem misturar origens, pelo que é possível acompanhar um membro desde um ecrã do PlaidCloud até um painel de controlo do Superset. Funis recentes reabre um funil executado anteriormente. A lista de passos só oferece eventos registados no intervalo.

Utilização não atribuída

Alguns eventos não podem ser associados a um membro do PlaidCloud. Contam em Eventos e em Eventos não atribuídos, mas nunca nas contagens de utilizadores. Os principais casos:

Uma conta do Superset criada no próprio Superset em vez de através do PlaidCloud.
Uma visualização de um painel de controlo incorporado, que não tem utilizador do Superset.
Atividade do Panel e do JupyterHub que os registos da plataforma não conseguem associar a um membro. A atribuição provém desses registos, pelo que deve ser tratada como um melhor esforço.

Uma percentagem elevada de eventos não atribuídos numa origem significa que as contagens de utilizadores dessa origem estão subestimadas.

Quando começa o histórico

O histórico começa quando a recolha de utilização é ativada para a área de trabalho, e um dia ou mês anterior a esse momento não mostra atividade. O primeiro mês com dados é assinalado como parcial.

O Panel e o JupyterHub são lidos a partir dos registos da plataforma, que são mantidos durante cerca de 90 dias. Quando a recolha começa, estas duas origens preenchem, no máximo, esse período de histórico anterior. O Superset preenche a partir dos seus próprios registos, até 180 dias. Apenas a aplicação PlaidCloud começa do zero quando a recolha arranca.

Os Relatórios de utilização mantêm os eventos em bruto durante 180 dias, razão pela qual o intervalo mais longo é de 180 dias, e mantêm os resumos mensais durante 25 meses. Quando um membro é removido fora do PlaidCloud, por exemplo através de SCIM ou Keycloak, a sua utilização em bruto expira após 180 dias e o seu registo de primeira utilização após 25 meses.

Apagar a utilização de um membro

Um administrador da área de trabalho (ou superutilizador) com a permissão identity.security_log.read pode apagar a utilização de um membro e deixar de a recolher, e mais tarde levantar essa eliminação. Tanto apagar como restaurar exigem essa permissão e essa função. Estas duas ações estão disponíveis apenas através da API REST.

Ação	Pedido
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 registo de primeira utilização do membro e, a partir desse momento, os relatórios e as exportações deixam o membro de fora. A sua utilização deixa de ser recolhida, e o histórico que for lido mais tarde a partir dos registos do Panel e do JupyterHub também é descartado. Se a remoção não puder ser concluída de imediato, a resposta indica-o e a execução de manutenção horária seguinte conclui-a.

Restaurar levanta a eliminação, de modo que a nova atividade volta a ser recolhida. Não repõe o que foi apagado.

Ambas as ações gravam uma entrada no Registo de segurança.