Package com.amazonaws.metrics
Class MetricAdmin
java.lang.Object
com.amazonaws.metrics.MetricAdmin
- All Implemented Interfaces:
MetricAdminMBean
Administration of AwsSdkMetrics as an MBean.
-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionvoidDisables the metric collector at the AWS SDK level.booleanStarts the default AWS SDK metric collector, but only if no metric collector is currently in use at the AWS SDK level.Returns the last set AWS credential file; or null if there is none.Returns the host name for metric purposes.Returns the JVM metric name.Returns the metric name space.Returns the internal metric queue size to be used for the default AWS SDK metric collector; or null if the default is to be used.Returns the internal metric queue timeout in millisecond to be used for the default AWS SDK metric collector; or null if the default is to be used.Returns the region configured for the default AWS SDK metric collector; or null if the default is to be used.Returns the name of the request metric collector set at the AWS SDK level, or NONE if there is none.Returns the name of the service metric collector set at the AWS SDK level, or NONE if there is none.booleanReturns true if machine metrics is to be excluded; false otherwise.booleanReturns true if metrics at the AWS SDK level is enabled; false if disabled.booleanReturns true if per-host metrics is to be included; false otherwise.booleanReturns true if single metric name space is to be used; false otherwise.voidsetCredentialFile(String filepath) Sets the AWS credential file used by the default AWS SDK metric collector for accessing CloudWatch.voidsetHostMetricName(String hostMetricName) Sets the host name to enable per-host level metrics generation.voidsetJvmMetricName(String jvmMetricName) Sets the JVM metric name to enable per-JVM level metrics generation.voidsetMachineMetricsExcluded(boolean excludeJvmMetrics) Used to set whether the JVM metrics is to be excluded.voidsetMetricNameSpace(String metricNameSpace) Sets the metric name space.voidsetMetricQueueSize(Integer metricQueueSize) Sets the metric queue size to be used for the default AWS SDK metric collector; or null if the default is to be used.voidsetPerHostMetricsIncluded(boolean includePerHostMetrics) Used to set whether the per-host metrics is to be included.voidsetQueuePollTimeoutMilli(Integer timeoutMilli) Sets the queue poll time in millisecond to be used for the default AWS SDK metric collector; or null if the default is to be used.voidSets the region to be used for the default AWS SDK metric collector; or null if the default is to be used.voidsetSingleMetricNamespace(boolean singleMetricNamespace) Used to set whether a single metric name space is to be used.
-
Constructor Details
-
MetricAdmin
public MetricAdmin()
-
-
Method Details
-
enableDefaultMetrics
public boolean enableDefaultMetrics()Description copied from interface:MetricAdminMBeanStarts the default AWS SDK metric collector, but only if no metric collector is currently in use at the AWS SDK level.- Specified by:
enableDefaultMetricsin interfaceMetricAdminMBean- Returns:
- true if the default AWS SDK metric collector has been successfully started by this call; false otherwise.
-
disableMetrics
public void disableMetrics()Description copied from interface:MetricAdminMBeanDisables the metric collector at the AWS SDK level.- Specified by:
disableMetricsin interfaceMetricAdminMBean
-
getRequestMetricCollector
Description copied from interface:MetricAdminMBeanReturns the name of the request metric collector set at the AWS SDK level, or NONE if there is none.- Specified by:
getRequestMetricCollectorin interfaceMetricAdminMBean
-
getServiceMetricCollector
Description copied from interface:MetricAdminMBeanReturns the name of the service metric collector set at the AWS SDK level, or NONE if there is none.- Specified by:
getServiceMetricCollectorin interfaceMetricAdminMBean
-
isMetricsEnabled
public boolean isMetricsEnabled()Description copied from interface:MetricAdminMBeanReturns true if metrics at the AWS SDK level is enabled; false if disabled.- Specified by:
isMetricsEnabledin interfaceMetricAdminMBean
-
isMachineMetricsExcluded
public boolean isMachineMetricsExcluded()Description copied from interface:MetricAdminMBeanReturns true if machine metrics is to be excluded; false otherwise.- Specified by:
isMachineMetricsExcludedin interfaceMetricAdminMBean
-
setMachineMetricsExcluded
public void setMachineMetricsExcluded(boolean excludeJvmMetrics) Description copied from interface:MetricAdminMBeanUsed to set whether the JVM metrics is to be excluded.- Specified by:
setMachineMetricsExcludedin interfaceMetricAdminMBean- Parameters:
excludeJvmMetrics- true if JVM metrics is to be excluded; false otherwise.
-
getRegion
Description copied from interface:MetricAdminMBeanReturns the region configured for the default AWS SDK metric collector; or null if the default is to be used.- Specified by:
getRegionin interfaceMetricAdminMBean
-
setRegion
Description copied from interface:MetricAdminMBeanSets the region to be used for the default AWS SDK metric collector; or null if the default is to be used.- Specified by:
setRegionin interfaceMetricAdminMBean
-
getMetricQueueSize
Description copied from interface:MetricAdminMBeanReturns the internal metric queue size to be used for the default AWS SDK metric collector; or null if the default is to be used.- Specified by:
getMetricQueueSizein interfaceMetricAdminMBean
-
setMetricQueueSize
Description copied from interface:MetricAdminMBeanSets the metric queue size to be used for the default AWS SDK metric collector; or null if the default is to be used.- Specified by:
setMetricQueueSizein interfaceMetricAdminMBean
-
getQueuePollTimeoutMilli
Description copied from interface:MetricAdminMBeanReturns the internal metric queue timeout in millisecond to be used for the default AWS SDK metric collector; or null if the default is to be used. Use Integer instead of Long as it seems jconsole does not handle Long properly.- Specified by:
getQueuePollTimeoutMilliin interfaceMetricAdminMBean
-
setQueuePollTimeoutMilli
Description copied from interface:MetricAdminMBeanSets the queue poll time in millisecond to be used for the default AWS SDK metric collector; or null if the default is to be used. Use Integer instead of Long as it seems jconsole does not handle Long properly.- Specified by:
setQueuePollTimeoutMilliin interfaceMetricAdminMBean
-
getMetricNameSpace
Description copied from interface:MetricAdminMBeanReturns the metric name space.- Specified by:
getMetricNameSpacein interfaceMetricAdminMBean
-
setMetricNameSpace
Description copied from interface:MetricAdminMBeanSets the metric name space.- Specified by:
setMetricNameSpacein interfaceMetricAdminMBean
-
isPerHostMetricsIncluded
public boolean isPerHostMetricsIncluded()Description copied from interface:MetricAdminMBeanReturns true if per-host metrics is to be included; false otherwise.- Specified by:
isPerHostMetricsIncludedin interfaceMetricAdminMBean
-
setPerHostMetricsIncluded
public void setPerHostMetricsIncluded(boolean includePerHostMetrics) Description copied from interface:MetricAdminMBeanUsed to set whether the per-host metrics is to be included.- Specified by:
setPerHostMetricsIncludedin interfaceMetricAdminMBean- Parameters:
includePerHostMetrics- true if per-host metrics is to be included; false otherwise.
-
getJvmMetricName
Description copied from interface:MetricAdminMBeanReturns the JVM metric name. If the returned value is either null or blank, no JVM level metrics will be generated.- Specified by:
getJvmMetricNamein interfaceMetricAdminMBean
-
setJvmMetricName
Description copied from interface:MetricAdminMBeanSets the JVM metric name to enable per-JVM level metrics generation. If the given value is either null or blank, no JVM level metrics will be generated.- Specified by:
setJvmMetricNamein interfaceMetricAdminMBean
-
getHostMetricName
Description copied from interface:MetricAdminMBeanReturns the host name for metric purposes. If the returned value is either null or blank, the host name will be automatically detected viaInetAddress.- Specified by:
getHostMetricNamein interfaceMetricAdminMBean
-
setHostMetricName
Description copied from interface:MetricAdminMBeanSets the host name to enable per-host level metrics generation. If the given value is either null or blank but the per-host metric is enabled, the host name will be automatically detected viaInetAddress.- Specified by:
setHostMetricNamein interfaceMetricAdminMBean
-
getCredentialFile
Description copied from interface:MetricAdminMBeanReturns the last set AWS credential file; or null if there is none.- Specified by:
getCredentialFilein interfaceMetricAdminMBean
-
setCredentialFile
Description copied from interface:MetricAdminMBeanSets the AWS credential file used by the default AWS SDK metric collector for accessing CloudWatch.- Specified by:
setCredentialFilein interfaceMetricAdminMBean- Parameters:
filepath- must be a valid path to an AWS credential property file.- Throws:
FileNotFoundExceptionIOException
-
isSingleMetricNamespace
public boolean isSingleMetricNamespace()Description copied from interface:MetricAdminMBeanReturns true if single metric name space is to be used; false otherwise.- Specified by:
isSingleMetricNamespacein interfaceMetricAdminMBean
-
setSingleMetricNamespace
public void setSingleMetricNamespace(boolean singleMetricNamespace) Description copied from interface:MetricAdminMBeanUsed to set whether a single metric name space is to be used.- Specified by:
setSingleMetricNamespacein interfaceMetricAdminMBean
-