README.md in logstash-output-scalyr-0.1.6 vs README.md in logstash-output-scalyr-0.1.7
- old
+ new
@@ -8,11 +8,11 @@
You can view documentation for this plugin [on the Scalyr website](https://app.scalyr.com/solutions/logstash).
# Quick start
1. Build the gem, run `gem build logstash-output-scalyr.gemspec`
-2. Install the gem into a Logstash installation, run `/usr/share/logstash/bin/logstash-plugin install logstash-output-scalyr-0.1.6.gem` or follow the latest official instructions on working with plugins from Logstash.
+2. Install the gem into a Logstash installation, run `/usr/share/logstash/bin/logstash-plugin install logstash-output-scalyr-0.1.7.gem` or follow the latest official instructions on working with plugins from Logstash.
3. Configure the output plugin (e.g. add it to a pipeline .conf)
4. Restart Logstash
# Configuration
@@ -46,11 +46,11 @@
`config :api_write_token, :validate => :string, :required => true`
---
-- If your Scalyr backend is located in other geographies (such as Europe which would use `https://agent.eu.scalyr.com/`), you may need to modify this
+- If you have an EU-based Scalyr account, please use https://eu.scalyr.com/
`config :scalyr_server, :validate => :string, :default => "https://agent.scalyr.com/"`
---
@@ -156,11 +156,10 @@
---
# Conceptual Overview
-
## Persistence
Logstash itself supports [Persistent Queues](https://www.elastic.co/guide/en/logstash/current/persistent-queues.html) with at-least-once delivery semantics. It expects output plugins to retry uploads until success or else to write failures into a Dead-Letter Queue (DLQ). Since Logstash offers Persistent Queues, the Scalyr plugin does not perform its own buffering or persistence. More specifically, invocation of `multi_receive` is synchronously retried until success or written to the DLQ upon failure. Note: the `multi_receive` interface does not provide a feedback mechanism (outcome codes etc).
## Concurrency
@@ -309,9 +308,19 @@
```
sudo bundle exec rspec
```
in the root of the repo.
+
+By default this will run all the tests (including integration ones which require sudo access and
+may not pass everywhere).
+
+If you want to run just the unit tests, you can run the command displayed below.
+
+
+```bash
+bundle exec rspec spec/logstash/outputs/scalyr_spec.rb spec/scalyr/common/util_spec.rb
+```
# Releasing
## Updating version