構文
Java
NewRelic.setUserId(string $userId)
コトリン [#kotlin]
NewRelic.recordMetric( name: String, category: String, count: Int, totalValue: Double, exclusiveValue: Double, countUnit: MetricUnit, valueUnit: MetricUnit)NewRelic.recordMetric(name: String?, category: String?, value: Double = 1.0)
説明 [#description]
このメソッドを使用すると、任意の カスタムメトリクス を記録して、New Relic が自動的に追跡していないアプリのアクティビティをより詳細に把握することができます。このコールでは、オプションで詳細レベルを指定するためのいくつかのパラメータセットを受け付けます。
メトリクスを最大限に活用するために、以下のガイドラインに従って、明確で簡潔なメトリクス名を作成してください。
- ユーザーインターフェースでの表示に適した大文字、小文字、空白文字を使用します。メトリック名はそのまま表示されます。
- メートル法の名称を大文字にします。
- メトリクスに名前を付ける際は、文字
/
]
[
|
*
を使用しないでください。 - マルチバイト文字は避けてください。
category
も必要です。 UIに表示され、カスタムメトリックが多数ある場合は、カスタムメトリックを整理するのに役立ちます。カスタムカテゴリにすることも、 MetricCategory
列挙型を使用して事前定義されたカテゴリにすることもできます。
パラメーター [#parameters]
パラメータ | タイプ | 説明 |
---|---|---|
|
| 必須です。カスタムメトリックの任意の名前。 |
|
| 必要です。カスタムまたは定義済みの メトリック カテゴリを使用したメトリック カテゴリ名 。 |
|
| 必須です。メトリックの値です。 |
|
| 必要。メトリクスが記録された回数。 |
|
| 必要。メトリックの合計値。 |
|
| 必要です。録画の排他的な値。例えば、合計値に他の場所で計上された測定値が含まれている場合など。 |
|
| 必須。 |
|
| 必須。 |
例 [#examples]
単純なカスタム メトリクスの作成例を次に示します。
Java [#java]
NewRelic.recordMetric("Custom Metric Name","MyCategory", 1.0);NewRelic.recordMetric("Login Auth Metric", "Network", 1.0);
コトリン [#kotlin]
NewRelic.recordMetric("Custom Metric Name","MyCategory", 1.0)NewRelic.recordMetric("Login Auth Metric", "Network", 1.0)
エージェント開始のカスタム メトリックを作成する例を次に示します。
Java [#java]
NewRelic.recordMetric("Agent start", "Lifecycle");
コトリン [#kotlin]
NewRelic.recordMetric("Agent start", "Lifecycle")
以下は、上記と同じメトリクスに経過時間の値を追加した例です。
Java [#java]
NewRelic.recordMetric("Agent start", "Lifecycle", 10.11f);
コトリン [#kotlin]
NewRelic.recordMetric("Agent start", "Lifecycle", 10.11)
以下は、上記と同じメトリクスの例ですが、経過時間、排他時間、および単位値パラメーターの 5 つのカウントが含まれています。
Java [#java]
NewRelic.recordMetric("Agent start", "Lifecycle", 5, 10.11, 1.23, MetricUnit.OPERATIONS, MetricUnit.SECONDS);
コトリン [#kotlin]
NewRelic.recordMetric("Agent start", "Lifecycle", 5, 10.11, 1.23, MetricUnit.OPERATIONS, MetricUnit.SECONDS)
構文
目的-c
[NewRelic recordMetricWithName:(NSString *)name category:(NSString *)category value:(NSNumber *)value];
迅速 [#swift]
NewRelic.recordMetric(withName: String!, category: String!, value: NSNumber!)
説明 [#description]
このメソッドを使用すると、任意の カスタムメトリクス を記録して、New Relic が自動的に追跡していないアプリのアクティビティをより詳細に把握することができます。このコールでは、オプションで詳細レベルを指定するためのいくつかのパラメータセットを受け付けます。
このメソッドは、カウントが 1 で、合計値が渡された値と等しい、形式Custom/[Category]/[Name]
のメトリクスを記録します。 複数の呼び出しでは、 の標準メトリクス集計ルールに従ってカウントと値が集計されます。
メトリクスを最大限に活用するために、以下のガイドラインに従って、明確で簡潔なメトリクス名を作成してください。
- ユーザーインターフェースでの表示に適した大文字、小文字、空白文字を使用します。メトリック名はそのまま表示されます。
- メートル法の名称を大文字にします。
- メトリクスに名前を付ける際は、文字
/
]
[
|
*
を使用しないでください。 - マルチバイト文字は避けてください。
category
も必須です。これは UI に表示され、カスタム メトリックが多数ある場合に整理するのに役立ちます。カスタム カテゴリにすることも、 MetricCategory
列挙型を使用して事前定義したカテゴリにすることもできます。
パラメーター [#parameters]
パラメータ | タイプ | 説明 |
---|---|---|
|
| 必須です。カスタムメトリックの任意の名前。 |
|
| 必要です。カスタムまたは定義済みの メトリック カテゴリを使用したメトリック カテゴリ名 。 |
|
| 必須です。メトリックの値です。 |
例 [#examples]
Objective-C [#obj-c]
ミリ秒単位でメトリクスを作成する例を次に示します。
[NewRelic recordMetricWithName:(NSString *)@"My Important Metric" category:(NSString *)@"Important Metrics" value:(NSNumber *)145.67];
迅速 [#swift]
ミリ秒単位でメトリクスを作成する例を次に示します。
NewRelic.recordMetric(withName: "My Important Metric", category: "Important Metrics", value: 145.67)
構文
recordMetric(options: { name: string; category: string; value?: number; countUnit?: string; valueUnit?: string; }) => void
説明 [#description]
カスタム メトリクス (任意の数値データ) を記録します。ここで、 countUnit
はメトリクス数の測定単位、 valueUnit
はメトリクス値の測定単位です。countUnit
または valueUnit
を使用する場合は、 value
、 countUnit
、および valueUnit
の 3 つをすべて設定する必要があります。
countUnit
と valueUnit
でサポートされている測定値は次のとおりです。
PERCENT
BYTES
SECONDS
BYTES_PER_SECOND
OPERATIONS
パラメーター [#parameters]
パラメータ | タイプ | 説明 |
---|---|---|
|
| 必須です。カスタムメトリックの任意の名前。 |
|
| 必要です。カスタムまたは定義済みの メトリック カテゴリを使用したメトリック カテゴリ名 。 |
|
| 必須です。メトリックの値です。 |
|
| 必要。カウントの測定単位。 |
|
| 必要。カウントの測定単位。 |
例 [#example]
NewRelicCapacitorPlugin.recordMetric({ name: "CapacitorMetricName", category: "CapacitorMetricCategory",});NewRelicCapacitorPlugin.recordMetric({ name: "CapacitorMetricName2", category: "CapacitorMetricCategory2", value: 25,});NewRelicCapacitorPlugin.recordMetric({ name: "CapacitorMetricName3", category: "CapacitorMetricCategory3", value: 30, countUnit: NREnums.MetricUnit.SECONDS, valueUnit: NREnums.MetricUnit.OPERATIONS,});
構文
recordMetric(name: string, category: string, value?: number, countUnit?: string, valueUnit?: string): void;
説明 [#description]
カスタム メトリクス (任意の数値データ) を記録します。ここで、 countUnit
はメトリクス数の測定単位、 valueUnit
はメトリクス値の測定単位です。countUnit
または valueUnit
を使用する場合は、 value
、 countUnit
、および valueUnit
の 3 つをすべて設定する必要があります。
countUnit
と valueUnit
でサポートされている測定値は次のとおりです。
PERCENT
BYTES
SECONDS
BYTES_PER_SECOND
OPERATIONS
パラメーター [#parameters]
パラメータ | タイプ | 説明 |
---|---|---|
|
| 必須です。カスタムメトリックの任意の名前。 |
|
| 必要です。カスタムまたは定義済みの メトリック カテゴリを使用したメトリック カテゴリ名 。 |
|
| 必須です。メトリックの値です。 |
|
| 必要。カウントの測定単位。 |
|
| 必要。カウントの測定単位。 |
例 [#example]
NewRelic.recordMetric('CordovaCustomMetricName', 'CordovaCustomMetricCategory');NewRelic.recordMetric('CordovaCustomMetricName', 'CordovaCustomMetricCategory', 12);NewRelic.recordMetric('CordovaCustomMetricName', 'CordovaCustomMetricCategory', 13, 'PERCENT', 'SECONDS');
構文
RecordMetric(string name, string category) : void;RecordMetric(string name, string category, double value) : void;
説明 [#description]
カスタム メトリクス (任意の数値データ) を記録します。ここで、 countUnit
はメトリクス数の測定単位、 valueUnit
はメトリクス値の測定単位です。countUnit
または valueUnit
を使用する場合は、 value
、 countUnit
、および valueUnit
の 3 つをすべて設定する必要があります。
countUnit
と valueUnit
でサポートされている測定値は次のとおりです。
PERCENT
BYTES
SECONDS
BYTES_PER_SECOND
OPERATIONS
パラメーター [#parameters]
パラメータ | タイプ | 説明 |
---|---|---|
|
| 必須です。カスタムメトリックの任意の名前。 |
|
| 必要です。カスタムまたは定義済みの メトリック カテゴリを使用したメトリック カテゴリ名 。 |
|
| 必須です。メトリックの値です。 |
|
| 必要。カウントの測定単位。 |
|
| 必要。カウントの測定単位。 |
例 [#example]
CrossNewRelic.Current.RecordMetric("Agent start", "Lifecycle");CrossNewRelic.Current.RecordMetric("Login Auth Metric", "Network", 78.9);
構文
recordMetric(name: string, category: string, value?: number, countUnit?: string, valueUnit?: string): void;
説明 [#description]
カスタム メトリクス (任意の数値データ) を記録します。ここで、 countUnit
はメトリクス数の測定単位、 valueUnit
はメトリクス値の測定単位です。countUnit
または valueUnit
を使用する場合は、 value
、 countUnit
、および valueUnit
の 3 つをすべて設定する必要があります。
countUnit
と valueUnit
でサポートされている測定値は次のとおりです。
PERCENT
BYTES
SECONDS
BYTES_PER_SECOND
OPERATIONS
パラメーター [#parameters]
パラメータ | タイプ | 説明 |
---|---|---|
|
| 必須です。カスタムメトリックの任意の名前。 |
|
| 必要です。カスタムまたは定義済みのメトリック・カテゴリーを使用したメトリック・カテゴリー名。 |
|
| 必須です。メトリックの値です。 |
|
| 必要。カウントの測定単位。 |
|
| 必要。カウントの測定単位。 |
例 [#example]
NewrelicMobile.instance.recordMetric("testMetric", "Test Champ",value: 12.0);NewrelicMobile.instance.recordMetric("testMetric1", "TestChamp12",value: 10,valueUnit: MetricUnit.BYTES,countUnit: MetricUnit.PERCENT);
構文
recordMetric(name: string, category: string, value?: number, countUnit?: string, valueUnit?: string): void;
説明 [#description]
カスタム メトリクス (任意の数値データ) を記録します。ここで、 countUnit
はメトリクス数の測定単位、 valueUnit
はメトリクス値の測定単位です。countUnit
または valueUnit
を使用する場合は、 value
、 countUnit
、および valueUnit
の 3 つをすべて設定する必要があります。
countUnit
と valueUnit
でサポートされている測定値は次のとおりです。
PERCENT
BYTES
SECONDS
BYTES_PER_SECOND
OPERATIONS
パラメーター [#parameters]
パラメータ | タイプ | 説明 |
---|---|---|
|
| 必須です。カスタムメトリックの任意の名前。 |
|
| 必要です。カスタムまたは定義済みの メトリック カテゴリを使用したメトリック カテゴリ名 。 |
|
| 必須です。メトリックの値です。 |
|
| 必要。カウントの測定単位。 |
|
| 必要。カウントの測定単位。 |
例 [#example]
NewRelic.recordMetric('RNCustomMetricName', 'RNCustomMetricCategory');NewRelic.recordMetric('RNCustomMetricName', 'RNCustomMetricCategory', 12);NewRelic.recordMetric('RNCustomMetricName', 'RNCustomMetricCategory', 13, NewRelic.MetricUnit.PERCENT, NewRelic.MetricUnit.SECONDS);
構文
RecordMetricWithName(string name, string category) : void;RecordMetricWithName(string name, string category, double value) : void;RecordMetricWithName(string name, string category, double value, MetricUnit countUnit, MetricUnit valueUnit) : void;
説明 [#description]
カスタム メトリクス (任意の数値データ) を記録します。ここで、 countUnit
はメトリクス数の測定単位、 valueUnit
はメトリクス値の測定単位です。countUnit
または valueUnit
を使用する場合は、 value
、 countUnit
、および valueUnit
の 3 つをすべて設定する必要があります。
countUnit
と valueUnit
でサポートされている測定値は次のとおりです。
PERCENT
BYTES
SECONDS
BYTES_PER_SECOND
OPERATIONS
パラメーター [#parameters]
パラメータ | タイプ | 説明 |
---|---|---|
|
| 必須です。カスタムメトリックの任意の名前。 |
|
| 必要です。カスタムまたは定義済みの メトリック カテゴリを使用したメトリック カテゴリ名 。 |
|
| 必須です。メトリックの値です。 |
|
| 必要。カウントの測定単位。 |
|
| 必要。カウントの測定単位。 |
例 [#example]
NewRelicAgent.RecordMetricWithName('UnityCustomMetricName', 'UnityCustomMetricCategory');NewRelicAgent.RecordMetricWithName('UnityCustomMetricName', 'UnityCustomMetricCategory', 12);NewRelicAgent.RecordMetricWithName('UnityCustomMetricName', 'UnityCustomMetricCategory', 13, NewRelicAgent.MetricUnit.PERCENT, NewRelicAgent.MetricUnit.SECONDS);
構文
RecordMetric(string name, string category) : void;RecordMetric(string name, string category, double value) : void;RecordMetric(string name, string category, double value, MetricUnit countUnit, MetricUnit valueUnit) : void;
説明 [#description]
カスタム メトリクス (任意の数値データ) を記録します。ここで、 countUnit
はメトリクス数の測定単位、 valueUnit
はメトリクス値の測定単位です。countUnit
または valueUnit
を使用する場合は、 value
、 countUnit
、および valueUnit
の 3 つをすべて設定する必要があります。
countUnit
と valueUnit
でサポートされている測定値は次のとおりです。
PERCENT
BYTES
SECONDS
BYTES_PER_SECOND
OPERATIONS
パラメーター [#parameters]
パラメータ | タイプ | 説明 |
---|---|---|
|
| 必須です。カスタムメトリックの任意の名前。 |
|
| 必要です。カスタムまたは定義済みの メトリック カテゴリを使用したメトリック カテゴリ名 。 |
|
| 必須です。メトリックの値です。 |
|
| 必要。カウントの測定単位。 |
|
| 必要。カウントの測定単位。 |
例 [#example]
CrossNewRelicClient.Current.RecordMetric("Agent start", "Lifecycle");CrossNewRelicClient.Current.RecordMetric("Login Auth Metric", "Network", 78.9);CrossNewRelicClient.Current.RecordMetric("Request Metric", "Network", 20, MetricUnit.SECONDS, MetricUnit.OPERATIONS);