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

Ρύθμιση παραμέτρων αρχείων καταγραφής για την πύλη δεδομένων εσωτερικής εγκατάστασης

  • Άρθρο

Υπάρχουν τρεις κατηγορίες αρχείων καταγραφής υπηρεσίας για μια πύλη δεδομένων εσωτερικής εγκατάστασης: πληροφορίες, σφάλμα και δίκτυο. Αυτή η κατηγοριοποίηση παρέχει μια εμπειρία αντιμετώπισης προβλημάτων που σας επιτρέπει να εστιάσετε στη συγκεκριμένη περιοχή για ένα σφάλμα ή ένα πρόβλημα.

Για να ελέγξετε τις ρυθμίσεις παραμέτρων καταγραφής, ακολουθήστε τα παρακάτω βήματα:

  1. Ανοίξτε το αρχείο ρύθμισης παραμέτρων πύλης Microsoft.PowerBI.EnterpriseGateway.exe.config, το οποίο από προεπιλογή θα πρέπει να βρίσκεται στην περιοχή \Program Files\On-premises data gateway.
  2. Προτού συνεχίσετε περαιτέρω, δημιουργήσετε ένα αντίγραφο αυτού του αρχείου σε περίπτωση που χρειαστεί να το επαναφέρετε αργότερα.
  3. Εντοπίστε την υπηρεσία ακρόασης ApplicationFileTraceListener που βρίσκεται στην περιοχή system.diagnostics.

Οι παρακάτω ενότητες παρέχουν τις λεπτομέρειες ρύθμισης παραμέτρων ανά τύπο διατήρησης, το οποίο εξαρτάται από την έκδοση της πύλης σας.

Διατήρηση βάσει ηλικίας

Ξεκινώντας από τον Φεβρουάριο του 2023, παρουσιάστηκε η νέα έννοια διατήρησης βάσει ηλικίας μέσα σε μια πύλη. Αυτή η έννοια είναι ο προεπιλεγμένος τύπος διατήρησης για νέες εγκαταστάσεις πύλης.

Για αυτόν τον τύπο διατήρησης, υπάρχουν δύο κύριες πτυχές που πρέπει να λάβετε υπόψη (με σειρά προτεραιότητας):

  • Μέγιστος χώρος στον δίσκο που θα καταναλωθεί από αρχεία καταγραφής πύλης (GatewayInfo*.log, GatewayError*.log, GatewayNetwork*.log), με προεπιλεγμένη τιμή 5 GB.
  • Περίοδος διατήρησης σε ημέρες, με προεπιλεγμένη τιμή 30 ημερών.

Σε αυτήν τη νέα λογική, διασφαλίζουμε ότι για κάθε νέα ημέρα παρέχεται ένα νέο αρχείο καταγραφής. Αυτή η προμήθεια εξασφαλίζει ότι οι πληροφορίες για μια δεδομένη ημέρα υπάρχουν στα αρχεία καταγραφής όπου το όνομα αρχείου συμφωνεί με τις ημερομηνίες καταχώρησης αρχείου καταγραφής. Επίσης, το διαμέρισμα αρχείου εντός της ημέρας εκτελείται εάν επιτευχθεί το μέγιστο μεμονωμένο μέγεθος αρχείου (προεπιλογή 100 MB).

  <system.diagnostics>
    <trace autoflush="true" indentsize="4">
      <listeners>
        <remove name="Default" />
        <add name="ApplicationFileTraceListener" type="Microsoft.PowerBI.DataMovement.Pipeline.Common.Diagnostics.AgeBasedRetentionRotatableFilesManagerTraceListener, Microsoft.PowerBI.DataMovement.Pipeline.Common" initializeData="%LOCALAPPDATA%\Microsoft\On-premises data gateway\,30,5120,100" />
      </listeners>
    </trace>
  </system.diagnostics>

