recordCustomEvent

構文

newrelic.recordCustomEvent(string $eventType[, JSON object $attributes])

カスタムアトリビュートを使用して、指定されたeventTypeでカスタムbrowserイベントをレポートします。

要件

• ブラウザ Pro または Pro+SPA エージェント (v1.277.0 以降)

• npm を使用してブラウザ エージェントをインストールしている場合は、 BrowserAgentクラスをインスタンス化するときにgeneric_events機能を有効にする必要があります。features配列に以下を追加します。

  import { GenericEvents } from '@newrelic/browser-agent/features/generic_events';
  
  const options = {
    info: { ... },
    loader_config: { ... },
    init: { ... },
    features: [
      GenericEvents
    ]
  }

  コピー

  詳細については、 npm ブラウザのインストールに関するドキュメントを参照してください。

説明

このAPI コールは、アプリケーションbrowser に設定し たカスタム に送信します。これは、制御するルールと属性によって強化されたブラウザエージェントによってまだ自動的に追跡されていないイベントを追跡するのに役立ちます。

• custom イベントは30秒ごとに送信されます。
• 1,000 件のイベントが観測された場合、エージェントは収集サイクル間隔をバイパスして、バッファリングされたイベントを直ちに収集します。

パラメーター

重要な検討事項やベストプラクティスは以下の通りです。

AI モニタリングを使用して、イベントの種類の総数を約 5 つに制限する必要があります。 カスタム イベント タイプは、高レベルのカテゴリをカプセル化するために使用されます。 たとえば、イベント タイプ「ジェスチャ」を作成できます。

カスタムイベントの名前には、eventType を使用しないでください。 イベントに名前を付けるか、オプションの名前を使用するには、eventType を作成してそのカテゴリ内のデータとプロパティを格納します。 多数のカスタムイベントを作成できますが、報告されるeventTypeの数を制限してデータを管理しやすくすることが重要です。

例

リンククリックの記録（JavaScript）

この例では、ユーザーがフォーム内のSubmitボタンをクリックするたびにカスタムイベントを記録します。 イベントはFormActionのeventTypeで記録されます。これは、フォーム上で実行されたアクションに関連する多くのイベントを含めるために使用されていました。

<a href="/demo" id="try-me">Try Me!</a>
<script>
  document.getElementById('submit').addEventListener('click', function (e) {
    newrelic.recordCustomEvent('FormAction', {
      element: 'submit',
      action: 'click',
    });
  });
</script>

次に、次のNRQLを使用して、Submit ボタンがクリックされた回数を書き込むことができます。

SELECT count(*) FROM FormAction WHERE element = 'submit' AND action = 'click' SINCE 1 hour ago