Atom feed of this document
  
 

 Chapter 11. Telemetry command-line client

The ceilometer client is the command-line interface (CLI) for the Telemetry API and its extensions. This chapter documents ceilometer version 1.0.10.

For help on a specific ceilometer command, enter:

$ ceilometer help COMMAND

 ceilometer usage

usage: ceilometer [--version] [-d] [-v] [-k] [--cert-file CERT_FILE]
                  [--key-file KEY_FILE] [--os-cacert <ca-certificate-file>]
                  [--ca-file OS_CACERT] [--timeout TIMEOUT]
                  [--os-username OS_USERNAME] [--os-password OS_PASSWORD]
                  [--os-tenant-id OS_TENANT_ID]
                  [--os-tenant-name OS_TENANT_NAME]
                  [--os-auth-url OS_AUTH_URL]
                  [--os-region-name OS_REGION_NAME]
                  [--os-auth-token OS_AUTH_TOKEN]
                  [--ceilometer-url CEILOMETER_URL]
                  [--ceilometer-api-version CEILOMETER_API_VERSION]
                  [--os-service-type OS_SERVICE_TYPE]
                  [--os-endpoint-type OS_ENDPOINT_TYPE]
                  <subcommand> ...

Subcommands

alarm-combination-create

Create a new alarm based on state of other alarms.

alarm-combination-update

Update an existing alarm based on state of other alarms.

alarm-create

Create a new alarm (Deprecated). Use alarm-threshold- create instead.

alarm-delete

Delete an alarm.

alarm-history

Display the change history of an alarm.

alarm-list

List the user's alarms.

alarm-show

Show an alarm.

alarm-state-get

Get the state of an alarm.

alarm-state-set

Set the state of an alarm.

alarm-threshold-create

Create a new alarm based on computed statistics.

alarm-threshold-update

Update an existing alarm based on computed statistics.

alarm-update

Update an existing alarm (Deprecated).

event-list

List events.

event-show

Show a particular event.

event-type-list

List event types.

meter-list

List the user's meters.

query-alarm-history

Query Alarm History.

query-alarms

Query Alarms.

query-samples

Query samples.

resource-list

List the resources.

resource-show

Show the resource.

sample-create

Create a sample.

sample-list

List the samples for a meter.

statistics

List the statistics for a meter.

trait-description-list

List trait info for an event type.

trait-list

List trait all traits with name <trait_name> for Event Type

bash-completion

Prints all of the commands and options to stdout.

help

Display help about this program or one of its subcommands.

 ceilometer optional arguments

--version

show program's version number and exit

-d, --debug

Defaults to env[CEILOMETERCLIENT_DEBUG].

-v, --verbose

Print more verbose output.

-k, --insecure

Explicitly allow ceilometerclient to perform "insecure" SSL (https) requests. The server's certificate will not be verified against any certificate authorities. This option should be used with caution.

--cert-file CERT_FILE

Path of certificate file to use in SSL connection. This file can optionally be prepended with the private key.

--key-file KEY_FILE

Path of client key to use in SSL connection. This option is not necessary if your key is prepended to your cert file.

--os-cacert <ca-certificate-file>

Path of CA TLS certificate(s) used to verifythe remote server's certificate. Without this option ceilometer looks for the default system CA certificates.

--ca-file OS_CACERT

DEPRECATED! Use --os-cacert.

--timeout TIMEOUT

Number of seconds to wait for a response.

--os-username OS_USERNAME

Defaults to env[OS_USERNAME].

--os-password OS_PASSWORD

Defaults to env[OS_PASSWORD].

--os-tenant-id OS_TENANT_ID

Defaults to env[OS_TENANT_ID].

--os-tenant-name OS_TENANT_NAME

Defaults to env[OS_TENANT_NAME].

--os-auth-url OS_AUTH_URL

Defaults to env[OS_AUTH_URL].

--os-region-name OS_REGION_NAME

