| /* |
| * Copyright (c) 1997, 2018 Oracle and/or its affiliates. All rights reserved. |
| * |
| * This program and the accompanying materials are made available under the |
| * terms of the Eclipse Public License v. 2.0, which is available at |
| * http://www.eclipse.org/legal/epl-2.0. |
| * |
| * This Source Code may also be made available under the following Secondary |
| * Licenses when the conditions for such availability set forth in the |
| * Eclipse Public License v. 2.0 are satisfied: GNU General Public License, |
| * version 2 with the GNU Classpath Exception, which is available at |
| * https://www.gnu.org/software/classpath/license.html. |
| * |
| * SPDX-License-Identifier: EPL-2.0 OR GPL-2.0 WITH Classpath-exception-2.0 |
| */ |
| |
| package com.sun.enterprise.admin.monitor.stats; |
| import org.glassfish.j2ee.statistics.Stats; |
| import org.glassfish.j2ee.statistics.RangeStatistic; |
| import org.glassfish.j2ee.statistics.CountStatistic; |
| |
| /** |
| * A Stats interface to represent the statistical data exposed by a Connection |
| * Pool. All the Connection Pool implementations should expose statistical data |
| * by implementing this interface. |
| */ |
| public interface ConnectionPoolStats extends Stats { |
| |
| /** |
| * Statistic to represent the Connection Usage |
| * In addition to information about the number of connections being |
| * used currently, this also contains information about the |
| * Maximum number of connections that were used(High Watermark) |
| * @return RangeStatistic |
| */ |
| RangeStatistic getNumConnUsed(); |
| |
| /* |
| * represents the number of free connections in the pool. |
| * @return CountStatistic |
| */ |
| //public CountStatistic getNumConnFree() ; |
| |
| /** |
| * represents the number of connections that failed validation |
| * @return CountStatistic |
| */ |
| CountStatistic getNumConnFailedValidation() ; |
| |
| /** |
| * represents the number of connection requests that timed out |
| * @return CountStatistic |
| */ |
| CountStatistic getNumConnTimedOut(); |
| |
| /** |
| * Indicates the number of free connections in the pool in addition |
| * to their high and low watermarks. |
| * @return RangeStatistic |
| */ |
| RangeStatistic getNumConnFree(); |
| |
| |
| /** |
| * Indicates the average wait time of connections, for successful |
| * connection request attempts to the connector connection pool |
| * @return CountStatistic |
| */ |
| CountStatistic getAverageConnWaitTime(); |
| |
| /** |
| * Indicates the number of connection requests in the queue waiting |
| * to be serviced |
| * @return CountStatistic |
| */ |
| CountStatistic getWaitQueueLength(); |
| |
| /** |
| * Indicates the longest, shortest wait times of connection |
| * requests. The current value indicates the wait time of |
| * the last request that was serviced by the pool. |
| * @return RangeStatistic |
| */ |
| RangeStatistic getConnRequestWaitTime(); |
| |
| /** |
| * indicates the number of physical EIS/JDBC connections that were created, |
| * since the last reset |
| * @return CountStatistic |
| */ |
| CountStatistic getNumConnCreated(); |
| |
| /** |
| * indicates the number of physical EIS/JDBC connections that were destroyed |
| * , since the last reset |
| * @return CountStatistic |
| */ |
| CountStatistic getNumConnDestroyed(); |
| |
| /** |
| * indicates the number of logical EIS/JDBC connections that were acquired |
| * from the pool, since the last reset |
| * @return CountStatistic |
| * @since 8.1 |
| */ |
| CountStatistic getNumConnAcquired(); |
| |
| /** |
| * indicates the number of logical EIS/JDBC connections that were released |
| * to the pool, since the last reset |
| * @return CountStatistic |
| * @since 8.1 |
| */ |
| CountStatistic getNumConnReleased(); |
| |
| /** |
| * Indicates the number of connections that were successfully matched by |
| * the Managed Connection Factory. |
| * |
| * @return CountStatistic |
| * @since 9.0 |
| */ |
| CountStatistic getNumConnSuccessfullyMatched(); |
| |
| /** |
| * Indicates the number of connections that were rejected by the |
| * Managed Connection Factory during matching. |
| * |
| * @return CountStatistic |
| * @since 9.0 |
| */ |
| CountStatistic getNumConnNotSuccessfullyMatched(); |
| |
| /** |
| * Indicates the number of potential connection leaks |
| * |
| * @return CountStatistic |
| * @since 9.1 |
| */ |
| CountStatistic getNumPotentialConnLeak(); |
| |
| } |