On this page:
On this page:
Follow the steps below to monitor the Synthetic Server:
Install the Java Agent
You should install the Java Agent in the same directory as the Synthetic Server installation directory. See Install the Java Agent for instructions.
Configure the Java Agent
Configure the Java Agent to report metrics to a specific Controller:
- Change to
- Edit the
controller-info.xmlfile so that the values for the following elements match your Controller information, application name, tier name, and node name:
For example, your
controller-info.xmlfile might look similar to the following:
You just need to make sure that they are the same as those when you attach the Java Agent to the Synthetic Server.
Connect the Synthetic Server with the Controller
Before you installed the Synthetic Server, you needed to configure the Synthetic Server to connect to the EUM Server's MySQL database and the EUM Collector. In this section, you will set configurations in
inputs.groovy to connect the Synthetic Server to the Controller, so that the predefined health rules and dashboards can be created.
inputs.groovy file, make sure you have set the properties below. Replace placeholders in brackets with information about your Controller as well as the application and tier that are being monitored.
Attach the Java Agent to the Synthetic Server
To attach the Java Agent to the Synthetic Server, set Java options through the variables
SYNTHETIC_SHEPHERD_OPTS. The node names and tier names given in the examples below can be modified for your use case. One JVM process requires one Java Agent to be attached.
Set the options for the Synthetic Scheduler so that the Java Agent is attached to the JVM process:
Set the options for the Synthetic Shepherd so that the Java Agent is attached to the JVM process:
Set the options for the Synthetic Feeder Client so that the Java Agent is attached to the JVM process:
Export the variables for the Synthetic Server options:
From the Synthetic Server installer directory, run the following to stop and start the Synthetic Server:
Verify the Instrumentation of the Synthetic Server
Confirm that the Java Agent is running:
Check the Java Agent logs:
Navigate to your Controller.
- You should see a business application with the name assigned in the
controller-info.xmlfile similar to the following. You should also see the tiers and nodes specified in the Java options.
Create Preset Dashboards and Health Rules
The Synthetic Server comes with the
post_deploy.sh command to help create preset dashboards and health rules to monitor the Synthetic Server. The health rules are based on metrics generated by Synthetic Shepherd and not the host machine of the Synthetic Agent or the Java Agent, so they serve to complement the JMX health rules such as CPU usage, memory consumption, etc.
About the Preset Dashboards and Health Rules
The preset health rules issue warnings for when the Synthetic Server has a busy percentage of 80% and issue critical alerts when that busy percentage reaches 90%. The busy percentage is evaluated over the last 30 minutes.
Understanding the Busy Percentage
Each Synthetic Agent can only run one job at a time. When running a job, the Synthetic Agent is busy, and when it's not running, the Synthetic Agent is not busy. The busy percentage indicates the percentage of time that a Synthetic Agent is running jobs. For example, if a Synthetic Agent ran a job that took five minutes and no other jobs, then over the last 10 minutes, it was 50% busy. The busy percentage is based on a metric reported every minute and calculated using pages per minute (PPM). The busy percentage can be used to monitor one Synthetic Agent, a group of Synthetic Agents, or a location.
Create the Dashboards and Health Rules
Once you have verified that the instrumentation was successful and that business applications were created:
- Log in to the machine hosting your Synthetic Server.
- Change to the Synthetic Server home.
Run the following command to create the preset dashboards and health rules:
From the Controller UI, navigate to the Dashboards & Reports page.
You should see the dashboard Synthetic Private Agent Capacity Monitoring as shown here:
- Open the business application for the on-premises Synthetic Server.
- Navigate to Alert & Respond > Health Rules.
- From Alert & Respond > Health Rules, you will see the health rules that you created in Create Preset Dashboards and Health Rules.
Create Custom Dashboards and Health Rules
The Java Agent will report metrics generated by Synthetic Server such as CPU usage, memory consumption, garbage collection, etc. You can use these metrics to create health rules and custom dashboards.
See the following pages for instructions: