Προβολή αρχείων καταγραφής συναρτήσεων δεδομένων χρήστη

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

  • Κατά τη διάρκεια της δοκιμής - Προβολή αρχείων καταγραφής σε πραγματικό χρόνο στον πίνακα δοκιμής κατά τη δοκιμή λειτουργιών σε λειτουργία ανάπτυξης
  • Μετά την κλήση - Προβολή ιστορικών αρχείων καταγραφής για δημοσιευμένες συναρτήσεις που έχουν κληθεί

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

Προβολή αρχείων καταγραφής κατά τη διάρκεια της δοκιμής

Όταν δοκιμάζετε συναρτήσεις, μπορείτε να δείτε αρχεία καταγραφής σε πραγματικό χρόνο καθώς εκτελείται η συνάρτησή σας:

  • Πίνακας δοκιμής σε λειτουργία ανάπτυξης - Προβολή αρχείων καταγραφής κατά τη δοκιμή μη δημοσιευμένων ή δημοσιευμένων λειτουργιών
  • Πίνακας "Εκτέλεση" σε λειτουργία "Εκτέλεση μόνο " - Προβολή αρχείων καταγραφής κατά την εκτέλεση δημοσιευμένων συναρτήσεων

Και οι δύο πίνακες εμφανίζουν αμέσως την έξοδο του αρχείου καταγραφής, επιτρέποντάς σας να βλέπετε λεπτομέρειες εκτέλεσης και να διορθώνετε προβλήματα καθώς προκύπτουν. Για περισσότερες πληροφορίες σχετικά με τη δοκιμή συναρτήσεων, ανατρέξτε στο θέμα Δοκιμή των συναρτήσεων δεδομένων χρήστη.

Προβολή ιστορικών αρχείων καταγραφής για καλούμενες συναρτήσεις

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

Για να αποκτήσετε πρόσβαση σε ιστορικά αρχεία καταγραφής:

  1. Μεταβείτε στη λειτουργία Μόνο εκτέλεση χρησιμοποιώντας την εναλλαγή λειτουργίας.

  2. Τοποθετήστε το δείκτη του ποντικιού πάνω από το όνομα της συνάρτησης στη λίστα συναρτήσεων.

  3. Επιλέξτε το εικονίδιο αποσιωπητικών (...) και, στη συνέχεια, επιλέξτε Προβολή αρχείου καταγραφής ιστορικού.

    Στιγμιότυπο οθόνης που εμφανίζει τον τρόπο προβολής των αρχείων καταγραφής ιστορικού για μια συνάρτηση.

Κατανόηση της προβολής ιστορικών αρχείων καταγραφής

Η προβολή ιστορικών αρχείων καταγραφής εμφανίζει πρόσφατες κλήσεις για την επιλεγμένη συνάρτηση. Μπορείτε να δείτε έως και 50 καταχωρήσεις και τα αρχεία καταγραφής διατηρούνται για 30 ημέρες. Επιλέξτε τη σύνδεση ημερομηνίας στη στήλη Ημερομηνία (UTC) για να προβάλετε λεπτομερή αρχεία καταγραφής για μια συγκεκριμένη κλήση.

Στιγμιότυπο οθόνης που δείχνει πώς μπορείτε να προβάλετε όλες τις κλήσεις για τις συναρτήσεις που έχουν παραγγελχθεί κατά ημερομηνία.

