カスタム属性の収集

New Relicソリューションによってデフォルトで報告されないカスタムデータを報告する場合、最も一般的なソリューションの2つは、カスタム属性とカスタムイベントです。このドキュメントでは、カスタム属性を使用する理由について詳しく説明します。

一部のNewRelicソリューションでは、カスタムデータをNew Relicにレポートする1つの方法は、カスタム属性を使用することです。データにカスタム属性を追加することで、ビジネスのより詳細でカスタマイズされた分析を行うことができます。たとえば、New Relicブラウザの監視では、カスタム属性を作成して、低速または失敗したリクエストに関連付けられたユーザー名を追跡できます。

重要

カスタム属性は、GB インジェストにカウントされ、課金対象のデータです。

要件

カスタム属性は、これらのNew Relicソリューションで利用できます。

APM
ブラウザのモニタリング
モバイルのモニタリング
インフラストラクチャのモニタリング
合成モニター

これらのオプションについては、以下で詳しく説明します。

カスタム属性を作成および使用するための推奨事項

New Relicでは、属性は、関連付けられているイベントに関するメタデータを提供するキーと値のペアです。

カスタム属性を作成する際の一般的なパターンは、名前、ID、電子メールなどのユーザー情報を取得することです。これにより、運用データとビジネスデータの間に関連付けを作成できます。たとえば、ユーザー情報がある場合は、サービスデスクとCRMデータをNewRelicの運用データと結び付けます。

他のタイプのビジネスコンテキストには、次のものが含まれる場合があります。

カスタマーズトークン
お客様の市場セグメント
顧客価値の分類
URIStemで明らかでないワークフロー制御値
ユーザー/製品/アカウントの権限のコンテキスト

オペレーショナル・コンテキストには、以下のようなものがあります。

どの機能フラグを使用したか
どのデータストアにアクセスしたか
どのキャッシュにアクセスしたか
どのようなエラーが検出され、無視されたか（フォールト・パーティショニング）

カスタム属性を追加すると、New Relicでクエリを実行し、そのデータからカスタムチャートを作成できます。たとえば、 JavaエージェントAPIを使用してTransactionおよびTransactionErrorイベントにuserId属性を追加した場合、次のように、その属性を使用してNRQLクエリを作成できます。

SELECT count(*) FROM TransactionError 
  WHERE userId = '1401961100' FACET dateOf(timestamp), `error.message` 
  SINCE 1 week ago

APM:カスタム属性の記録

重要

NRQL で使用されている予約語のリストを確認してください。予約語を使用すると問題が発生する可能性があります。

APM のカスタムアトリビュートを有効にして使用するには、エージェントの手順に従います。

カスタムアトリビュートコレクションは、Java ではデフォルトで有効になっています。 XML と Java エージェント API を使用してカスタムアトリビュートを収集できます。これら 2 つの方法は相互に組み合わせて使用できます。カスタムアトリビュートを収集するには、 New Relic Java API jar がアプリケーションのクラスパスに存在する必要があることに注意してください。

