第 13 章 Telemetry 服务命令行客户端


ceilometer 客户端是用于 Telemetry 服务 API 及其扩展的命令行界面(CLI)。本章记录了 ceilometer 版本 1.5.0。
有关特定 ceilometer 命令的帮助信息,请输入:
$ ceilometer help COMMAND

13.1. Ceilometer 用法

usage: ceilometer [--version] [-d] [-v] [--timeout TIMEOUT] [--ceilometer-url <CEILOMETER_URL>] [--ceilometer-api-version CEILOMETER_API_VERSION] [--os-tenant-id <tenant-id>] [--os-region-name <region-name>] [--os-auth-token <auth-token>] [--os-service-type <service-type>] [--os-endpoint-type <endpoint-type>] [--os-cacert <cacert>] [--os-insecure <insecure>] [--os-cert-file <cert-file>] [--os-key-file <key-file>] [--os-cert <cert>] [--os-key <key>] [--os-project-name <project-name>] [--os-project-id <project-id>] [--os-project-domain-id <project-domain-id>] [--os-project-domain-name <project-domain-name>] [--os-user-id <user-id>] [--os-user-domain-id <user-domain-id>] [--os-user-domain-name <user-domain-name>] [--os-endpoint <endpoint>] [--os-auth-system <auth-system>] [--os-username <username>] [--os-password <password>] [--os-tenant-name <tenant-name>] [--os-token <token>] [--os-auth-url <auth-url>] <subcommand> ...

子命令

alarm-combination-create
根据其他警报的状态创建新警报。
alarm-combination-update
根据其他警报的状态更新现有警报。
alarm-create
创建新警报(已弃用)。改为使用 alarm- threshold-create。
alarm-delete
删除警报。
alarm-event-create
根据事件创建新警报。
alarm-event-update
根据事件更新现有警报。
alarm-gnocchi-aggregation-by-metrics-threshold-create
根据计算的统计数据,创建一个新警报。
alarm-gnocchi-aggregation-by-metrics-threshold-update
根据计算的统计信息更新现有警报。
alarm-gnocchi-aggregation-by-resources-threshold-create
根据计算的统计数据,创建一个新警报。
alarm-gnocchi-aggregation-by-resources-threshold-update
根据计算的统计信息更新现有警报。
alarm-gnocchi-resources-threshold-create
根据计算的统计数据,创建一个新警报。
alarm-gnocchi-resources-threshold-update
根据计算的统计信息更新现有警报。
alarm-history
显示警报的更改历史记录。
alarm-list
列出用户的警报。
alarm-show
显示警报。
alarm-state-get
获取警报的状态。
alarm-state-set
设置警报的状态。
alarm-threshold-create
根据计算的统计数据,创建一个新警报。
alarm-threshold-update
根据计算的统计信息更新现有警报。
alarm-update
更新现有警报(已弃用)。
功能
打印 Ceilometer 功能.
event-list
列出事件。
event-show
显示特定事件。
event-type-list
列出事件类型。
meter-list
列出用户的量表。
query-alarm-history
查询警报历史.
query-alarms
查询警报.
query-samples
查询示例。
resource-list
列出资源。
resource-show
显示资源。
sample-create
创建示例。
sample-create-list
创建一个示例列表。
sample-list
列出示例(如果设置了 -m/-meter),则返回 OldSample 对象。
sample-show
显示示例。
statistics
列出量表的统计信息。
trait-description-list
列出事件类型的特征信息。
trait-list
列出名为 <trait_name> 用于 Event Type <event_type> 的所有特征。
bash-completion
将所有命令和选项输出到 stdout。
帮助
显示有关该程序或其其中一个子命令的帮助。

13.2. Ceilometer 可选参数

--version
显示程序的版本号并退出
-d, --debug
默认为 env[CEILOMETERCLIENT_DEBUG]。
-v, --verbose
打印更详细的输出。
--timeout TIMEOUT
等待响应的秒数。
--Ceilometer-url <CEILOMETER_URL>
DEPRECATED,改为使用 --os-endpoint。默认为 env[CEILOMETER_URL]。
--Ceilometer-api-version CEILOMETER_API_VERSION
默认为 env[CEILOMETER_API_VERSION] 或 2。
--os-tenant-id <tenant-id>
默认为 env[OS_TENANT_ID]。
--os-region-name <region-name>
默认为 env[OS_REGION_NAME]。
--os-auth-token <auth-token>
默认为 env[OS_AUTH_TOKEN]。
--os-service-type <service-type>
默认为 env[OS_SERVICE_TYPE]。
--os-endpoint-type <endpoint-type>
默认为 env[OS_ENDPOINT_TYPE]。
--os-cacert <cacert>
默认为 env[OS_CACERT]。
--os-insecure <insecure>
默认为 env[OS_INSECURE]。
--os-cert-file <cert-file>
默认为 env[OS_CERT_FILE]。
--os-key-file <key-file>
默认为 env[OS_KEY_FILE]。
--os-cert <cert>
默认为 env[OS_CERT]。
--os-key <key>
默认为 env[OS_KEY]。
--os-project-name <project-name>
默认为 env[OS_PROJECT_NAME]。
--os-project-id <project-id>
默认为 env[OS_PROJECT_ID]。
--os-project-domain-id <project-domain-id>
默认为 env[OS_PROJECT_DOMAIN_ID]。
--os-project-domain-name <project-domain-name>
默认为 env[OS_PROJECT_DOMAIN_NAME]。
--os-user-id <user-id>
默认为 env[OS_USER_ID]。
--os-user-domain-id <user-domain-id>
默认为 env[OS_USER_DOMAIN_ID]。
--os-user-domain-name <user-domain-name>
默认为 env[OS_USER_DOMAIN_NAME]。
--os-endpoint <endpoint>
默认为 env[OS_ENDPOINT]。
--os-auth-system <auth-system>
默认为 env[OS_AUTH_SYSTEM]。
--os-username <username>
默认为 env[OS_USERNAME]。
--os-password <password>
默认为 env[OS_PASSWORD]。
--os-tenant-name <tenant-name>
默认为 env[OS_TENANT_NAME]。
--os-token <token>
默认为 env[OS_TOKEN]。
--os-auth-url <auth-url>
默认为 env[OS_AUTH_URL]。

13.3. ceilometer alarm-combination-create

