Δημιουργία ειδοποιήσεων ενεργοποίησης από ένα σύνολο ερωτημάτων KQL

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

• όταν ένα προγραμματισμένο ερώτημα KQL επιστρέφει αποτελέσματα
• όταν ένα προγραμματισμένο ερώτημα KQL επιστρέφει αποτελέσματα που περιέχουν μια απεικόνιση που ικανοποιεί ένα καθορισμένο σύνολο συνθηκών.

Στείλτε ειδοποιήσεις είτε στον εαυτό σας είτε σε άλλους χρήστες στον οργανισμό σας. Οι ειδοποιήσεις μπορούν να σταλούν μέσω ηλεκτρονικού ταχυδρομείου ή μηνύματος του Microsoft Teams.

Δείγματα σεναρίων

Ακολουθούν ορισμένοι τρόποι με τους οποίους μπορείτε να χρησιμοποιήσετε ειδοποιήσεις ενεργοποίησης με ερωτήματα KQL:

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

Προαπαιτούμενα στοιχεία

• Ένας χώρος εργασίας με εκχωρημένους πόρους με δυνατότητα Microsoft Fabric
• Μια βάση δεδομένων KQL με δεδομένα
• Ένα σύνολο ερωτημάτων KQL συνδεδεμένο στη βάση δεδομένων KQL. Για περισσότερες πληροφορίες, ανατρέξτε στο θέμα Υποβολή ερωτημάτων για δεδομένα σε ένα σύνολο ερωτημάτων KQL.

Σημαντικό

Υποστηρίζονται μόνο ερωτήματα σε βάσεις δεδομένων KQL εντός μιας Eventhouse. Εάν το σύνολο ερωτημάτων KQL σας είναι συνδεδεμένο σε ένα εξωτερικό σύμπλεγμα Azure Data Explorer, η δημιουργία ειδοποίησης δεν υποστηρίζεται.

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

Επιλέξτε την καρτέλα που αντιστοιχεί στη ροή εργασιών που θέλετε.

Με την απεικόνιση

Ορισμός ειδοποίησης σε ένα σύνολο ερωτημάτων KQL

Σημαντικό

Οι απεικονίσεις γραφήματος χρόνου δεν υποστηρίζονται σε αυτό το σενάριο. Υποστηρίζονται στην ενότητα Δημιουργία ειδοποιήσεων ενεργοποίησης από έναν πίνακα εργαλείων σε πραγματικό χρόνο.

1. Ανοίξτε τον χώρο εργασίας που περιέχει το σύνολο ερωτημάτων KQL σας.

2. Μεταβείτε στο σύνολο ερωτημάτων KQL και επιλέξτε το για να το ανοίξετε.

3. Εκτελέστε ένα ερώτημα που επιστρέφει μια απεικόνιση.

4. Όταν το ερώτημα επιστρέψει αποτελέσματα, επιλέξτε Ορισμός ειδοποίησης στην επάνω κορδέλα.

   Για παράδειγμα, το παρακάτω ερώτημα βασίζεται στο δείγμα δεδομένων ποδηλάτων από την εκμάθηση "Ευφυΐα σε πραγματικό χρόνο".

   TutorialTable
   | where Timestamp < ago(5m)
   | summarize NumberOfBikes=sum(No_Bikes) by Neighbourhood
   | render columnchart
   

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

Ορισμός συνθηκών ειδοποίησης

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

2. Στο Οι συνθήκες, καθορίστε τις συνθήκες ειδοποίησης ως εξής:

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

3. Στην Ενέργεια, καθορίστε αν θέλετε την ειδοποίηση μέσω ηλεκτρονικού ταχυδρομείου ή του Microsoft Teams. Στο πλαϊνό τμήμα παραθύρου, μπορείτε να ρυθμίσετε τις παραμέτρους ειδοποιήσεων που αποστέλλονται στον εαυτό σας. Για να στείλετε ειδοποιήσεις σε διαφορετικό χρήστη, ανατρέξτε στο θέμα Προαιρετικό: Επεξεργασία του κανόνα σας στο Στοιχείο ενεργοποίησης.

4. Στην Αποθήκευση θέσης, καθορίστε πού θα αποθηκεύσετε την ειδοποίηση Ενεργοποίηση. Επιλέξτε έναν υπάρχοντα χώρο εργασίας και αποθηκεύστε τον είτε σε έναν υπάρχοντα είτε σε έναν νέο.

5. Επιλέξτε Δημιουργία για να δημιουργήσετε τον κανόνα Ενεργοποίηση.

   

Χωρίς απεικόνιση

Ορισμός ειδοποίησης σε ένα σύνολο ερωτημάτων KQL