方法	How to do it
XMLでの属性指定	XMLは、ソースコードを変更することなく、カスタム属性を指定することができます。カスタム属性用に複数のXMLファイルを用意し、論理的なファセットでグループ化することができます。 XMLを使ってJavaアプリのカスタム属性を設定する。 New Relic Java エージェントの XML ファイル形式、メソッドとクラス、例に関するドキュメントを確認してください。 New Relic Javaエージェント内の`Extensions`ディレクトリから、単一のXMLファイルを作成します。 XMLファイルを直接編集して、New Relicにモニターさせたいメソッドを定義します。 New Relic UIを使用して XML インストルメンテーションファイルを定義します。これには、 newrelic.yml の`common:`ブロックに追加の構成が必要になる場合があります。詳細については、インストゥルメンテーションオプションの Report custom attributes を参照してください。
エージェントのAPIを呼び出す	Example 1: Adding custom attributes to transactions エージェントのAPIを使用してカスタム属性を収集するには、関連するメソッドを呼び出します。属性を記録するメソッドごとに、 `NewRelic.addCustomParameter(...)`を呼び出します。オプション： `attributes.include`および`attributes.exclude`で特定の属性を含めるか除外します。たとえば、 `userId`という名前の変数を記録するには、次のコードを親メソッドに含めます。 `NewRelic.addCustomParameter("userId", userId);` Example 2: Adding custom attributes to spans in distributed traces エージェントのAPIを使用してカスタム属性を収集するには、関連するメソッドを呼び出します。属性を記録するスパン（現在実行中のメソッド）ごとに、 `NewRelic.getAgent().getTracedMethod().addCustomAttribute(...)`を呼び出します。オプション： `span_events.attributes.include`および`span_events.attributes.exclude`で特定の属性を含めるか除外します。たとえば、現在のスパンで`userId`という名前の変数を記録するには、関連するメソッドに次のコードを含めます。 `NewRelic.getAgent().getTracedMethod().addCustomAttribute("userId", userId);`
ユーザー属性の収集	Javaエージェントには、ユーザー属性を有効にし、カスタム属性として`HttpServletRequest.getUserPrincipal()`からユーザー情報を収集するための組み込みメカニズムも含まれています。

方法

How to do it

XMLでの属性指定

XMLは、ソースコードを変更することなく、カスタム属性を指定することができます。カスタム属性用に複数のXMLファイルを用意し、論理的なファセットでグループ化することができます。

XMLを使ってJavaアプリのカスタム属性を設定する。

New Relic Java エージェントの XML ファイル形式、メソッドとクラス、例に関するドキュメントを確認してください。
New Relic Javaエージェント内のExtensionsディレクトリから、単一のXMLファイルを作成します。
XMLファイルを直接編集して、New Relicにモニターさせたいメソッドを定義します。
New Relic UIを使用して XML インストルメンテーションファイルを定義します。これには、
newrelic.yml
のcommon:ブロックに追加の構成が必要になる場合があります。詳細については、インストゥルメンテーションオプションの
Report custom attributes
を参照してください。

エージェントのAPIを呼び出す

Example 1: Adding custom attributes to transactions

エージェントのAPIを使用してカスタム属性を収集するには、関連するメソッドを呼び出します。

属性を記録するメソッドごとに、 NewRelic.addCustomParameter(...)を呼び出します。
オプション： attributes.includeおよびattributes.excludeで特定の属性を含めるか除外します。
たとえば、 userIdという名前の変数を記録するには、次のコードを親メソッドに含めます。
```
NewRelic.addCustomParameter("userId", userId);
```
Example 2: Adding custom attributes to spans in distributed traces
エージェントのAPIを使用してカスタム属性を収集するには、関連するメソッドを呼び出します。
属性を記録するスパン（現在実行中のメソッド）ごとに、 NewRelic.getAgent().getTracedMethod().addCustomAttribute(...)を呼び出します。
オプション： span_events.attributes.includeおよびspan_events.attributes.excludeで特定の属性を含めるか除外します。
たとえば、現在のスパンでuserIdという名前の変数を記録するには、関連するメソッドに次のコードを含めます。
```
NewRelic.getAgent().getTracedMethod().addCustomAttribute("userId", userId);
```

ユーザー属性の収集

Javaエージェントには、ユーザー属性を有効にし、カスタム属性としてHttpServletRequest.getUserPrincipal()からユーザー情報を収集するための組み込みメカニズムも含まれています。

カスタム属性の収集は、.NETではデフォルトで有効になっています。カスタム属性を収集するには、関連するAPIメソッドを呼び出します。

属性を記録するメソッドごとに、 AddCustomAttributeを呼び出します。
オプション： includeおよびexclude構成オプションで属性を含めるか除外します。
例えば、クーポンコード（文字列）とアイテムIDコード（数字）の属性を記録するには、親メソッドにこのコードを記述します。
```
IAgent agent = NewRelic.Api.Agent.NewRelic.GetAgent();
ITransaction transaction = agent.CurrentTransaction;

transaction
    .AddCustomAttribute("Discount Code", "Summer Super Sale")
    .AddCustomAttribute("Item Code", 31456);
```

