Chapter 46. metric


This chapter describes the commands under the metric command.

46.1. metric aggregates

Usage:

openstack metric aggregates [-h] [-f {csv,json,table,value,yaml}]

                                 [-c COLUMN] [--max-width <integer>]
                                 [--fit-width] [--print-empty] [--noindent]
                                 [--quote {all,minimal,none,nonnumeric}]
                                 [--sort-column SORT_COLUMN]
                                 [--resource-type RESOURCE_TYPE]
                                 [--start START] [--stop STOP]
                                 [--granularity GRANULARITY]
                                 [--needed-overlap NEEDED_OVERLAP]
                                 [--groupby GROUPBY] [--fill FILL]
                                 operations [search]
Copy to Clipboard Toggle word wrap

Get measurements of aggregated metrics.

Expand
Table 46.1. Positional Arguments
ValueSummary

operations

Operations to apply to time series

search

A query to filter resource. the syntax is a combination of attribute, operator and value. For example: id=90d58eea-70d7-4294-a49a-170dcdf44c3c would filter resource with a certain id. More complex queries can be built, e.g.: not (flavor_id!="1" and memory>=24). Use "" to force data to be interpreted as string. Supported operators are: not, and, ∧ or, ∨, >=, ⇐, !=, >, <, =, ==, eq, ne, lt, gt, ge, le, in, like, ≠, ≥, ≤, like, in.

Expand
Table 46.2. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--resource-type RESOURCE_TYPE

Resource type to query

--start START

Beginning of the period

--stop STOP

End of the period

--granularity GRANULARITY

granularity to retrieve

--needed-overlap NEEDED_OVERLAP

percentage of overlap across datapoints

--groupby GROUPBY

Attribute to use to group resources

--fill FILL

Value to use when backfilling timestamps with missing values in a subset of series. Value should be a float or 'null'.

Expand
Table 46.3. Output Formatters
ValueSummary

-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml}

the output format, defaults to table

-c COLUMN, --column COLUMN

specify the column(s) to include, can be repeated

--sort-column SORT_COLUMN

specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated

Expand
Table 46.4. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 46.5. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 46.6. CSV Formatter
ValueSummary

--quote {all,minimal,none,nonnumeric}

when to include quotes, defaults to nonnumeric

This command is provided by the gnocchiclient plugin.

46.2. metric archive policy create

Usage:

openstack metric archive-policy create [-h]

                                            [-f {json,shell,table,value,yaml}]
                                            [-c COLUMN]
                                            [--max-width <integer>]
                                            [--fit-width] [--print-empty]
                                            [--noindent] [--prefix PREFIX]
                                            -d <DEFINITION> [-b BACK_WINDOW]
                                            [-m AGGREGATION_METHODS]
                                            name
Copy to Clipboard Toggle word wrap

Create an archive policy.

Expand
Table 46.7. Positional Arguments
ValueSummary

name

Name of the archive policy

Expand
Table 46.8. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

-d <DEFINITION>, --definition <DEFINITION>

two attributes (separated by ',') of an archive policy definition with its name and value separated with a ':'

-b BACK_WINDOW, --back-window BACK_WINDOW

back window of the archive policy

-m AGGREGATION_METHODS, --aggregation-method AGGREGATION_METHODS

aggregation method of the archive policy

Expand
Table 46.9. Output Formatters
ValueSummary

-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml}

the output format, defaults to table

-c COLUMN, --column COLUMN

specify the column(s) to include, can be repeated

Expand
Table 46.10. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 46.11. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 46.12. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the gnocchiclient plugin.

46.3. metric archive policy delete

Usage:

openstack metric archive-policy delete [-h] name
Copy to Clipboard Toggle word wrap

Delete an archive policy.

Expand
Table 46.13. Positional Arguments
ValueSummary

name

Name of the archive policy

Expand
Table 46.14. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the gnocchiclient plugin.

46.4. metric archive policy list

Usage:

openstack metric archive-policy list [-h]

                                          [-f {csv,json,table,value,yaml}]
                                          [-c COLUMN]
                                          [--max-width <integer>]
                                          [--fit-width] [--print-empty]
                                          [--noindent]
                                          [--quote {all,minimal,none,nonnumeric}]
                                          [--sort-column SORT_COLUMN]
Copy to Clipboard Toggle word wrap

List archive policies.

Expand
Table 46.15. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 46.16. Output Formatters
ValueSummary

-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml}

the output format, defaults to table

-c COLUMN, --column COLUMN

specify the column(s) to include, can be repeated

--sort-column SORT_COLUMN

specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated

Expand
Table 46.17. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 46.18. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 46.19. CSV Formatter
ValueSummary

--quote {all,minimal,none,nonnumeric}

when to include quotes, defaults to nonnumeric

This command is provided by the gnocchiclient plugin.

46.5. metric archive policy show

Usage:

openstack metric archive-policy show [-h]

                                          [-f {json,shell,table,value,yaml}]
                                          [-c COLUMN]
                                          [--max-width <integer>]
                                          [--fit-width] [--print-empty]
                                          [--noindent] [--prefix PREFIX]
                                          name
Copy to Clipboard Toggle word wrap

Show an archive policy.

Expand
Table 46.20. Positional Arguments
ValueSummary

name

Name of the archive policy

Expand
Table 46.21. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 46.22. Output Formatters
ValueSummary

-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml}

the output format, defaults to table

-c COLUMN, --column COLUMN

