コンテンツにスキップ

ログ設定

await FTLogger().logConfig(
  enableCustomLog: true,
);
フィールド 型 必須 説明
logSamplingRate double いいえ ログサンプリングレート。範囲は [0,100] で、小数をサポートします。デフォルトは 100 です。0.1 は 0.1%、1 は 1% を表します。SDK 0.5.8 以降でサポート。
sampleRate double いいえ 旧確率設定、互換性のため保持。ログサンプリングレート。範囲は [0,1]、デフォルトは 1 です。0.1 は 10%、1 は 100% を表します。logSamplingRate への変更を推奨します。
enableWebViewLog bool いいえ WebView 内の Web モニタリング SDK のログを収集するかどうか。デフォルトは false です。基本設定の allowWebViewHost とページ内の Web モニタリング SDK を組み合わせる必要があります。SDK 0.5.8 以降でサポート。詳細は WebView データモニタリング を参照してください。
enableLinkRumData bool いいえ RUM と関連付けるかどうか
enableCustomLog bool いいえ カスタムログを有効にするかどうか
logLevelFilters List<FTLogStatus> いいえ ログレベルフィルター
logCacheLimitCount int いいえ ローカルキャッシュの最大ログエントリ数制限 [1000, )、デフォルトは 5000
discardStrategy enum FTLogCacheDiscard いいえ ログが上限に達した後の破棄ルールを設定します。デフォルトは FTLogCacheDiscard.discard です。discard は追加データを破棄し、discardOldest は古いデータを破棄します。

パーセントサンプリングへの移行

SDK 0.5.8 以降でサポート。

サンプリングレートパラメータの命名

SDK 0.5.8 以降では logSamplingRate の使用を推奨します。値は 0~100 のパーセント値で、小数をサポートします。0 はサンプリングなし、100 は全サンプリングを表します。範囲外、NaN、無限大などの無効な値は ArgumentError をスローします。

旧 sampleRate は引き続き互換性のため保持され、値は 0~1 の確率です。たとえば、旧フィールドの 0.1 は 10%、新フィールドの 0.1 は 0.1% を表します。新旧フィールドを同時に設定した場合、明示的な 0 を含め、新しいパーセントフィールドが優先されます。

リモートサンプリングフィールドの単位と優先順位については、Flutter リモート設定フィールド を参照してください。

たとえば、12.5% のログサンプリングに移行するには:

 await FTLogger().logConfig(
   enableCustomLog: true,
-  sampleRate: 0.125,
+  logSamplingRate: 12.5,
 );

Logger のログ出力

カスタムログ

現時点ではログ内容は 30 KB に制限されており、超過した文字は切り捨てられます。

使用方法

/// ログを出力
/// [content] ログ内容
/// [status] ログステータス
/// [property] 追加属性パラメータ(オプション)
Future<void> logging(String content, FTLogStatus status,
  {Map<String, String>? property})

コード例

FTLogger().logging("info log content", FTLogStatus.info);

ログレベル

メソッド名 意味
FTLogStatus.info 情報
FTLogStatus.warning 警告
FTLogStatus.error エラー
FTLogStatus.critical 重大
FTLogStatus.ok 復旧

フィードバック

このページは役に立ちましたか?