メトリックとスナップショット API

このページでは、メトリックデータ情報や、モニタリング対象環境のさまざまなタイプのアクティビティに関する情報を取得できる、コントローラメトリックとイベント API メソッドについて説明します。さらに、メトリックを保持する期間を設定することもできます。

メトリックおよびスナップショット API のデータ保持

時間範囲のデフォルトの粒度

粒度は、データを取得するときの時間範囲に依存します。以下の表では、さまざまな時間範囲のデータの粒度を指定しています。

時間範囲 精度
0 ～ 1459 分（0 ～ 24.20 時間）

1分
1460 ～ 2940 分（24.20 ～ 49 時間）

10分
49 時間超 60 分

データが取得されていないか、時間範囲が無効な場合は、必然的にデータの粒度は適用されません。

データの集約

rollup クエリ文字列パラメータを true に設定すると、集約データ（1 データポイント）を要求できます。rollup=false を設定することで、データ集約を無効にすることができます。デフォルト値は true です。

例： /controller/rest/applications/application_name/metrics?rollup=true

時間範囲

クエリ文字列パラメータ time-range-type を使用して、データの時間範囲を設定できます。time-range-type では、次の値がサポートされています。

  • BEFORE_NOW
  • BEFORE_TIME
  • AFTER_TIME
  • BETWEEN_TIMES

カスタムデータ粒度のリクエスト

カスタム粒度でデータをリクエストするには、次の手順を実行します。

  • rollup=true を設定するか、または rollup プロパティを指定しないでください。
  • クエリ文字列パラメータ time-range を使用して、集約データの目的の時間範囲を設定します。
  • time-range と頻度を使用して範囲を設定します。
    • For BETWEEN_TIMES では、パラメータ start-time と end-time. で開始時刻と終了時刻を指定して頻度を設定します。
    • BEFORE_NOW には、パラメータ duration-in-mins. を指定します。
    • AFTER_TIME には、パラメータ duration-in-mins と start-time. を指定します。
    • BEFORE_TIME には、パラメータ duration-in-minsと end-time. を指定します。

リクエスト例

設定された範囲と頻度 データ粒度の説明
?rollup=true&time-range-type=BETWEEN_TIMES&start-time=1682841600000&end-time=1682841603600 指定された開始時刻と終了時刻の間（60 分間）に集約されたメトリックデータが返されます。
?rollup=true&time-range-type=BEFORE_NOW&duration-in-mins=120 120 分前から現在までに集約されたメトリックデータが返されます。
?rollup=true&time-range-type=BEFORE_TIME&end-time=1682841603600&duration-in-mins=15 end-time の 15 分前から end-time までに集約されたメトリックデータが返されます。

パラメータの説明とその他の例については、「時間範囲の使用」を参照してください。

メトリック階層を取得する

API は、メトリックツリー構造に関する情報を返します。API は子要素の最初の生成を取得するため、フォルダタイプの子のみを展開できます。

  • 応答で子要素がコンテナ項目の場合、その type 値は folder になります。
  • それ以外の場合は、子要素の type 値が leaf になります。

メトリックデータを取得する パラメータを使用すると、「メトリックデータ API」で説明されているようにメトリックツリー構造をさらに再帰させることができます。

形式

 GET /controller/rest/applications/application_name/metrics

入力パラメータ

パラメータ名 Parameter Type 値 必須

application_name

URI

ビジネスアプリケーションや EUM（browser/mobile/IoT）アプリケーションの名前または ID。 アプリケーションモデル API でアプリケーション ID を取得するには、コールを使用します。

あり

出力

クエリ

出力形式を変更するために URL の一部として含まれている HTTP リクエストパラメータ。有効な値は XML（デフォルト）または JSON です。

いいえ
metric-path [Query（クエリ）]

メトリック階層内のメトリックへのパス。

注: metric-path で特殊文字「|」（パイプ）または「\」（バックスラッシュ）を含める場合は、エスケープを示す追加のバックスラッシュ（「\」）を含める必要があります。
いいえ

例

curl --user user1@customer1:your_password "http://demo.appdynamics.com/controller/rest/applications/ECommerce_E2E/metrics"
<metric-items><metric-item>
<type>folder</type>
<name>Backends</name>
</metric-item>
<metric-item>
<type>folder</type>
<name>Service Endpoints</name>
</metric-item>
<metric-item>
<type>folder</type>
<name>End User Experience</name>
</metric-item>
<metric-item>
<type>folder</type>
<name>Errors</name>
</metric-item>
<metric-item>
<type>folder</type>
<name>Business Transaction Performance</name>
</metric-item>
<metric-item>
<type>folder</type>
<name>Information Points</name>
</metric-item>
<metric-item>
<type>folder</type>
<name>Overall Application Performance</name>
</metric-item>
<metric-item>
<type>folder</type>
<name>Application Infrastructure Performance</name>
</metric-item>
<metric-item>
<type>folder</type>
<name>Mobile</name>
</metric-item></metric-items>

メトリックデータを取得する

メトリックデータメソッドを使用すると、メトリックに対して生成された値を取得できます。このメソッドを使用するには、API に次のパラメータを指定します。

  • 取得するメトリックのパス。
  • データのタイムフレーム。

メトリックパスと時間範囲に関連するパラメータの作成方法を把握する最も簡単な方法は、コントローラ UI を使用することです。

  1. メトリックブラウザでメトリックを右クリックします。
  2. [Copy REST URL] を選択します。コピーした URL には、このメトリックと UI で選択した時間範囲へのパスが含まれています。
  3. 特定のクライアントでは、フルパスの値をメトリックパスパラメータとして受け入れ、適切にエンコードすることができます。
  4. ツリー内のメトリックの上にカーソルを合わせて、右クリックメニューの [] オプションを使用してパスをコピーできます。

以下の特定の例は完全にエンコードされた URL 値ではなく、 で示されています。フルパスを使用してコールをテストする場合は、パスの先頭または末尾にパイプ文字が使用されないようにしてください。

以下のセクションでは、メトリックデータメソッドの詳細情報と例について説明します。

形式

 GET /controller/rest/applications/application_name/metric-data

入力パラメータ

パラメータ名 Parameter Type 値 必須
metric-path [Query（クエリ）]

メトリック階層内のメトリックへのパス。

注: metric-path で特殊文字「|」（パイプ）または「\」（バックスラッシュ）を含める場合は、エスケープを示す追加のバックスラッシュ（「\」）を含める必要があります。
あり

ロールアップ

[Query（クエリ）]

デフォルトでは、返されるメトリックの値が 1 つのデータポイントにロールアップされます（rollup = true）。

いいえ

時間範囲を指定するための追加の必須パラメータについては、「時間範囲の使用」を参照してください。

例

絶対パスで、次のメトリックのメトリック値を取得します。

curl --user user1@customer1:your_password "http://demo.appdynamics.com/controller/rest/applications/ECommerce_E2E/metric-data?metric-path=Overall%20Application%20Performance%7CAverage%20Response%20Time%20%28ms%29&time-range-type=BEFORE_NOW&duration-in-mins=15"
<metric-datas><metric-data>
<metricId>2339</metricId>
<metricPath>Overall Application Performance|Average Response Time (ms)</metricPath>
<metricName>BTM|Application Summary|Average Response Time (ms)</metricName>
<frequency>ONE_MIN</frequency>
<metricValues>
<metric-value>
<startTimeInMillis>1450562160000</startTimeInMillis>
<value>302</value>
<min>0</min>
<max>15212</max>
<current>15212</current>
<sum>97800</sum>
<count>324</count>
<standardDeviation>0.0</standardDeviation>
<occurrences>0</occurrences>
<useRange>true</useRange>
</metric-value>
</metricValues>
</metric-data>
</metric-datas>

メトリック応答値

メトリックの結果には、次のフィールドが含まれます。

