Skip to content

Commit 8e2474c

Browse files
committed
Sync generated docs
1 parent 73a3795 commit 8e2474c

File tree

8 files changed

+285
-1
lines changed

8 files changed

+285
-1
lines changed
Lines changed: 118 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,118 @@
1+
## AxoSyslog
2+
3+
AxoSyslog is the Schema for the AxoSyslogs API.
4+
5+
Available in Logging operator version 5.4 and later.
6+
7+
### (metav1.TypeMeta, required) {#axosyslog-}
8+
9+
10+
### metadata (metav1.ObjectMeta, optional) {#axosyslog-metadata}
11+
12+
13+
### spec (AxoSyslogSpec, optional) {#axosyslog-spec}
14+
15+
16+
### status (AxoSyslogStatus, optional) {#axosyslog-status}
17+
18+
19+
20+
## AxoSyslogSpec
21+
22+
AxoSyslogSpec defines the desired state of AxoSyslog
23+
24+
### destinations ([]Destination, optional) {#axosyslogspec-destinations}
25+
26+
Destinations is a list of destinations to be rendered in the AxoSyslog configuration
27+
28+
29+
### logPaths ([]LogPath, optional) {#axosyslogspec-logpaths}
30+
31+
LogPaths is a list of log paths to be rendered in the AxoSyslog configuration
32+
33+
34+
35+
## LogPath
36+
37+
LogPath defines a single log path that will be rendered in the AxoSyslog configuration
38+
39+
### destination (string, optional) {#logpath-destination}
40+
41+
name of a destination to be used in the log path
42+
43+
44+
### filterx (string, optional) {#logpath-filterx}
45+
46+
filterx block to be rendered within the log path
47+
48+
49+
50+
## Destination
51+
52+
Destination defines a single destination that will be rendered in the AxoSyslog configuration
53+
54+
### config (string, optional) {#destination-config}
55+
56+
Config is the configuration for the destination
57+
58+
59+
### name (string, optional) {#destination-name}
60+
61+
Name of the destination
62+
63+
64+
65+
## AxoSyslogStatus
66+
67+
AxoSyslogStatus defines the observed state of AxoSyslog
68+
69+
### problems ([]string, optional) {#axosyslogstatus-problems}
70+
71+
Problems with the AxoSyslog resource
72+
73+
74+
### problemsCount (int, optional) {#axosyslogstatus-problemscount}
75+
76+
Count of problems with the AxoSyslog resource
77+
78+
79+
### sources ([]Source, optional) {#axosyslogstatus-sources}
80+
81+
Sources configured for AxoSyslog
82+
83+
84+
85+
## Source
86+
87+
Source represents the source of logs for AxoSyslog
88+
89+
### otlp (*OTLPSource, optional) {#source-otlp}
90+
91+
OTLP specific configuration
92+
93+
94+
95+
## OTLPSource
96+
97+
OTLPSource contains configuration for OpenTelemetry Protocol sources
98+
99+
### endpoint (string, optional) {#otlpsource-endpoint}
100+
101+
Endpoint for the OTLP source
102+
103+
104+
105+
## AxoSyslogList
106+
107+
AxoSyslogList contains a list of AxoSyslog
108+
109+
### (metav1.TypeMeta, required) {#axosysloglist-}
110+
111+
112+
### metadata (metav1.ListMeta, optional) {#axosysloglist-metadata}
113+
114+
115+
### items ([]AxoSyslog, required) {#axosysloglist-items}
116+
117+
118+

content/docs/configuration/crds/v1beta1/fluentbit_types.md

