APMエージェント、ブラウザエージェント、モバイルエージェントは、メトリックタイムスライスデータというメトリクスデータのタイプをレポートします。これらのエージェントを使用すると、アプリケーションからカスタムメトリックタイムスライスをレポートし、デフォルトNew Relicデータと一緒に表示します。APIコールを使用して以下のような任意のパフォーマンスデータを記録するには、カスタムメトリックを作成します。
- タイミングデータ
- コンピューターのリソースデータ
- サブスクリプションまたは購入データ
このデータをレポートした後は、調査およびクエリを行えます。
カスタムメトリックの命名
カスタムメトリックの名前は、Custom/で始めてください（例：Custom/MyMetric/My_label）。Custom/プレフィックスはすべてのカスタムメトリックで必須です。
Custom/で始まらないカスタムメトリック名はいずれも、その他のすべてのグループ化ルールの対象となります。それらの名前はクエリ時に表示されないか、UIに期待通りに表示されない可能性があります。
カスタムメトリック名は、プレフィックスCustom/、カテゴリ名またはクラス名、およびメソッドまたはラベルで構成され、それぞれがスラッシュで区切られています。
カスタムメトリックの実装
カスタムメトリックの実装にはAPIコールが必要です。APIコールの正確な内容はエージェントによって異なります。
ヒント
カスタムメトリックの実装テストを行う際は、APIコールがNew Relicにレポートされているかどうかを確認するため、少なくとも10分間はエージェントを実行してください。
New Relicエージェント | 実装 |
|---|---|
APMエージェント | |
New Relic Mobileエージェント | |
New Relic Browserエージェント | Browserはカスタムメトリックをサポートしていません。カスタムデータをブラウザに追加するオプションについては、ブラウザのインストゥルメンテーションを参照してください。 |
グループ化問題を回避する
あまりにも大量のメトリックタイムスライスを収集すると、アプリケーションとNew Relic両方のパフォーマンスに影響が出る可能性があります。たとえば、何千人もの個人ユーザーがいる場合、それらの一意のユーザーIDについてパフォーマンスを追跡するようなメトリクスを作成しないようにしてください。大量のメトリクスが作成されると、データを閲覧したり、理解したりするのはほぼ不可能となります。その代わりに、個人のユーザーIDではなく、アスタリスク（*）のようなプレースホルダーを使用してください。
重要
潜在的なデータの問題を回避するため、カスタムメトリックが採用する一意なメトリックタイムスライスの合計数を2000未満に維持するようにしてください。
一意のメトリック名の合計数が5,000件を超えると自動的に制限が適用され、ユーザーインタフェースのチャートや表などでのデータの表示方法に影響が出ます。詳細については、メトリクスのグループ化問題を参照してください。