Name 定義
現在 その時点（1分間）における値。コントローラで使用されている時間ロールアップタイプが最新の場合にのみ使用されます。
count 選択した期間にエージェントがメトリックを収集した回数。
min、max 指定した期間に報告された最小値と最大値。これらは、すべてのメトリックタイプに使用されるわけではありません。
回 標準偏差を計算するためにコントローラによって取得されたデータサンプルの数。
standardDeviation 時間ロールアップを標準偏差の計算に使用している間に、コントローラによって計算された中間値。「動的ベースライン」を参照してください。
startTimeInMillis StartTimeInMillis は、UNIX エポック時間で結果のメトリックデータが適用される時間範囲の開始時刻です。
sum 選択した期間におけるメトリックの累積値の合計。
useRange メトリックを処理するために、コントローラによって内部で使用されます。
value value 値は、設定された評価時間全体について報告されるすべてのメトリック値のうち、次のいずれかの値を指します。
  • 算術平均：メトリックの時間ロールアップタイプが average の場合
  • 合計：メトリックの時間ロールアップタイプが sum の場合
  • 最新の値：メトリックの時間ロールアップタイプが current の場合
注: メトリックが 1 時間ごと、または 1 日ごとのデータポイントにロールアップされる場合を除き、count ベースまたは sum ベースのメトリックでは min および max の値を使用できません。これらのメトリックには、1 分あたりのエラー数、1 分あたりのコール数などが含まれます。

ワイルドカードの使用

メトリックブラウザで REST URL をコピーすると、特定のアプリケーションおよび階層内にある特定のメトリックへのパスを取得します。または、URL パス内の 1 つ以上の手順でワイルドカード文字を使用し、複数のビジネストランザクション、階層、ノードを含むエンティティのメトリックデータを取得できます。

次の形式の例は、特定の結果を得るために、さまざまなメトリックパスでワイルドカード文字を配置する場所を示しています。わかりやすくするために、これらの形式の例では、REST URL ではなくメトリックの「フルパス」を使用します。完全な作業例については、各形式の下で展開中のリンクをクリックしてください。

  • 階層名にワイルドカードを使用して、アプリケーション内のすべての階層のアプリケーション エージェントの使用可能時間を取得します。

    /controller/rest/applications/ECommerce_E2E-Fulfillment/metric-data?metric-path=Application Infrastructure Performance|*|Agent|App|Availability&time-range-type=BEFORE_NOW&duration-in-mins=15
    詳細な例： 
    curl --user user1@customer1:your_password "http://demo.appdynamics.com/controller/rest/applications/ECommerce_E2E-Fulfillment/metric-data?metric-path=Application%20Infrastructure%20Performance%7C*%7CAgent%7CApp%7CAvailability&time-range-type=BEFORE_NOW&duration-in-mins=15"
<metric-datas><metric-data>
<metricId>2329</metricId>
<metricPath>Application Infrastructure Performance|Fulfillment-Services|Agent|App|Availability</metricPath>
<metricName>Agent|App|Availability</metricName>
<frequency>ONE_MIN</frequency>
<metricValues>
<metric-value>
<startTimeInMillis>1450562460000</startTimeInMillis>
<value>1</value>
<min>0</min>
<max>0</max>
<current>1</current>
<sum>15</sum>
<count>15</count>
<standardDeviation>0.0</standardDeviation>
<occurrences>0</occurrences>
<useRange>false</useRange>
</metric-value>
</metricValues>
</metric-data>
<metric-data>
<metricId>2329</metricId>
<metricPath>Application Infrastructure Performance|Fulfillment-Client-Services|Agent|App|Availability</metricPath>
<metricName>Agent|App|Availability</metricName>
<frequency>ONE_MIN</frequency>
<metricValues>
<metric-value>
<startTimeInMillis>1450562460000</startTimeInMillis>
<value>1</value>
<min>0</min>
<max>0</max>
<current>1</current>
<sum>15</sum>
<count>15</count>
<standardDeviation>0.0</standardDeviation>
<occurrences>0</occurrences>
<useRange>false</useRange>
</metric-value>
</metricValues>
</metric-data>
</metric-datas>

  • 階層名とノード名にワイルドカードを使用して、すべての階層内のすべてのノードの CPU % Busy メトリックを取得します。

    /controller/rest/applications/ECommerce_E2E-Fulfillment/metric-data?metric-path=Application Infrastructure Performance|*|Individual Nodes|*|Hardware Resources|CPU|%Busy&time-range-type=BEFORE_NOW&duration-in-mins=15
    詳細な例： 
    curl --user user1@customer1:your_password "http://demo.appdynamics.com/controller/rest/applications/ECommerce_E2E-Fulfillment/metric-data?metric-path=Application%20Infrastructure%20Performance%7C*%7CIndividual%20Nodes%7C*%7CHardware%20Resources%7CCPU%7C%25Busy&time-range-type=BEFORE_NOW&duration-in-mins=15"
<metric-datas><metric-data>
<metricId>2231</metricId>
<metricPath>Application Infrastructure Performance|Fulfillment-Client-Services|Individual Nodes|FulfillmentClient|Hardware Resources|CPU|%Busy</metricPath>
<metricName>Hardware Resources|CPU|%Busy</metricName>
<frequency>ONE_MIN</frequency>
<metricValues>
<metric-value>
<startTimeInMillis>1450563000000</startTimeInMillis>
<value>10</value>
<min>2</min>
<max>82</max>
<current>6</current>
<sum>4474</sum>
<count>450</count>
<standardDeviation>0.0</standardDeviation>
<occurrences>0</occurrences>
<useRange>true</useRange>
</metric-value>
</metricValues>
</metric-data>
<metric-data>
<metricId>2231</metricId>
<metricPath>Application Infrastructure Performance|Fulfillment-Services|Individual Nodes|Fulfillment|Hardware Resources|CPU|%Busy</metricPath>
<metricName>Hardware Resources|CPU|%Busy</metricName>
<frequency>ONE_MIN</frequency>
<metricValues>
<metric-value>
<startTimeInMillis>1450563000000</startTimeInMillis>
<value>10</value>
<min>2</min>
<max>82</max>
<current>6</current>
<sum>4478</sum>
<count>450</count>
<standardDeviation>0.0</standardDeviation>
<occurrences>0</occurrences>
<useRange>true</useRange>
</metric-value>
</metricValues>
</metric-data>
</metric-datas>

  • ビジネストランザクション名にワイルドカードを使用して、e-コマース階層にあるすべてのビジネストランザクションの 1 分あたりのコール数を取得します。

    /controller/rest/applications/ACME Book Store Application/metric-data?metric-path=Business Transaction Performance|Business Transactions|ECommerce Server|*|Calls per Minute&time-range-type=BEFORE_NOW&duration-in-mins=15
    詳細な例： 
    curl --user user1@customer1:your_password "http://demo.appdynamics.com/controller/rest/applications/ECommerce_E2E/metric-data?metric-path=Business%20Transaction%20Performance%7CBusiness%20Transactions%7CECommerce-Services%7C*%7CCalls%20per%20Minute&time-range-type=BEFORE_NOW&duration-in-mins=15"
