Relatórios de utilização
Os Relatórios de utilização mostram quem utiliza o quê na sua área de trabalho: que ecrãs, painéis de controlo, aplicações e notebooks os membros abrem, quantos membros regressam e para onde seguem depois. Use-os para perceber o que os seus membros adotam, que painéis de controlo e aplicações justificam o seu valor e onde as pessoas abandonam um processo.
Abra-os em Relatórios de utilização, em Análises, na barra lateral do separador Identidade. Abrem como uma página dentro de Identidade, ao lado da barra lateral, e não numa janela separada.
Quem os pode ver
Seção intitulada “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 item da barra lateral não é apresentado, e um membro que abra o relatório de outra forma vê um aviso de que não tem acesso.
Os relatórios mostram a utilização por membro nestes locais: o separador Membros, as listas de membros que abre a partir de Conteúdo e Visão geral, 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. A abertura da utilização de um membro fica, ela própria, registada; consulte Privacidade e auditoria.
O que é contabilizado
Seção intitulada “O que é contabilizado”Os Relatórios de utilização combinam cinco áreas. Escolha uma em Área ou deixe a opção Todas as áreas.
| Área | O que é registado |
|---|---|
| Aplicação PlaidCloud | Os ecrãs que os membros abrem e as ações que executam na aplicação. |
| Painéis de controlo | Visualizações de painéis de controlo e de gráficos. |
| Aplicações | Visitas às aplicações e o tempo que os membros passam em cada uma. |
| Servidores de notebooks | O tempo que os membros passam em sessões de servidores de notebooks. |
| Notebooks | Os notebooks que os membros abrem e guardam. |
Os servidores de notebooks e os notebooks são áreas separadas, pelo que pode escolher qualquer uma delas. As aplicações são uma única área. Os eventos de notebooks só são registados para notebooks que são executados na imagem de notebook predefinida. Uma imagem personalizada não os comunica.
Os eventos e as áreas aparecem com nomes legíveis, como Bloco de notas aberto, App de servidor visitada e App de browser visitada, em vez de códigos internos. As visitas a aplicações Dash e WASM aparecem como Visitas a aplicações na coluna Área. Escolher Aplicações em Área exclui-as; deixe Área em Todas as áreas para as incluir. Um painel de controlo ou uma aplicação entretanto eliminados aparecem como Painel de controlo eliminado ou App eliminada.
Ler os relatórios
Seção intitulada “Ler os relatórios”A barra no topo da página contém os filtros. Cada separador é carregado quando o abre pela primeira vez e novamente quando altera um filtro.
| Filtro | O que faz |
|---|---|
| Área | Limita o relatório a uma área. Está oculto em Funil, que escolhe uma área para cada passo, e em Exportações, que tem a sua 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 de início e de fim até 180 dias. |
| Atualizar | Carrega novamente os valores (F5). Atualizado mostra quando foram carregados pela última vez. |
O intervalo de datas é partilhado por todos os separadores, e o separador em que estava e o intervalo que escolheu são guardados nas definições da sua conta, pelo que a página reabre onde a deixou em qualquer computador. Alterar o intervalo recarrega o separador em que está e os restantes separadores quando os abrir. Cada separador tem as suas próprias explicações: aponte para um título ou número para ler o que significa.
Enquanto um separador carrega, vê um marcador de posição em vez de uma página em branco. Se um relatório não puder ser carregado, o separador mostra o motivo com Tentar novamente e Copiar detalhes. Quando um intervalo não tem atividade, o separador sugere que experimente um intervalo mais longo. Para abrir uma linha, faça duplo clique nela ou selecione-a e prima Enter. Anterior regressa do item que abriu à lista.
Visão geral
Seção intitulada “Visão geral”Os números principais do intervalo, cada um com uma seta e uma percentagem que indicam a variação em relação ao período anterior com a mesma duração:
| Número | Significado |
|---|---|
| Membros ativos | Membros com qualquer atividade. |
| Membros novos | Membros vistos pela primeira vez no intervalo. Apresentado como um traço quando o intervalo começa antes de a recolha ter começado, porque não é possível determinar utilizações anteriores. |
| Membros recorrentes | Membros ativos que foram vistos pela primeira vez antes do intervalo. |
| Minutos de atividade | Estimativa: cinco minutos por cada período de cinco minutos com qualquer ação ou visualização. |
| Minutos de aplicação aberta | Tempo em que as aplicações e os servidores de notebooks estiveram abertos, incluindo o tempo de inatividade. Contabilizado à parte dos minutos de atividade. |
| Eventos | Tudo o que foi registado. |
Os eventos que não podem ser associados a um membro são contabilizados separadamente, numa linha por baixo dos números. Contam como eventos, não como membros.
Destaques lista até quatro aspetos que merecem atenção, cada um com uma ligação para onde pode ver mais:
- Um aumento ou uma diminuição de 10% ou mais nos membros ativos em comparação com o período anterior.
- O número de membros não ativos no intervalo. Selecione-o para abrir a lista de membros inativos.
- O número de painéis de controlo e aplicações que ninguém abriu. Selecione-o para abrir Conteúdo com os não utilizados primeiro.
- O item mais utilizado, quando pelo menos cinco membros o utilizaram.
Um destaque só aparece quando tem algo a dizer. Quando o PlaidCloud não consegue determinar uma contagem, o destaque fica oculto em vez de mostrar 0, e se nada se destacar vê Sem alterações relevantes neste intervalo.
Mais utilizados lista cada ecrã, painel de controlo, gráfico ou item com a respetiva área, evento, número de membros e Alcance, a percentagem de membros ativos que o utilizaram no intervalo. O seletor de colunas acrescenta Eventos e Eventos não associados 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 (rácio DAU/MAU) de cada mês, com uma nota quando o mês ainda está a decorrer ou só está parcialmente coberto. A fidelização (rácio DAU/MAU) é a média de membros ativos diários dividida pelos membros ativos no mês, pelo que um valor mais alto significa que as pessoas regressam em mais dias.
Atividade
Seção intitulada “Atividade”Membros ativos por período Diário, Semanal ou Mensal, mais Retenção por primeira semana: para cada semana em que os membros apareceram pela primeira vez, a Dimensão da coorte e a percentagem desses membros que continuam ativos em cada semana seguinte. Um período marcado com um asterisco não está totalmente dentro do intervalo.
Caminhos
Seção intitulada “Caminhos”As transições mais frequentes entre ecrãs, como Passou de, Passou para e Vezes percorrido, entre áreas. Os caminhos abrangem, no máximo, os últimos 30 dias.
Membros
Seção intitulada “Membros”Mostrar alterna entre duas listas:
- Ativo tem uma linha por membro visto no intervalo: nome, nome de utilizador, dias ativos, eventos, minutos de atividade, minutos de aplicação aberta e quando foram vistos pela primeira e pela última vez. Abra uma linha para ver os eventos desse membro por dia e o que utilizou.
- Inativo lista os membros atuais sem atividade no intervalo, com a data em que se tornaram membros e a data em que foram vistos pela última vez. Nenhum registado significa que não há atividade no histórico conservado, que é de 25 meses no máximo e só desde que a recolha começou. Transfira a lista com Transferir CSV. Inativo significa sem atividade em qualquer área, pelo que ignora Área. Um membro removido da área de trabalho ou desativado não é listado nem contabilizado.
Conteúdo
Seção intitulada “Conteúdo”Todos os painéis de controlo, aplicações e notebooks com o respetivo Tipo, Membros, Alcance, Aberturas, Minutos de aplicação aberta (apenas aplicações), uma Tendência semanal e a Última utilização. Escolha um Tipo para restringir a lista ou selecione Ocultar não utilizados para deixar de fora os itens que ninguém abriu. Abra uma linha para ver os membros que utilizaram o item e transfira qualquer das listas com Transferir CSV. Uma nota por baixo da lista indica quais os tipos que ainda não são recolhidos ou que só foram recolhidos desde uma data posterior. Se não for possível consultar os nomes dos painéis de controlo e das aplicações, um aviso indica Names are unavailable right now, so items nobody used are not listed. Os itens que foram utilizados continuam a aparecer.
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. Escreva na caixa para pesquisar os grupos da área de trabalho. O relatório utiliza a composição atual do grupo, não a do momento em que a atividade ocorreu, e indica-o junto ao filtro.
- Os membros Ativo, Atividade, Caminhos e Exportações não são restringidos. O filtro está desativado nesses separadores e explica porquê.
- Por mês não é apresentado para um grupo, porque o histórico mensal é conservado para todos.
- Um grupo sem membros, ou que já não existe, devolve resultados vazios e um aviso que o indica, não um erro.
- Se não puder ler os grupos de segurança da área de trabalho, o filtro não é disponibilizado.
Exportações
Seção intitulada “Exportações”Transfira um resumo em CSV. Escolha o Resumo e um Intervalo de datas e, em seguida, selecione Transferir CSV. O intervalo pode ir até 25 meses.
| Resumo | Conteúdo |
|---|---|
| Atividade diária | Membros e eventos por dia, área, evento e assunto. |
| Atividade diária por membro | O mesmo para cada membro, com os identificadores dos membros. |
| Adoção mensal | Membros e eventos por mês, área, evento e assunto. |
| Membros ativos mensais | Membros ativos por mês e área. |
| Primeira utilização | Quando cada membro utilizou pela primeira vez cada área, com os identificadores dos membros. |
A exportação utiliza a área que escolheu acima dos separadores. Um resumo grande é transferido em lotes até 50 000 linhas, e a página combina-os num único ficheiro. Se o ficheiro for maior do que a página consegue construir, guarda o que tem e avisa que o ficheiro está incompleto: escolha um intervalo mais curto para obter o resto.
Cada exportação escreve uma entrada no Registo de segurança que regista quem exportou que resumo, o intervalo e o número de linhas. Um resumo que abrange vários lotes escreve uma entrada por lote.
Para colocar estes valores numa tabela de forma agendada, use antes o passo Get Workspace Usage.
Veja quantos membros percorrem uma sequência de passos. Um passo é um evento de uma das áreas, para um determinado assunto, ou Qualquer assunto. O funil utiliza o intervalo de datas que escolheu, até aos últimos 90 dias, e indica-o quando encurta um intervalo mais longo.
- Selecione Adicionar passo e escolha a área, 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.
- Selecione Executar funil.
O resultado mostra, para cada passo, quantos membros o alcançaram, a percentagem dos que começaram e o tempo mediano desde o passo anterior. Cada passo, exceto o último, mostra quantos membros pararam aí. O último passo mostra quantos concluíram o funil. Os passos podem misturar áreas, pelo que pode acompanhar um membro desde um ecrã do PlaidCloud até um painel de controlo. Funis recentes reabre um funil que executou anteriormente. A lista de passos só oferece eventos registados no intervalo.
Utilização não atribuída
Seção intitulada “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 membros. Os principais casos:
- Uma conta Superset criada dentro do Superset em vez de através do PlaidCloud.
- Uma visualização de um painel de controlo incorporado, que não tem utilizador Superset.
- Atividade de aplicações e de servidores de notebooks que os registos da plataforma não conseguem associar a um membro. A sua atribuição provém desses registos, pelo que deve ser considerada uma estimativa.
Uma percentagem elevada de eventos não atribuídos numa área significa que as contagens de membros dessa área estão subestimadas.
Quando começa o histórico
Seção intitulada “Quando começa o histórico”O histórico começa quando a recolha de utilização é ativada para a sua área de trabalho, e um dia ou mês anterior não mostra atividade. O primeiro mês com dados é marcado como parcial.
O Panel e o JupyterHub são lidos a partir dos registos da plataforma, que são conservados durante cerca de 90 dias. Quando a recolha começa, estas duas áreas 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 começa.
Os Relatórios de utilização conservam os eventos em bruto durante 180 dias, razão pela qual o intervalo mais longo é de 180 dias, e conservam 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. 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 já não existe.
Privacidade e auditoria
Seção intitulada “Privacidade e auditoria”Algumas consultas da utilização de membros identificados são, elas próprias, auditadas. Estas ações escrevem uma entrada no Registo de segurança que regista quem as realizou:
- Abrir o perfil de utilização de um membro.
- Abrir ou transferir a lista Inativo.
- Abrir ou transferir os membros que utilizaram um item em Conteúdo.
- Transferir a lista de Conteúdo.
- Abrir Visão geral ou Conteúdo restringido a um grupo.
- Todas as exportações, conforme descrito em Exportações.
A lista Ativo em Membros não é registada.
Apagar a utilização de um membro
Seção intitulada “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 não volta a ser recolhida, e o histórico que seja lido mais tarde 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 para que a nova atividade volte a ser recolhida. Não recupera o que foi apagado.
Ambas as ações escrevem uma entrada no Registo de segurança.