Waarneembaarheid configureren

Important

Deze functie bevindt zich in de bètaversie. Werkruimtebeheerders kunnen de toegang tot deze functie beheren vanaf de pagina Previews . Zie Azure Databricks previews beheren.

Een observabiliteitsconfiguratie legt diepe Lakebase Postgres-telemetrie vast als Delta-tabellen in Unity Catalog. Insights, Genie en de dashboards draaien allemaal op deze data; Een project heeft er geen van totdat er een configuratie is toegevoegd.

Een configuratie is één object dat één of meerdere projecten kan omvatten. Er zijn twee manieren om een identiteit eraan te koppelen, en ze bestaan bewust naast elkaar:

  • Een workspace-beheerder stelt een service-principal configuratie in als standaardwerkruimte, zodat elk nieuw project automatisch observabiliteit krijgt.
  • Een individuele projecteigenaar configureert zijn eigen project met gebruikersidentiteitsgegevens.

Een werkruimte eindigt meestal met een mix: de meeste projecten staan op de gedeelde standaardinstelling, sommige met hun eigen configuraties. Deze pagina behandelt de volledige opzet voor beide paden. Om één project in te stellen waarvan je de eigenaar bent, raadpleeg je de quickstart.

Prerequisites

  • De preview van Geavanceerde Postgres-telemetrie van Lakebase is ingeschakeld voor uw werkruimte. Een werkruimtebeheerder schakelt deze in vanaf de pagina Voorbeeldweergaven.
  • Een Lakebase-project op AWS of Azure. Zie Een Postgres-database ophalen.
  • Een Unity Catalog-catalogus en -schema voor het ontvangen van telemetrie. Het schema moet al bestaan en de catalogus kan geen standaardopslag gebruiken.

Stel de configuratie in

Kies een identiteit. De configuratie schrijft telemetrie naar Unity Catalog als een identiteit die je in de wizard selecteert. Die keuze bepaalt hoe ver de configuratie reikt en hoe lang deze duurt:

  • Kies een dienstprincipal voor een duurzame configuratie die niet aan het account van één persoon is gekoppeld. Dit is de juiste keuze voor het standaardiseren van observability: stel het in als standaard werkruimte en wijs het toe aan bestaande projecten. Het selecteren van een service principal is alleen beschikbaar voor workspace-beheerders, en u maakt deze eerst aan (zoals in stap 1 hieronder).
  • Kies inloggegevens op gebruikersniveau om een project met uw eigen toegangsrechten te configureren, zonder dat u iets hoeft in te richten. Dit past bij een individueel project dat je bezit. Het is afgestemd op je rechten, dus sla de service-principal provisioning stap over en begin met Open de configuratiewizard.

De service-principal inrichten

Als je inloggegevens op gebruikersniveau gebruikt, sla dan over naar De configuratiewizard openen.

Verleen de service principal de vier onderstaande rechten voordat je de configuratie aanmaakt, zodat hij klaar is om te selecteren in de wizard. Ze zijn onafhankelijk en elk wordt op een andere plaats verleend. Als er iets ontbreekt, wordt de configuratie nog steeds opgeslagen, maar telemetrie komt stilzwijgend nooit aan en er worden geen inzichten gegenereerd, zonder enige foutmelding die op de oorzaak wijst. Als een configuratie geen telemetrie produceert, controleer deze dan eerst.

Grant Waar het te plaatsen Waarom het nodig is
Toegang tot werkruimte Het tabblad Configuraties van de principal, onder Rechten Hiermee mag de servicehoofd überhaupt in de werkruimte opereren. Zonder die functie schrijft Lakebase telemetrie als een identiteit die niets kan doen, dus elke telemetrietabel blijft leeg.
Werkruimtebeheerder Instellingen > Identiteits- en toegangsgroepen>: open de beheerdersgroep en voeg de principal toe De achtergrondagent vereist momenteel beheerderstoegang om telemetrie te schrijven en inzichten te genereren.
KAN WORDEN GEBRUIKT Het tabblad Machtigingen van de principal Je kunt de hoofdpersoon in de wizard selecteren. Het aanmaken van een service-principal verleent CAN MANAGE, waar CAN USE niet onder valt, dus kent u die machtiging expliciet toe. Zie Rollen voor het beheren van service-principals.
Unity Catalog-bevoegdheden De bestemmingscatalogus en schema (zie de SQL hieronder) Laat de principal de telemetrietabellen maken en schrijven: USE CATALOG op de catalogus USE SCHEMA en CREATE TABLE op het schema.