Defaults to env[OS_REGION_NAME].

--os-auth-token OS_AUTH_TOKEN

Defaults to env[OS_AUTH_TOKEN].

--ceilometer-url CEILOMETER_URL

Defaults to env[CEILOMETER_URL].

--ceilometer-api-version CEILOMETER_API_VERSION

Defaults to env[CEILOMETER_API_VERSION] or 2.

--os-service-type OS_SERVICE_TYPE

Defaults to env[OS_SERVICE_TYPE].

--os-endpoint-type OS_ENDPOINT_TYPE

Defaults to env[OS_ENDPOINT_TYPE].

 ceilometer alarm-combination-create command

usage: ceilometer alarm-combination-create --name <NAME>
                                           [--project-id <PROJECT_ID>]
                                           [--user-id <USER_ID>]
                                           [--description <DESCRIPTION>]
                                           [--state <STATE>]
                                           [--enabled {True|False}]
                                           [--alarm-action <Webhook URL>]
                                           [--ok-action <Webhook URL>]
                                           [--insufficient-data-action <Webhook URL>]
                                           [--time-constraint <Time Constraint>]
                                           --alarm_ids <ALARM IDS>
                                           [--operator <OPERATOR>]
                                           [--repeat-actions {True|False}]
        

Create a new alarm based on state of other alarms.

Optional arguments

--name <NAME>

Name of the alarm (must be unique per tenant). Required.

--project-id <PROJECT_ID>

Tenant to associate with alarm (only settable by admin users).

--user-id <USER_ID>

User to associate with alarm (only settable by admin users).

--description <DESCRIPTION>

Free text description of the alarm.

--state <STATE>

State of the alarm, one of: ['ok', 'alarm', 'insufficient_data']

--enabled {True|False}

True if alarm evaluation/actioning is enabled.

--alarm-action <Webhook URL>

URL to invoke when state transitions to alarm. May be used multiple times. Defaults to None.

--ok-action <Webhook URL>

URL to invoke when state transitions to OK. May be used multiple times. Defaults to None.

--insufficient-data-action <Webhook URL>

URL to invoke when state transitions to insufficient_data. May be used multiple times. Defaults to None.

--time-constraint <Time Constraint>

Only evaluate the alarm if the time at evaluation is within this time constraint. Start point(s) of the constraint are specified with a cron expression , whereas its duration is given in seconds. Can be specified multiple times for multiple time constraints, format is: name=<CONSTRAINT_NAME>;start=< CRON>;duration=<SECONDS>;[description=<DESCRIPTION>;[t imezone=<IANA Timezone>]] Defaults to None.

--alarm_ids <ALARM IDS>

List of alarm ids. Required.

--operator <OPERATOR>

Operator to compare with, one of: ['and', 'or'].

--repeat-actions {True|False}

True if actions should be repeatedly notified while alarm remains in target state. Defaults to False.

 ceilometer alarm-combination-update command

usage: ceilometer alarm-combination-update -a <ALARM_ID> [--name <NAME>]
                                           [--project-id <PROJECT_ID>]
                                           [--user-id <USER_ID>]
                                           [--description <DESCRIPTION>]
                                           [--state <STATE>]
                                           [--enabled {True|False}]
                                           [--alarm-action <Webhook URL>]
                                           [--ok-action <Webhook URL>]
                                           [--insufficient-data-action <Webhook URL>]
                                           [--time-constraint <Time Constraint>]
                                           [--remove-time-constraint <Constraint names>]
                                           [--alarm_ids <ALARM IDS>]
                                           [--operator <OPERATOR>]
                                           [--repeat-actions {True|False}]
        

Update an existing alarm based on state of other alarms.

Optional arguments

-a <ALARM_ID>, --alarm_id <ALARM_ID>

ID of the alarm to update. Required.

--name <NAME>

Name of the alarm (must be unique per tenant).

--project-id <PROJECT_ID>

