Κοινή χρήση μέσω

Παρακολούθηση δραστηριοτήτων χρηστών στο Power BI

  • Άρθρο

Το να γνωρίζετε ποιος κάνει τι και σε ποιο στοιχείο στο Power BI μπορεί να έχει κρίσιμη σημασία, προκειμένου η εταιρεία σας να συμμορφώνεται με τις απαιτήσεις, όπως η κανονιστική συμμόρφωση και η διαχείριση εγγραφών. Αυτό το άρθρο περιγράφει το αρχείο καταγραφής δραστηριότητας του Power BI, το οποίο βασίζεται στα API REST του Power BI.

Μπορείτε να παρακολουθήσετε δραστηριότητες χρηστών του Microsoft Fabric, συμπεριλαμβανομένων των λειτουργιών του Power BI, χρησιμοποιώντας το αρχείο καταγραφής ελέγχου.

Προαπαιτούμενα στοιχεία

  • Πρέπει να είστε καθολικός διαχειριστής ή διαχειριστής του Power BI

  • Εγκαταστήστε τα cmdlet διαχείρισης του Power BI τοπικά ή χρησιμοποιήστε τα cmdlet διαχείρισης του Power BI στο Azure Cloud Shell.

Αρχείο καταγραφής δραστηριότητας

Το αρχείο καταγραφής δραστηριότητας του Power BI περιέχει ένα πλήρες αντίγραφο των δραστηριοτήτων Power BI σε έναν πίνακα JSON. Μπορείτε να βρείτε μια λίστα με όλες τις δραστηριότητες Power BI στη λίστα λειτουργιών Fabric.

ActivityEvents REST API

Μπορείτε να χρησιμοποιήσετε μια εφαρμογή διαχείρισης με βάση τα Power BI REST API για να εξαγάγετε συμβάντα δραστηριότητας σε ένα χώρο αποθήκευσης αντικειμένων blob ή σε μια βάση δεδομένων SQL. Στη συνέχεια, μπορείτε να δημιουργήσετε μια προσαρμοσμένη αναφορά χρήσης πάνω από τα δεδομένα που έχουν εξαχθεί. Στην κλήση REST API ActivityEvents, πρέπει να καθορίσετε μια ημερομηνία έναρξης και λήξης και, προαιρετικά, ένα φίλτρο για να επιλέξετε δραστηριότητες κατά τύπο δραστηριότητας ή αναγνωριστικό χρήστη. Επειδή το αρχείο καταγραφής δραστηριότητας μπορεί να περιέχει μεγάλο όγκο δεδομένων, το API ActivityEvents υποστηρίζει προς το παρόν μόνο τη λήψη έως και μίας ημέρας δεδομένων ανά αίτηση. Με άλλα λόγια, η ημερομηνία έναρξης και λήξης πρέπει να καθορίσετε την ίδια ημέρα, όπως στο παρακάτω παράδειγμα. Βεβαιωθείτε ότι καθορίζετε τις DateTime τιμές σε μορφή Συντονισμένη παγκόσμιας ώρας (UTC).

https://api.powerbi.com/v1.0/myorg/admin/activityevents?startDateTime='2019-08-31T00:00:00'&endDateTime='2019-08-31T23:59:59'

Εάν ο αριθμός των καταχωρήσεων είναι μεγάλος, το API ActivityEvents επιστρέφει μόνο περίπου 5.000 έως 10.000 καταχωρήσεις και ένα διακριτικό συνέχειας. Καλέστε ξανά το API ActivityEvents με το διακριτικό συνέχειας για να λάβετε την επόμενη δέσμη καταχωρήσεων, και ούτω καθεξής, μέχρι να λάβετε όλες τις καταχωρήσεις και να μην λαμβάνετε πλέον διακριτικά συνέχειας. Το παρακάτω παράδειγμα δείχνει πώς μπορείτε να χρησιμοποιήσετε το διακριτικό συνέχειας:

https://api.powerbi.com/v1.0/myorg/admin/activityevents?continuationToken='%2BRID%3ARthsAIwfWGcVAAAAAAAAAA%3D%3D%23RT%3A4%23TRC%3A20%23FPC%3AARUAAAAAAAAAFwAAAAAAAAA%3D'

Εάν τα αποτελέσματα περιλαμβάνουν ένα διακριτικό συνέχειας, συνεχίστε να καλείτε το API χρησιμοποιώντας αυτό το διακριτικό για να λάβετε τα υπόλοιπα δεδομένα μέχρι να μην επιστρέφεται πλέον ένα διακριτικό συνέχειας. Είναι πιθανό μια κλήση να επιστρέψει ένα διακριτικό συνέχειας χωρίς καταχωρήσεις συμβάντων. Το παρακάτω παράδειγμα δείχνει πώς μπορείτε να κάνετε βρόχο με ένα διακριτικό συνέχειας που επιστρέφεται στην απόκριση:

while(response.ContinuationToken != null)
{
   // Store the activity event results in a list for example
    completeListOfActivityEvents.AddRange(response.ActivityEventEntities);

    // Make another call to the API with continuation token
    response = GetPowerBIActivityEvents(response.ContinuationToken)
}
completeListOfActivityEvents.AddRange(response.ActivityEventEntities);

