secure loggerでログを収集する

概要

セキュアロガーはNFCウォレットSDKの実行ログを収集します。これらをアプリケーションサンドボックス内に安全に保存します。

デジタルウォレットアプリはログファイルを取得し、トラブルシューティングのためにThalesと共有できます。

SDK 統合

ログレベルを設定する

セキュアロガーはデフォルトで有効になっており、ログレベルは次に設定されています warn.

ログレベル	説明
デバッグ	トラブルシューティングやデバッグのための詳細情報をログに記録します。
info	APIの入出力ポイントや返される値など、通常のメッセージを記録します。
warn	通常の実行中に発生する警告や重要なフローの問題を記録します。
error	フローの正常な完了を妨げるエラーを記録します。
fatal	直ちに対処が必要な実行時エラーを記録します。
off	ロギングを無効にします。

セキュアロガーのインスタンスを取得する

SDKからセキュアロガーのインスタンスを取得します：

// TSHPay sdkからsecurelogオブジェクトを取得する
let securelog = TSHPay.secureLog

本番環境では、 warn 通常の条件では。

問題を再現するために、エンドユーザーにより詳細なログレベルを有効にしてもらいます。次に問題を再現し、ログファイルを共有してください。

セキュアロガーを無効にする

セキュアロガーを無効にするには：

// レベルをoffに設定するとログは無効になります。MPAは別のレベルを選択してオンにできます。例えば、debug
securelog.setLevel(.off)

ログファイルを取得する

ログファイルを取得するには：

// ファイルの一覧を返す
let files = securelog.files()

ログファイルを削除する

ログファイルを削除するには：

// ファイルを削除する
securelog.deleteFiles()

ログファイルを共有する（例）

この例では、次を使用してログを共有します UIActivityViewController.

デジタルウォレットアプリはログをファイルサーバーにアップロードすることもできます。

別の承認されたチャネルを通じてログを送信することもできます。

// ログを共有する
    func archieveLogsURL(_ onComplete: @escaping (URL?) -> ()) {
        var error: NSError?
        guard let file = TSHPay.secureLog.files().first?.absoluteURL.deletingLastPathComponent(),
            let fileURL = URL(string: "file://\(file.absoluteString)") else {
            onComplete(nil)
            return
        }
        
        NSFileCoordinator().coordinate(
            readingItemAt: fileURL,
            options: [.forUploading],
            error: &error
        ) { zipUrl in
            do {
                let tmpUrl = try FileManager.default
                    .url(
                        for: .itemReplacementDirectory,
                        in: .userDomainMask,
                        appropriateFor: zipUrl,
                        create: true
                    )
                    .appendingPathComponent("archive.zip")
                
                try FileManager.default.moveItem(at: zipUrl, to: tmpUrl)
                onComplete(tmpUrl)
            } catch {
                onComplete(nil)
            }
        }
    }