Lines changed: 31 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -127,9 +127,16 @@ Disable Kubernetes metadata filter
127127
128128
### disableVarLibDockerContainers (*bool, optional) {#fluentbitspec-disablevarlibdockercontainers}
129129
130+
Available in Logging operator version 5.4 and later.
131+
130132
DisableVarLibDockerContainers controls whether the /var/lib/docker/containers volume is mounted. If true, the volume is NOT mounted. If false (default), the volume is mounted.
131133
132134
135+
### disableVarLog (*bool, optional) {#fluentbitspec-disablevarlog}
136+
137+
DisableVarLog controls whether the /var/log volume is mounted. If true, the volume is NOT mounted. If false (default), the volume is mounted.
138+
139+
133140
### enableUpstream (bool, optional) {#fluentbitspec-enableupstream}
134141
135142
@@ -675,6 +682,30 @@ Allow Kubernetes Pods to suggest a pre-defined Parser (read more about it in Kub
675682

676683
Default: Off
677684

685+
Important: When enabling this setting, you must also configure
686+
`inputTail.multiline.parser` with appropriate parsers (typically including `cri` for
687+
Container Runtime Interface logs). Without this configuration, the annotation-based
688+
parsing will not work correctly.
689+
690+
#### Example Configuration
691+
692+
```yaml
693+
apiVersion: logging.banzaicloud.io/v1beta1
694+
kind: FluentbitAgent
695+
metadata:
696+
name: example-fluentbit
697+
spec:
698+
inputTail:
699+
multiline.parser: [cri] # Required when K8S-Logging.Parser is enabled
700+
filterKubernetes:
701+
K8S-Logging.Parser: "On"
702+
Merge_Log_Key: "parsed" # Optional but recommended to prevent key conflicts
703+
704+
# Once configured, you can use annotations on your pods:
705+
annotations:
706+
fluentbit.io/parser: "my-custom-parser"
707+
```
708+
678709
### Keep_Log (string, optional) {#filterkubernetes-keep_log}
679710

680711
When Keep_Log is disabled, the log field is removed from the incoming message once it has been successfully merged (Merge_Log must be enabled as well).

content/docs/configuration/crds/v1beta1/output_types.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -47,6 +47,9 @@ OutputSpec defines the desired state of Output
4747
### kinesisStream (*output.KinesisStreamOutputConfig, optional) {#outputspec-kinesisstream}
4848

4949

50+
### lmLogs (*output.LMLogsOutputConfig, optional) {#outputspec-lmlogs}
51+
52+
5053
### logdna (*output.LogDNAOutput, optional) {#outputspec-logdna}
5154

5255

content/docs/configuration/plugins/outputs/elasticsearch.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -109,6 +109,12 @@ Specify an existing index template for the data stream. If not present, a new te
109109
110110
Default: data_stream_name
111111
112+
### data_stream_template_use_index_patterns_wildcard (*bool, optional) {#elasticsearch-data_stream_template_use_index_patterns_wildcard}
113+
114+
https://github.com/uken/fluent-plugin-elasticsearch?tab=readme-ov-file#data_stream_template_use_index_patterns_wildcard
115+
116+
Default: true
117+
112118
### default_elasticsearch_version (string, optional) {#elasticsearch-default_elasticsearch_version}
113119
114120
This parameter changes that ES plugin assumes default Elasticsearch version.

content/docs/configuration/plugins/outputs/forward.md

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -17,6 +17,11 @@ Default: 190
1717
[Buffer](../buffer/)
1818

1919

20+
### compress (string, optional) {#forwardoutput-compress}
21+
22+
Fluentd supports transparent data compression, the only value accepted is "gzip"
23+
24+
2025
### connect_timeout (int, optional) {#forwardoutput-connect_timeout}
2126

2227
The timeout time for socket connect. When the connection timed out during establishment, Errno::ETIMEDOUT is raised.
Lines changed: 115 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,115 @@
1+
---
2+
title: LogicMonitor Logs
3+
weight: 200
4+
generated_file: true
5+
---
6+
7+
# LogicMonitor Logs output plugin for Fluentd
8+
## Overview
9+
10+
LogicMonitor Logs output plugin for Fluentd
11+
12+
Sends log records to LogicMonitor Logs via the LM API.
13+
14+
For details, see [https://github.com/logicmonitor/lm-logs-fluentd](https://github.com/logicmonitor/lm-logs-fluentd).
15+
16+
## Example output configurations
17+
18+
```yaml
19+
spec:
20+
lmLogs:
21+
company_name: mycompany
22+
access_id:
23+
valueFrom:
24+
secretKeyRef:
25+
name: lm-credentials
26+
key: access_id
27+
access_key:
28+
valueFrom:
29+
secretKeyRef:
30+
name: lm-credentials
31+
key: access_key
32+
resource_mapping: '{"kubernetes.host": "system.hostname"}'
33+
flush_interval: 60s
34+
debug: false
35+
```
36+
37+
38+
## Configuration
39+
## LogicMonitorLogs
40+
41+
### access_id (*secret.Secret, optional) {#logicmonitorlogs-access_id}
42+
43+
LM API Token access ID [Secret](../secret/)
44+
45+
46+
### access_key (*secret.Secret, optional) {#logicmonitorlogs-access_key}
47+
48+
LM API Token access key [Secret](../secret/)
49+
50+
51+
### bearer_token (*secret.Secret, optional) {#logicmonitorlogs-bearer_token}
52+
53+
LM API Bearer Token. Either specify access_id and access_key both or bearer_token. If all specified, LMv1 token(access_id and access_key) will be used for authentication with LogicMonitor [Secret](../secret/)
54+
55+
56+
### buffer (*Buffer, optional) {#logicmonitorlogs-buffer}
57+
58+
[Buffer](../buffer/)
59+
60+
61+
### company_domain (string, optional) {#logicmonitorlogs-company_domain}
62+
63+
LogicMonitor account domain. For eg. for url test.logicmonitor.com, company_domain is logicmonitor.com (default: logicmonitor.com)
64+
65+
Default: logicmonitor.com
66+
67+
### company_name (string, required) {#logicmonitorlogs-company_name}
68+
69+
LogicMonitor account name
70+
71+
72+
### debug (*bool, optional) {#logicmonitorlogs-debug}
73+
74+
When true, logs more information to the fluentd console
75+
76+
77+
### device_less_logs (*bool, optional) {#logicmonitorlogs-device_less_logs}
78+
79+
When true, do not map log with any resource. record must have service when true
80+
81+
Default: false
82+
83+
### flush_interval (string, optional) {#logicmonitorlogs-flush_interval}
84+
85+
Defines the time in seconds to wait before sending batches of logs to LogicMonitor (default: 60s)
86+
87+
Default: 60s
88+
89+
### force_encoding (string, optional) {#logicmonitorlogs-force_encoding}
90+
91+
Specify charset when logs contains invalid utf-8 characters
92+
93+
94+
### format (*Format, optional) {#logicmonitorlogs-format}
95+
96+
[Format](../format/)
97+
98+
99+
### http_proxy (string, optional) {#logicmonitorlogs-http_proxy}
100+
101+
http proxy string eg. http://user:pass@proxy.server:port
102+
103+
104+
### include_metadata (*bool, optional) {#logicmonitorlogs-include_metadata}
105+
106+
When true, appends additional metadata to the log
107+
108+
Default: false
109+
110+
### resource_mapping (string, required) {#logicmonitorlogs-resource_mapping}
111+
112+
The mapping that defines the source of the log event to the LM resource. In this case, the <event_key> in the incoming event is mapped to the value of <lm_property>
113+
114+
115+

content/docs/configuration/plugins/outputs/vmware_loginsight.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -161,7 +161,7 @@ Default: json
161161

162162
### shorten_keys (map[string]string, optional) {#vmwareloginsight-shorten_keys}
163163

164-
Keys from log event to rewrite for instance from 'kubernetes_namespace' to 'k8s_namespace' tags will be rewritten with substring substitution and applied in the order present in the hash. Hashes enumerate their values in the order that the corresponding keys were inserted, see: https://ruby-doc.org/core-2.2.2/Hash.html
164+
Keys from log event to rewrite for instance from 'kubernetes_namespace' to 'k8s_namespace' tags will be rewritten with substring substitution and applied in the order present in the hash. Hashes enumerate their values in the order that the corresponding keys were inserted, see: https://ruby-doc.org/core-2.2.2/Hash.html
165165

166166
Default: { 'kubernetes_':'k8s_', 'namespace':'ns', 'labels_':'', '_name':'', '_hash':'', 'container_':'' }
167167

content/docs/configuration/plugins/syslog-ng-outputs/syslog.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -103,6 +103,12 @@ Specifies how many lines are flushed to a destination at a time. For details, se
103103
Address of the destination host
104104

105105

106+
### ip-protocol (*int, optional) {#syslogoutput-ip-protocol}
107+
108+
IP protocol
109+
110+
Default: 4
111+
106112
### persist_name (string, optional) {#syslogoutput-persist_name}
107113

108114
Unique name for the syslog-ng driver. If you receive the following error message during syslog-ng startup, set the `persist-name()` option of the duplicate drivers: `Error checking the uniqueness of the persist names, please override it with persist-name option. Shutting down.` See the [documentation of the AxoSyslog syslog-ng distribution](https://axoflow.com/docs/axosyslog-core/chapter-destinations/configuring-destinations-http-nonjava/reference-destination-http-nonjava/#persist-name) for more information.

0 commit comments

Comments
 (0)