reddit/fluent-plugin-logdna

Name: fluent-plugin-logdna

Owner: Reddit

Description: null

Created: 2018-05-08 16:45:25.0

Updated: 2018-05-22 17:47:11.0

Pushed: 2018-05-22 17:47:09.0

Homepage: null

Size: 29

Language: Ruby

GitHub Committers

User	Most Recent Commit	# Commits

Other Committers

User	Email	Most Recent Commit	# Commits

README

fluent-plugin-logdna

Using fluent-plugin-logdna, you can send the logs you collect with Fluentd to LogDNA.

Instructions

• Install Fluentd
• gem install fluent-plugin-logdna or td-agent-gem install fluent-plugin-logdna if you are using td-agent.
• Add the contents below to /etc/fluent/fluent.conf. For td-agent, use /etc/td-agent/td-agent.conf:

ch your_match>
ype logdna
i_key xxxxxxxxxxxxxxxxxxxxxxxxxxx        # paste your api key here (required)
stname "#{Socket.gethostname}"           # your hostname (required)
p my_app                                 # replace with your app name
ac C0:FF:EE:C0:FF:EE                     # optional mac address
p 127.0.0.1                              # optional ip address
ffer_chunk_limit 1m                      # do not increase past 10m (10MB) or your logs will be rejected by our server.
ush_at_shutdown true                     # only needed with file buffer
tch>

• Restart fluentd to pick up the configuration changes.

Recommended Configuration Parameters

• buffer_type
• We recommend setting this to memory for development and file for production (file setting requires a buffer_path).
• buffer_queue_limit, buffer_chunk_limit
• We do not recommend increasing buffer_chunk_limit past 10MB.
• flush_interval
• Default is 60s. We recommend keeping this well above 5s.
• retry_wait, max_retry_wait, retry_limit, disable_retry_limit
• We recommend increasing these values if you are encountering problems.

Options

• App name and log level can also be provided on a line-by-line basis over JSON:
• _app and level will override the config

If you don't have a LogDNA account, you can create one on https://logdna.com or if you're on macOS w/Homebrew installed:

 cask install logdna-cli
na register <email>
w paste the api key above

LogDNA Pay-per-gig Pricing

Our paid plans start at $1.25/GB per month, pay for what you use / no fixed data buckets / all paid plans include all features.

Building a debian package for td-agent

If you use td-agent you can build a debian package instead of installing via td-agent-gem. This requires that td-agent is already installed and that you've installed fpm. Then just run make in your git directory.

install --no-ri --no-rdoc fpm
clone https://github.com/logdna/fluent-plugin-logdna
luent-plugin-logdna

 dpkg -i fluent-plugin-logdna*.deb

Additional Options

For advanced configuration options, please refer to the buffered output parameters documentation.

Questions or concerns? Contact support@logdna.com.