Welcome to the Alteryx Knowledge Base

How To: Enable MongoDB logs in RuntimeSettings.xml
user

Created/Edited - 4/28/2026 by Tyler Nguyen | Alteryx

How To

Enable MongoDB logs in RuntimeSettings.xml

 

When troubleshooting Server/Gallery issues, it can be useful to gather logs to determine whether the issue lies with your MongoDB. These steps will show you how to enable Mongo logging.

Environment
  • Alteryx Server
  • Embedded MongoDB
Prerequisites
  • Administrative Rights
Procedure
  1. ALWAYS BACK UP FIRST. Make sure to make a copy of your RuntimeSettings.xml as well as your MongoDB. See this article for Backup & Recovery Best Practices

  2. Stop your Alteryx Service

  3. Open File Explorer and navigate to %PROGRAMDATA%\Alteryx

    IbEzdrN 

  4. Open RuntimeSettings.xml in a text editor

  5. Under the Controller section add EmbeddedMongoDBLogPath as a key
    Zl2d0k0 

  6. Add a directory as the value with .txt file extension.
    apDKTMI 

  7. **OPTIONAL If you would like to have the logs with increased verbosity**
    1. Under the Controller section add EmbeddedMongoDBArguments as a key
      nxQocde 

    2. Add --vv as the value
      qqiG1Yh 

  8. Start your Alteryx Service and Mongo logs should be generating

    2spynow 

 

Additional Information
Was this article helpful?