サポートのために MetaMask ログをエクスポートするにはどうすればよいですか? (トラブルシューティング)

MetaMask ログ収集について

1. MetaMask は、その UI 内に組み込みの「ログのエクスポート」ボタンを公開しません。ログは実行時に内部で生成され、ブラウザのメモリまたはコンソール出力に一時的に保存されます。

2. この拡張機能は、特にトランザクションの失敗、ネットワークの構成ミス、または署名エラーが発生した場合に、標準のブラウザ開発者ツールに依存して診断情報を表示します。

3. ユーザーは、Chrome DevTools、Firefox Developer Edition、または Edge F12 ツールを使用してコンソール出力を手動でキャプチャする必要があります。現在の拡張機能バージョンには自動ログ アーカイブ機能がありません。

4. ログには、タイムスタンプ、RPC リクエスト ペイロード、エラー スタック トレース、ウォレット アドレス参照、およびchainId や EIP-1559 パラメータの不一致などの検出されたネットワーク識別子が含まれます。

5. 秘密キー、シード フレーズ、復号化された資格情報などの機密データがこれらのログに表示されることはありません。 MetaMask は、コンソールへの書き込み操作の前に、厳密なクライアント側のサニタイズを強制します。

ステップバイステップのコンソールログキャプチャ

1. MetaMask を開いて問題を再現します。これにより、関連するイベントがコンソール バッファーに確実に取り込まれます。

2. MetaMask ポップアップまたは dApp ページの任意の場所を右クリックし、「検査」を選択して DevTools を起動します。

3. [コンソール] タブに移動し、[設定] (歯車) アイコンをクリックして [ログの保存] を有効にします。これにより、ナビゲーションまたはポップアップのリロード時にログが消去されなくなります。

4. スワップの承認やメッセージへの署名など​​、問題のあるアクションを再度トリガーして、新しいエントリを生成します。

5. コンソール パネル内を右クリックし、[名前を付けて保存…] を選択して、表示されているログ ストリームをプレーン テキスト ファイルとしてエクスポートします。このエクスポートされたファイルは、サポート チームが優先順位付けに必要なものです。

重要なログ指標の特定

1. 「MetaMask:」プレフィックスを含む行は、権限チェックやプロバイダーの切り替え動作などの内部拡張ロジックを示します。

2. 「RPC エラー」で始まり、その後に -32603 や -32000 などのコード番号が続くエラーは、バックエンド ノードの拒否を示します。MetaMask のバグ自体ではなく、デバッグにとって重要なコンテキストです。

3. 「認識されないチェーン ID」または「無効な 16 進文字列」に関する警告は、dApp の期待値とユーザーが選択したネットワーク設定の間の構成のずれを直接示しています。

4. 「プロバイダーが設定されていません」または「アカウントが見つかりません」というメッセージが繰り返されると、多くの場合、ブラウザーの再起動またはタブ分離ポリシー後の切断状態に遡ります。

5. 「eth_signTypedData_v4 が失敗しました」または「ユーザーがトランザクション署名を拒否しました」が発生した場合は、先行する完全な RPC 要求/応答ペアを使用して分離する必要があります。

エクスポート中によくある間違い

1. MetaMask のバックグラウンド スクリプト コンテキストではなく、dApp のコンソールからのみログをキャプチャすると、署名処理やアカウント管理フローの可視性が不完全になります。

2. 広告ブロッカーやプライバシー強化機能など、コンソール出力をフィルタリングまたはミュートするブラウザ拡張機能を使用すると、重要な警告がユーザーに届く前に抑制される可能性があります。

3. タイムスタンプや完全なスタック トレースのない切り詰められた出力をコピーアンドペーストすると、イベント シーケンスの再構築に必要な時間的相関が削除されます。

4. 生のテキストではなくスクリーンショットを保存すると、検索性が失われ、サポート ツールによる自動解析が妨げられます。

5. ENS 名やウォレット アドレスなどの個人識別子を編集せずに含めることは、すべての主要な Web3 サポート デスクで遵守されている基本的な運用セキュリティ プロトコルに違反します。

よくある質問

Q: MetaMask ポップアップを閉じた後にログを取得できますか? A: 事前に「ログの保存」が有効になっており、ブラウザのタブが開いたままになっている場合に限ります。バックグラウンド スクリプト ログは、拡張プロセスが終了すると消えます。

Q: モバイル MetaMask ログも同じように機能しますか? A: いいえ。iOS および Android バージョンでは、コンソールへのアクセスが公開されません。ユーザーは、明示的な再現手順とネットワーク選択の詳細を含むスクリーンショットベースのレポートに依存する必要があります。

Q: インターネットが動作しているにもかかわらず、MetaMask に「取得に失敗しました」と表示されるのはなぜですか? A: これは通常、接続障害ではなく、ブロックされたカスタム RPC エンドポイントまたは到達不能なカスタム RPC エンドポイントを反映します。ログには、ノードから返された正確な URL と HTTP ステータス コードが含まれます。

Q: 手動でキャプチャせずに MetaMask アクティビティを継続的に記録する方法はありますか? A: ネイティブではありません。サードパーティのブラウザ自動化ツールはコンソール出力を傍受する可能性がありますが、それを行うと MetaMask の利用規約に違反し、セキュリティ リスクが生じます。