Deploying WLDF Application Modules 14-5
variable-definition -- Add two additional actions to Servlet_Before_Service monitor --
variable nameWLDFInstrumentationMonitor_Servlet_Before_Service_Actions_113050559713922name
valueDisplayArgumentsAction,StackDumpActionvalue variable
-- Enable the Servlet_Before_Service monitor -- variable
nameWLDFInstrumentationMonitor_Servlet_Before_Service_Enabled_113050559713927name valuetruevalue
variable variable-definition
module-override module-namejspExpressionWarmodule-name
module-typewarmodule-type module-descriptor external=false
root-elementweblogic-web-approot-element uriWEB-INFweblogic.xmluri
module-descriptor module-descriptor external=false
root-elementweb-approot-element uriWEB-INFweb.xmluri
module-descriptor module-descriptor external=false
root-elementwldf-resourceroot-element uriMETA-INFweblogic-diagnostics.xmluri
variable-assignment nameWLDFInstrumentationMonitor_Servlet_Before_Service_Actions_113050559713922name
xpathwldf-resourceinstrumentationwldf-instrumentation-monitor[name=Servlet_Before_ Service]actionxpath
variable-assignment variable-assignment
nameWLDFInstrumentationMonitor_Servlet_Before_Service_Enabled_113050559713927name xpathwldf-resourceinstrumentationwldf-instrumentation-monitor[name=Servlet_Before_
Service]enabledxpath variable-assignment
module-descriptor module-override
config-root xsi:nil=trueconfig-root deployment-plan
For a list and documentation of diagnostic monitors and actions that you can specify in the deployment plan, see
Appendix B, WLDF Instrumentation Library.
14.6 Enabling Hot-Swap Capabilities
To enable hot-swap capabilities, start the server with the following command line switch:
-javaagent:WL_HOMEserverlibdiagnostics-agent.jar
14.7 Deploying an Application with a Deployment Plan
To take advantage of the dynamic control provided by a deployment plan, you must deploy the application with the plan.
14-6 Configuring and Using the Diagnostics Framework for Oracle WebLogic Server
You can use any of the standard WebLogic Server tools for controlling deployment, including the Administration Console or the WebLogic Scripting Tool WLST. For
example, the following WLST command deploys an application with a corresponding deployment plan.
wls:mydomainserverConfig deploymyApp, .myApp.ear, myserver, nostage, .plan.xml
After deployment, the effective diagnostic monitor configuration is a combination of the original descriptor, combined with the overridden attribute values from the plan.
If the original descriptor did not include a monitor with the given name and the plan overrides an attribute of such a monitor, the monitor is added to the set of monitors to
be used with the application. This way, if your application is built with an empty weblogic-diagnostics.xml descriptor, you can add diagnostic monitors to the
application during or after the deployment process without having to modify the application archive.
14.8 Updating an Application with a Modified Plan
You change configuration settings by modifying the deployment plan and then updating or redeploying the application, depending on whether or not hot swap is
enabled. See Table 14–2
to see when you can simply update the application and when you must redeploy it. You can use any of the standard WebLogic Server tools for
updating or redeploying, including the Administration Console or the WebLogic Scripting Tool WLST.
If you enabled hot-swap, you can update the configuration for the application with the modified plan values by updating the application with the plan. For example, the
following WLST command updates an application with a plan:
wls:mydomainserverConfig updateApplicationBigApp, c:myappsBigAppnewPlanplan.xml, stageMode=STAGE,
testMode=false
If you did not enable hot-swap, you must redeploy the application for certain changes to take effect. For example, the following WLST command redeploys an application
using a plan:
wls:mydomainserverConfig redeploymyApp c:myappsplan.xml
15
Using the Monitoring Dashboard 15-1
15
Using the Monitoring Dashboard
The Monitoring Dashboard provides views and tools for graphically presenting diagnostic data about servers and applications running on them. The underlying
functionality for generating, retrieving, and persisting diagnostic data is provided by by the WebLogic Diagnostics Framework. The Monitoring Dashboard provides
additional tools for presenting that data in charts and graphs.
The following sections describe the Monitoring Dashboard:
■
Section 15.1, Running the Monitoring Dashboard