On this page:

Related pages:

The AppDynamics Universal Agent uses a rulebook to determine which versions of the runtime agents should be installed and deployed. You manage the deployment, versioning, and status of Standalone Machine Agents on a monitored machine by adding Machine Agent rules to the Universal Agent rulebook. This topic describes the syntax and usage for Machine Agent rules.

Define Standalone Machine Agent Rules

A monitor value of machine identifies a Machine Agent rule. 

The valid values for the state property for a Machine Agent rule are:

  • installed
  • started

The started state both installs the agent (if not installed yet) and starts it. The sim_enabled property enables Server Visibility for the machine agent. When a value is not specified in the rule, the value defaults to true.  See Server Visibility for details on licensing and functionality.

The other properties shown in the example, such as name and comments, are common across the agent types. For those rule properties, see Universal Agent Rulebooks.

Example Standalone Machine Agent Rule

The rule containing "name": "Machine monitor" specifies the configuration for a Machine Agent.

[
{
    "name": "default-controller",
    "comments": "An example rule book with a rule to start a machine monitor",
    "config": {
    },
    "rules": [
        {
            "config": {
                "state": "started",
                "version": "4.5.0.0"
                "sim_enabled": ["true"|"false"]
            },
            "monitor": "machine",
            "comments": "This is a Machine rule",
            "condition": "True",
            "name": "Machine monitor"
        },
        {
            "name": "Universal Agent rule",
            "comments": "Universal Agent rule",
            "monitor": "universal",
            "config": {
                "version": "4.5.0.0",
                "state": "started"
            },
            "condition": "True"
       }
    ]
}
]
CODE