Skip to content
Last updated

UbuntuおよびDebianへのTD Agentのインストール

Treasure Agent(td-agent)は、Treasure DataとCloud Native Computing Foundationによって保守されている、Fluentdの安定版ディストリビューションパッケージです。

インストール前の準備

インストールの準備方法については、Fluentdインストールガイドで詳しく説明されています。

td-agentのインストールまたはアップグレード

以下の方法を使用して、新規インストールまたは以前のバージョンからアップグレードできます。www.fluentd.orgウェブサイトからダウンロードできる最新バージョンのtd-agentをお勧めします。

このバージョンと以前のバージョンとの比較について詳しく学んでください。

PlatformPlatform VersionPackage or Installer
Ubuntu/Debian2.6+ Linux kernel (64-bit)td-agent v4

td-agent 4

現在、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 | sh

Ubuntu Bionicの場合、

# Ubuntu 18.04 Bionic -- td-agent 4
curl -L https://toolbelt.treasuredata.com/sh/install-ubuntu-bionic-td-agent4.sh | sh

Ubuntu Xenialの場合、

# Ubuntu 16.04 Xenial -- td-agent 4
curl -L https://toolbelt.treasuredata.com/sh/install-ubuntu-xenial-td-agent4.sh | sh

Debian Busterの場合、

# Debian Buster -- td-agent 4
curl -L https://toolbelt.treasuredata.com/sh/install-debian-buster-td-agent4.sh | sh

td-agent 3

レガシーの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 | sh

Debian Stretchの場合、

curl -L https://toolbelt.treasuredata.com/sh/install-debian-stretch-td-agent3.sh | sh

Debian Jessieの場合、

curl -L https://toolbelt.treasuredata.com/sh/install-debian-jessie-td-agent3.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; 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.pid

systemdの動作をカスタマイズしたい場合は、td-agent.serviceファイルを/etc/systemd/systemに配置してください。

init.dでのデーモンの起動

/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グループとして実行されます。設定ファイルを変更した後は、エージェントを再起動してください。

Cookbook

このプロセスを自動化するには、Chef cookbookを参照してください。

その他のリソース