ログ設定¶
| フィールド | 型 | 必須 | 説明 |
|---|---|---|---|
| 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% のログサンプリングに移行するには:
Logger のログ出力¶
カスタムログ¶
現時点ではログ内容は 30 KB に制限されており、超過した文字は切り捨てられます。
使用方法¶
/// ログを出力
/// [content] ログ内容
/// [status] ログステータス
/// [property] 追加属性パラメータ(オプション)
Future<void> logging(String content, FTLogStatus status,
{Map<String, String>? property})
コード例¶
ログレベル¶
| メソッド名 | 意味 |
|---|---|
| FTLogStatus.info | 情報 |
| FTLogStatus.warning | 警告 |
| FTLogStatus.error | エラー |
| FTLogStatus.critical | 重大 |
| FTLogStatus.ok | 復旧 |