タイトル:RPM パッケージによるインストール (Red Hat Linux)

td-agent のインストール

  1. rpm リポジトリからインストール

    注意: OS が対応していない場合は、代わりに gem のインストールを検討してください。

Red Hat / CentOS

以下のインストールスクリプトをダウンロードの上、curl で実行します:

# td-agent 4
$ curl -L https://toolbelt.treasuredata.com/sh/install-redhat-td-agent4.sh | sh

このスクリプトを実行すると、ユーザーのマシンに td-agent が自動的にインストールされます。また、このシェルスクリプトにより、/etc/yum.repos.d/td.repo に新しい rpm リポジトリが登録され、td-agent がインストールされます。スクリプトのリポジトリパスには $releasever を使用し、$releasever には 「7 」というようなメジャーバージョンのみを指定します。もし使用環境で 「7.2 」というような他の形式を使用している場合は、メジャーバージョンに変更するか、手動で TD リポジトリを設定してください。

Amazon Linux

Amazon Linux 2 の場合:

# td-agent 4
$ curl -L https://toolbelt.treasuredata.com/sh/install-amazon2-td-agent4.sh | sh
  1. デーモンを起動します。

td-agent により2つのスクリプトが提供されます:

systemd

エージェントの起動、停止、再起動には /usr/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 (/usr/lib/systemd/system/td-agent.service; enabled; vendor preset: disabled)
Active: active (running) since Tue 2022-09-27 06:14:36 UTC; 1s ago
Docs: https://docs.treasuredata.com/display/public/PD/About+Treasure+Data%27s+Server-Side+Agent
Process: 33953 ExecStart=/opt/td-agent/bin/fluentd --log $TD_AGENT_LOG_FILE --daemon /var/run/td-agent/td-agent.pid $TD_AGENT_OPTIONS (code=exited, status=0>
Main PID: 33959 (fluentd)
Tasks: 10 (limit: 4958)
Memory: 78.1M
CGroup: /system.slice/td-agent.service
├─33959 /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
└─33962 /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/td>

systemd の動作をカスタマイズするには、td-agent.service を /etc/systemd/system に置きます。

注意: td-agent 4 ではパスが異なり、/opt/td-agent/embedded/bin ではなく、/opt/td-agent/bin となります。

init.d これは CentOS 6、非 systemd ベースのシステム用です。エージェントの起動、停止、再起動には、/etc/init.d/td-agent スクリプトを使用します:

$ sudo /etc/init.d/td-agent start
Starting td-agent: [ OK ]
$ 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
  1. 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 のインストール

  1. ログに無効なタイムスタンプが含まれるのを防止するため、ノードで ntpd をセットアップすることを強く推奨します。
    注記: OSがサポートされていない場合は、代わりに gem のインストールを検討してください。

Red Hat / CentOS

インストールスクリプトをダウンロードし、curl で実行します:

# calyptia-fluentd 1
$ curl -L https://calyptia-fluentd.s3.us-east-2.amazonaws.com/calyptia-fluentd-1-redhat.sh | sh

このスクリプトを実行すると、ユーザーのマシンに calyptia-fluentd が自動的にインストールされます。また、このシェルスクリプトにより、/etc/yum.repos.d/Calyptia-Fluentd.repo に新しい rpm リポジトリが登録され、calyptia-fluentd がインストールされます。

スクリプトのリポジトリパスには $releasever を使用し、$releasever には「7」といったメジャーバージョンのみを指定します。もし「7.2」のような他の形式を使用している場合は、メジャーバージョンに変更するか、手動で TD リポジトリを設定してください。

CentOS Stream

CentOS Stream 8 の場合:

# calyptia-fluentd 1
$ curl -L https://calyptia-fluentd.s3.us-east-2.amazonaws.com/calyptia-fluentd-1-centos-stream.sh

Amazon Linux

Amazon Linux 2 の場合:

# calyptia-fluentd 1
$ curl -L https://calyptia-fluentd.s3.us-east-2.amazonaws.com/calyptia-fluentd-1-amazon-2.sh | sh
  1. デーモンを起動する。

Calyptia-fluentd は systemd のユニットファイルのみを提供します:

systemd

usr/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 (/usr/lib/systemd/system/calyptia-fluentd.service; enabled; vendor preset: disabled)
Active: active (running) since Mon 2021-05-31 01:37:47 UTC; 4h 38min ago
Docs: https://docs.fluentd.org/
Process: 694 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: 1365 (fluentd)
CGroup: /system.slice/calyptia-fluentd.service
├─1365 /opt/calyptia-fluentd/bin/ruby /opt/calyptia-fluentd/bin/fluentd --log /var/log/calyptia-fluentd/calyptia-fluentd.log --daem...
└─1368 /opt/calyptia-fluentd/bin/ruby -Eascii-8bit:ascii-8bit /opt/calyptia-fluentd/bin/fluentd --log /var/log/calyptia-fluentd/cal...

Systemd の動作をカスタマイズするには、/etc/systemd/system に calyptia-fluentd.service を設定します。

設定ファイルのパスが以下の通りであることを確認します:

/etc/calyptia-fluentd/calyptia-fluentd.confです。

  1. HTTP 経由でサンプルログを投稿します。

デフォルトの設定(/etc/calyptia-fluentd/calyptia-faluentd.conf)は、HTTPエンドポイントでログを受け取り、標準出力にルーティングします。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-31 06:19:04.415878392 +0000 debug.test: {"json":"message"}

SixthSense ログ監視エージェントをインストールします。詳細は ログ監視エージェントのインストール を参照ください。