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

应用于时间序列的操作

用于过滤资源的查询。语法是属性、运算符和值的组合。例如: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 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 插件提供。