Treasure Agent(td-agent)は、Treasure DataとCloud Native Computing Foundationによって保守されている、Fluentdの安定版ディストリビューションパッケージです。
インストールの準備方法については、Fluentdインストールガイドで詳しく説明されています。
以下の方法を使用して、新規インストールまたは以前のバージョンからアップグレードできます。www.fluentd.orgウェブサイトからダウンロードできる最新バージョンのtd-agentをお勧めします。
このバージョンと以前のバージョンとの比較について詳しく学んでください。
| Platform | Platform Version | Package or Installer |
|---|---|---|
| Ubuntu/Debian | 2.6+ Linux kernel (64-bit) | td-agent v4 |
現在、Ubuntu Focal、Bionic、Xenial、およびDebian Buster向けのtd-agent4.xパッケージを提供しています。
各バージョンのインストールプロセスを自動化するシェルスクリプトが提供されています。このシェルスクリプトは、/etc/apt/sources.list.d/treasure-data.listに新しいaptリポジトリを登録し、td-agent debパッケージをインストールします。
Ubuntu Focalの場合、
# Ubuntu 20.04 Focal -- td-agent 4
curl -L https://toolbelt.treasuredata.com/sh/install-ubuntu-focal-td-agent4.sh | shUbuntu Bionicの場合、
# Ubuntu 18.04 Bionic -- td-agent 4
curl -L https://toolbelt.treasuredata.com/sh/install-ubuntu-bionic-td-agent4.sh | shUbuntu Xenialの場合、
# Ubuntu 16.04 Xenial -- td-agent 4
curl -L https://toolbelt.treasuredata.com/sh/install-ubuntu-xenial-td-agent4.sh | shDebian Busterの場合、
# Debian Buster -- td-agent 4
curl -L https://toolbelt.treasuredata.com/sh/install-debian-buster-td-agent4.sh | shレガシーのtd-agent3.xは、EOLバージョンのUbuntu Trusty、Debian Stretch、Debian Jessieで利用可能です。
各バージョンのインストールプロセスを自動化するシェルスクリプトが提供されています。このシェルスクリプトは、/etc/apt/sources.list.d/treasure-data.listに新しいaptリポジトリを登録し、td-agent debパッケージをインストールします。
これらのコマンドは、td-agentパッケージをセットアップします:
Ubuntu Trustyの場合、
curl -L https://toolbelt.treasuredata.com/sh/install-ubuntu-trusty-td-agent3.sh | shDebian Stretchの場合、
curl -L https://toolbelt.treasuredata.com/sh/install-debian-stretch-td-agent3.sh | shDebian Jessieの場合、
curl -L https://toolbelt.treasuredata.com/sh/install-debian-jessie-td-agent3.sh | sh/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; disabled; vendor preset: enabled)
Active: active (running) since Thu 2017-12-07 15:12:27 PST; 6min ago
Docs: https://docs.treasuredata.com/articles/td-agent
Process: 53192 ExecStart=/opt/td-agent/embedded/bin/fluentd --log /var/log/td-agent/td-agent.log --daemon /var/run/td-agent/td-agent.pid (code=exited, status=0/SUCCESS)
Main PID: 53198 (fluentd)
Tasks: 2 (limit: 4915)
Memory: 19.9M
CPU: 1.251s
CGroup: /system.slice/td-agent.service
├─53198 /opt/td-agent/embedded/bin/ruby /opt/td-agent/embedded/bin/fluentd --log /var/log/td-agent/td-agent.log --daemon /var/run/td-agent/td-agent.pid
└─53203 /opt/td-agent/embedded/bin/ruby -Eascii-8bit:ascii-8bit /opt/td-agent/embedded/bin/fluentd --log /var/log/td-agent/td-agent.log --daemon /var/run/td-agent/td-agent.pidsystemdの動作をカスタマイズしたい場合は、td-agent.serviceファイルを/etc/systemd/systemに配置してください。
/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にあることを確認してください。
ログは/var/log/td-agent配下にあります。デーモンはtd-agentユーザーおよびtd-agentグループとして実行されます。設定ファイルを変更した後は、エージェントを再起動してください。
このプロセスを自動化するには、Chef cookbookを参照してください。