Skip to content

Commit f49b23b

Browse files
committed
fix docs
1 parent eebce5d commit f49b23b

8 files changed

Lines changed: 20 additions & 27 deletions

File tree

src/common/http/server_auth.rs

Lines changed: 1 addition & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -56,10 +56,8 @@ pub enum HttpServerAuthConfig {
5656
/// Custom authentication using VRL code.
5757
///
5858
/// Takes in request and validates it using VRL code. The VRL program must return a boolean.
59-
/// Metadata fields written via `%field = value` in the VRL program are extracted and injected
60-
/// into the log's body if log namespacing is enabled.
6159
Custom {
62-
/// The VRL boolean expression. May write `%field = value` to enrich events.
60+
/// The VRL boolean expression.
6361
source: String,
6462
},
6563
}

src/sources/http_server.rs

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -117,6 +117,11 @@ pub struct SimpleHttpConfig {
117117
#[configurable(metadata(docs::examples = "*"))]
118118
query_parameters: Vec<String>,
119119

120+
/// HTTP authentication configuration.
121+
///
122+
/// When using the `custom` strategy, the VRL program may write `%field = value` to enrich
123+
/// authenticated events. These metadata fields are injected into the event body (legacy
124+
/// namespace) or under `http_server.<field>` in event metadata (Vector namespace).
120125
#[configurable(derived)]
121126
auth: Option<HttpServerAuthConfig>,
122127

website/cue/reference/components/sinks/generated/websocket_server.cue

Lines changed: 1 addition & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -52,7 +52,7 @@ generated: components: sinks: websocket_server: configuration: {
5252
type: string: examples: ["${PASSWORD}", "password"]
5353
}
5454
source: {
55-
description: "The VRL boolean expression. May write `%field = value` to enrich events."
55+
description: "The VRL boolean expression."
5656
relevant_when: "strategy = \"custom\""
5757
required: true
5858
type: string: {}
@@ -72,8 +72,6 @@ generated: components: sinks: websocket_server: configuration: {
7272
Custom authentication using VRL code.
7373
7474
Takes in request and validates it using VRL code. The VRL program must return a boolean.
75-
Metadata fields written via `%field = value` in the VRL program are extracted and injected
76-
into the log's body if log namespacing is enabled.
7775
"""
7876
}
7977
}

website/cue/reference/components/sources/generated/heroku_logs.cue

Lines changed: 1 addition & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -43,7 +43,7 @@ generated: components: sources: heroku_logs: configuration: {
4343
type: string: examples: ["${PASSWORD}", "password"]
4444
}
4545
source: {
46-
description: "The VRL boolean expression. May write `%field = value` to enrich events."
46+
description: "The VRL boolean expression."
4747
relevant_when: "strategy = \"custom\""
4848
required: true
4949
type: string: {}
@@ -63,8 +63,6 @@ generated: components: sources: heroku_logs: configuration: {
6363
Custom authentication using VRL code.
6464
6565
Takes in request and validates it using VRL code. The VRL program must return a boolean.
66-
Metadata fields written via `%field = value` in the VRL program are extracted and injected
67-
into the log's body if log namespacing is enabled.
6866
"""
6967
}
7068
}

website/cue/reference/components/sources/generated/http.cue

Lines changed: 5 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -33,10 +33,11 @@ generated: components: sources: http: configuration: {
3333
}
3434
auth: {
3535
description: """
36-
Configuration of the authentication strategy for server mode sinks and sources.
36+
HTTP authentication configuration.
3737
38-
Use the HTTP authentication with HTTPS only. The authentication credentials are passed as an
39-
HTTP header without any additional encryption beyond what is provided by the transport itself.
38+
When using the `custom` strategy, the VRL program may write `%field = value` to enrich
39+
authenticated events. These metadata fields are injected into the event body (legacy
40+
namespace) or under `http_server.<field>` in event metadata (Vector namespace).
4041
"""
4142
required: false
4243
type: object: options: {
@@ -47,7 +48,7 @@ generated: components: sources: http: configuration: {
4748
type: string: examples: ["${PASSWORD}", "password"]
4849
}
4950
source: {
50-
description: "The VRL boolean expression. May write `%field = value` to enrich events."
51+
description: "The VRL boolean expression."
5152
relevant_when: "strategy = \"custom\""
5253
required: true
5354
type: string: {}
@@ -67,8 +68,6 @@ generated: components: sources: http: configuration: {
6768
Custom authentication using VRL code.
6869
6970
Takes in request and validates it using VRL code. The VRL program must return a boolean.
70-
Metadata fields written via `%field = value` in the VRL program are extracted and injected
71-
into the log's body if log namespacing is enabled.
7271
"""
7372
}
7473
}

website/cue/reference/components/sources/generated/http_server.cue

Lines changed: 5 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -33,10 +33,11 @@ generated: components: sources: http_server: configuration: {
3333
}
3434
auth: {
3535
description: """
36-
Configuration of the authentication strategy for server mode sinks and sources.
36+
HTTP authentication configuration.
3737
38-
Use the HTTP authentication with HTTPS only. The authentication credentials are passed as an
39-
HTTP header without any additional encryption beyond what is provided by the transport itself.
38+
When using the `custom` strategy, the VRL program may write `%field = value` to enrich
39+
authenticated events. These metadata fields are injected into the event body (legacy
40+
namespace) or under `http_server.<field>` in event metadata (Vector namespace).
4041
"""
4142
required: false
4243
type: object: options: {
@@ -47,7 +48,7 @@ generated: components: sources: http_server: configuration: {
4748
type: string: examples: ["${PASSWORD}", "password"]
4849
}
4950
source: {
50-
description: "The VRL boolean expression. May write `%field = value` to enrich events."
51+
description: "The VRL boolean expression."
5152
relevant_when: "strategy = \"custom\""
5253
required: true
5354
type: string: {}
@@ -67,8 +68,6 @@ generated: components: sources: http_server: configuration: {
6768
Custom authentication using VRL code.
6869
6970
Takes in request and validates it using VRL code. The VRL program must return a boolean.
70-
Metadata fields written via `%field = value` in the VRL program are extracted and injected
71-
into the log's body if log namespacing is enabled.
7271
"""
7372
}
7473
}

website/cue/reference/components/sources/generated/prometheus_pushgateway.cue

Lines changed: 1 addition & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -57,7 +57,7 @@ generated: components: sources: prometheus_pushgateway: configuration: {
5757
type: string: examples: ["${PASSWORD}", "password"]
5858
}
5959
source: {
60-
description: "The VRL boolean expression. May write `%field = value` to enrich events."
60+
description: "The VRL boolean expression."
6161
relevant_when: "strategy = \"custom\""
6262
required: true
6363
type: string: {}
@@ -77,8 +77,6 @@ generated: components: sources: prometheus_pushgateway: configuration: {
7777
Custom authentication using VRL code.
7878
7979
Takes in request and validates it using VRL code. The VRL program must return a boolean.
80-
Metadata fields written via `%field = value` in the VRL program are extracted and injected
81-
into the log's body if log namespacing is enabled.
8280
"""
8381
}
8482
}

website/cue/reference/components/sources/generated/prometheus_remote_write.cue

Lines changed: 1 addition & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -47,7 +47,7 @@ generated: components: sources: prometheus_remote_write: configuration: {
4747
type: string: examples: ["${PASSWORD}", "password"]
4848
}
4949
source: {
50-
description: "The VRL boolean expression. May write `%field = value` to enrich events."
50+
description: "The VRL boolean expression."
5151
relevant_when: "strategy = \"custom\""
5252
required: true
5353
type: string: {}
@@ -67,8 +67,6 @@ generated: components: sources: prometheus_remote_write: configuration: {
6767
Custom authentication using VRL code.
6868
6969
Takes in request and validates it using VRL code. The VRL program must return a boolean.
70-
Metadata fields written via `%field = value` in the VRL program are extracted and injected
71-
into the log's body if log namespacing is enabled.
7270
"""
7371
}
7472
}

0 commit comments

Comments
 (0)