Tenant to associate with alarm (only settable by admin users).

--user-id <USER_ID>

User to associate with alarm (only settable by admin users).

--description <DESCRIPTION>

Free text description of the alarm.

--state <STATE>

State of the alarm, one of: ['ok', 'alarm', 'insufficient_data']

--enabled {True|False}

True if alarm evaluation/actioning is enabled.

--alarm-action <Webhook URL>

URL to invoke when state transitions to alarm. May be used multiple times. Defaults to None.

--ok-action <Webhook URL>

URL to invoke when state transitions to OK. May be used multiple times. Defaults to None.

--insufficient-data-action <Webhook URL>

URL to invoke when state transitions to insufficient_data. May be used multiple times. Defaults to None.

--time-constraint <Time Constraint>

Only evaluate the alarm if the time at evaluation is within this time constraint. Start point(s) of the constraint are specified with a cron expression , whereas its duration is given in seconds. Can be specified multiple times for multiple time constraints, format is: name=<CONSTRAINT_NAME>;start=< CRON>;duration=<SECONDS>;[description=<DESCRIPTION>;[t imezone=<IANA Timezone>]] Defaults to None.

--remove-time-constraint <Constraint names>

Name or list of names of the time constraints to remove.

--alarm_ids <ALARM IDS>

List of alarm id.

--operator <OPERATOR>

Operator to compare with, one of: ['and', 'or'].

--repeat-actions {True|False}

True if actions should be repeatedly notified while alarm remains in target state.

 ceilometer alarm-delete command

usage: ceilometer alarm-delete -a <ALARM_ID>
        

Delete an alarm.

Optional arguments

-a <ALARM_ID>, --alarm_id <ALARM_ID>

ID of the alarm to delete. Required.

 ceilometer alarm-history command

usage: ceilometer alarm-history -a <ALARM_ID> [-q <QUERY>]
        

Display the change history of an alarm.

Optional arguments

-a <ALARM_ID>, --alarm_id <ALARM_ID>

ID of the alarm for which history is shown. Required.

-q <QUERY>, --query <QUERY>

key[op]data_type::value; list. data_type is optional, but if supplied must be string, integer, float, or boolean.

 ceilometer alarm-list command

usage: ceilometer alarm-list [-q <QUERY>]
        

List the user's alarms.

Optional arguments

-q <QUERY>, --query <QUERY>

key[op]data_type::value; list. data_type is optional, but if supplied must be string, integer, float, or boolean.

 ceilometer alarm-show command

usage: ceilometer alarm-show -a <ALARM_ID>
        

Show an alarm.

Optional arguments

-a <ALARM_ID>, --alarm_id <ALARM_ID>

ID of the alarm to show. Required.

 ceilometer alarm-state-get command

usage: ceilometer alarm-state-get -a <ALARM_ID>
        

Get the state of an alarm.

Optional arguments

-a <ALARM_ID>, --alarm_id <ALARM_ID>

ID of the alarm state to show. Required.

 ceilometer alarm-state-set command

usage: ceilometer alarm-state-set -a <ALARM_ID> --state <STATE>
        

Set the state of an alarm.

Optional arguments

-a <ALARM_ID>, --alarm_id <ALARM_ID>

ID of the alarm state to set. Required.

--state <STATE>

State of the alarm, one of: ['ok', 'alarm', 'insufficient_data']. Required.

 ceilometer alarm-threshold-create command

usage: ceilometer alarm-threshold-create --name <NAME>
                                         [--project-id <PROJECT_ID>]
                                         [--user-id <USER_ID>]
                                         [--description <DESCRIPTION>]
                                         [--state <STATE>]
                                         [--enabled {True|False}]
                                         [--alarm-action <Webhook URL>]
                                         [--ok-action <Webhook URL>]
                                         [--insufficient-data-action <Webhook URL>]
                                         [--time-constraint <Time Constraint>]
                                         -m <METRIC> [--period <PERIOD>]
                                         [--evaluation-periods <COUNT>]
                                         [--statistic <STATISTIC>]
                                         [--comparison-operator <OPERATOR>]
                                         --threshold <THRESHOLD> [-q <QUERY>]
                                         [--repeat-actions {True|False}]
        

