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 |
|---|---|
カスタム属性の欠落 | カスタム属性が |
| クエリ時に 要件が満たされている場合は、 予約された属性名や無効な値を使用していないかを確認してください。 |
| クエリ時に 要件が満たされている場合は、 予約された属性名や無効な値を使用していないかを確認してください。 |