specify the column(s) to include, can be repeated

Expand
Table 46.23. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 46.24. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 46.25. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the gnocchiclient plugin.

46.6. metric archive policy update

Usage:

openstack metric archive-policy update [-h]

                                            [-f {json,shell,table,value,yaml}]
                                            [-c COLUMN]
                                            [--max-width <integer>]
                                            [--fit-width] [--print-empty]
                                            [--noindent] [--prefix PREFIX]
                                            -d <DEFINITION>
                                            name
Copy to Clipboard Toggle word wrap

Update an archive policy.

Expand
Table 46.26. Positional Arguments
ValueSummary

name

Name of the archive policy

Expand
Table 46.27. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

-d <DEFINITION>, --definition <DEFINITION>

two attributes (separated by ',') of an archive policy definition with its name and value separated with a ':'

Expand
Table 46.28. Output Formatters
ValueSummary

-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml}

the output format, defaults to table

-c COLUMN, --column COLUMN

specify the column(s) to include, can be repeated

Expand
Table 46.29. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 46.30. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 46.31. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the gnocchiclient plugin.

46.7. metric archive policy rule create

Usage:

openstack metric archive-policy-rule create [-h]

                                                 [-f {json,shell,table,value,yaml}]
                                                 [-c COLUMN]
                                                 [--max-width <integer>]
                                                 [--fit-width]
                                                 [--print-empty]
                                                 [--noindent]
                                                 [--prefix PREFIX] -a
                                                 ARCHIVE_POLICY_NAME -m
                                                 METRIC_PATTERN
                                                 name
Copy to Clipboard Toggle word wrap

Create an archive policy rule.

Expand
Table 46.32. Positional Arguments
ValueSummary

name

Rule name

Expand
Table 46.33. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

-a ARCHIVE_POLICY_NAME, --archive-policy-name ARCHIVE_POLICY_NAME

Archive policy name

-m METRIC_PATTERN, --metric-pattern METRIC_PATTERN

Wildcard of metric name to match

Expand
Table 46.34. Output Formatters
ValueSummary

-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml}

the output format, defaults to table

-c COLUMN, --column COLUMN

specify the column(s) to include, can be repeated

Expand
Table 46.35. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 46.36. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 46.37. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the gnocchiclient plugin.

46.8. metric archive policy rule delete

Usage:

openstack metric archive-policy-rule delete [-h] name
Copy to Clipboard Toggle word wrap

Delete an archive policy rule.

Expand
Table 46.38. Positional Arguments
ValueSummary

name

Name of the archive policy rule

Expand
Table 46.39. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the gnocchiclient plugin.

46.9. metric archive policy rule list

Usage:

openstack metric archive-policy-rule list [-h]

                                               [-f {csv,json,table,value,yaml}]
                                               [-c COLUMN]
                                               [--max-width <integer>]
                                               [--fit-width] [--print-empty]
                                               [--noindent]
                                               [--quote {all,minimal,none,nonnumeric}]
                                               [--sort-column SORT_COLUMN]
Copy to Clipboard Toggle word wrap

List archive policy rules.

Expand
Table 46.40. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 46.41. Output Formatters
ValueSummary

-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml}

the output format, defaults to table

-c COLUMN, --column COLUMN

specify the column(s) to include, can be repeated

--sort-column SORT_COLUMN

specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated

Expand
Table 46.42. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 46.43. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 46.44. CSV Formatter
ValueSummary

--quote {all,minimal,none,nonnumeric}

when to include quotes, defaults to nonnumeric

This command is provided by the gnocchiclient plugin.

46.10. metric archive policy rule show

Usage:

openstack metric archive-policy-rule show [-h]

                                               [-f {json,shell,table,value,yaml}]
                                               [-c COLUMN]
                                               [--max-width <integer>]
                                               [--fit-width] [--print-empty]
                                               [--noindent]
                                               [--prefix PREFIX]
                                               name
Copy to Clipboard Toggle word wrap

Show an archive policy rule.

Expand
Table 46.45. Positional Arguments
ValueSummary

name

Name of the archive policy rule

Expand
Table 46.46. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 46.47. Output Formatters
ValueSummary

-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml}

the output format, defaults to table

-c COLUMN, --column COLUMN

specify the column(s) to include, can be repeated

Expand
Table 46.48. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 46.49. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 46.50. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the gnocchiclient plugin.

46.11. metric benchmark measures add

Usage:

openstack metric benchmark measures add [-h]

                                             [--resource-id RESOURCE_ID]
                                             [-f {json,shell,table,value,yaml}]
                                             [-c COLUMN]
                                             [--max-width <integer>]
                                             [--fit-width] [--print-empty]
                                             [--noindent] [--prefix PREFIX]
                                             [--workers WORKERS] --count
                                             COUNT [--batch BATCH]
                                             [--timestamp-start TIMESTAMP_START]
                                             [--timestamp-end TIMESTAMP_END]
                                             [--wait]
                                             metric
Copy to Clipboard Toggle word wrap

Do benchmark testing of adding measurements.

Expand
Table 46.51. Positional Arguments
ValueSummary

metric

Id or name of the metric

Expand
Table 46.52. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--resource-id RESOURCE_ID, -r RESOURCE_ID

ID of the resource

--workers WORKERS, -w WORKERS

Number of workers to use

--count COUNT, -n COUNT

Number of total measures to send

--batch BATCH, -b BATCH

Number of measures to send in each batch

