對於使用 MIP SDK 的自訂應用程式進行故障排除,首先要檢查 MIP 日誌。 當您建立 MipContext 時,會設定 MIP 記錄位置,而且可以使用 *.miplog 檔案副檔名來查詢記錄。
Microsoft 應用程式與範例會將 MIP 日誌儲存在 application path\APP_DATA\mip_data。
在 MIP 日誌中遮蔽敏感資料
MIP SDK 中的日誌不會遮蔽可能識別客戶個人身份的敏感內容,除非你設定遮蔽功能。
MIP SDK 日誌中的常見敏感資料:
- 電子郵件名稱
- 檔案名稱
- 唱片公司名稱
- IP 位址
- MAC 位址
若要遮蔽所有 *.miplog 由 MIP SDK 產生的檔案中的敏感內容,請在 JSON 設定檔中建立新欄位或設定 MipConfiguration。
組態檔
在所有支援平台上,使用設定檔在 MIP SDK 中設定自訂設定。 要在 MIP 日誌檔中遮蔽 PII,請使用以下方法。
- 建立一個名為
mip_config.jsonMIP SDK 可存取的自訂設定設定檔,並將該檔案儲存在以下 MipConfiguration 路徑中。
mipConfiguration->GetPath()/mip
- 新增一個欄位
mip_config.json,將該AllowPii欄位設為假。
{"MipLogger":{"MaxLogFilesSizeMb":40,"MaxLogFileCount":10,"AllowPii":false}}
設定此設定後,MIP SDK 會將敏感內容隱藏在所有新的 MIP 日誌中。
在 MipConfiguration 中配置
若要在 MIP 日誌檔中以 MipConfiguration 遮蔽 PII,請建立新的 MipConfiguration 物件,其中包含新的自訂設定值,以傳遞至 MipContext。
此方法僅支援 C++ 與 C#。 如果你用的是 C API 或 Java 包裝器,建議改建設定檔。
auto mipConfiguration = make_shared<mip::MipConfiguration>(appInfo, "mip_data", mip::LogLevel::Trace, false, mip::CacheStorageType::OnDisk);
auto loggerConfiguration = make_shared<mip::LoggerConfiguration>();
loggerConfiguration->isPiiAllowed = false;
mipConfiguration->SetLoggerConfiguration(loggerConfiguration);
auto mipContext = MipContext::Create(mipConfiguration);
MipConfiguration mipConfiguration = new MipConfiguration(appInfo, "mip_data", LogLevel.Trace, false, CacheStorageType.OnDiskEncrypted);
mipConfiguration.LoggerConfigurationOverride = new LoggerConfiguration(10, 40, false);
var mipContext = MIP.CreateMipContext(mipConfiguration);