エージェントの属性

属性は、イベントまたはトランザクションのプロパティを決定する情報を含むキーと値のペアです。キーと値のペアは、トランザクショントレース、Insights、またはその他のイベントデータを使用する製品で参照できます。New Relicには、それぞれの属性を指定した宛先に正確に送信するようにカスタマイズできる機能があります。

カスタム属性を収集して、APMとInsightsに追加のデータを送信することもできます。

属性の宛先フロー

次の図に、エージェントが属性をそれぞれの宛先に送信する方法をどのように決定しているかを示します。

nr attribute collection diagram.png
エージェントの属性のコレクション: エージェントは、関連するプロパティの設定に基づいて属性をNew Relicの宛先に送信する際に、3つの決定を行います。プロパティ名と構文はエージェントによって異なります。(この図のプロパティはPHPエージェントによって異なりますが、一般的なフローはすべてのエージェントに対して同じです。プロパティ名と構文はエージェントによって異なります)。

属性のタイプ

属性は、以下のようなさまざまな方法で収集できます。

  • メッセージプロパティの属性: キューまたはトピックから受信したメッセージに設定されるプロパティです。
  • HTTP要求の属性: HTTP要求のパラメーターです。
  • ユーザー属性: 各エージェントのAPIを介してユーザーが提供する属性です。
  • エージェント属性: エージェントが取得するhttpResponseCodehttpResponseMessageなどの属性です。

属性の宛先

収集された属性は、以下の場所に表示されます。

収集された属性 場所
トランザクショントレース トランザクショントレースは、最も遅い個別のHTTP要求のデータを毎分収集します。これらのトレースは、トランザクション中に収集された属性をレポートします。
トレースされたエラー

トランザクションでエラーが発生すると、トレースされたエラーがNew Relic APMにレポートされます。トレースされたエラーには、トランザクション中に収集された属性が含まれます。

Insightsのトランザクションイベント

New Relic InsightsにレポートされるAPMトランザクションには、トランザクション中に収集された属性が含まれます。

Insightsのページビュー

New Relic Insightsにレポートされるブラウザのページビューには、トランザクション中に収集された属性が含まれます。ただし、トランザクションの最後に収集された属性は、InsightsのPageViewイベントの下に表示されないことがあります。この宛先は、ブラウザ監視とも呼ばれます。

スパンイベント

ディストリビューティッド(分散)トレーシングに対して収集されたスパンイベントには、スパン中に収集された属性が含まれます。

注意: 現時点では、当社の製品は、Spanイベントにカスタムユーザー属性を追加する機能をサポートしていません。

トランザクションセグメント

トランザクショントレースの各セグメントには、そのセグメントに対して記録された属性が含まれます。

要求属性の表示

要求属性は、New Relic APMとNew Relic Insightsにおける特定のトランザクショントレース、ブラウザトレース、およびエラーに関連付けられています。個々のトレースまたはエラーを参照する際に、要求とともに記録されている属性を確認できます。Insightsでは、カスタム属性は他のすべての属性とまったく同様にNRQLによってクエリを実行できます。

screen-tx-trace-attributes.png
APM > (アプリを選択)> Monitoring > Transactions >(トランザクションを選択)>(トレースを選択): ここに、トランザクショントレースの要求属性カスタム属性の例を示します。正確な属性は、各自のエージェントおよび属性の設定によって異なります。

制限

ユーザー属性、要求属性、およびメッセージキューのパラメーターは、カウントとサイズによって制限されます。

パラメーター 制限
トランザクション 64のユーザー属性に制限
属性キー

それぞれ256バイトに制限

キーが256バイトを超えると、属性は記録されなくなります。

属性値

それぞれ256バイトに制限

値が256バイトを超えると、属性値は切り詰められます。

エージェント固有の属性

各New Relic APMエージェントは、カスタム属性を収集します。サポートされている属性は、個々のエージェントによって異なります。

その他のヘルプ

推奨する詳細情報: