gnocchi¶
指标聚合¶
获取聚合指标的测量值。
openstack metric aggregates
[--sort-column SORT_COLUMN]
[--sort-ascending | --sort-descending]
[--resource-type RESOURCE_TYPE]
[--start START]
[--stop STOP]
[--granularity GRANULARITY]
[--needed-overlap NEEDED_OVERLAP]
[--groupby GROUPBY]
[--fill FILL]
[--use-history USE_HISTORY]
operations
[search]
- --sort-column SORT_COLUMN¶
指定要对数据进行排序的列(首先指定的列具有优先级,不存在的列将被忽略),可以重复
- --sort-ascending¶
按升序对列进行排序
- --sort-descending¶
按降序对列进行排序
- --resource-type <RESOURCE_TYPE>¶
要查询的资源类型
- --start <START>¶
时间段的开始
- --stop <STOP>¶
时间段的结束
- --granularity <GRANULARITY>¶
要检索的粒度
- --needed-overlap <NEEDED_OVERLAP>¶
数据点之间的重叠百分比
- --groupby <GROUPBY>¶
用于分组资源的属性
- --fill <FILL>¶
当数据集中部分序列缺少值时,用于填充时间戳的值。值应为浮点数或“null”。
- --use-history <USE_HISTORY>¶
指示 Gnocchi 服务器是否应该响应聚合查询的资源标签历史记录。如果设置为 False,则仅返回最新的标签值。否则,如果标签在请求的 granularity 中发生了更改,则测量值将按比例拆分。
- operations¶
应用于时间序列的操作
- search¶
用于过滤资源的查询。语法是属性、运算符和值的组合。例如:id=90d58eea-70d7-4294-a49a-170dcdf44c3c 将过滤具有特定 id 的资源。可以构建更复杂的查询,例如:not (flavor_id!=”1” and memory>=24)。使用 “” 强制将数据解释为字符串。支持的运算符有:not, and, ∧ or, ∨, >=, <=, !=, >, <, =, ==, eq, ne, lt, gt, ge, le, in, like, ≠, ≥, ≤, like, in。
此命令由 gnocchiclient 插件提供。
指标归档策略创建¶
创建归档策略。
openstack metric archive-policy create
-d <DEFINITION>
[-b BACK_WINDOW]
[-m AGGREGATION_METHODS]
name
- -d <DEFINITION>, --definition <DEFINITION>¶
归档策略定义的两个属性(用“,”分隔),其名称和值用“:”分隔
- -b <BACK_WINDOW>, --back-window <BACK_WINDOW>¶
归档策略的回溯窗口
- -m <AGGREGATION_METHODS>, --aggregation-method <AGGREGATION_METHODS>¶
归档策略的聚合方法
- name¶
归档策略的名称
此命令由 gnocchiclient 插件提供。
指标归档策略删除¶
删除归档策略。
openstack metric archive-policy delete name
- name¶
归档策略的名称
此命令由 gnocchiclient 插件提供。
指标归档策略列表¶
列出归档策略。
openstack metric archive-policy list
[--sort-column SORT_COLUMN]
[--sort-ascending | --sort-descending]
- --sort-column SORT_COLUMN¶
指定要对数据进行排序的列(首先指定的列具有优先级,不存在的列将被忽略),可以重复
- --sort-ascending¶
按升序对列进行排序
- --sort-descending¶
按降序对列进行排序
此命令由 gnocchiclient 插件提供。
指标归档策略显示¶
显示归档策略。
openstack metric archive-policy show name
- name¶
归档策略的名称
此命令由 gnocchiclient 插件提供。
指标归档策略更新¶
更新归档策略。
openstack metric archive-policy update -d <DEFINITION> name
- -d <DEFINITION>, --definition <DEFINITION>¶
归档策略定义的两个属性(用“,”分隔),其名称和值用“:”分隔
- name¶
归档策略的名称
此命令由 gnocchiclient 插件提供。
指标归档策略规则创建¶
创建归档策略规则。
openstack metric archive-policy-rule create
-a ARCHIVE_POLICY_NAME
-m METRIC_PATTERN
name
- -a <ARCHIVE_POLICY_NAME>, --archive-policy-name <ARCHIVE_POLICY_NAME>¶
归档策略名称
- -m <METRIC_PATTERN>, --metric-pattern <METRIC_PATTERN>¶
匹配指标名称的通配符
- name¶
规则名称
此命令由 gnocchiclient 插件提供。
指标归档策略规则删除¶
删除归档策略规则。
openstack metric archive-policy-rule delete name
- name¶
归档策略规则的名称
此命令由 gnocchiclient 插件提供。
指标归档策略规则列表¶
列出归档策略规则。
openstack metric archive-policy-rule list
[--sort-column SORT_COLUMN]
[--sort-ascending | --sort-descending]
- --sort-column SORT_COLUMN¶
指定要对数据进行排序的列(首先指定的列具有优先级,不存在的列将被忽略),可以重复
- --sort-ascending¶
按升序对列进行排序
- --sort-descending¶
按降序对列进行排序
此命令由 gnocchiclient 插件提供。
指标归档策略规则显示¶
显示归档策略规则。
openstack metric archive-policy-rule show name
- name¶
归档策略规则的名称
此命令由 gnocchiclient 插件提供。
指标基准测量添加¶
执行添加测量的基准测试。
openstack metric benchmark measures add
[--resource-id RESOURCE_ID]
[--workers WORKERS]
--count COUNT
[--batch BATCH]
[--timestamp-start TIMESTAMP_START]
[--timestamp-end TIMESTAMP_END]
[--wait]
metric
- --resource-id <RESOURCE_ID>, -r <RESOURCE_ID>¶
资源的 ID
- --workers <WORKERS>, -w <WORKERS>¶
使用的 worker 数量
- --count <COUNT>, -n <COUNT>¶
要发送的总测量数量
- --batch <BATCH>, -b <BATCH>¶
每个批次中发送的测量数量
- --timestamp-start <TIMESTAMP_START>, -s <TIMESTAMP_START>¶
要使用的第一个时间戳
- --timestamp-end <TIMESTAMP_END>, -e <TIMESTAMP_END>¶
要使用的最后一个时间戳
- --wait¶
等待所有测量处理完成
- metric¶
指标的 ID 或名称
此命令由 gnocchiclient 插件提供。
指标基准测量显示¶
执行测量显示的基准测试。
openstack metric benchmark measures show
[--sort-column SORT_COLUMN]
[--sort-ascending | --sort-descending]
[--utc]
[--resource-id RESOURCE_ID]
[--aggregation AGGREGATION]
[--start START]
[--stop STOP]
[--granularity GRANULARITY]
[--refresh]
[--resample RESAMPLE]
[--workers WORKERS]
--count COUNT
metric
- --sort-column SORT_COLUMN¶
指定要对数据进行排序的列(首先指定的列具有优先级,不存在的列将被忽略),可以重复
- --sort-ascending¶
按升序对列进行排序
- --sort-descending¶
按降序对列进行排序
- --utc¶
以 UTC 时间戳返回
- --resource-id <RESOURCE_ID>, -r <RESOURCE_ID>¶
资源的 ID
- --aggregation <AGGREGATION>¶
要检索的聚合方式
- --start <START>¶
时间段的开始
- --stop <STOP>¶
时间段的结束
- --granularity <GRANULARITY>¶
要检索的粒度
- --refresh¶
强制聚合所有已知指标
- --resample <RESAMPLE>¶
将时间序列重采样到的粒度(以秒为单位)
- --workers <WORKERS>, -w <WORKERS>¶
使用的 worker 数量
- --count <COUNT>, -n <COUNT>¶
要发送的总测量数量
- metric¶
指标的 ID 或名称
此命令由 gnocchiclient 插件提供。
指标基准测试指标创建¶
执行指标创建的基准测试。
openstack metric benchmark metric create
[--resource-id RESOURCE_ID]
[--archive-policy-name ARCHIVE_POLICY_NAME]
[--workers WORKERS]
--count COUNT
[--keep]
- --resource-id <RESOURCE_ID>, -r <RESOURCE_ID>¶
资源的 ID
- --archive-policy-name <ARCHIVE_POLICY_NAME>, -a <ARCHIVE_POLICY_NAME>¶
归档策略的名称
- --workers <WORKERS>, -w <WORKERS>¶
使用的 worker 数量
- --count <COUNT>, -n <COUNT>¶
要创建的指标数量
- --keep, -k¶
保留创建的指标
此命令由 gnocchiclient 插件提供。
指标基准测试指标显示¶
执行指标显示的基准测试。
openstack metric benchmark metric show
[--resource-id RESOURCE_ID]
[--workers WORKERS]
--count COUNT
metric
[metric ...]
- --resource-id <RESOURCE_ID>, -r <RESOURCE_ID>¶
资源的 ID
- --workers <WORKERS>, -w <WORKERS>¶
使用的 worker 数量
- --count <COUNT>, -n <COUNT>¶
要获取的指标数量
- metric¶
指标的 ID 或名称
此命令由 gnocchiclient 插件提供。
指标功能列表¶
列出功能。
openstack metric capabilities list
此命令由 gnocchiclient 插件提供。
指标创建¶
创建一个指标。
openstack metric create
[--resource-id RESOURCE_ID]
[--archive-policy-name ARCHIVE_POLICY_NAME]
[--unit UNIT]
[METRIC_NAME]
- --resource-id <RESOURCE_ID>, -r <RESOURCE_ID>¶
资源的 ID
- --archive-policy-name <ARCHIVE_POLICY_NAME>, -a <ARCHIVE_POLICY_NAME>¶
归档策略的名称
- --unit <UNIT>, -u <UNIT>¶
指标的单位
- METRIC_NAME¶
指标名称
此命令由 gnocchiclient 插件提供。
指标删除¶
删除一个指标。
openstack metric delete [--resource-id RESOURCE_ID] metric [metric ...]
- --resource-id <RESOURCE_ID>, -r <RESOURCE_ID>¶
资源的 ID
- metric¶
指标的 ID 或名称
此命令由 gnocchiclient 插件提供。
指标列表¶
列出指标。
openstack metric list
[--sort-column SORT_COLUMN]
[--sort-ascending | --sort-descending]
[--limit <LIMIT>]
[--marker <MARKER>]
[--sort <SORT>]
- --sort-column SORT_COLUMN¶
指定要对数据进行排序的列(首先指定的列具有优先级,不存在的列将被忽略),可以重复
- --sort-ascending¶
按升序对列进行排序
- --sort-descending¶
按降序对列进行排序
- --limit <LIMIT>¶
要返回的指标数量(默认值为服务器默认值)
- --marker <MARKER>¶
上一次列出的最后一个项目。在此值之后返回下一个结果
- --sort <SORT>¶
指标属性的排序方式(例如:user_id:desc-nullslast
此命令由 gnocchiclient 插件提供。
指标测量值添加¶
向指标添加测量值。
openstack metric measures add
[--resource-id RESOURCE_ID]
-m MEASURE
metric
- --resource-id <RESOURCE_ID>, -r <RESOURCE_ID>¶
资源的 ID
- -m <MEASURE>, --measure <MEASURE>¶
用“@”分隔的测量值的时间戳和值
- metric¶
指标的 ID 或名称
此命令由 gnocchiclient 插件提供。
指标测量值聚合¶
获取聚合指标的测量值。
openstack metric measures aggregation
[--sort-column SORT_COLUMN]
[--sort-ascending | --sort-descending]
[--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]
- --sort-column SORT_COLUMN¶
指定要对数据进行排序的列(首先指定的列具有优先级,不存在的列将被忽略),可以重复
- --sort-ascending¶
按升序对列进行排序
- --sort-descending¶
按降序对列进行排序
- --utc¶
以 UTC 时间戳返回
- -m <METRIC>, --metric <METRIC>¶
指标 ID 或指标名称
- --aggregation <AGGREGATION>¶
要检索的聚合粒度函数
- --reaggregation <REAGGREGATION>¶
要检索的按组聚合函数
- --start <START>¶
时间段的开始
- --stop <STOP>¶
时间段的结束
- --granularity <GRANULARITY>¶
要检索的粒度
- --needed-overlap <NEEDED_OVERLAP>¶
每个指标所需的百分比数据点
- --query <QUERY>¶
用于过滤资源的查询。语法是属性、运算符和值的组合。例如:id=90d58eea-70d7-4294-a49a-170dcdf44c3c 将过滤具有特定 id 的资源。可以构建更复杂的查询,例如:not (flavor_id!=”1” and memory>=24)。使用 “” 强制将数据解释为字符串。支持的运算符有:not, and, ∧ or, ∨, >=, <=, !=, >, <, =, ==, eq, ne, lt, gt, ge, le, in, like, ≠, ≥, ≤, like, in。
- --resource-type <RESOURCE_TYPE>¶
要查询的资源类型
- --groupby <GROUPBY>¶
用于分组资源的属性
- --refresh¶
强制聚合所有已知指标
- --resample <RESAMPLE>¶
将时间序列重采样到的粒度(以秒为单位)
- --fill <FILL>¶
当数据集中部分序列缺少值时,用于填充时间戳的值。值应为浮点数或“null”。
此命令由 gnocchiclient 插件提供。
metric measures batch-metrics¶
openstack metric measures batch-metrics file
- file¶
包含要批量处理的度量值的的文件,或者使用标准输入 (请参阅 Gnocchi REST API 文档了解格式)
此命令由 gnocchiclient 插件提供。
metric measures batch-resources-metrics¶
openstack metric measures batch-resources-metrics
[--create-metrics]
file
- --create-metrics¶
创建未知的度量
- file¶
包含要批量处理的度量值的的文件,或者使用标准输入 (请参阅 Gnocchi REST API 文档了解格式)
此命令由 gnocchiclient 插件提供。
metric measures show¶
获取度量的度量值。
openstack metric measures show
[--sort-column SORT_COLUMN]
[--sort-ascending | --sort-descending]
[--utc]
[--resource-id RESOURCE_ID]
[--aggregation AGGREGATION]
[--start START]
[--stop STOP]
[--granularity GRANULARITY]
[--refresh]
[--resample RESAMPLE]
metric
- --sort-column SORT_COLUMN¶
指定要对数据进行排序的列(首先指定的列具有优先级,不存在的列将被忽略),可以重复
- --sort-ascending¶
按升序对列进行排序
- --sort-descending¶
按降序对列进行排序
- --utc¶
以 UTC 时间戳返回
- --resource-id <RESOURCE_ID>, -r <RESOURCE_ID>¶
资源的 ID
- --aggregation <AGGREGATION>¶
要检索的聚合方式
- --start <START>¶
时间段的开始
- --stop <STOP>¶
时间段的结束
- --granularity <GRANULARITY>¶
要检索的粒度
- --refresh¶
强制聚合所有已知指标
- --resample <RESAMPLE>¶
将时间序列重采样到的粒度(以秒为单位)
- metric¶
指标的 ID 或名称
此命令由 gnocchiclient 插件提供。
metric resource batch delete¶
根据属性值批量删除资源。
openstack metric resource batch delete [--type RESOURCE_TYPE] query
- --type <RESOURCE_TYPE>, -t <RESOURCE_TYPE>¶
资源类型
- query¶
用于过滤资源的查询。语法是属性、运算符和值的组合。例如:id=90d58eea-70d7-4294-a49a-170dcdf44c3c 将过滤具有特定 id 的资源。可以构建更复杂的查询,例如:not (flavor_id!=”1” and memory>=24)。使用 “” 强制将数据解释为字符串。支持的运算符有:not, and, ∧ or, ∨, >=, <=, !=, >, <, =, ==, eq, ne, lt, gt, ge, le, in, like, ≠, ≥, ≤, like, in。
此命令由 gnocchiclient 插件提供。
metric resource create¶
创建资源。
openstack metric resource create
[--type RESOURCE_TYPE]
[-a ATTRIBUTE]
[-m ADD_METRIC]
[-n CREATE_METRIC]
resource_id
- --type <RESOURCE_TYPE>, -t <RESOURCE_TYPE>¶
资源类型
- -a <ATTRIBUTE>, --attribute <ATTRIBUTE>¶
用“:”分隔的属性名称和值
- -m <ADD_METRIC>, --add-metric <ADD_METRIC>¶
要添加的度量的名称:id
- -n <CREATE_METRIC>, --create-metric <CREATE_METRIC>¶
要创建的度量的名称:archive_policy_name
- resource_id¶
资源的 ID
此命令由 gnocchiclient 插件提供。
metric resource delete¶
删除资源。
openstack metric resource delete resource_id
- resource_id¶
资源的 ID
此命令由 gnocchiclient 插件提供。
metric resource history¶
显示资源的记录。
openstack metric resource history
[--sort-column SORT_COLUMN]
[--sort-ascending | --sort-descending]
[--details]
[--limit <LIMIT>]
[--marker <MARKER>]
[--sort <SORT>]
[--type RESOURCE_TYPE]
resource_id
- --sort-column SORT_COLUMN¶
指定要对数据进行排序的列(首先指定的列具有优先级,不存在的列将被忽略),可以重复
- --sort-ascending¶
按升序对列进行排序
- --sort-descending¶
按降序对列进行排序
- --details¶
显示通用资源的全部属性
- --limit <LIMIT>¶
返回的资源数量(默认值为服务器默认值)
- --marker <MARKER>¶
上一次列出的最后一个项目。在此值之后返回下一个结果
- --sort <SORT>¶
资源属性的排序方式(例如:user_id:desc-nullslast
- --type <RESOURCE_TYPE>, -t <RESOURCE_TYPE>¶
资源类型
- resource_id¶
资源的 ID
此命令由 gnocchiclient 插件提供。
metric resource list¶
列出资源。
openstack metric resource list
[--sort-column SORT_COLUMN]
[--sort-ascending | --sort-descending]
[--details]
[--history]
[--limit <LIMIT>]
[--marker <MARKER>]
[--sort <SORT>]
[--type RESOURCE_TYPE]
- --sort-column SORT_COLUMN¶
指定要对数据进行排序的列(首先指定的列具有优先级,不存在的列将被忽略),可以重复
- --sort-ascending¶
按升序对列进行排序
- --sort-descending¶
按降序对列进行排序
- --details¶
显示通用资源的全部属性
- --history¶
显示资源的记录
- --limit <LIMIT>¶
返回的资源数量(默认值为服务器默认值)
- --marker <MARKER>¶
上一次列出的最后一个项目。在此值之后返回下一个结果
- --sort <SORT>¶
资源属性的排序方式(例如:user_id:desc-nullslast
- --type <RESOURCE_TYPE>, -t <RESOURCE_TYPE>¶
资源类型
此命令由 gnocchiclient 插件提供。
metric resource search¶
使用指定的查询规则搜索资源。
openstack metric resource search
[--sort-column SORT_COLUMN]
[--sort-ascending | --sort-descending]
[--details]
[--history]
[--limit <LIMIT>]
[--marker <MARKER>]
[--sort <SORT>]
[--type RESOURCE_TYPE]
query
- --sort-column SORT_COLUMN¶
指定要对数据进行排序的列(首先指定的列具有优先级,不存在的列将被忽略),可以重复
- --sort-ascending¶
按升序对列进行排序
- --sort-descending¶
按降序对列进行排序
- --details¶
显示通用资源的全部属性
- --history¶
显示资源的记录
- --limit <LIMIT>¶
返回的资源数量(默认值为服务器默认值)
- --marker <MARKER>¶
上一次列出的最后一个项目。在此值之后返回下一个结果
- --sort <SORT>¶
资源属性的排序方式(例如:user_id:desc-nullslast
- --type <RESOURCE_TYPE>, -t <RESOURCE_TYPE>¶
资源类型
- query¶
用于过滤资源的查询。语法是属性、运算符和值的组合。例如:id=90d58eea-70d7-4294-a49a-170dcdf44c3c 将过滤具有特定 id 的资源。可以构建更复杂的查询,例如:not (flavor_id!=”1” and memory>=24)。使用 “” 强制将数据解释为字符串。支持的运算符有:not, and, ∧ or, ∨, >=, <=, !=, >, <, =, ==, eq, ne, lt, gt, ge, le, in, like, ≠, ≥, ≤, like, in。
此命令由 gnocchiclient 插件提供。
metric resource show¶
显示资源。
openstack metric resource show [--type RESOURCE_TYPE] resource_id
- --type <RESOURCE_TYPE>, -t <RESOURCE_TYPE>¶
资源类型
- resource_id¶
资源的 ID
此命令由 gnocchiclient 插件提供。
metric resource update¶
更新资源。
openstack metric resource update
[--type RESOURCE_TYPE]
[-a ATTRIBUTE]
[-m ADD_METRIC]
[-n CREATE_METRIC]
[-d DELETE_METRIC]
resource_id
- --type <RESOURCE_TYPE>, -t <RESOURCE_TYPE>¶
资源类型
- -a <ATTRIBUTE>, --attribute <ATTRIBUTE>¶
用“:”分隔的属性名称和值
- -m <ADD_METRIC>, --add-metric <ADD_METRIC>¶
要添加的度量的名称:id
- -n <CREATE_METRIC>, --create-metric <CREATE_METRIC>¶
要创建的度量的名称:archive_policy_name
- -d <DELETE_METRIC>, --delete-metric <DELETE_METRIC>¶
要删除的度量的名称
- resource_id¶
资源的 ID
此命令由 gnocchiclient 插件提供。
metric resource-type create¶
创建资源类型。
openstack metric resource-type create [-a ATTRIBUTE] name
- -a <ATTRIBUTE>, --attribute <ATTRIBUTE>¶
属性定义,属性名:属性类型:属性是否必选:属性类型选项名=属性类型选项值:… 例如: display_name:string:true:max_length=255
- name¶
资源类型名称
此命令由 gnocchiclient 插件提供。
指标资源类型删除¶
删除一个资源类型。
openstack metric resource-type delete name
- name¶
资源类型名称
此命令由 gnocchiclient 插件提供。
指标资源类型列表¶
列出资源类型。
openstack metric resource-type list
[--sort-column SORT_COLUMN]
[--sort-ascending | --sort-descending]
- --sort-column SORT_COLUMN¶
指定要对数据进行排序的列(首先指定的列具有优先级,不存在的列将被忽略),可以重复
- --sort-ascending¶
按升序对列进行排序
- --sort-descending¶
按降序对列进行排序
此命令由 gnocchiclient 插件提供。
指标资源类型显示¶
显示一个资源类型。
openstack metric resource-type show name
- name¶
资源类型名称
此命令由 gnocchiclient 插件提供。
指标资源类型更新¶
创建资源类型。
openstack metric resource-type update
[-a ATTRIBUTE]
[-r REMOVE_ATTRIBUTE]
name
- -a <ATTRIBUTE>, --attribute <ATTRIBUTE>¶
属性定义,属性名:属性类型:属性是否必选:属性类型选项名=属性类型选项值:… 例如: display_name:string:true:max_length=255
- -r <REMOVE_ATTRIBUTE>, --remove-attribute <REMOVE_ATTRIBUTE>¶
属性名称
- name¶
资源类型名称
此命令由 gnocchiclient 插件提供。
指标服务器版本¶
显示 Gnocchi 服务器的版本。
openstack metric server version
此命令由 gnocchiclient 插件提供。
指标显示¶
显示一个指标。
openstack metric show [--resource-id RESOURCE_ID] metric
- --resource-id <RESOURCE_ID>, -r <RESOURCE_ID>¶
资源的 ID
- metric¶
指标的 ID 或名称
此命令由 gnocchiclient 插件提供。
指标状态¶
显示测量处理状态。
openstack metric status
此命令由 gnocchiclient 插件提供。