Bug 1402214

Summary: [Docs] [RFE] Convert ceilometer commands to use gnocchi instead
Product: Red Hat OpenStack Reporter: Martin Lopes <mlopes>
Component: documentationAssignee: Martin Lopes <mlopes>
Status: CLOSED CURRENTRELEASE QA Contact: Don Domingo <ddomingo>
Severity: high Docs Contact:
Priority: unspecified    
Version: 10.0 (Newton)CC: ddomingo, eglynn, fbaudin, jdanjou, jruzicka, jschluet, lbopf, mabaakou, mbayer, mburns, nlevinki, pkilambi, rhel-osp-director-maint, sclewis, srevivo
Target Milestone: rcKeywords: Documentation, FutureFeature, Triaged
Target Release: 10.0 (Newton)   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: Enhancement
Doc Text:
Story Points: ---
Clone Of: 1366721 Environment:
Last Closed: 2016-12-20 05:16:33 UTC Type: Bug
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Bug Depends On: 1366721    
Bug Blocks:    

Description Martin Lopes 2016-12-07 04:43:07 UTC 
"The old Ceilometer API and therefore its associated "ceilometer <foobar>" (e.g. ceilometer sample-list or meter-list) commands won't work anymore by default as Ceilometer won't store any data itself.

Users should use the Gnocchi API instead and the "gnocchi <foobar>" command line tool, which will be fully available instead."

Source: https://bugzilla.redhat.com/show_bug.cgi?id=1366721#c11
Comment 1 Martin Lopes 2016-12-07 05:33:53 UTC 
Identified the following ceilometer commands used throughout the docs:

# ceilometer help
# ceilometer alarm-list
# ceilometer meter-list --query resource=_UUID_
# ceilometer alarm-threshold-create --name _alarm-name_ [--description _alarm-text_] --meter-name _meter-name_ --threshold _value_
# ceilometer alarm-threshold-create --name cpu_high --description 'CPU usage high' --meter-name cpu_usage_high --threshold 50 --comparison-operator gt --statistic avg --period 600 --evaluation-periods 3 --alarm-action 'log://' --query resource_id=5056eda6-8a24-4f52-9cc4-c3ddb6fb4a69
# ceilometer alarm-threshold-update 35addb25-d488-4a74-a038-076aad3a3dc3 --threshold=75
# ceilometer alarm-threshold-update --enabled False _ALARM_ID_
# ceilometer alarm-delete _ALARM_ID_
# ceilometer sample-list --meter _METER_NAME_
# ceilometer sample-list --meter _METER_NAME_ --query 'resource_id=_INSTANCE_ID_;timestamp>_START_TIME_;timestamp>=_END_TIME_'
# ceilometer sample-list --meter cpu --query 'resource_id=5056eda6-8a24-4f52-9cc4-c3ddb6fb4a69;timestamp>2015-01-12T13:10:00;timestamp>=2015-01-12T14:25:00'
# ceilometer sample-create --resource_id _RESOURCE_ID_ --meter-name _METER_NAME_ --meter-type _METER_TYPE_ --meter-unit _METER_UNIT_ --sample-volume _SAMPLE_VOLUME_
# ceilometer sample-create -r 5056eda6-8a24-4f52-9cc4-c3ddb6fb4a69 -m On_Time_Mins --meter-type cumulative --meter-unit mins --sample-volume 0
# ceilometer statistics --meter cpu_util
# ceilometer statistics --meter cpu_util --query 'resource_id=5056eda6-8a24-4f52-9cc4-c3ddb6fb4a69;timestamp>2015-01-12T13:00:00;timestamp<=2015-01-13T14:00:00'
# ceilometer statistics -m cpu_util -q metadata.user_metadata.stack=8f86c3d5-15cf-4a64-b9e8-70215498c046 -p 60 -a avg
Comment 2 Martin Lopes 2016-12-07 05:46:22 UTC 
Can't identify the gnocchi equivalent of alarm-list, checking with SME