recordMetric（Android SDK API）

構文

NewRelic.recordMetric(string $name, string $category)
NewRelic.recordMetric(string $name, string $category, double $value)
NewRelic.recordMetric(string $name, string $category, int $count, double $totalValue, double $exclusiveValue)
NewRelic.recordMetric(string $name, string $category, int $count, double $totalValue, double $exclusiveValue, MetricUnit $countUnit, MetricUnit $valueUnit)

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

要件

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

説明

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

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

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

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

カスタムメトリクスを表示するには、 Insights Metric Explorer を使用してメトリクスを検索し、カスタマイズ可能なチャートを作成し、それらのチャートをInsightsダッシュボードに追加します。詳細については、 Android SDK API usage guide をご参照ください。

パラメータ

このコールは、4つのパラメータセットを受け取ります。

パラメーター	説明
`NewRelic.recordMetric(string $name, string $category)`
`$name` 文字列	必須です。カスタムメトリックの任意の名前。
`$category` 文字列	必要です。カスタムまたは定義済みのメトリックカテゴリを使用したメトリックカテゴリ名。
`NewRelic.recordMetric(string $name, string $category, double $value)`
`$name` 文字列	必須です。カスタムメトリックの任意の名前。
`$category` 文字列	必要です。カスタムまたは定義済みのメトリックカテゴリを使用したメトリックカテゴリ名。
`値` ダブル	必須です。メトリックの値です。
`NewRelic.recordMetric(string $name, string $category, int $count, double $totalValue, double $exclusiveValue)`
`$name` 文字列	必須です。カスタムメトリックの任意の名前。
`$category` 文字列	必要です。カスタムまたは定義済みのメトリックカテゴリを使用したメトリックカテゴリ名。
`値` ダブル	必須です。メトリックの値です。
`count` int	必須です。イベントの発生回数です。
`トータルバリュー` ダブル	必要です。録画の合計金額です。
`排他的価値` ダブル	必要です。録画の排他的な値。例えば、合計値に他の場所で計上された測定値が含まれている場合など。
`NewRelic.recordMetric(string $name, string $category, int $count, double $totalValue, double $exclusiveValue, MetricUnit $countUnit, MetricUnit $valueUnit)`
`$name` 文字列	必須です。カスタムメトリックの任意の名前。
`$category` 文字列	必要です。カスタムまたは定義済みのメトリックカテゴリを使用したメトリックカテゴリ名。
`値` ダブル	必須です。メトリックの値です。
`count` int	必須です。イベントの発生回数です。
`トータルバリュー` ダブル	必要です。録画の合計金額です。
`排他的価値` ダブル	必要です。録画の排他的な値。例えば、合計値に他の場所で計上された測定値が含まれている場合など。
`カウントユニット` メトリックユニット	必須。 `PERCENT`, `BYTES`, `SECONDS`, `BYTES_PER_SECOND`, または `OPERATIONS` を含む、メトリックカウントの測定単位。
`値の単位` メトリックユニット	必須。 `PERCENT`, `BYTES`, `SECONDS`, `BYTES_PER_SECOND`, または `OPERATIONS` を含む、メトリック値の測定単位。

例

シンプルなカスタムメトリック

カスタムメトリクスの作成例

NewRelic.recordMetric("Custom Metric Name","MyCategory", 1.0);
NewRelic.recordMetric("Login Auth Metric", "Network", 1.0);

任意の属性を持つメトリクス

エージェント・スタートのカスタム・メトリックを作成した例です。

NewRelic.recordMetric("Agent start", "Lifecycle");

同じ指標に経過時間の値を加えたもの。

NewRelic.recordMetric("Agent start", "Lifecycle", 10.11f);

経過時間と専有時間の2つのカウントを持つ。

NewRelic.recordMetric("Agent Start", "lifecycle", 2, 10.11, 1.23)

経過時間、専有時間、単位値パラメータの5カウント付き。

NewRelic.recordMetric("Agent start", "Lifecycle", 5, 10.11, 1.23, MetricUnit.OPERATIONS, MetricUnit.SECONDS);

本書は、お客様のご参考のために原文の英語版を機械翻訳したものです。

構文

要件

説明

パラメータ

例

シンプルなカスタムメトリック

任意の属性を持つメトリクス