Βέλτιστες πρακτικές υποστήριξης

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

Επισκόπηση

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

Επικεφαλίδες αιτήματος

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

  • ActivityId: Ένα καθολικά μοναδικό αναγνωριστικό που μπορείτε να χρησιμοποιήσετε εσείς, ο προγραμματιστής, για να συσχετίσετε το αίτημα με τα συστήματά σας όταν ένας χρήστης Fabric αλληλεπιδρά με τον φόρτο εργασίας σας.
  • RequestId: Ένα καθολικά μοναδικό αναγνωριστικό που βοηθά το Fabric να συσχετίσει το αίτημά σας με ανιχνεύσεις πλατφόρμας, το οποίο θα σας βοηθήσει να διερευνήσετε προβλήματα και να παρέχετε βοήθεια. Εάν δεν μπορείτε να προσδιορίσετε το πρόβλημα από την πλευρά σας χρησιμοποιώντας το ActivityId, μπορείτε να παρέχετε υποστήριξη στο Fabric κατά την RequestId αναφορά ενός προβλήματος. Βεβαιωθείτε ότι συντηρείτε και αποθηκεύετε το RequestId ώστε να μπορεί να παρέχεται εύκολα αργότερα.

Βέλτιστες πρακτικές για υποστήριξη

Για να υποστηρίξετε αποτελεσματικά τους πελάτες σας, είναι απαραίτητο να διατηρείτε, να αποθηκεύετε και να συσχετίζετε αυτά τα αναγνωριστικά. Ακολουθούν ορισμένες βέλτιστες πρακτικές:

1. Υλοτομία

  • Διατήρηση αρχείων καταγραφής: Βεβαιωθείτε ότι τα αρχεία καταγραφής διατηρούνται για επαρκές χρονικό διάστημα, ώστε να είναι δυνατή η αποτελεσματική αντιμετώπιση προβλημάτων.
  • Λεπτομερής καταγραφή: Συμπεριλάβετε το ActivityId και RequestId σε όλες τις σχετικές καταχωρήσεις καταγραφής. Αυτό θα σας βοηθήσει να εντοπίσετε τη ροή ενός αιτήματος μέσω του συστήματός σας.
  • Ενοποίηση Application Insights: Για φόρτους εργασίας που φιλοξενούνται στο Azure, εξετάστε το ενδεχόμενο ενοποίησης με το Azure Application Insights για αυτόματη καταγραφή αναγνωριστικών τηλεμετρίας και συσχέτισης.

2. Παρακολούθηση

  • Παρακολούθηση σε πραγματικό χρόνο: Εφαρμόστε παρακολούθηση σε πραγματικό χρόνο για τον εντοπισμό και την ειδοποίηση για προβλήματα καθώς προκύπτουν. Αυτό περιλαμβάνει την παρακολούθηση των ποσοστών αιτημάτων, των ποσοστών σφαλμάτων και της απόδοσης του συστήματος.
  • Συσχέτιση με κεφαλίδες: Βεβαιωθείτε ότι τα εργαλεία παρακολούθησης μπορούν να συσχετίσουν αρχεία καταγραφής και μετρήσεις χρησιμοποιώντας το ActivityId και RequestId. Αυτό θα σας βοηθήσει να εντοπίσετε και να διαγνώσετε γρήγορα προβλήματα.
  • Azure Monitor: Εξετάστε το ενδεχόμενο να χρησιμοποιήσετε το Azure Monitor για ολοκληρωμένες δυνατότητες παρακολούθησης και ειδοποίησης.

3. Υποστήριξη

  • Υποστήριξη πελατών: Εκπαιδεύστε την ομάδα υποστήριξής σας να ζητά το ActivityId και RequestId όταν αντιμετωπίζετε ζητήματα πελατών. Αυτό θα επιταχύνει τη διαδικασία αντιμετώπισης προβλημάτων.
  • Τεκμηρίωση: Παρέχετε σαφή τεκμηρίωση στους πελάτες σας σχετικά με τον τρόπο απόκτησης και χρήσης αυτών των αναγνωριστικών κατά την αναφορά προβλημάτων.
  • Διαδικασία κλιμάκωσης: Καθιερώστε σαφείς διαδικασίες για την κλιμάκωση ζητημάτων στην υποστήριξη Fabric χρησιμοποιώντας το RequestId όταν απαιτείται έρευνα σε επίπεδο πλατφόρμας.

