TailFile 2025.5.31.15¶

ファイルの場所

NiFi の再起動時にデータが重複することなくすべて消費されるように、状態を適切に保存できるように、ローカルまたはクラスタリングのいずれかに状態を保存する場所を指定します。

最初のスタート位置

プロセッサーが最初にデータのテーリングを開始するとき、このプロパティは、プロセッサーがデータの読み取りを開始する場所を指定します。データがファイルから取り込まれると、プロセッサーはデータを受信した最後のポイントから処理を続けます。

最大バッファサイズ

行頭パターンを使用する場合、テールされるファイルのデータが正規表現に一致しない場合があります。この場合、プロセッサーはテーリングされたファイルからすべてのデータをバッファリングすることになり、ヒープをすぐに使い果たしてしまいます。これを避けるために、プロセッサーはバッファをフラッシュする前に、たとえファイルから部分的なデータを取り込むことになったとしても、このデータ量までしかバッファリングしません。

ローリングファイル名パターン

ログファイルの場合のように、テールするファイルが「ロールオーバー」する場合、このファイル名パターンはロールオーバーしたファイルを識別するために使われます。これにより、 NiFi を再起動したときに、ファイルがロールオーバーしていた場合、そのファイルを再開することができます。このパターンは、ワイルドカード文字 * と ? をサポートしています。また、ファイル名 (拡張子なし) に基づいてパターンを指定する ${filename} という記法もサポートしており、ロールオーバーされたファイルは、テールオーバーされたファイルと同じディレクトリにあると仮定します。すべてのファイルで同じグロブ・パターンが使用されます。

reread-on-nul

このオプションを'true'にセットすると、 NUL の文字が読み込まれたとき、プロセッサーはイールドし、同じ部分を後でもう一度読み込もうとします。(注意: Yieldingは、 NUL 文字を持つファイルだけでなく、このプロセッサーが尾行する他のファイルの処理を遅らせる可能性があります)。このフラグの目的は、ファイルを読むと仮に NUL の値が返されるようなケースをユーザーが扱えるようにすることです。NFS 例えば、ファイルの内容を順番通りに送信できない場合があります。この場合は、一時的に NUL の値で置き換えられます。CAUTION!ファイルに正当な NUL 値が含まれている場合、このフラグをセットすると、このプロセッサは無期限にスタックします。このため、ユーザーはできる限りこの機能を使用せず、読み取りが不安定なファイルシステム上にターゲットファイルを置かないようにしてください。

tail-mode

使用するモード：単一ファイルは1つのファイルだけを尾行し、複数ファイルはファイルのリストを探します。複数モードではBaseディレクトリが必要です。

tailfile-maximum-age

複数ファイルモードでのみ使用されます。これは、ファイルの最終更新日以降に新しいメッセージが追加されないことを考慮するために必要な最小期間を指定します。新しいメッセージがより低い頻度で追加される場合にデータの重複を避けるため、これはあまり低くセットすべきではありません。

CLUSTER

再起動時にデータを複製する必要がないように、Tailed Fileのどこで中断したかをデータファイルとして保存します。状態は、<File Location> プロパティによって、ローカルまたはクラスタ化されて保存されます。

ファイルシステムの読み込み

演算子に、 NiFi がアクセスできるあらゆるファイルからの読み取り機能を提供します。

success

すべての FlowFiles はこの リレーションシップ にルーティングされます。

tailfile.original.path

フローファイルの元ファイルのパス。