usage: ceilometer alarm-combination-create --name <NAME> [--project-id <ALARM_PROJECT_ID>] [--user-id <ALARM_USER_ID>] [--description <DESCRIPTION>] [--state <STATE>] [--severity <SEVERITY>] [--enabled {True|False}] [--alarm-action <Webhook URL>] [--ok-action <Webhook URL>] [--insufficient-data-action <Webhook URL>] [--time-constraint <Time Constraint>] [--repeat-actions {True|False}] --alarm_ids <ALARM IDS> [--operator <OPERATOR>]
根据其他警报的状态创建新警报。

可选参数

--name <NAME>
警报的名称(每个租户必须是唯一的)。必需。
--project-id <ALARM_PROJECT_ID>
与警报关联的租户(仅由 admin 用户设置)。
--user-id <ALARM_USER_ID>
与警报关联的用户(仅由 admin 用户设置)。
--description <DESCRIPTION>
警报的空闲文本描述。
--state <STATE>
警报的状态,其中之一: ['ok', 'alarm', 'insufficient data']
--severity <SEVERITY>
警报的严重性,其中之一: ['low', 'moderate', 'critical']
--enabled {True|False}
如果启用了警报评估/操作,则为 true。
--alarm-action <Webhook URL>
在状态过渡到 alarm 时调用的 URL。可以多次使用。默认值为 None。
--OK-action <Webhook URL>
当状态转换为 OK 时调用的 URL。可以多次使用。默认值为 None。
--insufficient-data-action <Webhook URL>
当状态过渡到 insufficient data 时要调用的 URL。可以多次使用。默认值为 None。
--time-constraint <Time Constraint>
仅在评估时间在此时间约束内评估警报。约束的起点使用 cron 表达式指定,而其持续时间以秒为单位。可以多次指定多个时间限制,格式为: name=<CONSTRAINT_NAME>;start=<CRON>;durati on=<SECONDS>;[description=<DESCRIPTION>;[timez one=<IANA Timezone>]] Defaults to None.
--repeat-actions {True|False}
如果为在警报保持目标状态时重复通知,则为 true。默认值为 False。
--alarm_ids <ALARM IDS>
警报 ID 列表。必需。
--Operator <OPERATOR>
要比较的运算符,其中之一: ['and', 'or']。

13.4. Ceilometer alarm-combination-update

usage: ceilometer alarm-combination-update [--name <NAME>] [--project-id <ALARM_PROJECT_ID>] [--user-id <ALARM_USER_ID>] [--description <DESCRIPTION>] [--state <STATE>] [--severity <SEVERITY>] [--enabled {True|False}] [--alarm-action <Webhook URL>] [--ok-action <Webhook URL>] [--insufficient-data-action <Webhook URL>] [--time-constraint <Time Constraint>] [--repeat-actions {True|False}] [--remove-time-constraint <Constraint names>] [--alarm_ids <ALARM IDS>] [--operator <OPERATOR>] [<ALARM_ID>]
根据其他警报的状态更新现有警报。

positional 参数

<ALARM_ID>
要更新的警报 ID。

可选参数

--name <NAME>
警报的名称(每个租户必须是唯一的)。
--project-id <ALARM_PROJECT_ID>
与警报关联的租户(仅由 admin 用户设置)。
--user-id <ALARM_USER_ID>
与警报关联的用户(仅由 admin 用户设置)。
--description <DESCRIPTION>
警报的空闲文本描述。
--state <STATE>
警报的状态,其中之一: ['ok', 'alarm', 'insufficient data']
--severity <SEVERITY>
警报的严重性,其中之一: ['low', 'moderate', 'critical']
--enabled {True|False}
如果启用了警报评估/操作,则为 true。
--alarm-action <Webhook URL>
在状态过渡到 alarm 时调用的 URL。可以多次使用。默认值为 None。
--OK-action <Webhook URL>
当状态转换为 OK 时调用的 URL。可以多次使用。默认值为 None。
--insufficient-data-action <Webhook URL>
当状态过渡到 insufficient data 时要调用的 URL。可以多次使用。默认值为 None。
--time-constraint <Time Constraint>
仅在评估时间在此时间约束内评估警报。约束的起点使用 cron 表达式指定,而其持续时间以秒为单位。可以多次指定多个时间限制,格式为: name=<CONSTRAINT_NAME>;start=<CRON>;durati on=<SECONDS>;[description=<DESCRIPTION>;[timez one=<IANA Timezone>]] Defaults to None.
--repeat-actions {True|False}
如果为在警报保持目标状态时重复通知,则为 true。默认值为 False。
--remove-time-constraint <Constraint name>
要删除的时间限制的名称或列表。
--alarm_ids <ALARM IDS>
警报 ID 列表。
--Operator <OPERATOR>
要比较的运算符,其中之一: ['and', 'or']。

13.5. Ceilometer alarm-delete

usage: ceilometer alarm-delete [<ALARM_ID>]
删除警报。

positional 参数

<ALARM_ID>
要删除的警报的 ID。

13.6. ceilometer alarm-event-create

usage: ceilometer alarm-event-create --name <NAME> [--project-id <ALARM_PROJECT_ID>] [--user-id <ALARM_USER_ID>] [--description <DESCRIPTION>] [--state <STATE>] [--severity <SEVERITY>] [--enabled {True|False}] [--alarm-action <Webhook URL>] [--ok-action <Webhook URL>] [--insufficient-data-action <Webhook URL>] [--time-constraint <Time Constraint>] [--repeat-actions {True|False}] [--event-type <EVENT_TYPE>] [-q <QUERY>]
根据事件创建新警报。

可选参数