<metric-datas><metric-data>
<metricId>4042</metricId>
<metricPath>Business Transaction Performance|Business Transactions|ECommerce-Services|/json/cart/all.GET|Calls per Minute</metricPath>
<metricName>BTM|BTs|BT:125|Component:9|Calls per Minute</metricName>
<frequency>ONE_MIN</frequency>
<metricValues>
<metric-value>
<startTimeInMillis>1450563420000</startTimeInMillis>
<value>0</value>
<min>0</min>
<max>0</max>
<current>0</current>
<sum>5</sum>
<count>30</count>
<standardDeviation>0.0</standardDeviation>
<occurrences>0</occurrences>
<useRange>false</useRange>
</metric-value>
</metricValues>
</metric-data>
<metric-data>
<metricId>9784</metricId>
<metricPath>Business Transaction Performance|Business Transactions|ECommerce-Services|/appdynamicspilot/WEB-INF|Calls per Minute</metricPath>
<metricName>BTM|BTs|BT:183|Component:9|Calls per Minute</metricName>
<frequency>ONE_MIN</frequency>
<metricValues>
<metric-value>
<startTimeInMillis>1450563420000</startTimeInMillis>
<value>0</value>
<min>2147483647</min>
<max>-2147483648</max>
<current>0</current>
<sum>0</sum>
<count>0</count>
<standardDeviation>0.0</standardDeviation>
<occurrences>0</occurrences>
<useRange>false</useRange>
</metric-value>
</metricValues>
</metric-data>
<metric-data>
<metricId>5574</metricId>
<metricPath>Business Transaction Performance|Business Transactions|ECommerce-Services|/appdynamicspilot/404.jsp|Calls per Minute</metricPath>
<metricName>BTM|BTs|BT:140|Component:9|Calls per Minute</metricName>
<frequency>ONE_MIN</frequency>
<metricValues>
<metric-value>
<startTimeInMillis>1450563420000</startTimeInMillis>
<value>0</value>
<min>2147483647</min>
<max>-2147483648</max>
<current>0</current>
<sum>0</sum>
<count>0</count>
<standardDeviation>0.0</standardDeviation>
<occurrences>0</occurrences>
<useRange>false</useRange>
</metric-value>
</metricValues>
</metric-data>
<metric-data>
<metricId>4033</metricId>
<metricPath>Business Transaction Performance|Business Transactions|ECommerce-Services|/json/items/all.GET|Calls per Minute</metricPath>
<metricName>BTM|BTs|BT:124|Component:9|Calls per Minute</metricName>
<frequency>ONE_MIN</frequency>
<metricValues>
<metric-value>
<startTimeInMillis>1450563420000</startTimeInMillis>
<value>0</value>
<min>0</min>
<max>0</max>
<current>0</current>
<sum>5</sum>
<count>30</count>
<standardDeviation>0.0</standardDeviation>
<occurrences>0</occurrences>
<useRange>false</useRange>
</metric-value>
</metricValues>
</metric-data>
<metric-data>
<metricId>4060</metricId>
<metricPath>Business Transaction Performance|Business Transactions|ECommerce-Services|/user/login.POST|Calls per Minute</metricPath>
<metricName>BTM|BTs|BT:127|Component:9|Calls per Minute</metricName>
<frequency>ONE_MIN</frequency>
<metricValues>
<metric-value>
<startTimeInMillis>1450563420000</startTimeInMillis>
<value>0</value>
<min>0</min>
<max>0</max>
<current>0</current>
<sum>5</sum>
<count>30</count>
<standardDeviation>0.0</standardDeviation>
<occurrences>0</occurrences>
<useRange>false</useRange>
</metric-value>
</metricValues>
</metric-data>
<metric-data>
<metricId>5592</metricId>
<metricPath>Business Transaction Performance|Business Transactions|ECommerce-Services|/cart/{id}.DELETE|Calls per Minute</metricPath>
<metricName>BTM|BTs|BT:142|Component:9|Calls per Minute</metricName>
<frequency>ONE_MIN</frequency>
<metricValues>
<metric-value>
<startTimeInMillis>1450563420000</startTimeInMillis>
<value>0</value>
<min>2147483647</min>
<max>-2147483648</max>
<current>0</current>
<sum>0</sum>
<count>0</count>
<standardDeviation>0.0</standardDeviation>
<occurrences>0</occurrences>
<useRange>false</useRange>
</metric-value>
</metricValues>
</metric-data>
<metric-data>
<metricId>5583</metricId>
<metricPath>Business Transaction Performance|Business Transactions|ECommerce-Services|/cart/{id}.GET|Calls per Minute</metricPath>
<metricName>BTM|BTs|BT:141|Component:9|Calls per Minute</metricName>
<frequency>ONE_MIN</frequency>
<metricValues>
<metric-value>
<startTimeInMillis>1450563420000</startTimeInMillis>
<value>0</value>
<min>2147483647</min>
<max>-2147483648</max>
<current>0</current>
<sum>0</sum>
<count>0</count>
<standardDeviation>0.0</standardDeviation>
<occurrences>0</occurrences>
<useRange>false</useRange>
</metric-value>
</metricValues>
</metric-data>
<metric-data>
<metricId>4024</metricId>
<metricPath>Business Transaction Performance|Business Transactions|ECommerce-Services|/json/cart/co.GET|Calls per Minute</metricPath>
<metricName>BTM|BTs|BT:123|Component:9|Calls per Minute</metricName>
<frequency>ONE_MIN</frequency>
<metricValues>
<metric-value>
<startTimeInMillis>1450563420000</startTimeInMillis>
<value>0</value>
<min>0</min>
<max>0</max>
<current>0</current>
<sum>5</sum>
<count>30</count>
<standardDeviation>0.0</standardDeviation>
<occurrences>0</occurrences>
<useRange>false</useRange>
</metric-value>
</metricValues>
</metric-data>
<metric-data>
<metricId>2477</metricId>
<metricPath>Business Transaction Performance|Business Transactions|ECommerce-Services|/user/.POST|Calls per Minute</metricPath>
<metricName>BTM|BTs|BT:92|Component:9|Calls per Minute</metricName>
<frequency>ONE_MIN</frequency>
<metricValues>
<metric-value>
<startTimeInMillis>1450563420000</startTimeInMillis>
<value>5</value>
<min>0</min>
<max>0</max>
<current>3</current>
<sum>71</sum>
<count>30</count>
<standardDeviation>0.0</standardDeviation>
<occurrences>0</occurrences>
<useRange>false</useRange>
</metric-value>
</metricValues>
</metric-data>
<metric-data>
<metricId>5601</metricId>
<metricPath>Business Transaction Performance|Business Transactions|ECommerce-Services|/cart/co.GET|Calls per Minute</metricPath>
<metricName>BTM|BTs|BT:143|Component:9|Calls per Minute</metricName>
<frequency>ONE_MIN</frequency>
<metricValues>
<metric-value>
<startTimeInMillis>1450563420000</startTimeInMillis>
<value>0</value>
<min>2147483647</min>
<max>-2147483648</max>
<current>0</current>
<sum>0</sum>
<count>0</count>
<standardDeviation>0.0</standardDeviation>
<occurrences>0</occurrences>
<useRange>false</useRange>
</metric-value>
</metricValues>
</metric-data>
<metric-data>
<metricId>4099</metricId>
<metricPath>Business Transaction Performance|Business Transactions|ECommerce-Services|UserLogin.memberLogin|Calls per Minute</metricPath>
<metricName>BTM|BTs|BT:129|Component:9|Calls per Minute</metricName>
<frequency>ONE_MIN</frequency>
<metricValues>
<metric-value>
<startTimeInMillis>1450563420000</startTimeInMillis>
<value>0</value>
<min>2147483647</min>
<max>-2147483648</max>
<current>0</current>
<sum>0</sum>
<count>0</count>
<standardDeviation>0.0</standardDeviation>
<occurrences>0</occurrences>
<useRange>false</useRange>
</metric-value>
</metricValues>
</metric-data>
<metric-data>
<metricId>4138</metricId>
<metricPath>Business Transaction Performance|Business Transactions|ECommerce-Services|/appdynamicspilot/|Calls per Minute</metricPath>
<metricName>BTM|BTs|BT:132|Component:9|Calls per Minute</metricName>
<frequency>ONE_MIN</frequency>
<metricValues>
<metric-value>
<startTimeInMillis>1450563420000</startTimeInMillis>
<value>0</value>
<min>0</min>
<max>0</max>
<current>0</current>
<sum>4</sum>　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　
<count>30</count>
<standardDeviation>0.0</standardDeviation>
<occurrences>0</occurrences>
<useRange>false</useRange>
</metric-value>
</metricValues>
</metric-data>
<metric-data>
<metricId>4108</metricId>
<metricPath>Business Transaction Performance|Business Transactions|ECommerce-Services|ViewItems.getAllItems|Calls per Minute</metricPath>
<metricName>BTM|BTs|BT:130|Component:9|Calls per Minute</metricName>
<frequency>ONE_MIN</frequency>
<metricValues>
<metric-value>
<startTimeInMillis>1450563420000</startTimeInMillis>
<value>0</value>
<min>0</min>
<max>0</max>
<current>0</current>
<sum>4</sum>　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　
<count>30</count>
<standardDeviation>0.0</standardDeviation>
<occurrences>0</occurrences>
<useRange>false</useRange>
</metric-value>
</metricValues>
</metric-data>
<metric-data>
<metricId>4129</metricId>
<metricPath>Business Transaction Performance|Business Transactions|ECommerce-Services|ViewCart.sendItems|Calls per Minute</metricPath>
<metricName>BTM|BTs|BT:131|Component:9|Calls per Minute</metricName>
<frequency>ONE_MIN</frequency>
<metricValues>
<metric-value>
<startTimeInMillis>1450563420000</startTimeInMillis>
<value>0</value>
<min>0</min>
<max>0</max>
<current>0</current>
<sum>2</sum>
<count>30</count>
<standardDeviation>0.0</standardDeviation>
<occurrences>0</occurrences>
<useRange>false</useRange>
</metric-value>
</metricValues>
</metric-data>
<metric-data>
<metricId>4051</metricId>
<metricPath>Business Transaction Performance|Business Transactions|ECommerce-Services|/json/cart/{id}.GET|Calls per Minute</metricPath>
<metricName>BTM|BTs|BT:126|Component:9|Calls per Minute</metricName>
<frequency>ONE_MIN</frequency>
<metricValues>
<metric-value>
<startTimeInMillis>1450563420000</startTimeInMillis>
<value>1</value>
<min>0</min>
<max>0</max>
<current>0</current>
<sum>13</sum>
<count>30</count>
<standardDeviation>0.0</standardDeviation>
<occurrences>0</occurrences>
<useRange>false</useRange>
</metric-value>
</metricValues>
</metric-data>
<metric-data>
<metricId>4156</metricId>
<metricPath>Business Transaction Performance|Business Transactions|ECommerce-Services|ViewCart.addToCart|Calls per Minute</metricPath>
<metricName>BTM|BTs|BT:134|Component:9|Calls per Minute</metricName>
<frequency>ONE_MIN</frequency>
<metricValues>
<metric-value>
<startTimeInMillis>1450563420000</startTimeInMillis>
<value>0</value>
<min>0</min>
<max>0</max>
<current>0</current>
<sum>3</sum>
<count>30</count>
<standardDeviation>0.0</standardDeviation>
<occurrences>0</occurrences>
<useRange>false</useRange>
</metric-value>
</metricValues>
</metric-data>
<metric-data>
<metricId>4147</metricId>
<metricPath>Business Transaction Performance|Business Transactions|ECommerce-Services|/json/fault/getfaults.GET|Calls per Minute</metricPath>
<metricName>BTM|BTs|BT:133|Component:9|Calls per Minute</metricName>
<frequency>ONE_MIN</frequency>
<metricValues>
<metric-value>
<startTimeInMillis>1450563420000</startTimeInMillis>
<value>9</value>
<min>0</min>
<max>0</max>
<current>9</current>
<sum>130</sum>
<count>30</count>
<standardDeviation>0.0</standardDeviation>
<occurrences>0</occurrences>
<useRange>false</useRange>
</metric-value>
</metricValues>
</metric-data>
<metric-data>
<metricId>2630</metricId>
<metricPath>Business Transaction Performance|Business Transactions|ECommerce-Services|/items/all.GET|Calls per Minute</metricPath>
<metricName>BTM|BTs|BT:93|Component:9|Calls per Minute</metricName>
<frequency>ONE_MIN</frequency>
<metricValues>
<metric-value>
<startTimeInMillis>1450563420000</startTimeInMillis>
<value>5</value>
<min>0</min>
<max>0</max>
<current>0</current>
<sum>76</sum>
<count>30</count>
<standardDeviation>0.0</standardDeviation>
<occurrences>0</occurrences>
<useRange>false</useRange>
</metric-value>
</metricValues>
</metric-data>
<metric-data>
<metricId>4090</metricId>
<metricPath>Business Transaction Performance|Business Transactions|ECommerce-Services|UserLogOut.memberLogOut|Calls per Minute</metricPath>
<metricName>BTM|BTs|BT:128|Component:9|Calls per Minute</metricName>
<frequency>ONE_MIN</frequency>
<metricValues>
<metric-value>
<startTimeInMillis>1450563420000</startTimeInMillis>
<value>0</value>
<min>2147483647</min>
<max>-2147483648</max>
<current>0</current>
<sum>0</sum>
<count>0</count>
<standardDeviation>0.0</standardDeviation>
<occurrences>0</occurrences>
<useRange>false</useRange>
</metric-value>
</metricValues>
</metric-data>
</metric-datas>

  • ECommerce-Services サーバーで、ViewCart.addToCart トランザクションの複数のメトリックに対応するデータを取得します。

    /controller/rest/applications/ECommerce_E2E/metric-data?metric-path=Business Transaction Performance|Business Transactions|ECommerce Server|ViewCart.addToCart|*&time-range-type=BEFORE_NOW&duration-in-mins=15
    詳細な例： 
    curl --user user1@customer1:your_password "http://demo.appdynamics.com/controller/rest/applications/ECommerce_E2E/metric-data?metric-path=Business%20Transaction%20Performance%7CBusiness%20Transactions%7CECommerce-Services%7CViewCart.addToCart%7C*&time-range-type=BEFORE_NOW&duration-in-mins=15"
