{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"redocly_category":"Products","product_name":"Integration Hub","type":"markdown"},"seo":{"title":"Installing Fluentd on macOS","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":"installing-fluentd-on-macos","__idx":0},"children":["Installing Fluentd on macOS"]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["td-agent was discontinued in December 2023 and has been replaced by ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["fluent-package"]},". The fluent-package is the official successor maintained by the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://www.cncf.io/projects/"},"children":["Cloud Native Computing Foundation"]},"."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["fluent-package for macOS is planned to be available via Homebrew in the future. For current installation options, see the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://docs.fluentd.org/installation"},"children":["Fluentd Installation Guide"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For production environments, we recommend using Linux-based systems (Ubuntu, Debian, RHEL, or Amazon Linux)."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"alternative-install-fluentd-via-ruby-gem","__idx":1},"children":["Alternative: Install Fluentd via Ruby Gem"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For development and testing on macOS, you can install Fluentd using Ruby gems:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"# Install Fluentd\ngem install fluentd\n\n# Install the TD plugin for Treasure Data integration\ngem install fluent-plugin-td\n\n# Create a sample configuration file\nfluentd --setup ./fluent\n\n# Start Fluentd\nfluentd -c ./fluent/fluent.conf\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"configuration","__idx":2},"children":["Configuration"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Your configuration file should include the TD output plugin for sending data to Treasure Data:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"conf","header":{"controls":{"copy":{}}},"source":"# Input from HTTP\n<source>\n  @type http\n  port 8888\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  use_ssl true\n  <buffer>\n    @type file\n    path ./fluent/buffer/td\n  </buffer>\n</match>\n","lang":"conf"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"post-sample-logs-using-http","__idx":3},"children":["Post Sample Logs using HTTP"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["By default, with an HTTP input configured, you can post sample log records using the following curl command:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X POST -d 'json={\"json\":\"message\"}' http://localhost:8888/debug.test\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"other-resources","__idx":4},"children":["Other Resources"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://docs.fluentd.org/"},"children":["Fluentd Documentation"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://docs.fluentd.org/installation/install-by-gem"},"children":["Fluentd Ruby Gem Installation"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/int/fluentd-continuous-data-import-integration"},"children":["Continuous Data Import with Fluentd"]}]}]}]},"headings":[{"value":"Installing Fluentd on macOS","id":"installing-fluentd-on-macos","depth":1},{"value":"Alternative: Install Fluentd via Ruby Gem","id":"alternative-install-fluentd-via-ruby-gem","depth":2},{"value":"Configuration","id":"configuration","depth":2},{"value":"Post Sample Logs using HTTP","id":"post-sample-logs-using-http","depth":2},{"value":"Other Resources","id":"other-resources","depth":2}],"frontmatter":{"seo":{"title":"Installing Fluentd on macOS"}},"lastModified":"2026-02-12T08:44:10.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/products/customer-data-platform/integration-hub/streaming/td-agent/installing-td-agent-on-macos-x","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}