How do I enable verbose logging in Headless Chromium for troubleshooting?

Verbose logging in headless Chromium can be quite useful when troubleshooting issues such as rendering problems or script errors. To enable verbose logging, you'll typically need to pass command-line arguments to the Chromium process.

Here's how to enable verbose logging in headless Chromium:

Using Command Line

When running Chromium from the command line, you can use the --enable-logging and --v=1 flags to enable verbose logging. The --v flag sets the verbosity level (for example, --v=1 is less verbose, while --v=99 is very verbose). You can also redirect the logs to a file using the --log-net-log flag.

chromium-browser --headless --enable-logging --v=1 --log-net-log=/path/to/logfile.json

Using ChromeDriver with Selenium

If you're using Selenium with ChromeDriver to control headless Chromium, you can configure the WebDriver to start Chromium with the necessary flags for verbose logging. Below is an example using Python with Selenium:

from selenium import webdriver
from import Options
from import Service
from import ChromeDriverManager

# Configure Chrome options
chrome_options = Options()

# Specify the path to the log file
service = Service(ChromeDriverManager().install())
service.log_path = "/path/to/chromedriver.log"

# Start the WebDriver with the configured options
driver = webdriver.Chrome(service=service, options=chrome_options)

# Your web scraping code goes here

# Quit the driver to end the session

Using Puppeteer with Node.js

When using Puppeteer, a Node.js library to control headless Chromium, you can pass the arguments to puppeteer.launch():

const puppeteer = require('puppeteer');

(async () => {
  const browser = await puppeteer.launch({
    headless: true,
    args: [

  // Your web scraping code goes here

  await browser.close();

Analyzing the Logs

Once you've enabled verbose logging, you can analyze the logs for errors, warnings, or other information that can help you troubleshoot the issue. If you've redirected the logs to a file, you can view the file using any text editor or command-line tools like cat, less, or tail in Linux/MacOS, or using Notepad, PowerShell, etc., in Windows.


  • The exact command-line flags and their availability may change between different versions of Chromium. Always consult the official documentation or --help flag for the latest information.
  • Verbose logging can generate a lot of data, which may impact performance or use significant disk space. Use it only when necessary for troubleshooting.
  • The file paths and options used in the examples above should be adjusted based on your specific environment and requirements.
  • If you're using ChromeDriver, make sure it's compatible with the version of Chromium you are using.

In summary, enabling verbose logging in headless Chromium is a matter of passing the correct command-line arguments when starting the browser or configuring your code accordingly when using tools like Selenium or Puppeteer.

Related Questions

Get Started Now

WebScraping.AI provides rotating proxies, Chromium rendering and built-in HTML parser for web scraping