5.2. Jaeger デプロイメントのカスタマイズ

apiVersion:

オブジェクトの作成時に使用する Application Program Interface のバージョン。

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/<component> ノードの下に配置されます。

該当なし

strategy:

Jaeger デプロイメントストラテジー

allInOne、production、または streaming

allInOne

allInOne:

allInOne イメージはエージェント、Collector、Query、Ingester, Jaeger UI を単一 Pod にデプロイするため、このデプロイメントの設定は、コンポーネント設定を allInOne パラメーターの下でネストする必要があります。

agent:

Jaeger エージェントを定義する設定オプション。

collector:

Jaeger Collector を定義する設定オプション。

sampling:

トレース用のサンプリングストラテジーを定義する設定オプション。

storage:

ストレージを定義する設定オプション。すべてのストレージ関連のオプションは、 allInOne または他のコンポーネントオプションではなく、storage に配置される必要があります。

query:

Query サービスを定義する設定オプション。

ingester:

Ingester サービスを定義する設定オプション。

トレース用のサンプリングストラテジーを定義する設定オプション。

使用するサンプリングストラテジー。(上記の説明を参照してください。)

有効な値は const、probabilistic、ratelimiting、および remote です。

remote

選択したサンプリングストラテジーのパラメーター(上記の例を参照してください。)

10 進値および整数値 (0、.1、1、10)

該当なし

ストレージを定義する設定オプション。

デプロイメントに使用するストレージのタイプ。

memory または elasticsearchメモリーストレージは、Pod がシャットダウンした場合にデータが永続化されないため、開発、テスト、デモ、および概念検証用の環境にのみに適しています。実稼働環境については、Jaeger は永続ストレージの Elasticsearch をサポートします。

memory

Elasticsearch インスタンスの URL。

Elasticsearch サーバーの完全修飾ドメイン名。spec:storage:type= elasticsearch を指定しているが、server-urls パラメーターの値を指定していない場合、Jaeger Operator は Elasticsearch Operator を使用し、カスタムリソースファイルの spec:storage:elasticsearch セクションの設定を使用して Elasticsearch クラスターを作成します。

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

Elasticsearch のクエリーごとに 1 度に取得するスパンの最大数。

10000

Elasticsearch のスパンについての最大ルックバック。

72h0m0s

シークレットの名前 (例: jaeger-secret)

該当なし

Elasticsearch のスニファー設定。クライアントはスニファープロセスを使用してすべてのノードを自動的に検出します。デフォルトでは無効にされています。

true/ false

false

クエリーに使用されるタイムアウト。ゼロに設定するとタイムアウトはありません。

0s

Elasticsearch で必要なユーザー名。Basic 認証は、指定されている場合に CA も読み込みます。es.password も参照してください。

Elasticsearch で必要なパスワード。es.username も参照してください。

主要な Elasticsearch バージョン。指定されていない場合、値は Elasticsearch から自動検出されます。

0

Elasticsearch ノードの数。高可用性を確保するには、少なくとも 3 つのノードを使用します。「スプリットブレイン」の問題が生じる可能性があるため、2 つのノードを使用しないでください。

整数値。例: 概念実証用 = 1、最小デプロイメント = 3

1

ご使用の環境設定に基づく、要求に対する中央処理単位の数。

コアまたはミリコアで指定されます (例: 200m、0.5、1)。例: 概念実証用 = 500m、最小デプロイメント = 1

1Gi

ご使用の環境設定に基づく、要求に使用できるメモリー。

バイト単位で指定されます (例: 200Ki、50Mi、5Gi)。例: 概念実証用 = 1Gi、最小デプロイメント = 16Gi*

500m

ご使用の環境設定に基づく、中央処理単位数の制限。

コアまたはミリコアで指定されます (例: 200m、0.5、1)。例: 概念実証用 = 500m、最小デプロイメント = 1

ご使用の環境設定に基づく、利用可能なメモリー制限。

バイト単位で指定されます (例: 200Ki、50Mi、5Gi)。例: 概念実証用 = 1Gi、最小デプロイメント = 16Gi*

各 Elasticsearch ノードはこれより低い値のメモリー設定でも動作しますが、これは実稼働環境でのデプロイメントには推奨されません。実稼働環境で使用する場合、デフォルトで各 Pod に割り当てる設定を 16Gi 未満にすることはできず、Pod ごとに最大 64Gi を割り当てることを推奨します。

データレプリケーションポリシーは、Elasticsearch シャードをクラスター内のデータノードにレプリケートする方法を定義します。指定されていない場合、Jaeger Operator はノード数に基づいて最も適切なレプリケーションを自動的に判別します。

