一部の New Relic ソリューションでは、 カスタムデータを New Relic に報告する方法のひとつとして、カスタム 属性 を使用します。例えば、New Relic のブラウザモニタリングでは、カスタム属性を作成して、遅いリクエストや失敗したリクエストに関連するユーザー名を追跡することができます。
要件
カスタム属性は、これらのNew Relicソリューションで利用できます。
- APM
- ブラウザのモニタリング
- モバイルのモニタリング
- インフラストラクチャのモニタリング
その他のカスタムデータソリューションについては、 Intro to custom data をご覧ください。
APM:カスタム属性の記録
APMのカスタムアトリビュートを有効にして使用するには、ご使用のAPMエージェントの手順に従ってください。
C SDKが監視するアプリケーションにカスタムアトリビュートを追加するには、 属性関数の一つを呼び出します。 例えば、 newrelic_add_attribute_double()
。カスタムアトリビュートのキー名は、この関数を呼び出す際に指定したものに依存します。
カスタム属性の収集は、Javaではデフォルトで有効になっています。カスタム属性の収集は、XML と Java エージェント API を使用して行うことができます。この2つの方法は、互いに併用することができます。
カスタム属性の収集は、.NETではデフォルトで有効になっています。カスタム属性を収集するには、関連するAPIメソッドを呼び出します。
属性を記録したい各メソッドについて、 AddCustomAttribute
を呼び出します。
オプション: include
and exclude
設定オプションで属性を含めたり、除外したりします。
例えば、クーポンコード(文字列)とアイテムIDコード(数字)の属性を記録するには、親メソッドにこのコードを記述します。
IAgent agent = NewRelic.Api.Agent.NewRelic.GetAgent();
ITransaction transaction = agent.CurrentTransaction;
.AddCustomAttribute("Discount Code", "Summer Super Sale")
.AddCustomAttribute("Item Code", 31456);
カスタム属性の収集は、Node.jsではデフォルトで有効になっています。カスタム属性を収集するには、関連するAPIメソッドを呼び出します。
カスタム属性の収集は、PHPではデフォルトで有効になっています。カスタム属性を収集するには、属性を記録したい各メソッドの関連するAPIメソッドを呼び出します。
newrelic_add_custom_parameter
for transaction events and spans
newrelic_add_custom_span_parameter
スパンのみの場合。
例えば、 $userId
という変数を記録するには、親メソッドに以下のコードを記述します。
newrelic_add_custom_parameter ('userID', $userId)
カスタム属性の収集は、Pythonではデフォルトで有効になっています。カスタム属性を収集するには、属性を記録したいメソッドごとに add_custom_parameter
を呼び出してください。
例えば、 user_id
という変数を記録するには、親メソッドに以下のコードを記述します。
newrelic.agent.add_custom_parameter('user_id', user_id)
カスタム属性の収集は、Rubyではデフォルトで有効になっています。カスタム属性を収集するには、関連するAPIメソッドを呼び出します。
Ruby エージェントのバージョン 3.12.0 以降では, add_custom_attributes
メソッドを使用します。例えば, @user_id
という変数を記録するには,親メソッドに以下のコードを記述します。
::NewRelic::Agent.add_custom_attributes({ user_id: @user.id })
Ruby エージェントのバージョン 3.11.2 以下では, add_custom_parameters
メソッドを使用します。例えば, @user_id
という変数を記録するには,親メソッドに以下のコードを記述します。
::NewRelic::Agent.add_custom_parameters({ user_id: @user.id })
ブラウザモニタリング。カスタム属性の記録
ブラウザエージェントは、ページビューやブラウザのインタラクションに関連する追加の詳細を指定するためのAPIを提供しています。APMからブラウザモニタリングに属性を転送する または、JavaScriptでカスタム属性を指定する のいずれかの方法で行います。APMエージェントから転送された値は、ブラウザエージェントによってエンコードされ、ブラウザの属性に注入されます。
インフラストラクチャのモニタリング。カスタム属性の記録
当社の インフラストラクチャ モニタリング では、インフラストラクチャ エージェントからのデータに注釈を付けるために使用される カスタム属性 を作成することができます。このメタデータを使用して、フィルタセットの構築、結果のグループ化、データの注釈付けを行うことができます。
モバイルモニタリング。カスタム属性の記録
モバイルエージェントには、カスタム属性を記録するためのAPIコールが含まれています。