--timestamp-start TIMESTAMP_START, -s TIMESTAMP_START

First timestamp to use

--timestamp-end TIMESTAMP_END, -e TIMESTAMP_END

Last timestamp to use

--wait

Wait for all measures to be processed

Expand
Table 46.53. Output Formatters
ValueSummary

-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml}

the output format, defaults to table

-c COLUMN, --column COLUMN

specify the column(s) to include, can be repeated

Expand
Table 46.54. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 46.55. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 46.56. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the gnocchiclient plugin.

46.12. metric benchmark measures show

Usage:

openstack metric benchmark measures show [-h]

                                              [-f {json,shell,table,value,yaml}]
                                              [-c COLUMN]
                                              [--max-width <integer>]
                                              [--fit-width] [--print-empty]
                                              [--noindent] [--prefix PREFIX]
                                              [--sort-column SORT_COLUMN]
                                              [--utc]
                                              [--resource-id RESOURCE_ID]
                                              [--aggregation AGGREGATION]
                                              [--start START] [--stop STOP]
                                              [--granularity GRANULARITY]
                                              [--refresh]
                                              [--resample RESAMPLE]
                                              [--workers WORKERS] --count
                                              COUNT
                                              metric
Copy to Clipboard Toggle word wrap

Do benchmark testing of measurements show.

Expand
Table 46.57. Positional Arguments
ValueSummary

metric

Id or name of the metric

Expand
Table 46.58. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--utc

Return timestamps as utc

--resource-id RESOURCE_ID, -r RESOURCE_ID

ID of the resource

--aggregation AGGREGATION

aggregation to retrieve

--start START

Beginning of the period

--stop STOP

End of the period

--granularity GRANULARITY

granularity to retrieve

--refresh

Force aggregation of all known measures

--resample RESAMPLE

Granularity to resample time-series to (in seconds)

--workers WORKERS, -w WORKERS

Number of workers to use

--count COUNT, -n COUNT

Number of total measures to send

Expand
Table 46.59. Output Formatters
ValueSummary

-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml}

the output format, defaults to table

-c COLUMN, --column COLUMN

specify the column(s) to include, can be repeated

--sort-column SORT_COLUMN

specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated

Expand
Table 46.60. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 46.61. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 46.62. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the gnocchiclient plugin.

46.13. metric benchmark metric create

Usage:

openstack metric benchmark metric create [-h]

                                              [--resource-id RESOURCE_ID]
                                              [-f {json,shell,table,value,yaml}]
                                              [-c COLUMN]
                                              [--max-width <integer>]
                                              [--fit-width] [--print-empty]
                                              [--noindent] [--prefix PREFIX]
                                              [--archive-policy-name ARCHIVE_POLICY_NAME]
                                              [--workers WORKERS] --count
                                              COUNT [--keep]
Copy to Clipboard Toggle word wrap

Do benchmark testing of metric creation.

Expand
Table 46.63. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--resource-id RESOURCE_ID, -r RESOURCE_ID

ID of the resource

--archive-policy-name ARCHIVE_POLICY_NAME, -a ARCHIVE_POLICY_NAME

name of the archive policy

--workers WORKERS, -w WORKERS

Number of workers to use

--count COUNT, -n COUNT

Number of metrics to create

--keep, -k

Keep created metrics

Expand
Table 46.64. Output Formatters
ValueSummary

-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml}

the output format, defaults to table

-c COLUMN, --column COLUMN

specify the column(s) to include, can be repeated

Expand
Table 46.65. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 46.66. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 46.67. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the gnocchiclient plugin.

46.14. metric benchmark metric show

Usage:

openstack metric benchmark metric show [-h] [--resource-id RESOURCE_ID]

                                            [-f {json,shell,table,value,yaml}]
                                            [-c COLUMN]
                                            [--max-width <integer>]
                                            [--fit-width] [--print-empty]
                                            [--noindent] [--prefix PREFIX]
                                            [--workers WORKERS] --count
                                            COUNT
                                            metric [metric ...]
Copy to Clipboard Toggle word wrap

Do benchmark testing of metric show.

Expand
Table 46.68. Positional Arguments
ValueSummary

metric

Id or name of the metrics

Expand
Table 46.69. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--resource-id RESOURCE_ID, -r RESOURCE_ID

ID of the resource

--workers WORKERS, -w WORKERS

Number of workers to use

--count COUNT, -n COUNT

Number of metrics to get

Expand
Table 46.70. Output Formatters
ValueSummary

-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml}

the output format, defaults to table

-c COLUMN, --column COLUMN

specify the column(s) to include, can be repeated

Expand
Table 46.71. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 46.72. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 46.73. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the gnocchiclient plugin.

46.15. metric capabilities list

Usage:

openstack metric capabilities list [-h]

                                        [-f {json,shell,table,value,yaml}]
                                        [-c COLUMN] [--max-width <integer>]
                                        [--fit-width] [--print-empty]
                                        [--noindent] [--prefix PREFIX]
Copy to Clipboard Toggle word wrap

List capabilities.

Expand
Table 46.74. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 46.75. Output Formatters
ValueSummary

-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml}

the output format, defaults to table

-c COLUMN, --column COLUMN

specify the column(s) to include, can be repeated

Expand
Table 46.76. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 46.77. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 46.78. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the gnocchiclient plugin.

46.16. metric create

Usage:

