Creare avvisi di attivazione da un set di query KQL

Questo articolo illustra come creare avvisi di Fabric Activator da una query KQL. Fabric Activator in Microsoft Fabric consente di eseguire azioni quando vengono rilevati modelli o condizioni nei flussi di dati. Per altre informazioni, vedere Che cos'è Activator.

È possibile configurare Activator per attivare le notifiche in base ai risultati del set di query KQL in due scenari:

Quando le query KQL pianificate restituiscono risultati.
Quando le query KQL pianificate restituiscono risultati con visualizzazioni che soddisfano condizioni specifiche.

Inviare notifiche di avviso a se stessi o ad altri utenti dell'organizzazione. È possibile configurare le notifiche da inviare tramite posta elettronica o Microsoft Teams messaggio.

Scenari di esempio

Ecco alcuni esempi di come usare gli avvisi di Activator con query KQL:

Monitorare i log applicazioni per gli errori: si supponga di avere un database KQL che archivia i log applicazioni. È possibile configurare un avviso per inviare una notifica se i record degli ultimi cinque minuti contengono la stringa authorization error nella colonna del messaggio .
Tenere traccia delle biciclette disponibili nei quartieri: si supponga di avere dati in streaming per le biciclette disponibili in diversi quartieri. Si crea una query KQL per eseguire il rendering di un grafico a torta che mostra il numero di biciclette disponibili per quartiere. È possibile impostare un avviso per notificare quando il numero di biciclette disponibili in qualsiasi quartiere scende al di sotto di una soglia specificata.

Prerequisiti

Uno workspace con una capacità abilitata per Microsoft Fabric.
Un database KQL con dati.
Un Queryset KQL connesso al database KQL. Per ulteriori informazioni, consultare Dati della query in un set di query KQL.

Importante

Sono supportate solo le query sui database KQL all'interno di una Eventhouse. Se il set di query KQL è connesso a un cluster external Azure Data Explorer, la creazione di un avviso non è supportata.
L'impatto di una regola di avviso in Eventhouse dipende dalla complessità della query. Le query e le aggregazioni semplici sono leggere, mentre i join, le trasformazioni e gli ordinamenti sono più a elevato utilizzo di risorse. Se una query viene eseguita ogni 1 o 5 minuti, mantiene di fatto Eventhouse in uno stato sempre attivo. Senza interrogazioni o inserimenti per più di 5 minuti, Eventhouse può andare in idle, riducendo così i costi. Per altre informazioni, vedere Tempo di attività di Eventhouse.

I passaggi seguenti illustrano come creare un avviso in una query che crea una visualizzazione o in una query che non crea una visualizzazione.

Scegliere la scheda corrispondente al flusso di lavoro desiderato.

Con la visualizzazione
Senza visualizzazione

Impostare un avviso su un set di query KQL

Importante

Le visualizzazioni del grafico temporale non sono supportate in questo scenario. Sono supportati in Crea avvisi di attivazione da una dashboard in tempo reale.

Aprire l'area di lavoro contenente il set di query KQL.
Accedere al queryset KQL e selezionarlo per aprirlo.
Eseguire una query che restituisce una visualizzazione.
Dopo aver restituito i risultati della query, selezionare Imposta avviso nella barra multifunzione superiore.

Definire le condizioni di avviso

Nel riquadro Aggiungi regola laterale seguire questa procedura per definire le condizioni di avviso:

Nella sezione Dettagli, inserire un nome per la regola di avviso Activator.
Nella sezione Monitoraggio impostare una frequenza di tempo per la frequenza di esecuzione della query. Il valore predefinito è 5 minuti.
Nella sezione Condizione specificare le condizioni di avviso come indicato di seguito:
- Se la visualizzazione non ha dimensioni, selezionare la condizione On each event when per monitorare le modifiche nel flusso di dati scegliendo un campo specifico da monitorare.
- Nell'elenco a discesa When (Quando ) impostare il valore da valutare.
- Nell'elenco a discesa Condizione impostare la condizione da valutare. Per altre informazioni, vedere Condizioni.
- Nel campo Occorrenza impostare il numero di volte in cui la condizione deve essere soddisfatta prima che venga attivato un avviso.
Nella sezione Azione selezionare una delle azioni seguenti:
- Invia notifica tramite posta elettronica:
  1. Per Seleziona azione, seleziona Invia messaggio di posta elettronica.
  2. Per A, immettere l'indirizzo di posta elettronica del ricevitore o usare l'elenco a discesa per selezionare una proprietà il cui valore è un indirizzo di posta elettronica. Per impostazione predefinita, l'indirizzo di posta elettronica viene inserito automaticamente qui.
  3. Per Oggetto immettere l'oggetto della notifica tramite posta elettronica.
  4. Per Titolo immettere il titolo della notifica tramite posta elettronica.
  5. Per Note immettere le note per la notifica tramite posta elettronica.
    
    Annotazioni
    
    Quando si immette l'oggetto, il titolo o le note, è possibile fare riferimento alle proprietà nei dati digitando @ o selezionando il pulsante accanto alle caselle di testo. Ad esempio: @BikepointID.
  6. In Contesto selezionare i valori nell'elenco a discesa da includere nella notifica tramite posta elettronica.
- Send Microsoft Teams notifica: invia una notifica di Microsoft Teams a utenti, una chat di gruppo o un canale. È possibile personalizzare il titolo e il contenuto del messaggio.
  1. Per Selezionare azione, selezionare Teams -->Messaggio a singoli individui (Messaggi a singoli utenti), Messaggio di gruppo (Messaggio di gruppo) o Post del canale (Canale).
  2. Seguire uno di questi passaggi a seconda della selezione:
    - Se si seleziona l'opzione Messaggio a singoli utenti , immettere gli indirizzi di posta elettronica dei ricevitori o usare l'elenco a discesa per selezionare una proprietà il cui valore è un indirizzo di posta elettronica. Quando viene soddisfatta la condizione, viene inviato un messaggio di Teams agli utenti specificati.
    - Se si seleziona l'opzione Messaggio di chat di gruppo, selezionare una chat di gruppo dall'elenco a discesa. Quando la condizione viene soddisfatta, viene inviato un messaggio alla chat di gruppo.
    - Se si seleziona l'opzione Post canale, selezionare un team e un canale dagli elenchi a discesa. Quando viene soddisfatta la condizione, viene inviato un messaggio al canale selezionato.
  3. Per Titolo immettere il titolo della notifica di Teams.
  4. Aggiungi Note alla notifica di Teams.
    
    Annotazioni
    
    Quando si immette l'oggetto, il titolo o le note, è possibile fare riferimento alle proprietà nei dati digitando @ o selezionando il pulsante accanto alle caselle di testo. Ad esempio: @BikepointID.
  5. In Contesto selezionare i valori nell'elenco a discesa da includere nella notifica di Teams.
- Esegui attività Fabric: Per configurare l'avviso che avvia una pipeline di Fabric, un flusso di dati, un processo Spark, un notebook o una funzione dati utente al verificarsi della condizione, segui questi passaggi:
  1. Per Selezionare l'azione, selezionare il tipo di elemento Fabric appropriato all'interno della sezione Esegui attività Fabric.
  2. In Seleziona l'elemento Fabric da eseguire, seleziona l'elemento Fabric dall'elenco.
  3. Selezionare Aggiungi parametro e specificare il nome del parametro per l'elemento Fabric e un valore per esso. È possibile aggiungere più di un parametro. È possibile passare parametri dai dati dell'avviso digitando @ o selezionando il pulsante accanto alla casella di testo. Ad esempio: @BikepointID.
- Azioni personalizzate: per configurare l'avviso per chiamare un'azione personalizzata quando viene soddisfatta la condizione, seguire questa procedura:
  1. Per Seleziona azione, selezionare Crea azione personalizzata.
  2. Come indicato nella sezione Azione , creare prima la regola. Completare quindi la configurazione dell'azione personalizzata seguendo la procedura descritta in Trigger azioni personalizzate (flussi Power Automate).
  3. Dopo aver creato l'azione personalizzata, nel riquadro Definizione della regola selezionare l'azione personalizzata creata dall'elenco a discesa Azione .
