13.3. トラブルシューティング

手順

1. 特定のコンポーネントのログの詳細度を設定するには、次のコマンドを実行して、デフォルトのテキストエディターで HyperConverged CR を開きます。

   $ oc edit hyperconverged kubevirt-hyperconverged -n openshift-cnv

2. spec.logVerbosityConfig スタンザを編集して、1 つ以上のコンポーネントのログレベルを設定します。以下に例を示します。

   apiVersion: hco.kubevirt.io/v1beta1
   kind: HyperConverged
   metadata:
     name: kubevirt-hyperconverged
   spec:
     logVerbosityConfig:
       kubevirt:
         virtAPI: 5 1
         virtController: 4
         virtHandler: 3
         virtLauncher: 2
         virtOperator: 6

   1

   ログの詳細度の値は 1 ~ 9 の範囲の整数である必要があり、数値が大きいほど詳細なログであることを示します。この例では、virtAPI コンポーネントのログは、優先度が 5 以上の場合に公開されます。

3. エディターを保存して終了し、変更を適用します。

手順

1. Virtualization VirtualMachines に移動します。
2. 仮想マシンを選択して、VirtualMachine details ページを開きます。
3. General タイルで、Pod 名をクリックして Pod details ページを開きます。
4. Logs タブをクリックして、ログを表示します。

手順

1. 以下のコマンドを実行して、OpenShift Virtualization の namespace 内の Pod のリストを表示します。

   $ oc get pods -n openshift-cnv

   例13.1 出力例

   NAME                               READY   STATUS    RESTARTS   AGE
   disks-images-provider-7gqbc        1/1     Running   0          32m
   disks-images-provider-vg4kx        1/1     Running   0          32m
   virt-api-57fcc4497b-7qfmc          1/1     Running   0          31m
   virt-api-57fcc4497b-tx9nc          1/1     Running   0          31m
   virt-controller-76c784655f-7fp6m   1/1     Running   0          30m
   virt-controller-76c784655f-f4pbd   1/1     Running   0          30m
   virt-handler-2m86x                 1/1     Running   0          30m
   virt-handler-9qs6z                 1/1     Running   0          30m
   virt-operator-7ccfdbf65f-q5snk     1/1     Running   0          32m
   virt-operator-7ccfdbf65f-vllz8     1/1     Running   0          32m

2. Pod ログを表示するには、次のコマンドを実行します。

   $ oc logs -n openshift-cnv <pod_name>

   注記

   Pod の起動に失敗した場合は、--previous オプションを使用して、最後の試行からのログを表示できます。

   ログ出力をリアルタイムで監視するには、-f オプションを使用します。

   例13.2 出力例

   {"component":"virt-handler","level":"info","msg":"set verbosity to 2","pos":"virt-handler.go:453","timestamp":"2022-04-17T08:58:37.373695Z"}
   {"component":"virt-handler","level":"info","msg":"set verbosity to 2","pos":"virt-handler.go:453","timestamp":"2022-04-17T08:58:37.373726Z"}
   {"component":"virt-handler","level":"info","msg":"setting rate limiter to 5 QPS and 10 Burst","pos":"virt-handler.go:462","timestamp":"2022-04-17T08:58:37.373782Z"}
   {"component":"virt-handler","level":"info","msg":"CPU features of a minimum baseline CPU model: map[apic:true clflush:true cmov:true cx16:true cx8:true de:true fpu:true fxsr:true lahf_lm:true lm:true mca:true mce:true mmx:true msr:true mtrr:true nx:true pae:true pat:true pge:true pni:true pse:true pse36:true sep:true sse:true sse2:true sse4.1:true ssse3:true syscall:true tsc:true]","pos":"cpu_plugin.go:96","timestamp":"2022-04-17T08:58:37.390221Z"}
   {"component":"virt-handler","level":"warning","msg":"host model mode is expected to contain only one model","pos":"cpu_plugin.go:103","timestamp":"2022-04-17T08:58:37.390263Z"}
   {"component":"virt-handler","level":"info","msg":"node-labeller is running","pos":"node_labeller.go:94","timestamp":"2022-04-17T08:58:37.391011Z"}

手順

1. サイドメニューから、Virtualization Overview をクリックします。
2. Settings タブをクリックします。
3. Cluster Guest management をクリックします。
4. Enable guest system log access をオンに設定します。

手順

1. 以下のコマンドを実行して、デフォルトのエディターで HyperConverged CR を開きます。

   $ oc edit hyperconverged kubevirt-hyperconverged -n openshift-cnv

2. disableSerialConsoleLog の値を更新します。以下に例を示します。

   kind: HyperConverged
   metadata:
     name: kubevirt-hyperconverged
   spec:
     virtualMachineOptions:
       disableSerialConsoleLog: true 1
   #...

   1

   仮想マシン上でシリアルコンソールアクセスをデフォルトで有効にする場合は、disableSerialConsoleLog の値を false に設定します。

手順

1. サイドメニューから Virtualization VirtualMachines をクリックします。
2. 仮想マシンを選択して、VirtualMachine details ページを開きます。
3. Configuration タブをクリックします。
4. Guest system log access をオンまたはオフに設定します。

手順

1. 次のコマンドを実行して、仮想マシンのマニフェストを編集します。

   $ oc edit vm <vm_name>

2. logSerialConsole フィールドの値を更新します。以下に例を示します。

   apiVersion: kubevirt.io/v1
   kind: VirtualMachine
   metadata:
     name: example-vm
   spec:
     template:
       spec:
         domain:
           devices:
             logSerialConsole: true 1
   #...

   1

   ゲストのシリアルコンソールログへのアクセスを有効にするには、logSerialConsole の値を true に設定します。

3. 次のコマンドを実行して、新しい設定を仮想マシンに適用します。

   $ oc apply vm <vm_name>

4. オプション: 実行中の仮想マシンを編集した場合は、仮想マシンを再起動して新しい設定を適用します。以下に例を示します。

   $ virtctl restart <vm_name> -n <namespace>

手順

1. サイドメニューから Virtualization VirtualMachines をクリックします。
2. 仮想マシンを選択して、VirtualMachine details ページを開きます。
3. Diagnostics タブをクリックします。
4. Guest system logs をクリックしてシリアルコンソールをロードします。

手順

1. Web コンソールで Observe Logs に移動します。
2. ログタイプのリストから、virt-launcher Pod ログの場合は application を選択し、OpenShift Virtualization コントロールプレーン Pod およびコンテナーの場合は infrastructure を選択します。
3. Show Query をクリックしてクエリーフィールドを表示します。
4. クエリーフィールドに LogQL クエリーを入力し、Run Query をクリックしてフィルタリングされたログを表示します。