openstack metric create [-h] [--resource-id RESOURCE_ID]

                             [-f {json,shell,table,value,yaml}] [-c COLUMN]
                             [--max-width <integer>] [--fit-width]
                             [--print-empty] [--noindent] [--prefix PREFIX]
                             [--archive-policy-name ARCHIVE_POLICY_NAME]
                             [--unit UNIT]
                             [METRIC_NAME]
Copy to Clipboard Toggle word wrap

Create a metric.

Expand
Table 46.79. Positional Arguments
ValueSummary

METRIC_NAME

Name of the metric

Expand
Table 46.80. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--resource-id RESOURCE_ID, -r RESOURCE_ID

ID of the resource

--archive-policy-name ARCHIVE_POLICY_NAME, -a ARCHIVE_POLICY_NAME

name of the archive policy

--unit UNIT, -u UNIT

Unit of the metric

Expand
Table 46.81. Output Formatters
ValueSummary

-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml}

the output format, defaults to table

-c COLUMN, --column COLUMN

specify the column(s) to include, can be repeated

Expand
Table 46.82. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 46.83. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 46.84. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the gnocchiclient plugin.

46.17. metric delete

Usage:

openstack metric delete [-h] [--resource-id RESOURCE_ID]

                             metric [metric ...]
Copy to Clipboard Toggle word wrap

Delete a metric.

Expand
Table 46.85. Positional Arguments
ValueSummary

metric

Ids or names of the metric

Expand
Table 46.86. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--resource-id RESOURCE_ID, -r RESOURCE_ID

ID of the resource

This command is provided by the gnocchiclient plugin.

46.18. metric list

Usage:

openstack metric list [-h] [-f {csv,json,table,value,yaml}] [-c COLUMN]

                           [--max-width <integer>] [--fit-width]
                           [--print-empty] [--noindent]
                           [--quote {all,minimal,none,nonnumeric}]
                           [--sort-column SORT_COLUMN] [--limit <LIMIT>]
                           [--marker <MARKER>] [--sort <SORT>]
Copy to Clipboard Toggle word wrap

List metrics.

Expand
Table 46.87. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--limit <LIMIT>

Number of metrics to return (default is server default)

--marker <MARKER>

Last item of the previous listing. return the next results after this value

--sort <SORT>

Sort of metric attribute (example: user_id:desc- nullslast

Expand
Table 46.88. Output Formatters
ValueSummary

-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml}

the output format, defaults to table

-c COLUMN, --column COLUMN

specify the column(s) to include, can be repeated

--sort-column SORT_COLUMN

specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated

Expand
Table 46.89. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 46.90. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 46.91. CSV Formatter
ValueSummary

--quote {all,minimal,none,nonnumeric}

when to include quotes, defaults to nonnumeric

This command is provided by the gnocchiclient plugin.

46.19. metric measures add

Usage:

openstack metric measures add [-h] [--resource-id RESOURCE_ID] -m

                                   MEASURE
                                   metric
Copy to Clipboard Toggle word wrap

Add measurements to a metric.

Expand
Table 46.92. Positional Arguments
ValueSummary

metric

Id or name of the metric

Expand
Table 46.93. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--resource-id RESOURCE_ID, -r RESOURCE_ID

ID of the resource

-m MEASURE, --measure MEASURE

timestamp and value of a measure separated with a '@'

This command is provided by the gnocchiclient plugin.

46.20. metric measures aggregation

Usage:

openstack metric measures aggregation [-h]

                                           [-f {csv,json,table,value,yaml}]
                                           [-c COLUMN]
                                           [--max-width <integer>]
                                           [--fit-width] [--print-empty]
                                           [--noindent]
                                           [--quote {all,minimal,none,nonnumeric}]
                                           [--sort-column SORT_COLUMN]
                                           [--utc] -m METRIC [METRIC ...]
                                           [--aggregation AGGREGATION]
                                           [--reaggregation REAGGREGATION]
                                           [--start START] [--stop STOP]
                                           [--granularity GRANULARITY]
                                           [--needed-overlap NEEDED_OVERLAP]
                                           [--query QUERY]
                                           [--resource-type RESOURCE_TYPE]
                                           [--groupby GROUPBY] [--refresh]
                                           [--resample RESAMPLE]
                                           [--fill FILL]
Copy to Clipboard Toggle word wrap

Get measurements of aggregated metrics.

Expand
Table 46.94. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--utc

Return timestamps as utc

-m METRIC [METRIC …​], --metric METRIC [METRIC …​]

metrics IDs or metric name

--aggregation AGGREGATION

granularity aggregation function to retrieve

--reaggregation REAGGREGATION

groupby aggregation function to retrieve

--start START

Beginning of the period

--stop STOP

End of the period

--granularity GRANULARITY

granularity to retrieve

--needed-overlap NEEDED_OVERLAP

percent of datapoints in each metrics required

--query QUERY

A query to filter resource. the syntax is a combination of attribute, operator and value. For example: id=90d58eea-70d7-4294-a49a-170dcdf44c3c would filter resource with a certain id. More complex queries can be built, e.g.: not (flavor_id!="1" and memory>=24). Use "" to force data to be interpreted as string. Supported operators are: not, and, ∧ or, ∨, >=, ⇐, !=, >, <, =, ==, eq, ne, lt, gt, ge, le, in, like, ≠, ≥, ≤, like, in.

--resource-type RESOURCE_TYPE

Resource type to query

--groupby GROUPBY

Attribute to use to group resources

--refresh

Force aggregation of all known measures

--resample RESAMPLE

