TLSRPT-COLLECTD(1) tlsrpt-collectd TLSRPT-COLLECTD(1)

tlsrpt-collectd - دیمنی برای جمع‌آوری داده‌های گزارش TLSRPT از نمونه‌های MTA از طریق سوکت دامنه یونیکس

tlsrpt-collectd [گزینه]

دیمن tlsrpt-collectd داده‌های مربوط به تحویل موفق رمزگذاری‌شدهٔ ایمیل‌ها یا خطاهای رخ‌داده در حین تلاش برای تحویل را از MTAها جمع‌آوری می‌کند. این داده‌ها از پیش تجمیع شده و توسط tlsrpt-fetcherهای متناظر بازیابی خواهند شد.

دیمن tlsrpt-collectd می‌تواند از پس‌اندهای ذخیره‌سازی مختلفی استفاده کند و اگر قرار باشد داده‌ها توسط tlsrpt-reportd استفاده شوند، باید برای هر یک از این پیاده‌سازی‌ها یک پیاده‌سازی fetcher متناظر ارائه شود.

همچنین امکان پیاده‌سازی پس‌اندهای ذخیره‌سازی که توسط tlsrpt-reportd پرس‌وجو نمی‌شوند نیز وجود دارد. چنین پس‌اندهای «ذخیره‌سازی» صرفاً داده‌ها را برای اهداف تحلیلی جمع‌آوری کرده و راهکاری برای بازیابی دوبارهٔ آن‌ها ارائه نمی‌دهند.

--storage=URL

استفاده از فضای ذخیره‌سازی داده که با URL مشخص شده است. این مقدار می‌تواند فهرستی از چند پس‌اند ذخیره‌سازی باشد که با کاما از یکدیگر جدا شده‌اند. طرح‌وارهٔ URL، نوع پس‌اند ذخیره‌سازی را مشخص می‌کند.

--socketname=path

شنود روی سوکت دامنه یونیکس در path برای دریافت داده‌های گزارش.

--socketuser=name

تنظیم مالکیت کاربریِ سوکت روی name.

--socketgroup=name

تنظیم مالکیت گروهیِ سوکت روی name.

--socketmode=octal

تنظیم بیت‌های حالت فایلِ سوکت روی حالت عددی octal؛ برای نمونه 0200 تا فقط دسترسی نوشتن برای مالک فراهم باشد.

--sockettimeout=n

ثبت (Commit) داده‌های تجمیع‌شده در فضای ذخیره‌سازی، در صورتی که n ثانیه از آخرین ثبت گذشته باشد.

--max_uncommited_datagrams=n

ثبت داده‌های تجمیع‌شده در فضای ذخیره‌سازی پس از دریافت n دیتاگرام.

--retry_commit_datagram_count=n

پس از ناموفق بودن ثبت داده‌های تجمیع‌شده، تلاش مجدد به جای آنکه بلافاصله پس از دیتاگرام بعدی انجام شود، پس از دریافت n دیتاگرام دیگر انجام خواهد شد. اگر ثبت داده‌ها به دلیل پایان مهلت زمانی (timeout) با شکست مواجه شود، تلاش مجدد پس از هر دیتاگرام ممکن است خطر مواجههٔ پی‌درپی با همان مهلت زمانی را در پی داشته باشد. تلاش مجدد تنها پس از هر n دیتاگرام، زمان انتظار برای این وقفه‌ها را کاهش می‌دهد.

--daily_rollover_script=script

اگر این گزینه تنظیم شود، پس از گذشت نیمه‌شب به وقت UTC و انجام مراحل نگهداری، script اجرا خواهد شد. این قابلیت می‌تواند برای ارسال (push) پایگاه داده collectd به مکانی دیگر در پیکربندی‌هایی مفید باشد که در آن‌ها امکان پرس‌وجوی مستقیم یک TLSRPT-collectd دوردست توسط TLSRPT-reportd وجود ندارد، اما TLSRPT-collectd می‌تواند داده‌ها را به سوی TLSRPT-reportd ارسال کند.

--dump_path_for_invalid_datagram=path

در صورت دریافت یک دیتاگرام نامعتبر و فعال بودن این گزینه، دیتاگرام نامعتبر در فایلی به نام path ذخیره خواهد شد.

--config_file=filename

خواندن گزینه‌ها از بخش tlsrpt_collectd در فایل پیکربندی به سبک INI در filename. متغیرهای محیطی بر تنظیمات فایل پیکربندی اولویت دارند و گزینه‌های خط فرمان بر هر دو اولویت خواهند داشت.

--help

نمایش پیام راهنما که تمامی گزینه‌ها را شرح می‌دهد.

--pidfilename=path

فایلی را مشخص می‌کند که شناسه فرایند (PID) دیمن tlsrpt-collectd را در خود نگه می‌دارد. یک رشتهٔ خالی مانع از ایجاد فایل PID می‌شود.

--logfilename=filename

استفاده از filename به عنوان فایل لاگ.

--log_level=level

تنظیم سطح ثبت وقایع روی level؛ مقادیر مجاز: debug، info، warn، error.

تمامی گزینه‌های پیکربندی به جز --help و --config_file را می‌توان از طریق متغیرهای محیطی نیز تنظیم کرد. متغیر محیطی متناظر با هر گزینهٔ پیکربندی، شامل پیشوند TLSRPT_COLLECTD_ به همراه نام تنظیم پیکربندی با حروف تمام بزرگ است. برای نمونه، گزینهٔ --log_level را می‌توان با استفاده از متغیر محیطی TLSRPT_COLLECTD_LOG_LEVEL پیکربندی کرد.

0

موفقیت‌آمیز.

1

شکست. داده‌ها تحویل داده نشدند.

2

شکست. داده‌ها تحویل داده نشدند.

3

خطای نحوهٔ استفاده (Usage error).

اجرای tlsrpt-collectd با یک فایل پیکربندی خاص و بازنویسی تنظیم log-level:

tlsrpt-collectd --config-file /path/to/config.cfg --log_level info

man:tlsrpt-fetcher[1], man:tlsrpt-reportd[1]

Boris Lohner

2026-09-01 tlsrpt-collectd