Creazione di avvisi

Se disponi delle autorizzazioni utente appropriate, puoi creare avvisi nei riquadri basati su query o collegati a Look nelle dashboard definite dall'utente o nelle dashboard LookML.

Creazione di un avviso

Gli avvisi possono essere impostati solo per i riquadri che mostrano almeno una misura numerica o un calcolo tabulare. Il tipo di visualizzazione e i campi presenti nella visualizzazione dei riquadri della dashboard determinano se puoi impostare una condizione di avviso basata su un singolo valore di calcolo a campo o tabulare oppure su "qualsiasi" o di 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. Gli avvisi che crei saranno di uno dei seguenti tipi:

  • Avvisi relativi a valori singoli (utilizzati solo con le visualizzazioni di valori singoli): Looker controlla i dati in base al valore utilizzato nella visualizzazione, ovvero la prima riga della tabella dei risultati.
  • Avvisi relativi a serie temporali (utilizzati 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 (né valori singoli né serie temporali): Looker controlla tutte le righe e i valori pivot, a meno che non sia stato selezionato una riga o un valore pivot specifico al momento della creazione dell'avviso.

Gli avvisi basati su un calcolo tabulare che include il totale di una riga non sono supportati.

Per creare avvisi, la tua dashboard deve essere fuori dalla modalità di modifica e tu devi uscire dalla modalità di sviluppo.

Per creare un avviso in un riquadro di una dashboard, fai clic sull'icona a forma di campana del riquadro e poi sul pulsante Nuovo in fondo all'elenco degli avvisi di cui hai l'autorizzazione a visualizzare (potrebbe essere necessario scorrere per visualizzare l'elenco completo). Se non hai ancora configurato avvisi per quel riquadro o se non hai l'autorizzazione per visualizzare gli avvisi esistenti nel riquadro, tieni il puntatore sul riquadro della dashboard per visualizzare l'icona Avvisi a forma di campana. Fai clic sull'icona a forma di campana Avvisi nel riquadro della dashboard per aprire la finestra di dialogo di creazione degli avvisi.

Nella finestra di creazione degli avvisi, puoi specificare diversi componenti dell'avviso:

Ogni query dell'avviso acquisisce le impostazioni della dashboard e dei riquadri al momento della creazione dell'avviso. Tuttavia, un avviso si sincronizza con molti dei tipi comuni di modifiche apportate da te o da altri utenti alla dashboard o al riquadro sottostante, senza la necessità di ricrearlo. Per ulteriori informazioni, consulta la pagina di documentazione relativa agli 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. Per rinominare l'avviso:

  1. Fai clic sul menu con tre puntini e poi su Modifica avviso.
  2. Fai clic una sola 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 di avviso.

Passa il mouse sopra il titolo personalizzato di un avviso qualsiasi nella finestra di visualizzazione degli avvisi per visualizzare le condizioni che attivano quell'avviso.

Impostazione delle condizioni di avviso

Nei menu a discesa 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 a cui devono essere applicati i campi, i calcoli tabulari o i calcoli tabulari selezionati per attivare la notifica di avviso
  • L'entità della modifica che attiva la notifica di avviso

Queste condizioni includono:

  • È maggiore di
  • È minore di
  • È uguale a
  • È maggiore di o uguale a
  • È minore o uguale a

Se la query contiene un campo relativo alla data o all'ora, saranno disponibili le seguenti condizioni aggiuntive:

  • Aumenta di
  • Diminuisce di
  • Modifiche di (una combinazione di Aumenta di e Riduci di)

L'utilizzo di queste condizioni di confronto con i dati delle serie temporali comporta ulteriori considerazioni. Per ulteriori informazioni, consulta la pagina sulle best practice in Impostare avvisi in base ai dati di serie temporali.

Puoi creare avvisi basati solo su confronti di valori di dati decimali e numeri interi. Per impostare avvisi basati sulle variazioni percentuali dei valori dei dati, consulta la pagina delle best practice Impostazione di condizioni di avviso in base alle variazioni percentuali dei valori dei dati.

Impostazione delle notifiche di avviso