Granularity to resample time-series to (in seconds)

--fill FILL

Value to use when backfilling timestamps with missing values in a subset of series. Value should be a float or 'null'.

Expand
Table 46.95. Output Formatters
ValueSummary

-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml}

the output format, defaults to table

-c COLUMN, --column COLUMN

specify the column(s) to include, can be repeated

--sort-column SORT_COLUMN

specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated

Expand
Table 46.96. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 46.97. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 46.98. CSV Formatter
ValueSummary

--quote {all,minimal,none,nonnumeric}

when to include quotes, defaults to nonnumeric

This command is provided by the gnocchiclient plugin.

46.21. metric measures batch metrics

Usage:

openstack metric measures batch-metrics [-h] file
Copy to Clipboard Toggle word wrap

Expand
Table 46.99. Positional Arguments
ValueSummary

file

File containing measurements to batch or - for stdin (see Gnocchi REST API docs for the format

Expand
Table 46.100. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the gnocchiclient plugin.

46.22. metric measures batch resources metrics

Usage:

openstack metric measures batch-resources-metrics [-h]

                                                       [--create-metrics]
                                                       file
Copy to Clipboard Toggle word wrap

Expand
Table 46.101. Positional Arguments
ValueSummary

file

File containing measurements to batch or - for stdin (see Gnocchi REST API docs for the format

Expand
Table 46.102. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--create-metrics

Create unknown metrics

This command is provided by the gnocchiclient plugin.

46.23. metric measures show

Usage:

openstack metric measures show [-h] [-f {csv,json,table,value,yaml}]

                                    [-c COLUMN] [--max-width <integer>]
                                    [--fit-width] [--print-empty]
                                    [--noindent]
                                    [--quote {all,minimal,none,nonnumeric}]
                                    [--sort-column SORT_COLUMN] [--utc]
                                    [--resource-id RESOURCE_ID]
                                    [--aggregation AGGREGATION]
                                    [--start START] [--stop STOP]
                                    [--granularity GRANULARITY] [--refresh]
                                    [--resample RESAMPLE]
                                    metric
Copy to Clipboard Toggle word wrap

Get measurements of a metric.

Expand
Table 46.103. Positional Arguments
ValueSummary

metric

Id or name of the metric

Expand
Table 46.104. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--utc

Return timestamps as utc

--resource-id RESOURCE_ID, -r RESOURCE_ID

ID of the resource

--aggregation AGGREGATION

aggregation to retrieve

--start START

Beginning of the period

--stop STOP

End of the period

--granularity GRANULARITY

granularity to retrieve

--refresh

Force aggregation of all known measures

--resample RESAMPLE

Granularity to resample time-series to (in seconds)

Expand
Table 46.105. Output Formatters
ValueSummary

-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml}

the output format, defaults to table

-c COLUMN, --column COLUMN

specify the column(s) to include, can be repeated

--sort-column SORT_COLUMN

specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated

Expand
Table 46.106. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 46.107. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 46.108. CSV Formatter
ValueSummary

--quote {all,minimal,none,nonnumeric}

when to include quotes, defaults to nonnumeric

This command is provided by the gnocchiclient plugin.

46.24. metric metric create

Usage:

openstack metric metric create [-h] [--resource-id RESOURCE_ID]

                                    [-f {json,shell,table,value,yaml}]
                                    [-c COLUMN] [--max-width <integer>]
                                    [--fit-width] [--print-empty]
                                    [--noindent] [--prefix PREFIX]
                                    [--archive-policy-name ARCHIVE_POLICY_NAME]
                                    [--unit UNIT]
                                    [METRIC_NAME]
Copy to Clipboard Toggle word wrap

Deprecated: Create a metric.

Expand
Table 46.109. Positional Arguments
ValueSummary

METRIC_NAME

Name of the metric

Expand
Table 46.110. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--resource-id RESOURCE_ID, -r RESOURCE_ID

ID of the resource

--archive-policy-name ARCHIVE_POLICY_NAME, -a ARCHIVE_POLICY_NAME

name of the archive policy

--unit UNIT, -u UNIT

Unit of the metric

Expand
Table 46.111. Output Formatters
ValueSummary

-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml}

the output format, defaults to table

-c COLUMN, --column COLUMN

specify the column(s) to include, can be repeated

Expand
Table 46.112. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 46.113. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 46.114. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the gnocchiclient plugin.

46.25. metric metric delete

Usage:

openstack metric metric delete [-h] [--resource-id RESOURCE_ID]

                                    metric [metric ...]
Copy to Clipboard Toggle word wrap

Deprecated: Delete a metric.

Expand
Table 46.115. Positional Arguments
ValueSummary

metric

Ids or names of the metric

Expand
Table 46.116. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--resource-id RESOURCE_ID, -r RESOURCE_ID

ID of the resource

This command is provided by the gnocchiclient plugin.

46.26. metric metric list

Usage:

openstack metric metric list [-h] [-f {csv,json,table,value,yaml}]

                                  [-c COLUMN] [--max-width <integer>]
                                  [--fit-width] [--print-empty] [--noindent]
                                  [--quote {all,minimal,none,nonnumeric}]
                                  [--sort-column SORT_COLUMN]
                                  [--limit <LIMIT>] [--marker <MARKER>]
                                  [--sort <SORT>]
Copy to Clipboard Toggle word wrap

Deprecated: List metrics.

Expand
Table 46.117. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--limit <LIMIT>

Number of metrics to return (default is server default)

