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