{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-@l10n/ja/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Perl Apps Import Integration","description":"Perlアプリケーションからのログとイベントデータを、td-agentを使用してTreasure AIにシームレスにインポートする方法を解説します。インストール手順と設定方法を詳しく説明します。","siteUrl":"https://docs.treasure.ai","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":"perl-apps-import-integration","__idx":0},"children":["Perl Apps Import Integration"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Treasure Dataは、サーバーサイドのログとイベントを収集し、Perlアプリケーションからシームレスにデータをインポートするために",{"$$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":["PerlとCPANの基本知識"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["最新バージョンの",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://toolbelt.treasuredata.com/"},"children":["TD Toolbelt"]},"がインストールされているTreasure Dataの基本知識"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Perl 5.10以上（ローカルテスト用）"]}]},{"$$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/image2020-12-2_14-12-51.1754f4e3154420d54cc976b16d454ef773c83ad5fc4b8580d99a87302c614932.23757061.png","alt":""},"children":[]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"http://github.com/fluent/fluent-logger-perl"},"children":["fluent-logger-perl"]},"ライブラリにより、Perlアプリケーションはローカルの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":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"$ curl -L https://toolbelt.treasuredata.com/sh/install-redhat-td-agent3.sh | sh\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"ubuntu-and-debian","__idx":5},"children":["Ubuntu and Debian"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"# 18.04 Bionic\n$ curl -L https://toolbelt.treasuredata.com/sh/install-ubuntu-bionic-td-agent3.sh | sh\n# 16.04 Xenial (64bit only)\n$ curl -L https://toolbelt.treasuredata.com/sh/install-ubuntu-xenial-td-agent3.sh | sh\n","lang":"bash"},"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-repository","__idx":9},"children":["Opscode Chef Repository"]},{"$$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":["apikey"]},"オプションを設定して、APIキーを指定します。APIキーは、Treasure コンソールのプロファイルから確認できます。td-agent.confファイルに",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["apikey"]},"オプションを設定します。"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"# Treasure Data Input and Output\nsource\n  type forward\n  port 24224\n</source>\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"},"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":"fluent-logger-perlの使用","__idx":11},"children":["fluent-logger-perlの使用"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["まず、CPAN経由で",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Fluent::Logger"]},"ライブラリをインストールします。"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"$ cpan\ncpan[1]> install Fluent::Logger\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["次に、次のように初期化してレコードを投稿します。"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"testpl","__idx":12},"children":["test.pl"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"perl","header":{"controls":{"copy":{}}},"source":"use Fluent::Logger;\nmy $logger = Fluent::Logger->new(\n    host => '127.0.0.1',\n    port => 24224,\n    tag_prefix => 'td.test_db',\n);\n$logger->post(\"test_table\", { \"entry1\" => \"value1\", \"entry2\" => 2 });\n","lang":"perl"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"データインポートの確認","__idx":13},"children":["データインポートの確認"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["まず、前述のプログラムを実行します。"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"$ perl test.pl\n","lang":"bash"},"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":"p","attributes":{},"children":["データが正常にアップロードされたことを確認するには、次のように",{"$$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    | test_table | log  | 1         |\n+------------+------------+------+-----------+\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["post()の最初の引数は、データベース名とテーブル名を決定します。",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["td.test\\_db.test\\_table"]},"を指定すると、データはデータベース*test_db*内のテーブル*test_table*にインポートされます。これらはアップロード時に自動的に作成されます。"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"本番デプロイ","__idx":14},"children":["本番デプロイ"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"td-agentの高可用性構成","__idx":15},"children":["td-agentの高可用性構成"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["高トラフィックのウェブサイト（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":["High-Availability Configurations of td-agent"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"td-agentの監視","__idx":16},"children":["td-agentの監視"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["td-agent自体の監視も重要です。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/monitoring-td-agent"},"children":["Monitoring td-agent"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["td-agentは、",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"http://fluentd.org/"},"children":["Fluentdプロジェクト"]},"の下で完全にオープンソース化されています。"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"次のステップ","__idx":17},"children":["次のステップ"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["従来のRDBMSよりも柔軟なスキーマメカニズムを提供しています。クエリには、HiveおよびPresto Query Languageを活用しています。"]},{"$$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/schema-management"},"children":["Schema Management"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/customer-data-platform/data-workbench/queries/trino/quickstart"},"children":["Presto Query Language"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/customer-data-platform/data-workbench/queries/hive/quickstart"},"children":["Hive Query Language"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/apis/td-api"},"children":["Programmatic Access with REST API and its Bindings"]}]}]}]},"headings":[{"value":"Perl Apps Import Integration","id":"perl-apps-import-integration","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 and Debian","id":"ubuntu-and-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 Repository","id":"opscode-chef-repository","depth":3},{"value":"/etc/td-agent/td-agent.confの変更","id":"etctd-agenttd-agentconfの変更","depth":2},{"value":"fluent-logger-perlの使用","id":"fluent-logger-perlの使用","depth":2},{"value":"test.pl","id":"testpl","depth":3},{"value":"データインポートの確認","id":"データインポートの確認","depth":2},{"value":"本番デプロイ","id":"本番デプロイ","depth":1},{"value":"td-agentの高可用性構成","id":"td-agentの高可用性構成","depth":2},{"value":"td-agentの監視","id":"td-agentの監視","depth":2},{"value":"次のステップ","id":"次のステップ","depth":1}],"frontmatter":{"seo":{"title":"Perl Apps Import Integration","description":"Perlアプリケーションからのログとイベントデータを、td-agentを使用してTreasure AIにシームレスにインポートする方法を解説します。インストール手順と設定方法を詳しく説明します。"}},"lastModified":"2026-06-17T07:22:53.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/ja/int/perl-apps-import-integration","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}