Appendix A: vCloud Director Cell Monitoring
   
Appendix A: vCloud Director Cell Monitoring
The following table represents a subset of MBeans that can be used to improve the monitoring performance of a vCloud instance.
Table 4. MBeans Used to Monitor vCloud Cells
Local user sessions
 
MBean
com.vmware.vcloud.diagnostics.UserSessions
Description
Local (cell) user session statistics
Cardinality
1
Instance ID
n/a
Attribute
Description
totalSessions
Total number of sessions created on this cell
successfulLogins
Total number of successful logins to this cell
failedLogins
Total number of failed login requests to this cell
Global user sessions
 
MBean
com.vmware.vcloud.GlobalUserSessionStatistics
Description
List of active user sessions by organization.
Cardinality
1
Instance ID
n/a
Attribute
Description
Organization
Database ID of the organization
Active
Number of active sessions
Open_Session
Number of open sessions
Data access diagnostics
 
MBean
com.vmware.vcloud.diagnostics.DataAccess
Description
Local (cell) user session statistics
Cardinality
1
Instance ID
Conversation
Attribute
Description
lastAccessInfo.objectType
Object type of the last database object accessed
lastAccessInfo.accessTime
Time taken to access the last database object accessed
worstAccessInfo.objectType
Object type of the worst (slowest) database object access
worstAccessInfo.accessTime
Time taken by the worst (slowest) database object access
Database Connection Pool
 
MBean
com.vmware.vcloud.datasource.globalDataSource
Description
Statistics and configuration information about the database connection pool. This information is currently specific to the database JDBC driver being used (Oracle).
Cardinality
1
Instance ID
 
Attribute
Description
abandonedConnectionTimeout
 
availableConnectionsCount
 
borrowedConnectionsCount
 
connectionHarvestMaxCount
 
connectionHarvestTriggerCount
 
connectionPoolName
 
connectionWaitTImeout
 
databaseName
Database connection database name (SID)
dataSourceName
 
fastConnectionFailoverEnabled
 
inactiveConnectionTimeout
 
initialPoolSize
 
loginTImeout
 
maxConnectionReuseCount
 
maxIdleTime
 
maxPoolSize
Maximum number of connections allowed in the pool
maxStatements
 
minPoolSize
Minimum number of connections in the pool
networkProtocol
Network protocol used by JDBC driver
ONSConfiguration
 
portNumber
Database connection port number
SQLForValidateConnection
 
timeoutCheckInterval
 
timeToLiveConnectionTimeout
 
URL
Database connection URL
user
Database connection username
validateConnectionOnBorrow
 
VIM Operations
 
MBean
com.vmware.vcloud.diagnostics.VlsiOperations
Description
Local (cell) user session statistics
Cardinality
1 per VIM end-point (VC or host agent)
Instance ID
VIM end-point URL
Attribute
Description
ObjectType.MethodName.httpTime
The total network round-trip time taken to make the “MethodName” call on object of type “ObjectType” in the VIM endpoint.
Presentation API Methods
 
MBean
com.vmware.vcloud.diagnostics.VlsiOperations
Description
Local (cell) user session statistics
Cardinality
1 per presentation layer method
Instance ID
method name
Attribute
Description
currentInvocations
Currently active invocations
totalFailed
Total number of failed executions
totalInvocations
Total number of invocations over time
executionTime
Total time taken to execute
Jetty
 
MBean
com.vmware.vcloud.diagnostics.Jetty
Description
Web server request statistics
Cardinality
2:1 for REST API and 1 for UI
Instance ID
"UI Requests" for UI, "REST API Requests" for REST API
Attribute
Description
Active
Number of Web requests currently being handled
REST API
 
MBean
com.vmware.vcloud.diagnostics.VlsiOperations
Description
Local (cell) user session statistics
Cardinality
1 per operation stage/granularity: RoundTrip, BasicLogin, Logout, Authentication, SecurityFilter, ConversationFilter, JAXRSServlet. RoundTrip is the most interesting, as it represents the overall REST API performance.
Instance ID
One of: RoundTrip, BasicLogin, Logout, Authentication, SecurityFilter, ConversationFilter, JAXRSServlet
Attribute
Description
currentInvocations
Currently active invocations
totalFailed
Total number of failed executions
totalInvocations
Total number of invocations over time
executionTime
Total time taken to execute
Task Execution
 
MBean
com.vmware.vcloud.diagnostics.TaskExecutionJobs
Description
Statistics about long running tasks
Cardinality
1 per task
Instance ID
Name of task
Attribute
Description
currentInvocations
Currently active invocations
totalFailed
Total number of failed executions
totalInvocations
Total number of invocations over time
executionTime
Total time taken to execute
Query Service (UI)
 
MBean
com.vmware.vcloud.diagnostics.QueryService
Description
Presentation layer query service statistics
Cardinality
1 per query
Instance ID
query name
Attribute
Description
currentInvocations
Currently active invocations
totalFailed
Total number of failed executions
totalInvocations
Total number of invocations over time
executionTime
Total time taken to execute
returnedItems
Number of items returned by successful query executions
VC Task Manager
 
