Pular para o conteúdo

Gerar um relatório

Este guia leva-o de uma página vazia até um relatório que pode enviar a um cliente. Cobre também as tarefas relacionadas: cancelar uma execução, ler um relatório, libertar um espaço de armazenamento e descobrir porque é que um relatório está incompleto.

Para a referência, consulte Relatórios de health check e O que cada relatório contém.

O que é necessário: a função de admin. Um workspace no plano Max ou superior, com os relatórios ligados. Um tenant Okta, Auth0 ou Entra ID ligado.

Um relatório lê o que o tenant recolheu e o que o Identiguard tem permissão para ler.

  • Okta: a integração precisa dos scopes de relatório. Consulte Ligar o Okta.
  • Auth0: o relatório utiliza o que o log stream enviou. Um tenant ligado ontem tem um dia de dados.
  • Entra ID: abra a página Edit do tenant. Verifique se os streams que pretende estão ligados e verifique Reporting permissions (optional). Cada permissão que pretende mostra Granted (concedida).
  1. Na barra lateral, em Reporting, escolha Generate.
  2. No cartão Start a health check, escolha o tenant em Tenant. Verifique o distintivo do fornecedor ao lado do nome: Okta, Auth0 ou Microsoft Entra.
  3. Para um tenant Auth0 ou Entra ID, escolha o Reporting window (período do relatório): 7 days, 30 days ou 12 weeks. A predefinição é 12 weeks. Um tenant Okta não tem período.
  4. Verifique se Stored reports (relatórios guardados) está abaixo de 100 / 100.
  5. Escolha Generate report.

Funcionou quando: aparece a mensagem Report started. (Relatório iniciado.), e o cartão In progress mostra a execução com o distintivo Queued ou Running.

A lista de verificação em In progress mostra a secção que está a ser construída. Um tenant grande e complexo pode demorar até 90 minutos. Pode fechar a página e voltar mais tarde. O progresso fica guardado.

Inicie o relatório na véspera de uma reunião com o cliente.

Quando a execução termina, o cartão In progress mostra Nothing running (nada em execução). Na barra lateral, escolha Reports. O novo relatório está no topo, com o estado Completed ou Partial. Ambos têm um PDF.

  • Procure cartões que indiquem Not available for this tenant (Não disponível para este tenant). Significam que falta um stream, uma permissão ou uma licença, e não que algo está errado. Esteja preparado para explicar qual.
  • Procure títulos que terminem em was not collected (não foi recolhido). Significam que uma secção falhou.
  • Escolha as três constatações mais importantes para este cliente. Consulte Escolher páginas para um cliente.

Para um segundo relatório do Okta ou posterior, consulte Comparar dois relatórios.

O que é necessário: a função de admin.

  1. Na barra lateral, em Reporting, escolha Generate e escolha o tenant.
  2. No cartão In progress, escolha Cancel run. Não há confirmação.

Funcionou quando: aparece a mensagem Cancelling report. (A cancelar o relatório.) e o distintivo mostra Cancelling. A execução aparece depois na página Reports com o estado Cancelled.

Uma execução cancelada continua a ocupar um espaço de armazenamento. Elimine-a se não precisar dela. Consulte Libertar um espaço no limite de 100 relatórios.

Ler um relatório na aplicação e descarregar o PDF

Seção intitulada “Ler um relatório na aplicação e descarregar o PDF”

O que é necessário: qualquer função. Os membros e os visualizadores podem ler relatórios e descarregar PDF.

  1. Na barra lateral, em Reporting, escolha Reports e escolha o tenant.
  2. Selecione a linha. Mostra a data e a hora, e Run com um ID curto.
  3. Leia os cartões. Tome nota de qualquer cartão que indique Not available for this tenant e de qualquer título que termine em was not collected.
  4. Escolha Download PDF no topo do relatório. Pode também escolher o ícone de transferência na coluna PDF da lista.
  5. Escolha All reports para voltar à lista.

Funcionou quando: o PDF é descarregado. Uma linha com - na coluna PDF não tem PDF.

O PDF contém também a secção de monitorização, que não tem cartão na aplicação. Consulte Secções só no PDF.

Cada tenant guarda até 100 relatórios. Todas as execuções contam, incluindo as execuções Partial, Failed e Cancelled. No limite, Generate report fica desativado.

O que é necessário: a função de admin.

  1. Na barra lateral, em Reporting, escolha Reports e escolha o tenant.
  2. Escolha o ícone do caixote do lixo (Delete report) numa linha de que já não precisa. As execuções falhadas e canceladas são boas candidatas.
  3. Na caixa de diálogo Delete this report? (Eliminar este relatório?), escolha Delete.
  4. Volte a Generate.

Funcionou quando: aparece a mensagem Report deleted. (Relatório eliminado.) e o indicador Stored reports está mais baixo.

Os relatórios são também removidos automaticamente 180 dias depois de terem sido criados.

Corrigir uma secção “Not available” do Entra ID

Seção intitulada “Corrigir uma secção “Not available” do Entra ID”

Um cartão que indica Not available for this tenant apresenta o motivo e dá uma pista.

