Euca2ools Guide / CloudWatch-Compatible Commands |
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.
euwatch-list-metrics [--dimensions "key1=value1,key2=value2..." ] [--metric-name value ] [--namespace value ]
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 |
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. |
Eucalyptus returns a table that contains the following information:
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} ...