Observability konfigurieren

Important

Dieses Feature befindet sich in der Betaversion. Arbeitsbereichsadministratoren können den Zugriff auf dieses Feature über die Vorschauseite steuern. Siehe Manage Azure Databricks Previews.

Eine Observabilitätskonfiguration erfasst tiefe Lakebase-Postgres-Telemetrie als Delta-Tabellen im Unity-Katalog. Insights, Genie und die Dashboards basieren alle auf diesen Daten; Ein Projekt hat keine davon, bis eine Konfiguration angehängt ist.

Eine Konfiguration ist ein einzelnes Objekt, das ein oder mehrere Projekte abdecken kann. Es gibt zwei Möglichkeiten, eine Identität daran anzuknüpfen, und sie koexistieren absichtlich:

  • Ein Workspace-Admin setzt eine Service-Principal-Konfiguration als Standardeinstellung, sodass jedes neue Projekt automatisch Observabilität erhält.
  • Ein einzelner Projektverantwortlicher konfiguriert sein eigenes Projekt mit Benutzeridentitätsdaten.

Ein Arbeitsbereich endet typischerweise mit einer Mischung: die meisten Projekte sind auf der gemeinsamen Standardeinstellung, einige mit eigenen Konfigurationen. Diese Seite behandelt das vollständige Setup für beide Wege. Um ein einzelnes Projekt einzurichten, das du besitzt, siehe den Quickstart.

Voraussetzungen

  • Die Vorschau für Lakebase Advanced Postgres Telemetry ist für Ihren Arbeitsbereich aktiviert. Ein Arbeitsbereichsadministrator aktiviert sie über die Vorschauseite.
  • Ein Lakebase-Projekt auf AWS oder Azure. Siehe Abrufen einer Postgres-Datenbank.
  • Ein Unity-Katalogkatalog und -Schema zum Empfangen von Telemetrie. Das Schema muss bereits vorhanden sein, und der Katalog kann keinen Standardspeicher verwenden.

Einrichtung der Konfiguration

Wähle eine Identität. Die Konfiguration schreibt Telemetrie in den Unity-Katalog als eine Identität, die du im Wizard auswählst. Diese Wahl bestimmt, wie weit die Konfiguration reicht und wie lange sie hält:

  • Wählen Sie einen Service Principal für eine dauerhafte Konfiguration, die nicht an das Konto einer Person gebunden ist. Das ist die richtige Lösung zur Standardisierung der Observabilität: Setzen Sie sie als Standardarbeitsbereich und weisen Sie sie bestehenden Projekten zu. Die Auswahl eines Dienstprinzipals ist nur Workspace-Admins vorbehalten, und Sie stellen ihn zuerst bereit (Schritt 1 unten).
  • Wählen Sie Benutzerzugangsdaten, um ein Projekt unter eigenem Zugriff zu konfigurieren, ohne etwas bereitzustellen. Das passt zu einem einzelnen Projekt, das Sie besitzen. Es ist auf deine Berechtigungen zugeschnitten, also überspringe den Schritt der Service-Principal-Bereitstellung und starte mit "Öffne den Konfigurations-Wizard".

Dienstprinzipal bereitstellen

Wenn Sie Benutzerzugangsdaten verwenden, springen Sie zum Konfigurationsassistenten öffnen.

Erteile dem Service Principal die vier untenstehenden Berechtigungen, bevor du die Konfiguration erstellst, damit sie im Wizard ausgewählt werden kann. Sie sind unabhängig, und jede wird an einem anderen Ort gewährt. Wenn etwas davon fehlt, wird die Konfiguration zwar trotzdem gespeichert, aber die Telemetriedaten kommen stillschweigend nie an, und es werden keine Erkenntnisse generiert, ohne dass eine Fehlermeldung auf die Ursache hinweist. Wenn eine Konfiguration keine Telemetrie erzeugt, überprüfen Sie diese zuerst.

Grant Wo soll man es einordnen Warum es erforderlich ist
Arbeitsbereichszugriff Die Registerkarte Konfigurationen des Prinzipals unter Berechtigungen Ermöglicht es dem Service Principal, überhaupt im Arbeitsbereich zu agieren. Ohne sie schreibt Lakebase Telemetrie als Identität, die nichts tun kann, sodass jede Telemetrietabelle leer bleibt.
Arbeitsbereichsadministrator Einstellungen > Identitäts- und Zugriffsgruppen>: Öffne die Admins-Gruppe und füge den Principal hinzu Der Hintergrund-Agent erfordert derzeit Administratorzugriff, um Telemetrie zu schreiben und Einblicke zu generieren.
KANN VERWENDET WERDEN Die Registerkarte „Berechtigungen“ des Schulleiters Damit kannst du den Prinzipal im Zauberer auswählen. Durch das Erstellen eines Service Principals wird CAN MANAGE gewährt, was CAN USE nicht einschließt, daher müssen Sie dies explizit gewähren. Siehe Rollen zum Verwalten von Dienstprinzipalen.
Unity-Katalogberechtigungen Der Zielkatalog und das Schema (siehe das SQL unten) Ermöglicht dem Prinzipal, die Telemetrietabellen zu erstellen und in sie zu schreiben: USE CATALOG im Katalog sowie USE SCHEMA und CREATE TABLE im Schema.

