Agent Based Licensing Rule

To create an agent-based licensing rule:
  1. Click User Profile > License > License Rules.
  2. Click Create > Create APM License Rule.
  3. In LICENSE RULE NAME, enter the name of your rule.
  4. In LICENSE ALLOCATION, enter the number of units for each agent module type that this rule allocates.
  5. In the Application Scope tab, select + Specified Applications and select the applications from the list on which you want to apply the license rule. If you don't apply any application scope, the license rule applies to all the applications.
    Note:

    • Only the agents that report to the selected applications can consume the license units allocated by this rule. You can select one or more applications from the list.

    • You can specify a matching criteria to select the applications. If you select Dynamic and then Include dynamic ones, all the dynamic application names matching your criteria are selected for your license rule.

    • The agents reporting to the non-matching applications are rejected and cannot report data.

    • You can also add un-instrumented applications to the rule in Application Scope so that when you install the agents to instrument these un-monitored applications, they will be allowed to consume licenses defined in this rule.

    • You can select up to 100 applications to assign to a rule.

  6. In the Server Scope tab, select + Specified Servers and select the servers from the list on which you want to apply the license rule. If you don't apply any server scope, the license rule applies to all the servers.
    Note:

    • Only the agents deployed on the selected servers can consume the license units allocated by this rule. You can select one or more servers from the list.

    • You can specify a matching criteria to select the servers. If you select Dynamic and then Include dynamic ones, all the dynamic server names matching your criteria are selected for your license rule.

    • The agents reporting to the non-matching servers are rejected and cannot report data.

    • You can also add un-monitored machines in Server Scope so that when you install the agents to instrument these un-monitored servers, they will be allowed to consume licenses defined in this rule.

  7. Click Done to create the license rule.

This diagram is an example of a scope configuration.

Agent based license scope configuration

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.

Note: You must allocate the same number of Machine Agents as your APM Agents. For example, if you allocate 10 Java Agents, 10 .NET Agents, and 10 Node.js Agents, you must allocate 30 Machine Agent units. 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.