Partager via

Générer des rapports App Insights pour surveiller les applications non-Microsoft

App Insights est une fonctionnalité de gestion avancée sharePoint qui permet aux administrateurs informatiques d’obtenir des insights sur les différentes applications non-Microsoft inscrites auprès de votre centre d’administration Microsoft Entra et sur la façon dont ils accèdent à votre contenu SharePoint. Ce rapport peut vous aider à maintenir et à protéger l’intégrité de votre contenu.

Le rapport est basé sur les données d’audit Microsoft journalisées lorsqu’une application non-Microsoft accède au contenu via l’ensemble d’événements suivant :

  • FileAccessed
  • FileDownloaded
  • FileModified
  • FileUploaded

De quoi avez-vous besoin pour générer des rapports App Insights ?

Quelles sont les exigences de licence ?

Votre organization doit disposer de la licence appropriée et répondre à certaines autorisations ou rôles administratifs pour utiliser la fonctionnalité décrite dans cet article.

Tout d’abord, votre organization doit avoir l’une des licences de base suivantes :

  • Office 365 E3, E5 ou A5
  • Microsoft 365 E1, E3, E5 ou A5

En outre, vous devez avoir Microsoft 365 Copilot licence.

Remarque

Au moins un utilisateur de votre organization doit se voir attribuer une licence Copilot (cet utilisateur n’a pas besoin d’être administrateur SharePoint). Si votre organization dispose d’une licence Copilot et qu’au moins une personne de votre organization se voit attribuer une licence Copilot, les administrateurs SharePoint ont automatiquement accès aux fonctionnalités de gestion avancée sharePoint nécessaires au déploiement de Copilot.

Configuration requise pour l’administrateur

Vous devez être administrateur SharePoint ou disposer d’autorisations équivalentes.

Rapports App Insights dans le Centre d’administration SharePoint

Collecte de données pour le rapport Enterprise App Insight

Importante

En tant qu’activité ponctuelle, vous verrez une fenêtre contextuelle sur l’interface utilisateur pour activer la collecte de données pour les rapports « Enterprise App Insight », afin que le produit commence à collecter les données d’audit pertinentes pour générer ce rapport. Une fois activés, les rapports peuvent être générés 24 heures plus tard et contiennent des données à partir du moment de la collecte des données. Les données sont stockées pendant 28 jours. Si aucun rapport n’est généré, même une fois tous les trois mois, la collecte de données est suspendue et doit être à nouveau activée.

Créer un rapport

  1. Connectez-vous au Centre d’administration SharePoint avec vos informations d’identification d’administrateur SharePoint.

  2. Dans le volet gauche, développez Rapports , puis sélectionnez App Insights.

  3. Une fois sur la page d’accueil App Insights , sélectionnez Ajouter un rapport pour générer un nouveau rapport.

    Capture d’écran de la page créer des rapports pour le tableau de bord App Insights dans le Centre d’administration SharePoint.

  4. Sous Plage de rapports, vous pouvez spécifier et filtrer les données d’une période respective pour votre rapport. Capture d’écran de la plage de rapports pour app Insights dans le Centre d’administration SharePoint.

  5. Sélectionnez Ajouter et exécuter.

Remarque

  • La disponibilité des rapports générés peut prendre jusqu’à plusieurs heures.
  • Un seul rapport est autorisé par plage de rapports.
  • Les rapports peuvent être réexécutés après 24 heures.

Gérer les rapports dans le Centre d’administration SharePoint

Afficher les status de rapport

Pour case activée si un rapport est prêt ou lorsqu’il a été mis à jour pour la dernière fois, consultez la colonne État. Lorsqu’un rapport est prêt, sélectionnez-le pour afficher les données.

Capture d’écran du rapport d’insight d’application créé dans le Centre d’administration SharePoint.

Vous pouvez voir les 100 premiers résultats (par volume de requête) à l’écran.

Vous pouvez également filtrer par nom de l’application, autorisations d’application et Sensibilité du site pour afficher les résultats pertinents des 100 premières lignes.

Capture d’écran de la liste des rapports d’insight dans le Centre d’administration SharePoint.

Importante

Pour afficher jusqu’à 1 million de résultats, vous devez sélectionner Télécharger le rapport détaillé.

Supprimer le rapport

Pour supprimer un rapport, sélectionnez le rapport existant que vous souhaitez supprimer, puis sélectionnez Supprimer le rapport.

Réexécuter un rapport

Pour obtenir des données mises à jour pour une plage de rapports donnée, sélectionnez un rapport existant, puis sélectionnez Exécuter.

Conseil

Une invite de réexécution s’affiche également si vous sélectionnez Ajouter un rapport et une plage de rapports pour laquelle il existe déjà un rapport.

Rapports App Insights dans le module PowerShell SharePoint

Vous pouvez générer et gérer des rapports App Insights à l’aide de SharePoint Online Management Shell.

  1. Téléchargez et installez la dernière version de SharePoint Online Management Shell.
  2. Connectez-vous à SharePoint Online en tant qu’administrateur SharePoint dans Microsoft 365. Pour plus d’informations sur SharePoint Online Management Shell, consultez Bien démarrer avec SharePoint Online Management Shell.
  3. Vérifiez que vous disposez de la licence Gestion avancée SharePoint.

Commandes PowerShell pour les rapports App Insights

Pour effectuer les opérations nécessaires, utilisez les commandes suivantes :

Créer un rapport de durée par défaut d’un jour

Pour générer un rapport pour la durée par défaut d’un jour, exécutez la commande suivante :

Start-SPOEnterpriseAppInsightsReport

Créer un rapport pour toute autre durée

Pour générer un rapport pour une autre durée, exécutez la commande suivante :

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

Vérifier status de tous les rapports actifs et disponibles

Pour case activée status de tous les rapports actifs et disponibles, exécutez la commande suivante :

Get-SPOEnterpriseAppInsightsReport

Vérifier status d’un rapport spécifique

Pour case activée status d’un rapport spécifique, exécutez la commande suivante :

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

Afficher un rapport spécifique

Pour afficher un rapport spécifique, exécutez la commande suivante :

Get-SPOEnterpriseAppInsightsReport -reportID $reportID

Télécharger un rapport

Pour télécharger le rapport, exécutez la commande suivante :

Get-SPOEnterpriseAppInsightsReport -reportID $reportID -action download

Importante

Les fonctionnalités de réexécuter et de supprimer des rapports ne sont pas disponibles pour PowerShell. Les applets de commande Créer un rapport peuvent être utilisées avec une durée de rapport appropriée.

Expériences connues

  • Dans les nouveaux locataires, la disponibilité des données et la génération de ces rapports peut prendre quelques jours. Dans les grands locataires, les données peuvent être retardées jusqu’à 48 heures (environ deux jours).
  • Un rapport ne peut être réexécuté qu’après 24 heures depuis la dernière génération de rapport.
  • Il ne peut y avoir qu’un seul rapport pour chaque valeur de la plage de rapports. Cela signifie que vous pouvez voir un maximum de quatre rapports dans la page d’accueil Enterprise Application Insights .
  • Ces rapports sont alimentés par des données d’audit et n’incluent pas tous les événements d’audit.
  • Vous pouvez voir l’ID d’application d’une application non-Microsoft, mais le nom d’application d’une application de niveau intermédiaire dans certains cas.
  • Last updated on