Konfigurowanie możliwości obserwowania

Ważna

Ta funkcja jest dostępna w wersji beta. Administratorzy obszaru roboczego mogą kontrolować dostęp do tej funkcji ze strony Podglądy . Zobacz Zarządzanie wersjami zapoznawczami usługi Azure Databricks.

Konfiguracja obserwowalności przechwytuje szczegółowe dane telemetryczne systemu Lakebase Postgres w postaci tabel Delta w Unity Catalog. Insights, Genie i pulpity zarządzające działają na tych danych; Projekt nie ma żadnej z nich, dopóki nie zostanie dołączona konfiguracja.

Konfiguracja to pojedynczy obiekt, który może obejmować jeden lub wiele projektów. Istnieją dwa sposoby przypisania mu tożsamości, które współistnieją z założenia:

  • Administrator przestrzeni roboczej ustawia konfigurację jednostki usługi jako domyślną konfigurację dla przestrzeni roboczej, dzięki czemu każdy nowy projekt ma automatycznie włączoną obserwowalność.
  • Właściciel indywidualnego projektu konfiguruje własny projekt z uprawnieniami tożsamości użytkownika.

Przestrzeń robocza zazwyczaj kończy się mieszanką: większość projektów jest domyślnie współdzielona, niektóre mają własne konfiguracje. Ta strona opisuje pełną konfigurację dla obu ścieżek. Aby skonfigurować pojedynczy projekt, którego jesteś właścicielem, zobacz quickstart.

Wymagania wstępne

  • Wersja zapoznawcza Lakebase Advanced Postgres Telemetry jest włączona w Twoim obszarze roboczym. Administrator obszaru roboczego włącza go ze strony Podglądy.
  • Projekt Lakebase na AWS lub Azure. Zobacz Pobieranie bazy danych Postgres.
  • Katalog i schemat w Unity Catalog do odbierania danych telemetrycznych. Schemat musi już istnieć, a wykaz nie może używać magazynu domyślnego.

Ustaw konfigurację

Wybierz tożsamość. Konfiguracja zapisuje telemetrię do Unity Catalog jako tożsamość, którą wybierasz w kreatorze. Ten wybór decyduje o tym, jak daleko sięga konfiguracja i jak długo utrzymuje się:

  • Wybierz podmiot usługowy dla trwałej konfiguracji, która nie jest powiązana z kontem żadnej osoby. To właściwe rozwiązanie do standaryzacji monitorowania: ustaw je jako domyślne dla obszaru roboczego i przypisz do istniejących projektów. Wybór zasady usługi jest dostępny tylko dla administratora przestrzeni roboczej i najpierw ją konfigurujesz (krok 1 poniżej).
  • Wybierz dane logowania na poziomie użytkownika, aby skonfigurować projekt w ramach własnego dostępu, bez konieczności niczego przygotowywać. To pasuje do indywidualnego projektu, który posiadasz. Jest to ograniczone zakresem Twoich uprawnień, więc pomiń etap aprowizacji jednostki usługi i zacznij od Otwórz kreator konfiguracji.

Skonfiguruj nazwę główną usługi

Jeśli używasz poświadczeń na poziomie użytkownika, przejdź do Otwórz kreator konfiguracji.

Przyznaj podmiotowi usługi cztery poniższe uprawnienia przed utworzeniem konfiguracji, aby była gotowa do wyboru w kreatorze. Są one niezależne, a każda z nich jest udzielana w innym miejscu. Jeśli któregoś z nich brakuje, konfiguracja nadal zostanie zapisana, ale dane telemetryczne po cichu nigdy nie docierają i nie są generowane żadne analizy, a żaden błąd nie wskazuje przyczyny. Jeśli konfiguracja nie generuje telemetrii, najpierw sprawdź je.

Grant Gdzie ją ustawić Dlaczego jest to potrzebne
Dostęp do obszaru roboczego Zakładka Konfiguracje dyrektora, w sekcji Uprawnienia Umożliwia jednostce usługi działanie w obszarze roboczym w ogóle. Bez niej Lakebase zapisuje telemetrię przy użyciu tożsamości, która nie ma żadnych uprawnień, przez co wszystkie tabele telemetrii pozostają puste.
Administrator obszaru roboczego Ustawienia > Grupy tożsamości i dostępu>: otwórz grupę administratorów i dodaj główną osobę Agent w tle obecnie wymaga dostępu administratora do pisania danych telemetrycznych i generowania szczegółowych informacji.
MOŻNA UŻYĆ Zakładka Uprawnienia dyrektora Pozwala wybrać główną postać w czarodzieju. Utworzenie jednostki usługi przyznaje uprawnienie CAN MANAGE, które nie obejmuje CAN USE, więc należy przyznać je jawnie. Zobacz Role służące do zarządzania jednostkami usługi.
Uprawnienia Unity Catalog Katalog docelowy i schemat (patrz SQL poniżej) Pozwala to głównemu generować i zapisywać tabele telemetryczne: USE CATALOG na katalogu USE SCHEMA i CREATE TABLE na schemacie.

