Skip to content

Commit d7c3735

Browse files
[Filebeat/Journald] Add note about the issues with using globs (#47494)
--------- Co-authored-by: Colleen McGinnis <[email protected]>
1 parent e991bf0 commit d7c3735

File tree

1 file changed

+24
-1
lines changed

1 file changed

+24
-1
lines changed

docs/reference/filebeat/filebeat-input-journald.md

Lines changed: 24 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -87,10 +87,33 @@ filebeat.inputs:
8787

8888
### `paths` [filebeat-input-journald-paths]
8989

90-
A list of paths that will be crawled and fetched. Each path can be a directory path (to collect events from all journals in a directory), or a file path. If you specify a directory, Filebeat merges all journals under the directory into a single journal and reads them.
90+
A list of paths that will be crawled and fetched. A path can be either:
91+
92+
* A file path
93+
* {applies_to}`stack: ga 9.1.5` {applies_to}`stack: ga 9.0.8` A directory path (to collect events from all journals in a directory). If you specify a directory, Filebeat merges all journals under the directory into a single journal and reads them.
9194

9295
If no paths are specified, Filebeat reads from the default journal.
9396

97+
For example, this configuration will ingest all journals and correctly handle the journald rotation:
98+
99+
```yaml
100+
- type: journald
101+
id: journald-id
102+
paths:
103+
- /var/log/journal
104+
```
105+
106+
107+
:::{warning}
108+
If a glob (for example, `/var/log/journal/*/*.journal`) is used, the journald
109+
input will only ingest the journal files found when started. New
110+
files will not be ingested.
111+
:::
112+
113+
114+
115+
116+
94117
### `merge` [filebeat-input-journald-merge]
95118
```{applies_to}
96119
stack: ga 9.2.0

0 commit comments

Comments
 (0)