In Percorso di salvataggio, specifica dove salvare l'avviso Activator. Scegliere un'area di lavoro esistente e salvarla in un attivatore esistente o in una nuova.
Selezionare Crea per creare la regola di attivazione.

Impostare un avviso su un set di query KQL

Aprire l'area di lavoro contenente il set di query KQL.
Accedere al queryset KQL e selezionarlo per aprirlo.
Eseguire una query . L'attivatore controlla i risultati di questa query in base alla frequenza temporale impostata in un passaggio successivo e invia un avviso per ogni record restituito nel set di risultati. Ad esempio, se una query pianificata restituisce cinque record, Activator invia cinque avvisi.
Al termine dell'esecuzione della query, selezionare Imposta avviso nella barra multifunzione superiore.

Esempio 1 - Risultato singolo quando count è maggiore della soglia

Ad esempio, la query seguente restituisce un avviso se nella tabella sono presenti più record di soglia degli ultimi 5 minuti. Le ultime due righe della query sono chiave, in cui viene creato il conteggio dei record corrispondenti ai filtri e viene restituito un risultato solo se il conteggio è maggiore della soglia.

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

Esempio 2: Creare un singolo risultato con una matrice di diversi valori

Nell'esempio seguente la query restituisce un avviso se il numero di biciclette in qualsiasi quartiere supera la soglia specificata. Per ottenere un singolo avviso per tutti i quartieri in cui il numero è superiore alla soglia, la query restituisce un singolo record (ovvero un singolo avviso) usando l'operatore make_list(). Per modificare l'avviso in modo da contenere l'elenco dei quartieri che hanno raggiunto la soglia, vedere Facoltativo: Modificare la regola in Activator.

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

Definire le condizioni di avviso

Nel riquadro Aggiungi regola laterale seguire questa procedura per definire le condizioni di avviso:

Nella sezione Dettagli, inserire un nome per la regola di avviso Activator.
Nella sezione Monitoraggio impostare una frequenza di tempo per la frequenza di esecuzione della query. Il valore predefinito è 5 minuti.
Nella sezione Condizione specificare le condizioni di avviso come indicato di seguito:
- Se la visualizzazione non ha dimensioni, selezionare la condizione On each event when per monitorare le modifiche nel flusso di dati scegliendo un campo specifico da monitorare.
- Nell'elenco a discesa When (Quando ) impostare il valore da valutare.
- Nell'elenco a discesa Condizione impostare la condizione da valutare. Per altre informazioni, vedere Condizioni.
- Nel campo Occorrenza impostare il numero di volte in cui la condizione deve essere soddisfatta prima che venga attivato un avviso.
Nella sezione Azione selezionare una delle azioni seguenti:
- Invia notifica tramite posta elettronica:
  1. Per Seleziona azione, seleziona Invia messaggio di posta elettronica.
  2. Per A, immettere l'indirizzo di posta elettronica del ricevitore o usare l'elenco a discesa per selezionare una proprietà il cui valore è un indirizzo di posta elettronica. Per impostazione predefinita, l'indirizzo di posta elettronica viene inserito automaticamente qui.
  3. Per Oggetto immettere l'oggetto della notifica tramite posta elettronica.
  4. Per Titolo immettere il titolo della notifica tramite posta elettronica.
  5. Per Note immettere le note per la notifica tramite posta elettronica.
    
    Annotazioni
    
    Quando si immette l'oggetto, il titolo o le note, è possibile fare riferimento alle proprietà nei dati digitando @ o selezionando il pulsante accanto alle caselle di testo. Ad esempio: @BikepointID.
  6. In Contesto selezionare i valori nell'elenco a discesa da includere nella notifica tramite posta elettronica.
