Configurare l'osservabilità

Importante

Questa funzionalità è in versione beta. Gli amministratori dell'area di lavoro possono controllare l'accesso a questa funzionalità dalla pagina Anteprime . Vedere Gestire le anteprime di Azure Databricks.

Una configurazione di osservabilità cattura la telemetria profonda di Lakebase Postgres come tabelle Delta nel Catalogo Unity. Insights, Genie e le dashboard funzionano tutti su questi dati; un progetto non ne ha nessuno finché non viene aggiunta una configurazione.

Una configurazione è un singolo oggetto che può coprire uno o più progetti. Ci sono due modi per associare un'identità a essa, e coesistono per design:

  • Un amministratore di workspace imposta una configurazione di principale servizio come impostazione predefinita dello spazio di lavoro, così ogni nuovo progetto ottiene automaticamente l'osservabilità.
  • Un singolo proprietario di progetto configura il proprio progetto con le credenziali di identità utente.

Uno spazio di lavoro di solito si ritrova con un mix: la maggior parte dei progetti è sulla modalità predefinita condivisa, alcuni con le proprie configurazioni. Questa pagina copre l'intera configurazione per entrambi i percorsi. Per impostare un singolo progetto che possiedi, consulta l'avvio rapido.

Prerequisiti

  • Anteprima di Telemetria avanzata di Postgres di Lakebase abilitata per la tua area di lavoro. Un amministratore dell'area di lavoro lo attiva dalla pagina Anteprime.
  • Un progetto di scalabilità automatica di Lakebase in AWS o Azure. Vedere Ottenere un database Postgres.
  • Catalogo Unity e schema per ricevere i dati di telemetria. Lo schema deve esistere già e il catalogo non può usare l'archiviazione predefinita.

Imposta la configurazione

Scegli un'identità. La configurazione scrive la telemetria nel Catalogo Unity come identità che selezioni nell'assistente. Questa scelta determina fino a che punto la configurazione arriva e quanto dura:

  • Scegli un committente di servizio per una configurazione duratura che non sia legata al conto di nessuna persona. Questa è la soluzione giusta per standardizzare l'osservabilità: impostalo come predefinito dello spazio di lavoro e assegnalo ai progetti esistenti. La selezione di un principale di servizio è solo per amministratore dello spazio di lavoro, e devi provisionarlo prima (passo 1 qui sotto).
  • Scegli le credenziali a livello utente per configurare un progetto a tuo accesso, senza nulla da fornire. Questo si adatta a un progetto individuale che possiedi. È limitato ai tuoi permessi, quindi salta la fase di provisioning del principale servizio e inizia da Apri la guida di configurazione.

Fornire il principio del servizio

Se stai usando credenziali a livello utente, salta all'assistente di configurazione di Apertura.

Concedi al principale del servizio i quattro permessi qui sotto prima di creare la configurazione, così sarà pronto da selezionare nel wizard. Sono indipendenti e ognuno viene concesso in un luogo diverso. Se ne manca qualcuno, la configurazione salva comunque, ma la telemetria non si attiva mai silenziosamente e non vengono generate intuizioni, senza errori che ti indichino la causa. Se una configurazione non produce telemetria, controlla prima queste.

Grant Dove impostarlo Perché è necessario
Accesso all'area di lavoro La scheda Configurazioni del preside, sotto Diritti Permette al principale di servizio di agire nell'area di lavoro. Senza di essa, Lakebase scrive la telemetria come un'identità che non può fare nulla, quindi ogni tabella di telemetria resta vuota.
Amministratore dell'area di lavoro Impostazioni > Gruppi di identità e accesso>: apri il gruppo amministratori e aggiungi il principale L'agente in background richiede attualmente l'accesso amministratore per scrivere i dati di telemetria e generare informazioni dettagliate.
PUÒ ESSERE UTILE. La scheda Permessi del preside Ti permette di selezionare il preside nel wizard. Creare un principale di servizio concede PUÒ GESTIRE, che non include CAN USER, quindi lo concedi esplicitamente. Vedere Ruoli per la gestione delle entità servizio.
Privilegi del catalogo Unity Il catalogo di destinazione e lo schema (vedi SQL sotto) Permette al principale di creare e scrivere le tabelle di telemetria: USE CATALOG sul catalogo USE SCHEMA e CREATE TABLE sullo schema.

Concedere l'accesso al Workspace e CAN USE nelle impostazioni > Identità e > accesso ai principi del servizio. Concedere privilegi al Catalogo Unity in Catalog Explorer o con SQL:

