geode-docs/managing/management/mbeans_jconsole.html.md.erb

<% set_title("Browsing", product_name, "MBeans through JConsole") %>

<!--
Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements.  See the NOTICE file distributed with
this work for additional information regarding copyright ownership.
The ASF licenses this file to You under the Apache License, Version 2.0
(the "License"); you may not use this file except in compliance with
the License.  You may obtain a copy of the License at

     http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
-->

You can browse all the <%=vars.product_name%> MBeans in your cluster by using JConsole.

To view <%=vars.product_name%> MBeans through JConsole, perform the following steps:

1.  Start a `gfsh` prompt.
2.  Connect to a running cluster by either connecting to a locator with an embedded JMX Manager or connect directly to a JMX Manager. For example:

    ``` pre
    gfsh>connect --locator=locator1[10334]
    ```

    or

    ``` pre
    gfsh>connect --jmx-manager=locator1[1099]
    ```

3.  Start JConsole:

    ``` pre
    gfsh>start jconsole
    ```

    If successful, the message `Running JDK JConsole` appears. The JConsole application launches and connects directly to the JMX Manager using RMI.

4.  On the JConsole screen, click on the MBeans tab. Expand **GemFire**. Then expand each MBean to browse individual MBean attributes, operations and notifications.

    The following is an example screenshot of the MBean hierarchy in a <%=vars.product_name%> cluster:

    <img src="../../images/jconsole_mbeans.png" id="concept_492532E145834248997BD23BCAC7AD45__image_7A45BE69B67A44A7A8AD40343A2B0AEB" class="image" />