Important
この機能は、プライベート プレビュー段階にあります。 試すには、Azure Databricks の連絡先にお問い合わせください。
App Analyticsは、ユーザーがどのページを訪れ、どのような操作をし、ブラウザ上でどのように動作するかを理解するのに役立ちます。 Databricksアプリの 分析 ページを使って、使用状況を探り、ブラウザのパフォーマンスを調査し、最近のイベントをチェックしましょう。
ダッシュボードは、アプリが送信するイベントとAzure Databricksが収集したアクセス情報を組み合わせています。 分析イベントを送信するのに特定のクライアントライブラリは必要ありません。 イベントスキーマに従うプロデューサーなら誰でも供給できます。
必要条件
アプリ分析アクセスとテレメトリの設定は別々の要件があります。
テレメトリの構成
アプリのテレメトリを有効にし、分析イベントを送信する前にアプリを再デプロイしてください。 サポートされているリージョン、宛先テーブルの要件、設定権限については 、「要件 」および 「アプリテレメトリを有効にする」を参照してください。
テレメトリは、選択したカタログやスキーマの otel_logs テーブルを作成または再利用します。 テーブルプレフィックスを設定する場合は、対応する <prefix>_otel_logs テーブルを使いましょう。
分析結果の表示
Analyticsを開く人は以下のアクセス権を持っている必要があります:
-
CAN MANAGEアプリで。 -
USE CATALOGカタログで、USE SCHEMAスキーマで、SELECTテレメトリ ログ テーブルで。 - テーブルのクエリに使用される SQL ウェアハウスに対する SQL アクセスおよび
CAN USE。
アプリへのアクセスが自動的にテレメトリーテーブルや倉庫へのアクセスを許可するわけではありません。 Databricks アプリのアクセス許可の構成を参照してください。
オープンアナリティクスと完全なセットアップ
- アプリの詳細ページを開きます。
- アプリのナビゲーションで 「Analytics 」を選択してください。
- テレメトリーテーブルをクエリするためにSQLウェアハウスを選択します。
- 設定が不完全な場合は、オンボーディングページに従ってテレメトリの設定、イベント送信、イベントの到達確認を行います。 「 App Analyticsで始める」をご覧ください。
アプリやデータソースにアクセスできない場合、Analyticsは専用の権限ページを表示します。 アクセスが必要なリソースのガイダンスに従ってください。 欠損した権限に応じて、テーブルアクセスを要求するか、リソース所有者のアクセスリクエストをコピーしてください。 アクセスが許可されたら、もう一度確認してください。 権限エラーがあるからといって、テレメトリを再度設定する必要はない。
オンボーディングページと許可ページは異なる条件を扱っています。 オンボーディングはテレメトリの設定や最初のイベントの受信に役立ちます。 許可ページは、すでに設定されているリソースへのアクセスを助けてくれます。
ダッシュボードを探索する
分析のために時間範囲と倉庫を選択してください。 概要タブとウェブバイタルタブには、選択した範囲の過去データが表示されます。 更新された結果を取得するにはリフレッシュを使ってください。
Overview
概要タブには、ページビュー、セッション、追跡されたアクション、セッションごとのページ数、ユニークビューアが表示されます。 また、時間経過のトラフィック、頻繁に訪れたページ、頻繁に記録されたアクションも表示します。
以下のスクリーンショットは 、トップページ と トップアクション、 分析 アクションを含むものを示しています。
セッションやユニークビューアは異なる指標を測定します:
-
セッション:
session_idによって特定された分析活動ウィンドウ。 セッションは人ではありません。 イベントスキーマsession_idオプションです。 セッションベースの分析は生産者が提供することに依存しています。 - ユニークビューア:カスタム分析イベントスキーマとは別にアプリアクセスログからビューア情報を提供します。 分析イベントを送信してもユーザーIDは作成されません。
追跡アクションの場合は、そのボリューム、セッション数、ルート、周辺アクションを検査するために 「分析 」を選択してください。 Genie Code が利用可能な場合は、引き継ぎ機能を使用して調査を継続してください。 提出前にGenie Codeで用意したプロンプトを必ず確認してください。
ウェブバイタルズ
Web Vitalsタブでは、ブラウザのパフォーマンス測定、評価分布、傾向、ルートレベルの結果が表示されます。 指標を選択して、その閾値とサンプルサイズを検査します。
デフォルトのパーセンタイルは75パーセンタイル(p75)で、75% のサンプルがそれ以下の値を持っています。 また、メトリック詳細ビューでp50、p90、p99を選択することもできます。
以下のスクリーンショットは、Largest Contentful Paint(LCP)の詳細ビューを示しています。
コアとなるウェブバイタルは、LCP、次のペイントへのインタラクション(INP)、累積レイアウトシフト(CLS)です。 ページにはFirst Contentful Paint(FCP)とTime to First Byte(TTFB)も含まれています。 ウェブ バイタルルールを参照してください。
30個未満のサンプルに基づく結果は指標として扱いましょう。 表示された価値だけでは信頼できる傾向を確立しません。
ライブ イベント
ライブイベントタブでは定期的に最近のイベントを取得します。 フィルターを使ってイベントの種類、名前、ルートをチェックし、イベントを開いて詳細を確認できます。
このビューは有界イベントバッファを使用します。 テレメトリーテーブルの網羅的なエクスポートではありません。 表示された出来事を超えた歴史分析のために、直接テーブルをクエリしてください。
分析イベントを収集する
アプリは使用状況やブラウザパフォーマンス分析を入力するために、以下のイベントタイプを送信する必要があります:
| イベントの種類 | 記録内容 |
|---|---|
action |
レポートのエクスポートのような名前付きのやり取りや結果。 |
page_view |
アプリケーションのルートへのアクセス。 |
web_vital |
ブラウザのパフォーマンス測定です。 |
テレメトリを有効にしても、アプリのルートやビジネスアクションを自動的に計測するわけではありません。 インストゥルメンテーションを追加するか、イベントスキーマを実装するプロデューサーを使う。 「 App Analyticsで始める」をご覧ください。
以下の図は、アプリ生成の分析イベントの経過ルートを示しています。 ビューア情報は別のアプリアクセスソースを利用します。
- ブラウザはアプリのバックエンドにイベントを送信します。
- バックエンドはOpenTelemetry(OTel)ログレコードをアプリと併用して動作するコレクタにエクスポートします。
- コレクターはレコードをUnity Catalog の
otel_logsに書き込みます。 - アナリティクスはSQLウェアハウスを使ってテーブルをクエリします。
アプリのランタイムでサポートされているエンドポイントとトランスポートを活用してください。 コレクターを直接ブラウザに露出させないでください。 注入された環境変数については、 App Telemetry環境変数を参照してください。
制限とデータ処理
アナリティクスイベントはプロダクト分析を支援します。 それらは権威ある取引記録やセキュリティ監査ログではありません。 配信はベストエフォートであるため、イベントが失われたり、複数回配信されたりすることがあります。
イベント名、パス、プロパティを送信する前にサニティ化してください。 認証情報、個人情報、ユーザーが入力したテキストは含めないでください。 クエリ側フィルタリングは、プロデューサーがすでに基礎テレメトリーテーブルに書き込んだ機密データを除去しません。
テレメトリのインジェスやSQLウェアハウスクエリはプラットフォームリソースを使用します。 テレメトリ請求の詳細は「 価格設定」をご覧ください。