5.2. 自定义 Jaeger 部署

apiVersion：

创建对象时使用的应用程序接口版本。

jaegertracing.io/v1

jaegertracing.io/v1

kind：

定义要创建的 Kubernetes 对象的种类。

jaeger

metadata：

有助于唯一标识对象的数据，包括 name 字符串、UID 和可选 namespace。

OpenShift 会自动生成 UID 并使用创建对象的项目名称完成 namespace。

name：

对象的名称。

Jaeger 实例的名称。

jaeger-all-in-one-inmemory

spec：

要创建的对象的规格。

包含 Jaeger 实例的所有配置参数。当需要一个通用定义（用于所有 Jaeger 组件）时，会在 spec 节点下定义它。当该定义与单个组件相关时，会将它放置在 spec/<component> 节点下。

N/A

strategy：

Jaeger 部署策略

allInOne、production 或 streaming

allInOne

allInOne：

由于 allInOne 镜像在单个 Pod 中部署了 agent、collector、query、ingester 和 Jaeger UI，因此该部署的配置应该在 allInOne 参数下嵌套组件配置。

agent：

定义 Jaeger 代理的配置选项。

collector：

定义 Jaeger Collector 的配置选项。

sampling：

定义用于追踪的抽样策略的配置选项。

storage：

定义存储的配置选项。所有与存储相关的选项都应放在 storage 下，而不是放在 allInOne 或者其他组件选项下。

query：

定义 Query 服务的配置选项。

ingester：

定义 Ingester 服务的配置选项。

spec:
 sampling:
  options: {}

定义用于追踪的抽样策略的配置选项。

sampling:
  type:

要使用的抽样策略。（请参阅上述描述。）

有效值为 const、probabilistic、ratelimiting 和 remote。

remote

sampling:
  options:
    type:
    param:

所选抽样策略的参数。（请参阅上述示例。）

小数值和整数值 (0, .1, 1, 10)

N/A

spec:
 storage:
  options: {}

定义存储的配置选项。

storage:
  type:

要在部署中使用的存储类型。

memory 或 elasticsearch。内存存储仅适用于开发、测试、演示和验证概念环境，因在关闭 pod 时，数据不会保留。对于生产环境，Jaeger 支持 Elasticsearch 的持久性存储。

memory

General Elasticsearch configuration settings

elasticsearch:
  server-urls:

Elasticsearch 实例的 URL。

Elasticsearch 服务器的完全限定域名。如果您指定了 spec:storage:type= elasticsearch，但没有为 server-urls 参数指定值，Jaeger Operator 将使用自定义资源文件的 spec:storage:elasticsearch 部分中的配置创建一个 Elasticsearch 集群。

http://elasticsearch.<namespace>.svc:9200

es:
  max-num-spans:

在 Elasticsearch 中每个查询一次获取的最大 span 数量。

10000

es:
  max-span-age:

Elasticsearch 中 span 的最大查询。

72h0m0s

elasticsearch:
  secretname:

secret 的名称，如 jaeger-secret。

N/A

es:
  sniffer:

Elasticsearch 的侦察器配置。客户端使用侦察过程自动查找所有节点。默认禁用此选项。

true/ false

false

es:
  timeout:

用于查询的超时。当设为零时，则没有超时。

0s

es:
  username:

Elasticsearch 所需的用户名。如果指定，基本身份验证也会加载 CA。另请参阅 es.password。

es:
  password:

Elasticsearch 所需的密码。另请参阅 es.username。

es:
  version:

主要的 Elasticsearch 版本。如果没有指定，则该值将从 Elasticsearch 中自动探测到。

0

Elasticsearch resource configuration settings

elasticsearch:
  nodeCount:

Elasticsearch 节点数量。对于高可用性，需要至少 3 个节点。不要只使用 2 个节点，因为可能会出现“脑裂”问题。

整数值。例如，概念验证 = 1，最小部署 = 3

1

elasticsearch:
  resources:
    requests:
      cpu:

根据您的环境配置，请求的 CPU 数量。

以 core 或者 millicores 指定（例如: 200m, 0.5, 1）。例如，概念证明 = 500m，最小部署 =1

1Gi

elasticsearch:
  resources:
    requests:
      memory:

根据您的环境配置，可用于请求的内存。

以字节为单位指定（例如: 200Ki, 50Mi, 5Gi）。例如，概念证明 = 1Gi，最小部署 = 16Gi*

500m

elasticsearch:
  resources:
    limits:
      cpu:

根据您的环境配置，CPU 数量的限值。

以 core 或者 millicores 指定（例如: 200m, 0.5, 1）。例如，概念证明 = 500m，最小部署 =1

elasticsearch:
  resources:
    limits:
      memory:

根据您的环境配置，可用的内存限值。

以字节为单位指定（例如: 200Ki, 50Mi, 5Gi）。例如，概念证明 = 1Gi，最小部署 = 16Gi*

*通过这个设置可以使每个 Elasticsearch 节点使用较低内存进行操作，但对于生产环境部署，不建议这样做。对于生产环境，您应该默认为每个 Pod 分配不少于 16Gi 的尽量多的内存，但不要超过 64Gi 内存。

Elasticsearch data replication options

elasticsearch:
  redundancyPolicy:

数据复制策略定义如何在集群中的数据节点之间复制 Elasticsearch 分片：如果没有指定，Jaeger Operator 会自动根据节点数量决定最合适的复制。

ZeroRedundancy（无副本分片）、SingleRedundancy（一个副本分片）、MultipleRedundancy（每个索引分散于一半的 Data 节点）、FullRedundancy（每个索引在集群中的每个 Data 节点上完全复制）。

es:
  num-replicas:

Elasticsearch 中每个索引的副本数。

1

es:
  num-shards:

