Log4j Kubernetes 支持

Log4j 通过提供查找来检索容器信息来支持 Kubernetes。

Accessing Kubernetes

Log4j Kubernetes 支持需要访问 Docker REST 接口。在许多情况下，可以自动访问 REST 服务。如果需要，可以在任何标准 Log4j 配置位置或通过 Spring Boot 配置来配置 KubernetesClient 端。但是请注意，由于 Spring Boot 会导致日志记录初始化 3 次，并且由于 Spring 环境仅在上次 Log4j 初始化期间可用，因此 Spring 属性仅对上次初始化的 Log4j 可用。

Lookup Attributes

Log4j Kubernetes 提供对以下容器属性的访问：

• accountName-服务帐户名称。

• clusterName-运行应用程序的群集的名称。

• containerId-分配给容器的完整 ID。

• containerName-分配给容器的名称。

• host-主机名。

• hostIp-主机的 IP 地址。

• imageId-分配给图像的 ID。

• imageName-分配给图像的名称。

• 标签-在列表中格式化的所有标签。

• labels.app-应用程序名称。

• labels.podTemplateHash-窗格的模板哈希值。

• masterUrl-访问 API 服务器所需的 URL。

• namespaceId-各种 kubernetes 组件位于其中的名称空间的 ID。

• namespaceName-各种 kubernetes 组件位于其中的名称空间。

• podId-窗格的 ID 号。

• podIp-窗格的 IP 地址。

• podName-窗格的名称。

可以通过添加属性来访问属性

${k8s:containerId}

配置。请注意，kubernetes 变量在记录初始化期间仅解析一次，因此不应使用多个'$'字符来引用它们。

Configuration

Kubernetes 自动提供访问 Kubernetes API 服务器所需的许多配置。但是，通常需要提供访问 Kubernetes API 服务器或应用程序分配到的名称空间所需的 url。可以使用 Log4j 变量名配置以下属性，并通过 Log4j 的常规属性解析机制 mechansim 定位该属性，或者当应用程序在 Spring Boot 中运行并且创建了 Spring Environment 时，Log4j 将解析 spring 属性。请注意，Spring Boot 会初始化日志记录 3 次，只有最后一次会出现一个 Spring Environment。

Log4j 属性名称	SpringProperty 名称	Default	Description
log4j2.kubernetes.client.apiVersion	spring.cloud.kubernetes.client.apiVersion	v1	Kubernetes API 版本
log4j2.kubernetes.client.caCertData	spring.cloud.kubernetes.client.caCertData		Kubernetes API CACertData
log4j2.kubernetes.client.caCertFile	spring.cloud.kubernetes.client.caCertFile		Kubernetes API CACertFile
log4j2.kubernetes.client.clientCertData	spring.cloud.kubernetes.client.clientCertData		Kubernetes API ClientCertData
log4j2.kubernetes.client.clientCertFile	spring.cloud.kubernetes.client.clientCertFile		Kubernetes API ClientCertFile
log4j2.kubernetes.client.clientKeyAlgo	spring.cloud.kubernetes.client.clientKeyAlgo	RSA	Kubernetes API ClientKeyAlgo
log4j2.kubernetes.client.clientKeyData	spring.cloud.kubernetes.client.clientKeyData		Kubernetes API ClientKeyData
log4j2.kubernetes.client.clientKeyFile	spring.cloud.kubernetes.client.clientKeyFile		Kubernetes API ClientKeyFile
log4j2.kubernetes.client.clientKeyPassPhrase	spring.cloud.kubernetes.client.clientKeyPassphrase	changeit	Kubernetes API ClientKeyPassphrase
log4j2.kubernetes.client.connectionTimeout	spring.cloud.kubernetes.client.connectionTimeout	10s	Connection timeout
log4j2.kubernetes.client.httpProxy	spring.cloud.kubernetes.client.http-proxy
log4j2.kubernetes.client.httpsProxy	spring.cloud.kubernetes.client.https-proxy
log4j2.kubernetes.client.loggingInberval	spring.cloud.kubernetes.client.loggingInterval	20s	Logging interval
log4j2.kubernetes.client.masterUrl	spring.cloud.kubernetes.client.masterUrl	kubernetes.default.svc	Kubernetes API 主节点 URL
log4j2.kubernetes.client.namespacce	spring.cloud.kubernetes.client.namespace	default	Kubernetes Namespace
log4j2.kubernetes.client.noProxy	spring.cloud.kubernetes.client.noProxy
log4j2.kubernetes.client.password	spring.cloud.kubernetes.client.password		Kubernetes API 密码
log4j2.kubernetes.client.proxyPassword	spring.cloud.kubernetes.client.proxyPassword
log4j2.kubernetes.client.proxyUsername	spring.cloud.kubernetes.client.proxyUsername
log4j2.kubernetes.client.requestTimeout	spring.cloud.kubernetes.client.requestTimeout	10s	Request timeout
log4j2.kubernetes.client.rollingTimeout	spring.cloud.kubernetes.client.rollingTimeout	900s	Rolling timeout
log4j2.kubernetes.client.trustCerts	spring.cloud.kubernetes.client.trustCerts	false	Kubernetes API 信任证书
log4j2.kubernetes.client.username	spring.cloud.kubernetes.client.username		Kubernetes API 用户名
log4j2.kubernetes.client.watchReconnectInterval	spring.cloud.kubernetes.client.watchReconnectInterval	1s	Reconnect Interval
log4j2.kubernetes.client.watchReconnectLimit	spring.cloud.kubernetes.client.watchReconnectLimit	-1	重新连接间隔限制重试

Requirements

Log4j Kubernetes 需要 Log4j Core，Log4j API 和最少的 Java8.有关更多信息，请参阅Runtime Dependencies。