Εάν το χρονικό διάστημα μεταξύ startDateTime και endDateTime υπερβαίνει την 1 ώρα, απαιτούνται πολλές αιτήσεις για τη λήψη των δεδομένων continuationUri μέσω της απόκρισης.

Το παρακάτω παράδειγμα δείχνει πώς μπορείτε να κάνετε λήψη δεδομένων για 1 ώρα και 5 λεπτά:

GET https://wabi-staging-us-east-redirect.analysis.windows.net/v1.0/myorg/admin/activityevents?startDateTime='2020-08-13T07:55:00Z'&endDateTime='2020-08-13T09:00:00Z'
{
  "activityEventEntities": […],
  "continuationUri": https://wabi-staging-us-east-redirect.analysis.windows.net/v1.0/myorg/admin/activityevents?continuationToken='LDIwMjAtMDgtMTNUMDc6NTU6MDBaLDIwMjAtMDgtMTNUMDk6MDA6MDBaLDEsLA%3D%3D',
  "continuationToken": "LDIwMjAtMDgtMTNUMDc6NTU6MDBaLDIwMjAtMDgtMTNUMDk6MDA6MDBaLDEsLA%3D%3D",
  "lastResultSet": false
}

GET https://wabi-staging-us-east-redirect.analysis.windows.net/v1.0/myorg/admin/activityevents?continuationToken='LDIwMjAtMDgtMTNUMDc6NTU6MDBaLDIwMjAtMDgtMTNUMDk6MDA6MDBaLDEsLA%3D%3D'
{
  "activityEventEntities": [],
  "continuationUri": null,
  "continuationToken": null,
  "lastResultSet": false
}

Για να μάθετε περισσότερα σχετικά με τη χρήση του Power BI REST API, συμπεριλαμβανομένων παραδειγμάτων για τον τρόπο λήψης συμβάντων δραστηριότητας ελέγχου, ανατρέξτε στο θέμα Διαχείριση - Λήψη συμβάντων δραστηριότητας στην τεκμηρίωση αναφοράς του Power BI REST API.

Cmdlet Get-PowerBIActivityEvent

Κάντε λήψη συμβάντων δραστηριότητας χρησιμοποιώντας τα cmdlet διαχείρισης του Power BI για το PowerShell. Το cmdlet Get-PowerBIActivityEvent χειρίζεται αυτόματα το διακριτικό συνέχειας για εσάς. Το Get-PowerBIActivityEvent cmdlet λαμβάνει μια παράμετρο StartDateTime και μια παράμετρο EndDateTime με τους ίδιους περιορισμούς με το REST API ActivityEvents . Με άλλα λόγια, η ημερομηνία έναρξης και λήξης πρέπει να αναφέρει την ίδια τιμή ημερομηνίας, καθώς μπορείτε να ανακτήσετε μόνο τα δεδομένα δραστηριότητας για μία ημέρα κάθε φορά.

Η ακόλουθη δέσμη ενεργειών παρουσιάζει τον τρόπο λήψης όλων των δραστηριοτήτων Power BI. Η εντολή μετατρέπει τα αποτελέσματα από JSON σε αντικείμενα .NET για άμεση πρόσβαση σε μεμονωμένες ιδιότητες δραστηριότητας. Αυτά τα παραδείγματα εμφανίζουν τις μικρότερες και μεγαλύτερες χρονικές σημάνσεις για μια ημέρα, ώστε να εξασφαλίζεται ότι δεν θα λείπουν συμβάντα:

Login-PowerBI

$activities = Get-PowerBIActivityEvent -StartDateTime '2019-08-31T00:00:00' -EndDateTime '2019-08-31T23:59:59' | ConvertFrom-Json

$activities.Count
$activities[0]

Φιλτράρισμα δεδομένων δραστηριότητας

Μπορείτε να φιλτράρετε συμβάντα δραστηριότητας κατά τύπο δραστηριότητας και αναγνωριστικό χρήστη. Η ακόλουθη δέσμη ενεργειών παρουσιάζει τον τρόπο λήψης μόνο των δεδομένων συμβάντων για τη δραστηριότητα ViewDashboard . Για πρόσθετες πληροφορίες σχετικά με τις υποστηριζόμενες παραμέτρους, χρησιμοποιήστε την εντολή Get-Help Get-PowerBIActivityEvent.

Login-PowerBI

$activities = Get-PowerBIActivityEvent -StartDateTime '2019-08-31T00:00:00' -EndDateTime '2019-08-31T23:59:59' -ActivityType 'ViewDashboard' | ConvertFrom-Json

$activities.Count
$activities[0]

Σημείωμα

Ένα δείγμα PowerShell είναι διαθέσιμο για να σας βοηθήσει να μάθετε πώς να φιλτράρετε και να ανακτάτε συμβάντα αρχείου καταγραφής δραστηριότητας του Power BI. Για περισσότερες πληροφορίες, ανατρέξτε στο θέμα Πρόσβαση στο αρχείο καταγραφής δραστηριότητας του Power BI.

Σχετικό περιεχόμενο