Fluentd 存取日誌 (proto)

extensions.access_loggers.fluentd.v3.FluentdAccessLogConfig

[extensions.access_loggers.fluentd.v3.FluentdAccessLogConfig proto]

用於 envoy.access_loggers.fluentd AccessLog 的組態。此存取日誌擴充功能會透過 TCP 連線將發出的存取日誌傳送到接受 Fluentd Forward Protocol 的上游，如 Fluentd Forward Protocol Specification 中所述。

此擴充功能的限定名稱為 envoy.access_loggers.fluentd

注意

此擴充功能是可用的，但尚未經過大量的生產環境驗證，請謹慎使用。

此擴充功能旨在針對不受信任的下游流量保持強健。它假設上游是受信任的。

提示

此擴充功能擴展自以下擴充功能類別，並且可以與之一起使用

此擴充功能必須使用以下類型 URL 之一進行組態

{
  "cluster": ...,
  "tag": ...,
  "stat_prefix": ...,
  "buffer_flush_interval": {...},
  "buffer_size_bytes": {...},
  "record": {...},
  "retry_options": {...},
  "formatters": []
}
cluster

(字串，必填) 用於串流 Fluentd 訊息的連線之上游叢集。

tag

(字串，必填) 標籤是用 '.' 分隔的字串 (例如 log.type) 用於分類事件。請參閱： https://github.com/fluent/fluentd/wiki/Forward-Protocol-Specification-v1#message-modes

stat_prefix

(字串，必填) 發出統計資訊時要使用的前綴。

buffer_flush_interval

(Duration) 將存取日誌刷新到 TCP 流的時間間隔。記錄器會在每次經過此間隔或達到批次大小限制時，先發生者為準，刷新請求。預設為 1 秒。

buffer_size_bytes

(UInt32Value) 存取日誌項目緩衝區的軟大小限制 (以位元組為單位)。記錄器會緩衝請求，直到達到此限制，或每次經過刷新間隔時 (先發生者為準)。當達到緩衝區限制時，記錄器會立即刷新緩衝區內容。將其設定為零會有效地停用批次處理。預設為 16384。

record

(Struct, 必填) 代表每個日誌項目發送的記錄的結構。https://github.com/fluent/fluentd/wiki/Forward-Protocol-Specification-v1#entry 值會以字串、數字或布林值形式呈現。巢狀 JSON 物件可能會由某些命令運算子產生 (例如 FILTER_STATE 或 DYNAMIC_METADATA)。請參閱 格式字串 文件，以了解特定命令運算子的詳細資訊。

record:
  status: "%RESPONSE_CODE%"
  message: "%LOCAL_REPLY_BODY%"

將會建立以下 msgpack 記錄

{
  "status": 500,
  "message": "My error message"
}
retry_options

(extensions.access_loggers.fluentd.v3.FluentdAccessLogConfig.RetryOptions) 可選的重試選項，以防上游連線失敗。如果未設定此欄位，則將套用預設值，如RetryOptions 組態中所指定。

formatters

(重複 config.core.v3.TypedExtensionConfig) 指定可從存取日誌組態中呼叫的格式器外掛程式集合。請參閱格式器擴充功能文件以了解詳細資訊。

提示

此擴充功能類別具有以下已知的擴充功能

extensions.access_loggers.fluentd.v3.FluentdAccessLogConfig.RetryOptions

[extensions.access_loggers.fluentd.v3.FluentdAccessLogConfig.RetryOptions proto]

{
  "max_connect_attempts": {...},
  "backoff_options": {...}
}
max_connect_attempts

(UInt32Value) 記錄器在重新連線期間嘗試連線到上游的次數。預設情況下，沒有限制。每次連線到上游失敗或由於任何原因關閉上游連線時，記錄器都會嘗試重新連線到上游。

backoff_options

(config.core.v3.BackoffStrategy) 設定退避策略。如果未設定此值，則預設基本退避間隔為 500 毫秒，預設最大退避間隔為 5 秒 (基本間隔的 10 倍)。