Studio is Unresponsive/Freezing

There are a number of reasons you may be experiencing poor performance in Studio.

Requirements

Browser

Studio supports recent versions of "evergreen" browsers. The most supported browser is Chrome (which typically is expected to provide the most optimized experience); however, Firefox, Safari, and Edge are also supported. Foursquare Studio uses the latest JavaScript, HTML, and web GPU technologies and does not provide support for legacy browsers (like Internet Explorer 11, pre-Chromium Edge, etc).

Hardware

The performance of Studio will depend on the computer's hardware. In particular, the GPU and the memory will affect performance and the size of data that can be loaded. On systems with both internal and external GPUs (for instance MacBook Pros with external GPU card), Studio requests the most powerful GPU available. Studio does not provide support for running browsers with software GPU drivers.

Ensure your browser supports WebGL

Visit https://get.webgl.org/ to ensure your browser supports WebGL.

Enable Hardware Acceleration in Chrome

Studio makes use of Chrome's hardware acceleration feature. Follow the instructions below to enable hardware acceleration in Chrome:

Start Chrome, then select Menu > Settings.
Scroll down to select the Advanced option.
Click the System section, then enable Use hardware acceleration when available.

Known Bugs

AMD MacBooks using Chrome

We have observed a known performance regression while using Chrome on MacBook + AMD Radeon 500 series GPU. While under investigation, it is believed this issue is caused by an unknown performance bug in Apple's OpenGL drivers. The recommendation from the Chrome team is to turn on Metal backed ANGLE in your Chrome's about:flags.

See: https://bugs.chromium.org/p/chromium/issues/detail?id=1245448#c22

Data Connectors

This section details common issues and solutions for Data Connectors.

Google BigQuery Connector Not Working

Update BigQuery Connectors for v1.39

Note: This section is only relevant to customers who configured a BigQuery connector prior to May 25th, 2022.

On May 25th, 2022, Studio released Version 1.39, which featured performance improvements for the BigQuery connector, facilitating faster data retrieval when making BigQuery queries.
As part of these performance upgrades, our backend now makes use of the BigQuery Storage API. Unfortunately, this update caused our BigQuery connector to require one additional BigQuery permission.

The connector now requires three roles:

BigQuery Read Session User (newly required as of May 25th, 2022)
BigQuery Data Viewer
BigQuery Job User

Add New Permission to Existing Service Account

To update the roles for service accounts that are already uploaded into Studio, follow these instructions:

1. Navigate to the GCP Console IAM page.

Link to GCP Console IAM page: https://console.cloud.google.com/iam-admin/iam

2. Add the new role to the Studio service accounts.

For any service accounts currently in use in Studio, click the pencil icon on the right side. Choose Add Another Role >> BigQuery Read Session User.