# トラブルシューティング

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/ja-jp/help/clion/llms.txt).

JetBrains IDE の   リモート開発   機能はまだ開発段階にあるため、問題が発生する可能性があります。 このページは、セットアップ中またはその後の作業中の最初のトラブルシューティングに役立つことを目的としています。

> **Note:**
> ドキュメントの [システム要件](prerequisites-for-dev-containers.html)および [よくある質問 (FAQ)](faq-about-remote-development.html) パーツを認識していることを確認してください。

## セットアップ

|  質問  |  回答  |
| --- | --- |
|  JetBrains Gateway と Toolbox、個別にダウンロードしたもの、IDE からのものの間に違いはありますか ?  |     スタンドアロンの JetBrains Gateway には、 [Space ベースのプロジェクト](https://www.jetbrains.com/ja-jp/help/space/getting-started.html#what-is-space)を「IDE で開く」オプションが用意されています。これを使用しない場合、インストーラーやワークフローに他の違いはありません。       [インストールシナリオ](jetbrains-gateway.html)を確認してください。     |
|  リモート開発を リモートサーバー上の既存の IDE に向けることはできますか ? IDE を手動でインストールすることは可能ですか ?  |     バージョン   221.5481   以降、既存のバックエンド IDE をリモートサーバーに手動で登録し、JetBrains Gateway で表示できるようになりました。 インストールされた IDE が利用可能なビルドのリストに表示されます。        1.     SSH でリモートサーバーに入ります。        2.     解凍された IDE があるフォルダーを見つけて、  `bin`  フォルダーに入ります。        3.     コマンドラインで、次のコマンドを実行します：       ``` remote-dev-server.sh registerBackendLocationForGateway ```      例えば、       ``` sh CLion-221.5591.52/bin/remote-dev-server.sh registerBackendLocationForGateway ```       |
|  JetBrains Gateway のインストール自体が正常に完了しない  |      * システムユーザーにソフトウェアをインストールする権限があることを確認するか、組織のシステム管理者に連絡してください。    |
|  セットアップ中にリモートサーバーへの SSH 接続が失敗するのはなぜですか ?  |      * リモートサーバー側のファイアウォールまたは仮想マシンプロバイダーが受信接続を禁止しています。 AWS の場合は「セキュリティグループ」の調整も忘れずに    * リモート側では、SSH は非標準ポートをリッスンします。    * パスワードまたはキーファイルが正しくないか、いくつかのエラーにより接続がブロックされました    |
|  JetBrains Gateway が   IDE バージョンを取得   ステップでハングし、利用可能な IDE をロードしない  |      * JetBrains Gateway は [JetBrains のサイト(英語)](https://data.services.jetbrains.com/products)に接続して既存のビルドのリストを取得できません    |
|  JetBrains Gateway は接続を試行しますが、失敗します。 資格情報は 100% が正しいです。  |      * サーバー管理者に、 `sshd_config` で TCP 転送を許可するよう依頼してください。 JetBrains Gateway では、SSH 経由で IDE 接続を転送するために `AllowTcpForwarding` が必要です。    |
|  ローカルマシンから IDE インストーラーを選択しましたが、アップロードプロセスが失敗します  |      * リモートサーバーのディスクに十分な空き容量がありません。 リモートサーバーの使用可能なスペースは、サイズが少なくとも 4xIDE.tar.gz でなければなりません。 バージョン 2022.1.1 以降、リモートサーバー上のカスタムパスをデプロイターゲットの場所として選択できます。    * アップロードしたのは .tar.gz インストーラーアーカイブではないため、リモート側で展開できません。    |
|  リモート -dev-worker のアップロードが「終了コード」で失敗する: 139 (SIGSEGV)」  |  リモートマシンの OS が RHEL、CentOS、RockyLinux の場合 -   syslog で SELinux の警告   を確認するか、SELinux を無効にしてインストールを再試行します。  |
|  ローカルマシンでプロセスが失敗し、「JetBrains Client のダウンロードに失敗しました」というエラーが表示される  |     ローカルコンピューターには、次の JetBrains URL へのネットワーク接続が必要です：        * https://code-with-me.jetbrains.com    * https://download.jetbrains.com    * https://download-cf.jetbrains.com    * https://download-cdn.jetbrains.com    * https://cache-redirector.jetbrains.com      または、 [完全オフラインモード](fully-offline-mode.html)を構成することもできます。     |

## リモートプロジェクトの操作

|  質問  |  回答  |
| --- | --- |
|  60 秒以内に IDE ステータスを取得できませんでした。 おそらく IDE バックエンドがスタックしています  |      * バックエンドサーバーのシェルが対話型であるか、構成エラーがあるため、デプロイコマンドが正しく終了しません。 デフォルトの構成または単純な bash に置き換えてみてください    * リソース不足によりバックエンド IDE がハングし、応答しません： 1。 ssh でリモートサーバーに入り、手動で IDE プロセスを終了する 2。 JVM オプションファイルを編集して、リモート IDE にメモリを追加します。 デフォルトのデプロイ設定は、平均的なプロジェクトや大規模なプロジェクトには適していない場合があります。 3。 リモート IDE JVM 設定ファイルを見つける `$IDE_BIN_DIR/${IDE_PRODUCT_VM_OPTIONS}.vmoptions` 次の例を確認してください： `./.cache/JetBrains/RemoteDev/dist/a17ad99f7faf8_ideaIU-2021.3.1/bin/idea64.vmoptions` 4。 `-Xmx` 値を編集し、新しい設定でデプロイ / 接続を繰り返する    * 一般に、バックエンド IDE はプロジェクトを処理できません（リソースの不足、構成の誤り、依存関係の破損）。 ssh でリモートサーバーに入り、 [このページ](https://www.jetbrains.com/ja-jp/help/idea/2022.1/remote-development-a.html#use_idea)の説明に従って手動でプロジェクトを起動し、出力を確認します。 プロジェクトが正常に開始された場合は、生成されたリンクをコピーし、ローカル Gateway からの接続を試してください（この記事でも説明されています）。    |
|  CPU またはリソースの使用率が異常に見える  |      * パフォーマンスの問題を診断するには、ログ (ヘルプ -> ホストとクライアントのログを収集) 、サーバー (ヘルプ -> 診断ツール -> CPU 使用率プロファイリングの開始) からの CPU スナップショット、およびヒープダンプ（ `java_error_in_idea*.hprof` のようなファイル） パフォーマンスの問題の診断について詳しくは、 [パフォーマンス問題の報告](https://intellij-support.jetbrains.com/hc/en-us/articles/207241235-Reporting-performance-problems)を参照してください。    |
|  IDE がハングして応答しない  |      * IDE がハングして応答しないため、メニューを使用してスナップショットをキャプチャーできない場合は、 [スレッドダンプ](https://intellij-support.jetbrains.com/hc/en-us/articles/206544899)を提供してください。    |
|  リモート IDE は機能しましたが、応答を停止しました  |      * リモートサーバーに入り、IDE プロセスを終了するか、サーバーを再起動して再テストします。    |

## ログの収集とレポートの送信

上記の解決策が役に立たず、サポートが必要な場合は、詳細な説明を提供してください。 必須の IDE バージョン、ログ、スレッドダンプに加えて、問題を説明するコード / プロジェクトサンプル、スクリーンショット、スクリーンキャスト /GIF を提供していただければ幸いです。

レポートを送信する際に、 [問題にアタッチしてください(英語)](https://youtrack.jetbrains.com/newIssue?project=CWM&c=Remote%20Context%20Remote%20Development)。

問題を JetBrains チームだけに見えるようにするには、その可視性を   jetbrains チーム   グループに設定します。 イメージを除いて、すべての添付ファイルはデフォルトで JetBrains チームのみに表示されます。

Procedure: UI からログを収集する

> **Note:**
> バックエンド IDE からログを収集するには、JetBrains Gateway または IDE がリモートサーバーに接続されている必要があります。 接続されていない場合は、ローカルログのみを取得できます。

1. JetBrains Gateway から   : ようこそ (スタート) 画面 - 左下隅 - 歯車アイコン - 「ログと診断データの収集」。

2. リモート開発の開始点として使用するメイン IDE から   : トップメニュー - 「ヘルプ」 - 「ログと診断データの収集」。

3. 開始された JetBrains Client セッションから   (リモートサーバーに接続されている): トップメニュー - " ヘルプ " - 「ホストとクライアントのログを収集する」

Procedure: ログを手動で収集する

> **Note:**
> UI がフリーズした場合、または接続が失われた場合は、このメソッドを使用します。

1. ローカルワークステーション側   : 場所は、ローカルコンピューターの OS によって異なります。

[IDE で使用されるディレクトリ](directories-used-by-the-ide-to-store-settings-caches-plugins-and-logs.html#logs-directory)からログのフォルダー全体を収集して送信することをお勧めします。

2. リモートサーバー上   : ログは IDE ごとにインストールフォルダーに保存されます。

デフォルトのインストールパスは  `~/.cache/JetBrains/<product><versions>/log/`  です

例:  `~/.cache/JetBrains/IntelliJIdea2024.1/log/`

