Utilizzo di Lookerbot per Slack

Questa pagina fornisce una panoramica su come utilizzare Lookerbot, una delle numerose integrazioni fornite da Looker per la condivisione dei dati di Looker in Slack.

Lookerbot per Slack si integra con Looker e ti consente di eseguire query sui dati direttamente da Slack, consentendo di condividere facilmente i dati e rispondere a domande basate sui dati senza dover lavorare al di fuori del flusso di lavoro esistente della tua organizzazione.

In questa pagina vengono descritti i flussi di lavoro Slack-Lookerbot:

Introduzione a Lookerbot

Prima di poter utilizzare Lookerbot in Slack, devi configurare l'applicazione Lookerbot seguendo le istruzioni di configurazione tecnica nel repository GitHub open source di Looker.

A febbraio 2021, Slack ha ritirato alcuni endpoint API che influiscono sul modo in cui Lookerbot interagisce con le azioni sui dati. Estrai gli ultimi aggiornamenti dal repository GitHub di Looker di Looker. Il file package.json deve indicare una versione di Looker 0.0.16 o successiva.

Espansione automatica degli URL di Looker

Lookerbot può espandere automaticamente gli URL per i contenuti Looker che condividi in Slack. Per consentire a Lookerbot di espandere automaticamente gli URL condivisi all'interno di un canale Slack, devi aggiungere Lookerbot al canale Slack. Inoltre, la configurazione del bot deve impostare la variabile di ambiente LOOKER_SLACKBOT_EXPAND_URLS su true. Per ulteriori informazioni sulle variabili di ambiente, consulta le istruzioni per la configurazione tecnica di Looker.

La possibilità di espandere gli URL di Looker non è disponibile nei messaggi diretti Slack, a causa della distinzione tra canali privati/pubblici e messaggi diretti nelle funzionalità API legacy utilizzate in Lookerbot.

Per invitare Lookerbot su un canale pubblico o privato in Slack:

  1. Fai clic sul nome del canale per aprire le impostazioni del canale.
  2. Seleziona la scheda Integrazioni.
  3. In App, seleziona il nome della tua app Lookerbot.

Quando incolli l'URL da un'esplorazione o un Look in un canale Slack a cui è stato invitato Lookerbot, Lookerbot espande automaticamente l'URL e i relativi contenuti. Se ai contenuti Looker è associata una visualizzazione, Lookerbot mostrerà un'immagine di questa visualizzazione. Se i contenuti di Looker sono una tabella di dati, Lookerbot mostrerà i dati come testo.

Utilizzo dei comandi slash personalizzati per eseguire e pubblicare query di Looker

Puoi anche creare e utilizzare comandi slash personalizzati che, se eseguiti, eseguiranno una query salvata dei tuoi dati in Looker e pubblicheranno il risultato in Slack. I comandi slash personalizzati vengono creati durante la configurazione di Lookerbot, ma possono essere eseguiti in Slack da qualsiasi utente di Slack.

I comandi slash non sono necessari per interagire con Lookerbot. Per utilizzare tutte le funzioni di Lookerbot, puoi anche inviare messaggi al bot direttamente o menzionarlo in un canale Slack in cui è presente Lookerbot: @lookerbot help.

Se l'integrazione di Slack è abilitata per l'area di lavoro di Slack, non puoi utilizzare i comandi slash /looker con Lookerbot. Anziché @looker o /looker, usa @lookerbot o /lookerbot.

Per vedere i comandi creati per il tuo Lookerbot:

  • Passa il mouse sopra una qualsiasi menzione del Lookerbot. I comandi disponibili sono elencati nella finestra popup.
  • Seleziona l'app Lookerbot nella sezione App dell'area di lavoro di Slack. Seleziona quindi la scheda Informazioni nella pagina dell'app. I comandi disponibili sono elencati in Comandi.

Diversi modi di utilizzare i comandi slash

Esistono tre modi per utilizzare i comandi. Supponiamo, ad esempio, che tu o uno sviluppatore della tua organizzazione abbiate configurato un comando per recuperare dati da Looker monitorando il numero di ordini effettuati dai clienti per un determinato prodotto. Lo sviluppatore ha utilizzato gli "ordini" per rappresentare questi dati durante la configurazione del comando slash. Per richiamare questo comando, puoi:

  1. @menzione Lookerbot seguito dal componente di testo del comando. Questa operazione può essere eseguita in qualsiasi canale in cui è presente Lookerbot. Ad esempio:

    @lookerbot orders

  2. Utilizza il comando slash. Puoi utilizzare un comando facendo clic sul comando nell'elenco dei comandi o digitando il nome del comando (preceduto da una barra). Puoi farlo se il comando slash è stato configurato durante la configurazione.

    /lookerbot orders

  3. Messaggio diretto da Lookerbot. Se invii un messaggio direttamente a Lookerbot, non è necessario anteporre /lookerbot al comando. In questo caso, il messaggio diretto sarebbe semplicemente orders.

Utilizzo dei comandi slash con i filtri

Se tu o uno sviluppatore della tua organizzazione avete creato un comando slash che esegue query in una dashboard con un singolo elemento e filtri della dashboard, puoi eseguire il comando per recuperare i contenuti di Looker e aggiungere i valori dei filtri da Slack. I filtri sono facoltativi e la query verrà eseguita senza questo filtro se non vengono specificati valori.

Ad esempio, supponiamo di avere una dashboard con una visualizzazione mappa dei clienti che filtra in base a città specifiche degli Stati Uniti e è stato configurato un comando slash personalizzato per richiamare questi dati della dashboard. Puoi eseguire il comando customer map in, filtrato in base a New York, in questo modo:

Risposta Slackbot di una visualizzazione dati che mostra una mappa di New York con punti di dimensioni diverse che rappresentano il numero di utenti in una determinata area.

Formati dei dati

I comandi restituiscono i dati in modi diversi a seconda del tipo di visualizzazione dell'elemento Explore, Look o dashboard sottostante. Esistono tre possibili formati di ritorno:

  • Testo: se il contenuto sottostante è una tabella, i dati verranno restituiti come testo. Ad esempio, se un utente esegue il comando configurato top customer this month, Slackbot restituisce il record principale in formato di testo:

    La risposta di Slackbot al comando del cliente principale questo mese restituisce un link alla query Looker e ai valori per Nome utente, Età utenti, Stato utenti e Numero ordini.
  • Visualizzazione valore singolo: se il contenuto sottostante è una visualizzazione di valore singolo, i dati verranno restituiti come valore di testo. Ad esempio, se un utente esegue il comando configurato orders last week, Slackbot restituisce il conteggio totale della settimana precedente:

    Risposta di Slackbot al comando degli ordini della scorsa settimana che restituisce un link alla query Looker e indica il conteggio totale degli ordini pari a 228.
  • Visualizzazione: se il contenuto sottostante è una visualizzazione, i dati torneranno a essere mostrati sotto forma di immagine della visualizzazione. Ad esempio, se un utente esegue il comando movie budgets configurato con il valore Brad Pitt, Slackbot risponde con un link alla query Looker e una visualizzazione con grafico a linee che mostra le tendenze di valore crescente e decrescente del budget medio per i film di Brad Pitt da 0 a 160 milioni per il primo anno di uscita di un film, dal 1990 al 2015:

Risorse aggiuntive

Per informazioni sulle altre integrazioni Slack di Looker, consulta queste risorse: