fluentd README

The project's README from github.com/fluent/fluentd. As one markdown file: README.md.

Fluentd: Open-Source Log Collector

Test Test with Ruby head CII Best Practices OpenSSF Scorecard Backport Pull Requests

Fluentd collects events from various data sources and writes them to files, RDBMS, NoSQL, IaaS, SaaS, Hadoop and so on. Fluentd helps you unify your logging infrastructure (Learn more about the Unified Logging Layer).

Quick Start

$ gem install fluentd
$ fluentd -s conf
$ fluentd -c conf/fluent.conf &
$ echo '{"json":"message"}' | fluent-cat debug.test

Development

Branch

Prerequisites

git should be in PATH. On Windows, you can use Github for Windows and GitShell for easy setup.

Install dependent gems

Use bundler:

$ gem install bundler
$ bundle install --path vendor/bundle

Run test

$ bundle exec rake test

You can run specified test via TEST environment variable:

$ bundle exec rake test TEST=test/test_specified_path.rb
$ bundle exec rake test TEST=test/test_*.rb

More Information

Security

A third party security audit was performed by Cure53, you can see the full report here.

See SECURITY to contact us about vulnerability.

Contributors:

Patches contributed by great developers.

fluentd (fluent/fluentd)

Searching Database…

13.6K ·GitHub
Что это такое?Fluentd — это опенсорсный сборщик логов, который находится в центре вашей системы логирования: он принимает события из множества источников данных и записывает их в файлы, RDBMS, NoSQL, IaaS, SaaS, Hadoop и не только.
Это библиотека, которую я подключаю в свой код, или программа, которую я запускаю на своих серверах?Это отдельный демон: вы устанавливаете его, запускаете с конфигурационным файлом, и он сам собирает и маршрутизирует логи, а ваши приложения просто отправляют ему события.
Как его запустить?Установите гем, сгенерируйте конфиг и запустите демон: 'gem install fluentd', затем 'fluentd -s conf', затем 'fluentd -c conf/fluent.conf &'. Проверить можно, отправив JSON-сообщение через 'fluent-cat debug.test'.
Что должно быть установлено, чтобы он заработал?Ruby 3.3 или новее, плюс git в PATH (в Windows в README советуют для простой настройки git использовать GitHub for Windows или GitShell).
Я всё ещё на старой ветке 0.12 — это нормально?Нет: ветка v0.12 устарела и больше не поддерживается. Разработка идёт в master для v1, так что планируйте переход на v1.
Можно ли использовать его в коммерческих целях, и сколько он стоит?Он бесплатный и опенсорсный, под лицензией Apache License 2.0, которая разрешает коммерческое использование.
Почему он называет себя единой системой логирования (unified logging layer)?Потому что он отделяет источники данных от мест хранения: вместо того чтобы подключать каждое приложение к каждому хранилищу, Fluentd принимает события один раз и пересылает их туда, куда нужно — в файлы, RDBMS, NoSQL, IaaS, SaaS или Hadoop — объединяя всю вашу инфраструктуру логирования.
Как быстро проверить, что он действительно получает события?Пока демон работает, отправьте небольшой JSON через команду 'fluent-cat' с тестовым тегом вроде debug.test — и посмотрите, как сообщение проходит.
What are similar projects?vector, telegraf, thanos, signoz, kubescape, cat, jaeger, awesome-sysadmin
Creator
fluent
Size
21.2 MB
Stars
13.6K
Age
15y
Commits · 90 Days