Gateway: Power BI'ın Sessiz Kabusu

Power BI forumlarında en çok yardım istenen konulardan biri Gateway sorunlarıdır. _"Gateway bağlantısı kesildi"_, _"Scheduled refresh başarısız"_, _"Gateway çok yavaş"_ — bu mesajlar her gün yüzlerce kez paylaşılır.

On-Premises Data Gateway, şirket içi veri kaynaklarınızı (SQL Server, Oracle, SAP, dosya paylaşımları) Power BI Service'e bağlayan köprüdür. Köprü sağlam olmazsa raporlarınız eski kalır.

Gateway Mimarisi

💡Gateway giden (outbound) bağlantı kullanır — firewall'da gelen port açmanız gerekmez. Gateway, Azure Service Bus üzerinden Power BI Service'e bağlanır.

En Sık Karşılaşılan Hatalar

Hata 1: "Unable to connect" — Bağlantı Hatası

Kontrol listesi:

  • Windows Service "On-premises data gateway service" çalışıyor mu?
  • Gateway makinesinden veri kaynağına bağlanabiliyor musunuz? (SSMS, sqlcmd ile test)
  • Gateway'deki veri kaynağı credential'ları güncel mi?
  • Proxy veya firewall *.servicebus.windows.net'i engelliyor mu?

Hata 2: "The gateway is not reachable" — Gateway Erişilemiyor

Bu hata genellikle şu durumlarda oluşur:

  • Gateway makinesi kapalı veya restart edilmiş (Windows Update!)
  • Ağ bağlantısı kopmuş
  • SSL/TLS sertifika sorunu
PowerShell
# Gateway bağlantısını test et (Gateway makinesinde çalıştırın)
Test-NetConnection -ComputerName *.servicebus.windows.net -Port 443
Test-NetConnection -ComputerName login.microsoftonline.com -Port 443
Test-NetConnection -ComputerName *.frontend.clouddatahub.net -Port 443
⚠️Forum Hatası #1: Windows Update sonrası Gateway servisi otomatik başlamayabilir. Startup Type = Automatic olduğundan emin olun.

Hata 3: Scheduled Refresh Başarısız

| Neden | Çözüm |

|---|---|

| Gateway offline | Servisi başlatın |

| Credential expired | Gateway'den credential güncelleyin |

| Query timeout | Timeout süresini artırın |

| Bellek yetersiz | Gateway makinesine RAM ekleyin |

| Veri kaynağı yoğun | Yenileme saatini kaydırın |

Hata 4: Gateway Çok Yavaş

Gateway performans sorunlarının en yaygın nedenleri:

Gateway Minimum Donanım Gereksinimleri:

  • CPU: 8 core (önerilen)
  • RAM: 16 GB (minimum 8 GB)
  • Disk: SSD
  • Ağ: Stabil, düşük latency

Gateway Cluster: Yüksek Erişilebilirlik

Tek bir Gateway makinesi arızalandığında tüm yenilemeler durur. Gateway Cluster ile birden fazla makine arasında yük dağılımı ve failover sağlarsınız.

Cluster kurulum adımları:

  • İlk Gateway'i normal kurun
  • İkinci makinede Gateway kurulumunda "Add to existing cluster" seçin
  • Aynı recovery key'i girin
  • Power BI Service'te cluster otomatik görünür
💡Cluster'da en az 2 aktif node bulundurun. Yük dağılımı otomatik yapılır.

Gateway vs VNet Gateway

Fabric ve Power BI Premium kullanıyorsanız VNet Data Gateway alternatifini değerlendirin:

| Özellik | On-Premises Gateway | VNet Gateway |

|---|---|---|

| Kurulum | Fiziksel/VM makine | Azure portal'dan |

| Bakım | Siz yönetirsiniz | Microsoft yönetir |

| Güncelleme | Manuel | Otomatik |

| Maliyet | Makine + lisans | Fabric kapasitesi içinde |

| Uygunluk | Şirket içi kaynaklar | Azure VNet'teki kaynaklar |

Gateway Log Analizi

Sorunları teşhis etmek için Gateway loglarını inceleyin:

TEXT
# Log konumu:
C:\Users\<GatewayServiceAccount>\AppData\Local\Microsoft\On-premises data gateway\
# veya
%LocalAppData%\Microsoft\On-premises data gateway\

# Önemli log dosyaları:
# - GatewayErrors.log → Hata detayları
# - Report_<date>.log → Sorgu performansı
# - GatewayInfo.log → Genel bilgi
⚠️Log dosyalarını Power BI support'a gönderirken Gateway > Diagnostics > Export logs kullanın. Bu, tüm logları tek ZIP'te toplar.

Performans Optimizasyonu İpuçları

  • Spooling'i devre dışı bırakın: Büyük veri setlerinde disk kullanımını azaltır
  • Streaming'i etkinleştirin: Veriyi parça parça aktarır, bellek kullanımını düşürür
  • Mashup Container sürecini izole edin: Her veri kaynağı ayrı process'te çalışır
  • Query folding'i doğrulayın: Power Query adımlarının kaynağa pushdown edildiğinden emin olun
TEXT
# Gateway yapılandırma dosyası:
# Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.dll.config

# Streaming etkinleştirme:
<setting name="StreamBeforeRequestCompletes" serializeAs="String">
    <value>True</value>
</setting>

Sonuç

Gateway sorunlarının çoğu donanım yetersizliği, credential yönetimi ve ağ yapılandırması kaynaklıdır. Minimum 8 core / 16 GB RAM kullanın, cluster kurun, Windows Update sonrası servisi kontrol edin ve logları düzenli izleyin. Fabric kullanıyorsanız VNet Gateway'i değerlendirin — bakım yükünü Microsoft'a bırakın.