ZeroRedundancy（レプリカシャードなし）、SingleRedundancy（レプリカシャード 1 つ)、MultipleRedundancy（各インデックスはデータノードの半分に分散される)、FullRedundancy (各インデックスはクラスター内のすべてのデータノードに完全にレプリケートされます）

Elasticsearch のインデックスごとのレプリカ数。

1

Elasticsearch のインデックスごとのシャード数。

5

true に設定されている場合、アプリケーションの起動時にインデックステンプレートを自動的に作成します。テンプレートが手動でインストールされる場合は、false に設定されます。

true/ false

true

Jaeger インデックスのオプションのプレフィックス。たとえば、これを「production」に設定すると、「production-jaeger-*」という名前のインデックスが作成されます。

Elasticsearch ストレージを使用する場合、デフォルトでジョブが作成され、古いトレースをインデックスからクリーンアップします。このパラメーターは、インデックスクリーナージョブを有効または無効にします。

true/ false

true

インデックスの削除を待機する日数。

整数値

7

Elasticsearch インデックスを消去する頻度についてのスケジュールを定義します。

cron 式

"55 23 * * *"

新規 Elasticsearch インデックスにロールオーバーする頻度についてのスケジュールを定義します。

cron 式

'*/30 * * * *'

バルクプロセッサーがディスクへの更新のコミットを決定する前にキューに追加できる要求の数。

1000

time.Duration: この後に、他のしきい値に関係なく一括要求がコミットされます。バルクプロセッサーのフラッシュ間隔を無効にするには、これをゼロに設定します。

200ms

バルクプロセッサーがディスクへの更新をコミットするまでに一括要求が発生する可能性のあるバイト数。

5000000

一括要求を受信し、Elasticsearch にコミットできるワーカーの数。

1

リモートサーバーの検証に使用される TLS 認証局 (CA) ファイルへのパス。

デフォルトではシステムトラストストアを使用します。

リモートサーバーに対するこのプロセスの特定に使用される TLS 証明書ファイルへのパス。

リモートサーバーと通信する際に、トランスポート層セキュリティー (TLS) を有効にします。デフォルトでは無効にされています。

true/ false

false

リモートサーバーに対するこのプロセスの特定に使用される TLS 秘密鍵ファイルへのパス。

リモートサーバーの証明書の予想される TLS サーバー名を上書きします。

ベアラートークンが含まれるファイルへのパス。このフラグは、指定されている場合は認証局 (CA) ファイルも読み込みます。

バルクプロセッサーがディスクへの更新のコミットを決定する前にキューに追加できる要求の数。

0

time.Duration: この後に、他のしきい値に関係なく一括要求がコミットされます。バルクプロセッサーのフラッシュ間隔を無効にするには、これをゼロに設定します。

0s

バルクプロセッサーがディスクへの更新をコミットするまでに一括要求が発生する可能性のあるバイト数。

0

一括要求を受信し、Elasticsearch にコミットできるワーカーの数。

0

true に設定されている場合、アプリケーションの起動時にインデックステンプレートを自動的に作成します。テンプレートが手動でインストールされる場合は、false に設定されます。

true/ false

false

追加ストレージを有効にします。

true/ false

false

Jaeger インデックスのオプションのプレフィックス。たとえば、これを「production」に設定すると、「production-jaeger-*」という名前のインデックスが作成されます。

Elasticsearch のクエリーごとに 1 度に取得するスパンの最大数。

0

Elasticsearch のスパンについての最大ルックバック。

0s

Elasticsearch のインデックスごとのレプリカ数。

0

Elasticsearch のインデックスごとのシャード数。

0

Elasticsearch で必要なパスワード。es.username も参照してください。

Elasticsearch サーバーのコンマ区切りの一覧。完全修飾 URL（例: http://localhost:9200) として指定される必要があります。

Elasticsearch のスニファー設定。クライアントはスニファープロセスを使用してすべてのノードを自動的に検出します。デフォルトでは無効にされています。

true/ false

false

クエリーに使用されるタイムアウト。ゼロに設定するとタイムアウトはありません。

0s

リモートサーバーの検証に使用される TLS 認証局 (CA) ファイルへのパス。

デフォルトではシステムトラストストアを使用します。

リモートサーバーに対するこのプロセスの特定に使用される TLS 証明書ファイルへのパス。

リモートサーバーと通信する際に、トランスポート層セキュリティー (TLS) を有効にします。デフォルトでは無効にされています。

true/ false

false

リモートサーバーに対するこのプロセスの特定に使用される TLS 秘密鍵ファイルへのパス。

リモートサーバーの証明書の予想される TLS サーバー名を上書きします。

ベアラートークンが含まれるファイルへのパス。このフラグは、指定されている場合は認証局 (CA) ファイルも読み込みます。

Elasticsearch で必要なユーザー名。Basic 認証は、指定されている場合に CA も読み込みます。es-archive.password も参照してください。

主要な Elasticsearch バージョン。指定されていない場合、値は Elasticsearch から自動検出されます。

0

Query サービスを定義する設定オプション。

追加の HTTP 応答ヘッダー。複数回指定できます。

形式: "Key: Value"

すべての jaeger-query HTTP ルートのベースパスは、root 以外の値に設定できます。たとえば、/jaeger ではすべての UI URL が /jaeger で開始するようになります。これは、リバースプロキシーの背後で jaeger-query を実行する場合に役立ちます。

/{path}

クエリーサービスのポート。

16686

Query のロギングレベル。

使用できる値は、trace、debug、info、warning、error、fatal、panic です。