Útmutató: Hiba- és teljesítménynaplózás engedélyezése
Fontos
A Microsoft Rights Management Service SDK 2020 márciusa előtt kiadott verziói elavultak; a korábbi verziókat használó alkalmazásokat frissíteni kell a 2020. márciusi kiadás használatához. További részletekért tekintse meg az elavulással kapcsolatos közleményt.
A Microsoft Rights Management Service SDK-hoz nem tervezünk további fejlesztéseket. Határozottan javasoljuk, hogy a besorolási, címkézési és védelmi szolgáltatásokhoz használja a Microsoft-információvédelem SDK-t.
A Microsoft Rights Management SDK 4.2 egyetlen eszköztulajdonságon keresztül kezeli a diagnosztikát és a teljesítménynaplókat.
Áttekintés
A felhasználói élmény és a hibaelhárítás javítása érdekében engedélyezheti az automatikus diagnosztikai, a teljesítmény- és a telemetriai naplók feltöltését a Microsoft számára.
Fontos
A felhasználók adatvédelme érdekében az alkalmazás fejlesztőjeként a felhasználó beleegyezését kell kérnie az automatikus naplózás engedélyezése előtt.
Megjegyzés
Itt van például egy szokásos üzenet, amelyet a Microsoft naplózási értesítésekhez használ:
A hiba- és teljesítménynaplózás bekapcsolásával elfogadja, hogy hiba- és teljesítményadatokat küld a Microsoftnak. A Microsoft hiba- és teljesítményadatokat gyűjt az interneten „Adatok”. A Microsoft ezeket az Adatokat a Microsoft-termékek és -szolgáltatások minőségének, biztonságának és sértetlenségének biztosítására és javítására használja. Elemezzük például a teljesítményt és a megbízhatóságot, többek között, hogy milyen funkciókat használ, milyen gyorsan válaszolnak ezek a funkciók, a felhasználói felületen végzett interakciókat, valamint a termékkel kapcsolatban tapasztalt problémákat. Az adatok tartalmazni fogják a szoftver konfigurációjára vonatkozó információkat is, például a jelenleg használt szoftvert és az IP-címet.
Két tulajdonságon keresztül vezérli a naplózást.
Engedélyezze a naplózást az IpcCustomerExperienceDataCollectionEnabled tulajdonságon keresztül. A beállítás az eszköz-visszaállítások során nem vész el.
A következő beállításokkal vezérelheti a naplózási szintet az IpcLogLevel tulajdonságon keresztül.
- 1 - Részletes
- 2 - Tájékoztató
- 3 - Figyelmeztetés
- 4 - Hiba
- 5 - Kritikus
Az összes következő példakódrészletben a hívó alkalmazás állíthatja be vagy kérheti le a tulajdonságot.
Android
Automatikus naplózás engedélyezése
SharedPreferences preferences = PreferenceManager.getDefaultSharedPreferences(context);
SharedPreferences.Editor editor = preferences.edit();
editor.putBoolean("IpcCustomerExperienceDataCollectionEnabled", true);
editor.commit();
Aktuális naplózásvezérlő jelző beállításának lekérése
SharedPreferences preferences = PreferenceManager.getDefaultSharedPreferences(context);
Boolean isLogUploadEnabled = preferences.getBoolean("IpcCustomerExperienceDataCollectionEnabled", false);
iOS
Automatikus naplózás engedélyezése
NSUserDefaults \*prefs = [NSUserDefaults standardUserDefaults];
[prefs setBool:FALSE forKey:@"IpcCustomerExperienceDataCollectionEnabled"];
[[NSUserDefaults standardUserDefaults] synchronize];
Aktuális naplózásvezérlő jelző beállításának lekérése
[[NSUserDefaults standardUserDefaults] boolForKey:@"IpcCustomerExperienceDataCollectionEnabled"];
Naplózási szint vezérlésének beállítása
NSUserDefaults \*prefs = [NSUserDefaults standardUserDefaults];
[prefs setInteger:1 forKey:@"IpcLogLevel"];
[[NSUserDefaults standardUserDefaults] synchronize];
A naplózási szint vezérlési beállításának lekérése
[[NSUserDefaults standardUserDefaults] boolForKey:@"IpcLogLevel"];
Windows
Automatikus naplózás engedélyezése
CustomerExperienceConfiguration::Option = CustomerExperienceOptions::LoggingEnabledNow;
Az opcionális beállításokról további információért lásd: CustomerExperienceOptions.
Aktuális naplózásvezérlő jelző beállításának lekérése
CustomerExperienceOptions loggingOption = CustomerExperienceConfiguration::Option;
Megjegyzés – A fenti Windows kódrészletek C++ nyelvben vannak. C# esetén frissítse a szintaxist a következővel: "." a ‘::’ helyett.
Linux / C++ – Ez az SDK alapvető naplózással rendelkezik, amely a többi platformhoz képest kevésbé átfogó. További információt az RMS SDK for portable C++ kód a „README.md” fájljának Troubleshooting (Hibaelhárítás) szakaszban talál.