Παράδειγμα ροής εργασίας

  1. Καταχώριση αρχείου καταγραφής: Όταν λαμβάνεται ένα αίτημα, καταγράψτε το ActivityId και RequestId μαζί με άλλες σχετικές πληροφορίες.
  2. Παρακολούθηση: Χρησιμοποιήστε εργαλεία παρακολούθησης για να παρακολουθείτε το αίτημα σε πραγματικό χρόνο, σε συσχέτιση με τα αναγνωριστικά.
  3. Αντιμετώπιση προβλημάτων: Εάν προκύψει κάποιο πρόβλημα, χρησιμοποιήστε το ActivityId και RequestId για να εντοπίσετε το αίτημα μέσω των αρχείων καταγραφής και των συστημάτων σας.
  4. Υποστήριξη: Όταν ένας πελάτης αναφέρει ένα πρόβλημα, ζητήστε το ActivityId και RequestId να εντοπίσετε γρήγορα τα σχετικά αρχεία καταγραφής και να παρέχετε βοήθεια. Εάν το πρόβλημα δεν μπορεί να προσδιοριστεί από την πλευρά σας, παρέχετε την RequestId υποστήριξη στο Fabric για περαιτέρω διερεύνηση.

Θέματα εφαρμογής

Για Frontend-Only φόρτους εργασίας

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

Για φόρτους εργασίας με στοιχεία υποστήριξης

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

Ενοποίηση Azure

  • Application Insights: Καταγράφει αυτόματα τη συσχέτιση αιτημάτων και παρέχει ενσωματωμένους πίνακες εργαλείων
  • Azure Log Analytics: Αρχεία καταγραφής ερωτημάτων με χρήση αναγνωριστικών συσχέτισης για αντιμετώπιση προβλημάτων
  • Ειδοποιήσεις Azure: Ρύθμιση ειδοποιήσεων με βάση μοτίβα σφαλμάτων ή μετρικά απόδοσης

Οδηγίες υποστήριξης πελατών

Για τους πελάτες σας

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

  1. Αναγνωριστικό δραστηριότητας: Μπορεί συχνά να βρεθεί στα αρχεία καταγραφής κονσόλας εργαλείων προγραμματιστή προγράμματος περιήγησης
  2. Αναγνωριστικό αιτήματος: Μπορεί να εμφανίζεται σε μηνύματα σφάλματος ή να είναι διαθέσιμο μέσω εργαλείων υποστήριξης
  3. Χρονική σήμανση: Όταν παρουσιάστηκε το πρόβλημα
  4. Συμφραζόμενα: Ποια λειτουργία εκτελούσαν όταν παρουσιάστηκε το ζήτημα

Για την ομάδα υποστήριξής σας

Εκπαιδεύστε την ομάδα υποστήριξής σας ώστε:

  1. Συλλέξτε αναγνωριστικά συσχέτισης: Πάντα να ζητάτε ActivityId και RequestId κατά τη διερεύνηση ζητημάτων
  2. Χρησιμοποιήστε διαγνωστικά εργαλεία: Αξιοποιήστε τα συστήματα καταγραφής και παρακολούθησης για τον εντοπισμό προβλημάτων
  3. Κλιμάκωση όταν χρειάζεται: Μάθετε πότε να κλιμακώσετε την υποστήριξη Fabric με το RequestId
  4. Λύσεις εγγράφων: Δημιουργήστε μια βάση γνώσεων για κοινά ζητήματα και τα μοτίβα συσχέτισής τους

Συμπέρασμα

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

Για πιο λεπτομερείς οδηγίες εφαρμογής, ανατρέξτε στο:

  • Last updated on