構文
NewRelic recordMetricWithName:(NSString *)name category:(NSString *)category value:(NSNumber *)value];NewRelic.recordMetric(withName: String!, category: String!, value: NSNumber!)
カスタムメトリクス(任意の数値データ)の記録。
要件
すべてのAgentバージョンに対応しています。
説明
このメソッドを使用すると、任意の カスタムメトリクス を記録して、New Relic が自動的に追跡していないアプリのアクティビティをより詳細に把握することができます。このコールでは、オプションで詳細レベルを指定するためのいくつかのパラメータセットを受け付けます。
このメソッドは、1のカウントと渡された値に等しい合計値で、形式Custom/[Category]/[Name]
のメトリックを記録します。複数の呼び出しは、モバイル監視の標準メトリック集約ルールに従ってカウントと値を集約します。
メトリクスを最大限に活用するために、以下のガイドラインに従って、明確で簡潔なメトリクス名を作成してください。
- ユーザーインターフェースでの表示に適した大文字、小文字、空白文字を使用します。メトリック名はそのまま表示されます。
- メートル法の名称を大文字にします。
- メトリックに名前を付けるときは、文字
/ ] [ | *
を使用しないでください。 - マルチバイト文字は避けてください。
category
も必要です。 UIに表示され、カスタムメトリックが多数ある場合は、カスタムメトリックを整理するのに役立ちます。カスタムカテゴリにすることも、 MetricCategory
列挙型を使用して事前定義されたカテゴリにすることもできます。
追加の引数を受け取り、記録するメトリクスをより細かく制御できるバリエーションについては、 NewRelic.h を参照してください。このAPIの使用に関する詳細は、 iOS SDK API usage guide を参照してください。
パラメーター
パラメータ | 説明 |
---|---|
ストリング | 必須です。カスタムメトリックの名前です。 |
ストリング | 必要です。カスタムまたは定義済みのメトリック・カテゴリーを使用したメトリック・カテゴリー名。 |
ダブル | 必須です。メトリックの値です。 |
NRMetricUnit | オプション。値の単位を表します。 |
NRMetricUnit | オプション。メトリックの単位を表します |
例
Objective-C
方法です。
[NewRelic recordMetricWithName:(NSString *)name category:(NSString *)category value:(NSNumber *)value];
例(メトリクスはミリ秒単位)。
[NewRelic recordMetricWithName:(NSString *)@"My Important Metric" category:(NSString *)@"Important Metrics" value:(NSNumber *)145.67];
迅速
方法です。
NewRelic.recordMetric(withName: String!, category: String!, value: NSNumber!)
例(メトリクスはミリ秒単位)。
NewRelic.recordMetric(withName: "My Important Metric", category: "Important Metrics", value: 145.67)