Insights 用 APM のデフォルトイベントとデフォルト属性

New Relic APM のトランザクションやエラーのデータは、自動的に New Relic Insights へ追加されます。ここで言及しているトランザクションイベントのデフォルト属性を使うと、アプリのパフォーマンスを確認したり、APM のエラーイベントのデフォルト属性についての追加情報も見ることができます。

また、カスタム属性カスタムイベントを使うことで、デフォルト属性を拡張することができます。また、全デフォルト属性については、Insights 属性をご覧ください。

利用可能な属性の表示

デフォルトで、New Relic APM エージェントは、サーバーサイドのトランザクションデータの属性を New Relic Insights にもデータを送ります。利用可能な属性は、お使いのサーバー設定によって利用可能なログやサーバーの情報は異なりますので、それにより、利用可能な属性は異なります。

利用可能な属性を確認するには、Data Explorer を使うと便利です。以下の手順で確認できます。

  1. New Relic のメニューバーから、Insights > Data Explorer へアクセスします。
  2. イベントタイプのドロップダウンから、Transaction を選択します。

Explorer には、直近の Transaction イベントの一覧が表示されます。

APM のトランザクションイベントへの問い合わせは、以下のように SELECT 文で、FROM Transaction を使います。

SELECT average(duration) FROM Transaction

カスタム属性とカスタムイベントの追加

デフォルトの属性は、APM のカスタム属性を使って拡張できます。Java と .NET のユーザーであれば、ユーザーのより詳細はアクティビティに関するユーザー属性を収集できます。APM エージェント APIInsights API を使えば、新しいイベントを作ることもできます。

デフォルト APM 属性

New Relic APM のトランザクションイベントは、以下のデフォルト属性があります。

属性 説明
appId New Relic が記録した アプリケーション ID
appName アプリケーション名。通常、アプリケーションサーバーの名前となります。値は、(エイリアスがセットされている場合、) APM のapp alias [エイリアス]となります。
databaseDuration データベースの応答時間です。単位は秒です。Node.js を除く全エージェントで利用できます。
duration サーバーサイドのトランザクションの合計応答時間です。単位は秒です。リクエストの処理待ち時間は含みません。
errorMessage .NET と PHP エージェントのみ: トランザクションで発生したエラーに含まれるメッセージ。トランザクション内でエラーが発生すると、イベントの処理時間がエラーによって狂うことがあります。
errorType .NET と PHP エージェントのみ: エラークラスまたは分類。複数のエラーが発生した場合は、最初のエラーのみ表示されます。トランザクション中にエラーが発生した場合、エラーにより、イベントの処理時間を狂わすことがあります。
externalDuration 全外部サービスの合計レスポンスタイム。単位は秒。
gcCumulative Ruby エージェントのみ: このトランザクション中のガーベッジコレクションの合計処理時間
host このリクエストを処理したアプリケーションのホスト名
httpResponseCode Java と PHP エージェントのみ: トンランザクションに関連する HTTP の レスポンスコード [英語]
name このトランザクションを処理したコントローラー名 (例: Controller/customers/show)
queueDuration サービス開始のために待ち時間の合計。単位は秒。
realAgentId New Relic エージェントのレポートの ID
transactionSubType トランザクションの詳細なタイプ。例: ResqueJobCustom
transactionType トランザクションのタイプ。例: WebBackground
tripId ランダムに生成された文字列。アプリ間のトレース内のすべてのトランザクションで一貫しています。この文字列を使うと、特定のアクセスやトレースに関連する一連のトランザクションを特定できます。
type イベントのタイプ。ここでは、常に Transaction となります。
webDuration 全ウェブトランザクションの合計レスポンスタイム。単位は秒。

関連情報

関連する情報は以下のとおりです。