この機械翻訳は、参考として提供されています。

英語版と翻訳版に矛盾がある場合は、英語版が優先されます。詳細については、このページを参照してください。

問題を作成する

addRelease

構文

newrelic.addRelease(string $release_name, string $release_id)

同一ページに複数のJavaScriptバンドルを使用したリリースを識別するために、一意の名前とIDを追加します。

要件

  • Browser Pro または Pro+SPA エージェント (v1016 以降)

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

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

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

説明

では、リリースは、現在実行されているアプリケーションのバージョンに関する情報を使用してエラーをタグ付けする方法です。 これは、共有コンポーネントが異なるチームによって所有されているサイトや、複数のアプリケーションが独立してデプロイされているが同じページで実行されるサイトで役立ちます。

最近のウェブアプリケーションは相互に関連する部分が多いため、1つのアプリケーションには、同じページの読み込みに関連する複数の(異なる名前の)リリースが存在する場合があります。例えば、リリースを使って次のようなことができます。

  • キャッシュされた古いバージョンのアプリで発生したエラーと、新しいバージョンで発生したエラーの違いを確認できます。
  • A/Bテスト、スローロールアウト、機能フラグ、その他の高度なデプロイメント方法で発見された問題を特定します。
  • ブラウザのソースマップ のどのバージョンを使用するかを決定します。

JavaScriptのURLが一意でない場合は、ブラウザエージェントへのこのAPI呼び出しでリリース名と識別子を指定する必要があります。この情報は、ソースマップをストレージサービスに公開するときにも必要です。このAPIは、同じページに複数のJavaScriptバンドルがあるリリースを識別するためのブラウザー監視用のIDを追加します。

コードをデプロイするたびにアプリの JavaScript バンドルの URL がis uniqueである場合、ブラウザ監視ではリリースを識別するための追加情報は必要ありません。 たとえば、一部のフロントエンド デプロイメント ツールでは、デプロイされたコードのファイル名に Jenkins ビルド番号またはgit commit sha使用されます。 これらは、エラーの原因となったリリースを一意に特定するのに十分です。

ページの読み込み後、できるだけ早くnewrelic.addRelease()を呼び出します。ブラウザー エージェントが確認するすべてのエラーは、そのバージョンの JavaScript コードに関連付けられます。

パラメーター

パラメータ

説明

$release_name

ストリング

Required. コンポーネントの簡単な説明。たとえば、プロジェクト、アプリケーション、ファイル、ライブラリの名前など。

$release_id

ストリング

Required. このリリースの ID またはバージョン。たとえば、バージョン番号、CI 環境のビルド番号、GitHub SHA、GUID、またはコンテンツのハッシュなど。 New Relic はこの値を文字列に変換するため、必要に応じてnullまたはundefined使用することもできます。

$release_name$release_idの組み合わせは一意でなければなりません。例えば:

  • 'signup', '2.4.0'

  • 'signup', '2.4.1'

    しかし、同じバージョンを異なるコンポーネントに使用することは可能です。例えば、次のようになります。

  • 'signup', '2.4.0'

  • 'logout', '2.4.0'

現在のショートSHA

newrelic.addRelease('checkout page', 'a818994')

セマンティック・バージョニング

newrelic.addRelease('jquery.min.js', 'v3.1.1')