Elasticsearch 中每个索引的分片数量。

5

Elasticsearch index and index cleaner configuration options

es:
  create-index-templates:

设置为 true 时，应用程序启动时自动创建索引模板。手动安装模板时，设置为 false。

true/ false

true

es:
  index-prefix:

Jaeger 索引的可选前缀。例如，将它设置为 "production" 会创建名为 "production-jaeger-*" 的索引。

esIndexCleaner:
  enabled:

当使用 Elasticsearch 存储时，默认会创建一个任务来清理索引中的旧 trace。这个参数用于启用或禁用索引清理任务。

true/ false

true

esIndexCleaner:
  numberOfDays:

删除索引前等待的天数。

整数值

7

esIndexCleaner:
  schedule:

为 Elasticsearch 索引的清理频率定义调度。

Cron 表达式

"55 23 * * *"

esRollover:
  schedule:

为滚动到新的 Elasticsearch 索引的频率定义调度

Cron 表达式

'*/30 * * * *'

Configuration settings for Elasticsearch bulk processor

es:
  bulk:
    actions:

在批量处理器决定向磁盘提交更新前可添加到队列的请求数。

1000

es:
  bulk:
    flush-interval:

提交批量请求的时间.要禁用批量处理器清除间隔，请将其设置为零。

200ms

es:
  bulk:
    size:

在批量处理器决定提交更新之前，批量请求可以处理的字节数。

5000000

es:
  bulk:
    workers:

可以接收并将批量请求提交 Elasticsearch 的 worker 数量。

1

Elasticsearch TLS configuration settings

es:
  tls:
    ca:

用于验证远程服务器的 TLS 认证机构（CA）文件的路径。

默认将使用系统信任存储。

es:
  tls:
    cert:

TLS 证书文件的路径，用来识别此进程到远程服务器。

es:
  tls:
    enabled:

与远程服务器对话时启用传输层安全（TLS）。默认禁用此选项。

true/ false

false

es:
  tls:
    key:

TLS 私钥文件的路径，用于识别此进程到远程服务器。

es:
  tls:
    server-name:

覆盖远程服务器证书中的预期 TLS 服务器名称。

es:
  token-file:

包含 bearer 令牌的文件的路径。如果指定该标志，该标志也会载入认证机构（CA）文件。

Elasticsearch archive configuration settings

es-archive:
  bulk:
    actions:

在批量处理器决定向磁盘提交更新前可添加到队列的请求数。

0

es-archive:
  bulk:
    flush-interval:

提交批量请求的时间.要禁用批量处理器清除间隔，请将其设置为零。

0s

es-archive:
  bulk:
    size:

在批量处理器决定提交更新之前，批量请求可以处理的字节数。

0

es-archive:
  bulk:
    workers:

可以接收并将批量请求提交 Elasticsearch 的 worker 数量。

0

es-archive:
  create-index-templates:

设置为 true 时，应用程序启动时自动创建索引模板。手动安装模板时，设置为 false。

true/ false

false

es-archive:
  enabled:

启用额外的存储。

true/ false

false

es-archive:
  index-prefix:

Jaeger 索引的可选前缀。例如，将它设置为 "production" 会创建名为 "production-jaeger-*" 的索引。

es-archive:
  max-num-spans:

在 Elasticsearch 中每个查询一次获取的最大 span 数量。

0

es-archive:
  max-span-age:

Elasticsearch 中 span 的最大查询。

0s

es-archive:
  num-replicas:

Elasticsearch 中每个索引的副本数。

0

es-archive:
  num-shards:

Elasticsearch 中每个索引的分片数量。

0

es-archive:
  password:

Elasticsearch 所需的密码。另请参阅 es.username。

es-archive:
  server-urls:

以逗号分隔的 Elasticsearch 服务器列表。必须指定为完全限定的 URL，例如 http://localhost:9200。

es-archive:
  sniffer:

Elasticsearch 的侦察器配置。客户端使用侦察过程自动查找所有节点。默认禁用此选项。

true/ false

false

es-archive:
  timeout:

用于查询的超时。当设为零时，则没有超时。

0s

es-archive:
  tls:
    ca:

用于验证远程服务器的 TLS 认证机构（CA）文件的路径。

默认将使用系统信任存储。

es-archive:
  tls:
    cert:

TLS 证书文件的路径，用来识别此进程到远程服务器。

es-archive:
  tls:
    enabled:

与远程服务器对话时启用传输层安全（TLS）。默认禁用此选项。

true/ false

false

es-archive:
  tls:
    key:

TLS 私钥文件的路径，用于识别此进程到远程服务器。

es-archive:
  tls:
    server-name:

覆盖远程服务器证书中的预期 TLS 服务器名称。

es-archive:
  token-file:

包含 bearer 令牌的文件的路径。如果指定该标志，该标志也会载入认证机构（CA）文件。

es-archive:
  username:

Elasticsearch 所需的用户名。如果指定，基本身份验证也会加载 CA。请参阅 es-archive.password。

es-archive:
  version:

主要的 Elasticsearch 版本。如果没有指定，则该值将从 Elasticsearch 中自动探测到。

0

spec:
  query:
   options: {}
   resources: {}

定义 Query 服务的配置选项。

query:
  additional-headers:

其他 HTTP 响应标头。可多次指定。

格式：“键: 值”

query:
  base-path:

所有 jaeger-query HTTP 路由的基本路径都可设置为非 root 值，例如，/jaeger 将导致所有 UI URL 以 /jaeger 开头。当在反向代理后面运行 Jaeger-query 时，这很有用。

/{path}

query:
  port:

查询服务的端口。

16686

options:
  log-level:

Query 的日志记录级别。

可能的值有：trace、debug、info、warning、error、fatal、panic。