Konfigurera observerbarhet

Important

Den här funktionen finns i Beta. Arbetsyteadministratörer kan styra åtkomsten till den här funktionen från sidan Förhandsversioner . Se Hantera förhandsversioner av Azure Databricks.

En observabilitetskonfiguration fångar djup Lakebase Postgres-telemetri som Delta-tabeller i Unity Catalog. Insights, Genie och instrumentpanelerna körs alla på denna data; Ett projekt har inga sådana förrän en konfiguration är kopplad.

En konfiguration är ett enda objekt som kan täcka ett eller flera projekt. Det finns två sätt att koppla en identitet till den, och de samexisterar avsiktligt:

  • En workspace-administratör sätter en service-principal-konfiguration som arbetsplatsstandard, så att varje nytt projekt automatiskt får observerbarhet.
  • En enskild projektägare konfigurerar sitt eget projekt med användaridentitetsuppgifter.

En arbetsyta slutar vanligtvis med en blandning: de flesta projekt på den delade standarden, vissa med egna konfigurationer. Den här sidan täcker hela upplägget för båda vägarna. För att skapa ett enda projekt du äger, se snabbstart.

Förutsättningar

  • Förhandsversionen av Lakebase Advanced Postgres Telemetry är aktiverad för din arbetsyta. En arbetsyteadministratör aktiverar den från sidan Förhandsversioner.
  • Ett Lakebase Autoscaling-projekt på AWS eller Azure. Se Hämta en Postgres-databas.
  • En Unity Catalog-katalog och ett schema för att ta emot telemetri. Schemat måste redan finnas och katalogen kan inte använda Standardlagring.

Ställ in konfigurationen

Välj en identitet. Konfigurationen skriver telemetri till Unity Catalog som en identitet du väljer i guiden. Det valet avgör hur långt konfigurationen sträcker sig och hur länge den varar:

  • Välj en tjänsteprincip för en hållbar konfiguration som inte är kopplad till någon persons konto. Detta är rätt lösning för att standardisera observabilitet: sätt det som arbetsyta som standard och tilldela det befintliga projekt. Att välja en tjänsteprincip är endast för arbetsmiljöadministratör, och du provisionerar den först (steg 1 nedan).
  • Välj användarnivåuppgifter för att konfigurera ett projekt under din egen åtkomst, utan något att provisionera. Detta passar ett enskilt projekt du äger. Det är begränsat till dina behörigheter, så hoppa över service-principal-provisioneringssteget och börja med att öppna konfigurationsguiden.

Tillhandahåll tjänstehuvudpersonen

Om du använder användarnivåuppgifter, hoppa till Öppna konfigurationsguiden.

Ge tjänstehuvudpersonen de fyra behörigheterna nedan innan du skapar konfigurationen, så att den är redo att välja i guiden. De är oberoende, och var och en beviljas på en annan plats. Om någon saknas sparas konfigurationen fortfarande, men telemetrin landar tyst aldrig och inga insikter genereras, utan något felmeddelande som pekar på orsaken. Om en konfiguration inte ger någon telemetri, kontrollera dessa först.

Grant Var ska den placeras Varför det behövs
Åtkomst till arbetsyta Rektorns flik Konfigurationer , under Rättigheter Låter tjänstehuvudpersonen agera i arbetsytan överhuvudtaget. Utan den skriver Lakebase telemetri som en identitet som inte kan göra något, så varje telemetritabell förblir tom.
Arbetsyteadministratör Miljöer > Identitets- och åtkomstgrupper>: öppna administratörsgruppen och lägg till huvudpersonen Bakgrundsagenten kräver för närvarande administratörsåtkomst för att skriva telemetri och generera insikter.
KAN ANVÄNDAS Principalens flik Behörigheter Låter dig välja princip i trollkarlen. Att skapa en tjänst principal ger KAN HANTERA, vilket inte inkluderar KAN ANVÄNDA, så du beviljar det uttryckligen. Se Roller för att hantera tjänsthuvudkonton.
Behörigheter för Unity-katalogen Destinationskatalogen och schemat (se SQL nedan) Låter huvudpersonen skapa och skriva telemetritabellerna: USE CATALOG på katalogen USE SCHEMA och CREATE TABLE på schemat.

