Download PDF
Download page メトリックとスナップショット API.
メトリックとスナップショット API
On this page:
コントローラメトリックとイベント API を使用すると、メトリックデータ情報や、モニタリング対象環境のさまざまなタイプのアクティビティに関する情報(コントローラのイベントなど)を取得できるようになります。さらに、メトリックを保持する期間を設定することもできます。
AppDynamics Dexter(Data Extraction and Enhanced Reporting)拡張機能は、REST クライアントを使用してメトリックデータを取得するための代替手段を提供します。このツールによって、AppDynamics がデータウェアハウスのような方法でクエリできるようになります。詳細については、AppDynamics Community Exchange の拡張機能に関するページを参照してください。
メトリック階層を取得する
メトリックツリー構造に関する情報を返します。子要素がコンテナ項目の場合、応答ではその type
値が folder
になります。それ以外の場合は、子要素の type
タグが leaf
になります。
API は、子要素の第 1 世代を取得します。子のフォルダタイプのみを展開できます。
形式
GET /controller/rest/applications/application_name/metrics
入力パラメータ
Parameter Name | Parameter Type | Value | Mandatory |
---|---|---|---|
application_name | URI | ビジネスアプリケーションや EUM(ブラウザ、モバイル、IoT)アプリケーションの名前または ID。アプリケーションモデル API でアプリケーション ID を取得するには、コールを使用します。 | あり |
出力 | [Query(クエリ)] | 出力形式を変更するために URL の一部として含まれている HTTP リクエストパラメータ。 | なし |
例
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 を使用することです。メトリックブラウザでメトリックを右クリックすると、メトリックの完全な REST URL をコピーするためのメニューオプションが表示されます。コピーした URL には、このメトリックと UI で選択した時間範囲へのパスが含まれています。
また、多くの Web ブラウザのように、特定のクライアントでは、フルパスの値をメトリックパスパラメータとして受け入れ、適切にエンコードすることもできます。ツリー内のメトリックの上にカーソルを合わせてフルパスを確認するか、右クリックメニューの Copy Full Path オプションを使用してパスをコピーできます。わかりやすくするために、以下の特定の例は完全にエンコードされた URL 値ではなく、フルパスの値で示されています。フルパスを使用してコールをテストする場合は、パスの先頭または末尾にパイプ文字が表示されないようにしてください。
以下のセクションでは、メトリックデータメソッドの詳細情報と例について説明します。
形式
GET /controller/rest/applications/application_name/metric-data
入力パラメータ
Parameter Name | Parameter Type | Value | Mandatory |
---|---|---|---|
metric-path | [Query(クエリ)] | メトリック階層内のメトリックへのパス。 | あり |
rollup | [Query(クエリ)] | デフォルトでは、返されるメトリックの値が 1 つのデータポイントにロールアップされます(rollup = true)。時間範囲内のすべての値に対して別々の結果を取得するには、クエリでロールアップパラメータを 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>
メトリック応答値
メトリックの結果には、次のフィールドが含まれます。
名前 | 定義 |
---|---|
電流 | その時点(1 分間)における値。コントローラで使用されている時間ロールアップタイプが最新の場合にのみ使用されます。 |
count | 選択した期間にエージェントがメトリックを収集した回数。 |
min、max | 指定した期間に報告された最小値と最大値。これらは、すべてのメトリックタイプに使用されるわけではありません。 |
回 | 標準偏差を計算するためにコントローラによって取得されたデータサンプルの数。 |
standardDeviation | 時間ロールアップを標準偏差の計算に使用している間に、コントローラによって計算された中間値。この値の計算方法については、動的ベースラインを参照してください。 |
startTimeInMillis | StartTimeInMillis は、UNIX エポック時間で結果のメトリックデータが適用される時間範囲の開始時刻です。 |
サム | 選択した期間におけるメトリックの累積値の合計。 |
useRange | メトリックを処理するために、コントローラによって内部で使用されます。 |
の値を入力します。 | 「value」値は、設定された評価時間全体について報告されるすべてのメトリック値のうち、次のいずれかの値を指します。
|
メトリックが 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>
ロールアップを無効にしてメトリックデータを呼び出すと、大量の結果が発生する可能性があります。
メトリックデータメソッドで返すことのできるデータの量には制限がありますので、十分にご注意ください。最大結果数は 200 メトリックです。
時間範囲の使用
特定の時点間の範囲(たとえば、月曜日の午後 2:00 ~ 2:15)、または相対時間範囲(過去 15 分)など、任意の時間範囲のメトリックデータを取得できます。
メトリックデータ API メソッドに時間ベースの入力パラメータを使用して、次の表に示すように、いくつかの方法で時間範囲を指定できます。
時間範囲入力パラメータ
Parameter Name | Parameter Type | Value | Mandatory |
---|---|---|---|
time-range-type | [Query(クエリ)] | 次の値が使用できます。
| あり |
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
「その他のトラフィック」ビジネス トランザクション メトリックの取得
「その他のトラフィック」ビジネストランザクションは、ビジネストランザクションの登録制限に到達した後で新しいトランザクションのトラフィックを集約するビジネストランザクションのタイプです。「その他のトラフィック」ビジネストランザクションの詳細については、「ビジネストランザクション」を参照してください。
「その他のトラフィック」ビジネストランザクションでは、API URI パスで特別な ID を使用します(_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 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(クエリ)] | 次の値が使用できます。
| あり | |
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(クエリ)] | 適用するカンマ区切りのスナップショット ポリシー フィルタの配列。有効な値は以下のとおりです。
| なし | |
application-component-ids | [Query(クエリ)] | フィルタ処理するカンマ区切りの階層 ID の配列。デフォルトは、アプリケーション内のすべての階層です。 | なし | |
application-component-node-ids | [Query(クエリ)] | カンマ区切りのノード ID フィルタの配列。デフォルトは、アプリケーション内のすべてのノードです。 | なし | |
business-transaction-ids | [Query(クエリ)] | カンマ区切りのビジネストランザクション ID フィルタの配列。デフォルトは、アプリケーション内のすべてのビジネストランザクションです。 | なし | |
user-experience | [Query(クエリ)] | カンマ区切りのユーザ エクスペリエンス フィルタの配列。有効な値は以下のとおりです。
| なし | |
first-in-chain | [Query(クエリ)] | true の場合は、チェーンからの最初の要求のみを取得します。デフォルトは false です。 | なし | |
need-props | [Query(クエリ)] | true の場合、次のスナップショットプロパティの値が出力に含まれます。これらの値は、data-collector-type パラメータの値に対応します。false の場合、デフォルトではこれらの値が出力で空になります。
| なし | |
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 とともに使用され、データコレクタの値に基づいてスナップショット収集をフィルタリングします。一部の値にはスペースが含まれています。すべての値で大文字と小文字が区別され、スペースが必要な場所が示されています。有効な値は次のとおりです。
| ||
出力 | [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
ファイルに記載されている内容と同じです。詳細については、「プラットフォームログファイル」を参照してください。
形式
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%27T%27HH:mm:ss.SSSZ&endTime=yyyy-MM-dd%27T%27HH:mm:ss.SSSZ?include=filterName1:filterValue1&include=filterName1:filterValue1&exclude=filterName1:filterValue1&exclude=filterName1:filterValue1
http://localhost:8080/controller/ControllerAuditHistory?startTime=yyyy-MM-dd%27T%27HH:mm:ss.SSSZ&endTime=yyyy-MM-dd%27T%27HH: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_id | URI | アカウント 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_id | URI | アカウント ID。 |
application_id | URI | アプリケーション 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"