{"id":17003263,"url":"https://github.com/jayfk/django-fluentd","last_synced_at":"2025-08-28T02:48:59.545Z","repository":{"id":15078336,"uuid":"17804744","full_name":"jayfk/django-fluentd","owner":"jayfk","description":"django-fluentd allows you to use django's logging framework to log directly to a fluentd server of your choice.","archived":false,"fork":false,"pushed_at":"2014-03-16T18:10:50.000Z","size":132,"stargazers_count":19,"open_issues_count":1,"forks_count":10,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-12T06:38:26.872Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"expressjs/express","license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jayfk.png","metadata":{"files":{"readme":"README.rst","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2014-03-16T17:33:38.000Z","updated_at":"2025-02-26T13:19:28.000Z","dependencies_parsed_at":"2022-08-30T04:51:13.784Z","dependency_job_id":null,"html_url":"https://github.com/jayfk/django-fluentd","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/jayfk/django-fluentd","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jayfk%2Fdjango-fluentd","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jayfk%2Fdjango-fluentd/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jayfk%2Fdjango-fluentd/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jayfk%2Fdjango-fluentd/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jayfk","download_url":"https://codeload.github.com/jayfk/django-fluentd/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jayfk%2Fdjango-fluentd/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":272424888,"owners_count":24932895,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-28T02:00:10.768Z","response_time":74,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-10-14T04:30:09.637Z","updated_at":"2025-08-28T02:48:59.508Z","avatar_url":"https://github.com/jayfk.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"============\ndjango-fluentd\n============\n\ndjango-fluentd allows you to use django's logging framework to log directly to a fluentd server of your choice.\n\nPlease consider the package as unstable and don't use it for production, yet.\n\nInstallation\n============\n\nwith pip::\n\n  pip install django-fluentd\n\n**or**\n\nwith setup.py::\n\n  git clone https://github.com/jayfk/django-fluentd.git\n  cd django-fluentd\n  python setup.py install\n\nConfiguration\n============\n\nAdd the following to your settings.py::\n\n  DJANGO_FLUENTD_SERVER = \"10.10.10.10\"\n  DJANGO_FLUENTD_PORT = 24224 #no string\n  DJANGO_FLUENTD_TAG = \"your_fluentd_tag\"\n\nAdd the fluentd handler to your LOGGING dict in your settings.py and add this handler to one of your loggers::\n\n  LOGGING = {\n    \n    ...\n    \n    'handlers':{\n        'fluentd': {\n            'level': 'DEBUG',\n            'class': 'django_fluentd.handler.FluentdHandler',\n        },\n    }\n    \n    ...\n    \n    'loggers': {\n        'django': {\n            'handlers': ['fluentd',],\n            'level': 'DEBUG',\n            'propagate': False,\n        },\n    },\n  }\n\nIf you want to capture all logging messages using fluentd, you can add a root handler::\n\n  LOGGING = {\n    ...\n\n    'root': {\n          'level': 'DEBUG',\n          'handlers': ['fluentd'],\n      },\n\n    ...\n  }\n\nFurther information on how to use django's logging framework can be found here: https://docs.djangoproject.com/en/dev/topics/logging/\n\nFluentd Server Setup\n============\n\nYour Fluentd Server should listen on the ip and the port you specified in ``DJANGO_FLUENTD_SERVER`` and ``DJANGO_FLUENTD_PORT``::\n\n  \u003csource\u003e\n   type forward\n   port 24224\n   bind 10.10.10.10\n  \u003c/source\u003e\n\nPlease not that you currently can't use fluentd's secure_forward. If you want to send encrypted or authenticated messages\nto another fluentd server on the net, you'll have to add a local fluentd server that accepts unencrypted messages and forwards\nthem using secure_forward::\n\n  \u003csource\u003e\n   type forward\n   port 24224\n   bind 10.10.10.10\n  \u003c/source\u003e\n\n  \u003cmatch **\u003e\n    type secure_forward\n    shared_key foobar\n    self_hostname example.org\n    send_timeout 60s\n    recover_wait 10s\n    heartbeat_interval 1s\n    phi_threshold 8\n    hard_timeout 60s\n\n    \u003cserver\u003e\n      name remote_server_name\n      host 10.10.10.11\n      port 24224\n      username your_username\n      password your_password\n    \u003c/server\u003e\n\n  \u003c/match\u003e\n\nFurther information on how to use fluentd can be found here: http://fluentd.org/\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjayfk%2Fdjango-fluentd","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjayfk%2Fdjango-fluentd","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjayfk%2Fdjango-fluentd/lists"}