Το τμήμα παραθύρου Όλα τα ιστορικά αρχεία καταγραφής περιέχει τις ακόλουθες πληροφορίες ανά κλήση:

  • Ημερομηνία (UTC). Η χρονική σήμανση που εμφανίζει την αρχή της κλήσης της συνάρτησης. Επιλέξτε τη σύνδεση για να εξετάσετε όλα τα αρχεία καταγραφής για αυτήν την κλήση. Εμφανίζει τις λεπτομέρειες της κλήσης με όλα τα μηνύματα που έχουν καταγραφεί από τον χρήστη ή την υπηρεσία.
  • κατάστασης. Υποδεικνύει εάν η κλήση ολοκληρώθηκε με επιτυχία ή απέτυχε.
  • Duration(ms). Η διάρκεια εκτέλεσης της συνάρτησης σε χιλιοστά του δευτερολέπτου.
  • αναγνωριστικό κλήσης . Το αναγνωριστικό της συγκεκριμένης κλήσης συνάρτησης. Το αναγνωριστικό κλήσης επιστρέφεται ως μέρος μιας κεφαλίδας HTTP. Εάν υπάρχουν προβλήματα, οι χρήστες μπορούν να αναφέρουν αυτό το αναγνωριστικό κλήσης σε μια αίτηση υποστήριξης για την ανάκτηση περισσότερων πληροφοριών σχετικά με την κλήση.

Προβολή λεπτομερών αρχείων καταγραφής για μια συγκεκριμένη κλήση

Αφού ανοίξετε την προβολή ιστορικών αρχείων καταγραφής (όπως περιγράφεται στην προηγούμενη ενότητα), μπορείτε να κάνετε λεπτομερή έρευνα σε μεμονωμένες κλήσεις. Όταν επιλέγετε μια σύνδεση χρονικής σήμανσης στη στήλη Ημερομηνία (UTC), ανοίγει το τμήμα παραθύρου Λεπτομέρειες κλήσης για να εμφανιστούν όλα τα αρχεία καταγραφής για αυτήν την κλήση. Μπορείτε να προβάλετε:

  • Όλα τα αρχεία καταγραφής προστέθηκαν στον κώδικα της συνάρτησής σας χρησιμοποιώντας τη logging μονάδα
  • Αρχεία καταγραφής που δημιουργούνται από το σύστημα σχετικά με την εκτέλεση συναρτήσεων
  • Τυχόν σφάλματα ή εξαιρέσεις που προέκυψαν

Κάθε καταχώρηση αρχείου καταγραφής περιλαμβάνει τη χρονική σήμανση, το μήνυμα καταγραφής και το επίπεδο καταγραφής (Πληροφορίες, Προειδοποίηση, Σφάλμα, Κρίσιμο).

Στιγμιότυπο οθόνης που δείχνει πώς μπορείτε να αναλύετε τα αρχεία καταγραφής για μια δεδομένη κλήση συνάρτησης.

Προσθέστε καταγραφή στις συναρτήσεις σας

Μπορείτε να προσθέσετε προσαρμοσμένες προτάσεις καταγραφής στις συναρτήσεις σας χρησιμοποιώντας την τυπική logging ενότητα της Python. Τα αρχεία καταγραφής σάς βοηθούν να παρακολουθείτε τη συμπεριφορά των λειτουργιών, να παρακολουθείτε την επεξεργασία δεδομένων και να διαγιγνώσκετε προβλήματα.

Εισαγωγή της λειτουργικής μονάδας καταγραφής

Αρχικά, εισαγάγετε το logging άρθρωμα στον κώδικα συνάρτησής σας:

import logging

Σημείωμα

Η logging λειτουργική μονάδα εισάγεται από προεπιλογή όταν δημιουργείτε ένα νέο στοιχείο Συναρτήσεις δεδομένων χρήστη στην πύλη Fabric ή χρησιμοποιώντας την επέκταση VS Code.

Χρήση κατάλληλων επιπέδων καταγραφής

Η Python παρέχει διαφορετικά επίπεδα καταγραφής για διαφορετικές καταστάσεις. Χρησιμοποιήστε το κατάλληλο επίπεδο για να κάνετε τα αρχεία καταγραφής σας πιο ουσιαστικά:

# INFO - Track normal function execution and key steps
logging.info('Processing started for customer ID: 12345')
logging.info('Successfully retrieved 150 records from database')

