1. CloudStackのAlert機能を
使ってみよう
2013/12/26
CloudStack Advent Calendar jp: 2013
@tadashimishima

2. CloudStackのアラート管理機能の強化
• 4.2.0以前
• ダッシュボードと管理者へのメールのみ
• 4.2.0以降
• log4jを使ってSNMPとsyslogでの通知が可能
• イベントとアラートの削除、アーカイブ化が可能
• ログ収集ツールcloud-bugtoolの提供

3. SNMP、Syslogで送信可能な内容１
1.
2.
3.
4.
定義名
availableMemory
availableCpu
availableStorage
remainingStorageAllocated
内容
利用可能なメモリの閾値
未割当CPUの閾値
利用可能なストレージの閾値
残りのストレージの閾値
5. unallocatedVirtualNetworkpublicIp 仮想ネットワークの未割当パブリックIPアドレスの閾値
6. unallocatedPrivateIp
8. host
9. userVmState
10. domainRouterVmState
11. consoleProxyVmState
12. routingConnection
13. storageIssueSystemVms
未割当プライベートIPアドレスの閾値
アベイラビリティゾーンで利用可能なセカンダリストレージ
の閾値
ホスト関連のアラート
予期しないVMの停止
予期しないドメインルータの停止
予期しないコンソールプロキシの停止
デフォルトルートの切断
システムVMのストレージの問題
14. usageServerStatus
Usageサーバのプロセスが動作していない
7. availableSecondaryStorage

4. SNMP、Syslogで送信可能な内容２
定義名
15. managmentNode
内容
管理ネットワークのCIDRの設定が誤っている
16. domainRouterMigrate
ドメインルータVMの移行が失敗
17. consoleProxyMigrate
コンソールプロキシVMの移行が失敗
18. userVmMigrate
ユーザーVMの移行が失敗
19. unallocatedVlan
アベイラビリティゾーンで未割当のVLAN数の閾値
20. ssvmStopped
予期しないSSVMの停止
21. usageServerResult
Usageジョブが停止
22. storageDelete
ストレージプールの削除に失敗
23. updateResourceCount
リソースカウントの更新に失敗
24. usageSanityResult
Usageデータの確認に失敗
25. unallocatedDirectAttachedPublicIp
共有ネットワークの未割当IPアドレスの閾値
26. unallocatedLocalStorage
残りのローカルストレージの閾値
27. resourceLimitExceeded
リミットを越えたリソースリミット

5. SNMPによるアラート通知
• SNMPトラップによる通知が可能
• ポーリングは非対応
• SNMPv2対応
• 最大20のサーバに対して送信可能
• SNMPでの送信内容
•
•
•
•
•
メッセージ
ポッドID
データセンターID
クラスターID
生成時刻

6. CloudStackのMIBファイル
• 監視サーバ（ZabbixやHinemos等）がSNMPでの通知を受け取るた
めにMIBファイルを事前にインストールします
※手順は各監視サーバにより異なります。
• MIBファイル
CS-ROOT-MIB.mib
https://cwiki.apache.org/confluence/download/attachments/3
0747160/CS-ROOT-MIB.mib

7. SNMP通知の設定
• 設定ファイル
/etc/cloudstack/management/log4j-cloud.xml
※DevCloudはこの場所にはありません。
• 設定内容
<appender name="SNMP" class="org.apache.cloudstack.alert.snmp.SnmpTrapAppender">
<param name="Threshold" value="WARN"/> <!-- Do not edit. The alert feature assumes WARN. -->
<param name="SnmpManagerIpAddresses" value="10.1.1.1,10.1.1.2"/>
<param name="SnmpManagerPorts" value="162,162"/>
<param name="SnmpManagerCommunities" value="public,public"/>
<layout class="org.apache.cloudstack.alert.snmp.SnmpEnhancedPatternLayout"> <!-- Do not edit -->
<param name="PairDelimeter" value="//"/>
<param name="KeyValueDelimeter" value="::"/>
</layout>
</appender>

