第 7 章 警报

-h, --help

显示帮助信息并退出

--name <NAME>

警报的名称

-t <TYPE>, --type <TYPE>

警报类型应该是以下之一： event, composite, gnocchi_resources_threshold, gnocchi_aggregation_by_metrics_threshold, gnocchi_aggregation_by_resources_threshold。

--project-id <PROJECT_ID>

与警报关联的项目（仅由 admin 用户配置）

--user-id <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。可以多次使用

--OK-action <Webhook URL>

在状态转换为 ok 时调用的 URL。可以多次使用

--insufficient-data-action <Webhook URL>

当状态过渡到 insufficient data 时要调用的 URL。可以多次使用

--time-constraint <Time Constraint>

仅在评估时间在此时间约束内评估警报。约束的起点使用 cron 表达式指定，而其持续时间以秒为单位。可以多次指定多个时间限制，格式为： name=<CONSTRAINT_NAME>;start=< CRON>;duration=<SECONDS>;[description=<DESCRIPTION>;[t imezone=<IANA Timezone>]]

--repeat-actions {True|False}

如果为在警报处于目标状态时重复通知的 true

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

输出格式，默认为 table

-c COLUMN, --column COLUMN

可以重复指定要包含的列

--noindent

是否禁用对 json 的缩进

--prefix PREFIX

在所有变量名称中添加前缀

--max-width <integer>

最大显示宽度，即 <1 来禁用。您还可以使用 CLIFF_MAX_TERM_WIDTH 环境变量，但参数具有优先权。

--fit-width

将表与显示宽度匹配。如果 --max 宽度大于 0，则表示表示。将环境变量 CLIFF_FIT_WIDTH=1 设置为 always 启用

--print-empty

如果没有要显示数据，则打印空表。

--query <QUERY>

对于类型为 event: key[op]data_type::value; list. data_type 警报的警报，但如果提供，则必须为字符串、整数、浮点或布尔值。对于类型为 gnocchi_aggregation_by_resources_threshold: 的警报，需要指定复杂的查询 json 字符串，如 {"and": [{"=": {"ended_at": null}}, …​]}。

--comparison-operator <OPERATOR>

要比较的 operator，以下之一：[lt,le,eq,ne,ge,gt]

--evaluation-periods <EVAL_PERIODS>

评估的期间数

--threshold <THRESHOLD>

评估的阈值。

--event-type <EVENT_TYPE>

要评估的事件类型

--granularity <GRANULARITY>

要查询的时间范围（以秒为单位）。

--aggregation-method <AGGR_METHOD>

用于与阈值比较的 aggregation_method。

--metric <METRIC>, --metrics <METRIC>

指标 ID 或名称，具体取决于警报类型

--resource-type <RESOURCE_TYPE>

资源的类型。

--resource-id <RESOURCE_ID>

资源的 id。

--composite-rule <COMPOSITE_RULE>

使用 json 格式的复合阈值规则，表单可以是嵌套字典，它组合了 gnocchi 规则，即 "or"。例如，表单如下： {"or":[RULE1, RULE2, {"and": [RULE3, RULE4]}]}。