--name <NAME>
警报的名称(每个租户必须是唯一的)。必需。
--project-id <ALARM_PROJECT_ID>
与警报关联的租户(仅由 admin 用户设置)。
--user-id <ALARM_USER_ID>
与警报关联的用户(仅由 admin 用户设置)。
--description <DESCRIPTION>
警报的空闲文本描述。
--state <STATE>
警报的状态,其中之一: ['ok', 'alarm', 'insufficient data']
--severity <SEVERITY>
警报的严重性,其中之一: ['low', 'moderate', 'critical']
--enabled {True|False}
如果启用了警报评估/操作,则为 true。
--alarm-action <Webhook URL>
在状态过渡到 alarm 时调用的 URL。可以多次使用。默认值为 None。
--OK-action <Webhook URL>
当状态转换为 OK 时调用的 URL。可以多次使用。默认值为 None。
--insufficient-data-action <Webhook URL>
当状态过渡到 insufficient data 时要调用的 URL。可以多次使用。默认值为 None。
--time-constraint <Time Constraint>
仅在评估时间在此时间约束内评估警报。约束的起点使用 cron 表达式指定,而其持续时间以秒为单位。可以多次指定多个时间限制,格式为: name=<CONSTRAINT_NAME>;start=<CRON>;durati on=<SECONDS>;[description=<DESCRIPTION>;[timez one=<IANA Timezone>]] Defaults to None.
--repeat-actions {True|False}
如果为在警报保持目标状态时重复通知,则为 true。默认值为 False。
--event-type <EVENT_TYPE>
事件警报的事件类型。
-Q <QUERY>, --query <QUERY>
key[op]data_type::value; 列表用于过滤 events。data_type 是可选的,但如果提供的字符串、整数、float 或 datetime。

13.7. Ceilometer alarm-event-update

usage: ceilometer alarm-event-update [--name <NAME>] [--project-id <ALARM_PROJECT_ID>] [--user-id <ALARM_USER_ID>] [--description <DESCRIPTION>] [--state <STATE>] [--severity <SEVERITY>] [--enabled {True|False}] [--alarm-action <Webhook URL>] [--ok-action <Webhook URL>] [--insufficient-data-action <Webhook URL>] [--time-constraint <Time Constraint>] [--repeat-actions {True|False}] [--event-type <EVENT_TYPE>] [-q <QUERY>] [<ALARM_ID>]
根据事件更新现有警报。

positional 参数

<ALARM_ID>
要更新的警报 ID。

可选参数

--name <NAME>
警报的名称(每个租户必须是唯一的)。
--project-id <ALARM_PROJECT_ID>
与警报关联的租户(仅由 admin 用户设置)。
--user-id <ALARM_USER_ID>
与警报关联的用户(仅由 admin 用户设置)。
--description <DESCRIPTION>
警报的空闲文本描述。
--state <STATE>
警报的状态,其中之一: ['ok', 'alarm', 'insufficient data']
--severity <SEVERITY>
警报的严重性,其中之一: ['low', 'moderate', 'critical']
--enabled {True|False}
如果启用了警报评估/操作,则为 true。
--alarm-action <Webhook URL>
在状态过渡到 alarm 时调用的 URL。可以多次使用。默认值为 None。
--OK-action <Webhook URL>
当状态转换为 OK 时调用的 URL。可以多次使用。默认值为 None。
--insufficient-data-action <Webhook URL>
当状态过渡到 insufficient data 时要调用的 URL。可以多次使用。默认值为 None。
--time-constraint <Time Constraint>
仅在评估时间在此时间约束内评估警报。约束的起点使用 cron 表达式指定,而其持续时间以秒为单位。可以多次指定多个时间限制,格式为: name=<CONSTRAINT_NAME>;start=<CRON>;durati on=<SECONDS>;[description=<DESCRIPTION>;[timez one=<IANA Timezone>]] Defaults to None.
--repeat-actions {True|False}
如果为在警报保持目标状态时重复通知,则为 true。默认值为 False。
--event-type <EVENT_TYPE>
事件警报的事件类型。
-Q <QUERY>, --query <QUERY>
key[op]data_type::value; 列表用于过滤 events。data_type 是可选的,但如果提供的字符串、整数、float 或 datetime。
usage: ceilometer alarm-gnocchi-aggregation-by-metrics-threshold-create --name <NAME> [--project-id <ALARM_PROJECT_ID>] [--user-id <ALARM_USER_ID>] [--description <DESCRIPTION>] [--state <STATE>] [--severity <SEVERITY>] [--enabled {True|False}] [--alarm-action <Webhook URL>] [--ok-action <Webhook URL>] [--insufficient-data-action <Webhook URL>] [--time-constraint <Time Constraint>] [--repeat-actions {True|False}] [--granularity <GRANULARITY>] [--evaluation-periods <COUNT>] [--aggregation-method <AGGREATION>] [--comparison-operator <OPERATOR>] --threshold <THRESHOLD> -m <METRICS>
根据计算的统计数据,创建一个新警报。

可选参数

--name <NAME>
警报的名称(每个租户必须是唯一的)。必需。
--project-id <ALARM_PROJECT_ID>
与警报关联的租户(仅由 admin 用户设置)。
--user-id <ALARM_USER_ID>
与警报关联的用户(仅由 admin 用户设置)。
--description <DESCRIPTION>
警报的空闲文本描述。
--state <STATE>
警报的状态,其中之一: ['ok', 'alarm', 'insufficient data']
--severity <SEVERITY>
警报的严重性,其中之一: ['low', 'moderate', 'critical']
--enabled {True|False}
如果启用了警报评估/操作,则为 true。
--alarm-action <Webhook URL>
在状态过渡到 alarm 时调用的 URL。可以多次使用。默认值为 None。
--OK-action <Webhook URL>
当状态转换为 OK 时调用的 URL。可以多次使用。默认值为 None。
--insufficient-data-action <Webhook URL>
当状态过渡到 insufficient data 时要调用的 URL。可以多次使用。默认值为 None。
--time-constraint <Time Constraint>
仅在评估时间在此时间约束内评估警报。约束的起点使用 cron 表达式指定,而其持续时间以秒为单位。可以多次指定多个时间限制,格式为: name=<CONSTRAINT_NAME>;start=<CRON>;durati on=<SECONDS>;[description=<DESCRIPTION>;[timez one=<IANA Timezone>]] Defaults to None.
--repeat-actions {True|False}
如果为在警报保持目标状态时重复通知,则为 true。默认值为 False。
--granularity <GRANULARITY>
要评估的每个时间段(秒)的长度。
--evaluation-periods <COUNT>
评估的期间数。
--aggregation-method <AGGREATION>
要使用的聚合方法之一: ['max', 'min', 'avg', 'sum', 'count']。
--comparison-operator <OPERATOR>
要比较的 operator,其中之一: ['lt', 'le', 'eq', 'ne', 'ge', 'gt']。
--threshold <THRESHOLD>
评估的阈值。必需。
-m <METRICS>, --metrics <METRICS>
要评估的指标。必需。
usage: ceilometer alarm-gnocchi-aggregation-by-metrics-threshold-update [--name <NAME>] [--project-id <ALARM_PROJECT_ID>] [--user-id <ALARM_USER_ID>] [--description <DESCRIPTION>] [--state <STATE>] [--severity <SEVERITY>] [--enabled {True|False}] [--alarm-action <Webhook URL>] [--ok-action <Webhook URL>] [--insufficient-data-action <Webhook URL>] [--time-constraint <Time Constraint>] [--repeat-actions {True|False}] [--granularity <GRANULARITY>] [--evaluation-periods <COUNT>] [--aggregation-method <AGGREATION>] [--comparison-operator <OPERATOR>] [--threshold <THRESHOLD>] [-m <METRICS>] [--remove-time-constraint <Constraint names>] [<ALARM_ID>]
根据计算的统计信息更新现有警报。

