Standalone JVM Monitoring plugin

Cloud Monitoring can monitor Java Virtual Machine processes for common Java metrics.

This functionality is only available for agents running on Linux. It is not available on Windows.


To see the metrics for Java Virtual Machine, do the following:

  1. In the Google Cloud console, go to the  Dashboards page:

    Go to Dashboards

    If you use the search bar to find this page, then select the result whose subheading is Monitoring.

  2. Select the Java Virtual Machine dashboard from the list.

Configuring Monitoring to monitor Java VMs

After you install the monitoring agent, use the following instructions to configure the JVM plugin on your instances.


The JVM plugin requires version 5.5.0-257 or later of the monitoring agent. To update the agent, see Upgrading the agent.

Enabling the JVM monitoring plugin

Java Virtual Machines are monitored via JMX.

On your VM instance, download jvm-sun-hotspot.conf from the GitHub configuration repository and place it in the directory /etc/stackdriver/collectd.d/:

(cd /etc/stackdriver/collectd.d/ && sudo curl -O

As root, edit the downloaded configuration file and replace JMX_PORT by the port on which your JVM is configured to allow JMX connections.

After adding the configuration file, restart the monitoring agent by running the following command:

sudo service stackdriver-agent restart

For more information on the collectd GenericJMX plugin used to monitor the JVM, see Plugin:GenericJMX.

What is monitored

The full list of metrics the JVM plugin monitors is at Agent metrics: jvm.

Any additional JMX metrics (MBean attributes) must be sent to Cloud Monitoring as user-defined metrics. For more information, see User-defined metrics from the agent. Any user-supplied MBeans added to the configuration that are not redirected to user-defined metrics are rejected by the API.