<metric-datas><metric-data>
<metricId>4155</metricId>
<metricPath>Business Transaction Performance|Business Transactions|ECommerce-Services|ViewCart.addToCart|Average Response Time (ms)</metricPath>
<metricName>BTM|BTs|BT:134|Component:9|Average Response Time (ms)</metricName>
<frequency>ONE_MIN</frequency>
<metricValues>
<metric-value>
<startTimeInMillis>1450566420000</startTimeInMillis>
<value>28</value>
<min>0</min>
<max>32</max>
<current>0</current>
<sum>84</sum>
<count>3</count>
<standardDeviation>0.0</standardDeviation>
<occurrences>0</occurrences>
<useRange>true</useRange>
</metric-value>
</metricValues>
</metric-data>
<metric-data>
<metricId>4159</metricId>
<metricPath>Business Transaction Performance|Business Transactions|ECommerce-Services|ViewCart.addToCart|Number of Very Slow Calls</metricPath>
<metricName>BTM|BTs|BT:134|Component:9|Number of Very Slow Calls</metricName>
<frequency>ONE_MIN</frequency>
<metricValues>
<metric-value>
<startTimeInMillis>1450566420000</startTimeInMillis>
<value>0</value>
<min>2147483647</min>
<max>-2147483648</max>
<current>0</current>
<sum>0</sum>
<count>0</count>
<standardDeviation>0.0</standardDeviation>
<occurrences>0</occurrences>
<useRange>false</useRange>
</metric-value>
</metricValues>
</metric-data>
<metric-data>
<metricId>4157</metricId>
<metricPath>Business Transaction Performance|Business Transactions|ECommerce-Services|ViewCart.addToCart|Errors per Minute</metricPath>
<metricName>BTM|BTs|BT:134|Component:9|Errors per Minute</metricName>
<frequency>ONE_MIN</frequency>
<metricValues>
<metric-value>
<startTimeInMillis>1450566420000</startTimeInMillis>
<value>0</value>
<min>2147483647</min>
<max>-2147483648</max>
<current>0</current>
<sum>0</sum>
<count>0</count>
<standardDeviation>0.0</standardDeviation>
<occurrences>0</occurrences>
<useRange>false</useRange>
</metric-value>
</metricValues>
</metric-data>
<metric-data>
<metricId>4161</metricId>
<metricPath>Business Transaction Performance|Business Transactions|ECommerce-Services|ViewCart.addToCart|Average CPU Used (ms)</metricPath>
<metricName>BTM|BTs|BT:134|Component:9|Average CPU Used (ms)</metricName>
<frequency>ONE_MIN</frequency>
<metricValues>
<metric-value>
<startTimeInMillis>1450566420000</startTimeInMillis>
<value>18</value>
<min>0</min>
<max>20</max>
<current>0</current>
<sum>54</sum>
<count>3</count>
<standardDeviation>0.0</standardDeviation>
<occurrences>0</occurrences>
<useRange>true</useRange>
</metric-value>
</metricValues>
</metric-data>
<metric-data>
<metricId>4160</metricId>
<metricPath>Business Transaction Performance|Business Transactions|ECommerce-Services|ViewCart.addToCart|Stall Count</metricPath>
<metricName>BTM|BTs|BT:134|Component:9|Stall Count</metricName>
<frequency>ONE_MIN</frequency>
<metricValues>
<metric-value>
<startTimeInMillis>1450566420000</startTimeInMillis>
<value>0</value>
<min>2147483647</min>
<max>-2147483648</max>
<current>0</current>
<sum>0</sum>
<count>0</count>
<standardDeviation>0.0</standardDeviation>
<occurrences>0</occurrences>
<useRange>false</useRange>
</metric-value>
</metricValues>
</metric-data>
<metric-data>
<metricId>4411</metricId>
<metricPath>Business Transaction Performance|Business Transactions|ECommerce-Services|ViewCart.addToCart|95th Percentile Response Time (ms)</metricPath>
<metricName>BTM|BTs|BT:134|Component:9|95th Percentile Response Time (ms)</metricName>
<frequency>ONE_MIN</frequency>
<metricValues>
<metric-value>
<startTimeInMillis>1450566420000</startTimeInMillis>
<value>28</value>
<min>0</min>
<max>32</max>
<current>0</current>
<sum>84</sum>
<count>3</count>
<standardDeviation>0.0</standardDeviation>
<occurrences>0</occurrences>
<useRange>true</useRange>
</metric-value>
</metricValues>
</metric-data>
<metric-data>
<metricId>4335</metricId>
<metricPath>Business Transaction Performance|Business Transactions|ECommerce-Services|ViewCart.addToCart|Normal Average Response Time (ms)</metricPath>
<metricName>BTM|BTs|BT:134|Component:9|Normal Average Response Time (ms)</metricName>
<frequency>ONE_MIN</frequency>
<metricValues>
<metric-value>
<startTimeInMillis>1450566420000</startTimeInMillis>
<value>28</value>
<min>0</min>
<max>32</max>
<current>0</current>
<sum>84</sum>
<count>3</count>
<standardDeviation>0.0</standardDeviation>
<occurrences>0</occurrences>
<useRange>true</useRange>
</metric-value>
</metricValues>
</metric-data>
<metric-data>
<metricId>4162</metricId>
<metricPath>Business Transaction Performance|Business Transactions|ECommerce-Services|ViewCart.addToCart|Average Block Time (ms)</metricPath>
<metricName>BTM|BTs|BT:134|Component:9|Average Block Time (ms)</metricName>
<frequency>ONE_MIN</frequency>
<metricValues>
<metric-value>
<startTimeInMillis>1450566420000</startTimeInMillis>
<value>0</value>
<min>0</min>
<max>0</max>
<current>0</current>
<sum>0</sum>
<count>3</count>
<standardDeviation>0.0</standardDeviation>
<occurrences>0</occurrences>
<useRange>true</useRange>
</metric-value>
</metricValues>
</metric-data>
<metric-data>
<metricId>4163</metricId>
<metricPath>Business Transaction Performance|Business Transactions|ECommerce-Services|ViewCart.addToCart|Average Wait Time (ms)</metricPath>
<metricName>BTM|BTs|BT:134|Component:9|Average Wait Time (ms)</metricName>
<frequency>ONE_MIN</frequency>
<metricValues>
<metric-value>
<startTimeInMillis>1450566420000</startTimeInMillis>
<value>0</value>
<min>0</min>
<max>0</max>
<current>0</current>
<sum>0</sum>
<count>3</count>
<standardDeviation>0.0</standardDeviation>
<occurrences>0</occurrences>
<useRange>true</useRange>
</metric-value>
</metricValues>
</metric-data>
<metric-data>
<metricId>4156</metricId>
<metricPath>Business Transaction Performance|Business Transactions|ECommerce-Services|ViewCart.addToCart|Calls per Minute</metricPath>
<metricName>BTM|BTs|BT:134|Component:9|Calls per Minute</metricName>
<frequency>ONE_MIN</frequency>
<metricValues>
<metric-value>
<startTimeInMillis>1450566420000</startTimeInMillis>
<value>0</value>
<min>0</min>
<max>0</max>
<current>0</current>
<sum>3</sum>
<count>30</count>
<standardDeviation>0.0</standardDeviation>
<occurrences>0</occurrences>
<useRange>false</useRange>
</metric-value>
</metricValues>
</metric-data>
<metric-data>
<metricId>4331</metricId>
<metricPath>Business Transaction Performance|Business Transactions|ECommerce-Services|ViewCart.addToCart|Average Request Size</metricPath>
<metricName>BTM|BTs|BT:134|Component:9|Average Request Size</metricName>
<frequency>ONE_MIN</frequency>
<metricValues>
<metric-value>
<startTimeInMillis>1450566420000</startTimeInMillis>
<value>740</value>
<min>0</min>
<max>1057</max>
<current>0</current>
<sum>2221</sum>
<count>3</count>
<standardDeviation>0.0</standardDeviation>
<occurrences>0</occurrences>
<useRange>true</useRange>
</metric-value>
</metricValues>
</metric-data>
<metric-data>
<metricId>4158</metricId>
<metricPath>Business Transaction Performance|Business Transactions|ECommerce-Services|ViewCart.addToCart|Number of Slow Calls</metricPath>
<metricName>BTM|BTs|BT:134|Component:9|Number of Slow Calls</metricName>
<frequency>ONE_MIN</frequency>
<metricValues>
<metric-value>
<startTimeInMillis>1450566420000</startTimeInMillis>
<value>0</value>
<min>2147483647</min>
<max>-2147483648</max>
<current>0</current>
<sum>0</sum>
<count>0</count>
<standardDeviation>0.0</standardDeviation>
<occurrences>0</occurrences>
<useRange>false</useRange>
</metric-value>
</metricValues>
</metric-data>
</metric-datas>

