第2章 運用
2.3 コマンドリファレンス
2.3.4 ceilometer
名前
/usr/bin/ceilometer
形式
ceilometer [--timeout TIMEOUT] statistics [-q QUERY] -m NAME [-p PERIOD] [-g FIELD]
機能説明
統計情報を表示します。
ceilometerコマンドの詳細は、OpenStackのドキュメントを参照してください。
http://docs.openstack.org/cli-reference/ceilometer.html
サブコマンド
statisticsメータリングの統計情報を表示します。
オプション
--timeout TIMEOUT
タイムアウト時間を秒数で指定します。
省略した場合のデフォルト値は10分(600秒)です。
"ceilometer"と"statistics"の間に指定してください。
"statistics"のあとに記述するとエラーになります。
-q QUERY
取得内容を指定できます。
QUERY全体をシングルクォーテーション(')で囲んでください。
条件を複数指定する場合はセミコロン(";")で区切ります。
-
期間を指定する場合期間は不等号(">","<")を使って範囲指定できます。
日時はISO8601拡張形式で入力してください。
-
プロジェクトを指定する場合project_id=プロジェクトIDと指定してください。
-
リソースを指定する場合resource_id=リソースIDと指定してください。
-m NAME
計測項目を指定します。必須項目です。計測項目は以下から指定してください。
他の計測項目の詳細は、OpenStackのドキュメントを参照してください。
http://docs.openstack.org/admin-guide/telemetry-measurements.html
計測項目 説明
instance インスタンスの有無
memory インスタンスに割り当てられたメモリ
memory.usage インスタンスのメモリ使用量
cpu CPU使用時間
計測項目 説明
cpu_util CPU平均使用量
disk.read.requests readリクエスト数
disk.write.requests writeリクエスト数
disk.read.bytes readサイズ
disk.write.bytes writeサイズ
network.incoming.bytes 受信バイト量
network.outgoing.bytes 送信バイト量
network.incoming.packets 受信パケット量
network.outgoing.packets 送信パケット量
instance:m1.tiny インスタンスm1の有無 (tiny)
instance:m1.small インスタンスm1の有無 (small)
instance:m1.medium インスタンスm1の有無 (medium)
instance:m1.large インスタンスm1の有無 (large)
image イメージの有無
image.size アップロードしたイメージのサイズ
storage.objects オブジェクト数
storage.objects.size 保存されたオブジェクトの合計サイズ
storage.objects.containers コンテナの数
-p PERIOD
統計情報を取得する測定時間(秒)を指定します。
Horizon画面と同様に10分ごとの結果を取得するためには600を指定してください。
-g FIELD
グルーピングするフィールドを指定します。
プロジェクトごとの結果を取得する場合はproject_idを指定してください。
使用例
測定期間を指定して統計情報を取得する場合
# ceilometer statistics -m storage.objects.size -p 600 -q
'timestamp<2016-02-05T12:00:00;timestamp>2016-02-03T12:00:00' <RETURN>
+---+---+---+---+---+---+---+---+---+---+---+
| Period | Period Start | Period End | Max | Min | Avg | Sum | Count | Duration | Duration Start
| Duration End |
+---+---+---+---+---+---+---+---+---+---+---+
| 600 | 2016-02-05T00:40:00 | 2016-02-05T00:50:00 | 0.0 | 0.0 | 0.0 | 0.0 | 2 | 0.0 | 2016-02-05T00:48:24
| 2016-02-05T00:48:24 |
| 600 | 2016-02-05T00:50:00 | 2016-02-05T01:00:00 | 0.0 | 0.0 | 0.0 | 0.0 | 2 | 0.0 | 2016-02-05T00:58:24
| 2016-02-05T00:58:24 |
| 600 | 2016-02-05T01:00:00 | 2016-02-05T01:10:00 | 0.0 | 0.0 | 0.0 | 0.0 | 2 | 0.0 | 2016-02-05T01:08:24
| 2016-02-05T01:08:24 |
| 600 | 2016-02-05T01:10:00 | 2016-02-05T01:20:00 | 0.0 | 0.0 | 0.0 | 0.0 | 2 | 0.0 | 2016-02-05T01:18:24
| 2016-02-05T01:18:24 |
| 600 | 2016-02-05T01:20:00 | 2016-02-05T01:30:00 | 0.0 | 0.0 | 0.0 | 0.0 | 2 | 0.0 | 2016-02-05T01:28:24
| 2016-02-05T01:28:24 |
| 600 | 2016-02-05T01:30:00 | 2016-02-05T01:40:00 | 0.0 | 0.0 | 0.0 | 0.0 | 2 | 0.0 | 2016-02-05T01:38:24
| 2016-02-05T01:38:24 |
| 600 | 2016-02-05T01:40:00 | 2016-02-05T01:50:00 | 109.0 | 0.0 | 54.5 | 109.0 | 2 | 0.0 | 2016-02-05T01:48:24
| 2016-02-05T01:48:24 |
| 600 | 2016-02-05T01:50:00 | 2016-02-05T02:00:00 | 109.0 | 0.0 | 54.5 | 109.0 | 2 | 0.0 | 2016-02-05T01:58:24
| 2016-02-05T01:58:24 |
| 600 | 2016-02-05T02:00:00 | 2016-02-05T02:10:00 | 109.0 | 0.0 | 54.5 | 109.0 | 2 | 0.0 | 2016-02-05T02:08:24
| 2016-02-05T02:08:24 |
+---+---+---+---+---+---+---+---+---+---+---+
表示項目
項目名 説明
Period 統計情報を取得する測定時間(秒)
Period Start 測定の開始時刻
Period End 測定の終了時刻
Max 最大値
Min 最小値
Avg 平均値
Sum 合計値
Count 計測数
Duration 最新と最古のタイムスタンプの差分(秒)
Duration Start 測定結果で最も古いタイムスタンプ
Duration End 測定結果で最も新しいタイムスタンプ
必要な権限・実行環境
権限OSのroot権限 実行環境
管理サーバ(コントローラーVM2)
終了ステータス
以下の終了ステータスが返されます。
0
正常に処理されました。
1
処理に失敗しました。