Εάν θέλετε να αλλάξετε τις τιμές προεπιλεγμένων παραμέτρων διατήρησης, θα πρέπει να τις προσαρμόσετε στην initializeData τιμή. Η παρακάτω λίστα περιγράφει κάθε παράμετρο:

  • Περίοδος διατήρησης σε ημέρες (τιμή μεταξύ 1 και 365 ημερών).
  • Μέγιστο συνολικό μέγεθος σε MB που μπορεί να καταναλωθεί από τους τρεις τύπους αρχείων καταγραφής.
  • Μέγιστο μέγεθος σε MB το οποίο κάθε αρχείο καταγραφής μπορεί να έχει ξεχωριστά. Κάθε φορά που προσεγγίζεται το όριο, δημιουργείται ένα νέο αρχείο με προσαρτημένο έναν διαδοχικό αριθμό.

Σημείωμα

Τα αρχεία καταγραφής πύλης χρησιμοποιούν χρονικές σημάνσεις που βασίζονται σε UTC και η περιστροφή του ημερήσιου αρχείου καταγραφής θα πραγματοποιηθεί στις 00:00 UTC.

Διατήρηση βάσει πλήθους αρχείων

Αυτή ήταν η προεπιλεγμένη λογική διατήρησης λογικής μέσα σε μια πύλη για τις εκδόσεις Δεκεμβρίου 2022 και προηγούμενες. Αυτή η λογική έχει δύο κύριες έννοιες:

  • Ο αριθμός των αρχείων που θα διατηρηθούν ανά τύπο αρχείου καταγραφής (GatewayInfo*.log, GatewayError*.log, GatewayNetwork*.log).
  • Μέγιστος χώρος στον δίσκο που θα καταναλωθεί ανά τύπο αρχείου καταγραφής (GatewayInfo*.log, GatewayError*.log, GatewayNetwork*.log).

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

Το ακόλουθο απόσπασμα από το αρχείο ρύθμισης παραμέτρων πύλης Microsoft.PowerBI.EnterpriseGateway.exe.config περιέχει τις τρεις κατηγορίες: GatewayInfo.log, GatewayErrors.logκαι GatewayNetwork.log.

  <system.diagnostics>
    <trace autoflush="true" indentsize="4">
      <listeners>
        <remove name="Default" />
        <add name="ApplicationFileTraceListener"
             type="Microsoft.PowerBI.DataMovement.Pipeline.Common.Diagnostics.RotatableFilesManagerTraceListener, Microsoft.PowerBI.DataMovement.Pipeline.Common"
             initializeData="%LOCALAPPDATA%\Microsoft\On-premises data gateway\,GatewayInfo.log,GatewayErrors.log,GatewayNetwork.log,20,50" />
      </listeners>
    </trace>
  </system.diagnostics>

Από προεπιλογή, το αρχείο ρύθμισης παραμέτρων πύλης βρίσκεται στον κατάλογο \Program Files\On-premises data gateway. Για να ορίσετε τον αριθμό των αρχείων καταγραφής προς διατήρηση, αλλάξτε τον πρώτο αριθμό στην τιμή του initializeData αρχείου. Για να ρυθμίσετε το μέγεθος κάθε αρχείου καταγραφής, αλλάξτε τον δεύτερο αριθμό.

Το παρακάτω παράδειγμα καθορίζει ότι 20 αρχεία καταγραφής, το άθροισμα όλων των αρχείων σε κάθε κατηγορία που δεν υπερβαίνουν τα 50 MB, θα διατηρηθεί: GatewayInfo.log,GatewayErrors.log,GatewayNetwork.log,20,50

Θα εφαρμοστεί η λογική διατήρησης βάσει νέας ηλικίας από προεπιλογή στην υπάρχουσα εγκατάσταση της πύλης δεδομένων εσωτερικής εγκατάστασης;

Όχι. Αυτή η λογική διατήρησης προς το παρόν εφαρμόζεται σε εντελώς νέες εγκαταστάσεις πύλης. Οι υπάρχουσες πύλες κατά την αναβάθμιση σε εκδόσεις Φεβρουαρίου 2023 ή νεότερες θα πρέπει να διατηρούν την τρέχουσα λογική διατήρησης λογικής λογικής (διατήρηση βάσει πλήθους αρχείων).

Επόμενα βήματα

Για πληροφορίες σχετικά με τον τρόπο εξαγωγής αρχείων καταγραφής πύλης για την αντιμετώπιση προβλημάτων, μεταβείτε στα Εργαλεία αντιμετώπισης προβλημάτων.