관측 가능성 설정

Important

이 기능은 베타 버전으로 제공됩니다. 작업 영역 관리자는 미리 보기 페이지에서 이 기능에 대한 액세스를 제어할 수 있습니다. Azure Databricks 미리 보기 관리를 참조하세요.

옵저버빌리티 구성은 Lakebase Postgres의 상세 텔레메트리를 Unity Catalog의 Delta 테이블로 수집합니다. 인사이트, Genie, 대시보드 모두 이 데이터를 기반으로 실행됩니다; 프로젝트는 구성이 첨부되기 전까지는 이 중 하나도 갖추지 않습니다.

구성은 하나 또는 여러 프로젝트를 커버할 수 있는 단일 객체입니다. 정체성을 부여하는 방법은 두 가지가 있으며, 설계상 공존합니다:

  • 워크스페이스 관리자는 워크스페이스의 기본값으로 서비스 프린시펄 구성을 설정하여, 모든 새 프로젝트가 자동으로 관측 가능성을 받게 됩니다.
  • 개별 프로젝트 소유자는 사용자 신원 증명으로 자신의 프로젝트를 설정합니다.

작업 공간은 보통 혼합된 형태로 끝납니다: 대부분의 프로젝트가 공유 기본값에 있고, 일부는 자체 설정을 가지고 있습니다. 이 페이지는 두 경로 모두에 대한 전체 설정을 다룹니다. 자신이 소유한 단일 프로젝트를 설정하려면 퀵스타트를 참고하세요.

Prerequisites

  • 워크스페이스에서 Lakebase Advanced Postgres 텔레메트리 미리 보기가 사용 설정되었습니다. 작업 영역 관리자가 미리보기 페이지에서 이를 활성화합니다.
  • AWS나 Azure에서 Lakebase 프로젝트를 운영하는 것. Postgres 데이터베이스 가져오기를 참조하세요.
  • 텔레메트리를 수신할 Unity Catalog 카탈로그 및 스키마입니다. 스키마가 이미 있어야 하며 카탈로그는 기본 스토리지를 사용할 수 없습니다.

구성 설정

정체성을 선택하세요. 이 구성은 위드에서 선택한 신원으로 텔레메트리를 Unity 카탈로그에 기록합니다. 이 선택이 구성의 도달 거리와 지속 시간을 결정합니다:

  • 특정 개인의 계정에 묶이지 않는 내구성 있는 구성을 위한 서비스 주체 를 선택하세요. 이것이 관측 가능성을 표준화하는 데 적합한 방법입니다: 워크스페이스 기본값으로 설정하고 기존 프로젝트에 할당하세요. 서비스 주체를 선택하는 것은 작업 공간 관리자 전용이며, 먼저 프로비저닝을 해야 합니다(아래 1단계 참조).
  • 사용자 수준의 자격 증명을 선택해 프로젝트를 직접 접근 권한으로 설정하고, 아무런 프로비저닝 없이 프로젝트를 구성하세요. 이는 당신이 소유한 개별 프로젝트에 적합합니다. 권한에 맞게 범위가 설정되어 있으니, 서비스 주체 프로비저닝 단계를 건너뛰고 설정 마법사 열기부터 시작하세요.

서비스 주체를 제공한다

사용자 수준 자격 증명을 사용한다면 설정 마법사 열기로 건너뛰세요.

구성을 만들기 전에 서비스 주체에게 아래 네 가지 권한을 부여하면, 마법사에서 바로 선택할 수 있습니다. 그들은 독립적이며, 각각은 다른 장소에서 부여됩니다. 하나라도 누락되면 구성은 계속 저장되지만, 텔레메트리 데이터는 아무런 표시 없이 수집되지 않고 원인을 알려 주는 오류 메시지도 없이 인사이트도 생성되지 않습니다. 만약 어떤 구성에서 텔레메트리가 생성되지 않는다면, 먼저 이 부분들을 확인하세요.

Grant 어디에 설정할까 필요한 이유
작업 영역 액세스 교장 설정(Configurations) 탭, 권한(Entitlements) 항목 서비스 주체가 작업 영역에서 아예 활동할 수 있도록 허용합니다. 이 기능이 없으면 Lakebase는 텔레메트리를 아무것도 할 수 없는 아이덴티티로 작성하여 모든 텔레메트리 테이블이 비어 있습니다.
작업 영역 관리자 설정 > 신원 및 접근 > 그룹: 관리자 그룹을 열고 프린시펄을 추가하세요 현재 백그라운드 에이전트는 원격 분석을 작성하고 인사이트를 생성하기 위해 관리자 액세스 권한이 필요합니다.
사용 가능 교장의 권한 탭 위저드에서 원칙을 선택할 수 있습니다. 서비스 주체를 생성하면 CAN MANAGE가 부여되는데, CAN USE는 포함되지 않으므로 명시적으로 부여합니다. 서비스 주체 관리에 대한 역할을 참조하세요.
Unity 카탈로그 권한 목적지 카탈로그와 스키마(아래 SQL 참조) 주체가 카탈로그 USE CATALOGUSE SCHEMA 와 스키마 모두에서 텔레메트리 테이블 CREATE TABLE 을 만들고 작성할 수 있게 합니다.