- Send Microsoft Teams notifica: invia una notifica di Microsoft Teams a utenti, una chat di gruppo o un canale. È possibile personalizzare il titolo e il contenuto del messaggio.
  1. Per Selezionare azione, selezionare Teams -->Messaggio a singoli individui (Messaggi a singoli utenti), Messaggio di gruppo (Messaggio di gruppo) o Post del canale (Canale).
  2. Seguire uno di questi passaggi a seconda della selezione:
    - Se si seleziona l'opzione Messaggio a singoli utenti , immettere gli indirizzi di posta elettronica dei ricevitori o usare l'elenco a discesa per selezionare una proprietà il cui valore è un indirizzo di posta elettronica. Quando viene soddisfatta la condizione, viene inviato un messaggio di Teams agli utenti specificati.
    - Se si seleziona l'opzione Messaggio di chat di gruppo, selezionare una chat di gruppo dall'elenco a discesa. Quando la condizione viene soddisfatta, viene inviato un messaggio alla chat di gruppo.
    - Se si seleziona l'opzione Post canale, selezionare un team e un canale dagli elenchi a discesa. Quando viene soddisfatta la condizione, viene inviato un messaggio al canale selezionato.
  3. Per Titolo immettere il titolo della notifica di Teams.
  4. Aggiungi Note alla notifica di Teams.
    
    Annotazioni
    
    Quando si immette l'oggetto, il titolo o le note, è possibile fare riferimento alle proprietà nei dati digitando @ o selezionando il pulsante accanto alle caselle di testo. Ad esempio: @BikepointID.
  5. In Contesto selezionare i valori nell'elenco a discesa da includere nella notifica di Teams.
- Esegui attività Fabric: Per configurare l'avviso in modo che avvii una pipeline di Fabric, un Flusso di Dati, un Processo Spark, un Notebook o una Funzione Dati Utente (anteprima) nel momento in cui la condizione viene soddisfatta, seguire questa procedura:
  1. Per Selezionare l'azione, selezionare il tipo di elemento Fabric appropriato all'interno della sezione Esegui attività Fabric.
  2. In Seleziona l'elemento Fabric da eseguire, seleziona l'elemento Fabric dall'elenco.
  3. Selezionare Aggiungi parametro e specificare il nome del parametro per l'elemento Fabric e un valore per esso. È possibile aggiungere più di un parametro. È possibile passare parametri dai dati dell'avviso digitando @ o selezionando il pulsante accanto alla casella di testo. Ad esempio: @BikepointID.
- Azioni personalizzate: per configurare l'avviso per chiamare un'azione personalizzata quando viene soddisfatta la condizione, seguire questa procedura:
  1. Per Seleziona azione, selezionare Crea azione personalizzata.
  2. Come indicato nella sezione Azione , creare prima la regola. Completare quindi la configurazione dell'azione personalizzata seguendo la procedura descritta in Trigger azioni personalizzate (flussi Power Automate).
  3. Dopo aver creato l'azione personalizzata, nel riquadro Definizione della regola selezionare l'azione personalizzata creata dall'elenco a discesa Azione .
In Percorso di salvataggio, specifica dove salvare l'avviso Activator. Scegliere un'area di lavoro esistente e salvarla in un attivatore esistente o in una nuova.

Screenshot della sezione Salva posizione nel riquadro laterale Aggiungi regola.

Selezionare Crea per creare la regola di attivazione.

Facoltativo: modificare la regola in Activator

Quando si salva l'attivatore, nel riquadro laterale viene visualizzato un collegamento all'elemento. Selezionare il collegamento per modificare ulteriormente in Activator. Questo passaggio può essere utile se si vuole eseguire una delle azioni seguenti:

Aggiungere altri destinatari all'avviso.
Modificare il contenuto dell'avviso in modo da riflettere i dati specifici che hanno attivato l'avviso.
Definire una condizione di avviso più complessa di quanto sia possibile nel riquadro Imposta avviso .

Per informazioni su come modificare le regole in Activator, vedere Creare regole di attivazione.

Nell'attivatore stesso è anche possibile visualizzare la cronologia dei risultati della query e la cronologia delle attivazioni delle regole. Per altre informazioni, vedere Creare regole di attivazione.

Commenti e suggerimenti

Questa pagina è stata utile?

Last updated on 2026-04-22

Creare avvisi di attivazione da un set di query KQL

Scenari di esempio

Prerequisiti

Impostare un avviso su un set di query KQL

Definire le condizioni di avviso

Facoltativo: modificare la regola in Activator

Contenuto correlato

Commenti e suggerimenti

Risorse aggiuntive