Create a new alarm based on computed statistics.

Optional arguments

--name <NAME>

Name of the alarm (must be unique per tenant). Required.

--project-id <PROJECT_ID>

Tenant to associate with alarm (only settable by admin users).

--user-id <USER_ID>

User to associate with alarm (only settable by admin users).

--description <DESCRIPTION>

Free text description of the alarm.

--state <STATE>

State of the alarm, one of: ['ok', 'alarm', 'insufficient_data']

--enabled {True|False}

True if alarm evaluation/actioning is enabled.

--alarm-action <Webhook URL>

URL to invoke when state transitions to alarm. May be used multiple times. Defaults to None.

--ok-action <Webhook URL>

URL to invoke when state transitions to OK. May be used multiple times. Defaults to None.

--insufficient-data-action <Webhook URL>

URL to invoke when state transitions to insufficient_data. May be used multiple times. Defaults to None.

--time-constraint <Time Constraint>

Only evaluate the alarm if the time at evaluation is within this time constraint. Start point(s) of the constraint are specified with a cron expression , whereas its duration is given in seconds. Can be specified multiple times for multiple time constraints, format is: name=<CONSTRAINT_NAME>;start=< CRON>;duration=<SECONDS>;[description=<DESCRIPTION>;[t imezone=<IANA Timezone>]] Defaults to None.

-m <METRIC>, --meter-name <METRIC>

Metric to evaluate against. Required.

--period <PERIOD>

Length of each period (seconds) to evaluate over.

--evaluation-periods <COUNT>

Number of periods to evaluate over.

--statistic <STATISTIC>

Statistic to evaluate, one of: ['max', 'min', 'avg', 'sum', 'count'].

--comparison-operator <OPERATOR>

Operator to compare with, one of: ['lt', 'le', 'eq', 'ne', 'ge', 'gt'].

--threshold <THRESHOLD>

Threshold to evaluate against. Required.

-q <QUERY>, --query <QUERY>

key[op]data_type::value; list. data_type is optional, but if supplied must be string, integer, float, or boolean.

--repeat-actions {True|False}

True if actions should be repeatedly notified while alarm remains in target state. Defaults to False.

 ceilometer alarm-threshold-update command

usage: ceilometer alarm-threshold-update -a <ALARM_ID> [--name <NAME>]
                                         [--project-id <PROJECT_ID>]
                                         [--user-id <USER_ID>]
                                         [--description <DESCRIPTION>]
                                         [--state <STATE>]
                                         [--enabled {True|False}]
                                         [--alarm-action <Webhook URL>]
                                         [--ok-action <Webhook URL>]
                                         [--insufficient-data-action <Webhook URL>]
                                         [--time-constraint <Time Constraint>]
                                         [--remove-time-constraint <Constraint names>]
                                         [-m <METRIC>] [--period <PERIOD>]
                                         [--evaluation-periods <COUNT>]
                                         [--statistic <STATISTIC>]
                                         [--comparison-operator <OPERATOR>]
                                         [--threshold <THRESHOLD>]
                                         [-q <QUERY>]
                                         [--repeat-actions {True|False}]
        

Update an existing alarm based on computed statistics.

Optional arguments

-a <ALARM_ID>, --alarm_id <ALARM_ID>

ID of the alarm to update. Required.

--name <NAME>

Name of the alarm (must be unique per tenant).

--project-id <PROJECT_ID>

Tenant to associate with alarm (only settable by admin users).

--user-id <USER_ID>

User to associate with alarm (only settable by admin users).

--description <DESCRIPTION>

Free text description of the alarm.

--state <STATE>

