{"id":13447441,"url":"https://github.com/sematext/logagent-js","last_synced_at":"2025-05-16T05:04:26.629Z","repository":{"id":35414143,"uuid":"39678912","full_name":"sematext/logagent-js","owner":"sematext","description":"Extensible log shipper with input/output plugins, buffering, parsing, data masking, and small memory/CPU footprint","archived":false,"fork":false,"pushed_at":"2024-09-12T15:57:37.000Z","size":3166,"stargazers_count":390,"open_issues_count":41,"forks_count":78,"subscribers_count":24,"default_branch":"master","last_synced_at":"2025-04-21T11:08:29.485Z","etag":null,"topics":["elk","elk-stack","javascript","log-collector","log-management","logagent","logging","logs","logshipper","nodejs"],"latest_commit_sha":null,"homepage":"https://sematext.com/logagent","language":"JavaScript","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/sematext.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2015-07-25T09:09:07.000Z","updated_at":"2025-04-11T09:12:34.000Z","dependencies_parsed_at":"2024-01-07T12:51:54.887Z","dependency_job_id":"fd3aed30-c576-4d57-894d-810206a8b13b","html_url":"https://github.com/sematext/logagent-js","commit_stats":{"total_commits":1785,"total_committers":46,"mean_commits":38.80434782608695,"dds":0.6128851540616247,"last_synced_commit":"866ff41ce451d786d413880b4d7ef56070d580f1"},"previous_names":[],"tags_count":273,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sematext%2Flogagent-js","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sematext%2Flogagent-js/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sematext%2Flogagent-js/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sematext%2Flogagent-js/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sematext","download_url":"https://codeload.github.com/sematext/logagent-js/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254471060,"owners_count":22076585,"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":["elk","elk-stack","javascript","log-collector","log-management","logagent","logging","logs","logshipper","nodejs"],"created_at":"2024-07-31T05:01:17.780Z","updated_at":"2025-05-16T05:04:26.612Z","avatar_url":"https://github.com/sematext.png","language":"JavaScript","readme":"[![Build Status](https://api.travis-ci.org/sematext/logagent-js.svg?branch=master)](https://travis-ci.org/sematext/logagent-js)\n[![Deploy](https://www.herokucdn.com/deploy/button.png)](https://heroku.com/deploy?template=https://github.com/sematext/logagent-js) - [read more](http://blog.sematext.com/2016/02/18/how-to-ship-heroku-logs-to-logsene-managed-elk-stack/)\n\n# What is Logagent\n\n[Logagent](https://sematext.com/logagent) is a modern, open-source, light-weight log shipper. It is like Filebeat and Logstash in one, without the JVM memory footprint.  It comes with out of the box and extensible log parsing, on-disk buffering, secure transport, and bulk indexing to Elasticsearch, [Sematext Logs](https://sematext.com/logsene), and other destinations. Its low memory footprint and low CPU overhead make it suitable for deploying on edge nodes and devices, while its ability to parse and structure logs makes it a great Logstash alternative.\n\n![](https://sematext.com/wp-content/uploads/2016/07/logagent.png)\n\n# Docker\n\nDetails about the the Logagent Docker image are described in the [Docker Hub Readme](https://github.com/sematext/logagent-js/blob/master/dockerhub/README.md)\n\n# Installation\n\n**1) Install Node.js**\n\nOfficial Node.js [downloads and instructions](https://nodejs.org/en/download/). E.g. for Debian/Ubuntu:\n\n```\ncurl -sL https://deb.nodesource.com/setup_10.x | sudo -E bash -\nsudo apt-get install -y nodejs\nInstall Logagent with npm\nsudo npm i -g @sematext/logagent\n```\n\n**2) Run logagent command line tool**\n\n```\nlogagent --help\n```\n\n**3) Example: Index your log files in Elasticsearch**\n\n```\nlogagent -e http://localhost:9200 -i logs -g ‘/var/log/**/*.log’\n```\n\n**4) Optional: Install service \u0026 config**\n\nInstall service for Logagent using systemd, upstart, launchd\nTo quickly create a config file for indexing into Elasticsearch without having to edit it run something like this:\n\n```\nsudo logagent-setup -u http://localhost:9200 -i INDEX_NAME -g '/var/log/**/*.log'\n# Logsene US: use -u https://logsene-receiver.sematext.com and your Logsene App Token as index name.\n# Logsene EU: use -u https://logsene-receiver.eu.sematext.com and your Logsene App Token as index name.\n```\n\n**Configuration**\n\nTo configure different inputs, different event processing, or different outputs (e.g. your own Elasticsearch) edit /etc/sematext/logagent.conf, e.g.:\n\n```\noutput:\n  logsene:\n    module: elasticsearch\n    url: http://elasticsearch-server:9200\n    index: logs\n```\n\nThen restart the service with sudo service logagent restart.\nTroubleshooting \u0026 Logs\nLogagent’s own logs:\n\n* Upstart: `/var/log/upstart/logagent.log`\n* Systemd: `journalctl -u logagent`\n* Launchd: `/Library/Logs/logagent.log`\n\nLocation of service scripts:\n\n* Upstart: `/etc/init/logagent.conf`\n* Systemd: `/etc/systemd/system/logagent.service`\n* Launchd: `/Library/LaunchDaemons/com.sematext.logagent.plist`\n\nStart/stop service:\n\n* Upstart: `service logagent stop/start`\n* Systemd: `systemctl stop/start logagent`\n* Launchd: `launchctl start/stop com.sematext.logagent`\n\n# Documentation \u0026 Support\n\n* [Full documentation](http://sematext.com/docs/logagent/)\n* [Logagent main page](https://sematext.com/logagent)\n* [Logagent on Github](https://github.com/sematext/logagent-js)\n* Forum: [https://groups.google.com/forum/#!forum/logagent](https://groups.google.com/forum/#!forum/logagent)\n* Twitter: [@sematext](https://twitter.com/sematext)\n* Blog: [sematext.com/blog](https://sematext.com/blog)\n\n# Development\n\n* Update to the last node version\n* From root folder node type: node ./bin/logagent -h\n* To test from root folder type: node test\n","funding_links":[],"categories":["JavaScript","Collecting data into InfluxDB","Container Operations","Logging"],"sub_categories":["Projects","Monitoring"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsematext%2Flogagent-js","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsematext%2Flogagent-js","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsematext%2Flogagent-js/lists"}