Troubleshooting scatter/area map display issues on on-prem linux environments [Linux]
This article addresses common issues with the Scatter Map widget in Sisense, specifically when the map does not display as intended. By following the steps outlined here, you can diagnose and resolve issues preventing the map from rendering properly within your Sisense dashboard. Relevant for On-Prem Linux instances.
Step-by-Step Guide:
1. Verify Network Configuration:
- Check your firewall or proxy settings to ensure HTTPS traffic (port 443) is allowed to and from Mapbox domains:
mapbox.com
www.mapbox.com
api.mapbox.com
api.tiles.mapbox.com
a.tiles.mapbox.com
b.tiles.mapbox.com
c.tiles.mapbox.com
d.tiles.mapbox.com
events.mapbox.com
2. Whitelist Mapbox Domains:
- Coordinate with your internal Cloud, DevOps, or Network Security team to whitelist Mapbox domains.
- Avoid whitelisting specific IP addresses, as these can change; using domain names like api.mapbox.com is more reliable.
3. Check Connectivity to Mapbox:
- Use the ping command or curl command to verify connectivity to https://api.mapbox.com. For example:
curl -I https://api.mapbox.com
- A successful connection should return a 200 OK response.
4. Update Security Settings in Sisense:
- Navigate to the Admin tab in Sisense and select Security Settings from the left-hand menu.
- Add api.mapbox.com to the Embedded Domain White List.
5. Collect Further Information for Troubleshooting:
- If the issue persists, capture a .HAR file while reproducing the issue. This can provide a detailed log of network requests and help identify the problem.
- Instructions for generating a .HAR file can be found here.
Conclusion:
Ensuring the Scatter Map displays correctly involves verifying network connectivity and updating firewall configurations to allow communication with the necessary Mapbox services. By whitelisting the appropriate domains and confirming SSL/TLS settings, most display issues can be resolved. For persistent problems, generating a .HAR file or contacting support may be necessary.
References/Related Content
Disclaimer: This post outlines a potential custom workaround for a specific use case or provides instructions regarding a specific task. The solution may not work in all scenarios or Sisense versions, so we strongly recommend testing it in your environment before deployment. If you need further assistance with this, please let us know.