positional 参数

<ALARM_ID>
要更新的警报 ID。

可选参数

--name <NAME>
警报的名称(每个租户必须是唯一的)。
--project-id <ALARM_PROJECT_ID>
与警报关联的租户(仅由 admin 用户设置)。
--user-id <ALARM_USER_ID>
与警报关联的用户(仅由 admin 用户设置)。
--description <DESCRIPTION>
警报的空闲文本描述。
--state <STATE>
警报的状态,其中之一: ['ok', 'alarm', 'insufficient data']
--severity <SEVERITY>
警报的严重性,其中之一: ['low', 'moderate', 'critical']
--enabled {True|False}
如果启用了警报评估/操作,则为 true。
--alarm-action <Webhook URL>
在状态过渡到 alarm 时调用的 URL。可以多次使用。默认值为 None。
--OK-action <Webhook URL>
当状态转换为 OK 时调用的 URL。可以多次使用。默认值为 None。
--insufficient-data-action <Webhook URL>
当状态过渡到 insufficient data 时要调用的 URL。可以多次使用。默认值为 None。
--time-constraint <Time Constraint>
仅在评估时间在此时间约束内评估警报。约束的起点使用 cron 表达式指定,而其持续时间以秒为单位。可以多次指定多个时间限制,格式为: name=<CONSTRAINT_NAME>;start=<CRON>;durati on=<SECONDS>;[description=<DESCRIPTION>;[timez one=<IANA Timezone>]] Defaults to None.
--repeat-actions {True|False}
如果为在警报保持目标状态时重复通知,则为 true。默认值为 False。
--granularity <GRANULARITY>
要评估的每个时间段(秒)的长度。
--evaluation-periods <COUNT>
评估的期间数。
--aggregation-method <AGGREATION>
要使用的聚合方法之一: ['max', 'min', 'avg', 'sum', 'count']。
--comparison-operator <OPERATOR>
要比较的 operator,其中之一: ['lt', 'le', 'eq', 'ne', 'ge', 'gt']。
--threshold <THRESHOLD>
评估的阈值。
-m <METRICS>, --metrics <METRICS>
要评估的指标。
--remove-time-constraint <Constraint name>
要删除的时间限制的名称或列表。
usage: ceilometer alarm-gnocchi-aggregation-by-resources-threshold-create --name <NAME> [--project-id <ALARM_PROJECT_ID>] [--user-id <ALARM_USER_ID>] [--description <DESCRIPTION>] [--state <STATE>] [--severity <SEVERITY>] [--enabled {True|False}] [--alarm-action <Webhook URL>] [--ok-action <Webhook URL>] [--insufficient-data-action <Webhook URL>] [--time-constraint <Time Constraint>] [--repeat-actions {True|False}] [--granularity <GRANULARITY>] [--evaluation-periods <COUNT>] [--aggregation-method <AGGREATION>] [--comparison-operator <OPERATOR>] --threshold <THRESHOLD> -m <METRIC> --resource-type <RESOURCE_TYPE> --query <QUERY>
根据计算的统计数据,创建一个新警报。

可选参数

--name <NAME>
警报的名称(每个租户必须是唯一的)。必需。
--project-id <ALARM_PROJECT_ID>
与警报关联的租户(仅由 admin 用户设置)。
--user-id <ALARM_USER_ID>
与警报关联的用户(仅由 admin 用户设置)。
--description <DESCRIPTION>
警报的空闲文本描述。
--state <STATE>
警报的状态,其中之一: ['ok', 'alarm', 'insufficient data']
--severity <SEVERITY>
警报的严重性,其中之一: ['low', 'moderate', 'critical']
--enabled {True|False}
如果启用了警报评估/操作,则为 true。
--alarm-action <Webhook URL>
在状态过渡到 alarm 时调用的 URL。可以多次使用。默认值为 None。
--OK-action <Webhook URL>
当状态转换为 OK 时调用的 URL。可以多次使用。默认值为 None。
--insufficient-data-action <Webhook URL>
当状态过渡到 insufficient data 时要调用的 URL。可以多次使用。默认值为 None。
--time-constraint <Time Constraint>
仅在评估时间在此时间约束内评估警报。约束的起点使用 cron 表达式指定,而其持续时间以秒为单位。可以多次指定多个时间限制,格式为: name=<CONSTRAINT_NAME>;start=<CRON>;durati on=<SECONDS>;[description=<DESCRIPTION>;[timez one=<IANA Timezone>]] Defaults to None.
--repeat-actions {True|False}
如果为在警报保持目标状态时重复通知,则为 true。默认值为 False。
--granularity <GRANULARITY>
要评估的每个时间段(秒)的长度。
--evaluation-periods <COUNT>
评估的期间数。
--aggregation-method <AGGREATION>
要使用的聚合方法之一: ['max', 'min', 'avg', 'sum', 'count']。
--comparison-operator <OPERATOR>
要比较的 operator,其中之一: ['lt', 'le', 'eq', 'ne', 'ge', 'gt']。
--threshold <THRESHOLD>
评估的阈值。必需。
-m <METRIC>, --metric <METRIC>
要评估的指标。必需。
--resource-type <RESOURCE_TYPE>
要评估的 resource_type。必需。
--query <QUERY>
Gnocchi 资源搜索查询过滤器必填。
usage: ceilometer alarm-gnocchi-aggregation-by-resources-threshold-update [--name <NAME>] [--project-id <ALARM_PROJECT_ID>] [--user-id <ALARM_USER_ID>] [--description <DESCRIPTION>] [--state <STATE>] [--severity <SEVERITY>] [--enabled {True|False}] [--alarm-action <Webhook URL>] [--ok-action <Webhook URL>] [--insufficient-data-action <Webhook URL>] [--time-constraint <Time Constraint>] [--repeat-actions {True|False}] [--granularity <GRANULARITY>] [--evaluation-periods <COUNT>] [--aggregation-method <AGGREATION>] [--comparison-operator <OPERATOR>] [--threshold <THRESHOLD>] [-m <METRIC>] [--resource-type <RESOURCE_TYPE>] [--query <QUERY>] [--remove-time-constraint <Constraint names>] [<ALARM_ID>]
根据计算的统计信息更新现有警报。

