sources: started to add the missing common source options

Signed-off-by: Hofi <[email protected]>

Author: HofiOne

_includes/doc/admin-guide/options/chain-hostname.md

@@ -0,0 +1,6 @@
+## chain-hostname()
+
+|   Type:|       `yes`, `no`|
+|Default:|              `no`|
+
+*Description:* This option can be used to enable or disable the chained hostname format. For more information, see the chain-hostnames() global option.

_includes/doc/admin-guide/options/default-priority.md

@@ -1,8 +1,15 @@
+## default-level()
+
+This is just an alias of default-priority().
+
 ## default-priority()
 
 | Type:|  priority string |
 |  Default: | {{ page.priority_default | default: '' }} |
 
-*Description:* This parameter assigns an emergency level to the messages
-received from the {{ page.src | default: 'file' }} source if the message does not specify one. For
-example, default-priority(warning).
+*Description:* This option defines the default level value if the `PRIORITY` entry does not exist in the msg received from the {{ page.src | default: 'file' }} source.
+For example, `default-priority(warning)`.
+
+## default-severity()
+
+This is just an alias of default-priority().

_includes/doc/admin-guide/options/dns-cache.md

@@ -0,0 +1,6 @@
+## dns-cache()
+
+|   Type:|       `yes`, `no`|
+|Default:|              `no`|
+
+*Description:* This option enables or disables the DNS cache usage.

doc/_admin-guide/060_Sources/020_File/README.md

