LoggerTunnel

LoggerTunnel payload را مشاهده و ثبت می‌کند، اما داده، lifecycle و جهت زنجیر را تغییر نمی‌دهد. این نود برای debug و عیب‌یابی بسیار مفید است.

جایگاه رایج

TcpListener -> LoggerTunnel -> TcpConnector
TunDevice -> LoggerTunnel -> IpManipulator
UdpListener -> LoggerTunnel -> UdpConnector

نمونه تنظیم: log معمولی

{
  "name": "trace-http",
  "type": "LoggerTunnel",
  "settings": {
    "mode": "log",
    "level": "info"
  },
  "next": "next-node"
}

نمونه تنظیم: خروجی فایل

{
  "name": "payload-dump",
  "type": "LoggerTunnel",
  "settings": {
    "mode": "file",
    "output-mode": "split-direction"
  },
  "next": "next-node"
}

modeها

mode	کاربرد
log	ثبت خلاصه payload در network log
file	ذخیره payload خام در فایل
tcp-payload-file	استخراج payload TCP از IPv4 packet و ذخیره در فایل

تنظیمات

گزینه	اجباری	پیش‌فرض	توضیح
mode	بله	-	یکی از log، file یا tcp-payload-file
level	فقط برای log اختیاری	debug	یکی از debug، info، warning، error، fatal
output-mode	برای file modeها اختیاری	split-direction	یکی از per-payload، split-direction یا single-file

output-mode

مقدار	فایل‌های خروجی
per-payload	هر payload یک فایل جدا: <name>-up-1.txt، <name>-down-1.txt و ...
split-direction	همه payloadهای هر جهت در یک فایل: <name>-up.txt و <name>-down.txt
single-file	هر دو جهت در یک فایل مشترک: <name>-all.txt

tcp-payload-file

در این mode، نود payload ورودی را به عنوان packet بررسی می‌کند و فقط payload transport مربوط به IPv4 TCP را می‌نویسد:

• non-IPv4 نادیده گرفته می‌شود.
• IPv6 نادیده گرفته می‌شود.
• packetهای غیر TCP نادیده گرفته می‌شوند.
• fragmentهای IPv4 نادیده گرفته می‌شوند.
• TCP segment بدون payload نوشته نمی‌شود.

نکته‌ها

• این نود payload را تغییر نمی‌دهد.
• برای داده حساس با احتیاط استفاده کنید، چون ممکن است محتوای واقعی traffic را ذخیره کند.
• در مسیرهای packet، mode مناسب را انتخاب کنید؛ payload خام ممکن است یک IP packet کامل باشد.
• خروجی file در working directory فعلی نوشته می‌شود و raw bytes است، حتی اگر پسوند فایل .txt باشد.