Configuring the THROTTLE Dye
12.6.1 Configuring the THROTTLE Dye
Unlike other dyes in the dye vector, the THROTTLE dye is configured through two properties. ■ THROTTLE_INTERVAL sets an interval in milliseconds after which a new incoming request is dyed with the THROTTLE dye. If the THROTTLE_INTERVAL is greater than 0, the DyeInjection monitor sets the THROTTLE dye flag in the dye vector of an incoming request if the last request dyed with THROTTLE arrived at least THROTTLE_INTERVAL before the new request. For example, if THROTTLE_INTERVAL=3000, the DyeInjection monitor waits at least 3000 milliseconds before it will dye an incoming request with THROTTLE. ■ THROTTLE_RATE sets the rate in terms of the number of incoming requests by which new incoming requests are dyed with the THROTTLE dye. If THROTTLE_RATE is greater than 0, the DyeInjection monitor sets the THROTTLE dye flag in the dye vector of an incoming request when the number of requests since the last request dyed with THROTTLE equals THROTTLE_RATE. For example, if THROTTLE_RATE = 6, every sixth request is dyed with THROTTLE. You can use THROTTLE_INTERVAL and THROTTLE_RATE together. If either condition is satisfied, the request is dyed with the THROTTLE dye. If you assign a value to either THROTTLE_INTERVAL or THROTTLE_RATE or both, or neither, you are configuring the THROTTLE dye. A THROTTLE configuration setting in the Administration Console is shown in the following figure. Figure 12–4 Configuring the THROTTLE Dye Example 12–3 shows the resulting configuration in the descriptor file for the diagnostics module. Note: The USERn and ADDRn dyes allow inspection of requests from specific users or IP addresses. However, they do not provide a means to look at arbitrary user transactions. The THROTTLE dye provides that functionality by allowing sampling of requests. 12-12 Configuring and Using the Diagnostics Framework for Oracle WebLogic Server Example 12–3 Sample THROTTLE Configuration in the DyeInjection Monitor, in DIAG_ MODULE.xml wldf-resource nameMyDiagnosticModulename instrumentation wldf-instrumentation-monitor nameDyeInjectionname properties THROTTLE_INTERVAL=3000 THROTTLE_RATE=6 properties wldf-instrumentation-monitor instrumentation -- Other elements to configure this diagnostic monitor -- wldf-resource Example 12–4 shows the configuration for a JDBC_Before_Start_Internal delegating monitor where the THROTTLE dye is set in the dye mask for the monitor. Example 12–4 Sample Configuration for Setting THROTTLE in a Dye Mask of a Delegating Monitor, in DIAG_MODULE.xml wldf-resource nameMyDiagnosticModulename instrumentation wldf-instrumentation-monitor nameJDBC_Before_Start_Internalname enabledtrueenabled dye-maskTHROTTLEdye-mask wldf-instrumentation-monitor instrumentation -- Other elements to configure this diagnostic monitor -- wldf-resource12.6.2 How Throttling is Handled by Delegating and Custom Monitors
Parts
» Oracle Fusion Middleware Online Documentation Library
» What Is the WebLogic Diagnostics Framework?
» Document Scope and Audience Guide to This Document
» Data Creation, Collection, and Instrumentation Archive
» Monitoring Dashboard Diagnostics Request Performance Page
» Watch and Notification Data Accessor Diagnostic Image Capture
» How It All Fits Together About Oracle JRockit Flight Recorder
» Key Features of WLDF Integration with JRockit Flight Recorder
» JFR Graphical User Interface
» Displaying Event Data for a Product Subcomponent Viewing the Event Log to Display Details
» Tracking Execution Flow by Analyzing an Operative Set
» Changing the Location of Temporary JFR Files
» Obtaining the JRockit Flight Recording File Configuration MBeans and XML
» Tools for Configuring WLDF Configuring Diagnostic Image Capture and Diagnostic Archives
» The DIAG_MODULE.xml Resource Descriptor Configuration Managing Diagnostic System Modules
» WLDF Configuration MBeans and Their Mappings to XML Elements
» Configuring WLDF Diagnostic Volume WLST Commands for Generating an Image Capture
» Creating WLDF Tables in the Database
» Harvesting, Harvestable Data, and Harvested Data
» Configuring the Harvester Sampling Period Configuring the Types of Data to Harvest
» Sample Configurations for Different Harvestable Types
» Harvesting Data from the Different Harvestable Entities Watches and Notifications
» Sample Watch and Notification Configuration
» Types of Watches Configuration Options Shared by All Types of Watches
» Configuring Harvester Watches Oracle Fusion Middleware Online Documentation Library
» Configuring Log Watches Configuring Instrumentation Watches
» Defining Watch Rule Expressions Types of Notifications
» Configuring JMX Notifications Configuring JMS Notifications
» Configuring SNMP Notifications Oracle Fusion Middleware Online Documentation Library
» Configuring SMTP Notifications Configuring Image Notifications
» Instrumentation Scope Configuration and Deployment Joinpoints, Pointcuts, and Diagnostic Locations
» Diagnostic Monitor Types Concepts and Terminology
» Instrumentation Configuration Files Oracle Fusion Middleware Online Documentation Library
» Instrumentation XML Elements XML Elements Used for Instrumentation
» wldf-instrumentation-monitor XML Elements XML Elements Used for Instrumentation
» Configuring Server-Scoped Instrumentation Oracle Fusion Middleware Online Documentation Library
» Comparing System-Scoped to Application-Scoped Instrumentation
» Defining Pointcuts for Custom Monitors
» Creating Request Performance Data
» Context Life Cycle and the Context ID Dyes, Dye Flags, and Dye Vectors
» Dyes Supported by the DyeInjection Monitor PROTOCOL Dye Flags
» THROTTLE Dye Flag When Diagnostic Contexts Are Created
» Configuring Delegating Monitors to Use Dye Filtering
» Dye Filtering Example How Dye Masks Filter Requests to Pass to Monitors
» Configuring the THROTTLE Dye
» How Throttling is Handled by Delegating and Custom Monitors
» Using weblogic.diagnostics.context
» Data Stores Accessed by the Data Accessor Accessing Diagnostic Data Offline
» Accessing Diagnostic Data Programmatically
» Using Deployment Plans to Dynamically Control Instrumentation Configuration
» Using a Deployment Plan: Overview Creating a Deployment Plan Using weblogic.PlanGenerator
» Sample Deployment Plan for Diagnostics
» View List About the Monitoring Dashboard Interface
» Metric Browser About the Monitoring Dashboard Interface
» Current Time Range Charts Custom Time Range Charts
» Sequence in which Metrics Data is Displayed
» Notes about Metric Data Retention
» How WLDF Generates and Retrieves Data Mapping WLDF Components to Beans and Packages
» Configuration APIs Configuration and Runtime APIs
» Runtime APIs Configuration and Runtime APIs
Show more