Power BI के refresh
TaskBeacon हर उस semantic model की refresh history पढ़ता है जिस पर आप नज़र रखते हैं: Failed (विफल) refresh, Power BI के error code के साथ एक Failed run बन जाता है, चल रहा refresh Running (चल रहा है) दिखता है (और जब वह सामान्य से बहुत ज़्यादा समय ले, तो Late), और पूरा हुआ refresh अपनी अवधि के साथ OK होता है। Model के scheduled refresh समय job का schedule बन जाते हैं, इसलिए जो refresh कभी हुआ ही नहीं, वह Missed (छूटा) दिखता है।
आपको चाहिए: आपके अपने tenant में एक Microsoft Entra app registration (एक service principal), एक Fabric / Power BI administrator जो एक बार service principals को अनुमति दे, और workspace का admin जो app को workspace में जोड़े।
1. App registration बनाएँ
- Microsoft Entra admin center में App registrations → New registration पर जाएँ। इसे नाम दें, जैसे TaskBeacon monitor, single tenant, कोई redirect URI नहीं।
- इसके Overview पर Application (client) ID और Directory (tenant) ID कॉपी करें।
- Certificates & secrets → Client secrets → New client secret में secret की Value तुरंत कॉपी करें (यह सिर्फ़ एक बार दिखाई जाती है)। इसकी expiry तारीख नोट कर लें: जब यह खत्म हो जाती है, तो integration रुक जाता है और तब तक error दिखाता है जब तक आप नया secret पेस्ट न करें।
- Power BI के लिए API permissions न जोड़ें। Power BI REST API को कॉल करने वाले service principal के लिए Microsoft कोई permission नहीं सुझाता; access नीचे दिए workspace role से मिलता है।
2. Service principals को अनुमति दें (Fabric administrator, एक बार)
एक Microsoft Entra security group बनाएँ (जैसे Power BI API apps) और app को उसमें जोड़ें। फिर Fabric admin portal की Tenant settings में (2026 में यहाँ पहुँचते हैं: OneLake catalog → Govern → Configurations → Tenant settings), Developer settings हिस्से में, उस security group के लिए Service principals can call Fabric public APIs चालू करें (पुराने पेज इसे Allow service principals to use Power BI APIs कहते हैं)। इसे पूरे संगठन के बजाय किसी खास group के लिए चालू करने से दायरा सीमित रहता है।
3. App को हर workspace में जोड़ें
Power BI में workspace खोलें → Manage access (Workspace access) → Add people or groups, app को उसके नाम से ढूँढें और उसे Contributor role दें। Contributor सबसे निचला role है जो काम करता है: refresh history पढ़ने के लिए semantic model पर write permission चाहिए, जो Viewer के पास नहीं होती। Member या Admin भी काम करते हैं, लेकिन ज़रूरत से ज़्यादा अधिकार देते हैं। My workspace को service principal के साथ इस्तेमाल नहीं किया जा सकता।
4. TaskBeacon में connect करें
Jobs → ▾ → Add integration… → Power BI। tenant ID, client ID और secret पेस्ट करें और Test connection and continue दबाएँ। फिर Choose what to watch (चुनें किस पर नज़र रखनी है): app जिन workspaces को देख सकता है, उनका हर refresh होने वाला model workspace / model के रूप में दिखता है। जिन models पर निशान लगाएँ, वे jobs बन जाते हैं।
Runs कैसे पढ़े जाते हैं
- हर poll में आखिरी 5 refreshes पढ़े जाते हैं। Status Completed = OK, Failed = error code के साथ Failed (जैसे ModelRefreshFailed_CredentialsNotSpecified), Unknown = अभी चल रहा है।
- Refresh schedule दिन में एक बार पढ़ा जाता है। जब उसमें दिन में कई बराबर अंतराल वाले समय हों, तो सभी गिने जाते हैं; जब समय असमान हों, तो सिर्फ़ दिन का पहला refresh तय माना जाता है।
- सिर्फ़ import mode वाले models: DirectQuery और live connection models का कोई refresh नहीं होता और वे सूची में नहीं आते। OneDrive पर रखे models के refreshes history में नहीं होते।
अभी किसी असली installation पर test नहीं किया गया — हमें बताएँ कि कैसा रहा (support@taskbeacon.io)।
उपयोग के उदाहरण: पूरी team के लिए Power BI refresh failure की सूचनाएँ। और सवाल: FAQ.