可観測性を構成する

Important

この機能は ベータ版です。 ワークスペース管理者は、[ プレビュー] ページからこの機能へのアクセスを制御できます。 Manage Azure Databricks プレビューを参照してください。

観測可能性構成は、Unityカタログ内のDeltaテーブルとしてLakebase Postgresの深いテレメトリをキャプチャします。 Insights、 Genie、ダッシュボードはすべてこのデータに基づいて動作 します 。プロジェクトには構成が付加されるまではこれらの要素が一切ありません。

構成とは、1つまたは複数のプロジェクトをカバーできる単一のオブジェクトのことです。 アイデンティティを付与する方法は2つあり、設計上共存しています。

  • ワークスペース管理者はサービスプリンシパル構成をワークスペースのデフォルトとして設定し、新しいプロジェクトごとに自動的に観測可能性が付与されます。
  • 個々のプロジェクトオーナーはユーザーID認証情報で自分のプロジェクトを設定します。

ワークスペースは通常、ほとんどのプロジェクトが共有デフォルトで、一部は独自の設定を持つ混合状態になります。 このページではどちらの道でも全ての準備を解説しています。 自分が所有する単一のプロジェクトを設定するには、 クイックスタートをご覧ください。

前提条件

  • ワークスペースで Lakebase Advanced Postgres Telemetry のプレビューが有効になっています。 ワークスペース管理者は 、[プレビュー] ページから有効にします。
  • AWS または Azure 上の Lakebase 自動スケーリング プロジェクト。 Postgres データベースの取得を参照してください。
  • テレメトリを受信するための Unity カタログ カタログとスキーマ。 スキーマは既に存在している必要があり、カタログでは既定の ストレージを使用できません。

設定を立ててください

アイデンティティを選びましょう。 この構成は、ウィザードで選択したアイデンティティとしてテレメトリをUnity Catalogに書き込みます。 その選択が構成の到達範囲と持続時間を決定します:

  • 特定のアカウントに縛られない耐久性のある 構成のサービスプリンシパル を選びましょう。 これは観測可能性の標準化に適しており、ワークスペースのデフォルトに設定し、既存のプロジェクトに割り当てます。 サービスプリンシパルの選択はワークスペース管理者のみで、まずプロビジョニングを行います(下記のステップ1)。
  • ユーザー レベルの認証情報 を選択して、プロビジョニングなしでプロジェクトを自分のアクセスで設定してください。 これはあなたが所有する個別プロジェクトに適しています。 権限に限定されているので、サービス主体のプロビジョニングステップを飛ばして「 設定ウィザードを開く」から始めてください。

サービスプリンシパルの提供

ユーザーレベルの認証情報を使っている場合は、 設定ウィザードを開くところに飛ばしてください。

設定を作成する前に、サービスプリンシパルに以下の4つの権限を付与し、ウィザードで選択できるようにしてください。 これらは独立しており、それぞれ異なる場所で付与されます。 もし不足している設定でもセーブされますが、テレメトリーは静かに着地せず、原因を示すエラーもありません。 構成でテレメトリが得られない場合は、まずこれらを確認してください。

Grant どこに設定するか 必要な理由
ワークスペースへのアクセス 校長の 設定 タブ、 権限欄 サービスプリンシパルが作業スペースで行動できるようにしています。 これがなければ、Lakebaseはテレメトリを何もできないアイデンティティとして書き込むため、すべてのテレメトリーテーブルは空のままになります。
ワークスペース管理者 設定 > グループ > の識別とアクセス: 管理者 グループを開き、プリンシパルを追加します 現在、バックグラウンド エージェントでは、テレメトリを書き込んで分析情報を生成するために管理者アクセス権が必要です。
使える 校長の パーセンテージ タブ ウィザードで校長を選べます。 サービスプリンシパルを作成するとCAN MANAGEが付与されますが、CAN USEは含まれていないので、明示的に付与します。 サービス プリンシパルを管理するロールを参照してください。
Unity カタログの権限 宛先カタログとスキーマ(以下のSQLを参照) プリンシパルがテレメトリテーブルを作成・書き込むことができます。カタログ上で USE CATALOG 、スキーマ上で USE SCHEMA 、 CREATE TABLE します。

