Power BI Gateway Configuration
Power BI Gateway Configuration
Overview
To enable automatic data refresh for your Learn Amp reports in Power BI Service, you'll need to configure a data gateway. This guide walks you through setting up the on-premises data gateway for both Data Lake and API connections.
π‘ Tip: A gateway is required when your data source isn't directly accessible from Power BI Service in the cloudβthis includes the Learn Amp Data Lake (Redshift) and potentially API connections depending on your network setup.
Functionality Breakdown
What is a Power BI Gateway?
A Power BI Gateway acts as a bridge between Power BI Service (in the cloud) and your data sources. It enables:
Scheduled refresh β Automatically update reports on a schedule
Live connections β Query data in real-time (for supported sources)
Secure data transfer β Encrypted communication between your network and Power BI
Gateway Types
Type | Best For | Setup Complexity |
|---|---|---|
On-premises data gateway (standard mode) | Shared use across multiple users and reports | Moderate |
On-premises data gateway (personal mode) | Single user, quick setup | Simple |
π‘ Tip: For team use, we recommend the standard mode gateway to enable sharing and centralised management.
Pre-requisites
Role Requirements
Action | Required Role |
|---|---|
Install gateway | Windows administrator on host machine |
Configure gateway in Power BI | Power BI Service administrator or workspace admin |
Add data sources | Gateway admin or delegated user |
Technical Requirements
Windows machine (Windows 10, Windows Server 2016 or later)
.NET Framework 4.7.2 or later
8 GB RAM minimum (16 GB recommended)
Network access to:
Power BI Service (*.powerbi.com)
Learn Amp Data Lake (bi.la-dl.com:5439) β for Data Lake connections
Learn Amp API (api.learnamp.com) β for API connections
Always-on availability β the gateway machine must remain powered on for scheduled refreshes
β οΈ Important: The gateway cannot be installed on a domain controller or a machine that's frequently shut down.
Quick Start Guide
Step 1: Download the Gateway
Go to the Power BI Gateway download page
Click Download standard mode (or personal mode if for individual use)
Run the downloaded installer
Step 2: Install the Gateway
Accept the terms and click Install
Choose the installation path (default is usually fine)
Wait for the installation to complete
Click Close when finished
Step 3: Configure the Gateway
Launch the On-premises data gateway application
Sign in with your Power BI account
Select Register a new gateway on this computer
Enter a gateway name (e.g., "Learn Amp Reporting Gateway")
Create a recovery key β store this securely!
Click Configure
β οΈ Warning: The recovery key is essential for migrating or recovering your gateway. Store it in a secure location.
Step 4: Add Data Sources
For Data Lake (Redshift) Connection:
Open Power BI Service (app.powerbi.com)
Click the Settings gear icon β Manage connections and gateways
Select your gateway cluster
Click + New to add a data source
Configure:
Data Source Name: Learn Amp Data Lake
Data Source Type: Amazon Redshift
Server: bi.la-dl.com
Database: Your database name (e.g., prod_eu1)
Authentication Method: Basic
Username: Your Data Lake username
Password: Your Data Lake password
Click Create
For API Connection:
Follow steps 1-4 above
Configure:
Data Source Name: Learn Amp API
Data Source Type: Web
URL: https://api.learnamp.com/v1/activities (or your specific endpoint)
Authentication Method: Anonymous or OAuth2 (depending on your setup)
Click Create
π‘ Tip: For API connections, you may need to handle token refresh in your Power Query code since OAuth tokens expire.
Step 5: Assign Data Source to Dataset
In Power BI Service, go to your workspace
Find your dataset (hover over it and click β― β Settings)
Expand Gateway connection
Select your gateway and map the data sources
Click Apply
Step 6: Configure Scheduled Refresh
In dataset settings, expand Scheduled refresh
Toggle Keep your data up to date to On
Set your refresh frequency:
Refresh frequency: Daily or Weekly
Time zone: Select your timezone
Time: Add refresh times (up to 8 per day on Pro, 48 on Premium)
Optionally enable Send refresh failure notifications
Click Apply
Gateway Best Practices
Performance Recommendations
Recommendation | Benefit |
|---|---|
Use a dedicated machine | Avoids resource contention |
Install on SSD storage | Faster data processing |
Ensure stable network | Reduces refresh failures |
Monitor gateway health | Catch issues early |
Security Considerations
Firewall rules: Ensure outbound connections to Power BI and data sources are allowed
Service account: Consider running the gateway service under a dedicated service account
Updates: Keep the gateway software updated for security patches
Recovery key: Store securely and rotate periodically
High Availability (Enterprise)
For mission-critical reporting, consider:
Gateway clusters: Install multiple gateways in the same cluster for failover
Load balancing: Distribute queries across gateway members
Monitoring: Set up alerts for gateway health
FAQs
Do I need a gateway for Data Lake connections?
Yes, the Learn Amp Data Lake (Redshift) isn't directly accessible from Power BI Service. A gateway bridges this connection.
Can multiple users share one gateway?
Yes! The standard mode gateway supports multiple users and datasets. Gateway admins can grant access to specific users.
How often can I refresh my data?
Power BI Pro allows up to 8 scheduled refreshes per day. Power BI Premium allows up to 48 refreshes per day (every 30 minutes).
What happens if the gateway machine goes offline?
Scheduled refreshes will fail. Power BI will retry, but if the gateway remains offline, you'll need to manually trigger a refresh once it's back online.
Can I use a personal gateway for Data Lake?
Yes, but it's limited to your own use and cannot be shared. For team reporting, use the standard mode gateway.
Troubleshooting
Issue | Solution |
|---|---|
Gateway shows offline | Check the machine is running and has network access. Restart the gateway service. |
Refresh fails with credentials error | Re-enter data source credentials in gateway settings. |
"Unable to connect" error | Verify firewall rules allow outbound traffic on required ports (5439 for Redshift). |
Slow refresh performance | Check gateway machine resources. Consider upgrading RAM or using SSD. |
"Data source not found" error | Ensure the data source is added to the gateway and mapped to your dataset. |
Gateway not appearing in settings | Verify you have admin access to the gateway cluster. |
Checking Gateway Logs
Open On-premises data gateway application
Click Diagnostics tab
Click Export logs
Review logs for error messages
Refresh Schedule Examples
Daily Morning Update
Ideal for reports reviewed at the start of the workday:
Setting | Value |
|---|---|
Frequency | Daily |
Time | 06:00 |
Timezone | Your local timezone |
Twice Daily
For reports needing mid-day updates:
Setting | Value |
|---|---|
Frequency | Daily |
Times | 06:00, 13:00 |
Timezone | Your local timezone |
Hourly (Premium)
For near-real-time dashboards (requires Premium):
Setting | Value |
|---|---|
Frequency | Daily |
Times | Every hour from 07:00 to 19:00 |
Timezone | Your local timezone |
Next Steps
Build reports using Sample Power BI Report Templates
Create custom calculations with Calculated Measures and DAX Examples
Contact Customer Support for gateway troubleshooting assistance