第7章 CodeReady Workspaces のトラブルシューティング

手順

1. デバッグ設定で showLog 属性を true に設定します。

   {
     "version": "0.2.0",
     "configurations": [
        {
           "type": "go",
           "showLog": true
          ....
        }
     ]
   }

2. コンポーネントのデバッグ出力を有効にするには、パッケージを logOutput 属性のコンマ区切りの一覧に追加します。

   {
     "version": "0.2.0",
     "configurations": [
        {
           "type": "go",
           "showLog": true,
           "logOutput": "debugger,rpc,gdbwire,lldbout,debuglineerr"
          ....
        }
     ]
   }

3. デバッグコンソールは、デバッグコンソールに追加情報を出力します。

   

手順

1. Output ビューに移動します。

2. ドロップダウンリストで Go を選択します。

   

手順

1. Typescript (TS) サーバーに送信されるメッセージのトレースを有効にするには、Preferences ビューで typescript.tsserver.trace 属性を verbose に設定します。これを使用して、TS サーバーの問題を診断します。
2. TS サーバーのファイルへのロギングを有効にするには、typescript.tsserver.log 属性を verbose に設定します。このログを使用して、TS サーバーの問題を診断します。ログにはファイルパスが含まれます。

手順

1. ログファイルへのパスを取得するには、Typescript Output コンソールを参照してください。

   

2. ログファイルを開くには、Open TS Server log コマンドを使用します。

   

手順

1. Output ビューに移動します。

2. ドロップダウンリストで TypeScript を選択します。

   

1. Eclipse JDT Language Server プラグインを実行しているコンテナーでターミナルを開きます (コンテナーのサンプル名: vscode-javaxxx)。

2. ターミナル内で ps aux | grep jdt コマンドを実行して、Eclipse JDT Language Server プロセスがコンテナーで実行されているかどうかを確認します。プロセスが実行されている場合、出力は以下のようになります。

   usr/lib/jvm/default-jvm/bin/java --add-modules=ALL-SYSTEM --add-opens java.base/java.util

   このメッセージは、使用される VSCode Java 拡張機能も表示します。言語サーバーが実行されていない場合には、これはコンテナー内で起動していません。

3. 「重要なログの確認」で説明されているすべてのログを確認します。

1. Java ファイルを開き、ホバーや自動補完機能を使用します。誤りのあるファイルの場合、ユーザーはこの Outline ビューまたは Problems ビューで Java を確認できます。

1. このログファイルを開くには、Eclipse JDT Language Server プラグインを実行しているコンテナーでターミナルを開きます。Java: Open Java Language Server log file コマンドを実行してログファイルを表示することもできます。
2. cat <PATH_TO_LOG_FILE> を実行します。PATH_TO_LOG_FILE は /home/theia/.theia/workspace-storage/<workspace_name>/redhat.java/jdt_ws/.metadata/.log になります。

1. File → Settings をクリックします。
2. Preferences ビューを開きます。
3. Intelephense セクションを拡張し、trace.server.verbose 設定値を verbose に設定してすべての通信イベントを表示します (デフォルト値は off です)。

手順

1. View → Output をクリックします。
2. Output ビューのドロップダウンリストで Intelephense を選択します。

手順

1. vscode-xml-<xxx> という名前のコンテナーでターミナルを開きます。

2. ps aux | grep java を実行して、XML 言語サーバーが起動していることを確認します。プロセスが実行されている場合、出力は以下のようになります。

   java ***/org.eclipse.ls4xml-uber.jar`

   そうでない場合は、「重要なログの確認」の章を参照してください。

手順

1. 機能が有効にされているかどうかを確認します。XML プラグインは、機能を有効かつ無効にできる複数の設定を提供します。

   • xml.format.enabled: フォーマッターを有効にします。
   • xml.validation.enabled: 検証を有効にします。
   • xml.documentSymbols.enabled: ドキュメントシンボルを有効にします。
2. XML 言語サーバーが機能しているかどうかを確認するには、<hello></hello> などの単純な XML 要素を作成し、右側の Outline パネルに表示されることを確認します。
3. ドキュメントのシンボルが表示されない場合は、xml.documentSymbols.enabled 属性が true に設定されていることを確認します。true の場合でシンボルがない場合は、言語サーバーはエディターにフックされない可能性があります。ドキュメントのシンボルがある場合は、言語サーバーがエディターに接続されます。
4. ユーザーが必要とする機能が、設定の true に設定されていることを確認します (デフォルトでは true に設定されます)。機能のいずれかが機能していないか、または予想通りに機能しない場合は、言語サーバー に対する問題を報告します。

1. エディターを使用し、YAML プラグインを実行しているコンテナーでターミナルを開きます (コンテナーの名前の例: vscode-yaml-<xxx>)。
2. ターミナルで ps aux | grep node コマンドを実行します。このコマンドは、現在のコンテナーで実行されているすべてのノードプロセスを検索します。

3. コマンド node **/server.js が実行していることを確認します。

   

1. 機能が有効にされているかどうかを確認します。YAML プラグインは、以下のような機能を有効および無効にできる複数の設定を提供します。

   • xml.format.enabled: フォーマッターを有効にします。
   • yaml.validate: 検証を有効にします。
   • yaml.hover: ホバー機能を有効にします。
   • yaml.completion: 補完 (completion) 機能を有効にします。
2. プラグインが機能しているかどうかを確認するには、hello: world などの最も簡単な YAML を入力してから、エディターの右側にある Outline パネルを開きます。
3. ドキュメントのシンボルがあるかどうかを確認します。yes の場合、言語サーバーはエディターに接続されます。
4. いずれの機能も機能していない場合は、上記の設定が true に設定されていることを確認してください (デフォルトでは true に設定されます)。この機能が機能していない場合は、言語サーバーに対する問題を報告します。

手順

1. launch.json ファイルに netcoredbg デバッグ設定があるかどうかを確認します。

   例7.1 デバッグ設定のサンプル

   {
    "type": "netcoredbg",
    "request": "launch",
    "program": "${workspaceFolder}/bin/Debug/<target-framework>/<project-name.dll>",
    "args": [],
    "name": ".NET Core Launch (console)",
    "stopAtEntry": false,
    "console": "internalConsole"
   }

2. launch.json ファイルの configuration セクションの中括弧内で自動補完機能をテストします。netcoredbg が見つかる場合、Che-Theia プラグインは正しく初期化されています。そうでない場合は、「重要なログの確認」を参照してください。

1. vscode-apache-camel<xxx> コンテナー内でターミナルを開きます。

2. ps aux | grep java コマンドを実行します。以下は、言語サーバープロセスの例です。

   java -jar /tmp/vscode-unpacked/camel-tooling.vscode-apache-camel.latest.euqhbmepxd.camel-tooling.vscode-apache-camel-0.0.14.vsix/extension/jars/language-server.jar

3. これが見つからない場合は、「重要なログの確認」を参照してください。