カスタム属性の収集は、Node.jsではデフォルトで有効になっています。カスタム属性を収集するには、関連するAPIメソッドを呼び出します。

記録する属性ごとに、 newrelic.addCustomAttributeを呼び出します。
1 回の呼び出しで複数の属性を記録するには、 newrelic.addCustomAttributesを使用します。
例えば、クーポンコードとアイテムIDコードの属性を記録するには、これを親メソッドに含めます。
```
newrelic.addCustomAttributes({
  "Discount Code": "Summer Super Sale",
  "Item Code": 31456
});
```

カスタム属性の収集は、PHPではデフォルトで有効になっています。カスタム属性を収集するには、属性を記録したい各メソッドの関連するAPIメソッドを呼び出します。

newrelic_add_custom_parameter : トランザクションイベントとスパン
newrelic_add_custom_span_parameterはスパンのみの場合
たとえば、 $userIdという名前の変数を記録するには、次のコードを親メソッドに含めます。
```
newrelic_add_custom_parameter ('userID', $userId)
```

カスタム属性収集は、Python ではデフォルトで有効になっています。カスタム属性を収集するには、属性を記録するメソッドごとにadd_custom_attributeを呼び出します。

たとえば、 user_idという名前の変数を記録するには、次のコードを親メソッドに含めます。

newrelic.agent.add_custom_attribute('user_id', user_id)

Ruby では、カスタム属性の収集がデフォルトで有効になっています。カスタム属性を収集するには、 add_custom_attributesメソッドを呼び出します。たとえば、 @user_idという名前の変数を記録するには、次のコードを親メソッドに含めます。

::NewRelic::Agent.add_custom_attributes({ user_id: @user.id })

ブラウザモニタリング。カスタム属性の記録

ブラウザエージェントは、ページビューやブラウザのインタラクションに関連する追加の詳細を指定するためのAPIを提供しています。APMからブラウザモニタリングに属性を転送するまたは、JavaScriptでカスタム属性を指定するのいずれかの方法で行います。APMエージェントから転送された値は、ブラウザエージェントによってエンコードされ、ブラウザの属性に注入されます。

インフラストラクチャのモニタリング。カスタム属性の記録

インフラストラクチャ監視を使用すると、インフラストラクチャエージェントからのデータに注釈を付けるために使用されるカスタム属性を作成できます。このメタデータを使用して、エンティティをフィルタリングし、結果をグループ化し、データに注釈を付けることができます。

モバイルモニタリング。カスタム属性の記録

モバイルエージェントには、カスタム属性を記録するためのAPIコールが含まれています。

カスタムデータの概要については、「カスタムイベントと属性の挿入」を参照してください。
Android メソッド: setAttribute
iOS メソッド: setAttribute

合成モニター：カスタム属性を記録する

合成モニターのカスタム属性を参照してください。

この機械翻訳は、参考として提供されています。

重要

要件

カスタム属性を作成および使用するための推奨事項

APM:カスタム属性の記録

重要

Go

Java

.NET

Node.js

PHP

Python

Ruby

ブラウザモニタリング。カスタム属性の記録

インフラストラクチャのモニタリング。カスタム属性の記録

モバイルモニタリング。カスタム属性の記録

合成モニター：カスタム属性を記録する

この機械翻訳は、参考として提供されています。

カスタム属性の収集

重要

要件 .css-21sua1{background:none;border:none;width:0;padding:0;}

カスタム属性を作成および使用するための推奨事項

APM:カスタム属性の記録

重要

Java

.NET

Node.js

PHP

Python

Ruby

ブラウザモニタリング。カスタム属性の記録

インフラストラクチャのモニタリング。カスタム属性の記録

モバイルモニタリング。カスタム属性の記録

合成モニター：カスタム属性を記録する

要件