1. Check that Open Access is configured correctly.
2. Check the list of common problems:
3. Check the content that does not work on Open Access pages.
1. Configuring Open Access
Open Access enables easy sharing of dashboards, that do not require authentication to view. As no user is logged in, the SquaredUp enterprise application (service principal) is used. Open Access dashboards will only show resources, resource groups or subscriptions for which the enterprise application has at least the role of Reader.
2. Common Problems
"Error loading dashboard - An error occurred loading this dashboard"
If you see the following error, you should check the Open Access loopback URL:
"No resources", "No entities" or "Subscription not found"
"No resources matched the specified scope."
"No entities found."
"The subscription was not found in the list of available subscriptions."
"There are no Azure subscriptions available: Check the Access Control (IAM) role and scope for the subscriptions you intend to access."
To allow resources to show on Open Access dashboards you need to give the SquaredUp enterprise application Reader access to the resource, resource group or subscription as described in How to configure Open Access.
Open Access dashboards do not show all the resources on a tile
Some tiles on the Open Access page are not shown
You may need to increase the time between the dashboard being loaded and snapshot being taken.
Open Access dashboards are cut off or show an unusable fixed scroll bar
If the full length of the Open Access page is not shown or fixed scroll bars are visible then you may need to increase some settings.
"Error loading dashboard - A valid mapping was not found for the given ID: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx, there may be more information available in your log file."
"You do not have the required permissions or your current license does not include Open Access"
3. Content that does not work on Open Access pages
- Open Access dashboards are non-interactive so users will not be able to hover or drill down for more information. You may wish to design your dashboards slightly differently with Open Access in mind. For example, you should consider adding a key to a performance line graph.
- Web Content tiles are not supported with Open Access, because in many cases they do not work. Slow webpages may show as blank in Open Access. Webpages requiring authentication will not work because Open Access does not use any authentication.
Reference - Open Access settings
This table shows the most used Open Access settings as described in this article. Most values are in milliseconds (ms), but
oa-refresh-interval is in seconds.
|oa-loopback-base-url||Base loopback URL||https://localhost||https://CertificateURL|
|oa-ajax-complete-wait||How long to wait after an ajax call before assuming all calls are complete in ms (1000 ms is 1 second)||1000||5000|
|oa-width-resize-wait||Timeout applied before doing the width in ms (300 ms is 0.3 seconds)||300||1000|
|oa-height-resize-wait||Timeout applied before doing the length in ms (300 ms is 0.3 seconds)||300||1000|
|oa-engine-logging||When this is enabled an OpenAccessEngine.log file is generated in F:\squaredupv4\Transient\Log||false||true (if troubleshooting)|
|oa-verbose-logging||When enabled SSR will log verbosely||false||true (if troubleshooting)|
|oa-refresh-interval||Open Access dashboard refresh interval in seconds (not in ms) (60 seconds)||60||60|
|oa-theme||Open Access dashboards in SquaredUp for Azure default to dark theme, but can be changed to lighttheme||darktheme||lighttheme (if preferred)|
Once troubleshooting is complete, remove the
"oa-engine-logging": true, and
"oa-verbose-logging": true lines and remove the comma from the last line.