Getting MetaMask Logs
To help us deliver better support, we might ask you to provide your MetaMask state logs to further analyze the issues you face. These logs tell us:
- Your account addresses
- Your sent transaction history
- Your internal UI State
They don’t reveal:
- Your Private Keys
- Your Secret Recovery Phrase
Despite this, DO NOT POST YOUR LOGS PUBLICLY.
There are four types of logs that we might ask you to provide:
If you've had an issue sending transactions or found a visual glitch in the rendering of MetaMask, we might ask you for a state log. To get them:
- Open MetaMask and ensure it's unlocked
- Click on your Account icon on the top right corner
- Click on Settings and then select Advanced
- Click on Download State Logs
- Attach the file in your response on a support ticket
- In the MetaMask app, tap the Menu icon on the top left of the app
- Tap on Settings (gear icon)
- Select Advanced
- Scroll down and tap on "Download State Logs"
- Attach the file in your response on a support ticket
To get logs from the popup:
- Click the MetaMask fox in the top right of your browser.
- Wait for the popup to open (or partially open if that's part of the bug).
- Right-click in the newly opened popup, and select Inspect.
- Click Console at the top of the Inspector window.
- Look for any strange logs, especially red errors!
- Share a screenshot with us.
To get logs from MetaMask's background process in Chrome:
- Right-click the MetaMask fox in the top right of your browser.
- Select Manage Extensions.
- Ensure "Developer Mode" is selected in the top right.
- Scroll down to MetaMask, and click the "Inspect views: background page" link.
- Click Console at the top of the Inspector window.
- Look for any strange logs, especially red errors!
If you are using Windows OS, usually you could see the state logs in your Downloads folder.
If your bug involves crashing the whole browser, then having a browser console won't be much good! (It will be crashed).
In these cases, you'll need to start your browser in a way that it writes its logs to the disk, so you can open that log file after the browser crashes.
This process is described here, and we hope to write more specific steps on this in the future. If you have to go through this process, please do record the steps, so we can have more detailed instructions here for different platforms.