positional 参数

<ALARM_ID>
要更新的警报 ID。

可选参数

--name <NAME>
警报的名称(每个租户必须是唯一的)。
--project-id <ALARM_PROJECT_ID>
与警报关联的租户(仅由 admin 用户设置)。
--user-id <ALARM_USER_ID>
与警报关联的用户(仅由 admin 用户设置)。
--description <DESCRIPTION>
警报的空闲文本描述。
--state <STATE>
警报的状态,其中之一: ['ok', 'alarm', 'insufficient data']
--severity <SEVERITY>
警报的严重性,其中之一: ['low', 'moderate', 'critical']
--enabled {True|False}
如果启用了警报评估/操作,则为 true。
--alarm-action <Webhook URL>
在状态过渡到 alarm 时调用的 URL。可以多次使用。默认值为 None。
--OK-action <Webhook URL>
当状态转换为 OK 时调用的 URL。可以多次使用。默认值为 None。
--insufficient-data-action <Webhook URL>
当状态过渡到 insufficient data 时要调用的 URL。可以多次使用。默认值为 None。
--time-constraint <Time Constraint>
仅在评估时间在此时间约束内评估警报。约束的起点使用 cron 表达式指定,而其持续时间以秒为单位。可以多次指定多个时间限制,格式为: name=<CONSTRAINT_NAME>;start=<CRON>;durati on=<SECONDS>;[description=<DESCRIPTION>;[timez one=<IANA Timezone>]] Defaults to None.
--repeat-actions {True|False}
如果为在警报保持目标状态时重复通知,则为 true。默认值为 False。
--granularity <GRANULARITY>
要评估的每个时间段(秒)的长度。
--evaluation-periods <COUNT>
评估的期间数。
--aggregation-method <AGGREATION>
要使用的聚合方法之一: ['max', 'min', 'avg', 'sum', 'count']。
--comparison-operator <OPERATOR>
要比较的 operator,其中之一: ['lt', 'le', 'eq', 'ne', 'ge', 'gt']。
--threshold <THRESHOLD>
评估的阈值。
-m <METRIC>, --metric <METRIC>
要评估的指标。
--resource-type <RESOURCE_TYPE>
要评估的 resource_type。
--query <QUERY>
Gnocchi 资源搜索查询过滤器
--remove-time-constraint <Constraint name>
要删除的时间限制的名称或列表。

13.12. ceilometer alarm-gnocchi-resources-threshold-create

usage: ceilometer alarm-gnocchi-resources-threshold-create --name <NAME> [--project-id <ALARM_PROJECT_ID>] [--user-id <ALARM_USER_ID>] [--description <DESCRIPTION>] [--state <STATE>] [--severity <SEVERITY>] [--enabled {True|False}] [--alarm-action <Webhook URL>] [--ok-action <Webhook URL>] [--insufficient-data-action <Webhook URL>] [--time-constraint <Time Constraint>] [--repeat-actions {True|False}] [--granularity <GRANULARITY>] [--evaluation-periods <COUNT>] [--aggregation-method <AGGREATION>] [--comparison-operator <OPERATOR>] --threshold <THRESHOLD> -m <METRIC> --resource-type <RESOURCE_TYPE> --resource-id <RESOURCE_ID>
根据计算的统计数据,创建一个新警报。

可选参数

--name <NAME>
警报的名称(每个租户必须是唯一的)。必需。
--project-id <ALARM_PROJECT_ID>
与警报关联的租户(仅由 admin 用户设置)。
--user-id <ALARM_USER_ID>
与警报关联的用户(仅由 admin 用户设置)。
--description <DESCRIPTION>
警报的空闲文本描述。
--state <STATE>
警报的状态,其中之一: ['ok', 'alarm', 'insufficient data']
--severity <SEVERITY>
警报的严重性,其中之一: ['low', 'moderate', 'critical']
--enabled {True|False}
如果启用了警报评估/操作,则为 true。
--alarm-action <Webhook URL>
在状态过渡到 alarm 时调用的 URL。可以多次使用。默认值为 None。
--OK-action <Webhook URL>
当状态转换为 OK 时调用的 URL。可以多次使用。默认值为 None。
--insufficient-data-action <Webhook URL>
当状态过渡到 insufficient data 时要调用的 URL。可以多次使用。默认值为 None。
--time-constraint <Time Constraint>
仅在评估时间在此时间约束内评估警报。约束的起点使用 cron 表达式指定,而其持续时间以秒为单位。可以多次指定多个时间限制,格式为: name=<CONSTRAINT_NAME>;start=<CRON>;durati on=<SECONDS>;[description=<DESCRIPTION>;[timez one=<IANA Timezone>]] Defaults to None.
--repeat-actions {True|False}
如果为在警报保持目标状态时重复通知,则为 true。默认值为 False。
--granularity <GRANULARITY>
要评估的每个时间段(秒)的长度。
--evaluation-periods <COUNT>
评估的期间数。
--aggregation-method <AGGREATION>
要使用的聚合方法之一: ['max', 'min', 'avg', 'sum', 'count']。
--comparison-operator <OPERATOR>
要比较的 operator,其中之一: ['lt', 'le', 'eq', 'ne', 'ge', 'gt']。
--threshold <THRESHOLD>
评估的阈值。必需。
-m <METRIC>, --metric <METRIC>
要评估的指标。必需。
--resource-type <RESOURCE_TYPE>
要评估的 resource_type。必需。
--resource-id <RESOURCE_ID>
要针对需要评估的资源 ID。

13.13. ceilometer alarm-gnocchi-resources-threshold-update

usage: ceilometer alarm-gnocchi-resources-threshold-update [--name <NAME>] [--project-id <ALARM_PROJECT_ID>] [--user-id <ALARM_USER_ID>] [--description <DESCRIPTION>] [--state <STATE>] [--severity <SEVERITY>] [--enabled {True|False}] [--alarm-action <Webhook URL>] [--ok-action <Webhook URL>] [--insufficient-data-action <Webhook URL>] [--time-constraint <Time Constraint>] [--repeat-actions {True|False}] [--granularity <GRANULARITY>] [--evaluation-periods <COUNT>] [--aggregation-method <AGGREATION>] [--comparison-operator <OPERATOR>] [--threshold <THRESHOLD>] [-m <METRIC>] [--resource-type <RESOURCE_TYPE>] [--resource-id <RESOURCE_ID>] [--remove-time-constraint <Constraint names>] [<ALARM_ID>]
根据计算的统计信息更新现有警报。

positional 参数

<ALARM_ID>
要更新的警报 ID。

可选参数

--name <NAME>
警报的名称(每个租户必须是唯一的)。
--project-id <ALARM_PROJECT_ID>
与警报关联的租户(仅由 admin 用户设置)。
--user-id <ALARM_USER_ID>
与警报关联的用户(仅由 admin 用户设置)。
--description <DESCRIPTION>
警报的空闲文本描述。
--state <STATE>
警报的状态,其中之一: ['ok', 'alarm', 'insufficient data']
--severity <SEVERITY>
警报的严重性,其中之一: ['low', 'moderate', 'critical']
--enabled {True|False}
如果启用了警报评估/操作,则为 true。
--alarm-action <Webhook URL>
在状态过渡到 alarm 时调用的 URL。可以多次使用。默认值为 None。
--OK-action <Webhook URL>
当状态转换为 OK 时调用的 URL。可以多次使用。默认值为 None。
--insufficient-data-action <Webhook URL>
当状态过渡到 insufficient data 时要调用的 URL。可以多次使用。默认值为 None。
--time-constraint <Time Constraint>
仅在评估时间在此时间约束内评估警报。约束的起点使用 cron 表达式指定,而其持续时间以秒为单位。可以多次指定多个时间限制,格式为: name=<CONSTRAINT_NAME>;start=<CRON>;durati on=<SECONDS>;[description=<DESCRIPTION>;[timez one=<IANA Timezone>]] Defaults to None.
--repeat-actions {True|False}
如果为在警报保持目标状态时重复通知,则为 true。默认值为 False。
--granularity <GRANULARITY>
要评估的每个时间段(秒)的长度。
--evaluation-periods <COUNT>
评估的期间数。
--aggregation-method <AGGREATION>
要使用的聚合方法之一: ['max', 'min', 'avg', 'sum', 'count']。
--comparison-operator <OPERATOR>
要比较的 operator,其中之一: ['lt', 'le', 'eq', 'ne', 'ge', 'gt']。
--threshold <THRESHOLD>
评估的阈值。
-m <METRIC>, --metric <METRIC>
要评估的指标。
--resource-type <RESOURCE_TYPE>
要评估的 resource_type。
--resource-id <RESOURCE_ID>
要评估的资源 ID
--remove-time-constraint <Constraint name>
要删除的时间限制的名称或列表。

13.14. Ceilometer alarm-history

usage: ceilometer alarm-history [-q <QUERY>] [<ALARM_ID>]
显示警报的更改历史记录。

positional 参数

<ALARM_ID>
显示历史记录的警报 ID。

可选参数

-Q <QUERY>, --query <QUERY>
key[op]data_type::value; list. data_type 是可选的,但如果提供,则必须为字符串、整数、浮点或布尔值。

13.15. ceilometer alarm-list

usage: ceilometer alarm-list [-q <QUERY>]
列出用户的警报。

可选参数

-Q <QUERY>, --query <QUERY>
key[op]data_type::value; list. data_type 是可选的,但如果提供,则必须为字符串、整数、浮点或布尔值。

13.16. ceilometer alarm-show

usage: ceilometer alarm-show [<ALARM_ID>]
显示警报。

positional 参数

<ALARM_ID>
要显示的警报 ID。

13.17. ceilometer alarm-state-get

usage: ceilometer alarm-state-get [<ALARM_ID>]
获取警报的状态。

positional 参数

<ALARM_ID>
要显示的警报状态的 ID。

13.18. ceilometer alarm-state-set

usage: ceilometer alarm-state-set --state <STATE> [<ALARM_ID>]
设置警报的状态。

positional 参数

<ALARM_ID>
要设置的警报状态的 ID。

可选参数

--state <STATE>
警报的状态,其中之一: ['ok', 'alarm', 'insufficient data']。必需。

13.19. ceilometer alarm-threshold-create

usage: ceilometer alarm-threshold-create --name <NAME> [--project-id <ALARM_PROJECT_ID>] [--user-id <ALARM_USER_ID>] [--description <DESCRIPTION>] [--state <STATE>] [--severity <SEVERITY>] [--enabled {True|False}] [--alarm-action <Webhook URL>] [--ok-action <Webhook URL>] [--insufficient-data-action <Webhook URL>] [--time-constraint <Time Constraint>] [--repeat-actions {True|False}] -m <METRIC> [--period <PERIOD>] [--evaluation-periods <COUNT>] [--statistic <STATISTIC>] [--comparison-operator <OPERATOR>] --threshold <THRESHOLD> [-q <QUERY>]
根据计算的统计数据,创建一个新警报。

可选参数

