{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-@l10n/ja/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Python Apps Import Integration","description":"Treasure Data Product Documentation · Collect and Unify · Segment and Activate · Experiment and Analyze · Decisioning Automate with AI Scale and Trust.","siteUrl":"https://docs.treasuredata.com","lang":"en-US","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"python-apps-import-integration","__idx":0},"children":["Python Apps Import Integration"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Treasure Dataは、サーバーサイドのログとイベントを収集し、Pythonアプリケーションからシームレスにデータをインポートするために",{"$$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":["Pythonの基本知識"]},{"$$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":["Python 2.6以上（ローカルテスト用）"]}]},{"$$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_13-15-24.1754f4e3154420d54cc976b16d454ef773c83ad5fc4b8580d99a87302c614932.08c5a0cf.png","alt":""},"children":[]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"http://github.com/fluent/fluent-logger-python"},"children":["fluent-logger-python"]},"ライブラリにより、Pythonアプリケーションはローカルの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-and-debian","__idx":5},"children":["Ubuntu and Debian"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"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"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":5,"id":"eolバージョンのレガシーサポートはまだ利用可能です","__idx":6},"children":["EOLバージョンのレガシーサポートはまだ利用可能です"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"# 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":7},"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 AWS Linux"]},"を参照してください。"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"macos-x-1011","__idx":8},"children":["MacOS X 10.11+"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"$ open 'https://td-agent-package-browser.herokuapp.com/3/macosx'\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":9},"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":10},"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":11},"children":["/etc/td-agent/td-agent.confの変更"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["apikey"]},"オプションを設定して、APIキーを指定します。APIキーは、Treasure コンソールから確認できます。"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"conf","header":{"controls":{"copy":{}}},"source":"# Treasure Data Input and Output\n<source>\n  type forward\n  port 24224\n</source>\n\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</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":"fluent-logger-pythonの使用","__idx":12},"children":["fluent-logger-pythonの使用"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["pip経由でfluent-loggerライブラリをインストールします。"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"$ pip install fluent-logger\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["次のように初期化してレコードを投稿します。"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"# Initialize\nfrom fluent import sender\nfrom fluent import event\nsender.setup('td.test_db', host='localhost', port=24224)\nevent.Event('follow', {\n  'from': 'userA',\n  'to':   'userB'\n})\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"インポートの確認","__idx":13},"children":["インポートの確認"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["プログラムを実行します。"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"$ python test.py\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":"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    | follow     | log  | 1         |\n+------------+------------+------+-----------+\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"本番デプロイ","__idx":14},"children":["本番デプロイ"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"gunicorntornadoまたはmodwsgiを使用","__idx":15},"children":["gunicorn、tornado、またはmodwsgiを使用"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"http://gunicorn.org/"},"children":["gunicorn"]},"、",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"http://www.tornadoweb.org/"},"children":["tornado"]},"、または",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"http://code.google.com/p/modwsgi/"},"children":["modwsgi"]},"の使用を推奨します。他のセットアップは完全には検証されていません。"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"td-agentの高可用性構成","__idx":16},"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":17},"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プロジェクト"]},"の下で完全にオープンソース化されています。"]}]},"headings":[{"value":"Python Apps Import Integration","id":"python-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":"EOLバージョンのレガシーサポートはまだ利用可能です","id":"eolバージョンのレガシーサポートはまだ利用可能です","depth":5},{"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-pythonの使用","id":"fluent-logger-pythonの使用","depth":2},{"value":"インポートの確認","id":"インポートの確認","depth":2},{"value":"本番デプロイ","id":"本番デプロイ","depth":1},{"value":"gunicorn、tornado、またはmodwsgiを使用","id":"gunicorntornadoまたはmodwsgiを使用","depth":3},{"value":"td-agentの高可用性構成","id":"td-agentの高可用性構成","depth":2},{"value":"td-agentの監視","id":"td-agentの監視","depth":2}],"frontmatter":{"seo":{"title":"Python Apps Import Integration"}},"lastModified":"2026-06-01T09:34:27.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/ja/int/python-apps-import-integration","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}