Gewähren Sie Zugriff auf den Workspace und „Kann verwenden“ in Einstellungen > Identität und Zugriff > Dienstprinzipale. Gewähren Sie die Unity Catalog-Rechte im Catalog Explorer oder mit 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

Die Notwendigkeit eines Workspace-Admins ist eine aktuelle Beta-Einschränkung und könnte in einer späteren Version eingeschränkt werden. Gewähren Sie es jetzt, damit Telemetrie und Einblicke funktionieren.

Öffnen Sie den Konfigurationsassistenten

Öffne den Zauberer von beiden Seiten. Beide öffnen denselben Zauberer:

  • Von Lakebase>Insights>Verwalten von Konfigurationen>Hinzufügen einer neuen Konfiguration
  • Aus den projektspezifischen Einstellungen>Observability-Konfiguration>Neue Konfiguration erstellen

Erfülle die drei folgenden Zaubererschritte in der Reihenfolge und klicke zwischen ihnen auf Nächst.

Konfigurieren

Geben Sie der Konfiguration einen Namen, und wählen Sie aus, wohin die Telemetriedaten gesendet werden. Zwei Entscheidungen sind es wert, kurz näher betrachtet zu werden:

  • Mach dies zur Standardkonfiguration für neue Projekte , mach dies zum Standardarbeitsbereich: Jedes neue Projekt, das im Arbeitsbereich erstellt wird, wird diese Konfiguration automatisch zugewiesen, ohne dass der Ersteller etwas tun kann. Aktivieren Sie dies, um die Observabilität im gesamten Arbeitsbereich zu standardisieren. Ein Arbeitsbereich hat höchstens einen Standard, und der Standard gilt nur für danach erstellte Projekte, daher weist man ihn auch bestehenden Projekten im Schritt "Projekten zuweisen " zu. Lass es weg, wenn du möchtest, dass diese Konfiguration auf bestimmte Projekte und nicht auf den gesamten Arbeitsbereich angewendet wird.
  • Identität (unter Lakebase autorisieren, Ihre Daten zu schreiben) ist das Konto, unter dem Lakebase Telemetriedaten schreibt, entsprechend der Auswahl, die Sie in Wählen Sie eine Identität getroffen haben. Wähle Dienstprinzipal verwenden aus und dann den von dir bereitgestellten Prinzipal, oder wähle Benutzeranmeldeinformationen verwenden, um als du selbst auszuführen. Nur Workspace-Administratoren können einen Dienstprinzipal auswählen.

Wählen Sie unter "Telemetrie an Unity-Katalog senden" den Katalog und das Schema aus, in dem sich die Tabellen befinden, und optional ein Tabellenpräfix. Du wählst ein Ziel aus, du gestaltest es nicht: Lakebase erstellt die in What gets captured aufgeführten Tabellen, wenn erstmals Telemetriedaten geschrieben werden. Das Schema muss bereits vorhanden sein, und der Katalog kann keinen Standardspeicher verwenden. Da " Standardspeicher verwenden" beim Erstellen eines Katalogs im Katalog-Explorer standardmäßig aktiviert ist, müssen Sie ihn für den hier verwendeten Katalog löschen.

Einblicke aktivieren

Stellen Sie sicher, dass "Einblicke aktivieren" aktiviert ist. Das führt den Hintergrund-Insights-Agenten aus. Ohne sie schreibt eine Konfiguration Telemetriedaten in Unity Catalog, stellt jedoch keine Informationen proaktiv bereit. Es werden zwei verwandte Felder angezeigt:

  • Anweisungen sind Freitext, den der Agent vor jedem Analysedurchlauf liest, z. B. "Keine Erkenntnisse über die Tabellengröße generieren". Behandeln Sie sie als Anleitungen, nicht als garantierter Filter: Wie jede Anweisung, die einem LLM gegeben wird, wird sie normalerweise befolgt, nicht streng erzwungen.
  • Die Analysefrequenz steuert, wie oft Insights deine Telemetrie bewertet (zum Beispiel jede Stunde). Dies ist unabhängig davon, wie schnell unformatierte Telemetrie im Unity-Katalog landet, was unabhängig davon kontinuierlich erfolgt.

Insights speichert seine Ergebnisse an einem Workspace-Speicherort, der sich von dem oben genannten Unity Catalog-Ziel unterscheidet: Rohtelemetrie landet als Delta-Tabellen, aber die Erkenntnisse selbst sind Dateien in Ihrem eigenen Azure Databricks Workspace.

Projekten zuordnen

Wählen Sie die bestehenden Lakebase-Projekte aus, auf die diese Konfiguration angewendet wird, und speichern Sie dann. Die Einstellung als Arbeitsbereich-Standard im vorherigen Schritt umfasst Projekte, die ab jetzt erstellt werden; Wenn du es hier zuweist, werden deine bestehenden Projekte unter dieselbe Konfiguration gestellt.

Nach dem Speichern:

  • Bestätigen Sie, dass die Berechnung läuft.
  • Wenn Sie die Observability für eine Bereits ausgeführte Instanz aktiviert haben, starten Sie die Instanz neu, damit die Änderung wirksam wird. Während der Beta beginnt die Telemetrie bei einer bereits laufenden Instanz erst nach einem Neustart.

Nächste Schritte

  • Last updated on