--marker <MARKER>

Last item of the previous listing. return the next results after this value

--sort <SORT>

Sort of metric attribute (example: user_id:desc- nullslast

Expand
Table 46.118. Output Formatters
ValueSummary

-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml}

the output format, defaults to table

-c COLUMN, --column COLUMN

specify the column(s) to include, can be repeated

--sort-column SORT_COLUMN

specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated

Expand
Table 46.119. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 46.120. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 46.121. CSV Formatter
ValueSummary

--quote {all,minimal,none,nonnumeric}

when to include quotes, defaults to nonnumeric

This command is provided by the gnocchiclient plugin.

46.27. metric metric show

Usage:

openstack metric metric show [-h] [-f {json,shell,table,value,yaml}]

                                  [-c COLUMN] [--max-width <integer>]
                                  [--fit-width] [--print-empty] [--noindent]
                                  [--prefix PREFIX]
                                  [--resource-id RESOURCE_ID]
                                  metric
Copy to Clipboard Toggle word wrap

Deprecated: Show a metric.

Expand
Table 46.122. Positional Arguments
ValueSummary

metric

Id or name of the metric

Expand
Table 46.123. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--resource-id RESOURCE_ID, -r RESOURCE_ID

ID of the resource

Expand
Table 46.124. Output Formatters
ValueSummary

-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml}

the output format, defaults to table

-c COLUMN, --column COLUMN

specify the column(s) to include, can be repeated

Expand
Table 46.125. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 46.126. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 46.127. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the gnocchiclient plugin.

46.28. metric resource batch delete

Usage:

openstack metric resource batch delete [-h]

                                            [-f {json,shell,table,value,yaml}]
                                            [-c COLUMN]
                                            [--max-width <integer>]
                                            [--fit-width] [--print-empty]
                                            [--noindent] [--prefix PREFIX]
                                            [--type RESOURCE_TYPE]
                                            query
Copy to Clipboard Toggle word wrap

Delete a batch of resources based on attribute values.

Expand
Table 46.128. Positional Arguments
ValueSummary

query

A query to filter resource. the syntax is a combination of attribute, operator and value. For example: id=90d58eea-70d7-4294-a49a-170dcdf44c3c would filter resource with a certain id. More complex queries can be built, e.g.: not (flavor_id!="1" and memory>=24). Use "" to force data to be interpreted as string. Supported operators are: not, and, ∧ or, ∨, >=, ⇐, !=, >, <, =, ==, eq, ne, lt, gt, ge, le, in, like, ≠, ≥, ≤, like, in.

Expand
Table 46.129. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--type RESOURCE_TYPE, -t RESOURCE_TYPE

Type of resource

Expand
Table 46.130. Output Formatters
ValueSummary

-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml}

the output format, defaults to table

-c COLUMN, --column COLUMN

specify the column(s) to include, can be repeated

Expand
Table 46.131. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 46.132. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 46.133. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the gnocchiclient plugin.

46.29. metric resource create

Usage:

openstack metric resource create [-h]

                                      [-f {json,shell,table,value,yaml}]
                                      [-c COLUMN] [--max-width <integer>]
                                      [--fit-width] [--print-empty]
                                      [--noindent] [--prefix PREFIX]
                                      [--type RESOURCE_TYPE] [-a ATTRIBUTE]
                                      [-m ADD_METRIC] [-n CREATE_METRIC]
                                      resource_id
Copy to Clipboard Toggle word wrap

Create a resource.

Expand
Table 46.134. Positional Arguments
ValueSummary

resource_id

Id of the resource

Expand
Table 46.135. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--type RESOURCE_TYPE, -t RESOURCE_TYPE

Type of resource

-a ATTRIBUTE, --attribute ATTRIBUTE

name and value of an attribute separated with a ':'

-m ADD_METRIC, --add-metric ADD_METRIC

name:id of a metric to add

-n CREATE_METRIC, --create-metric CREATE_METRIC

name:archive_policy_name of a metric to create

Expand
Table 46.136. Output Formatters
ValueSummary

-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml}

the output format, defaults to table

-c COLUMN, --column COLUMN

specify the column(s) to include, can be repeated

Expand
Table 46.137. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 46.138. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 46.139. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the gnocchiclient plugin.

46.30. metric resource delete

Usage:

openstack metric resource delete [-h] resource_id
Copy to Clipboard Toggle word wrap

Delete a resource.

Expand
Table 46.140. Positional Arguments
ValueSummary

resource_id

Id of the resource

Expand
Table 46.141. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the gnocchiclient plugin.

46.31. metric resource history

Usage:

openstack metric resource history [-h] [-f {csv,json,table,value,yaml}]

                                       [-c COLUMN] [--max-width <integer>]
                                       [--fit-width] [--print-empty]
                                       [--noindent]
                                       [--quote {all,minimal,none,nonnumeric}]
                                       [--sort-column SORT_COLUMN]
                                       [--details] [--limit <LIMIT>]
                                       [--marker <MARKER>] [--sort <SORT>]
                                       [--type RESOURCE_TYPE]
                                       resource_id
Copy to Clipboard Toggle word wrap

Show the history of a resource.

Expand
Table 46.142. Positional Arguments
ValueSummary

resource_id

Id of a resource

Expand
Table 46.143. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--details

Show all attributes of generic resources

--limit <LIMIT>

Number of resources to return (default is server default)

--marker <MARKER>

Last item of the previous listing. return the next results after this value

