Power BI Gateway Configuration

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

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

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:

  • 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

  1. Go to the Power BI Gateway download page

  2. Click Download standard mode (or personal mode if for individual use)

  3. Run the downloaded installer

Step 2: Install the Gateway

  1. Accept the terms and click Install

  2. Choose the installation path (default is usually fine)

  3. Wait for the installation to complete

  4. Click Close when finished

Step 3: Configure the Gateway

  1. Launch the On-premises data gateway application

  2. Sign in with your Power BI account

  3. Select Register a new gateway on this computer

  4. Enter a gateway name (e.g., "Learn Amp Reporting Gateway")

  5. Create a recovery key β€” store this securely!

  6. 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:

  1. Open Power BI Service (app.powerbi.com)

  2. Click the Settings gear icon β†’ Manage connections and gateways

  3. Select your gateway cluster

  4. Click + New to add a data source

  5. 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

  6. Click Create

For API Connection:

  1. Follow steps 1-4 above

  2. 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)

  3. 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

  1. In Power BI Service, go to your workspace

  2. Find your dataset (hover over it and click β‹― β†’ Settings)

  3. Expand Gateway connection

  4. Select your gateway and map the data sources

  5. Click Apply

Step 6: Configure Scheduled Refresh

  1. In dataset settings, expand Scheduled refresh

  2. Toggle Keep your data up to date to On

  3. 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)

  4. Optionally enable Send refresh failure notifications

  5. Click Apply


Gateway Best Practices

Performance Recommendations

Recommendation

Benefit

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:

  1. Gateway clusters: Install multiple gateways in the same cluster for failover

  2. Load balancing: Distribute queries across gateway members

  3. 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

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

  1. Open On-premises data gateway application

  2. Click Diagnostics tab

  3. Click Export logs

  4. Review logs for error messages


Refresh Schedule Examples

Daily Morning Update

Ideal for reports reviewed at the start of the workday:

Setting

Value

Setting

Value

Frequency

Daily

Time

06:00

Timezone

Your local timezone

Twice Daily

For reports needing mid-day updates:

Setting

Value

Setting

Value

Frequency

Daily

Times

06:00, 13:00

Timezone

Your local timezone

Hourly (Premium)

For near-real-time dashboards (requires Premium):

Setting

Value

Setting

Value

Frequency

Daily

Times

Every hour from 07:00 to 19:00

Timezone

Your local timezone


Next Steps