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       /**
   35        * Gets the number of requests being processed concurrently (as well
   36        * as the min and max since statistics gathering started).
   37        */
   38       RangeStatistic getActiveRequestCount();
   39   
   40       /**
   41        * Gets the the number of requests that have been processed since 
   42        * statistics gathering started.
   43        * Gets the length of time taken to process a request (includes
   44        * figures across all requests since statistics gathering started)
   45        */
   46       TimeStatistic getRequestDuration();
   47   
   48       /**
   49        * Gets the count of 1xx responses
   50        */
   51       CountStatistic getResponses1xx();
   52   
   53       /**
   54        * Gets the count of 2xx responses
   55        */
   56       CountStatistic getResponses2xx();
   57   
   58       /**
   59        * Gets the count of 3xx responses
   60        */
   61       CountStatistic getResponses3xx();
   62   
   63       /**
   64        * Gets the count of 4xx responses
   65        */
   66       CountStatistic getResponses4xx();
   67   
   68       /**
   69        * Gets the count of 5xx responses
   70        */
   71       CountStatistic getResponses5xx();
   72   
   73       /**
   74        * Gets the time duration that stats have been active.
   75        */
   76       CountStatistic getStatsOnMs();
   77   
   78   }