Bevilja åtkomst till arbetsytan och KAN ANVÄNDA i Inställningar, > identitet och åtkomst till > tjänstehuvudpersoner. Giv Unity-katalogen behörigheter i Catalog Explorer eller med 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

Att kräva workspace-administration är en nuvarande betabegränsning och kan begränsas i en senare version. Bevilja det för tillfället så att telemetri och insikter fungerar.

Öppna konfigurationsguiden

Öppna trollkarlen från båda ställen. Båda öppnar samma trollkarl:

  • Från Lakebase>Insights>Hantera konfigurationer>Lägg till ny konfiguration
  • Från ett projekts egna inställningar>Observability config>Skapa ny konfiguration

Slutför de tre trollkarlsstegen som följer i ordning och klicka på Nästa mellan dem.

Konfigurera

Namnge konfigurationen och välj var dess telemetri hamnar. Två alternativ här är värda att pausa:

  • Gör detta till en standardkonfiguration för nya projekt , gör detta till arbetsytans standard: varje nytt projekt som skapas i arbetsytan tilldelas denna konfiguration automatiskt, utan någon åtgärd från skaparen. Slå på detta för att standardisera observabilitet i hela arbetsområdet. En arbetsyta har högst en standard, och standarden gäller bara för projekt som skapas efteråt, så du tilldelar den också till befintliga projekt i steget Tilldela till projekt . Lämna den avstängd om du vill att denna konfiguration ska gälla specifika projekt istället för hela arbetsytan.
  • Identitet (under Auktorisera Lakebase för att skriva din data) är det konto som Lakebase skriver telemetri som, efter det val du gjorde i Välj en identitet. Välj Använd tjänsteprincip och välj den princip du provisionerade, eller välj Använd användarnivåuppgifter för att köra som dig själv. Endast arbetsyteadministratörer kan välja tjänstens huvudnamn.

Under Skicka telemetri till Unity-katalogen väljer du Katalogen och Schema som tabellerna hamnar i och eventuellt ett tabellprefix. Du väljer en destination, inte designar en: Lakebase skapar tabellerna som listas i Vad fångas första gången den skriver telemetri. Schemat måste redan finnas och katalogen kan inte använda Standardlagring. Eftersom Använd standardlagring är valt som standard när du skapar en katalog i Katalogutforskaren måste du rensa den för den katalog som du använder här.

Aktivera insikter

Kontrollera att Aktivera insikter är aktiverat. Det är det som kör insights-agenten i bakgrunden. Utan detta skriver en konfiguration telemetri till Unity Catalog, men lyfter inte fram något proaktivt. Två relaterade fält visas:

  • Instruktioner är fritext som agenten läser före varje analyspass, till exempel "Generera inte insikter om tabellstorlek". Behandla det som vägledning, inte ett garanterat filter: som alla instruktioner som ges till en LLM följs det vanligtvis, inte strikt framtvingas.
  • Analysfrekvensen styr hur ofta Insights utvärderar din telemetri (till exempel varje timme). Detta är skilt från hur snabbt rå telemetri landar i Unity Catalog, vilket sker kontinuerligt oavsett.

Insights sparar sina fynd på en Workspace-plats, skild från destinationen i Unity Catalog ovan: rå telemetri hamnar som Delta-tabeller, men själva insikterna är filer i din egen Azure Databricks-arbetsyta.

Tilldela till projekt

Välj de befintliga Lakebase-projekten som denna konfiguration gäller för, och spara sedan. Att sätta det som arbetsyta som standard i föregående steg täcker projekt som skapas från och med nu; Att tilldela det här gör att dina befintliga projekt hamnar under samma konfiguration.

Efter sparat:

  • Bekräfta att beräkningen körs.
  • Om du har aktiverat observerbarhet för en instans som redan kördes startar du om instansen så att ändringen börjar gälla. Under betan börjar telemetridata inte skickas från en instans som redan är igång förrän den har startats om.

Nästa steg

  • Last updated on