recordMetric（iOS SDK API）

構文

NewRelic recordMetricWithName:(NSString *)name  category:(NSString *)category  value:(NSNumber *)value];
NewRelic.recordMetric(withName: String!, category: String!, value: NSNumber!)

カスタムメトリクス（任意の数値データ）の記録。

要件

すべてのAgentバージョンに対応しています。

説明

このメソッドを使用すると、任意の カスタムメトリクス を記録して、New Relic が自動的に追跡していないアプリのアクティビティをより詳細に把握することができます。このコールでは、オプションで詳細レベルを指定するためのいくつかのパラメータセットを受け付けます。

このメソッドは、 Custom/[Category]/[Name] という形式のメトリックを記録します。カウント数は1で、合計値は渡された値と等しくなります。複数回の呼び出しにより、カウント数と値は、モバイル・モニタリング用の標準的な メトリック集約ルール に従って集約されます。

メトリクスを最大限に活用するために、以下のガイドラインに従って、明確で簡潔なメトリクス名を作成してください。

• ユーザーインターフェースでの表示に適した大文字、小文字、空白文字を使用します。メトリック名はそのまま表示されます。
• メートル法の名称を大文字にします。
• / ] という文字の使用は避けてください。[ | * ] メトリクスの名前を付けるときに。
• マルチバイト文字は避けてください。

カテゴリ も必須です。これは UI に表示され、カスタムメトリクスが多数ある場合に整理するのに便利です。カスタムカテゴリでも、 MetricCategory enum を使用して定義済みのカテゴリでも構いません。

カスタムメトリクスを表示するには、 Insights Metric Explorer を使用してメトリクスを検索し、カスタマイズ可能なチャートを作成し、それらのチャートを Insights ダッシュボードに追加します。

追加の引数を受け取り、記録するメトリクスをより細かく制御できるバリエーションについては、 NewRelic.h を参照してください。このAPIの使用に関する詳細は、 iOS SDK API usage guide を参照してください。

パラメータ

例

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];

Swift

方法です。

NewRelic.recordMetric(withName: String!, category: String!, value: NSNumber!)

例（メトリクスはミリ秒単位）。

NewRelic.recordMetric(withName: "My Important Metric", category: "Important Metrics", value: 145.67)