Geef toegang tot de werkruimte en KAN GEBRUIKEN in Instellingen > Identiteit en toegang > Service-principals. Verleen de Unity Catalog-machtigingen in Catalog Explorer of met 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

Het vereisen van workspace-beheer is een huidige bètabeperking en kan in een latere release worden aangescherpt. Verleen het voorlopig zodat telemetrie en inzichten werken.

Open de configuratiewizard

Open de tovenaar vanaf een van beide plaatsen. Beide openen dezelfde wizard:

  • Vanuit Lakebase>Insights>- configuraties> beheren, nieuwe configuratie toevoegen
  • Maak een nieuwe configuratie op basis van de eigen >> van een project

Voltooi de drie volgende tovenaarsstappen in volgorde, klik tussen de volgende stappen tussen.

Configureren

Geef de configuratie een naam en selecteer waar de telemetrie van de configuratie terechtkomt. Twee keuzes hier zijn het waard om even bij stil te staan:

  • Maak hiervan een standaardconfiguratie voor nieuwe projecten , maak dit de standaardwerkruimte: elk nieuw project dat in de werkruimte wordt aangemaakt, krijgt deze configuratie automatisch toegewezen, zonder actie van de maker. Zet dit aan om observabiliteit in de hele werkruimte te standaardiseren. Een werkruimte heeft hooguit één standaardinstelling, en die standaard geldt alleen voor projecten die daarna zijn aangemaakt, dus je wijst het ook toe aan bestaande projecten in de stap Aan projecten toewijzen . Laat het eruit als je wilt dat deze configuratie op specifieke projecten geldt in plaats van op de hele werkruimte.
  • Identiteit (onder Autoriseren Lakebase om uw gegevens te schrijven) is het account waarmee Lakebase telemetrie schrijft, na de keuze die u maakte in Kies een identiteit. Kies Service-principal gebruiken en selecteer de principal die je hebt ingericht, of kies Gebruikersreferenties gebruiken om als jezelf uit te voeren. Alleen werkruimtebeheerders kunnen een service-principal selecteren.

Kies onder Telemetrie verzenden naar Unity Catalog de catalogus en het schema waarin de tabellen terechtkomen en eventueel een tabelvoorvoegsel. Je kiest een bestemming, niet om er een te ontwerpen: Lakebase maakt de tabellen die in What gets captured worden vermeld de eerste keer dat het telemetrie wegschrijft. Het schema moet al bestaan en de catalogus kan geen standaardopslag gebruiken. Omdat Standaardopslag gebruiken standaard is geselecteerd wanneer u een catalogus maakt in Catalog Explorer, moet u deze wissen voor de catalogus die u hier gebruikt.

Inzichten inschakelen

Zorg ervoor dat Inzichten inschakelen is ingeschakeld. Dit is wat de Insights-agent op de achtergrond draait. Zonder dit schrijft een configuratie telemetrie naar Unity Catalog, maar wordt er proactief niets zichtbaar gemaakt. Er worden twee gerelateerde velden weergegeven:

  • Instructies zijn vrije tekst die de agent leest voordat elke analyse wordt doorgegeven, bijvoorbeeld 'Inzichten over tabelgrootte niet genereren'. Behandel het als richtlijn, geen gegarandeerd filter: zoals instructies die aan een LLM worden gegeven, wordt het meestal gevolgd, niet strikt afgedwongen.
  • De frequentie van analyses bepaalt hoe vaak Insights je telemetrie evalueert (bijvoorbeeld elk uur). Dit staat los van hoe snel onbewerkte telemetrie in Unity Catalog terechtkomt, wat hoe dan ook continu gebeurt.

Inzichten slaan de bevindingen op naar een werkruimtelocatie, anders dan de hierboven genoemde Unity Catalog-bestemming: onbewerkte telemetrie komt terecht als Delta-tabellen, maar de inzichten zelf zijn bestanden in uw eigen Azure Databricks Werkruimte.

Aan projecten toewijzen

Selecteer de bestaande Lakebase-projecten waarop deze configuratie van toepassing is, en sla het op. Het instellen als standaard werkruimte in de vorige stap dekt projecten die vanaf nu zijn aangemaakt; Als je het hier toewijst, komen je bestaande projecten onder dezelfde configuratie.

Na het opslaan:

  • Bevestig dat de berekening draait.
  • Als u waarneembaarheid hebt ingeschakeld voor een exemplaar dat al werd uitgevoerd, start u het exemplaar opnieuw op om de wijziging van kracht te laten worden. Tijdens de bèta wordt telemetrie pas verzonden vanaf een al actieve instantie nadat de instantie opnieuw is opgestart.

Volgende stappen 

  • Last updated on