Παρακολούθηση πίνακα εργαλείων και καταγραφής GraphQL (προεπισκόπηση)

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

Προϋποθέσεις

• Ενεργοποιημένο χώρος εργασίαςπαρακολούθησης χώρου εργασίας . Για περισσότερες πληροφορίες, ανατρέξτε στο θέμα Επισκόπηση παρακολούθησης χώρου εργασίας και ακολουθήστε τα βήματα για να ενεργοποιήσετε την παρακολούθηση χώρου εργασίας.
• Πριν ξεκινήσετε να χρησιμοποιείτε τις δυνατότητες παρακολούθησης και καταγραφής, πρέπει να έχετε ένα API για το GraphQL στο Fabric. Για περισσότερες πληροφορίες, ανατρέξτε στο θέμα Δημιουργία API για το GraphQL στο Fabric και προσθήκη δεδομένων.

Ενεργοποίηση παρακολούθησης API GraphQL

Σε αυτή την ενότητα, θα σας καθοδηγήσουμε στα βήματα που απαιτούνται για την ενεργοποίηση της παρακολούθησης για το API σας για GraphQL. Από προεπιλογή, αυτή η δυνατότητα είναι απενεργοποιημένη.

1. Για να ενεργοποιήσετε μετρικά ή/και εμπειρία καταγραφής για κάθε API για GraphQL στον μισθωτή σας, ανοίξτε το GraphQL API σας και, στη συνέχεια, επιλέξτε στο εικονίδιο ρυθμίσεις:

   

2. Από το παράθυρο Ρυθμίσεις API, επιλέξτε Παρακολούθηση (προεπισκόπηση) από το αριστερό μενού. Εάν παρακολούθηση χώρου εργασίας δεν έχει ενεργοποιηθεί ήδη, θα δείτε μια σημείωση που σας καθοδηγεί να μεταβείτε στις ρυθμίσεις του χώρου εργασίας για να την ενεργοποιήσετε.

   

3. Αφού ενεργοποιήσετε την παρακολούθηση για τον χώρο εργασίας, θα δείτε τις επιλογές ενεργοποίησης μόνο μετρικών (πίνακας εργαλείων API), καταγραφής μόνο (αιτήσεις API) ή και τα δύο. Τα μετρικά και τα αρχεία καταγραφής αποθηκεύονται σε ξεχωριστούς πίνακες στο Kusto και μπορείτε να ενεργοποιήσετε κάθε δυνατότητα ξεχωριστά, ανάλογα με τις απαιτήσεις σας. Από προεπιλογή, αμφότερες οι επιλογές είναι απενεργοποιημένες:

   

Δραστηριότητα αίτησης API

Όταν ενεργοποιηθεί η παρακολούθηση, η επιλογή δραστηριότητας αίτησης API στην επάνω κορδέλα από το GraphQL API ενεργοποιείται. Επιλέξτε το για πρόσβαση στις λεπτομέρειες παρακολούθησης.

Το δραστηριότητας αίτησης API αποτελείται από δύο κύριες προβολές:

1. πίνακας εργαλείων API (για μετρικά): Αυτή η σελίδα εμφανίζει όλους τους μετρητές και γραφήματα για το καθορισμένο χρονικό εύρος.
2. αιτήσεις API (για καταγραφή): Αυτή η σελίδα παραθέτει αιτήσεις API εντός του καθορισμένου χρονικού εύρους.

Στις παρακάτω ενότητες, περιγράφουμε τη λειτουργικότητα κάθε επιλογής.

Μετρικά (πίνακας εργαλείων API)

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

• Συνολικό ευρετήριο Εύρυθμης λειτουργίας API GraphQL που περιλαμβάνει:

  • Αίτηση API/δευτ.
  • Ποσοστό επιτυχίας
  • Κατάσταση εύρυθμης λειτουργίας

• Αριθμός αιτήσεων API

• Λανθάνουσα κατάσταση

• Αριθμός αιτήσεων σε γράφημα ράβδων που απεικονίζουν τον αριθμό των επιτυχιών και σφαλμάτων

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

Βασικές δυνατότητες μετρικών:

• επιλογής χρονικού εύρους: Μπορείτε να επιλέξετε διαφορετικές περιοχές ώρας για τα δεδομένα που εμφανίζονται στα γραφήματα παρακολούθησης. Σημειώστε ότι λόγω ορίων παρακολούθησης του χώρου εργασίας, η διατήρηση των δεδομένων είναι διαθέσιμη μόνο για 30 ημέρες.

  

• αίτηση API/δευτ.: Μπορείτε να προβάλετε τον αριθμό αιτήσεων API που υποβάλλονται κάθε δευτερόλεπτο στο επιλεγμένο χρονικό διάστημα.

  

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

  

• Συνολικός δείκτης Εύρυθμης λειτουργίας API GraphQL με βάση το ποσοστό επιτυχίας ανά API:

  • Πράσινο: 75 -100% αιτήσεων είναι επιτυχείς (Υγιής)

  • Κίτρινο: 50 - 74% αιτήσεων είναι επιτυχημένες (Χρειάζεται προσοχή)

  • Κόκκινο: Ο φυσητήρας 50% επιτυχημένες αιτήσεις (Μη ανθυγιεινές)

    

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

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

  

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

  

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

Καταγραφή (αιτήσεις API)

Η σελίδα αιτήσεων API παρέχει λεπτομερείς πληροφορίες σχετικά με όλες τις αιτήσεις API που συνέβησαν σε ένα συγκεκριμένο χρονικό πλαίσιο. Για να αποκτήσετε πρόσβαση, επιλέξτε την καρτέλα αιτήσεων API από τη σελίδα δραστηριότητας αιτήσεων API.

βασικών δυνατοτήτων καταγραφής:

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

• Προβολή μιας λίστας πρόσφατων αιτήσεων API και προηγούμενων αιτήσεων που παρατίθενται με το Αναγνωριστικό αίτησης.
• Προβάλετε τον τύπο της λειτουργίας (Ερώτημα ή Μετάλλαξη).
• Προβάλετε το πρωτόκολλο μεταφοράς που χρησιμοποιείται από το αίτημα (HTTP).
• Προβολή της ώρας της αίτησης.
• Ταξινομήστε τη λίστα αιτήσεων κατά αύξουσα/φθίνουσα ώρα.
• Προβολή της διάρκειας της αίτησης.
• Ταξινομήστε τη λίστα αιτήσεων κατά αύξουσα/φθίνουσα διάρκεια.
• Προβολή μεγέθους απόκρισης.
• Προβολή κατάστασης (επιτυχία ή αποτυχία).
• Προβάλετε τις λεπτομέρειες της αίτησης, συμπεριλαμβανομένων συγκεκριμένων μηνυμάτων απόκρισης/προειδοποίησης/σφάλματος.
• Φιλτράρετε και αναζητήστε συγκεκριμένες συμβολοσειρές ή προτάσεις.
• Αλλάξτε το μέγεθος των στηλών και ταξινομήστε τις στήλες (αύξουσα/φθίνουσα) από τον πίνακα αναφοράς.

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

• API Microsoft Fabric για GraphQL
• παρακολούθησης χώρου εργασίας
• Επισκόπηση παρακολούθησης χώρου εργασίας
• API για GraphQL σε Fabric
• API Fabric για το πρόγραμμα επεξεργασίας GraphQL
• API Fabric για την προβολή σχήματος GraphQL και την εξερεύνηση