Gerar relatórios do App Insights para monitorizar aplicações que não sejam da Microsoft

O App Insights é uma funcionalidade de Gestão Avançada do SharePoint que permite que os administradores de TI obtenham informações sobre as várias aplicações não Microsoft registadas no seu centro de administração do Microsoft Entra e como acedem aos seus conteúdos do SharePoint. Este relatório pode ajudá-lo a manter e proteger a integridade dos seus conteúdos.

O relatório baseia-se nos dados de auditoria da Microsoft registados quando uma aplicação não Microsoft acede ao conteúdo através do seguinte conjunto de eventos:

  • FileAccessed
  • FileDownloaded
  • FileModified
  • FileUploaded

Pré-requisitos para gerar relatórios do App Insights

Veja Pré-requisitos da Gestão Avançada do SharePoint, incluindo requisitos para o módulo do PowerShell do SharePoint Online.

Relatórios do App Insights no centro de administração do SharePoint

Recolha de dados para o relatório do Enterprise App Insight

Importante

Como uma atividade única, verá um pop-up na IU para ativar a recolha de dados para relatórios do "Enterprise App Insight", para que o produto comece a recolher os dados de auditoria relevantes para criar este relatório. Depois de ativados, os relatórios podem ser gerados 24 horas depois e contêm dados do momento da recolha de dados. Os dados são armazenados durante 28 dias. Se não forem gerados relatórios mesmo uma vez em três meses, a recolha de dados será colocada em pausa e deverá ser ativada novamente.

Criar relatório

  1. No centro de administração do SharePoint, no painel de navegação, expanda Relatórios e, em seguida, selecione Informações da aplicação.

  2. Uma vez na página de destino do App Insights , selecione Adicionar um relatório para gerar um novo relatório.

    Captura de ecrã da página Criar relatórios para informações da aplicação dashboard no centro de administração do SharePoint.

  3. Em Intervalo de relatórios, pode especificar e filtrar dados a partir de um período de tempo respetivo para o relatório. Captura de ecrã do intervalo de relatórios das informações da aplicação no centro de administração do SharePoint.

  4. Selecione Adicionar e executar.

Observação

  • Pode demorar até várias horas para que os relatórios gerados estejam disponíveis.
  • Só é permitido um relatório por intervalo de relatórios.
  • Os relatórios podem ser novamente executados após 24 horas.

Gerir relatórios no centro de administração do SharePoint

Ver status de relatórios

Para marcar se um relatório está pronto ou quando foi atualizado pela última vez, veja a coluna Estado. Quando um relatório estiver pronto, selecione-o para ver os dados.

Captura de ecrã do relatório de informações da aplicação criado no centro de administração do SharePoint.

Pode ver os 100 melhores resultados (por volume de pedido) no ecrã.

Também pode filtrar por Nome da aplicação, Permissões de aplicações e Sensibilidade do site para ver os resultados relevantes das 100 linhas principais.

Captura de ecrã da lista de relatórios de informações no centro de administração do SharePoint.

Importante

Para ver até um milhão de resultados, tem de selecionar Transferir relatório detalhado.

Eliminar relatório

Para eliminar um relatório, selecione o relatório existente que pretende eliminar e, em seguida, selecione Eliminar relatório.

Executar novamente um relatório

Para obter dados atualizados para um determinado intervalo de relatórios, selecione um relatório existente e, em seguida, selecione Executar.

Dica

Também é apresentado um pedido de nova execução se selecionar Adicionar um relatório e selecionar um intervalo de relatórios para o qual já exista um relatório.

Relatórios do App Insights no Módulo do PowerShell do SharePoint

Pode gerar e gerir relatórios do App Insights com Shell de Gerenciamento do SharePoint Online.

Criar um relatório de duração predefinido de um dia

Para gerar um relatório para a duração predefinida de um dia, execute o seguinte comando:

Start-SPOEnterpriseAppInsightsReport

Criar relatório para qualquer outra duração

Para gerar o relatório para qualquer outra duração, execute o seguinte comando:

Start-SPOEnterpriseAppInsightsReport -ReportPeriodInDays $ReportPeriodInDays (possible values = 1, 7, 14, 28)

Verificar status de todos os relatórios ativos e disponíveis

Para marcar status de todos os relatórios ativos e disponíveis, execute o seguinte comando:

Get-SPOEnterpriseAppInsightsReport

Verificar status de um relatório específico

Para marcar status de um relatório específico, execute o seguinte comando:

Get-SPOEnterpriseAppInsightsReport -reportID $reportID (for the given report ID)

Ver um relatório específico

Para ver um relatório específico, execute o seguinte comando:

Get-SPOEnterpriseAppInsightsReport -reportID $reportID

Transferir um relatório

Para transferir o relatório, execute o seguinte comando:

Get-SPOEnterpriseAppInsightsReport -reportID $reportID -action download

Importante

As capacidades de voltar a executar e eliminar relatórios não estão disponíveis para o PowerShell. Os cmdlets Create report podem ser utilizados com a duração do relatório relevante.

Problemas conhecidos

  • Nos novos inquilinos, pode demorar alguns dias para que os dados estejam disponíveis e para que estes relatórios sejam gerados com êxito. Em inquilinos grandes, os dados podem ser atrasados até 48 horas (cerca de dois dias).
  • Um relatório só pode ser executado novamente após 24 horas desde a última geração do relatório.
  • Só pode existir um relatório para cada valor do Intervalo de relatórios. Isto significa que pode ver um máximo de quatro relatórios na home page do Enterprise Application Insights .
  • Estes relatórios são alimentados por Dados de auditoria e não incluem todos os eventos de auditoria.
  • Poderá ver o ID da Aplicação de uma aplicação que não seja da Microsoft, mas o Nome da aplicação de uma aplicação de camada média em alguns casos.
  • Last updated on