GRANT USE CATALOG ON CATALOG <catalog> TO `<service-principal-id>`;
GRANT USE SCHEMA ON SCHEMA <catalog>.<schema> TO `<service-principal-id>`;
GRANT CREATE TABLE ON SCHEMA <catalog>.<schema> TO `<service-principal-id>`;

Note

La richiesta di amministrazione dello spazio di lavoro è un vincolo attuale della Beta e potrebbe essere ristretta in una release successiva. Concederlo per il momento in modo che i dati di telemetria e le informazioni dettagliate funzionino.

Apri la guida di configurazione

Apri il mago da entrambe le parti. Entrambi aprono lo stesso mago:

  • Da Lakebase>Insights>Gestire le configurazioni>Aggiungere una nuova configurazione
  • Dalle Impostazioni>Configurazione dell'osservabilità>Crea nuova configurazione di un progetto

Completa i tre passaggi magici che seguono in ordine, cliccando su Avanti tra di essi.

Configura

Denominare la configurazione e selezionare la posizione in cui si trovano i dati di telemetria. Vale la pena soffermarsi su due scelte:

  • Rendere questa configurazione predefinita per i nuovi progetti, renderla predefinita dello spazio di lavoro: ogni nuovo progetto creato nello spazio di lavoro viene assegnata automaticamente a questa configurazione, senza alcuna azione da parte del creatore. Attivalo per standardizzare l'osservabilità a livello di spazio di lavoro. Uno spazio di lavoro ha al massimo un valore predefinito, e il valore predefinito si applica solo ai progetti creati dopo, quindi lo assegni anche ai progetti esistenti nella fase Assegna ai progetti . Lascialo fuori se vuoi che questa configurazione si applichi a progetti specifici piuttosto che a tutto lo spazio di lavoro.
  • L'identità (sotto Autorizza Lakebase a scrivere i tuoi dati) è l'account che Lakebase scrive come telemetria, seguendo la scelta che hai fatto in Scegli un'identità. Seleziona Usa principio di servizio e scegli il principale che hai fornito, oppure seleziona Usa credenziali a livello utente per eseguire come te stesso. Solo gli amministratori dell'area di lavoro possono selezionare un service principal.

In Invia dati di telemetria a Unity Catalog, scegli il Catalogo e lo Schema in cui finiscono le tabelle e, facoltativamente, specifica un prefisso di tabella. Stai scegliendo una destinazione, non ne stai progettando: Lakebase crea le tabelle elencate in Cosa viene catturato la prima volta che scrive telemetria. Lo schema deve esistere già e il catalogo non può usare l'archiviazione predefinita. Poiché l'opzione Usa archiviazione predefinita è selezionata per impostazione predefinita quando si crea un catalogo in Esplora cataloghi, assicurarsi di cancellarla per il catalogo usato qui.

Attiva approfondimenti

Assicurarsi che Abilita analisi dettagliate sia attivo. Si tratta di ciò che esegue l'agente di Informazioni dettagliate in background. Senza di esso, una configurazione scrive i dati di telemetria in Unity Catalog, ma non espone nulla in modo proattivo. Vengono visualizzati due campi correlati:

  • Le istruzioni sono testo libero che l'agente legge prima del passaggio di analisi, ad esempio "Non generare informazioni dettagliate sulle dimensioni della tabella". Considerarlo come materiale sussidiario, non un filtro garantito: come qualsiasi istruzione data a un LLM, in genere viene seguita, non rigorosamente applicata.
  • La frequenza di analisi controlla con quale frequenza Insights valuta la tua telemetria (ad esempio, ogni ora). Questa operazione è separata dalla velocità con cui i dati di telemetria non elaborati vengono inseriti nel catalogo unity, che si verificano in modo continuo indipendentemente.

Insights salva i propri risultati in un percorso del Workspace, distinto dalla destinazione di Unity Catalog indicata sopra: i dati di telemetria non elaborati vengono salvati come tabelle Delta, ma i risultati stessi sono file nel proprio Workspace di Azure Databricks.

Assegnare ai progetti

Seleziona i progetti Lakebase esistenti a cui questa configurazione si applica, poi salva. Impostarlo come workspace predefinito nel passaggio precedente copre i progetti creati da ora in poi; Assegnandolo qui porta i tuoi progetti esistenti nella stessa configurazione.

Dopo aver salvato:

  • Conferma che il calcolo sia in esecuzione.
  • Se è stata abilitata l'osservabilità in un'istanza già in esecuzione, riavviare l'istanza per rendere effettiva la modifica. Durante la fase beta, i dati di telemetria non vengono inviati da un'istanza già in esecuzione finché non viene riavviata.

Passaggi successivi