THROTTLE Dye Flag When Diagnostic Contexts Are Created

12-6 Configuring and Using the Diagnostics Framework for Oracle WebLogic Server

12.3.2 PROTOCOL Dye Flags

You must explicitly set the values for the dye flags USERn, ADDRn, COOKIEn, and CONNECTORn. in the DyeInjection monitor. However, the flags PROTOCOL_HTTP, PROTOCOL_IIOP, ROTOCOL_JRMP, PROTOCOL_RMI, PROTOCOL_SOAP, PROTOCOL_SSL, and PROTOCOL_T3 are set implicitly by WLDF. When the DyeInjection monitor is enabled, every request is injected with the appropriate protocol dye. For example, every request that arrives via HTTP is injected with the PROTOCOL_HTTP dye.

12.3.3 THROTTLE Dye Flag

The THROTTLE dye flag can be used to control the volume of incoming requests that are dyed. THROTTLE is configured differently from the other flags, and WLDF uses it differently. See Section 12.6, Using Throttling to Control the Volume of Instrumentation Events, for more information.

12.3.4 When Diagnostic Contexts Are Created

When the DyeInjection monitor is enabled in a diagnostic module, a diagnostic context is created for every incoming request. The DyeInjection monitor is enabled by default when you enable instrumentation in a diagnostic module. This ensures that a diagnostic Context ID is available so that events can be correlated. Even if no properties are explicitly set in the DyeInjection monitor, the diagnostic context for every request will contain a unique Context ID and a dye vector with one of the implicit PROTOCOL dyes. PROTOCOL_ HTTP PROTOCOL_IIOP PROTOCOL_JRMP PROTOCOL_RMI PROTOCOL_ SOAP PROTOCOL_SSL PROTOCOL_T3 The DyeInjection monitor implicitly identifies the protocol used for a request and sets the appropriate dyes in the dye vector, according to the protocols used. PROTOCOL_HTTP is set in the diagnostic context of a request if the request uses HTTP or HTTPS protocol. PROTOCOL_IIOP is set in the diagnostic context of a request if it uses Internet Inter-ORB Protocol IIOP. PROTOCOL_JRMP is set in the diagnostic context of a request if it uses the Java Remote Method Protocol JRMP. PROTOCOL_RMI is set in the diagnostic context of a request if it uses the Java Remote Method Invocation RMI protocol. PROTOCOL_SSL is set in the diagnostic context of a request if it uses the Secure Sockets Layer SSL protocol. PROTOCOL_T3 is set in the diagnostic context of a request if the request uses T3 or T3s protocol THROTTLE The THROTTLE dye is set in the diagnostic context of a request if it satisfies requirements specified by THROTTLE_INTERVAL andor THROTTLE_RATE properties of the DyeInjection monitor. USER1 USER2 USER3 USER4 Use the USER1, USER2, USER3 and USER4 dyes to specify the user names of clients that originate requests. These dye flags are set in the diagnostic context for a request if the request was originated by a user specified by the respective property USER1, USER2, USER3, USER4 of the DyeInjection monitor. Table 12–1 Cont. Request Protocols for Supported Diagnostic Context Dyes Dye Flags Description Configuring the DyeInjection Monitor to Manage Diagnostic Contexts 12-7 If the DyeInjection monitor is disabled, no diagnostic contexts will be created for any incoming requests.

12.4 Configuring Delegating Monitors to Use Dye Filtering