{"id":28501996,"url":"https://github.com/fluent/fluent-logger-java","last_synced_at":"2025-07-05T02:31:57.172Z","repository":{"id":635001,"uuid":"2543682","full_name":"fluent/fluent-logger-java","owner":"fluent","description":"A structured logger for Fluentd (Java)","archived":false,"fork":false,"pushed_at":"2025-02-15T10:18:43.000Z","size":629,"stargazers_count":205,"open_issues_count":34,"forks_count":91,"subscribers_count":22,"default_branch":"master","last_synced_at":"2025-06-08T16:08:37.409Z","etag":null,"topics":["fluentd","fluentd-logger","java"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/fluent.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGES.txt","contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":"AUTHORS.txt","dei":null,"publiccode":null,"codemeta":null}},"created_at":"2011-10-09T17:56:44.000Z","updated_at":"2025-06-07T23:16:21.000Z","dependencies_parsed_at":"2024-06-21T16:42:44.959Z","dependency_job_id":"77e4de5e-7de5-4189-8906-be110c227d54","html_url":"https://github.com/fluent/fluent-logger-java","commit_stats":{"total_commits":239,"total_committers":21,"mean_commits":"11.380952380952381","dds":0.4644351464435147,"last_synced_commit":"2e5fdf2dbed59cc5af88442ceae6cbe72f321060"},"previous_names":[],"tags_count":12,"template":false,"template_full_name":null,"purl":"pkg:github/fluent/fluent-logger-java","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fluent%2Ffluent-logger-java","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fluent%2Ffluent-logger-java/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fluent%2Ffluent-logger-java/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fluent%2Ffluent-logger-java/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fluent","download_url":"https://codeload.github.com/fluent/fluent-logger-java/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fluent%2Ffluent-logger-java/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":263671746,"owners_count":23494027,"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","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":["fluentd","fluentd-logger","java"],"created_at":"2025-06-08T16:08:42.280Z","updated_at":"2025-07-05T02:31:57.167Z","avatar_url":"https://github.com/fluent.png","language":"Java","readme":"# Fluent Logger for Java\n\n[![Build Status](https://travis-ci.org/fluent/fluent-logger-java.svg?branch=master)](https://travis-ci.org/fluent/fluent-logger-java)\n\n## Overview\n\nMany web/mobile applications generate huge amount of event logs (c,f. login,\nlogout, purchase, follow, etc).  Analyzing these event logs can be quite\nvaluable for improving services.  However, collecting these logs easily and \nreliably is a challenging task.\n\nFluentd solves the problem by having: easy installation, small footprint, plugins,\nreliable buffering, log forwarding, etc.\n\n  * Fluentd website: [http://github.com/fluent/fluentd](http://github.com/fluent/fluentd)\n\n**fluent-logger-java** is a Java library, to record events via Fluentd, from Java application.\n\n## Requirements\n\nJava \u003e= 1.6\n\n## Install\n\n### Install with all-in-one jar file\n\nYou can download all-in-one jar file for Fluent Logger for Java.\n\n```bash\nwget http://central.maven.org/maven2/org/fluentd/fluent-logger/${logger.version}/fluent-logger-${logger.version}-jar-with-dependencies.jar   \n```\n\nTo use Fluent Logger for Java, set the above jar file to your classpath.\n\n### Install from Maven2 repository\n\nFluent Logger for Java is released on Fluent Maven2 repository.  You can \nconfigure your pom.xml or build.gradle as follows to use it:\n\n**Maven:**\n\n```xml\n\u003cdependencies\u003e\n  ...\n  \u003cdependency\u003e\n    \u003cgroupId\u003eorg.fluentd\u003c/groupId\u003e\n    \u003cartifactId\u003efluent-logger\u003c/artifactId\u003e\n    \u003cversion\u003e${logger.version}\u003c/version\u003e\n  \u003c/dependency\u003e\n  ...\n\u003c/dependencies\u003e\n```\n\n**Gradle:**\n\n```gradle\ndependencies {\n    compile 'org.fluentd:fluent-logger:'+loggerVersion\n}\n```\n\n### Install from Github repository\n\nYou can get latest source code using git.\n\n```bash\ngit clone git@github.com:fluent/fluent-logger-java.git\ncd fluent-logger-java\nmvn assembly:assembly\n```\n\nYou will get the fluent logger jar file in fluent-logger-java/target \ndirectory.  File name will be fluent-logger-${logger.version}-jar-with-dependencies.jar.\nFor more detail, see pom.xml.\n\n**Replace `${logger.version}` or `loggerVersion` with the current version of Fluent Logger for Java.**\n\n## Quickstart\n\nThe following program is a small example of Fluent Logger for Java.\n\n```java\nimport java.util.HashMap;\nimport java.util.Map;\nimport org.fluentd.logger.FluentLogger;\n\npublic class Main {\n    private static FluentLogger LOG = FluentLogger.getLogger(\"app\");\n\n    public void doApplicationLogic() {\n        // ...\n        Map\u003cString, Object\u003e data = new HashMap\u003cString, Object\u003e();\n        data.put(\"from\", \"userA\");\n        data.put(\"to\", \"userB\");\n        LOG.log(\"follow\", data);\n        // ...\n    }\n}\n```\n\nTo create Fluent Logger instances, users need to invoke getLogger method in \nFluentLogger class like org.slf4j, org.log4j logging libraries.  The method \nshould be called only once.  By default, the logger assumes fluent daemon is \nlaunched locally.  You can also specify remote logger by passing the following \noptions.  \n\n```java\n// for remote fluentd\nprivate static FluentLogger LOG = FluentLogger.getLogger(\"app\", \"remotehost\", port);\n```\n\nThen, please create the events like this.  This will send the event to fluentd, \nwith tag 'app.follow' and the attributes 'from' and 'to'.\n\nClose method in FluentLogger class should be called explicitly when application \nis finished.  The method closes socket connection with the fluentd.\n\n```java\nFluentLogger.close();\n```\n\n## License\n\nApache License, Version 2.0\n","funding_links":[],"categories":["日志库"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffluent%2Ffluent-logger-java","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffluent%2Ffluent-logger-java","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffluent%2Ffluent-logger-java/lists"}