This page applies to an earlier version of the AppDynamics App IQ Platform.
See the latest version of the documentation.

Skip to end of metadata
Go to start of metadata

On this page:

In addition to maintaining runtime app agents, the Universal Agent can manage itself via the rulebook, as described in this topic.

About Universal Agent Rules

In a Universal Agent rulebook, a rule with a monitor value of universal identifies a Universal Agent rule.

"monitor": "universal",

The state has the following meaning for Universal Agent: 

  • "installed" indicates that the Universal Agent binaries for the specified Universal Agent version should be downloaded and installed, if possible.  
  • "started" indicates that the binaries for the specified Universal Agent version should be download and installed, and that this version should be running

When you install the Universal Agent, you get a default rulebook that includes a rule for the Universal Agent. 

To upgrade the Universal Agent, you simply load the new version of the agent in the repository and increment the version number in the rule. When the Universal Agent detects that the rulebook specifies a different version than the version currently running, it automatically restarts itself with the new version.

Example Universal Agent Rule

The default rulebook includes a default rule for the Universal Agent, as follows:

            "name": "Universal Agent rule",
            "comments": "Universal Agent rule",
            "monitor": "universal",
            "config": {
                "version": "",
                "state": "started"
            "condition": "True"

Using Multiple Universal Agent Rules

You can have multiple Universal Agent rules in a rulebook. Each should specify a different name and a different version. Only one rule at a time can specify a state of "started."

If multiple rules specify a state of "started," only the first one is recognized, and the other "started" Universal Agent rules are ignored.  As with other rules in the rulebook, Universal Agent are ignored if the "condition" expression yields a value of "False."

  • No labels