データロールアップの無効化

デフォルトでは、メトリックデータが要求したタイムフレームでロールアップされます。rollup パラメータを false に設定すると、タイムフレーム内のすべてのデータポイントを取得できます。例：

curl --user user1@customer1:your_password "http://demo.appdynamics.com/controller/rest/applications/ECommerce_E2E/metric-data?rollup=false&metric-path=Overall%20Application%20Performance%7CAverage%20Response%20Time%20%28ms%29&time-range-type=BEFORE_NOW&duration-in-mins=15"
<metric-datas><metric-data>
<metricId>2339</metricId>
<metricPath>Overall Application Performance|Average Response Time (ms)</metricPath>
<metricName>BTM|Application Summary|Average Response Time (ms)</metricName>
<frequency>ONE_MIN</frequency>
<metricValues>
<metric-value>
<startTimeInMillis>1450503540000</startTimeInMillis>
<value>334</value>
<min>0</min>
<max>3340</max>
<current>2</current>
<sum>6678</sum>
<count>20</count>
<standardDeviation>0.0</standardDeviation>
<occurrences>0</occurrences>
<useRange>true</useRange>
</metric-value>
<metric-value>
<startTimeInMillis>1450503600000</startTimeInMillis>
<value>771</value>
<min>1</min>
<max>11235</max>
<current>4113</current>
<sum>15424</sum>
<count>20</count>
<standardDeviation>0.0</standardDeviation>
<occurrences>0</occurrences>
<useRange>true</useRange>
</metric-value>
<metric-value>
<startTimeInMillis>1450503660000</startTimeInMillis>
<value>215</value>
<min>0</min>
<max>4249</max>
<current>3</current>
<sum>4306</sum>
<count>20</count>
<standardDeviation>0.0</standardDeviation>
<occurrences>0</occurrences>
<useRange>true</useRange>
</metric-value>
...
</metricValues>
</metric-data>
</metric-datas>

