logging.gdc.goog/v1
包含 Logging 群組的 API 結構定義。
AlertRule
定義快訊規則設定。
顯示位置： - LoggingRuleSpec
| 欄位 | 說明 |
|---|---|
alert 字串 |
快訊名稱。值必須是有效的標籤值。 |
expr 字串 |
用來評估快訊規則的 PromQL 或 LogQL 運算式。 |
for 字串 |
指定條件必須符合的時間長度 (以秒為單位)，警報才會從待處理狀態移至開啟狀態。 |
labels 物件 (鍵：字串，值：字串) |
要新增或覆寫的標籤。這個欄位的必要標籤為 severity: [error, critical, warning, info]、code: <short code for the error> 和 resource: <component, service, or hardware related to the alert>。其他標籤則可自由選擇提供。 |
annotations 物件 (鍵：字串，值：字串) |
要新增的註解。 |
LoggingRule
定義 Logging Rules API 的結構定義。
出現位置： - LoggingRuleList
| 欄位 | 說明 |
|---|---|
apiVersion 字串 |
logging.gdc.goog/v1 |
kind 字串 |
LoggingRule |
metadata ObjectMeta |
如需 metadata 的欄位，請參閱 Kubernetes API 說明文件。 |
spec LoggingRuleSpec |
|
status LoggingRuleStatus |
LoggingRuleList
包含記錄規則清單。
| 欄位 | 說明 |
|---|---|
apiVersion 字串 |
logging.gdc.goog/v1 |
kind 字串 |
LoggingRuleList |
metadata ListMeta |
如需 metadata 的欄位，請參閱 Kubernetes API 說明文件。 |
items LoggingRule 陣列 |
LoggingRuleSpec
定義 LoggingRule 物件的規格或預期狀態。
顯示於： - LoggingRule
| 欄位 | 說明 |
|---|---|
source 來源 |
要據以發出快訊的記錄來源。可接受的值為 operational 和 audit。 |
interval 字串 |
規則評估間隔。 |
limit 整數 |
警告數量上限。值為 0 表示沒有限制。 |
recordRules RecordRule 陣列 |
記錄規則清單。 |
alertRules AlertRule 陣列 |
快訊規則清單。 |
LoggingRuleStatus
定義 LoggingRule 物件的觀察狀態。
顯示於： - LoggingRule
| 欄位 | 說明 |
|---|---|
conditions Condition 陣列 |
記錄快訊堆疊中觀察到的條件清單。 |
lokiInstance 字串 |
目前安裝 LoggingRule 物件的 Loki 主機執行個體名稱。 |
LoggingTarget
定義作業記錄目標 API 的結構定義。
出現位置： - LoggingTargetList
| 欄位 | 說明 |
|---|---|
apiVersion 字串 |
logging.gdc.goog/v1 |
kind 字串 |
LoggingTarget |
metadata ObjectMeta |
如需 metadata 的欄位，請參閱 Kubernetes API 說明文件。 |
spec LoggingTargetSpec |
|
status LoggingTargetStatus |
LoggingTargetList
包含記錄目標清單。
| 欄位 | 說明 |
|---|---|
apiVersion 字串 |
logging.gdc.goog/v1 |
kind 字串 |
LoggingTargetList |
metadata ListMeta |
如需 metadata 的欄位，請參閱 Kubernetes API 說明文件。 |
items LoggingTarget 陣列 |
LoggingTargetSelectors
提供選取器，決定要從哪些 Pod 或容器收集記錄。
顯示於： - LoggingTargetSpec
| 欄位 | 說明 |
|---|---|
matchClusters 字串陣列 |
要從中收集記錄的叢集。預設設定是從所有叢集收集記錄。不同叢集之間的關係為 OR 關係。舉例來說，值 ["admin", "system"] 表示將管理員叢集 OR 視為系統叢集。 |
matchPodNames 字串陣列 |
要收集記錄的 Pod 名稱前置字元。可觀測性平台會擷取名稱開頭為指定前置字元的所有 Pod。值只能包含 [a-z0-9-] 個字元。不同清單元素之間的關係為 OR 關係。 |
matchContainerNames 字串陣列 |
要收集記錄的容器名稱前置字串。可觀測性平台會擷取名稱開頭為指定前置字串的所有容器。值只能包含 [a-z0-9-] 個字元。不同清單元素之間的關係為 OR 關係。 |
LoggingTargetSpec
定義 LoggingTarget 物件的規格或預期狀態。
顯示於： - LoggingTarget
| 欄位 | 說明 |
|---|---|
selector LoggingTargetSelectors |
比對模式，用於識別要從哪些 Pod 或容器收集記錄。不同選取器之間的關係為 AND 關係，因此系統會考量所有選取器。 |
logAccessLevel LogAccessLevel |
記錄檔項目的存取層級。應用程式運算子的預設值為 AO。 |
parser OperationalLogParser |
記錄項目的預先定義剖析器。 |
serviceName 字串 |
要套用為標籤的服務名稱。如果是使用者工作負載，您可以考慮將這個欄位做為工作負載名稱。 |
additionalFields 物件 (鍵：字串，值：字串) |
要套用至記錄項目的其他靜態欄位。這個欄位是鍵/值組合的對應，其中欄位名稱是鍵，欄位值是值。 |
LoggingTargetStatus
定義 LoggingTarget 物件的觀察狀態。
顯示於： - LoggingTarget
| 欄位 | 說明 |
|---|---|
conditions Condition 陣列 |
記錄堆疊中觀察到的條件清單。 |
RecordRule
定義記錄規則設定。
顯示位置： - LoggingRuleSpec
| 欄位 | 說明 |
|---|---|
record 字串 |
要寫入記錄規則的時間序列。必須是有效的指標名稱。 |
expr 字串 |
用於評估記錄規則的 PromQL 或 LogQL 運算式。 |
labels 物件 (鍵：字串，值：字串) |
要新增或覆寫的標籤。 |
SIEMOrgForwarder
定義 SIEMOrgForwarder API 的結構定義。
這個 API 會定義記錄類型 (稽核或作業)，以及要傳送記錄的外部 SIEM 目的地。
出現位置： - SIEMOrgForwarderList
| 欄位 | 說明 |
|---|---|
apiVersion 字串 |
logging.gdc.goog/v1 |
kind 字串 |
SIEMOrgForwarder |
metadata ObjectMeta |
如需 metadata 的欄位，請參閱 Kubernetes API 說明文件。 |
spec SIEMOrgForwarderSpec |
|
status SIEMOrgForwarderStatus |
SIEMOrgForwarderList
包含 SIEMOrgForwarder 物件清單。
| 欄位 | 說明 |
|---|---|
apiVersion 字串 |
logging.gdc.goog/v1 |
kind 字串 |
SIEMOrgForwarderList |
metadata ListMeta |
如需 metadata 的欄位，請參閱 Kubernetes API 說明文件。 |
items SIEMOrgForwarder 陣列 |
SIEMOrgForwarderSpec
定義 SIEMOrgForwarder 資源的規格或預期狀態。
出現位置： - SIEMOrgForwarder
| 欄位 | 說明 |
|---|---|
source LogType |
要匯出至 SIEM 目的地的記錄類型。可接受的值為 operational 和 audit。 |
splunkOutputs SplunkOutput 陣列 |
Splunk 輸出內容清單。 |
SIEMOrgForwarderStatus
定義 SIEMOrgForwarder 資源的觀察狀態。
出現位置： - SIEMOrgForwarder
| 欄位 | 說明 |
|---|---|
conditions Condition 陣列 |
SIEMOrgForwarder 資源的觀察狀態。 |
SplunkOutput
定義 Splunk 輸出設定。
出現位置： - SIEMOrgForwarderSpec
| 欄位 | 說明 |
|---|---|
host 字串 |
目標 Splunk 服務的主機名稱。 |
token 權杖 |
HTTP 事件收集器介面的驗證權杖。 |
tls 字串 |
傳輸層安全標準 (TLS) 通訊協定。詳情請參閱 https://docs.fluentbit.io/manual/administration/transport-security。 |
netConnectTimeout 整數 |
等待建立 TCP 連線的時間上限 (以秒為單位)。這個值包含 TLS 交握時間。 |
權杖
定義 SIEM 匯出作業的權杖設定。
顯示位置： - SplunkOutput
| 欄位 | 說明 |
|---|---|
name 字串 |
權杖名稱。 |
field 字串 |
權杖的欄位。 |