Oracle WebLogic: Configuring DyeInjection Monitor

A fairly unknown tool within WLDF(WebLogic Diagnostic Framework) is the DyeInjection Monitor. With this monitor configured one can track a  user or client address within a WebLogic system.

You can configure WLDF to check for  every request that enters the system and add a unique ID within a context to track this request in it’s flow.A diagnostic context contains a unique context ID and a dye vector, which identifies characteristics of the context.

First of all you will have to create a diagnostic module configured to use the DyeInjection Monitor:

1. Create a Diagnostic Module within your WebLogic Admin Console

2. Add the DyeInjection Monitor to the Module, from the tab instrumentation, and add the DyeInjection Monitor

Add Dye

Oracle WebLogic: Configuring DyeInjection Monitor dye2

3. Within the DyeInjection Monitor, you can configure the originatin IP Adress and user. ( you can not use DNS for it)

Oracle WebLogic: Configuring DyeInjection Monitor dye3

The following flags should be used:

ADDRn –> Originating IP adress

USERn –> Specific User or client name

COOKIEn –>are set in the diagnostic context for an HTTP request, if the request contains the cookie named weblogic.diagnostics.dye and its value is equal to the value of the respective property of the DyeInjection monitor.

CONNECTORn –>These dye flags are set by the connector drivers to identify request properties specific to their situations ( for instance a JDBC connector)

Other ones are: THROTTLE, PROTOCOL_HTTP,PROTOCOL_SOAP, PROTOCOL_IIOP, PROTOCOL_RMI, PROTOCOL_SSL, PROTOCOL_T3. These are are set implicitly by WLDF.


4 Configure a dye mask and enable dye filtering for the for an already instrumented application diagnostic monitor.

Here’s the way how to instrument an application with Diagnostics:


– In the Admin Console, click Deployments

On the Summary of Deployments > Control page, click the name of the application or application module for which you want to configure diagnostic monitors. I use the FMW  Welcome page application inhere, just as an example

– Select Configuration > Instrumentation. and add a Monitor from Library, and then select the options you’d like to attach

Oracle WebLogic: Configuring DyeInjection Monitor app diag1Oracle WebLogic: Configuring DyeInjection Monitor app diag2

4 Comments

  1. Radu Dobrinescu February 2, 2012
  2. Lucas Jellema January 7, 2011
  3. Michel Schildmeijer January 7, 2011
  4. Lucas Jellema January 7, 2011