この記事は最終更新から1年以上経過しています。 気をつけてね。
Chef AnalyticsはChefServer上のオブジェクト変更や、Chef-ManageやKnifeといったクライアント達が何をしたか見やすく記録する、情シス臭あふれるコンポーネントです。
基本はChef-Serverに到達可能な別の場所に構築すべし(Standalone)なのですが、既存Chef-Server12と同じサーバにインストールする(Combined)ことも可能です。
Install Chef Analytics — Chef Docs
ただしChef-Server12と共存させる場合、次の仕様になります。
Chef-Server12がRC3の時点での仕様なので、このへんは変わるかもしれません。
- Chef-Server APIと同じIP/PortでListen
- ネームベースでChef-ServerAPIとChef Analyticsが振り分けられる
- Servernameを一緒にしちゃうと、Chef Analyticsが優先
この仕様から、うかつにCombinedでインストールすると、Chef-Server本体のエンドポイントが乗っ取られる悲劇が待っています。
安全にCombinedでインストールしよう
関連パッケージのchef-server-core, opscode-manage, opscode-analyticsはrpm/dpkgでインストール済みとします。
まずは公式の案内通りに/etc/opscode/private-chef.rbを編集します。
dark_launch['actions'] = true
analyticsとインテグレーションするため、reconfigure時にprivate-chef/recipes/actions.rbレシピを呼びます。
※ 一応案内通り、デフォルトでtrueな気がするんだけど...
で、一回chef-server-ctl reconfigureしておきます。
# chef-server-ctl reconfigure
...
Chef Client finished, 31/384 resources updated in 19.674226684 seconds
opscode Reconfigured!
ホスト名にxip.ioを利用しよう
次に/etc/opscode-analytics/opscode-analytics.rbを作成します。
ここで名前ベースのホスト名に、xip.ioを使います。
analytics_fqdn "54.199.xx.xxx.xip.io"
ちなみに、このファイルもRubyで書いてOKなうえ、Ohaiのアトリビュートもそのまあ使えるので、次のように書いてもOK。
analytics_fqdn "#{node[:cloud_v2][:public_ipv4]}.xip.io"
IaaSクラウドでEIPとか付け外ししてもreconfigureすれば済むのでおすすめ。
編集したら opscode-analytics-ctl でreconfigureします。
# opscode-analytics-ctl reconfigure
...
Chef Client finished, 104/114 resources updated in 36.144560204 seconds
opscode-analytics Reconfigured!
あとはパブリックIPとxip.ioでブラウザからアクセスすればChef Analyticsを使って見る事ができます。
xip.ioなので、オンプレミスでChef-Server12にプライベートIPしか付与してないという状態でも特に問題ないのはいいですね。
ログインはChef-Serverに登録済みのユーザで、関連付けられたOrgに関する情報を見ることができます。
Analyticsを有効にした後で色々と操作をしていくと、アクティビティが表示されていきます。
止めたくなったらopscode-analytics-ctl stopで止めときましょう。
本格運用したくなったらStandAloneを検討するか、自ドメインのホスト名くらいは付けてあげたほうが良いかも。
さいごに
Node内のChef-Clientの挙動はReporting, 操作ログ(オペログ)はChef Analyticsと役割が分かれていますね。