Ρύθμιση παραμέτρων αρχείων καταγραφής ενεργειών ροής επιφάνειας εργασίας
Αυτή η σελίδα παρέχει οδηγίες ρύθμισης παραμέτρων για αρχεία καταγραφής ροής επιφάνειας εργασίας, που βρίσκονται κάτω από την ενότητα δυνατοτήτων του περιβάλλοντος στο κέντρο διαχείρισης του Power Platform.
Σημαντικό
- Αυτή η δυνατότητα ισχύει μόνο για ροές επιφάνειας εργασίας που εκκινούνται από μια ροή cloud και δεν είναι ακόμη διαθέσιμη για τοπικές επιτηρούμενες εκτελέσεις από Power Automate επιφάνεια εργασίας.
Η ρύθμιση Κατάσταση ενεργοποίησης των αρχείων καταγραφής ενεργειών εκτέλεσης καθορίζει πότε πρέπει να καταγραφούν τα αρχεία καταγραφής ενεργειών εκτέλεσης ροής επιφάνειας εργασίας και σας επιτρέπει ακόμα και να τα απενεργοποιήσετε πλήρως.
| Κατάσταση ενεργοποίησης | Details |
|---|---|
| Ενεργοποιημένο (προεπιλογή) | Αυτή η επιλογή είναι η προεπιλογή τόσο για τα υπάρχοντα όσο και για τα νέα περιβάλλοντα, όπου τα αρχεία καταγραφής καταγράφονται ως συνήθως. |
| Αποτυχία κατά την εκτέλεση | Αυτή η επιλογή καταγράφει μόνο αρχεία καταγραφής ενεργειών ροής επιφάνειας εργασίας όταν υπάρχει σφάλμα χρόνου εκτέλεσης. Αυτό σημαίνει ότι τα αρχεία καταγραφής δεν είναι διαθέσιμα για κάθε εκτέλεση, αλλά μόνο όταν παρουσιάζεται σφάλμα. Ωστόσο, εάν παρουσιαστεί σφάλμα, είναι διαθέσιμα όλα τα αρχεία καταγραφής για τη συγκεκριμένη εκτέλεση, συμπεριλαμβανομένων των ενεργειών που είναι επιτυχημένες και αποτυχημένες. |
| Απενεργοποιημένο | Αυτή η επιλογή απενεργοποιεί αποτελεσματικά τα αρχεία καταγραφής ενεργειών εκτέλεσης ροής επιφάνειας εργασίας πλήρως. |
Προσοχή
Η αλλαγή αυτών των ρυθμίσεων μπορεί να επηρεάσει σημαντικά δυνατότητες, όπως η αντιμετώπιση προβλημάτων αποτυχίας εκτέλεσης και ο έλεγχος. Λάβετε υπόψη σας τις επιπτώσεις της αλλαγής αυτών των ρυθμίσεων πριν να συνεχίσετε.
Προϋποθέσεις
- Premium Power Automate άδεια χρήσης και δικαιώματα διαχειριστή για τη ρύθμιση παραμέτρων των ρυθμίσεων καταγραφής
- Ρύθμιση παραμέτρων διεύθυνσης IP και URL Power Automate
Ρύθμιση παραμέτρων έκδοσης αρχείων καταγραφής ενεργειών ροής επιφάνειας εργασίας
Η έκδοση των αρχείων καταγραφής ενεργειών σάς επιτρέπει να επιλέξετε V1, V2 ή και τα δύο.
| Έκδοση αρχείων καταγραφής | Επεξήγηση |
|---|---|
| V1 - Αποθηκευμένο στο πεδίο AdditionalContext της οντότητας FlowSession | Αυτή η επιλογή είναι η προεπιλεγμένη. Τα αρχεία καταγραφής αποθηκεύονται στο πεδίο AdditionalContext του πίνακα "Περίοδος λειτουργίας ροής", το οποίο είναι ένα χαρακτηριστικό αρχείου που αποθηκεύεται ως αντικείμενο blob στο Microsoft Dataverse. Τα αρχεία καταγραφής V1 καταναλώνουν χωρητικότητα αρχείων Dataverse. |
| V2 - Αποθηκεύεται στην οντότητα FlowLogs | Αυτή η επιλογή σάς επιτρέπει να αποθηκεύετε αρχεία καταγραφής στον πίνακα "Αρχεία καταγραφής ροής", ο οποίος αποθηκεύεται σε Ελαστικούς πίνακες. Τα αρχεία καταγραφής V2 καταναλώνουν χωρητικότητα βάσης δεδομένων Dataverse. |
| Και τα δύο | Αυτή η ρύθμιση επιτρέπει την αποθήκευση των αρχείων καταγραφής τόσο στο χαρακτηριστικό πεδίο AdditionalContext του πίνακα "Περίοδος λειτουργίας ροής" όσο και στον πίνακα "Αρχεία καταγραφής ροής". Αυτή η δυνατότητα καταναλώνει τόσο τη χωρητικότητα αρχείων και βάσης δεδομένων του Dataverse. Σκοπός είναι ο εντοπισμός σφαλμάτων ή οι δοκιμές, καθώς καταναλώνει τόσο τη χωρητικότητα βάσης δεδομένων και αρχείων του Dataverse. |
Η τιμή του χρόνου έως παραγωγική λειτουργία της οντότητας FlowLogs σε λεπτά καθορίζει πόσο καιρό θα πρέπει να διατηρηθούν τα αρχεία καταγραφής ενεργειών στον ελαστικό πίνακα των αρχείων καταγραφής ροής. Το Dataverse διαγράφει αυτόματα καρτέλες που είναι παλαιότερες από το καθορισμένο χρονικό πλαίσιο. Ακολουθούν ορισμένα παραδείγματα τιμών για ευκολία σας.
| ημέρες | Λεπτά |
|---|---|
| Μία ημέρα | 1,440 λεπτά |
| Τρεις μέρες | 4,320 λεπτά |
| Εφτά ημέρες | 10,080 λεπτά |
| 14 ημέρες | 20,160 λεπτά |
| Τελευταίες 28 ημέρες | 40,320 λεπτά |
| 60 ημέρες | 86,400 λεπτά |
| 90 ημέρες | 129,600 λεπτά |
| 180 ημέρες | 259,200 λεπτά |
| Τελευταίες 365 ημέρες | 525,600 λεπτά |
| Πάντα | 0 (μηδέν) λεπτά |
Σημείωμα
Πριν ενεργοποιήσετε τα αρχεία καταγραφής V2, βεβαιωθείτε ότι έχετε επαρκή χωρητικότητα βάσης δεδομένων Dataverse που θα μπορούσε να υποστηρίξει τις ρυθμίσεις διατήρησης δεδομένων και να ευθυγραμμίζεται με τον σχεδιασμό της χωρητικότητάς σας, τα δικαιώματα και την προσαρμογή, όπως απαιτείται. Δείτε την ακόλουθη ενότητα Υπολογισμοί ζήτησης δείγματος χωρητικότητας Dataverse για αρχεία καταγραφής V2 για ορισμένα παραδείγματα αλλαγής μεγέθους.
Βασικές διαφορές στα αρχεία καταγραφής ροής επιφάνειας εργασίας V1 και V2
Ο παρακάτω πίνακας περιγράφει τις διαφορές μεταξύ των αρχείων καταγραφής ροής επιφάνειας εργασίας V1 και V2:
| Χαρακτηριστικό | Αρχεία καταγραφής V1 | Αρχεία καταγραφής V2 | Details |
|---|---|---|---|
| Αυτόματη ανανέωση δεδομένων | Μη διαθέσιμο | Διαθέσιμος | Η V2 χρησιμοποιεί Ελαστικούς πίνακες, που προσφέρονται από το Azure Cosmos DB και διαθέτουν μια ενσωματωμένη δυνατότητα για αυτόματη διατήρηση δεδομένων σε χρόνο για παραγωγική λειτουργία. |
| Υποστήριξη για μεγάλα μεγέθη αρχείων καταγραφής | Κατά προσέγγιση έως 50.000 έως 80.000 αρχεία καταγραφής ενεργειών (μέγιστη) | Τουλάχιστον 100K ενέργειες, μπορούν να φτάσουν έως και 10M ενέργειες ανάλογα με τις ενέργειες που δημιουργούνται και τη διάρκεια εκτέλεσης | Το V2 μπορεί θεωρητικά να κλιμακώσει αρχεία καταγραφής ενεργειών αξίας έως και gigabyte ανά εκτέλεση στο μέλλον, ενώ το V1 μπορεί να κλιμακωθεί μόνο στον όγκο που καθορίζεται σε αυτόν τον πίνακα. |
| Υποστήριξη για σύνθετες αναφορές και διαχείριση | Μη διαθέσιμο | Διαθέσιμος | Στο V1, το χαρακτηριστικό AdditionalContext είναι ένας τύπος αρχείου, που αποθηκεύεται ως αντικείμενο blob στο Dataverse, καθιστώντας πρόκληση την ανάλυση για στοιχεία ελέγχου αναφοράς και διαχείρισης. Τα αρχεία καταγραφής είναι πολύ πιο προσβάσιμα στη V2. |
| Υποστήριξη για Σύνδεση Azure Synapse για ενοποίηση του Dataverse | Μη διαθέσιμο | Διαθέσιμος | Στο V1, το χαρακτηριστικό AdditionalContext είναι ένας τύπος αρχείου, αποθηκευμένος ως αντικείμενο blob στο Dataverse, ο οποίος δεν υποστηρίζεται για συγχρονισμό στο Azure Synapse. |
| Υποστήριξη για έλεγχο του Dataverse | Μη διαθέσιμο | Διαθέσιμος | Στο V1, το χαρακτηριστικό AdditionalContext είναι ένας τύπος αρχείου, αποθηκευμένος ως αντικείμενο blob στο Dataverse, ο οποίος δεν υποστηρίζεται στον έλεγχο Dataverse. |
| Υποστήριξη για μακρόχρονη διατήρηση του Dataverse | Μη διαθέσιμο | Προγραμματισμένη | Στο V1, το χαρακτηριστικό AdditionalContext είναι ένας τύπος αρχείου, αποθηκευμένος ως αντικείμενο blob στο Dataverse, ο οποίος δεν υποστηρίζεται στη μακρόχρονη διατήρηση του Dataverse. |
| Με βάση τον έλεγχο πρόσβασης βάσει ρόλου (RBAC) του Dataverse | Διαθέσιμος | Διαθέσιμος | Και οι δύο εκδόσεις χρησιμοποιούν το Dataverse RBAC, κληρονομώντας δικαιώματα αρχείων καταγραφής ενεργειών από την καρτέλα περιόδου λειτουργίας γονικής ροής. |
Τα αρχεία καταγραφής V2 προσφέρουν σημαντικές βελτιώσεις σε σχέση με την προηγούμενη έκδοση, V1. Η V2 χρησιμοποιεί τη δυνατότητα των ελαστικών πινάκων, η οποία είναι μια καλή επιλογή για τον χειρισμό μεγάλων όγκων δεδομένων, όπως σενάρια αρχείων καταγραφής ενεργειών, και διαθέτει ενσωματωμένη διατήρηση δεδομένων (TTL). Ιδανικό για οργανισμούς που χρειάζεται να έχουν πρόσβαση σε σημαντικό αριθμό δεδομένων για δημιουργία αναφορών, διαχείριση και ενοποίηση με αυτόματο έλεγχο διατήρησης δεδομένων.
Η χωρητικότητα του Dataverse απαιτεί υπολογισμούς για αρχεία καταγραφής V2
Ο παρακάτω πίνακας δείχνει το δείγμα χώρου αποθήκευσης της βάσης δεδομένων Dataverse σύμφωνα με τις εκτιμήσεις κατά την εκτέλεση ροής επιφάνειας εργασίας κατά τη χρήση αρχείων καταγραφής V2. Περιγράφει την κατά προσέγγιση ζήτηση χώρου αποθήκευσης για διαφορετικούς αριθμούς ενεργειών, με προϋπόθεση έναν μέσο χώρο αποθήκευσης 3 KB ανά ενέργεια.
| Αριθμός ενεργειών | Ζήτηση χώρου αποθήκευσης ανά ενέργεια (KB) | Συνολικός χώρος αποθήκευσης (MB) |
|---|---|---|
| 1,000 | 3 | 2.93 |
| 10,000 | 3 | 29.3 |
| 30,000 | 3 | 87.9 |
| 60,000 | 3 | 175.8 |
| 100,000 | 3 | 293 |
| 160,000 | 3 | 480 |
Σημαντικό
Τα στοιχεία που παρουσιάζονται στον παραπάνω πίνακα είναι απλώς εκτιμήσεις και η πραγματική κατανάλωση χώρου αποθήκευσης μπορεί να ποικίλει σημαντικά. Η ακριβής ζήτηση χώρου αποθήκευσης εξαρτάται από τις συγκεκριμένες λεπτομέρειες και την πολυπλοκότητα κάθε αρχείου καταγραφής ενεργειών. Επομένως, αυτοί οι αριθμοί θα πρέπει να χρησιμοποιηθούν ως γενικός οδηγός κατανόησης της δυνητικής ζήτησης χώρου αποθήκευσης και τον σχεδιασμό των απαιτήσεων χώρου αποθήκευσης αντίστοιχα.
Υποβολή ερωτήματος για δεδομένα V2 αρχείων καταγραφής
Η πρόσβαση σε δεδομένα αρχείων καταγραφής ενεργειών ροής επιφάνειας εργασίας μπορεί να επιτευχθεί με την πραγματοποίηση μιας κλήσης API στο παρασκήνιο του Dataverse, είτε χρησιμοποιώντας την παραδοσιακή σύνταξη κλήσεων API είτε χρησιμοποιώντας τη νέα μέθοδο ExecuteCosmosSqlQuery. Αυτή η μέθοδος σας επιτρέπει να εκτελείτε ένα ερώτημα SQL έναντι Dataverse, ενεργοποιώντας την ανάκτηση και το φιλτράρισμα δεδομένων.
Το μοντέλο δεδομένων των αρχείων καταγραφής V2 βασίζεται σε μια σχέση γονικού-θυγατρικού στοιχείου μεταξύ των πινάκων Περίοδος λειτουργίας ροής και Αρχείων καταγραφής ροής. Σε κάθε καρτέλα μεταβιβάζονται δικαιώματα από την καρτέλα περιόδου λειτουργίας γονικής ροής. Για να υποβληθούν ερωτήματα για τα αρχεία καταγραφής ενεργειών μιας συγκεκριμένης εκτέλεσης ροής επιφάνειας εργασίας, μπορείτε να χρησιμοποιήσετε την παρακάτω σύνταξη ερωτήματος.
Παραδοσιακή σύνταξη κλήσεων API Dataverse
Η παρακάτω κλήση API ανακτά μια συγκεκριμένη περίοδο λειτουργίας ροής από το αναγνωριστικό (9d51aa1f-315e-43ab-894f-bc445dfb049b) και, στη συνέχεια, έχει πρόσβαση στα σχετικά αρχεία καταγραφής ενεργειών χρησιμοποιώντας τη σχέση flowsession_flowlog_parentobjectid.
[Organization URI]/api/data/v9.0/flowsessions(9d51aa1f-315e-43ab-894f-bc445dfb049b)/flowsession_flowlog_parentobjectid
Νέα σύνταξη κλήσεων ΑΡΙ ExecuteCosοsqlQuery με χρήση του πίνακα FlowLogs
[Organization URI]/api/data/v9.2/ExecuteCosmosSqlQuery(
QueryText=@p1,EntityLogicalName=@p2,QueryParameters=@p3,PageSize=@p4)?
@p1: 'SELECT c.props.flowlogid as flowlogid, c.props.createdon as createdon, c.props.data as data, c.props.level as level, c.props.type as type, c.ttl as ttlinseconds, c.props.cloudflowid as cloudflowid, c.props.cloudflowrunid as cloudflowrunid, c.props.desktopflowid as desktopflowid, c.props.flowmachineid as flowmachineid, c.props.flowmachinegroupid as flowmachinegroupid, c.props.flowsessionid as flowsessionid, c.props.workqueueid as workqueueid, c.props.workqueueitemid as workqueueitemid FROM c WHERE c.props.type IN (100000001) ORDER BY c.props.data.startTime DESC'
@p2: 'flowlog'
@p3: {"Keys":["@referencingParentId","@referencingParentLogicalName"],"Values":[{"Type":"System.Guid","Value":"40590757-a9c0-4f4c-abfc-e2f389049d90"},{"Type":"System.String","Value":"flowsession"}]}
@p4: 50
Μάθετε περισσότερα σχετικά με την υποβολή ερωτημάτων σε στήλες JSON σε ελαστικούς πίνακες.
Διακοπή της κλήσης σε μεμονωμένα τεμάχια
- Η βασική διεύθυνση URL (https://[my org].api.crm[my region].dynamics.com/api/data/v9.2/) είναι το τελικό σημείο για το API Web Dataverse.
- ExecuteCosοsqlQuery είναι η μέθοδος που καλείται. Αυτή η μέθοδος επιτρέπει την εκτέλεση ενός ερωτήματος SQL κατά Dataverse.
- Οι παράμετροι για τη μέθοδο E ExecuteCosmosSqlQuery παρέχονται σε παρένθεση που ακολουθεί το όνομα της μεθόδου:
-
QueryText=@p1: Το ερώτημα SQL που θα εκτελεστεί. Σε αυτήν την περίπτωση, το ερώτημα επιλέγει διάφορες ιδιότητες από έναν πίνακα όπου ο τύπος είναι 100000001 (τύπος αρχείου καταγραφής ενέργειας ροής επιφάνειας εργασίας) και παραγγέλνει τα αποτελέσματα από την ιδιότητα startTime σε φθίνουσα σειρά. -
EntityLogicalName=@p2: Αυτή η ενότητα είναι το λογικό όνομα του πίνακα (flowlog) που αποθηκεύει τα αρχεία καταγραφής ενεργειών. -
QueryParameters=@p3: Αυτή η ενότητα είναι ένα αντικείμενο JSON που καθορίζει παραμέτρους για το ερώτημα. Στο προηγούμενο παράδειγμα, προσδιορίζει ένα ζεύγος τιμής κλειδιού όπου το κλειδί είναι@referencingParentIdκαι η τιμή είναι το@referencingParentLogicalNameμε τιμέςflowsessionid(GUID) και τύπο πίνακαflowsession. -
PageSize=p4: Αυτή η ενότητα είναι το μέγεθος σελίδας ερωτήματος.
-
Γνωστοί περιορισμοί
- Τα αρχεία καταγραφής V2 είναι διαθέσιμα μόνο για εκτελέσεις ροής επιφάνειας εργασίας που ξεκινούν από μια ροή cloud μέσω της ενέργειας σύνδεσης ροής επιφάνειας εργασίας.
- Οι εργασίες μαζικής διαγραφής δεν υποστηρίζονται προς το παρόν για τον πίνακα αρχείων καταγραφής ροής.
- Οι καρτέλες αρχείων καταγραφής ροής δεν μπορούν ακόμη να προβληθούν στην ενότητα Πίνακας του Maker Portal (make.powerapps.com).
- Η αλλαγή της έκδοσης του αρχείου καταγραφής ενεργειών δεν μετεγκαθιστά προηγούμενα αρχεία καταγραφής ενεργειών ροής επιφάνειας εργασίας στο νέο τύπο χώρου αποθήκευσης αρχείων καταγραφής.