New RelicでAPMデータを操作する場合、複数のクラスタ、環境またはデータセンターにわたるアプリケーションの「ロールアップされた」集計データを表示したい場合がありますが、各アプリインスタンスのデータを個別に表示することもできます。これを行うには、APMで監視対象のアプリに複数のアプリ名を設定します。
始める前に
複数のアプリ名を使用する際に知っておくべき重要な注意事項を以下に示します。
代替ソリューション
複数のアプリ名を追加すると、重複したデータが報告されるため、他のオプションを検討することをお勧めします。
テレメトリーデータを属性でより簡単にフィルタリングすることが目標の場合(エージェント領域でフィルタリングする場合など)、代わりに以下のオプションのいずれかを使用することをお勧めします。
- エージェント設定ファイルを使用してタグを追加します(例:ここでのJava設定)
- カスタムアトリビュートの追加
アプリデータを整理するもう1つのオプションとして、アラート条件とキートランザクションを使用して、環境ごとに異なるパフォーマンス閾値を設定できます。これらの閾値は個別のアプリに適用されますが、ロールアップされたアプリ全体には固有の閾値がありません。全体のアプリは、関連する環境の閾値に従って受信データを処理します。
重複データ
複数のアプリ名を使用すると、重複したイベントとメトリクスが生成され、取り込みデータとしてカウントされます。たとえば、New Relicの監視対象アプリに3つのアプリ名が設定されている場合、イベントとメトリクスが3回報告されます。
複数のアプリ名を使用し、以下の代替ソリューションのいずれも使用したくない場合は、ドロップデータルールを使用して、特定の不要なイベントをドロップできます。
名前の優先順位
エージェント設定でのアプリ名の順序が重要です。詳細については、アプリ名の定義を参照してください。
複数のアプリ名の使用方法
通常、2 つのインスタンスが同じアプリ名、エージェント言語、ライセンスキーでレポートする場合、 New Relicそれらのデータを 1 つのNew Relic - モニター アプリに集約します。 アプリの New Relic APM Overviewページから個々のホストとインスタンスのデータを表示することもできます。
異なる方法でアプリをセグメント、またはデータの全体的な表示を維持しながら個別のアプリとして各インスタンスと作業するには、New Relicエージェントの設定ファイルを使用して、最大3つまでの異なるロールアップ名をアプリに付けます。New Relicは設定ファイルにリストされている各アプリにアプリのデータを個別にレポートします。
たとえば、環境の開発、ステージング、およびプロダクションで実行しているアプリに収集したデータを分離し、かつ各環境でアプリの一般的なビューにすることもお勧めします。または、同じコードを実行している2か所のデータセンターがある場合は、1つのアプリをEastCoastApp;AggregateApp
と命名し、2つ目のアプリをWestCoastApp;AggregateApp
と命名できます。
Browserデータのロールアップ
複数の名前を使用してアプリケーション データをレポートする場合、そのアプリケーションのデータも同じ設定を使用して複数のアプリケーションにグループ化されます。
重要
blobs
エンドポイントにレポートするセッションリプレイとトレース データは、複数のアプリケーションのレポートをサポートしていません。 他のブラウザデータは、最大 3 つのアプリケーションのそれぞれに入力されます。
最も限定度が低いものからアプリ名を定義
各アプリに最大3つまでの名前を付けることができ、New Relicは最も限定度が低いものからデータを集約します。各アプリ名のデータを個別に表示するNew Relic UIを使用し、全体的なアプリケーションのパフォーマンスのデータも集計できます。その際、アプリ名を指定する順序が重要です。
Using multiple names | Comments |
---|---|
最も限定度が高い名前 | ユニークなロールアップ名。 |
New Relic UIにデータを集計する共有ロールアップ名。これは一般的な組織を提供します。 | |
オプションで、個別的でない名前 | 追加の共有ロールアップ名。使用する場合は、これがNew Relicが1つのアプリにデータを集計するために使用する最も一般的な名前です。 |
エージェント設定ファイルでアプリケーションインスタンスに命名
設定ファイルで使用する命名規則は、New Relicエージェントによって異なります。最初のロールアップ名が最もユニークになるようにアプリ名の順序を設定します。
2つ目と3つ目の名前はユニークまたは同じにできます。2つ目の名前は集計データにより一般的なもので、3つ目の名前は(使用する場合)最も一般的なものです。
Agent | Configuration file value |
---|---|
C | newrelic_app_config_t* config;で、セミコロン |
Go |
|
Java |
|
.NET | 使用可能オプションのいずれかを使用して、.NET アプリに命名します。 |
Node.js |
|
PHP | 使用可能なオプションのいずれかを使用して、PHPアプリケーションに命名します。セミコロンで区切った3つの名前を使用します。 |
Python |
|
Ruby |
|
詳細については、エージェントの設定ファイルドキュメントを参照してください。
例
以下は、1つのアプリで複数のロールアップ名を使用する方法の例です。