Observeでデータをモニターする

Observe は、トラッキングプランと照らしてイベントストリームを継続的に検査、分析、監視し、無効なイベント、欠落したイベント、および古いイベントが発生したときにそれを明らかにします。 コードの変更が不要で、バックグラウンドで自動的に実行されるため、トラッキングコードとトラッキングプランを同期させます。Observe は、すべてのイベントに 4 つのステータス（予期しない、有効な、無効な、または古い）のうち 1 つを割り当てます。

Observe は既存のイベントストリームをリッスンし、トラッキングコードをライブドキュメントに変換します。そのため、プラットフォーム間でデータ収集を全体的に把握できます。

お客様とチームの皆様は、問題がある箇所や注意が必要な事象について、すぐにインサイトを得ることができます。直感的でコラボレーションに適したワークフローにより、チームは協力して修正を実装し、トラッキング計画を適切に維持することができます。

イベントステータスの表示と更新

イベントストリームにアクセスするには、[データ] > [イベント] に移動します。 これにより、すべてのイベントが表示されます。

トラッキング計画を初めて表示すると、Amplitudeには受信および処理されたすべてのイベントとプロパティが表示されます。 デフォルトでは、Amplitudeはすべてのイベントとプロパティを予期しないものに分類します。 トラッキングプランに追加するには、イベント名の横にあるチェックボックスをオンにし、[プランに追加] をクリックします。

これは、予期しないイベントをトラッキング計画に追加したいときにいつでも行うことができます。 Publish をクリックしてプロセスを完了します。この時点以降、このイベントまたはそれに関連付けられたプロパティに対する変更について、Observe が通知します。

イベントのステータスは常に次の 4 つのいずれかです。

• 予期しない: トラッキングプランにまだ追加されていないイベントやプロパティ。
• 有効（かつ最新）: 既存のイベントの最新バージョンに（名前とスキーマにおいて）一致するイベントまたはプロパティです。Observe がイベントのバージョンを認識していない場合、イベントの形状が現在のトラッキング計画と一致していることを確認するだけです。
• 無効: 現在のトラッキング計画と一致しないイベントまたはプロパティです。
• 古いもの：既存のイベントまたはプロパティの以前のバージョンと一致するイベントまたはプロパティ（Amplitude SDKを使用している場合にのみ適用可能）。

データが表面化するのと同時に、そのデータのみを監視してください。レガシートラッキングや頻繁に発生しないイベントがある場合は、トラッキングプランに表示されない可能性があります。 Observe が表示しないイベントをご存じの場合は、手動でプランに追加するか、自分でイベントをトリガーできます。

ObserveとAmpli CLI

AmplitudeのSDKを使用してすべてのイベントトラッキングを計測済みであれば、タイプセーフなアナリティクスライブラリ、クライアント側の検証、信頼できるクリーンで正確なデータのためのCIとの継続的な連携のメリットをすでに受けています。

Observe は、Web アプリの実行時の検証エラーを検出して警告することで、依然として価値を高めます。 これは JavaScript に特に関連しています。なぜなら、JavaScript は型セーフな言語ではなく、チェックは実行時にのみ行われるからです。 詳細については、Amplitude データ開発者向けドキュメントを参照してください。

観測されたイベントや問題点を使用して追跡計画をオーバーレイ

トラッキング計画をイベントストリームでオーバーレイすることができます。

Amplitude SDK を使用している場合は、環境からのイベントストリームを使用してトラッキングプランをオーバーレイすることもできますが、これは現在使用している特定のブランチに送信されたデータのみが対象です。これは、複数のチームが環境にデータを送信する場合のデバッグに役立ちます。

また、イベントストリームをトラッキングプランと重ね合わせるために使用する特定の時間範囲を設定することもできます。 次のものから選択できます。

• 5分間です
• 1時間です
• 12時間です
• 7日間です
• 14日です

この範囲を変更すると、Observe がイベントを有効とみなすか無効とみなすかを決定できます。 たとえば、7 日前にバグが発生した場合、直近 7 日間 を選択すると、そのイベントは無効として表示されます。7 日前～12 時間前のいずれかの時点で修正を行い、過去 12 時間 を選択した場合、Observe はそれを有効とみなします。

Observe インサイトに基づいて行動する

Observeは、イベントにおける欠落したプロパティや無効なプロパティを表面化させます。プロパティ行には、この情報がいくつかの方法で表示されます。

• ステータスツールチップ：Amplitudeがイベントを受信した時点でイベントが無効だったかどうかを示します（Observe がバージョンを受信した場合、イベントをバージョンと比較します。そうでない場合、イベントを現在のトラッキングプランと比較します）。
• 表示率（%）インジケーター：プロパティが必要であり（公開されているか未公開であるか）、選択した期間内にプロパティなしでAmplitudeがイベントを受信した場合に赤色です。 未公開の変更がある場合や、最近イベントを変更した場合は、ステータスが緑色であってもインジケーターが赤色になることがあります。
• タイプインジケーター：選択された期間内にAmplitudeが選択されたタイプ（公開済みまたは未公開）以外のプロパティを受け取った場合、赤色になります。 未公開の変更がある場合や、最近イベントを変更した場合は、ステータスが緑色であってもインジケーターが赤色になることがあります。

Observe は各イベントのソースを自動的に検出し（ライブラリに基づいて）、イベント詳細ペインにそれらのソースを表示します。これは、複数のソースが異なるチームによって管理されている場合に特に役立ちます。これは、どのソースが無効なデータを送信しているかを特定できるからです。

ソース名の右側にあるスパークラインには、合計イベント量と無効イベント量の両方が表示されており、エラーのあるデータの量を定量化できます。

また、同じライブラリを使用して複数の SDK ソースを作成して割り当てることもできます。たとえば、ブラウザSDKを使用するマーケティングサイトとWebアプリがある場合、2つの異なるソースを作成し、それぞれのイベントに正しいソースを割り当てることができます。また、Ampliを使用すると、各ソースのボリュームと検証データを別々に確認することもできます。Ampli を使用していない場合は、両方のソースのボリュームがライブラリ名（この場合は「ブラウザ SDK」）とともに単一の行にまとめられていることがわかります。

適用範囲と制限事項

Observeは、Amplitudeにデータを送信する場合にデフォルトで動作します。Observeは、Amplitudeへのデータの送信方法によって制限されます。AmplitudeのSDKを使用している場合（現在のソースサポート：JavaScript、Node.js、Android、iOS）、Observeはイベントストリームをそれぞれのソース（ウェブ、iOS、バックエンドなど）に帰属させることができます。