Like JSR 77, AMX imposes a containment hierarchy, as well as certain
relationships.  Here's how it's done for Servlets, WebModules and
J2EEApplications:

*Servlets and WebModules*

A Servlet must refer to a WebModule via the
'WebModule=/web-module-name//'/ property in its ObjectName.  This
WebModule must exist with j2eeType=WebModule,name=/web-module-name/ in
its ObjectName./

/A Servlet or WebModule must also contain the property 
J2EEApplication=/app-name/ in its ObjectName.  If the WebModule is a
standalone war file, then J2EEApplication=null, per JSR 77 specification.

Putting this all together, we should see the following proeprties in the
JSR 77 Servlet and WebModule ObjectNames:

j2eeType=Servlet,name=/servlet-name/,WebModule=/web-module-name/,J2EEApplication=/app-name/
j2eeType=WebModule,name=/web-module-name/,J2EEApplication=/app-name
/j2eeType=J2EEApplication,name=/app-name      /*// exists only if
/app-name/ != null*/
/
*Servlet and WebModule monitoring*

The Monitoring hierarchy mimics this more or less.  There is one
wrinkle: standalone web modules and embedded web modules are a different
'type' and have different name structure.
*
**For monitoring a /standalone /WebModule*:*
*

*JSR 77: **(category=runtime omitted from name)*
j2eeType=WebModule,name=///virtual-server-name/web-module-name/,J2EEServer=/server-name/,J2EEApplication=null*
*j2eeType=Servlet,name=/servlet-name/,WebModule=///virtual-server-name/web-module-name/,J2EEServer=/server-name/,J2EEApplication=null

*Monitoring (category=monitor** omitted from name**)
[the following is workable, but inconsistent]*
type=webmodule-virtual-server,name=/virtual-server-name/,server=/server-name/,standalone-web-module=/web-module-name/
type=servlet,name/=servlet-name/,server=/server-name/,standalone-web-module=/web-module-name,/webmodule-virtual-server=/server-name
/type=web-module,name=///virtual-server-name///web-module-name/,server=/server-name//
/

////**//***For monitoring an /embedded  /WebModule*, the following is
needed:

*JSR 77: **(category=runtime omitted from name)*
j2eeType=J2EEApplication,name=/app-name/,J2EEServer=/server-name/
j2eeType=WebModule,name/=web-module-name/,J2EEApplication=/app-name,/J2EEServer=/server-name/
j2eeType=Servlet,name=/servlet-name/,WebModule=/web-module-name/,J2EEApplication=/app-name,/J2EEServer=/server-name/

*Monitoring (category=monitor** omitted from name**)*

type=application,name=/app-name/,server=/server-name
/type=web-module,name=///virtual-server-name/web-module-name/,application=/app-name/,server=/server-name/
type=servlet,name=/servlet-name/,web-module=///virtual-server-name/web-module-name,/webmodule-virtual-server=/server-name/,application=/app-name/
type=webmodule-virtual-server,name/=virtual-server-name/,application=/app-name/,web-module=/web-module-name
/type=application,name=/app-name/,server=/server-name/*
*//
*Thoughts
*
The above names do require special-case code because the names aren't
consistent:

