Metrics Entry Object

The Metrics Entry object expresses a single metric, with its values for utilization and capacity. You should be aware of the following points concerning metrics:

  • The given metric types are all types that Turbonomic supports natively in its supply chain with the exception of kpi metrics

  • The kpi metric is for Key Performance Indicators. You can track any indicator you want, against a capacity that you specify. Charts will include this metric, and will show the percentage of capacity your entities are utilizing. For example, you could track the number of issues for a given application, and charts would show when the too many issues are currently open. Note that these metrics do not affect Turbonomic analysis or the actions it generates.

  • For native metrics that you track for your entities, charts display the values. However, these metrics do not affect Turbonomic analysis or the actions it generates.

  • Not all metric types make sense for all entity types. For example, dbMem makes sense for databaseServer entities, but not for a businessTransaction entity. For more information, see Commodities Bought and Sold by Entities.

Each metrics entry object is of a specific type. For each type, you express the average, min, max, and capacity values in a specific metruc unit. The following table describes each metric type:

kpi

Key Performance Indicator

Metric Unit: count

A custom metric that you can use to track entities by different criteria. For example, you can use kpi to track the number of support tickets that are open for a given application.

The key that you provide gives the name of the metric that you will see in charts and tables in the Turbonomic user interface.

responseTime

Response Time

Metric Unit: ms

A measure of the time it takes for an entity (for example, an application or a service) to process a transaction.

transaction

Transactions Per Second

Metric Unit: tps

connections

Concurrent Connections

Metric Unit: count

heap

Amount of Heap in Use

Metric Unit: mb

collectionTime

Time Spent on Garbage Collection

Metric Unit: pct

For a 10 minute period, the percentage of that time that is spent on garbage collection.

cpu

Utilization of CPU Capacity

Metric Unit: mhz

The schema specifies a rawData object for this metric. The rawData is not used at this time.

memory

Utilization of Memory

Metric Unit: mb

The schema specifies a rawData object for this metric. The rawData is not used at this time.

threads

Concurrent Threads for the Entity

Metric Unit: count

cacheHitRate

Rate of Data Requests Satisfied by Cache

Metric Unit:

Percentage of data requests that are satisfied by the database cache, where a greater value indicates fewer disk reads for data. The capacity is assumed to be 100% – You do not need to provide a value for capacity.

dbMem

Utilization of Database Memory

Metric Unit: mb

When a database has its own allocated capacity of memory, this tracks the utilization of that capacity.