構文
newrelic_custom_metric(string $metric_name, float $value)
デフォルトでは取得されないアプリのコンポーネントの時間を測定するカスタムメトリック(ミリ秒単位)を追加します。
要件
すべてのAgentバージョンに対応しています。
説明
記録する カスタムメトリクス PHPエージェントがデフォルトで取得していないもの。
ならば、できる。
- データエクスプローラー を使用して、カスタムメトリクスを検索し、カスタマイズ可能なチャートを作成し、ダッシュボードに追加します。
- New Relic REST API を使用して、New Relic UI の外でプログラム的にカスタムメトリックデータを取得して使用することができます。
- カスタムメトリックアラートを作成する カスタムメトリックが特定の値を超えたときに自分やチームに通知します。
パラメータ
パラメーター | 説明 |
---|---|
文字列 | 必要です。カスタムメトリクスには、 Custom/ のプレフィックスを付けた名前を付けます(例: Custom/ MyMetric )。これにより、UIがカスタムメトリクスを1か所にまとめることができ、Metric Explorerで簡単に見つけることができます。 |
フロート | 必須。タイミングをミリ秒単位で記録します。例: 値がNaN、Infinity、denorm、負のゼロの場合、この関数の動作は不定です。New Relic は、与えられた値から 1 ビット以上の精度 (ULP) を破棄することがあります。 |
戻り値
メトリックが正常に追加された場合は true
を返します。
例
100ミリ秒の応答時間を記録
function example() { if (extension_loaded('newrelic')) { // Ensure PHP agent is available newrelic_custom_metric("Custom/custom-metric-name", 100.00); }}