type=webmodule-virtual-server,*name/=virtual-server-name/,standalone-web-module=/web-module-name/**,*server=/server-name
...vs.../
type=web-module,*name=///virtual-server-name/web-module-name/*

It would be nice if webmodule-virtual-server were modified to use the
ObjectName:

type=webmodule-virtual-server,name/=////virtual-server-name/web-module-name/,server=/server-name

/However, the AMX code currently special-cases this, so it is not a
show-stopper.

Thanks,
Lloyd/
/

Jan Luehe wrote On 10/26/05 10:05,:



  

Lloyd,

Lloyd L Chambers wrote On 10/25/05 18:33,:

  


    

Jan,

I'm at home unfortunately.  Here is what I'm seeing--ghese names are
after running the AMX unit tests, which deploy most of the sample apps. 
I've grouped related names together as best I can figure out (see below
after my comments).
    

      

thanks for grouping the names! That helps.

I know what's going on: I had confused a web-module monitoring object
name with a virtual-server monitoring object name. I think the reason I
had confused the two is because the virtual-server monitoring object
name is a misnomer: it really represents a web module or app deployed on
a particular vs, and not the vs itself.

I had never understood why
MonitoringObjectNames.getVirtualServerObjectName()
would take "app" and "module" arguments. Now I understand.
It's really unfortunate that this method has been named this way.

As part of my recent changes, I had only modified
MonitoringObjectNames.getWebModuleObjectName() and
MonitoringObjectNames.getServletObjectName() to take into
consideration the ctx root, but I had not changed
MonitoringObjectNames.getVirtualServerObjectName().

Sorry for the confusion.

I take it you are only interested in object names of the form

type=webmodule-virtual-server

and

type=server,
  

    

I meant type=servlet.

Jan





  

but not type=web-module, right?

So the equivalent of j2eeType=WebModule in the monitoring world is
type=webmodule-virtual-server, not type=web-module, right?

Why are we even registering monitoring beans for type=web-module,
if those beans don't have any attributes?

Anyway, I'll send you a patch shortly to try out.

Thanks for your patience,


Jan




  


    

Looks like there are several issues:
1.  *For a web module within an application*:

Names are taken from two different places!

(a) The value of <web-uri> is being used for the  'web-module' property
value in type=webmodule-virtual-server:

type=webmodule-virtual-server,name=server,application=HelloWorld,category=monitor,server=server,web-module=*stateless-simple.war*

(c) The name used for the j2eeType=WebModule is taken from
<context-root> in application.xml. Ditto for type=web-module:

j2eeType=WebModule,name=//server/*helloworld*,J2EEServer=server,J2EEApplication=HelloWorld
type=web-module,name=//server/*helloworld*,application=HelloWorld,category=monitor,server=server

*Solution: *make the name used be context-root in both cases.  This
applies to servlets as well.
*Alternative*: /application-name/./context-root/


*2.  For a standalone web module:
*
Names are taken from two different places:

(a) The value of the "name" Attribute in <web-module> is being used for
the  'standalone-web-module' property value in
type=webmodule-virtual-server:

type=webmodule-virtual-server,name=server,category=monitor,server=server,standalone-web-module=*Car_Store**
***
**(b) The name used for j2eeType=WebModule is the <context-root> within
domain.xml:

j2eeType=WebModule,name=//server/jsf-carstore.war29357,J2EEServer=server,J2EEApplication=null

*Solution: *make the name used be context-root in both cases.  This
applies to servlets as well.
*Alternative*: /web-module-name/./context-root/
*
***
*3. Other notes*

(a) There are *two* category=monitor MBeans for the same web module. 
The important one is 'type=webmodule-virtual-server'.  The
'type=web-module' one seems to be useless, since it has no Attributes. 
Ditto for type=application.

type=webmodule-virtual-server,name=*server*,application=*HelloWorld*,category=monitor,server=server,web-module=stateless-simple.war

type=web-module,name=//server/*helloworld*,application=*HelloWorld*,category=monitor,server=server

(b) There are two JSR 77 MBeans j2eeType=WebModule for the same
WebModule within an application.  One of these has J2EEApplication=null:

j2eeType=WebModule,name=//server/*rmi-iiop-simple*,J2EEServer=server,J2EEApplication=*RMIConverterApp*
j2eeType=WebModule,name=//server/*RMIConverterApp*,J2EEServer=server,J2EEApplication=null
*!**null J2EEApplication**!**
*
Lloyd

----------------

jmxcmd> find type=web-module type=webmodule-virtual-server
type=application &category=monitor j2eeType=WebModule
j2eeType=J2EEApplication
*
Applications (OK):*

j2eeType=J2EEApplication,name=*MEjbApp*,J2EEServer=server,category=runtime
type=application,name=*MEjbApp*,category=monitor,server=server

j2eeType=J2EEApplication,name=*ManagementServiceEAR*,J2EEServer=server,category=runtime
type=application,name=*ManagementServiceEAR*,category=monitor,server=server

j2eeType=J2EEApplication,name=*__ejb_container_timer_app*,J2EEServer=server,category=runtime 
!no WebModule (OK)!
type=application,name=*__ejb_container_timer_app*,category=monitor,server=server
*
Applications (name mismatches and/or null J2EEApplication):*

j2eeType=J2EEApplication,name=*CartApp*,J2EEServer=server,category=runtime
j2eeType=WebModule,name=//server/*CartApp*,J2EEServer=server,J2EEApplication=null
*!**null J2EEApplication**!***
type=application,name=*CartApp*,category=monitor,server=server

j2eeType=J2EEApplication,name=*CustomJndiFactory*,J2EEServer=server,category=runtime
j2eeType=WebModule,name=//server/*CustomJndiFactory*,J2EEServer=server,J2EEApplication=null
*!**null J2EEApplication**!*

j2eeType=J2EEApplication,name=*ExternalJndiFactory*,J2EEServer=server,category=runtime
j2eeType=WebModule,name=//server/*ExternalJndiFactory*,J2EEServer=server,J2EEApplication=null
*!**null J2EEApplication**!***

j2eeType=J2EEApplication,name=*HelloWorld*,J2EEServer=server,category=runtime
j2eeType=WebModule,name=//server/*helloworld*,J2EEServer=server,J2EEApplication=HelloWorld
type=webmodule-virtual-server,name=*server*,application=*HelloWorld*,category=monitor,server=server,web-module=stateless-simple.war
!*???*!
/type=web-module,name=//server/*helloworld*,application=*HelloWorld*,category=monitor,server=server
type=application,name=*HelloWorld*,category=monitor,server=server/

j2eeType=J2EEApplication,name=*RMIConverterApp*,J2EEServer=server,category=runtime
j2eeType=WebModule,name=//server/*rmi-iiop-simple*,J2EEServer=server,J2EEApplication=*RMIConverterApp*
j2eeType=WebModule,name=//server/*RMIConverterApp*,J2EEServer=server,J2EEApplication=null
*!**null J2EEApplication**!*
type=webmodule-virtual-server,name=*server*,application=*RMIConverterApp*,category=monitor,server=server,web-module=*rmi-simple.war*
/type=application,name=*RMIConverterApp*,category=monitor,server=server
type=web-module,name=//server/*rmi-iiop-simple*,application=//*null
J2EEApplication*//,category=monitor,server=server/**

j2eeType=J2EEApplication,name=*__JWSappclients*,J2EEServer=server,category=runtime
j2eeType=WebModule,name=//server/*__JWSappclients*,J2EEServer=server,J2EEApplication=*__JWSappclients*
type=webmodule-virtual-server,name=*server*,application=_*_JWSappclients*,category=monitor,server=server,web-module=*sys.war*
/type=web-module,name=//server/*__JWSappclients*,application=*__JWSappclients*,category=monitor,server=server
type=application,name=*__JWSappclients*,category=monitor,server=server/

j2eeType=J2EEApplication,name=*jaxrpc-simple*,J2EEServer=server,category=runtime
j2eeType=WebModule,name=//server/*jaxrpc-simple*,J2EEServer=server,J2EEApplication=*jaxrpc-simple*
j2eeType=WebModule,name=//server/*jaxrpc-simple*,J2EEServer=server,J2EEApplication=null
*!**null J2EEApplication**!*
type=webmodule-virtual-server,name=*server*,application=*jaxrpc-simple*,category=monitor,server=server,web-module=*jaxrpc-simple.war*
/type=application,name=*jaxrpc-simple*,category=monitor,server=server//
type=web-module,name=//server/*jaxrpc-simple*,application=*jaxrpc-simple*,category=monitor,server=server/**

j2eeType=J2EEApplication,name=*jdbc-simple*,J2EEServer=server,category=runtime
j2eeType=WebModule,name=//server/*jdbc-simple*,J2EEServer=server,J2EEApplication=*jdbc-simple*
type=webmodule-virtual-server,name=*server*,application=*jdbc-simple*,category=monitor,server=server,web-module=*jdbc-simple.war*
/type=application,name=*jdbc-simple*,category=monitor,server=server//
type=web-module,name=//server/*jdbc-simple*,application=*jdbc-simple*,category=monitor,server=server/

j2eeType=J2EEApplication,name=*jndi-url*,J2EEServer=server,category=runtime
j2eeType=WebModule,name=//server/*jndi-url*,J2EEServer=server,J2EEApplication=null*
!**null J2EEApplication**!*
/type=application,name=*jndi-url*,category=monitor,server=server/

j2eeType=J2EEApplication,name=*logging-helloworld*,J2EEServer=server,category=runtime
j2eeType=WebModule,name=//server/*logging-helloworld*,J2EEServer=server,J2EEApplication=*logging-helloworld
*type=webmodule-virtual-server,name=*server*,application=logging-helloworld,category=monitor,server=server,web-module=*logging-helloworld.war*
/type=application,name=*logging-helloworld*,category=monitor,server=server//
type=web-module,name=//server/*logging-helloworld*,application=*logging-helloworld*,category=monitor,server=server/
**

j2eeType=WebModule,name=//server/*SimpleMessageApp*,J2EEServer=server,J2EEApplication=null
!*ORPHAN*?!
type=application,name=*SimpleMessageApp*,category=monitor,server=server

j2eeType=WebModule,name=//server/,J2EEServer=server,J2EEApplication=null
j2eeType=WebModule,name=//__asadmin/web1,J2EEServer=server,J2EEApplication=null
type=webmodule-virtual-server,name=*__asadmin*,category=monitor,server=server,standalone-web-module=*adminapp*

j2eeType=WebModule,name=*//__asadmin/*,J2EEServer=server,J2EEApplication=null
!*ORPHAN*?!
j2eeType=WebModule,name=//__asadmin/*asadmin*,J2EEServer=server,J2EEApplication=null
!*ORPHAN*?!
type=webmodule-virtual-server,name=*__asadmin*,category=monitor,server=server,standalone-web-module=*admingui***

*ORPHANS?:*

j2eeType=WebModule,name=//server/*service*,J2EEServer=server,J2EEApplication=null
type=application,name=*InboundMessageApp*,category=monitor,server=server


*Standalone web modules:

Looks like context-root is used for the standalone-web-module property,
but the name of the app is used for WebModule.
*
j2eeType=WebModule,name=//server/*bookstore*,J2EEServer=server,J2EEApplication=null
type=webmodule-virtual-server,name=server,category=monitor,server=server,standalone-web-module=*BookstoreWAR*

j2eeType=WebModule,name=//server/*jsf-carstore.war29357*,J2EEServer=server,J2EEApplication=null
type=webmodule-virtual-server,name=server,category=monitor,server=server,standalone-web-module=*Car_Store*

j2eeType=WebModule,name=//server/*jsf-components.war29358*,J2EEServer=server,J2EEApplication=null
type=webmodule-virtual-server,name=server,category=monitor,server=server,standalone-web-module=*JavaServer_Faces_Custom_Components*

j2eeType=WebModule,name=//server/*jsf-guessNumber.war29359*,J2EEServer=server,J2EEApplication=null
type=webmodule-virtual-server,name=server,category=monitor,server=server,standalone-web-module=*JavaServer_Faces_Guess_Number_Sample_Application*


j2eeType=WebModule,name=//server/*web-basic-auth.war29364*,J2EEServer=server,J2EEApplication=null
type=webmodule-virtual-server,name=*server*,category=monitor,server=server,standalone-web-module=*Welcome_to_BASIC_Security_Zone*

j2eeType=WebModule,name=//server/web-form-auth,J2EEServer=server,J2EEApplication=null
type=webmodule-virtual-server,name=server,category=monitor,server=server,standalone-web-module=*Formauth*

j2eeType=WebModule,name=//server/*webapps-simple*,J2EEServer=server,J2EEApplication=null
type=webmodule-virtual-server,name=*server*,category=monitor,server=server,standalone-web-module=*JSP_and_Servlet_Examples*