fluentdをwindowsにインストール方法。Windowsでもfluentdが動作する

プチSE

8年前

ログ収集ツール、fluentd(td-agent)をWindows上にインストールし
動作させる方法を紹介します。

ポイントは「checkout windows」です。
チェックアウトwindowsをしないと、Windowsでfluentdが正常動作しなかったケースがありました。

レジュメ

1 fluentdインストールの流れ
2 fluentdの操作・確認方法

fluentdインストールの流れ

Rubyをインストールします
fluentdはRuby上で動作するプログラムです
RudyのDevelopment kitをインストールします。
Gitを使用しgitbhubからfluentdをダウンロードとします
Githubはソース管理システムです、Gitコマンドを利用しダウンロードします。
fluentdをインストールします
fluentdの動作確認
fluentdをWindowsサービス登録します

環境・前提条件

今回紹介する環境です

Windows server 2012 R2
Ruby 2.2.4 (x64)
DevKit-mingw64-64-4.7.2-20130224-1432-sfx
Git-2.8.2-64-bit
fluentd-0.14.0

での構築例になります

１、RubyをWindowsにインストール方法

Ruby Installer for windows サイトからRubyをダウンロードし、インストールをします。今回は、

Ruby 2.2.4 (x64)

を使用します。
※ 残念ながらruby2.3.0では現バージョンのfluentdをインストールできませんでした

１－１、セットアップに使用する言語の選択

「日本語」を選び「OK」ボタンを押します

１－２、Ruby2.3.0-p0-x64使用許諾契約書の同意

「同意する」にチェックし、「次へ」ボタンをします

１－３、インストール先とオプションの指定

「Rudyの実行ファイルへ環境変数PATHを設定する」にチェックを入れて、「インストール」ボタンを押します

１－４、Rudy2.3.0-p0-x64セットアップウィザードの完了

「完了」ボタンを押します

２、RubyのDevelopment kitをインストール方法

Ruby Installer for windows サイトからRuby Development kitをダウンロードします。今回は

DevKit-mingw64-64-4.7.2-20130224-1432-sfx.exe

を使用します。（ダウンロードしたrudyに合わせて選択してください）

２－１、7-Zip self-extracting archive (自己解凍)

解凍先を「c:\ruby」とし、「Extract」ボタンを押します

２－２、config.ymlの編集

以下のコマンドをコマンドプロンプトから実行します

cd c:\ruby
ruby dk.rb init
notepad config.yml

作成された、config.ymlファイルをの編集します

先ほどrubyをインストールしたパスを追記します「- C:\Ruby22-x64」

２－３、インストール

コマンドプロンプト上で以下のコマンドを実行し、上記のようなinfo画面が出ることを確認します

ruby dk.rb install

３、Gitからfluentdをダウンロード。Windows版

Gitからプログラムをダウンロードするのに、gitコマンドをインストールし使用する方法になります。
（fluentd-0.14.0ではfluentd.gemspec内でgitを使用しているので必要になります）

３－１、Gitのダウンロード

cd

Git Downloadサイトから「Git」をダウンロードします。今回は

Git-2.8.2-64-bit

です。Gitのインストールをします

３－２、Git 2.8.2セットアップ

「Next」ボタンを押します

３－３、インストールフォルダの指定

「Next」ボタンを押します

３－４、コンポーネントの選択

「Next」ボタンを押します

３－５、スタートメニューフォルダの作成

「Next」ボタンを押します

３－６、PATH環境変数の調整

「Use Git from the Windows Command Prompt」を選択し「Next」ボタンを押します

３－７、ライン終了の設定をします

「Next」ボタンを押します

３－８、ターミナルエミュレータの設定

「Next」ボタンを押します

３－９、その他オプション

「Install」ボタンを押します

３－１０、セットアップウィザードの完了

「Finish」ボタンを押します

４、fluentdをインストール方法

以下のコマンドを実行します。

cd c:\
git clone https://github.com/fluent/fluentd.git
cd fluentd
gem install bundler
bundle
bundle exec rake build
gem install pkg/fluentd-0.14.0.pre.1.gem --no-ri --no-rdoc

fluentdの操作・確認方法

コマンドfluentdの起動方法

cd c:\fluentd
fluentd -c c:\fluentd\fluent.conf

上記コマンドを実行し、

エラーがないことや（上記[warn]は転送先サーバーのが存在しないためOK。デフォルト設定のfluent.conf使用のため出力されている）
fluentdプログラムが落ちてしまうこと（プログラムが実行中のままであること）

などがないことを確認しておきます。

fluentd出力の動作確認方法。ブラウザからURLアクセステスト

デフォルト設定のfluent.confにある以下の記述の動作確認をしてみます

サンプルにあるように「http://localhost:8888/<tag>?json=<json>」をブラウザから実行してみます。
例えば、以下です

http://localhost:8888/debug.test?json={"test1":"test2"}

すると、以下のようにログが出力出来ることを確認できます。

コマンドfluentdの停止方法

コマンドfluentdを停止するには「Ctrl+c」で停止してください。

長くなってしまったので「fluentdをWindowsサービス登録します」はまた別記事で紹介します。

モバイルバージョンを終了