FAQ
      Back to home
      1. Adriel Academy
      2. Business Intelligence: Adriel Dashboard
      3. FAQ

      Troubleshooting: Data Not Loading in Adriel

      This expanded guide incorporates critical troubleshooting steps to ensure a systematic approach to resolving data loading issues in Adriel. Follow these steps to identify and fix the problem effectively.

      Navigation Summary

      1. Gathering Intel: Check the Icons
      2. Troubleshooting Steps
        1. Step 1: Verify the Data Sources in the Widget
        2. Step 2: Check the Date Range
        3. Step 3: Review Filters
        4. Step 4: Check Data Blend Configuration
      3. Advanced Troubleshooting
      4. Data Hygiene: Preventative Tips
      5. Appendix: Error Messages Reference

      1. Gathering Intel: Check the Icons

      Start by examining the Warning or Info icons on the Adriel dashboard. These provide initial clues about potential API issues.

      Icon Meanings

      • Warning Icon (⚠️) indicates critical issues like:
        • Broken connections.
        • Authentication errors.
        • Unsupported data formats.
        • See the full list of issues and trouble shooting steps here.

      What to do:

      • Hover over the⚠️icon for more information.
      • Click the icon (if available) to access detailed error logs or support articles.
      • Loading Icon (🔄) indicates an ongoing data fetch such as:  
        • Ongoing data sync. 
        • Delays in syncing due to external platform issues. 
      • "No data to show" text indicates that there is no data to be found for the selected data sources in the selected date range.

      Pro Tip: If you can't access specific views, verify that you have the correct permissions to access the data:

      • Check user roles and permissions in your Workspace settings. Make sure you have the relevant 

      2. Troubleshooting Steps

      -> Upon connecting a new source, please wait up to 30 minutes for the data to finish loading. 

      -> For data sources that have already been connected - if loading doesn't happen within a few minutes, the fetch may time out. Select the "Refresh Data" button on the top right of the navigation bar to reload the data. 

      Step 1: Verify the Data Sources in the Widget

      • Open the widget settings and confirm that all necessary data sources are included and active.

      • Ensure there are no missing connections or errors in the data source configuration. If there are, we'll let you know via the "Warning" icon (⚠️). 

      Navigate to the connections page to reconnect or reauthorize the disconnected data sources. 

      • Add and reconnect any overlooked data sources required for the widget. 

      Step 2: Check the Date Range

      • Ensure the selected date range covers the period for which data is expected. Verify that the start and end dates are accurate. Follow this guide for more information on dates. 

      Important: Verify that the source database or platform contains data for the selected filters, in the selected date range.

      Cross-check this with Adriel's data to ensure that the data matches up to the original source data. 

      Step 3: Review Filters

      To ensure your filters are properly set up, make sure to read and follow this comprehensive guide on Adriel's filters. 

      A. Teamspace-level Data Source Filters

      • Check the Teamspace data source filters that may be filtering out data on the dashboard level. 
        • Make sure that the Teamspace filters include the data sources that you want to see. 

      B. View-level and Widget-level AND/OR/EXCLUDE Filters

      • Double check your View-level filter (the filter icon at the top navigation bar) and Widget filter (within the individual widget's data settings) to ensure that your filters are set up properly. Refer to this guide on filters for more information. 

      To not lose any work, try duplicating the widget or the view to run some tests! If multiple filters are applied, remove one filter at a time to isolate potential conflicts and see what works. 



      Step 4: Check Data Blend Configuration

      • For our enterprise customers that utilize the Data Blend feature, make sure that your data blend set up is correct with this pro guide. For some quick tips: 
        • Ensure that custom datasets match Adriel’s format requirements (e.g., BigQuery, CSV, Google Sheets).
          • Ensure schema consistency and date format validity according to Adriel’s documentation (coming soon).
        • Check that your LEFT JOIN and FULL JOIN keys between datasets are configured properly.

        Data blending is complex; we know! Reach out to us via email at support.global@adriel.com or simply fill out this form for assistance 😊.


        3. Advanced Troubleshooting

        If the issue persists, consider these advanced strategies:

        Check Downtime and API Limits

        • Test the connection to the data source to confirm it’s active and not experiencing downtime.
        • Platforms often enforce quotas for API requests or data exports. 
        • If limits are exceeded, syncing may pause. Wait for the reset period or contact the platform.

        Pro Tip: Our connect team actively monitors API limits or downtime, so please review our logs or error messages (via the data source error panel and on our Chatbot) for issues related to API data extraction or loading. 

        Contact Adriel Support

        If an error you encountered is not there, please share the issue with our team so we can investigate what may be happening! 

        • Include the following when contacting support using this form: 
          • URLs of the affected dashboards.
          • Screenshots of error messages or icons.
          • A description of the affected data source(s) and widgets. 

        4. Data Hygiene: Preventative Tips

        Adopt these practices to minimize future data loading issues:

        • Monitor Adriel notifications about disconnected data sources and platform API updates to ensure that your Workspace is up to speed when you need to see your data 

        Pro Tip: Use Adriel's Alarms feature to be notified whenever a data source is disconnected. 

        • Monitor our Chatbot notifications about maintenance, updates, or policy changes.
        • Streamline filters and use minimal and specific filters to reduce query complexity.
        • Before troubleshooting, ensure the platform or database contains the expected data.

        By following these steps and leveraging the tips above, you can resolve most data loading issues efficiently. If you encounter persistent problems, don’t hesitate to contact Adriel support for assistance!

        Appendix: Error Messages Reference

        Here is a quick reference for common error messages and actions (the full list will be added soon!):

        Error Message

        Meaning

        Action

        Connection Error

        Data source connection is broken.

        Reconnect the data source.

        Authentication Required

        Credentials are invalid or expired.

        Reauthenticate with updated credentials.

        Unsupported Data Format

        Data does not match Adriel’s format requirements.

        Reformat data and upload.

        API Quota Exceeded

        API usage limit exceeded.

        Wait for reset or contact the platform.

        Invalid Date Range

        Selected date range exceeds limits.

        Adjust to a shorter range.

        Missing Data Sources

        Required data sources are not connected.

        Add missing sources in widget settings.