{"id":26057643,"url":"https://github.com/wavefronthq/logstash-output-wavefront","last_synced_at":"2025-04-11T05:06:39.805Z","repository":{"id":56882159,"uuid":"66892878","full_name":"wavefrontHQ/logstash-output-wavefront","owner":"wavefrontHQ","description":"Wavefront Logstash Output Plugin","archived":false,"fork":false,"pushed_at":"2020-08-17T17:59:30.000Z","size":12,"stargazers_count":2,"open_issues_count":0,"forks_count":3,"subscribers_count":30,"default_branch":"master","last_synced_at":"2025-04-11T05:06:34.131Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Ruby","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/wavefrontHQ.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2016-08-30T00:55:35.000Z","updated_at":"2021-12-28T15:29:49.000Z","dependencies_parsed_at":"2022-08-20T13:00:38.288Z","dependency_job_id":null,"html_url":"https://github.com/wavefrontHQ/logstash-output-wavefront","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wavefrontHQ%2Flogstash-output-wavefront","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wavefrontHQ%2Flogstash-output-wavefront/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wavefrontHQ%2Flogstash-output-wavefront/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wavefrontHQ%2Flogstash-output-wavefront/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/wavefrontHQ","download_url":"https://codeload.github.com/wavefrontHQ/logstash-output-wavefront/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248345265,"owners_count":21088244,"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":[],"created_at":"2025-03-08T11:58:12.514Z","updated_at":"2025-04-11T05:06:39.779Z","avatar_url":"https://github.com/wavefrontHQ.png","language":"Ruby","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Wavefront Logstash Output Plugin\nWavefront Output Plugin for Logstash parse the log data and sends it as metrics to the Wavefront.\n\n# Installation\n1. Install Wavefront Logstash Output Plugin\n    - Install ruby.\n    - Install ruby bundler -- `gem install bundler`.\n    - Clone [logstash-output-wavefront](https://github.com/wavefrontHQ/logstash-output-wavefront) and `cd` to the directory.\n    - Build the plugin -- `gem build logstash-output-wavefront.gemspec`.\n    - Install the plugin --`logstash-plugin install *wavefront*.gem`.\n\n\n2. Create a config file that specifies wavefront as the output plugin and specifies settings for other plugins. You can see some examples under Optional Configuration below.\n    ```\n    output {\n        wavefront {\n          host =\u003e \"\u003cProxy-IP\u003e\"\n        }\n    }\n    ```\n    Optional Configuration\n    ```\n      port          Metric Port (Default - 2878)\n      prefix        Metric Prefix (Default - \"logstash\")\n      metrics       List of metrics (Default - [\"count\", \"mean\"])\n      source        Metric source (Default - Hostname of the node running logstash)\n    ```\n\n   You can send log events to Wavefront using the output plugin for Logstash. The events must have the following format:\n    ```\n    {\n       \"bytes\" =\u003e {\n         \"count\" =\u003e 200,\n         \"mean\" =\u003e 42.2\n       },\n       \"error\" =\u003e {\n         \"count\" =\u003e 123,\n         \"code\" =\u003e 404\n       },\n       \"message\" =\u003e \"I'm not a hash type, so I won't get sent.\"\n     }\n    ```\n    The Wavefront output plugin for Logstash generates the following metrics from the event and sends the metrics to Wavefront:\n    ```\n    logstash.bytes.count 200\n    logstash.bytes.mean 42.2\n    logstash.error.count 123\n    ```\n    You can send point tags for a metric to Wavefront using the Wavefront output plugin for Logstash. The event must have the following format:\n    ```\n    {\n       \"bytes.tagz.type=access.region=mumbai\" =\u003e {\n         \"count\" =\u003e 200,\n         \"mean\" =\u003e 42.2\n       },\n       \"error\" =\u003e {\n         \"count\" =\u003e 123,\n         \"code\" =\u003e 404\n       },\n       \"message\" =\u003e \"I'm not a hash type, so I won't get sent.\"\n     }\n    ```\n    Below metrics are the output of the above event:\n    ```\n    logstash.bytes.count 200 type=access region=mumbai\n    logstash.bytes.mean 42.2 type=access region=mumbai\n    logstash.error.count 123\n    ```\n    \n    **Note:** In this example the Wavefront output plugin has dropped the `logstash.error.code` metric because the default `metrics` list only includes `count` and `mean`. To include the `code` metric, override the default `metrics` to `[\"count\", \"mean\", \"code\"]` in the `wavefront` output plugin.\n\n\n3. Start logstash and specify the configuration file with the -f flag.\n    ```\n    bin/logstash -f \u003cconfig-file\u003e\n    ```\n\n# License\n[Apache 2.0 License](LICENSE).\n\n# How to Contribute\n\n* Reach out to us on our public [Slack channel](https://www.wavefront.com/join-public-slack).\n* If you run into any issues, let us know by creating a GitHub issue.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwavefronthq%2Flogstash-output-wavefront","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwavefronthq%2Flogstash-output-wavefront","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwavefronthq%2Flogstash-output-wavefront/lists"}