O que é necessário: a função de admin no Identiguard. Para as permissões, um administrador do tenant Entra ID do cliente que possa conceder o consentimento de administrador.

  1. Abra o relatório e leia o motivo no cartão.

  2. Siga a linha correspondente a esse motivo:

    Motivo no cartão O que fazer
    The … stream is not enabled for this tenant. (O stream … não está ativado para este tenant.) No Identiguard, abra a página de tenants, escolha Edit no tenant e ligue o stream. Consulte Alterar os eventos que um tenant envia. Os eventos são recolhidos a partir desse momento
    … has not been granted. (… não foi concedida.) No centro de administração do Entra, abra o registo da aplicação, abra API permissions, adicione a permissão de aplicação do Microsoft Graph indicada no cartão e, depois, escolha Grant admin consent
    Microsoft Graph refused the request (403). (O Microsoft Graph recusou o pedido, 403.) A permissão existe, mas não tem consentimento de administrador. Escolha Grant admin consent
    This tenant is not licensed for this data (Entra ID P1 or higher). (Este tenant não tem licença para estes dados, Entra ID P1 ou superior.) O tenant precisa de uma licença Entra ID P1 ou P2. Não há nada a alterar no Identiguard
  3. Gere um novo relatório.

Funcionou quando: o cartão do novo relatório mostra dados. Depois de ligar um stream, o primeiro relatório cobre apenas os dias desde esse momento, e o cartão indica Covers X of Y days, limited by when monitoring started. (Cobre X de Y dias, limitado pela data em que a monitorização começou.)

Para saber o que cada secção exige, consulte O que condiciona cada secção do Entra ID.

Perceber porque é que um relatório está Partial ou Failed

Seção intitulada “Perceber porque é que um relatório está Partial ou Failed”

Partial significa que pelo menos uma secção falhou, foi limitada por excesso de pedidos ou não foi alcançada em 90 minutos. Failed significa que nenhuma secção produziu dados, ou que a própria execução falhou.

O que é necessário: qualquer função para ler o relatório. A função de admin para gerar de novo ou eliminar.

  1. Na barra lateral, em Reporting, escolha Reports e selecione o relatório.
  2. Localize o motivo:
    • Okta: leia o texto a âmbar no fundo do cartão End user lifecycle. Indica cada secção que falhou e porquê.
    • Auth0 e Entra ID: localize os títulos que terminam em was not collected ou were not collected. O texto por baixo de cada um é o erro registado.
  3. Decida o que fazer:
    • O texto refere um limite de pedidos ou throttling: gere de novo numa altura mais calma para o cliente, por exemplo fora do horário de expediente.
    • O texto indica que o relatório excedeu o limite de 90 minutos: o tenant é grande. Gere de novo. No caso do Auth0 ou do Entra ID, experimente um Reporting window mais curto.
    • Um relatório do Entra ID está Failed e não mostra motivo: a Microsoft pode ter rejeitado o client ID e o client secret guardados. Atualize-os na página Edit do tenant. Consulte Renovar credenciais.
  4. Gere um novo relatório.
  5. Elimine a execução falhada, para que não ocupe um espaço de armazenamento.

Funcionou quando: o novo relatório tem o estado Completed.

  • Só é executado um relatório de cada vez por tenant.
  • Cada tenant guarda até 100 relatórios, e a lista mostra os 20 mais recentes.
  • Os relatórios são removidos automaticamente ao fim de 180 dias.
  • Os relatórios não são agendados. Para uma revisão mensal do serviço, coloque um lembrete no seu próprio calendário.
O que vê Porquê O que fazer
A secção Reporting não está na barra lateral, ou aparece Reporting is disabled for this workspace. (Os relatórios estão desativados para este workspace.) O plano não inclui relatórios, ou estes estão desligados para o workspace Passe para o plano Max ou superior, ou peça a um operador da plataforma
Only workspace admins can generate reports. (Só os admins do workspace podem gerar relatórios.) É member ou viewer Peça a um admin
A report is already running for this tenant. (Já há um relatório em execução para este tenant.) Só é executado um relatório de cada vez por tenant Aguarde ou cancele a execução
This tenant is storing the maximum of 100 reports. Delete one from Reports before generating another. (Este tenant tem guardado o máximo de 100 relatórios. Elimine um em Reports antes de gerar outro.) O tenant está no limite Liberte um espaço
Could not start the report. (Não foi possível iniciar o relatório.) O serviço de relatórios não aceitou a execução Tente de novo. Se se repetir, escale para o suporte
Could not cancel the report. (Não foi possível cancelar o relatório.) Não é admin, ou a execução já terminou Recarregue a página. Peça a um admin
Admin access required to delete reports (É necessário acesso de admin para eliminar relatórios) É member ou viewer Peça a um admin
That report is no longer available. It may have been deleted. (Esse relatório já não está disponível. Pode ter sido eliminado.) O relatório foi eliminado, foi removido ao fim de 180 dias ou é mais antigo do que os 20 mais recentes Escolha All reports

Para todas as mensagens, consulte a Resolução de problemas na página de relatórios.