[Feedback]: The customer told us a number of API keys descriptions are missing

[Dariaus999]

Was the documentation helpful?

Yes

What documentation page is affected

https://www.elastic.co/docs/api/doc/kibana/operation/operation-post-alerting-rule-id#operation-post-alerting-rule-id-body-application-json-params_property_infra_metric_threshold-params-criteria-custom-criterion

Description

The customer wants to create Kibana Alerts for observability features based on Kibana documentation. However, the API descriptions are incomplete.

Missing API keys description

・threshold
・timeUnit
・timeSize
・warningThreshold
・customMetric -> name
・customMetric -> field
・equation
・label
・criteria.timeSize
　・sourceId
　・alertOnNoData
　・alertOnGroupDisappear
　・filterquerytext
　・filterQuery

[lcawl]

This seems to relate to the lack of descriptions in https://github.com/elastic/kibana/blob/main/x-pack/solutions/observability/plugins/infra/server/lib/alerting/docs/params_property_infra_metric_threshold.yaml (short term) and https://github.com/elastic/kibana/blob/main/src/platform/packages/shared/response-ops/rule_params/metric_inventory_threshold/v1.ts (long term), some of which might be derivable from https://www.elastic.co/guide/en/observability/current/metrics-threshold-alert.html#metrics-conditions

[lcawl]

Descriptions were added in elastic/kibana#213181 but there are some more that require clarification per the comments in that PR.