Portals for Tableau 101: Debug Mode

Data

Portals for Tableau 101: Debug Mode

Portals for Tableau 101 shares the basics of interacting with InterWorks' embedded analytics solution, Portals for Tableau.

One of the biggest selling points for Portals for Tableau is how feature-rich and flexible it is. Portals for Tableau supports numerous versions of Tableau Server, Tableau Online and Tableau Public; multiple sites within a Tableau Server; a bunch of authentication methods and SAML identity providers; lots of web server platforms; tons of dashboard features; and a myriad of portal theme and configuration options. That’s a lot of moving parts.

When Things Go Wrong

While we do our best to have the portal run flawlessly regardless of your environment, sometimes things just don’t work like they should. Occasionally, it’s the portal’s fault, but other times, it’s some other component specific to your setup. Nevertheless, the root cause of the issue needs to be found and fixed as quickly as possible.

If you ever find yourself with some feature of the portal not behaving like it should and throwing a tantrum, it can be overwhelming trying to pinpoint where the issue might lie. Your first step should be to reach out to Assist by InterWorks (or use the backend Contact Us form to report the issue). However, if we can’t immediately identify the cause based on the behavior or error message, we may need a little more information. Often, we can get that additional information by switching your portal into debug mode, recreating the scenario that caused the problem and then looking through the debug logs for the culprit.

If we can access your portal directly, we can do that ourselves. However, many portals are locked away behind a firewall. In those cases, we’ll have to rely on you to perform those steps. This post will outline the steps you’ll need to take to send us those logs.

Process for Providing Debug Logs

The first step is to tell the portal to turn on debug logging. To do so, you’ll need to log in to your portal’s frontend. Once logged in, add ?debug=1 to the end of the URL in your browser. However, if you already had a question mark in the URL, then add &debug=1 instead. Hit enter to load the page and start debug mode. You’ll notice a new toolbar at the bottom of the screen. Ignore it for now:

Next, recreate the issue you’re experiencing. This could mean navigating to another page or clicking a button. There might even be multiple steps you’ll need to perform to make it happen again. Whatever the case, the goal here is to break it in the same way you saw it broken before.

Pass Along the Debug Logs

After the portal throws its tantrum again, the next step is to download the debug logs and send them to us. Now, it is time to turn your focus to that new toolbar that appeared at the bottom of the screen on the frontend. This will provide the debugging information we need to troubleshoot. Within that toolbar is a button to export the logs to a file. It should be located on the right side of the toolbar. Once you find it, go ahead and click that button, save the file it gives you, email it to us, and rest easy that we are diligently working behind the scenes to find a fix for the glitch:

More About the Author

Matthew Orr

Solutions Architect
Portals for Tableau 101: Contact Us Forms Disclaimer: This is a more advanced topic than our typical 101 blogs. You will need to feel somewhat comfortable with editing HTML code ...
Portals for Tableau 101: Setting up SSL/TLS Certificates for HTTPS If your portal is available to the World Wide Web, we highly recommend setting up encryption for the connection between your users and ...

See more from this author →

Subscribe to our newsletter

  • I understand that InterWorks will use the data provided for the purpose of communication and the administration my request. InterWorks will never disclose or sell any personal data except where required to do so by law. Finally, I understand that future communications related topics and events may be sent from InterWorks, but I can opt-out at any time.
  • This field is for validation purposes and should be left unchanged.

InterWorks uses cookies to allow us to better understand how the site is used. By continuing to use this site, you consent to this policy. Review Policy OK

×

Interworks GmbH
Ratinger Straße 9
40213 Düsseldorf
Germany
Geschäftsführer: Mel Stephenson

Kontaktaufnahme: markus@interworks.eu
Telefon: +49 (0)211 5408 5301

Amtsgericht Düsseldorf HRB 79752
UstldNr: DE 313 353 072