State of the alarm, one of: ['ok', 'alarm', 'insufficient_data']

--enabled {True|False}

True if alarm evaluation/actioning is enabled.

--alarm-action <Webhook URL>

URL to invoke when state transitions to alarm. May be used multiple times. Defaults to None.

--ok-action <Webhook URL>

URL to invoke when state transitions to OK. May be used multiple times. Defaults to None.

--insufficient-data-action <Webhook URL>

URL to invoke when state transitions to insufficient_data. May be used multiple times. Defaults to None.

--time-constraint <Time Constraint>

Only evaluate the alarm if the time at evaluation is within this time constraint. Start point(s) of the constraint are specified with a cron expression , whereas its duration is given in seconds. Can be specified multiple times for multiple time constraints, format is: name=<CONSTRAINT_NAME>;start=< CRON>;duration=<SECONDS>;[description=<DESCRIPTION>;[t imezone=<IANA Timezone>]] Defaults to None.

--remove-time-constraint <Constraint names>

Name or list of names of the time constraints to remove.

-m <METRIC>, --meter-name <METRIC>

Metric to evaluate against.

--period <PERIOD>

Length of each period (seconds) to evaluate over.

--evaluation-periods <COUNT>

Number of periods to evaluate over.

--statistic <STATISTIC>

Statistic to evaluate, one of: ['max', 'min', 'avg', 'sum', 'count'].

--comparison-operator <OPERATOR>

Operator to compare with, one of: ['lt', 'le', 'eq', 'ne', 'ge', 'gt'].

--threshold <THRESHOLD>

Threshold to evaluate against.

-q <QUERY>, --query <QUERY>

key[op]data_type::value; list. data_type is optional, but if supplied must be string, integer, float, or boolean.

--repeat-actions {True|False}

True if actions should be repeatedly notified while alarm remains in target state.

 ceilometer alarm-update command

usage: ceilometer alarm-update -a <ALARM_ID> [--name <NAME>]
                               [--project-id <PROJECT_ID>]
                               [--user-id <USER_ID>]
                               [--description <DESCRIPTION>] [--state <STATE>]
                               [--enabled {True|False}]
                               [--alarm-action <Webhook URL>]
                               [--ok-action <Webhook URL>]
                               [--insufficient-data-action <Webhook URL>]
                               [--time-constraint <Time Constraint>]
                               [--remove-time-constraint <Constraint names>]
                               [--period <PERIOD>]
                               [--evaluation-periods <COUNT>] [-m <METRIC>]
                               [--statistic <STATISTIC>]
                               [--comparison-operator <OPERATOR>]
                               [--threshold <THRESHOLD>]
                               [--matching-metadata <Matching Metadata>]
                               [--repeat-actions {True|False}]
        

Update an existing alarm (Deprecated).

Optional arguments

-a <ALARM_ID>, --alarm_id <ALARM_ID>

ID of the alarm to update. Required.

--name <NAME>

Name of the alarm (must be unique per tenant).

--project-id <PROJECT_ID>

Tenant to associate with alarm (only settable by admin users).

--user-id <USER_ID>

User to associate with alarm (only settable by admin users).

--description <DESCRIPTION>

Free text description of the alarm.

--state <STATE>

State of the alarm, one of: ['ok', 'alarm', 'insufficient_data']

--enabled {True|False}

True if alarm evaluation/actioning is enabled.

--alarm-action <Webhook URL>

URL to invoke when state transitions to alarm. May be used multiple times. Defaults to None.

--ok-action <Webhook URL>

URL to invoke when state transitions to OK. May be used multiple times. Defaults to None.

--insufficient-data-action <Webhook URL>

URL to invoke when state transitions to insufficient_data. May be used multiple times. Defaults to None.

--time-constraint <Time Constraint>

