Creazione di avvisi

Se disponi delle autorizzazioni utente appropriate, puoi creare avvisi su 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 hanno almeno una misura numerica o un calcolo tabulare nella visualizzazione del riquadro. Il tipo di visualizzazione e i campi presenti nella visualizzazione a riquadri della dashboard determinano se è possibile impostare una condizione di avviso basata su un singolo valore di calcolo di campo o tabella oppure su "qualsiasi" campo o valore di calcolo tabulare.

A seconda del tipo di visualizzazione del riquadro della dashboard e dei tipi di campi presenti nella visualizzazione, Looker controlla i dati in modi diversi. Quando crei un avviso, può essere uno dei seguenti tipi:

  • Avvisi relativi a un valore singolo (utilizzati solo con le visualizzazioni di un valore singolo): Looker controlla i dati in base al valore utilizzato nella visualizzazione, ovvero la prima riga della tabella dei risultati.
  • Avvisi di serie temporali (utilizzati quando nei risultati della query è presente una data o una dimensione temporale): Looker controlla tutte le nuove righe che non sono state mai visualizzate prima (in base alla data o alla dimensione temporale nella query).
  • Avvisi categorici (né con valore singolo né serie temporale): Looker controlla tutte le righe e tutti i valori pivot, a meno che non sia stato selezionato un valore pivot o una riga specifica al momento della creazione dell'avviso.

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

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