Przyznaj dostęp do obszaru roboczego oraz możliwość użycia w Ustawieniach > Tożsamość i dostęp > Jednostki usługi. Przyznaj uprawnienia Unity Catalog w Catalog Explorer lub za pomocą 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>`;

Uwaga / Notatka

Wymaganie administrowania przestrzenią roboczą jest obecnie ograniczeniem w wersji beta, które może zostać ograniczone w późniejszej wersji. Udziel tego uprawnienia na razie, aby dane telemetryczne i analizy działały.

Otwórz kreator konfiguracji

Otwórz czarodzieja z dowolnego miejsca. Oba otwierają tego samego czarodzieja:

  • W Lakebase>Insights>Zarządzaj konfiguracjami>Dodaj nową konfigurację
  • Z poziomu ustawień projektu Ustawienia>Konfiguracja obserwowalności>Utwórz nową konfigurację

Wykonaj trzy kolejne kroki czarodzieja, klikając Dalej między nimi.

Konfiguruj

Nadaj konfiguracji nazwę i wybierz miejsce, w którym znajduje się jego telemetria. Tutaj warto się na chwilę zatrzymać przy dwóch kwestiach:

  • Ustawienie tej konfiguracji domyślnej dla nowych projektów sprawia, że to domyślna przestrzeń robocza: każdy nowy projekt utworzony w przestrzeni roboczej automatycznie otrzymuje tę konfigurację, bez żadnej akcji ze strony twórcy. Włącz tę opcję, aby ujednolicić observability w całym obszarze roboczym. Workspace ma co najwyżej jedną domyślną konfigurację, a ta domyślna dotyczy tylko projektów utworzonych później, więc przypisujesz ją także do istniejących projektów w kroku Przypisz do projektów . Zostaw to wyłączone, jeśli chcesz, aby ta konfiguracja dotyczyła konkretnych projektów, a nie całego workspace.
  • Tożsamość (w sekcji Autoryzuj Lakebase do zapisu danych) to konto, którym Lakebase zapisuje telemetrię, zgodnie z wyborem, którego dokonałeś w Wybierz tożsamość. Wybierz Użyj zasady usługi i wybierz zasadę, którą przydzieliłeś, lub wybierz Użyj poświadczeń na poziomie użytkownika , aby uruchomić się jako Ty sam. Tylko administratorzy obszaru roboczego mogą wybrać nazwę główną usługi.

W sekcji Wyślij dane telemetryczne do Unity Catalog wybierz Katalog i Schemat, do których trafiają tabele, oraz opcjonalnie prefiks tabeli. Wybierasz cel, a nie projektujesz go: Lakebase tworzy tabele wymienione w Co zostaje zarejestrowane przy pierwszym zapisie telemetrii. Schemat musi już istnieć, a wykaz nie może używać magazynu domyślnego. Ponieważ podczas tworzenia katalogu w Eksploratorze katalogów opcja Use default storage jest domyślnie zaznaczona, pamiętaj, aby wyczyścić to pole wyboru dla katalogu, którego tutaj używasz.

Włącz analizę

Upewnij się, że włączono opcję Włącz szczegółowe informacje . To właśnie uruchamia działającego w tle agenta Insights. Bez niego konfiguracja zapisuje dane telemetryczne w Unity Catalog, ale nie pokazuje niczego w sposób proaktywny. Pojawią się dwa powiązane pola:

  • Instructions to dowolny tekst, który agent odczytuje przed każdym przebiegiem analizy, na przykład „Nie generuj wniosków dotyczących rozmiaru tabeli”. Traktuj to jako wskazówkę, a nie gwarantowany filtr: podobnie jak każda instrukcja przekazana modelowi LLM, zwykle jest wykonywana, ale nie jest ściśle egzekwowana.
  • Częstotliwość analizy kontroluje, jak często Insights ocenia twoją telemetrię (na przykład co godzinę). Jest to niezależne od tego, jak szybko surowe dane telemetryczne trafiają do Unity Catalog, co i tak odbywa się w sposób ciągły.

Insights zapisuje swoje wyniki w lokalizacji w obszarze roboczym, odrębnej od docelowej lokalizacji Unity Catalog podanej powyżej: nieprzetworzone dane telemetryczne trafiają do tabel Delta, ale same analizy są plikami we własnym obszarze roboczym Azure Databricks.

Przydziel do projektów

Wybierz istniejące projekty Lakebase, do których ta konfiguracja się odnosi, a następnie zapisz. Ustawienie go jako domyślnego dla obszaru roboczego w poprzednim kroku obejmuje projekty utworzone od tej pory; przypisanie go tutaj powoduje, że istniejące projekty korzystają z tej samej konfiguracji.

Po zapisaniu:

  • Potwierdź, że obliczenia działają.
  • Jeśli włączono możliwość obserwowania w wystąpieniu, które było już uruchomione, uruchom ponownie wystąpienie, aby zmiany zaczęły obowiązywać. Podczas wersji beta dane telemetryczne nie zaczynają przepływać w już uruchomionym wystąpieniu, dopóki nie zostanie uruchomione ponownie.

Następne kroki