Google Distributed Cloud (GDC) 實體隔離設備的記錄收集功能,可讓您匯總工作流程中的作業事件,以便監控及排解問題。在 Management API 伺服器中,將 LoggingTarget 自訂資源部署至專案命名空間,以便從服務元件提取、建立索引及標記記錄。
設定記錄收集功能後,您可以在 Grafana 使用者介面中查詢及查看記錄。如需檢測建議,請參閱 Kubernetes 記錄指南。
事前準備
如要取得管理 LoggingTarget 自訂資源所需的權限,請要求組織 IAM 管理員或專案 IAM 管理員授予您其中一個相關聯的 LoggingTarget 角色。
視所需的存取層級和權限而定,您可能會在組織或專案中取得這項資源的建立者、編輯者或檢視者角色。詳情請參閱「準備 IAM 權限」。
應用程式操作員:如要取得在管理 API 伺服器中管理專案內
LoggingTarget自訂資源所需的權限,請要求專案 IAM 管理員在專案命名空間中授予您下列其中一個角色:- LoggingTarget 建立者:建立
LoggingTarget自訂資源。要求 LoggingTarget 建立者 (loggingtarget-creator) 角色。 - LoggingTarget 編輯者:編輯或修改
LoggingTarget自訂資源。要求 LoggingTarget 編輯者 (loggingtarget-editor) 角色。 - LoggingTarget 檢視者:查看
LoggingTarget自訂資源。要求 LoggingTarget 檢視者 (loggingtarget-viewer) 角色。
- LoggingTarget 建立者:建立
平台管理員:如要取得管理管理 API 伺服器中
platform-obs命名空間內LoggingTarget自訂資源所需的權限,請要求組織 IAM 管理員在platform-obs命名空間中授予您下列其中一個叢集角色:- LoggingTarget PA Creator:建立
LoggingTarget自訂資源。要求 LoggingTarget PA Creator (loggingtarget-pa-creator) 叢集角色。 - LoggingTarget PA 編輯者:編輯或修改
LoggingTarget自訂資源。要求 LoggingTarget PA 編輯者 (loggingtarget-pa-editor) 叢集角色。 - LoggingTarget PA 檢視者:查看
LoggingTarget自訂資源。要求 LoggingTarget PA 檢視者 (loggingtarget-pa-viewer) 叢集角色。
- LoggingTarget PA Creator:建立
收集作業記錄
在 GDC 管理應用程式和服務的持續作業時,作業記錄會記錄條件、變更和動作。將 LoggingTarget 自訂資源部署至 Management API 伺服器,設定系統記錄管道,在專案層級收集特定服務的作業記錄。
如要收集服務的作業記錄,請完成下列步驟:
- 在 Management API 伺服器中設定
LoggingTarget自訂資源,指定要收集作業記錄的 Pod、專案命名空間和任何其他設定。如要瞭解LoggingTarget的格式,請參閱「設定LoggingTarget自訂資源」。 將
LoggingTarget自訂資源部署至 Management API 伺服器中的專案命名空間:kubectl --kubeconfig MANAGEMENT_API_SERVER apply -f LOGGING_TARGET_NAME更改下列內容:
MANAGEMENT_API_SERVER:可用區 Management API 伺服器的 kubeconfig 路徑。LOGGING_TARGET_NAME:LoggingTarget自訂資源的名稱,例如my-service-logging-target.yaml。
管道會開始從專案的其他元件收集記錄。
從專案的 Grafana 執行個體查詢記錄。詳情請參閱「查詢及查看記錄」。
使用 Grafana 內建的顏色編碼功能,區分服務的不同記錄層級。如要進一步瞭解如何設定記錄層級值,請參閱 https://grafana.com/docs/grafana/latest/explore/logs-integration/。
設定 LoggingTarget 自訂資源
LoggingTarget 自訂資源會指示記錄管道,從 GDC 專案中的特定服務收集記錄。您可以指定要收集記錄的目標、記錄剖析器、存取層級和任何其他設定。
這項資源定義了下列設定:
- 目標:選取要收集記錄檔的 Pod 和容器時,所依據的條件。您可以指定叢集名稱、Pod 名稱前置字元和容器名稱前置字元。
- 記錄分析器:預先定義的剖析器,用於解讀記錄項目、將記錄輸出內容對應至標籤,以及擷取相關欄位。
- 服務識別:套用至記錄項目的服務名稱標籤,方便識別及篩選。
授權:記錄項目的存取層級,控管誰可以查看收集到的記錄。
在 LoggingTarget 自訂資源中設定這些參數,即可精確控管服務記錄的收集和整理方式。
請按照下列步驟,收集服務的作業記錄:
- 決定要從哪個 GDC 專案收集記錄。
在
LoggingTarget設定中,指定要收集作業記錄的 Pod、專案命名空間,以及任何其他設定。下列 YAML 檔案顯示
my-project-namespace中LoggingTarget設定的範例,其中要收集記錄的 Pod 名稱前置字串為my-pod-prefix、記錄項目的存取層級授予應用程式運算子 (ao)、服務名稱為my-service-name,且記錄格式為 JSON:# Configures a log scraping job apiVersion: logging.gdc.goog/v1 kind: LoggingTarget metadata: # Choose a namespace that matches the namespace of the workload pods. namespace: my-project-namespace name: my-service-logging-target spec: selector: matchPodNames: - my-pod-prefix parser: json logAccessLevel: ao serviceName: my-service-name如需其他欄位和選項,請參閱完整的
LoggingTarget規格和 API 參考文件。將
LoggingTarget設定套用至 Management API 伺服器,該伺服器與目標 Pod 位於同一個命名空間:kubectl --kubeconfig KUBECONFIG_PATH apply -f LOGGING_TARGET_NAME.yaml更改下列內容:
KUBECONFIG_PATH:Management API 伺服器的 kubeconfig 檔案路徑。LOGGING_TARGET_NAME:LoggingTarget定義檔案的名稱,例如my-service-logging-target。
記錄管道會開始從專案的其他元件收集記錄。
您可以使用 Grafana 使用者介面或 Log Query API 查詢收集到的記錄。詳情請參閱「查詢及查看記錄」。
如果您使用 Grafana 查詢記錄,可以針對服務的不同記錄層級,使用內建的顏色編碼功能。如要進一步瞭解如何設定記錄層級值,請參閱 https://grafana.com/docs/grafana/latest/explore/logs-integration/。
完成LoggingTarget規格
下列 YAML 檔案是 LoggingTarget 自訂資源完整規格的範例。如需更多資訊和欄位的完整說明,請參閱 API 參考文件。
# Configures a log scraping job
apiVersion: logging.gdc.goog/v1
kind: LoggingTarget
metadata:
# Choose a namespace that matches the namespace of the workload pods.
namespace: PROJECT_NAMESPACE
name: LOGGING_TARGET_NAME
spec:
# Choose a matching pattern that identifies the pods for this job.
# Optional.
# Relationship between different selectors: 'AND'
selector:
# The clusters to collect logs from.
# The default configuration is to collect logs from all clusters.
# The relationship between different clusters is an 'OR' relationship.
# Optional
matchClusters:
- my-cluster
- another-cluster
# The pod name prefixes to collect logs from.
# The logging platform scrapes all pods with names
# that start with the specified prefixes.
# The values must contain '[a-z0-9-]' characters only.
# The relationship between different list elements is an 'OR' relationship.
# Optional.
matchPodNames:
- my-pod-prefix
- another-pod-prefix
# The container name prefixes to collect logs from.
# The logging platform scrapes all containers with names
# that start with the specified prefixes.
# The values must contain '[a-z0-9-]' characters only.
# The relationship between different list elements is an 'OR' relationship.
# Optional.
matchContainerNames:
- my-container-prefix
- another-container-prefix
# Choose the predefined parser for log entries.
# Use parsers to map the log output to labels and extract fields.
# Specify the log format.
# Optional.
# Options: klog_text, klog_json, klogr, gdch_json, json
parser: klog_text
# Specify an access level for log entries.
# The default value is 'ao'.
# Optional.
# Options: ao, pa, io
logAccessLevel: ao
# Specify a service name to be applied as a label.
# For user workloads consider this field as a workload name.
# Required.
serviceName: my-service-name
# The additional static fields to apply to log entries.
# The field is a key-value pair, where the field name is the key and
# the field value is the value.
# Optional.
additionalFields:
app: workload2
key: value
更改下列內容:
PROJECT_NAMESPACE:專案命名空間。LOGGING_TARGET_NAME:LoggingTarget定義檔案的名稱。