時間範囲の使用

特定の時点間の範囲（たとえば、月曜日の午後 2:00 ～ 2:15）、または相対時間範囲など、任意の時間範囲のメトリックデータを取得できます。

メトリックデータ API メソッドに時間ベースの入力パラメータを使用して、次の表に示すように、いくつかの方法で時間範囲を指定できます。

時間範囲入力パラメータ

パラメータ名 Parameter Type 値 必須

time-range-type

[Query（クエリ）]

可能な値は以下の通りです：

  • BEFORE_NOW：duration-in-mins パラメータを指定する必要があります。
  • BEFORE_TIME：duration-in-mins パラメータと end-time パラメータを指定する必要があります。
  • AFTER_TIME：duration-in-mins パラメータと start-time パラメータを指定する必要があります。
  • BETWEEN_TIMES：start-time パラメータと end-time パラメータを指定する必要があります。[BETWEEN_TIMES] の範囲には start-time が含まれますが、end-time は除外されます。

あり

duration-in-mins

[Query（クエリ）]

メトリックデータを返す期間（分単位）。

time-range-type が BEFORE_NOW、BEFORE_TIME、または AFTER_TIME の場合

start-time

[Query（クエリ）]

UNIX エポック時間でメトリックデータが返される期間の開始時刻（ミリ秒単位）。

time-range-type が AFTER_TIME または BETWEEN_TIMES の場合

end-time

[Query（クエリ）]

UNIX エポック時間でメトリックデータが返される期間の終了時刻（ミリ秒単位）。

time-range-type が BEFORE_TIME または BETWEEN_TIMES の場合

例

このページでは、ほとんどの例で要求時間範囲に「過去 15 分」が使用されています。次の形式の例では、要求の時間範囲を定義するその他の方法を提示します。

  • 2015 年 12 月 19 日午前 5 時 40 分（GMT）以降の 15 分の時間範囲：

    ?time-range-type=AFTER_TIME&start-time=1450532400000&duration-in-mins=15

  • 2015 年 12 月 19 日午前 6 時（GMT）以前の 15 分の時間範囲：

    ?time-range-type=BEFORE_TIME&end-time=1450533600000&duration-in-mins=15

  • 2015 年 12 月 19 日午前 6 時（GMT）～ 2015 年 12 月 19 日午前 6 時 30 分（GMT）の時間範囲：

    ?time-range-type=BETWEEN_TIMES&start-time=1450533600000&end-time=1450535400000

「その他のトラフィック」ビジネス トランザクション メトリックの取得

「All Other Traffic」ビジネストランザクションは、ビジネストランザクションの登録制限に到達した後で新しいトランザクションのトラフィックを集約するビジネストランザクションのタイプです。ここでは、API URI パスに特殊な識別子、_APPDYNAMICS_DEFAULT_TX_ を使用します。「ビジネストランザクション」を参照してください。

次に、「」ビジネストランザクションで使用する平均 CPU の取得例を示します。

curl --user user1@customer1:your_password "http://demo.appdynamics.com:8090/controller/rest/applications/ACME%20Book%20Store%20Application/metric-data?metric-path=Business%20Transaction%20Performance%7CBusiness%20Transactions%7CECommerce%20Server%7C_APPDYNAMICS_DEFAULT_TX_%7CAverage%20CPU%20Used%20%28ms%29&time-range-type=BEFORE_NOW&duration-in-mins=15"
<metric-datas><metric-data>
<metricId>4000</metricId>
<metricPath>Business Transaction Performance|Business Transactions|ECommerce Server|_APPDYNAMICS_DEFAULT_TX_|Average CPU 活用 (ms)</metricPath>
<metricName>BTM|BTs|BT:78|Component:12|Average CPU Used (ms)</metricName>
<frequency>ONE_MIN</frequency>
<metricValues>
<metric-value>
<startTimeInMillis>1450570800000</startTimeInMillis>
<value>22</value>
<min>0</min>
<max>50</max>
<current>20</current>
<sum>3140</sum>
<count>146</count>
<standardDeviation>0.0</standardDeviation>
<occurrences>0</occurrences>
<useRange>true</useRange>
</metric-value>
</metricValues>
</metric-data>
</metric-datas>

トランザクション スナップショットを取得する

スナップショットには、要求セグメントごとにトランザクションの詳細が含まれています。時間範囲パラメータは、メトリックを取得する場合と同じようにスナップショットで使用されます。同様に、相対時間範囲や特定の範囲を指定することもできます。 「時間範囲の使用」を参照してください。

形式

GET /controller/rest/applications/application_name/request-snapshots

入力パラメータ

パラメータ名 Parameter Type 値 必須

application_name

URI

アプリケーション名またはアプリケーション ID のいずれかを指定します。

あり

time-range-type

クエリ

可能な値は以下の通りです：

  • BEFORE_NOW：duration-in-mins パラメータを指定する必要があります。
  • BEFORE_TIME：duration-in-mins パラメータと end-time パラメータを指定する必要があります。
  • AFTER_TIME：duration-in-mins パラメータと start-time パラメータを指定する必要があります。
  • BETWEEN_TIMES：start-time パラメータと end-time パラメータを指定する必要があります。[BETWEEN_TIMES] の範囲には start-time が含まれますが、end-time は除外されます。

あり

duration-in-mins

クエリ

データを返す期間（分単位）。

time-range-type が BEFORE_NOW、BEFORE_TIME、または AFTER_TIME の場合

start-time

クエリ

データが返される期間の開始時刻（ミリ秒単位）。

time-range-type が AFTER_TIME または BETWEEN_TIMES の場合

end-time

クエリ

データが返される期間の終了時刻（ミリ秒単位）。

time-range-type が BEFORE_TIME または BETWEEN_TIMES の場合

guids

[Query（クエリ）]

トランザクション スナップショットのカンマ区切りの GUID の配列。指定されていない場合は、指定された時間範囲内のすべてのスナップショットが取得されます。

いいえ

archived

[Query（クエリ）]

アーカイブされたスナップショットを取得する場合は true。デフォルトは false です。

いいえ

deep-dive-policy

[Query（クエリ）]

適用するカンマ区切りのスナップショット ポリシー フィルタの配列。有効な値は次のとおりです。

  • SLA_FAILURE
  • TIME_SAMPLING
  • ERROR_SAMPLING
  • OCCURRENCE_SAMPLING
  • ON_DEMAND
  • APPLICATION_STARTUP
  • SLOW_DIAGNOSTIC_SESSION
  • ERROR_DIAGNOSTIC_SESSION
  • POLICY_FAILURE_DIAGNOSTIC_SESSION
  • DIAGNOSTIC_SESSION
  • INFLIGHT_SLOW_SESSION

いいえ

application-component-ids

[Query（クエリ）]

フィルタ処理するカンマ区切りの階層 ID の配列。デフォルトは、アプリケーション内のすべての階層です。

いいえ

application-component-node-ids

クエリ

カンマ区切りのノード ID フィルタの配列。デフォルトは、アプリケーション内のすべてのノードです。

いいえ

business-transaction-ids

[Query（クエリ）]

カンマ区切りのビジネストランザクション ID フィルタの配列。デフォルトは、アプリケーション内のすべてのビジネストランザクションです。

いいえ

user-experience

[Query（クエリ）]

