Metric and Snapshot API

The Controller Metrics and Events API allows you to retrieve metric data information and information on various types of activities in your monitored environment, including Controller events. Additionally, you can configure how long you retain metrics.

The AppDynamics Dexter Data Extraction Enhanced Reporting extension provides an alternative to using a REST client to get metric data. The tool makes AppDynamics data queryable in the manner of a data warehouse. See the extension page on the AppDynamics Community Exchange for more information.

Retrieve Metric Hierarchy

Returns information about the metric tree structure. The API retrieves first generation of child elements and so you can expand only the children of the folder type. If in the response, a child element is a container item, its type value is folder. Otherwise, the type tag for the child element is leaf. One can recurse the metric tree structure further, by using the metric-path parameter. Metric-path can be constructed in the same way as described in the metric data api below.

Format

GET /controller/rest/applications/application_name/metrics

Input parameters

Parameter Name	Parameter Type	Value	Mandatory
application_name	URI	The name or ID of the business or EUM (browser/mobile/IoT) application. Use the call to get the application ID in the Application Model API.	Yes
output	Query	HTTP Request parameter included as part of the URL to change the output format. Valid values are "XML" (default) or "JSON".	No
metric-path	Query	The path to the metric in the metric hierarchy.	No

Example

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>

Retrieve Metric Data

The metric data method lets you get values generated for metrics. To use the method, you need to specify these parameters to the API:

The path of the metric to retrieve.
The time frame for the data.

The easiest way to learn how to construct the metric path and time range-related parameters is by using the Controller UI. When you right-click on the metric in the Metric Browser, a menu option appears for copying the full REST URL for the metric. The copied URL includes the path to this metric and time range selected in the UI.

Certain clients, such as most web browser, can also accept and properly encode the full path value as the metric path parameter. You can see the full path by hovering over the metric in the tree or copy it using the Copy Full Path option in the right-click menu. For reading clarity, certain examples below are shown with the full path value rather than the fully encoded URL value. If you test calls with the full path yourself, be sure to avoid having a pipe character appear at the start or end of the path.

The following sections provide additional details and examples for the metric data method:

Metric Response Values
Using Wildcards
Using Time Ranges
Retrieving All Other Traffic Business Transaction Metrics

Format

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

Input Parameters

Parameter Name	Parameter Type	Value	Mandatory
metric-path	Query	The path to the metric in the metric hierarchy.	Yes
rollup	Query	By default, the values of the returned metrics are rolled up into a single data point (rollup=true). To get separate results for all values within the time range, set the rollup parameter to false in the query.	No

Additional mandatory parameters for specifying time ranges are described in Using Time Ranges.

Example

Retrieve metric values for a metric at an absolute path:

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>

Metric Response Values

Metrics results include the following fields:

Name	Definition
current	Value for the current minute. Used only when the time rollup type used by the Controller is current.
count	Number of times the agent collected the metric over the selected time period.
min, max	The minimum and maximum values reported across the selected time period. These are not used for all metric types.
occurrences	Number of data samples taken by the Controller to calculate the standard deviation.
standardDeviation	Intermediate values calculated by the Controller during time rollup used to calculate standard deviation. See Dynamic Baselines for information on how this value is calculated.
startTimeInMillis	The startTimeInMillis is the start time of the time range to which the result metric data applies, in UNIX epoch time.
sum	Total accumulated value for the metric over the selected time period.
useRange	Used internally by the Controller to process the metric.
value	The "value" value is one of the following for all metric values reported across the configured evaluation time length: arithmetic average, if the metric time rollup type is average sum, if the metric time rollup type is sum latest, if the metric time rollup type is current

min and max values are not available for any count- or sum-based metric except when the metric is rolled up to hourly or daily data points. Count- and sum-based metrics include errors per minute, calls per minute, and so on.

Using Wildcards

When you copy the REST URL in the Metric Browser, you get the path to a specific metric within a specific application and tier. Alternatively, you can use wildcard characters in one or more the steps in the URL path get metric data for entities, including multiple business transactions, tiers, or nodes.

The following format examples show where to put wildcard characters in various metric paths to achieve particular results. For reading clarity, these format examples use the "full path" for the metric (rather than the REST URL). For a full working example, click the expanding link under each format listing:

Retrieve the app agent availability time for all tiers in the application using a wildcard for the tier name:

/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

Click to view a full example...

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>

Retrieve the CPU % Busy metric for all the nodes in all tiers using a wildcard for the tier and node names:

/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

Click to view a full example...

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>

Retrieve the Calls per Minute metric for all the business transactions on the ECommerce tier using a wildcard for the business transaction name:

/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

Click to view a full example...

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>

Retrieve data for multiple metrics for the ViewCart.addToCart transaction on the ECommerce-Services server:

/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

Click to view a full example...

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>

Disabling Data Rollup

By default, metric data is rolled up for the time frame you request. You can set the rollup parameter to false to get all data points within the time frame. For example:

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>

Calling metric data with rollups disabled can result in a considerable number of results.

It is important to note that a limit exists on the amount of data that can be returned for the metric data method. The maximum result is 200 metrics.

Using Time Ranges

You can fetch metric data for any time range, including for a range between specific points (for example, from 2:00 to 2:15 pm Monday) or for a relative time range (the last 15 minutes).

Time-based input parameters for the metric data API method let you specify a time range in several ways, as described in the following table.

Time Range Input Parameters

Parameter Name	Parameter Type	Value	Mandatory
time-range-type	Query	Possible values are: BEFORE_NOW: To use this value, you must also specify the "duration-in-mins" parameter. BEFORE_TIME: To use this value, you must also specify the "duration-in-mins" and "end-time" parameters. AFTER_TIME: To use this value, you must also specify the "duration-in-mins" and "start-time" parameters. BETWEEN_TIMES: To use this value, you must also specify the "start-time" and "end-time" parameters. The "BETWEEN_TIMES" range includes the start- time and excludes the end-time.	Yes
duration-in-mins	Query	Duration (in minutes) to return the metric data.	If time-range-type is BEFORE_NOW, BEFORE_TIME, or AFTER_TIME
start-time	Query	Start time (in milliseconds) from which the metric data is returned in UNIX epoch time.	If time-range-type is AFTER_TIME or BETWEEN_TIMES
end-time	Query	End time (in milliseconds) until which the metric data is returned in UNIX epoch time.	If time-range-type is BEFORE_TIME or BETWEEN_TIMES

Examples

Most examples on this page use the past 15 minutes as the request time range. The following format examples show other ways you can define the time range for the request.

Time range of the 15 minutes after December 19, 2015 5:40:00 AM GMT:

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

Time range of the 15 minutes before December 19, 2015 6:00:00 AM GMT.

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

Time range between December 19, 2015 6:00:00 AM GMT and December 19, 2015 6:30:00 AM GMT:
```
?time-range-type=BETWEEN_TIMES&start-time=1450533600000&end-time=1450535400000
```

Retrieving All Other Traffic Business Transaction Metrics

The All Other Traffic business transaction is a type of business transaction that aggregates traffic for new transactions once the business transaction registration limits are reached. See Business Transactions for more about the All Other Traffic business transactions.

The All Other Traffic business transaction uses a special identifier in API URI paths, _APPDYNAMICS_DEFAULT_TX_ The following example shows an example of retrieving the average CPU used by the All Other Traffic business transaction:

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>

Retrieve Transaction Snapshots

Snapshots contain details on transactions, by request segment. The time range parameters are the same for snapshots as for retrieving metrics. You can similarly specify a relative time range or a specific range. See Using Time Ranges for more information on using time range parameters.

Format

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

Input parameters

Parameter Name	Parameter Type	Value	Mandatory
application_name	URI	Provide either the application name or application id.	Yes
time-range-type	Query	Possible values are: BEFORE_NOW: To use this value, you must also specify the "duration-in-mins" parameter. BEFORE_TIME: To use this value, you must also specify the "duration-in-mins" and "end-time" parameters. AFTER_TIME: To use this value, you must also specify the "duration-in-mins" and "start-time" parameters. BETWEEN_TIMES: To use this value, you must also specify the "start-time" and "end-time" parameters. The "BETWEEN_TIMES" range includes the start- time and excludes the end-time.	Yes
duration-in-mins	Query	Duration (in minutes) to return the data.	If time-range-type is BEFORE_NOW, BEFORE_TIME, or AFTER_TIME
start-time	Query	Start time (in milliseconds) from which the data is returned.	If time-range-type is AFTER_TIME or BETWEEN_TIMES
end-time	Query	End time (in milliseconds) until which the data is returned.	If time-range-type is BEFORE_TIME or BETWEEN_TIMES
guids	Query	Array of comma-separated guids for the transaction snapshots. If not specified, retrieves all snapshots in the specified time range.	No
archived	Query	True to retrieve archived snapshots. Default is false.	No
deep-dive-policy	Query	Array of comma-separated snapshot policy filters to apply. Valid values are: 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	No
application-component-ids	Query	Array of comma-separated tier IDs to filter. Default is all the tiers in the application.	No
application-component-node-ids	Query	Array of comma-separated node ID filters. Default is all the nodes in the application	No
business-transaction-ids	Query	Array of comma-separated business transaction ID filters. Default is all the business transactions in the application.	No
user-experience	Query	Array of comma-separated user experiences filters. Valid values are: NORMAL SLOW VERY_SLOW STALL ERROR	No
first-in-chain	Query	If true, retrieve only the first request from the chain. Default is false.	No
need-props	Query	If true, the values of the following snapshot properties are included in the output. These values correspond to the values of the data-collector-type parameter. If false, the default, these values are empty in the output. errorDetails errorIDs httpParameters businessData cookies httpHeaders sessionKeys responseHeaders logMessages transactionProperties transactionEvents dotnetProperty	No
need-exit-calls	Query	If true, exit calls are included in the result. Default is false.	No
execution-time-in-milis	Query	If set, retrieves only data for requests with execution times greater than this value.	No
session-id	Query	If set, retrieves data only for this session id.	No
user-principal-id	Query	If set, retrieves data only for this user login.	No
error-ids	Query	Array of comma-separated error codes to filter by. Default is to retrieve all error codes.	No
starting-request-id, ending-request-id	Query	If set, retrieves data only for this range of request IDs.	No
error-occurred	Query	If true, retrieves only error requests. Default is false.	No
diagnostic-snapshot	Query	If true, retrieves only diagnostic snapshots. Default is false.	No
bad-request	Query	If true, retrieves only slow and error requests. Default is false.	No
diagnostic-session-guid	Query	Array of comma-separated diagnostic session guids to filter.	No
data-collector-name	Query	Used with data-collector-value to filter snapshot collection based on the value of a data collector.	No
data-collector-value	Query	Used with data-collector-name to filter snapshot collection based on the value of a data collector.	If data-collector-name is set.
data-collector-type	Query	Used with data-collector-name and data-collector-value to filter snapshot collection based on the value of a data collector. Some of the values contain spaces. All are case-sensitive and where indicated the spaces are required. Valid values are: Error IDs Stack Traces Error Detail Http Parameter Business Data (This type is a method invocation data collector.) Cookie Http Header Session Key Response Header Log Message Transaction Property Transaction Event Dotnet Property isProtoBuf EUM Request GUID
output	Query	HTTP Request parameter included as part of the URL to change the output format Valid values are "XML" (default) or "JSON".	No
maximum-results	Query	A number, if specified, this number of maximum results will be returned. If not specified, default 600 results can be returned at most.	No

Examples

Retrieve list of transaction snapshots for the ACME Book Store:

/controller/rest/applications/ECommerce_E2E-Fulfillment/request-snapshots?time-range-type=BEFORE_NOW&duration-in-mins=5

Click to view full example...

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>

Retrieve list of transaction snapshots including the snapshot fields that are associated with an HTTP parameter data collector:

/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

Click to view full example...

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

Retrieve Controller Audit History

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

Format

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

Input parameters

Parameter Name	Parameter Type	Value	Mandatory
start-time	Query	Start time in the format: "yyyy-MM-dd'T'HH:mm:ss.SSSZ"	Yes
end-time	Query	End time in the format: "yyyy-MM-dd'T'HH:mm:ss.SSSZ"	Yes
time-zone-id	Query	Time zone	No
include	Query	Restricted information in the Controller audit history	No
exclude	Query	Restricted information in the Controller audit history	No

To control the size of the output, the range between the start-time and end-time cannot exceed twenty-four hours. For periods longer than 24 hours, use multiple queries with consecutive time parameters.

Multiple filters of the same type are allowed. The backend API treats include filters with the same <field> with relationship "OR", and filters with different <field> with relationship "AND". There is no direct interaction between include and exclude filters.

Each filter needs to be a parameter, e.g. include=filterName1:filterValue1&include=filterName2:filterValue2. See the below examples.

Examples

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"}]

Configure Metric Retention by Account

You can configure the Controller to purge stale metrics once a day based on account. Stale metrics are metrics that have not had new data reported based on the number of days configured. This only deletes EUM and SIM metrics that are more than two days old.

To configure this option, you must be the account owner.

Format

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

Input Parameters

Parameter Name	Parameter Type	Value
account_id	URI	The account ID.
number_of_days	Integer	The number of days you want to retain stale metrics.

Example

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

Configure Metric Retention by Application

You can configure the Controller to purge stale metrics once a day based on application. Stale metrics are metrics that have not had new data reported based on the number of days configured. This only deletes EUM and SIM metrics that are more than two days old.

To configure this option, you must have administrator permissions or higher.

Format

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

Input Parameters

Parameter Name	Parameter Type	Value
account_id	URI	The account ID.
application_id	URI	The application ID.
number_of_days	Integer	The number of days you want to retain stale metrics.

Example

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