構文
newrelic_custom_metric(string $metric_name, float $value)
デフォルトでは取得されないアプリのコンポーネントの時間を測定するカスタムメトリック(ミリ秒単位)を追加します。
要件
すべてのAgentバージョンに対応しています。
説明
記録する カスタムメトリクス PHPエージェントがデフォルトで取得していないもの。
ならば、できる。
- メトリックとイベントを使用して、カスタム メトリックを検索し、カスタマイズ可能なグラフを作成して、ダッシュボードに追加します。
- New Relic REST API を使用して、New Relic UI の外でプログラム的にカスタムメトリックデータを取得して使用することができます。
- カスタムメトリックアラートを作成する カスタムメトリックが特定の値を超えたときに自分やチームに通知します。
パラメーター
パラメータ | 説明 |
---|---|
ストリング | 必須。 カスタムメトリックの名前にCustom/プレフィックスを付けます (例: Custom/MyMetric )。 これにより、 UIエクスポートメトリックを 1 か所に整理できるようになり、メトリック エクスプローラーで簡単に見つけられるようになります。 |
浮く | 必須。タイミングをミリ秒単位で記録します。例: 値が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); }}