Bug 1473698 - [Doc][ceilometer] Add telemetry usage examples, describe alarm types.
[Doc][ceilometer] Add telemetry usage examples, describe alarm types.
Status: ON_DEV
Product: Red Hat OpenStack
Classification: Red Hat
Component: documentation (Show other bugs)
10.0 (Newton)
Unspecified Unspecified
low Severity low
: ---
: 12.0 (Pike)
Assigned To: Martin Lopes
Charelle Collett
: Triaged
Depends On:
Blocks:
  Show dependency treegraph
 
Reported: 2017-07-21 08:42 EDT by KOSAL RAJ I
Modified: 2017-09-28 10:08 EDT (History)
4 users (show)

See Also:
Fixed In Version:
Doc Type: If docs needed, set a value
Doc Text:
Story Points: ---
Clone Of:
Environment:
Last Closed:
Type: Bug
Regression: ---
Mount Type: ---
Documentation: ---
CRM:
Verified Versions:
Category: ---
oVirt Team: ---
RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: ---


Attachments (Terms of Use)

  None (edit)
Description KOSAL RAJ I 2017-07-21 08:42:37 EDT
Description of problem:

Can we have telemetry example in downstream as well.

Please follow the following upstream doc,

https://docs.openstack.org/aodh/latest/admin/telemetry-alarms.html

Version-Release number of selected component (if applicable):
RHOSP 10

How reproducible:


Steps to Reproduce:
1.
2.
3.

Actual results:


Expected results:


Additional info:
Comment 1 Martin Lopes 2017-07-25 00:20:29 EDT
Reviewed the existing guide: https://access.redhat.com/documentation/en-us/red_hat_openstack_platform/10/html-single/logging_monitoring_and_troubleshooting_guide/#monitoring_using_the_telemetry_service

Identified a few gaps that should be documented:

* Describe alarm dimensioning
* Describe composite alarms
* Describe alarm types:
--type event
--type composite

These should be added to the OSP11 guide, and backported to OSP10, where appropriate.
Comment 2 Martin Lopes 2017-07-25 01:45:14 EDT
Identified use case in BZ#1467317.

Created draft text for `--type event`.

----
This alarm raises an event when a particular instance is shutdown:

aodh alarm create \
	 --type event \
	 --name instance_off \
	 --description 'event_instance_power_off' \
	 --event-type "compute.instance.power_off.*" \
	 --enable True \
	 --query "traits.instance_id=string::ac917539-fa21-42fb-bac6-c3a795f056e" \
	 --alarm-action 'log://' \
	 --ok-action 'log://' \
	 --insufficient-data-action 'log://' \
	 --resource-type instance
----
Comment 3 Martin Lopes 2017-07-25 21:35:47 EDT
also elaborate on -alarm-action options, such as a webhook URL
Comment 4 Martin Lopes 2017-07-26 22:40:01 EDT
Emailed questions to SME.
Comment 5 Martin Lopes 2017-08-02 01:46:04 EDT
Also update examples to use the `ge` operator, where appropriate.
Comment 6 Martin Lopes 2017-08-03 18:48:43 EDT
Update: don't cover composite alarms
Comment 9 Martin Lopes 2017-08-08 00:55:53 EDT
See also https://access.redhat.com/solutions/2953931

Note You need to log in before you can comment on or make changes to this bug.