AppDynamics Cloud uses a Token-based Ingestion model. With token-based ingestion, each license has a pool of tokens per license unit that allows you to monitor and consume licenses according to your data ingestion. AppDynamics SaaS uses both an Infrastructure-based Licensing (IBL) model and an Agent-based Licensing (ABL) model. 

You must have the Company Admin or License Admin role to view the License Management page.

Navigation Overview

You can find license usage information by navigating to Entitlements > License Management. This page provides Cloud-based and Controller-based license usage information for the current or specified usage cycle:

  • License Usage—summarizes usage within a specified anniversary periodLicense Usage.
  • License Identifier—provides a Cloud Tenant License ID or Controller Tenant License Usage ModelLicense ID.
  • License Usage Period—provides the Cloud Tenant Anniversary Period and the Controller Tenant Expiration DateLicense Usage Period.
  • Search—lets you search for a Cloud Tenant Name and Controller Tenant SubscriptionSearch.

The UI provides a list of all the Cloud Tenants associated with your account. You can hover over the Cloud Tenant License Usage data to view the percent of total tokens spent for the usage period. Drill down into the Cloud Tenant for detailed usage information.

  • Click certain column headings with Sort DescendingSort Ascending to sort the list according to that column.
  • ClickInformation(where available) to display information about the corresponding data.

License Management Overview

Access License Usage Detail

You can view the details of Cloud Tenant or Controller Tenant license usage on individual Tenants. AppDynamics captures usage data in five-minute intervals and aggregates it into larger intervals.   

The license usage details help you gauge how your application is ingesting data. You can use this information to accurately determine how many license units you typically consume or how many additional tokens you may need during a given 12-month anniversary period.

To access usage detail:

  1. Select a Tenant Name.
  2. Review the following details: 
    • Token Pool—displays the number of tokens consumed from the total number acquired. 
    • Average Daily Token Use—displays a daily average of token usage.
    • Historical Usage—provides a customizable, graphical view of token usage for a certain time range.
    • License Details—provides date, ID, retention days, and region data. 

To review Historical Usage:

The Historical Usage data graph displays the total number and percentage of tokens consumed against your total allocation during either a usage cycle or a timeframe you choose. 

  • The y-axis represents the tokens used.
  • The x-axis represents the time period.
  1. Select a graphical view optionGraphical Display Options to customize the Historical Usage data displays.
    • Total Usage—displays data in terms of number and percent of tokens used per total purchased.
    • MELT Breakdown—displays data in terms of the number and percent of metrics, events, logs, and traces that consumed the tokens in your pool.
    • Click Linear View or Logarithmic View to toggle between a linear or logarithmic scale.
    • Click Line Chart or Bar Chart to toggle between an area or bar chart. 

  2. Click Time Range Selector to use the Time Range SelectorProvisioned Tokens to adjust the period, date, time zone, and granularity of data you want to view in the graph. There are several predefined time ranges that allow you to view past cycles quickly.
    • Select Data GranularityData Granularity Dropdown to choose daily, hourly, weekly, or monthly detail.
    • Use the calendar and time tools to set specific historical ranges.
      If you select a timeframe that is too long for the aggregation, certain granularity options are not visible. 
      For example, if you choose a timeframe longer than one month, hourly granularity is disabled. 
    • Select Custom to view the timeline over several usage cycles.

  3. Hover over a data point on the graph to view granular metrics for that particular timeGraphical View Options. The dashed line represents the number of provisioned tokensNumber of Provisioned Tokens.

    License units are always rounded up to the next highest integer because that is the minimum amount necessary for your monitoring.

    License Usage Detail

To access usage statements:

You can access and download license usage statements for the current month and all the previous time periods.

  1. Click Usage Statements in the License Details section.
  2. Select an available statement type from the dropdown
    • Current Month
    • Last Month
    • Previous Month
    • Current Anniversary Cycle
    • Previous Anniversary Cycle
  3. Click Create to display a PDF view.
  4. Use the PDF viewer controls to download the statement.

To view usage projection:

With careful planning, you can gauge annual license consumption to ensure you have enough tokens to cover your monitoring needs. However, unexpected events such as consumer market demand or application abnormalities can cause excessive token utilization. You can use the Projection feature to display current and future token consumption estimates. The estimation plotline lets you verify that you have enough tokens to cover future usage. It also provides an estimation of how many additional tokens you may need, in the event of a shortfall, to ensure continuous monitoring for the current license unit anniversary period. 

  1. Click the Projection toggle to display an estimation plotline of future token usage on the graph. 
  2. Hover over the future graph plotline to view projected usage estimates on specific dates based on your average usageEstimated date when the license may reach the token limit..
  3. Hover over Projected Usage Chart Line to:
    • Know that either you have enough tokensThe number of tokens you need to cover usage through the anniversary period. or the date when the license may reach the token limitThe projection of tokens exceeding the limit..
    • Obtain the number of additional tokens necessaryLimit date vertical plotline. to cover usage through the anniversary period in the event of a shortfall.
    • View estimation plotlines on the projected shortfall dateEstimated Shortfall Date.

Usage Projection Graph

To view license overages:

You can go over your license usage limit on a per Tenant and per entitlement basis by a configurable amount determined, at the sole discretion of AppDynamics, during account setup, which is subjection to change at any time without notice.

If you begin to exceed your usage allowance, the overage utilization displays in the Overage Pool and the graph accordingly. Hover over the graph to view overage by a select date. You can also view by month, anniversary period, or a custom time period by setting a specific time range. This information can help you plan future usage requirements.

Each subscription license model has a unique display in the UI.

The IBL model offers license packages for Application Performance Management (APM), End User Monitoring (EUM), Application Analytics, and security. Each package includes a combination of AppDynamics Agents and is based on a single metering unit. : CPU Core.

If you purchased AppDynamics licenses before February 23, 2021, you most likely have licenses in the ABL model. Agent-based Licensing is the original model in which each AppDynamics Agent is licensed and metered individually. 

License Model Graph Examples

You can use View OptionsView Options Dropdownto select a Controller type and status to filter the list.

There are several product families and each family has several products associated with it. Usage is measured differently for each product.See License Entitlements and Restrictions.

  1. Select a Subscription to access usage detail for each product associated with the license, including:
    • Each Product associated with the selected license.
    • The Product Family category.
    • The current Usage of the product for a specified usage period.
    • The Usage Period in which the product can consume licenses before the usage limit is reset.
      The usage periods that display for each product in the detailed usage graphs are set as default time ranges for efficient page loading.  

  2. Select a Product to view:
    • The Usage limit.
    • The Contract term.
    • The Max and Monthly Average usage metrics.
    • Total (cumulative) license usage for that product and product family.
      For the APM Any Language product, select or deselect the language to view or remove usage data in the graph.

  3. Click one of the Bread Crumb Dropdown in the page navigation pathBread Crumbs Drop Down to select a different license or different product within that license. 
    Only products associated with the chosen license display in the dropdown menu.

  4. Click Time Range Selector to use the Time Range SelectorProvisioned Tokens to adjust the period, date, time zone, and granularity of data you want to view in the graph. There are several predefined time ranges that allow you to view past cycles quickly.
    • Select Data GranularityData Granularity Dropdown to choose daily, hourly, weekly, or monthly detail.
    • Use the calendar and time tools to set specific historical ranges.
      If you select a timeframe that is too long for the aggregation, certain granularity options are not visible. 
      For example, if you choose a timeframe longer than one month, hourly granularity is disabled. 
    • Select Custom to view the timeline over several usage cycles.

  5. For certain ABL model products under the Application Performance Management (APM) and End User Monitoring product families, there are two graph types.
    You can specify the data granularity and timeframe you want to view in both types.
    • cumulative plot line graph for a given usage cycle.
    • non-cumulative plot line graph for the same usage cycle. 
    • Click Line Chart or Bar Chart to toggle the data display as either a line graph or bar graph.

  6. Hover over a data point on the graph to view granular metricsHover Data Point Display
    If you set a timeframe to less than one month, hourly metrics are available. If you select a timeframe greater than or equal to one month, daily data is available.

  7. Click an agent name in the legendGraph Agent Legend to include or exclude the metric on the graph. 

  8. When available, select View usage as <metered units> or View usage as license units.
    • Viewing usage by metered units displays consumption according to how many events you consumed due to license unit consumption.
      Each product has distinct meters on which licenses are consumed. 
    • Viewing usage by license units displays how many licenses have been consumed. 
      The usage data is the same; the x-axis displays the same usage on both graphs, while the y-axis reflects the view you select. 

      License units are always rounded up to the next highest integer because that is the minimum amount you would need for your monitoring.

License Usage Detail Controller Tenant

Max and Average Usage Metrics

You can view these metrics reporting for the timeframe you chose in the date range selector UI: 

  • Max—the maximum usage of all agents aggregated over the chosen timeframe. It is the maximum of all the data points on the graph.
  • Monthly Average—the average of all agents reporting usage during the chosen timeframe. It is the average of all the average values on the graph.

For certain products under the Application Performance Management (APM) and Infrastructure Visibility product families, the x-axis is the time frame and the y-axis is the number of license units used. 

The APM Any Language product includes multiple agents. Click a corresponding checkbox in the filter bar to drill down into usage for a particular agent (such as Java). Agents that do not report data during the selected timeframe are grayed out in the filter.

You can interpret metrics according to the view:

  • When you select all agent types, the maximums and the averages of all agents display reporting usage over the selected timeframe.
  • When you select one agent type, the results are restricted to that agent’s data.
  • When you select a subset of agent types, the maximums and averages are calculated based only on the agents chosen.  

Cumulative Plot Graph

This graph displays the total number of units used during either a usage cycle or a timeframe you choose. 

  • The y-axis represents the units used, either as the metered unit or as license units.
  • The x-axis represents the time period.

For a given usage period, the Usage Overview will show usage as a percentage to display the quantity consumption against your total allocation.

Real User Monitoring, Synthetics Monitoring, and Transaction Analytics are a few examples of products that are metered on a cumulative basis.   

Non-Cumulative Plot Graph

This graph plots the usage for a product’s given usage cycle or timeframe and the granularity you select. You can use the non-cumulative graph to help you determine how much of the product is being used at a regular cadence and whether there are spikes in usage. 

Hover over a data point on the graph to view granular metrics. You can also view an average data point for the set granularity.

APM Any Language, Server Visibility, and Databases Monitoring are a few examples of products that are metered on a non-cumulative basis.