{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-@l10n/ja/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Java 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":"java-apps-import-integration","__idx":0},"children":["Java Apps Import Integration"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Treasure Dataは、サーバーサイドのログとイベントを収集し、JavaアプリケーションからデータをシームレスにインポートするためのTreasure Agent（",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://docs.treasuredata.com/smart/project-product-documentation/installing-td-agent"},"children":["td-agent"]},"）を提供しています。"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"前提条件","__idx":1},"children":["前提条件"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Javaの基本的な知識"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Mavenの基本的な知識"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Treasure Dataの基本的な知識"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Java 6以上（ローカルテスト用）"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"td-agentのインストール","__idx":2},"children":["td-agentのインストール"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["アプリケーションサーバーにtd-agentをインストールします。td-agentはアプリケーションサーバー内に常駐し、アプリケーションログをクラウドにアップロードすることに専念します。"," ",{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/image2021-4-15_14-42-29.e1f0a3881144362a280b1dabf16baeb3de7e9fc7265ee930c72b1518d9bbaf83.10220609.png","alt":""},"children":[]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"http://github.com/treasure-data/td-logger-java"},"children":["td-logger-java"]},"ライブラリを使用すると、Javaアプリケーションがローカルのtd-agentにレコードを送信できるようになります。td-agentは、これらのレコードを受信し、バッファリングし、5分ごとにデータをクラウドにアップロードします。デーモンがローカルノードで実行されるため、ログ記録のレイテンシはごくわずかです。"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"インストールオプション","__idx":3},"children":["インストールオプション"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["td-agentは、fluentdの安定版ディストリビューションパッケージであり、rpm/deb/dmgなどの各プラットフォームのパッケージ管理ソフトウェアを使用すると自動的にインストールされます。各プラットフォームの詳細な手順については、",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://docs.treasuredata.com/smart/project-product-documentation/installing-td-agent"},"children":["td-agentのインストール"]},"を参照してください。"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"etctd-agenttd-agentconfの変更","__idx":4},"children":["/etc/td-agent/td-agent.confの変更"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["/etc/td-agent/td-agent.confファイルでAPIキーオプションを設定して、APIキーを指定します。"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"# Input from Logger Libraries\nsource\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"},"children":[]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["YOUR_API_KEY"]},"は実際のAPIキー文字列に置き換える必要があります。APIキーはTreasure コンソールのプロフィールから取得できます。",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/my-settings/getting-your-api-keys"},"children":["書き込み専用APIキー"]},"の使用を推奨します。"]}]},{"$$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-javaの使用","__idx":5},"children":["td-logger-javaの使用"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["オールインワンのJARファイルが必要な場合は、",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://search.maven.org/artifact/com.treasuredata/td-logger"},"children":["https://search.maven.org/artifact/com.treasuredata/td-logger"]},"を参照してください。td-logger-{version_number}-jar-with-dependencies.jarファイルの最新バージョンをダウンロードしてください。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Mavenを使用している場合は、Mavenプロジェクトのpom.xmlに以下の行を追加します。"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"dependencies\n  ...\n  dependency\n    groupIdcom.treasuredata</groupId>\n    artifactIdtd-logger</artifactId>\n    version${logger.version}</version>\n  </dependency>\n  ...\n</dependencies>\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["次のコマンドを使用して",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["treasure-data.properties"]},"ファイルを設定します。"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"td.logger.agentmode=true\ntd.logger.agent.host=localhost\ntd.logger.agent.port=24224\ntd.logger.agent.tag=td\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["treasure-data.properties"]},"ファイルがJavaクラスパスから参照できることを確認する必要があります。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["アプリケーションに以下の行を挿入します。APIの詳細については、",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://github.com/treasure-data/td-logger-java"},"children":["こちら"]},"を参照してください。"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"java","header":{"controls":{"copy":{}}},"source":"import com.treasure_data.logger.TreasureDataLogger;\npublic class Main {\n  private static TreasureDataLogger LOG;\n  static {\n    try {\n      Properties props = System.getProperties();\n      props.load(Main.class.getClassLoader().getResourceAsStream(\"treasure-data.properties\"));\n      LOG = TreasureDataLogger.getLogger(\"test_db\");\n    } catch (IOException e) {\n      // do something\n    }\n  }\n  public void doApp() {\n    Map<String, Object> data = new HashMap<String, Object>();\n    data.put(\"from\", \"userA\");\n    data.put(\"to\", \"userB\");\n    LOG.log(\"follow\", data);\n  }\n}\n","lang":"java"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"データインポートの確認","__idx":6},"children":["データインポートの確認"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["プログラムを実行します。"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"# Post a record\n$ java -jar test.jar\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":4,"id":"treasure-コンソールから","__idx":7},"children":["Treasure コンソールから"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["データが正常にアップロードされたことを確認するには、",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://console.treasuredata.com/app/databases"},"children":["Webブラウザ"]},"からデータセットを確認します。"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"cliから","__idx":8},"children":["CLIから"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["または、",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://docs.treasuredata.com/smart/project-product-documentation/configuring-authentication-for-td-using-the-td-toolbelt"},"children":["td 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    | follow     | log  | 1         |\n+------------+------------+------+-----------+\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"本番環境へのデプロイメント","__idx":9},"children":["本番環境へのデプロイメント"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"td-agentの高可用性構成","__idx":10},"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":["td-agentの高可用性構成"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"td-agentの監視","__idx":11},"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":"https://www.fluentd.org/"},"children":["Fluentdプロジェクト"]},"の下で完全にオープンソース化されています。"]}]},"headings":[{"value":"Java Apps Import Integration","id":"java-apps-import-integration","depth":1},{"value":"前提条件","id":"前提条件","depth":1},{"value":"td-agentのインストール","id":"td-agentのインストール","depth":1},{"value":"インストールオプション","id":"インストールオプション","depth":2},{"value":"/etc/td-agent/td-agent.confの変更","id":"etctd-agenttd-agentconfの変更","depth":2},{"value":"td-logger-javaの使用","id":"td-logger-javaの使用","depth":2},{"value":"データインポートの確認","id":"データインポートの確認","depth":2},{"value":"Treasure コンソールから","id":"treasure-コンソールから","depth":4},{"value":"CLIから","id":"cliから","depth":4},{"value":"本番環境へのデプロイメント","id":"本番環境へのデプロイメント","depth":1},{"value":"td-agentの高可用性構成","id":"td-agentの高可用性構成","depth":2},{"value":"td-agentの監視","id":"td-agentの監視","depth":2}],"frontmatter":{"seo":{"title":"Java Apps Import Integration"}},"lastModified":"2026-06-01T09:34:27.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/ja/int/java-apps-import-integration","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}