WebContainerStats


1   /**
2    *  Licensed to the Apache Software Foundation (ASF) under one or more
3    *  contributor license agreements.  See the NOTICE file distributed with
4    *  this work for additional information regarding copyright ownership.
5    *  The ASF licenses this file to You under the Apache License, Version 2.0
6    *  (the "License"); you may not use this file except in compliance with
7    *  the License.  You may obtain a copy of the License at
8    *
9    *     http://www.apache.org/licenses/LICENSE-2.0
10   *
11   *  Unless required by applicable law or agreed to in writing, software
12   *  distributed under the License is distributed on an "AS IS" BASIS,
13   *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14   *  See the License for the specific language governing permissions and
15   *  limitations under the License.
16   */
17  package org.apache.geronimo.management.geronimo.stats;
18  
19  import javax.management.j2ee.statistics.Stats  ;
20  import javax.management.j2ee.statistics.RangeStatistic  ;
21  import javax.management.j2ee.statistics.TimeStatistic  ;
22  import javax.management.j2ee.statistics.CountStatistic  ;
23  
24  /**
25   * Statistics exposed by a web container (for the container as a whole, not
26   * a particular servlet/JSP/URL).
27   *
28   * todo: confirm the definitions of the Jetty stats included here; verify these are valid for Tomcat as well
29   *
30   * @version $Revision: 1.0$
31   */
32  public interface WebContainerStats extends Stats   {
33      /**
34       * Gets the total number of connections thus far
35       */
36      CountStatistic   getTotalConnectionCount();
37   
38      /**
39       * Gets the number of connections currently open (as well as the min and
40       * max since statistics gathering started).
41       */
42      RangeStatistic   getOpenConnectionCount();
43  
44      /**
45       * Gets the number of requests handled by a particular connection (as well
46       * as the min and max since statistics gathering started).
47       */
48      RangeStatistic   getConnectionRequestCount();
49  
50      /**
51       * Gets the legnth of time that connections have been open (includes
52       * figures across all connections open at present)
53       */
54      TimeStatistic   getConnectionDuration();
55  
56      /**
57       * Gets the number of errors that have been returned since statistics
58       * gathering started.
59       */
60      CountStatistic   getTotalErrorCount();
61  
62      /**
63       * Gets the number of requests that have been processed since statistics
64       * gathering started.
65       */
66      CountStatistic   getTotalRequestCount();
67  
68      /**
69       * Gets the number of requests being processed concurrently (as well
70       * as the min and max since statistics gathering started).
71       */
72      RangeStatistic   getActiveRequestCount();
73  
74      /**
75       * Gets the legnth of time taken to process a request (includes
76       * figures across all requests since statistics gathering started)
77       */
78      TimeStatistic   getRequestDuration();
79  
80      /**
81       * Gets the current state of statistics collection (on or off)
82       */
83      boolean isStatsOn();
84  }
85
A to Z: JavaDoc & Examples Daily Java News & Articles Open Source Projects Open Source Codes Free Computer Books Remove Frame
Popular Tags