概念 - MIP SDK 中的日誌

對於使用 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,請使用以下方法。

  1. 建立一個名為 mip_config.json MIP SDK 可存取的自訂設定設定檔,並將該檔案儲存在以下 MipConfiguration 路徑中。
mipConfiguration->GetPath()/mip
  1. 新增一個欄位 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);