# WARNING - Log potentially problematic situations that don't prevent execution
logging.warning('API response time exceeded 2 seconds')
logging.warning('Using cached data because fresh data is unavailable')

# ERROR - Log errors that affect functionality but don't crash the function
logging.error('Failed to connect to external API: Connection timeout')
logging.error('Invalid data format in row 42')

# CRITICAL - Log severe errors that may cause function failure
logging.critical('Database connection lost')
logging.critical('Required configuration parameter missing')

Βέλτιστες πρακτικές για την καταγραφή

Ακολουθήστε αυτές τις πρακτικές για να κάνετε τα αρχεία καταγραφής σας πιο αποτελεσματικά:

  • Καταγραφή σημαντικών πληροφοριών - Συμπεριλάβετε σχετικές λεπτομέρειες, όπως αναγνωριστικά, μετρήσεις ή τιμές παραμέτρων που βοηθούν στη διάγνωση προβλημάτων
  • Χρησιμοποιήστε κατάλληλα επίπεδα καταγραφής - Μην καταγράφετε τα πάντα ως ΠΛΗΡΟΦΟΡΙΕΣ ή ΣΦΑΛΜΑ. Χρησιμοποιήστε το σωστό επίπεδο για την κατάσταση
  • Σύνδεση σε βασικά σημεία - Προσθέστε αρχεία καταγραφής στην αρχή των λειτουργιών, πριν και μετά από εξωτερικές κλήσεις και κατά την επεξεργασία δεδομένων
  • Αποφύγετε την καταγραφή ευαίσθητων δεδομένων - Μην καταγράφετε κωδικούς πρόσβασης, διακριτικά, προσωπικές πληροφορίες ή άλλα ευαίσθητα δεδομένα
  • Διατηρήστε τα μηνύματα συνοπτικά - Γράψτε σαφή, σύντομα μηνύματα καταγραφής που είναι εύκολο να σαρωθούν
  • Προσοχή στον όγκο - Η υπερβολική καταγραφή μπορεί να επηρεάσει την απόδοση και να φτάσει το ημερήσιο όριο κατάποσης

Για περισσότερες πληροφορίες σχετικά με τη σύνταξη κώδικα συνάρτησης, ανατρέξτε στο μοντέλο προγραμματισμού Python.

Περιορισμοί και διατήρηση αρχείων καταγραφής

Λάβετε υπόψη τους ακόλουθους περιορισμούς όταν εργάζεστε με αρχεία καταγραφής:

  • Διατήρηση αρχείου καταγραφής - Τα αρχεία καταγραφής ιστορικού κλήσεων διατηρούνται για 30 ημέρες από προεπιλογή
  • Ορατές καταχωρήσεις - Η προβολή ιστορικών αρχείων καταγραφής εμφανίζει έως και 50 καταχωρήσεις ανά συνάρτηση
  • Διαθεσιμότητα αρχείου καταγραφής - Τα αρχεία καταγραφής κλήσεων μπορεί να χρειαστούν μερικά λεπτά για να εμφανιστούν. Ανανεώστε τη σελίδα εάν δεν βλέπετε πρόσφατα αρχεία καταγραφής
  • Ημερήσιο όριο κατάποσης - 250 MB ανά ημέρα. Το όριο μηδενίζεται καθημερινά
  • Δειγματοληψία - Τα αρχεία καταγραφής μπορούν να υποβληθούν σε δειγματοληψία για τη μείωση του όγκου, διατηρώντας παράλληλα τη στατιστικά σωστή ανάλυση
  • Υποστηριζόμενοι τύποι αρχείων καταγραφής - Πληροφορίες, Σφάλμα, Προειδοποίηση και Ανίχνευση

Για πλήρεις πληροφορίες σχετικά με τα όρια υπηρεσίας, ανατρέξτε στην ενότητα Λεπτομέρειες και περιορισμοί υπηρεσίας.