نام (NAME)

mqttui-log - ثبت مقادیر موضوعات مشترک‌شده در خروجی استاندارد (stdout)

خلاصه دستور (SYNOPSIS)

mqttui log [-j|--json] [-v|--verbose] [--qos] [-b|--broker] [-u|--username] [--password] [-i|--client-id] [--ca-cert] [--client-cert] [--client-private-key] [--insecure] [-h|--help] [TOPIC]

توضیحات (DESCRIPTION)

ثبت مقادیر موضوعات (topics) مشترک‌شده در خروجی استاندارد (stdout)

گزینه‌ها (OPTIONS)

-j, --json

خروجی بسته‌های دریافتی به صورت JSON جدا شده با خط جدید (newline-delimited)

-v, --verbose

نمایش کامل ارتباطات MQTT

--qos <LEVEL> [پیش‌فرض: 2]

حداکثر سطح کیفیت خدمات (`QoS`) برای اشتراک‌ها و ارسال پیام‌ها.

سطح کیفیت خدمات پایین‌تر میان ارسال‌کننده و مشترک، از کارگزار به مشترک تحویل داده می‌شود؛ بنابراین، اشتراک با سطح 0 هرگز پیام‌های با سطح 1 یا 2 را دریافت نخواهد کرد. ارسال با سطح 2، هنگام اشتراک با سطح 1، به عنوان 1 دریافت خواهد شد.

- 0: حداکثر یک بار (fire and forget یا ارسال بدون پیگیری)

- 1: حداقل یک بار (تحویل تاییدشده با احتمال وجود نسخه‌های تکراری)

- 2: دقیقاً یک بار (تحویل تضمین‌شده بدون موارد تکراری)

-h, --help

چاپ راهنما (مشاهده خلاصه با '-h')

[TOPIC] [پیش‌فرض: #]

موضوعاتی که باید پایش شوند

اتصال MQTT (MQTT CONNECTION)

-b, --broker <URL> [پیش‌فرض: mqtt://localhost]

نشانی URL که نحوه اتصال به کارگزار MQTT را مشخص می‌کند.

مثال‌ها: `mqtt://localhost` `mqtt://localhost:1883` `mqtts://localhost` `mqtts://localhost:8883` `ws://localhost/path` `ws://localhost:9001/path` `wss://localhost/path` `wss://localhost:9001/path`

-u, --username <STRING>

نام کاربری برای دسترسی به کارگزار MQTT.

در صورت عدم ارائه، دسترسی به صورت ناشناس خواهد بود.

--password <STRING>

گذرواژه برای دسترسی به کارگزار MQTT.

استفاده از یک اتصال مبتنی بر TLS به کارگزار را مد نظر قرار دهید؛ در غیر این صورت گذرواژه در قالب متن آشکار (plaintext) منتقل خواهد شد.

ارسال گذرواژه از طریق خط فرمان ناامن است زیرا گذرواژه می‌تواند از تاریخچه دستورات خوانده شود! باید آن را از طریق متغیر محیطی منتقل کنید.

-i, --client-id <STRING>

مشخص کردن شناسه کلاینت (client id) برای اتصال

--ca-cert <FILEPATH>

مسیر فایل PEM گواهی CA معتبر برای تأیید کارگزار.

گواهی CA باید یک گواهی X.509 نسخه ۳ باشد زیرا rustls از گواهی‌های نسخه ۱ که امنیت کمتری دارند پشتیبانی نمی‌کند. ببینید: https://github.com/rustls/rustls/issues/2364

--client-cert <FILEPATH>

مسیر فایل گواهی کلاینت TLS.

همراه با --client-private-key برای فعال‌سازی احراز هویت کلاینت TLS استفاده می‌شود. این فایل باید یک گواهی DER-encoded X.509 باشد که به PEM سریال‌سازی شده است.

--client-private-key <FILEPATH>

مسیر فایل کلید خصوصی کلاینت TLS.

همراه با --client-cert برای فعال‌سازی احراز هویت کلاینت TLS استفاده می‌شود. این فایل باید یک فایل DER-encoded ASN.1 در قالب PKCS#8 باشد که به PEM سریال‌سازی شده است.

--insecure

اجازه برقراری اتصالات ناامن TLS