| fstrm_capture(1) | General Commands Manual | fstrm_capture(1) |
نام (NAME)
fstrm_capture - دریافت و ذخیره داده‌های Frame Streams از سوکت
خلاصه دستور (SYNOPSIS)
fstrm_capture -t content-type -w
filename
[ -u socket-path ] [ -a IP -p port
]
[ -c max-connections ] [ -b buffer-size ]
[ -s seconds ] [ --gmtime ] [ --localtime ]
[ -d [-d ...] ]
fstrm_capture --type content-type --write
filename
[ --unix socket-path ] [ --tcp IP --port
port ]
[ --maxconns max-connections ] [ --buffersize
buffer-size ]
[ --split seconds ] [ --gmtime ] [ --localtime ]
[ --debug [--debug ...] ]
توضیحات (DESCRIPTION)
دستور fstrm_capture به یک سوکت دامنه یونیکس (UNIX domain) یا TCP گوش فرا می‌دهد، داده‌های Frame Streams را دریافت کرده و در یک فایل می‌نویسد.
گزینه‌ها (OPTIONS)
- -w filename | --write filename
- نوشتن
داده‌ها در
فایل filename.
اگر گزینه --gmtime یا --localtime داده شده باشد، filename با استفاده از strftime() پیش‌پردازش می‌شود. این امر امکان مشخص کردن یک رشته قالب‌بندی حاوی تاریخ و زمان را برای نام فایل ایجادشده فراهم می‌کند.
اگر filename برابر با «-» باشد و خروجی استاندارد به ترمینال متصل نباشد، fstrm_capture در خروجی استاندارد می‌نویسد. تقسیم‌بندی خروجی (-s) را نمی‌توان با filename برابر «-» استفاده کرد.
ارسال سیگنال SIGHUP به fstrm_capture تمام خروجی‌های بافر شده را در فایل تخلیه (flush) می‌کند. ارسال SIGUSR1 فایل را بسته و دوباره باز می‌کند.
- -t content-type | --type content-type
- مشخص کردن content-type برای دریافت از سوکت و نوشتن در filename خروجی.
- -u socket-path | --unix socket-path
- گوش دادن به سوکت دامنه یونیکس socket-path برای دریافت داده‌های Frame Streams. تنها یکی از گزینه‌های -u یا -a می‌تواند مشخص شود.
- -a IP | --tcp IP
- گوش دادن به اتصالات TCP روی آدرس IP برای دریافت داده‌های Frame Streams. تنها یکی از گزینه‌های -u یا -a می‌تواند مشخص شود. استفاده از -a نیازمند مشخص کردن پورت با -p است.
- -p port | --port port
- در صورت مشخص شدن -a، به پورت TCP با شماره port برای دریافت داده‌های Frame Streams گوش فرا می‌دهد.
- -c max-conns | --maxconns max-conns
- اجازه دادن به حداکثر max-conns اتصال همزمان. در صورت عدم تعیین، اتصالات همزمان محدود نمی‌شوند.
- -b buffersize | --buffersize buffersize
- تنظیم
اندازه
بافر
خواندن بر
حسب بایت به
مقدار buffersize.
در ترکیب با
-c، می‌توان
از این
گزینه برای
محدود کردن
کل حافظه
مصرفی fstrm_capture
استفاده
کرد. مقدار
buffersize همچنین
بر حداکثر
اندازه
فریمی که
fstrm_capture
می‌پذیرد
تأثیر
می‌گذارد.
فریم‌های
بزرگ‌تر از
buffersize، با
احتساب ۴
بایت بار
اضافه
فریم‌بندی
(framing overhead)، دور
ریخته
خواهند شد.
مقدار پیش‌فرض buffersize برابر ۲۶۲۱۴۴ (۲۵۶ کیبی‌بایت) است.
- -s interval | --split interval
- بازگشایی
مجدد فایل
خروجی در هر
interval ثانیه.
نیازمند
استفاده از
یکی از
گزینه‌های
--gmtime یا --localtime
است.
توجه داشته باشید که این چرخش فایل با ورود داده‌ها فعال می‌شود، بنابراین ممکن است پس از پایان بازه زمانی، با اندکی تأخیر رخ دهد.
- --gmtime
- پردازش نام فایل مشخص‌شده در --write از طریق strftime() بر اساس زمان فعلی در گرینویچ (GMT). از این گزینه می‌توان برای ایجاد یک فایل خروجی دارای برچسب زمانی هنگام شروع fstrm_capture، هنگام بازگشایی مجدد فایل خروجی با استفاده از گزینه --split، یا هنگام دریافت سیگنال SIGUSR1 استفاده کرد.
- --localtime
- پردازش نام فایل مشخص‌شده در --write از طریق strftime() بر اساس زمان فعلی در منطقه زمانی محلی سیستم. از این گزینه می‌توان برای ایجاد یک فایل خروجی دارای برچسب زمانی هنگام شروع fstrm_capture، هنگام بازگشایی مجدد فایل خروجی با استفاده از گزینه --split، یا هنگام دریافت سیگنال SIGUSR1 استفاده کرد.
- -d [ -d ... ] | --debug [ --debug ]
- افزایش سطح اشکال‌زدایی. بدون گزینه -d، دستور fstrm_capture تنها پیام‌های خطای حیاتی را چاپ می‌کند. حداکثر پنج گزینه -d می‌تواند مشخص شود و تکرار بیش از آن تأثیری نخواهد داشت.
مثال‌ها (EXAMPLES)
دریافت داده‌های dnstap و ذخیره آن‌ها در فایل‌هایی با چرخش ساعتی (با نام تبدیل‌شده‌ای مانند /var/log/dnstap/dnstap-2018-05-04-12:58:48.fstrm):
fstrm_capture -t protobuf:dnstap.Dnstap \ -u /var/run/named/dnstap.sock \ -w /var/log/dnstap/dnstap-%F-%T.fstrm \ -s 3600 --gmtime
همچنین ببینید (SEE ALSO)
fstrm_dump(1), fstrm_replay(1), strftime(3),
کتابخانه Frame Streams
C https://farsightsec.github.io/fstrm