--sort <SORT>

Sort of resource attribute (example: user_id:desc- nullslast

--type RESOURCE_TYPE, -t RESOURCE_TYPE

Type of resource

Expand
Table 46.144. Output Formatters
ValueSummary

-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml}

the output format, defaults to table

-c COLUMN, --column COLUMN

specify the column(s) to include, can be repeated

--sort-column SORT_COLUMN

specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated

Expand
Table 46.145. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 46.146. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 46.147. CSV Formatter
ValueSummary

--quote {all,minimal,none,nonnumeric}

when to include quotes, defaults to nonnumeric

This command is provided by the gnocchiclient plugin.

46.32. metric resource list

Usage:

openstack metric resource list [-h] [-f {csv,json,table,value,yaml}]

                                    [-c COLUMN] [--max-width <integer>]
                                    [--fit-width] [--print-empty]
                                    [--noindent]
                                    [--quote {all,minimal,none,nonnumeric}]
                                    [--sort-column SORT_COLUMN] [--details]
                                    [--history] [--limit <LIMIT>]
                                    [--marker <MARKER>] [--sort <SORT>]
                                    [--type RESOURCE_TYPE]
Copy to Clipboard Toggle word wrap

List resources.

Expand
Table 46.148. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--details

Show all attributes of generic resources

--history

Show history of the resources

--limit <LIMIT>

Number of resources to return (default is server default)

--marker <MARKER>

Last item of the previous listing. return the next results after this value

--sort <SORT>

Sort of resource attribute (example: user_id:desc- nullslast

--type RESOURCE_TYPE, -t RESOURCE_TYPE

Type of resource

Expand
Table 46.149. Output Formatters
ValueSummary

-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml}

the output format, defaults to table

-c COLUMN, --column COLUMN

specify the column(s) to include, can be repeated

--sort-column SORT_COLUMN

specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated

Expand
Table 46.150. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 46.151. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 46.152. CSV Formatter
ValueSummary

--quote {all,minimal,none,nonnumeric}

when to include quotes, defaults to nonnumeric

This command is provided by the gnocchiclient plugin.

46.34. metric resource show

Usage:

openstack metric resource show [-h] [-f {json,shell,table,value,yaml}]

                                    [-c COLUMN] [--max-width <integer>]
                                    [--fit-width] [--print-empty]
                                    [--noindent] [--prefix PREFIX]
                                    [--type RESOURCE_TYPE]
                                    resource_id
Copy to Clipboard Toggle word wrap

Show a resource.

Expand
Table 46.159. Positional Arguments
ValueSummary

resource_id

Id of a resource

Expand
Table 46.160. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--type RESOURCE_TYPE, -t RESOURCE_TYPE

Type of resource

Expand
Table 46.161. Output Formatters
ValueSummary

-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml}

the output format, defaults to table

-c COLUMN, --column COLUMN

specify the column(s) to include, can be repeated

Expand
Table 46.162. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 46.163. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 46.164. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the gnocchiclient plugin.

46.35. metric resource update

Usage:

openstack metric resource update [-h]

                                      [-f {json,shell,table,value,yaml}]
                                      [-c COLUMN] [--max-width <integer>]
                                      [--fit-width] [--print-empty]
                                      [--noindent] [--prefix PREFIX]
                                      [--type RESOURCE_TYPE] [-a ATTRIBUTE]
                                      [-m ADD_METRIC] [-n CREATE_METRIC]
                                      [-d DELETE_METRIC]
                                      resource_id
Copy to Clipboard Toggle word wrap

Update a resource.

Expand
Table 46.165. Positional Arguments
ValueSummary

resource_id

Id of the resource

Expand
Table 46.166. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--type RESOURCE_TYPE, -t RESOURCE_TYPE

Type of resource

-a ATTRIBUTE, --attribute ATTRIBUTE

name and value of an attribute separated with a ':'

-m ADD_METRIC, --add-metric ADD_METRIC

name:id of a metric to add

-n CREATE_METRIC, --create-metric CREATE_METRIC

name:archive_policy_name of a metric to create

-d DELETE_METRIC, --delete-metric DELETE_METRIC

Name of a metric to delete

Expand
Table 46.167. Output Formatters
ValueSummary

-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml}

the output format, defaults to table

-c COLUMN, --column COLUMN

specify the column(s) to include, can be repeated

Expand
Table 46.168. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 46.169. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 46.170. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the gnocchiclient plugin.

46.36. metric resource type create

Usage:

openstack metric resource-type create [-h]

                                           [-f {json,shell,table,value,yaml}]
                                           [-c COLUMN]
                                           [--max-width <integer>]
                                           [--fit-width] [--print-empty]
                                           [--noindent] [--prefix PREFIX]
                                           [-a ATTRIBUTE]
                                           name
Copy to Clipboard Toggle word wrap

Create a resource type.

Expand
Table 46.171. Positional Arguments
ValueSummary

name

Name of the resource type

Expand
Table 46.172. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

-a ATTRIBUTE, --attribute ATTRIBUTE

attribute definition, attribute_name:attribute_type:at tribute_is_required:attribute_type_option_name=attribu te_type_option_value:…​ For example: display_name:string:true:max_length=255

Expand
Table 46.173. Output Formatters
ValueSummary

-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml}

the output format, defaults to table

-c COLUMN, --column COLUMN

specify the column(s) to include, can be repeated

Expand
Table 46.174. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 46.175. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 46.176. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the gnocchiclient plugin.