--name <NAME>
警报的名称(每个租户必须是唯一的)。必需。
--project-id <ALARM_PROJECT_ID>
与警报关联的租户(仅由 admin 用户设置)。
--user-id <ALARM_USER_ID>
与警报关联的用户(仅由 admin 用户设置)。
--description <DESCRIPTION>
警报的空闲文本描述。
--state <STATE>
警报的状态,其中之一: ['ok', 'alarm', 'insufficient data']
--severity <SEVERITY>
警报的严重性,其中之一: ['low', 'moderate', 'critical']
--enabled {True|False}
如果启用了警报评估/操作,则为 true。
--alarm-action <Webhook URL>
在状态过渡到 alarm 时调用的 URL。可以多次使用。默认值为 None。
--OK-action <Webhook URL>
当状态转换为 OK 时调用的 URL。可以多次使用。默认值为 None。
--insufficient-data-action <Webhook URL>
当状态过渡到 insufficient data 时要调用的 URL。可以多次使用。默认值为 None。
--time-constraint <Time Constraint>
仅在评估时间在此时间约束内评估警报。约束的起点使用 cron 表达式指定,而其持续时间以秒为单位。可以多次指定多个时间限制,格式为: name=<CONSTRAINT_NAME>;start=<CRON>;durati on=<SECONDS>;[description=<DESCRIPTION>;[timez one=<IANA Timezone>]] Defaults to None.
--repeat-actions {True|False}
如果为在警报保持目标状态时重复通知,则为 true。默认值为 False。
-m <METRIC>, --meter-name <METRIC>
要评估的指标。必需。
--period <PERIOD>
要评估的每个时间段(秒)的长度。
--evaluation-periods <COUNT>
评估的期间数。
--statistic <STATISTIC>
评估的统计数据: ['max', 'min', 'avg', 'sum', 'count']。
--comparison-operator <OPERATOR>
要比较的 operator,其中之一: ['lt', 'le', 'eq', 'ne', 'ge', 'gt']。
--threshold <THRESHOLD>
评估的阈值。必需。
-Q <QUERY>, --query <QUERY>
key[op]data_type::value; list. data_type 是可选的,但如果提供,则必须为字符串、整数、浮点或布尔值。

13.20. ceilometer alarm-threshold-update

usage: ceilometer alarm-threshold-update [--name <NAME>] [--project-id <ALARM_PROJECT_ID>] [--user-id <ALARM_USER_ID>] [--description <DESCRIPTION>] [--state <STATE>] [--severity <SEVERITY>] [--enabled {True|False}] [--alarm-action <Webhook URL>] [--ok-action <Webhook URL>] [--insufficient-data-action <Webhook URL>] [--time-constraint <Time Constraint>] [--repeat-actions {True|False}] [--remove-time-constraint <Constraint names>] [-m <METRIC>] [--period <PERIOD>] [--evaluation-periods <COUNT>] [--statistic <STATISTIC>] [--comparison-operator <OPERATOR>] [--threshold <THRESHOLD>] [-q <QUERY>] [<ALARM_ID>]
根据计算的统计信息更新现有警报。

positional 参数

<ALARM_ID>
要更新的警报 ID。

可选参数

--name <NAME>
警报的名称(每个租户必须是唯一的)。
--project-id <ALARM_PROJECT_ID>
与警报关联的租户(仅由 admin 用户设置)。
--user-id <ALARM_USER_ID>
与警报关联的用户(仅由 admin 用户设置)。
--description <DESCRIPTION>
警报的空闲文本描述。
--state <STATE>
警报的状态,其中之一: ['ok', 'alarm', 'insufficient data']
--severity <SEVERITY>
警报的严重性,其中之一: ['low', 'moderate', 'critical']
--enabled {True|False}
如果启用了警报评估/操作,则为 true。
--alarm-action <Webhook URL>
在状态过渡到 alarm 时调用的 URL。可以多次使用。默认值为 None。
--OK-action <Webhook URL>
当状态转换为 OK 时调用的 URL。可以多次使用。默认值为 None。
--insufficient-data-action <Webhook URL>
当状态过渡到 insufficient data 时要调用的 URL。可以多次使用。默认值为 None。
--time-constraint <Time Constraint>
仅在评估时间在此时间约束内评估警报。约束的起点使用 cron 表达式指定,而其持续时间以秒为单位。可以多次指定多个时间限制,格式为: name=<CONSTRAINT_NAME>;start=<CRON>;durati on=<SECONDS>;[description=<DESCRIPTION>;[timez one=<IANA Timezone>]] Defaults to None.
--repeat-actions {True|False}
如果为在警报保持目标状态时重复通知,则为 true。默认值为 False。
--remove-time-constraint <Constraint name>
要删除的时间限制的名称或列表。
-m <METRIC>, --meter-name <METRIC>
要评估的指标。
--period <PERIOD>
要评估的每个时间段(秒)的长度。
--evaluation-periods <COUNT>
评估的期间数。
--statistic <STATISTIC>
评估的统计数据: ['max', 'min', 'avg', 'sum', 'count']。
--comparison-operator <OPERATOR>
要比较的 operator,其中之一: ['lt', 'le', 'eq', 'ne', 'ge', 'gt']。
--threshold <THRESHOLD>
评估的阈值。
-Q <QUERY>, --query <QUERY>
key[op]data_type::value; list. data_type 是可选的,但如果提供,则必须为字符串、整数、浮点或布尔值。

13.21. Ceilometer 功能

usage: ceilometer capabilities
打印 Ceilometer 功能.

13.22. ceilometer event-list

usage: ceilometer event-list [-q <QUERY>] [--no-traits] [-l <NUMBER>]
列出事件。

可选参数

-Q <QUERY>, --query <QUERY>
key[op]data_type::value; list. data_type 是可选的,但如果提供,则必须为字符串、整数、浮点时间。
--no-traits
如果指定,则不会打印特征。
-L <NUMBER>, --limit <NUMBER>
要返回的最大事件数。

13.23. ceilometer event-show

usage: ceilometer event-show <message_id>
显示特定事件。

positional 参数

<message_id>
事件的 ID。应该是 UUID。

13.24. ceilometer event-type-list

usage: ceilometer event-type-list
列出事件类型。

13.25. ceilometer meter-list

usage: ceilometer meter-list [-q <QUERY>] [-l <NUMBER>]
列出用户的量表。

可选参数

-Q <QUERY>, --query <QUERY>
key[op]data_type::value; list. data_type 是可选的,但如果提供,则必须为字符串、整数、浮点或布尔值。
-L <NUMBER>, --limit <NUMBER>
要返回的最大量表数。

13.26. ceilometer query-alarm-history

usage: ceilometer query-alarm-history [-f <FILTER>] [-o <ORDERBY>] [-l <LIMIT>]
查询警报历史.

可选参数

-f <FILTER>, --filter <FILTER>
{complex_op: [{simple_op: {field_name: value}}]} The complex_op 是:['and', 'or'], simple_op 之一:['=', '!=', '<', '<=', '>', '>=']。
-o <ORDERBY>, --orderby <ORDERBY>
[{field_name: direction}, {field_name: direction}] 方向是其中之一: ['asc', 'desc']。
-L <LIMIT>, --limit <LIMIT>
要返回的最大警报历史记录项数。