Per creare un avviso in un riquadro della dashboard, fai clic sull'icona a forma di campana del riquadro, quindi sul pulsante Nuovo in fondo all'elenco degli avvisi esistenti che puoi visualizzare (potresti dover scorrere per visualizzare l'elenco completo). Se per il riquadro non sono ancora stati configurati avvisi o se non hai l'autorizzazione per visualizzare gli avvisi esistenti, passa il mouse sopra il riquadro della dashboard per visualizzare l'icona Avvisi a forma di campana. Fai clic sull'icona Avvisi a forma di campana nel riquadro della dashboard per aprire la finestra di dialogo per la creazione degli avvisi.

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

Ogni query sull'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 che tu o altri utenti apporti alla dashboard o al riquadro sottostante, senza dover ricreare l'avviso. Per ulteriori informazioni, consulta la pagina della documentazione Effetti delle modifiche della dashboard sugli avvisi.

Denominazione di un avviso

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

  1. Fai clic sul menu con tre puntini, quindi 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 di quel riquadro. Il titolo personalizzato verrà visualizzato anche nelle notifiche di avviso.

Passa il mouse sopra il titolo personalizzato di qualsiasi avviso nella finestra di visualizzazione per visualizzare le condizioni che lo attivano.

Impostazione delle condizioni di avviso

Nei menu a discesa Condition (Condizione) della finestra di creazione degli avvisi, puoi impostare i componenti che indicano a Looker come verificare la presenza di modifiche nei dati del riquadro e i tipi di modifiche che attivano una notifica di avviso.

La condizione dell'avviso è rappresentata da questi componenti:

  • L'elenco di campi o calcoli tabulari visualizzati nella visualizzazione del riquadro della dashboard
  • La modifica al campo selezionato, ai campi, al calcolo tabulare o ai calcoli tabulari selezionati per attivare la notifica di avviso
  • L'entità della modifica che attiverà la notifica di avviso

Queste condizioni includono quanto segue:

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

Se la query contiene un campo di data o ora, sono disponibili le seguenti condizioni aggiuntive:

  • Aumenta del
  • Diminuisce del
  • Varia di (una combinazione di Aumenta di e Riduci di)

L'utilizzo di queste condizioni di confronto con i dati di serie temporali richiede alcune considerazioni aggiuntive. Per ulteriori informazioni, consulta la pagina delle best practice in Impostazione di avvisi basati sui dati di serie temporali.

Puoi creare avvisi basati su confronti solo 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 Impostare le condizioni di avviso basate sulle variazioni percentuali dei valori dei dati.

Impostazione delle notifiche di avviso

Nella sezione Where to send it (Dove inviare le notifiche) della finestra di creazione degli avvisi, puoi specificare la destinazione della notifica.

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

Ciascun destinatario riceverà un'email con le informazioni dell'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.

Per le dashboard incorporate, puoi personalizzare l'URL fornito ai destinatari che possono 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 alla 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 del menu Amministrazione.
  • Se vuoi, nel campo Etichetta URL inserisci un nuovo testo per il link che rimanda ai contenuti. Per impostazione predefinita, questo campo visualizza il testo inserito nel campo Etichetta URL della pagina Incorpora del menu Amministrazione e può essere modificato in questo campo.

Invio di avvisi all'integrazione di Slack Attachment (API Token)

L'azione per l'allegato Slack (token API) è disponibile nell'hub azioni di Looker. Quando questa azione è abilitata nella pagina Azioni del riquadro Amministrazione, viene visualizzata l'opzione Allegato slate (token API) 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 di Looker.

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

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

    I campi Tipo di canale e Condividi in verranno visualizzati sotto il menu a discesa Dove inviare.

    Anche se gli utenti incorporati hanno le autorizzazioni per inviare notifiche di avviso all'integrazione degli allegati Slack, non vedranno l'allegato Slack (token API) nel menu a discesa Dove inviarlo, a meno che la loro area di lavoro 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 tramite messaggio diretto a un utente Slack

    Una volta 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 visualizzazione a mosaico della dashboard
    • Un messaggio con il nome della dashboard o il titolo dell'avviso personalizzato e le condizioni che lo hanno attivato
    • Un link per accedere alla dashboard del riquadro
    • Un link per annullare l'iscrizione alla notifica di avviso

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

Invio di avvisi all'integrazione Slack

L'azione Slack è disponibile nell'hub azioni di Looker. Quando questa azione è abilitata nella pagina Azioni del riquadro Amministrazione, viene visualizzata l'opzione Slack nel menu a discesa Dove inviare della finestra di creazione degli avvisi. Un amministratore di Looker deve inoltre 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 le seguenti condizioni:

  • L'istanza è su Looker 6.24 o versioni successive.
  • La funzionalità Lista consentita IP non è abilitata nell'istanza di Looker.

Questa integrazione di Slack non è supportata per le istanze ospitate dal cliente.

Per abilitare 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 connesso le aree di lavoro Slack appropriate, puoi inviare notifiche di avviso a Slack seguendo questi passaggi:

  1. Seleziona Slack dal menu a discesa Dove inviare.

    Se non hai già eseguito l'autenticazione in Slack, nel menu a discesa Where to send it viene visualizzato il pulsante Sign in with Slack (Accedi con Slack).

  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 alla tua istanza di Looker, vedrai un elenco di aree di lavoro con opzioni per accedere a ciascuna singolarmente.

    Dopo aver eseguito l'accesso ad almeno un'area di lavoro di Slack, sotto il campo Workspace 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, a meno che la loro area di lavoro Slack non sia connessa all'istanza di Looker, non vedranno l'opzione Slack nel menu a discesa Where to send it.

  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 la notifica di avviso, puoi visualizzare un elenco di aree di lavoro che l'amministratore di Looker ha collegato all'istanza di Looker e accedervi singolarmente dalla pagina dell'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 mosaico della dashboard
    • Un messaggio con il nome della dashboard o il titolo dell'avviso personalizzato e le condizioni che lo hanno attivato
    • Un link per accedere alla dashboard del riquadro
    • Un link per annullare l'iscrizione alla notifica di avviso

    Per le visualizzazioni di un singolo valore, la notifica Slack includerà il singolo valore come testo anziché come 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 le 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 specificato del mese (l'impostazione predefinita è il 1° del mese) alla Ora specificata (l'impostazione predefinita è 05:00)
  • Settimanale in un Giorno della settimana specificato (l'impostazione predefinita è Dom per la domenica) all'Ora specificata (l'impostazione predefinita è 05:00)
  • Giornaliera alle ore specificate (il valore predefinito è 05:00)
  • Orari a un intervallo specificato (l'impostazione predefinita è il controllo dei dati ogni ora) con orari di Inizio e Fine specificati (l'impostazione predefinita è 05:00 e 17:00). A intervalli orari puoi fare in modo che Looker controlli i dati a questi intervalli:
    • Ora
    • 2 ore
    • 3 ore
    • 4 ore
    • 6 ore
    • 8 ore
    • 12 ore
  • Minuti a un intervallo specificato (l'impostazione predefinita prevede il controllo dei dati ogni 15 minuti) con orari di Inizio e Fine specificati (l'impostazione predefinita è 05:00 e 17:00). Con intervalli di minuti, puoi fare in modo che Looker controlli i dati a questi intervalli:
    • 15 minuti
    • 30 minuti

Gli orari di inizio e fine sono inclusi. Ad esempio, se imposti Controlla ogni su 12 ore con Inizio 05:00 e Fine 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 applicazione della pagina Impostazioni amministratore o, se abilitato, al fuso orario specifico dell'utente dell'autore dell'avviso.

Impostazione delle autorizzazioni per gli 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 degli avvisi selezionando le opzioni Pubblico o Privato dal menu a discesa Autorizzazioni nella finestra di creazione degli avvisi. Se un avviso può essere seguito, per impostazione predefinita è contrassegnato come Pubblico, il che significa che qualsiasi utente di Looker con autorizzazioni di follow-up sui contenuti sottostanti del riquadro della dashboard può vedere l'avviso e le relative impostazioni nella finestra di visualizzazione degli avvisi. Possono anche seguire l'avviso in modo da ricevere notifiche 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 per le integrazioni Slack e Allegato Slack (token API). 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 degli avvisi.