ログは、DNS、TCP 接続、TLS またはプロトコルのハンドシェイク、ルールの一致、制御インターフェースという段階に分けて判断します。最初の失敗記録を探し、lookup、dial、handshake などのキーワードから発生箇所を特定してください。一度の再現に必要なログだけを残し、クライアント、カーネル、システムの各バージョンを添えます。共有する前に、URL、token、secret、IP、ノードの認証情報を伏せてください。
最初に読むべきログの行
再現操作を行った時刻から後にある最初のエラーを探し、lookup、dial、handshake、parse、unauthorized の各キーワードから失敗箇所を判断します。
- エラーに lookup、dial、connect、handshake、unauthorized、parse のいずれかが含まれているか
- エラーがサブスクリプションの更新、ノード接続、Dashboard へのアクセスのどこで起きているか(参照: 実行時の制御)
- 特定のドメインまたは特定のノードだけで起きるか
- ログレベルが不足せず、過剰でもないか
エラーが起きた段階に応じて調査を続ける
- まずエラーが起きた時刻と操作を特定します
- キーワードからエラーが起きた段階を判断します
- サブスクリプションの完全な URL、token、ノードのパスワード、実際の IP を伏せてから共有します(参照: セキュリティ FAQ)
- 再現時には、クライアント、カーネル、システムの各バージョンと設定の入手元を記録します
debug ログは短時間の調査に適しており、常時有効にすることは推奨しません
ログには、ドメイン、IP、ノード名、サブスクリプションの URL、secret が含まれる場合があります
最後の一行だけをスクリーンショットにしても、通常は問題を特定するには不十分です
