3.3. Kubernetes イベントの期間を制限することで etcd のサイズを管理する

検証

• 設定が適用されたことを確認するには、次のコマンドを入力します。

  $ oc get cm config -n openshift-kube-apiserver -ojsonpath='{.data.config\.yaml}' | jq -r ".apiServerArguments[\"event-ttl\"][0]"

  出力には設定された期間が表示されます。次の例では 5 分です。

  5m

  注記

  eventTTLMintes プロパティーの新しい値を使用することで、新しく作成されたイベントのみが etcd に書き込まれます。古い既存のイベントは更新されず、以前に指定された TTL 値に従って期限切れになります。

• 特定のイベントが短いリース期間で書き込まれたことを手動で確認するには、次のコマンドを入力して etcd 上でリース期間を直接調べます。

  $ oc exec -it pods/<etcd_pod_name> -n openshift-etcd -c etcdctl -- sh

  コマンドの出力は、次の例のようになります。

  sh-5.1h# $ etcdctl lease list | xargs -I {} etcdctl lease timetolive {}
  lease 1e6e9a77a71d8235 granted with TTL(15s), remaining(1s)
  lease 1e6e9a77a71d8247 granted with TTL(15s), remaining(3s)
  lease 1e6e9a77a71d8252 granted with TTL(15s), remaining(3s)
  lease 1e6e9a77a71d8310 granted with TTL(15s), remaining(11s)
  lease 1e6e9a77a71d8332 granted with TTL(15s), remaining(12s)
  lease 1e6e9a77a71d833e granted with TTL(15s), remaining(13s)
  lease 086e9a77a31f0776 granted with TTL(315s), remaining(177s)
  lease 086e9a779dcd8245 granted with TTL(10860s), remaining(8369s)
  lease 086e9a779dcd8fdf granted with TTL(10860s), remaining(8369s)

  注記

  他の API オブジェクトにもリースを設定できます。

• 添付されたキーを検査するには、次のコマンドを入力してイベントのキープレフィックスでフィルタリングします。

  $ etcdctl lease list | xargs -I {} etcdctl lease timetolive --keys {} | grep "/kubernetes.io/events"

  出力は次の例のようになります。

  lease 0f009a77a48509ac granted with TTL(315s), remaining(74s), attached keys([/kubernetes.io/events/openshift-marketplace/redhat-operators-rrq79.18773e905b3e29a8 /kubernetes.io/events/openshift-marketplace/community-operators-csds7.18773e91b1e551a3])
  ...
  ...
  lease 1e6e9a77a71d3df1 granted with TTL(10860s), remaining(9478s), attached keys([/kubernetes.io/events/openshift-kube-apiserver/kube-apiserver-guard-ci-ln-pbkb71t-72292-dwp9h-master-2.18773c38ef4dcc03])

  この例では、TTL 値は 5 分 (300s) ですが、リースバッファーの再利用率 5% が加算されるため、出力には 315s と表示されます。

  注記

  リースが再利用可能な場合に、etcd はそのリースを再利用します。TTL プロパティーを必要とするリソースごとに固有の etcd リースを作成すると、API サーバーが何千もの個別のオブジェクトを追跡しなければならなくなるため、固有のリースを作成するのではなく、システムは既存のリースのより小さなプールを再利用します。新しいオブジェクトが特定の期間のリースを必要とする場合、マネージャーは、その期間に加えて 5% の小さな安全バッファーを含めて、残りの有効期間が十分にある既存のリースがないかを確認します。一致するものが見つかった場合、新しいオブジェクトはその既存のリースを使用します。そうでない場合は、新しいリースが作成され、他のユーザーが共有できるようにプールに追加されます。