{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-@l10n/ja/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Logstash Import Integration","description":"Logstashからデータを簡単に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":"logstash-import-integration","__idx":0},"children":["Logstash Import Integration"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://www.elastic.co/products/logstash"},"children":["Logstash"]},"は、ログ管理用のオープンソースソフトウェアであり、ELKスタックの一部として広く使用されています。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Logstashには、多くのソースからデータを収集、フィルタリング、保存し、多くの宛先に送信するための多数のプラグインが存在します。Treasure Dataプラグインを作成することで、LogstashからTreasure Dataにデータを取り込むことができます。"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"treasure-data-logstashプラグインのインストールと設定","__idx":1},"children":["Treasure Data Logstashプラグインのインストールと設定"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Logstash用のTreasure Dataプラグインをインストールできます。以下の例では、Logstashがすでにインストールおよび設定されていることを前提としています。"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"$ cd /path/of/logstash\n$ bin/plugin install logstash-output-treasure_data\nValidating logstash-output-treasure_data\nInstalling logstash-output-treasure_data\nInstallation successful\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["LogstashをTreasure Dataサービスで設定します。Logstashデータのインポート先となるdatabaseとtableの名前を指定する必要があります。APIキーは、Treasure コンソールのプロファイルから取得できます。write-onlyキーを使用してください。"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"conf","header":{"controls":{"copy":{}}},"source":"input {\n  # ...\n}\noutput {\n  treasure_data {\n    apikey   => \"xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\"\n    database => \"dbname\"\n    table    => \"tablename\"\n    endpoint => \"api-import.treasuredata.com\"\n  }\n}\n","lang":"conf"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["設定ファイルを使用してLogstashを起動します。"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"$ bin/logstash -f your.conf\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Treasure コンソールでデータの行を確認できます。ログメッセージテキストはmessageカラムに保存され、追加のカラム(例: time、host、version)が存在します。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/logtash-td.3c9a41c1e020ed11569ac4a2873a1951219c2ac01bd125e726091791f45b9d62.8c2a6faf.png","alt":""},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"パラメータ","__idx":2},"children":["パラメータ"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["ログはテーブルに保存されます。2つ以上のテーブルにデータを挿入する場合は、設定ファイルに2つ以上のセクションを作成してください。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Logstash設定では、以下のオプションを指定できます:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["apikey(必須)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["database(必須)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["table(必須)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["auto_create_table [true]: テーブルが存在しない場合にテーブルを作成します"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["endpoint [",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"http://api.treasuredata.com"},"children":["api.treasuredata.com"]},"]"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["use_ssl [true]"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["http_proxy [none]"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["connect_timeout [60s]"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["read_timeout [600s]"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["send_timeout [600s]"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["プラグインはほとんどの場合、デフォルト値で動作しますが、一部のパラメータは不安定なネットワーク環境で役立つ場合があります。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["このプラグインは、データを最大5分間メモリバッファにバッファリングします。Logstashプロセスがクラッシュすると、バッファリングされたデータは失われます。インポート中のデータ損失を回避するには、Logstashプラグインと共にtd-agentを使用することをお勧めします。"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"td-agentと組み合わせたlogstashプラグイン","__idx":3},"children":["td-agentと組み合わせたLogstashプラグイン"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Logstashプラグインは、バッファリング、保存されたテーブル仕様、およびパフォーマンスの面で制限されています。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["より柔軟で高性能なデータ転送には、Treasure Agent(",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://docs.treasuredata.com/smart/project-product-documentation/about-treasure-data-s-server-side-agent"},"children":["td-agent"]},")を使用できます。これを行うには、logstash-output-fluentdを使用します。"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"[host a]\n  -> (logstash-output-fluentd) -+\n[host b]                        |\n  -> (logstash-output-fluentd) -+- [Treasure Agent] -> [Treasure Data]\n[host c]                        |\n  -> (logstash-output-fluentd) -+\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Logstashをtd-agentノードにログを送信するように設定でき、そのtd-agentがすべてのデータをTreasure Dataに保存します。"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"conf","header":{"controls":{"copy":{}}},"source":"# Configuration for Logastash\ninput {\n  # ...\n}\noutput {\n  fluentd {\n    host => \"your.host.name.example.com\"\n    port => 24224 # default\n    tag  => \"td.database.tablename\"\n  }\n}\n# Configuration for Fluentd\n<source>\n  @type forward\n  port 24224\n</source>\n<match td.*.*>\n  type tdlog\n  endpoint api-import.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  num_threads 8\n</match>\n","lang":"conf"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Fluentd tdlogプラグインは、td.dbname.tablenameを解析することで、多くのdatabase-tableの組み合わせにデータを保存できます。Logstash設定ファイルで任意のdatabaseとtableのペアを設定できます。"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"詳細情報","__idx":4},"children":["詳細情報"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://github.com/tagomoris/logstash-output-treasure_data"},"children":["github.com/tagomoris/logstash-output-treasure_data"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://github.com/tagomoris/logstash-output-fluentd"},"children":["github.com/tagomoris/logstash-output-fluentd"]}]}]}]},"headings":[{"value":"Logstash Import Integration","id":"logstash-import-integration","depth":1},{"value":"Treasure Data Logstashプラグインのインストールと設定","id":"treasure-data-logstashプラグインのインストールと設定","depth":2},{"value":"パラメータ","id":"パラメータ","depth":2},{"value":"td-agentと組み合わせたLogstashプラグイン","id":"td-agentと組み合わせたlogstashプラグイン","depth":2},{"value":"詳細情報","id":"詳細情報","depth":2}],"frontmatter":{"seo":{"title":"Logstash Import Integration","description":"Logstashからデータを簡単にTreasure AIにインポートする方法を解説。プラグインのインストール、設定、データ転送の手順を日本語で詳しく説明します。"}},"lastModified":"2026-06-17T07:22:53.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/ja/int/logstash-import-integration","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}