APMカスタムイベントと属性のレポート

C SDK によって監視されるアプリにカスタム イベントを追加するには、トランザクションを開始し、 newrelic_create_custom_event } 関数とnewrelic_record_custom_event関数を使用します。詳細については、C SDK API の使用に関するガイド を参照してください。その後、C SDK アプリのカスタム属性を追加できます。

Go エージェントによって監視されるアプリにカスタム イベントを追加するには、 RecordCustomEventを使用します。その後、Go アプリのカスタム属性を追加できます。

Java エージェント バージョン 3.13.0 以降では、カスタム イベント コレクションがデフォルトで有効になっています。カスタム イベントを送信するには、 recordCustomEventを呼び出します。例えば：

Map<String, Object> eventAttributes = new HashMap<String, Object>();
NewRelic.getAgent().getInsights().recordCustomEvent("MyCustomEvent", eventAttributes);

最初の引数は、イベントタイプの名前を定義し、2番目の引数は、カスタムイベントの属性を持つマップです。イベントの属性は文字列または数字でなければなりません。作成するイベントタイプ名の数を制限し、これらの名前を動的に生成しないようにしてください。イベントタイプ名の制限については、 の制限と制限された文字 と NRQL の予約語 についてのドキュメントを参照してください。

newrelic.ymlの構成パラメータを使用して、Java エージェントによって記録されるイベントの最大数を変更できます。

1分間に記録するイベントの最大数を整数で指定します。例えば、デフォルトの10000イベントより少ない数を送信したい場合などです。

custom_insights_events:
  max_samples_stored: 5000

カスタム イベントを完全に無効にするには、次をnewrelic.ymlに追加します。

custom_insights_events:
  enabled: false

そして、Javaアプリのために、 カスタム属性 を追加することができます。

Javaエージェントのバージョンが4.1.0より前の場合は、以下のYAML設定を使用してください。

custom_insights_events.enabled: true
custom_insights_events.max_samples_stored: 5000

カスタム イベント コレクションは、.NET エージェント バージョン 4.6.29.0 以降でデフォルトで有効になっています。カスタム イベントを送信するには、単にRecordCustomEvent()を呼び出します。例えば：

var eventAttributes = new Dictionary<String, Object>();
NewRelic.Api.Agent.NewRelic.RecordCustomEvent("MyCustomEvent", eventAttributes);

最初の引数はイベント タイプの名前を定義し、2 番目の引数はカスタム イベントの属性を持つIEnumerableです。作成する一意のイベント タイプ名の数を制限し、これらの名前を動的に生成しないようにしてください。イベント タイプ名の制限については、制限、制限された文字、およびNRQL 予約語に関するドキュメントを参照してください。

そうすれば、.NETアプリに カスタム属性 を追加することができます。

newrelic.configでcustomEvents.enabledをfalseに設定することで、カスタム イベントを完全にオフにすることができます。

カスタムイベントの収集は、Node.jsエージェントのバージョン1.15.0以降ではデフォルトで有効になっています。カスタムイベントを送信するには、関連するAPIを呼び出すだけです。例えば、以下のようになります。

recordCustomEvent(eventType, attributes)

recordCustomEvent()を使用して、通常は特定の期間に関連付けられたイベント ベースの指標を記録します。eventTypeは、255 文字未満の英数字の文字列でなければなりません。属性は、キーと値のペアのオブジェクトである必要があります。キーは 255 文字未満である必要があり、値は文字列、数値、またはブール値である必要があります。イベント タイプ名の制限については、制限、制限された文字、およびNRQL 予約語に関するドキュメントを参照してください。

そうすれば、Node.jsアプリに カスタム属性 を追加することができます。

カスタム イベントを完全に無効にするには、 custom_insights_events.enabled: falseをnewrelic.jsに追加します。

カスタムイベントの収集は、PHPエージェントのバージョン4.18以上でデフォルトで有効になります。カスタムイベントを送信するには、関連するAPI関数を呼び出すだけです。例えば、以下のようになります。

newrelic_record_custom_event("WidgetSale", array("color"=>"red", "weight"=>12.5));

最初の引数はイベントタイプの名前を定義し、2番目の引数はカスタムイベントの属性を持つ配列です。作成するユニークなイベントタイプ名の数を確実に制限し、これらの名前を動的に生成しないようにしてください。イベントタイプ名の制限については、 の制限と制限された文字 と NRQL の予約語 についてのドキュメントを参照してください。

初期設定では、1分間に記録されるカスタムイベントの最大数は10,000です。この設定は変更できません。

そして、PHPアプリのために、 カスタム属性 を追加することができます。

カスタム イベントを完全に無効にするには、 newrelic.custom_insights_events.enabled = falseをnewrelic.iniに追加して、エージェントを再起動します。

カスタムイベントの収集は、Pythonエージェントのバージョン2.60.0.46以上でデフォルトで有効になります。カスタムイベントを送信するには、関連するAPIを呼び出すだけです。例えば、以下のようになります。

newrelic.agent.record_custom_event(event_type, params, application=None)

event_typeは、カスタム イベントの名前 (またはタイプ) を定義します。カスタム イベントの属性は、 paramsキーワード引数を介してディクショナリとして渡す必要があります。作成する一意のイベント タイプ名の数を制限し、これらの名前を動的に生成しないようにしてください。event_typeとparamsの制限と制限については、制限と制限された文字と予約語に関するドキュメントを参照してください

監視対象の Web リクエストまたはバックグラウンド タスクのコンテキスト外で呼び出された場合、 applicationキーワード引数が提供され、例外が記録されるアプリケーションに対応するアプリケーション オブジェクトが提供されない限り、呼び出しは無視されます。newrelic.agent.application()関数を使用して、適切なアプリケーション オブジェクトを取得できます。

そして、Pythonアプリのために、 カスタムアトリビュート を追加することができます。

カスタム イベントを完全に無効にするには、 newrelic.ini構成ファイルでcustom_insights_events.enabledをFalseに設定します。

カスタムイベントの収集は、Rubyエージェントのバージョン3.9.8.273以上でデフォルトで有効になります。カスタムイベントを送信するには、関連するAPIを呼び出すだけです。例えば、以下のようになります。

::NewRelic::Agent.record_custom_event('WidgetSale', color: 'red', weight: 12.5)

最初の引数はイベントタイプの名前を定義し、2番目の引数はカスタムイベントの属性を持つハッシュです。作成するユニークなイベントタイプ名の数を確実に制限し、これらの名前を動的に生成しないようにしてください。イベントタイプ名の制限については、 の制限と制限された文字 と NRQL の予約語 についてのドキュメントを参照してください。

newrelic.ymlの構成パラメータを使用して、Ruby エージェントによって記録されるイベントの最大数を変更できます。

1. 構成ファイルにcustom_insights_events.max_samples_stored:を追加してください。

2. 1分間に記録するイベントの最大数を整数で指定します。例えば、1分間に最大5000件のイベントを送信できるようにしたい場合は、次のように追加します。

   custom_insights_events.max_samples_stored: 5000

   コピー

そうすれば、Rubyアプリに カスタム属性 を追加することができます。

カスタム イベントを完全に無効にするには、 custom_insights_events.enabled: falseをnewrelic.ymlに追加します。