PSENSOR-SERVER(1) User Commands PSENSOR-SERVER(1)

psensor-server - وب‌سرور پایش دما و سیستم

psensor-server [OPTION]...

برنامهٔ psensor-server یک کارگزار HTTP برای پایش حسگرهای سخت‌افزاری از راه دور است.

این برنامه یک وب‌سرویس JSON ارائه می‌دهد که می‌تواند توسط psensor(1) برای پایش حسگرهای سخت‌افزاری یک رایانه از راه دور استفاده شود.

این ابزار می‌تواند اطلاعات زیر را ارائه دهد:
* دمای حسگرهای مادربرد و CPU (با استفاده از lm-sensors).
* دمای دیسک‌های سخت (با استفاده از hddtemp).
* سرعت چرخش فن‌ها (با استفاده از lm-sensors).

همچنین اتصال به psensor-server با یک مرورگر امکان‌پذیر است؛ یک صفحهٔ وب ساده، اطلاعات حسگرها و میزان مصرف CPU را نمایش می‌دهد.

نشانی اینترنتی http://hostname:3131/api/1.0/sensors/[id] یک شیء JSON شامل تمام اطلاعات مربوط به یک حسگر را برمی‌گرداند. [id] شناسهٔ یکتای حسگر است.

در اینجا نمونه‌ای از شیء JSON از نوع 'sensor' آورده شده است:

{ "id": "lmsensor acpitz-virtual-0 temp1",
"name": "temp1",
"type": 257,
"min": 47.800000,
"max": 60.800000,
"measures": [ { "value": 47.800000, "time": 1311374873 },
{ "value": 49.800000, "time": 1311374878 },
{ "value": 49.800000, "time": 1311374883 } ],
"last_measure": { "value": 49.800000, "time": 1311374883 } }

فیلدهای نوع 'sensor':


* id: شناسهٔ یکتای حسگر.
* name: یک نام خوانا برای انسان از حسگر (ممکن است یکتا نباشد).
* type: نوع حسگر. برای انواع مختلف، به src/lib/psensor.h مراجعه کنید.
* min: کمینهٔ مقدار حسگر.
* max: بیشینهٔ مقدار حسگر.
* measures: تمام اندازه‌گیری‌های حسگر.
* last_measure: آخرین مقدار حسگر.
* time: زمان اندازه‌گیری بر حسب تعداد ثانیه‌های گذشته از 1970/01/01.

نشانی اینترنتی http://hostname:3131/api/1.0/sensors یک آرایهٔ JSON شامل تمامی اشیاء JSON از نوع 'sensor' را برمی‌گرداند.

برنامهٔ psensor-server می‌تواند با ارسال یک درخواست HTTP با نشانی 'http://hostname:port/api/1.0/server/stop' متوقف شود.

نمایش این راهنما و خروج
نمایش اطلاعات نگارش و خروج
درگاه وب‌سرور
دایرکتوری حاوی صفحات وب‌سرور
تنظیم سطح اشکال‌زدایی، عدد صحیحی بین 0 و 3
تنظیم فایل لاگ به PATH

--sensor-log-file=PATH تنظیم فایل لاگ حسگر به PATH

--sensor-log-interval=S تنظیم بازهٔ لاگ حسگر به S (ثانیه)

اطلاعات حسگرها با استفاده از گزینهٔ --sensor-log-file قابل ثبت هستند.

این قابلیت از یک قالب متنی استفاده می‌کند، و هر خط با نویسهٔ NEWLINE پایان می‌یابد.

خط نخست عبارت است از: I,%D,%V

%D زمان آغاز ثبت لاگ است که بر حسب تعداد ثانیه‌ها از زمان مبدأ (EPOC) بیان می‌شود.

%V نگارش psensor-server است.

خطوط بعدی فهرست مرتب‌شده‌ای از حسگرها را ارائه می‌دهند: S,%I,%T

%I شناسهٔ یکتای حسگر است.

%T نمایش هگزادسیمال (شانزده‌شانزدهی) نوع حسگر است.

سپس، مقادیر تمامی حسگرها نوشته می‌شود: %D,%V...

%D تعداد ثانیه‌های سپری‌شده از زمان آغاز ثبت لاگ است.

%V... فهرستی جداشده با ویرگول از مقادیر کنونی تمام حسگرها است. ترتیب آن با فهرست شناسه‌های حسگر یکسان است.

مقدار به عنوان یک عدد ممیز شناور با دقت یک رقم اعشار بیان می‌شود. دماها بر حسب سلسیوس هستند.

مقدار فقط در صورتی نوشته می‌شود که تغییر کرده باشد.

مثال: I,1345974927,0.7.0.4 S,lmsensor coretemp-isa-0000 Physical id 0,101 S,lmsensor coretemp-isa-0000 Core 0,101 S,lmsensor coretemp-isa-0000 Core 1,101 0,37.0,37.0,36.0 5,36.0,,36.0

پنج ثانیه پس از آغاز ثبت لاگ، دمای حسگر دوم (Core 0) همچنان 37C است.

برنامهٔ psensor-server هیچ روشی برای محدودسازی اتصال به وب‌سرور HTTP ارائه نمی‌دهد، و بدتر اینکه هیچ تدبیری در برابر حملات مخرب HTTP اندیشیده نشده است. شما باید درگاه psensor-server را تنها با استفاده از ابزارهای معمول امنیت شبکه در سیستم (به عنوان مثال iptables(8))، صرفاً در دسترس شبکه یا رایانه‌ای قرار دهید که به آن اطمینان دارید.

گزارش باگ‌ها به: jeanfi@gmail.com

صفحهٔ خانگی psensor: http://wpitchoune.net/psensor

حق نشر © 2010-2012 jeanfi@gmail.com اجازه‌نامهٔ GPLv2: گنو GPL نسخهٔ ۲ یا بالاتر http://www.gnu.org/licenses/old-licenses/gpl-2.0.html
این نرم‌افزار آزاد است: شما برای تغییر و توزیع مجدد آن آزاد هستید. هیچ ضمانتی وجود ندارد، تا حدی که قانون اجازه می‌دهد.

psensor(1), sensors(1), sensors-detect(8)

August 2026 psensor-server 1.2.1