Instrumentation Scope Configuration and Deployment Joinpoints, Pointcuts, and Diagnostic Locations

11-2 Configuring and Using the Diagnostics Framework for Oracle WebLogic Server ■ Section 11.1.5, Diagnostic Actions

11.1.1 Instrumentation Scope

You can provide instrumentation services at the system level servers and clusters and at the application level. Many concepts, services, configuration options, and implementation features are the same for both. However, there are differences, and they are discussed throughout this documentation. The term server-scoped instrumentation refers to instrumentation configuration and features specific to WebLogic Server instances and clusters. Application-scoped instrumentation refers to configuration and features specific to applications deployed on WebLogic servers. The scope is built in to each diagnostic monitor; you cannot modify a monitors scope.

11.1.2 Configuration and Deployment

Server-scoped instrumentation for a server or cluster is configured and deployed as part of a diagnostic module, an XML configuration file located in the DOMAIN_ NAMEconfigdiagnostics directory, and linked from config.xml. Application-scoped instrumentation is also configured and deployed as a diagnostics module, in this case an XML configuration file named weblogic-diagnostics.xml which is packaged with the application archive in the ARCHIVE_PATHMETA-INF directory for the deployed application.

11.1.3 Joinpoints, Pointcuts, and Diagnostic Locations

Instrumentation code is inserted into or woven into server and application code at precise locations. The following terms are used to describe these locations: ■ A joinpoint is a specific location in a class, for example the entry andor exit point of a method or a call site within a method. ■ A pointcut is an expression that specifies a set of joinpoints, for example all methods related to scheduling, starting, and executing work items. The XML element used to describe a pointcut is pointcut. Pointcuts are described in Section 11.5.4.1, Defining Pointcuts for Custom Monitors. ■ A diagnostic location is the position relative to a joinpoint where the diagnostic activity will take place. Diagnostic locations are before, after, and around. The XML element used to describe a diagnostic location is location-type.

11.1.4 Diagnostic Monitor Types