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

AppDynamics Dexter(Data Extraction and Enhanced Reporting; DEXTER)拡張機能は、REST クライアントを使用してメトリックデータを取得するための代替手段を提供します。これにより、AppDynamics がデータウェアハウスのような方法でデータをクエリできるようになります。

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

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

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

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


形式

GET /controller/rest/applications/application_name/metrics

入力パラメータ

Parameter Name

Parameter Type

Value

Mandatory

application_name

URI

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

あり

output

[Query(クエリ)]

出力形式を変更するために 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. ツリー内のメトリックの上にカーソルを合わせて、右クリックメニューの [Copy Full Path] オプションを使用してパスをコピーできます。 

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

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

形式

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

入力パラメータ

Parameter Name

Parameter Type

Value

Mandatory

metric-path[Query(クエリ)]

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

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

あり

rollup

[Query(クエリ)]

デフォルトでは、返されるメトリックの値が 1 つのデータポイントにロールアップされます(rollup=true)。時間範囲内のすべての値に対して別々の結果を取得するには、クエリで Rollup パラメータを false に設定します。

なし

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

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

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>

メトリック応答値

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

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

メトリックが 1 時間ごと、または 1 日ごとのデータポイントにロールアップされる場合を除き、count ベースまたは sum ベースのメトリックでは min および max の値を使用できません。これらのメトリックには、1 分あたりのエラー数、1 分あたりのコール数などが含まれます。

ワイルドカードの使用

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

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

  • 階層名にワイルドカードを使用して、アプリケーション内のすべての階層の app agent availability time を取得します。

    /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-コマース階層にあるすべてのビジネストランザクションの Calls per Minute メトリックを取得します。

    /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 Name

Parameter Type

Value

Mandatory

time-range-type

[Query(クエリ)]

次の値が使用できます。

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

あり

duration-in-mins

[Query(クエリ)]

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

time-range-type が BEFORE_NOWBEFORE_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_ を使用します。詳細については、ビジネストランザクションを参照してください。

次に、「All Other Traffic」ビジネストランザクションで使用する平均 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 Used (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 Name

Parameter Type

Value

必須

application_name

URI

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

あり

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(クエリ)]

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

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

end-time

[Query(クエリ)]

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

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

[Query(クエリ)]

カンマ区切りのノード 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

output

[Query(クエリ)]

出力形式を変更するために 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>

コントローラの監査履歴を取得する

コントローラの監査履歴は、コントローラの構成の設定とユーザアクティビティのレコードです。ControllerAuditHistory API メソッドは、指定した時間範囲の監査ログを返します。出力形式は JSON または CSV です。この情報は、audit.log ファイルに記載されている内容と同じです。「Platform Log Files」および「プラットフォーム別のログファイル情報」を参照してください。

形式

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

入力パラメータ

Parameter Name

Parameter Type

Value

必須

start-time

[Query(クエリ)]

yyyy-MM-dd'T'HH:mm:ss.SSSZ 形式の開始時刻

あり

end-time

[Query(クエリ)]

yyyy-MM-dd'T'HH:mm:ss.SSSZ 形式の終了時刻

あり

time-zone-id[Query(クエリ)]Time zoneいいえ
include[Query(クエリ)]コントローラの監査履歴の制限付き情報いいえ
exclude[Query(クエリ)]コントローラの監査履歴の制限付き情報なし
  • 出力のサイズを制御するには、start-time から end-time までの範囲が 24 時間を超えないようにします。24 時間よりも長くなる場合は、連続する時間パラメータで複数のクエリを使用します。
  • 同じタイプの複数のフィルタが許可されます。 
    • バックエンド API は、含まれるフィルタを、リレーションシップ OR と同じ <field> で処理します。
    • リレーションシップ AND とは異なる <field> でフィルタ処理します。include フィルタと exclude フィルタが直接連携することはありません。
  • 各フィルタはパラメータにする必要があります(例: include=filterName1:filterValue1&include=filterName2:filterValue2)。以下の例を参照してください。
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
curl --user user1@customer1:welcome "http://demo.appdynamics.com:8090/controller/ControllerAuditHistory?startTime=2015-12-19T10:50:03.607-0700&endTime=2015-12-19T17:50:03.607-0700&timeZoneId=America%2FSan%20Francisco&include=userName:user1&include=action:LOGIN&exclude=accountName:system&exclude=action:OBJECT_UPDATE"
  
[{"timeStamp":1450569821811,"auditDateTime":"2015-12-20T00:03:41.811+0000","accountName":"customer1","securityProviderType":"INTERNAL","userName":"user1","action":"LOGIN"},{"timeStamp":1450570234518,"auditDateTime":"2015-12-20T00:10:34.518+0000","accountName":"customer1","securityProviderType":"INTERNAL","userName":"user1","action":"LOGIN"},{"timeStamp":1450570273841,"auditDateTime":"2015-12-20T00:11:13.841+0000","accountName":"customer1","securityProviderType":"INTERNAL","userName":"user1","action":"OBJECT_CREATED","objectType":"AGENT_CONFIGURATION"},
...
{"timeStamp":1450570675345,"auditDateTime":"2015-12-20T00:17:55.345+0000","accountName":"customer1","securityProviderType":"INTERNAL","userName":"user1","action":"OBJECT_DELETED","objectType":"BUSINESS_TRANSACTION"},{"timeStamp":1450570719240,"auditDateTime":"2015-12-20T00:18:39.240+0000","accountName":"customer1","securityProviderType":"INTERNAL","userName":"user1","action":"APP_CONFIGURATION","objectType":"APPLICATION","objectName":"ACME Book Store Application"},{"timeStamp":1450571834835,"auditDateTime":"2015-12-20T00:37:14.835+0000","accountName":"customer1","securityProviderType":"INTERNAL","userName":"user1","action
 
curl --user user1@customer1:welcome "http://127.0.0.1:8080/controller/ControllerAuditHistory?startTime=2019-05-28T08:00:03.607-0700&endTime=2019-05-28T11:32:03.607-0700&timeZoneId=America%2FSan%20Francisco&include=applicationName:ACME"
[{"timeStamp":1559066415823,"auditDateTime":"2019-05-28T18:00:15.823+0000","accountName":"customer1","securityProviderType":"INTERNAL","userName":"user1","action":"LOGIN","objectId":0,"applicationName":"ACME"}]

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

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

  • 古いメトリックとは、設定された日数を基に新しいデータが報告されなかったメトリックを指します。 
  • これにより、3 日を経過した EUM および SIM メトリックのみが削除されます。
このオプションを設定するには、アカウント所有者である必要があります。


形態

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

入力パラメータ

パラメータ名Parameter Type
account_idURIアカウント ID。
number_of_days整数型(Integer)古いメトリックを保持する日数。

curl -X POST -u user1@customer1: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_idURIアカウント ID。
application_idURIアプリケーション ID。
number_of_days整数型(Integer)古いメトリックを保持する日数。

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