MBean
com.vmware.vcloud.diagnostics.VcTasks
Description
VC task management statistics
Cardinality
1
Instance ID
 
Attribute
Description
successfulTasksCount
total successful tasks
failedTasksCount
total failed tasks
waitForTaskInvocationsCount
total invocations of VIM "wait for task"
completedWaitForTasksCount
total completed task waits
historicalTasksCount
total historical task updates received
vcRetrievedTaskCompletionsCount
total task completions received
taskCompletionMessagesPublishedCount
total task completion messages published on message bus
taskCompletionMessagesReceivedCount
total task completion messages received on message bus
success_elapsedTaskWaitTime
time elapsed for successful tasks
failed_elapsedTaskWaitTIme
time elapsed for failed tasks
VIM Inventory Update Processing – Object Update Statistics
MBean
com.vmware.vcloud.diagnostics.VimInventoryUpdates
Description
Inventory processing statistics
Cardinality
3: one for ObjectUpdate, one for PropertyCollector, and one for UpdateSets
Instance ID
ObjectUpdate
Attribute
Description
totalUpdates
Total number of object updates received
totalFailed
Total number of object updates failed to be processed
executionTime
Time taken for updates
VIM Inventory Events
 
MBean
com.vmware.vcloud.diagnostics.VimInventoryEvents
Description
VIM inventory event manager statistics. Tracks the frequency of common vCenter events.
Cardinality
1 per folder per VC URL, 1 MBean per event name
Instance ID
Event name
Attribute
Description
totalInvocations
Total number of VIM inventory events dispatched since
that vCloud Director cell started
totalFailed
Total number of VIM inventory events that failed to be handled
executionTime
Total time to handle VIM inventory events
VC Object Validations
 
MBean
com.vmware.vcloud.diagnostics.VcValidation
Description
VC object validation statistics
Cardinality
1 global plus 1 per validator
Instance ID
null = global, validator name = per validator
Attribute
Description
totalInvocations
Total number of validation executions
executionTime
Total time spent in validator
totalItemsInQueue
Total items currently queued for validation (global)
objectsInQueue
Total items currently queued for validation (per validator)
objectBusyRequeueCount
Total number of objects re-queued for validation due to
object being busy
loadValidationObjectTime
Time taken to load validation object
duplicatesDiscarded
Total number of discarded duplicate validations
VC Object Validation Reactions
 
MBean
com.vmware.vcloud.diagnostics.Reactions
Description
validation reaction statistics
Cardinality
1 global plus 1 per reaction
Instance ID
null = global, reaction name = per reaction
Attribute
Description
totalReactionsFired
Total number of reaction executions
requeueCount
Total number of reactions re-queued due to objects being busy
totalInvocations
Total number of executions of this reaction
executionTime
Total time spent in reaction
failedReactions
Total number of failed reactions
objectRequeueCount
Number of times this reaction was re-queued due to objects
being busy
VC Connections
 
MBean
com.vmware.vcloud.diagnostics.VimConnection
Description
Local (cell) user session statistics
Cardinality
1 per VC
Instance ID
"VC-VcInstanceId" where VcInstanceId is an integer identifying
the vCenter instance
Attribute
Description
Connected Count
Total successful connections
Disconnected Count
Total disconnections
Start Count
Total number of times the VC listener was started
UI Vim Reconnect Count
Total number of times the VC was reconnected through the UI
ActiveMQ
 
MBean
com.vmware.vcloud.diagnostics.ActiveMQ
Description
ActiveMQ (message bus) statistics
Cardinality
1 global and 1 per peer vCloud Director cell (each cell other than the current one)
Instance ID
"Global" = global statistics"to_cellName_cellPrimaryIp_cellUUID"=per cell
Attribute
Description
lastHealthCheckDate
Last time health check was performed (date/time)
messageRoundTripDurationMs
Time taken for an echo message to be sent and returned (ms)
isHealthy
Health of connection to peer cell in the case of the per-cell MBean, overall message bus connection health in the case of the global MBean (true/false)
timedOutMessages
Total number of echo messages for which no reply was received within the timeout (controlled by the activeMonitorCheckDelayMs config parameter, default 10 minutes)
sendErrors
Total number of failed echo message sends (messages)
corruptedOrBadEchoMessages
Total number of corrupted/bad echo messages received (starts)_ (messages)
Transfer Server
 
MBean
com.vmware.vcloud.diagnostics.VlsiOperations
Description
Transfer server statistics
Cardinality
1
Instance ID
 
Attribute
Description
successfulPuts
Number of items successfully transferred (transfer items)
failedPuts
Number of items that failed to be transferred (transfer items)
successfulUploads
Number of successful upload operations (uploads)
acceptedQuarantinedTransferSessions
Number of quarantined transfers which were accepted (quarantined items)
rejectedQuarantinedTransferSessions
Number of quarantined transfers which were rejected (quarantined items)
expiredTransferSessions
Number of transfer sessions which timed out (transfer sessions)