setApplicationVersion

構文

newrelic.setApplicationVersion(value: string|null)

ユーザー定義のアプリケーションのバージョン文字列をページ上の後続のイベントに追加します。

要件

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

• npm を使用してブラウザ エージェントをインストールしている場合は、 BrowserAgentクラスをインスタンス化するときに少なくとも 1 つの機能を有効にする必要があります。たとえば、次をfeatures配列に追加します。

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

  コピー

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

説明

有効な値を指定してこの関数を実行すると、ブラウザ エージェントは、属性が手動で設定解除されるか、ページがアンロードされるまで、後続のすべてのイベントに application.version 属性を追加します。関数が複数回呼び出された場合、指定された最新の値のみが後続のイベントで送信されます。この関数が値 nullで呼び出された場合、既存のアプリケーション バージョンは後続のイベントで送信を停止します。

application.version 属性を設定すると、エラーが発生しているソフトウェアのバージョンを特定するのに役立ちます。エラー受信箱の今後のリリースでは、ソフトウェアのどのバージョンでエラーが発生しているかを自動的に追跡します。互換性のあるエージェント バージョンで SPA モニタリング を使用している場合、アプリケーション バージョンも newrelic.interaction イベントに含まれます。

パラメーター

例

アプリケーションバージョンでイベントを装飾する

newrelic.setApplicationVersion('1.2.3') // decorates events with the property 'application.version':'1.2.3'

アプリケーションのバージョンを装飾するイベントの停止

newrelic.setApplicationVersion(null) // events will no longer have an 'application.version' property set