Impostazioni di rilevamento in Activator

Questo articolo descrive l'intervallo di impostazioni di rilevamento disponibili quando si crea una regola. Si apprenderà come funzionano le impostazioni di rilevamento in Fabric Activator e come configurarle in modo efficace. Le varie impostazioni di rilevamento interagiscono per individuare i dati esatti a cui si è interessati a tenere traccia.

Gli esempi in questo articolo usano il flusso di eventi di esempio Eventi di recapito dei pacchetti. Si riferisce specificamente all'attributo Temperature e alla regola Troppo caldo per la medicina creata nel tutorial.

Opzioni delle impostazioni di rilevamento

Configurare le impostazioni di rilevamento nel riquadro Definizione , visualizzato sul lato destro di Activator. Il riquadro viene aperto quando si seleziona una regola nel riquadro Esplora a sinistra. Le impostazioni di rilevamento in Riepilogo, Condizione e Filtro proprietà interagiscono per definire esattamente quali eventi di dati attivano la regola. Ogni impostazione è descritta nelle sezioni seguenti.

L'immagine seguente mostra il riquadro Definizione con le impostazioni di rilevamento per l'attributo Temperature della regola Too hot for medicine .

Screenshot del riquadro Definizione in Activator che mostra le impostazioni di rilevamento dell'attributo Temperature per la regola Too hot for medicine.

Riepilogo

Un riepilogo converte un flusso di eventi non elaborati in un singolo valore calcolato in un intervallo di tempo in sequenza. È costituito da un tipo di aggregazione (Operazione), una dimensione della finestra e un passo. I riepiloghi sono utili quando una regola deve rispondere a una tendenza o a un modello nel tempo, anziché a singoli eventi.

Le dimensioni della finestra definiscono il tempo trascorso di ogni calcolo. Ad esempio, una dimensione della finestra di 1 ora indica che ogni valore di riepilogo viene calcolato dagli eventi nell'ora più recente. La dimensione del passo controlla la frequenza con cui la finestra avanza e viene calcolato un nuovo valore di riepilogo. Ad esempio, un passo di 15 minuti indica che viene generato un nuovo valore aggregato ogni 15 minuti. Entrambi i valori possono variare da 10 secondi a 24 ore.

Nella tabella seguente vengono descritti i tipi di aggregazione disponibili.

Aggregation Descrizione
Medio Calcola il valore medio della proprietà o della colonna nell'intervallo di tempo.
Requisiti minimi Calcola il valore minimo della proprietà o della colonna nell'intervallo di tempo.
Massimo Calcola il valore massimo della proprietà o della colonna nell'intervallo di tempo.
Totale Calcola la somma dei valori della proprietà o della colonna nell'intervallo di tempo.
Totale Calcola il numero di eventi contenenti la proprietà o la colonna nell'intervallo di tempo. A differenza di Sum, che somma i valori della proprietà, Total conta il numero di eventi che si sono verificati.

Condizioni

Una condizione definisce il modello che Activator deve rilevare nei dati per attivare la regola. Le condizioni sono raggruppate per tipo di dati e ogni gruppo contiene tipi di condizione che descrivono tipi diversi di modifica o stato.

L'immagine e la tabella seguenti descrivono le categorie di stati disponibili nel menu a tendina.

Screenshot della sezione Condizione nel riquadro Definizione che mostra l'elenco a discesa Condizione espanso con otto categorie compatte: Modifica numerica, Stato numerico, Modifica del testo, Stato del testo, Modifica logica, Stato logico, Modifica comune e Heartbeat.

Categoria Descrizione
Modifica numerica Condizioni che si attivano quando un valore numerico cambia rispetto a una soglia, ad esempio Aumenta al di sopra o Diminuisce sotto. Usare queste condizioni per rilevare le tendenze direzionali nei dati numerici.
Stato numerico Condizioni che si attivano quando un valore numerico è in uno stato specifico, ad esempio è maggiore di, è minore di o è compreso tra. La regola viene attivata per ogni evento dove la condizione è vera.
Modifica del testo Condizioni che si attivano quando un valore di testo passa a o da un valore specifico, ad esempio Modifiche a o Modifiche da.
Stato del testo Condizioni che si attivano quando un valore di testo corrisponde a un criterio, ad esempio Contains, Inizia con o Termina con.
Modifica logica Condizioni che si attivano quando un valore booleano cambia stato. Diventa true viene attivato quando un valore passa da false a true. Diventa false viene attivato quando un valore passa da true a false.
Stato logico Condizioni che si attivano per ogni evento in cui un valore booleano corrisponde allo stato specificato. È uguale a e non è uguale a per confrontare il valore con true o false.
Modifica comune Viene attivato quando viene modificato un valore di attributo. La condizione Changes si applica tra i tipi di dati e non ha una soglia o un valore di destinazione specifico.
Heartbeat Condizioni in base all'arrivo degli eventi. Assenza di dati si attiva quando nuovi eventi non arrivano entro un periodo di tempo specificato. Prima apparizione dell'oggetto si attiva la prima volta che un ID oggetto specifico appare nel flusso di eventi.

Evento

Per alcuni tipi di condizione, viene visualizzato un campo Occorrenza che controlla per quanto tempo, o quante volte, la condizione deve essere true prima dell'attivazione della regola. Ad esempio, se si vuole ricevere un avviso solo quando una temperatura rimane superiore a 100 gradi per almeno 10 minuti, impostare la condizione su superiore a 100 e impostare l'occorrenza su Quando è stato valido per 10 minuti. Nella tabella seguente vengono descritte le opzioni di occorrenza disponibili.

Evento Descrizione
Ogni volta che viene soddisfatta la condizione La regola viene attivata ogni volta che la condizione è vera.
Quando è stato vero per n volte La regola viene attivata solo dopo che la condizione è vera per il numero di volte specificato.
Quando è stato valido per La regola viene attivata solo se la condizione rimane sempre true per la durata specificata.

Filtro delle proprietà

La sezione Filtro proprietà crea una condizione in un subset dei dati, limitando gli eventi valutati dalla regola. Activator supporta filtri di proprietà per qualsiasi tipo di attributo, ovvero numerico, testo o booleano.

Ogni filtro specifica un attributo, un'operazione e un valore. Solo gli eventi che soddisfano il filtro vengono passati alla condizione della regola. Tutti gli altri eventi vengono esclusi.

Screenshot della sezione Filtro proprietà nel riquadro Definizione che mostra Filtro 1 configurato con Attributo impostato su Temperatura (°C), Operazione impostata su È maggiore di e Valore impostato su 0.

Ad esempio, l'immagine mostra un filtro sull'attributo Temperature (°C) in cui Operation è maggiore di e Value è 0. Questo filtro esclude tutti gli eventi in cui Temperature è zero o inferiore. Un altro esempio è un filtro di testo in cui Attribute è impostato su City, Operation è uguale a e Value è Redmond , limitando la valutazione delle regole agli eventi in cui si trovano i pacchetti in Redmond.

È possibile applicare fino a tre filtri a una singola regola. Quando si applicano più filtri, un evento deve soddisfare tutti i filtri per l'evento da valutare. I filtri vengono combinati con la logica AND.

Impostazioni avanzate

La sezione Impostazioni avanzate del riquadro Definizione contiene le impostazioni di intervallo che influiscono sull'accuratezza della valutazione delle regole, non sulla logica di rilevamento. L'impostazione Tempo di attesa per gli eventi in arrivo in ritardo controlla per quanto tempo Activator mantiene aperta la finestra di valutazione per consentire l'arrivo di eventi ritardati. Per altre informazioni, vedere Latenza in Activator.