Skip to content

Commit 99a4619

Browse files
authored
Doc: Prefix creates temp files (#233)
Doc: Performance implications of interpolated strings in prefixes Co-authored-by: Rob Bavey <[email protected]> Bump to v.4.3.4
1 parent f0a7470 commit 99a4619

File tree

3 files changed

+13
-5
lines changed

3 files changed

+13
-5
lines changed

CHANGELOG.md

+4-1
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,8 @@
1+
## 4.3.4
2+
- [DOC] Added note about performance implications of interpolated strings in prefixes [#233](https://github.com/logstash-plugins/logstash-output-s3/pull/233)
3+
14
## 4.3.3
2-
- [DOC] Update links to use shared attributes [#230](https://github.com/logstash-plugins/logstash-output-s3/pull/230)
5+
- [DOC] Updated links to use shared attributes [#230](https://github.com/logstash-plugins/logstash-output-s3/pull/230)
36

47
## 4.3.2
58
- [DOC] Added note that only AWS S3 is supported. No other S3 compatible storage solutions are supported. [#223](https://github.com/logstash-plugins/logstash-output-s3/pull/223)

docs/index.asciidoc

+8-3
Original file line numberDiff line numberDiff line change
@@ -217,13 +217,18 @@ The endpoint should be an HTTP or HTTPS URL, e.g. https://example.com
217217
* Value type is <<string,string>>
218218
* Default value is `""`
219219

220-
Specify a prefix to the uploaded filename, this can simulate directories on S3.
220+
Specify a prefix to the uploaded filename to simulate directories on S3.
221221
Prefix does not require leading slash.
222222
This option supports
223223
{logstash-ref}/event-dependent-configuration.html#sprintf[Logstash
224-
interpolation]; for example, files can be prefixed with the event date using
224+
interpolation]. For example, files can be prefixed with the event date using
225225
`prefix = "%{+YYYY}/%{+MM}/%{+dd}"`.
226-
Be warned this can create a lot of temporary local files.
226+
227+
IMPORTANT: Take care when you are using interpolated strings in prefixes. This
228+
has the potential to create large numbers of unique prefixes, causing large
229+
numbers of in-progress uploads. This scenario may result in performance and
230+
stability issues, which can be further exacerbated when you use a
231+
rotation_strategy that delays uploads.
227232

228233
[id="plugins-{type}s-{plugin}-proxy_uri"]
229234
===== `proxy_uri`

logstash-output-s3.gemspec

+1-1
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
Gem::Specification.new do |s|
22
s.name = 'logstash-output-s3'
3-
s.version = '4.3.3'
3+
s.version = '4.3.4'
44
s.licenses = ['Apache-2.0']
55
s.summary = "Sends Logstash events to the Amazon Simple Storage Service"
66
s.description = "This gem is a Logstash plugin required to be installed on top of the Logstash core pipeline using $LS_HOME/bin/logstash-plugin install gemname. This gem is not a stand-alone program"

0 commit comments

Comments
 (0)