Only evaluate the alarm if the time at evaluation is within this time constraint. Start point(s) of the constraint are specified with a cron expression , whereas its duration is given in seconds. Can be specified multiple times for multiple time constraints, format is: name=<CONSTRAINT_NAME>;start=< CRON>;duration=<SECONDS>;[description=<DESCRIPTION>;[t imezone=<IANA Timezone>]] Defaults to None.

--remove-time-constraint <Constraint names>

Name or list of names of the time constraints to remove.

--period <PERIOD>

Length of each period (seconds) to evaluate over.

--evaluation-periods <COUNT>

Number of periods to evaluate over.

-m <METRIC>, --meter-name <METRIC>

Metric to evaluate against.

--statistic <STATISTIC>

Statistic to evaluate, one of: ['max', 'min', 'avg', 'sum', 'count']

--comparison-operator <OPERATOR>

Operator to compare with, one of: ['lt', 'le', 'eq', 'ne', 'ge', 'gt'].

--threshold <THRESHOLD>

Threshold to evaluate against.

--matching-metadata <Matching Metadata>

A meter should match this resource metadata (key=value) additionally to the meter_name. Defaults to None.

--repeat-actions {True|False}

True if actions should be repeatedly notified while alarm remains in target state.

 ceilometer event-list command

usage: ceilometer event-list [-q <QUERY>]
        

List events.

Optional arguments

-q <QUERY>, --query <QUERY>

key[op]data_type::value; list. data_type is optional, but if supplied must be string, integer, floator datetime.

 ceilometer event-show command

usage: ceilometer event-show -m <message_id>
        

Show a particular event.

Optional arguments

-m <message_id>, --message_id <message_id>

The id of the event. Should be a UUID Required.

 ceilometer event-type-list command

usage: ceilometer event-type-list
        

List event types.

 ceilometer meter-list command

usage: ceilometer meter-list [-q <QUERY>]
        

List the user's meters.

Optional arguments

-q <QUERY>, --query <QUERY>

key[op]data_type::value; list. data_type is optional, but if supplied must be string, integer, float, or boolean.

 ceilometer query-alarm-history command

usage: ceilometer query-alarm-history [-f <FILTER>] [-o <ORDERBY>]
                                      [-l <LIMIT>]
        

Query Alarm History.

Optional arguments

-f <FILTER>, --filter <FILTER>

{complex_op: [{simple_op: {field_name: value}}]} The complex_op is one of: ['and', 'or'], simple_op is one of: ['=', '!=', '<', '<=', '>', '>='].

-o <ORDERBY>, --orderby <ORDERBY>

[{field_name: direction}, {field_name: direction}] The direction is one of: ['asc', 'desc'].

-l <LIMIT>, --limit <LIMIT>

Maximum number of alarm history items to return.

 ceilometer query-alarms command

usage: ceilometer query-alarms [-f <FILTER>] [-o <ORDERBY>] [-l <LIMIT>]
        

Query Alarms.

Optional arguments

-f <FILTER>, --filter <FILTER>

{complex_op: [{simple_op: {field_name: value}}]} The complex_op is one of: ['and', 'or'], simple_op is one of: ['=', '!=', '<', '<=', '>', '>='].

-o <ORDERBY>, --orderby <ORDERBY>

[{field_name: direction}, {field_name: direction}] The direction is one of: ['asc', 'desc'].

-l <LIMIT>, --limit <LIMIT>

Maximum number of alarms to return.

 ceilometer query-samples command

usage: ceilometer query-samples [-f <FILTER>] [-o <ORDERBY>] [-l <LIMIT>]
        

Query samples.

Optional arguments

-f <FILTER>, --filter <FILTER>

{complex_op: [{simple_op: {field_name: value}}]} The complex_op is one of: ['and', 'or'], simple_op is one of: ['=', '!=', '<', '<=', '>', '>='].

-o <ORDERBY>, --orderby <ORDERBY>

[{field_name: direction}, {field_name: direction}] The direction is one of: ['asc', 'desc'].

-l <LIMIT>, --limit <LIMIT>