13.27. ceilometer query-alarms

usage: ceilometer query-alarms [-f <FILTER>] [-o <ORDERBY>] [-l <LIMIT>]
查询警报.

可选参数

-f <FILTER>, --filter <FILTER>
{complex_op: [{simple_op: {field_name: value}}]} The complex_op 是:['and', 'or'], simple_op 之一:['=', '!=', '<', '<=', '>', '>=']。
-o <ORDERBY>, --orderby <ORDERBY>
[{field_name: direction}, {field_name: direction}] 方向是其中之一: ['asc', 'desc']。
-L <LIMIT>, --limit <LIMIT>
要返回的最大警报数。

13.28. ceilometer query-samples

usage: ceilometer query-samples [-f <FILTER>] [-o <ORDERBY>] [-l <LIMIT>]
查询示例。

可选参数

-f <FILTER>, --filter <FILTER>
{complex_op: [{simple_op: {field_name: value}}]} The complex_op 是:['and', 'or'], simple_op 之一:['=', '!=', '<', '<=', '>', '>=']。
-o <ORDERBY>, --orderby <ORDERBY>
[{field_name: direction}, {field_name: direction}] 方向是其中之一: ['asc', 'desc']。
-L <LIMIT>, --limit <LIMIT>
要返回的最大示例数。

13.29. ceilometer resource-list

usage: ceilometer resource-list [-q <QUERY>] [-l <NUMBER>]
列出资源。

可选参数

-Q <QUERY>, --query <QUERY>
key[op]data_type::value; list. data_type 是可选的,但如果提供,则必须为字符串、整数、浮点或布尔值。
-L <NUMBER>, --limit <NUMBER>
要返回的资源的最大数量。

13.30. ceilometer resource-show

usage: ceilometer resource-show <RESOURCE_ID>
显示资源。

positional 参数

<RESOURCE_ID>
要显示的资源 ID。

13.31. ceilometer sample-create

usage: ceilometer sample-create [--project-id <SAMPLE_PROJECT_ID>] [--user-id <SAMPLE_USER_ID>] -r <RESOURCE_ID> -m <METER_NAME> --meter-type <METER_TYPE> --meter-unit <METER_UNIT> --sample-volume <SAMPLE_VOLUME> [--resource-metadata <RESOURCE_METADATA>] [--timestamp <TIMESTAMP>] [--direct <DIRECT>]
创建示例。

可选参数

--project-id <SAMPLE_PROJECT_ID>
与示例关联的租户(仅由 admin 用户设置)。
--user-id <SAMPLE_USER_ID>
与示例关联的用户(仅由 admin 用户设置)。
-r <RESOURCE_ID>, --resource-id <RESOURCE_ID>
资源的 ID。必需。
-m <METER_NAME>, --meter-name <METER_NAME>
计量名称。必需。
--meter-type <METER_TYPE>
计量类型。必需。
--meter-unit <METER_UNIT>
计量单元。必需。
--sample-volume <SAMPLE_VOLUME>
示例卷。必需。
--resource-metadata <RESOURCE_METADATA>
资源元数据.提供的值应当是一组键值对,如 {"key":"value"}。
--timestamp <TIMESTAMP>
示例时间戳。
--direct <DIRECT>
直接将示例发布到存储。默认值为 False。

13.32. ceilometer sample-create-list

usage: ceilometer sample-create-list [--direct <DIRECT>] <SAMPLES_LIST>
创建一个示例列表。

positional 参数

<SAMPLES_LIST>
带有要创建的示例的 JSON 数组。

可选参数

--direct <DIRECT>
直接将示例发布到存储。默认值为 False。

13.33. ceilometer sample-list

usage: ceilometer sample-list [-q <QUERY>] [-m <NAME>] [-l <NUMBER>]
列出示例(如果设置了 -m/-meter),则返回 OldSample 对象。

可选参数

-Q <QUERY>, --query <QUERY>
key[op]data_type::value; list. data_type 是可选的,但如果提供,则必须为字符串、整数、浮点或布尔值。
-m <NAME>, --meter <NAME>
显示示例的计量名称。
-L <NUMBER>, --limit <NUMBER>
要返回的最大示例数。

13.34. ceilometer sample-show

usage: ceilometer sample-show <SAMPLE_ID>
显示示例。

positional 参数

<SAMPLE_ID>
要显示的示例 ID (也称为消息 ID)。

13.35. Ceilometer 统计

usage: ceilometer statistics [-q <QUERY>] -m <NAME> [-p <PERIOD>] [-g <FIELD>] [-a <FUNC>[<-<PARAM>]]
列出量表的统计信息。

可选参数

-Q <QUERY>, --query <QUERY>
key[op]data_type::value; list. data_type 是可选的,但如果提供,则必须为字符串、整数、浮点或布尔值。
-m <NAME>, --meter <NAME>
列出统计信息的计量名称。必需。
-p <PERIOD>, --period <PERIOD>
对样本进行分组的期间(以秒为单位)。
-g <FIELD>, --groupby <FIELD>
组的字段按以下项:
-a <FUNC>[<-<PARAM>], --aggregate <FUNC>[<-<PARAM>]
数据聚合功能。可用的聚合有:count, cardinality, min, max, sum, stddev, avg.默认为 []。

13.36. ceilometer trait-description-list

usage: ceilometer trait-description-list -e <EVENT_TYPE>
列出事件类型的特征信息。

可选参数

-e <EVENT_TYPE>, --event_type <EVENT_TYPE>
显示特征的事件类型。必需。

13.37. ceilometer trait-list

usage: ceilometer trait-list -e <EVENT_TYPE> -t <TRAIT_NAME>
列出名为 <trait_name> 用于 Event Type <event_type> 的所有特征。

可选参数

-e <EVENT_TYPE>, --event_type <EVENT_TYPE>
列出特征的事件类型。必需。
-T <TRAIT_NAME>, --trait_name <TRAIT_NAME>
要列出的特征的名称。必需。
Red Hat logoGithubRedditYoutubeTwitter

学习

尝试、购买和销售

社区

關於紅帽

我们提供强化的解决方案,使企业能够更轻松地跨平台和环境(从核心数据中心到网络边缘)工作。

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情,请参阅红帽博客.

关于红帽文档

Legal Notice

Theme

© 2026 Red Hat
返回顶部