Nella sezione Dove inviare le notifiche della finestra di creazione degli avvisi, puoi specificare la destinazione della notifica di avviso.

Invio di 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 di cui disponi determinano a quali domini email puoi inviare le notifiche di avviso.

Ogni destinatario riceve un'email con le informazioni relative all'avviso e l'opzione per non seguirlo più. Se il destinatario decide di non seguire più l'avviso, il suo indirizzo email viene rimosso dall'elenco dei destinatari.

Per le dashboard incorporate, puoi personalizzare l'URL fornito ai destinatari per rimandare a Looker. Per utilizzare questa opzione, un amministratore di Looker o un utente con l'autorizzazione schedule_look_emails o create_alerts deve prima specificare i domini consentiti per il link personalizzato e selezionare il formato dell'URL del link personalizzato nella pagina Incorpora del menu Amministrazione.

  • Nel campo Dominio, seleziona uno dei domini disponibili.
  • Nel campo Percorso, inserisci un percorso della dashboard, ad esempio /dashboards/12 o /reports/salesoverview. L'opzione Percorso viene visualizzata solo se è selezionata l'opzione URL definito dall'utente nel campo Seleziona percorso contenuti della pagina Incorpora nel menu Amministrazione.
  • Se vuoi, nel campo Etichetta URL, inserisci il nuovo testo per il link che rimanda ai contenuti. Per impostazione predefinita, in questo campo viene visualizzato qualsiasi testo inserito nel campo Etichetta URL nella pagina Incorpora del menu Amministrazione e può essere modificato in questo campo.

Invio di avvisi all'integrazione dell'allegato di Slack (token API)

L'azione di Slack Attachment (API Token) è disponibile nell'hub azioni di Looker. Quando questa azione viene attivata nella pagina Azioni del riquadro Amministrazione, Allegato Slack (token API) viene visualizzata come opzione nel menu a discesa Dove inviare della finestra di creazione degli avvisi.

Gli amministratori delle istanze ospitate dal cliente che utilizzano un server hub azioni self-hosted devono riavviare il server hub azioni quando aggiornano l'istanza Looker.

Dopo che un amministratore di Looker ha attivato l'azione di Slack Attachment (API Token) e che l'utente bot dell'app Looker è stato configurato in Slack, puoi seguire questi passaggi per inviare le notifiche di avviso a Slack utilizzando l'integrazione di Slack Attachment (API Token):

  1. Seleziona Slack Attachment (API Token) dal menu a discesa Where to send it.

    Verranno visualizzati i campi Tipo di canale e Condividi in.

    Anche se gli utenti incorporati dispongono delle autorizzazioni per inviare notifiche di avviso all'integrazione di Slack Attachment, non vedranno l'opzione Slack Attachment (API Token) nel menu a discesa Dove inviare le notifiche a meno che l'area di lavoro di Slack non sia configurata per l'utente 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 di Slack

    Una volta selezionato il tipo di canale, il campo Condividi in viene compilato con le opzioni del canale o del 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 le informazioni relative al riquadro su cui è impostato l'avviso:

    • Un'immagine PNG della visualizzazione a riquadri 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 accedere al pannello del riquadro
    • Un link per annullare l'iscrizione alla notifica di avviso

    Per le visualizzazioni a valore singolo, la notifica di Slack includerà il singolo valore sotto forma di testo, anziché di un file PNG della visualizzazione.

Invio di avvisi all'integrazione di Slack

L'azione Slack è disponibile nell'hub azioni di Looker. Quando questa azione viene attivata nella pagina Azioni del riquadro Amministrazione, Slack viene visualizzata come opzione nel menu a discesa Dove inviare della finestra di creazione degli avvisi. Inoltre, un amministratore di Looker deve connettere 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 è su Looker 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 regolare le impostazioni di installazione dell'app per l'area di lavoro di Slack.

