構文
newrelic_record_custom_event(string $name, array $attributes)指定された名前と属性を持つカスタムイベントを記録します。
要件
エージェントのバージョン 4.18.0.89 以上。
説明
カスタムイベントを記録する New Relic で使用する 。詳細については、 PHP エージェントでカスタムイベントを挿入する を参照してください。
ヒント
カスタムイベントを作成する際は、以下のルールに従ってください。
- デフォルトでは、エージェントは毎分最大 30,000 イベントを記録します。この ini 設定を変更することにより、1 分あたり最大 100,000 イベントを記録するようにエージェントを構成できます。
- 作成する一意のイベント タイプ名の数を制限し、これらの名前を動的に生成しないでください。
- イベント名と属性名に 予約語 と文字を使用しないでください。
- イベントのサイズとレートの制限を超えないようにしてください。
newrelic_ignore_transactionがnewrelic_record_custom_eventと同じトランザクション内で呼び出された場合、カスタム イベントは報告されません。
パラメーター
パラメータ | 説明 |
|---|---|
ストリング | 必須項目です。カスタムイベントの名前。 |
アレイ | 必要です。カスタム属性を連想配列で指定します。属性名を最大255文字のキーとして指定し、値をスカラー値として指定します。配列とオブジェクトはサポートされていません。 |
例
基本的な例
if (extension_loaded('newrelic')) { // Ensure PHP agent is available newrelic_record_custom_event("WidgetSale", array("color"=>"red", "weight"=>12.5));}