{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-@l10n/ja/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"TD Agentのトラブルシューティング","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":"td-agentのトラブルシューティング","__idx":0},"children":["TD Agentのトラブルシューティング"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Treasure DataのTreasure Agent(td-agent)は、時々「Failed to upload to TreasureData: Import failed」というエラーが発生します。考えられる原因はいくつかあります:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["アップロード中にネットワークが不安定になった。"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Treasure DataのAPIが予期しないネットワーク/ノードの状態により接続をシャットダウンした。"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["td-agentには、これらのケースに対する堅牢な再試行メカニズムがあるため、Treasure Dataへのデータインポートを継続します。数回の再試行後、ログに「retry succeeded」というメッセージが表示されるはずです。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["同じエラーが続き、再試行制限を超えた場合は、ネットワーク以外の問題です。",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"mailto:support@treasure-data.com"},"children":["support@treasure-data.com"]},"までご連絡ください。"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"データをインポートできない","__idx":1},"children":["データをインポートできない"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["データをインポートできない一般的な理由は次のとおりです。"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["ネットワークが稼働しており、外部ネットワークへのアクセスが許可されていることを確認してください。"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["データに2e64より大きい数値が含まれている場合は、tdコマンド/td-agentを最新バージョンにアップグレードする必要があります。代わりにFluentdを使用している場合は、Fluent-plugin-tdをバージョン0.10.15以降にアップグレードしてください。"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"td-agentのパフォーマンスが遅い","__idx":2},"children":["td-agentのパフォーマンスが遅い"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["td-agentの実行には、いくらかのエージェントオーバーヘッドが関連しています。リソース消費量は次のように概算されます:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["常駐メモリ(実際に使用されるRAM): 50MB"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["CPUランタイム: 平均ランタイムの2%未満 + ワークロード"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["ディスク: Linux 120MB + ファイルバッファ(設定可能)"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["td-agentが遅いと思われる場合は、「",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://blog.treasuredata.com/blog/2015/08/18/5-tips-to-optimize-fluentd-performance/"},"children":["5 Tips to Optimize Fluentd Performance"]},"」をご覧ください。"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"詳細ログの有効化","__idx":3},"children":["詳細ログの有効化"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["問題が発生している場合は、",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/etc/default/td-agent"]},"に次の行を追加して詳細ログを有効にしてください。"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"conf","header":{"controls":{"copy":{}}},"source":"    DAEMON_ARGS=-vv\n","lang":"conf"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["デーモンを再起動してください。これで、/var/log/td-agent.logでより詳細なログを確認できます。"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"エンドポイント変更の警告","__idx":4},"children":["エンドポイント変更の警告"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["td-agentログに次のメッセージが表示される場合があります。"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"log","header":{"controls":{"copy":{}}},"source":"tdlog plugin will change the API endpoint from api.us01.treasure-data.com to api.us01.treasuredata.com\nIf you want to keep api.treasure-data.com, set 'endpoint api.treasure-data.com' in tdlog configuration\n","lang":"log"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["このメッセージは、",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://api.treasure-data.com"},"children":["api.treasure-data.com"]},"へのネットワークアクセスの制御を変更するユーザー向けです。APIエンドポイントに基づくアクセス制限を設定していない場合は、この警告を無視してください。"]}]},"headings":[{"value":"TD Agentのトラブルシューティング","id":"td-agentのトラブルシューティング","depth":1},{"value":"データをインポートできない","id":"データをインポートできない","depth":1},{"value":"td-agentのパフォーマンスが遅い","id":"td-agentのパフォーマンスが遅い","depth":1},{"value":"詳細ログの有効化","id":"詳細ログの有効化","depth":1},{"value":"エンドポイント変更の警告","id":"エンドポイント変更の警告","depth":1}],"frontmatter":{"seo":{"title":"TD Agentのトラブルシューティング"}},"lastModified":"2025-11-22T02:43:27.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/ja/products/customer-data-platform/integration-hub/streaming/td-agent/troubleshooting-td-agent","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}