Creazione di avvisi

Se disponi delle autorizzazioni appropriate per l'utente, puoi creare avvisi su riquadri basati sulle query o link collegati a Looker sulle dashboard definite dall'utente o sulle dashboard LookML che utilizzano dashboard nuove o legacy.

Creazione di un avviso

Gli avvisi possono essere impostati solo per i riquadri che mostrano almeno una misura numerica o un calcolo tabella. 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 dai tipi di campi presenti nella visualizzazione, Looker esegue controlli diversi sui tuoi dati. Quando crei un avviso, il tipo sarà uno dei seguenti:

  • Avvisi sui valori singoli (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 sulle serie temporali (usati quando nei risultati della query è presente una data o una dimensione temporale): Looker controlla tutte le righe nuove che non sono state visualizzate 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 degli avvisi esistenti che puoi visualizzare (potresti dover 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 Avvisi. Fai clic sull'icona Avvisi per aprire la finestra di creazione degli avvisi.

Nella finestra di creazione degli avvisi, puoi specificare diversi componenti del tuo avviso:

Ogni query di avviso acquisisce le impostazioni della dashboard e del riquadro configurate al momento della creazione dell'avviso. Una 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 da applicare 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 sugli effetti delle modifiche alla dashboard sugli avvisi.

Denominazione di un avviso

Il titolo dell'avviso predefinito indica quali condizioni devono essere vere per attivare l'avviso. Se vuoi rinominare l'avviso:

  1. Fai clic sul menu con tre puntini, quindi fai clic su Modifica avviso.
  2. Fai clic una volta sul titolo dell'avviso.
  3. Inserisci un titolo personalizzato, quindi fai clic fuori dal campo o premi il tasto Invio per visualizzare l'aggiornamento.
  4. 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 dell'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

Nel menu a discesa Condizione della 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 dei campi, dei campi o del calcolo della tabella selezionati deve essere attivata per attivare la notifica di avviso
  • l'entità della modifica che attiverà la notifica dell'avviso

tra cui:

  • Maggiore di
  • Meno di
  • È uguale a
  • Is greater than or equal to (È superiore o pari a)
  • è minore o uguale a

Se la query contiene un campo con la data o l'ora, sono disponibili condizioni aggiuntive:

  • Aumenta di
  • Riduci di
  • Cambia di (una combinazione di Aumenta di e Diminuisci di)

L'utilizzo di queste condizioni comparative con i dati delle serie temporali richiede alcune considerazioni aggiuntive. Per ulteriori informazioni, consulta questa pagina delle best practice su come impostare avvisi basati su 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.

Invio degli avvisi via email

Per inviare le notifiche di avviso via email, seleziona Email dal menu a discesa Dove inviare. 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 le notifiche di avviso.

Ciascun destinatario riceverà un'email con le informazioni sull'avviso e un'opzione per non seguirlo più. Se sceglie di non seguire più l'avviso, il suo indirizzo email verrà rimosso dall'elenco dei destinatari.

Se l'opzione URL personalizzati per avvisi e pianificazioni email è abilitata, Looker visualizza l'opzione Includi link personalizzato.

Per i contenuti incorporati, puoi personalizzare l'URL fornito ai destinatari per rimandare a Looker.

  • Nel campo Dominio, seleziona uno dei domini disponibili.
  • Nel campo Percorso, inserisci facoltativamente un percorso ai contenuti, ad esempio /dashboards/12 o /reports/salesoverview. Il formato del percorso deve corrispondere alla Selezione dei parametri definiti impostata nella pagina Impostazioni amministratore - Incorpora.
  • Nel campo Etichetta URL, facoltativamente, inserisci un nuovo testo per il link che rimanda ai contenuti.

Invio degli 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 Azioni del riquadro Amministratore, l'opzione Slack Attachment (API Token) viene visualizzata come opzione nel menu a discesa Dove inviarlo della finestra di creazione degli avvisi.

Gli amministratori di 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 abilitato l'azione Slack Attachment (API Token) e che l'utente del bot dell'app Looker è stato configurato in Slack, puoi inviare notifiche di avviso a Slack utilizzando l'integrazione dell'Allegato Slack (Token API):

  1. Seleziona Slack Attachment (API Token) dal menu a discesa Dove inviarlo.

    I campi Tipo di canale e Condividi in appariranno sotto il menu a discesa Dove inviarlo.

    Anche se gli utenti dell'incorporamento hanno le autorizzazioni per inviare notifiche di avviso all'integrazione di Slack Attachment, non vedranno l'allegato Slack (token API) nel menu a discesa Dove inviarlo, a meno che l'area di lavoro di Slack non sia configurata per l'utente del bot dell'app Looker.

  2. Utilizza il campo 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.

  3. 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 informazioni relative al riquadro su cui è impostato l'avviso:

    • Un'immagine PNG della vista 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 andare alla dashboard del riquadro
    • Un link per annullare l'iscrizione alle notifiche di avviso

    Per le visualizzazioni di valori singoli, la notifica di Slack includerà il valore singolo come testo e non come PNG della visualizzazione.

Invio degli 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à Lista consentita IP non è abilitata 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 abilitato l'azione Slack e collegato le aree di lavoro di Slack appropriate, puoi inviare notifiche di avviso a Slack:

  1. Seleziona Slack dal menu a discesa Dove inviarlo.

    Se non hai ancora eseguito l'autenticazione in Slack, viene visualizzato un pulsante Accedi con Slack nel menu a discesa Dove inviarlo.

  2. 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 di 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, sotto i campi Tipo di canale e Condividi verrà visualizzato il campo Area di lavoro.

    Anche se gli utenti dell'incorporamento hanno le autorizzazioni per inviare notifiche di avviso all'integrazione di Slack, a meno che l'area di lavoro di Slack non sia connessa all'istanza di Looker, non vedranno l'opzione Slack nel menu a discesa Dove inviare le notifiche.

  3. 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.

  4. 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 vista 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 andare alla dashboard del riquadro
    • Un link per annullare l'iscrizione alla notifica di avviso

    Per le visualizzazioni di valori singoli, la notifica di Slack includerà il valore singolo come testo e non come 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 è daily alle 05:00. Le opzioni di frequenza disponibili sono le seguenti:

  • Mensile in un Giorno del mese specificato (il valore predefinito è il 1° del mese) e in una Ora specificata (il valore predefinito è 05:00).
  • Weekly in un determinato giorno della settimana (il valore predefinito è dom la domenica) in un orario specificato (il valore predefinito è 05:00).
  • Ogni giorno all'orario specificato (il valore predefinito è 05:00).
  • Ogni ora a un intervallo specificato (il valore predefinito è controllare i dati ogni ora) con gli orari di inizio e di fine, rispettivamente (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 un intervallo specificato (l'impostazione predefinita prevede la verifica dei dati ogni 15 minuti) con orari di inizio e di fine specificati (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 di fine sono inclusi. Ad esempio, se imposti Check every su 12 hours (12 ore) con le 05:00 sulle 05:00 e le 17:00 sulle 17:00, Looker controllerà i dati alle 05:00 e alle 17:00.

Looker invia avvisi in base al fuso orario indicato nell'impostazione Applicazione fuso orario della pagina Impostazioni per gli amministratori o, se attivata, al 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 seguibile, è contrassegnato come Pubblico per impostazione predefinita, il che significa che qualsiasi utente Looker con seguenti autorizzazioni sui contenuti sottostanti del riquadro può vedere l'avviso e le relative impostazioni nella finestra di visualizzazione degli avvisi. 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 alle integrazioni Slack e Slack Attachment (API Token); tuttavia, se stai creando un avviso per una di queste destinazioni e lo contrassegni come Pubblico, gli altri utenti potranno visualizzare e duplicare le impostazioni degli avvisi.

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 e non sarai in grado di visualizzare o impostare le autorizzazioni.