Konfigurasikan observabilitas

Important

Fitur ini ada di Beta. Admin ruang kerja dapat mengontrol akses ke fitur ini dari halaman Pratinjau . Lihat Kelola Pratinjau Azure Databricks.

Konfigurasi observabilitas merekam telemetri mendalam Lakebase Postgres dalam bentuk tabel Delta di Unity Catalog. Insights, Genie, dan dashboard semuanya berjalan dengan data ini; sebuah proyek tidak memiliki salah satu dari mereka sampai konfigurasi dilampirkan.

Konfigurasi adalah satu objek yang dapat mencakup satu atau banyak proyek. Ada dua cara untuk mengaitkan identitas padanya, dan keduanya memang dirancang berdampingan:

  • Admin workspace mengatur konfigurasi service-principal sebagai default workspace, sehingga setiap proyek baru mendapatkan observabilitas secara otomatis.
  • Seorang pemilik proyek individu mengonfigurasi proyeknya sendiri dengan kredensial identitas pengguna.

Sebuah workspace biasanya terdiri dari kombinasi berikut: sebagian besar proyek menggunakan konfigurasi default bersama, sementara sebagian lainnya memiliki konfigurasi sendiri. Halaman ini membahas pengaturan lengkap untuk salah satu jalur. Untuk mengatur satu proyek yang Anda miliki, lihat quickstart.

Prasyarat

  • Pratinjau Lakebase Advanced Postgres Telemetry telah diaktifkan untuk ruang kerja Anda. Admin ruang kerja mengaktifkannya dari halaman Pratinjau.
  • Sebuah proyek Lakebase di AWS atau Azure. Lihat Mendapatkan database Postgres.
  • Katalog dan skema di Unity Catalog untuk menerima telemetri. Skema harus sudah ada, dan katalog tidak dapat menggunakan Penyimpanan default.

Siapkan konfigurasi

Pilih identitas. Konfigurasi menulis data telemetri ke Unity Catalog menggunakan identitas yang Anda pilih dalam panduan. Pilihan tersebut menentukan seberapa jauh konfigurasi menjangkau dan berapa lama waktu yang berlangsung:

  • Pilih service principal untuk konfigurasi yang tahan lama dan tidak terikat ke akun satu orang tertentu. Ini adalah pilihan yang tepat untuk menstandardisasi observabilitas: tetapkan sebagai default ruang kerja, dan terapkan ke proyek yang sudah ada. Memilih prinsipal layanan hanya dapat dilakukan oleh admin ruang kerja, dan Anda harus melakukan provisi terlebih dahulu (langkah 1 di bawah).
  • Pilih kredensial tingkat pengguna untuk mengonfigurasi proyek dengan akses Anda sendiri, tanpa perlu menyediakan apa-apa. Ini cocok untuk proyek individu yang Anda miliki. Cakupannya dibatasi oleh izin Anda, jadi lewati langkah penyediaan prinsipal layanan dan mulai dari Buka wizard konfigurasi.

Menyediakan prinsipal layanan

Jika Anda menggunakan kredensial tingkat pengguna, lanjutkan ke Buka panduan konfigurasi.

Berikan keempat izin di bawah ini kepada prinsipal layanan sebelum Anda membuat konfigurasi, sehingga siap dipilih di wizard. Mereka independen, dan masing-masing diberikan di tempat yang berbeda. Jika ada komponen yang hilang, konfigurasi tetap tersimpan, tetapi telemetri diam-diam tidak pernah masuk dan tidak ada wawasan yang dihasilkan, tanpa pesan kesalahan yang menunjukkan penyebabnya. Jika sebuah konfigurasi tidak menghasilkan telemetri, periksa ini terlebih dahulu.

Grant Di mana harus ditempatkan Mengapa diperlukan
Akses ruang kerja Tab Konfigurasi milik prinsipal, di bawah Hak Memungkinkan prinsipal layanan melakukan tindakan di ruang kerja sama sekali. Tanpanya, Lakebase menulis telemetri sebagai identitas yang tidak bisa melakukan apa-apa, sehingga setiap tabel telemetri tetap kosong.
Admin Ruang Kerja Pengaturan > Grup Identitas dan akses>: buka grup admin dan tambahkan prinsipal Agen latar belakang saat ini memerlukan akses admin untuk menulis telemetri dan menghasilkan wawasan.
DAPAT DIGUNAKAN Tab Izin milik prinsipal Memungkinkan Anda memilih prinsipal di wizard. Membuat service principal memberikan izin CAN MANAGE, yang tidak mencakup CAN USE, sehingga Anda perlu memberikannya secara eksplisit. Lihat Peran untuk mengelola perwakilan layanan.
Hak istimewa Unity Catalog Katalog tujuan dan skema (lihat SQL di bawah) Memungkinkan principal membuat dan menulis tabel telemetri: USE CATALOG pada katalog, USE SCHEMA dan CREATE TABLE pada skema.

