トラブルシューティング

よくあるエラーとその解決方法 — 接続、認証、監視、vaultについて説明します。

接続

Connection Refused

サーバーがネットワークレベルで拒否している状態で、まだ認証の段階には至っていません。次の順で確認してください。

# 1. ホストにそもそも到達できるか
ping <host>

# 2. SSHポートが実際に開いているか
nc -vz <host> 22

よくある原因: ポート番号の間違い(多くのホストが22番から変更しています)、ファイアウォールやセキュリティグループによるIPブロック、または sshd が起動していないこと。

接続がハングし、その後タイムアウトする

パケットは送信されているのに何も返ってこない場合、通常は**拒否(reject)ではなく破棄 (drop)**するタイプのファイアウォールが原因です。VPNを使用している場合は、まずそれを確認してください。

ホスト鍵の不一致

アプリは処理を停止し、両方のフィンガープリントを表示します。反射的に無視しないでください。

ホスト鍵が変わる理由はまったく異なる2つの可能性があります。サーバーが再インストールされた (正常)か、誰かが接続経路の途中に割り込んでいる(異常)かです。プロバイダーのコンソールや、たった今マシンを再インストールした同僚など、別の手段で確認してから、Forget host key を選び新しい鍵を信頼して再接続してください。

認証

パスワードが間違っている、または鍵が拒否される

SSH鍵の場合: .pub ファイルではなく秘密鍵を貼り付けましたか? パスフレーズがある場合、それは入力しましたか?
対応する公開鍵は、サーバー上の正しいアカウントの ~/.ssh/authorized_keys に実際に含まれていますか?
サーバー側のファイル権限を確認してください。もっとも見落とされがちな原因です。
```
chmod 700 ~/.ssh
chmod 600 ~/.ssh/authorized_keys
```
そもそもサーバーはパスワードログインを許可していますか? 多くのインストールでは PasswordAuthentication no がデフォルトです。

サーバー側のログを見れば、正確な理由が分かります。

sudo journalctl -u sshd -n 50

監視

有効にしたがまだデータがない

Vaultはロックされていませんか? ポーリングには認証情報が必要で、vaultがロックされているとすべてのタスクが停止します — ステータスバーを確認してください。
まだ順番が来ていないだけ。 タスクは約15秒以内に開始され、最初のサンプルは最初のポーリングが成功した後に表示されます。待ちたくない場合は Poll now を押してください。
監視用の認証情報は実際に選択されていますか? これはVMのデフォルト認証情報とは別のフィールドです。

CPU使用率やネットワーク速度が表示されない

どちらも2回のポーリングの間で算出されます。最初のポーリングには比較対象がないため、2回目が到着するまでこの2つの項目は空のままです。

到達不能とマークされたが、手動SSHはまだ使える

ポーリングは20秒以内に応答がないと失敗として扱われます。負荷の高いマシンではこれを超えてしまうことがある一方、インタラクティブなセッションは問題なく感じられることがあります。負荷を確認し、ホストがもともと遅い場合はポーリング間隔を長くしてください。

Vault

アプリを開くたびに毎回パスワードを聞かれる

OSのキーチェーンが利用できない状態です。Linuxの場合、Secret Service(GNOME Keyring、 KWalletなど)が起動してアンロックされていないことを意味します。前回 Lock vault を押した場合にも、これは想定どおりの動作です。

マスターパスワードを忘れた

設計上、復元はできません。パスワードVault → マスターパスワードを忘れた場合を参照してください。

パスワード変更が中断された

マスターパスワードの変更はトランザクション内で実行されます。中断された場合、トランザクションはロールバックされ、vaultは以前の状態のまま維持されます。古いパスワードでアンロックしてから、もう一度やり直してください。

それでも解決しない場合

サポートにメールする際は、次の情報を含めてください。返信が5分で済むか5日かかるかはここで決まります。

アプリのバージョンとOS、
何をして、何が起きたか、
エラーメッセージ(そのまま)、
問題がサーバー側にある場合は、そのLinuxディストリビューション。

秘密鍵、パスワード、authorized_keys の内容は含めないでください。サポート対応においてそれらが必要になることは一切ありません。