@@ -48,6 +48,6 @@ source s_tail {
 
 **NOTE:** If the message does not have a proper syslog header, syslog-ng
 treats messages received from files as sent by the kern facility. Use
-the **default-facility()** and **default-priority()** options in the
+the default-facility() and default-priority() options in the
 source definition to assign a different facility if needed.
 {: .notice--info}

doc/_admin-guide/060_Sources/021_Wildcard-file/README.md

@@ -50,7 +50,7 @@ Note the following important points:
 
 - If the message does not have a proper syslog header, {{ site.product.short_name }}
     treats messages received from files as sent by the user facility.
-    Use the **default-facility()** and **default-priority()** options in
+    Use the default-facility() and default-priority() options in
     the source definition to assign a different facility if needed.
 
 - For every message that {{ site.product.short_name }} reads from the source files,

doc/_admin-guide/060_Sources/038_Kafka/001_Kafka_options.md

@@ -1,6 +1,7 @@
 ---
 title: "Options of the kafka() source"
 id: adm-src-kafka-opt
+src: kafka
 description: >-
     This section describes the options of the kafka() source in {{ site.product.short_name }}.
 ---
@@ -13,18 +14,32 @@ To use the kafka() source, the following two options are required: bootstrap-ser
 
 {% include doc/admin-guide/options/bootstrap-servers.md %}
 
+{% include doc/admin-guide/options/chain-hostname.md %}
+
 {% include doc/admin-guide/options/config-kafka.md kafka_type='consumer' type='source' protected_options='`bootstrap.servers` `metadata.broker.list` `enable.auto.offset.store` `auto.offset.reset` `enable.auto.commit` `auto.commit.enable`' %}
 
+{% include doc/admin-guide/options/default-facility.md %}
+
+{% include doc/admin-guide/options/default-priority.md %}
+
 {% include doc/admin-guide/options/disable-bookmarks.md %}
 See Bookmarking in the kafka() source for more details.
 
+{% include doc/admin-guide/options/dns-cache.md %}
+
 {% include doc/admin-guide/options/hook.md %}
 
+{% include doc/admin-guide/options/host-override.md %}
+
 {% include doc/admin-guide/options/ignore-saved-bookmarks.md %} (depending on the setting of the read-old-records() option.\
 See Bookmarking in the kafka() source for more details.
 
 {% include doc/admin-guide/options/kafka-logging.md %}
 
+{% include doc/admin-guide/options/keep-hostname.md %}
+
+{% include doc/admin-guide/options/keep-timestamp.md %}
+
 ## log-fetch-limit()
 
 |  Type: | integer |
@@ -72,6 +87,8 @@ For example, with `workers(3)` and `fetch-limit(100000)`, the 2 processor worker
 {% include doc/admin-guide/options/read-old-records.md %}\
 See Bookmarking in the kafka() source for more details.
 
+{% include doc/admin-guide/options/program-override.md %}
+
 ## separated-worker-queues()
 
 |  Type: | yes \| no |
@@ -82,6 +99,13 @@ See Bookmarking in the kafka() source for more details.
 **NOTE:** This approach can improve performance, especially in high-throughput scenarios, but may also lead to significantly increased memory usage.
 {: .notice--info}
 
+## state-update-timeout()
+
+|  Type: | integer in milliseconds |
+|Default:| 1000 |
+
+*Description:* Specifies the maximum amount of time {{ site.product.short_name }} waits during Kafka broker state queries or other requests, such as metadata queries, partition offset queries/seeking, etc.
+
 ## strategy-hint()
 
 | Accepted values: | assign, subscribe |
@@ -93,6 +117,10 @@ Why is it worth using dual consumer strategies? describes the differences betwee
 
 For details about how the resulting topic names, partitions, and Kafka assign/subscribe strategies are determined in different scenarios, see Basic startegy usage cross-reference of the different topic configuration cases
 
+{% include doc/admin-guide/options/tags.md %}
+
+{% include doc/admin-guide/options/time-zone.md %}
+
 ## time-reopen()
 
 |  Type: | integer in seconds |
@@ -130,6 +158,10 @@ The partition number must be:
 
 For details about how the resulting topic names, partitions, and Kafka assign/subscribe strategies are determined in different scenarios, see Basic startegy usage cross-reference of the different topic configuration cases and Why is it worth using dual consumer strategies?
 
+{% include doc/admin-guide/options/use-dns.md %}
+
+{% include doc/admin-guide/options/use-fqdn.md %}
+
 ## workers()
 
 |  Type: | integer |

doc/_admin-guide/060_Sources/085_macOS/000_darwin_oslog_options.md

@@ -10,15 +10,23 @@ description: >-
 
 The `darwin-oslog()` source has the following options.
 
+{% include doc/admin-guide/options/chain-hostname.md %}
+
+{% include doc/admin-guide/options/default-facility.md %}
+
+{% include doc/admin-guide/options/default-priority.md %}
+
+{% include doc/admin-guide/options/disable-bookmarks.md %}
+
+{% include doc/admin-guide/options/dns-cache.md %}
+
 ## filter-predicate()
 
 |Type:|     string|
 |Default:|`(eventType == 'logEvent' || eventType == 'lossEvent' || eventType == 'stateEvent' || eventType == 'userActionEvent') && (logType != 'debug')`|
 
 *Description:* String for native macOS log message filtering using predicates. For example, the following predicate selects AirDrop logs: `subsystem=="com.apple.sharing" and category=="AirDrop"`
 
-{% include doc/admin-guide/options/disable-bookmarks.md %}
-
 ## go-reverse()
 
 |Type:|     boolean|
@@ -28,10 +36,18 @@ The `darwin-oslog()` source has the following options.
 
 {% include doc/admin-guide/options/hook.md %}
 
+{% include doc/admin-guide/options/host-override.md %}
+
+{% include doc/admin-guide/options/hook.md %}
+
 {% include doc/admin-guide/options/ignore-saved-bookmarks.md %} (depending on the setting of the go-reverse() and the read-old-records() options.
 
 {% include doc/admin-guide/options/deprecated-options.md old='do-not-use-bookmark()' new='ignore-saved-bookmarks()' %}
 
+{% include doc/admin-guide/options/keep-hostname.md %}
+
+{% include doc/admin-guide/options/keep-timestamp.md %}
+
 {% include doc/admin-guide/options/log-fetch-delays.md %}
 
 {% include doc/admin-guide/options/log-fetch-limit.md %}
@@ -43,4 +59,15 @@ The `darwin-oslog()` source has the following options.
 
 *Description:* The maximum distance in seconds that a bookmark can point backward. That is, if {{ site.product.short_name }} is stopped for 10 minutes (600 seconds) and `max-bookmark-distance()` is set to `60`, then {{ site.product.short_name }} starts reading the logs from 60 seconds before the startup, missing 9 minutes (540 seconds) worth of logs.
 
+{% include doc/admin-guide/options/program-override.md %}
+
 {% include doc/admin-guide/options/read-old-records.md %}
+
+{% include doc/admin-guide/options/tags.md %}
+
+{% include doc/admin-guide/options/time-zone.md %}
+
+{% include doc/admin-guide/options/use-dns.md %}
+
+{% include doc/admin-guide/options/use-fqdn.md %}
+

doc/_admin-guide/060_Sources/175_syslog-otlp/000_otlp_source_options.md

@@ -1,6 +1,8 @@
 ---
 title: syslog-ng-otlp() source options
 id: adm-src-sng-otlp-opt
+src: syslog-ng-otlp
+priority_default: notice 
 description: >-
     This section describes the options of the syslog-ng-otlp() source in {{ site.product.short_name }}.
 ---
@@ -66,12 +68,7 @@ destination {
   };
 ```
 
-## chain-hostname()
-
-|   Type:|       `yes`, `no`|
-|Default:|              `no`|
-
-*Description:* This option can be used to enable or disable the chained hostname format. For more information, see the chain-hostnames() global option.
+{% include doc/admin-guide/options/chain-hostname.md %}
 
 {% include doc/admin-guide/options/channel-args.md %}
 
@@ -82,28 +79,11 @@ destination {
 
 *Description:* This option configures the upper limit of in-flight gRPC requests per worker. It is advisd to set this value in the range of 10s or 100s when there are a high number of clients sending simultaneously. In an optimized solution, the number of `workers()` and `concurrent-requests()` is greater than or equal to the number of clients. However, this can cause an increase in memory usage.
 
-## default-facility()
-
-|   Type:|       facility string|
-|Default:|                  kern|
-
-*Description:* This option assigns a facility value to messages received from the file source if the message does not specify one.
-
-## default-level()
-
-|   Type:|       string|
-|Default:|       notice|
-
-*Description:* This option defines the default level value if the `PRIORITY` entry does not exist.
+{% include doc/admin-guide/options/default-facility.md %}
 
 {% include doc/admin-guide/options/default-priority.md %}
 
-## dns-cache()
-
-|   Type:|       `yes`, `no`|
-|Default:|              `no`|
-
-*Description:* This option enables or disables the DNS cache usage.
+{% include doc/admin-guide/options/dns-cache.md %}
 
 ## ebpf()
 

doc/_admin-guide/060_Sources/190_systemd-journal/000_systemd-journal_options.md

@@ -14,14 +14,6 @@ The systemd-journal() driver has the following options:
 
 {% include doc/admin-guide/options/default-priority.md %}
 
-## default-level()
-
-|Type:      |string|
-|Default:   |notice|
-
-*Description:* The default level value if the `PRIORITY` entry does not
-exist.
-
 {% include doc/admin-guide/options/hook.md %}
 
 {% include doc/admin-guide/options/host-override.md %}