eG Help

The Oracle Primavera P6 EPPM Server allows connections to many different clients including Desktop clients, API clients, Webservice clients and other reporting clients. EPPM manages client connections using connection pools which create, allocate and terminate connections as and when required. It is quite useful for administrators for administrators to keep an eye on availability of connections in connections pools, so as to ensure that unused connections are free up and new connections are allocated whenever a new client comes to join.

This test monitors the connection pools and provide important insights about connection performance, availability, waiting time and query performance over these connections.

Outputs of the test: One set of results for each connection pool hosted on P6 EPPM Server

Measurement	Description	Measurement Unit	Interpretation
avgSQLTime	Indicates the average time taken to execute SQL queries.	Seconds	If this time is increasing over repeated measurements, it is cause of concern.
avgLeaseTime	Indicates the average time a user holds the connection.	Seconds	Administrators can use this metrics to plan the capacity required for the system.
avgLeaseWaitTime	Indicates the average time a users has to wait to acquire the connection.	Seconds	If this time is increasing over repeated measurements, it is cause of concern.
connectionsAllocated	Indicates the number of connections made available and allocated to the users during last measurement period.	Number
connectionsInUse	Indicates the number of leased connection that are involved in database transactions.	Number	Very high number of connections in use can degrade the system performance so administrators need to investigate if number of active connection stays high for longer period of time.
pctConnectionUsage	Indicates the number of connection which are in use against the total number of leased connections.	Percentage	Number of connections used should be optimal, it shouldn't be too low , which would mean capacity is not fully utilized. Also, it should not be too high which means it will not be possible to allocate new connections.
waitingForLease	Indicates the number of users who are waiting for the connection to be made available and acquire it.	Number	If this metrics is high, it means more users want to connect to system than capacity.
connectionsLeased	Indicates the number of connections that have been reserved by active user transactions.	Number
connectionsRecycled	Indicates the number of previously leased connections which have been forcibly returned to connections pool due to lease timeout while connection was not in use.	Number
connectionsRevoked	Indicates the number of previously leased connections which have been forcibly returned to connections pool due to lease timeout during a database transaction.	Number	While it is good to recycle connections but revoking connections in the middle of transaction can cause the user real inconvinience.
succeededLeaseRequests	Indicates the number of users who were successful in leasing a connection on request.	Number
deniedLeaseRequest	Indicates the number of database connection lease request which were denied due to the connection pool not having any free connections.	Number	If there are too many denied requests, which means the connection availability is too low.
sqlQueries	Indicates the number of SQL queries executed across the connections.	Number