46.37. metric resource type delete

Usage:

openstack metric resource-type delete [-h] name
Copy to Clipboard Toggle word wrap

Delete a resource type.

Expand
Table 46.177. Positional Arguments
ValueSummary

name

Name of the resource type

Expand
Table 46.178. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the gnocchiclient plugin.

46.38. metric resource type list

Usage:

openstack metric resource-type list [-h]

                                         [-f {csv,json,table,value,yaml}]
                                         [-c COLUMN] [--max-width <integer>]
                                         [--fit-width] [--print-empty]
                                         [--noindent]
                                         [--quote {all,minimal,none,nonnumeric}]
                                         [--sort-column SORT_COLUMN]
Copy to Clipboard Toggle word wrap

List resource types.

Expand
Table 46.179. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 46.180. Output Formatters
ValueSummary

-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml}

the output format, defaults to table

-c COLUMN, --column COLUMN

specify the column(s) to include, can be repeated

--sort-column SORT_COLUMN

specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated

Expand
Table 46.181. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 46.182. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 46.183. CSV Formatter
ValueSummary

--quote {all,minimal,none,nonnumeric}

when to include quotes, defaults to nonnumeric

This command is provided by the gnocchiclient plugin.

46.39. metric resource type show

Usage:

openstack metric resource-type show [-h]

                                         [-f {json,shell,table,value,yaml}]
                                         [-c COLUMN] [--max-width <integer>]
                                         [--fit-width] [--print-empty]
                                         [--noindent] [--prefix PREFIX]
                                         name
Copy to Clipboard Toggle word wrap

Show a resource type.

Expand
Table 46.184. Positional Arguments
ValueSummary

name

Name of the resource type

Expand
Table 46.185. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 46.186. Output Formatters
ValueSummary

-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml}

the output format, defaults to table

-c COLUMN, --column COLUMN

specify the column(s) to include, can be repeated

Expand
Table 46.187. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 46.188. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 46.189. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the gnocchiclient plugin.

46.40. metric resource type update

Usage:

openstack metric resource-type update [-h]

                                           [-f {json,shell,table,value,yaml}]
                                           [-c COLUMN]
                                           [--max-width <integer>]
                                           [--fit-width] [--print-empty]
                                           [--noindent] [--prefix PREFIX]
                                           [-a ATTRIBUTE]
                                           [-r REMOVE_ATTRIBUTE]
                                           name
Copy to Clipboard Toggle word wrap

Expand
Table 46.190. Positional Arguments
ValueSummary

name

Name of the resource type

Expand
Table 46.191. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

-a ATTRIBUTE, --attribute ATTRIBUTE

attribute definition, attribute_name:attribute_type:at tribute_is_required:attribute_type_option_name=attribu te_type_option_value:…​ For example: display_name:string:true:max_length=255

-r REMOVE_ATTRIBUTE, --remove-attribute REMOVE_ATTRIBUTE

attribute name

Expand
Table 46.192. Output Formatters
ValueSummary

-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml}

the output format, defaults to table

-c COLUMN, --column COLUMN

specify the column(s) to include, can be repeated

Expand
Table 46.193. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 46.194. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 46.195. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the gnocchiclient plugin.

46.41. metric server version

Usage:

openstack metric server version [-h] [-f {json,shell,table,value,yaml}]

                                     [-c COLUMN] [--max-width <integer>]
                                     [--fit-width] [--print-empty]
                                     [--noindent] [--prefix PREFIX]
Copy to Clipboard Toggle word wrap

Show the version of Gnocchi server.

Expand
Table 46.196. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 46.197. Output Formatters
ValueSummary

-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml}

the output format, defaults to table

-c COLUMN, --column COLUMN

specify the column(s) to include, can be repeated

Expand
Table 46.198. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 46.199. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 46.200. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the gnocchiclient plugin.

46.42. metric show

Usage:

openstack metric show [-h] [-f {json,shell,table,value,yaml}]

                           [-c COLUMN] [--max-width <integer>] [--fit-width]
                           [--print-empty] [--noindent] [--prefix PREFIX]
                           [--resource-id RESOURCE_ID]
                           metric
Copy to Clipboard Toggle word wrap

Show a metric.

Expand
Table 46.201. Positional Arguments
ValueSummary

metric

Id or name of the metric

Expand
Table 46.202. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--resource-id RESOURCE_ID, -r RESOURCE_ID

ID of the resource

Expand
Table 46.203. Output Formatters
ValueSummary

-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml}

the output format, defaults to table

-c COLUMN, --column COLUMN

specify the column(s) to include, can be repeated

Expand
Table 46.204. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 46.205. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 46.206. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the gnocchiclient plugin.

46.43. metric status

Usage:

openstack metric status [-h] [-f {json,shell,table,value,yaml}]

                             [-c COLUMN] [--max-width <integer>]
                             [--fit-width] [--print-empty] [--noindent]
                             [--prefix PREFIX]
Copy to Clipboard Toggle word wrap

Show the status of measurements processing.

Expand
Table 46.207. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 46.208. Output Formatters
ValueSummary

-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml}

the output format, defaults to table

-c COLUMN, --column COLUMN

specify the column(s) to include, can be repeated

Expand
Table 46.209. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 46.210. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 46.211. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the gnocchiclient plugin.

Back to top
Red Hat logoGithubredditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust. Explore our recent updates.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

Theme

© 2025 Red Hat