Se disponi delle autorizzazioni utente appropriate, puoi creare avvisi nei riquadri basati su query o guardati dai link su dashboard definite dall'utente o dashboard LookML che utilizzano dashboard nuove o legacy.
Creazione di un avviso
Gli avvisi possono essere impostati solo per i riquadri che hanno almeno una misura numerica o un calcolo tabella nella visualizzazione del riquadro. Il tipo di visualizzazione e i campi presenti nella vista a mosaico della dashboard determinano la possibilità di impostare una condizione di avviso basata sul valore di un singolo campo o calcolo tabulare oppure sul valore di ""qualsiasi" campo o calcolo tabulare.
A seconda del tipo di visualizzazione dei riquadri della dashboard e dei tipi di campi presenti nella visualizzazione, Looker esegue controlli diversi sui tuoi dati. Puoi creare avvisi dei seguenti tipi:
- Avvisi su un valore singolo (usati solo con le visualizzazioni di un valore singolo): Looker controlla i dati in base al valore usato nella visualizzazione, corrispondente alla prima riga della tabella dei risultati.
- Avvisi serie temporali (usati quando nella query dei risultati è presente una data o una dimensione temporale): Looker controlla tutte le righe nuove che non sono state viste prima (in base alla data o alla dimensione temporale nella query).
- Avvisi categorici (non relativi a un valore singolo o a serie temporali): Looker controlla tutte le righe e i valori pivot a meno che durante la creazione dell'avviso non siano stati selezionati una riga o un valore pivot specifici.
Gli avvisi basati su un calcolo tabulare che include il totale di una riga non sono supportati.
Per creare avvisi, la dashboard non deve trovarsi in modalità di modifica e tu devi uscire dalla modalità di sviluppo.
Per creare un avviso su un riquadro della dashboard, fai clic sull'icona a forma di campana nel riquadro, quindi fai clic sul pulsante Nuovo in fondo all'elenco di avvisi esistenti che puoi visualizzare (potrebbe essere necessario scorrere per vedere l'intero elenco). Se al momento non sono configurati avvisi per quel riquadro o se non disponi dell'autorizzazione per visualizzare eventuali avvisi esistenti, passa il mouse sul riquadro della dashboard per visualizzare l'icona a forma di campana. Fai clic sull'icona a forma di campana per aprire la finestra di creazione degli avvisi:
Nella finestra di creazione degli avvisi, puoi specificare diversi componenti del tuo avviso:
- Titolo personalizzato
- Condizioni di avviso
- Destinatari
- Frequenza
- Autorizzazioni (a seconda se l'avviso sarà seguibile)
Ogni query di avviso acquisisce le impostazioni della dashboard e del riquadro configurate al momento della creazione dell'avviso. La query dell'avviso non acquisisce le modifiche apportate alla dashboard o al riquadro dopo la creazione dell'avviso, incluse le modifiche ai filtri della dashboard o all'aspetto dei riquadri della dashboard (ad esempio le modifiche al tipo di visualizzazione). Dopo aver implementato eventuali modifiche, dovresti creare un nuovo avviso per fare in modo che vengano applicate all'avviso e alle notifiche.
Un avviso si sincronizza con molti dei comuni tipi di modifiche che tu o altri utenti apportate alla dashboard o al riquadro sottostante, senza che sia necessario creare un nuovo avviso. Per ulteriori informazioni, consulta la pagina della documentazione Effetto delle modifiche alla dashboard sugli avvisi.
Denominare un avviso
Il titolo dell'avviso predefinito indica quali condizioni devono essere vere per attivare l'avviso. Per rinominare l'avviso:
- Fai clic sul menu con tre puntini, quindi fai clic su Modifica avviso.
- Fai clic una sola volta sul titolo dell'avviso.
- Inserisci un titolo personalizzato, quindi fai clic fuori dal campo o premi il tasto Invio per visualizzare l'aggiornamento.
- Fai clic su Salva avviso per salvare il nuovo titolo.
Il titolo dell'avviso personalizzato verrà visualizzato in tutti gli avvisi visibili pubblicamente elencati nella finestra di visualizzazione degli avvisi su quel riquadro. Il titolo personalizzato verrà visualizzato anche nelle notifiche di avviso.
Passa il mouse sopra il titolo personalizzato di un avviso qualsiasi nella finestra di visualizzazione degli avvisi per visualizzare quali condizioni attivano quell'avviso.
Impostazione delle condizioni di avviso
Nei menu a discesa Condition (Condizione) nella finestra di creazione degli avvisi, puoi impostare i componenti che indicano in che modo Looker controlla i dati del riquadro per individuare eventuali modifiche e quali tipi di modifiche attivano una notifica di avviso.
La condizione di avviso è rappresentata da questi componenti:
- L'elenco di campi o di calcoli tabulari che compaiono nella visualizzazione dei riquadri della dashboard
- La modifica del campo, dei campi, del calcolo tabulare o dei calcoli tabulari selezionati per attivare la notifica di avviso
- L'entità della modifica che attiverà la notifica di avviso
tra cui:
- è maggiore di
- è minore di
- Uguale a
- è maggiore o uguale a
- è minore o uguale a
Se la query contiene un campo con la data o l'ora, sono disponibili condizioni aggiuntive:
- Aumenta del
- Diminuisce di
- Cambia di (una combinazione di Aumenta del e Riduci del)
L'utilizzo di queste condizioni comparative con i dati delle serie temporali richiede alcune considerazioni aggiuntive. Per ulteriori informazioni, consulta questo articolo del Centro assistenza sull'impostazione di avvisi basati sui dati di serie temporali.
Looker crea unicamente avvisi basati sulla comparazione di valori di dati decimali e numeri interi. Tuttavia, con una semplice soluzione alternativa, puoi impostare avvisi basati sulle variazioni percentuali dei valori dei dati.
Impostazione delle notifiche di avviso
Nella sezione Dove inviarlo della finestra di creazione degli avvisi, puoi specificare la destinazione della notifica di avviso.
Invio di avvisi all'indirizzo email
Per inviare le notifiche di avviso via email, seleziona Email dal menu a discesa Dove inviare le notifiche. Puoi indicare i destinatari delle notifiche di avviso via email. Il tuo indirizzo email verrà inserito per impostazione predefinita e potrai modificare l'elenco dei destinatari in base alle necessità. Le autorizzazioni determinano i domini email a cui puoi inviare notifiche di avviso.
Ciascun destinatario riceverà un'email con le informazioni sull'avviso e l'opzione per non seguirlo più. Se scelgono di non seguire più l'avviso, il loro indirizzo email verrà rimosso dall'elenco dei destinatari.
Invio di avvisi all'integrazione di Slack Attachment (API Token)
L'azione Slack Attachment (API Token) è disponibile nell'hub azioni di Looker. Quando l'azione viene attivata nella pagina Actions (Azioni) del riquadro Admin (Amministrazione), viene visualizzata l'opzione Slack Attachment (API Token) nel menu a discesa Where to it it (Dove inviare le notifiche) della finestra di creazione degli avvisi.
Gli amministratori delle istanze ospitate dal cliente che usano un server hub azioni self-hosted devono riavviare il server hub azioni quando aggiornano le istanze di Looker.
Dopo che un amministratore di Looker ha attivato l'azione Slack Attachment (API Token) e l'utente del bot dell'app Looker è stato configurato in Slack, puoi inviare notifiche di avviso a Slack utilizzando l'integrazione di Slack Attachment (API Token):
Seleziona Slack Attachment (API Token) dal menu a discesa Where to send it.
Vengono visualizzati i campi Tipo di canale e Condividi in:
Anche se gli utenti di incorporamento hanno le autorizzazioni per inviare notifiche di avviso all'integrazione di Slack Attachment, non vedranno l'impostazione Slack Attachment (API Token) nel menu a discesa Where to send it a meno che l'area di lavoro di Slack non sia configurata per l'utente del bot dell'app Looker.
Utilizza il campo Channel Type (Tipo di canale) per specificare il tipo di destinatario Slack per l'avviso:
- Canali: invia l'avviso a un canale Slack
- Utenti: invia l'avviso in un messaggio diretto a un utente Slack
Dopo aver selezionato il tipo di canale, il campo Condividi in viene compilato con le opzioni relative al canale o al messaggio diretto applicabili alle credenziali dell'utente del bot dell'app Looker nell'area di lavoro di Slack.
Nel campo Condividi in, seleziona il messaggio diretto o il canale a cui vuoi inviare la notifica di avviso. L'utente o il canale selezionato riceverà una notifica con le informazioni relative al riquadro su cui è impostato l'avviso:
- Un'immagine PNG della visualizzazione a mosaico della dashboard
- Un messaggio con il nome della dashboard o il titolo dell'avviso personalizzato e le condizioni che hanno attivato l'avviso
- Un link per passare alla dashboard del riquadro
- Un link per annullare l'iscrizione alle notifiche di avviso
Per le visualizzazioni di un valore singolo, la notifica di Slack includerà il valore singolo come testo anziché un file PNG della visualizzazione.
Invio di avvisi all'integrazione di Slack
L'azione Slack è disponibile nell'hub azioni di Looker. Quando l'azione viene attivata nella pagina Azioni del riquadro Amministratore, Slack viene visualizzato come opzione nel menu a discesa Dove inviarlo della finestra di creazione degli avvisi. Inoltre, un amministratore di Looker deve collegare almeno un'area di lavoro di Slack all'istanza di Looker.
L'integrazione di Slack è disponibile per i deployment ospitati da Looker che soddisfano queste condizioni:
- L'istanza di Looker è su 6.24 o versioni successive.
- La funzionalità IP Allowlist (Lista consentita IP) non è attivata sull'istanza di Looker.
Questa integrazione di Slack non è supportata per le istanze ospitate dal cliente.
Per attivare l'installazione dell'app Looker, il proprietario dell'area di lavoro di Slack potrebbe dover modificare le impostazioni di installazione dell'app per l'area di lavoro di Slack.
Dopo che un amministratore di Looker ha attivato l'azione Slack e collegato le aree di lavoro di Slack appropriate, puoi inviare notifiche di avviso a Slack:
Seleziona Slack dal menu a discesa Dove inviarlo.
Se non hai ancora eseguito l'autenticazione in Slack, viene visualizzato un pulsante Sign in with Slack (Accedi con Slack) nel menu a discesa Where to send it (Dove inviare le notifiche):
Fai clic su Sign in with Slack (Accedi con Slack). Looker richiederà l'accesso all'area di lavoro di Slack. Se l'amministratore di Looker ha collegato più aree di lavoro di Slack all'istanza di Looker, viene visualizzato un menu a discesa in alto a destra nella pagina OAuth. Seleziona l'area di lavoro di Slack appropriata nel menu a discesa. Fai clic su Consenti.
Puoi anche eseguire l'autenticazione in Slack dalla pagina del tuo account personale in Looker. Se l'amministratore di Looker ha collegato più aree di lavoro di Slack all'istanza di Looker, visualizzerai un elenco delle aree di lavoro con le opzioni per accedere a ognuna di loro singolarmente.
Dopo che avrai effettuato l'accesso ad almeno un'area di lavoro di Slack, nella finestra di creazione degli avvisi vengono visualizzati i restanti campi di Slack:
Anche se gli utenti di incorporamento hanno le autorizzazioni per inviare notifiche di avviso all'integrazione di Slack, a meno che la loro area di lavoro di Slack non sia connessa all'istanza di Looker, non vedranno l'opzione Slack nel menu a discesa Where to send it.
Il menu a discesa Area di lavoro mostra un elenco di tutte le aree di lavoro a cui hai eseguito l'accesso. Seleziona un'area di lavoro dall'elenco. Se non vedi l'area di lavoro a cui vuoi inviare le notifiche di avviso, puoi visualizzare un elenco delle aree di lavoro a cui l'amministratore di Looker ha collegato l'istanza di Looker e accedere a ognuna di loro singolarmente dalla pagina del tuo account personale in Looker.
Il campo Share In (Condividi in) viene compilato con le opzioni relative al canale e al messaggio diretto basate sull'area di lavoro di Slack selezionata. Seleziona il messaggio diretto o il canale a cui vuoi inviare la notifica di avviso. Chiunque in quel canale vedrà una notifica con le informazioni relative al riquadro su cui è impostato l'avviso:
- Un'immagine PNG della visualizzazione a mosaico della dashboard
- Un messaggio con il nome della dashboard o il titolo dell'avviso personalizzato e le condizioni che hanno attivato l'avviso
- Un link per passare alla dashboard del riquadro
- Un link per annullare l'iscrizione alla notifica di avviso
Per le visualizzazioni di un valore singolo, la notifica di Slack includerà il valore singolo come testo anziché un file PNG della visualizzazione.
Impostazione della frequenza degli avvisi
Puoi impostare la frequenza con la quale Looker controlla le modifiche apportate ai tuoi dati (e invia una notifica di avviso se le condizioni di avviso vengono soddisfatte) nella sezione Frequenza della finestra di creazione degli avvisi. La frequenza predefinita è Ogni giorno alle 05:00. Di seguito sono riportate le opzioni disponibili in merito alla frequenza:
- Mensile in un giorno del mese specificato (il valore predefinito è il 1° del mese) e in un orario specificato (l'impostazione predefinita è 05:00)
- Ogni settimana in un giorno della settimana (il valore predefinito è dom per domenica) e in un orario specificato (l'impostazione predefinita è 05:00).
- Ogni giorno in un orario specificato (l'impostazione predefinita è 05:00).
- Ogni ora a un intervallo specifico (il valore predefinito è controllare i dati ogni ora) con orari di inizio e di fine (l'impostazione predefinita è 05:00 e 17:00). Puoi impostare Looker in modo che controlli i dati a questi intervalli orari:
- Ora
- 2 ore
- 3 ore
- 4 ore
- 6 ore
- 8 ore
- 12 ore
- Minuti a intervalli specificati (per impostazione predefinita, vengono controllati i dati ogni 15 minuti) e inserire un orario specifico nei campi Inizio e Fine (il valore predefinito è 05:00 e 17:00). Puoi impostare Looker in modo che controlli i dati ai seguenti intervalli di minuti:
- 15 minuti
- 30 minuti
Gli orari di inizio e fine sono inclusi. Ad esempio, se imposti Controlla ogni su 12 ore con le ore 05:00 e le 17:00 alle ore 05:00, Looker controllerà i dati alle 05:00 e alle 17:00.
Looker invia avvisi in base al fuso orario indicato nell'impostazione Fuso orario dell'applicazione nella pagina Impostazioni dell'amministratore o, se abilitato, nel Fuso orario specifico dell'utente dell'autore dell'avviso.
Impostazione delle autorizzazioni relative agli avvisi
Puoi impostare le autorizzazioni relative agli avvisi selezionando le opzioni Pubblico o Privato dal menu a discesa Autorizzazioni nella finestra di creazione degli avvisi. Se un avviso non è non seguito, è contrassegnato come Pubblico per impostazione predefinita, il che significa che qualsiasi utente di Looker con seguenti autorizzazioni sul riquadro della dashboard può vedere il suo avviso e la sua vista; Questi utenti potranno anche seguire l'avviso in modo da ricevere notifiche via email quando vengono attivate le condizioni dell'avviso.
Non è possibile seguire gli avvisi per le integrazioni Slack e Slack Attachment (API Token); tuttavia, se crei un avviso per una di queste destinazioni e lo contrassegni come Pubblico, gli altri utenti potranno vedere e duplicare le tue impostazioni di avviso.
Puoi impostare l'avviso su Privato in modo che le sue impostazioni siano visibili solo a te (e agli amministratori) selezionando l'opzione Privato dal menu a discesa Autorizzazioni nella finestra di creazione degli avvisi.
Per motivi di sicurezza, alcuni avvisi non possono essere visualizzati o seguiti da altri utenti, quindi non potrai visualizzarne o impostarne le autorizzazioni.