APMブラウザ・エージェントのトレースおよびスパン属性
トレース・エクスプローラのトレース(ルート・スパン)およびスパン属性は、スパンにタグ付けすることによって定義されます。これにより、アプリケーションの様々な層の効果的なモニタリングが可能になります。
属性は、スパンにアタッチされたキーと値のペアで、スパン内で実行される操作に関する追加情報とコンテキストを提供します。トレースには、トレースのみの属性とルート・スパンのすべてのスパン属性があります。
トレース・エクスプローラでは、属性を使用してトレースとスパンを問合せおよびフィルタできます。属性には、トレース・エクスプローラの「属性」パネルで使用可能なディメンション(文字列属性)とメトリック(数値属性)の2つのタイプがあります。
この項では、APMブラウザ・エージェントに適用可能な即時利用可能な属性の完全なリストを示します。次の表には次のものが含まれます。
- 名前: 属性の名前。
- 説明: 属性の簡潔な説明。
- トレース/スパン: 属性の可用性。属性は、トレース、スパンまたはその両方に使用できます。
- タイプ: 属性のタイプ: ディメンションまたはメトリック。
| 名前 | 説明 | トレース/スパン | タイプ | 
|---|---|---|---|
| AggregateCount | 1つのスパンにまとめられた観測の数。これは、 ApmrumTypeに応じて、リソース・ヒットまたはエラーになる可能性があります。 | トレースおよびスパン属性 | メトリック | 
| AjaxCalls | 監視されたAJAXコールの数。 | トレースおよびスパン属性 | メトリック | 
| AjaxDownloadTime | レスポンスのダウンロードにかかった時間。 | トレースおよびスパン属性 | メトリック | 
| AjaxErrors | 監視されたAJAXエラーの数。 | トレースおよびスパン属性 | メトリック | 
| AjaxFirstByteTime | リクエストがサーバーに送信されてからAJAXコール・レスポンスの最初のバイトを受信するまでにかかった時間。これは主に、ネットワーク・レイテンシおよびサーバー・レスポンス時間の影響を受けます。 | トレースおよびスパン属性 | メトリック | 
| AjaxInitTime | fetch/xhrの作成からリクエストの送信までに、ブラウザ内部でAJAXリクエストの初期化にかかった時間。 | トレースおよびスパン属性 | メトリック | 
| AjaxResponseTime | AJAXコール・レスポンスの処理にかかった時間。これは AjaxInitTime、AjaxFirstByteTimeおよびAjaxDownloadTimeの合計です | トレースおよびスパン属性 | メトリック | 
| ApdexScore | ユーザー満足度レベルと、集計可能な数値表現とのマッピング。値は、「不満」の場合は 0と「満足」の場合は1の間です。 | トレースおよびスパン属性 | メトリック | 
| ApmrumAttribute1 | 必要な値をレポートするように構成できるカスタム属性。デフォルト値には最初のディレクトリが移入されます。 | トレースおよびスパン属性 | ディメンション | 
| ApmrumAttribute2 | ユーザー定義値が移入されたカスタム・ディメンション。Oracle Application Development Frameworkなどの一部のフレームワークでは、ドキュメントでデフォルト値について説明します。 | トレースおよびスパン属性 | ディメンション | 
| ApmrumClickElementId | ApmRumType PageUpdateに関連してクリックされた要素のxpath表現。 | トレースおよびスパン属性 | ディメンション | 
| ApmrumClickElementName | ApmRumType PageUpdateに関連してクリックされたテキスト。このフィールドは、trackScreenTextブールが構成されている場合にのみ移入されます。 | トレースおよびスパン属性 | ディメンション | 
| ApmrumContextType | スパンが作成されるコンテキスト。たとえば、 Page、Page UpdateおよびCustom Spanです。 | トレースおよびスパン属性 | ディメンション | 
| ApmrumLanguage | ブラウザからの言語設定。 | トレースおよびスパン属性 | ディメンション | 
| ApmrumPageUpdateType | ページ更新タイプ。たとえば、  Partial Page Update、Full Page UpdateまたはPage Loadです。 | トレースおよびスパン属性 | ディメンション | 
| ApmrumType | スパンのタイプ。たとえば、 Page Update、Page LoadまたはAjaxです。 | トレースおよびスパン属性 | ディメンション | 
| ApmrumWindowId | スパンを生成するアクティブ・ウィンドウのID。 | トレースおよびスパン属性 | ディメンション | 
| Component | JDBC、SERVLET、BROWSERなどの値を使用して、 https://opentracing.io/specification/conventions/標準からスパンを生成したコンポーネント。 | トレースおよびスパン属性 | ディメンション | 
| ConnectCount | 確立された接続の数。 | トレースおよびスパン属性 | メトリック | 
| ConnectTime | サーバー接続の確立にかかった平均時間。 | トレースおよびスパン属性 | メトリック | 
| DeviceType | ユーザーが使用するデバイスのタイプ。たとえば、パーソナル・コンピュータなどです。 | トレースおよびスパン属性 | ディメンション | 
| DNSLookups | DNSルックアップの数。 | トレースおよびスパン属性 | メトリック | 
| DNSTime | DNSルックアップの実行にかかった平均時間。 | トレースおよびスパン属性 | メトリック | 
| ECID | Oracle実行コンテキストID。 | スパン属性 | ディメンション | 
| Error | エラーの場合に、スパンをブール値 trueで「失敗」としてマークするスパン・プロパティ。これは、スパンで表される操作が失敗したとみなされたことを示します。デフォルトのブール値はfalseです(エラーなし)。 | トレースおよびスパン属性 | ディメンション | 
| ErrorLocation | エラーの場所または発生元(ある場合)。 | トレースおよびスパン属性 | ディメンション | 
| ErrorMessage | エラーの説明。 | トレースおよびスパン属性 | ディメンション | 
| ErrorObject | 判読可能なエラーの説明。 | トレースおよびスパン属性 | ディメンション | 
| HttpMethod | リクエストで使用されるHTTPメソッド( GET、POST、DELETEなど)。 | トレースおよびスパン属性 | ディメンション | 
| HttpStatusCode | レスポンスのHTTPステータス・コード( 200、404、500など)。 | トレースおよびスパン属性 | ディメンション | 
| HttpStatusDetails | HTTPレスポンス・ステータス・コードの説明。 | トレースおよびスパン属性 | ディメンション | 
| HttpUrl | スパンに関連するHTTP URL。 | トレースおよびスパン属性 | ディメンション | 
| HttpUrlFragment | スパンに関連するHTTP URLフラグメント。 | トレースおよびスパン属性 | ディメンション | 
| HttpUrlHost | スパンに関連するHTTP URLホスト名。 | トレースおよびスパン属性 | ディメンション | 
| HttpUrlPath | スパンに関連するHTTP URLパス。 | トレースおよびスパン属性 | ディメンション | 
| HttpUrlQuery | スパンに関連するHTTP URL問合せ。 | トレースおよびスパン属性 | ディメンション | 
| Kind | オープン・トレース定義(https://opentracing.io/specification/conventions/) span.kind0に関連するフィールド。ブラウザ・エージェントはCLIENTやINTERNALなどの値をレポートでき、Javaエージェントおよびその他のトレーサはサーブレット用のSERVERやHttpClientおよびJDBC用のCLIENTなどの値をレポートできます。 | トレースおよびスパン属性 | ディメンション | 
| OperationName | スパンの名前。 | トレースおよびスパン属性 | ディメンション | 
| PageClicks | ページでクリックされた回数。 | トレースおよびスパン属性 | メトリック | 
| PageDownloadTime | ブラウザがページURLのリクエストを送信してからコンテンツ全体が受信されるまでの時間。 | トレースおよびスパン属性 | メトリック | 
| PageFirstByteTime | ブラウザがページURLのリクエストを送信してから、そのページURLのサーバーからのレスポンスの最初のバイトが送信されるまでの時間。これは主に、サーバー・レスポンス時間とネットワーク・レイテンシの影響を受けます。 | トレースおよびスパン属性 | メトリック | 
| PageInitTime | ブラウザがナビゲーション・トリガーを受信してからページURLのリクエストが開始されるまでの時間(接続設定時間を含む)。この時間は、ページ・ロードおよびページ更新について計算されます。 | トレースおよびスパン属性 | メトリック | 
| PageInteractiveTime | ページがインタラクティブになるまでにかかった時間。 | トレースおよびスパン属性 | メトリック | 
| PageRenderTime | ブラウザが完全なHTMLを受信してからコンテンツがレンダリングされるまでの時間。 | トレースおよびスパン属性 | メトリック | 
| PageResponseTime | ナビゲーションの開始からスクリプトのロードの完了までにかかった時間。これは、 PageInitTime、PageFirstByteTime、PageDownloadTimeおよびPageRenderTimeの合計です | トレースおよびスパン属性 | メトリック | 
| PageViews | ページ・ビューの数。 | トレースおよびスパン属性 | メトリック | 
| RedirectTime | HTTPリダイレクトの処理にかかった平均時間。 | トレースおよびスパン属性 | メトリック | 
| SatisfiedPageViews | パフォーマンスが「満足」のページ・ビューの数。 | トレースおよびスパン属性 | メトリック | 
| ScriptErrors | 監視されたJavaScriptエラーの数。 | トレースおよびスパン属性 | メトリック | 
| SessionId | セッションまたはブラウザの一意の識別子。 | トレースおよびスパン属性 | ディメンション | 
| SpanID | 各スパンの一意の識別子。 | スパン属性 | ディメンション | 
| SSLTime | ( ConnectTimeの一部として)セキュアなサーバー接続の確立にかかった平均時間。 | トレースおよびスパン属性 | メトリック | 
| StartTime | スパンの開始時間。 | スパン属性 | メトリック | 
| ToleratingPageViews | パフォーマンスが「許容」のページ・ビューの数。 | トレースおよびスパン属性 | メトリック | 
| UserName | システムを使用するエンド・ユーザーのユーザー名、またはユーザーを一意に識別する識別子。 ユーザー名取得および構成オプションの詳細は、Modify or Disable Default Probe Settingsを参照してください。 | トレースおよびスパン属性 | ディメンション | 
| WebApplicationName | インストゥルメンテーションで指定されたWebアプリケーションの名前。このディメンションに値が指定されていない場合は、「デフォルトWebApp」が割り当てられます。 | トレースおよびスパン属性 | ディメンション |