New Relic のブラウザモニタリングを利用して、 カスタムイベントや属性を追加することができます。 。
カスタムアトリビュート
カスタムアトリビュートをすべてのbrowserイベントに追加すると、データを書き込んだりフィルタリングして、アプリケーションに関するさらなる質問に答えることができます。
カスタムイベント
ブラウザ API のrecordCustomEvent
メソッドを使用して、カスタム属性を持つイベントをキャプチャします。
ページアクション
browser APIのaddPageAction
呼び出しを使用して、アプリケーションでイベント、アクション、ルート変更、またはエンドユーザー インタラクションをキャプチャします。 addPageAction
呼び出しは、アクション名、ページに関連するメタデータ、および一緒にキャプチャしたカスタムアトリビュート名と値を含む、 PageAction
という名前のイベントを追加します。
前提条件
Custom
イベントを報告するには、次の前提条件を確認してください:
Requirement | Comments |
---|---|
エージェントバージョン | ブラウザ監視エージェントのバージョンは1.277.0 以上である必要があります。 |
クライアントのブラウザのバージョン |
|
サイクルあたりのイベント数 |
|
イベント/アトリビュートのネーミング、データタイプ、サイズ | イベント/属性の命名構文、データタイプ、およびサイズに関する の一般的な要件に確実に従ってください。 |
PageAction
イベントを報告するには、次の前提条件を確認してください:
Requirement | Comments |
---|---|
エージェントバージョン | お使いのブラウザの監視エージェントのバージョンは 593 以上でなければなりません. |
クライアントのブラウザのバージョン |
|
サイクルあたりのイベント数 |
|
イベント/アトリビュートのネーミング、データタイプ、サイズ | イベント/属性の命名構文、データタイプ、およびサイズに関する の一般的な要件に確実に従ってください。 |
カスタムイベントを作成する
custom
イベントを作成するには:
- ブラウザエージェントがアプリにインストールされていることを確認します
- アプリケーションの JavaScript の関連部分で
newrelic.recordCustomEvent
関数を呼び出します。 - アプリケーションが実行され、指定した eventType で関連する
custom
イベントが報告されるまで、数分お待ちください。 - イベントのキャプチャに使用した
eventType
プロパティ(およびイベントと一緒に送信した関連プロパティ)を含むイベントのNRQL実行します。
- たとえば、
eventType
がFoo
で属性がbar: 123
のcustom
イベントを送信した場合、次のようなクエリを実行できます。SELECT * FROM Foo WHERE bar = 123
PageActionイベントの作成
PageAction
イベントを作成するには:
- ブラウザエージェントがアプリにインストールされていることを確認します
- アプリケーションの JavaScript の関連部分で
newrelic.addPageAction
関数を呼び出します。 - アプリケーションが実行され、関連する
PageAction
イベントが報告されるまで数分待ちます。 - イベントのキャプチャに使用した
actionName
属性 (およびアクションと共に送信した関連属性) を含むPageAction
イベントのNRQL クエリを実行します。
- たとえば、
actionName
がFoo
で属性がbar: 123
のPageAction
イベントを送信した場合、次のようなクエリを実行できます。SELECT * FROM PageAction WHERE actionName = 'Foo' AND bar = 123
ブラウザイベントにカスタムアトリビュートを追加
すべてのブラウザイベントにカスタムアトリビュートを追加できます。 setCustomAttribute
API使用して追加したカスタム アトリビュートは、キャプチャされたすべてのイベントに追加されます。
カスタムアトリビュートを追加するには 2 つの方法があります。
重要な検討事項やベストプラクティスは以下の通りです。
AI モニタリングを使用して、カスタムイベント タイプの総数を約 5 つに制限する必要があります。 カスタムイベント タイプは、高レベルのカテゴリをカプセル化するために使用することを目的としています。 たとえば、さまざまな目的を持つ多数のイベントを含むジェスチャーというイベント タイプを作成するとします。
カスタムイベントの名前にイベント タイプを使用することは避けてください。 イベント タイプを作成してデータのカテゴリを格納し、そのカテゴリ内のプロパティを使用してイベントを区別します。 多数のカスタムイベントを作成できますが、報告されるイベントの種類の数を制限してデータを管理しやすくすることが重要です。
帰属表示を含む
カスタムbrowserイベントは、イベントが発生したときのbrowser環境のコンテキストを理解しやすくすることを目的とした次のプロパティで装飾されています。
トラブルシューティング
ここでは、トラブルシューティングをご紹介します。
Problem | Comments |
---|---|
カスタム属性の欠落 | カスタム属性が |
| クエリ時に 要件が満たされている場合は、 予約された属性名や無効な値を使用していないかを確認してください。 |
| クエリ時に 要件が満たされている場合は、 予約された属性名や無効な値を使用していないかを確認してください。 |