カンマ区切りのユーザ エクスペリエンス フィルタの配列。有効な値は次のとおりです。

  • NORMAL
  • SLOW
  • VERY_SLOW
  • STALL
  • ERROR

いいえ

first-in-chain

[Query（クエリ）]

true の場合は、チェーンからの最初の要求のみを取得します。デフォルトは false です。

いいえ

need-props

[Query（クエリ）]

true の場合、次のスナップショットプロパティの値が出力に含まれます。これらの値は、data-collector-type パラメータの値に対応します。false の場合、デフォルトではこれらの値が出力で空になります。

  • errorDetails
  • errorIDs
  • httpParameters
  • businessData
  • cookies
  • httpHeaders
  • sessionKeys
  • responseHeaders
  • logMessages
  • transactionProperties
  • transactionEvents
  • dotnetProperty

いいえ

need-exit-calls

[Query（クエリ）]

true の場合は、終了コールが結果に含まれます。デフォルトは false です。

いいえ

execution-time-in-milis

[Query（クエリ）]

設定されている場合は、この値を超える実行時間を要する要求のデータのみを取得します。

いいえ

session-id

[Query（クエリ）]

設定した場合は、このセッション ID のデータのみを取得します。

いいえ

user-principal-id

[Query（クエリ）]

設定した場合は、このユーザログインのデータのみを取得します。

いいえ

error-ids

[Query（クエリ）]

フィルタ処理に使用するカンマ区切りのエラーコードの配列。デフォルトでは、すべてのエラーコードが取得されます。

いいえ

starting-request-id、ending-request-id

[Query（クエリ）]

設定した場合は、この要求 ID の範囲に対するデータのみ取得します。

いいえ

error-occurred

[Query（クエリ）]

true の場合は、エラーリクエストのみを取得します。デフォルトは false です。

いいえ

diagnostic-snapshot

[Query（クエリ）]

true の場合は、診断スナップショットのみを取得します。デフォルトは false です。

いいえ

bad-request

[Query（クエリ）]

true の場合は、遅延およびエラーリクエストのみを取得します。デフォルトは false です。

いいえ

diagnostic-session-guid

[Query（クエリ）]

フィルタ処理するカンマ区切りの診断セッション GUID の配列。

いいえ

data-collector-name

[Query（クエリ）]

data-collector-value とともに使用され、データコレクタの値に基づいてスナップショット収集をフィルタ処理します。

いいえ

data-collector-value

[Query（クエリ）]

data-collector-name とともに使用され、データコレクタの値に基づいてスナップショット収集をフィルタ処理します。

data-collector-name が設定されている場合。

data-collector-type

[Query（クエリ）]

data-collector-name および data-collector-value とともに使用され、データコレクタの値に基づいてスナップショット収集をフィルタ処理します。一部の値にはスペースが含まれています。すべての値で大文字と小文字が区別され、スペースが必要な場所が示されています。有効な値は次のとおりです。

  • Error IDs
  • Stack Traces
  • Error Detail
  • Http Parameter
  • Business Data（このタイプはメソッド呼び出しのデータコレクタです）。
  • Cookie
  • Http Header
  • Session Key
  • Response Header
  • Log Message
  • Transaction Property
  • Transaction Event
  • Dotnet Property
  • isProtoBuf
  • EUM Request GUID

出力

クエリ

出力形式を変更するために URL の一部として含まれている HTTP リクエストパラメータ。有効な値は XML（デフォルト）または JSON です。

いいえ
maximum-results [Query（クエリ）] 指定されている場合、この数値が返される最大結果数となります。指定されていない場合は、最大でデフォルト値である 600 件の結果が返される可能性があります。 いいえ

例

  • ACME Book Store のトランザクション スナップショットのリストを取得します。

    /controller/rest/applications/ECommerce_E2E-Fulfillment/request-snapshots?time-range-type=BEFORE_NOW&duration-in-mins=5
    詳細な例： 
    curl --user user1@customer1:your_password "http://demo.appdynamics.com/controller/rest/applications/ECommerce_E2E-Fulfillment/request-snapshots?time-range-type=BEFORE_NOW&duration-in-mins=5"
<request-segment-datas><request-segment-data>
<id>0</id>
<archived>false</archived>
<requestGUID>18a9ae17-33a8-4d24-b3fa-558fe42b98b5</requestGUID>
<businessTransactionId>113</businessTransactionId>
<applicationId>8</applicationId>
<applicationComponentId>14</applicationComponentId>
<applicationComponentNodeId>13</applicationComponentNodeId>
<async>false</async>
<threadID>58</threadID>
<threadName>http-nio-8080-exec-8</threadName>
<localStartTime>1450574075422</localStartTime>
<serverStartTime>1450574075422</serverStartTime>
<firstInChain>true</firstInChain>
<callChain>Component:14</callChain>
<localID>0</localID>
<errorOccured>false</errorOccured>
<hasDeepDiveData>true</hasDeepDiveData>
<userExperience>NORMAL</userExperience>
<timeTakenInMilliSecs>3693</timeTakenInMilliSecs>
<cpuTimeTakenInMilliSecs>19</cpuTimeTakenInMilliSecs>
<warningThreshold>5318 ms. 3.0x of standard deviation [453.7 ms] for moving average [3956.8 ms] (minimum baseline: 200 ms) for the last 11617 minutes.</warningThreshold>
<criticalThreshold>5772 ms. 4.0x of standard deviation [453.7 ms] for moving average [3956.8 ms] (minimum baseline: 600 ms) for the last 11617 minutes.</criticalThreshold>
<summary>Scheduled Snapshots: one every 10 minutes.</summary>
<errorSummary></errorSummary>
<diagnosticSessionGUID></diagnosticSessionGUID>
<deepDivePolicy>TIME_SAMPLING</deepDivePolicy>
<delayedDeepDive>false</delayedDeepDive>
<delayedDeepDiveOffSet>0</delayedDeepDiveOffSet>
<exitCallsDataTruncated>false</exitCallsDataTruncated>
<URL>/appdynamicspilot/rest/fulfillment</URL>
<errorIDs/>
<errorDetails/>
<httpParameters/>
<businessData/>
<cookies/>
<httpHeaders/>
<sessionKeys/>
<responseHeaders/>
<logMessages/>
<transactionProperties/>
<transactionEvents/>
<unresolvedCallInCallChain>false</unresolvedCallInCallChain>
<dotnetProperty/>
<endToEndLatency>-1</endToEndLatency>
</request-segment-data>
...
<request-segment-data>
<id>0</id>
<archived>false</archived>
<requestGUID>bfce5066-2409-4a4b-a869-6afcc06614d6</requestGUID>
<businessTransactionId>113</businessTransactionId>
<applicationId>8</applicationId>
<applicationComponentId>14</applicationComponentId>
<applicationComponentNodeId>13</applicationComponentNodeId>
<async>false</async>
<threadID>60</threadID>
<threadName>http-nio-8080-exec-10</threadName>
<localStartTime>1450574082926</localStartTime>
<serverStartTime>1450574082926</serverStartTime>
<firstInChain>true</firstInChain>
<callChain>Component:14</callChain>
<localID>0</localID>
<errorOccured>false</errorOccured>
<hasDeepDiveData>true</hasDeepDiveData>
<userExperience>NORMAL</userExperience>
<timeTakenInMilliSecs>3634</timeTakenInMilliSecs>
<cpuTimeTakenInMilliSecs>16</cpuTimeTakenInMilliSecs>
<warningThreshold>5318 ms. 3.0x of standard deviation [453.7 ms] for moving average [3956.8 ms] (minimum baseline: 200 ms) for the last 11617 minutes.</warningThreshold>
<criticalThreshold>5772 ms. 4.0x of standard deviation [453.7 ms] for moving average [3956.8 ms] (minimum baseline: 600 ms) for the last 11617 minutes.</criticalThreshold>
<summary>[null]</summary>
<errorSummary></errorSummary>
<diagnosticSessionGUID></diagnosticSessionGUID>
<deepDivePolicy>CROSS_APP_POLICY</deepDivePolicy>
<delayedDeepDive>false</delayedDeepDive>
<delayedDeepDiveOffSet>0</delayedDeepDiveOffSet>
<exitCallsDataTruncated>false</exitCallsDataTruncated>
<URL>/appdynamicspilot/rest/fulfillment</URL>
<errorIDs/>
<errorDetails/>
<httpParameters/>
<businessData/>
<cookies/>
<httpHeaders/>
<sessionKeys/>
<responseHeaders/>
<logMessages/>
<transactionProperties/>
<transactionEvents/>
<unresolvedCallInCallChain>false</unresolvedCallInCallChain>
<dotnetProperty/>
<endToEndLatency>-1</endToEndLatency>
</request-segment-data>
</request-segment-datas>

  • HTTP パラメータ データ コレクタに関連付けられているスナップショットフィールドを含む、トランザクション スナップショットのリストを取得します。

    /controller/rest/applications/ECommerce_E2E-Fulfillment/request-snapshots?time-range-type=BEFORE_NOW&duration-in-mins=5&data-collector-type=Http Parameter&data-collector-name=param1&data-collector-value=%5B100%5D&need-props=true
    詳細な例： 
    curl --user user1@customer1:your_password "http://demo.appdynamics.com/controller/rest/applications/ECommerce_E2E-Fulfillment/request-snapshots?time-range-type=BEFORE_NOW&duration-in-mins=5&data-collector-type=Http%20Parameter&data-collector-name=param1&data-collector-value=%5B100%5D&need-props=true"
