次の方法で共有

概念 - MIP SDKでのロギング

  • [アーティクル]

MIP SDKを使用するカスタムアプリケーションのトラブルシューティングは、まずmipログの検査から始まります。 MIPログロケーションはMipContextの作成時に設定され、*.miplog ァイル拡張子を使用して照会できます。 Microsoftアプリとサンプルはapplication path\APP_DATA\mip_dataにMIPログを保存します。

MIP ログの機密データのマスク

MIP SDKのログは、追加設定なしにお客様が個人的に識別できる重要なコンテンツをマスクしません。

MIP SDKログの一般的な機密データ:

  • メール名
  • ファイル名
  • ラベル名
  • IP アドレス
  • MAC アドレス

MIP SDKによって生成されたすべてのmiplogファイルで機密コンテンツをマスクするには、コンフィギュレーション.jsonファイルに新しいフィールドを作成するか、またはMipConfigurationで設定します。

構成ファイル

コンフィギュレーションファイルは、MIP SDKでカスタム設定を行う場合に推奨されるパスであり、サポートされているすべてのプラットフォームで使用できます。 MIPログファイルのPIIをマスクするには、次の方法を使用します。

  1. カスタム設定のためにMIP SDKからアクセス可能なmip_config.jsonという名前の設定ファイルを作成し、そのファイルを以下のMipConfigurationパスに保存します。
mipConfiguration->GetPath()/mip
  1. mip_config.jsonに新しいフィールドを追加し、AllowPiiフィールドをfalseに設定します。
{"MipLogger":{"MaxLogFilesSizeMb":40,"MaxLogFileCount":10,"AllowPii":false}}

設定されると、MIP SDKによって生成されたすべての新しいMIPログで機密コンテンツがマスクされます。

MipConfigurationでの設定

MipConfigurationを使用してMIPログファイルのPIIをマスクするには、カスタム設定の新しい値でMipConfigurationに渡す新しいMipContextオブジェクトを作成します。

このメソッドは、C++およびC#でだけサポートされます。 CAPIまたは Javaラッパを使用する開発者は、代わりにコンフィギュレーションファイルを作成することをお勧めします。

auto mipConfiguration = make_shared<mip::MipConfiguration>(appInfo, "mip_data", mip::LogLevel::Trace, false);
    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);
  mipConfiguration.LoggerConfigurationOverride = new LoggerConfiguration(10, 40, false);
  var mipContext = MIP.CreateMipContext(mipConfiguration);