1. Ανοίξτε τον χώρο εργασίας που περιέχει το σύνολο ερωτημάτων KQL σας.
2. Μεταβείτε στο σύνολο ερωτημάτων KQL και επιλέξτε το για να το ανοίξετε.
3. Εκτελέστε ένα ερώτημα. Ο ενεργοποιητής ελέγχει τα αποτελέσματα αυτού του ερωτήματος σύμφωνα με τη συχνότητα ώρας που έχει οριστεί σε μεταγενέστερο βήμα και αποστέλλει μια ειδοποίηση για κάθε εγγραφή που επιστρέφεται στο σύνολο αποτελεσμάτων. Για παράδειγμα, εάν ένα προγραμματισμένο ερώτημα επιστρέψει πέντε εγγραφές, ο Ενεργοποιητής αποστέλλει πέντε ειδοποιήσεις.
4. Όταν το ερώτημα ολοκληρωθεί, επιλέξτε Ορισμός ειδοποίησης στην επάνω κορδέλα.

Παράδειγμα 1 - Μεμονωμένο αποτέλεσμα όταν το πλήθος είναι μεγαλύτερο από το όριο

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

SampleTable 
| where ingestion_time() > ago (5min)
// Add any other optional filters
| count 
| where Count > threshold

Παράδειγμα 2 - Δημιουργία ενός μοναδικού αποτελέσματος με έναν πίνακα πολλών τιμών

Στο παρακάτω παράδειγμα, το ερώτημα επιστρέφει μια ειδοποίηση εάν ο αριθμός των ποδηλάτων σε οποιαδήποτε γειτονιά είναι πάνω από το καθορισμένο όριο. Για να λάβετε μια ενιαία ειδοποίηση για όλες τις γειτονιές για τις οποίες ο αριθμός είναι πάνω από το όριο, το ερώτημα δημιουργείται για να επιστρέψει μια μοναδική εγγραφή (δηλαδή, μια μοναδική ειδοποίηση). Αυτό γίνεται χρησιμοποιώντας τον τελεστή make_list() Για να επεξεργαστείτε την ειδοποίηση ώστε να περιέχει τη λίστα των γειτονιών που έφθασαν το όριο, ανατρέξτε στο θέμα Προαιρετικό: Επεξεργασία του κανόνα σας στο Ενεργοποιητής.

TableForReflex
| where ingestion_time() > ago (5min)
| summarize NeighborhoodCount = count() by Neighbourhood
| where NeighborhoodCount > threshold
| summarize NeighbourhoodList = make_list(Neighbourhood)

Ορισμός συνθηκών ειδοποίησης

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

1. Ορίστε μια συχνότητα ώρας για το πόσο συχνά εκτελείται το ερώτημα. Η προεπιλογή είναι 5 λεπτά. Η μοναδική συνθήκη που είναι διαθέσιμη σε αυτό το σενάριο είναι Σε κάθε συμβάν, που σημαίνει ότι όταν επιστρέφεται οποιαδήποτε εγγραφή, ικανοποιείται η συνθήκη.
2. Στην Ενέργεια, καθορίστε αν θέλετε την ειδοποίηση μέσω ηλεκτρονικού ταχυδρομείου ή του Microsoft Teams. Στο πλαϊνό τμήμα παραθύρου, μπορείτε να ρυθμίσετε τις παραμέτρους ειδοποιήσεων που αποστέλλονται στον εαυτό σας. Για να στείλετε ειδοποιήσεις σε διαφορετικό χρήστη, ανατρέξτε στο θέμα Προαιρετικό: Επεξεργασία του κανόνα σας στο Στοιχείο ενεργοποίησης.
3. Στην Αποθήκευση θέσης, καθορίστε πού θα αποθηκεύσετε την ειδοποίηση Ενεργοποίηση. Επιλέξτε έναν υπάρχοντα χώρο εργασίας και αποθηκεύστε τον είτε σε έναν υπάρχοντα είτε σε έναν νέο.
4. Επιλέξτε Δημιουργία για να δημιουργήσετε τον κανόνα Ενεργοποίηση.

Προαιρετικό: Επεξεργασία του κανόνα σας στο Στοιχείο ενεργοποίησης

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

• Προσθέστε άλλους παραλήπτες στην ειδοποίησή σας.
• Αλλάξτε το περιεχόμενο της ειδοποίησης ώστε να αντικατοπτρίζει τα συγκεκριμένα δεδομένα που ενεργοποίησαν την ειδοποίηση.
• Καθορίστε μια πιο σύνθετη συνθήκη ειδοποίησης από ό,τι είναι δυνατό στο τμήμα παραθύρου Ορισμός ειδοποίησης.

Για πληροφορίες σχετικά με τον τρόπο επεξεργασίας κανόνων στο στοιχείο Ενεργοποίηση, ανατρέξτε στο θέμα Δημιουργία κανόνων ενεργοποίησης.

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

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

• Υποβολή ερωτήματος σε ένα σύνολο ερωτημάτων KQL
• Γρήγορα αποτελέσματα με την ενεργοποίηση
• Οδηγός γρήγορης αναφοράς KQL