ログ設定¶
サンプリングフィールドの移行(
ft-sdk >= 1.7.6):setLogSamplingRateは 0~100 の浮動小数点数パーセントを使用します。旧setSamplingRateは 0~1 の単位を維持し、移行時は数値を 100 倍してください。新しいフィールドは明示的に設定された場合にのみ優先され、不正な値は例外をスローし、それまでの有効な値は変更されません。このバージョン未満では旧メソッドを引き続き使用します。非推奨は削除を意味せず、旧メソッドは元の単位と動作を維持します。
ログ初期化設定¶
| メソッド名 | 型 | 必須 | 意味 |
|---|---|---|---|
| setLogSamplingRate | Float | いいえ | サンプリング率(パーセント)。範囲 [0,100]、デフォルトは 100。小数もサポートされ、例えば 0.1 は 0.1% を意味します。0 は収集しない、100 は全収集を意味します。新しいフィールドは明示的に設定された場合、設定順序に関係なく旧フィールドより優先されます。ft-sdk >= 1.7.6 でサポートされます。 |
| setSamplingRate | Float | いいえ | ft-sdk 1.7.6 以降は非推奨ですが、互換性のために残されています。収集率を設定します。範囲 [0,1]。0 は収集しない、1 は全収集を意味します。デフォルト値は 1 です。 |
| setEnableConsoleLog | Boolean | いいえ | コンソールログを報告するかどうか。この設定は ft-plugin に依存し、デフォルトは false です。ログレベルの対応関係は次のとおりです:Log.v -> ok、Log.i -> info、Log.d -> debug、Log.e -> error、Log.w -> warning。prefix はプレフィックスフィルターパラメータで、デフォルトではフィルタリングは設定されません。注意:Android のコンソールログは量が非常に多いため、アプリのパフォーマンスへの影響を避け、不要なリソースの浪費を減らすには、prefix を使って価値のあるログだけをフィルタリングすることをお勧めします。ft-plugin 1.3.5 以上では、Log.println で出力されたログをキャプチャできます。 |
| setEnableWebViewLog | Boolean | いいえ | WebView 内で Browser SDK が生成したログを収集するかどうか。デフォルトは false です。ft-sdk 1.7.5 以上でサポートされます。この設定は setEnableCustomLog および setEnableConsoleLog とは独立しています。導入方法は WebView ログ収集 を参照してください。 |
| setEnableLinkRumData | Boolean | いいえ | RUM データと関連付けるかどうか。デフォルトは false です。 |
| setEnableCustomLog | Boolean | いいえ | カスタムログをアップロードするかどうか。デフォルトは false です。 |
| setLogLevelFilters | Array | いいえ | ログレベルフィルターを設定します。デフォルトでは設定されません。 |
| addGlobalContext | Dictionary | いいえ | ログのグローバル属性を追加します。追加ルールはこちらを参照してください。 |
| setLogCacheLimitCount | Int | いいえ | ローカルキャッシュの最大ログエントリ数(制限値 [1000,))。ログエントリ数が多いほど、ディスクキャッシュへの負荷が大きくなります。デフォルトは 5000 です。 |
| setLogCacheDiscardStrategy | LogCacheDiscard | いいえ | ログが上限に達した後のログ破棄ルールを設定します。デフォルトは LogCacheDiscard.DISCARD です。DISCARD は追加データを破棄し、DISCARD_OLDEST は古いデータを破棄します。 |
Logger によるログ出力¶
FTLoggerを使用してカスタムログを出力するには、FTLoggerConfig.setEnableCustomLog(true)を有効にする必要があります。現在、ログ内容は 30 KB に制限されており、超過した文字は切り捨てられます。
使用方法¶
/**
* 単一のログデータをローカルに同期保存します
*
* @param content ログ内容
* @param status ログレベル、enum Status
* @param property 追加プロパティ(オプション)
*/
public void logBackground(String content, Status status, HashMap<String, Object> property)
/**
* 単一のログデータをローカルに同期保存します
*
* @param content ログ内容
* @param status ログレベル、String
* @param property 追加プロパティ(オプション)
*/
public void logBackground(String content, String status, HashMap<String, Object> property)
/**
* 複数のログデータをローカルに同期保存します
*
* @param logDataList {@link LogData} のリスト
*/
public void logBackground(List<LogData> logDataList)
/**
* 単一のログデータをローカルに同期保存します
*
* @param content ログ内容
* @param status ログレベル
* @param property ログプロパティ(オプション)
*/
fun logBackground(content: String, status: Status, property: HashMap<String, Any>)
/**
* 単一のログデータをローカルに同期保存します
*
* @param content ログ内容
* @param status ログレベル
* @param property ログプロパティ(オプション)
*/
fun logBackground(content: String, status: String, property: HashMap<String, Any>)
/**
* 複数のログデータをローカルに同期保存します
*
* @param logDataList ログデータリスト
*/
fun logBackground(logDataList: List<LogData>)
ログレベル¶
| メソッド名 | 意味 |
|---|---|
| Status.DEBUG | デバッグ |
| Status.INFO | 情報 |
| Status.WARNING | 警告 |
| Status.ERROR | エラー |
| Status.CRITICAL | クリティカル |
| Status.OK | 回復 |
コード例¶
// 単一ログをアップロード
FTLogger.getInstance().logBackground("test", Status.INFO);
// HashMap にパラメータを渡す
HashMap<String, Object> map = new HashMap<>();
map.put("ft_key", "ft_value");
FTLogger.getInstance().logBackground("test", Status.INFO, map);
// ログを一括アップロード
List<LogData> logList = new ArrayList<>();
logList.add(new LogData("test", Status.INFO));
FTLogger.getInstance().logBackground(logList);
// 単一ログをアップロード
FTLogger.getInstance().logBackground("test", Status.INFO)
// HashMap にパラメータを渡す
val map = HashMap<String, Any>()
map["ft_key"] = "ft_value"
FTLogger.getInstance().logBackground("test", Status.INFO, map)
// ログを一括アップロード
FTLogger.getInstance().logBackground(mutableListOf(LogData("test", Status.INFO)))