{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-@l10n/ja/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Rails Appsインポートインテグレーション","description":"Ruby on Rails向けTreasure AIインポート方法を解説。td-agentのインストール手順と、サーバーサイドログやイベントデータのクラウドへのシームレスな収集方法を説明します。","siteUrl":"https://docs.treasure.ai","image":"/assets/treasure-ai-social-preview.e6fefb35676f6da91c2d1bc783bd39e618e7af2b1ad3aa52a96ae69d72e700fe.b1bff462.png","lang":"en-US","jsonLd":{"@context":"https://schema.org","@graph":[{"@type":"Organization","@id":"https://www.treasure.ai/","name":"Treasure AI","url":"https://www.treasure.ai/","logo":"https://www.treasure.ai/hubfs/assets/images/logos/primary-logo.svg"},{"@type":"WebSite","@id":"https://docs.treasure.ai/#website","name":"Treasure AI Documentation","url":"https://docs.treasure.ai/","inLanguage":["en","ja"],"publisher":{"@id":"https://www.treasure.ai/"}}]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"rails-appsインポートインテグレーション","__idx":0},"children":["Rails Appsインポートインテグレーション"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Treasure Dataは、サーバーサイドのログやイベントを収集し、Ruby on Railsアプリケーションからデータをシームレスにインポートするために",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://docs.treasuredata.com/smart/project-product-documentation/about-treasure-data-s-server-side-agent"},"children":["td-agent"]},"を提供しています。"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"前提条件","__idx":1},"children":["前提条件"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Ruby、Rails、Gems、Bundlerの基本知識"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Treasure Dataの基本知識"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Ruby 2.0以上(ローカルテスト用)"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"td-agentのインストール","__idx":2},"children":["td-agentのインストール"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["アプリケーションサーバーに",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["td-agent"]},"をインストールします。td-agentはアプリケーションサーバー内に配置され、アプリケーションログのクラウドへのアップロードに重点を置いています。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/image-20191007-035026.6a881b783b2ff61b88f50c884f82ed90da06d32bddf4462fec948d0e7710f572.dffa02f7.png","alt":""},"children":[]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"http://github.com/treasure-data/td-logger-ruby"},"children":["td-logger-ruby"]},"ライブラリにより、Ruby on Railsアプリケーションはローカルのtd-agentにレコードを送信できるようになります。td-agentは、レコードを受信し、バッファリングして、5分ごとにデータをクラウドにアップロードします。デーモンはローカルノードで実行されるため、ログの遅延は無視できるほど小さくなります。"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"td-agentのインストールオプション","__idx":3},"children":["td-agentのインストールオプション"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["td-agent"]},"をインストールするには、環境に基づいて以下のいずれかのコマンドを実行します。エージェントプログラムは、各プラットフォームのパッケージ管理ソフトウェア(rpm/deb/dmgなど)を使用して自動的にインストールされます。"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"rhelcentos-567","__idx":4},"children":["RHEL/CentOS 5,6,7"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"$ curl -L https://toolbelt.treasuredata.com/sh/install-redhat-td-agent3.sh | sh\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"ubuntuとdebian","__idx":5},"children":["UbuntuとDebian"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"# 16.04 Xenial (64bit only)\n$ curl -L https://toolbelt.treasuredata.com/sh/install-ubuntu-xenial-td-agent3.sh | sh\n# 14.04 Trusty\n$ curl -L https://toolbelt.treasuredata.com/sh/install-ubuntu-trusty-td-agent3.sh | sh\n# 12.04 Precise\n$ curl -L https://toolbelt.treasuredata.com/sh/install-ubuntu-precise-td-agent3.sh | sh\n# Debian Stretch (64-bit only) $ curl -L https://toolbelt.treasuredata.com/sh/install-debian-stretch-td-agent3.sh | sh\n# Debian Jessie (64-bit only)\n$ curl -L https://toolbelt.treasuredata.com/sh/install-debian-jessie-td-agent3.sh | sh\n# Debian Squeeze (64-bit only)\n$ curl -L https://toolbelt.treasuredata.com/sh/install-debian-squeeze-td-agent2.sh | sh\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"amazon-linux","__idx":6},"children":["Amazon Linux"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Amazon Linux 1またはAmazon Linux 2を選択できます。",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://docs.treasuredata.com/smart/project-product-documentation/installing-td-agent-on-aws-linux"},"children":["Installing td-agent on Amazon Linux"]},"を参照してください。"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"macos-x-1011","__idx":7},"children":["MacOS X 10.11+"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"$ open 'https://td-agent-package-browser.herokuapp.com/3/macosx/td-agent-3.1.1-0.dmg'\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["MacOS X 10.11.1 (El Capitan)では、いくつかのセキュリティ変更が導入されています。td-agentのインストール後、",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["/Library/LaunchDaemons/td-agent.plist"]},"ファイルを編集して、",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["/usr/sbin/td-agent"]},"を**/opt/td-agent/usr/sbin/td-agent**に変更してください。"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"windows-server-2012","__idx":8},"children":["Windows Server 2012+"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Windowsのインストールには、以下に詳述されている手順が必要です:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://docs.fluentd.org/installation/install-by-msi"},"children":["Installing Treasure Agent using .msi Installer (Windows)"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"opscode-chefリポジトリ","__idx":9},"children":["Opscode Chefリポジトリ"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://github.com/treasure-data/chef-td-agent?tab=readme-ov-file#description"},"children":["リポジトリについての詳細"]},"を参照できます。"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"$ echo 'cookbook \"td-agent\"' >> Berksfile\n$ berks install\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://github.com/treasure-data/elastic-beanstalk-td-agent"},"children":["AWS Elastic Beanstalk"]},"もサポートされています。Windowsはサポートされていません。"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"etctd-agenttd-agentconfの修正","__idx":10},"children":["/etc/td-agent/td-agent.confの修正"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/etc/td-agent/td-agent.conf"]},"ファイルで",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["apikey"]},"オプションを設定して、APIキーを指定します。"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"conf","header":{"controls":{"copy":{}}},"source":"# Input from Logging Libraries\n<source>\n  type forward\n  port 24224\n</source>\n\n# Treasure Data Output\n<match td.*.*>\n  type tdlog\n  endpoint api.treasuredata.com\n  apikey YOUR_API_KEY\n  auto_create_table\n  buffer_type file\n  buffer_path /var/log/td-agent/buffer/td\n  use_ssl true\n</match>\n","lang":"conf"},"children":[]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["YOUR_API_KEY"]}," should be your actual apikey string. You can retrieve your API key from your profiles in Treasure Console. Using a ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/my-settings/getting-your-api-keys"},"children":["write-only API key"]}," is recommended."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["以下の行を追加した後、エージェントを再起動してください:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"# Linux\n$ sudo /etc/init.d/td-agent restart\n\n# MacOS X\n$ sudo launchctl unload /Library/LaunchDaemons/td-agent.plist\n$ sudo launchctl load /Library/LaunchDaemons/td-agent.plist\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["td-agentは、ポート24224経由でデータを受け入れ、データをバッファリングし(",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["var/log/td-agent/buffer/td"]},")、自動的にデータをクラウドにアップロードします。"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"td-logger-rubyの使用","__idx":11},"children":["td-logger-rubyの使用"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Gemfileに'td' gemを追加します。"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"gem 'td', \"~> 0.10.6\"\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["config/treasure_data.yml"]},"ファイルを次のように変更します:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"production:\n  agent: \"localhost:24224\"\n  tag: td.production_database_name\n  debug_mode: false\n\ndevelopment:\n  agent: \"localhost:24224\"\n  tag: td.development_database_name\n  debug_mode: false\n\ntest:\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["アプリケーションに適切なログコードを挿入します。"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"# Example1: login event\nTD.event.post('login', {:uid=>123})\n\n# Example2: follow event\nTD.event.post('follow', {:uid=>123, :from=>'TD', :to=>'Heroku'})\n\n# Example3: pay event\nTD.event.post('pay',\n              {:uid=>123, :item_name=>'Stone of Jordan',\n               :category=>'ring', :price=>100, :count=>1})\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"データインポートの確認","__idx":12},"children":["データインポートの確認"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["プログラムを実行します。"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"$ ruby test.rb\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["SIGUSR1シグナルを送信すると、td-agentのバッファがフラッシュされます。アップロードは即座に開始されます。"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"# Linux\n$ kill -USR1 `cat /var/run/td-agent/td-agent.pid`\n\n# MacOS X\n$ sudo kill -USR1 `sudo launchctl list | grep td-agent | cut -f 1`\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"treasure-コンソールから","__idx":13},"children":["Treasure コンソールから"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["データが正常にアップロードされたことを確認するには、データセットを確認してください。"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"cliから","__idx":14},"children":["CLIから"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["または、CLIがある場合は",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["td tables"]},"コマンドを使用します。"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"$ td tables\n+------------+------------+------+-----------+\n| Database   | Table      | Type | Count     |\n+------------+------------+------+-----------+\n| test_db    | login      | log  | 1         |\n| test_db    | follow     | log  | 1         |\n| test_db    | pay        | log  | 1         |\n+------------+------------+------+-----------+\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"本番環境へのデプロイ","__idx":15},"children":["本番環境へのデプロイ"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"rackベースのサーバーデプロイメントを使用する","__idx":16},"children":["Rackベースのサーバーデプロイメントを使用する"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["unicorn"]},"、",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["thin"]},"、",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["mongrel"]},"などの使用を推奨します。他のセットアップは完全には検証されていません。"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"td-agentの高可用性構成","__idx":17},"children":["td-agentの高可用性構成"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["高トラフィックのWebサイト(5つ以上のアプリケーションノード)では、データ転送の信頼性とクエリパフォーマンスを向上させるために、td-agentの高可用性構成を使用してください。"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://docs.treasuredata.com/smart/project-product-documentation/configuring-td-agent-for-high-availability"},"children":["td-agentの高可用性構成"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"td-agentの監視","__idx":18},"children":["td-agentの監視"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["td-agent自体の監視も重要です。td-agentの一般的な監視方法については、",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://docs.treasuredata.com/smart/project-product-documentation/monitoring-td-agent"},"children":["td-agentの監視"]},"を参照してください。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["td-agentは、",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"http://fluentd.org/"},"children":["Fluentdプロジェクト"]},"の下で完全にオープンソース化されています。"]}]},"headings":[{"value":"Rails Appsインポートインテグレーション","id":"rails-appsインポートインテグレーション","depth":1},{"value":"前提条件","id":"前提条件","depth":2},{"value":"td-agentのインストール","id":"td-agentのインストール","depth":2},{"value":"td-agentのインストールオプション","id":"td-agentのインストールオプション","depth":2},{"value":"RHEL/CentOS 5,6,7","id":"rhelcentos-567","depth":3},{"value":"UbuntuとDebian","id":"ubuntuとdebian","depth":3},{"value":"Amazon Linux","id":"amazon-linux","depth":3},{"value":"MacOS X 10.11+","id":"macos-x-1011","depth":3},{"value":"Windows Server 2012+","id":"windows-server-2012","depth":3},{"value":"Opscode Chefリポジトリ","id":"opscode-chefリポジトリ","depth":3},{"value":"/etc/td-agent/td-agent.confの修正","id":"etctd-agenttd-agentconfの修正","depth":2},{"value":"td-logger-rubyの使用","id":"td-logger-rubyの使用","depth":2},{"value":"データインポートの確認","id":"データインポートの確認","depth":2},{"value":"Treasure コンソールから","id":"treasure-コンソールから","depth":3},{"value":"CLIから","id":"cliから","depth":3},{"value":"本番環境へのデプロイ","id":"本番環境へのデプロイ","depth":1},{"value":"Rackベースのサーバーデプロイメントを使用する","id":"rackベースのサーバーデプロイメントを使用する","depth":2},{"value":"td-agentの高可用性構成","id":"td-agentの高可用性構成","depth":2},{"value":"td-agentの監視","id":"td-agentの監視","depth":2}],"frontmatter":{"seo":{"title":"Rails Appsインポートインテグレーション","description":"Ruby on Rails向けTreasure AIインポート方法を解説。td-agentのインストール手順と、サーバーサイドログやイベントデータのクラウドへのシームレスな収集方法を説明します。"}},"lastModified":"2026-10-21T04:51:54.752Z","pagePropGetterError":{"message":"","name":""}},"slug":"/ja/int/rails-apps-import-integration","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}