スクリプトを用いたカスタムメーターのご利用方法¶
カスタムメーターを作成してみる¶
サンプルスクリプトのダウンロード¶
メモリー情報を取得したいサーバーインスタンス上で、サンプルスクリプトをダウンロードします。
# curl -LO https://sdpf.ntt.com/docs/files/monitoring/custom_meter_scripts.tar.gz
ダウンロードできたら、圧縮ファイルを展開します。 展開先のパスは適宜修正ください。
# tar zxvf custom_meter_scripts.tar.gz
上記ファイルを展開すると、以下のようなファイルが存在します。
custom_meter_scripts
├── bin
│ ├── save_token
│ └── send_custom_meter
├── load_average_01.sh
├── load_average_05.sh
├── load_average_15.sh
├── use_memory.sh
├── ping_status.sh
├── ping_rtt_avg.sh
├── save_token.sh
├── setup.conf
└── token
項目 |
説明 |
お客さまでの変更要否 |
|---|---|---|
save_token |
トークンを取得するためのスクリプトです。
save_token.shによってコールされますので、編集は不要です。
|
不要 |
send_custom_meter |
カスタムメーターへ取得した値を送信するスクリプトです。
各スクリプトによってコールされますので、編集は不要です。
|
不要 |
load_average_01.sh |
|
適宜変更 |
load_average_05.sh |
|
適宜変更 |
load_average_15.sh |
|
適宜変更 |
use_memory.sh |
|
適宜変更 |
ping_status.sh |
|
適宜変更 |
ping_rtt_avg.sh |
|
適宜変更 |
save_token.sh |
APIによってトークンを取得します。 |
不要 |
setup.conf |
サンプルスクリプトを実行するためのパラメータを設定します。 |
必要 |
token |
トークンを記録するファイルです。
save_token.shよってトークンが記録されますので、編集は不要です。
|
不要 |
環境設定¶
setup.confを編集し、お客さまの環境でAPIを送信できるようにします。 ここでは、JP2リージョンで実施する環境に設定しています。 テナントIDやAPI鍵はお客さまの環境に合わせて設定してください。
# vi setup.conf
export AUTH_URL=https://keystone-jp2-ecl.api.ntt.com
export MONITORING_URL=https://monitoring-jp2-ecl.api.ntt.com
export TENANT_ID=<tenantID>
export USER_NAME=<API key>
export PASSWORD=<API secret key>
トークンの取得¶
環境設定が終わったら、APIエンドポイントからトークンを取得します。 正常にAPIエンドポイントと通信ができていれば、取得されたトークンが、tokenファイルに記載されます。
# sh save_token.sh
# cat token
8ee901ded...488efc28050
スクリプトファイルの編集¶
次にスクリプトファイルを編集します。ここでは例として、use_memory.shを編集します。
use_memory.sh
#!/bin/sh
. ./setup.conf
free -m | grep Mem: | awk {'print $3'} | send_custom_meter (RESOURCE_ID) (METER_NAME) (METER_TYPE) (METER_UNIT)
設定項目 |
説明 |
RESOURCE_ID |
カスタムメーターを紐づけるリソースのIDを設定します。 モニタリング対象メニューのリソースに対してカスタムメーターを登録する場合は、そのリソースのIDを指定します。 モニタリング対象外メニューのリソースに対してカスタムメーターを登録する場合は、任意の文字列を指定します。 |
METER_NAME |
カスタムメーターの名前を設定します。 |
METER_TYPE |
カスタムメーターのデータタイプを設定します。これは値がどんな種類かラベル付けするものです。 タイプは以下の通りです。
|
METER_UNIT |
カスタムメーター値の単位を設定します。 |
注釈
モニタリング対象メニューのリソースのIDはモニタリングの画面上で確認可能です。
データの取得と送信¶
前述で設定したスクリプトを実行します。 これによって、データの取得とモニタリング基盤へのデータ送信が完了します。 ただし、初回起動時はカスタムメーターの受け皿を作成しますので、データは保存されません。
# sh use_memory.sh
定期的にデータを送信するためには、上記スクリプトをcronで設定します。 モニタリング基盤は、最短で1分間隔のデータ受信が可能です。1分より短い場合には、受け付けられませんのでご注意ください。
# crontab -e
*/5 * * * * cd /root/custom_meter_scripts; sh use_memory.sh
注釈
送信されたデータがモニタリンググラフに反映されるまで数分時間かかる場合がございます。
注釈
最後の値登録を実施後、24時間何もサンプル値登録がなかった場合、非アクティブカスタムメーターとなります。非アクティブとなったカスタムメーターがデフォルトの保存期間31日を超過して自動的に削除された場合、当該カスタムメーターに対して作成していたアラームも同時に自動削除されます。アドバンスドプランのメーター保存期間延長機能により、保存期間を397日に延長できます。（※カスタムメーターは自動削除以外にユーザーによる操作で削除することはできません。）
カスタムメーターのグラフをみる¶
注釈
モニタリング対象メニュー以外のメニューに対してカスタムメーターを登録された場合、カスタムメーターのグラフは「カスタムリソース」タブに表示されます。