Maximum number of samples to return.

 ceilometer resource-list command

usage: ceilometer resource-list [-q <QUERY>]
        

List the resources.

Optional arguments

-q <QUERY>, --query <QUERY>

key[op]data_type::value; list. data_type is optional, but if supplied must be string, integer, float, or boolean.

 ceilometer resource-show command

usage: ceilometer resource-show -r <RESOURCE_ID>
        

Show the resource.

Optional arguments

-r <RESOURCE_ID>, --resource_id <RESOURCE_ID>

ID of the resource to show. Required.

 ceilometer sample-create command

usage: ceilometer sample-create [--project-id <PROJECT_ID>]
                                [--user-id <USER_ID>] -r <RESOURCE_ID> -m
                                <METER_NAME> --meter-type <METER_TYPE>
                                --meter-unit <METER_UNIT> --sample-volume
                                <SAMPLE_VOLUME>
                                [--resource-metadata <RESOURCE_METADATA>]
                                [--timestamp <TIMESTAMP>]
        

Create a sample.

Optional arguments

--project-id <PROJECT_ID>

Tenant to associate with sample (only settable by admin users).

--user-id <USER_ID>

User to associate with sample (only settable by admin users).

-r <RESOURCE_ID>, --resource-id <RESOURCE_ID>

ID of the resource. Required.

-m <METER_NAME>, --meter-name <METER_NAME>

The meter name. Required.

--meter-type <METER_TYPE>

The meter type. Required.

--meter-unit <METER_UNIT>

The meter unit. Required.

--sample-volume <SAMPLE_VOLUME>

The sample volume. Required.

--resource-metadata <RESOURCE_METADATA>

Resource metadata.

--timestamp <TIMESTAMP>

The sample timestamp.

 ceilometer sample-list command

usage: ceilometer sample-list [-q <QUERY>] -m <NAME> [-l <NUMBER>]
        

List the samples for a meter.

Optional arguments

-q <QUERY>, --query <QUERY>

key[op]data_type::value; list. data_type is optional, but if supplied must be string, integer, float, or boolean.

-m <NAME>, --meter <NAME>

Name of meter to show samples for. Required.

-l <NUMBER>, --limit <NUMBER>

Maximum number of samples to return.

 ceilometer statistics command

usage: ceilometer statistics [-q <QUERY>] -m <NAME> [-p <PERIOD>] [-g <FIELD>]
                             [-a <FUNC>[<-<PARAM>]]
        

List the statistics for a meter.

Optional arguments

-q <QUERY>, --query <QUERY>

key[op]data_type::value; list. data_type is optional, but if supplied must be string, integer, float, or boolean.

-m <NAME>, --meter <NAME>

Name of meter to show samples for. Required.

-p <PERIOD>, --period <PERIOD>

Period in seconds over which to group samples.

-g <FIELD>, --groupby <FIELD>

Field for group by.

-a <FUNC>[<-<PARAM>], --aggregate <FUNC>[<-<PARAM>]

Function for data aggregation. Available aggregates are: count, cardinality, min, max, sum, stddev, avg. Defaults to [].

 ceilometer trait-description-list command

usage: ceilometer trait-description-list -e <EVENT_TYPE>
        

List trait info for an event type.

Optional arguments

-e <EVENT_TYPE>, --event_type <EVENT_TYPE>

Type of the event for which traits will be shown. Required.

 ceilometer trait-list command

usage: ceilometer trait-list -e <EVENT_TYPE> -t <TRAIT_NAME>
        

List trait all traits with name <trait_name> for Event Type <event_type>.

Optional arguments

-e <EVENT_TYPE>, --event_type <EVENT_TYPE>

Type of the event for which traits will listed. Required.

-t <TRAIT_NAME>, --trait_name <TRAIT_NAME>

The name of the trait to list. Required.

Questions? Discuss on ask.openstack.org
Found an error? Report a bug against this page

loading table of contents...