작업 공간 액세스 권한과 CAN USE 권한을 Settings > Identity and access > Service principals에서 부여하세요. Unity 카탈로그 권한은 카탈로그 탐색기나 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>`;

메모

작업 공간 관리자 요구는 현재 베타 제약 사항이며, 향후 릴리스에서 더 좁아질 수 있습니다. 원격 분석 및 인사이트가 작동하도록 지금은 허용하세요.

구성 마법사를 열기

어느 곳에서든 마법사를 열어보세요. 두 가지 모두 같은 마법사를 엽니다:

  • Lakebase>인사이트>구성 관리>새 구성 추가
  • 프로젝트 고유의 설정>관찰 가능성 구성>에서새 구성 만들기

다음 세 단계의 위저드 단계를 순서대로 완료하고, 그 사이에 '다음' 을 클릭하세요.

구성

구성의 이름을 지정하고 해당 원격 분석 데이터가 수집될 위치를 선택합니다. 여기서 두 가지 선택은 일시 중지할 가치가 있습니다.

  • 이 설정을 새 프로젝트의 기본 설정으로 설정 하면 워크스페이스를 기본값으로 만듭니다: 워크스페이스에서 새로 생성된 모든 프로젝트 는 자동으로 이 구성이 할당되며, 생성자의 아무런 조치도 없습니다. 이 기능을 켜면 작업 공간 전체에서 관측 가능성을 표준화할 수 있습니다. 작업 공간은 최대 하나의 기본 설정이 있고, 기본값은 이후에 생성된 프로젝트에만 적용되므로, 프로젝트 할당 단계에서 기존 프로젝트에도 할당할 수 있습니다. 이 구성을 전체 작업공간이 아니라 특정 프로젝트에 적용하고 싶다면 이 설정을 끄지 마세요.
  • Identity (Authorize Lakebase to write your data 아래)는 Choose an identity에서 선택한 항목에 따라 Lakebase가 텔레메트리를 기록할 때 사용하는 계정입니다. 서비스 주체 사용을 선택하고 프로비저닝한 주체를 선택하거나, 사용자 본인으로 실행하려면 사용자 수준 자격 증명 사용을 선택하세요. 작업 영역 관리자만 서비스 주체를 선택할 수 있습니다.

Unity 카탈로그에 원격 분석 보내기 아래에서 테이블이 배치되는 카탈로그 및 스키마를 선택하고 선택적으로 테이블 접두사를 선택합니다. 목적지를 선택하는 것이지 설계하는 것이 아닙니다: Lakebase는 텔레메트리를 처음 기록할 때 캡처되는 테이블 을 생성합니다. 스키마가 이미 있어야 하며 카탈로그는 기본 스토리지를 사용할 수 없습니다. 카탈로그 탐색기에서 카탈로그를 만들 때 기본 스토리지 사용 이 기본적으로 선택되므로 여기에서 사용하는 카탈로그에 대해 선택을 취소해야 합니다.

인사이트 활성화

인사이트 사용이 설정되었는지 확인합니다. 백그라운드 인사이트 에이전트를 실행하는 것입니다. 그것이 없으면 구성은 원격 분석을 Unity 카탈로그에 기록하지만 선제적으로는 아무것도 표시하지 않습니다. 다음과 같은 두 개의 관련 필드가 나타납니다.

  • 지침 은 각 분석이 통과하기 전에 에이전트가 읽는 무료 텍스트입니다(예: "테이블 크기에 대한 인사이트를 생성하지 마세요."). 보장된 필터가 아닌 지침으로 처리합니다. LLM에 제공된 명령처럼 일반적으로 엄격하게 적용되지 않고 따릅니다.
  • 분석 빈도 는 Insights가 텔레메트리를 얼마나 자주 평가하는지(예: 매시간 평가)를 조절합니다. 이는 원시 텔레메트리 데이터가 Unity 카탈로그에 얼마나 빨리 유입되는지와는 별개이며, 이와 관계없이 지속적으로 이루어집니다.

Insights는 그 결과를 위의 Unity 카탈로그 대상과는 다른 작업 영역 위치에 저장합니다. 원시 원격 분석은 델타 테이블로 표시되지만 인사이트 자체는 고유한 Azure Databricks 작업 영역에 있는 파일입니다.

프로젝트에 할당하기

이 구성이 적용되는 기존 Lakebase 프로젝트를 선택한 후 저장하세요. 이전 단계에서 워크workspace 기본값으로 설정하면 이제부터 생성된 프로젝트들이 포함됩니다; 여기에 할당하면 기존 프로젝트들이 동일한 구성 안에 들어갑니다.

저장 후:

  • 컴퓨트가 실행 중인지 확인하세요.
  • 이미 실행 중인 인스턴스에서 관찰 가능성을 사용하도록 설정한 경우 변경 내용이 적용되도록 인스턴스를 다시 시작합니다. 베타 기간에는 이미 실행 중인 인스턴스가 다시 시작되기 전까지는 원격 분석 데이터가 전송되기 시작하지 않습니다.

다음 단계

  • Last updated on