euwatch-list-metrics

Lists the metrics associated with your account. You can filter metrics by using any combination of MetricName, Namespace, or Dimensions. If a you do not specify a filter, Eucalyptus returns all possible matches for the attribute. Note that any metric not seen for two weeks will expire and be removed from from this list.

Syntax

euwatch-list-metrics [--dimensions  "key1=value1,key2=value2..." ]
[--metric-name  value ] [--namespace  value ] 

Options

Option Description Required
-d, --dimensions "key1=value1,key2=value2..." Dimensions (one or more) along which the metric names are to be filtered. If you do not specify a dimension, Eucalyptus returns metric names with all possible dimensions. No
-m, --metric-name value Metric name that you want data for. If you do not specify a metric, Eucalyptus returns all possible metric names. No
-n, --namespace value Namespace along which metrics will be filtered. If you do not specify, Eucalyptus returns metric names from all possible namespaces. No

Common Options

Option Description
--show-empty-fields Show empty fields using (nil) as a placeholder to indicate that this data was not requested. Empty fields are not shown by default.
--region value Specify region value as the cloud region to use. You can set this by using the environment variable AWS_DEFAULT_REGION.
-U,--url value Overrides the URL for the service call with the value entered. You can set this by using the environment variable AWS_AUTOSCALING_URL.
-I, --access-key-id value User's access key ID
-S, --secret-key value User's AWS secret Key to use.
--debug Prints what the command sends to the server and what it receives from the server. Use when you're trying to debug Euca2ools.
--debugger Enable interactive debugger on error.
--version Display the version of this tool.
-h,--help Display the manual page for the command.

Output

Eucalyptus returns a table that contains the following information:

Examples

The following example returns a list of all your metrics.

euwatch-list-metrics

The following example returns a list of all your metrics for a specified metric name.

euwatch-list-metrics --metric-name RequestCount

The following example returns a list of all your metrics for a specified namespace.

euwatch-list-metrics --namespace MyService

The following example returns a list of all your metrics for specified dimension names and values.

euwatch-list-metrics --dimensions "User=TestUser,Stack=Test"

The following is an example of the output.

Metric Name                 Namespace  Dimensions
CPUUtilization               AWS/EC2    {InstanceId=i-e7e48a8e}
CPUUtilization               AWS/EC2    {InstanceId=i-231d744a}
CPUUtilization               AWS/EC2    {InstanceId=i-22016e4b}
CPUUtilization               AWS/EC2    {InstanceId=i-b0345cd9}
CPUUtilization               AWS/EC2    {InstanceId=i-539dff3a}
CPUUtilization               AWS/EC2    {InstanceId=i-af3544c6}
CPUUtilization               AWS/EC2    {InstanceId=i-d4f29ebd}
CPUUtilization               AWS/EC2    {ImageId=ami-de4daab7}
...
x