<request-segment-datas><request-segment-data>
<id>0</id>
<archived>false</archived>
<requestGUID>07532d68-42b8-4a79-877a-dedf2912a2cf</requestGUID>
<businessTransactionId>128</businessTransactionId>
<applicationId>2</applicationId>
<applicationComponentId>5</applicationComponentId>
<applicationComponentNodeId>4</applicationComponentNodeId>
<async>false</async>
<threadID>60</threadID>
<threadName>http-8000-Processor24</threadName>
<localStartTime>1389164292752</localStartTime>
<serverStartTime>1389164292752</serverStartTime>
<firstInChain>true</firstInChain>
<callChain>Component:5</callChain>
<localID>0</localID>
<errorOccured>true</errorOccured>
<hasDeepDiveData>true</hasDeepDiveData>
<userExperience>ERROR</userExperience>
<timeTakenInMilliSecs>105</timeTakenInMilliSecs>
<cpuTimeTakenInMilliSecs>3839000</cpuTimeTakenInMilliSecs>
<summary>[Manual Diagnostic Session] - org.hibernate.util.JDBCExceptionReporter : Cannot create PoolableConnectionFactory (Unknown database 'appdy') </summary>
<errorSummary/>
<diagnosticSessionGUID>d70a41d9-a96f-46e8-9fbc-31061c6e452f</diagnosticSessionGUID>
<deepDivePolicy>ON_DEMAND</deepDivePolicy>
<delayedDeepDive>false</delayedDeepDive>
<delayedDeepDiveOffSet>0</delayedDeepDiveOffSet>
<exitCallsDataTruncated>false</exitCallsDataTruncated>
<URL>/appdynamicspilot/1.bookslist</URL>
<httpSessionID>088B2A2DD0EF77424DD0EB3346A441F9</httpSessionID>
<errorIDs>
<long>29</long>
</errorIDs>
<errorDetails>
<name-value>
<id>0</id>
<name>1. org.hibernate.util.JDBCExceptionReporter</name>
<value>org.hibernate.util.JDBCExceptionReporter : Cannot create PoolableConnectionFactory (Unknown database 'appdy')</value>
</name-value>
</errorDetails>
<httpParameters>
<name-value>
<id>0</id>
<name>param1</name>
<value>[100]</value>
</name-value>
</httpParameters>
<businessData/>
<cookies/>
<httpHeaders/>
<sessionKeys/>
<responseHeaders/>
<logMessages/>
<transactionProperties>
<name-value>
<id>0</id>
<name>Servlet URI</name>
<value>/appdynamicspilot/WEB-INF/presentation/bookslist.jsp</value>
</name-value>
<name-value>
<id>0</id>
<name>ProcessID</name>
<value>65331</value>
</name-value>
</transactionProperties>
<transactionEvents/>
<unresolvedCallInCallChain>false</unresolvedCallInCallChain>
<dotnetProperty/>
</request-segment-data></request-segment-datas>

Retrieve Controller Audit History

The Controller audit history is a record of the configuration and user activities in the Controller configuration. The ControllerAuditHistory API method returns the audit log for the time range specified. The output format can be JSON or CSV. This information is the same as that found in the audit.log file.

See SaaS Deployment Audit log.

Format

GET /controller/ ControllerAuditHistory?startTime=<start-time>&endTime=<end-time>&include=<field>:<value>&exclude=<field>:<value>

Input parameters

Parameter Name Parameter Type Value Mandatory

start-time

Query

Start time in the format: yyyy-MM-dd'T'HH:mm:ss.SSSZ

Yes

end-time

Query

End time in the format: yyyy-MM-dd'T'HH:mm:ss.SSSZ

Yes
time-zone-id Query Time zone No
include Query Restricted information in the Controller audit history No
exclude Query Restricted information in the Controller audit history No
  • To control the size of the output, the range between the start-time and end-time cannot exceed 24 hours. For periods longer than 24 hours, use multiple queries with consecutive time parameters.
  • Multiple filters of the same type are allowed.
    • The backend API treats included filters with the same < field > with relationship OR
    • Filters with different < field > with relationship AND . There is no direct interaction between include and exclude filters.
  • Each filter needs to be a parameter, e.g. include=filterName1:filterValue1&include=filterName2:filterValue2 . See the below examples:
http://localhost:8080/controller/ControllerAuditHistory?startTime=yyyy-MM-dd&HH:mm:ss.SSSZ&endTime=yyyy-MM-dd&HH:mm:ss.SSSZ?include=filterName1:filterValue1&include=filterName1:filterValue1&exclude=filterName1:filterValue1&exclude=filterName1:filterValue1

アカウントごとにメトリックの保持期間を設定する

アカウントに基づいて、古いメトリックを 1 日に 1 回消去するようにコントローラを設定できます。

  • 古いメトリックとは、設定された日数を基に新しいデータが報告されなかったメトリックを指します。
  • これにより、3 日を経過した EUM および SIM メトリックのみが削除されます。
これは
重要: このオプションを設定するには、コントローラの所有者である必要があります。SaaS のお客様はこの API を使用できません。

形式

 POST /controller/api/accounts/<account_id>/metricstaleduration/<number_of_days>

入力パラメータ

パラメータ名 Parameter Type 値
account_id URI アカウント ID。
number_of_days 整数 古いメトリックを保持する日数。

例

警告: root@system は SaaS オペレーションズチームが所有しているため、SaaS のお客様はこの API を使用できません。 
curl -X POST -u root@system:your_password "http://demo.appdynamics.com:8090/controller/api/accounts/2/metricstaleduration/3"

アプリケーションごとにメトリックの保持期間を設定する

アプリケーションに基づいて、古いメトリックを 1 日に 1 回消去するようにコントローラを設定できます。

  • 古いメトリックとは、設定された日数を基に新しいデータが報告されなかったメトリックを指します。
  • これにより、3 日を経過した EUM および SIM メトリックのみが削除されます。

このオプションを設定するには、管理者権限以上の権限が必要です。

形式

POST /controller/api/accounts/<account_id>/applications/<application_name>/metricstaleduration/<number_of_days>

入力パラメータ

パラメータ名 Parameter Type 値
account_id URI アカウント ID。
application_id URI アプリケーション ID。
number_of_days 整数 古いメトリックを保持する日数。

例

curl -X POST -u user1@customer1:your_password "http://demo.appdynamics.com:8090/controller/api/accounts/2/applications/12/metricstaleduration/3"