org.hawkular.btm.api.services

Interface AnalyticsService

All Known Implementing Classes:

AbstractAnalyticsService

public interface AnalyticsService

This interface represents the available analytics capabilities.

Author:

gbrown

Method Summary

Modifier and Type	Method and Description
int	getAlertCount(String tenantId, String name) This method returns the number of alerts associated with the specified business transaction.
List<String>	getBoundURIs(String tenantId, String businessTransaction, long startTime, long endTime) This method returns the bound URIs associated with a business transaction.
long	getCompletionCount(String tenantId, CompletionTimeCriteria criteria) This method returns the number of completed transactions, of the specified named business transaction, that were executed during the time range.
long	getCompletionFaultCount(String tenantId, CompletionTimeCriteria criteria) This method returns the number of completed transactions, of the specified named business transaction, that were executed during the time range and returned a fault.
List<Cardinality>	getCompletionFaultDetails(String tenantId, CompletionTimeCriteria criteria) This method returns the completion time fault details, for the specified criteria, that were executed during the time range.
Percentiles	getCompletionPercentiles(String tenantId, CompletionTimeCriteria criteria) This method returns the completion time percentiles, for the specified criteria, that were executed during the time range.
List<Cardinality>	getCompletionPropertyDetails(String tenantId, CompletionTimeCriteria criteria, String property) This method returns the completion time property details, for the specified criteria, that were executed during the time range.
List<CompletionTimeseriesStatistics>	getCompletionTimeseriesStatistics(String tenantId, CompletionTimeCriteria criteria, long interval) This method returns the completion timeseries statistics, for the specified criteria, that were executed during the time range.
List<String>	getHostNames(String tenantId, BaseCriteria criteria) This method returns the list of host names where activities were executed, subject to the supplied criteria.
List<NodeSummaryStatistics>	getNodeSummaryStatistics(String tenantId, NodeCriteria criteria) This method returns the node summary statistics, for the specified criteria, that were executed during the time range.
List<NodeTimeseriesStatistics>	getNodeTimeseriesStatistics(String tenantId, NodeCriteria criteria, long interval) This method returns the node timeseries statistics, for the specified criteria, that were executed during the time range.
List<PropertyInfo>	getPropertyInfo(String tenantId, String businessTransaction, long startTime, long endTime) This method returns the properties associated with a business transaction during the specified time range.
List<URIInfo>	getUnboundURIs(String tenantId, long startTime, long endTime, boolean compress) This method returns the unbound URIs (i.e.
void	storeCompletionTimes(String tenantId, List<CompletionTime> completionTimes) This method stores the supplied list of completion times.
void	storeNodeDetails(String tenantId, List<NodeDetails> nodeDetails) This method stores the supplied list of node details.

Method Detail

getUnboundURIs

List<URIInfo> getUnboundURIs(String tenantId,
                             long startTime,
                             long endTime,
                             boolean compress)

This method returns the unbound URIs (i.e. ones not associated with a business transaction).

Parameters:

tenantId - The optional tenant id

startTime - The start time

endTime - The end time (if 0, then current time)

compress - Whether to compress the list and show common patterns

Returns:

The unbound URIs

getBoundURIs

List<String> getBoundURIs(String tenantId,
                          String businessTransaction,
                          long startTime,
                          long endTime)

This method returns the bound URIs associated with a business transaction.

Parameters:

tenantId - The optional tenant id

businessTransaction - The business transaction name

startTime - The start time

endTime - The end time (if 0, then current time)

Returns:

The bound URIs

getPropertyInfo

List<PropertyInfo> getPropertyInfo(String tenantId,
                                   String businessTransaction,
                                   long startTime,
                                   long endTime)

This method returns the properties associated with a business transaction during the specified time range.

Parameters:

tenantId - The optional tenant id

businessTransaction - The business transaction name

startTime - The start time

endTime - The end time (if 0, then current time)

Returns:

The list of property info

getCompletionCount

long getCompletionCount(String tenantId,
                        CompletionTimeCriteria criteria)

This method returns the number of completed transactions, of the specified named business transaction, that were executed during the time range. The business transaction name must be specified as part of the criteria.

Parameters:

tenantId - The tenant id

criteria - The criteria

Returns:

The transaction count

getCompletionFaultCount

long getCompletionFaultCount(String tenantId,
                             CompletionTimeCriteria criteria)

This method returns the number of completed transactions, of the specified named business transaction, that were executed during the time range and returned a fault. The business transaction name must be specified as part of the criteria.

Parameters:

tenantId - The tenant id

criteria - The criteria

Returns:

The transaction fault count

getCompletionPercentiles

Percentiles getCompletionPercentiles(String tenantId,
                                     CompletionTimeCriteria criteria)

This method returns the completion time percentiles, for the specified criteria, that were executed during the time range. The business transaction name must be specified as part of the criteria.

Parameters:

tenantId - The tenant id

criteria - The criteria

Returns:

The completion time percentiles

getCompletionTimeseriesStatistics

List<CompletionTimeseriesStatistics> getCompletionTimeseriesStatistics(String tenantId,
                                                                       CompletionTimeCriteria criteria,
                                                                       long interval)

This method returns the completion timeseries statistics, for the specified criteria, that were executed during the time range. The business transaction name must be specified as part of the criteria.

Parameters:

tenantId - The tenant id

criteria - The criteria

interval - The aggregation interval (in milliseconds)

Returns:

The completion timeseries statistics

getCompletionFaultDetails

List<Cardinality> getCompletionFaultDetails(String tenantId,
                                            CompletionTimeCriteria criteria)

This method returns the completion time fault details, for the specified criteria, that were executed during the time range. The business transaction name must be specified as part of the criteria.

Parameters:

tenantId - The tenant id

criteria - The criteria

Returns:

The completion time fault details

getCompletionPropertyDetails

List<Cardinality> getCompletionPropertyDetails(String tenantId,
                                               CompletionTimeCriteria criteria,
                                               String property)

This method returns the completion time property details, for the specified criteria, that were executed during the time range. The business transaction name must be specified as part of the criteria.

Parameters:

tenantId - The tenant id

criteria - The criteria

property - The property name

Returns:

The completion time property details

getAlertCount

int getAlertCount(String tenantId,
                  String name)

This method returns the number of alerts associated with the specified business transaction.

Parameters:

tenantId - The tenant id

name - The business transaction name

Returns:

The number of alerts

getNodeTimeseriesStatistics

List<NodeTimeseriesStatistics> getNodeTimeseriesStatistics(String tenantId,
                                                           NodeCriteria criteria,
                                                           long interval)

This method returns the node timeseries statistics, for the specified criteria, that were executed during the time range.

Parameters:

tenantId - The tenant id

criteria - The criteria

interval - The aggregation interval (in milliseconds)

Returns:

The node timeseries statistics

getNodeSummaryStatistics

List<NodeSummaryStatistics> getNodeSummaryStatistics(String tenantId,
                                                     NodeCriteria criteria)

This method returns the node summary statistics, for the specified criteria, that were executed during the time range.

Parameters:

tenantId - The tenant id

criteria - The criteria

Returns:

The node summary statistics

storeNodeDetails

void storeNodeDetails(String tenantId,
                      List<NodeDetails> nodeDetails)
               throws Exception

This method stores the supplied list of node details.

Parameters:

tenantId - The tenant id

nodeDetails - The node details

Throws:

Exception - Failed to store

storeCompletionTimes

void storeCompletionTimes(String tenantId,
                          List<CompletionTime> completionTimes)
                   throws Exception

This method stores the supplied list of completion times.

Parameters:

tenantId - The tenant id

completionTimes - The completion times

Throws:

Exception - Failed to store

getHostNames

List<String> getHostNames(String tenantId,
                          BaseCriteria criteria)

This method returns the list of host names where activities were executed, subject to the supplied criteria.

Parameters:

tenantId - The tenant id

criteria - The criteria

Returns:

The list of host names