8. SNMP通知の設定箇所
• <param name="SnmpManagerIpAddresses"
value="10.1.1.1,10.1.1.2"/>
SNMPの監視サーバのIPアドレスを指定する
複数指定する場合はカンマで区切る
• <param name="SnmpManagerPorts" value="162,162"/>
SNMPの監視サーバのポート番号を指定する
複数指定する場合はIPアドレスの並び順でカンマで
区切って指定する
• <param name="SnmpManagerCommunities"
value="public,public"/>
SNMPのコミュニティ名を指定する
複数指定する場合はIPアドレスの並び順でカンマで
区切って指定する

9. Syslogによる通知
• Syslogによる通知が可能
• UDPによる送信
• 最大20のサーバに対して送信可能
• Syslogでの送信内容
•
•
•
•
•
アラートタイプ
メッセージ
ポッドID
データセンターID
クラスターID

10. Syslogのシビリティレベル
• Critical
•
•
•
•
•
•
•
•
•
•
•
host
userVmState
domainRouterVmState
consoleProxyVmState
storageIssueSystemVms
ssvmStopped
usageServerResult
usageServerStatus
domeinRouterMigrate
consoleProxyMigrate
routeinConnection
• WARN
上記以外

11. Syslog通知の設定
• 設定ファイル
/etc/cloudstack/management/log4j-cloud.xml
※DevCloudはこの場所にはありません。
• 設定内容
<appender name="ALERTSYSLOG">
<param name="Threshold" value="WARN"/>
<param name="SyslogHosts" value="10.1.1.1,10.1.1.2"/>
<param name="Facility" value="LOCAL6"/>
<layout>
<param name="ConversionPattern" value=""/>
</layout>
</appender>

12. Ssyslog通知の設定箇所
• <param name="SyslogHosts" value="10.1.1.1,10.1.1.2"/>
SyslogサーバのIPアドレスを指定する
複数指定する場合はカンマで区切る
• <param name="Facility" value="LOCAL6"/>
Syslogサーバのファシリティ名を指定する

13. イベントとアラートの削除、アーカイブ化
• CloudStackのUIから操作可能
• アーカイブ化されたデータはデータベース内にあり、直接DBを操作しな
いと見れない

14. ログ収集ツールcloud-bugtoolの提供
• トラブル時に各種データを一度に収集可能なpythonスクリプト
• Zipファイルをダウンロード後展開し、実行権限を与えて実行する
• 実行後、/tmpに収集データが保管される
# unzip cloud-bugtool.zip
# chmod 755 cloud-bugtool
# ./cloud-bugtool
Checking CloudStack instalation
We are going to collect diagnostic information now, please review the content and remove
~~~ 中略 ~~~
Compressing /tmp/cloudstack-bugtool_2013.12.26-12.41.14.2uogjC/CS-MGR . . . please wait (this may
take a while).
Diagnostic written and ready sent to support: /tmp/cloudstack-bugtool_2013.12.26-12.41.14.2uogjC.zip
# ls /tmp/
cloudstack-bugtool_2013.12.26-12.41.43.HoaBAm.zip
14

15. 参照先
• Release Note
• http://cloudstack.apache.org/docs/enUS/Apache_CloudStack/4.2.0/html/Release_Notes/version4.2.html#ops
• Administrator Alerts
(Manual)
• http://cloudstack.apache.org/docs/enUS/Apache_CloudStack/4.2.0/html/Admin_Guide/admin-alerts.html
• SNMP
• https://cwiki.apache.org/confluence/display/CLOUDSTACK/FS+for+In
tegrating+CS+alerts+via+SNMP+to+external+management+system
• Syslog
• https://cwiki.apache.org/confluence/display/CLOUDSTACK/FS+for+Sy
slog+Enhancements

16. See You Japan CloudStack User Group Meeting♪