# Rails Appsインポートインテグレーション

Treasure Dataは、サーバーサイドのログやイベントを収集し、Ruby on Railsアプリケーションからデータをシームレスにインポートするために[td-agent](https://docs.treasuredata.com/smart/project-product-documentation/about-treasure-data-s-server-side-agent)を提供しています。

## 前提条件

- Ruby、Rails、Gems、Bundlerの基本知識
- Treasure Dataの基本知識
- Ruby 2.0以上(ローカルテスト用)


## td-agentのインストール

アプリケーションサーバーに`td-agent`をインストールします。td-agentはアプリケーションサーバー内に配置され、アプリケーションログのクラウドへのアップロードに重点を置いています。

![](/assets/image-20191007-035026.6a881b783b2ff61b88f50c884f82ed90da06d32bddf4462fec948d0e7710f572.dffa02f7.png)

[td-logger-ruby](http://github.com/treasure-data/td-logger-ruby)ライブラリにより、Ruby on Railsアプリケーションはローカルのtd-agentにレコードを送信できるようになります。td-agentは、レコードを受信し、バッファリングして、5分ごとにデータをクラウドにアップロードします。デーモンはローカルノードで実行されるため、ログの遅延は無視できるほど小さくなります。

## td-agentのインストールオプション

`td-agent`をインストールするには、環境に基づいて以下のいずれかのコマンドを実行します。エージェントプログラムは、各プラットフォームのパッケージ管理ソフトウェア(rpm/deb/dmgなど)を使用して自動的にインストールされます。

### RHEL/CentOS 5,6,7


```
$ curl -L https://toolbelt.treasuredata.com/sh/install-redhat-td-agent3.sh | sh
```

### UbuntuとDebian


```
# 16.04 Xenial (64bit only)
$ curl -L https://toolbelt.treasuredata.com/sh/install-ubuntu-xenial-td-agent3.sh | sh
# 14.04 Trusty
$ curl -L https://toolbelt.treasuredata.com/sh/install-ubuntu-trusty-td-agent3.sh | sh
# 12.04 Precise
$ curl -L https://toolbelt.treasuredata.com/sh/install-ubuntu-precise-td-agent3.sh | sh
# Debian Stretch (64-bit only) $ curl -L https://toolbelt.treasuredata.com/sh/install-debian-stretch-td-agent3.sh | sh
# Debian Jessie (64-bit only)
$ curl -L https://toolbelt.treasuredata.com/sh/install-debian-jessie-td-agent3.sh | sh
# Debian Squeeze (64-bit only)
$ curl -L https://toolbelt.treasuredata.com/sh/install-debian-squeeze-td-agent2.sh | sh
```

### Amazon Linux

Amazon Linux 1またはAmazon Linux 2を選択できます。[Installing td-agent on Amazon Linux](https://docs.treasuredata.com/smart/project-product-documentation/installing-td-agent-on-aws-linux)を参照してください。

### MacOS X 10.11+


```
$ open 'https://td-agent-package-browser.herokuapp.com/3/macosx/td-agent-3.1.1-0.dmg'
```

MacOS X 10.11.1 (El Capitan)では、いくつかのセキュリティ変更が導入されています。td-agentのインストール後、**/Library/LaunchDaemons/td-agent.plist**ファイルを編集して、**/usr/sbin/td-agent**を**/opt/td-agent/usr/sbin/td-agent**に変更してください。

### Windows Server 2012+

Windowsのインストールには、以下に詳述されている手順が必要です:

- [Installing Treasure Agent using .msi Installer (Windows)](https://docs.fluentd.org/installation/install-by-msi)


### Opscode Chefリポジトリ

[リポジトリについての詳細](https://github.com/treasure-data/chef-td-agent?tab=readme-ov-file#description)を参照できます。


```
$ echo 'cookbook "td-agent"' >> Berksfile
$ berks install
```

[AWS Elastic Beanstalk](https://github.com/treasure-data/elastic-beanstalk-td-agent)もサポートされています。Windowsはサポートされていません。

## /etc/td-agent/td-agent.confの修正

`/etc/td-agent/td-agent.conf`ファイルで`apikey`オプションを設定して、APIキーを指定します。


```conf
# Input from Logging Libraries
<source>
  type forward
  port 24224
</source>

# Treasure Data Output
<match td.*.*>
  type tdlog
  endpoint api.treasuredata.com
  apikey YOUR_API_KEY
  auto_create_table
  buffer_type file
  buffer_path /var/log/td-agent/buffer/td
  use_ssl true
</match>
```

`YOUR_API_KEY` should be your actual apikey string. You can retrieve your API key from your profiles in TD Console. Using a [write-only API key](/products/my-settings/getting-your-api-keys) is recommended.

以下の行を追加した後、エージェントを再起動してください:


```
# Linux
$ sudo /etc/init.d/td-agent restart

# MacOS X
$ sudo launchctl unload /Library/LaunchDaemons/td-agent.plist
$ sudo launchctl load /Library/LaunchDaemons/td-agent.plist
```

td-agentは、ポート24224経由でデータを受け入れ、データをバッファリングし(*var/log/td-agent/buffer/td*)、自動的にデータをクラウドにアップロードします。

## td-logger-rubyの使用

Gemfileに'td' gemを追加します。


```
gem 'td', "~> 0.10.6"
```

*config/treasure_data.yml*ファイルを次のように変更します:


```
production:
  agent: "localhost:24224"
  tag: td.production_database_name
  debug_mode: false

development:
  agent: "localhost:24224"
  tag: td.development_database_name
  debug_mode: false

test:
```

アプリケーションに適切なログコードを挿入します。


```
# Example1: login event
TD.event.post('login', {:uid=>123})

# Example2: follow event
TD.event.post('follow', {:uid=>123, :from=>'TD', :to=>'Heroku'})

# Example3: pay event
TD.event.post('pay',
              {:uid=>123, :item_name=>'Stone of Jordan',
               :category=>'ring', :price=>100, :count=>1})
```

## データインポートの確認

プログラムを実行します。


```
$ ruby test.rb
```

SIGUSR1シグナルを送信すると、td-agentのバッファがフラッシュされます。アップロードは即座に開始されます。


```
# Linux
$ kill -USR1 `cat /var/run/td-agent/td-agent.pid`

# MacOS X
$ sudo kill -USR1 `sudo launchctl list | grep td-agent | cut -f 1`
```

### TD Consoleから

データが正常にアップロードされたことを確認するには、データセットを確認してください。

### CLIから

または、CLIがある場合は*td tables*コマンドを使用します。


```
$ td tables
+------------+------------+------+-----------+
| Database   | Table      | Type | Count     |
+------------+------------+------+-----------+
| test_db    | login      | log  | 1         |
| test_db    | follow     | log  | 1         |
| test_db    | pay        | log  | 1         |
+------------+------------+------+-----------+
```

# 本番環境へのデプロイ

## Rackベースのサーバーデプロイメントを使用する

*unicorn*、*thin*、*mongrel*などの使用を推奨します。他のセットアップは完全には検証されていません。

## td-agentの高可用性構成

高トラフィックのWebサイト(5つ以上のアプリケーションノード)では、データ転送の信頼性とクエリパフォーマンスを向上させるために、td-agentの高可用性構成を使用してください。

- [td-agentの高可用性構成](https://docs.treasuredata.com/smart/project-product-documentation/configuring-td-agent-for-high-availability)


## td-agentの監視

td-agent自体の監視も重要です。td-agentの一般的な監視方法については、[td-agentの監視](https://docs.treasuredata.com/smart/project-product-documentation/monitoring-td-agent)を参照してください。

td-agentは、[Fluentdプロジェクト](http://fluentd.org/)の下で完全にオープンソース化されています。