Optimize 10.7 | webMethods Optimize Documentation | Administering webMethods Optimize | Monitored KPI Definitions | Presto KPI Definitions | com.softwareag.jmx.Catalina.type.ProtocolHandler | KPIs
 
KPIs
The following table describes the com.softwareag.jmx.Catalina.type.ProtocolHandler KPIs.
Name
Description
int maxTrailerSize
Limits the total length of trailing headers in the last chunk of a chunked HTTP request. If the value is -1, no limit will be imposed. If not specified, the default value of 8192 will be used.
int soLinger
Limits the total length of chunk extensions in chunked HTTP requests. If the value is -1, no limit will be imposed. If not specified, the default value of 8192 will be used. If not specified, the default value of 8192 will be used.
boolean sSLEnabled
Whether to enable SSL traffic on a connector. To turn on SSL handshake/encryption/decryption on a connector, set this value to true. The default value is false. When you set this value true, you must also set the scheme and the secure attributes to pass the correct request.getScheme() and request.isSecure() values to the servlets.
int maxThreads
The maximum number of request processing threads to be created by this Connector, which also determines the maximum number of simultaneous requests that can be handled. If not specified, the default value of 200 is used. If an executor is associated with this connector, this attribute is ignored as the executor takes precedence.
int port
The TCP port number on which this Connector creates a server socket and awaits incoming connections. Your operating system will allow only one server application to listen to a particular port number on a particular IP address. If the value is set to 0, Tomcat selects a free port at random to use for this connector. This is typically only useful in embedded and testing applications.
int connectionTimeout
The number of milliseconds this Connector will wait, after accepting a connection, for the request URI line to be present. A value of -1 indicates no (i.e. infinite) timeout. The default value is 60000.
Note:
The standard server.xml that ships with Tomcat sets this property to 20000. Unless disableUploadTimeout is set to false, this timeout will also be used when reading the request body (if any).
int maxHeaderCount
The maximum number of headers in a request that are allowed by the container. A request that contains more headers than the specified limit will be rejected. A value of less than 0 means no limit. If not specified, a default of 100 is used.
int keepAliveTimeout
The number of milliseconds this Connector will wait for another HTTP request before closing the connection. The default value is to use the value that has been set for the connectionTimeout attribute. Use a value of -1 to indicate no (i.e. infinite) timeout.
int maxConnections
The maximum number of connections that the server will accept and process at any given time. When this number is reached, the server will accept, but not process any more connections. Note that once the limit has been reached, the operating system may still accept connections based on the acceptCount parameter. The default value varies by connector type. For BIO the default is the value of maxThreads unless an Executor is used, in which case the default will be the value of maxThreads from the executor. For NIO the default is 10000. For APR/native, the default is 8192. Note that for APR/native on Windows, the configured value will be reduced to the highest multiple of 1024 that is less than or equal to maxConnections. This is done for performance reasons. If set to a value of -1, the maxConnections feature is disabled and connections are not counted.
int maxHttpHeaderSize
The maximum size of the request and response HTTP header, specified in bytes. If not specified, this value is set to 8192 (8 KB).
int maxSavePostSize
The maximum size in bytes of the POST which will be saved/buffered by the container during FORM or CLIENT-CERT authentication. For both types of authentication, the POST will be saved/buffered before the user is authenticated. For CLIENT-CERT authentication, the POST is buffered for the duration of the SSL handshake and the buffer is emptied when the request is processed. For FORM authentication the POST is saved whilst the user is re-directed to the login form and is retained until the user successfully authenticates or the session associated with the authentication request expires. A value of -1 means no limit. Setting the attribute to 0 will disable the saving of POST data during authentication. If not specified, the default value of 4096 (4 kilobytes) is used.
int minSpareThreads
The minimum number of threads always kept running. If not specified, the default value of 10 is used.
long connectionCount
Introspected attribute connectionCount.
int processorCache
The protocol handler caches Http11NioProcessor objects to speed up performance. This setting dictates how many of these objects get cached. -1 means unlimited, default is 200. Set this value somewhere close to your maxThreads value.
int maxKeepAliveRequests
The maximum number of HTTP requests which can be pipelined until the connection is closed by the server. Setting this attribute to 1 will disable HTTP/1.0 keep-alive, as well as HTTP/1.1 keep-alive and pipelining. Setting this to -1 will allow an unlimited amount of pipelined or keep-alive HTTP requests. If not specified, this attribute is set to 100.
int disableKeepAlivePercentage
The percentage of processing threads that have to be in use before HTTP keep-alives are disabled to improve scalability. Values less than 0 will be changed to 0 and values greater than 100 will be changed to 100. If not specified, the default value is 75.
boolean aprRequired
Introspective attribute aprRequired.
int compressionMinSize
If compression is set to on, this attribute may be used to specify the minimum amount of data before the output is compressed. If not specified, the default value is 2048.
boolean secure
Set this attribute to true if you wish to have calls to request.isSecure() to return true for requests received by this Connector. You would want this on an SSL Connector or a non SSL connector that is receiving data from a SSL accelerator, like a crypto card, a SSL appliance or even a webserver. The default value is false.
int localPort
Introspected attribute localPort.
int soTimeout
This is equivalent to the standard connectionTimeout attribute.
int backlog
Introspected attribute backlog.
int socketBuffer
The size (in bytes) of the buffer to be provided for socket output buffering. Set this value to -1 to disable the use of a buffer. By default, a buffer of 9000 bytes will be used.
boolean disableUploadTimeout
This flag allows the servlet container to use a different, usually longer, connection timeout during data upload. If not specified, this attribute is set to true which disables the longer timeout.
int connectionUploadTimeout
Specifies the timeout, in milliseconds, to use while a data upload is in progress. This only takes effect if disableUploadTimeout is set to false.
int nameIndex
Introspected attribute nameIndex.
int threadPriority
The priority of the request processing threads within the JVM. The default value is 5 (the value of the java.lang.Thread.NORM_PRIORITY constant). For more information, see the JavaDoc for the java.lang.Thread class.
boolean tcpNoDelay
If set to true, the TCP_NO_DELAY option will be set on the server socket, which improves performance under most circumstances. The default value is true.