#td-agent のインストール
- Apt リポジトリからインストールします。
- 使用のOSがサポートされていない場合は、代わりにgem のインストールをご検討ください。
- Treasure Dataでは Debian パッケージの検証は行っておりません。Debian パッケージに問題がある場合は、fluent-package-builder リポジトリにパッチをお送りください。
各バージョンのインストールプロセスを自動化するためのシェルスクリプトが提供されています。このシェルスクリプトにより、/etc/apt/sources.list.d/treasure-data.list に新しい apt リポジトリが登録され、またtd-agent deb パッケージがインストールされます。
Ubuntu Jammy の場合：
# td-agent 4 (experimental)
curl -fsSL https://toolbelt.treasuredata.com/sh/install-ubuntu-jammy-td-agent4.sh | sh
Ubuntu Focal の場合：
# td-agent 4
curl -fsSL https://toolbelt.treasuredata.com/sh/install-ubuntu-focal-td-agent4.sh | sh
Ubuntu Bionic の場合：
# td-agent 4
curl -fsSL https://toolbelt.treasuredata.com/sh/install-ubuntu-bionic-td-agent4.sh | sh
Ubuntu Xenial の場合：
# td-agent 4
curl -fsSL https://toolbelt.treasuredata.com/sh/install-ubuntu-xenial-td-agent4.sh | sh
Debian Bullseye の場合：
# td-agent 4
curl -fsSL https://toolbelt.treasuredata.com/sh/install-debian-bullseye-td-agent4.sh | sh
Debian バスターの場合
# td-agent 4
curl -fsSL https://toolbelt.treasuredata.com/sh/install-debian-buster-td-agent4.sh | sh
- デーモンを起動する。
systemd
/lib/systemd/system/td-agent スクリプトを使用して、エージェントを起動、停止、再起動します：
$ sudo systemctl start td-agent.service
$ sudo systemctl status td-agent.service
● td-agent.service - td-agent: Fluentd based data collector for Treasure Data
Loaded: loaded (/lib/systemd/system/td-agent.service; enabled; vendor preset: enabled)
Active: active (running) since Tue 2022-09-20 05:28:25 JST; 1 week 0 days ago
Docs: https://docs.treasuredata.com/display/public/PD/About+Treasure+Data%27s+Server-Side+Agent
Main PID: 2417 (fluentd)
Tasks: 8 (limit: 38328)
Memory: 52.2M
CPU: 56.868s
CGroup: /system.slice/td-agent.service
├─2417 /opt/td-agent/bin/ruby /opt/td-agent/bin/fluentd --log /var/log/td-agent/td-agent.log --daemon /var/run/td-agent/td-agent.pid
└─2420 /opt/td-agent/bin/ruby -Eascii-8bit:ascii-8bit /opt/td-agent/bin/fluentd --log /var/log/td-agent/td-agent.log --daemon /var/run/td-agent/t>
Sept 9 20 05:28:24 Ryzen systemd[1]: Starting td-agent: Fluentd based data collector for Treasure Data...
Sept 9 20 05:28:25 Ryzen systemd[1]: Started td-agent: Fluentd based data collector for Treasure Data.
td-agent 4 ではパスが異なります。/opt/td-agent/embedded/bin の代わりに /opt/td-agent/bin を使用します。
init.d
Systemd ベースでないシステムでは、/etc/init.d/td-agent スクリプトを使用してエージェントを起動、停止、再起動します：
$ sudo /etc/init.d/td-agent restart
$ sudo /etc/init.d/td-agent status
td-agent (pid 21678) is running...
以下のコマンドがサポートされています：
$ sudo /etc/init.d/td-agent start
$ sudo /etc/init.d/td-agent stop
$ sudo /etc/init.d/td-agent restart
$ sudo /etc/init.d/td-agent status
設定ファイルのパスが以下の通りであることを確認してください。
/etc/td-agent/td-agent.conf
- HTTP経由でサンプルログを投稿する。
デフォルト（/etc/td-agent/td-agent.conf）では、HTTPエンドポイントでログを受信し、標準出力にルーティングするという設定になっています。td-agent のログについては /var/log/td-agent/td-agent.log を参照してください。
curl コマンドを使用してサンプルログレコードを投稿することが可能です：
$ curl -X POST -d 'json={"json":"message"}' http://localhost:8888/debug.test
$ tail -n 1 /var/log/td-agent/td-agent.log
2018-01-01 17:51:47 -0700 debug.test: {"json":"message"}
#calyptia-fluentd のインストール
- Apt リポジトリからインストールします。
使用のOSがサポートされていない場合は、代わりに gem のインストールを検討してください。
各バージョンのインストールプロセスを自動化するシェルスクリプトが提供されています。このシェルスクリプトにより、/etc/apt/sources.list.d/calyptia-fluentd.sources に新しい apt リポジトリが登録され、また calyptia-fluentd deb パッケージがインストールされます。
Ubuntu Focal の場合：
# calyptia-fluentd 1
# calyptia-fluentd 1
curl -fsSL https://calyptia-fluentd.s3.us-east-2.amazonaws.com/calyptia-fluentd-1-ubuntu-focal.sh | sh
Ubuntu Bionic の場合：
# calyptia-fluentd 1
curl -fsSL https://calyptia-fluentd.s3.us-east-2.amazonaws.com/calyptia-fluentd-1-ubuntu-bionic.sh | sh
Ubuntu Xenial の場合：
# calyptia-fluentd 1
# calyptia-fluentd 1
curl -fsSL https://calyptia-fluentd.s3.us-east-2.amazonaws.com/calyptia-fluentd-1-ubuntu-bionic.sh | sh
Debian Buster の場合：
# calyptia-fluentd 1
curl -fsSL https://calyptia-fluentd.s3.us-east-2.amazonaws.com/calyptia-fluentd-1-debian-buster.sh | sh
- デーモンを起動します。
systemd
エージェントの起動、停止、再起動には /lib/systemd/system/calyptia-fluentd スクリプトを使用します：
$ sudo systemctl start calyptia-fluentd.service
$ sudo systemctl status calyptia-fluentd.service
● calyptia-fluentd.service - calyptia-fluentd: Fluentd based data collector for Calyptia Services
Loaded: loaded (/lib/systemd/system/calyptia-fluentd.service; enabled; vendor preset: enabled)
Active: active (running) since Fri 2021-05-28 15:29:45 JST; 1s ago
Docs: https://docs.fluentd.org/
Process: 406739 ExecStart=/opt/calyptia-fluentd/bin/fluentd --log $CALYPTIA_FLUENTD_LOG_FILE --daemon /var/run/calyptia-fluentd/calyptia-fluentd.pid $CALYPTIA_FLUENTD_OPTIONS (code=exited, status=0/SUCCESS)
Main PID: 406762 (fluentd)
Tasks: 5 (limit: 4915)
CGroup: /system.slice/calyptia-fluentd.service
├─406762 /opt/calyptia-fluentd/bin/ruby /opt/calyptia-fluentd/bin/fluentd --log /var/log/calyptia-fluentd/calyptia-fluentd.log --daemon /var/run/calyptia-fluentd/calyptia-fluentd.pid
└─406835 /opt/calyptia-fluentd/bin/ruby -Eascii-8bit:ascii-8bit /opt/calyptia-fluentd/bin/fluentd --log /var/log/calyptia-fluentd/calyptia-fluentd.log --daemon /var/run/calyptia-fluentd/calyptia-fluentd.pid --under-supervisor
systemd の動作をカスタマイズするには、/lib/systemd/system に calyptia-fluentd.service を設置します。
設定ファイルのパスが以下の通りであることを確認してください：
/etc/calyptia-fluentd/calyptia-fluentd.conf
- HTTP 経由でサンプルログを投稿します。
デフォルト（/etc/calyptia-fluentd/calyptia-fluentd.conf）では、HTTP エンドポイントでログを受信し、stdout にルーティングするという設定になっています。calyptia-fluentd のログについては、/var/log/calyptia-fluentd/calyptia-fluentd.log を参照してください。
curl コマンドを使用してサンプルログレコードを投稿することが可能です：
$ curl -X POST -d 'json={"json":"message"}' http://localhost:8888/debug.test
$ sudo tail -n 1 /var/log/calyptia-fluentd/calyptia-fluentd.log
2021-05-28 15:45:17.998214460 +0900 debug.test: {"json":"message"}
この後 SixthSense ログ監視エージェントをインストールする必要があります。詳細は ログ監視エージェントのインストール を参照してください。