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 Looker in Slack.

Lookerbot per Slack si integra con Looker e ti consente di eseguire query sui dati direttamente da Slack, che consente 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 di 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 repo di Looker GitHub 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 di 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. La configurazione del bot deve anche 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à dell'API unfurling 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 relative impostazioni.
  2. Seleziona la scheda Integrations (Integrazioni).
  3. In App, seleziona il nome della tua app Lookerbot.

Quando incolli l'URL da un'esplorazione o da un Look in un canale Slack a cui è stato invitato Lookerbot, Lookerbot espande automaticamente l'URL e i relativi contenuti. Se ai contenuti di 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 le query di Looker

Puoi anche creare e utilizzare comandi slash personalizzati che, quando vengono eseguiti, eseguono una query salvata sui tuoi dati in Looker e pubblicano 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 un messaggio direttamente al bot 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 di /looker con Lookerbot. Al posto di @looker o /looker, usa @lookerbot o /lookerbot.

Per visualizzare i comandi creati per Lookerbot:

  • Passa il mouse sopra una qualsiasi menzione di 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 i 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. @mention 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 a Lookerbot. Se invii un messaggio direttamente a Lookerbot, non è necessario anteporre il comando /lookerbot. In questo caso, il messaggio diretto sarà 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 su una dashboard con un singolo elemento e filtri della dashboard, puoi eseguirlo per recuperare i contenuti di Looker e aggiungere valori di filtro da Slack. I filtri sono facoltativi e la query verrà eseguita senza questo filtro se non vengono specificati valori.

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

Risposta di Slackbot di una visualizzazione di 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 restituiranno i dati in modi diversi a seconda del tipo di visualizzazione dell'elemento Esplora, Look o dashboard sottostante. Esistono tre possibili formati di reso:

  • 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 testo:

    La risposta di Slackbot al comando del cliente principale di questo mese restituisce un link alla query Looker e i 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 il conteggio totale degli ordini è pari a 228.
  • Visualizzazione: se il contenuto sottostante è una visualizzazione, i dati verranno restituiti come immagine della visualizzazione. Ad esempio, se un utente esegue il comando configurato movie budgets con il valore Brad Pitt, Slackbot risponde con un link alla query Looker e una visualizzazione grafico a linee che mostra le tendenze di valore in aumento e in diminuzione 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: