The AppDynamics license that you purchase determines the features and deployment scale available to you. A license file that applies to your entire platform resides on the Controller. You do not need to install a license file for other components, such as on the agents or with the on-premises EUM Server, for example.
There are two different types of AppDynamics Licenses: Pro and Lite. You can try the Pro license free for 15 days. When the free trial ends, the license converts to a Lite license, as described in Lite and Pro Editions.
When you purchase Application Performance Monitoring licenses, you can create rules to fine-tune license distributions across your organization.
Users must have a role with the View and Configure Licenses permission for this activity.
Viewing License Information
To view license information in the Controller UI, click the gear icon and choose License.
The License dashboard consists of three tabs:
- Account Usage: displays the maximum license usage in the time range you specify
- Rules: allows you to configure license allocation across machines and applications
- Account: displays the account name, access key, and expiration
The following sections cover each of the tabs in more detail.
Viewing Account Usage
In the Account Usage tab, you can view the number of licenses consumed and license expiration dates for the following product areas:
- Applications: Java, .NET, C/C++, Apache, PHP, Node.js, Python, Go
- User Experience
- Server Visibility
- Network Visibility
You can click on each application type to see that type's license usage. You can specify the time range that you want to see data for in the drop-down menu on the upper right. For more information about how AppDynamics defines license units for each product module, see License Entitlements and Restrictions.
For Analytics, the graph shows the cumulative license usage over the time period you specify, even though the license usage count is reset daily. To see your license usage for one day, set the time range to 23 hours and 59 seconds.
Creating Custom Rules
In the Rules tab, you can create rules to specify the number of Application Performance Monitoring licenses to allocate to specified applications and machines. If you choose not to create any rules, your license allocation follows the default rule, which distributes the licenses evenly across all applications and machines.
In a rule, you can specify the following allocation details:
- How many units you want to allocate to each rule
- Which applications are allowed to consume the units (agents) allocated by this rule
- Which servers are allowed to consume the units (agents) allocated by this rule
When license rules are enabled, you must ensure that all your units are accounted for by either the default rule or a custom rule. AppDynamics follows a mix and match model: you can adjust the number of units allocated to each license rule at any time.
Prerequisite to Creating a Rule
Enable the license rules feature by clicking Create Rules on the Rules tab.
Create a Rule
- Click the +/Create button to display the Add Rule dialog box.
- In the General tab, enter the name of your rule and the number of units for each agent type that this rule allocates.
- In the Application Scope tab, select Specified Applications to restrict which applications agents can report to.
Only agents that report to the applications you specify can consume the units allocated by this rule. You can select one or more applications from the Available Applications list and click the left arrow button to move the applications to the Selected Applications box.
Also, you can specify matching criteria for allowed applications by clicking the Add button. You can also specify matching criteria for applications that you have not yet created. The applications you specify using matching criteria will not appear in the Selected Applications box. You can select up to 100 applications to assign to a rule.
- In the Server Scope tab, select Specified Servers to restrict which servers agents can be deployed to.
Only agents deployed on the servers you specify can consume the units allocated by this rule. You can select one or more servers from the Available Servers list and click the left arrow button to move the applications to the Selected Applications box.
You can specify matching criteria for allowed servers by clicking the Add button. You can also specify matching criteria for servers not yet monitored by AppDynamics. The applications you specify using matching criteria will not appear in the Selected Applications box.
After You Create a Rule
After creating your custom rule, return to the default rule and decrement your unit allocation by the number of units that you allocated in your custom rule. Otherwise, the allocations will show as over-provisioned.
For each rule you create, a new access key is generated, and the agents under that rule are authenticated with that generated key. Update your agent to use this new access key and restart the agent.
You must allocate the same number of machine agents as your APM agents. For example, if you allocate ten Java agents, ten .NET agents, and 10 Node.js agents, you must allocate 30 Machine Agent units.
Viewing License Usage
To view license usage for the units allocated by a rule, click the rule. AppDynamics indicates license usage percentage by the following colors:
- Blue: under 80% units used
- Yellow: over 80% units used
- Red: 100% units used
When configuring rules, you can allocate more units than AppDynamics has provisioned you with. Over-provisioning units buffer your unit allocation and is useful if you are unsure which agent type will consume more units. While your unit allocation is unbounded, AppDynamics limits your unit usage according to the number of licenses you purchase. In other words, AppDynamics continues to reports data for over-provisioned units as long as you have the units available, such as when the license usage for certain agents is lower than expected).
If a Licensed Agent cannot Register with the Controller
If a licensed agent (such as a Server Visibility or Analytics agent) cannot register with the Controller, do the following:
- Check that the user account has a product license for the relevant agent type.
- If the user account has license rules defined, make sure these have the correct number of license units allocated. To change the number of allocated units in a rule:
- Go to Controller Settings (gear icon ) > License > Rules.
- Edit the License Rule of interest. (There might be only one License Rule, named Default.)
- In the General tab, set the Allocated Units field for the relevant license and apply the change.
License Rules Best Practices
When creating license rules, you may want to follow consistent criteria for selecting which applications belong to a rule. We recommend that you follow one of these criteria:
- Group applications by business unit. If you want a rule to contain multiple applications, select applications that belong to the same business unit.
- If you want to view individual application usage, select only one application for a rule.
Viewing Access Keys
On the Account tab, you can view your license type (Pro or Lite) and access key. You use the access key to connect agents to the Controller. For more information, see Agent-to-Controller Connections.