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

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

- [インストール前の準備](#before-installation)
- [td-agentのインストールまたはアップグレード](#install-or-upgrade-td-agent)
- [td-agent 4](#td-agent-4)
- [td-agent 3](#td-agent-3)
- [Cookbook](#cookbook)
- [その他のリソース](#other-resources)


## インストール前の準備

インストールの準備方法については、[Fluentdインストールガイド](https://docs.fluentd.org/installation/before-install)で詳しく説明されています。

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

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

このバージョンと[以前のバージョンとの比較](https://docs.fluentd.org/quickstart/fluent-package-v5-vs-td-agent)について詳しく学んでください。

| Platform | Platform Version | Package or Installer |
|  --- | --- | --- |
| Ubuntu/Debian | 2.6+ Linux kernel (64-bit) | td-agent v4 |


- [インストールガイド](https://docs.fluentd.org/v1.0/articles/install-by-deb)
- 64-bit/amd64パッケージは、[Focal](https://td-agent-package-browser.herokuapp.com/4/ubuntu/focal/pool/contrib/t/td-agent)、[Bionic](https://td-agent-package-browser.herokuapp.com/4/ubuntu/bionic/pool/contrib/t/td-agent)、[Xenial](https://td-agent-package-browser.herokuapp.com/4/ubuntu/xenial/pool/contrib/t/td-agent)、およびDebian [Buster](https://td-agent-package-browser.herokuapp.com/4/debian/buster/pool/contrib/t/td-agent)で利用可能です。


### 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の場合、


```bash
# Ubuntu 20.04 Focal -- td-agent 4
curl -L https://toolbelt.treasuredata.com/sh/install-ubuntu-focal-td-agent4.sh | sh
```

Ubuntu Bionicの場合、


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

Ubuntu Xenialの場合、


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

Debian Busterの場合、


```bash
# 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の場合、


```bash
curl -L https://toolbelt.treasuredata.com/sh/install-ubuntu-trusty-td-agent3.sh | sh
```

Debian Stretchの場合、


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

Debian Jessieの場合、


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

#### systemdでのデーモンの起動

`/lib/systemd/system/td-agent`スクリプトは、エージェントの起動、停止、または再起動を行うために提供されています。


```bash
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: /products/customer-data-platform/integration-hub/streaming/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`スクリプトは、エージェントの起動、停止、または再起動を行うために提供されています。


```bash
sudo /etc/init.d/td-agent restart
sudo /etc/init.d/td-agent status
```

出力例:


```
td-agent (pid  21678) is running...
```

以下のコマンドがサポートされています:


```bash
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](https://github.com/treasure-data/chef-td-agent)を参照してください。

## その他のリソース

- [td-agent変更ログ](/ja/products/customer-data-platform/integration-hub/streaming/td-agent/td-agent-logs-sent-to-treasure-data)
- [td-agentを使用した継続的データインポート](https://docs.treasuredata.com/smart/project-integrations/fluentd-continuous-data-import-integration)