{"_id":"56a82ae72036420d002d21ba","parentDoc":null,"user":"5637d336aa96490d00a64f81","__v":1,"category":{"_id":"568adfffcbd4ca0d00aebf7e","project":"5633ebff7e9e880d00af1a53","version":"5633ec007e9e880d00af1a56","__v":1,"pages":["568ae00c7a42220d00498265"],"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2016-01-04T21:11:27.469Z","from_sync":false,"order":5,"slug":"dashboards","title":"Common Tools"},"project":"5633ebff7e9e880d00af1a53","version":{"_id":"5633ec007e9e880d00af1a56","project":"5633ebff7e9e880d00af1a53","__v":16,"createdAt":"2015-10-30T22:15:28.105Z","releaseDate":"2015-10-30T22:15:28.105Z","categories":["5633ec007e9e880d00af1a57","5633f072737ea01700ea329d","5637a37d0704070d00f06cf4","5637cf4e7ca5de0d00286aeb","564503082c74cf1900da48b4","564503cb7f1fff210078e70a","567af26cb56bac0d0019d87d","567afeb8802b2b17005ddea0","567aff47802b2b17005ddea1","567b0005802b2b17005ddea3","568adfffcbd4ca0d00aebf7e","56ba80078cf7c9210009673e","574d127f6f075519007da3d0","574fde60aef76a0e00840927","57a22ba6cd51b22d00f623a0","5a062c15a66ae1001a3f5b09"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"1.0.0","version":"1.0"},"updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-01-27T02:26:47.237Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":3,"body":"With Logstash playing such a prominent role in the Elastic suite, we are commonly asked whether we offer support for it. The answer is a qualified \"yes.\" We need to qualify the answer because technically Logstash is a client-side tool and we're not opinionated about where your data comes from.\n\nIn simpler terms, we don't play a role in logging because we don't have access to your logs. Basically, you run Logstash somewhere, and configure it to pass its output stream to your Bonsai cluster. [Incidentally, we support Kibana 4 in the same way](doc:using-kibana-with-bonsai).\n\nConnecting your Logstash instance to a Bonsai cluster is as easy as adding an output to the Logstash configuration file like so:\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"output {\\n    elasticsearch {\\n        # Bonsai URL: https://user123:pass456:::at:::logstash-12345.us-east-1.bonsai.io\\n        # would be entered as:\\n        hosts     => [\\\"logstash-12345.us-east-1.bonsai.io:443\\\"]\\n        user      => \\\"user123\\\"\\n        password  => \\\"pass456\\\"\\n        ssl       => true\\n        index     => \\\"<whatever your logstash index will be named>\\\"\\n    }\\n}\",\n      \"language\": \"text\"\n    }\n  ]\n}\n[/block]\nWe have made a number of tests and verified that we are fully compatible with Logstash, as of version 1.5+. Older versions of Logstash don't have support for SSL/TLS or HTTP Basic Auth; older versions _can_ work with Bonsai, but only without the benefits of encryption or authentication.\n\nIf you have any issues getting Logstash to pass data along to Bonsai, [check the documentation](https://www.elastic.co/guide/en/logstash/current/configuration.html) to make sure it's set up correctly. If that doesn't help, feel free to reach out to us at [support@bonsai.io ](mailto:support@bonsai.io) and we'll do our best to get you pointed in the right direction.","excerpt":"","slug":"using-logstash-with-bonsai","type":"basic","title":"Using Logstash with Bonsai"}

Using Logstash with Bonsai


With Logstash playing such a prominent role in the Elastic suite, we are commonly asked whether we offer support for it. The answer is a qualified "yes." We need to qualify the answer because technically Logstash is a client-side tool and we're not opinionated about where your data comes from. In simpler terms, we don't play a role in logging because we don't have access to your logs. Basically, you run Logstash somewhere, and configure it to pass its output stream to your Bonsai cluster. [Incidentally, we support Kibana 4 in the same way](doc:using-kibana-with-bonsai). Connecting your Logstash instance to a Bonsai cluster is as easy as adding an output to the Logstash configuration file like so: [block:code] { "codes": [ { "code": "output {\n elasticsearch {\n # Bonsai URL: https://user123:pass456@logstash-12345.us-east-1.bonsai.io\n # would be entered as:\n hosts => [\"logstash-12345.us-east-1.bonsai.io:443\"]\n user => \"user123\"\n password => \"pass456\"\n ssl => true\n index => \"<whatever your logstash index will be named>\"\n }\n}", "language": "text" } ] } [/block] We have made a number of tests and verified that we are fully compatible with Logstash, as of version 1.5+. Older versions of Logstash don't have support for SSL/TLS or HTTP Basic Auth; older versions _can_ work with Bonsai, but only without the benefits of encryption or authentication. If you have any issues getting Logstash to pass data along to Bonsai, [check the documentation](https://www.elastic.co/guide/en/logstash/current/configuration.html) to make sure it's set up correctly. If that doesn't help, feel free to reach out to us at [support@bonsai.io ](mailto:support@bonsai.io) and we'll do our best to get you pointed in the right direction.