What is App アナリティクス?
プレビュー
この機能は プライベート プレビュー段階です。試用については、Databricksの連絡先にお問い合わせください。
App Analyticsを使用すると、アプリのオーナーは、ユーザーがどのページにアクセスしたか、どのようなアクションを実行したか、そしてブラウザでアプリがどのように動作しているかを把握できます。Databricksアプリの アナリティクス ページを使用して、使用状況の探索、ブラウザのパフォーマンスの調査、最近のイベントの検査を行います。
ダッシュボードには、アプリが送信するイベントと、Databricksによって収集されたアプリのアクセス情報が組み合わされます。アナリティクスイベントを送信するために、特定のクライアントライブラリは必要ありません。イベントスキーマに従うプロデューサーであれば誰でも、それらを提供できます。
要件
App Analyticsへのアクセスとテレメトリ構成には、それぞれ異なる要件があります。
テレメトリを構成
アナリティクスイベントを送信する前に、アプリテレメトリを有効にしてアプリを再デプロイしてください。サポートされているリージョン、宛先テーブルの要件、および構成の権限については、要件とアプリテレメトリの有効化を参照してください。
テレメトリにより、選択したカタログとスキーマに otel_logs テーブルが作成されるか、既存のテーブルが再利用されます。テーブルのプレフィックスを設定する場合は、対応する <prefix>_otel_logs テーブルを使用します。
アナリティクスを表示
アナリティクス を開くユーザーには、次のアクセス権が必要です。
CAN MANAGEアプリ上で。USE CATALOGカタログ上のUSE SCHEMA、スキーマ上の、およびテレメトリー Logs テーブル上のSELECT。- テーブルのクエリーに使用されるSQLウェアハウス上のSQLアクセスと
CAN USE。
アプリへのアクセス権が付与されても、そのテレメトリーテーブルやwarehouseへのアクセス権が自動的に付与されるわけではありません。See Configure permissions for a Databricks app.
Open アナリティクスを開いてセットアップを完了します
- アプリの詳細ページを開いてください。
- アプリのナビゲーションで [アナリティクス] を選択します。
- テレメトリーテーブルをクエリーするためのSQLウェアハウスを選択します。
- セットアップが完了していない場合は、オンボーディングページの手順に従ってテレメトリを構成し、イベントを送信して、イベントが届いていることを確認してください。「Get started with App Analytics」を参照してください。
アプリやそのデータソースにアクセスできない場合、アナリティクスには専用の権限ページが表示されます。アクセスが必要なリソースの手順に従ってください。不足している権限に応じて、テーブルアクセスをリクエストするか、リソース所有者向けのアクセスリクエストをコピーします。アクセスが許可されたら、もう一度確認してください。権限エラーが表示された場合でも、テレメトリを再度設定する必要はありません。
オンボーディングページと権限ページでは、異なる条件に対処します。オンボーディングは、テレメトリの構成と最初のイベントの受信に役立ちます。権限ページは、すでに構成されている可能性のあるリソースへのアクセス権を取得するのに役立ちます。
ダッシュボードを探索する
分析の時間範囲とwarehouseを選択します。 Overview および Web Vitals の各tabには、選択した範囲のヒストリカルデータが表示されます。更新を使用して、更新された結果を取得します。
概要
The Overview tabには、ページビュー、セッション、追跡対象のアクション、セッションあたりのページ数、および一意の閲覧者が表示されます。また、一定期間のトラフィック、頻繁にアクセスされるページ、および頻繁に記録されるアクションも表示されます。
次のスクリーンショットは、 [Analyze] アクションを含め、 [Top pages] と [Top actions] を示しています。
セッション数とユニーク閲覧者数は異なるものを測定します。
- Sessions ：
session_idによって特定されたアナリティクスアクティビティウィンドウ。セッションは人物ではありません。イベントスキーマにより、session_idが任意になります。セッションベースの分析は、それを供給するプロデューサーに依存します。 - Unique viewers : カスタムアナリティクスイベントスキーマとは異なる、アプリアクセス Logs からのビューアー情報。アナリティクスイベントを送信しても、ユーザーIDは作成されません。
追跡されたアクションについて、 Analyze を選択してボリューム、セッション、ルート、および関連するアクションを検査します。Genie Codeが利用可能な場合は、ハンドオフを使用して調査を続行します。Genie Codeで準備されたプロンプトを送信する前に確認してください。
Web Vitals
The Web Vitals tab shows browser performance measurements, rating distributions, trends, and route-level results.メトリクスを選択して、そのthresholdとサンプルサイズを確認します。
The default percentile is the 75th percentile (p75): 75% of samples have a value at or below it.メトリックの詳細ビューで、p50、p90、または p99 を選択することもできます。
次のスクリーンショットは、最大コンテンツの描画（LCP）の詳細ビューを示しています。
Core Web Vitalsは、LCP、Interaction to Next Paint（INP）、およびCumulative Layout Shift（CLS）です。また、このページにはFirst Contentful Paint（FCP）とTime to First Byte（TTFB）も含まれます。Web Vitalルールを参照してください。
30 未満のサンプルに基づく結果は参考値として扱います。表示された値は、信頼できるトレンドを確立するものではありません。
ライブイベント
Live Events tabでは、定期的に最近のイベントを取得します。フィルターを使用してイベントの種類、名前、ルートを確認し、イベントを開いて詳細を表示します。
このビューでは、境界付きイベントバッファーを使用します。これは、テレメトリテーブルの完全なエクスポートではありません。表示されているイベントを超える過去の分析を行うには、テーブルを直接クエリーします。
アナリティクスイベントを収集する
使用状況とブラウザのパフォーマンス分析にデータを反映させるには、アプリから次のイベントタイプを送信する必要があります：
イベントタイプ | 記録される内容 |
|---|---|
| レポートのエクスポートなど、名前付きのインタラクションまたは結果。 |
| アプリケーションルートへのアクセス。 |
| ブラウザのパフォーマンス測定。 |
テレメトリを有効にしても、アプリのルートやビジネスアクションが自動的にインストルメント化されるわけではありません。インストルメント化を追加するか、イベントスキーマを実装するプロデューサーを使用してください。参照：App アナリティクスの利用開始。
次の図は、アプリで生成されたアナリティクスイベントのパスを示しています。閲覧者情報では、別のアプリアクセスソースを使用します。
- ブラウザからアプリのバックエンドにイベントが送信されます。
- バックエンドは、アプリと並行して実行されているコレクターに OpenTelemetry (OTel) log レコードをエクスポートします。
- コレクターは、レコードを Unity Catalog の
otel_logsに書き込みます。 - アナリティクスは、SQLウェアハウスを使用してテーブルに対してクエリーを実行します。
アプリのランタイムでサポートされているEndpointとトランスポートを使用してください。コレクターをブラウザーに直接公開しないでください。注入された環境変数については、Appテレメトリの環境変数を参照してください。
制限事項とデータの処理
アナリティクスイベントは製品分析をサポートします。正式な取引記録やセキュリティ監査Logsではありません。配信はベストエフォートであるため、イベントが失われたり、複数回配信されたりする可能性があります。
送信前にイベント名、パス、およびプロパティをサニタイズします。資格情報、個人データ、またはユーザーが入力したテキストを含めないでください。クエリー側のフィルタリングでは、プロデューサーがすでに基礎となるテレメトリテーブルに書き込んだ機密データは削除されません。
テレメトリーの取り込みとSQLウェアハウスのクエリーでは、プラットフォームのリソースが使用されます。テレメトリーの課金の詳細については、価格を参照してください。