Workspaceにアクセス権とCAN USEをIdentity>設定で付与し、Service Principals>アクセスします。 カタログエクスプローラーまたはSQLでUnity Catalogの権限を付与してください:

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

ワークスペース管理者の義務は現在のベータ制約であり、後のリリースで縮小される可能性があります。 テレメトリと分析情報が機能するように、今はそれを付与してください。

設定ウィザードを開きます

どちらの場所からウィザードを開けてください。 どちらも同じウィザードを開けます:

  • Lakebase>Insights>構成の管理>新しい構成を追加から
  • プロジェクトの独自の設定>Observability 構成から>新しい構成を作成する

続く3つのウィザードステップを順番に完了し、その間を「 次へ 」をクリックします。

構成

構成に名前を付け、テレメトリが配置される場所を選択します。 ここでは、次の 2 つの選択肢を一時停止する価値があります。

  • これを新しいプロジェクトのデフォルト設定にすると 、ワークスペースのデフォルトにします。ワークスペースで作成されたすべての 新しい プロジェクトは自動的にこの設定を割り当てられ、作成者の操作はありません。 これをオンにすると、ワークスペース全体で観測可能性を標準化できます。 ワークスペースには最大で1つのデフォルトが設定されており、デフォルトはその後に作成されたプロジェクトにのみ適用されるため、プロジェクト に割り当て るステップで既存のプロジェクトにも割り当てます。 この設定をワークスペース全体ではなく特定のプロジェクトに適用したい場合はオフにしてください。
  • Identity ( Authorize to your data write)は、Lakebaseが「 Choose a identity」で選択した後にテレメトリを書き込むアカウントです。 「 Service principal を使う 」を選択してプロビジョニングしたプリンシパルを選ぶか、ユーザー レベルの認証情報 を使って自分で実行します。 ワークスペース管理者のみがサービス プリンシパルを選択できます。

[ テレメトリを Unity カタログに送信する] で、テーブルが格納されている カタログ と スキーマ を選択し、必要に応じてテーブル プレフィックスを選択します。 あなたは目的地を選ぶのであって、設計しているわけではありません。Lakebaseは、テレメトリを初めて書き込むときに キャプチャされるもの に記載されたテーブルを作成します。 スキーマは既に存在している必要があり、カタログでは 既定のストレージを使用できません。 カタログ エクスプローラーでカタログを作成する場合は既定で [ 既定のストレージを使用 する] が選択されているため、ここで使用するカタログの場合は必ずクリアしてください。

分析情報を有効にする

[分析情報を有効にする] がオンになっていることを確認します。 バックグラウンドの Insights エージェントを動作させるものです。 これを使用しないと、構成によってテレメトリが Unity カタログに書き込まれますが、事前に何も表示されません。 次の 2 つの関連フィールドが表示されます。

  • 手順 は、エージェントが各分析パスの前に読み取るフリー テキストです 。たとえば、"テーブル サイズに関する分析情報を生成しない" などです。保証されたフィルターではなく、ガイダンスとして扱います。LLM に与えられた命令と同様に、通常は従われ、厳密には適用されません。
  • 分析頻度 は、Insightsがテレメトリーを評価する頻度(例えば1時間ごと)を制御します。 これは、未加工のテレメトリが Unity Catalog にどれだけ速く取り込まれるかとは別の話であり、それとは関係なく継続的に行われます。

Insights は、上記の Unity カタログの宛先とは異なるワークスペースの場所に結果を保存します。未加工のテレメトリは Delta テーブルとして到着しますが、分析情報自体は独自の Azure Databricks ワークスペース内のファイルです。

プロジェクトへの割り当て

この構成が適用される既存のLakebaseプロジェクトを選択し、保存します。 前のステップでワークスペースのデフォルトに設定すると、今後作成されたプロジェクトもカバーされます。ここに割り当てると、既存のプロジェクトも同じ構成に組み込まれます。

セーブ後:

  • 計算が実行されているか確認してください。
  • 既に実行されているインスタンスで可観測性を有効にした場合は、変更を有効にするためにインスタンスを再起動します。 ベータ期間中、テレメトリは再起動するまで、既に実行中のインスタンスでフローを開始しません。

次のステップ

  • Last updated on