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:

Metric Name: name of the metric attached to this metric.
Namespace: namespace associated with this metric.
Dimensions: list of the dimension names and values associated with this metric.

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}
...