Dopo che un amministratore di Looker ha abilitato l'azione di Slack e collegato le aree di lavoro di Slack appropriate, puoi inviare notifiche di avviso a Slack seguendo questa procedura:

  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 sotto il menu a discesa Dove inviare le notifiche.

  2. Fai clic su 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, vedrai un elenco di aree di lavoro con opzioni per accedere a ciascuna area di lavoro singolarmente.

    Dopo aver eseguito l'accesso ad almeno un'area di lavoro di Slack, vengono visualizzati i campi Tipo di canale e Condividi in.

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

  3. Il menu a discesa Workspace (Spazio di lavoro) mostra un elenco delle 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 la notifica di avviso, puoi vedere un elenco di aree di lavoro che l'amministratore di Looker ha collegato alla tua istanza di Looker e accedere a ciascuna singolarmente dalla tua pagina del tuo account personale in Looker.

  4. Il campo 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 riquadri 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 che reindirizza alla dashboard del riquadro
    • Un link per annullare l'iscrizione alla notifica di avviso

    Per le visualizzazioni a valore singolo, la notifica di Slack includerà il singolo valore sotto forma di testo, anziché di un file PNG della visualizzazione.

Impostazione della frequenza degli avvisi

Nella sezione Frequenza della finestra di creazione degli avvisi, puoi impostare la frequenza con cui Looker controlla la presenza di modifiche nei dati (e invia una notifica di avviso se le condizioni di avviso sono soddisfatte). La frequenza predefinita è Ogni giorno alle 05:00. Le opzioni di frequenza disponibili sono le seguenti:

  • Mensile in un giorno specifico del mese (l'impostazione predefinita è il 1° giorno del mese) a un'ora specifica (l'impostazione predefinita è 05:00)
  • Settimanale in un Giorno della settimana specificato (l'impostazione predefinita è Dom per la domenica) a un Ora specificato (l'impostazione predefinita è 05:00)
  • Giornaliera a un Ora specificato (il valore predefinito è 05:00)
  • Ogni ora a un intervallo specificato (per impostazione predefinita viene eseguito un controllo dei dati ogni ora) con orari Inizio e Fine specificati (per impostazione predefinita 05:00 e 17:00). Puoi fare in modo che Looker 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 (per impostazione predefinita viene eseguito un controllo dei dati ogni 15 minuti) con orari Inizio e Fine specificati (per impostazione predefinita 05:00 e 17:00). Puoi impostare Looker in modo che controlli i dati ai seguenti intervalli di minuti:
    • 15 minuti
    • 30 minuti

Sono inclusi gli orari definiti nei campi Inizio e Fine. Ad esempio, se imposti Esegui un controllo ogni su 12 ore con un'ora di Inizio pari a 05:00 e un'ora di Fine pari a 17:00, Looker controllerà i dati alle 05:00 e alle 17:00.

Looker invia gli avvisi in base al fuso orario indicato nell'impostazione Fuso orario dell'applicazione nella pagina Impostazioni Amministrazione o, se è attiva, nell'impostazione Fuso orario dell'utente specifico dell'autore dell'avviso.

Impostazione delle autorizzazioni relative agli avvisi

Per motivi di sicurezza, alcuni avvisi non possono essere visualizzati o seguiti da altri utenti e non puoi visualizzarne o impostarne le autorizzazioni.

Puoi impostare le autorizzazioni dell'avviso selezionando l'opzione Pubblico o Privato dal menu a discesa Autorizzazioni nella finestra di creazione degli avvisi. Se un avviso può essere seguito, viene contrassegnato come Pubblico per impostazione predefinita. Ciò significa che tutti gli utenti di Looker che dispongono delle autorizzazioni di follow per i contenuti sottostanti del riquadro della dashboard possono vedere l'avviso e le sue impostazioni nella finestra di visualizzazione dell'avviso. Questi utenti potranno anche seguire l'avviso in modo da ricevere notifiche via email quando vengono attivate le condizioni dell'avviso.

Puoi impostare l'avviso su Privato in modo che le relative impostazioni siano visibili solo a te (e agli amministratori) scegliendo l'opzione Privato dal menu a discesa Autorizzazioni nella finestra di creazione degli avvisi.

Non è possibile seguire gli avvisi relativi alle integrazioni di Slack e Slack Attachment (API Token). Tuttavia, se stai creando un avviso per una di queste destinazioni e lo contrassegna come pubblico, gli altri utenti potranno vedere e duplicare le tue impostazioni degli avvisi.