Berikan akses Workspace dan BISA MENGGUNAKAN di Pengaturan > Identitas dan akses > prinsipal layanan. Berikan hak istimewa Unity Catalog di Catalog Explorer atau dengan 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

Mewajibkan admin workspace adalah kendala Beta saat ini dan mungkin akan dipersempit di rilis berikutnya. Izinkan untuk sekarang agar telemetri dan insight berfungsi.

Buka panduan konfigurasi

Buka wizard dari salah satu tempat. Keduanya membuka wizard yang sama:

  • Dari Lakebase>Insights>Kelola konfigurasi>Tambahkan konfigurasi baru
  • Dari Setelan>konfigurasi observabilitas>Buat konfigurasi baru milik proyek itu sendiri

Selesaikan tiga langkah wizard berikut secara berurutan , klik Next di antara langkah-langkah tersebut.

Konfigurasikan

Beri nama konfigurasi dan pilih tempat telemetrinya mendarat. Dua pilihan di sini patut dicermati sejenak:

  • Jadikan ini konfigurasi default untuk proyek baru menjadikan ini sebagai default workspace: setiap proyek baru yang dibuat di workspace akan otomatis diberikan konfigurasi ini, tanpa tindakan dari pembuatnya. Aktifkan ini untuk menstandarisasi observabilitas di seluruh workspace. Sebuah workspace paling banyak memiliki satu default, dan default hanya berlaku untuk proyek yang dibuat setelahnya, jadi Anda juga menetapkannya ke proyek yang sudah ada pada langkah Assign to projects . Biarkan saja jika Anda ingin konfigurasi ini diterapkan pada proyek tertentu, bukan ke seluruh workspace.
  • Identitas (di bagian Otorisasi Lakebase untuk menulis data Anda) adalah akun yang digunakan Lakebase untuk menulis telemetri, sesuai dengan pilihan yang Anda buat di Pilih identitas. Pilih Gunakan prinsipal layanan dan pilih prinsipal yang Anda sediakan, atau pilih Gunakan kredensial tingkat pengguna untuk menjalankannya sebagai diri Anda sendiri. Hanya admin ruang kerja yang dapat memilih service principal.

Di bawah Kirim telemetri ke Katalog Unity, pilih Katalog dan Skema tempat tabel akan disimpan, dan, jika perlu, prefiks tabel. Anda memilih tujuan, bukan merancangnya: Lakebase membuat tabel yang tercantum di Apa yang ditangkap saat pertama kali menulis telemetry. Skema harus sudah ada, dan katalog tidak dapat menggunakan Penyimpanan default. Karena Gunakan penyimpanan default dipilih secara default saat Anda membuat katalog di Catalog Explorer, pastikan untuk menghapusnya untuk katalog yang Anda gunakan di sini.

Mengaktifkan wawasan

Pastikan Aktifkan wawasan aktif. Ini yang menjalankan agen Insights di latar belakang. Tanpa itu, konfigurasi menulis telemetri ke Unity Catalog tetapi tidak menampilkan apa pun secara proaktif. Dua bidang terkait muncul:

  • Instruksi adalah teks bebas yang dibaca agen sebelum setiap putaran analisis, misalnya "Jangan hasilkan wawasan tentang ukuran tabel." Anggap ini sebagai panduan, bukan penyaring yang dijamin efektif: seperti instruksi apa pun yang diberikan kepada LLM, instruksi ini biasanya diikuti, tetapi tidak diterapkan secara ketat.
  • Frekuensi analisis mengontrol seberapa sering Insights mengevaluasi telemetri Anda (misalnya, setiap jam). Hal ini terpisah dari seberapa cepat telemetri mentah masuk ke Unity Catalog, yang tetap berlangsung terus-menerus terlepas dari hal tersebut.

Insights menyimpan temuannya ke lokasi Workspace, yang berbeda dari tujuan Unity Catalog di atas: telemetri mentah disimpan sebagai tabel Delta, tetapi insight itu sendiri berupa file di Workspace Azure Databricks milik Anda sendiri.

Tetapkan ke proyek-proyek

Pilih proyek Lakebase yang sudah ada untuk konfigurasi ini, lalu simpan. Mengaturnya sebagai default workspace pada langkah sebelumnya mencakup proyek yang dibuat mulai sekarang; Menetapkan di sini akan membawa proyek Anda yang sudah ada di bawah konfigurasi yang sama.

Setelah menyimpan:

  • Konfirmasi komputasi sedang berjalan.
  • Jika Anda mengaktifkan pengamatan pada instans yang sudah berjalan, mulai ulang instans agar perubahan diterapkan. Selama masa Beta, telemetri tidak mulai dikirim pada instans yang sudah berjalan hingga instans tersebut dimulai ulang.

Langkah berikutnya

  • Last updated on