### ### # 10 Zabbix agent on Microsoft Windows # 10 عامل Zabbix در مایکروسافت ویندوز # 11 Time zones # 11 منطقه زمانی # 13. Problem acknowledgment # 13. تایید مشکل # 13 Remote monitoring of Zabbix stats # 13 نظارت از راه دور آمار Zabbix # 14. Configuration export/import # 14. وارد کردن یا خروجی گرفتن از تنظیمات # 14 Configuring Kerberos with Zabbix # 14 پیکربندی Kerberos با Zabbix # 14 Scheduled reports # 14 گزارش های برنامه ریزی شده # 1 Aggregate calculations # 1 محاسبات کل # 1 Configuring a network discovery rule # 1 پیکربندی یک قانون کشف شبکه # 1 Configuring a template # 1 پیکربندی یک الگو # 1 Database creation # 1 ایجاد پایگاه داده # 1 Foreach functions # 1 توابع Foreach # 1 High availability # 1 در دسترس بودن بالا # 1 Host groups In the frontend host groups can be [exported](/manual/xml_export_import) only with host or template export. When a host or template is exported all groups it belongs to are exported with it automatically. API allows to export host groups independently from hosts or templates. # گروه هاست های 1 In the frontend host groups can be [exported](/manual/xml_export_import) only with host or template export. When a host or template is exported all groups it belongs to are exported with it automatically. API allows to export host groups independently from hosts or templates. # 1 Menu # 1 منو # 1 MySQL encryption configuration [comment]: # (tags: ssl) # 1 پیکربندی رمزگذاری MySQL [نظر]: # (برچسب‌ها: ssl) # 1 Server سرور شماره 1 # 1 Server-proxy data exchange protocol # 1 پروتکل تبادل داده سرور-پراکسی # 1 Trigger event generation # 1 ایجاد رویداد # 1 Zabbix agent عامل زبیکس # 21 Top hosts شماره 21 میزبان برتر # 23 What's new in Zabbix 6.0.18 # 23 موارد جدید در Zabbix 6.0.18 # 28 What's new in Zabbix 6.0.23 See [breaking changes](/manual/installation/upgrade_notes_6023#breaking_changes) for this version. # 28 موارد جدید در Zabbix 6.0.23 برای این نسخه به [تغییرات شکسته](/manual/installation/upgrade_notes_6023#breaking_changes) مراجعه کنید. # 29 What's new in Zabbix 6.0.24 # 23 موارد جدید در Zabbix 6.0.18 # 2 Agent نماینده شماره 2 2. Do not use "ps -ef" to browse processes - it shows only non-kernel processes. Use "ps -Af" to see all processes which will be seen by Zabbix agent. 3. Let's go through example of 'topasrec' how Zabbix agent proc.mem[] selects processes. ``` $ ps -Af | grep topasrec root 10747984 1 0 Mar 16 - 0:00 /usr/bin/topasrec -L -s 300 -R 1 -r 6 -o /var/perf daily/ -ypersistent=1 -O type=bin -ystart_time=04:08:54,Mar16,2023 ``` proc.mem[] has arguments: ``` proc.mem[<name>,<user>,<mode>,<cmdline>,<memtype>] ``` 2. از "ps -ef" برای مرور فرآیندها استفاده نکنید - فقط فرآیندهای غیر هسته را نشان می دهد. از "ps -Af" برای مشاهده تمام فرآیندهایی که توسط عامل Zabbix مشاهده می شوند استفاده کنید. 3. بیایید مثالی از 'topasrec' را مرور کنیم که چگونه عامل Zabbix proc.mem[] فرآیندها را انتخاب می کند. ``` $ ps -Af | grep topasrec root 10747984 1 0 مارس 16 - 0:00 /usr/bin/topasrec -L -s 300 -R 1 -r 6 -o /var/perf daily/ -ypersistent=1 -O type=bin -ystart_time=04:08 :54، مارس 16،2023 ``` proc.mem[] آرگومان هایی دارد: ``` proc.mem[<نام>، <کاربر>، <حالت>، <cmdline>، <memtype>] ``` # 2 PostgreSQL encryption configuration [comment]: # (tags: ssl) # 1 پیکربندی رمزگذاری MySQL [نظر]: # (برچسب‌ها: ssl) # 2 Problems شماره 2 مشکلات # 2 Templates # 2 قالب # 2 Trigger expression # 2 بیان ماشه # 2 User macros supported by location # 2 ماکروهای کاربر توسط مکان پشتیبانی می شوند # 3 Database upgrade to primary keys شماره 3 پایگاه داده به کلیدهای اصلی ارتقا دهید # 3 Data overview نمای کلی # 3 Hosts # هاست ها # 3 JSONPath functionality # 3 عملکرد JSONPath # 3 Low-level discovery # 3 کشف سطح پایین # 3 Manual closing of problems شماره 3 بسته شدن دستی مشکلات # 3 Receiving notification on unsupported items # 3 دریافت اعلان در مورد موارد پشتیبانی نشده # 4 Network maps نقشه های شبکه # 4 Secure connection to the database # 4 اتصال ایمن به پایگاه داده # 4 Zabbix agent 2 plugin protocol Zabbix agent 2 protocol is based on code, size and data model. # 4 پروتکل پلاگین Zabbix agent 2 پروتکل Zabbix agent 2 بر اساس کد، اندازه و مدل داده است. # 4 Zabbix agent 2 (UNIX) # Zabbix Agent 2 (یونیکس) # 5 Maps [comment]: # (tags: map) شماره 5 نقشه ها [نظر]: # (برچسب‌ها: نقشه) # 5 Media types نوع رسانه (انتقال) # 5 User parameters پارامترهای دیگر # 5 Zabbix agent (Windows) عامل #5 Zabbix (ویندوز) ### 6.0.13 6.0.13 ### 6.0.14 ### 6.0.14 ### 6.0.15 6.0.15 ### 6.0.3 ### 6.0.3 ### 6.0.7 ### 6.0.7 ### 6.0.9 ### 6.0.9 # 6 Elasticsearch setup ::: noteimportant Elasticsearch support is experimental! ::: Zabbix supports the storage of historical data by means of Elasticsearch instead of a database. Users can choose the storage place for historical data between a compatible database and Elasticsearch. The setup procedure described in this section is applicable to Elasticsearch version 7.X. In case an earlier or later version of Elasticsearch is used, some functionality may not work as intended. ::: notewarning If all history data is stored in Elasticsearch, trends are **not** calculated nor stored in the database. With no trends calculated and stored, the history storage period may need to be extended. ::: # 6 راه اندازی Elasticsearch ::: نکته مهم پشتیبانی Elasticsearch آزمایشی است! ::: Zabbix از ذخیره سازی داده های تاریخی با استفاده از Elasticsearch پشتیبانی می کند به جای پایگاه داده کاربران می توانند مکان ذخیره سازی تاریخی را انتخاب کنند داده ها بین یک پایگاه داده سازگار و Elasticsearch. راه اندازی روش توضیح داده شده در این بخش برای Elasticsearch قابل اجرا است نسخه 7.X. در صورتی که نسخه قبلی یا بعدی Elasticsearch باشد استفاده می شود، برخی از عملکردها ممکن است آنطور که در نظر گرفته شده کار نکنند. ::: هشدار اگر تمام داده های تاریخچه در Elasticsearch ذخیره شده است، روندها ** محاسبه نشده و در پایگاه داده ذخیره نمی شوند. بدون هیچ روند محاسبه و ذخیره می شود، دوره ذخیره سازی تاریخچه ممکن است نیاز داشته باشد تمدید شده. ::: # 6 Log file monitoring [comment]: # (tags: logrt, logfile, log) # 6 نظارت بر فایل ورود [نظر]: # (برچسب‌ها: logrt، logfile، log) # 6 Zabbix appliance شماره 6 دستگاه Zabbix # 9 Notes on memtype parameter in proc.mem items # 9 نکاتی در مورد پارامتر memtype در موارد proc.mem # 9. Web monitoring مانیتورینگ وب #### Acknowledging an event Acknowledge a single event and leave a message. Request: ```json { "jsonrpc": "2.0", "method": "event.acknowledge", "params": { "eventids": "20427", "action": 6, "message": "Problem resolved." }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "eventids": [ "20427" ] }, "id": 1 } ``` #### تایید یک رخداد Acknowledge a single event and leave a message. Request: ```json { "jsonrpc": "2.0", "method": "event.acknowledge", "params": { "eventids": "20427", "action": 6, "message": "Problem resolved." }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "eventids": [ "20427" ] }, "id": 1 } ``` # action.create # ساخت اکشن # action.delete # action.delete ### Action filter The action filter object defines a set of conditions that must be met to perform the configured action operations. It has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**conditions**<br>(required)|array|Set of filter conditions to use for filtering results.| |**evaltype**<br>(required)|integer|Filter condition evaluation method.<br><br>Possible values:<br>0 - and/or;<br>1 - and;<br>2 - or;<br>3 - custom expression.| |eval\_formula|string|*(readonly)* Generated expression that will be used for evaluating filter conditions. The expression contains IDs that reference specific filter conditions by its `formulaid`. The value of `eval_formula` is equal to the value of `formula` for filters with a custom expression.| |formula|string|User-defined expression to be used for evaluating conditions of filters with a custom expression. The expression must contain IDs that reference specific filter conditions by its `formulaid`. The IDs used in the expression must exactly match the ones defined in the filter conditions: no condition can remain unused or omitted.<br><br>Required for custom expression filters.| ### فیلتر عمل شی فیلتر عمل مجموعه ای از شرایط را تعریف می کند که باید رعایت شوند عملیات پیکربندی شده را انجام دهید. موارد زیر را دارد خواص |مخصوص|[نوع](/manual/api/reference_commentary#data_types)|توضیحات| |--|--|------| |**شرایط**<br>(ضروری)|آرایه|مجموعه شرایط فیلتر برای استفاده برای فیلتر کردن نتایج.| |**evaltype**<br>(الزامی)|عدد صحیح|روش ارزیابی شرایط فیلتر.<br><br>مقادیر ممکن:<br>0 - و/یا;<br>1 - و;<br>2 - یا;<br>3 - عبارت سفارشی.| |eval\_formula|string|*(readonly)* عبارت ایجاد شده است که برای ارزیابی شرایط فیلتر استفاده خواهد شد. عبارت حاوی شناسه هایی است که به شرایط فیلتر خاص توسط «formulaid» خود ارجاع می دهند. مقدار 'eval_formula' برابر با مقدار 'formula' برای فیلترهایی با عبارت سفارشی است.| |formula|string|عبارت تعریف شده توسط کاربر برای ارزیابی شرایط فیلترها با عبارت سفارشی استفاده می شود. عبارت باید حاوی شناسه هایی باشد که با «formulaid» خود به شرایط فیلتر خاص ارجاع می دهند. شناسه های استفاده شده در عبارت باید دقیقاً مطابق با موارد تعریف شده در شرایط فیلتر باشد: هیچ شرطی نمی تواند بدون استفاده یا حذف شود.<br><br>برای فیلترهای عبارت سفارشی مورد نیاز است.| # action.get # دریافت اکشن #### Action operation condition The action operation condition object defines a condition that must be met to perform the current operation. It has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |opconditionid|string|*(readonly)* ID of the action operation condition| |**conditiontype**<br>(required)|integer|Type of condition.<br><br>Possible values:<br>14 - event acknowledged.| |**value**<br>(required)|string|Value to compare with.| |operationid|string|*(readonly)* ID of the operation.| |operator|integer|Condition operator.<br><br>Possible values:<br>0 - *(default)* =.| The following operators and values are supported for each operation condition type. |Condition|Condition name|Supported operators|Expected value| |---------|--------------|-------------------|--------------| |14|Event acknowledged|=|Whether the event is acknowledged.<br><br>Possible values:<br>0 - not acknowledged;<br>1 - acknowledged.| #### شرایط عملیات اکشن شیء شرط عملیات عمل، شرطی را تعریف می کند که باید باشد برای انجام عملیات جاری ملاقات کرد. دارای خواص زیر می باشد. |مخصوص|[نوع](/manual/api/reference_commentary#data_types)|توضیحات| |--|--|------| |opconditionid|string|*(readonly)* شناسه شرط عملیات عمل| |**conditiontype**<br>(الزامی)|عدد صحیح|نوع شرط.<br><br>مقادیر ممکن:<br>14 - رویداد تایید شد.| |**مقدار**<br>(لازم)|رشته|مقدار برای مقایسه.| |operationid|string|*(readonly)* شناسه عملیات.| |اپراتور|عدد صحیح|عملگر شرط.<br><br>مقادیر ممکن:<br>0 - *(پیش‌فرض)* =.| عملگرها و مقادیر زیر برای هر عملیات پشتیبانی می شوند نوع شرط |شرط|نام شرط|اپراتورهای پشتیبانی شده|مقدار مورد انتظار| |---------|-------------|------------------|---- ----------| |14|رویداد تأیید شد|=|آیا رویداد تأیید شده است یا نه.<br><br>مقادیر ممکن:<br>0 - تایید نشد؛<br>1 - تایید شد.| #### Action operation message The operation message object contains data about the message that will be sent by the operation. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |default\_msg|integer|Whether to use the default action message text and subject.<br><br>Possible values:<br>0 - use the data from the operation;<br>1 - *(default)* use the data from the media type.| |mediatypeid|string|ID of the media type that will be used to send the message.| |message|string|Operation message text.| |subject|string|Operation message subject.| #### پیام عملیات اقدام شیء پیام عملیات حاوی اطلاعاتی در مورد پیام است که خواهد شد توسط عملیات ارسال شود. |مخصوص|[نوع](/manual/api/reference_commentary#data_types)|توضیحات| |--|--|------| |default\_msg|عدد صحیح|از متن و موضوع پیام اقدام پیش‌فرض استفاده شود یا نه.<br><br>مقادیر ممکن:<br>0 - استفاده از داده‌های عملیات؛<br>1 - *(پیش‌فرض)* استفاده داده ها از نوع رسانه.| |mediatypeid|string|ID از نوع رسانه ای که برای ارسال پیام استفاده می شود.| |پیام|رشته|متن پیام عملیات.| |موضوع|رشته|موضوع پیام عملیات.| ### Action operation The action operation object defines an operation that will be performed when an action is executed. It has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |operationid|string|*(readonly)* ID of the action operation.| |**operationtype**<br>(required)|integer|Type of operation.<br><br>Possible values:<br>0 - send message;<br>1 - global script;<br>2 - add host;<br>3 - remove host;<br>4 - add to host group;<br>5 - remove from host group;<br>6 - link to template;<br>7 - unlink from template;<br>8 - enable host;<br>9 - disable host;<br>10 - set host inventory mode.<br><br>Note that only types '0' and '1' are supported for trigger and service actions, only '0' is supported for internal actions. All types are supported for discovery and autoregistration actions.| |actionid|string|*(readonly)* ID of the action that the operation belongs to.| |esc\_period|string|Duration of an escalation step in seconds. Must be greater than 60 seconds. Accepts seconds, time unit with suffix and user macro. If set to 0 or 0s, the default action escalation period will be used.<br><br>Default: 0s.<br><br>Note that escalations are supported only for trigger, internal and service actions, and only in normal operations.| |esc\_step\_from|integer|Step to start escalation from.<br><br>Default: 1.<br><br>Note that escalations are supported only for trigger, internal and service actions, and only in normal operations.| |esc\_step\_to|integer|Step to end escalation at.<br><br>Default: 1.<br><br>Note that escalations are supported only for trigger, internal and service actions, and only in normal operations.| |evaltype|integer|Operation condition evaluation method.<br><br>Possible values:<br>0 - *(default)* AND / OR;<br>1 - AND;<br>2 - OR.| |opcommand|object|Object containing data on global script run by the operation.<br><br>Each object has one following property: `scriptid` - *(string)* ID of the script.<br><br>Required for global script operations.| |opcommand\_grp|array|Host groups to run global scripts on.<br><br>Each object has the following properties:<br>`opcommand_grpid` - *(string, readonly)* ID of the object;<br>`operationid` - *(string, readonly)* ID of the operation;<br>`groupid` - *(string)* ID of the host group.<br><br>Required for global script operations if `opcommand_hst` is not set.| |opcommand\_hst|array|Host to run global scripts on.<br><br>Each object has the following properties:<br>`opcommand_hstid` - *(string, readonly)* ID of the object;<br>`operationid` - *(string, readonly)* ID of the operation;<br>`hostid` - *(string)* ID of the host; if set to 0 the command will be run on the current host.<br><br>Required for global script operations if `opcommand_grp` is not set.| |opconditions|array|Operation conditions used for trigger actions.<br><br>The operation condition object is [described in detail below](/manual/api/reference/action/object#action_operation_condition).| |opgroup|array|Host groups to add hosts to.<br><br>Each object has the following properties:<br>`operationid` - *(string, readonly)* ID of the operation;<br>`groupid` - *(string)* ID of the host group.<br><br>Required for "add to host group" and "remove from host group" operations.| |opmessage|object|Object containing the data about the message sent by the operation.<br><br>The operation message object is [described in detail below](/manual/api/reference/action/object#action_operation_message).<br><br>Required for message operations.| |opmessage\_grp|array|User groups to send messages to.<br><br>Each object has the following properties:<br>`operationid` - *(string, readonly)* ID of the operation;<br>`usrgrpid` - *(string)* ID of the user group.<br><br>Required for message operations if `opmessage_usr` is not set.| |opmessage\_usr|array|Users to send messages to.<br><br>Each object has the following properties:<br>`operationid` - *(string, readonly)* ID of the operation;<br>`userid` - *(string)* ID of the user.<br><br>Required for message operations if `opmessage_grp` is not set.| |optemplate|array|Templates to link the hosts to.<br><br>Each object has the following properties:<br>`operationid` - *(string, readonly)* ID of the operation;<br>`templateid` - *(string)* ID of the template.<br><br>Required for "link to template" and "unlink from template" operations.| |opinventory|object|Inventory mode set host to.<br><br>Object has the following properties:<br>`operationid` - *(string, readonly)* ID of the operation;<br>`inventory_mode` - *(string)* Inventory mode.<br><br>Required for "Set host inventory mode" operations.| ### عملیات اکشن شی عملیات عملیاتی عملیاتی را تعریف می کند که انجام خواهد شد زمانی که یک عمل اجرا می شود دارای خواص زیر می باشد. |مخصوص|[نوع](/manual/api/reference_commentary#data_types)|توضیحات| |--|--|------| |operationid|string|*(readonly)* شناسه عملیات اقدام.| |**نوع عملیات**<br>(الزامی)|عدد صحیح|نوع عملیات.<br><br>مقادیر ممکن:<br>0 - ارسال پیام؛<br>1 - اسکریپت جهانی؛<br>2 - افزودن میزبان؛<br>3 - حذف میزبان؛<br>4 - افزودن به گروه میزبان؛<br>5 - حذف از گروه میزبان؛<br>6 - پیوند به الگو؛<br>7 - لغو پیوند از الگو؛<br> >8 - فعال کردن میزبان؛<br>9 - غیرفعال کردن میزبان؛<br>10 - تنظیم حالت موجودی میزبان.<br><br>توجه داشته باشید که فقط انواع «0» و «1» برای اقدامات راه‌اندازی و خدمات پشتیبانی می‌شوند. '0' برای اقدامات داخلی پشتیبانی می شود. همه انواع برای اقدامات کشف و ثبت خودکار پشتیبانی می شوند.| |actionid|string|*(readonly)* شناسه عملی که عملیات به آن تعلق دارد.| |esc\_period|string|مدت یک مرحله تشدید بر حسب ثانیه. باید بیشتر از 60 ثانیه باشد. ثانیه، واحد زمان با پسوند و ماکرو کاربر را می پذیرد. اگر روی 0 یا 0 تنظیم شود، از دوره پیش‌فرض تشدید کنش استفاده می‌شود.<br><br>پیش‌فرض: 0s.<br><br>توجه داشته باشید که تشدیدها فقط برای اقدامات ماشه، داخلی و خدمات پشتیبانی می‌شوند و فقط در حالت عادی عملیات.| |esc\_step\_from|عدد صحیح|مرحله برای شروع تشدید از.<br><br>پیش‌فرض: 1.<br><br>توجه داشته باشید که تشدیدها فقط برای اقدامات ماشه، داخلی و خدمات پشتیبانی می‌شوند و فقط در عملیات عادی .| |esc\_step\_to|عدد صحیح|مرحله تا پایان تشدید در.<br><br>پیش‌فرض: 1.<br><br>توجه داشته باشید که تشدیدها فقط برای اقدامات ماشه‌ای، داخلی و خدماتی و فقط در عملیات عادی پشتیبانی می‌شوند. .| |evaltype|عدد صحیح|روش ارزیابی شرایط عملیات.<br><br>مقادیر ممکن:<br>0 - *(پیش‌فرض)* AND / OR;<br>1 - AND;<br>2 - OR.| |opcommand|object|شیء حاوی داده روی اسکریپت سراسری اجرا شده توسط عملیات.<br><br>هر شی دارای یک ویژگی زیر است: `scriptid` - *(string)* شناسه اسکریپت.<br><br>الزامی برای عملیات اسکریپت جهانی.| |opcommand\_grp|آرایه|گروه‌های میزبان برای اجرای اسکریپت‌های سراسری.<br><br>هر شی دارای ویژگی‌های زیر است:<br>`opcommand_grpid` - *(رشته، فقط خواندنی)* شناسه شی;<br> "operationid" - *(رشته، فقط خواندنی)* شناسه عملیات؛<br>"گروهی" - *(رشته)* شناسه گروه میزبان.<br><br>برای عملیات اسکریپت جهانی اگر "opcommand_hst" باشد لازم است تنظیم نشده است.| |opcommand\_hst|آرایه|میزبان برای اجرای اسکریپت های سراسری.<br><br>هر شی دارای ویژگی های زیر است:<br>`opcommand_hstid` - *(رشته، فقط خواندنی)* شناسه شی;<br>` Operationid` - *(رشته، فقط خواندنی)* شناسه عملیات;<br>`hostid` - *(رشته)* شناسه میزبان; اگر روی 0 تنظیم شود، فرمان روی میزبان فعلی اجرا خواهد شد.<br><br>اگر "opcommand_grp" تنظیم نشده باشد، برای عملیات اسکریپت جهانی لازم است.| |opconditions|آرایه|شرایط عملیاتی که برای اقدامات ماشه استفاده می‌شود.<br><br>شیء شرط عملیات [در جزئیات زیر توضیح داده شده است](/manual/api/reference/action/object#action_operation_condition).| |opgroup|آرایه|گروه‌های میزبان برای افزودن میزبان‌ها.<br><br>هر شی دارای ویژگی‌های زیر است:<br>`operationid` - *(string, only read)* شناسه عملیات;<br>`groupid` - *(رشته)* شناسه گروه میزبان.<br><br>برای عملیات "افزودن به گروه میزبان" و "حذف از گروه میزبان" لازم است.| |opmessage|object|شیء حاوی داده‌های مربوط به پیام ارسال‌شده توسط عملیات.<br><br>شیء پیام عملیات [به تفصیل در زیر توضیح داده شده است](/manual/api/reference/action/object#action_operation_message).< br><br>برای عملیات پیام مورد نیاز است.| |opmessage\_grp|آرایه|گروه های کاربری برای ارسال پیام به آنها.<br><br>هر شی دارای ویژگی های زیر است:<br>`operationid` - *(string, only read)* شناسه عملیات;<br>` usrgrpid` - *(string)* شناسه گروه کاربر.<br><br>اگر "opmessage_usr" تنظیم نشده باشد، برای عملیات پیام مورد نیاز است.| |opmessage\_usr|آرایه|کاربرانی برای ارسال پیام به آنها.<br><br>هر شی دارای ویژگی های زیر است:<br>`operationid` - *(رشته، فقط خواندنی)* شناسه عملیات؛<br>`userid ` - *(string)* شناسه کاربر.<br><br>اگر "opmessage_grp" تنظیم نشده باشد، برای عملیات پیام مورد نیاز است.| |optemplate|آرایه|الگوهایی برای پیوند دادن میزبان ها به.<br><br>هر شی دارای ویژگی های زیر است:<br>`operationid` - *(string, only read)* شناسه عملیات;<br>`templateid` - *(رشته)* شناسه الگو.<br><br>برای عملیات "پیوند به الگو" و "لغو پیوند از الگو" لازم است.| |opinventory|object|حالت موجودی میزبان را تنظیم کنید.<br><br>شیء دارای ویژگی های زیر است:<br>`operationid` - *(string, only read)* ID عملیات؛<br>`inventory_mode` - * (رشته)* حالت موجودی.<br><br>برای عملیات "تنظیم حالت موجودی میزبان" لازم است.| #### Actions if communication fails between agent and server Each matching line from `log[]` and `logrt[]` item and a result of each `log.count[]` and `logrt.count[]` item check requires a free slot in the designated 50% area in the agent send buffer. The buffer elements are regularly sent to server (or proxy) and the buffer slots are free again. While there are free slots in the designated log area in the agent send buffer and communication fails between agent and server (or proxy) the log monitoring results are accumulated in the send buffer. This helps to mitigate short communication failures. During longer communication failures all log slots get occupied and the following actions are taken: - `log[]` and `logrt[]` item checks are stopped. When communication is restored and free slots in the buffer are available the checks are resumed from the previous position. No matching lines are lost, they are just reported later. - `log.count[]` and `logrt.count[]` checks are stopped if `maxdelay = 0` (default). Behavior is similar to `log[]` and `logrt[]` items as described above. Note that this can affect `log.count[]` and `logrt.count[]` results: for example, one check counts 100 matching lines in a log file, but as there are no free slots in the buffer the check is stopped. When communication is restored the agent counts the same 100 matching lines and also 70 new matching lines. The agent now sends count = 170 as if they were found in one check. - `log.count[]` and `logrt.count[]` checks with `maxdelay > 0`: if there was no "jump" during the check, then behavior is similar to described above. If a "jump" over log file lines took place then the position after "jump" is kept and the counted result is discarded. So, the agent tries to keep up with a growing log file even in case of communication failure. #### اقدامات در صورتی که ارتباط بین عامل و سرور با شکست مواجه شود هر خط منطبق از آیتم «log[]» و «logrt[]» و نتیجه هر کدام بررسی آیتم «log.count[]» و «logrt.count[]» به یک شکاف رایگان در 50٪ منطقه در بافر ارسال عامل تعیین شده است. عناصر بافر هستند به طور منظم به سرور (یا پروکسی) ارسال می شود و اسلات های بافر دوباره رایگان هستند. در حالی که اسلات های رایگان در منطقه ورود به سیستم تعیین شده در ارسال عامل وجود دارد بافر و ارتباط بین عامل و سرور (یا پروکسی) از کار می افتد نتایج نظارت بر گزارش در بافر ارسال جمع می شود. این کمک می کند تا کاهش خرابی های کوتاه ارتباطی در طول خرابی های ارتباطی طولانی تر، همه اسلات ورود به سیستم اشغال می شوند و اقدامات زیر انجام می شود: - بررسی آیتم «log[]» و «logrt[]» متوقف شده است. وقتی ارتباط هست اسلات های بازیابی شده و رایگان در بافر در دسترس هستند چک ها هستند از موقعیت قبلی از سر گرفته شد. آنها هیچ خط تطبیقی از بین نمی روند فقط بعدا گزارش می شود - اگر چک‌های «log.count[]» و «logrt.count[]» متوقف شوند "maxdelay = 0" (پیش‌فرض). رفتار مشابه «log[]» و موارد "logrt[]" همانطور که در بالا توضیح داده شد. توجه داشته باشید که این می تواند تأثیر بگذارد نتایج «log.count[]» و «logrt.count[]»: برای مثال، یک بررسی 100 خط منطبق را در یک فایل گزارش می‌شمارد، اما از آنجایی که رایگان وجود ندارد اسلات در بافر چک متوقف شده است. وقتی ارتباط هست بازیابی شده، عامل همان 100 خط منطبق و همچنین 70 را می‌شمارد خطوط منطبق جدید نماینده اکنون تعداد = 170 را ارسال می کند که انگار آنها هستند در یک چک پیدا شد - «log.count[]» و «logrt.count[]» با «maxdelay > 0» بررسی می‌شود: اگر هیچ "پرش" در طول چک وجود دارد، سپس رفتار مشابه است در بالا توضیح داده شد. اگر یک "پرش" روی خطوط فایل لاگ صورت می گرفت، موقعیت پس از "پرش" حفظ می شود و نتیجه شمارش شده دور ریخته می شود. بنابراین، عامل تلاش می کند تا با یک فایل log در حال رشد حتی در صورت لزوم همگام شود از شکست ارتباطی #### Actions In [actions](/manual/config/notifications/action), user macros can be used in the following fields: |Location|<|Multiple macros/mix with text^[1](supported_by_location_user#footnotes)^| |-|------------------------------|----------| |Trigger-based notifications and commands|<|yes| |Trigger-based internal notifications|<|yes| |Problem update notifications|<|yes| |Service-based notifications and commands|<|yes| |Service update notifications|<|yes| |Time period condition|<|no| |*Operations*|<|<| | |Default operation step duration|no| |^|Step duration|no| #### اقدامات در [actions](/manual/config/notifications/action)، ماکروهای کاربر را می توان در زمینه های زیر استفاده می شود: |موقعیت|<|چند ماکرو/میکس با متن^[1](پشتیبانی_شده توسط_location_user#footnotes)^| |-|-----------------------------|----------| |اعلان ها و دستورات مبتنی بر ماشه|<|بله| |اعلان های داخلی مبتنی بر ماشه|<|بله| |اعلان های به روز رسانی مشکل|<|بله| |اعلان ها و دستورات مبتنی بر سرویس|<|بله| |اعلان های به روز رسانی سرویس|<|بله| |شرایط دوره زمانی|<|نه| |*عملیات*|<|<| | |مدت زمان پیش فرض مرحله عملیات|خیر| |^|مدت مرحله|نه| ### Action The action object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |actionid|string|*(readonly)* ID of the action.| |**esc\_period**<br>(required)|string|Default operation step duration. Must be at least 60 seconds. Accepts seconds, time unit with suffix and user macro.<br><br>Note that escalations are supported only for trigger, internal and service actions, and only in normal operations.| |**eventsource**<br>(required)|integer|*(constant)* Type of events that the action will handle.<br><br>Refer to the [event "source" property](/manual/api/reference/event/object#event) for a list of supported event types.| |**name**<br>(required)|string|Name of the action.| |status|integer|Whether the action is enabled or disabled.<br><br>Possible values:<br>0 - *(default)* enabled;<br>1 - disabled.| |pause\_suppressed|integer|Whether to pause escalation during maintenance periods or not.<br><br>Possible values:<br>0 - Don't pause escalation;<br>1 - *(default)* Pause escalation.<br><br>Note that this parameter is valid for trigger actions only.| |notify\_if\_canceled|integer|Whether to notify when escalation is canceled.<br><br>Possible values:<br>0 - Don't notify when escalation is canceled;<br>1 - *(default)* Notify when escalation is canceled.<br><br>Note that this parameter is valid for trigger actions only.| Note that for some methods (update, delete) the required/optional parameter combination is different. ### اکشن آبجکت اکشن دارای ویژگی های زیر است. |مخصوص|[نوع](/manual/api/reference_commentary#data_types)|توضیحات| |--|--|------| |actionid|string|*(readonly)* شناسه اقدام.| |**esc\_period**<br>(لازم)|رشته|مدت زمان پیش‌فرض مرحله عملیات. باید حداقل 60 ثانیه باشد. ثانیه ها، واحد زمان را با پسوند و ماکرو کاربر می پذیرد.<br><br>توجه داشته باشید که تشدیدها فقط برای اقدامات ماشه، داخلی و خدمات و فقط در عملیات عادی پشتیبانی می شوند.| |**eventsource**<br>(لازم)|عدد صحیح|*(ثابت)* نوع رویدادهایی که عمل انجام می دهد.<br><br>به [ویژگی "منبع" رویداد](/manual/api مراجعه کنید. /reference/event/object#event) برای لیستی از انواع رویدادهای پشتیبانی شده.| |**نام**<br>(لازم)|رشته|نام عمل.| |وضعیت|عدد صحیح|فعال یا غیرفعال بودن عملکرد.<br><br>مقادیر ممکن:<br>0 - *(پیش‌فرض)* فعال است؛<br>1 - غیرفعال است.| |pause\_suppressed|عدد صحیح|اینکه تشدید در طول دوره‌های نگهداری متوقف شود یا خیر.<br><br>مقادیر ممکن:<br>0 - تشدید موقتاً متوقف نشود؛<br>1 - *(پیش‌فرض)* تشدید را متوقف کنید. <br><br>توجه داشته باشید که این پارامتر فقط برای اقدامات ماشه معتبر است.| |notify\_if\_canceled|عدد صحیح|آیا هنگام لغو تشدید اطلاع داده شود.<br><br>مقادیر احتمالی:<br>0 - هنگام لغو تشدید اطلاع داده نشود؛<br>1 - *(پیش‌فرض)* هنگامی که تشدید لغو شد، اطلاع دهید.<br><br>توجه داشته باشید که این پارامتر فقط برای اقدامات راه‌اندازی معتبر است.| توجه داشته باشید که برای برخی از روش ها (به روز رسانی، حذف) ترکیب پارامترهای مورد نیاز/اختیاری متفاوت است. # action.update # action.update ### Action update operation The action update operation object defines an operation that will be performed when a problem is updated (commented upon, acknowledged, severity changed, or manually closed). Update operations are possible for trigger and service actions. It has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |operationid|string|*(readonly)* ID of the action operation.| |**operationtype**<br>(required)|integer|Type of operation.<br><br>Possible values for trigger and service actions:<br>0 - send message;<br>1 - global script;<br>12 - notify all involved.| |opcommand|object|Object containing data on global action type script run by the operation.<br><br>Each object has one following property: `scriptid` - *(string)* ID of the action type script.<br><br>Required for global script operations.| |opcommand\_grp|array|Host groups to run global scripts on.<br><br>Each object has the following properties:<br>`groupid` - *(string)* ID of the host group.<br><br>Required for global script operations if `opcommand_hst` is not set.| |opcommand\_hst|array|Host to run global scripts on.<br><br>Each object has the following properties:<br>`hostid` - *(string)* ID of the host; if set to 0 the command will be run on the current host.<br><br>Required for global script operations if `opcommand_grp` is not set.| |opmessage|object|Object containing the data about the message sent by the update operation.<br><br>The operation message object is [described in detail above](/manual/api/reference/action/object#action_operation_message).| |opmessage\_grp|array|User groups to send messages to.<br><br>Each object has the following properties:<br>`usrgrpid` - *(string)* ID of the user group.<br><br>Required only for `send message` operations if `opmessage_usr` is not set.<br>Is ignored for `send update message` operations.| |opmessage\_usr|array|Users to send messages to.<br><br>Each object has the following properties:<br>`userid` - *(string)* ID of the user.<br><br>Required only for `send message` operations if `opmessage_grp` is not set.<br>Is ignored for `send update message` operations.| ### عملیات به روز رسانی اکشن شی عملیات به روز رسانی عمل، عملیاتی را تعریف می کند که خواهد بود زمانی انجام می شود که یک مشکل به روز می شود (نظر داده می شود، تایید می شود، شدت تغییر کرد یا به صورت دستی بسته شد). عملیات به روز رسانی امکان پذیر است برای اقدامات ماشه و سرویس. دارای خواص زیر می باشد. |مخصوص|[نوع](/manual/api/reference_commentary#data_types)|توضیحات| |--|--|------| |operationid|string|*(readonly)* شناسه عملیات اقدام.| |**عملکرد نوع**<br>(الزامی)|عدد صحیح|نوع عملیات.<br><br>مقادیر ممکن برای اقدامات ماشه و سرویس:<br>0 - ارسال پیام؛<br>1 - اسکریپت جهانی؛< br>12 - به همه درگیرها اطلاع دهید.| |opcommand|object|شیء حاوی داده‌های مربوط به اسکریپت نوع عمل جهانی که توسط عملیات اجرا می‌شود.<br><br>هر شی دارای یک ویژگی زیر است: `scriptid` - *(string)* شناسه اسکریپت نوع اقدام.<br> <br>برای عملیات اسکریپت جهانی مورد نیاز است.| |opcommand\_grp|آرایه|گروه‌های میزبان برای اجرای اسکریپت‌های سراسری.<br><br>هر شی دارای ویژگی‌های زیر است:<br>`groupid` - *(string)* شناسه گروه میزبان.<br><br><br> br>اگر "opcommand_hst" تنظیم نشده باشد، برای عملیات اسکریپت جهانی مورد نیاز است.| |opcommand\_hst|آرایه|میزبان برای اجرای اسکریپت های سراسری.<br><br>هر شی دارای ویژگی های زیر است:<br>`hostid` - *(string)* شناسه میزبان; اگر روی 0 تنظیم شود، فرمان روی میزبان فعلی اجرا خواهد شد.<br><br>اگر "opcommand_grp" تنظیم نشده باشد، برای عملیات اسکریپت جهانی لازم است.| |opmessage|object|شیء حاوی داده‌های مربوط به پیام ارسال شده توسط عملیات به‌روزرسانی.<br><br>شیء پیام عملیات [در جزئیات در بالا توضیح داده شده است](/manual/api/reference/action/object#action_operation_message). | |opmessage\_grp|آرایه|گروه های کاربری برای ارسال پیام به آنها.<br><br>هر شی دارای ویژگی های زیر است:<br>`usrgrpid` - *(string)* شناسه گروه کاربر.<br><br> >در صورتی که «opmessage_usr» تنظیم نشده باشد، فقط برای عملیات «ارسال پیام» لازم است.<br>برای عملیات «ارسال پیام به‌روزرسانی» نادیده گرفته می‌شود.| |opmessage\_usr|آرایه|کاربرانی برای ارسال پیام به آنها.<br><br>هر شی دارای ویژگی های زیر است:<br>`userid` - *(string)* شناسه کاربر.<br><br>لازم است فقط برای عملیات "ارسال پیام" اگر "opmessage_grp" تنظیم نشده باشد.<br>برای عملیات "ارسال پیام به روز رسانی" نادیده گرفته می شود.| #### Active proxy #### پراکسی غیرفعال #### Adding a scheduled downtime Add a downtime for service with ID "4" scheduled weekly from Monday 22:00 till Tuesday 10:00. Request: ```json { "jsonrpc": "2.0", "method": "service.update", "params": { "serviceid": "4", "times": [ { "type": "1", "ts_from": "165600", "ts_to": "201600" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "serviceids": [ "4" ] }, "id": 1 } ``` ####غیرفعال کردن نمونه اولیه هاست Disable a host prototype, that is, set its status to 1. Request: ```json { "jsonrpc": "2.0", "method": "hostprototype.update", "params": { "hostid": "10092", "status": 1 }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "hostids": [ "10092" ] }, "id": 1 } ``` #### Adding dashboards To add dashboards to a template in *Configuration → Templates*, do the following: - Click on *Dashboards* in the row of the template - Configure a dashboard following the guidelines of [configuring dashboards](/manual/web_interface/frontend_sections/monitoring/dashboard) ::: noteimportant The widgets that can be included in a template dashboard are: *Clock*, *Graph (classic)*, *Graph prototype*, *Item value*, *Plain text*, *URL*. ::: ::: notetip For details on accessing host dashboards that are created from template dashboards, see the [host dashboard](/manual/config/visualization/host_screens#accessing_host_dashboards) section. ::: #### افزودن داشبورد برای افزودن داشبورد به یک الگو در *پیکربندی → الگوها*، این کار را انجام دهید ذیل: - روی *داشبوردها* در ردیف قالب کلیک کنید - یک داشبورد را با پیروی از دستورالعمل های [پیکربندی] پیکربندی کنید داشبوردها](/دستی/web_interface/frontend_sections/monitoring/dashboard) ::: نکته مهم ویجت هایی که می توانند در داشبورد الگو گنجانده شوند عبارتند از: *ساعت*، *گراف (کلاسیک)*، *نمونه اولیه نمودار*، *مقدار مورد*، *متن ساده*، *URL*. ::: ::: یادداشت برای جزئیات دسترسی به داشبوردهای میزبان که هستند ایجاد شده از داشبوردهای الگو، [میزبان داشبورد](/دستی/پیکربندی/تجسم/صفحات_میزبان#دسترسی به_داشبوردهای میزبان) بخش. ::: #### Adding hosts to host groups Add two hosts to host groups with IDs 5 and 6. Request: ```json { "jsonrpc": "2.0", "method": "hostgroup.massadd", "params": { "groups": [ { "groupid": "5" }, { "groupid": "6" } ], "hosts": [ { "hostid": "30050" }, { "hostid": "30001" } ] }, "auth": "f223adf833b2bf2ff38574a67bba6372", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "groupids": [ "5", "6" ] }, "id": 1 } ``` #### اضافه کردن هاست به گروه هاستی Add two hosts to host groups with IDs 5 and 6. Request: ```json { "jsonrpc": "2.0", "method": "hostgroup.massadd", "params": { "groups": [ { "groupid": "5" }, { "groupid": "6" } ], "hosts": [ { "hostid": "30050" }, { "hostid": "30001" } ] }, "auth": "f223adf833b2bf2ff38574a67bba6372", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "groupids": [ "5", "6" ] }, "id": 1 } ``` #### Adding LLD macro paths Request: ```json { "jsonrpc": "2.0", "method": "discoveryrule.update", "params": { "itemid": "22450", "lld_macro_paths": [ { "lld_macro": "{#MACRO1}", "path": "$.json.path" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "22450" ] }, "id": 1 } ``` #### اضافه کردن مسیر ماکرو LLD Request: ```json { "jsonrpc": "2.0", "method": "discoveryrule.update", "params": { "itemid": "22450", "lld_macro_paths": [ { "lld_macro": "{#MACRO1}", "path": "$.json.path" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "22450" ] }, "id": 1 } ``` #### Adding macros Add two new macros to two hosts. Request: ```json { "jsonrpc": "2.0", "method": "host.massadd", "params": { "hosts": [ { "hostid": "10160" }, { "hostid": "10167" } ], "macros": [ { "macro": "{$TEST1}", "value": "MACROTEST1" }, { "macro": "{$TEST2}", "value": "MACROTEST2", "description": "Test description" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "hostids": [ "10160", "10167" ] }, "id": 1 } ``` #### اضافه کردن ماکرو ها Add two new macros to two hosts. Request: ```json { "jsonrpc": "2.0", "method": "host.massadd", "params": { "hosts": [ { "hostid": "10160" }, { "hostid": "10167" } ], "macros": [ { "macro": "{$TEST1}", "value": "MACROTEST1" }, { "macro": "{$TEST2}", "value": "MACROTEST2", "description": "Test description" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "hostids": [ "10160", "10167" ] }, "id": 1 } ``` #### Adding web scenarios To add web scenarios to a template in *Configuration → Templates*, do the following: - Click on *Web* in the row of the template - Configure a web scenario following the usual method of [configuring web scenarios](/manual/web_monitoring#configuring_a_web_scenario) #### اضافه کردن سناریوهای وب برای افزودن سناریوهای وب به یک الگو در *پیکربندی → الگوها*، این کار را انجام دهید به شرح زیر: - روی *Web* در ردیف قالب کلیک کنید - یک سناریوی وب را به روش معمول [پیکربندی] پیکربندی کنید سناریوهای وب](/دستی/نظارت_وب#پیکربندی_سناریو_وب) ##### Additional parameters A third optional parameter is supported by the *bucket\_rate\_foreach* function: bucket_rate_foreach(item filter,time period,<parameter number>) where <parameter number> is the position of the "bucket" value in the item key. For example, if the "bucket" value in myItem\[aaa,0.2\] is '0.2', then its position is 2. The default value of <parameter number> is '1'. See [aggregate calculations](/manual/config/items/itemtypes/calculated/aggregate) for more details and examples on using foreach functions. ##### پارامترهای اضافی سومین پارامتر اختیاری توسط *bucket\_rate\_foreach* پشتیبانی می‌شود. تابع: bucket_rate_foreach (فیلتر مورد، دوره زمانی، <شماره پارامتر>) جایی که <parameter number> موقعیت مقدار "bucket" در آن است کلید مورد برای مثال، اگر مقدار "سطل" در myItem\[aaa,0.2\] باشد '0.2'، سپس موقعیت آن 2 است. مقدار پیش فرض <parameter number> '1' است. [محاسبات جمعی](/manual/config/items/itemtypes/calculated/aggregate) را ببینید جزئیات و مثال های بیشتر در مورد استفاده از توابع foreach. After receiving a list of active checks the agent marks obsolete persistent files for removal. A persistent file becomes obsolete if: 1) the corresponding log item is no longer monitored, 2) a log item is reconfigured with a different **persistent\_dir** location than before. Removing is done with delay 24 hours because log files in NOTSUPPORTED state are not included in the list of active checks but they may become SUPPORTED later and their persistent files will be useful. If the agent is stopped before 24 hours expire, then the obsolete files will not be deleted as Zabbix agent is not getting info about their location from Zabbix server anymore. ::: notewarning Reconfiguring a log item's **persistent\_dir** back to the old **persistent\_dir** location while the agent is stopped, without deleting the old persistent file by user - will cause restoring the agent state from the old persistent file resulting in missed messages or false alerts. ::: پس از دریافت لیستی از چک های فعال، عامل منسوخ دائمی را علامت گذاری می کند فایل ها برای حذف یک فایل دائمی منسوخ می شود اگر: 1) مربوطه مورد گزارش دیگر نظارت نمی‌شود، 2) یک مورد گزارش با دیگری پیکربندی مجدد می‌شود **موقعیت\_dir** موقعیت مکانی نسبت به قبل. حذف با 24 ساعت تاخیر انجام می شود زیرا فایل های ورود به سیستم در حالت NOTSUPPORTED هستند در لیست چک های فعال گنجانده نشده اند، اما ممکن است پشتیبانی شوند بعداً و فایل های ماندگار آنها مفید خواهد بود. اگر نماینده قبل از 24 ساعت منقضی شود، فایل های منسوخ شده متوقف می شوند حذف نشود زیرا عامل Zabbix اطلاعاتی در مورد موقعیت مکانی خود دریافت نمی کند سرور Zabbix دیگر. ::: هشدار پیکربندی مجدد **مداوم\_dir** یک آیتم گزارش به حالت قبلی **موقعیت\_dir** مکان زمانی که عامل متوقف شده است، بدون حذف کردن فایل پایدار قدیمی توسط کاربر - باعث بازگرداندن حالت عامل از حالت قبلی می شود فایل دائمی که منجر به پیام های از دست رفته یا هشدارهای نادرست می شود. ::: ##### Agent configuration HA cluster nodes (servers) must be listed in the configuration of Zabbix agent or Zabbix agent 2. ![](../../../../assets/en/manual/config/zabbix_ha_agent.png) To enable passive checks, the node names must be listed in the Server [parameter](/manual/appendix/config/zabbix_agentd), separated by a **comma**. ``` Server=zabbix-node-01,zabbix-node-02 ``` To enable active checks, the node names must be listed in the ServerActive [parameter](/manual/appendix/config/zabbix_agentd). Note that for active checks the nodes must be separated by a comma from any other servers, while the nodes themselves must be separated by a **semicolon**, e.g.: ``` ServerActive=zabbix-node-01;zabbix-node-02 ``` ##### پیکربندی عامل گره های خوشه HA (سرورها) باید در پیکربندی فهرست شوند عامل Zabbix یا عامل Zabbix 2. ![](../../../../assets/en/manual/config/zabbix_ha_agent.png) برای فعال کردن بررسی های غیرفعال، نام گره ها باید در سرور فهرست شوند [پارامتر](/manual/appendix/config/zabbix_agentd)، با یک **کاما** جدا شده است. ``` سرور=zabbix-node-01,zabbix-node-02 ``` برای فعال کردن بررسی‌های فعال، نام گره‌ها باید در ServerActive فهرست شوند [پارامتر](/manual/appendix/config/zabbix_agentd). توجه داشته باشید که برای چک های فعال گره ها باید با کاما از گره های دیگر جدا شوند سرورها، در حالی که خود گره ها باید با یک **نقطه ویرگول** از هم جدا شوند، به عنوان مثال: ``` ServerActive=zabbix-node-01;zabbix-node-02 ``` #### Agent on UNIX-like systems Zabbix agent on UNIX-like systems is run on the host being monitored. #### عامل در سیستم های یونیکس مانند عامل Zabbix در سیستم‌های شبه یونیکس بر روی میزبان تحت نظارت اجرا می‌شود. #### Agent on Windows systems Zabbix agent on Windows runs as a Windows service. #### عامل در سیستم های ویندوز عامل Zabbix در ویندوز به عنوان یک سرویس ویندوز اجرا می شود. ##### Agent operation with persistent file On startup Zabbix agent knows nothing about persistent files. Only after receiving a list of active checks from Zabbix server \(proxy\) the agent sees that some log items should be backed by persistent files under specified directories. During agent operation the persistent files are opened for writing (with fopen(filename, "w")) and overwritten with the latest data. The chance of losing persistent file data if the overwriting and file system mirror split happen at the same time is very small, no special handling for it. Writing into persistent file is NOT followed by enforced synchronization to storage media \(fsync\(\) is not called\). Overwriting with the latest data is done after successful reporting of matching log file record or metadata \(processed log size and modification time\) to Zabbix server. That may happen as often as every item check if log file keeps changing. No special actions during agent shutdown. ##### عملیات عامل با فایل پایدار هنگام راه اندازی، عامل Zabbix چیزی در مورد فایل های ماندگار نمی داند. تنها پس از با دریافت لیستی از چک های فعال از سرور Zabbix \(پروکسی\) نماینده مشاهده می کند که برخی از ثبت نام آیتم ها باید توسط فایل های ثابت تحت دایرکتوری های مشخص شده پشتیبانی شوند. در طول عملیات عامل، فایل‌های ماندگار برای نوشتن باز می‌شوند (با fopen (نام فایل، "w")) و با آخرین داده ها بازنویسی می شود. شانس از اگر بازنویسی و آینه سیستم فایل تقسیم شوند، داده های فایل دائمی را از دست می دهد اتفاق می افتد در همان زمان بسیار کوچک است، هیچ رسیدگی خاصی برای آن نیست. نوشتن به دنبال همگام سازی اجباری با ذخیره سازی در فایل پایدار نیست رسانه \(fsync\(\) نامیده نمی شود. بازنویسی با آخرین داده ها پس از گزارش موفقیت آمیز تطابق انجام می شود ثبت فایل لاگ یا ابرداده \(اندازه گزارش پردازش شده و زمان اصلاح\) به سرور Zabbix. این ممکن است به همان اندازه اتفاق بیفتد که هر آیتم بررسی کنید که آیا فایل log حفظ می شود یا خیر تغییر می کند. هیچ اقدام خاصی در حین خاموش شدن عامل وجود ندارد. #### AIX See values supported for 'memtype' parameter on AIX in the table. |Supported value|Description|Source in procentry64 structure|Tries to be compatible with| |--|------|--|--| |vsize ^[1](proc_mem_notes#footnotes)^|Virtual memory size|pi\_size| | |pmem|Percentage of real memory|pi\_prm|ps -o pmem| |rss|Resident set size|pi\_trss + pi\_drss|ps -o rssize| |size|Size of process (code + data)|pi\_dvm|"ps gvw" SIZE column| |dsize|Data size|pi\_dsize|<| |tsize|Text (code) size|pi\_tsize|"ps gvw" TSIZ column| |sdsize|Data size from shared library|pi\_sdsize|<| |drss|Data resident set size|pi\_drss| | |trss|Text resident set size|pi\_trss| | #### AIX مقادیر پشتیبانی شده برای پارامتر "memtype" در AIX را در جدول ببینید. |مقدار پشتیبانی شده|توضیح|منبع در ساختار procentry64|سعی می کند با| |--|------|--|--| |vsize ^[1](proc_mem_notes#footnotes)^|اندازه حافظه مجازی|pi\_size| | |pmem|درصد حافظه واقعی|pi\_prm|ps -o pmem| |rss|اندازه مجموعه مقیم|pi\_trss + pi\_drss|ps -o rssize| |size|اندازه فرآیند (کد + داده)|pi\_dvm|"ps gvw" ستون SIZE| |dsize|اندازه داده|pi\_dsize|<| |tsize|اندازه متن (کد)|pi\_tsize|"ps gvw" ستون TSIZ| |sdsize|اندازه داده از کتابخانه مشترک|pi\_sdsize|<| |drss|اندازه مجموعه مقیم داده|pi\_drss| | |trss|اندازه مجموعه مقیم متن|pi\_trss| | # alert.get # alert.get ### Alert ::: noteclassic Alerts are created by the Zabbix server and cannot be modified via the API. ::: The alert object contains information about whether certain action operations have been executed successfully. It has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |alertid|string|ID of the alert.| |actionid|string|ID of the action that generated the alert.| |alerttype|integer|Alert type.<br><br>Possible values:<br>0 - message;<br>1 - remote command.| |clock|timestamp|Time when the alert was generated.| |error|string|Error text if there are problems sending a message or running a command.| |esc\_step|integer|Action escalation step during which the alert was generated.| |eventid|string|ID of the event that triggered the action.| |mediatypeid|string|ID of the media type that was used to send the message.| |message|text|Message text. Used for message alerts.| |retries|integer|Number of times Zabbix tried to send the message.| |sendto|string|Address, user name or other identifier of the recipient. Used for message alerts.| |status|integer|Status indicating whether the action operation has been executed successfully.<br><br>Possible values for message alerts:<br>0 - message not sent.<br>1 - message sent.<br>2 - failed after a number of retries.<br>3 - new alert is not yet processed by alert manager.<br><br>Possible values for command alerts:<br>0 - command not run.<br>1 - command run.<br>2 - tried to run the command on the Zabbix agent but it was unavailable.| |subject|string|Message subject. Used for message alerts.| |userid|string|ID of the user that the message was sent to.| |p\_eventid|string|ID of problem event, which generated the alert.| |acknowledgeid|string|ID of acknowledgment, which generated the alert.| ### هشدار ::: نوتکلاسیک هشدارها توسط سرور Zabbix ایجاد می شوند و نمی توانند ایجاد شوند از طریق API اصلاح شده است. ::: شیء هشدار حاوی اطلاعاتی در مورد اینکه آیا اقدام خاصی است یا خیر عملیات با موفقیت اجرا شده است. موارد زیر را دارد خواص |مخصوص|[نوع](/manual/api/reference_commentary#data_types)|توضیحات| |--|--|------| |alertid|رشته|شناسه هشدار.| |actionid|string|شناسه اقدامی که هشدار را ایجاد کرده است.| |alerttype|عدد صحیح|نوع هشدار.<br><br>مقادیر ممکن:<br>0 - message;<br>1 - فرمان از راه دور.| |clock|timemp|زمان ایجاد هشدار.| |error|string|متن خطا در صورت وجود مشکل در ارسال پیام یا اجرای دستور.| |esc\_step|عدد صحیح|مرحله تشدید اقدام که در طی آن هشدار تولید شد.| |eventid|string|شناسه رویدادی که اقدام را آغاز کرد.| |mediatypeid|string|ID از نوع رسانه ای که برای ارسال پیام استفاده شده است.| |پیام|متن|متن پیام. برای هشدار پیام استفاده می شود.| |تعداد مجدد|عدد صحیح|تعداد دفعاتی که Zabbix برای ارسال پیام تلاش کرد.| |sendto|string|آدرس، نام کاربری یا شناسه دیگر گیرنده. برای هشدار پیام استفاده می شود.| |وضعیت|عدد صحیح|وضعیت نشان می دهد که آیا عملیات اقدام با موفقیت اجرا شده است یا خیر.<br><br>مقادیر ممکن برای هشدارهای پیام:<br>0 - پیام ارسال نشد.<br>1 - پیام ارسال شد.<br>2 - پس از چند بار تلاش ناموفق بود.<br>3 - هشدار جدید هنوز توسط مدیر هشدار پردازش نشده است.<br><br>مقادیر ممکن برای هشدارهای فرمان:<br>0 - فرمان اجرا نمی شود.<br>1 - اجرای فرمان .<br>2 - سعی کردم دستور را روی عامل Zabbix اجرا کنم اما در دسترس نبود.| |موضوع|رشته|موضوع پیام. برای هشدار پیام استفاده می شود.| |userid|string|شناسه کاربری که پیام به آن ارسال شده است.| |p\_eventid|string|ID رویداد مشکل، که هشدار را ایجاد کرد.| |acknowledgeid|string|ID of acknowledgment، که هشدار را ایجاد کرده است.| # apiinfo.version # apiinfo.version # Appendix 1. Reference commentary # ضمیمه 1. تفسیر مرجع # Appendix 2. Changes from 5.4 to 6.0 # پیوست 2. تغییرات از 5.4 به 6.0 #### A real life scenario In this example, we would like to set up network discovery for the local network having an IP range of 192.168.1.1-192.168.1.254. In our scenario we want to: - discover those hosts that have Zabbix agent running - run discovery every 10 minutes - add a host to monitoring if the host uptime is more than 1 hour - remove hosts if the host downtime is more than 24 hours - add Linux hosts to the "Linux servers" group - add Windows hosts to the "Windows servers" group - use the template *Linux* for Linux hosts - use the template *Windows* for Windows hosts #### یک سناریوی زندگی واقعی در این مثال، ما می خواهیم کشف شبکه را برای محلی راه اندازی کنیم شبکه با محدوده IP 192.168.1.1-192.168.1.254. در سناریوی ما می خواهیم: - میزبان هایی که عامل Zabbix در حال اجرا هستند را کشف کنید - اکتشاف را هر 10 دقیقه اجرا کنید - اگر زمان آپلود هاست بیش از 1 ساعت است، هاست را به مانیتورینگ اضافه کنید - حذف هاست در صورتی که زمان خرابی میزبان بیش از 24 ساعت باشد - هاست لینوکس را به گروه "سرورهای لینوکس" اضافه کنید - هاست های ویندوز را به گروه "Windows servers" اضافه کنید - از قالب *Linux* برای هاست لینوکس استفاده کنید - از قالب *ویندوز* برای هاست ویندوز استفاده کنید #### Assigning different hosts Replace the hosts currently assigned to maintenance with two different ones. Request: ```json { "jsonrpc": "2.0", "method": "maintenance.update", "params": { "maintenanceid": "3", "hosts": [ {"hostid": "10085"}, {"hostid": "10084"} ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "maintenanceids": [ "3" ] }, "id": 1 } ``` #### تغییر پورت اینترفیس هاست Change the port of a host interface. Request: ```json { "jsonrpc": "2.0", "method": "hostinterface.update", "params": { "interfaceid": "30048", "port": "30050" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "interfaceids": [ "30048" ] }, "id": 1 } ``` # auditlog.get # auditlog.get # authentication.get دریافت احرازهویت # authentication.update به روز رسانی احرازهویت ## AUTHOR Alexei Vladishev <<alex@zabbix.com>> ------------------------------------------------------------------------ [ ]{#index} ## نویسنده Zabbix LLC ------------------------------------------------ ---------------------- [ ]{#فهرست مطالب} ## AUTHOR Alexei Vladishev <<alex@zabbix.com>> ------------------------------------------------------------------------ [ ]{#index} ## نویسنده الکسی ولادیشف <<alex@zabbix.com>> ------------------------------------------------ ---------------------- [ ]{#فهرست مطالب} ## AUTHOR Alexei Vladishev <<alex@zabbix.com>> ------------------------------------------------------------------------ [ ]{#index} ## نویسنده الکسی ولادیشف <<alex@zabbix.com>> ------------------------------------------------ ---------------------- [ ]{#فهرست مطالب} ## AUTHOR Zabbix LLC ------------------------------------------------------------------------ [ ]{#index} ## نویسنده Zabbix LLC ------------------------------------------------ ---------------------- [ ]{#فهرست مطالب} ## AUTHOR Zabbix LLC ------------------------------------------------------------------------ [ ]{#index} ## نویسنده Zabbix LLC ------------------------------------------------ ---------------------- [ ]{#فهرست مطالب} # autoregistration.get دریافت ثبت خودکار # autoregistration.update دریافت ثبت خودکار ### Backward incompatible changes ### تغییرات ناسازگار با نسخه های گذشته #### Batch migration of history tables * Prepare directories for Data Pump. Data Pump must have read and write permissions to these directories. Example: ``` {.bash} mkdir -pv /export/history chown -R oracle:oracle /export ``` * Create a directory object and grant read and write permissions to this object to the user used for Zabbix authentication ('zabbix' in the example below). Under *sysdba* role, run: ``` {.sql} create directory history as '/export/history'; grant read,write on directory history to zabbix; ``` * Export tables. Replace N with the desired thread count. ``` {.bash} expdp zabbix/password@oracle_host/service \ DIRECTORY=history \ TABLES=history_old,history_uint_old,history_str_old,history_log_old,history_text_old \ PARALLEL=N ``` * Import tables. Replace N with the desired thread count. ``` {.bash} impdp zabbix/password@oracle_host/service \ DIRECTORY=history \ TABLES=history_uint_old \ REMAP_TABLE=history_old:history,history_uint_old:history_uint,history_str_old:history_str,history_log_old:history_log,history_text_old:history_text \ data_options=SKIP_CONSTRAINT_ERRORS table_exists_action=APPEND PARALLEL=N CONTENT=data_only ``` * Follow [post-migration instructions](#post-migration) to drop the old tables. #### مهاجرت دسته ای جداول تاریخچه * دایرکتوری ها را برای Data Pump آماده کنید. Data Pump باید مجوز خواندن و نوشتن در این دایرکتوری ها را داشته باشد. مثال: ``` {.bash} mkdir -pv /export/history chown -R oracle:oracle /export ``` * یک شی دایرکتوری ایجاد کنید و مجوز خواندن و نوشتن را به این شی به کاربر مورد استفاده برای احراز هویت Zabbix بدهید («zabbix» در مثال زیر). در نقش *sysdba*، اجرا کنید: ``` {.sql} ایجاد تاریخچه دایرکتوری به عنوان '/export/history'. اعطای خواندن، نوشتن در تاریخچه دایرکتوری به zabbix. ``` * جداول صادرات. تعداد نخ مورد نظر را جایگزین N کنید. ``` {.bash} expdp zabbix/password@oracle_host/service \ DIRECTORY=history \ TABLES=history_old,history_uint_old,history_str_old,history_log_old,history_text_old \ PARALLEL=N ``` * واردات جداول. تعداد نخ مورد نظر را جایگزین N کنید. ``` {.bash} impdp zabbix/password@oracle_host/service \ DIRECTORY=history \ TABLES=history_uint_old \ REMAP_TABLE=history_old:history,history_uint_old:history_uint,history_str_old:history_str,history_log_old:history_log,history_text_old:history_text \ data_options=SKIP_CONSTRAINT_ERRORS table_exists_action=APPEND PARALLEL=N CONTENT=فقط داده ``` * [دستورالعمل‌های پس از مهاجرت] (#post-migration) را برای حذف جداول قدیمی دنبال کنید. #### Behavior depending on availability The following table illustrates how each function behaves in cases of limited availability of host/item and history data. |Function|Disabled host|Unavailable host with data|Unavailable host without data|Disabled item|Unsupported item|Data retrieval error (SQL)| |--|--|--|--|--|--|--| |*avg_foreach*|ignore|return avg|ignore|ignore|ignore|ignore| |*bucket_rate_foreach*|ignore|return bucket rate|ignore|ignore|ignore|ignore| |*count_foreach*|ignore|return count|0|ignore|ignore|ignore| |*exists_foreach*|ignore|1|1|ignore|1|n/a| |*last_foreach*|ignore|return last|ignore|ignore|ignore|ignore| |*max_foreach*|ignore|return max|ignore|ignore|ignore|ignore| |*min_foreach*|ignore|return min|ignore|ignore|ignore|ignore| |*sum_foreach*|ignore|return sum|ignore|ignore|ignore|ignore| If the item is *ignored*, nothing is added to the aggregation. #### رفتار بسته به در دسترس بودن جدول زیر نحوه رفتار هر تابع را در مواردی که در دسترس بودن محدود میزبان/مورد و داده های تاریخچه عمل می کند، نشان می دهد. |عملکرد|میزبان غیرفعال|میزبان با داده در دسترس نیست|میزبان بدون داده در دسترس نیست|مورد غیرفعال|مورد پشتیبانی نشده|خطای بازیابی داده (SQL)| |--|--|--|--|--|--|--| |*avg_foreach*|نادیده گرفتن|بازگشت میانگین|نادیده گرفتن|نادیده گرفتن|نادیده گرفتن|نادیده گرفتن| |*bucket_rate_foreach*|نادیده گرفتن|نرخ سطل بازگشت|نادیده گرفتن|نادیده گرفتن|نادیده گرفتن|نادیده گرفتن| |*count_foreach*|نادیده گرفتن|تعداد بازگشت|0|نادیده گرفتن|نادیده گرفتن|نادیده گرفتن| |*exists_foreach*|نادیده گرفتن|1|1|نادیده گرفتن|1|n/a| |*last_foreach*|نادیده گرفتن|بازگشت آخرین|نادیده گرفتن|نادیده گرفتن|نادیده گرفتن|نادیده گرفتن| |*max_foreach*|نادیده گرفتن|بازگشت حداکثر|نادیده گرفتن|نادیده گرفتن|نادیده گرفتن|نادیده گرفتن| |*min_foreach*|نادیده گرفتن|بازگشت دقیقه|نادیده گرفتن|نادیده گرفتن|نادیده گرفتن|نادیده گرفتن| |*sum_foreach*|نادیده گرفتن|بازگرداندن مجموع|نادیده گرفتن|نادیده گرفتن|نادیده گرفتن|نادیده گرفتن| اگر مورد *نادیده گرفته شود*، چیزی به جمع اضافه نمی شود. ##### Buttons Buttons to the right offer the following options: | | | |--|--------| |![](../../../../../assets/en/manual/web_interface/frontend_sections/monitoring/edit_map.png)|Go to map constructor to edit the map content.| |![](../../../../../assets/en/manual/web_interface/frontend_sections/monitoring/add_to_fav1.png)|Add map to the favorites widget in the [Dashboard](dashboard).| |![](../../../../../assets/en/manual/web_interface/button_add_fav2.png)|The map is in the favorites widget in the [Dashboard](dashboard). Click to remove map from the favorites widget.| View mode buttons being common for all sections are described on the [Monitoring](/manual/web_interface/frontend_sections/monitoring#view_mode_buttons) page. ##### دکمه ها دکمه های سمت راست گزینه های زیر را ارائه می دهند: | | | |--|--------| |![](../../../../../assets/en/manual/web_interface/frontend_sections/monitoring/edit_map.png)|برای ویرایش محتوای نقشه، به سازنده نقشه بروید.| |![](../../../../../assets/en/manual/web_interface/frontend_sections/monitoring/add_to_fav1.png)|افزودن نقشه به ویجت مورد علاقه در [داشبورد](داشبورد ).| |![](../../../../../assets/en/manual/web_interface/button_add_fav2.png)|نقشه در ویجت مورد علاقه در [داشبورد](داشبورد) است. برای حذف نقشه از ویجت مورد علاقه کلیک کنید.| دکمه‌های حالت مشاهده که برای همه بخش‌ها مشترک هستند، در توضیح داده شده‌اند [مانیتورینگ](/دستی/واسط_وب/بخش‌های_نمایش/نظارت#دکمه‌های_حالت_نما) صفحه ##### Buttons The button to the right offers the following option: | | | |--|--------| |![](../../../../../assets/en/manual/web_interface/button_csv.png)|Export content from all pages to a CSV file.| View mode buttons, being common for all sections, are described on the [Monitoring](/manual/web_interface/frontend_sections/monitoring#view_mode_buttons) page. ##### دکمه ها دکمه سمت راست گزینه زیر را ارائه می دهد: | | | |--|--------| |![](../../../../../assets/en/manual/web_interface/button_csv.png)|صادر کردن محتوا از تمام صفحات به یک فایل CSV.| دکمه‌های حالت مشاهده، که برای همه بخش‌ها مشترک هستند، در توضیح داده شده‌اند [مانیتورینگ](/دستی/واسط_وب/بخش‌های_نمایش/نظارت#دکمه‌های_حالت_نما) صفحه #### Change dashboard owner Available only for admins and super admins. Request: ```json { "jsonrpc": "2.0", "method": "dashboard.update", "params": { "dashboardid": "2", "userid": "1" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 2 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "2" ] }, "id": 2 } ``` #### تعویض صاحب داشبورد Available only for admins and super admins. Request: ```json { "jsonrpc": "2.0", "method": "dashboard.update", "params": { "dashboardid": "2", "userid": "1" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 2 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "2" ] }, "id": 2 } ``` #### Change hosts monitored by a proxy Update the proxy to monitor the two given hosts. Request: ```json { "jsonrpc": "2.0", "method": "proxy.update", "params": { "proxyid": "10293", "hosts": [ { "hostid": "10294" }, { "hostid": "10295" }, ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "proxyids": [ "10293" ] }, "id": 1 } ``` #### حذف لینک تمپلیت ها Unlink and clear two templates from host. Request: ```json { "jsonrpc": "2.0", "method": "host.update", "params": { "hostid": "10126", "templates_clear": [ { "templateid": "10124" }, { "templateid": "10125" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "hostids": [ "10126" ] }, "id": 1 } ``` #### Change proxy status Change the proxy to an active proxy and rename it to "Active proxy". Request: ```json { "jsonrpc": "2.0", "method": "proxy.update", "params": { "proxyid": "10293", "host": "Active proxy", "status": "5" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "proxyids": [ "10293" ] }, "id": 1 } ``` تغییر وضعیت پروکسی #### Change the IP range of a discovery rule Change the IP range of a discovery rule to "192.168.2.1-255". Request: ```json { "jsonrpc": "2.0", "method": "drule.update", "params": { "druleid": "6", "iprange": "192.168.2.1-255" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "druleids": [ "6" ] }, "id": 1 } ``` #### تغییر رنج آی پی قانون جست و جو Change the IP range of a discovery rule to "192.168.2.1-255". Request: ```json { "jsonrpc": "2.0", "method": "drule.update", "params": { "druleid": "6", "iprange": "192.168.2.1-255" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "druleids": [ "6" ] }, "id": 1 } ``` #### Changing a host interface port Change the port of a host interface. Request: ```json { "jsonrpc": "2.0", "method": "hostinterface.update", "params": { "interfaceid": "30048", "port": "30050" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "interfaceids": [ "30048" ] }, "id": 1 } ``` #### تغییر پورت اینترفیس هاست Change the port of a host interface. Request: ```json { "jsonrpc": "2.0", "method": "hostinterface.update", "params": { "interfaceid": "30048", "port": "30050" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "interfaceids": [ "30048" ] }, "id": 1 } ``` #### Changing event's severity Change severity for multiple events and leave a message. Request: ```json { "jsonrpc": "2.0", "method": "event.acknowledge", "params": { "eventids": ["20427", "20428"], "action": 12, "message": "Maintenance required to fix it.", "severity": 4 }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "eventids": [ "20427", "20428" ] }, "id": 1 } ``` #### تغییر سطح رخداد Change severity for multiple events and leave a message. Request: ```json { "jsonrpc": "2.0", "method": "event.acknowledge", "params": { "eventids": ["20427", "20428"], "action": 12, "message": "Maintenance required to fix it.", "severity": 4 }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "eventids": [ "20427", "20428" ] }, "id": 1 } ``` #### Changing mappings for one value map. Request: ```json { "jsonrpc": "2.0", "method": "valuemap.update", "params": { "valuemapid": "2", "mappings": [ { "type": "0", "value": "0", "newvalue": "Online" }, { "type": "0", "value": "1", "newvalue": "Offline" } ] }, "auth": "57562fd409b3b3b9a4d916d45207bbcb", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "valuemapids": [ "2" ] }, "id": 1 } ``` ####ساخت Icon map Create an icon map to display hosts of different types. Request: ```json { "jsonrpc": "2.0", "method": "iconmap.create", "params": { "name": "Type icons", "default_iconid": "2", "mappings": [ { "inventory_link": 1, "expression": "server", "iconid": "3" }, { "inventory_link": 1, "expression": "switch", "iconid": "4" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "iconmapids": [ "2" ] }, "id": 1 } ``` #### Changing the excluded downtimes for an SLA Add a planned 4 hour long RAM upgrade downtime on the 6th of April, 2022, while keeping (needs to be defined anew) a previously existing software upgrade planned on the 4th of July for the SLA with ID "5". Request: ```json { "jsonrpc": "2.0", "method": "service.update", "params": { "slaid": "5", "excluded_downtimes": [ { "name": "Software version upgrade rollout", "period_from": "1648760400", "period_to": "1648764900" }, { "name": "RAM upgrade", "period_from": "1649192400", "period_to": "1649206800" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "slaids": [ "5" ] }, "id": 1 } ``` #### تغییر زمان های خرابی حذف شده برای SLA در 6 آوریل 2022، برنامه‌ریزی‌شده برای ارتقاء رم 4 ساعته را اضافه کنید. ضمن حفظ (نیاز به تعریف مجدد) یک ارتقاء نرم افزاری موجود که در 4 جولای برنامه ریزی شده است. برای SLA با شناسه "5". درخواست: ``json { "jsonrpc": "2.0"، "روش": "service.update"، "params": { "slaid": "5"، "excluded_downtimes": [ { "name": "نسخه ارتقاء نرم افزار عرضه شد"، "period_from": "1648760400"، "period_to": "1648764900" }، { "name": "ارتقای رم"، "period_from": "1649192400"، "period_to": "1649206800" } ] }، "auth": "038e1d7b1735c6a5436ee9eae095879e"، "id": 1 } ``` واکنش: ``json { "jsonrpc": "2.0"، "نتیجه": { "slaids": [ "5" ] }، "id": 1 } ``` #### Changing the interface of an item prototype Change the host interface that will be used by discovered items. Request: ```json { "jsonrpc": "2.0", "method": "itemprototype.update", "params": { "itemid": "27428", "interfaceid": "132" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "27428" ] }, "id": 1 } ``` #### تغییر پورت اینترفیس هاست Change the port of a host interface. Request: ```json { "jsonrpc": "2.0", "method": "hostinterface.update", "params": { "interfaceid": "30048", "port": "30050" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "interfaceids": [ "30048" ] }, "id": 1 } ``` #### Changing the schedule of an SLA Switch the SLA with ID "5" to a 24x7 schedule. Request: ```json { "jsonrpc": "2.0", "method": "service.update", "params": { "slaid": "5", "schedule": [] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "slaids": [ "5" ] }, "id": 1 } ``` ####غیرفعال کردن نمونه اولیه هاست Disable a host prototype, that is, set its status to 1. Request: ```json { "jsonrpc": "2.0", "method": "hostprototype.update", "params": { "hostid": "10092", "status": 1 }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "hostids": [ "10092" ] }, "id": 1 } ``` #### Changing the size of a graph prototype Change the size of a graph prototype to 1100 to 400 pixels. Request: ```json { "jsonrpc": "2.0", "method": "graphprototype.update", "params": { "graphid": "439", "width": 1100, "height": 400 }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "graphids": [ "439" ] }, "id": 1 } ``` #### تغییر سایز نمونه اولیه گراف Change the size of a graph prototype to 1100 to 400 pixels. Request: ```json { "jsonrpc": "2.0", "method": "graphprototype.update", "params": { "graphid": "439", "width": 1100, "height": 400 }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "graphids": [ "439" ] }, "id": 1 } ``` #### Changing the value of a global macro Change the value of a global macro to "public". Request: ```json { "jsonrpc": "2.0", "method": "usermacro.updateglobal", "params": { "globalmacroid": "1", "value": "public" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "globalmacroids": [ "1" ] }, "id": 1 } ``` ####غیرفعال کردن نمونه اولیه هاست Disable a host prototype, that is, set its status to 1. Request: ```json { "jsonrpc": "2.0", "method": "hostprototype.update", "params": { "hostid": "10092", "status": 1 }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "hostids": [ "10092" ] }, "id": 1 } ``` #### Changing value map name Change value map name to "Device status". Request: ```json { "jsonrpc": "2.0", "method": "valuemap.update", "params": { "valuemapid": "2", "name": "Device status" }, "auth": "57562fd409b3b3b9a4d916d45207bbcb", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "valuemapids": [ "2" ] }, "id": 1 } ``` #### تغییر نام داشبورد تغییر نام یک داشبورد به SQL server status ". Request: ```json { "jsonrpc": "2.0", "method": "dashboard.update", "params": { "dashboardid": "2", "name": "SQL server status" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "2" ] }, "id": 1 } ``` #### Check status of nodes at specific IP addresses Request: ```json { "jsonrpc": "2.0", "method": "hanode.get", "params": { "output": ["name", "status"], "filter": { "address": ["192.168.1.7", "192.168.1.13"] } }, "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "name": "node3", "status": "0" }, { "name": "node-active", "status": "3" } ], "id": 1 } ``` #### بررسی وضعیت نودها با آدرس آی پی خاص Request: ```json { "jsonrpc": "2.0", "method": "hanode.get", "params": { "output": ["name", "status"], "filter": { "address": ["192.168.1.7", "192.168.1.13"] } }, "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "name": "node3", "status": "0" }, { "name": "node-active", "status": "3" } ], "id": 1 } ``` ### Cleaner configuration export  YAML files generated during Zabbix entity configuration export no longer contain empty lines between entities in an array, which makes such files shorter and more convenient to work with. See [Configuration export/import](/manual/xml_export_import) section for updated export examples. ### صادرات پیکربندی پاک کننده فایل‌های YAML که در طول صادرات پیکربندی موجودیت Zabbix ایجاد می‌شوند، دیگر حاوی خطوط خالی بین موجودیت‌ها در یک آرایه نیستند، که کار با چنین فایل‌هایی را کوتاه‌تر و راحت‌تر می‌کند. برای نمونه‌های صادراتی به‌روزشده، بخش [پیکربندی صادرات/واردات](/دستی/xml_export_import) را ببینید. #### Clear history Request: ```json { "jsonrpc": "2.0", "method": "history.clear", "params": [ "10325", "13205" ], "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "10325", "13205" ] }, "id": 1 } ``` #### پاک کردن تاریخچه Request: ```json { "jsonrpc": "2.0", "method": "history.clear", "params": [ "10325", "13205" ], "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "10325", "13205" ] }, "id": 1 } ``` ##### Cloning a report To quickly clone an existing report, click the *Clone* button at the bottom of an existing report configuration form. When cloning a report created by another user, the current user becomes the owner of the new report. Report settings will be copied to the new report configuration form with respect to user permissions: - If the user who clones a report has no permissions to a dashboard, the *Dashboard* field will be cleared. - If the user who clones a report has no permissions to some users or user groups in the *Subscriptions* list, inaccessible recipients will not be cloned. - *Generate report by* settings will be updated to display the current user (unless *Generate report by* is set to the recipient). Change the required settings and the report name, then click *Add*. ##### شبیه سازی گزارش برای شبیه سازی سریع یک گزارش موجود، روی دکمه *Clone* در پایین فرم پیکربندی گزارش موجود کلیک کنید. هنگام شبیه سازی گزارش ایجاد شده توسط کاربر دیگر، کاربر فعلی مالک گزارش جدید می شود. تنظیمات گزارش با توجه به مجوزهای کاربر در فرم پیکربندی گزارش جدید کپی می شود: - اگر کاربری که یک گزارش را شبیه سازی می کند هیچ مجوزی برای داشبورد نداشته باشد، قسمت *داشبورد* پاک می شود. - اگر کاربری که یک گزارش را شبیه‌سازی می‌کند، هیچ مجوزی برای برخی از کاربران یا گروه‌های کاربری در فهرست *اشتراک‌ها* نداشته باشد، گیرندگان غیرقابل دسترسی شبیه‌سازی نمی‌شوند. - تنظیمات *تولید گزارش توسط* برای نمایش کاربر فعلی به روز می شود (مگر اینکه *تولید گزارش توسط* برای گیرنده تنظیم شده باشد). تنظیمات مورد نیاز و نام گزارش را تغییر دهید، سپس روی *افزودن* کلیک کنید. ### Code |Type|Size|Comments| |-----|-----|----------| |Byte| 4 |Payload type, currently only JSON is supported.| ### کد |نوع|اندازه|نظرات| |-----|-----|----------| |بایت| 4 | نوع بار، در حال حاضر فقط JSON پشتیبانی می شود.| #### Columns Columns have common parameters and additional parameters depending on the configuration of the parameter *Data*. ::: noteclassic For all parameters related to columns the number in the property name (e.g. columns.name.0) references a column for which the parameter is configured. ::: #### ستون ها ستون ها دارای پارامترهای مشترک و پارامترهای اضافی بسته به پیکربندی پارامتر *داده* هستند. ::: نوتکلاسیک برای همه پارامترهای مربوط به ستون‌ها، شماره در نام ویژگی (به عنوان مثال columns.name.0) به ستونی اشاره می‌کند که پارامتر برای آن پیکربندی شده است. ::: #### Command result The return value of the command is a standard output together with a standard error produced by the command. ::: noteimportant An item that returns text (character, log, or text type of information) will not become unsupported in case of a standard error output. ::: The return value is limited to 16MB (including trailing whitespace that is truncated); [database limits](/manual/config/items/item#text_data_limits) also apply. User parameters that return text (character, log, or text type of information) can also return a whitespace. In case of an invalid result, the item will become unsupported. #### نتیجه فرمان مقدار بازگشتی دستور یک خروجی استاندارد به همراه یک خطای استاندارد تولید شده توسط دستور است. ::: نکته مهم موردی که متن (نویسه، گزارش یا نوع متن اطلاعات) را برمی گرداند، در صورت بروز خطای استاندارد، پشتیبانی نمی شود. ::: مقدار بازگشتی به 16 مگابایت محدود شده است (از جمله فضای خالی انتهایی که کوتاه شده است). [محدودیت های پایگاه داده](/manual/config/items/item#text_data_limits) نیز اعمال می شود. پارامترهای کاربری که متن را برمی گرداند (نویسه، گزارش یا نوع متن اطلاعات) نیز می توانند یک فضای خالی برگردانند. در صورت نامعتبر بودن نتیجه، مورد پشتیبانی نمی شود. [comment]: # (tags: proxy) # 4 Proxy [نظر]: # (برچسب ها: پروکسی) پروکسی شماره 4 #### Comparing the import of a template Compare the template contained in the XML string to the current system elements, and show what will be changed if this template will be imported. Request: ```json { "jsonrpc": "2.0", "method": "configuration.importcompare", "params": { "format": "xml", "rules": { "discoveryRules": { "createMissing": true, "updateExisting": true, "deleteMissing": true }, "graphs": { "createMissing": true, "updateExisting": true, "deleteMissing": true }, "groups": { "createMissing": true, "updateExisting": true }, "httptests": { "createMissing": true, "updateExisting": true, "deleteMissing": true }, "items": { "createMissing": true, "updateExisting": true, "deleteMissing": true }, "templateLinkage": { "createMissing": true, "deleteMissing": true }, "templates": { "createMissing": true, "updateExisting": true }, "templateDashboards": { "createMissing": true, "updateExisting": true, "deleteMissing": true }, "triggers": { "createMissing": true, "updateExisting": true, "deleteMissing": true }, "valueMaps": { "createMissing": true, "updateExisting": true, "deleteMissing": true } }, "source": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<zabbix_export><version>6.0</version><date>2023-01-01T12:30:00Z</date><groups><group><uuid>7df96b18c230490a9a0a9e2307226338</uuid><name>Templates</name></group></groups><templates><template><uuid>5aef0444a82a4d8cb7a95dc4c0c85330</uuid><template>New template</template><name>New template</name><groups><group><name>Templates</name></group></groups><items><item><uuid>7f1e6f1e48aa4a128e5b6a958a5d11c3</uuid><name>Zabbix agent ping</name><key>agent.ping</key><delay>3m</delay></item><item><uuid>77ba228662be4570830aa3c503fcdc03</uuid><name>Apache server uptime</name><type>DEPENDENT</type><key>apache.server.uptime</key><delay>0</delay><trends>0</trends><value_type>TEXT</value_type><preprocessing><step><type>REGEX</type><parameters><parameter>&lt;dt&gt;Server uptime: (.*)&lt;/dt&gt;</parameter><parameter>\\1</parameter></parameters></step></preprocessing><master_item><key>web.page.get[127.0.0.1/server-status]</key></master_item></item><item><uuid>648006da5971424ead0c47ddbbf1ea2e</uuid><name>CPU utilization</name><key>system.cpu.util</key><value_type>FLOAT</value_type><units>%</units><triggers><trigger><uuid>736225012c534ec480c2a66a91322ce0</uuid><expression>avg(/New template/system.cpu.util,3m)&gt;70</expression><name>CPU utilization too high on 'New host' for 3 minutes</name><priority>WARNING</priority></trigger></triggers></item><item><uuid>590efe5731254f089265c76ff9320726</uuid><name>Apache server status</name><key>web.page.get[127.0.0.1/server-status]</key><trends>0</trends><value_type>TEXT</value_type></item></items><valuemaps><valuemap><uuid>8fd5814c45d44a00a15ac6eaae1f3946</uuid><name>Zabbix agent ping</name><mappings><mapping><value>1</value><newvalue>Available</newvalue></mapping><mapping><value>0</value><newvalue>Not available</newvalue></mapping></mappings></valuemap></valuemaps></template></templates></zabbix_export>\n" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "templates": { "updated": [ { "before": { "uuid": "5aef0444a82a4d8cb7a95dc4c0c85330", "template": "New template", "name": "New template" }, "after": { "uuid": "5aef0444a82a4d8cb7a95dc4c0c85330", "template": "New template", "name": "New template" }, "items": { "added": [ { "after": { "uuid": "648006da5971424ead0c47ddbbf1ea2e", "name": "CPU utilization", "key": "system.cpu.util", "value_type": "FLOAT", "units": "%" }, "triggers": { "added": [ { "after": { "uuid": "736225012c534ec480c2a66a91322ce0", "expression": "avg(/New template/system.cpu.util,3m)>70", "name": "CPU utilization too high on 'New host' for 3 minutes", "priority": "WARNING" } } ] } } ], "removed": [ { "before": { "uuid": "6805d4c39a624a8bab2cc8ab63df1ab3", "name": "CPU load", "key": "system.cpu.load", "value_type": "FLOAT" }, "triggers": { "removed": [ { "before": { "uuid": "ab4c2526c2bc42e48a633082255ebcb3", "expression": "avg(/New template/system.cpu.load,3m)>2", "name": "CPU load too high on 'New host' for 3 minutes", "priority": "WARNING" } } ] } } ], "updated": [ { "before": { "uuid": "7f1e6f1e48aa4a128e5b6a958a5d11c3", "name": "Zabbix agent ping", "key": "agent.ping" }, "after": { "uuid": "7f1e6f1e48aa4a128e5b6a958a5d11c3", "name": "Zabbix agent ping", "key": "agent.ping", "delay": "3m" } } ] } } ] } }, "id": 1 } ``` #### وارد کردن هاست و آیتم ها الگو و موارد موجود در رشته YAML را وارد کنید. اگر مواردی وجود دارد در YAML وجود ندارد، آنها به عنوان حذف شده نشان داده می شوند و هر چیز دیگری بدون تغییر باقی خواهد ماند. Request: ```json { "jsonrpc": "2.0", "method": "configuration.import", "params": { "format": "xml", "rules": { "groups": { "createMissing": true, "updateExisting": true }, "templates": { "createMissing": true, "updateExisting": true }, "items": { "createMissing": true, "updateExisting": true, "deleteMissing": true }, "triggers": { "createMissing": true, "updateExisting": true, "deleteMissing": true }, "discoveryRules": { "createMissing": true, "updateExisting": true, "deleteMissing": true }, "valueMaps": { "createMissing": true, "updateExisting": false } }, "source": "<?xml version=\"1.0\" encoding=\"UTF-8\"?><zabbix_export><version>5.4</version><date>2021-05-27T07:12:07Z</date><groups><group><uuid>6f6799aa69e844b4b3918f779f2abf08</uuid><name>Zabbix servers</name></group></groups><templates><template><uuid>e1bde9bf2f0544f5929f45b82502e744</uuid><template>Export template</template><name>Export template</name><groups><group><name>Zabbix servers</name></group></groups><items><item><uuid>3237bc89226e42ed8207574022470e83</uuid><name>Item</name><key>item.key</key><delay>30s</delay><valuemap><name>Host status</name></valuemap><triggers><trigger><uuid>bd1ed0089e4b4f35b762c9d6c599c348</uuid><expression>last(/Export template/item.key)=0</expression><name>Trigger</name></trigger></triggers></item></items><discovery_rules><discovery_rule><uuid>c91616bcf4a44f349539a1b40cb0979d</uuid><name>Discovery rule</name><key>rule.key</key><item_prototypes><item_prototype><uuid>7e164881825744248b3039af3435cf4b</uuid><name>Item prototype</name><key>prototype.key</key></item_prototype></item_prototypes></discovery_rule></discovery_rules><valuemaps><valuemap><uuid>7e666857c5df4af3a338349586f2afc3</uuid><name>Host status</name><mappings><mapping><value>0</value><newvalue>Up</newvalue></mapping><mapping><value>2</value><newvalue>Unreachable</newvalue></mapping></mappings></valuemap></valuemaps></template></templates></zabbix_export>" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ``` {.java} { "jsonrpc":"2.0", "result":{ "templates":{ "updated":[ { "before":{ "uuid":"e1bde9bf2f0544f5929f45b82502e744", "template":"Export template", "name":"Export template" }, "after":{ "uuid":"e1bde9bf2f0544f5929f45b82502e744", "template":"Export template", "name":"Export template" }, "items":{ "added":[ { "after":{ "uuid":"3237bc89226e42ed8207574022470e83", "name":"Item", "key":"item.key", "delay":"30s", "valuemap":{ "name":"Host status" } }, "triggers":{ "added":[ { "after":{ "uuid":"bd1ed0089e4b4f35b762c9d6c599c348", "expression":"last(/Export template/item.key)=0", "name":"Trigger" } } ] } } ], "removed":[ { "before":{ "uuid":"bd3e7b28b3d544d6a83ed01ddaa65ab6", "name":"Old Item", "key":"ite_old.key", "delay":"30s", "valuemap":{ "name":"Host status" } } } ] }, "discovery_rules":{ "updated":[ { "before":{ "uuid":"c91616bcf4a44f349539a1b40cb0979d", "name":"Discovery rule", "key":"rule.key" }, "after":{ "uuid":"c91616bcf4a44f349539a1b40cb0979d", "name":"Discovery rule", "key":"rule.key" }, "item_prototypes":{ "updated":[ { "before":{ "uuid":"7e164881825744248b3039af3435cf4b", "name":"Old item prototype", "key":"prototype_old.key" }, "after":{ "uuid":"7e164881825744248b3039af3435cf4b", "name":"Item prototype", "key":"prototype.key" } } ] } } ] } } ] } }, "id":1 } ``` #### Configuration پیکربندی # configuration.export خروجی گرفتن از تنظیمات #### Configuration file For details on configuring Zabbix agent see the configuration file options for [zabbix\_agentd](/manual/appendix/config/zabbix_agentd) or [Windows agent](/manual/appendix/config/zabbix_agentd_win). #### فایل پیکربندی برای جزئیات در مورد پیکربندی عامل Zabbix به فایل پیکربندی مراجعه کنید گزینه‌های [zabbix\_agentd](/manual/appendix/config/zabbix_agentd) یا [نماینده ویندوز](/دستی/ضمیمه/config/zabbix_agentd_win). ##### Configuration file See the [configuration file](/manual/appendix/config/zabbix_proxy) options for details on configuring zabbix\_proxy. ##### فایل پیکربندی [فایل پیکربندی] (/manual/appendix/config/zabbix_server) را ببینید گزینه هایی برای جزئیات پیکربندی zabbix\_server. ##### Configuration file See the [configuration file](/manual/appendix/config/zabbix_server) options for details on configuring zabbix\_server. ##### فایل پیکربندی [فایل پیکربندی] (/manual/appendix/config/zabbix_server) را ببینید گزینه هایی برای جزئیات پیکربندی zabbix\_server. # configuration.import وارد کردن تنظیمات # configuration.importcompare مقایسه تنظیمات وارد شده #### Configuration Overall, the process of setting up the notification should feel familiar to those who have set up alerts in Zabbix before. #### پیکربندی به طور کلی، روند تنظیم اعلان باید آشنا باشد به کسانی که قبلاً هشدارهایی را در Zabbix تنظیم کرده اند. #### Configuration To ensure proper communication between all elements involved make sure server configuration file and frontend configuration file parameters are properly configured. #### پیکربندی برای اطمینان از ارتباط مناسب بین تمام عناصر درگیر مطمئن شوید فایل پیکربندی سرور و پارامترهای فایل پیکربندی frontend هستند به درستی پیکربندی شده است. #### Configuration To ensure proper communication between all elements involved make sure server configuration file and frontend configuration parameters are properly configured. #### پیکربندی برای اطمینان از ارتباط مناسب بین تمام عناصر درگیر مطمئن شوید فایل پیکربندی سرور و پارامترهای فایل پیکربندی frontend هستند به درستی پیکربندی شده است. #### Configuration Two steps are required to close a problem manually. #### پیکربندی دو مرحله برای بستن یک مشکل به صورت دستی لازم است. ###### Configure request A request to execute the *Configure* function of the *Configurator* interface. | | | |---|---| |direction|agent → plugin| |response|n/a| Parameters specific to *Configure* requests: |Name|Type|Comments| |---------|--------|----------| |global_options|JSON object|JSON object containing global agent configuration options.| |private_options|JSON object (optional)|JSON object containing private plugin configuration options, if provided.| *Example:* {"id":6,"type":8,"global_options":{...},"private_options":{...}} ###### پیکربندی درخواست درخواستی برای اجرای تابع *Configure* رابط *Configurator*. | | | |---|---| |جهت|عامل → افزونه| |پاسخ|عدم| پارامترهای خاص درخواست های *پیکربندی*: |نام|نوع|نظر| |---------|--------|----------| |global_options|شیء JSON|شیء JSON حاوی گزینه‌های پیکربندی عامل جهانی.| |private_options|شیء JSON (اختیاری)|شیء JSON حاوی گزینه‌های پیکربندی افزونه خصوصی، در صورت ارائه.| *مثال:* {"id":6,"type":8,"global_options":{...},"private_options":{...}} #### Configuring a *Data overview* widget Configure a *Data overview* widget that displays data for host "10084" and only for items for which the tag with the name "component" contains value "cpu". In addition, display the data with hosts located on top. Request: ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "dataover", "name": "Data overview", "x": 0, "y": 0, "width": 12, "height": 5, "view_mode": 0, "fields": [ { "type": 3, "name": "hostids", "value": 10084 }, { "type": 1, "name": "tags.tag.0", "value": "component" }, { "type": 0, "name": "tags.operator.0", "value": 0 }, { "type": 1, "name": "tags.value.0", "value": "cpu" }, { "type": 0, "name": "style", "value": 1 } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### پیکربندی یک ویجت *نمای کلی داده* ویجت *نمای اجمالی داده* را پیکربندی کنید که داده ها را برای میزبان "10084" و فقط برای مواردی که برچسب با نام "کامپوننت" حاوی مقدار "cpu" است، نمایش دهد. علاوه بر این، داده ها را با میزبان هایی که در بالا قرار دارند نمایش دهید. درخواست: ``json { "jsonrpc": "2.0"، "روش": "dashboard.create"، "params": { "name": "داشبورد من"، "display_period": 30، "auto_start": 1، "صفحات": [ { "ویجت ها": [ { "type": "dataover", "name": "نمای کلی داده"، "x": 0، "y": 0، "عرض": 12، "ارتفاع": 5، "view_mode": 0، "زمینه های": [ { "نوع": 3، "نام": "میزبان"، "ارزش": 10084 }، { "نوع": 1، "name": "tags.tag.0"، "ارزش": "مولفه" }، { "نوع": 0، "name": "tags.operator.0"، "ارزش": 0 }، { "نوع": 1، "name": "tags.value.0"، "value": "cpu" }، { "نوع": 0، "نام": "سبک"، "ارزش": 1 } ] } ] } ]، "userGroups": [ { "usrgrpid": 7، «اجازه»: 2 } ]، "کاربران": [ { "userid": 1، «اجازه»: 3 } ] }، "auth": "038e1d7b1735c6a5436ee9eae095879e"، "id": 1 } ``` واکنش: ``json { "jsonrpc": "2.0"، "نتیجه": { "داشبوردها": [ "3" ] }، "id": 1 } ``` #### Configuring agent Both generations of Zabbix agents run as a Windows service. For Zabbix agent 2, replace *agentd* with *agent2* in the instructions below. You can run a single instance of Zabbix agent or multiple instances of the agent on a Microsoft Windows host. A single instance can use the default configuration file `C:\zabbix_agentd.conf` or a configuration file specified in the command line. In case of multiple instances each agent instance must have its own configuration file (one of the instances can use the default configuration file). An example configuration file is available in Zabbix source archive as `conf/zabbix_agentd.win.conf`. See the [configuration file](/manual/appendix/config/zabbix_agentd_win) options for details on configuring Zabbix Windows agent. #### عامل پیکربندی هر دو نسل از عوامل Zabbix به عنوان یک سرویس ویندوز اجرا می شوند. برای Zabbix عامل 2، در دستورالعمل زیر *agentd* را با *agent2* جایگزین کنید. شما می توانید یک نمونه از عامل Zabbix یا چندین نمونه از آن را اجرا کنید عامل در هاست مایکروسافت ویندوز. یک نمونه واحد می تواند از فایل پیکربندی پیش فرض «C:\zabbix_agentd.conf» یا یک پیکربندی فایل مشخص شده در خط فرمان در صورت وجود موارد متعدد هر کدام نمونه agent باید فایل پیکربندی خاص خود را داشته باشد (یکی از نمونه ها می توانند از فایل پیکربندی پیش فرض استفاده کنند). یک نمونه فایل پیکربندی در بایگانی منبع Zabbix به عنوان موجود است "conf/zabbix_agentd.win.conf". [فایل پیکربندی](/manual/appendix/config/zabbix_agentd_win) را ببینید گزینه هایی برای جزئیات پیکربندی عامل ویندوز Zabbix. #### Configuring a *Top hosts* widget Configure a *Top hosts* widget that displays top hosts by CPU utilization in host group "4". In addition, configure the following custom columns: "Host name", "Utilization", "1m avg", "5m avg", "15m avg", "Processes". Request: ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "tophosts", "name": "Top hosts", "x": 0, "y": 0, "width": 12, "height": 5, "view_mode": 0, "fields": [ { "type": 2, "name": "groupids", "value": 4 }, { "type": 1, "name": "columns.name.0", "value": "" }, { "type": 0, "name": "columns.data.0", "value": 2 }, { "type": 1, "name": "columns.base_color.0", "value": "FFFFFF" }, { "type": 1, "name": "columns.timeshift.0", "value": "" }, { "type": 1, "name": "columns.name.1", "value": "Utilization" }, { "type": 0, "name": "columns.data.1", "value": 1 }, { "type": 1, "name": "columns.base_color.1", "value": "4CAF50" }, { "type": 1, "name": "columns.timeshift.1", "value": "" }, { "type": 1, "name": "columns.item.1", "value": "CPU utilization" }, { "type": 0, "name": "columns.display.1", "value": 3 }, { "type": 1, "name": "columns.min.1", "value": "0" }, { "type": 1, "name": "columns.max.1", "value": "100" }, { "type": 1, "name": "columnsthresholds.color.1.0", "value": "FFFF00" }, { "type": 1, "name": "columnsthresholds.threshold.1.0", "value": "50" }, { "type": 1, "name": "columnsthresholds.color.1.1", "value": "FF8000" }, { "type": 1, "name": "columnsthresholds.threshold.1.1", "value": "80" }, { "type": 1, "name": "columnsthresholds.color.1.2", "value": "FF4000" }, { "type": 1, "name": "columnsthresholds.threshold.1.2", "value": "90" }, { "type": 1, "name": "columns.name.2", "value": "1m avg" }, { "type": 0, "name": "columns.data.2", "value": 1 }, { "type": 1, "name": "columns.base_color.2", "value": "FFFFFF" }, { "type": 1, "name": "columns.timeshift.2", "value": "" }, { "type": 1, "name": "columns.item.2", "value": "Load average (1m avg)" }, { "type": 1, "name": "columns.name.3", "value": "5m avg" }, { "type": 0, "name": "columns.data.3", "value": 1 }, { "type": 1, "name": "columns.base_color.3", "value": "FFFFFF" }, { "type": 1, "name": "columns.timeshift.3", "value": "" }, { "type": 1, "name": "columns.item.3", "value": "Load average (5m avg)" }, { "type": 1, "name": "columns.name.4", "value": "15m avg" }, { "type": 0, "name": "columns.data.4", "value": 1 }, { "type": 1, "name": "columns.base_color.4", "value": "FFFFFF" }, { "type": 1, "name": "columns.timeshift.4", "value": "" }, { "type": 1, "name": "columns.item.4", "value": "Load average (15m avg)" }, { "type": 1, "name": "columns.name.5", "value": "Processes" }, { "type": 0, "name": "columns.data.5", "value": 1 }, { "type": 1, "name": "columns.base_color.5", "value": "FFFFFF" }, { "type": 1, "name": "columns.timeshift.5", "value": "" }, { "type": 1, "name": "columns.item.5", "value": "Number of processes" }, { "type": 0, "name": "column", "value": 1 } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### Configurant el giny d'*Equips principals* Configura un giny d'*Equips principals* que ensenya els equips principals sobre ús de CPU del grup d'equips "4". A més, configura les columnes següents: "Nom d'equip", "Ús", "1m avg", "5m avg", "15m avg", "Processos". Petició: ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "tophosts", "name": "Top hosts", "x": 0, "y": 0, "width": 12, "height": 5, "view_mode": 0, "fields": [ { "type": 2, "name": "groupids", "value": 4 }, { "type": 1, "name": "columns.name.0", "value": "" }, { "type": 0, "name": "columns.data.0", "value": 2 }, { "type": 1, "name": "columns.base_color.0", "value": "FFFFFF" }, { "type": 1, "name": "columns.timeshift.0", "value": "" }, { "type": 1, "name": "columns.name.1", "value": "Utilization" }, { "type": 0, "name": "columns.data.1", "value": 1 }, { "type": 1, "name": "columns.base_color.1", "value": "4CAF50" }, { "type": 1, "name": "columns.timeshift.1", "value": "" }, { "type": 1, "name": "columns.item.1", "value": "CPU utilization" }, { "type": 0, "name": "columns.display.1", "value": 3 }, { "type": 1, "name": "columns.min.1", "value": "0" }, { "type": 1, "name": "columns.max.1", "value": "100" }, { "type": 1, "name": "columnsthresholds.color.1.0", "value": "FFFF00" }, { "type": 1, "name": "columnsthresholds.threshold.1.0", "value": "50" }, { "type": 1, "name": "columnsthresholds.color.1.1", "value": "FF8000" }, { "type": 1, "name": "columnsthresholds.threshold.1.1", "value": "80" }, { "type": 1, "name": "columnsthresholds.color.1.2", "value": "FF4000" }, { "type": 1, "name": "columnsthresholds.threshold.1.2", "value": "90" }, { "type": 1, "name": "columns.name.2", "value": "1m avg" }, { "type": 0, "name": "columns.data.2", "value": 1 }, { "type": 1, "name": "columns.base_color.2", "value": "FFFFFF" }, { "type": 1, "name": "columns.timeshift.2", "value": "" }, { "type": 1, "name": "columns.item.2", "value": "Load average (1m avg)" }, { "type": 1, "name": "columns.name.3", "value": "5m avg" }, { "type": 0, "name": "columns.data.3", "value": 1 }, { "type": 1, "name": "columns.base_color.3", "value": "FFFFFF" }, { "type": 1, "name": "columns.timeshift.3", "value": "" }, { "type": 1, "name": "columns.item.3", "value": "Load average (5m avg)" }, { "type": 1, "name": "columns.name.4", "value": "15m avg" }, { "type": 0, "name": "columns.data.4", "value": 1 }, { "type": 1, "name": "columns.base_color.4", "value": "FFFFFF" }, { "type": 1, "name": "columns.timeshift.4", "value": "" }, { "type": 1, "name": "columns.item.4", "value": "Load average (15m avg)" }, { "type": 1, "name": "columns.name.5", "value": "Processes" }, { "type": 0, "name": "columns.data.5", "value": 1 }, { "type": 1, "name": "columns.base_color.5", "value": "FFFFFF" }, { "type": 1, "name": "columns.timeshift.5", "value": "" }, { "type": 1, "name": "columns.item.5", "value": "Number of processes" }, { "type": 0, "name": "column", "value": 1 } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### Configuring authentication The **Authentication** tab allows you to configure scenario authentication options. A green dot next to the tab name indicates that some type of HTTP authentication is enabled. ![](../../assets/en/manual/config/scenario_d.png) Authentication parameters: |Parameter|Description| |--|--------| |*Authentication*|Authentication options.<br>**None** - no authentication used.<br>**Basic** - basic authentication is used.<br>**NTLM** - NTLM ([Windows NT LAN Manager)](http://en.wikipedia.org/wiki/NTLM) authentication is used.<br>**Kerberos** - Kerberos authentication is used. See also: [Configuring Kerberos with Zabbix](/manual/appendix/items/kerberos).<br>**Digest** - Digest authentication is used.<br>Selecting an authentication method will provide two additional fields for entering a user name and password.<br>User macros can be used in user and password fields.| |*SSL verify peer*|Mark the checkbox to verify the SSL certificate of the web server.<br>The server certificate will be automatically taken from system-wide certificate authority (CA) location. You can override the location of CA files using Zabbix server or proxy configuration parameter [SSLCALocation](/manual/appendix/config/zabbix_server).<br>This sets the [CURLOPT\_SSL\_VERIFYPEER](http://curl.haxx.se/libcurl/c/CURLOPT_SSL_VERIFYPEER.html) cURL option.| |*SSL verify host*|Mark the checkbox to verify that the *Common Name* field or the *Subject Alternate Name* field of the web server certificate matches.<br>This sets the [CURLOPT\_SSL\_VERIFYHOST](http://curl.haxx.se/libcurl/c/CURLOPT_SSL_VERIFYHOST.html) cURL option.| |*SSL certificate file*|Name of the SSL certificate file used for client authentication. The certificate file must be in PEM^1^ format. If the certificate file contains also the private key, leave the *SSL key file* field empty. If the key is encrypted, specify the password in *SSL key password* field. The directory containing this file is specified by Zabbix server or proxy configuration parameter [SSLCertLocation](/manual/appendix/config/zabbix_server).<br>`HOST.*` macros and user macros can be used in this field.<br>This sets the [CURLOPT\_SSLCERT](http://curl.haxx.se/libcurl/c/CURLOPT_SSLCERT.html) cURL option.| |*SSL key file*|Name of the SSL private key file used for client authentication. The private key file must be in PEM^1^ format. The directory containing this file is specified by Zabbix server or proxy configuration parameter [SSLKeyLocation](/manual/appendix/config/zabbix_server).<br>`HOST.*` macros and user macros can be used in this field.<br>This sets the [CURLOPT\_SSLKEY](http://curl.haxx.se/libcurl/c/CURLOPT_SSLKEY.html) cURL option.| |*SSL key password*|SSL private key file password.<br>User macros can be used in this field.<br>This sets the [CURLOPT\_KEYPASSWD](http://curl.haxx.se/libcurl/c/CURLOPT_KEYPASSWD.html) cURL option.| ::: noteimportant \[1\] Zabbix supports certificate and private key files in PEM format only. In case you have your certificate and private key data in PKCS \#12 format file (usually with extension \*.p12 or \*.pfx) you may generate the PEM file from it using the following commands: openssl pkcs12 -in ssl-cert.p12 -clcerts -nokeys -out ssl-cert.pem openssl pkcs12 -in ssl-cert.p12 -nocerts -nodes -out ssl-cert.key ::: ::: noteclassic Zabbix server picks up changes in certificates without a restart. ::: ::: noteclassic If you have client certificate and private key in a single file just specify it in a "SSL certificate file" field and leave "SSL key file" field empty. The certificate and key must still be in PEM format. Combining certificate and key is easy: cat client.crt client.key > client.pem ::: #### تنظیم احراز هویت The **Authentication** tab allows you to configure scenario authentication options. A green dot next to the tab name indicates that some type of HTTP authentication is enabled. ![](../../assets/en/manual/config/scenario_d.png) Authentication parameters: |Parameter|Description| |--|--------| |*Authentication*|Authentication options.<br>**None** - no authentication used.<br>**Basic** - basic authentication is used.<br>**NTLM** - NTLM ([Windows NT LAN Manager)](http://en.wikipedia.org/wiki/NTLM) authentication is used.<br>**Kerberos** - Kerberos authentication is used. See also: [Configuring Kerberos with Zabbix](/manual/appendix/items/kerberos).<br>**Digest** - Digest authentication is used.<br>Selecting an authentication method will provide two additional fields for entering a user name and password.<br>User macros can be used in user and password fields.| |*SSL verify peer*|Mark the checkbox to verify the SSL certificate of the web server.<br>The server certificate will be automatically taken from system-wide certificate authority (CA) location. You can override the location of CA files using Zabbix server or proxy configuration parameter [SSLCALocation](/manual/appendix/config/zabbix_server).<br>This sets the [CURLOPT\_SSL\_VERIFYPEER](http://curl.haxx.se/libcurl/c/CURLOPT_SSL_VERIFYPEER.html) cURL option.| |*SSL verify host*|Mark the checkbox to verify that the *Common Name* field or the *Subject Alternate Name* field of the web server certificate matches.<br>This sets the [CURLOPT\_SSL\_VERIFYHOST](http://curl.haxx.se/libcurl/c/CURLOPT_SSL_VERIFYHOST.html) cURL option.| |*SSL certificate file*|Name of the SSL certificate file used for client authentication. The certificate file must be in PEM^1^ format. If the certificate file contains also the private key, leave the *SSL key file* field empty. If the key is encrypted, specify the password in *SSL key password* field. The directory containing this file is specified by Zabbix server or proxy configuration parameter [SSLCertLocation](/manual/appendix/config/zabbix_server).<br>`HOST.*` macros and user macros can be used in this field.<br>This sets the [CURLOPT\_SSLCERT](http://curl.haxx.se/libcurl/c/CURLOPT_SSLCERT.html) cURL option.| |*SSL key file*|Name of the SSL private key file used for client authentication. The private key file must be in PEM^1^ format. The directory containing this file is specified by Zabbix server or proxy configuration parameter [SSLKeyLocation](/manual/appendix/config/zabbix_server).<br>`HOST.*` macros and user macros can be used in this field.<br>This sets the [CURLOPT\_SSLKEY](http://curl.haxx.se/libcurl/c/CURLOPT_SSLKEY.html) cURL option.| |*SSL key password*|SSL private key file password.<br>User macros can be used in this field.<br>This sets the [CURLOPT\_KEYPASSWD](http://curl.haxx.se/libcurl/c/CURLOPT_KEYPASSWD.html) cURL option.| ::: noteimportant \[1\] Zabbix supports certificate and private key files in PEM format only. In case you have your certificate and private key data in PKCS \#12 format file (usually with extension \*.p12 or \*.pfx) you may generate the PEM file from it using the following commands: openssl pkcs12 -in ssl-cert.p12 -clcerts -nokeys -out ssl-cert.pem openssl pkcs12 -in ssl-cert.p12 -nocerts -nodes -out ssl-cert.key ::: ::: noteclassic Zabbix server picks up changes in certificates without a restart. ::: ::: noteclassic If you have client certificate and private key in a single file just specify it in a "SSL certificate file" field and leave "SSL key file" field empty. The certificate and key must still be in PEM format. Combining certificate and key is easy: cat client.crt client.key > client.pem ::: #### Configuring low-level discovery rules See the [low-level discovery](/manual/discovery/low_level_discovery) section of the manual. #### پیکربندی قوانین کشف سطح پایین [کاوش سطح پایین] (/manual/discovery/low_level_discovery) را ببینید بخش راهنما #### Configuring SNMP monitoring To start monitoring a device through SNMP, the following steps have to be performed: #### پیکربندی نظارت SNMP برای شروع نظارت بر دستگاه از طریق SNMP، مراحل زیر باید انجام شود انجام شود: #### Configuring steps ![](../../assets/en/manual/config/scenario_step.png){width="600"} Step parameters: |Parameter|Description| |--|--------| |*Name*|Unique step name.<br>[User macros](/manual/config/macros/user_macros) are supported. *Note* that if user macros are used, these macros will be left unresolved in [web monitoring item](/manual/web_monitoring/items) names.| |*URL*|URL to connect to and retrieve data. For example:<br>https://www.example.com<br>http://www.example.com/download<br>Domain names can be specified in Unicode characters. They are automatically punycode-converted to ASCII when executing the web scenario step.<br>The *Parse* button can be used to separate optional query fields (like ?name=Admin&password=mypassword) from the URL, moving the attributes and values into *Query fields* for automatic URL-encoding.<br>Variables can be used in the URL, using the {macro} syntax. Variables can be URL-encoded manually using a {{macro}.urlencode()} syntax.<br>User macros and {HOST.\*} [macros](/manual/appendix/macros/supported_by_location) are supported.<br>Limited to 2048 characters.| |*Query fields*|HTTP GET variables for the URL.<br>Specified as attribute and value pairs.<br>Values are URL-encoded automatically. Values from scenario variables, user macros or {HOST.\*} macros are resolved and then URL-encoded automatically. Using a {{macro}.urlencode()} syntax will double URL-encode them.<br>User macros and {HOST.\*} [macros](/manual/appendix/macros/supported_by_location) are supported.| |*Post*|HTTP POST variables.<br>In **Form data** mode, specified as attribute and value pairs.<br>Values are URL-encoded automatically. Values from scenario variables, user macros or {HOST.\*} macros are resolved and then URL-encoded automatically.<br>In **Raw data** mode, attributes/values are displayed on a single line and concatenated with a **&** symbol.<br>Raw values can be URL-encoded/decoded manually using a {{macro}.urlencode()} or {{macro}.urldecode()} syntax.<br>For example: id=2345&userid={user}<br>If {user} is defined as a variable of the web scenario, it will be replaced by its value when the step is executed. If you wish to URL-encode the variable, substitute {user} with {{user}.urlencode()}.<br>User macros and {HOST.\*} [macros](/manual/appendix/macros/supported_by_location) are supported.| |*Variables*|Step-level variables that may be used for GET and POST functions.<br>Specified as attribute and value pairs.<br>Step-level variables override scenario-level variables or variables from the previous step. However, the value of a step-level variable only affects the step after (and not the current step).<br>They have the following format:<br>**{macro}**=value<br>**{macro}**=regex:<regular expression><br>For more information see variable description on the [scenario](web_monitoring#configuring_a_web_scenario) level.<br>Variables are automatically URL-encoded when used in query fields or form data for post variables, but must be URL-encoded manually when used in raw post or directly in URL.| |*Headers*|Custom HTTP headers that will be sent when performing a request.<br>Specified as attribute and value pairs.<br>A header defined on a step level will be used for that particular step.<br>**It should be noted that defining the header on a step level automatically discards all the previously defined headers, except for a default header that is assigned by selecting the 'User-Agent' from a drop-down list on a scenario level.**<br>However, even the 'User-Agent' default header can be overridden by specifying it on a step level.<br>For example, assigning the name to a header, but setting no value will unset the default header on a scenario level.<br>User macros and {HOST.\*} macros are supported.<br>This sets the [CURLOPT\_HTTPHEADER](http://curl.haxx.se/libcurl/c/CURLOPT_HTTPHEADER.html) cURL option.<br>Specifying custom headers is supported *starting with Zabbix 2.4*.| |*Follow redirects*|Mark the checkbox to follow HTTP redirects.<br>This sets the [CURLOPT\_FOLLOWLOCATION](http://curl.haxx.se/libcurl/c/CURLOPT_FOLLOWLOCATION.html) cURL option.| |*Retrieve mode*|Select the retrieve mode:<br>**Body** - retrieve only body from the HTTP response<br>**Headers** - retrieve only headers from the HTTP response<br>**Body and headers** - retrieve body and headers from the HTTP response| |*Timeout*|Zabbix will not spend more than the set amount of time on processing the URL (from one second to maximum of 1 hour). Actually this parameter defines the maximum time for making connection to the URL and maximum time for performing an HTTP request. Therefore, Zabbix will not spend more than **2 x Timeout** seconds on the step.<br>[Time suffixes](/manual/appendix/suffixes) are supported, e.g. 30s, 1m, 1h. [User macros](/manual/config/macros/user_macros) are supported.| |*Required string*|Required regular expression pattern.<br>Unless retrieved content (HTML) matches the required pattern the step will fail. If empty, no check on required string is performed.<br>For example:<br>Homepage of Zabbix<br>Welcome.\*admin<br>*Note*: Referencing [regular expressions](regular_expressions) created in the Zabbix frontend is not supported in this field.<br>User macros and {HOST.\*} [macros](/manual/appendix/macros/supported_by_location) are supported.| |*Required status codes*|List of expected HTTP status codes. If Zabbix gets a code which is not in the list, the step will fail.<br>If empty, no check on status codes is performed.<br>For example: 200,201,210-299<br>User macros are supported.| ::: noteclassic Any changes in web scenario steps will only be saved when the whole scenario is saved. ::: See also a [real-life example](/manual/web_monitoring/example) of how web monitoring steps can be configured. #### تنظیم مراحل ![](../../assets/en/manual/config/scenario_step.png){width="600"} Step parameters: |Parameter|Description| |--|--------| |*Name*|Unique step name.| |*URL*|URL to connect to and retrieve data. For example:<br>https://www.example.com<br>http://www.example.com/download<br>Domain names can be specified in Unicode characters. They are automatically punycode-converted to ASCII when executing the web scenario step.<br>The *Parse* button can be used to separate optional query fields (like ?name=Admin&password=mypassword) from the URL, moving the attributes and values into *Query fields* for automatic URL-encoding.<br>Variables can be used in the URL, using the {macro} syntax. Variables can be URL-encoded manually using a {{macro}.urlencode()} syntax.<br>User macros and {HOST.\*} [macros](/manual/appendix/macros/supported_by_location) are supported.<br>Limited to 2048 characters.| |*Query fields*|HTTP GET variables for the URL.<br>Specified as attribute and value pairs.<br>Values are URL-encoded automatically. Values from scenario variables, user macros or {HOST.\*} macros are resolved and then URL-encoded automatically. Using a {{macro}.urlencode()} syntax will double URL-encode them.<br>User macros and {HOST.\*} [macros](/manual/appendix/macros/supported_by_location) are supported.| |*Post*|HTTP POST variables.<br>In **Form data** mode, specified as attribute and value pairs.<br>Values are URL-encoded automatically. Values from scenario variables, user macros or {HOST.\*} macros are resolved and then URL-encoded automatically.<br>In **Raw data** mode, attributes/values are displayed on a single line and concatenated with a **&** symbol.<br>Raw values can be URL-encoded/decoded manually using a {{macro}.urlencode()} or {{macro}.urldecode()} syntax.<br>For example: id=2345&userid={user}<br>If {user} is defined as a variable of the web scenario, it will be replaced by its value when the step is executed. If you wish to URL-encode the variable, substitute {user} with {{user}.urlencode()}.<br>User macros and {HOST.\*} [macros](/manual/appendix/macros/supported_by_location) are supported.| |*Variables*|Step-level variables that may be used for GET and POST functions.<br>Specified as attribute and value pairs.<br>Step-level variables override scenario-level variables or variables from the previous step. However, the value of a step-level variable only affects the step after (and not the current step).<br>They have the following format:<br>**{macro}**=value<br>**{macro}**=regex:<regular expression><br>For more information see variable description on the [scenario](web_monitoring#configuring_a_web_scenario) level.<br>Variables are automatically URL-encoded when used in query fields or form data for post variables, but must be URL-encoded manually when used in raw post or directly in URL.| |*Headers*|Custom HTTP headers that will be sent when performing a request.<br>Specified as attribute and value pairs.<br>A header defined on a step level will be used for that particular step.<br>**It should be noted that defining the header on a step level automatically discards all the previously defined headers, except for a default header that is assigned by selecting the 'User-Agent' from a drop-down list on a scenario level.**<br>However, even the 'User-Agent' default header can be overridden by specifying it on a step level.<br>For example, assigning the name to a header, but setting no value will unset the default header on a scenario level.<br>User macros and {HOST.\*} macros are supported.<br>This sets the [CURLOPT\_HTTPHEADER](http://curl.haxx.se/libcurl/c/CURLOPT_HTTPHEADER.html) cURL option.<br>Specifying custom headers is supported *starting with Zabbix 2.4*.| |*Follow redirects*|Mark the checkbox to follow HTTP redirects.<br>This sets the [CURLOPT\_FOLLOWLOCATION](http://curl.haxx.se/libcurl/c/CURLOPT_FOLLOWLOCATION.html) cURL option.| |*Retrieve mode*|Select the retrieve mode:<br>**Body** - retrieve only body from the HTTP response<br>**Headers** - retrieve only headers from the HTTP response<br>**Body and headers** - retrieve body and headers from the HTTP response| |*Timeout*|Zabbix will not spend more than the set amount of time on processing the URL (from one second to maximum of 1 hour). Actually this parameter defines the maximum time for making connection to the URL and maximum time for performing an HTTP request. Therefore, Zabbix will not spend more than **2 x Timeout** seconds on the step.<br>[Time suffixes](/manual/appendix/suffixes) are supported, e.g. 30s, 1m, 1h. [User macros](/manual/config/macros/user_macros) are supported.| |*Required string*|Required regular expression pattern.<br>Unless retrieved content (HTML) matches the required pattern the step will fail. If empty, no check on required string is performed.<br>For example:<br>Homepage of Zabbix<br>Welcome.\*admin<br>*Note*: Referencing [regular expressions](regular_expressions) created in the Zabbix frontend is not supported in this field.<br>User macros and {HOST.\*} [macros](/manual/appendix/macros/supported_by_location) are supported.| |*Required status codes*|List of expected HTTP status codes. If Zabbix gets a code which is not in the list, the step will fail.<br>If empty, no check on status codes is performed.<br>For example: 200,201,210-299<br>User macros are supported.| ::: noteclassic Any changes in web scenario steps will only be saved when the whole scenario is saved. ::: See also a [real-life example](/manual/web_monitoring/example) of how web monitoring steps can be configured. #### Configuring tags The **Tags** tab allows to define scenario-level [tags](/manual/config/tagging). ![](../../assets/en/manual/config/scenario_c.png) Tagging allows to filter web scenarios and web monitoring [items](/manual/web_monitoring/items). #### تنظیم تگ ها The **Tags** tab allows to define scenario-level [tags](/manual/config/tagging). ![](../../assets/en/manual/config/scenario_c.png) Tagging allows to filter web scenarios and web monitoring [items](/manual/web_monitoring/items). ### Connection set up Zabbix supports two types of connect identifiers (connection methods): - Easy Connect - Net Service Name Connection configuration parameters for Zabbix server and Zabbix proxy can be set in the configuration files. Important parameters for the server and proxy are *DBHost*, *DBUser*, *DBName* and *DBPassword*. The same parameters are important for the frontend: *$DB\["SERVER"\]*, *$DB\["PORT"\]*, *$DB\["DATABASE"\]*, *$DB\["USER"\]*, *$DB\["PASSWORD"\]*. Zabbix uses the following connection string syntax: {DBUser/DBPassword[@<connect_identifier>]} <connect\_identifier> can be specified either in the form of "Net Service Name" or "Easy Connect". @[[//]Host[:Port]/<service_name> | <net_service_name>] ### اتصال راه اندازی شد Zabbix از دو نوع شناسه اتصال (روش های اتصال) پشتیبانی می کند: - اتصال آسان - نام سرویس Net پارامترهای پیکربندی اتصال برای سرور Zabbix و پراکسی Zabbix را می توان در فایل های پیکربندی تنظیم کرد. پارامترهای مهم برای سرور و پروکسی *DBHost*، *DBUser*، *DBName* و *DBPassword* هستند. این پارامترهای مشابهی برای فرانت اند مهم هستند: *$DB\["SERVER"\]*، *$DB\["PORT"\]*، *$DB\["DATABASE"\]*، *$DB\["USER"\]*، *$DB\["گذرواژه"\]*. Zabbix از نحو رشته اتصال زیر استفاده می کند: {DBUser/DBPassword[@<connect_identifier>]} <connect\_identifier> را می توان در قالب "Net نام سرویس" یا "Easy Connect". @[[//]میزبان[:Port]/<service_name> | <net_service_name>] #### Content conversion to UTF-8 HTTP agent items, web scenarios, web checks and JavaScript items have been improved to convert to UTF-8 from the character set specified in the HTTP header or HTTP meta tag. #### تبدیل محتوا به UTF-8 آیتم های عامل HTTP، سناریوهای وب، بررسی های وب و موارد جاوا اسکریپت برای تبدیل به UTF-8 از مجموعه کاراکترهای مشخص شده در هدر HTTP یا متا تگ HTTP بهبود یافته اند. #### Copy an LLD rule to multiple hosts Copy an LLD rule to two hosts. Request: ```json { "jsonrpc": "2.0", "method": "discoveryrule.copy", "params": { "discoveryids": [ "27426" ], "hostids": [ "10196", "10197" ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": true, "id": 1 } ``` #### کپی کردن یک قانون LLD در چندین هاست کپی کردن یک قانون LLD در چندین هاست . Request: ```json { "jsonrpc": "2.0", "method": "discoveryrule.copy", "params": { "discoveryids": [ "27426" ], "hostids": [ "10196", "10197" ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": true, "id": 1 } ``` ### Copyright notice Zabbix documentation is NOT distributed under a GPL license. Use of Zabbix documentation is subject to the following terms: You may create a printed copy of this documentation solely for your own personal use. Conversion to other formats is allowed as long as the actual content is not altered or edited in any way. You shall not publish or distribute this documentation in any form or on any media, except if you distribute the documentation in a manner similar to how Zabbix disseminates it (that is, electronically for download on a Zabbix web site) or on a USB or similar medium, provided however that the documentation is disseminated together with the software on the same medium. Any other use, such as any dissemination of printed copies or use of this documentation, in whole or in part, in another publication, requires the prior written consent from an authorized representative of Zabbix. Zabbix reserves any and all rights to this documentation not expressly granted above. ### اعلامیه کپی رایت اسناد Zabbix تحت مجوز GPL توزیع نمی شود. استفاده از اسناد Zabbix مشمول شرایط زیر است: شما می توانید یک نسخه چاپی از این اسناد را صرفاً برای استفاده شخصی خود تهیه نمایید. تبدیل به فرمت های دیگر تا جایی مجاز است که محتوای اصلی به هیچ وجه تغییر یا ویرایش نشده باشد. شما نباید این مستندات را به هیچ شکلی یا در هیچ رسانه ای منتشر یا توزیع کنید، مگر اینکه اسناد را به روشی مشابه به نحوه انتشار Zabbix (یعنی به صورت الکترونیکی برای دانلود در یک وب سایت Zabbix) یا در یک USB یا رسانه مشابه ارائه شده است، هرچند که مستندات همراه با نرم افزار منتشر شده باشند، توزیع کنید. هر گونه استفاده دیگر، مانند هر گونه انتشار نسخه چاپ شده یا استفاده از این سند، به طور کامل یا جزئی، در دیگر انتشارات، نیاز به رضایت کتبی قبلی از یک نماینده مجاز Zabbix دارد. Zabbix تمامی حقوق این مورد را برای خود محفوظ می دارد اسنادی که صریحاً در بالا ارائه نشده است. # correlation.create # ایجاد همبستگی # correlation.delete # correlation.delete #### Correlation filter condition The correlation filter condition object defines a specific condition that must be checked before running the correlation operations. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**type**<br>(required)|integer|Type of condition.<br><br>Possible values:<br>0 - old event tag;<br>1 - new event tag;<br>2 - new event host group;<br>3 - event tag pair;<br>4 - old event tag value;<br>5 - new event tag value.| |tag|string|Event tag (old or new). Required when type of condition is: 0, 1, 4, 5.| |groupid|string|Host group ID. Required when type of condition is: 2.| |oldtag|string|Old event tag. Required when type of condition is: 3.| |newtag|string|New event tag. Required when type of condition is: 3.| |value|string|Event tag (old or new) value. Required when type of condition is: 4, 5.| |formulaid|string|Arbitrary unique ID that is used to reference the condition from a custom expression. Can only contain capital-case letters. The ID must be defined by the user when modifying filter conditions, but will be generated anew when requesting them afterward.| |operator|integer|Condition operator.<br><br>Required when type of condition is: 2, 4, 5.| ::: notetip To better understand how to use filters with various types of expressions, see examples on the [correlation.get](get#retrieve_correlations) and [correlation.create](create#using_a_custom_expression_filter) method pages. ::: The following operators and values are supported for each condition type. |Condition|Condition name|Supported operators|Expected value| |---------|--------------|-------------------|--------------| |2|Host group|=, <>|Host group ID.| |4|Old event tag value|=, <>, like, not like|string| |5|New event tag value|=, <>, like, not like|string| #### شرایط فیلتر همبستگی آبجکت شرط فیلتر همبستگی یک شرایط خاص را تعریف می کند که باید قبل از اجرای عملیات همبستگی بررسی شود. |مخصوص|[نوع](/manual/api/reference_commentary#data_types)|توضیحات| |--|--|------| |**نوع**<br>(الزامی)|عدد صحیح|نوع شرط.<br><br>مقادیر ممکن:<br>0 - برچسب رویداد قدیمی؛<br>1 - برچسب رویداد جدید؛<br>2 - گروه میزبان رویداد جدید؛<br>3 - جفت تگ رویداد؛<br>4 - مقدار برچسب رویداد قدیمی؛<br>5 - مقدار برچسب رویداد جدید.| |tag|string|برچسب رویداد (قدیمی یا جدید). زمانی لازم است که نوع شرط باشد: 0، 1، 4، 5.| |groupid|string|شناسه گروه میزبان. زمانی لازم است که نوع شرط: 2.| |oldtag|string|برچسب رویداد قدیمی. زمانی لازم است که نوع شرط: 3.| |newtag|string|برچسب رویداد قدیمی. زمانی لازم است که نوع شرط: 3.| |value|string|مقدار تگ رویداد (قدیمی یا جدید). زمانی لازم است که نوع شرط باشد: 4، 5.| |formulaid|string|شناسه منحصربه‌فرد دلخواه که برای ارجاع شرط از یک عبارت سفارشی استفاده می‌شود. فقط می تواند شامل حروف بزرگ باشد. شناسه باید هنگام تغییر شرایط فیلتر توسط کاربر تعریف شود، اما پس از درخواست مجدداً ایجاد می شود. |عملگر|عدد صحیح|عملگر شرط.<br><br>زمانی که نوع شرط است: 2، 4، 5.| ::: یادداشت برای درک بهتر نحوه استفاده از فیلترها با انواع مختلف انواع عبارات، نمونه هایی را در مورد مشاهده کنید [correlation.get](get#retrieve_correlations) و روش [correlation.create](create#using_a_custom_expression_filter) صفحات ::: عملگرها و مقادیر زیر برای هر شرط پشتیبانی می شوند نوع |شرط|نام شرط|اپراتورهای پشتیبانی شده|مقدار مورد انتظار| |---------|-------------|------------------|---- ----------| |2|گروه میزبان|=، <>|شناسه گروه میزبان.| |4|مقدار تگ رویداد قدیمی|=، <>، مانند، نه مانند|رشته| |5|مقدار تگ رویداد جدید|=، <>، مانند، نه مانند|رشته| ### Correlation filter The correlation filter object defines a set of conditions that must be met to perform the configured correlation operations. It has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**evaltype**<br>(required)|integer|Filter condition evaluation method.<br><br>Possible values:<br>0 - and/or;<br>1 - and;<br>2 - or;<br>3 - custom expression.| |**conditions**<br>(required)|array|Set of filter conditions to use for filtering results.| |eval\_formula|string|*(readonly)* Generated expression that will be used for evaluating filter conditions. The expression contains IDs that reference specific filter conditions by its `formulaid`. The value of `eval_formula` is equal to the value of `formula` for filters with a custom expression.| |formula|string|User-defined expression to be used for evaluating conditions of filters with a custom expression. The expression must contain IDs that reference specific filter conditions by its `formulaid`. The IDs used in the expression must exactly match the ones defined in the filter conditions: no condition can remain unused or omitted.<br><br>Required for custom expression filters.| ### فیلتر همبستگی شی فیلتر همبستگی مجموعه ای از شرایط را تعریف می کند که باید باشد برای انجام عملیات همبستگی پیکربندی شده ملاقات کرد. آن را دارد خواص زیر |مخصوص|[نوع](/manual/api/reference_commentary#data_types)|توضیحات| |--|--|------| |**evaltype**<br>(الزامی)|عدد صحیح|روش ارزیابی شرایط فیلتر.<br><br>مقادیر ممکن:<br>0 - و/یا;<br>1 - و;<br>2 - یا;<br>3 - عبارت سفارشی.| |**شرایط**<br>(ضروری)|آرایه|مجموعه شرایط فیلتر برای استفاده برای فیلتر کردن نتایج.| |eval\_formula|string|*(readonly)* عبارت ایجاد شده است که برای ارزیابی شرایط فیلتر استفاده خواهد شد. عبارت حاوی شناسه هایی است که به شرایط فیلتر خاص توسط «formulaid» خود ارجاع می دهند. مقدار 'eval_formula' برابر با مقدار 'formula' برای فیلترهایی با عبارت سفارشی است.| |formula|string|عبارت تعریف شده توسط کاربر برای ارزیابی شرایط فیلترها با عبارت سفارشی استفاده می شود. عبارت باید حاوی شناسه هایی باشد که با «formulaid» خود به شرایط فیلتر خاص ارجاع می دهند. شناسه های استفاده شده در عبارت باید دقیقاً مطابق با موارد تعریف شده در شرایط فیلتر باشد: هیچ شرطی نمی تواند بدون استفاده یا حذف شود.<br><br>برای فیلترهای عبارت سفارشی مورد نیاز است.| # correlation.get # correlation.get ### Correlation operation The correlation operation object defines an operation that will be performed when a correlation is executed. It has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**type**<br>(required)|integer|Type of operation.<br><br>Possible values:<br>0 - close old events;<br>1 - close new event.| ### عملیات همبستگی شی عملیات همبستگی عملیاتی را تعریف می کند که خواهد بود هنگامی که یک همبستگی اجرا می شود انجام می شود. موارد زیر را دارد خواص |مخصوص|[نوع](/manual/api/reference_commentary#data_types)|توضیحات| |--|--|------| |**نوع**<br>(الزامی)|عدد صحیح|نوع عملیات.<br><br>مقادیر ممکن:<br>0 - بستن رویدادهای قدیمی؛<br>1 - بستن رویداد جدید.| ### Correlation The correlation object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |correlationid|string|*(readonly)* ID of the correlation.| |**name**<br>(required)|string|Name of the correlation.| |description|string|Description of the correlation.| |status|integer|Whether the correlation is enabled or disabled.<br><br>Possible values are:<br>0 - *(default)* enabled;<br>1 - disabled.| Note that for some methods (update, delete) the required/optional parameter combination is different. ### همبستگی شی همبستگی دارای ویژگی های زیر است. |مخصوص|[نوع](/manual/api/reference_commentary#data_types)|توضیحات| |--|--|------| |correlationid|رشته|*(فقط خواندنی)* شناسه همبستگی.| |**نام**<br>(ضروری)|رشته|نام همبستگی.| |توضیح|رشته|توضیحات همبستگی.| |وضعیت|عدد صحیح|اینکه همبستگی فعال یا غیرفعال باشد.<br><br>مقادیر ممکن عبارتند از:<br>0 - *(پیش‌فرض)* فعال؛<br>1 - غیرفعال است.| توجه داشته باشید که برای برخی از روش ها (به روز رسانی، حذف) ترکیب پارامترهای مورد نیاز/اختیاری متفاوت است. # correlation.update # correlation.update ### Cosmos DB monitoring The template *Azure by HTTP* now also works with Azure Cosmos DB for MongoDB. You can get this template: - In *Configuration → Templates* in new installations. - If you are upgrading from previous versions, you can download this template from Zabbix [Git repository](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/azure_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) or find it in the *zabbix/templates* directory of the downloaded latest Zabbix version. Then, while in *Configuration → Templates* you can import it manually into Zabbix. ### نظارت بر DB Cosmos الگوی *Azure توسط HTTP* اکنون با Azure Cosmos DB برای MongoDB نیز کار می کند. شما می توانید این قالب را دریافت کنید: - در *پیکربندی → الگوها* در نصب های جدید. - اگر از نسخه های قبلی ارتقا می دهید، می توانید این الگو را از Zabbix [مخزن Git] (https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/azure_http/README.md) دانلود کنید. ?at=refs%2Fheads%2Frelease%2F6.0) یا آن را در فهرست *zabbix/templates* آخرین نسخه دانلود شده Zabbix پیدا کنید. سپس، در حالی که در *پیکربندی → الگوها* هستید، می توانید آن را به صورت دستی در Zabbix وارد کنید. #### Create a custom script Create a custom script that will reboot a server. The script will require write access to the host and will display a configuration message before running in the frontend. Request: ```json { "jsonrpc": "2.0", "method": "script.create", "params": { "name": "Reboot server", "command": "reboot server 1", "confirmation": "Are you sure you would like to reboot the server?", "scope": 2, "type": 0 }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "scriptids": [ "4" ] }, "id": 1 } ``` #### ساخت اسکریپت سفارشی یک اسکریپت سفارشی ایجاد کنید که سرور را مجدد راه اندازی کند. این اسکریپت نیاز به دسترسی نوشتن به هاست دارد و پیام پیکربندی را قبل ازاجرا در وب نمایش می دهد Request: ```json { "jsonrpc": "2.0", "method": "script.create", "params": { "name": "Reboot server", "command": "reboot server 1", "confirmation": "Are you sure you would like to reboot the server?", "scope": 2, "type": 0 }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "scriptids": [ "4" ] }, "id": 1 } ``` #### Create a discovery action Create an action that will link discovered hosts to template "10091". Request: ```json { "jsonrpc": "2.0", "method": "action.create", "params": { "name": "Discovery action", "eventsource": 1, "status": 0, "filter": { "evaltype": 0, "conditions": [ { "conditiontype": 21, "operator": 0, "value": "1" }, { "conditiontype": 10, "operator": 0, "value": "2" } ] }, "operations": [ { "operationtype": 6, "optemplate": [ { "templateid": "10091" } ] } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "actionids": [ "18" ] }, "id": 1 } ``` #### ساخت اکشن جست وجو اقدامی ایجاد کنید که میزبان های کشف شده را به الگوی "10091" پیوند دهد. درخواست: ``json { "jsonrpc": "2.0"، "روش": "اقدام. ایجاد"، "params": { "name": "اقدام کشف"، "منبع رویداد": 1، "وضعیت": 0، "فیلتر": { "evaltype": 0، "شرایط": [ { "شرایط نوع": 21، "اپراتور": 0، "ارزش": "1" }، { "شرایط نوع": 10، "اپراتور": 0، "ارزش": "2" } ] }، "عملیات": [ { "نوع عملیات": 6، "نمونه": [ { "templateid": "10091" } ] } ] }، "auth": "038e1d7b1735c6a5436ee9eae095879e"، "id": 1 } ``` واکنش: ``json { "jsonrpc": "2.0"، "نتیجه": { "actionids": [ "18" ] }، "id": 1 } ``` #### Create a discovery rule Create a discovery rule to find machines running the Zabbix agent in the local network. The rule must use a single Zabbix agent check on port 10050. Request: ```json { "jsonrpc": "2.0", "method": "drule.create", "params": { "name": "Zabbix agent discovery", "iprange": "192.168.1.1-255", "dchecks": [ { "type": "9", "key_": "system.uname", "ports": "10050", "uniq": "0" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "druleids": [ "6" ] }, "id": 1 } ``` #### Create a discovery rule Create a discovery rule to find machines running the Zabbix agent in the local network. The rule must use a single Zabbix agent check on port 10050. Request: ```json { "jsonrpc": "2.0", "method": "drule.create", "params": { "name": "Zabbix agent discovery", "iprange": "192.168.1.1-255", "dchecks": [ { "type": "9", "key_": "system.uname", "ports": "10050", "uniq": "0" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "druleids": [ "6" ] }, "id": 1 } ``` #### Create agent autoregistration rule Add a host to host group "Linux servers" when host name contains "SRV" or metadata contains "AlmaLinux". Request: ```json { "jsonrpc": "2.0", "method": "action.create", "params": { "name": "Register Linux servers", "eventsource": "2", "status": "0", "filter": { "evaltype": "2", "conditions": [ { "conditiontype": "22", "operator": "2", "value": "SRV" }, { "conditiontype": "24", "operator": "2", "value": "AlmaLinux" } ] }, "operations": [ { "operationtype": "4", "opgroup": [ { "groupid": "2" } ] } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "actionids": [ 19 ] }, "id": 1 } ``` #### ساخت قانون ثبت خودکار ایجنت وقتی نام میزبان حاوی "SRV" یا متادیتا حاوی "AlmaLinux" باشد یک میزبان به گروه میزبان "سرورهای لینوکس" اضافه کنید. درخواست: ``json { "jsonrpc": "2.0"، "روش": "اقدام. ایجاد"، "params": { "name": "ثبت سرورهای لینوکس"، "منبع رویداد": "2"، "وضعیت": "0"، "فیلتر": { "evaltype": "2"، "شرایط": [ { "conditiontype": "22"، "اپراتور": "2"، "value": "SRV" }، { "conditiontype": "24"، "اپراتور": "2"، "value": "AlmaLinux" } ] }، "عملیات": [ { "نوع عملیات": "4"، "opgroup": [ { "گروهی": "2" } ] } ] }، "auth": "038e1d7b1735c6a5436ee9eae095879e"، "id": 1 } ``` واکنش: ``json { "jsonrpc": "2.0"، "نتیجه": { "actionids": [ 19 ] }، "id": 1 } ``` #### Create a host map Create a map with two host elements and a link between them. Note the use of temporary "selementid1" and "selementid2" values in the map link object to refer to map elements. Request: ```json { "jsonrpc": "2.0", "method": "map.create", "params": { "name": "Host map", "width": 600, "height": 600, "selements": [ { "selementid": "1", "elements": [ {"hostid": "1033"} ], "elementtype": 0, "iconid_off": "2" }, { "selementid": "2", "elements": [ {"hostid": "1037"} ], "elementtype": 0, "iconid_off": "2" } ], "links": [ { "selementid1": "1", "selementid2": "2" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "sysmapids": [ "9" ] }, "id": 1 } ``` #### یک نقشه میزبان ایجاد کنید یک نقشه با دو عنصر میزبان و یک پیوند بین آنها ایجاد کنید. توجه داشته باشید که استفاده از مقادیر موقت "selementid1" و "selementid2" در پیوند نقشه شی برای اشاره به عناصر نقشه. درخواست: ``json { "jsonrpc": "2.0"، "روش": "map.create"، "params": { "name": "نقشه میزبان"، "عرض": 600، "ارتفاع": 600، "عنصر": [ { "selementid": "1"، "عناصر": [ {"hostid": "1033"} ]، "نوع عنصر": 0، "iconid_off": "2" }، { "selementid": "2"، "عناصر": [ {"hostid": "1037"} ]، "نوع عنصر": 0، "iconid_off": "2" } ]، "پیوندها": [ { "selementid1": "1"، "selementid2": "2" } ] }، "auth": "038e1d7b1735c6a5436ee9eae095879e"، "id": 1 } ``` واکنش: ``json { "jsonrpc": "2.0"، "نتیجه": { "sysmapids": [ "9" ] }، "id": 1 } ``` #### Create an active proxy Create an action proxy "Active proxy" and assign a host to be monitored by it. Request: ```json { "jsonrpc": "2.0", "method": "proxy.create", "params": { "host": "Active proxy", "status": "5", "hosts": [ { "hostid": "10279" } ] }, "auth": "ab9638041ec6922cb14b07982b268f47", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "proxyids": [ "10280" ] }, "id": 1 } ``` #### حذف لینک تمپلیت ها Unlink and clear two templates from host. Request: ```json { "jsonrpc": "2.0", "method": "host.update", "params": { "hostid": "10126", "templates_clear": [ { "templateid": "10124" }, { "templateid": "10125" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "hostids": [ "10126" ] }, "id": 1 } ``` #### Create an empty map Create a map with no elements. Request: ```json { "jsonrpc": "2.0", "method": "map.create", "params": { "name": "Map", "width": 600, "height": 600 }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "sysmapids": [ "8" ] }, "id": 1 } ``` #### تغییر نام آیکون نقشه یک آیکون نقشه را به "آیکون سیستم عامل" تغییر نام دهید. درخواست: ``json { "jsonrpc": "2.0"، "method": "iconmap.update"، "params": { "iconmapid": "1"، "name": "OS icons" }، "auth": "038e1d7b1735c6a5436ee9eae095879e"، "id": 1 } ``` پاسخ: ``json { "jsonrpc": "2.0"، "result": { "iconmapids": [ "1" ] }، "id": 1 } ``` #### Create a new event tag correlation Create a correlation using evaluation method `AND/OR` with one condition and one operation. By default the correlation will be enabled. Request: ```json { "jsonrpc": "2.0", "method": "correlation.create", "params": { "name": "new event tag correlation", "filter": { "evaltype": 0, "conditions": [ { "type": 1, "tag": "ok" } ] }, "operations": [ { "type": 0 } ] }, "auth": "343baad4f88b4106b9b5961e77437688", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "correlationids": [ "1" ] }, "id": 1 } ``` #### یک همبستگی تگ رویداد جدید ایجاد کنید یک همبستگی با استفاده از روش ارزیابی «AND/OR» با یک شرط ایجاد کنید و یک عملیات به طور پیش فرض همبستگی فعال خواهد شد. درخواست: ``json { "jsonrpc": "2.0"، "روش": "همبستگی.ایجاد"، "params": { "name": "همبستگی برچسب رویداد جدید"، "فیلتر": { "evaltype": 0، "شرایط": [ { "نوع": 1، "برچسب": "باشه" } ] }، "عملیات": [ { "نوع": 0 } ] }، "auth": "343baad4f88b4106b9b5961e77437688"، "id": 1 } ``` واکنش: ``json { "jsonrpc": "2.0"، "نتیجه": { "همبستگی ها": [ "1" ] }، "id": 1 } ``` #### Create a new interface Create a secondary IP agent interface on host "30052." Request: ```json { "jsonrpc": "2.0", "method": "hostinterface.create", "params": { "hostid": "30052", "main": "0", "type": "1", "useip": "1", "ip": "127.0.0.1", "dns": "", "port": "10050", }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "interfaceids": [ "30062" ] }, "id": 1 } ``` #### ساخت اینترفیس جدید Create a secondary IP agent interface on host "30052." Request: ```json { "jsonrpc": "2.0", "method": "hostinterface.create", "params": { "hostid": "30052", "main": "0", "type": "1", "useip": "1", "ip": "127.0.0.1", "dns": "", "port": "10050", }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "interfaceids": [ "30062" ] }, "id": 1 } ``` #### Create an icon map Create an icon map to display hosts of different types. Request: ```json { "jsonrpc": "2.0", "method": "iconmap.create", "params": { "name": "Type icons", "default_iconid": "2", "mappings": [ { "inventory_link": 1, "expression": "server", "iconid": "3" }, { "inventory_link": 1, "expression": "switch", "iconid": "4" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "iconmapids": [ "2" ] }, "id": 1 } ``` ####ساخت Icon map Create an icon map to display hosts of different types. Request: ```json { "jsonrpc": "2.0", "method": "iconmap.create", "params": { "name": "Type icons", "default_iconid": "2", "mappings": [ { "inventory_link": 1, "expression": "server", "iconid": "3" }, { "inventory_link": 1, "expression": "switch", "iconid": "4" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "iconmapids": [ "2" ] }, "id": 1 } ``` #### Create an image Create a cloud icon. Request: ```json { "jsonrpc": "2.0", "method": "image.create", "params": { "imagetype": 1, "name": "Cloud_(24)", "image": "iVBORw0KGgoAAAANSUhEUgAAABgAAAANCAYAAACzbK7QAAAABHNCSVQICAgIfAhkiAAAAAlwSFlzAAACmAAAApgBNtNH3wAAABl0RVh0U29mdHdhcmUAd3d3Lmlua3NjYXBlLm9yZ5vuPBoAAAIcSURBVDjLrZLbSxRRHMdPKiEiRQ89CD0s+N5j9BIMEf4Hg/jWexD2ZEXQbC9tWUFZimtLhswuZiVujK1UJmYXW9PaCUdtb83enL3P7s6ss5f5dc7EUsmqkPuFH3M4/Ob7+V0OAgC0UyDENFEU03rh1uNOs/lFG75o2i2/rkd9Y3Tgyj3HiaezbukdH9A/rP4E9vWi0u+Y4fuGnMf3DRgYc3Z/84YrQSkD3mgKhFAC+KAEK74Y2Lj3MjPoOokQ3Xyx/1GHeXCifbfO6lRPH/wi+AvZQhGSsgKxdB5CCRkCGPbDgMXBMbukTc4vK5/WRHizsq7fZl2LFuvE4T0BZDTXHtgv4TNUqlUolsqQL2qQwbDEXzBBTIJ7I4y/cfAENmHZF4XrY9Mc+X9HAFmoyXS2ddy1IOg6/KNyBcM0DFP/wFZFCcOy4N9Mw0YkCTOfhdL5AfZQXQBFn2t/ODXHC8FYVcoWjNEQ03qqwTJ5FdI44jg/msoB2Zd5ZKq3q6evA1FUS60bYyyj3AJf3V72HiLZJQxTtRLk1C2IYEg4mTNg63hPd1mOJd7Ict911OMNlWEf0nFxpCt16zcshTuLpGSwDDuPIfv0xzNyQYVGicC0cgUUDLM6Xp02lvvW/V2EBssnxlSGmWsxljw0znV9XfPLjTCW84r+cn7Jc8c2eWrbM6Wbe6/aTJbhJ/TNkWc9/xXW592Xb9iPkKnUfH8BKdLgFy0lDyQAAAAASUVORK5CYII=" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "imageids": [ "188" ] }, "id": 1 } ``` #### ساخت ایمیج Create a cloud icon. Request: ```json { "jsonrpc": "2.0", "method": "image.create", "params": { "imagetype": 1, "name": "Cloud_(24)", "image": "iVBORw0KGgoAAAANSUhEUgAAABgAAAANCAYAAACzbK7QAAAABHNCSVQICAgIfAhkiAAAAAlwSFlzAAACmAAAApgBNtNH3wAAABl0RVh0U29mdHdhcmUAd3d3Lmlua3NjYXBlLm9yZ5vuPBoAAAIcSURBVDjLrZLbSxRRHMdPKiEiRQ89CD0s+N5j9BIMEf4Hg/jWexD2ZEXQbC9tWUFZimtLhswuZiVujK1UJmYXW9PaCUdtb83enL3P7s6ss5f5dc7EUsmqkPuFH3M4/Ob7+V0OAgC0UyDENFEU03rh1uNOs/lFG75o2i2/rkd9Y3Tgyj3HiaezbukdH9A/rP4E9vWi0u+Y4fuGnMf3DRgYc3Z/84YrQSkD3mgKhFAC+KAEK74Y2Lj3MjPoOokQ3Xyx/1GHeXCifbfO6lRPH/wi+AvZQhGSsgKxdB5CCRkCGPbDgMXBMbukTc4vK5/WRHizsq7fZl2LFuvE4T0BZDTXHtgv4TNUqlUolsqQL2qQwbDEXzBBTIJ7I4y/cfAENmHZF4XrY9Mc+X9HAFmoyXS2ddy1IOg6/KNyBcM0DFP/wFZFCcOy4N9Mw0YkCTOfhdL5AfZQXQBFn2t/ODXHC8FYVcoWjNEQ03qqwTJ5FdI44jg/msoB2Zd5ZKq3q6evA1FUS60bYyyj3AJf3V72HiLZJQxTtRLk1C2IYEg4mTNg63hPd1mOJd7Ict911OMNlWEf0nFxpCt16zcshTuLpGSwDDuPIfv0xzNyQYVGicC0cgUUDLM6Xp02lvvW/V2EBssnxlSGmWsxljw0znV9XfPLjTCW84r+cn7Jc8c2eWrbM6Wbe6/aTJbhJ/TNkWc9/xXW592Xb9iPkKnUfH8BKdLgFy0lDyQAAAAASUVORK5CYII=" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "imageids": [ "188" ] }, "id": 1 } ``` #### Create an interface with SNMP details Request: ```json { "jsonrpc": "2.0", "method": "hostinterface.create", "params": { "hostid": "10456", "main": "0", "type": "2", "useip": "1", "ip": "127.0.0.1", "dns": "", "port": "1601", "details": { "version": "2", "bulk": "1", "community": "{$SNMP_COMMUNITY}" } }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "interfaceids": [ "30063" ] }, "id": 1 } ``` #### ساخت اینترفیس با جزییات snmp Request: ```json { "jsonrpc": "2.0", "method": "hostinterface.create", "params": { "hostid": "10456", "main": "0", "type": "2", "useip": "1", "ip": "127.0.0.1", "dns": "", "port": "1601", "details": { "version": "2", "bulk": "1", "community": "{$SNMP_COMMUNITY}" } }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "interfaceids": [ "30063" ] }, "id": 1 } ``` #### Create a passive proxy Create a passive proxy "Passive proxy" and assign two hosts to be monitored by it. Request: ```json { "jsonrpc": "2.0", "method": "proxy.create", "params": { "host": "Passive proxy", "status": "6", "interface": { "ip": "127.0.0.1", "dns": "", "useip": "1", "port": "10051" }, "hosts": [ { "hostid": "10192" }, { "hostid": "10139" } ] }, "auth": "ab9638041ec6922cb14b07982b268f47", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "proxyids": [ "10284" ] }, "id": 1 } ``` #### حذف لینک تمپلیت ها Unlink and clear two templates from host. Request: ```json { "jsonrpc": "2.0", "method": "host.update", "params": { "hostid": "10126", "templates_clear": [ { "templateid": "10124" }, { "templateid": "10125" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "hostids": [ "10126" ] }, "id": 1 } ``` #### Create a SSH script Create a SSH script with public key authentication that can be executed on a host and has a context menu. Request: ```json { "jsonrpc": "2.0", "method": "script.create", "params": { "name": "SSH script", "command": "my script command", "type": 2, "username": "John", "publickey": "pub.key", "privatekey": "priv.key", "password": "secret", "port": "12345", "scope": 2, "menu_path": "All scripts/SSH", "usrgrpid": "7", "groupid": "4" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "scriptids": [ "5" ] }, "id": 1 } ``` #### یک اسکریپت SSH ایجاد کنید یک اسکریپت SSH با احراز هویت کلید عمومی ایجاد کنید که قابل اجرا در هاست باشد و دارای منوی محتوا است. Request: ```json { "jsonrpc": "2.0", "method": "script.create", "params": { "name": "SSH script", "command": "my script command", "type": 2, "username": "John", "publickey": "pub.key", "privatekey": "priv.key", "password": "secret", "port": "12345", "scope": 2, "menu_path": "All scripts/SSH", "usrgrpid": "7", "groupid": "4" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "scriptids": [ "5" ] }, "id": 1 } ``` #### Create a trigger action Create an action that will be run when a trigger from host "10084" that has the word "memory" in its name goes into problem state. The action must first send a message to all users in user group "7". If the event is not resolved in 4 minutes, it will run script "3" on all hosts in group "2". On trigger recovery it will notify all users who received any messages regarding the problem before. On trigger update, message with custom subject and body will be sent to all who left acknowledgments and comments via all media types. Request: ```json { "jsonrpc": "2.0", "method": "action.create", "params": { "name": "Trigger action", "eventsource": 0, "status": 0, "esc_period": "2m", "filter": { "evaltype": 0, "conditions": [ { "conditiontype": 1, "operator": 0, "value": "10084" }, { "conditiontype": 3, "operator": 2, "value": "memory" } ] }, "operations": [ { "operationtype": 0, "esc_period": "0s", "esc_step_from": 1, "esc_step_to": 2, "evaltype": 0, "opmessage_grp": [ { "usrgrpid": "7" } ], "opmessage": { "default_msg": 1, "mediatypeid": "1" } }, { "operationtype": 1, "esc_step_from": 3, "esc_step_to": 4, "evaltype": 0, "opconditions": [ { "conditiontype": 14, "operator": 0, "value": "0" } ], "opcommand_grp": [ { "groupid": "2" } ], "opcommand": { "scriptid": "3" } } ], "recovery_operations": [ { "operationtype": "11", "opmessage": { "default_msg": 1 } } ], "update_operations": [ { "operationtype": "12", "opmessage": { "default_msg": 0, "message": "Custom update operation message body", "subject": "Custom update operation message subject" } } ], "pause_suppressed": "0", "notify_if_canceled": "0" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "actionids": [ "17" ] }, "id": 1 } ``` #### ساخت تریگر یک عمل ایجاد کنید که زمانی که یک ماشه از میزبان "10084" اجرا می شود کلمه "حافظه" را در نام خود دارد به حالت مشکل می رود. عمل ابتدا باید برای همه کاربران گروه کاربری "7" پیام ارسال کند. اگر رویداد در 4 دقیقه حل نمی شود، اسکریپت "3" را در همه میزبان ها اجرا می کند گروه "2". در بازیابی ماشه به همه کاربرانی که هر کدام را دریافت کرده‌اند اطلاع می‌دهد پیام های مربوط به مشکل قبلی در به‌روزرسانی ماشه، پیام با موضوع و بدنه سفارشی برای همه کسانی که تقدیرنامه و نظرات از طریق انواع رسانه ها درخواست: ``json { "jsonrpc": "2.0"، "روش": "اقدام. ایجاد"، "params": { "name": "عمل ماشه"، "منبع رویداد": 0، "وضعیت": 0، "esc_period": "2m"، "فیلتر": { "evaltype": 0، "شرایط": [ { "شرایط نوع": 1، "اپراتور": 0، "value": "10084" }، { "شرایط نوع": 3، "اپراتور": 2، "ارزش": "حافظه" } ] }، "عملیات": [ { "نوع عملیات": 0، "esc_period": "0s"، "esc_step_from": 1، "esc_step_to": 2، "evaltype": 0، "opmessage_grp": [ { "usrgrpid": "7" } ]، "opmessage": { "default_msg": 1، "mediatypeid": "1" } }، { "نوع عملیات": 1، "esc_step_from": 3، "esc_step_to": 4، "evaltype": 0، "شرایط": [ { "شرایط نوع": 14، "اپراتور": 0، "ارزش": "0" } ]، "opcommand_grp": [ { "گروهی": "2" } ]، "opcommand": { "scriptid": "3" } } ]، "بازیابی_عملیات": [ { "نوع عملیات": "11"، "opmessage": { "default_msg": 1 } } ]، "update_operations": [ { "نوع عملیات": "12"، "opmessage": { "default_msg": 0، "پیام": "بدنه پیام عملیات به روز رسانی سفارشی"، "موضوع": "موضوع پیام عملیات به روز رسانی سفارشی" } } ]، "pause_suppressed": "0"، "notify_if_cancelled": "0" }، "auth": "038e1d7b1735c6a5436ee9eae095879e"، "id": 1 } ``` واکنش: ``json { "jsonrpc": "2.0"، "نتیجه": { "actionids": [ "17" ] }، "id": 1 } ``` #### Create a trigger map Create a map with trigger element, which contains two triggers. Request: ```json { "jsonrpc": "2.0", "method": "map.create", "params": { "name": "Trigger map", "width": 600, "height": 600, "selements": [ { "elements": [ {"triggerid": "12345"}, {"triggerid": "67890"} ], "elementtype": 2, "iconid_off": "2" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "sysmapids": [ "10" ] }, "id": 1 } ``` #### ساخت گراف Create a graph with two items. Request: ```json { "jsonrpc": "2.0", "method": "graph.create", "params": { "name": "MySQL bandwidth", "width": 900, "height": 200, "gitems": [ { "itemid": "22828", "color": "00AA00" }, { "itemid": "22829", "color": "3333FF" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "graphids": [ "652" ] }, "id": 1 } ``` #### Create a webhook script Create a webhook script that sends HTTP request to external service. Request: ```json { "jsonrpc": "2.0", "method": "script.create", "params": { "name": "Webhook script", "command": "try {\n var request = new HttpRequest(),\n response,\n data;\n\n request.addHeader('Content-Type: application/json');\n\n response = request.post('https://localhost/post', value);\n\n try {\n response = JSON.parse(response);\n }\n catch (error) {\n response = null;\n }\n\n if (request.getStatus() !== 200 || !('data' in response)) {\n throw 'Unexpected response.';\n }\n\n data = JSON.stringify(response.data);\n\n Zabbix.Log(3, '[Webhook Script] response data: ' + data);\n\n return data;\n}\ncatch (error) {\n Zabbix.Log(3, '[Webhook Script] script execution failed: ' + error);\n throw 'Execution failed: ' + error + '.';\n}", "type": 5, "timeout": "40s", "parameters": [ { "name": "token", "value": "{$WEBHOOK.TOKEN}" }, { "name": "host", "value": "{HOST.HOST}" }, { "name": "v", "value": "2.2" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "scriptids": [ "3" ] }, "id": 1 } ``` #### یک اسکریپت webhook ایجاد کنید یک اسکریپت webhook ایجاد کنید که درخواست HTTP را به سرویس خارجی ارسال کند. Request: ```json { "jsonrpc": "2.0", "method": "script.create", "params": { "name": "Webhook script", "command": "try {\n var request = new HttpRequest(),\n response,\n data;\n\n request.addHeader('Content-Type: application/json');\n\n response = request.post('https://localhost/post', value);\n\n try {\n response = JSON.parse(response);\n }\n catch (error) {\n response = null;\n }\n\n if (request.getStatus() !== 200 || !('data' in response)) {\n throw 'Unexpected response.';\n }\n\n data = JSON.stringify(response.data);\n\n Zabbix.Log(3, '[Webhook Script] response data: ' + data);\n\n return data;\n}\ncatch (error) {\n Zabbix.Log(3, '[Webhook Script] script execution failed: ' + error);\n throw 'Execution failed: ' + error + '.';\n}", "type": 5, "timeout": "40s", "parameters": [ { "name": "token", "value": "{$WEBHOOK.TOKEN}" }, { "name": "host", "value": "{HOST.HOST}" }, { "name": "v", "value": "2.2" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "scriptids": [ "3" ] }, "id": 1 } ``` #### Create HTTP agent item Create POST request method item with JSON response preprocessing. Request: ```json { "jsonrpc": "2.0", "method": "item.create", "params": { "url": "http://127.0.0.1/http.php", "query_fields": [ { "mode": "json" }, { "min": "10" }, { "max": "100" } ], "interfaceid": "1", "type": 19, "hostid": "10254", "delay": "5s", "key_": "json", "name": "HTTP agent example JSON", "value_type": 0, "output_format": 1, "preprocessing": [ { "type": 12, "params": "$.random", "error_handler": 0, "error_handler_params": "" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 2 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "23865" ] }, "id": 3 } ``` #### ساخت قانون LLD به همراه preprocessing Request: ```json { "jsonrpc": "2.0", "method": "discoveryrule.create", "params": { "name": "Discovery rule with preprocessing", "key_": "lld.with.preprocessing", "hostid": "10001", "ruleid": "27665", "type": 0, "value_type": 3, "delay": "60s", "interfaceid": "1155", "preprocessing": [ { "type": 20, "params": "20", "error_handler": 0, "error_handler_params": "" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "44211" ] }, "id": 1 } ``` #### Create HTTP agent item prototype Create item prototype with URL using user macro, query fields and custom headers. Request: ```json { "jsonrpc": "2.0", "method": "itemprototype.create", "params": { "type": "19", "hostid": "10254", "ruleid": "28256", "interfaceid": "2", "name": "api item prototype example", "key_": "api_http_item", "value_type": 3, "url": "{$URL_PROTOTYPE}", "query_fields": [ { "min": "10" }, { "max": "100" } ], "headers": { "X-Source": "api" }, "delay": "35" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "28305" ] }, "id": 1 } ``` #### استفاده از هدر ها و کوئری های شخصی سازی شذه Create LLD rule with custom query fields and headers. Request: ```json { "jsonrpc": "2.0", "method": "discoveryrule.create", "params": { "hostid": "10257", "interfaceid": "5", "type": 19, "name": "API HTTP agent", "key_": "api_discovery_rule", "value_type": 3, "delay": "5s", "url": "http://127.0.0.1?discoverer.php", "query_fields": [ { "mode": "json" }, { "elements": "2" } ], "headers": { "X-Type": "api", "Authorization": "Bearer mF_A.B5f-2.1JcM" }, "allow_traps": 1, "trapper_hosts": "127.0.0.1" }, "auth": "d678e0b85688ce578ff061bd29a20d3b", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "28336" ] }, "id": 1 } ``` #### Create script item Create a simple data collection using a script item. Request: ```json { "jsonrpc": "2.0", "method": "item.create", "params": { "name": "Script example", "key_": "custom.script.item", "hostid": "12345", "type": 21, "value_type": 4, "params": "var request = new CurlHttpRequest();\nreturn request.Post(\"https://postman-echo.com/post\", JSON.parse(value));", "parameters": [ { "name": "host", "value": "{HOST.CONN}" } ], "timeout": "6s", "delay": "30s" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 2 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "23865" ] }, "id": 3 } ``` #### ساخت اسکریپت قوانین LLD Create a simple data collection using a script LLD rule. Request: ```json { "jsonrpc": "2.0", "method": "discoveryrule.create", "params": { "name": "Script example", "key_": "custom.script.lldrule", "hostid": "12345", "type": 21, "value_type": 4, "params": "var request = new CurlHttpRequest();\nreturn request.Post(\"https://postman-echo.com/post\", JSON.parse(value));", "parameters": [ { "name": "host", "value": "{HOST.CONN}" } ], "timeout": "6s", "delay": "30s" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 2 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "23865" ] }, "id": 3 } ``` #### Create script item prototype Create a simple data collection using a script item prototype. Request: ```json { "jsonrpc": "2.0", "method": "itemprototype.create", "params": { "name": "Script example", "key_": "custom.script.itemprototype", "hostid": "12345", "type": 21, "value_type": 4, "params": "var request = new CurlHttpRequest();\nreturn request.Post(\"https://postman-echo.com/post\", JSON.parse(value));", "parameters": [ { "name": "host", "value": "{HOST.CONN}" } ], "timeout": "6s", "delay": "30s" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 2 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "23865" ] }, "id": 3 } ``` #### ساخت اسکریپت قوانین LLD Create a simple data collection using a script LLD rule. Request: ```json { "jsonrpc": "2.0", "method": "discoveryrule.create", "params": { "name": "Script example", "key_": "custom.script.lldrule", "hostid": "12345", "type": 21, "value_type": 4, "params": "var request = new CurlHttpRequest();\nreturn request.Post(\"https://postman-echo.com/post\", JSON.parse(value));", "parameters": [ { "name": "host", "value": "{HOST.CONN}" } ], "timeout": "6s", "delay": "30s" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 2 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "23865" ] }, "id": 3 } ``` #### Creating a dashboard Create a dashboard named "My dashboard" with one Problems widget with tags and using two types of sharing (user group and user) on a single dashboard page. Request: ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "problems", "x": 0, "y": 0, "width": 12, "height": 5, "view_mode": 0, "fields": [ { "type": 1, "name": "tags.tag.0", "value": "service" }, { "type": 0, "name": "tags.operator.0", "value": 1 }, { "type": 1, "name": "tags.value.0", "value": "zabbix_server" } ] } ] } ], "userGroups": [ { "usrgrpid": "7", "permission": 2 } ], "users": [ { "userid": "4", "permission": 3 } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "2" ] }, "id": 1 } ``` #### ساخت یک داشبورد یک داشبورد به نام "داشبورد من" با یک ویجت مشکلات ایجاد کنید برچسب ها و استفاده از دو نوع اشتراک گذاری (گروه کاربری و کاربر) در یک واحد صفحه داشبورد Request: ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "problems", "x": 0, "y": 0, "width": 12, "height": 5, "view_mode": 0, "fields": [ { "type": 1, "name": "tags.tag.0", "value": "service" }, { "type": 0, "name": "tags.operator.0", "value": 1 }, { "type": 1, "name": "tags.value.0", "value": "zabbix_server" } ] } ] } ], "userGroups": [ { "usrgrpid": "7", "permission": 2 } ], "users": [ { "userid": "4", "permission": 3 } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "2" ] }, "id": 1 } ``` #### Creating a graph Create a graph with two items. Request: ```json { "jsonrpc": "2.0", "method": "graph.create", "params": { "name": "MySQL bandwidth", "width": 900, "height": 200, "gitems": [ { "itemid": "22828", "color": "00AA00" }, { "itemid": "22829", "color": "3333FF" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "graphids": [ "652" ] }, "id": 1 } ``` #### ساخت گراف Create a graph with two items. Request: ```json { "jsonrpc": "2.0", "method": "graph.create", "params": { "name": "MySQL bandwidth", "width": 900, "height": 200, "gitems": [ { "itemid": "22828", "color": "00AA00" }, { "itemid": "22829", "color": "3333FF" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "graphids": [ "652" ] }, "id": 1 } ``` #### Creating a graph prototype Create a graph prototype with two items. Request: ```json { "jsonrpc": "2.0", "method": "graphprototype.create", "params": { "name": "Disk space usage {#FSNAME}", "width": 900, "height": 200, "gitems": [ { "itemid": "22828", "color": "00AA00" }, { "itemid": "22829", "color": "3333FF" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "graphids": [ "652" ] }, "id": 1 } ``` #### ساخت نمونه اولیه گراف Create a graph prototype with two items. Request: ```json { "jsonrpc": "2.0", "method": "graphprototype.create", "params": { "name": "Disk space usage {#FSNAME}", "width": 900, "height": 200, "gitems": [ { "itemid": "22828", "color": "00AA00" }, { "itemid": "22829", "color": "3333FF" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "graphids": [ "652" ] }, "id": 1 } ``` #### Creating a host Create a host called "Linux server" with an IP interface and tags, add it to a group, link a template to it and set the MAC addresses in the host inventory. Request: ```json { "jsonrpc": "2.0", "method": "host.create", "params": { "host": "Linux server", "interfaces": [ { "type": 1, "main": 1, "useip": 1, "ip": "192.168.3.1", "dns": "", "port": "10050" } ], "groups": [ { "groupid": "50" } ], "tags": [ { "tag": "Host name", "value": "Linux server" } ], "templates": [ { "templateid": "20045" } ], "macros": [ { "macro": "{$USER_ID}", "value": "123321" }, { "macro": "{$USER_LOCATION}", "value": "0:0:0", "description": "latitude, longitude and altitude coordinates" } ], "inventory_mode": 0, "inventory": { "macaddress_a": "01234", "macaddress_b": "56768" } }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "hostids": [ "107819" ] }, "id": 1 } ``` #### ساخت هاست Create a host called "Linux server" with an IP interface and tags, add it to a group, link a template to it and set the MAC addresses in the host inventory. Request: ```json { "jsonrpc": "2.0", "method": "host.create", "params": { "host": "Linux server", "interfaces": [ { "type": 1, "main": 1, "useip": 1, "ip": "192.168.3.1", "dns": "", "port": "10050" } ], "groups": [ { "groupid": "50" } ], "tags": [ { "tag": "Host name", "value": "Linux server" } ], "templates": [ { "templateid": "20045" } ], "macros": [ { "macro": "{$USER_ID}", "value": "123321" }, { "macro": "{$USER_LOCATION}", "value": "0:0:0", "description": "latitude, longitude and altitude coordinates" } ], "inventory_mode": 0, "inventory": { "macaddress_a": "01234", "macaddress_b": "56768" } }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "hostids": [ "107819" ] }, "id": 1 } ``` #### Creating a host group Create a host group called "Linux servers". Request: ```json { "jsonrpc": "2.0", "method": "hostgroup.create", "params": { "name": "Linux servers" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "groupids": [ "107819" ] }, "id": 1 } ``` #### ساخت گروه هاست Create a host group called "Linux servers". Request: ```json { "jsonrpc": "2.0", "method": "hostgroup.create", "params": { "name": "Linux servers" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "groupids": [ "107819" ] }, "id": 1 } ``` #### Creating a host inventory item Create a Zabbix agent item to populate the host's "OS" inventory field. Request: ```json { "jsonrpc": "2.0", "method": "item.create", "params": { "name": "uname", "key_": "system.uname", "hostid": "30021", "type": 0, "interfaceid": "30007", "value_type": 1, "delay": "10s", "inventory_link": 5 }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "24759" ] }, "id": 1 } ``` #### ساخت یک قانون LLD Create a Zabbix agent LLD rule to discover mounted file systems. Discovered items will be updated every 30 seconds. Request: ```json { "jsonrpc": "2.0", "method": "discoveryrule.create", "params": { "name": "Mounted filesystem discovery", "key_": "vfs.fs.discovery", "hostid": "10197", "type": 0, "interfaceid": "112", "delay": "30s" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "27665" ] }, "id": 1 } ``` #### Creating a host prototype Create a host prototype "{\#VM.NAME}" on LLD rule "23542" with a group prototype "{\#HV.NAME}", tag pair "Datacenter": "{\#DATACENTER.NAME}" and custom SNMPv2 interface 127.0.0.1:161 with community {$SNMP\_COMMUNITY}. Link it to host group "2". Request: ```json { "jsonrpc": "2.0", "method": "hostprototype.create", "params": { "host": "{#VM.NAME}", "ruleid": "23542", "custom_interfaces": "1", "groupLinks": [ { "groupid": "2" } ], "groupPrototypes": [ { "name": "{#HV.NAME}" } ], "tags": [ { "tag": "Datacenter", "value": "{#DATACENTER.NAME}" } ], "interfaces": [ { "main": "1", "type": "2", "useip": "1", "ip": "127.0.0.1", "dns": "", "port": "161", "details": { "version": "2", "bulk": "1", "community": "{$SNMP_COMMUNITY}" } } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "hostids": [ "10103" ] }, "id": 1 } ``` #### ساخت نمونه اولیه هاست Create a host prototype "{\#VM.NAME}" on LLD rule "23542" with a group prototype "{\#HV.NAME}", tag pair "Datacenter": "{\#DATACENTER.NAME}" and custom SNMPv2 interface 127.0.0.1:161 with community {$SNMP\_COMMUNITY}. Link it to host group "2". Request: ```json { "jsonrpc": "2.0", "method": "hostprototype.create", "params": { "host": "{#VM.NAME}", "ruleid": "23542", "custom_interfaces": "1", "groupLinks": [ { "groupid": "2" } ], "groupPrototypes": [ { "name": "{#HV.NAME}" } ], "tags": [ { "tag": "Datacenter", "value": "{#DATACENTER.NAME}" } ], "interfaces": [ { "main": "1", "type": "2", "useip": "1", "ip": "127.0.0.1", "dns": "", "port": "161", "details": { "version": "2", "bulk": "1", "community": "{$SNMP_COMMUNITY}" } } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "hostids": [ "10103" ] }, "id": 1 } ``` #### Creating a host with SNMP interface Create a host called "SNMP host" with an SNMPv3 interface with details. Request: ```json { "jsonrpc": "2.0", "method": "host.create", "params": { "host": "SNMP host", "interfaces": [ { "type": 2, "main": 1, "useip": 1, "ip": "127.0.0.1", "dns": "", "port": "161", "details": { "version": 3, "bulk": 0, "securityname": "mysecurityname", "contextname": "", "securitylevel": 1 } } ], "groups": [ { "groupid": "4" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "hostids": [ "10658" ] }, "id": 1 } ``` ####ساخت هاست با اینترفیس SNMP Create a host called "SNMP host" with an SNMPv3 interface with details. Request: ```json { "jsonrpc": "2.0", "method": "host.create", "params": { "host": "SNMP host", "interfaces": [ { "type": 2, "main": 1, "useip": 1, "ip": "127.0.0.1", "dns": "", "port": "161", "details": { "version": 3, "bulk": 0, "securityname": "mysecurityname", "contextname": "", "securitylevel": 1 } } ], "groups": [ { "groupid": "4" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "hostids": [ "10658" ] }, "id": 1 } ``` #### Creating a maintenance Create a maintenance with data collection for host group with ID "2" and with problem tags **service:mysqld** and **error**. It must be active from 22.01.2013 till 22.01.2014, come in effect each Sunday at 18:00 and last for one hour. Request: ```json { "jsonrpc": "2.0", "method": "maintenance.create", "params": { "name": "Sunday maintenance", "active_since": 1358844540, "active_till": 1390466940, "tags_evaltype": 0, "groups": [ {"groupid": "2"} ], "timeperiods": [ { "period": 3600, "timeperiod_type": 3, "start_time": 64800, "every": 1, "dayofweek": 64 } ], "tags": [ { "tag": "service", "operator": "0", "value": "mysqld" }, { "tag": "error", "operator": "2", "value": "" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "maintenanceids": [ "3" ] }, "id": 1 } ``` #### ایجاد یک تعمیر و نگهداری ایجاد تعمیر و نگهداری با جمع آوری داده ها برای گروه میزبان با شناسه "2" و با برچسب های مشکل **service:mysqld** و **error**. باید فعال باشه از 22.01.2013 تا 22.01.2014، هر یکشنبه از ساعت 18:00 اعمال می شود و آخرین برای یک ساعت. درخواست: ``json { "jsonrpc": "2.0"، "روش": "نگهداری. ایجاد"، "params": { "نام": "نگهداری یکشنبه"، "active_since": 1358844540، "فعال_تا": 1390466940، "tags_evaltype": 0، "گروه ها": [ {"groupid": "2"} ]، "دوره های زمانی": [ { "دوره": 3600، "timeperiod_type": 3، "start_time": 64800، "هر": 1، «روز هفته»: 64 } ]، "برچسب ها": [ { "برچسب": "خدمات"، "اپراتور": "0"، "value": "mysqld" }، { "برچسب": "خطا"، "اپراتور": "2"، "ارزش": "" } ] }، "auth": "038e1d7b1735c6a5436ee9eae095879e"، "id": 1 } ``` واکنش: ``json { "jsonrpc": "2.0"، "نتیجه": { "Maintenanceids": [ "3" ] }، "id": 1 } ``` #### Creating an e-mail media type Create a new e-mail media type with a custom SMTP port and message templates. Request: ```json { "jsonrpc": "2.0", "method": "mediatype.create", "params": { "type": "0", "name": "E-mail", "smtp_server": "mail.example.com", "smtp_helo": "example.com", "smtp_email": "zabbix@example.com", "smtp_port": "587", "content_type": "1", "message_templates": [ { "eventsource": "0", "recovery": "0", "subject": "Problem: {EVENT.NAME}", "message": "Problem \"{EVENT.NAME}\" on host \"{HOST.NAME}\" started at {EVENT.TIME}." }, { "eventsource": "0", "recovery": "1", "subject": "Resolved in {EVENT.DURATION}: {EVENT.NAME}", "message": "Problem \"{EVENT.NAME}\" on host \"{HOST.NAME}\" has been resolved at {EVENT.RECOVERY.TIME} on {EVENT.RECOVERY.DATE}." }, { "eventsource": "0", "recovery": "2", "subject": "Updated problem in {EVENT.AGE}: {EVENT.NAME}", "message": "{USER.FULLNAME} {EVENT.UPDATE.ACTION} problem \"{EVENT.NAME}\" on host \"{HOST.NAME}\" at {EVENT.UPDATE.DATE} {EVENT.UPDATE.TIME}." } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "mediatypeids": [ "7" ] }, "id": 1 } ``` #### ایجاد یک نوع رسانه ایمیل یک نوع رسانه ایمیل جدید با یک پورت و پیام SMTP سفارشی ایجاد کنید قالب ها درخواست: ``json { "jsonrpc": "2.0"، "روش": "mediatype.create", "params": { "نوع": "0"، "نام": "ایمیل"، "smtp_server": "mail.example.com"، "smtp_helo": "example.com"، "smtp_email": "zabbix@example.com"، "smtp_port": "587"، "content_type": "1"، "message_templates": [ { "منبع رویداد": "0"، "بازیابی": "0"، "subject": "مشکل: {EVENT.NAME}"، "message": "مشکل \"{EVENT.NAME}\" در میزبان \"{HOST.NAME}\" در {EVENT.TIME} شروع شد." }، { "منبع رویداد": "0"، "بازیابی": "1"، "subject": "در {EVENT.DURATION} حل شد: {EVENT.NAME}"، "message": "مشکل \"{EVENT.NAME}\" در میزبان \"{HOST.NAME}\" در {EVENT.RECOVERY.TIME} در {EVENT.RECOVERY.DATE} حل شد." }، { "منبع رویداد": "0"، "بازیابی": "2"، "subject": "مشکل به روز شده در {EVENT.AGE}: {EVENT.NAME}"، "message": "{USER.FULLNAME} {EVENT.UPDATE.ACTION} مشکل \"{EVENT.NAME}\" در میزبان \"{HOST.NAME}\" در {EVENT.UPDATE.DATE} {EVENT.UPDATE .زمان}." } ] }، "auth": "038e1d7b1735c6a5436ee9eae095879e"، "id": 1 } ``` واکنش: ``json { "jsonrpc": "2.0"، "نتیجه": { "mediatypeids": [ "7" ] }، "id": 1 } ``` #### Creating a new global regular expression. Request: ```json { "jsonrpc": "2.0", "method": "regexp.create", "params": { "name": "Storage devices for SNMP discovery", "test_string": "/boot", "expressions": [ { "expression": "^(Physical memory|Virtual memory|Memory buffers|Cached memory|Swap space)$", "expression_type": "4", "case_sensitive": "1" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "regexpids": [ "16" ] }, "id": 1 } ``` #### ساخت گراف Create a graph with two items. Request: ```json { "jsonrpc": "2.0", "method": "graph.create", "params": { "name": "MySQL bandwidth", "width": 900, "height": 200, "gitems": [ { "itemid": "22828", "color": "00AA00" }, { "itemid": "22829", "color": "3333FF" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "graphids": [ "652" ] }, "id": 1 } ``` #### Creating an item Create a numeric Zabbix agent item with 2 item tags to monitor free disk space on host with ID "30074". Request: ```json { "jsonrpc": "2.0", "method": "item.create", "params": { "name": "Free disk space on /home/joe/", "key_": "vfs.fs.size[/home/joe/,free]", "hostid": "30074", "type": 0, "value_type": 3, "interfaceid": "30084", "tags": [ { "tag": "Disk usage" }, { "tag": "Equipment", "value": "Workstation" } ], "delay": "30s" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "24758" ] }, "id": 1 } ``` #### ساخت یک قانون LLD به همراه Path Request: ```json { "jsonrpc": "2.0", "method": "discoveryrule.create", "params": { "name": "LLD rule with LLD macro paths", "key_": "lld", "hostid": "10116", "type": 0, "interfaceid": "13", "delay": "30s", "lld_macro_paths": [ { "lld_macro": "{#MACRO1}", "path": "$.path.1" }, { "lld_macro": "{#MACRO2}", "path": "$.path.2" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "27665" ] }, "id": 1 } ``` #### Creating an item prototype Create an item prototype to monitor free disk space on a discovered file system. Discovered items should be numeric Zabbix agent items updated every 30 seconds. Request: ```json { "jsonrpc": "2.0", "method": "itemprototype.create", "params": { "name": "Free disk space on {#FSNAME}", "key_": "vfs.fs.size[{#FSNAME},free]", "hostid": "10197", "ruleid": "27665", "type": 0, "value_type": 3, "interfaceid": "112", "delay": "30s" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "27666" ] }, "id": 1 } ``` #### ساخت یک قانون LLD Create a Zabbix agent LLD rule to discover mounted file systems. Discovered items will be updated every 30 seconds. Request: ```json { "jsonrpc": "2.0", "method": "discoveryrule.create", "params": { "name": "Mounted filesystem discovery", "key_": "vfs.fs.discovery", "hostid": "10197", "type": 0, "interfaceid": "112", "delay": "30s" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "27665" ] }, "id": 1 } ``` #### Creating an item prototype with preprocessing Create an item using change per second and a custom multiplier as a second step. Request: ```json { "jsonrpc": "2.0", "method": "itemprototype.create", "params": { "name": "Incoming network traffic on {#IFNAME}", "key_": "net.if.in[{#IFNAME}]", "hostid": "10001", "ruleid": "27665", "type": 0, "value_type": 3, "delay": "60s", "units": "bps", "interfaceid": "1155", "preprocessing": [ { "type": 10, "params": "", "error_handler": 0, "error_handler_params": "" }, { "type": 1, "params": "8", "error_handler": 2, "error_handler_params": "10" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "44211" ] }, "id": 1 } ``` #### ساخت قانون LLD به همراه preprocessing Request: ```json { "jsonrpc": "2.0", "method": "discoveryrule.create", "params": { "name": "Discovery rule with preprocessing", "key_": "lld.with.preprocessing", "hostid": "10001", "ruleid": "27665", "type": 0, "value_type": 3, "delay": "60s", "interfaceid": "1155", "preprocessing": [ { "type": 20, "params": "20", "error_handler": 0, "error_handler_params": "" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "44211" ] }, "id": 1 } ``` #### Creating an item with preprocessing Create an item using custom multiplier. Request: ```json { "jsonrpc": "2.0", "method": "item.create", "params": { "name": "Device uptime", "key_": "sysUpTime", "hostid": "11312", "type": 4, "snmp_oid": "SNMPv2-MIB::sysUpTime.0", "value_type": 1, "delay": "60s", "units": "uptime", "interfaceid": "1156", "preprocessing": [ { "type": 1, "params": "0.01", "error_handler": 1, "error_handler_params": "" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "44210" ] }, "id": 1 } ``` #### ساخت قانون LLD به همراه preprocessing Request: ```json { "jsonrpc": "2.0", "method": "discoveryrule.create", "params": { "name": "Discovery rule with preprocessing", "key_": "lld.with.preprocessing", "hostid": "10001", "ruleid": "27665", "type": 0, "value_type": 3, "delay": "60s", "interfaceid": "1155", "preprocessing": [ { "type": 20, "params": "20", "error_handler": 0, "error_handler_params": "" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "44211" ] }, "id": 1 } ``` #### Creating an LLD rule Create a Zabbix agent LLD rule to discover mounted file systems. Discovered items will be updated every 30 seconds. Request: ```json { "jsonrpc": "2.0", "method": "discoveryrule.create", "params": { "name": "Mounted filesystem discovery", "key_": "vfs.fs.discovery", "hostid": "10197", "type": 0, "interfaceid": "112", "delay": "30s" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "27665" ] }, "id": 1 } ``` #### ساخت یک قانون LLD Create a Zabbix agent LLD rule to discover mounted file systems. Discovered items will be updated every 30 seconds. Request: ```json { "jsonrpc": "2.0", "method": "discoveryrule.create", "params": { "name": "Mounted filesystem discovery", "key_": "vfs.fs.discovery", "hostid": "10197", "type": 0, "interfaceid": "112", "delay": "30s" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "27665" ] }, "id": 1 } ``` #### Creating an SLA Instruct to create an SLA entry for: * tracking uptime for SQL-engine related services; * custom schedule of all weekdays excluding last hour on Saturday; * an effective date of the last day of the year 2022; * with 1 hour and 15 minutes long planned downtime starting at midnight on the 4th of July; * SLA weekly report calculation will be on; * the minimum acceptable SLO will be 99.9995%. #### ایجاد SLA دستور ایجاد یک ورودی SLA برای: * ردیابی زمان کار برای خدمات مرتبط با موتور SQL. * برنامه سفارشی تمام روزهای هفته به استثنای ساعت گذشته در روز شنبه. * تاریخ لازم الاجرا شدن آخرین روز سال 2022؛ * با 1 ساعت و 15 دقیقه توقف برنامه ریزی شده از نیمه شب 4 جولای؛ * محاسبه گزارش هفتگی SLA روشن خواهد بود. * حداقل SLO قابل قبول 99.9995% خواهد بود. #### Creating a scheduled report Create a weekly report that will be prepared for the previous week every Monday-Friday at 12:00 from 2021-04-01 to 2021-08-31. Request: ```json { "jsonrpc": "2.0", "method": "report.create", "params": { "userid": "1", "name": "Weekly report", "dashboardid": "1", "period": "1", "cycle": "1", "start_time": "43200", "weekdays": "31", "active_since": "2021-04-01", "active_till": "2021-08-31", "subject": "Weekly report", "message": "Report accompanying text", "status": "1", "description": "Report description", "users": [ { "userid": "1", "access_userid": "1", "exclude": "0" }, { "userid": "2", "access_userid": "0", "exclude": "1" } ], "user_groups": [ { "usrgrpid": "7", "access_userid": "0" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "reportids": [ "1" ] }, "id": 1 } ``` #### ایجاد یک گزارش برنامه ریزی شده یک گزارش هفتگی ایجاد کنید که هر هفته برای هفته قبل آماده می شود دوشنبه تا جمعه ساعت 12:00 از 01-04-2021 تا 2021-08-31. درخواست: ``json { "jsonrpc": "2.0"، "روش": "report.create", "params": { "userid": "1"، "name": "گزارش هفتگی"، "dashboardid": "1"، "دوره 1"، "چرخه": "1"، "start_time": "43200"، "روزهای هفته": "31"، "active_since": "01-04-2021", "active_till": "31-08-2021", "موضوع": "گزارش هفتگی"، "پیام": "گزارش متن همراه"، "وضعیت": "1"، "description": "گزارش شرح", "کاربران": [ { "userid": "1"، "access_userid": "1"، "exclude": "0" }، { "userid": "2"، "access_userid": "0"، "exclude": "1" } ]، "user_groups": [ { "usrgrpid": "7"، "access_userid": "0" } ] }، "auth": "038e1d7b1735c6a5436ee9eae095879e"، "id": 1 } ``` واکنش: ``json { "jsonrpc": "2.0"، "نتیجه": { "گزارش ها": [ "1" ] }، "id": 1 } ``` #### Creating a script media type Create a new script media type with a custom value for the number of attempts and the interval between them. Request: ```json { "jsonrpc": "2.0", "method": "mediatype.create", "params": { "type": "1", "name": "Push notifications", "exec_path": "push-notification.sh", "exec_params": "{ALERT.SENDTO}\n{ALERT.SUBJECT}\n{ALERT.MESSAGE}\n", "maxattempts": "5", "attempt_interval": "11s" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "mediatypeids": [ "8" ] }, "id": 1 } ``` #### ساخت یک قانون LLD Create a Zabbix agent LLD rule to discover mounted file systems. Discovered items will be updated every 30 seconds. Request: ```json { "jsonrpc": "2.0", "method": "discoveryrule.create", "params": { "name": "Mounted filesystem discovery", "key_": "vfs.fs.discovery", "hostid": "10197", "type": 0, "interfaceid": "112", "delay": "30s" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "27665" ] }, "id": 1 } ``` #### Creating a task Create a task `check now` for two items. One is an item, the other is a low-level discovery rule. Request: ```json { "jsonrpc": "2.0", "method": "task.create", "params": [ { "type": 6, "request": { "itemid": "10092" } }, { "type": "6", "request": { "itemid": "10093" } } ], "auth": "700ca65537074ec963db7efabda78259", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "taskids": [ "1", "2" ] }, "id": 1 } ``` Create a task `diagnostic information` task. Request: ```json { "jsonrpc": "2.0", "method": "task.create", "params": [ { "type": 1, "request": { "alerting": { "stats": [ "alerts" ], "top": { "media.alerts": 10 } }, "lld": { "stats": "extend", "top": { "values": 5 } } }, "proxy_hostid": 0 } ], "auth": "700ca65537074ec963db7efabda78259", "id": 2 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "taskids": [ "3" ] }, "id": 2 } ``` #### ایجاد یک کار یک کار «اکنون بررسی کنید» برای دو مورد ایجاد کنید. یکی یک آیتم است، دیگری یک قانون کشف سطح پایین. درخواست: ``json { "jsonrpc": "2.0"، "روش": "task.create"، "params": [ { "نوع": 6، "درخواست": { "itemid": "10092" } }، { "نوع": "6"، "درخواست": { "itemid": "10093" } } ]، "auth": "700ca65537074ec963db7efabda78259"، "id": 1 } ``` واکنش: ``json { "jsonrpc": "2.0"، "نتیجه": { "تکلیف": [ "1"، "2" ] }، "id": 1 } ``` یک وظیفه «اطلاعات تشخیصی» ایجاد کنید. درخواست: ``json { "jsonrpc": "2.0"، "روش": "task.create"، "params": [ { "نوع": 1، "درخواست": { "هشدار": { "آمار": [ "هشدارها" ]، "بالا": { "media.alerts": 10 } }، "lld": { "stats": "extend", "بالا": { "ارزش ها": 5 } } }، "proxy_hostid": 0 } ]، "auth": "700ca65537074ec963db7efabda78259"، "id": 2 } ``` واکنش: ``json { "jsonrpc": "2.0"، "نتیجه": { "تکلیف": [ "3" ] }، "id": 2 } ``` #### Creating a template Create a template with tags and link two templates to this template. Request: ```json { "jsonrpc": "2.0", "method": "template.create", "params": { "host": "Linux template", "groups": { "groupid": 1 }, "templates": [ { "templateid": "11115" }, { "templateid": "11116" } ], "tags": [ { "tag": "Host name", "value": "{HOST.NAME}" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "templateids": [ "11117" ] }, "id": 1 } ``` #### ساخت قالب درخواست: ``json { "jsonrpc": "2.0"، "روش": "correlation.update"، "params": { "همبستگی": "1"، "فیلتر": { "شرایط": [ { "نوع": 3، "oldtag": "خطا"، "نیوتگ": "خوب" } ] } }، "auth": "343baad4f88b4106b9b5961e77437688", "id": 1 } ``` واکنش: ``json { "jsonrpc": "2.0"، "نتیجه": { "همبستگی ها": [ "1" ] }، "id": 1 } ``` #### Creating a template dashboard Create a template dashboard named “Graphs” with one Graph widget on a single dashboard page. Request: ```json { "jsonrpc": "2.0", "method": "templatedashboard.create", "params": { "templateid": "10318", "name": "Graphs", "pages": [ { "widgets": [ { "type": "graph", "x": 0, "y": 0, "width": 12, "height": 5, "view_mode": 0, "fields": [ { "type": 6, "name": "graphid", "value": "1123" } ] } ] } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "32" ] }, "id": 1 } ``` #### ایجاد داشبورد الگو یک داشبورد قالب به نام «گراف ها» با یک ویجت Graph در یک ایجاد کنید صفحه داشبورد واحد درخواست: ``json { "jsonrpc": "2.0"، "روش": "templatedashboard.create"، "params": { "templateid": "10318"، "name": "نمودارها"، "صفحات": [ { "ویجت ها": [ { "نوع": "گراف"، "x": 0، "y": 0، "عرض": 12، "ارتفاع": 5، "view_mode": 0، "زمینه های": [ { "نوع": 6، "نام": "گرافید"، "value": "1123" } ] } ] } ] }، "auth": "038e1d7b1735c6a5436ee9eae095879e"، "id": 1 } ``` واکنش: ``json { "jsonrpc": "2.0"، "نتیجه": { "داشبوردها": [ "32" ] }، "id": 1 } ``` #### Creating a value map Create one value map with two mappings. Request: ```json { "jsonrpc": "2.0", "method": "valuemap.create", "params": { "hostid": "50009", "name": "Service state", "mappings": [ { "type": "1", "value": "1", "newvalue": "Up" }, { "type": "5", "newvalue": "Down" } ] }, "auth": "57562fd409b3b3b9a4d916d45207bbcb", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "valuemapids": [ "1" ] }, "id": 1 } ``` ####ساخت Icon map Create an icon map to display hosts of different types. Request: ```json { "jsonrpc": "2.0", "method": "iconmap.create", "params": { "name": "Type icons", "default_iconid": "2", "mappings": [ { "inventory_link": 1, "expression": "server", "iconid": "3" }, { "inventory_link": 1, "expression": "switch", "iconid": "4" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "iconmapids": [ "2" ] }, "id": 1 } ``` #### Creating a webhook media type Create a new webhook media type. Request: ```json { "jsonrpc": "2.0", "method": "mediatype.create", "params": { "type": "4", "name": "Webhook", "script": "var Webhook = {\r\n token: null,\r\n to: null,\r\n subject: null,\r\n message: null,\r\n\r\n sendMessage: function() {\r\n // some logic\r\n }\r\n}", "parameters": [ { "name": "Message", "value": "{ALERT.MESSAGE}" }, { "name": "Subject", "value": "{ALERT.SUBJECT}" }, { "name": "To", "value": "{ALERT.SENDTO}" }, { "name": "Token", "value": "<Token>" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "mediatypeids": [ "9" ] }, "id": 1 } ``` #### ساخت قالب درخواست: ``json { "jsonrpc": "2.0"، "روش": "correlation.update"، "params": { "همبستگی": "1"، "فیلتر": { "شرایط": [ { "نوع": 3، "oldtag": "خطا"، "نیوتگ": "خوب" } ] } }، "auth": "343baad4f88b4106b9b5961e77437688", "id": 1 } ``` واکنش: ``json { "jsonrpc": "2.0"، "نتیجه": { "همبستگی ها": [ "1" ] }، "id": 1 } ``` #### Creating a web scenario Create a web scenario to monitor the company home page. The scenario will have two steps, to check the home page and the "About" page and make sure they return the HTTP status code 200. Request: ```json { "jsonrpc": "2.0", "method": "httptest.create", "params": { "name": "Homepage check", "hostid": "10085", "steps": [ { "name": "Homepage", "url": "http://example.com", "status_codes": "200", "no": 1 }, { "name": "Homepage / About", "url": "http://example.com/about", "status_codes": "200", "no": 2 } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "httptestids": [ "5" ] }, "id": 1 } ``` #### ساخت وب سناریو Create a web scenario to monitor the company home page. The scenario will have two steps, to check the home page and the "About" page and make sure they return the HTTP status code 200. Request: ```json { "jsonrpc": "2.0", "method": "httptest.create", "params": { "name": "Homepage check", "hostid": "10085", "steps": [ { "name": "Homepage", "url": "http://example.com", "status_codes": "200", "no": 1 }, { "name": "Homepage / About", "url": "http://example.com/about", "status_codes": "200", "no": 2 } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "httptestids": [ "5" ] }, "id": 1 } ``` #### Creating dependent item Create a dependent item for the master item with ID 24759. Only dependencies on the same host are allowed, therefore master and the dependent item should have the same hostid. Request: ```json { "jsonrpc": "2.0", "method": "item.create", "params": { "hostid": "30074", "name": "Dependent test item", "key_": "dependent.item", "type": 18, "master_itemid": "24759", "value_type": 2 }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "44211" ] }, "id": 1 } ``` #### ایجاد آیتم وابسته یک مورد وابسته برای آیتم اصلی با شناسه 24759 ایجاد کنید. فقط وابستگی به همان میزبان مجاز است، بنابراین master و the آیتم وابسته باید میزبان یکسانی داشته باشد. درخواست: ``json { "jsonrpc": "2.0"، "روش": "item.create", "params": { "hostid": "30074"، "name": "آیتم آزمایشی وابسته"، "key_": "dependent.item", "نوع": 18، "master_itemid": "24759"، "نوع_ارزش": 2 }، "auth": "038e1d7b1735c6a5436ee9eae095879e"، "id": 1 } ``` واکنش: ``json { "jsonrpc": "2.0"، "نتیجه": { "اقلام": [ "44211" ] }، "id": 1 } ``` #### Creating dependent item prototype Create Dependent item prototype for Master item prototype with ID 44211. Only dependencies on same host (template/discovery rule) are allowed, therefore Master and Dependent item should have same hostid and ruleid. Request: ```json { "jsonrpc": "2.0", "method": "itemprototype.create", "params": { "hostid": "10001", "ruleid": "27665", "name": "Dependent test item prototype", "key_": "dependent.prototype", "type": 18, "master_itemid": "44211", "value_type": 3 }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "44212" ] }, "id": 1 } ``` #### ایجاد آیتم وابسته یک مورد وابسته برای آیتم اصلی با شناسه 24759 ایجاد کنید. فقط وابستگی به همان میزبان مجاز است، بنابراین master و the آیتم وابسته باید میزبان یکسانی داشته باشد. درخواست: ``json { "jsonrpc": "2.0"، "روش": "item.create", "params": { "hostid": "30074"، "name": "آیتم آزمایشی وابسته"، "key_": "dependent.item", "نوع": 18، "master_itemid": "24759"، "نوع_ارزش": 2 }، "auth": "038e1d7b1735c6a5436ee9eae095879e"، "id": 1 } ``` واکنش: ``json { "jsonrpc": "2.0"، "نتیجه": { "اقلام": [ "44211" ] }، "id": 1 } ``` #### Creating interfaces Create an interface on two hosts. Request: ```json { "jsonrpc": "2.0", "method": "hostinterface.massadd", "params": { "hosts": [ { "hostid": "30050" }, { "hostid": "30052" } ], "interfaces": { "dns": "", "ip": "127.0.0.1", "main": 0, "port": "10050", "type": 1, "useip": 1 } }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "interfaceids": [ "30069", "30070" ] }, "id": 1 } ``` #### ساخت اینترفیس ها Create an interface on two hosts. Request: ```json { "jsonrpc": "2.0", "method": "hostinterface.massadd", "params": { "hosts": [ { "hostid": "30050" }, { "hostid": "30052" } ], "interfaces": { "dns": "", "ip": "127.0.0.1", "main": 0, "port": "10050", "type": 1, "useip": 1 } }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "interfaceids": [ "30069", "30070" ] }, "id": 1 } ``` ### Custom interface details The details object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**version**<br>(required)|integer|SNMP interface version.<br><br>Possible values are:<br>1 - SNMPv1;<br>2 - SNMPv2c;<br>3 - SNMPv3| |bulk|integer|Whether to use bulk SNMP requests.<br><br>Possible values are:<br>0 - don't use bulk requests;<br>1 - *(default)* - use bulk requests.| |community|string|SNMP community. Used only by SNMPv1 and SNMPv2 interfaces.| |securityname|string|SNMPv3 security name. Used only by SNMPv3 interfaces.| |securitylevel|integer|SNMPv3 security level. Used only by SNMPv3 interfaces.<br><br>Possible values are:<br>0 - *(default)* - noAuthNoPriv;<br>1 - authNoPriv;<br>2 - authPriv.| |authpassphrase|string|SNMPv3 authentication passphrase. Used only by SNMPv3 interfaces.| |privpassphrase|string|SNMPv3 privacy passphrase. Used only by SNMPv3 interfaces.| |authprotocol|integer|SNMPv3 authentication protocol. Used only by SNMPv3 interfaces.<br><br>Possible values are:<br>0 - *(default)* - MD5;<br>1 - SHA1;<br>2 - SHA224;<br>3 - SHA256;<br>4 - SHA384;<br>5 - SHA512.| |privprotocol|integer|SNMPv3 privacy protocol. Used only by SNMPv3 interfaces.<br><br>Possible values are:<br>0 - *(default)* - DES;<br>1 - AES128;<br>2 - AES192;<br>3 - AES256;<br>4 - AES192C;<br>5 - AES256C.| |contextname|string|SNMPv3 context name. Used only by SNMPv3 interfaces.| ### جزییات اینترفیس خاص The details object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**version**<br>(required)|integer|SNMP interface version.<br><br>Possible values are:<br>1 - SNMPv1;<br>2 - SNMPv2c;<br>3 - SNMPv3| |bulk|integer|Whether to use bulk SNMP requests.<br><br>Possible values are:<br>0 - don't use bulk requests;<br>1 - *(default)* - use bulk requests.| |community|string|SNMP community. Used only by SNMPv1 and SNMPv2 interfaces.| |securityname|string|SNMPv3 security name. Used only by SNMPv3 interfaces.| |securitylevel|integer|SNMPv3 security level. Used only by SNMPv3 interfaces.<br><br>Possible values are:<br>0 - *(default)* - noAuthNoPriv;<br>1 - authNoPriv;<br>2 - authPriv.| |authpassphrase|string|SNMPv3 authentication passphrase. Used only by SNMPv3 interfaces.| |privpassphrase|string|SNMPv3 privacy passphrase. Used only by SNMPv3 interfaces.| |authprotocol|integer|SNMPv3 authentication protocol. Used only by SNMPv3 interfaces.<br><br>Possible values are:<br>0 - *(default)* - MD5;<br>1 - SHA1;<br>2 - SHA224;<br>3 - SHA256;<br>4 - SHA384;<br>5 - SHA512.| |privprotocol|integer|SNMPv3 privacy protocol. Used only by SNMPv3 interfaces.<br><br>Possible values are:<br>0 - *(default)* - DES;<br>1 - AES128;<br>2 - AES192;<br>3 - AES256;<br>4 - AES192C;<br>5 - AES256C.| |contextname|string|SNMPv3 context name. Used only by SNMPv3 interfaces.| # dashboard.create ساخت داشبورد # dashboard.delete حذف داشبورد # dashboard.get # دریافت داشبورد ### Dashboard page The dashboard page object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |dashboard\_pageid|string|*(readonly)* ID of the dashboard page.| |name|string|Dashboard page name.<br><br>Default: empty string.| |display\_period|integer|Dashboard page display period (in seconds).<br><br>Possible values: 0, 10, 30, 60, 120, 600, 1800, 3600.<br><br>Default: 0 (will use the default page display period).| |widgets|array|Array of the [dashboard widget](object#dashboard_widget) objects.| ### صفحه داشبورد آبجکت صفحه داشبورد دارای ویژگی های زیر است . |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |dashboard\_pageid|string|*(readonly)* ID of the dashboard page.| |name|string|Dashboard page name.<br><br>Default: empty string.| |display\_period|integer|Dashboard page display period (in seconds).<br><br>Possible values: 0, 10, 30, 60, 120, 600, 1800, 3600.<br><br>Default: 0 (will use the default page display period).| |widgets|array|Array of the [dashboard widget](object#dashboard_widget) objects.| ### Dashboard The dashboard object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |dashboardid|string|*(readonly)* ID of the dashboard.| |**name**<br>(required)|string|Name of the dashboard.| |userid|string|Dashboard owner user ID.| |private|integer|Type of dashboard sharing.<br><br>Possible values:<br>0 - public dashboard;<br>1 - *(default)* private dashboard.| |display\_period|integer|Default page display period (in seconds).<br><br>Possible values: 10, 30, 60, 120, 600, 1800, 3600.<br><br>Default: 30.| |auto\_start|integer|Auto start slideshow.<br><br>Possible values:<br>0 - do not auto start slideshow;<br>1 - *(default)* auto start slideshow.| Note that for some methods (update, delete) the required/optional parameter combination is different. ### داشبورد آبجکت داشبورد دارای ویژگی های زیر است . |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |dashboardid|string|*(readonly)* ID of the dashboard.| |**name**<br>(required)|string|Name of the dashboard.| |userid|string|Dashboard owner user ID.| |private|integer|Type of dashboard sharing.<br><br>Possible values:<br>0 - public dashboard;<br>1 - *(default)* private dashboard.| |display\_period|integer|Default page display period (in seconds).<br><br>Possible values: 10, 30, 60, 120, 600, 1800, 3600.<br><br>Default: 30.| |auto\_start|integer|Auto start slideshow.<br><br>Possible values:<br>0 - do not auto start slideshow;<br>1 - *(default)* auto start slideshow.| Note that for some methods (update, delete) the required/optional parameter combination is different. # dashboard.update به روز رسانی داشبورد ### Dashboard user group List of dashboard permissions based on user groups. It has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**usrgrpid**<br>(required)|string|User group ID.| |**permission**<br>(required)|integer|Type of permission level.<br><br>Possible values:<br>2 - read only;<br>3 - read-write;| ### داشبورد گروه کاربران لیست داشبورد دسترسی بر اساس گروه کاربران ویژگی های زیر را دارد . |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**usrgrpid**<br>(required)|string|User group ID.| |**permission**<br>(required)|integer|Type of permission level.<br><br>Possible values:<br>2 - read only;<br>3 - read-write;| ### Dashboard user List of dashboard permissions based on users. It has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**userid**<br>(required)|string|User ID.| |**permission**<br>(required)|integer|Type of permission level.<br><br>Possible values:<br>2 - read only;<br>3 - read-write;| ### داشبورد گروه کاربران لیست داشبورد دسترسی بر اساس گروه کاربران ویژگی های زیر را دارد . |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**usrgrpid**<br>(required)|string|User group ID.| |**permission**<br>(required)|integer|Type of permission level.<br><br>Possible values:<br>2 - read only;<br>3 - read-write;| # Dashboard widget fields # فیلدهای ویجت داشبورد ### Dashboard widget field The dashboard widget field object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**type**<br>(required)|integer|Type of the widget field.<br><br>Possible values:<br>0 - Integer;<br>1 - String;<br>2 - Host group;<br>3 - Host;<br>4 - Item;<br>5 - Item prototype;<br>6 - Graph;<br>7 - Graph prototype;<br>8 - Map;<br>9 - Service;<br>10 - SLA.| |**name**<br>(required)|string|Widget field name.<br><br>Possible values: see [Dashboard widget fields](/manual/api/reference/dashboard/widget_fields).| |**value**<br>(required)|mixed|Widget field value depending on the type.<br><br>Possible values: see [Dashboard widget fields](/manual/api/reference/dashboard/widget_fields).| ### فیلد وبجت داشبورد آبجکت فیلد ویجت داشبورد دارای ویژگی های زیر است . |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**type**<br>(required)|integer|Type of the widget field.<br><br>Possible values:<br>0 - Integer;<br>1 - String;<br>2 - Host group;<br>3 - Host;<br>4 - Item;<br>5 - Item prototype;<br>6 - Graph;<br>7 - Graph prototype;<br>8 - Map;<br>9 - Service;<br>10 - SLA.| |name|string|Widget field name.| |**value**<br>(required)|mixed|Widget field value depending of type.| ### Database creation We assume that a *zabbix* database user with *password* password exists and has permissions to create database objects in ORCL service located on the *host* Oracle database server. Zabbix requires a Unicode database character set and a `UTF8` national character set. Check current settings: sqlplus> select parameter,value from v$nls_parameters where parameter='NLS_CHARACTERSET' or parameter='NLS_NCHAR_CHARACTERSET'; Now prepare the database: cd /path/to/zabbix-sources/database/oracle sqlplus zabbix/password@oracle_host/ORCL sqlplus> @schema.sql # stop here if you are creating database for Zabbix proxy sqlplus> @images.sql sqlplus> @data.sql ::: notetip Please set the initialization parameter CURSOR\_SHARING=FORCE for best performance. ::: ### ایجاد پایگاه داده ما فرض می کنیم که یک کاربر پایگاه داده *zabbix* با رمز عبور *password* وجود دارد و دارای مجوز برای ایجاد اشیاء پایگاه داده در سرویس ORCL واقع شده است در سرور *میزبان* پایگاه داده Oracle. Zabbix به یک پایگاه داده یونیکد نیاز دارد مجموعه شخصیت‌ها و مجموعه شخصیت‌های ملی «UTF8». جریان را بررسی کنید تنظیمات: sqlplus> پارامتر، مقدار را از v$nls_parameters انتخاب کنید که در آن پارامتر='NLS_CHARACTERSET' یا پارامتر='NLS_NCHAR_CHARACTERSET'; حالا دیتابیس را آماده کنید: سی دی /path/to/zabbix-sources/database/oracle sqlplus zabbix/password@oracle_host/ORCL sqlplus> @schema.sql اگر در حال ایجاد پایگاه داده برای پروکسی Zabbix هستید، در اینجا توقف کنید sqlplus> @images.sql sqlplus> @data.sql ::: یادداشت لطفاً پارامتر مقداردهی اولیه را تنظیم کنید CURSOR\_SHARING=FORCE برای بهترین عملکرد. ::: ## Databases ## پایگاه های داده ## Databases #### Supported versions PostgreSQL **16** and MariaDB **11.1** are now supported. See also: [Requirements](/manual/installation/requirements#third-party-external-surrounding-software). ## پایگاه های داده #### نسخه های پشتیبانی شده PostgreSQL **16** و MariaDB **11.1** اکنون پشتیبانی می شوند. همچنین ببینید: [نیازها](/دستی/نصب/نیازها#نرم‌افزار-خارجی-شخصی-ثالث). # dcheck.get # dcheck.get ### Default values for Zabbix agent 2 Zabbix agent 2 plugins now allow to define default values for connecting to monitoring targets in the configuration file. If no value is specified in an item key or a named session, the plugin will use the value defined in the corresponding default parameter. New parameters have the structure `Plugins.<PluginName>.Default.<Parameter>` - for example, `Plugins.MongoDB.Default.Uri=tcp://localhost:27017`. See for more info: - [Configuring plugins](/manual/config/items/plugins#configuring-plugins) - [Plugin configuration file parameters](/manual/appendix/config/zabbix_agent2_plugins) ### مقادیر پیش‌فرض برای عامل Zabbix 2 افزونه‌های Zabbix agent 2 اکنون اجازه می‌دهند تا مقادیر پیش‌فرض را برای اتصال به اهداف نظارتی در فایل پیکربندی تعریف کنند. اگر هیچ مقداری در یک کلید آیتم یا جلسه ای با نام مشخص نشده باشد، افزونه از مقدار تعریف شده در پارامتر پیش فرض مربوطه استفاده می کند. پارامترهای جدید دارای ساختار "Plugins.<PluginName>.Default.<Parameter>" هستند - برای مثال، "Plugins.MongoDB.Default.Uri=tcp://localhost:27017". برای اطلاعات بیشتر مراجعه کنید: - [پیکربندی پلاگین‌ها](/دستی/کانفیگ/ایتم/پلاگین#پیکربندی-پلاگین) - [پارامترهای فایل پیکربندی افزونه](/manual/appendix/config/zabbix_agent2_plugins) #### Delete a host interface Delete the host interface with ID 30062. Request: ```json { "jsonrpc": "2.0", "method": "hostinterface.delete", "params": [ "30062" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "interfaceids": [ "30062" ] }, "id": 1 } ``` #### حذف اینترفیس هاست Delete the host interface with ID 30062. Request: ```json { "jsonrpc": "2.0", "method": "hostinterface.delete", "params": [ "30062" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "interfaceids": [ "30062" ] }, "id": 1 } ``` #### Delete multiple actions Delete two actions. Request: ```json { "jsonrpc": "2.0", "method": "action.delete", "params": [ "17", "18" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "actionids": [ "17", "18" ] }, "id": 1 } ``` #### پاک کردن چندین اکشن پاک کردن دو اکشن . Request: ```json { "jsonrpc": "2.0", "method": "action.delete", "params": [ "17", "18" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "actionids": [ "17", "18" ] }, "id": 1 } ``` #### Delete multiple correlations Delete two correlations. Request: ```json { "jsonrpc": "2.0", "method": "correlation.delete", "params": [ "1", "2" ], "auth": "343baad4f88b4106b9b5961e77437688", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "correlationids": [ "1", "2" ] }, "id": 1 } ``` #### همبستگی های متعدد را حذف کنید حذف دو همبستگی درخواست: ``json { "jsonrpc": "2.0"، "روش": "correlation.delete"، "params": [ "1"، "2" ]، "auth": "343baad4f88b4106b9b5961e77437688"، "id": 1 } ``` واکنش: ``json { "jsonrpc": "2.0"، "نتیجه": { "همبستگی ها": [ "1"، "2" ] }، "id": 1 } ``` #### Delete multiple discovery rules Delete two discovery rules. Request: ```json { "jsonrpc": "2.0", "method": "drule.delete", "params": [ "4", "6" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "druleids": [ "4", "6" ] }, "id": 1 } ``` #### پاک کردن چندین قانون جست و جو پاک کردن دوتا : Request: ```json { "jsonrpc": "2.0", "method": "drule.delete", "params": [ "4", "6" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "druleids": [ "4", "6" ] }, "id": 1 } ``` #### Delete multiple icon maps Delete two icon maps. Request: ```json { "jsonrpc": "2.0", "method": "iconmap.delete", "params": [ "2", "5" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "iconmapids": [ "2", "5" ] }, "id": 1 } ``` #### حذف چندین آیکون مپ Delete two icon maps. Request: ```json { "jsonrpc": "2.0", "method": "iconmap.delete", "params": [ "2", "5" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "iconmapids": [ "2", "5" ] }, "id": 1 } ``` #### Delete multiple images Delete two images. Request: ```json { "jsonrpc": "2.0", "method": "image.delete", "params": [ "188", "192" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "imageids": [ "188", "192" ] }, "id": 1 } ``` #### حذف دو تصویر Delete two images. Request: ```json { "jsonrpc": "2.0", "method": "image.delete", "params": [ "188", "192" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "imageids": [ "188", "192" ] }, "id": 1 } ``` #### Delete multiple maps Delete two maps. Request: ```json { "jsonrpc": "2.0", "method": "map.delete", "params": [ "12", "34" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "sysmapids": [ "12", "34" ] }, "id": 1 } ``` #### حذف چندین آیکون مپ Delete two icon maps. Request: ```json { "jsonrpc": "2.0", "method": "iconmap.delete", "params": [ "2", "5" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "iconmapids": [ "2", "5" ] }, "id": 1 } ``` #### Delete multiple proxies Delete two proxies. Request: ```json { "jsonrpc": "2.0", "method": "proxy.delete", "params": [ "10286", "10285" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "proxyids": [ "10286", "10285" ] }, "id": 1 } ``` حذف دو تصویر. درخواست:```json{"jsonrpc": "2.0"،"روش": "image.delete"،"params": ["188"،"192"],"auth": "3a57200802b24cda67c4e4010b50c065" "id": 1}``` پاسخ:```json{"jsonrpc": "2.0"، "result": {"imageids": ["188"،"192"]}"id": 1 } #### Delete multiple scripts Delete two scripts. Request: ```json { "jsonrpc": "2.0", "method": "script.delete", "params": [ "3", "4" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "scriptids": [ "3", "4" ] }, "id": 1 } ``` #### پاک کردن چندین اکشن پاک کردن دو اکشن . Request: ```json { "jsonrpc": "2.0", "method": "action.delete", "params": [ "17", "18" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "actionids": [ "17", "18" ] }, "id": 1 } ``` #### Delete multiple tokens Delete two tokens. Request: ```json { "jsonrpc": "2.0", "method": "token.delete", "params": [ "188", "192" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "tokenids": [ "188", "192" ] }, "id": 1 } ``` حذف دو تصویر. درخواست:```json{"jsonrpc": "2.0"،"روش": "image.delete"،"params": ["188"،"192"],"auth": "3a57200802b24cda67c4e4010b50c065" "id": 1}``` پاسخ:```json{"jsonrpc": "2.0"، "result": {"imageids": ["188"،"192"]}"id": 1 } #### Deleting multiple dashboards Delete two dashboards. Request: ```json { "jsonrpc": "2.0", "method": "dashboard.delete", "params": [ "2", "3" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "2", "3" ] }, "id": 1 } ``` #### پاک کردن چندین داشبورد پاک کردن دو داشبورد. Request: ```json { "jsonrpc": "2.0", "method": "dashboard.delete", "params": [ "2", "3" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "2", "3" ] }, "id": 1 } ``` #### Deleting multiple global regular expressions. Request: ```json { "jsonrpc": "2.0", "method": "regexp.delete", "params": [ "16", "17" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "regexpids": [ "16", "17" ] }, "id": 1 } ``` #### حذف چندین گراف Delete two graphs. Request: ```json { "jsonrpc": "2.0", "method": "graph.delete", "params": [ "652", "653" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "graphids": [ "652", "653" ] }, "id": 1 } ``` #### Deleting multiple graph prototypes Delete two graph prototypes. Request: ```json { "jsonrpc": "2.0", "method": "graphprototype.delete", "params": [ "652", "653" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "graphids": [ "652", "653" ] }, "id": 1 } ``` #### حذف چندین نمونه اولیه گراف Delete two graph prototypes. Request: ```json { "jsonrpc": "2.0", "method": "graphprototype.delete", "params": [ "652", "653" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "graphids": [ "652", "653" ] }, "id": 1 } ``` #### Deleting multiple graphs Delete two graphs. Request: ```json { "jsonrpc": "2.0", "method": "graph.delete", "params": [ "652", "653" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "graphids": [ "652", "653" ] }, "id": 1 } ``` #### حذف چندین گراف Delete two graphs. Request: ```json { "jsonrpc": "2.0", "method": "graph.delete", "params": [ "652", "653" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "graphids": [ "652", "653" ] }, "id": 1 } ``` #### Deleting multiple host groups Delete two host groups. Request: ```json { "jsonrpc": "2.0", "method": "hostgroup.delete", "params": [ "107824", "107825" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "groupids": [ "107824", "107825" ] }, "id": 1 } ``` #### حذف چندین گروه هاستی Delete two host groups. Request: ```json { "jsonrpc": "2.0", "method": "hostgroup.delete", "params": [ "107824", "107825" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "groupids": [ "107824", "107825" ] }, "id": 1 } ``` #### Deleting multiple host prototypes Delete two host prototypes. Request: ```json { "jsonrpc": "2.0", "method": "hostprototype.delete", "params": [ "10103", "10105" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "hostids": [ "10103", "10105" ] }, "id": 1 } ``` #### حذف چندین نمونه اولیه هاست Delete two host prototypes. Request: ```json { "jsonrpc": "2.0", "method": "hostprototype.delete", "params": [ "10103", "10105" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "hostids": [ "10103", "10105" ] }, "id": 1 } ``` #### Deleting multiple hosts Delete two hosts. Request: ```json { "jsonrpc": "2.0", "method": "host.delete", "params": [ "13", "32" ], "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "hostids": [ "13", "32" ] }, "id": 1 } ``` #### حذف چندین هاست Delete two hosts. Request: ```json { "jsonrpc": "2.0", "method": "host.delete", "params": [ "13", "32" ], "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "hostids": [ "13", "32" ] }, "id": 1 } ``` #### Deleting multiple LLD rules Delete two LLD rules. Request: ```json { "jsonrpc": "2.0", "method": "discoveryrule.delete", "params": [ "27665", "27668" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "ruleids": [ "27665", "27668" ] }, "id": 1 } ``` #### پاک کردن چندین قوانین LLD Delete two LLD rules. Request: ```json { "jsonrpc": "2.0", "method": "discoveryrule.delete", "params": [ "27665", "27668" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "ruleids": [ "27665", "27668" ] }, "id": 1 } ``` #### Deleting multiple maintenance periods Delete two maintenance periods. Request: ```json { "jsonrpc": "2.0", "method": "maintenance.delete", "params": [ "3", "1" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "maintenanceids": [ "3", "1" ] }, "id": 1 } ``` #### پاک کردن چندین اکشن پاک کردن دو اکشن . Request: ```json { "jsonrpc": "2.0", "method": "action.delete", "params": [ "17", "18" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "actionids": [ "17", "18" ] }, "id": 1 } ``` #### Deleting multiple scheduled reports Delete two scheduled reports. Request: ```json { "jsonrpc": "2.0", "method": "report.delete", "params": [ "1", "2" ], "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "reportids": [ "1", "2" ] }, "id": 1 } ``` #### حذف چندین هاست Delete two hosts. Request: ```json { "jsonrpc": "2.0", "method": "host.delete", "params": [ "13", "32" ], "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "hostids": [ "13", "32" ] }, "id": 1 } ``` #### Deleting multiple value maps Delete two value maps. Request: ```json { "jsonrpc": "2.0", "method": "valuemap.delete", "params": [ "1", "2" ], "auth": "57562fd409b3b3b9a4d916d45207bbcb", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "valuemapids": [ "1", "2" ] }, "id": 1 } ``` #### حذف چندین آیکون مپ Delete two icon maps. Request: ```json { "jsonrpc": "2.0", "method": "iconmap.delete", "params": [ "2", "5" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "iconmapids": [ "2", "5" ] }, "id": 1 } ``` #### Deleting multiple web scenarios Delete two web scenarios. Request: ```json { "jsonrpc": "2.0", "method": "httptest.delete", "params": [ "2", "3" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "httptestids": [ "2", "3" ] }, "id": 1 } ``` #### حذف چندین وب سناریو Delete two web scenarios. Request: ```json { "jsonrpc": "2.0", "method": "httptest.delete", "params": [ "2", "3" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "httptestids": [ "2", "3" ] }, "id": 1 } ``` ### Description `array configuration.importcompare(object parameters)` This method allows to compare import file with current system elements and shows what will be changed if this import file will be imported. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### شرح `configuration.importcompare آرایه (پارامترهای شیء)` این روش اجازه می دهد تا فایل وارداتی را با عناصر سیستم فعلی مقایسه کنید و نشان می دهد که اگر این فایل وارداتی وارد شود، چه چیزی تغییر خواهد کرد. ::: توجه این روش برای کاربران از هر نوع در دسترس است. مجوزها برای فراخوانی روش را می توان در تنظیمات نقش کاربر لغو کرد. [کاربر roles](/manual/web_interface/frontend_sections/administration/user_roles) برای اطلاعات بیشتر. ::: ### Description `boolean configuration.import(object parameters)` This method allows to import configuration data from a serialized string. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### شرح "object iconmap.update(object/array iconMaps)". این روش اجازه می دهد تا نقشه های آیکون موجود را به روز کنید. ::: توجه : این روش فقط برای کاربر *Super Admin* موجود است. دسترسی امکان لغو روش های فراخوانی در بخش تنظیمات کاربر می باشد . (در مسیر زیر) (/manual/web_interface/frontend_sections/administration/user_roles) برای اطلاعات بیشتر. ::: ### Description `integer/array action.get(object parameters)` The method allows to retrieve actions according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### شرح «عداد صحیح/آرایه action.get (پارامترهای شی)». این روش اجازه می دهد تا اقدامات را با توجه به پارامترهای داده شده بازیابی کنید. ::: نوتکلاسیک این روش برای کاربران از هر نوع در دسترس است. مجوزها برای فراخوانی روش را می توان در تنظیمات نقش کاربر لغو کرد. [کاربر roles](/manual/web_interface/frontend_sections/administration/user_roles) برای اطلاعات بیشتر. ::: ### Description `integer/array alert.get(object parameters)` The method allows to retrieve alerts according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### شرح `alert.get(پارامترهای شیء) عدد صحیح/آرایه` این روش اجازه می دهد تا هشدارها را با توجه به پارامترهای داده شده بازیابی کنید. ::: نوتکلاسیک این روش برای کاربران از هر نوع در دسترس است. مجوزها برای فراخوانی روش را می توان در تنظیمات نقش کاربر لغو کرد. [کاربر roles](/manual/web_interface/frontend_sections/administration/user_roles) برای اطلاعات بیشتر. ::: ### Description `integer/array auditlog.get(object parameters)` The method allows to retrieve audit log records according to the given parameters. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### شرح «عدد صحیح/آرایه auditlog.get(پارامترهای شی)». این روش امکان بازیابی سوابق گزارش حسابرسی را با توجه به موارد داده شده فراهم می کند مولفه های. ::: نوتکلاسیک این روش فقط برای نوع کاربری *Super Admin* موجود است. مجوزهای فراخوانی روش را می توان در تنظیمات نقش کاربر لغو کرد. دیدن [کاربر roles](/manual/web_interface/frontend_sections/administration/user_roles) برای اطلاعات بیشتر. ::: ### Description `integer/array correlation.get(object parameters)` The method allows to retrieve correlations according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### شرح "همبستگی عدد صحیح/آرایه.get(پارامترهای شیء)". این روش اجازه می دهد تا همبستگی ها را مطابق با داده شده بازیابی کنید مولفه های. ::: نوتکلاسیک این روش برای کاربران از هر نوع در دسترس است. مجوزها برای فراخوانی روش را می توان در تنظیمات نقش کاربر لغو کرد. [کاربر roles](/manual/web_interface/frontend_sections/administration/user_roles) برای اطلاعات بیشتر. ::: ### Description `integer/array dashboard.get(object parameters)` The method allows to retrieve dashboards according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### شرح "همبستگی عدد صحیح/آرایه.get(پارامترهای شیء)". این روش اجازه می دهد تا همبستگی ها را مطابق با داده شده بازیابی کنید مولفه های. ::: نوتکلاسیک این روش برای کاربران از هر نوع در دسترس است. مجوزها برای فراخوانی روش را می توان در تنظیمات نقش کاربر لغو کرد. [کاربر roles](/manual/web_interface/frontend_sections/administration/user_roles) برای اطلاعات بیشتر. ::: ### Description `integer/array dcheck.get(object parameters)` The method allows to retrieve discovery checks according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### شرح `object authentication.get(پارامترهای شیء)` این روش امکان بازیابی شی احراز هویت را با توجه به پارامترهای داده شده می دهد . ::: توجه : این روش فقط برای نوع کاربری *Super Admin* موجود است. مجوزهای فراخوانی روش را می توان در تنظیمات نقش کاربر لغو کرد. roles](/manual/web_interface/frontend_sections/administration/user_roles) برای اطلاعات بیشتر. ::: ### Description `integer/array dhost.get(object parameters)` The method allows to retrieve discovered hosts according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### شرح `object authentication.get(پارامترهای شیء)` این روش امکان بازیابی شی احراز هویت را با توجه به پارامترهای داده شده می دهد . ::: توجه : این روش فقط برای نوع کاربری *Super Admin* موجود است. مجوزهای فراخوانی روش را می توان در تنظیمات نقش کاربر لغو کرد. roles](/manual/web_interface/frontend_sections/administration/user_roles) برای اطلاعات بیشتر. ::: ### Description `integer/array discoveryrule.get(object parameters)` The method allows to retrieve LLD rules according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### شرح `alert.get(پارامترهای شیء) عدد صحیح/آرایه` این روش اجازه می دهد تا هشدارها را با توجه به پارامترهای داده شده بازیابی کنید. ::: نوتکلاسیک این روش برای کاربران از هر نوع در دسترس است. مجوزها برای فراخوانی روش را می توان در تنظیمات نقش کاربر لغو کرد. [کاربر roles](/manual/web_interface/frontend_sections/administration/user_roles) برای اطلاعات بیشتر. ::: ### Description `integer/array drule.get(object parameters)` The method allows to retrieve discovery rules according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### شرح `object authentication.get(پارامترهای شیء)` این روش امکان بازیابی شی احراز هویت را با توجه به پارامترهای داده شده می دهد . ::: توجه : این روش فقط برای نوع کاربری *Super Admin* موجود است. مجوزهای فراخوانی روش را می توان در تنظیمات نقش کاربر لغو کرد. roles](/manual/web_interface/frontend_sections/administration/user_roles) برای اطلاعات بیشتر. ::: ### Description `integer/array dservice.get(object parameters)` The method allows to retrieve discovered services according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### شرح `object authentication.get(پارامترهای شیء)` این روش امکان بازیابی شی احراز هویت را با توجه به پارامترهای داده شده می دهد . ::: توجه : این روش فقط برای نوع کاربری *Super Admin* موجود است. مجوزهای فراخوانی روش را می توان در تنظیمات نقش کاربر لغو کرد. roles](/manual/web_interface/frontend_sections/administration/user_roles) برای اطلاعات بیشتر. ::: ### Description `integer/array event.get(object parameters)` The method allows to retrieve events according to the given parameters. ::: noteimportant This method may return events of a deleted entity if these events have not been removed by the housekeeper yet. ::: ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### توضیحات `integer/array event.get(object parameters)` The method allows to retrieve events according to the given parameters. ::: noteimportant This method may return events of a deleted entity if these events have not been removed by the housekeeper yet. ::: ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Description `integer/array graph.get(object parameters)` The method allows to retrieve graphs according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### توضیحات `integer/array graph.get(object parameters)` The method allows to retrieve graphs according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Description `integer/array graphitem.get(object parameters)` The method allows to retrieve graph items according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### توضیحات `integer/array graphitem.get(object parameters)` The method allows to retrieve graph items according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Description `integer/array graphprototype.get(object parameters)` The method allows to retrieve graph prototypes according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ###توضیحات `integer/array graphprototype.get(object parameters)` The method allows to retrieve graph prototypes according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Description `integer/array hanode.get(object parameters)` The method allows to retrieve a list of High availability cluster nodes according to the given parameters. ::: noteclassic This method is only available to *Super admin* user types. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### توضیحات `integer/array hanode.get(object parameters)` The method allows to retrieve a list of High availability cluster nodes according to the given parameters. ::: noteclassic This method is only available to *Super admin* user types. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Description `integer/array host.get(object parameters)` The method allows to retrieve hosts according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### شرح `object authentication.get(پارامترهای شیء)` این روش امکان بازیابی شی احراز هویت را با توجه به پارامترهای داده شده می دهد . ::: توجه : این روش فقط برای نوع کاربری *Super Admin* موجود است. مجوزهای فراخوانی روش را می توان در تنظیمات نقش کاربر لغو کرد. roles](/manual/web_interface/frontend_sections/administration/user_roles) برای اطلاعات بیشتر. ::: ### Description `integer/array hostgroup.get(object parameters)` The method allows to retrieve host groups according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### توضیحات `integer/array hostgroup.get(object parameters)` The method allows to retrieve host groups according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Description `integer/array hostinterface.get(object parameters)` The method allows to retrieve host interfaces according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### توضیحات `integer/array hostinterface.get(object parameters)` The method allows to retrieve host interfaces according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Description `integer/array hostprototype.get(object parameters)` The method allows to retrieve host prototypes according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ###توضیحات `integer/array hostprototype.get(object parameters)` The method allows to retrieve host prototypes according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Description `integer/array httptest.get(object parameters)` The method allows to retrieve web scenarios according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### توضیحات `integer/array httptest.get(object parameters)` The method allows to retrieve web scenarios according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Description `integer/array iconmap.get(object parameters)` The method allows to retrieve icon maps according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ###توضیحات `integer/array iconmap.get(object parameters)` The method allows to retrieve icon maps according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Description `integer/array image.get(object parameters)` The method allows to retrieve images according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: # توضیحات:`integer/array image.get(object parameters)` این روش اجازه می دهد تا تصاویر را با توجه به پارامترهای داده شده بازیابی کنید.::: noteclassicاین روش برای کاربران از هر نوع در دسترس است. مجوز برای فراخوانی روش را می توان در تنظیمات نقش کاربر لغو کرد. برای اطلاعات بیشتر به [Userroles](/manual/web_interface/frontend_sections/administration/user_roles) مراجعه کنید. ### Description `integer/array item.get(object parameters)` The method allows to retrieve items according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: `integer/array image.get(object parameters)` این روش اجازه می دهد تا تصاویر را با توجه به پارامترهای داده شده بازیابی کنید.::: noteclassicاین روش برای کاربران از هر نوع در دسترس است. مجوز برای فراخوانی روش را می توان در تنظیمات نقش کاربر لغو کرد. برای اطلاعات بیشتر به [Userroles](/manual/web_interface/frontend_sections/administration/user_roles) مراجعه کنید. ### Description `integer/array itemprototype.get(object parameters)` The method allows to retrieve item prototypes according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ###توضیحات `integer/array hostprototype.get(object parameters)` The method allows to retrieve host prototypes according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Description `integer/array maintenance.get(object parameters)` The method allows to retrieve maintenances according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: `integer/array image.get(object parameters)` این روش اجازه می دهد تا تصاویر را با توجه به پارامترهای داده شده بازیابی کنید.::: noteclassicاین روش برای کاربران از هر نوع در دسترس است. مجوز برای فراخوانی روش را می توان در تنظیمات نقش کاربر لغو کرد. برای اطلاعات بیشتر به [Userroles](/manual/web_interface/frontend_sections/administration/user_roles) مراجعه کنید. ### Description `integer/array problem.get(object parameters)` The method allows to retrieve problems according to the given parameters. This method is for retrieving unresolved problems. It is also possible, if specified, to additionally retrieve recently resolved problems. The period that determines how old is "recently" is defined in *Administration* → *[General](/manual/web_interface/frontend_sections/administration/general#trigger_displaying_options)*. Problems that were resolved prior to that period are not kept in the problem table. To retrieve problems that were resolved further back in the past, use the [event.get](/manual/api/reference/event/get) method. ::: noteimportant This method may return problems of a deleted entity if these problems have not been removed by the housekeeper yet. ::: ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### شرح `problem.get(پارامترهای شیء) عدد صحیح/آرایه` این روش اجازه می دهد تا مشکلات را مطابق با داده شده بازیابی کنید مولفه های. این روش برای بازیابی مشکلات حل نشده است. همچنین ممکن است، در صورت مشخص شدن، برای بازیابی مشکلات اخیراً حل شده نیز. این دوره ای که تعیین می کند "اخیرا" چند ساله است در تعریف شده است *اداره* → *[General](/manual/web_interface/frontend_sections/administration/general#trigger_displaying_options)*. مشکلاتی که قبل از آن دوره حل شده اند در آن نگهداری نمی شوند جدول مشکل برای بازیابی مشکلاتی که در ادامه حل شده اند در گذشته، از روش [event.get](/manual/api/reference/event/get) استفاده کنید. ::: نکته مهم این روش ممکن است مشکلات حذف شده را برگرداند در صورتی که این مشکلات توسط متصدی خانه برطرف نشده باشد هنوز. ::: ::: نوتکلاسیک این روش برای کاربران از هر نوع در دسترس است. مجوزها برای فراخوانی روش را می توان در تنظیمات نقش کاربر لغو کرد. [کاربر roles](/manual/web_interface/frontend_sections/administration/user_roles) برای اطلاعات بیشتر. ::: ### Description `integer/array regexp.get(object parameters)` The method allows to retrieve global regular expressions according to the given parameters. ::: noteclassic This method is available only to *Super Admin*. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### توضیحات `integer/array graph.get(object parameters)` The method allows to retrieve graphs according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Description `integer/array role.get(object parameters)` The method allows to retrieve roles according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### شرح `alert.get(پارامترهای شیء) عدد صحیح/آرایه` این روش اجازه می دهد تا هشدارها را با توجه به پارامترهای داده شده بازیابی کنید. ::: نوتکلاسیک این روش برای کاربران از هر نوع در دسترس است. مجوزها برای فراخوانی روش را می توان در تنظیمات نقش کاربر لغو کرد. [کاربر roles](/manual/web_interface/frontend_sections/administration/user_roles) برای اطلاعات بیشتر. ::: ### Description `integer/array sla.get(object parameters)` The method allows to retrieve SLA objects according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### شرح `object authentication.get(پارامترهای شیء)` این روش امکان بازیابی شی احراز هویت را با توجه به پارامترهای داده شده می دهد . ::: توجه : این روش فقط برای نوع کاربری *Super Admin* موجود است. مجوزهای فراخوانی روش را می توان در تنظیمات نقش کاربر لغو کرد. roles](/manual/web_interface/frontend_sections/administration/user_roles) برای اطلاعات بیشتر. ::: ### Description `integer/array templatedashboard.get(object parameters)` The method allows to retrieve template dashboards according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### شرح "همبستگی عدد صحیح/آرایه.get(پارامترهای شیء)". این روش اجازه می دهد تا همبستگی ها را مطابق با داده شده بازیابی کنید مولفه های. ::: نوتکلاسیک این روش برای کاربران از هر نوع در دسترس است. مجوزها برای فراخوانی روش را می توان در تنظیمات نقش کاربر لغو کرد. [کاربر roles](/manual/web_interface/frontend_sections/administration/user_roles) برای اطلاعات بیشتر. ::: ### Description `integer/array template.get(object parameters)` The method allows to retrieve templates according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: `integer/array image.get(object parameters)` این روش اجازه می دهد تا تصاویر را با توجه به پارامترهای داده شده بازیابی کنید.::: noteclassicاین روش برای کاربران از هر نوع در دسترس است. مجوز برای فراخوانی روش را می توان در تنظیمات نقش کاربر لغو کرد. برای اطلاعات بیشتر به [Userroles](/manual/web_interface/frontend_sections/administration/user_roles) مراجعه کنید. ### Description `integer/array triggerprototype.get(object parameters)` The method allows to retrieve trigger prototypes according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ###توضیحات `integer/array hostprototype.get(object parameters)` The method allows to retrieve host prototypes according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Description `integer/array usergroup.get(object parameters)` The method allows to retrieve user groups according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### توضیحات `integer/array hostgroup.get(object parameters)` The method allows to retrieve host groups according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Description `integer/array usermacro.get(object parameters)` The method allows to retrieve host and global macros according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### شرح `object authentication.get(پارامترهای شیء)` این روش امکان بازیابی شی احراز هویت را با توجه به پارامترهای داده شده می دهد . ::: توجه : این روش فقط برای نوع کاربری *Super Admin* موجود است. مجوزهای فراخوانی روش را می توان در تنظیمات نقش کاربر لغو کرد. roles](/manual/web_interface/frontend_sections/administration/user_roles) برای اطلاعات بیشتر. ::: ### Description `integer/array valuemap.get(object parameters)` The method allows to retrieve value maps according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### شرح `alert.get(پارامترهای شیء) عدد صحیح/آرایه` این روش اجازه می دهد تا هشدارها را با توجه به پارامترهای داده شده بازیابی کنید. ::: نوتکلاسیک این روش برای کاربران از هر نوع در دسترس است. مجوزها برای فراخوانی روش را می توان در تنظیمات نقش کاربر لغو کرد. [کاربر roles](/manual/web_interface/frontend_sections/administration/user_roles) برای اطلاعات بیشتر. ::: ### Description `object action.create(object/array actions)` This method allows to create new actions. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### شرح "عملکرد شیء. ایجاد (عملکردهای شی/آرایه)". این روش امکان ایجاد اقدامات جدید را فراهم می کند. ::: توجه این روش فقط برای *Admin* و *Super Admin* در دسترس است انواع کاربر مجوزهای فراخوانی متد را می توان در نقش کاربر لغو کرد تنظیمات. [کاربر roles](/manual/web_interface/frontend_sections/administration/user_roles) برای اطلاعات بیشتر. ::: ### Description `object action.delete(array actionIds)` This method allows to delete actions. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### شرح "object iconmap.update(object/array iconMaps)". این روش اجازه می دهد تا نقشه های آیکون موجود را به روز کنید. ::: توجه : این روش فقط برای کاربر *Super Admin* موجود است. دسترسی امکان لغو روش های فراخوانی در بخش تنظیمات کاربر می باشد . (در مسیر زیر) (/manual/web_interface/frontend_sections/administration/user_roles) برای اطلاعات بیشتر. ::: ### Description `object action.update(object/array actions)` This method allows to update existing actions. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### شرح `object action.update(عملکرد شی/آرایه)` این روش اجازه می دهد تا اقدامات موجود را به روز کنید. ::: نوتکلاسیک این روش فقط برای *Admin* و *Super Admin* در دسترس است انواع کاربر مجوزهای فراخوانی متد را می توان در نقش کاربر لغو کرد تنظیمات. [کاربر roles](/manual/web_interface/frontend_sections/administration/user_roles) برای اطلاعات بیشتر. ::: ### Description `object authentication.get(object parameters)` The method allows to retrieve authentication object according to the given parameters. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### شرح `object authentication.get(پارامترهای شیء)` این روش امکان بازیابی شی احراز هویت را با توجه به پارامترهای داده شده می دهد . ::: توجه : این روش فقط برای نوع کاربری *Super Admin* موجود است. مجوزهای فراخوانی روش را می توان در تنظیمات نقش کاربر لغو کرد. roles](/manual/web_interface/frontend_sections/administration/user_roles) برای اطلاعات بیشتر. ::: ### Description `object authentication.update(object authentication)` This method allows to update existing authentication settings. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### شرح "object iconmap.update(object/array iconMaps)". این روش اجازه می دهد تا نقشه های آیکون موجود را به روز کنید. ::: توجه : این روش فقط برای کاربر *Super Admin* موجود است. دسترسی امکان لغو روش های فراخوانی در بخش تنظیمات کاربر می باشد . (در مسیر زیر) (/manual/web_interface/frontend_sections/administration/user_roles) برای اطلاعات بیشتر. ::: ### Description `object autoregistration.get(object parameters)` The method allows to retrieve autoregistration object according to the given parameters. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### شرح `object authentication.get(پارامترهای شیء)` این روش امکان بازیابی شی احراز هویت را با توجه به پارامترهای داده شده می دهد . ::: توجه : این روش فقط برای نوع کاربری *Super Admin* موجود است. مجوزهای فراخوانی روش را می توان در تنظیمات نقش کاربر لغو کرد. roles](/manual/web_interface/frontend_sections/administration/user_roles) برای اطلاعات بیشتر. ::: ### Description `object autoregistration.update(object autoregistration)` This method allows to update existing autoregistration. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### شرح "object iconmap.update(object/array iconMaps)". این روش اجازه می دهد تا نقشه های آیکون موجود را به روز کنید. ::: توجه : این روش فقط برای کاربر *Super Admin* موجود است. دسترسی امکان لغو روش های فراخوانی در بخش تنظیمات کاربر می باشد . (در مسیر زیر) (/manual/web_interface/frontend_sections/administration/user_roles) برای اطلاعات بیشتر. ::: ### Description `object correlation.create(object/array correlations)` This method allows to create new correlations. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### شرح "object iconmap.update(object/array iconMaps)". این روش اجازه می دهد تا نقشه های آیکون موجود را به روز کنید. ::: توجه : این روش فقط برای کاربر *Super Admin* موجود است. دسترسی امکان لغو روش های فراخاونی در بخش تنظیمات کاربر می باشد . (در مسیر زیر) (/manual/web_interface/frontend_sections/administration/user_roles) برای اطلاعات بیشتر. ::: ### Description `object correlation.delete(array correlationids)` This method allows to delete correlations. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### شرح `object correlation.delete(array correlationids)` این روش اجازه می دهد تا همبستگی ها را حذف کنید. ::: نوتکلاسیک این روش فقط برای نوع کاربری *Super Admin* موجود است. مجوزهای فراخوانی روش را می توان در تنظیمات نقش کاربر لغو کرد. دیدن [کاربر roles](/manual/web_interface/frontend_sections/administration/user_roles) برای اطلاعات بیشتر. ::: ### Description `object correlation.update(object/array correlations)` This method allows to update existing correlations. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### شرح `object correlation.update(object/array correlation)` این روش امکان به روز رسانی همبستگی های موجود را فراهم می کند. ::: نوتکلاسیک این روش فقط برای نوع کاربری *Super Admin* موجود است. مجوزهای فراخوانی روش را می توان در تنظیمات نقش کاربر لغو کرد. دیدن [کاربر roles](/manual/web_interface/frontend_sections/administration/user_roles) برای اطلاعات بیشتر. ::: ### Description `object dashboard.create(object/array dashboards)` This method allows to create new dashboards. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### شرح `object correlation.update(object/array correlation)` این روش امکان به روز رسانی همبستگی های موجود را فراهم می کند. ::: نوتکلاسیک این روش فقط برای نوع کاربری *Super Admin* موجود است. مجوزهای فراخوانی روش را می توان در تنظیمات نقش کاربر لغو کرد. دیدن [کاربر roles](/manual/web_interface/frontend_sections/administration/user_roles) برای اطلاعات بیشتر. ::: ### Description `object dashboard.delete(array dashboardids)` This method allows to delete dashboards. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### شرح "عملکرد شیء. ایجاد (عملکردهای شی/آرایه)". این روش امکان ایجاد اقدامات جدید را فراهم می کند. ::: توجه این روش فقط برای *Admin* و *Super Admin* در دسترس است انواع کاربر مجوزهای فراخوانی متد را می توان در نقش کاربر لغو کرد تنظیمات. [کاربر roles](/manual/web_interface/frontend_sections/administration/user_roles) برای اطلاعات بیشتر. ::: ### Description `object dashboard.update(object/array dashboards)` This method allows to update existing dashboards. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### شرح این روش اجازه می دهد تا داشبورد موجود را به روز کنید. ::: توجه : این روش فقط برای کاربر *Super Admin* موجود است. دسترسی امکان لغو روش های فراخوانی در بخش تنظیمات کاربر می باشد . (در مسیر زیر) (/manual/web_interface/frontend_sections/administration/user_roles) برای اطلاعات بیشتر. ::: ### Description `object discoveryrule.copy(object parameters)` This method allows to copy LLD rules with all of the prototypes to the given hosts. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### شرح `object correlation.update(object/array correlation)` این روش امکان به روز رسانی همبستگی های موجود را فراهم می کند. ::: نوتکلاسیک این روش فقط برای نوع کاربری *Super Admin* موجود است. مجوزهای فراخوانی روش را می توان در تنظیمات نقش کاربر لغو کرد. دیدن [کاربر roles](/manual/web_interface/frontend_sections/administration/user_roles) برای اطلاعات بیشتر. ::: ### Description `object discoveryrule.create(object/array lldRules)` This method allows to create new LLD rules. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### شرح `object action.update(عملکرد شی/آرایه)` این روش اجازه می دهد تا اقدامات موجود را به روز کنید. ::: نوتکلاسیک این روش فقط برای *Admin* و *Super Admin* در دسترس است انواع کاربر مجوزهای فراخوانی متد را می توان در نقش کاربر لغو کرد تنظیمات. [کاربر roles](/manual/web_interface/frontend_sections/administration/user_roles) برای اطلاعات بیشتر. ::: ### Description `object discoveryrule.delete(array lldRuleIds)` This method allows to delete LLD rules. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### شرح `object action.update(عملکرد شی/آرایه)` این روش اجازه می دهد تا اقدامات موجود را به روز کنید. ::: نوتکلاسیک این روش فقط برای *Admin* و *Super Admin* در دسترس است انواع کاربر مجوزهای فراخوانی متد را می توان در نقش کاربر لغو کرد تنظیمات. [کاربر roles](/manual/web_interface/frontend_sections/administration/user_roles) برای اطلاعات بیشتر. ::: ### Description `object discoveryrule.update(object/array lldRules)` This method allows to update existing LLD rules. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### شرح `object action.update(عملکرد شی/آرایه)` این روش اجازه می دهد تا اقدامات موجود را به روز کنید. ::: نوتکلاسیک این روش فقط برای *Admin* و *Super Admin* در دسترس است انواع کاربر مجوزهای فراخوانی متد را می توان در نقش کاربر لغو کرد تنظیمات. [کاربر roles](/manual/web_interface/frontend_sections/administration/user_roles) برای اطلاعات بیشتر. ::: ### Description `object drule.create(object/array discoveryRules)` This method allows to create new discovery rules. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### شرح "object iconmap.update(object/array iconMaps)". این روش اجازه می دهد تا قانون جست و جو جدیدی بسازید ::: توجه : این روش فقط برای کاربر *Super Admin* موجود است. دسترسی امکان لغو روش های فراخاونی در بخش تنظیمات کاربر می باشد . (در مسیر زیر) (/manual/web_interface/frontend_sections/administration/user_roles) برای اطلاعات بیشتر. ::: ### Description `object drule.delete(array discoveryRuleIds)` This method allows to delete discovery rules. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### شرح بخش حذف قانون جست و جو این روش اجازه می دهد تا قانون جست و جو جدیدی بسازید ::: توجه : این روش فقط برای کاربر *Super Admin* موجود است. دسترسی امکان لغو روش های فراخاونی در بخش تنظیمات کاربر می باشد . (در مسیر زیر) (/manual/web_interface/frontend_sections/administration/user_roles) برای اطلاعات بیشتر. ::: ### Description `object drule.update(object/array discoveryRules)` This method allows to update existing discovery rules. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### شرح "object iconmap.update(object/array iconMaps)". این روش اجازه می دهد تا قانون جست و جو جدیدی بسازید ::: توجه : این روش فقط برای کاربر *Super Admin* موجود است. دسترسی امکان لغو روش های فراخاونی در بخش تنظیمات کاربر می باشد . (در مسیر زیر) (/manual/web_interface/frontend_sections/administration/user_roles) برای اطلاعات بیشتر. ::: ### Description `object graph.create(object/array graphs)` This method allows to create new graphs. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### توضیحات `object graph.create(object/array graphs)` This method allows to create new graphs. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Description `object graph.delete(array graphIds)` This method allows to delete graphs. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### توضیحات `object graph.delete(array graphIds)` This method allows to delete graphs. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Description `object graphprototype.create(object/array graphPrototypes)` This method allows to create new graph prototypes. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### توضیحات `object graphprototype.create(object/array graphPrototypes)` This method allows to create new graph prototypes. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Description `object graphprototype.delete(array graphPrototypeIds)` This method allows to delete graph prototypes. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### توضیحات `object graphprototype.delete(array graphPrototypeIds)` This method allows to delete graph prototypes. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Description `object graphprototype.update(object/array graphPrototypes)` This method allows to update existing graph prototypes. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ###توضیحات `object graphprototype.update(object/array graphPrototypes)` This method allows to update existing graph prototypes. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Description `object graph.update(object/array graphs)` This method allows to update existing graphs. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ###توضیحات `object graph.update(object/array graphs)` This method allows to update existing graphs. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Description `object history.clear(array itemids)` This method allows to clear item history. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### توضیحات `object history.clear(array itemids)` This method allows to clear item history. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Description `object host.create(object/array hosts)` This method allows to create new hosts. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### توضیحات `object host.create(object/array hosts)` This method allows to create new hosts. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Description `object host.delete(array hosts)` This method allows to delete hosts. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ###توضیحات `object host.delete(array hosts)` This method allows to delete hosts. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Description `object hostgroup.create(object/array hostGroups)` This method allows to create new host groups. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### توضیحات `object hostgroup.create(object/array hostGroups)` This method allows to create new host groups. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Description `object hostgroup.delete(array hostGroupIds)` This method allows to delete host groups. A host group can not be deleted if: - it contains hosts that belong to this group only; - it is marked as internal; - it is used by a host prototype; - it is used in a global script; - it is used in a correlation condition. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### توضیحات `object hostgroup.delete(array hostGroupIds)` This method allows to delete host groups. A host group can not be deleted if: - it contains hosts that belong to this group only; - it is marked as internal; - it is used by a host prototype; - it is used in a global script; - it is used in a correlation condition. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Description `object hostgroup.massadd(object parameters)` This method allows to simultaneously add multiple related objects to all the given host groups. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### توضیحات `object hostgroup.massadd(object parameters)` This method allows to simultaneously add multiple related objects to all the given host groups. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Description `object hostgroup.massremove(object parameters)` This method allows to remove related objects from multiple host groups. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ###توضیحات `object hostgroup.massremove(object parameters)` This method allows to remove related objects from multiple host groups. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Description `object hostgroup.massupdate(object parameters)` This method allows to replace hosts and templates with the specified ones in multiple host groups. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### توضیحات `object hostgroup.massupdate(object parameters)` This method allows to replace hosts and templates with the specified ones in multiple host groups. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Description `object hostgroup.update(object/array hostGroups)` This method allows to update existing hosts groups. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ###توضیحات `object hostgroup.update(object/array hostGroups)` This method allows to update existing hosts groups. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Description `object hostinterface.create(object/array hostInterfaces)` This method allows to create new host interfaces. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### توضیحات `object hostinterface.create(object/array hostInterfaces)` This method allows to create new host interfaces. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Description `object hostinterface.delete(array hostInterfaceIds)` This method allows to delete host interfaces. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### توضیحات `object hostinterface.delete(array hostInterfaceIds)` This method allows to delete host interfaces. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Description `object hostinterface.massadd(object parameters)` This method allows to simultaneously add host interfaces to multiple hosts. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### توضیحات `object hostinterface.massadd(object parameters)` This method allows to simultaneously add host interfaces to multiple hosts. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Description `object hostinterface.massremove(object parameters)` This method allows to remove host interfaces from the given hosts. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### توضیحات `object hostinterface.massremove(object parameters)` This method allows to remove host interfaces from the given hosts. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Description `object hostinterface.replacehostinterfaces(object parameters)` This method allows to replace all host interfaces on a given host. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### توضیحات `object hostinterface.replacehostinterfaces(object parameters)` This method allows to replace all host interfaces on a given host. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Description `object hostinterface.update(object/array hostInterfaces)` This method allows to update existing host interfaces. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### توضیحات `object hostinterface.update(object/array hostInterfaces)` This method allows to update existing host interfaces. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Description `object host.massadd(object parameters)` This method allows to simultaneously add multiple related objects to all the given hosts. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### توضیحات `object host.massadd(object parameters)` This method allows to simultaneously add multiple related objects to all the given hosts. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Description `object host.massremove(object parameters)` This method allows to remove related objects from multiple hosts. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ###توضیحات `object host.massremove(object parameters)` This method allows to remove related objects from multiple hosts. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Description `object host.massupdate(object parameters)` This method allows to simultaneously replace or remove related objects and update properties on multiple hosts. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### توضیحات `object host.massupdate(object parameters)` This method allows to simultaneously replace or remove related objects and update properties on multiple hosts. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Description `object hostprototype.create(object/array hostPrototypes)` This method allows to create new host prototypes. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ###توضیحات `object hostprototype.create(object/array hostPrototypes)` This method allows to create new host prototypes. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Description `object hostprototype.delete(array hostPrototypeIds)` This method allows to delete host prototypes. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### توضیحات `object hostprototype.delete(array hostPrototypeIds)` This method allows to delete host prototypes. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Description `object hostprototype.update(object/array hostPrototypes)` This method allows to update existing host prototypes. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### توضیحات `object hostprototype.update(object/array hostPrototypes)` This method allows to update existing host prototypes. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Description `object host.update(object/array hosts)` This method allows to update existing hosts. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ###توضیحات `object hostgroup.update(object/array hostGroups)` This method allows to update existing hosts groups. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Description `object housekeeping.get(object parameters)` The method allows to retrieve housekeeping object according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### توضیحات `object housekeeping.get(object parameters)` The method allows to retrieve housekeeping object according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Description `object housekeeping.update(object housekeeping)` This method allows to update existing housekeeping settings. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ###توضیحات `object housekeeping.update(object housekeeping)` This method allows to update existing housekeeping settings. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Description `object httptest.create(object/array webScenarios)` This method allows to create new web scenarios. ::: noteclassic Creating a web scenario will automatically create a set of [web monitoring items](/manual/web_monitoring/items). ::: ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### توضیحات `object httptest.create(object/array webScenarios)` This method allows to create new web scenarios. ::: noteclassic Creating a web scenario will automatically create a set of [web monitoring items](/manual/web_monitoring/items). ::: ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Description `object httptest.delete(array webScenarioIds)` This method allows to delete web scenarios. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ###توضیحات `object httptest.delete(array webScenarioIds)` This method allows to delete web scenarios. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Description `object httptest.update(object/array webScenarios)` This method allows to update existing web scenarios. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### توضیحات `object httptest.update(object/array webScenarios)` This method allows to update existing web scenarios. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Description `object iconmap.create(object/array iconMaps)` This method allows to create new icon maps. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ###توضیحات `object iconmap.create(object/array iconMaps)` This method allows to create new icon maps. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Description `object iconmap.delete(array iconMapIds)` This method allows to delete icon maps. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### توضیحات `object iconmap.delete(array iconMapIds)` This method allows to delete icon maps. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Description `object iconmap.update(object/array iconMaps)` This method allows to update existing icon maps. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### شرح "object iconmap.update(object/array iconMaps)". این روش اجازه می دهد تا نقشه های آیکون موجود را به روز کنید. ::: توجه : این روش فقط برای کاربر *Super Admin* موجود است. دسترسی امکان لغو روش های فراخاونی در بخش تنظیمات کاربر می باشد . (در مسیر زیر) (/manual/web_interface/frontend_sections/administration/user_roles) برای اطلاعات بیشتر. ::: ### Description `object image.create(object/array images)` This method allows to create new images. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### توضیحات `object image.create(object/array images)` This method allows to create new images. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Description `object image.delete(array imageIds)` This method allows to delete images. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: #توضیحات`object image.delete(array imageIds)` این روش امکان حذف تصاویر را می دهد.::: noteclassicاین روش فقط برای نوع کاربر *Super Admin* در دسترس است. مجوزهای فراخوانی روش را می توان در تنظیمات نقش کاربر لغو کرد. برای اطلاعات بیشتر به [Userroles](/manual/web_interface/frontend_sections/administration/user_roles) مراجعه کنید. ### Description `object image.update(object/array images)` This method allows to update existing images. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### شرح "object iconmap.update(object/array iconMaps)". این روش اجازه می دهد تا نقشه های آیکون موجود را به روز کنید. ::: توجه : این روش فقط برای کاربر *Super Admin* موجود است. دسترسی امکان لغو روش های فراخاونی در بخش تنظیمات کاربر می باشد . (در مسیر زیر) (/manual/web_interface/frontend_sections/administration/user_roles) برای اطلاعات بیشتر. ::: ### Description `object item.create(object/array items)` This method allows to create new items. ::: noteclassic Web items cannot be created via the Zabbix API. ::: ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### توضیحات `object hostinterface.create(object/array hostInterfaces)` This method allows to create new host interfaces. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Description `object item.delete(array itemIds)` This method allows to delete items. ::: noteclassic Web items cannot be deleted via the Zabbix API. ::: ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### توضیحات `object hostinterface.create(object/array hostInterfaces)` This method allows to create new host interfaces. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Description `object itemprototype.create(object/array itemPrototypes)` This method allows to create new item prototypes. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ###توضیحات `object hostprototype.create(object/array hostPrototypes)` This method allows to create new host prototypes. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Description `object itemprototype.delete(array itemPrototypeIds)` This method allows to delete item prototypes. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### توضیحات `object hostprototype.delete(array hostPrototypeIds)` This method allows to delete host prototypes. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Description `object itemprototype.update(object/array itemPrototypes)` This method allows to update existing item prototypes. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### توضیحات `object hostprototype.update(object/array hostPrototypes)` This method allows to update existing host prototypes. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Description `object item.update(object/array items)` This method allows to update existing items. ::: noteclassic Web items cannot be updated via the Zabbix API. ::: ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### توضیحات `object hostinterface.create(object/array hostInterfaces)` This method allows to create new host interfaces. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Description `object maintenance.create(object/array maintenances)` This method allows to create new maintenances. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### توضیحات `object hostinterface.create(object/array hostInterfaces)` This method allows to create new host interfaces. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Description `object maintenance.delete(array maintenanceIds)` This method allows to delete maintenance periods. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### توضیحات `object hostinterface.create(object/array hostInterfaces)` This method allows to create new host interfaces. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Description `object maintenance.update(object/array maintenances)` This method allows to update existing maintenances. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### توضیحات `object hostinterface.create(object/array hostInterfaces)` This method allows to create new host interfaces. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Description `object map.create(object/array maps)` This method allows to create new maps. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### شرح `object correlation.update(object/array correlation)` این روش امکان به روز رسانی همبستگی های موجود را فراهم می کند. ::: نوتکلاسیک این روش فقط برای نوع کاربری *Super Admin* موجود است. مجوزهای فراخوانی روش را می توان در تنظیمات نقش کاربر لغو کرد. دیدن [کاربر roles](/manual/web_interface/frontend_sections/administration/user_roles) برای اطلاعات بیشتر. ::: ### Description `object map.delete(array mapIds)` This method allows to delete maps. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### شرح `object correlation.update(object/array correlation)` این روش امکان به روز رسانی همبستگی های موجود را فراهم می کند. ::: نوتکلاسیک این روش فقط برای نوع کاربری *Super Admin* موجود است. مجوزهای فراخوانی روش را می توان در تنظیمات نقش کاربر لغو کرد. دیدن [کاربر roles](/manual/web_interface/frontend_sections/administration/user_roles) برای اطلاعات بیشتر. ::: ### Description `object mediatype.create(object/array mediaTypes)` This method allows to create new media types. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### توضیحات `object image.create(object/array images)` This method allows to create new images. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Description `object mediatype.update(object/array mediaTypes)` This method allows to update existing media types. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### توضیحات `object image.create(object/array images)` This method allows to create new images. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Description `object proxy.create(object/array proxies)` This method allows to create new proxies. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### شرح "object iconmap.update(object/array iconMaps)". این روش اجازه می دهد تا نقشه های آیکون موجود را به روز کنید. ::: توجه : این روش فقط برای کاربر *Super Admin* موجود است. دسترسی امکان لغو روش های فراخاونی در بخش تنظیمات کاربر می باشد . (در مسیر زیر) (/manual/web_interface/frontend_sections/administration/user_roles) برای اطلاعات بیشتر. ::: ### Description `object proxy.delete(array proxies)` This method allows to delete proxies. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### شرح "object iconmap.update(object/array iconMaps)". این روش اجازه می دهد تا نقشه های آیکون موجود را به روز کنید. ::: توجه : این روش فقط برای کاربر *Super Admin* موجود است. دسترسی امکان لغو روش های فراخاونی در بخش تنظیمات کاربر می باشد . (در مسیر زیر) (/manual/web_interface/frontend_sections/administration/user_roles) برای اطلاعات بیشتر. ::: ### Description `object proxy.update(object/array proxies)` This method allows to update existing proxies. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### شرح "object iconmap.update(object/array iconMaps)". این روش اجازه می دهد تا نقشه های آیکون موجود را به روز کنید. ::: توجه : این روش فقط برای کاربر *Super Admin* موجود است. دسترسی امکان لغو روش های فراخاونی در بخش تنظیمات کاربر می باشد . (در مسیر زیر) (/manual/web_interface/frontend_sections/administration/user_roles) برای اطلاعات بیشتر. ::: ### Description `object regexp.create(object/array regularExpressions)` This method allows to create new global regular expressions. ::: noteclassic This method is only available to *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: `object image.delete(array imageIds)` این روش امکان حذف تصاویر را می دهد.::: noteclassicاین روش فقط برای نوع کاربر *Super Admin* در دسترس است. مجوزهای فراخوانی روش را می توان در تنظیمات نقش کاربر لغو کرد. برای اطلاعات بیشتر به [Userroles](/manual/web_interface/frontend_sections/administration/user_roles) مراجعه کنید. ### Description `object regexp.delete(array regexpids)` This method allows to delete global regular expressions. ::: noteclassic This method is only available to *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: `object image.delete(array imageIds)` این روش امکان حذف تصاویر را می دهد.::: noteclassicاین روش فقط برای نوع کاربر *Super Admin* در دسترس است. مجوزهای فراخوانی روش را می توان در تنظیمات نقش کاربر لغو کرد. برای اطلاعات بیشتر به [Userroles](/manual/web_interface/frontend_sections/administration/user_roles) مراجعه کنید. ### Description `object regexp.update(object/array regularExpressions)` This method allows to update existing global regular expressions. ::: noteclassic This method is only available to *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: `object image.delete(array imageIds)` این روش امکان حذف تصاویر را می دهد.::: noteclassicاین روش فقط برای نوع کاربر *Super Admin* در دسترس است. مجوزهای فراخوانی روش را می توان در تنظیمات نقش کاربر لغو کرد. برای اطلاعات بیشتر به [Userroles](/manual/web_interface/frontend_sections/administration/user_roles) مراجعه کنید. ### Description `object report.create(object/array reports)` This method allows to create new scheduled reports. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### توضیحات `object host.create(object/array hosts)` This method allows to create new hosts. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Description `object report.delete(array reportids)` This method allows to delete scheduled reports. ::: noteclassic This method is only available to *Admin* and *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### توضیحات `object host.create(object/array hosts)` This method allows to create new hosts. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Description `object script.create(object/array scripts)` This method allows to create new scripts. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### شرح "object iconmap.update(object/array iconMaps)". این روش اجازه می دهد تا نقشه های آیکون موجود را به روز کنید. ::: توجه : این روش فقط برای کاربر *Super Admin* موجود است. دسترسی امکان لغو روش های فراخاونی در بخش تنظیمات کاربر می باشد . (در مسیر زیر) (/manual/web_interface/frontend_sections/administration/user_roles) برای اطلاعات بیشتر. ::: ### Description `object script.delete(array scriptIds)` This method allows to delete scripts. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### شرح "object iconmap.update(object/array iconMaps)". این روش اجازه می دهد تا نقشه های آیکون موجود را به روز کنید. ::: توجه : این روش فقط برای کاربر *Super Admin* موجود است. دسترسی امکان لغو روش های فراخاونی در بخش تنظیمات کاربر می باشد . (در مسیر زیر) (/manual/web_interface/frontend_sections/administration/user_roles) برای اطلاعات بیشتر. ::: ### Description `object script.execute(object parameters)` This method allows to run a script on a host or event. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### شرح `object correlation.update(object/array correlation)` این روش امکان به روز رسانی همبستگی های موجود را فراهم می کند. ::: نوتکلاسیک این روش فقط برای نوع کاربری *Super Admin* موجود است. مجوزهای فراخوانی روش را می توان در تنظیمات نقش کاربر لغو کرد. دیدن [کاربر roles](/manual/web_interface/frontend_sections/administration/user_roles) برای اطلاعات بیشتر. ::: ### Description `object service.update(object/array services)` This method allows to update existing services. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### شرح این روش اجازه می دهد تا داشبورد موجود را به روز کنید. ::: توجه : این روش فقط برای کاربر *Super Admin* موجود است. دسترسی امکان لغو روش های فراخوانی در بخش تنظیمات کاربر می باشد . (در مسیر زیر) (/manual/web_interface/frontend_sections/administration/user_roles) برای اطلاعات بیشتر. ::: ### Description `object settings.update(object settings)` This method allows to update existing common settings. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ###توضیحات `object housekeeping.update(object housekeeping)` This method allows to update existing housekeeping settings. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Description `object sla.create(object/array SLAs)` This method allows to create new SLA objects. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### توضیحات `object host.create(object/array hosts)` This method allows to create new hosts. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Description `object sla.update(object/array slaids)` This method allows to update existing SLA entries. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ###توضیحات `object hostgroup.update(object/array hostGroups)` This method allows to update existing hosts groups. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Description `object task.create(object/array tasks)` This method allows to create a new task (such as collect diagnostic data or check items or low-level discovery rules without config reload). ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### توضیحات `object hostinterface.create(object/array hostInterfaces)` This method allows to create new host interfaces. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Description `object template.create(object/array templates)` This method allows to create new templates. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### شرح `object correlation.update(object/array correlation)` این روش امکان به روز رسانی همبستگی های موجود را فراهم می کند. ::: نوتکلاسیک این روش فقط برای نوع کاربری *Super Admin* موجود است. مجوزهای فراخوانی روش را می توان در تنظیمات نقش کاربر لغو کرد. دیدن [کاربر roles](/manual/web_interface/frontend_sections/administration/user_roles) برای اطلاعات بیشتر. ::: ### Description `object templatedashboard.create(object/array templateDashboards)` This method allows to create new template dashboards. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### شرح `object correlation.update(object/array correlation)` این روش امکان به روز رسانی همبستگی های موجود را فراهم می کند. ::: نوتکلاسیک این روش فقط برای نوع کاربری *Super Admin* موجود است. مجوزهای فراخوانی روش را می توان در تنظیمات نقش کاربر لغو کرد. دیدن [کاربر roles](/manual/web_interface/frontend_sections/administration/user_roles) برای اطلاعات بیشتر. ::: ### Description `object templatedashboard.update(object/array templateDashboards)` This method allows to update existing template dashboards. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### شرح `object correlation.update(object/array correlation)` این روش امکان به روز رسانی همبستگی های موجود را فراهم می کند. ::: نوتکلاسیک این روش فقط برای نوع کاربری *Super Admin* موجود است. مجوزهای فراخوانی روش را می توان در تنظیمات نقش کاربر لغو کرد. دیدن [کاربر roles](/manual/web_interface/frontend_sections/administration/user_roles) برای اطلاعات بیشتر. ::: ### Description `object template.massadd(object parameters)` This method allows to simultaneously add multiple related objects to the given templates. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### توضیحات `object host.massadd(object parameters)` This method allows to simultaneously add multiple related objects to all the given hosts. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Description `object template.massremove(object parameters)` This method allows to remove related objects from multiple templates. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ###توضیحات `object host.massremove(object parameters)` This method allows to remove related objects from multiple hosts. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Description `object triggerprototype.update(object/array triggerPrototypes)` This method allows to update existing trigger prototypes. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### توضیحات `object hostprototype.update(object/array hostPrototypes)` This method allows to update existing host prototypes. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Description `object trigger.update(object/array triggers)` This method allows to update existing triggers. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ###توضیحات `object graph.update(object/array graphs)` This method allows to update existing graphs. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Description `object usergroup.update(object/array userGroups)` This method allows to update existing user groups. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### شرح "object iconmap.update(object/array iconMaps)". این روش اجازه می دهد تا نقشه های آیکون موجود را به روز کنید. ::: توجه : این روش فقط برای کاربر *Super Admin* موجود است. دسترسی امکان لغو روش های فراخاونی در بخش تنظیمات کاربر می باشد . (در مسیر زیر) (/manual/web_interface/frontend_sections/administration/user_roles) برای اطلاعات بیشتر. ::: ### Description `object usermacro.updateglobal(object/array globalMacros)` This method allows to update existing global macros. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### شرح "object iconmap.update(object/array iconMaps)". این روش اجازه می دهد تا نقشه های آیکون موجود را به روز کنید. ::: توجه : این روش فقط برای کاربر *Super Admin* موجود است. دسترسی امکان لغو روش های فراخاونی در بخش تنظیمات کاربر می باشد . (در مسیر زیر) (/manual/web_interface/frontend_sections/administration/user_roles) برای اطلاعات بیشتر. ::: ### Description `object valuemap.create(object/array valuemaps)` This method allows to create new value maps. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### شرح "object iconmap.update(object/array iconMaps)". این روش اجازه می دهد تا نقشه های آیکون موجود را به روز کنید. ::: توجه : این روش فقط برای کاربر *Super Admin* موجود است. دسترسی امکان لغو روش های فراخاونی در بخش تنظیمات کاربر می باشد . (در مسیر زیر) (/manual/web_interface/frontend_sections/administration/user_roles) برای اطلاعات بیشتر. ::: ### Description `object valuemap.delete(array valuemapids)` This method allows to delete value maps. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### شرح "object iconmap.update(object/array iconMaps)". این روش اجازه می دهد تا نقشه های آیکون موجود را به روز کنید. ::: توجه : این روش فقط برای کاربر *Super Admin* موجود است. دسترسی امکان لغو روش های فراخاونی در بخش تنظیمات کاربر می باشد . (در مسیر زیر) (/manual/web_interface/frontend_sections/administration/user_roles) برای اطلاعات بیشتر. ::: ### Description `object valuemap.update(object/array valuemaps)` This method allows to update existing value maps. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### شرح "object iconmap.update(object/array iconMaps)". این روش اجازه می دهد تا نقشه های آیکون موجود را به روز کنید. ::: توجه : این روش فقط برای کاربر *Super Admin* موجود است. دسترسی امکان لغو روش های فراخاونی در بخش تنظیمات کاربر می باشد . (در مسیر زیر) (/manual/web_interface/frontend_sections/administration/user_roles) برای اطلاعات بیشتر. ::: ### Description `string apiinfo.version(array)` This method allows to retrieve the version of the Zabbix API. ::: noteimportant This method is only available to unauthenticated users and must be called without the `auth` parameter in the JSON-RPC request. ::: ### شرح `string apiinfo.version(array)` این روش امکان بازیابی نسخه Zabbix API را فراهم می کند. ::: نکته مهم این روش فقط برای غیر احراز هویت در دسترس است کاربران و باید بدون پارامتر «auth» در JSON-RPC فراخوانی شوند درخواست. ::: ### Description `string configuration.export(object parameters)` This method allows to export configuration data as a serialized string. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### شرح "object iconmap.update(object/array iconMaps)". این روش اجازه می دهد تا نقشه های آیکون موجود را به روز کنید. ::: توجه : این روش فقط برای کاربر *Super Admin* موجود است. دسترسی امکان لغو روش های فراخوانی در بخش تنظیمات کاربر می باشد . (در مسیر زیر) (/manual/web_interface/frontend_sections/administration/user_roles) برای اطلاعات بیشتر. ::: ## DESCRIPTION **zabbix\_agent2** is an application for monitoring parameters of various services.\ \ [ ]{#lbAE} ## شرح **zabbix\_agent2** یک برنامه کاربردی برای نظارت بر پارامترهای است خدمات مختلف.\ \ [ ]{#lbAE} ## DESCRIPTION **zabbix\_agentd** is a daemon for monitoring various server parameters. [ ]{#lbAE} ## شرح **zabbix\_agentd** دیمونی برای نظارت بر پارامترهای مختلف سرور است. [ ]{#lbAE} ## DESCRIPTION **zabbix\_get** is a command line utility for getting data from Zabbix agent. [ ]{#lbAE} ## شرح **zabbix\_get** یک ابزار خط فرمان برای دریافت داده از عامل Zabbix است. [ ]{#lbAE} ## DESCRIPTION **zabbix\_js** is a command line utility that can be used for embedded script testing. [ ]{#lbAE} ## شرح **zabbix\_js** یک ابزار خط فرمان است که می تواند برای جاسازی استفاده شود تست اسکریپت [ ]{#lbAE} ## DESCRIPTION **zabbix\_proxy** is a daemon that collects monitoring data from devices and sends it to Zabbix server. [ ]{#lbAE} ## شرح **zabbix\_proxy** دیمونی است که داده های نظارتی را از دستگاه ها جمع آوری می کند و آن را به سرور Zabbix ارسال می کند. [ ]{#lbAE} ## DESCRIPTION **zabbix\_sender** is a command line utility for sending monitoring data to Zabbix server or proxy. On the Zabbix server an item of type **Zabbix trapper** should be created with corresponding key. Note that incoming values will only be accepted from hosts specified in **Allowed hosts** field for this item. [ ]{#lbAE} ## شرح **zabbix\_sender** یک ابزار خط فرمان برای ارسال داده های نظارت است به سرور یا پروکسی Zabbix. در سرور Zabbix موردی از نوع **Zabbix trapper** باید با کلید مربوطه ایجاد شود. توجه داشته باشید که ورودی مقادیر فقط از میزبان های مشخص شده در **میزبان های مجاز** پذیرفته می شود. فیلد برای این مورد [ ]{#lbAE} ## DESCRIPTION **zabbix\_server** is the core daemon of Zabbix software. [ ]{#lbAE} ## شرح **zabbix\_server** دیمون اصلی نرم افزار Zabbix است. [ ]{#lbAE} ## DESCRIPTION **zabbix\_web\_service** is an application for providing web services to Zabbix components. [ ]{#lbAE} ## شرح **zabbix\_web\_service** اپلیکیشنی برای ارائه خدمات وب به اجزای Zabbix [ ]{#lbAE} #### Details about export - All supported elements are exported in one file. - Host and template entities (items, triggers, graphs, discovery rules) that are inherited from linked templates are not exported. Any changes made to those entities on a host level (such as changed item interval, modified regular expression or added prototypes to the low-level discovery rule) will be lost when exporting; when importing, all entities from linked templates are re-created as on the original linked template. - Entities created by low-level discovery and any entities depending on them are not exported. For example, a trigger created for an LLD-rule generated item will not be exported. #### جزئیات در مورد خروجی گرفتن - تمام عناصر پشتیبانی شده در یک فایل صادر می شوند. - موجودیت های میزبان و قالب (اقلام، محرک ها، نمودارها، کشف قوانین) که از الگوهای پیوندی به ارث رسیده اند صادر نمی شوند. هر گونه تغییری که در آن نهادها در سطح میزبان ایجاد شود (مانند تغییر فاصله آیتم، بیان منظم اصلاح شده یا نمونه های اولیه اضافه شده به قانون کشف سطح پایین) هنگام صادرات از بین خواهد رفت. چه زمانی با وارد کردن، همه موجودیت‌ها از قالب‌های پیوندی مجدداً ایجاد می‌شوند الگوی لینک شده اصلی - موجودیت های ایجاد شده توسط اکتشاف سطح پایین و هر موجودیت وابسته بر روی آنها صادر نمی شود. به عنوان مثال، یک ماشه ایجاد شده برای یک مورد ایجاد شده با قانون LLD صادر نخواهد شد. ### Details tag The details object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**version**<br>(required)|integer|SNMP interface version.<br><br>Possible values are:<br>1 - SNMPv1;<br>2 - SNMPv2c;<br>3 - SNMPv3| |bulk|integer|Whether to use bulk SNMP requests.<br><br>Possible values are:<br>0 - don't use bulk requests;<br>1 - (default) - use bulk requests.| |community|string|SNMP community (required). Used only by SNMPv1 and SNMPv2 interfaces.| |securityname|string|SNMPv3 security name. Used only by SNMPv3 interfaces.| |securitylevel|integer|SNMPv3 security level. Used only by SNMPv3 interfaces.<br><br>Possible values are:<br>0 - (default) - noAuthNoPriv;<br>1 - authNoPriv;<br>2 - authPriv.| |authpassphrase|string|SNMPv3 authentication passphrase. Used only by SNMPv3 interfaces.| |privpassphrase|string|SNMPv3 privacy passphrase. Used only by SNMPv3 interfaces.| |authprotocol|integer|SNMPv3 authentication protocol. Used only by SNMPv3 interfaces.<br><br>Possible values are:<br>0 - (default) - MD5;<br>1 - SHA1;<br>2 - SHA224;<br>3 - SHA256;<br>4 - SHA384;<br>5 - SHA512.| |privprotocol|integer|SNMPv3 privacy protocol. Used only by SNMPv3 interfaces.<br><br>Possible values are:<br>0 - (default) - DES;<br>1 - AES128;<br>2 - AES192;<br>3 - AES256;<br>4 - AES192C;<br>5 - AES256C.| |contextname|string|SNMPv3 context name. Used only by SNMPv3 interfaces.| ### تگ جزییات The details object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**version**<br>(required)|integer|SNMP interface version.<br><br>Possible values are:<br>1 - SNMPv1;<br>2 - SNMPv2c;<br>3 - SNMPv3| |bulk|integer|Whether to use bulk SNMP requests.<br><br>Possible values are:<br>0 - don't use bulk requests;<br>1 - (default) - use bulk requests.| |community|string|SNMP community (required). Used only by SNMPv1 and SNMPv2 interfaces.| |securityname|string|SNMPv3 security name. Used only by SNMPv3 interfaces.| |securitylevel|integer|SNMPv3 security level. Used only by SNMPv3 interfaces.<br><br>Possible values are:<br>0 - (default) - noAuthNoPriv;<br>1 - authNoPriv;<br>2 - authPriv.| |authpassphrase|string|SNMPv3 authentication passphrase. Used only by SNMPv3 interfaces.| |privpassphrase|string|SNMPv3 privacy passphrase. Used only by SNMPv3 interfaces.| |authprotocol|integer|SNMPv3 authentication protocol. Used only by SNMPv3 interfaces.<br><br>Possible values are:<br>0 - (default) - MD5;<br>1 - SHA1;<br>2 - SHA224;<br>3 - SHA256;<br>4 - SHA384;<br>5 - SHA512.| |privprotocol|integer|SNMPv3 privacy protocol. Used only by SNMPv3 interfaces.<br><br>Possible values are:<br>0 - (default) - DES;<br>1 - AES128;<br>2 - AES192;<br>3 - AES256;<br>4 - AES192C;<br>5 - AES256C.| |contextname|string|SNMPv3 context name. Used only by SNMPv3 interfaces.| # dhost.get # dhost.get #### Disable action Disable action, that is, set its status to "1". Request: ```json { "jsonrpc": "2.0", "method": "action.update", "params": { "actionid": "2", "status": "1" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "actionids": [ "2" ] }, "id": 1 } ``` ####اکشن را غیرفعال کنید عملکرد را غیرفعال کنید، یعنی وضعیت آن را روی "1" تنظیم کنید. درخواست: ``json { "jsonrpc": "2.0"، "روش": "action.update"، "params": { "actionid": "2"، "وضعیت": "1" }، "auth": "038e1d7b1735c6a5436ee9eae095879e"، "id": 1 } ``` واکنش: ``json { "jsonrpc": "2.0"، "نتیجه": { "actionids": [ "2" ] }، "id": 1 } ``` #### Disable correlation Request: ```json { "jsonrpc": "2.0", "method": "correlation.update", "params": { "correlationid": "1", "status": "1" }, "auth": "343baad4f88b4106b9b5961e77437688", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "correlationids": [ "1" ] }, "id": 1 } ``` #### همبستگی را غیرفعال کنید درخواست: ``json { "jsonrpc": "2.0"، "روش": "correlation.update"، "params": { "همبستگی": "1"، "وضعیت": "1" }، "auth": "343baad4f88b4106b9b5961e77437688", "id": 1 } ``` واکنش: ``json { "jsonrpc": "2.0"، "نتیجه": { "همبستگی ها": [ "1" ] }، "id": 1 } ``` #### Disable trapping Disable LLD trapping for discovery rule. Request: ```json { "jsonrpc": "2.0", "method": "discoveryrule.update", "params": { "itemid": "28336", "allow_traps": 0 }, "id": 36, "auth": "d678e0b85688ce578ff061bd29a20d3b" } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "28336" ] }, "id": 36 } ``` #### غیر فعال کردن trapping Disable LLD trapping for discovery rule. Request: ```json { "jsonrpc": "2.0", "method": "discoveryrule.update", "params": { "itemid": "28336", "allow_traps": 0 }, "id": 36, "auth": "d678e0b85688ce578ff061bd29a20d3b" } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "28336" ] }, "id": 36 } ``` #### Disabling a host prototype Disable a host prototype, that is, set its status to 1. Request: ```json { "jsonrpc": "2.0", "method": "hostprototype.update", "params": { "hostid": "10092", "status": 1 }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "hostids": [ "10092" ] }, "id": 1 } ``` ####غیرفعال کردن نمونه اولیه هاست Disable a host prototype, that is, set its status to 1. Request: ```json { "jsonrpc": "2.0", "method": "hostprototype.update", "params": { "hostid": "10092", "status": 1 }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "hostids": [ "10092" ] }, "id": 1 } ``` #### Disabling a user group Disable a user group. Request: ```json { "jsonrpc": "2.0", "method": "usergroup.update", "params": { "usrgrpid": "17", "users_status": "1" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "usrgrpids": [ "17" ] }, "id": 1 } ``` ####غیرفعال کردن نمونه اولیه هاست Disable a host prototype, that is, set its status to 1. Request: ```json { "jsonrpc": "2.0", "method": "hostprototype.update", "params": { "hostid": "10092", "status": 1 }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "hostids": [ "10092" ] }, "id": 1 } ``` ### Disabling high availability To disable a high availability cluster: - make backup copies of configuration files - stop standby nodes - remove the HANodeName parameter from the active primary server - restart the primary server (it will start in standalone mode) ### غیرفعال کردن دسترسی بالا برای غیرفعال کردن یک خوشه در دسترس بودن بالا: - از فایل های پیکربندی نسخه پشتیبان تهیه کنید - گره های آماده به کار را متوقف کنید - پارامتر HANodeName را از سرور اصلی فعال حذف کنید - راه اندازی مجدد سرور اصلی (در حالت مستقل شروع به کار می کند) ### Discovered host ::: noteclassic Discovered host are created by the Zabbix server and cannot be modified via the API. ::: The discovered host object contains information about a host discovered by a network discovery rule. It has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |dhostid|string|ID of the discovered host.| |druleid|string|ID of the discovery rule that detected the host.| |lastdown|timestamp|Time when the discovered host last went down.| |lastup|timestamp|Time when the discovered host last went up.| |status|integer|Whether the discovered host is up or down. A host is up if it has at least one active discovered service.<br><br>Possible values:<br>0 - host up;<br>1 - host down.| ### هاست های پیدا شده ::: noteclassic Discovered host are created by the Zabbix server and cannot be modified via the API. ::: The discovered host object contains information about a host discovered by a network discovery rule. It has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |dhostid|string|ID of the discovered host.| |druleid|string|ID of the discovery rule that detected the host.| |lastdown|timestamp|Time when the discovered host last went down.| |lastup|timestamp|Time when the discovered host last went up.| |status|integer|Whether the discovered host is up or down. A host is up if it has at least one active discovered service.<br><br>Possible values:<br>0 - host up;<br>1 - host down.| ### Discovered service ::: noteclassic Discovered services are created by the Zabbix server and cannot be modified via the API. ::: The discovered service object contains information about a service discovered by a network discovery rule on a host. It has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |dserviceid|string|ID of the discovered service.| |dcheckid|string|ID of the discovery check used to detect the service.| |dhostid|string|ID of the discovered host running the service.| |dns|string|DNS of the host running the service.| |ip|string|IP address of the host running the service.| |lastdown|timestamp|Time when the discovered service last went down.| |lastup|timestamp|Time when the discovered service last went up.| |port|integer|Service port number.| |status|integer|Status of the service.<br><br>Possible values:<br>0 - service up;<br>1 - service down.| |value|string|Value returned by the service when performing a Zabbix agent, SNMPv1, SNMPv2 or SNMPv3 discovery check.| ### سرویس جست و جو شده ::: noteclassic Discovered services are created by the Zabbix server and cannot be modified via the API. ::: The discovered service object contains information about a service discovered by a network discovery rule on a host. It has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |dserviceid|string|ID of the discovered service.| |dcheckid|string|ID of the discovery check used to detect the service.| |dhostid|string|ID of the discovered host running the service.| |dns|string|DNS of the host running the service.| |ip|string|IP address of the host running the service.| |lastdown|timestamp|Time when the discovered service last went down.| |lastup|timestamp|Time when the discovered service last went up.| |port|integer|Service port number.| |status|integer|Status of the service.<br><br>Possible values:<br>0 - service up;<br>1 - service down.| |value|string|Value returned by the service when performing a Zabbix agent, SNMPv1, SNMPv2 or SNMPv3 discovery check.| ### Discovery check The discovery check object defines a specific check performed by a network discovery rule. It has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |dcheckid|string|*(readonly)* ID of the discovery check.| |druleid|string|*(readonly)* ID of the discovery rule that the check belongs to.| |key\_|string|The value of this property differs depending on the type of the check:<br>- key to query for Zabbix agent checks, required;<br>- SNMP OID for SNMPv1, SNMPv2 and SNMPv3 checks, required.| |ports|string|One or several port ranges to check separated by commas. Used for all checks except for ICMP.<br><br>Default: 0.| |snmp\_community|string|SNMP community.<br><br>Required for SNMPv1 and SNMPv2 agent checks.| |snmpv3\_authpassphrase|string|Authentication passphrase used for SNMPv3 agent checks with security level set to *authNoPriv* or *authPriv*.| |snmpv3\_authprotocol|integer|Authentication protocol used for SNMPv3 agent checks with security level set to *authNoPriv* or *authPriv*.<br><br>Possible values:<br>0 - *(default)* MD5;<br>1 - SHA1;<br>2 - SHA224;<br>3 - SHA256;<br>4 - SHA384;<br>5 - SHA512.| |snmpv3\_contextname|string|SNMPv3 context name. Used only by SNMPv3 checks.| |snmpv3\_privpassphrase|string|Privacy passphrase used for SNMPv3 agent checks with security level set to *authPriv*.| |snmpv3\_privprotocol|integer|Privacy protocol used for SNMPv3 agent checks with security level set to *authPriv*.<br><br>Possible values:<br>0 - *(default)* DES;<br>1 - AES128;<br>2 - AES192;<br>3 - AES256;<br>4 - AES192C;<br>5 - AES256C.| |snmpv3\_securitylevel|string|Security level used for SNMPv3 agent checks.<br><br>Possible values:<br>0 - noAuthNoPriv;<br>1 - authNoPriv;<br>2 - authPriv.| |snmpv3\_securityname|string|Security name used for SNMPv3 agent checks.| |**type**<br>(required)|integer|Type of check.<br><br>Possible values:<br>0 - SSH;<br>1 - LDAP;<br>2 - SMTP;<br>3 - FTP;<br>4 - HTTP;<br>5 - POP;<br>6 - NNTP;<br>7 - IMAP;<br>8 - TCP;<br>9 - Zabbix agent;<br>10 - SNMPv1 agent;<br>11 - SNMPv2 agent;<br>12 - ICMP ping;<br>13 - SNMPv3 agent;<br>14 - HTTPS;<br>15 - Telnet.| |uniq|integer|Whether to use this check as a device uniqueness criteria. Only a single unique check can be configured for a discovery rule. Used for Zabbix agent, SNMPv1, SNMPv2 and SNMPv3 agent checks.<br><br>Possible values:<br>0 - *(default)* do not use this check as a uniqueness criteria;<br>1 - use this check as a uniqueness criteria.| |host\_source|integer|Source for host name.<br><br>Possible values:<br>1 - *(default)* DNS;<br>2 - IP;<br>3 - discovery value of this check.| |name\_source|integer|Source for visible name.<br><br>Possible values:<br>0 - *(default)* not specified;<br>1 - DNS;<br>2 - IP;<br>3 - discovery value of this check.| ### بررسی جست جو ها The discovery check object defines a specific check performed by a network discovery rule. It has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |dcheckid|string|*(readonly)* ID of the discovery check.| |druleid|string|*(readonly)* ID of the discovery rule that the check belongs to.| |key\_|string|The value of this property differs depending on the type of the check:<br>- key to query for Zabbix agent checks, required;<br>- SNMP OID for SNMPv1, SNMPv2 and SNMPv3 checks, required.| |ports|string|One or several port ranges to check separated by commas. Used for all checks except for ICMP.<br><br>Default: 0.| |snmp\_community|string|SNMP community.<br><br>Required for SNMPv1 and SNMPv2 agent checks.| |snmpv3\_authpassphrase|string|Authentication passphrase used for SNMPv3 agent checks with security level set to *authNoPriv* or *authPriv*.| |snmpv3\_authprotocol|integer|Authentication protocol used for SNMPv3 agent checks with security level set to *authNoPriv* or *authPriv*.<br><br>Possible values:<br>0 - *(default)* MD5;<br>1 - SHA1;<br>2 - SHA224;<br>3 - SHA256;<br>4 - SHA384;<br>5 - SHA512.| |snmpv3\_contextname|string|SNMPv3 context name. Used only by SNMPv3 checks.| |snmpv3\_privpassphrase|string|Privacy passphrase used for SNMPv3 agent checks with security level set to *authPriv*.| |snmpv3\_privprotocol|integer|Privacy protocol used for SNMPv3 agent checks with security level set to *authPriv*.<br><br>Possible values:<br>0 - *(default)* DES;<br>1 - AES128;<br>2 - AES192;<br>3 - AES256;<br>4 - AES192C;<br>5 - AES256C.| |snmpv3\_securitylevel|string|Security level used for SNMPv3 agent checks.<br><br>Possible values:<br>0 - noAuthNoPriv;<br>1 - authNoPriv;<br>2 - authPriv.| |snmpv3\_securityname|string|Security name used for SNMPv3 agent checks.| |**type**<br>(required)|integer|Type of check.<br><br>Possible values:<br>0 - SSH;<br>1 - LDAP;<br>2 - SMTP;<br>3 - FTP;<br>4 - HTTP;<br>5 - POP;<br>6 - NNTP;<br>7 - IMAP;<br>8 - TCP;<br>9 - Zabbix agent;<br>10 - SNMPv1 agent;<br>11 - SNMPv2 agent;<br>12 - ICMP ping;<br>13 - SNMPv3 agent;<br>14 - HTTPS;<br>15 - Telnet.| |uniq|integer|Whether to use this check as a device uniqueness criteria. Only a single unique check can be configured for a discovery rule. Used for Zabbix agent, SNMPv1, SNMPv2 and SNMPv3 agent checks.<br><br>Possible values:<br>0 - *(default)* do not use this check as a uniqueness criteria;<br>1 - use this check as a uniqueness criteria.| |host\_source|integer|Source for host name.<br><br>Possible values:<br>1 - *(default)* DNS;<br>2 - IP;<br>3 - discovery value of this check.| |name\_source|integer|Source for visible name.<br><br>Possible values:<br>0 - *(default)* not specified;<br>1 - DNS;<br>2 - IP;<br>3 - discovery value of this check.| # discoveryrule.copy # کپی کردن قوانین جست وجو # discoveryrule.create # ساختن قوانین جست وجو # discoveryrule.delete # پاک کردن قوانین جست وجو # discoveryrule.get # گرفتن قوانین جست وجو ### Discovery rule The discovery rule object defines a network discovery rule. It has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |druleid|string|*(readonly)* ID of the discovery rule.| |**iprange**<br>(required)|string|One or several IP ranges to check separated by commas.<br><br>Refer to the [network discovery configuration](/manual/discovery/network_discovery/rule) section for more information on supported formats of IP ranges.| |**name**<br>(required)|string|Name of the discovery rule.| |delay|string|Execution interval of the discovery rule. Accepts seconds, time unit with suffix and user macro.<br><br>Default: 1h.| |nextcheck|timestamp|*(readonly)* Time when the discovery rule will be executed next.| |proxy\_hostid|string|ID of the proxy used for discovery.| |status|integer|Whether the discovery rule is enabled.<br><br>Possible values:<br>0 - *(default)* enabled;<br>1 - disabled.| Note that for some methods (update, delete) the required/optional parameter combination is different. ### قانون جست وجو The discovery rule object defines a network discovery rule. It has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |druleid|string|*(readonly)* ID of the discovery rule.| |**iprange**<br>(required)|string|One or several IP ranges to check separated by commas.<br><br>Refer to the [network discovery configuration](/manual/discovery/network_discovery/rule) section for more information on supported formats of IP ranges.| |**name**<br>(required)|string|Name of the discovery rule.| |delay|string|Execution interval of the discovery rule. Accepts seconds, time unit with suffix and user macro.<br><br>Default: 1h.| |nextcheck|timestamp|*(readonly)* Time when the discovery rule will be executed next.| |proxy\_hostid|string|ID of the proxy used for discovery.| |status|integer|Whether the discovery rule is enabled.<br><br>Possible values:<br>0 - *(default)* enabled;<br>1 - disabled.| Note that for some methods (update, delete) the required/optional parameter combination is different. # discoveryrule.update # به روز رسانی قوانین جست وجو #### Display Based on acknowledgment information it is possible to configure how the problem count is displayed in the dashboard or maps. To do that, you have to make selections in the *Problem display* option, available in both [map configuration](/manual/config/visualization/maps/map#creating_a_map) and the *Problems by severity* [dashboard widget](/manual/web_interface/frontend_sections/monitoring/dashboard##adding_widgets). It is possible to display all problem count, unacknowledged problem count as separated from the total or unacknowledged problem count only. Based on problem update information (acknowledgment, etc.), it is possible to configure update operations - send a message or execute remote commands. #### نمایش دادن بر اساس اطلاعات تصدیق شده ، می‌توان پیکربندی کرد که چگونه تعداد مشکلات در داشبورد یا نقشه ها نمایش داده می شود. برای انجام این کار، شما باید در گزینه *نمایش مشکل* که در موجود است، انتخاب کنید هر دو [نقشه configuration](/manual/config/visualization/maps/map#creating_a_map) و *مشکلات بر اساس شدت* [داشبورد ویجت](/دستی/واسط_وب/بخشهای_نمایش/مانیتورینگ/داشبورد##افزودن_ویجتها). این امکان وجود دارد که تمام تعداد مشکلات، مشکل تایید نشده نمایش داده شود فقط از کل یا تعداد مشکل تایید نشده جدا شده حساب شود. بر اساس اطلاعات به روز رسانی مشکل (تأیید و غیره) است امکان پیکربندی عملیات به روز رسانی - ارسال پیام یا اجرا دستورات از راه دور #### Display To view web scenarios configured for a host, go to *Monitoring → Hosts*, locate the host in the list and click on the *Web* hyperlink in the last column. Click on the scenario name to get detailed information. ![](../../assets/en/manual/web_monitoring/scenario_details2.png){width="600"} An overview of web scenarios can also be displayed in *Monitoring → Dashboard* by a Web monitoring widget. Recent results of the web scenario execution are available in the *Monitoring → Latest data* section. #### نمایش To view web scenarios configured for a host, go to *Monitoring → Hosts*, locate the host in the list and click on the *Web* hyperlink in the last column. Click on the scenario name to get detailed information. ![](../../assets/en/manual/web_monitoring/scenario_details2.png){width="600"} An overview of web scenarios can also be displayed in *Monitoring → Dashboard* by a Web monitoring widget. Recent results of the web scenario execution are available in the *Monitoring → Latest data* section. # drule.create # ساختن # drule.delete پاک کردن قانون جست وجو # drule.get دریافت حذف قانون جست و جو # drule.update # آپدیت قانون جست و جو # dservice.get # دریافت سرویس جست و جو #### Easy Connect Easy Connect uses the following parameters to connect to the database: - *Host* - the host name or IP address of the database server computer (DBHost parameter in the configuration file). - *Port* - the listening port on the database server (DBPort parameter in the configuration file; if not set the default 1521 port will be used). - <service\_name> - the service name of the database you want to access (DBName parameter in the configuration file). **Example:** Database parameters set in the server or proxy configuration file (zabbix\_server.conf and zabbix\_proxy.conf): DBHost=localhost DBPort=1521 DBUser=myusername DBName=ORCL DBPassword=mypassword Connection string used by Zabbix to establish connection: DBUser/DBPassword@DBHost:DBPort/DBName During Zabbix frontend installation, set the corresponding parameters in the *Configure DB connection* step of the setup wizard: - Database host: localhost - Database port: 1521 - Database name: ORCL - User: myusername - Password: mypassword ![](../../../../assets/en/manual/appendix/install/oracle_easy_connect.png){width="600"} Alternatively, these parameters can be set in the frontend configuration file (zabbix.conf.php): $DB["TYPE"] = 'ORACLE'; $DB["SERVER"] = 'localhost'; $DB["PORT"] = '1521'; $DB["DATABASE"] = 'ORCL'; $DB["USER"] = 'myusername'; $DB["PASSWORD"] = 'mypassword'; #### اتصال آسان Easy Connect از پارامترهای زیر برای اتصال به پایگاه داده استفاده می کند: - *میزبان* - نام میزبان یا آدرس IP رایانه سرور پایگاه داده (پارامتر DBHost در فایل پیکربندی). - *پورت* - پورت گوش دادن در سرور پایگاه داده (پارامتر DBPort در فایل پیکربندی؛ اگر تنظیم نشود پورت پیش فرض 1521 خواهد بود استفاده شده). - <service\_name> - نام سرویس پایگاه داده ای که می خواهید دسترسی (پارامتر DBName در فایل پیکربندی). **مثال:** پارامترهای پایگاه داده در فایل پیکربندی سرور یا پروکسی تنظیم شده است (zabbix\_server.conf و zabbix\_proxy.conf): DBHost=localhost DBPort=1521 DBUser=myusername DBName=ORCL DBPassword=mypassword رشته اتصال که توسط Zabbix برای ایجاد اتصال استفاده می شود: DBUser/DBPassword@DBHost:DBPort/DBName در طول نصب Zabbix frontend، پارامترهای مربوطه را در آن تنظیم کنید مرحله *پیکربندی اتصال DB* جادوگر راه اندازی: - میزبان پایگاه داده: localhost - پورت پایگاه داده: 1521 - نام پایگاه داده: ORCL - کاربر: myusername - رمز عبور: mypassword ![](../../../../assets/en/manual/appendix/install/oracle_easy_connect.png){width="600"} متناوبا، این پارامترها را می توان در پیکربندی frontend تنظیم کرد فایل (zabbix.conf.php): $DB["TYPE"] = 'ORACLE'; $DB["SERVER"] = 'localhost'; $DB["PORT"] = '1521'; $DB["DATABASE"] = 'ORCL'; $DB["USER"] = 'myusername'; $DB["PASSWORD"] = 'mypassword'; #### Element tags Element tag values are explained in the table below. #### برچسب های عنصر مقادیر تگ عنصر در جدول زیر توضیح داده شده است. #### Element tags Element tag values are explained in the table below. #### برچسب های عنصر مقادیر تگ عنصر در جدول زیر توضیح داده شده است. #### Enabling a host Enable host monitoring, i.e. set its status to 0. Request: ```json { "jsonrpc": "2.0", "method": "host.update", "params": { "hostid": "10126", "status": 0 }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "hostids": [ "10126" ] }, "id": 1 } ``` #### فعال سازی هاست Enable host monitoring, i.e. set its status to 0. Request: ```json { "jsonrpc": "2.0", "method": "host.update", "params": { "hostid": "10126", "status": 0 }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "hostids": [ "10126" ] }, "id": 1 } ``` #### Enabling a media type Enable a media type, that is, set its status to "0". Request: ```json { "jsonrpc": "2.0", "method": "mediatype.update", "params": { "mediatypeid": "6", "status": "0" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "mediatypeids": [ "6" ] }, "id": 1 } ``` ####اکشن را غیرفعال کنید عملکرد را غیرفعال کنید، یعنی وضعیت آن را روی "1" تنظیم کنید. درخواست: ``json { "jsonrpc": "2.0"، "روش": "action.update"، "params": { "actionid": "2"، "وضعیت": "1" }، "auth": "038e1d7b1735c6a5436ee9eae095879e"، "id": 1 } ``` واکنش: ``json { "jsonrpc": "2.0"، "نتیجه": { "actionids": [ "2" ] }، "id": 1 } ``` #### Enabling an item Enable an item, that is, set its status to "0". Request: ```json { "jsonrpc": "2.0", "method": "item.update", "params": { "itemid": "10092", "status": 0 }, "auth": "700ca65537074ec963db7efabda78259", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "10092" ] }, "id": 1 } ``` #### فعال سازی وب سناریو Enable a web scenario, that is, set its status to "0". Request: ```json { "jsonrpc": "2.0", "method": "httptest.update", "params": { "httptestid": "5", "status": 0 }, "auth": "700ca65537074ec963db7efabda78259", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "httptestids": [ "5" ] }, "id": 1 } ``` #### Enabling a trigger Enable a trigger, that is, set its status to 0. Request: ```json { "jsonrpc": "2.0", "method": "trigger.update", "params": { "triggerid": "13938", "status": 0 }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "triggerids": [ "13938" ] }, "id": 1 } ``` ####غیرفعال کردن نمونه اولیه هاست Disable a host prototype, that is, set its status to 1. Request: ```json { "jsonrpc": "2.0", "method": "hostprototype.update", "params": { "hostid": "10092", "status": 1 }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "hostids": [ "10092" ] }, "id": 1 } ``` #### Enabling a trigger prototype Enable a trigger prototype, that is, set its status to 0. Request: ```json { "jsonrpc": "2.0", "method": "triggerprototype.update", "params": { "triggerid": "13938", "status": 0 }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "triggerids": [ "13938" ] }, "id": 1 } ``` ####غیرفعال کردن نمونه اولیه هاست Disable a host prototype, that is, set its status to 1. Request: ```json { "jsonrpc": "2.0", "method": "hostprototype.update", "params": { "hostid": "10092", "status": 1 }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "hostids": [ "10092" ] }, "id": 1 } ``` #### Enabling a web scenario Enable a web scenario, that is, set its status to "0". Request: ```json { "jsonrpc": "2.0", "method": "httptest.update", "params": { "httptestid": "5", "status": 0 }, "auth": "700ca65537074ec963db7efabda78259", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "httptestids": [ "5" ] }, "id": 1 } ``` #### فعال سازی وب سناریو Enable a web scenario, that is, set its status to "0". Request: ```json { "jsonrpc": "2.0", "method": "httptest.update", "params": { "httptestid": "5", "status": 0 }, "auth": "700ca65537074ec963db7efabda78259", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "httptestids": [ "5" ] }, "id": 1 } ``` ### Enabling high availability ### فعال کردن در دسترس بودن بالا #### Enabling multiple hosts Enable monitoring of two hosts, i.e., set their status to 0. Request: ```json { "jsonrpc": "2.0", "method": "host.massupdate", "params": { "hosts": [ { "hostid": "69665" }, { "hostid": "69666" } ], "status": 0 }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "hostids": [ "69665", "69666" ] }, "id": 1 } ``` #### فعال سازی چندین هاست Enable monitoring of two hosts, i.e., set their status to 0. Request: ```json { "jsonrpc": "2.0", "method": "host.massupdate", "params": { "hosts": [ { "hostid": "69665" }, { "hostid": "69666" } ], "status": 0 }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "hostids": [ "69665", "69666" ] }, "id": 1 } ``` #### Encoding settings To make sure that the acquired data are not corrupted you may specify the correct encoding for processing the check (e.g. 'vfs.file.contents') in the `encoding` parameter. The list of supported encodings (code page identifiers) may be found in documentation for [libiconv](http://www.gnu.org/software/libiconv/) (GNU Project) or in Microsoft Windows SDK documentation for "Code Page Identifiers". If no encoding is specified in the `encoding` parameter the following resolution strategies are applied: - If encoding is not specified (or is an empty string) it is assumed to be UTF-8, the data is processed "as-is"; - BOM analysis - applicable for items 'vfs.file.contents', 'vfs.file.regexp', 'vfs.file.regmatch'. An attempt is made to determine the correct encoding by using the byte order mark (BOM) at the beginning of the file. If BOM is not present - standard resolution (see above) is applied instead. #### تنظیمات رمزگذاری برای اطمینان از اینکه داده های به دست آمده خراب نیستند، می توانید آن را مشخص کنید رمزگذاری صحیح برای پردازش چک (به عنوان مثال "vfs.file.contents") در پارامتر «رمزگذاری» لیست کدگذاری های پشتیبانی شده (صفحه کد شناسه) را می توان در اسناد برای یافت [libiconv](http://www.gnu.org/software/libiconv/) (پروژه گنو) یا در مستندات Microsoft Windows SDK برای "شناسه صفحه کد". اگر هیچ کدگذاری در پارامتر «رمزگذاری» مشخص نشده باشد، به شرح زیر است استراتژی های وضوح اعمال می شود: - اگر رمزگذاری مشخص نشده باشد (یا یک رشته خالی باشد) UTF-8 فرض می شود، داده ها "همانطور که هست" پردازش می شوند. - تجزیه و تحلیل BOM - قابل استفاده برای موارد "vfs.file.contents"، 'vfs.file.regexp'، 'vfs.file.regmatch'. تلاش می شود تا رمزگذاری صحیح را با استفاده از علامت ترتیب بایت (BOM) در تعیین کنید ابتدای فایل اگر BOM وجود نداشته باشد - استاندارد وضوح (به بالا مراجعه کنید) به جای آن اعمال می شود. # event.acknowledge # تایید رویداد ##### Event correlation Event correlation (also called global event correlation) is a way to set up custom event closing (resulting in OK event generation) rules. The rules define how the new problem events are paired with existing problem events and allow to close the new event or the matched events by generating corresponding OK events. However, event correlation must be configured very carefully, as it can negatively affect event processing performance or, if misconfigured, close more events than intended (in the worst case even all problem events could be closed). A few configuration tips: 1. always reduce the correlation scope by setting a unique tag for the control event (the event that is paired with old events) and use the 'new event tag' correlation condition 2. don't forget to add a condition based on the old event when using 'close old event' operation, or all existing problems could be closed 3. avoid using common tag names used by different correlation configurations ##### همبستگی رویداد همبستگی رویداد (همبستگی رویداد جهانی نیز نامیده می شود) راهی برای تنظیم است قوانین بسته شدن رویداد سفارشی (که منجر به تولید رویداد OK می شود). قوانین نحوه جفت شدن رویدادهای مشکل جدید با موجود را تعریف می کنند رویدادهای مشکل ساز و اجازه می دهد تا رویداد جدید یا رویدادهای منطبق توسط ایجاد رویدادهای OK مربوطه. با این حال، همبستگی رویداد باید بسیار با دقت پیکربندی شود، همانطور که می تواند بر عملکرد پردازش رویداد تأثیر منفی می گذارد یا در صورت پیکربندی اشتباه، رویدادهای بیشتری از آنچه در نظر گرفته شده را ببندید (در بدترین حالت حتی همه مشکلات رویدادها می توانند بسته شوند). چند نکته برای پیکربندی: 1. همیشه دامنه همبستگی را با تنظیم یک برچسب منحصر به فرد برای آن کاهش دهید رویداد را کنترل کنید (رویدادی که با رویدادهای قدیمی جفت شده است) و از آن استفاده کنید شرط همبستگی "برچسب رویداد جدید". 2. فراموش نکنید که هنگام استفاده، یک شرط بر اساس رویداد قدیمی اضافه کنید عملیات "بستن رویداد قدیمی" یا تمام مشکلات موجود می تواند باشد بسته 3. از استفاده از نام تگ های رایج که توسط همبستگی های مختلف استفاده می شود خودداری کنید پیکربندی # event.get دریافت رخداد ### Event tag The event tag object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |tag|string|Event tag name.| |value|string|Event tag value.| ### تگ رویداد The event tag object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |tag|string|Event tag name.| |value|string|Event tag value.| ### Example ### مثال ##### Example 10 CPU activity at any time with exception. Use of function time() and **not** operator: min(/zabbix/system.cpu.load[all,avg1],5m)>2 and not (dayofweek()=7 and time()>230000) and not (dayofweek()=1 and time()<010000) The trigger may change its state to problem at any time, except for 2 hours on a week change (Sunday, 23:00 - Monday, 01:00). ##### مثال 10 فعالیت CPU در هر زمان به استثنای. استفاده از تابع time() و عملگر **not**: min(/zabbix/system.cpu.load[all,avg1],5m)>2 و نه (dayofweek()=7 و time()>230000) و نه (dayofweek()=1 and time()<010000) ماشه ممکن است در هر زمانی حالت خود را به مشکل تغییر دهد، به جز 2 ساعت تغییر در هفته (یکشنبه، 23:00 - دوشنبه، 01:00). ##### Example 11 Check if client local time is in sync with Zabbix server time. Use of function fuzzytime(): fuzzytime(/MySQL_DB/system.localtime,10s)=0 The trigger will change to the problem state in case when local time on server MySQL\_DB and Zabbix server differs by more than 10 seconds. Note that 'system.localtime' must be configured as a [passive check](/manual/appendix/items/activepassive#passive_checks). ##### مثال 11 بررسی کنید که آیا زمان محلی مشتری با زمان سرور Zabbix همگام است یا خیر. استفاده از تابع fuzzytime(): fuzzytime(/MySQL_DB/system.localtime,10s)=0 در صورت روشن بودن زمان محلی، ماشه به حالت مشکل تغییر می کند سرور MySQL\_DB و سرور Zabbix بیش از 10 ثانیه با هم تفاوت دارند. توجه داشته باشید که "system.localtime" باید به عنوان یک [غیرفعال] پیکربندی شود بررسی کنید](/دستی/ضمیمه/items/activepassive#passive_checks). ##### Example 12 Comparing average load today with average load of the same time yesterday (using time shift as `now-1d`). avg(/server/system.cpu.load,1h)/avg(/server/system.cpu.load,1h:now-1d)>2 This trigger will fire if the average load of the last hour tops the average load of the same hour yesterday more than two times. ##### مثال 12 مقایسه میانگین بار امروز با میانگین بار در همان زمان دیروز (با استفاده از تغییر زمان به عنوان "اکنون-1d"). avg(/server/system.cpu.load,1h)/avg(/server/system.cpu.load,1h:now-1d)>2 این ماشه در صورتی که میانگین بار ساعت گذشته از آن بالاتر برود فعال می شود میانگین بار در همان ساعت دیروز بیش از دو بار. ##### Example 13 Using the value of another item to get a trigger threshold: last(/Template PfSense/hrStorageFree[{#SNMPVALUE}])<last(/Template PfSense/hrStorageSize[{#SNMPVALUE}])*0.1 The trigger will fire if the free storage drops below 10 percent. ##### مثال 13 استفاده از مقدار یک مورد دیگر برای به دست آوردن آستانه ماشه: last(/Template PfSense/hrStorageFree[{#SNMPVALUE}])<last(/Template PfSense/hrStorageSize[{#SNMPVALUE}])*0.1 اگر فضای ذخیره‌سازی رایگان به کمتر از 10 درصد برسد، ماشه فعال می‌شود. ##### Example 14 Using [evaluation result](#operators) to get the number of triggers over a threshold: (last(/server1/system.cpu.load[all,avg1])>5) + (last(/server2/system.cpu.load[all,avg1])>5) + (last(/server3/system.cpu.load[all,avg1])>5)>=2 The trigger will fire if at least two of the triggers in the expression are in a problem state. ##### مثال 14 استفاده از [نتیجه ارزیابی] (#اپراتورها) برای به دست آوردن تعداد محرک‌ها یک آستانه: (last(/server1/system.cpu.load[all,avg1])>5) + (last(/server2/system.cpu.load[all,avg1])>5) + (last(/server3/system. cpu.load[all,avg1])>5)>=2 اگر حداقل دو ماشه در عبارت بیان شوند، ماشه فعال می شود در وضعیت مشکل قرار دارند ##### Example 15 Comparing string values of two items - operands here are functions that return strings. Problem: create an alert if Ubuntu version is different on different hosts last(/NY Zabbix server/vfs.file.contents[/etc/os-release])<>last(/LA Zabbix server/vfs.file.contents[/etc/os-release]) ##### مثال 15 مقایسه مقادیر رشته دو مورد - عملوندها در اینجا توابعی هستند که رشته های برگشتی مشکل: در صورتی که نسخه اوبونتو متفاوت است، هشدار ایجاد کنید میزبان ها last(/NY Zabbix server/vfs.file.contents[/etc/os-release])<>last(/LA Zabbix server/vfs.file.contents[/etc/os-release]) ##### Example 16 Comparing two string values - operands are: - a function that returns a string - a combination of macros and strings Problem: detect changes in the DNS query The item key is: net.dns.record[8.8.8.8,{$WEBSITE_NAME},{$DNS_RESOURCE_RECORD_TYPE},2,1] with macros defined as {$WEBSITE_NAME} = example.com {$DNS_RESOURCE_RECORD_TYPE} = MX and normally returns: example.com MX 0 mail.example.com So our trigger expression to detect if the DNS query result deviated from the expected result is: last(/Zabbix server/net.dns.record[8.8.8.8,{$WEBSITE_NAME},{$DNS_RESOURCE_RECORD_TYPE},2,1])<>"{$WEBSITE_NAME} {$DNS_RESOURCE_RECORD_TYPE} 0 mail.{$WEBSITE_NAME}" Notice the quotes around the second operand. ##### مثال 16 مقایسه دو مقدار رشته - عملوندها عبارتند از: - تابعی که یک رشته را برمی گرداند - ترکیبی از ماکروها و رشته ها مشکل: تشخیص تغییرات در پرس و جو DNS کلید مورد این است: net.dns.record[8.8.8.8،{$WEBSITE_NAME}،{$DNS_RESOURCE_RECORD_TYPE}،2،1] با ماکروهایی که به صورت تعریف شده اند {$WEBSITE_NAME} = example.com {$DNS_RESOURCE_RECORD_TYPE} = MX و به طور معمول برمی گردد: example.com MX 0 mail.example.com بنابراین عبارت ماشه ای برای تشخیص انحراف نتیجه جستجوی DNS از نتیجه مورد انتظار این است: last(/Zabbix server/net.dns.record[8.8.8.8،{$WEBSITE_NAME}،{$DNS_RESOURCE_RECORD_TYPE}،2،1])<>"{$WEBSITE_NAME} {$DNS_RESOURCE_RECORD_TYPE} 0 ایمیل.{$WEBSITE_}. به نقل قول های اطراف عملوند دوم توجه کنید. ##### Example 17 Comparing two string values - operands are: - a function that returns a string - a string constant with special characters \\ and " Problem: detect if the `/tmp/hello` file content is equal to: \" //hello ?\" Option 1) write the string directly last(/Zabbix server/vfs.file.contents[/tmp/hello])="\\\" //hello ?\\\"" Notice how \\ and " characters are escaped when the string gets compared directly. Option 2) use a macro {$HELLO_MACRO} = \" //hello ?\" in the expression: last(/Zabbix server/vfs.file.contents[/tmp/hello])={$HELLO_MACRO} ##### مثال 17 مقایسه دو مقدار رشته - عملوندها عبارتند از: - تابعی که یک رشته را برمی گرداند - یک رشته ثابت با کاراکترهای خاص \\ و " مشکل: تشخیص دهید که محتوای فایل «/tmp/hello» برابر است با: \" //سلام ؟\" گزینه 1) رشته را مستقیم بنویسید last(/Zabbix server/vfs.file.contents[/tmp/hello])="\\\" //hello ?\\\"" توجه کنید که وقتی رشته با هم مقایسه می شود چگونه کاراکترهای \\ و " فرار می کنند به طور مستقیم. گزینه 2) از ماکرو استفاده کنید {$HELLO_MACRO} = \" //سلام ?\" در بیان: last(/Zabbix server/vfs.file.contents[/tmp/hello])={$HELLO_MACRO} ##### Example 18 Comparing long-term periods. Problem: Load of Exchange server increased by more than 10% last month trendavg(/Exchange/system.cpu.load,1M:now/M)>1.1*trendavg(/Exchange/system.cpu.load,1M:now/M-1M) You may also use the [Event name](/manual/config/triggers/trigger#configuration) field in trigger configuration to build a meaningful alert message, for example to receive something like `"Load of Exchange server increased by 24% in July (0.69) comparing to June (0.56)"` the event name must be defined as: Load of {HOST.HOST} server increased by {{?100*trendavg(//system.cpu.load,1M:now/M)/trendavg(//system.cpu.load,1M:now/M-1M)}.fmtnum(0)}% in {{TIME}.fmttime(%B,-1M)} ({{?trendavg(//system.cpu.load,1M:now/M)}.fmtnum(2)}) comparing to {{TIME}.fmttime(%B,-2M)} ({{?trendavg(//system.cpu.load,1M:now/M-1M)}.fmtnum(2)}) It is also useful to allow manual closing in trigger configuration for this kind of problem. ##### مثال 18 مقایسه دوره های بلندمدت مشکل: بار سرور Exchange در ماه گذشته بیش از 10٪ افزایش یافته است trendavg(/Exchange/system.cpu.load,1M:now/M)>1.1*trendavg(/Exchange/system.cpu.load,1M:now/M-1M) شما همچنین می توانید از [رویداد name](/manual/config/triggers/trigger#configuration) فیلد در ماشه پیکربندی برای ایجاد یک پیام هشدار معنی دار، به عنوان مثال به دریافت چیزی شبیه به "بار سرور Exchange در جولای (0.69) در مقایسه با ژوئن (0.56) 24٪ افزایش یافته است." نام رویداد باید به صورت زیر تعریف شود: بار سرور {HOST.HOST} با {{?100*trendavg(//system.cpu.load,1M:now/M)/trendavg(//system.cpu.load,1M:now/M-1M) افزایش یافت }.fmtnum(0)}% در {{TIME}.fmttime(%B,-1M)} ({{?trendavg(//system.cpu.load,1M:now/M)}.fmtnum(2)} ) در مقایسه با {{TIME}.fmttime(%B,-2M)} ({{?trendavg(//system.cpu.load,1M:now/M-1M)}.fmtnum(2)}) همچنین امکان بستن دستی در پیکربندی ماشه مفید است این نوع مشکل ##### Example 1 General example: |Parameter|Description| |--|--------| |**OID**|1.2.3.45.6.7.8.0 (or .1.2.3.45.6.7.8.0)| |**Key**|<Unique string to be used as reference to triggers><br>For example, "my\_param".| Note that OID can be given in either numeric or string form. However, in some cases, string OID must be converted to numeric representation. Utility snmpget may be used for this purpose: snmpget -On localhost public enterprises.ucdavis.memory.memTotalSwap.0 ##### مثال 1 مثال کلی: |پارامتر|توضیحات| |--|--------| |**OID**|1.2.3.45.6.7.8.0 (یا .1.2.3.45.6.7.8.0)| |**Key**|<رشته منحصر به فرد برای استفاده به عنوان مرجع به تریگرها <br>به عنوان مثال، "my\_param".| توجه داشته باشید که OID می تواند به صورت عددی یا رشته ای ارائه شود. با این حال، در در برخی موارد، رشته OID باید به نمایش عددی تبدیل شود. برای این منظور می توان از ابزار snmpget استفاده کرد: snmpget -On localhost public enterprises.ucdavis.memory.memTotalSwap.0 ##### Example 1 Something very simple: UserParameter=ping[*],echo $1 We may define unlimited number of items for monitoring all having format ping\[something\]. - ping\[0\] - will always return '0' - ping\[aaa\] - will always return 'aaa' ##### مثال 1 یه چیز خیلی ساده: UserParameter=ping[*],echo $1 ما ممکن است تعداد نامحدودی از آیتم ها را برای نظارت بر همه فرمت ها تعریف کنیم پینگ\[چیزی\]. - ping\[0\] - همیشه '0' برمی گردد - ping\[aaa\] - همیشه "aaa" برمی‌گردد ##### Example 1 Temperature in server room is too high. Problem expression: last(/server/temp)>20 Recovery expression: last(/server/temp)<=15 ##### مثال 1 دمای اتاق سرور خیلی بالاست. بیان مسئله: last(/server/temp)> 20 عبارت بازیابی: last(/server/temp)<=15 ##### Example 1 The processor load is too high on Zabbix server. last(/Zabbix server/system.cpu.load[all,avg1])>5 By using the function 'last()', we are referencing the most recent value. `/Zabbix server/system.cpu.load[all,avg1]` gives a short name of the monitored parameter. It specifies that the host is 'Zabbix server' and the key being monitored is 'system.cpu.load\[all,avg1\]'. Finally, `>5` means that the trigger is in the PROBLEM state whenever the most recent processor load measurement from Zabbix server is greater than 5. ##### مثال 1 بار پردازنده در سرور Zabbix بسیار زیاد است. last(/Zabbix server/system.cpu.load[all,avg1])>5 با استفاده از تابع 'last()'، به جدیدترین آنها ارجاع می دهیم ارزش. `/Zabbix server/system.cpu.load[all,avg1]` نام کوتاهی از پارامتر نظارت شده مشخص می کند که میزبان "سرور Zabbix" است و کلید تحت نظارت 'system.cpu.load\[all,avg1\]' است. سرانجام، «> 5» به این معنی است که ماشه در هر زمان که بیشتر باشد در حالت PROBLEM است اندازه گیری بار پردازنده اخیر از سرور Zabbix بیشتر از 5 است. ##### Example 1 Total disk space of host group 'MySQL Servers'. sum(last_foreach(/*/vfs.fs.size[/,total]?[group="MySQL Servers"])) ##### مثال 1 فضای دیسک کل گروه میزبان «سرورهای MySQL». sum(last_foreach(/*/vfs.fs.size[/,total]?[group="MySQL Servers"])) ##### Example 2 Free disk space is too low. Problem expression: it is less than 10GB for last 5 minutes max(/server/vfs.fs.size[/,free],5m)<10G Recovery expression: it is more than 40GB for last 10 minutes min(/server/vfs.fs.size[/,free],10m)>40G ##### مثال 2 فضای آزاد دیسک خیلی کم است. بیان مشکل: برای 5 دقیقه آخر کمتر از 10 گیگابایت است max(/server/vfs.fs.size[/,free],5m)<10G بیان بازیابی: بیش از 40 گیگابایت برای 10 دقیقه گذشته است min(/server/vfs.fs.size[/,free],10m)>40G ##### Example 2 Let's add more sense! UserParameter=mysql.ping[*],mysqladmin -u$1 -p$2 ping | grep -c alive This parameter can be used for monitoring availability of MySQL database. We can pass user name and password: mysql.ping[zabbix,our_password] ##### مثال 2 بیایید حس بیشتری اضافه کنیم! UserParameter=mysql.ping[*],mysqladmin -u$1 -p$2 پینگ | grep -c زنده این پارامتر می تواند برای نظارت بر در دسترس بودن MySQL استفاده شود پایگاه داده ما می توانیم نام کاربری و رمز عبور را ارسال کنیم: mysql.ping[zabbix,our_password] ##### Example 2 Monitoring of uptime: |Parameter|Description| |--|--------| |**OID**|MIB::sysUpTime.0| |**Key**|router.uptime| |**Value type**|Float| |**Units**|uptime| |**Preprocessing step: Custom multiplier**|0.01| ##### مثال 2 نظارت بر زمان کار: |پارامتر|توضیحات| |--|--------| |**OID**|MIB::sysUpTime.0| |**Key**|router.uptime| |**نوع مقدار**|Float| |**واحدها**|آپتایم| |**مرحله پیش پردازش: ضرب کننده سفارشی**|0.01| ##### Example 2 Sum of latest values of all items matching net.if.in\[\*\] on the host. sum(last_foreach(/host/net.if.in[*])) ##### مثال 2 مجموع آخرین مقادیر همه موارد مطابق با net.if.in\[\*\] در میزبان. sum(last_foreach(/host/net.if.in[*])) ##### Example 2 www.example.com is overloaded. last(/www.example.com/system.cpu.load[all,avg1])>5 or min(/www.example.com/system.cpu.load[all,avg1],10m)>2 The expression is true when either the current processor load is more than 5 or the processor load was more than 2 during last 10 minutes. ##### مثال 2 www.example.com بیش از حد بارگذاری شده است. last(/www.example.com/system.cpu.load[all,avg1])>5 یا دقیقه(/www.example.com/system.cpu.load[all,avg1],10m)>2 این عبارت زمانی درست است که بار پردازنده فعلی بیشتر باشد از 5 یا بار پردازنده در 10 دقیقه گذشته بیش از 2 بوده است. ##### Example 3 Average processor load of host group 'MySQL Servers'. avg(last_foreach(/*/system.cpu.load[,avg1]?[group="MySQL Servers"])) ##### مثال 1 فضای دیسک کل گروه میزبان «سرورهای MySQL». sum(last_foreach(/*/vfs.fs.size[/,total]?[group="MySQL Servers"])) ##### Example 3 /etc/passwd has been changed. last(/www.example.com/vfs.file.cksum[/etc/passwd],#1)<>last(/www.example.com/vfs.file.cksum[/etc/passwd],#2) The expression is true when the previous value of /etc/passwd checksum differs from the most recent one. Similar expressions could be useful to monitor changes in important files, such as /etc/passwd, /etc/inetd.conf, /kernel, etc. ##### مثال 3 /etc/passwd تغییر کرده است. last(/www.example.com/vfs.file.cksum[/etc/passwd],#1)<>last(/www.example.com/vfs.file.cksum[/etc/passwd],#2) این عبارت زمانی درست است که مقدار قبلی /etc/passwd checksum باشد با جدیدترین آنها متفاوت است. عبارات مشابه می تواند برای نظارت بر تغییرات مهم مفید باشد فایل‌هایی مانند /etc/passwd، /etc/inetd.conf، /kernel و غیره. ##### Example 3 How many lines matching a regular expression in a file? UserParameter=wc[*],grep -c "$2" $1 This parameter can be used to calculate number of lines in a file. wc[/etc/passwd,root] wc[/etc/services,zabbix] ##### مثال 3 چند خط با یک عبارت منظم در یک فایل مطابقت دارد؟ UserParameter=wc[*],grep -c "$2" $1 از این پارامتر می توان برای محاسبه تعداد خطوط یک فایل استفاده کرد. wc[/etc/passwd,root] wc[/etc/services,zabbix] ##### Example 4 5-minute average of the number of queries per second for host group 'MySQL Servers'. avg(avg_foreach(/*/mysql.qps?[group="MySQL Servers"],5m)) ##### مثال 4 میانگین 5 دقیقه تعداد پرس و جو در ثانیه برای گروه میزبان "سرورهای MySQL". avg(avg_foreach(/*/mysql.qps?[group="MySQL Servers"]،5m)) ##### Example 4 Someone is downloading a large file from the Internet. Use of function min: min(/www.example.com/net.if.in[eth0,bytes],5m)>100K The expression is true when number of received bytes on eth0 is more than 100 KB within last 5 minutes. ##### مثال 4 شخصی در حال دانلود یک فایل بزرگ از اینترنت است. استفاده از تابع min: min(/www.example.com/net.if.in[eth0,bytes],5m)>100K این عبارت زمانی درست است که تعداد بایت های دریافتی روی eth0 بیشتر باشد بیش از 100 کیلوبایت در 5 دقیقه گذشته ##### Example 5 Average CPU load on all hosts in multiple host groups that have the specific tags. avg(last_foreach(/*/system.cpu.load?[(group="Servers A" or group="Servers B" or group="Servers C") and (tag="Service:" or tag="Importance:High")])) ##### مثال 5 میانگین بار CPU در همه میزبان ها در چندین گروه میزبان که دارای این هستند برچسب های خاص avg(last_foreach(/*/system.cpu.load?[(group="Servers A" or group="Servers B" or group="Servers C") and (tag="Service:" or tag="اهمیت: بالا")])) ##### Example 5 Both nodes of clustered SMTP server are down. Note use of two different hosts in one expression: last(/smtp1.example.com/net.tcp.service[smtp])=0 and last(/smtp2.example.com/net.tcp.service[smtp])=0 The expression is true when both SMTP servers are down on both smtp1.example.com and smtp2.example.com. ##### مثال 5 هر دو گره سرور SMTP خوشه ای از کار افتاده اند. به استفاده از دو میزبان مختلف در یک عبارت توجه کنید: last(/smtp1.example.com/net.tcp.service[smtp])=0 و last(/smtp2.example.com/net.tcp.service[smtp])=0 این عبارت زمانی درست است که هر دو سرور SMTP در هر دو از کار افتاده باشند smtp1.example.com و smtp2.example.com. ##### Example 6 Calculation used on the latest item value sums of a whole host group. sum(last_foreach(/*/net.if.out[eth0,bytes]?[group="video"])) / sum(last_foreach(/*/nginx_stat.sh[active]?[group="video"])) ##### مثال 6 محاسبه استفاده شده بر روی آخرین مجموع ارزش آیتم کل گروه میزبان. sum(last_foreach(/*/net.if.out[eth0,bytes]?[group="video"])) / sum(last_foreach(/*/nginx_stat.sh[active]?[group="video"]) ) ##### Example 6 Zabbix agent needs to be upgraded. Use of function find(): find(/example.example.com/agent.version,,"like","beta8")=1 The expression is true if Zabbix agent has version beta8. ##### مثال 6 عامل Zabbix باید ارتقا یابد. استفاده از تابع find(): find(/example.example.com/agent.version,"like","beta8")=1 اگر عامل Zabbix نسخه beta8 داشته باشد، این عبارت درست است. ##### Example 7 Server is unreachable. count(/example.example.com/icmpping,30m,,"0")>5 The expression is true if host "example.example.com" is unreachable more than 5 times in the last 30 minutes. ##### مثال 7 سرور غیر قابل دسترسی است count(/example.example.com/impping,30m,"0")>5 اگر میزبان "example.example.com" بیشتر غیرقابل دسترسی باشد، عبارت درست است بیش از 5 بار در 30 دقیقه گذشته. ##### Example 7 The total number of unsupported items in host group 'Zabbix servers'. sum(last_foreach(/*/zabbix[host,,items_unsupported]?[group="Zabbix servers"])) ##### مثال 7 تعداد کل موارد پشتیبانی نشده در گروه میزبان "سرورهای Zabbix". sum(last_foreach(/*/zabbix[host,,items_unsupported]?[group="servers Zabbix"])) ##### Example 8 No heartbeats within last 3 minutes. Use of function nodata(): nodata(/example.example.com/tick,3m)=1 To make use of this trigger, 'tick' must be defined as a Zabbix [trapper](/manual/config/items/itemtypes/trapper) item. The host should periodically send data for this item using zabbix\_sender. If no data is received within 180 seconds, the trigger value becomes PROBLEM. *Note* that 'nodata' can be used for any item type. ##### مثال 8 بدون ضربان قلب در 3 دقیقه گذشته استفاده از تابع nodata(): nodata(/example.example.com/tick,3m)=1 برای استفاده از این ماشه، 'تیک' باید به عنوان Zabbix تعریف شود [trapper](/manual/config/items/itemtypes/trapper) مورد. میزبان باید به صورت دوره ای داده های این مورد را با استفاده از zabbix\_sender ارسال کنید. اگر داده ای وجود ندارد دریافت شده در عرض 180 ثانیه، مقدار ماشه مشکل می شود. *توجه داشته باشید* که 'nodata' را می توان برای هر نوع موردی استفاده کرد. ##### Example 9 CPU activity at night time. Use of function time(): min(/Zabbix server/system.cpu.load[all,avg1],5m)>2 and time()<060000 The trigger may change its state to problem only at night time (00:00 - 06:00). ##### مثال 9 فعالیت CPU در شب استفاده از تابع زمان(): min(/Zabbix server/system.cpu.load[all,avg1],5m)>2 and time()<060000 ماشه ممکن است فقط در شب (00:00 - 06:00) حالت خود را به مشکل تغییر دهد. Example of using runtime control to reload the server configuration cache: zabbix_server -c /usr/local/etc/zabbix_server.conf -R config_cache_reload Examples of using runtime control to gather diagnostic information: # Gather all available diagnostic information in the server log file: zabbix_server -R diaginfo # Gather history cache statistics in the server log file: zabbix_server -R diaginfo=historycache Example of using runtime control to reload the SNMP cache: zabbix_server -R snmp_cache_reload Example of using runtime control to trigger execution of housekeeper: zabbix_server -c /usr/local/etc/zabbix_server.conf -R housekeeper_execute Examples of using runtime control to change log level: # Increase log level of all processes: zabbix_server -c /usr/local/etc/zabbix_server.conf -R log_level_increase # Increase log level of second poller process: zabbix_server -c /usr/local/etc/zabbix_server.conf -R log_level_increase=poller,2 # Increase log level of process with PID 1234: zabbix_server -c /usr/local/etc/zabbix_server.conf -R log_level_increase=1234 # Decrease log level of all http poller processes: zabbix_server -c /usr/local/etc/zabbix_server.conf -R log_level_decrease="http poller" Example of setting the HA failover delay to the minimum of 10 seconds: zabbix_server -R ha_set_failover_delay=10s مثالی از استفاده از کنترل زمان اجرا برای بارگذاری مجدد پیکربندی سرور حافظه پنهان: zabbix_server -c /usr/local/etc/zabbix_server.conf -R config_cache_reload نمونه هایی از استفاده از کنترل زمان اجرا برای جمع آوری اطلاعات تشخیصی: # تمام اطلاعات تشخیصی موجود را در فایل گزارش سرور جمع آوری کنید: zabbix_server -R diaginfo # آمار کش تاریخچه را در فایل گزارش سرور جمع آوری کنید: zabbix_server -R diaginfo=historycache مثالی از استفاده از کنترل زمان اجرا برای بارگذاری مجدد کش SNMP: zabbix_server -R snmp_cache_reload مثالی از استفاده از کنترل زمان اجرا برای راه اندازی اجرای خانه نگهدار: zabbix_server -c /usr/local/etc/zabbix_server.conf -R housekeeper_execute نمونه هایی از استفاده از کنترل زمان اجرا برای تغییر سطح گزارش: # افزایش سطح گزارش تمام فرآیندها: zabbix_server -c /usr/local/etc/zabbix_server.conf -R log_level_increase # افزایش سطح گزارش فرآیند دوم نظرسنجی: zabbix_server -c /usr/local/etc/zabbix_server.conf -R log_level_increase=poller,2 # سطح گزارش فرآیند را با PID 1234 افزایش دهید: zabbix_server -c /usr/local/etc/zabbix_server.conf -R log_level_increase=1234 # سطح گزارش تمام فرآیندهای نظرسنجی http را کاهش دهید: zabbix_server -c /usr/local/etc/zabbix_server.conf -R log_level_decrease="http poller" مثالی از تنظیم تأخیر شکست HA روی حداقل 10 ثانیه: zabbix_server -R ha_set_failover_delay=10s ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها #### Examples ### مثال ها ##### Examples of correct/incorrect syntax Expressions (including function calls) cannot be used as history, trend, or foreach [function](/manual/appendix/functions) parameters. However, those functions themselves can be used in other (non-historical) function parameters. |Expression|Example| |-|---------| |Valid|`avg(last(/host/key1),last(/host/key2)*10,last(/host/key1)*100)`<br>`max(avg(avg_foreach(/*/system.cpu.load?[group="Servers A"],5m)),avg(avg_foreach(/*/system.cpu.load?[group="Servers B"],5m)),avg(avg_foreach(/*/system.cpu.load?[group="Servers C"],5m)))`| |Invalid|`sum(/host/key,10+2)`<br>`sum(/host/key, avg(10,2))`<br>`sum(/host/key,last(/host/key2))`| Note that in an expression like: sum(sum_foreach(//resptime[*],5m))/sum(count_foreach(//resptime[*],5m)) it cannot be guaranteed that both parts of the equation will always have the same set of values. While one part of the expression is evaluated, a new value for the requested period may arrive and then the other part of the expression will have a different set of values. ##### نمونه هایی از نحو صحیح/نادرست عبارات (از جمله فراخوانی تابع) را نمی توان به عنوان تاریخچه، روند، یا پارامترهای foreach [function](/manual/appendix/functions) استفاده کرد. با این حال، خود آن توابع می توانند در پارامترهای تابع دیگر (غیر تاریخی) استفاده شوند. |بیان|مثال| |-|---------| |معتبر|`avg(last(/host/key1),last(/host/key2)*10,last(/host/key1)*100)`<br>`max(avg(avg_foreach(/*/system. cpu.load?[group="Servers A"],5m)),avg(avg_foreach(/*/system.cpu.load?[group="Servers B"],5m)),avg(avg_foreach(/*/ system.cpu.load?[group="Servers C"],5m)))`| |نامعتبر|`sum(/host/key,10+2)`<br>`sum(/host/key, avg(10,2))`<br>`sum(/host/key,last(/host /key2))`| توجه داشته باشید که در عبارتی مانند: sum(sum_foreach(//sptime[*],5m))/sum(count_foreach(//resptime[*],5m)) نمی توان تضمین کرد که هر دو بخش معادله همیشه دارای مجموعه ای از مقادیر یکسان باشند. در حالی که یک قسمت از عبارت ارزیابی می شود، مقدار جدیدی برای دوره درخواستی ممکن است وارد شود و سپس قسمت دیگر عبارت دارای مجموعه ای متفاوت از مقادیر خواهد بود. ##### Examples of simple user parameters A simple command: UserParameter=ping,echo 1 The agent will always return '1' for an item with 'ping' key. A more complex example: UserParameter=mysql.ping,mysqladmin -uroot ping | grep -c alive The agent will return '1', if MySQL server is alive, '0' - otherwise. ##### نمونه هایی از پارامترهای ساده کاربر یک دستور ساده: UserParameter=پینگ، اکو 1 نماینده همیشه برای یک آیتم با کلید "پینگ" "1" را برمی گرداند. مثال پیچیده تر: UserParameter=mysql.ping,mysqladmin -uroot ping | grep -c زنده اگر سرور MySQL زنده باشد، نماینده '1' را برمی گرداند - در غیر این صورت. #### Examples of triggers #### نمونه هایی از محرک ها ### Examples Request: ``` {.java} { "jsonrpc": "2.0", "method": "autoregistration.get", "params": { "output": "extend" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "tls_accept": "3" }, "id": 1 } ``` ### مثال ها Request: ``` {.java} { "jsonrpc": "2.0", "method": "autoregistration.get", "params": { "output": "extend" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "tls_accept": "3" }, "id": 1 } ``` ### Examples Request: ```json { "jsonrpc": "2.0", "method": "authentication.get", "params": { "output": "extend" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "authentication_type": "0", "http_auth_enabled": "0", "http_login_form": "0", "http_strip_domains": "", "http_case_sensitive": "1", "ldap_configured": "0", "ldap_host": "", "ldap_port": "389", "ldap_base_dn": "", "ldap_search_attribute": "", "ldap_bind_dn": "", "ldap_case_sensitive": "1", "ldap_bind_password": "", "saml_auth_enabled": "0", "saml_idp_entityid": "", "saml_sso_url": "", "saml_slo_url": "", "saml_username_attribute": "", "saml_sp_entityid": "", "saml_nameid_format": "", "saml_sign_messages": "0", "saml_sign_assertions": "0", "saml_sign_authn_requests": "0", "saml_sign_logout_requests": "0", "saml_sign_logout_responses": "0", "saml_encrypt_nameid": "0", "saml_encrypt_assertions": "0", "saml_case_sensitive": "0", "passwd_min_length": "8", "passwd_check_rules": "8" }, "id": 1 } ``` ### مثال ها Request: ```json { "jsonrpc": "2.0", "method": "authentication.get", "params": { "output": "extend" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "authentication_type": "0", "http_auth_enabled": "0", "http_login_form": "0", "http_strip_domains": "", "http_case_sensitive": "1", "ldap_configured": "0", "ldap_host": "", "ldap_port": "389", "ldap_base_dn": "", "ldap_search_attribute": "", "ldap_bind_dn": "", "ldap_case_sensitive": "1", "ldap_bind_password": "", "saml_auth_enabled": "0", "saml_idp_entityid": "", "saml_sso_url": "", "saml_slo_url": "", "saml_username_attribute": "", "saml_sp_entityid": "", "saml_nameid_format": "", "saml_sign_messages": "0", "saml_sign_assertions": "0", "saml_sign_authn_requests": "0", "saml_sign_logout_requests": "0", "saml_sign_logout_responses": "0", "saml_encrypt_nameid": "0", "saml_encrypt_assertions": "0", "saml_case_sensitive": "0", "passwd_min_length": "8", "passwd_check_rules": "8" }, "id": 1 } ``` ### Examples Request: ```json { "jsonrpc": "2.0", "method": "authentication.update", "params": { "http_auth_enabled": 1, "http_case_sensitive": 0, "http_login_form": 1 }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ "http_auth_enabled", "http_case_sensitive", "http_login_form" ], "id": 1 } ``` ### مثال ها Request: ```json { "jsonrpc": "2.0", "method": "authentication.update", "params": { "http_auth_enabled": 1, "http_case_sensitive": 0, "http_login_form": 1 }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ "http_auth_enabled", "http_case_sensitive", "http_login_form" ], "id": 1 } ``` ### Examples Request: ```json { "jsonrpc": "2.0", "method": "autoregistration.update", "params": { "tls_accept": "3", "tls_psk_identity": "PSK 001", "tls_psk": "11111595725ac58dd977beef14b97461a7c1045b9a1c923453302c5473193478" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": true, "id": 1 } ``` ### مثال ها Request: ```json { "jsonrpc": "2.0", "method": "autoregistration.update", "params": { "tls_accept": "3", "tls_psk_identity": "PSK 001", "tls_psk": "11111595725ac58dd977beef14b97461a7c1045b9a1c923453302c5473193478" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": true, "id": 1 } ``` ### Examples Request: ```json { "jsonrpc": "2.0", "method": "housekeeping.get", "params": { "output": "extend" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "hk_events_mode": "1", "hk_events_trigger": "365d", "hk_events_service": "1d", "hk_events_internal": "1d", "hk_events_discovery": "1d", "hk_events_autoreg": "1d", "hk_services_mode": "1", "hk_services": "365d", "hk_audit_mode": "1", "hk_audit": "365d", "hk_sessions_mode": "1", "hk_sessions": "365d", "hk_history_mode": "1", "hk_history_global": "0", "hk_history": "90d", "hk_trends_mode": "1", "hk_trends_global": "0", "hk_trends": "365d", "db_extension": "", "compression_status": "0", "compress_older": "7d" }, "id": 1 } ``` ###مثال ها Request: ```json { "jsonrpc": "2.0", "method": "housekeeping.get", "params": { "output": "extend" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "hk_events_mode": "1", "hk_events_trigger": "365d", "hk_events_service": "1d", "hk_events_internal": "1d", "hk_events_discovery": "1d", "hk_events_autoreg": "1d", "hk_services_mode": "1", "hk_services": "365d", "hk_audit_mode": "1", "hk_audit": "365d", "hk_sessions_mode": "1", "hk_sessions": "365d", "hk_history_mode": "1", "hk_history_global": "0", "hk_history": "90d", "hk_trends_mode": "1", "hk_trends_global": "0", "hk_trends": "365d", "db_extension": "", "compression_status": "0", "compress_older": "7d" }, "id": 1 } ``` ### Examples Request: ```json { "jsonrpc": "2.0", "method": "housekeeping.update", "params": { "hk_events_mode": "1", "hk_events_trigger": "200d", "hk_events_internal": "2d", "hk_events_discovery": "2d" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ "hk_events_mode", "hk_events_trigger", "hk_events_internal", "hk_events_discovery" ], "id": 1 } ``` ### مثال ها Request: ```json { "jsonrpc": "2.0", "method": "housekeeping.update", "params": { "hk_events_mode": "1", "hk_events_trigger": "200d", "hk_events_internal": "2d", "hk_events_discovery": "2d" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ "hk_events_mode", "hk_events_trigger", "hk_events_internal", "hk_events_discovery" ], "id": 1 } ``` ### Examples Request: ```json { "jsonrpc": "2.0", "method": "settings.update", "params": { "login_attempts": "1", "login_block": "1m" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ "login_attempts", "login_block" ], "id": 1 } ``` ### مثال ها Request: ``` {.java} { "jsonrpc": "2.0", "method": "autoregistration.get", "params": { "output": "extend" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "tls_accept": "3" }, "id": 1 } ``` ### Examples The following examples aim to only describe the configuration of the dashboard widget field objects for the *Data overview* widget. For more information on configuring a dashboard, see [`dashboard.create`](/manual/api/reference/dashboard/create). ### مثال ها هدف مثال‌های زیر فقط تشریح پیکربندی اشیاء فیلد ویجت داشبورد برای ویجت *نمای کلی داده* است. برای اطلاعات بیشتر در مورد پیکربندی داشبورد، به [`dashboard.create`](/manual/api/reference/dashboard/create) مراجعه کنید. ### Examples The following examples aim to only describe the configuration of the dashboard widget field objects for the *Top hosts* widget. For more information on configuring a dashboard, see [`dashboard.create`](/manual/api/reference/dashboard/create). ### مثال ها هدف مثال‌های زیر فقط تشریح پیکربندی اشیاء فیلد ویجت داشبورد برای ویجت *نمای کلی داده* است. برای اطلاعات بیشتر در مورد پیکربندی داشبورد، به [`dashboard.create`](/manual/api/reference/dashboard/create) مراجعه کنید. ## EXAMPLES **zabbix\_get -s 127.0.0.1 -p 10050 -k "system.cpu.load\[all,avg1\]"**\ **zabbix\_get -s 127.0.0.1 -p 10050 -k "system.cpu.load\[all,avg1\]" --tls-connect cert --tls-ca-file /home/zabbix/zabbix\_ca\_file --tls-agent-cert-issuer "CN=Signing CA,OU=IT operations,O=Example Corp,DC=example,DC=com" --tls-agent-cert-subject "CN=server1,OU=IT operations,O=Example Corp,DC=example,DC=com" --tls-cert-file /home/zabbix/zabbix\_get.crt --tls-key-file /home/zabbix/zabbix\_get.key\ zabbix\_get -s 127.0.0.1 -p 10050 -k "system.cpu.load\[all,avg1\]" --tls-connect psk --tls-psk-identity "PSK ID Zabbix agentd" --tls-psk-file /home/zabbix/zabbix\_agentd.psk** [ ]{#lbAH} ## مثال ها **zabbix\_get -s 127.0.0.1 -p 10050 -k "system.cpu.load\[all,avg1\]"**\ **zabbix\_get -s 127.0.0.1 -p 10050 -k "system.cpu.load\[all,avg1\]" --tls-connect Cert --tls-ca-file /home/zabbix/zabbix\_ca\_file --tls-agent-cert-issuer "CN=امضای عملیات CA,OU=IT,O=مثال Corp,DC=example,DC=com" --tls-agent-cert-subject "CN=server1,OU=IT عملیات,O=Example Corp,DC=example,DC=com" --tls-cert-file /home/zabbix/zabbix\_get.crt --tls-key-file /home/zabbix/zabbix\_get.key\ zabbix\_get -s 127.0.0.1 -p 10050 -k "system.cpu.load\[all,avg1\]" --tls-connect psk --tls-psk-identity "PSK ID Zabbix agentd" --tls-psk-file /home/zabbix/zabbix\_agentd.psk** [ ]{#lbAH} ## EXAMPLES **zabbix\_js -s script-file.js -p example** [ ]{#lbAG} ## مثال ها **zabbix\_js -s script-file.js -p مثال** [ ]{#lbAG} ## EXAMPLES **zabbix\_sender -c /etc/zabbix/zabbix\_agentd.conf -k mysql.queries -o 342.45**\ Send **342.45** as the value for **mysql.queries** item of monitored host. Use monitored host and Zabbix server defined in agent configuration file. **zabbix\_sender -c /etc/zabbix/zabbix\_agentd.conf -s "Monitored Host" -k mysql.queries -o 342.45**\ Send **342.45** as the value for **mysql.queries** item of **Monitored Host** host using Zabbix server defined in agent configuration file. \ **zabbix\_sender -z 192.168.1.113 -i data\_values.txt** \ Send values from file **data\_values.txt** to Zabbix server with IP **192.168.1.113**. Host names and keys are defined in the file. \ **echo "- hw.serial.number 1287872261 SQ4321ASDF" | zabbix\_sender -c /usr/local/etc/zabbix\_agentd.conf -T -i -**\ Send a timestamped value from the commandline to Zabbix server, specified in the agent configuration file. Dash in the input data indicates that hostname also should be used from the same configuration file. \ **echo '"Zabbix server" trapper.item ""' | zabbix\_sender -z 192.168.1.113 -p 10000 -i -**\ Send empty value of an item to the Zabbix server with IP address **192.168.1.113** on port **10000** from the commandline. Empty values must be indicated by empty double quotes. **zabbix\_sender -z 192.168.1.113 -s "Monitored Host" -k mysql.queries -o 342.45 --tls-connect cert --tls-ca-file /home/zabbix/zabbix\_ca\_file --tls-cert-file /home/zabbix/zabbix\_agentd.crt --tls-key-file /home/zabbix/zabbix\_agentd.key**\ Send **342.45** as the value for **mysql.queries** item in **Monitored Host** host to server with IP **192.168.1.113** using TLS with certificate. **zabbix\_sender -z 192.168.1.113 -s "Monitored Host" -k mysql.queries -o 342.45 --tls-connect psk --tls-psk-identity "PSK ID Zabbix agentd" --tls-psk-file /home/zabbix/zabbix\_agentd.psk**\ Send **342.45** as the value for **mysql.queries** item in **Monitored Host** host to server with IP **192.168.1.113** using TLS with pre-shared key (PSK). [ ]{#lbAI} ## مثال ها **zabbix\_sender -c /etc/zabbix/zabbix\_agentd.conf -k mysql.queries -o 342.45**\ ارسال **342.45** به عنوان مقدار برای **mysql.queries** مورد نظارت شده میزبان. از میزبان نظارت شده و سرور Zabbix تعریف شده در عامل استفاده کنید فایل پیکربندی. **zabbix\_sender -c /etc/zabbix/zabbix\_agentd.conf -s "میزبان نظارت شده" -k mysql.queries -o 342.45**\ ارسال **342.45** به عنوان مقدار برای **mysql.queries** مورد **Monitored میزبان ** با استفاده از سرور Zabbix تعریف شده در فایل پیکربندی عامل. \ **zabbix\_sender -z 192.168.1.113 -i data\_values.txt** \ مقادیر را از فایل **data\_values.txt** به سرور Zabbix با IP ارسال کنید **192.168.1.113**. نام هاست و کلیدها در فایل تعریف شده است. \ **echo "- hw.serial.number 1287872261 SQ4321ASDF" | zabbix\_sender -c /usr/local/etc/zabbix\_agentd.conf -T -i -**\ یک مقدار مهر زمانی از خط فرمان به سرور Zabbix ارسال کنید، در فایل پیکربندی عامل مشخص شده است. خط تیره در داده های ورودی نشان می دهد که نام میزبان نیز باید از همان پیکربندی استفاده شود فایل. \ **echo '"سرور Zabbix" trapper.item ""' | zabbix\_sender -z 192.168.1.113 -p 10000 -i -**\ مقدار خالی یک مورد را با آدرس IP به سرور Zabbix ارسال کنید **192.168.1.113** در پورت **10000** از خط فرمان. ارزش های خالی باید با دو نقل قول خالی نشان داده شود. **zabbix\_sender -z 192.168.1.113 -s "میزبان نظارت شده" -k mysql.queries -o 342.45 --tls-connect Cert --tls-ca-file /home/zabbix/zabbix\_ca\_file --tls-cert-file /home/zabbix/zabbix\_agentd.crt --tls-key-file /home/zabbix/zabbix\_agentd.key**\ ارسال **342.45** به عنوان مقدار مورد **mysql.queries** در **Monitored میزبان ** میزبان به سرور با IP **192.168.1.113** با استفاده از TLS با گواهی **zabbix\_sender -z 192.168.1.113 -s "میزبان نظارت شده" -k mysql.queries -o 342.45 --tls-connect psk --tls-psk-identity "PSK ID Zabbix agent" --tls-psk-file /home/zabbix/zabbix\_agentd.psk**\ ارسال **342.45** به عنوان مقدار مورد **mysql.queries** در **Monitored میزبان ** میزبان به سرور با IP **192.168.1.113** با استفاده از TLS با کلید از پیش مشترک (PSK). [ ]{#lbAI} #### Exit code Before version 2.2 Zabbix agent returned 0 in case of successful exit and 255 in case of failure. Starting from version 2.2 and higher Zabbix agent returns 0 in case of successful exit and 1 in case of failure. #### کد خروج قبل از نسخه 2.2 عامل Zabbix در صورت خروج موفقیت آمیز 0 را برمی گرداند و 255 در صورت خرابی. شروع از نسخه 2.2 و بالاتر Zabbix عامل در صورت خروج موفقیت آمیز 0 و در صورت شکست 1 برمی گرداند. ## EXIT STATUS The exit status is 0 if the values were sent and all of them were successfully processed by server. If data was sent, but processing of at least one of the values failed, the exit status is 2. If data sending failed, the exit status is 1. [ ]{#lbAH} ## وضعیت خروج اگر مقادیر ارسال شده باشند و همه آنها ارسال شده باشند، وضعیت خروج 0 است با موفقیت توسط سرور پردازش شد. اگر داده ها ارسال شد، اما پردازش در حداقل یکی از مقادیر ناموفق، وضعیت خروج 2 است. در صورت ارسال داده ها ناموفق، وضعیت خروج 1 است. [ ]{#lbAH} ##### Export format Data can be exported using the Zabbix web frontend or [Zabbix API](/manual/api/reference/configuration). Supported export formats are YAML, XML and JSON. ##### فرمت صادرات داده ها را می توان با استفاده از صفحه وب Zabbix یا [Zabbix صادر کرد API](/دستی/api/reference/configuration). فرمت های صادراتی پشتیبانی شده هستند YAML، XML و JSON. #### Exporting a template Export the configuration of template "10571" as an XML string. Request: ```json { "jsonrpc": "2.0", "method": "configuration.export", "params": { "options": { "templates": [ "10571" ] }, "format": "xml" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<zabbix_export><version>6.0</version><date>2023-01-01T12:00:00Z</date><groups><group><uuid>7df96b18c230490a9a0a9e2307226338</uuid><name>Templates</name></group></groups><templates><template><uuid>5aef0444a82a4d8cb7a95dc4c0c85330</uuid><template>New template</template><name>New template</name><groups><group><name>Templates</name></group></groups><items><item><uuid>7f1e6f1e48aa4a128e5b6a958a5d11c3</uuid><name>Zabbix agent ping</name><key>agent.ping</key></item><item><uuid>77ba228662be4570830aa3c503fcdc03</uuid><name>Apache server uptime</name><type>DEPENDENT</type><key>apache.server.uptime</key><delay>0</delay><trends>0</trends><value_type>TEXT</value_type><preprocessing><step><type>REGEX</type><parameters><parameter>&lt;dt&gt;Server uptime: (.*)&lt;/dt&gt;</parameter><parameter>\\1</parameter></parameters></step></preprocessing><master_item><key>web.page.get[127.0.0.1/server-status]</key></master_item></item><item><uuid>6805d4c39a624a8bab2cc8ab63df1ab3</uuid><name>CPU load</name><key>system.cpu.load</key><value_type>FLOAT</value_type><triggers><trigger><uuid>ab4c2526c2bc42e48a633082255ebcb3</uuid><expression>avg(/New template/system.cpu.load,3m)&gt;2</expression><name>CPU load too high on 'New host' for 3 minutes</name><priority>WARNING</priority></trigger></triggers></item><item><uuid>590efe5731254f089265c76ff9320726</uuid><name>Apache server status</name><key>web.page.get[127.0.0.1/server-status]</key><trends>0</trends><value_type>TEXT</value_type></item></items><valuemaps><valuemap><uuid>8fd5814c45d44a00a15ac6eaae1f3946</uuid><name>Zabbix agent ping</name><mappings><mapping><value>1</value><newvalue>Available</newvalue></mapping><mapping><value>0</value><newvalue>Not available</newvalue></mapping></mappings></valuemap></valuemaps></template></templates></zabbix_export>\n", "id": 1 } ``` #### ساخت هاست پیکربندی یک میزبان را به عنوان یک رشته XML بسازید . Request: ```json { "jsonrpc": "2.0", "method": "configuration.export", "params": { "options": { "hosts": [ "10161" ] }, "format": "xml" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<zabbix_export><version>5.4</version><date>2020-03-13T15:31:45Z</date><groups><group><uuid>6f6799aa69e844b4b3918f779f2abf08</uuid><name>Zabbix servers</name></group></groups><hosts><host><host>Export host</host><name>Export host</name><groups><group><name>Zabbix servers</name></group></groups><interfaces><interface><interface_ref>if1</interface_ref></interface></interfaces><items><item><name>Item</name><key>item.key</key><delay>30s</delay><tags><tag><tag>Application</tag><value>CPU</value></tag></tags><valuemap><name>Host status</name></valuemap><interface_ref>if1</interface_ref><request_method>POST</request_method></item></items><valuemaps><valuemap><name>Host status</name><mappings><mapping><value>0</value><newvalue>Up</newvalue></mapping><mapping><value>2</value><newvalue>Unreachable</newvalue></mapping></mappings></valuemap></valuemaps></host></hosts></zabbix_export>\n", "id": 1 } ``` #### Exporting To export hosts, do the following: - Go to: *Configuration* → *Hosts* - Mark the checkboxes of the hosts to export - Click on *Export* below the list ![](../../../assets/en/manual/xml_export_import/export_hosts.png) Depending on the selected format, hosts are exported to a local file with a default name: - *zabbix\_export\_hosts.yaml* - in YAML export (default option for export) - *zabbix\_export\_hosts.xml* - in XML export - *zabbix\_export\_hosts.json* - in JSON export #### خروجی گرفتن برای خروجی گرفتن از هاست ها مراحل زیر راانجام دهید : - Go to: *Configuration* → *Hosts* - Mark the checkboxes of the hosts to export - Click on *Export* below the list ![](../../../assets/en/manual/xml_export_import/export_hosts.png) Depending on the selected format, hosts are exported to a local file with a default name: - *zabbix\_export\_hosts.yaml* - in YAML export (default option for export) - *zabbix\_export\_hosts.xml* - in XML export - *zabbix\_export\_hosts.json* - in JSON export #### Exporting To export media types, do the following: - Go to: *Administration* → *Media types* - Mark the checkboxes of the media types to export - Click on *Export* below the list ![](../../../assets/en/manual/xml_export_import/export_mediatypes.png) Depending on the selected format, media types are exported to a local file with a default name: - *zabbix\_export\_mediatypes.yaml* - in YAML export (default option for export) - *zabbix\_export\_mediatypes.xml* - in XML export - *zabbix\_export\_mediatypes.json* - in JSON export #### خروجی گرفتن برای خروجی گرفتن قالب ها، موارد زیر را انجام دهید: - به: *پیکربندی* → *قالب*ها بروید - چک باکس های الگوهای صادراتی را علامت بزنید - روی *Export* در زیر لیست کلیک کنید ![](../../../assets/en/manual/xml_export_import/export_templates.png) بسته به فرمت انتخاب شده، قالب ها به یک فایل محلی صادر می شوند با نام پیش فرض: - *zabbix\_export\_templates.yaml* - در صادرات YAML (گزینه پیش فرض برای صادرات) - *zabbix\_export\_templates.xml* - در صادرات XML - *zabbix\_export\_templates.json* - در صادرات JSON #### Exporting To export network maps, do the following: - Go to: *Monitoring* → *Maps* - Mark the checkboxes of the network maps to export - Click on *Export* below the list ![](../../../assets/en/manual/xml_export_import/export_maps.png) Depending on the selected format, maps are exported to a local file with a default name: - *zabbix\_export\_maps.yaml* - in YAML export (default option for export) - *zabbix\_export\_maps.xml* - in XML export - *zabbix\_export\_maps.json* - in JSON export #### خروجی گرفتن برای خروجی گرفتن قالب ها، موارد زیر را انجام دهید: - به: *پیکربندی* → *قالب*ها بروید - چک باکس های الگوهای صادراتی را علامت بزنید - روی *Export* در زیر لیست کلیک کنید ![](../../../assets/en/manual/xml_export_import/export_templates.png) بسته به فرمت انتخاب شده، قالب ها به یک فایل محلی صادر می شوند با نام پیش فرض: - *zabbix\_export\_templates.yaml* - در صادرات YAML (گزینه پیش فرض برای صادرات) - *zabbix\_export\_templates.xml* - در صادرات XML - *zabbix\_export\_templates.json* - در صادرات JSON #### Exporting To export templates, do the following: - Go to: *Configuration* → *Templates* - Mark the checkboxes of the templates to export - Click on *Export* below the list ![](../../../assets/en/manual/xml_export_import/export_templates.png) Depending on the selected format, templates are exported to a local file with a default name: - *zabbix\_export\_templates.yaml* - in YAML export (default option for export) - *zabbix\_export\_templates.xml* - in XML export - *zabbix\_export\_templates.json* - in JSON export #### خروجی گرفتن برای خروجی گرفتن قالب ها، موارد زیر را انجام دهید: - به: *پیکربندی* → *قالب*ها بروید - چک باکس های الگوهای صادراتی را علامت بزنید - روی *Export* در زیر لیست کلیک کنید ![](../../../assets/en/manual/xml_export_import/export_templates.png) بسته به فرمت انتخاب شده، قالب ها به یک فایل محلی صادر می شوند با نام پیش فرض: - *zabbix\_export\_templates.yaml* - در صادرات YAML (گزینه پیش فرض برای صادرات) - *zabbix\_export\_templates.xml* - در صادرات XML - *zabbix\_export\_templates.json* - در صادرات JSON ###### Export request A request to execute the Export function of the Exporter interface. | | | |---|---| |direction|agent → plugin| |response|no| Parameters specific to export requests: |Name|Type|Comments| |---------|--------|----------| |key|string|The plugin key.| |parameters|array of strings (optional)|The parameters for Export function.| *Example:* {"id":4,"type":6,"key":"test.key","parameters":["foo","bar"]} ###### درخواست صادرات درخواستی برای اجرای تابع Export رابط صادرکننده. | | | |---|---| |جهت|عامل → افزونه| |پاسخ|نه| پارامترهای خاص برای درخواست صادرات: |نام|نوع|نظر| |---------|--------|----------| |کلید|رشته|کلید افزونه.| |پارامترها|آرایه رشته ها (اختیاری)|پارامترهای تابع Export.| *مثال:* {"id":4,"type":6,"key":"test.key","parameters":["foo","bar"]} ###### Export response Response from the Export function of the Exporter interface. | | | |---|---| |direction|plugin → agent| |response|n/a| Parameters specific to export responses: |Name|Type|Comments| |---------|--------|----------| |value|string (optional) |Response value from the Export function. Absent, if error is returned.| |error|string (optional) |Error message if the Export function has not been executed successfully. Absent, if value is returned.| *Examples:* {"id":5,"type":7,"value":"response"} or {"id":5,"type":7,"error":"error message"} ###### پاسخ صادرات پاسخ از تابع صادرات رابط صادرکننده. | | | |---|---| |جهت|پلاگین → عامل| |پاسخ|عدم| پارامترهای خاص برای پاسخ های صادراتی: |نام|نوع|نظر| |---------|--------|----------| | مقدار | رشته (اختیاری) | مقدار پاسخ از تابع Export. وجود ندارد، در صورت بازگشت خطا.| |error|string (اختیاری) |پیام خطا در صورتی که تابع Export با موفقیت اجرا نشده باشد. وجود ندارد، در صورت بازگشت مقدار.| *مثال ها:* {"id":5,"type":7,"value":"response"} یا {"id":5,"type":7,"error":"پیام خطا"} #### Exposed metrics The stats items gather the statistics in bulk and return a JSON, which is the basis for dependent items to get their data from. The following [internal metrics](/manual/config/items/itemtypes/internal) are returned by either of the two items: - `zabbix[boottime]` - `zabbix[hosts]` - `zabbix[items]` - `zabbix[items_unsupported]` - `zabbix[preprocessing_queue]` (server only) - `zabbix[process,<type>,<mode>,<state>]` (only process type based statistics) - `zabbix[rcache,<cache>,<mode>]` - `zabbix[requiredperformance]` - `zabbix[triggers]` (server only) - `zabbix[uptime]` - `zabbix[vcache,buffer,<mode>]` (server only) - `zabbix[vcache,cache,<parameter>]` - `zabbix[version]` - `zabbix[vmware,buffer,<mode>]` - `zabbix[wcache,<cache>,<mode>]` ('trends' cache type server only) #### معیارهای در معرض آیتم های آماری آمار را به صورت انبوه جمع آوری می کنند و یک JSON برمی گردند، که مبنایی برای اقلام وابسته است که داده های خود را از آنها دریافت می کنند. به شرح زیر [سنجش‌های داخلی](/دستی/config/items/itemtypes/internal) برگردانده شد توسط یکی از دو مورد: - `zabbix[boottime]` - "zabbix[host]". - `zabbix[اقلام]` - «zabbix[itms_unsupported]». - `zabbix[preprocessing_queue]` (فقط سرور) - `zabbix[process,<type>,<mode>,<state>]` (فقط بر اساس نوع فرآیند آمار) - `zabbix[rcache,<cache>,<mode>]` - `zabbix[عملکرد مورد نیاز]` - "zabbix[triggers]" (فقط سرور) - "zabbix[uptime]". - `zabbix[vcache,buffer,<mode>]` (فقط سرور) - `zabbix[vcache,cache,<parameter>]` - `zabbix[نسخه]` - `zabbix[vmware,buffer,<mode>]` - `zabbix[wcache,<cache>,<mode>]` (فقط سرور نوع حافظه نهان "Trends") #### Extracting matching part of regular expression Sometimes we may want to extract only the interesting value from a target file instead of returning the whole line when a regular expression match is found. Since Zabbix 2.2.0, log items have the ability to extract desired values from matched lines. This is accomplished by the additional **output** parameter in `log` and `logrt` items. Using the 'output' parameter allows to indicate the "capturing group" of the match that we may be interested in. So, for example log[/path/to/the/file,"large result buffer allocation.*Entries: ([0-9]+)",,,,\1] should allow returning the entry count as found in the content of: Fr Feb 07 2014 11:07:36.6690 */ Thread Id 1400 (GLEWF) large result buffer allocation - /Length: 437136/Entries: 5948/Client Ver: >=10/RPC ID: 41726453/User: AUser/Form: CFG:ServiceLevelAgreement Only the number will be returned because **\\1** refers to the first and only capturing group: **(\[0-9\]+)**. And, with the ability to extract and return a number, the value can be used to define triggers. #### استخراج بخش منطبق از عبارت منظم گاهی اوقات ممکن است بخواهیم فقط مقدار جالب را از a استخراج کنیم فایل هدف به جای بازگرداندن کل خط زمانی که یک معمولی است مطابقت عبارت یافت می شود. از Zabbix 2.2.0، آیتم های گزارش قابلیت استخراج مقادیر دلخواه را دارند از خطوط همسان این کار با **خروجی** اضافی انجام می شود پارامتر در موارد «log» و «logrt». استفاده از پارامتر "خروجی" امکان نشان دادن "گروه گرفتن" از مسابقه ای که ممکن است به آن علاقه مند باشیم. بنابراین، برای مثال log[/path/to/the/file,"تخصیص بافر نتیجه بزرگ.* ورودی ها: ([0-9]+)"،،،،\1] باید امکان برگرداندن تعداد ورودی را همانطور که در محتوای زیر یافت می شود: Fr 07 فوریه 2014 11:07:36.6690 */ شناسه موضوع 1400 (GLEWF) نتیجه بزرگ تخصیص بافر - / طول: 437136 / ورودی: 5948 / نسخه مشتری: >=10/RPC شناسه: 41726453/کاربر: AUser/فرم: CFG:ServiceLevelAgreement فقط شماره برگردانده می شود زیرا **\\1** به اولین و اشاره دارد فقط گروه عکسبرداری: **(\[0-9\]+)**. و با قابلیت استخراج و برگرداندن عدد، مقدار می تواند باشد برای تعریف محرک ها استفاده می شود. ### Failover to standby node Zabbix will fail over to another node automatically if the active node stops. There must be at least one node in standby status for the failover to happen. How fast will the failover be? All nodes update their last access time (and status, if it is changed) every 5 seconds. So: - If the active node shuts down and manages to report its status as "stopped", another node will take over within **5 seconds**. - If the active node shuts down/becomes unavailable without being able to update its status, standby nodes will wait for the **failover delay** + 5 seconds to take over The failover delay is configurable, with the supported range between 10 seconds and 15 minutes (one minute by default). To change the failover delay, you may run: ``` zabbix_server -R ha_set_failover_delay=5m ``` ### Failover به گره آماده به کار اگر گره فعال متوقف شود، Zabbix به طور خودکار به گره دیگری با شکست مواجه می شود. آنجا باید حداقل یک گره در وضعیت آماده به کار باشد تا failover اتفاق بیفتد. سرعت شکست چقدر خواهد بود؟ همه گره ها آخرین زمان دسترسی خود را به روز می کنند (و وضعیت، اگر هر 5 ثانیه تغییر می کند. بنابراین: - اگر گره فعال خاموش شود و بتواند وضعیت خود را گزارش دهد به عنوان "توقف"، یک گره دیگر در عرض **5 ثانیه **. - اگر گره فعال بدون امکان به روز رسانی خاموش شود/در دسترس نباشد وضعیت آن، گره‌های آماده به کار منتظر خواهند ماند تا **تأخیر شکست** + 5 ثانیه آن را کنترل کند تأخیر شکست قابل تنظیم است و محدوده پشتیبانی شده بین 10 تا 15 ثانیه است دقیقه (به طور پیش فرض یک دقیقه). برای تغییر تاخیر شکست، می توانید اجرا کنید: ``` zabbix_server -R ha_set_failover_delay=5m ``` ## FILES */usr/local/etc/zabbix\_agent2.conf* Default location of Zabbix agent 2 configuration file (if not modified during compile time). [ ]{#lbAH} ## فایل ها */usr/local/etc/zabbix\_agent2.conf* محل پیش‌فرض فایل پیکربندی عامل Zabbix 2 (در صورت عدم تغییر در طول زمان کامپایل). [ ]{#lbAH} ## FILES */usr/local/etc/zabbix\_agentd.conf* Default location of Zabbix agent configuration file (if not modified during compile time). [ ]{#lbAI} ## فایل ها */usr/local/etc/zabbix\_agent2.conf* محل پیش‌فرض فایل پیکربندی عامل Zabbix 2 (در صورت عدم تغییر در طول زمان کامپایل). [ ]{#lbAH} ## FILES */usr/local/etc/zabbix\_proxy.conf* Default location of Zabbix proxy configuration file (if not modified during compile time). [ ]{#lbAI} ## فایل ها */usr/local/etc/zabbix\_agent2.conf* محل پیش‌فرض فایل پیکربندی عامل Zabbix 2 (در صورت عدم تغییر در طول زمان کامپایل). [ ]{#lbAH} ## FILES */usr/local/etc/zabbix\_server.conf* Default location of Zabbix server configuration file (if not modified during compile time). [ ]{#lbAI} ## فایل ها */usr/local/etc/zabbix\_server.conf* محل پیش‌فرض فایل پیکربندی سرور Zabbix (در صورت عدم تغییر در طول زمان کامپایل). [ ]{#lbAI} ## FILES */usr/local/etc/zabbix\_web\_service.conf* Default location of Zabbix web service configuration file (if not modified during compile time). [ ]{#lbAG} ## فایل ها */usr/local/etc/zabbix\_web\_service.conf* محل پیش‌فرض فایل پیکربندی وب سرویس Zabbix (اگر نه در طول زمان کامپایل اصلاح شد). [ ]{#lbAG} ##### Filter buttons | | | |--|--------| |![filter\_apply.png](../../../../../assets/en/manual/web_interface/filter_apply.png)|Apply specified filtering criteria (without saving).| |![filter\_reset.png](../../../../../assets/en/manual/web_interface/filter_reset.png)|Reset current filter and return to saved parameters of the current tab. On the main tab, this will clear the filter.| |![filter\_save\_as.png](../../../../../assets/en/manual/web_interface/filter_save_as.png)|Save current filter parameters in a new tab. Only available on the main tab.| |![filter\_update.png](../../../../../assets/en/manual/web_interface/filter_update.png)|Replace tab parameters with currently specified parameters. Not available on the main tab.| ##### دکمه های فیلتر | | | |--|--------| |![filter\_apply.png](../../../../../assets/en/manual/web_interface/filter_apply.png)|اعمال معیارهای فیلتر مشخص شده (بدون ذخیره).| |![filter\_reset.png](../../../../../assets/en/manual/web_interface/filter_reset.png)|فیلتر فعلی را بازنشانی کنید و به پارامترهای ذخیره شده برگه فعلی بازگردید . در برگه اصلی، این فیلتر را پاک می کند.| |![filter\_save\_as.png](../../../../../assets/en/manual/web_interface/filter_save_as.png)| پارامترهای فیلتر فعلی را در یک برگه جدید ذخیره کنید. فقط در برگه اصلی موجود است.| |![filter\_update.png](../../../../../assets/en/manual/web_interface/filter_update.png)|پارامترهای برگه را با پارامترهای مشخص شده فعلی جایگزین کنید. در برگه اصلی موجود نیست.| #### Find HTTP agent item Find HTTP agent item with post body type XML for specific host ID. Request: ```json { "jsonrpc": "2.0", "method": "item.get", "params": { "hostids": "10255", "filter": { "type": 19, "post_type": 3 } }, "id": 3, "auth": "d678e0b85688ce578ff061bd29a20d3b" } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "itemid": "28252", "type": "19", "snmp_oid": "", "hostid": "10255", "name": "template item", "key_": "ti", "delay": "30s", "history": "90d", "trends": "365d", "status": "0", "value_type": "3", "trapper_hosts": "", "units": "", "logtimefmt": "", "templateid": "0", "valuemapid": "0", "params": "", "ipmi_sensor": "", "authtype": "0", "username": "", "password": "", "publickey": "", "privatekey": "", "flags": "0", "interfaceid": "0", "description": "", "inventory_link": "0", "evaltype": "0", "jmx_endpoint": "", "master_itemid": "0", "timeout": "3s", "url": "localhost", "query_fields": [ { "mode": "xml" } ], "posts": "<body>\r\n<![CDATA[{$MACRO}<foo></bar>]]>\r\n</body>", "status_codes": "200", "follow_redirects": "0", "post_type": "3", "http_proxy": "", "headers": [], "retrieve_mode": "1", "request_method": "3", "output_format": "0", "ssl_cert_file": "", "ssl_key_file": "", "ssl_key_password": "", "verify_peer": "0", "verify_host": "0", "allow_traps": "0", "uuid": "", "state": "0", "error": "", "parameters": [], "lastclock": "0", "lastns": "0", "lastvalue": "", "prevvalue": "" } ], "id": 3 } ``` #### مورد عامل HTTP را پیدا کنید مورد عامل HTTP را با نوع پست XML برای شناسه میزبان خاص پیدا کنید. درخواست: ``json { "jsonrpc": "2.0"، "روش": "item.get"، "params": { "hostids": "10255"، "فیلتر": { "نوع": 19، "نوع_پست": 3 } }، "id": 3، "auth": "d678e0b85688ce578ff061bd29a20d3b" } ``` واکنش: ``json { "jsonrpc": "2.0"، "نتیجه": [ { "itemid": "28252"، "نوع": "19"، "snmp_oid": "", "hostid": "10255"، "name": "اقلام الگو", "key_": "ti"، "تاخیر": "30s", "تاریخچه": "90d", "روند": "365d"، "وضعیت": "0"، "value_type": "3"، "trapper_hosts": "", "واحد": ""، "logtimefmt": "", "templateid": "0", "valuemapid": "0"، "params": "", "ipmi_sensor": "", "authtype": "0"، "نام کاربری": ""، "کلمه عبور": ""، "کلید عمومی": ""، "کلید خصوصی": ""، "پرچم ها": "0"، "interfaceid": "0"، "شرح": ""، "inventory_link": "0"، "evaltype": "0"، "jmx_endpoint": "", "master_itemid": "0"، "تایم اوت": "3 ثانیه"، "url": "localhost", "query_fields": [ { "mode": "xml" } ]، "posts": "<body>\r\n<![CDATA[{$MACRO}<foo></bar>]]>\r\n</body>، "status_codes": "200"، "follow_redirects": "0", "پست_نوع": "3"، "http_proxy": ""، "headers": [], "retrieve_mode": "1"، "request_method": "3"، "output_format": "0"، "ssl_cert_file": ""، "ssl_key_file": ""، "ssl_key_password": ""، "verify_peer": "0"، "verify_host": "0", "allow_traps": "0"، "uuid": ""، "state": "0", "خطا": ""، "مولفه های": []، "آخرین ساعت": "0"، "lastns": "0"، "آخرین ارزش": ""، "prevvalue": "" } ]، "id": 3 } ``` #### Find HTTP agent item prototype Find HTTP agent item prototype with request method HEAD for specific host ID. Request: ```json { "jsonrpc": "2.0", "method": "itemprototype.get", "params": { "hostids": "10254", "filter": { "type": "19", "request_method": "3" } }, "id": 17, "auth": "d678e0b85688ce578ff061bd29a20d3b" } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "itemid": "28257", "type": "19", "snmp_oid": "", "hostid": "10254", "name": "discovered", "key_": "item[{#INAME}]", "delay": "{#IUPDATE}", "history": "90d", "trends": "30d", "status": "0", "value_type": "3", "trapper_hosts": "", "units": "", "logtimefmt": "", "templateid": "28255", "valuemapid": "0", "params": "", "ipmi_sensor": "", "authtype": "0", "username": "", "password": "", "publickey": "", "privatekey": "", "interfaceid": "2", "description": "", "evaltype": "0", "jmx_endpoint": "", "master_itemid": "0", "timeout": "3s", "url": "{#IURL}", "query_fields": [], "posts": "", "status_codes": "", "follow_redirects": "0", "post_type": "0", "http_proxy": "", "headers": [], "retrieve_mode": "0", "request_method": "3", "output_format": "0", "ssl_cert_file": "", "ssl_key_file": "", "ssl_key_password": "", "verify_peer": "0", "verify_host": "0", "allow_traps": "0", "discover": "0", "uuid": "", "parameters": [] } ], "id": 17 } ``` #### نمونه اولیه آیتم عامل HTTP را پیدا کنید نمونه اولیه مورد عامل HTTP را با روش درخواست HEAD برای شناسه میزبان خاص پیدا کنید. درخواست: ``json { "jsonrpc": "2.0"، "روش": "itemprototype.get"، "params": { "hostids": "10254"، "فیلتر": { "نوع": "19"، "request_method": "3" } }، "id": 17، "auth": "d678e0b85688ce578ff061bd29a20d3b" } ``` واکنش: ``json { "jsonrpc": "2.0"، "نتیجه": [ { "itemid": "28257"، "نوع": "19"، "snmp_oid": "", "hostid": "10254"، "نام": "کشف"، "key_": "مورد[{#INNAME}]"، "تاخیر": "{#IUPDATE}"، "تاریخچه": "90d", "روند": "30 روز"، "وضعیت": "0"، "value_type": "3"، "trapper_hosts": "", "واحد": ""، "logtimefmt": "", "templateid": "28255"، "valuemapid": "0"، "params": "", "ipmi_sensor": "", "authtype": "0"، "نام کاربری": ""، "کلمه عبور": ""، "کلید عمومی": ""، "کلید خصوصی": ""، "interfaceid": "2"، "شرح": ""، "evaltype": "0"، "jmx_endpoint": "", "master_itemid": "0"، "تایم اوت": "3 ثانیه"، "url": "{#IURL}"، "query_fields": []، "نوشته ها": ""، "status_codes": "", "follow_redirects": "0", "پست_نوع": "0"، "http_proxy": ""، "headers": [], "retrieve_mode": "0"، "request_method": "3"، "output_format": "0"، "ssl_cert_file": ""، "ssl_key_file": ""، "ssl_key_password": ""، "verify_peer": "0"، "verify_host": "0", "allow_traps": "0"، "کشف": "0"، "uuid": ""، "مولفه های": [] } ]، "id": 17 } ``` #### Finding dependent item Find one Dependent item for item with ID "25545". Request: ```json { "jsonrpc": "2.0", "method": "item.get", "params": { "output": "extend", "filter": { "type": "18", "master_itemid": "25545" }, "limit": "1" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "itemid": "25547", "type": "18", "snmp_oid": "", "hostid": "10116", "name": "Seconds", "key_": "apache.status.uptime.seconds", "delay": "0", "history": "90d", "trends": "365d", "status": "0", "value_type": "3", "trapper_hosts": "", "units": "", "logtimefmt": "", "templateid": "0", "valuemapid": "0", "params": "", "ipmi_sensor": "", "authtype": "0", "username": "", "password": "", "publickey": "", "privatekey": "", "interfaceid": "0", "description": "", "evaltype": "0", "master_itemid": "25545", "jmx_endpoint": "", "timeout": "3s", "url": "", "query_fields": [], "posts": "", "status_codes": "200", "follow_redirects": "1", "post_type": "0", "http_proxy": "", "headers": [], "retrieve_mode": "0", "request_method": "0", "output_format": "0", "ssl_cert_file": "", "ssl_key_file": "", "ssl_key_password": "", "verify_peer": "0", "verify_host": "0", "allow_traps": "0", "discover": "0", "uuid": "", "parameters": [] } ], "id": 1 } ``` #### پیدا کردن آیتم وابسته یک مورد وابسته برای مورد با شناسه "25545" پیدا کنید. درخواست: ``json { "jsonrpc": "2.0"، "روش": "item.get"، "params": { "output": "extend" "فیلتر": { "نوع": "18"، "master_itemid": "25545" }، "حد": "1" }، "auth": "038e1d7b1735c6a5436ee9eae095879e"، "id": 1 } ``` واکنش: ``json { "jsonrpc": "2.0"، "نتیجه": [ { "itemid": "25547"، "نوع": "18"، "snmp_oid": "", "hostid": "10116"، "name": "ثانیه"، "key_": "apache.status.uptime.seconds"، "تاخیر": "0"، "تاریخچه": "90d", "روند": "365d"، "وضعیت": "0"، "value_type": "3"، "trapper_hosts": "", "واحد": ""، "logtimefmt": "", "templateid": "0", "valuemapid": "0"، "params": "", "ipmi_sensor": "", "authtype": "0"، "نام کاربری": ""، "کلمه عبور": ""، "کلید عمومی": ""، "کلید خصوصی": ""، "interfaceid": "0"، "شرح": ""، "evaltype": "0"، "master_itemid": "25545"، "jmx_endpoint": "", "تایم اوت": "3 ثانیه"، "url": "", "query_fields": []، "نوشته ها": ""، "status_codes": "200"، "follow_redirects": "1"، "پست_نوع": "0"، "http_proxy": ""، "headers": [], "retrieve_mode": "0"، "request_method": "0"، "output_format": "0"، "ssl_cert_file": ""، "ssl_key_file": ""، "ssl_key_password": ""، "verify_peer": "0"، "verify_host": "0", "allow_traps": "0"، "کشف": "0"، "uuid": ""، "مولفه های": [] } ]، "id": 1 } ``` #### Finding dependent items by key Retrieve all dependent items from host with ID "10116" that have the word "apache" in the key. Request: ```json { "jsonrpc": "2.0", "method": "item.get", "params": { "output": "extend", "hostids": "10116", "search": { "key_": "apache" }, "filter": { "type": 18 } }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "itemid": "25550", "type": "18", "snmp_oid": "", "hostid": "10116", "name": "Days", "key_": "apache.status.uptime.days", "delay": "0", "history": "90d", "trends": "365d", "status": "0", "value_type": "3", "trapper_hosts": "", "units": "", "logtimefmt": "", "templateid": "0", "valuemapid": "0", "params": "", "ipmi_sensor": "", "authtype": "0", "username": "", "password": "", "publickey": "", "privatekey": "", "flags": "0", "interfaceid": "0", "description": "", "inventory_link": "0", "evaltype": "0", "jmx_endpoint": "", "master_itemid": "25545", "timeout": "3s", "url": "", "query_fields": [], "posts": "", "status_codes": "200", "follow_redirects": "1", "post_type": "0", "http_proxy": "", "headers": [], "retrieve_mode": "0", "request_method": "0", "output_format": "0", "ssl_cert_file": "", "ssl_key_file": "", "ssl_key_password": "", "verify_peer": "0", "verify_host": "0", "allow_traps": "0", "uuid": "", "state": "0", "error": "", "parameters": [], "lastclock": "0", "lastns": "0", "lastvalue": "0", "prevvalue": "0" }, { "itemid": "25555", "type": "18", "snmp_oid": "", "hostid": "10116", "name": "Hours", "key_": "apache.status.uptime.hours", "delay": "0", "history": "90d", "trends": "365d", "status": "0", "value_type": "3", "trapper_hosts": "", "units": "", "logtimefmt": "", "templateid": "0", "valuemapid": "0", "params": "", "ipmi_sensor": "", "authtype": "0", "username": "", "password": "", "publickey": "", "privatekey": "", "flags": "0", "interfaceid": "0", "description": "", "inventory_link": "0", "evaltype": "0", "jmx_endpoint": "", "master_itemid": "25545", "timeout": "3s", "url": "", "query_fields": [], "posts": "", "status_codes": "200", "follow_redirects": "1", "post_type": "0", "http_proxy": "", "headers": [], "retrieve_mode": "0", "request_method": "0", "output_format": "0", "ssl_cert_file": "", "ssl_key_file": "", "ssl_key_password": "", "verify_peer": "0", "verify_host": "0", "allow_traps": "0", "uuid": "", "state": "0", "error": "", "parameters": [], "lastclock": "0", "lastns": "0", "lastvalue": "0", "prevvalue": "0" } ], "id": 1 } ``` #### پیدا کردن آیتم های وابسته با کلید همه موارد وابسته را از میزبان با شناسه "10116" که کلمه "apache" را در کلید دارند، بازیابی کنید. درخواست: ``json { "jsonrpc": "2.0"، "روش": "item.get"، "params": { "output": "extend" "hostids": "10116"، "جستجو کردن": { "key_": "apache" }، "فیلتر": { "نوع": 18 } }، "auth": "038e1d7b1735c6a5436ee9eae095879e"، "id": 1 } ``` واکنش: ``json { "jsonrpc": "2.0"، "نتیجه": [ { "itemid": "25550"، "نوع": "18"، "snmp_oid": "", "hostid": "10116"، "name": "روزها" "key_": "apache.status.uptime.days"، "تاخیر": "0"، "تاریخچه": "90d", "روند": "365d"، "وضعیت": "0"، "value_type": "3"، "trapper_hosts": "", "واحد": ""، "logtimefmt": "", "templateid": "0", "valuemapid": "0"، "params": "", "ipmi_sensor": "", "authtype": "0"، "نام کاربری": ""، "کلمه عبور": ""، "کلید عمومی": ""، "کلید خصوصی": ""، "پرچم ها": "0"، "interfaceid": "0"، "شرح": ""، "inventory_link": "0"، "evaltype": "0"، "jmx_endpoint": "", "master_itemid": "25545"، "تایم اوت": "3 ثانیه"، "url": "", "query_fields": []، "نوشته ها": ""، "status_codes": "200"، "follow_redirects": "1"، "پست_نوع": "0"، "http_proxy": ""، "headers": [], "retrieve_mode": "0"، "request_method": "0"، "output_format": "0"، "ssl_cert_file": ""، "ssl_key_file": ""، "ssl_key_password": ""، "verify_peer": "0"، "verify_host": "0", "allow_traps": "0"، "uuid": ""، "state": "0", "خطا": ""، "مولفه های": []، "آخرین ساعت": "0"، "lastns": "0"، "lastvalue": "0"، "prevvalue": "0" }، { "itemid": "25555"، "نوع": "18"، "snmp_oid": "", "hostid": "10116"، "name": "ساعت"، "key_": "apache.status.uptime.hours"، "تاخیر": "0"، "تاریخچه": "90d", "روند": "365d"، "وضعیت": "0"، "value_type": "3"، "trapper_hosts": "", "واحد": ""، "logtimefmt": "", "templateid": "0", "valuemapid": "0"، "params": "", "ipmi_sensor": "", "authtype": "0"، "نام کاربری": ""، "کلمه عبور": ""، "کلید عمومی": ""، "کلید خصوصی": ""، "پرچم ها": "0"، "interfaceid": "0"، "شرح": ""، "inventory_link": "0"، "evaltype": "0"، "jmx_endpoint": "", "master_itemid": "25545"، "تایم اوت": "3 ثانیه"، "url": "", "query_fields": []، "نوشته ها": ""، "status_codes": "200"، "follow_redirects": "1"، "پست_نوع": "0"، "http_proxy": ""، "headers": [], "retrieve_mode": "0"، "request_method": "0"، "output_format": "0"، "ssl_cert_file": ""، "ssl_key_file": ""، "ssl_key_password": ""، "verify_peer": "0", "verify_host": "0", "allow_traps": "0"، "uuid": ""، "state": "0", "خطا": ""، "مولفه های": []، "آخرین ساعت": "0"، "lastns": "0"، "lastvalue": "0"، "prevvalue": "0" } ]، "id": 1 } ``` #### Finding items by key Retrieve all items used in triggers specific host ID that have word "system.cpu" in the item key and sort results by name. Request: ```json { "jsonrpc": "2.0", "method": "item.get", "params": { "output": "extend", "hostids": "10084", "with_triggers": true, "search": { "key_": "system.cpu" }, "sortfield": "name" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "itemid": "42269", "type": "18", "snmp_oid": "", "hostid": "10084", "name": "CPU utilization", "key_": "system.cpu.util", "delay": "0", "history": "7d", "trends": "365d", "status": "0", "value_type": "0", "trapper_hosts": "", "units": "%", "logtimefmt": "", "templateid": "42267", "valuemapid": "0", "params": "", "ipmi_sensor": "", "authtype": "0", "username": "", "password": "", "publickey": "", "privatekey": "", "flags": "0", "interfaceid": "0", "description": "CPU utilization in %.", "inventory_link": "0", "evaltype": "0", "jmx_endpoint": "", "master_itemid": "42264", "timeout": "3s", "url": "", "query_fields": [], "posts": "", "status_codes": "200", "follow_redirects": "1", "post_type": "0", "http_proxy": "", "headers": [], "retrieve_mode": "0", "request_method": "0", "output_format": "0", "ssl_cert_file": "", "ssl_key_file": "", "ssl_key_password": "", "verify_peer": "0", "verify_host": "0", "allow_traps": "0", "uuid": "", "state": "0", "error": "", "parameters": [], "lastclock": "0", "lastns": "0", "lastvalue": "0", "prevvalue": "0" }, { "itemid": "42259", "type": "0", "snmp_oid": "", "hostid": "10084", "name": "Load average (15m avg)", "key_": "system.cpu.load[all,avg15]", "delay": "1m", "history": "7d", "trends": "365d", "status": "0", "value_type": "0", "trapper_hosts": "", "units": "", "logtimefmt": "", "templateid": "42219", "valuemapid": "0", "params": "", "ipmi_sensor": "", "authtype": "0", "username": "", "password": "", "publickey": "", "privatekey": "", "flags": "0", "interfaceid": "1", "description": "", "inventory_link": "0", "evaltype": "0", "jmx_endpoint": "", "master_itemid": "0", "timeout": "3s", "url": "", "query_fields": [], "posts": "", "status_codes": "200", "follow_redirects": "1", "post_type": "0", "http_proxy": "", "headers": [], "retrieve_mode": "0", "request_method": "0", "output_format": "0", "ssl_cert_file": "", "ssl_key_file": "", "ssl_key_password": "", "verify_peer": "0", "verify_host": "0", "allow_traps": "0", "uuid": "", "state": "0", "error": "", "parameters": [], "lastclock": "0", "lastns": "0", "lastvalue": "0", "prevvalue": "0" }, { "itemid": "42249", "type": "0", "snmp_oid": "", "hostid": "10084", "name": "Load average (1m avg)", "key_": "system.cpu.load[all,avg1]", "delay": "1m", "history": "7d", "trends": "365d", "status": "0", "value_type": "0", "trapper_hosts": "", "units": "", "logtimefmt": "", "templateid": "42209", "valuemapid": "0", "params": "", "ipmi_sensor": "", "authtype": "0", "username": "", "password": "", "publickey": "", "privatekey": "", "flags": "0", "interfaceid": "1", "description": "", "inventory_link": "0", "evaltype": "0", "jmx_endpoint": "", "master_itemid": "0", "timeout": "3s", "url": "", "query_fields": [], "posts": "", "status_codes": "200", "follow_redirects": "1", "post_type": "0", "http_proxy": "", "headers": [], "retrieve_mode": "0", "request_method": "0", "output_format": "0", "ssl_cert_file": "", "ssl_key_file": "", "ssl_key_password": "", "verify_peer": "0", "verify_host": "0", "allow_traps": "0", "uuid": "", "state": "0", "error": "", "parameters": [], "lastclock": "0", "lastns": "0", "lastvalue": "0", "prevvalue": "0" }, { "itemid": "42257", "type": "0", "snmp_oid": "", "hostid": "10084", "name": "Load average (5m avg)", "key_": "system.cpu.load[all,avg5]", "delay": "1m", "history": "7d", "trends": "365d", "status": "0", "value_type": "0", "trapper_hosts": "", "units": "", "logtimefmt": "", "templateid": "42217", "valuemapid": "0", "params": "", "ipmi_sensor": "", "authtype": "0", "username": "", "password": "", "publickey": "", "privatekey": "", "flags": "0", "interfaceid": "1", "description": "", "inventory_link": "0", "evaltype": "0", "jmx_endpoint": "", "master_itemid": "0", "timeout": "3s", "url": "", "query_fields": [], "posts": "", "status_codes": "200", "follow_redirects": "1", "post_type": "0", "http_proxy": "", "headers": [], "retrieve_mode": "0", "request_method": "0", "output_format": "0", "ssl_cert_file": "", "ssl_key_file": "", "ssl_key_password": "", "verify_peer": "0", "verify_host": "0", "allow_traps": "0", "uuid": "", "state": "0", "error": "", "parameters": [], "lastclock": "0", "lastns": "0", "lastvalue": "0", "prevvalue": "0" }, { "itemid": "42260", "type": "0", "snmp_oid": "", "hostid": "10084", "name": "Number of CPUs", "key_": "system.cpu.num", "delay": "1m", "history": "7d", "trends": "365d", "status": "0", "value_type": "3", "trapper_hosts": "", "units": "", "logtimefmt": "", "templateid": "42220", "valuemapid": "0", "params": "", "ipmi_sensor": "", "authtype": "0", "username": "", "password": "", "publickey": "", "privatekey": "", "flags": "0", "interfaceid": "1", "description": "", "inventory_link": "0", "evaltype": "0", "jmx_endpoint": "", "master_itemid": "0", "timeout": "3s", "url": "", "query_fields": [], "posts": "", "status_codes": "200", "follow_redirects": "1", "post_type": "0", "http_proxy": "", "headers": [], "retrieve_mode": "0", "request_method": "0", "output_format": "0", "ssl_cert_file": "", "ssl_key_file": "", "ssl_key_password": "", "verify_peer": "0", "verify_host": "0", "allow_traps": "0", "uuid": "", "state": "0", "error": "", "parameters": [], "lastclock": "0", "lastns": "0", "lastvalue": "0", "prevvalue": "0" } ], "id": 1 } ``` #### Finding items by key Retrieve all items used in triggers specific host ID that have word "system.cpu" in the item key and sort results by name. Request: ```json { "jsonrpc": "2.0", "method": "item.get", "params": { "output": "extend", "hostids": "10084", "with_triggers": true, "search": { "key_": "system.cpu" }, "sortfield": "name" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "itemid": "42269", "type": "18", "snmp_oid": "", "hostid": "10084", "name": "CPU utilization", "key_": "system.cpu.util", "delay": "0", "history": "7d", "trends": "365d", "status": "0", "value_type": "0", "trapper_hosts": "", "units": "%", "logtimefmt": "", "templateid": "42267", "valuemapid": "0", "params": "", "ipmi_sensor": "", "authtype": "0", "username": "", "password": "", "publickey": "", "privatekey": "", "flags": "0", "interfaceid": "0", "description": "CPU utilization in %.", "inventory_link": "0", "evaltype": "0", "jmx_endpoint": "", "master_itemid": "42264", "timeout": "3s", "url": "", "query_fields": [], "posts": "", "status_codes": "200", "follow_redirects": "1", "post_type": "0", "http_proxy": "", "headers": [], "retrieve_mode": "0", "request_method": "0", "output_format": "0", "ssl_cert_file": "", "ssl_key_file": "", "ssl_key_password": "", "verify_peer": "0", "verify_host": "0", "allow_traps": "0", "uuid": "", "state": "0", "error": "", "parameters": [], "lastclock": "0", "lastns": "0", "lastvalue": "0", "prevvalue": "0" }, { "itemid": "42259", "type": "0", "snmp_oid": "", "hostid": "10084", "name": "Load average (15m avg)", "key_": "system.cpu.load[all,avg15]", "delay": "1m", "history": "7d", "trends": "365d", "status": "0", "value_type": "0", "trapper_hosts": "", "units": "", "logtimefmt": "", "templateid": "42219", "valuemapid": "0", "params": "", "ipmi_sensor": "", "authtype": "0", "username": "", "password": "", "publickey": "", "privatekey": "", "flags": "0", "interfaceid": "1", "description": "", "inventory_link": "0", "evaltype": "0", "jmx_endpoint": "", "master_itemid": "0", "timeout": "3s", "url": "", "query_fields": [], "posts": "", "status_codes": "200", "follow_redirects": "1", "post_type": "0", "http_proxy": "", "headers": [], "retrieve_mode": "0", "request_method": "0", "output_format": "0", "ssl_cert_file": "", "ssl_key_file": "", "ssl_key_password": "", "verify_peer": "0", "verify_host": "0", "allow_traps": "0", "uuid": "", "state": "0", "error": "", "parameters": [], "lastclock": "0", "lastns": "0", "lastvalue": "0", "prevvalue": "0" }, { "itemid": "42249", "type": "0", "snmp_oid": "", "hostid": "10084", "name": "Load average (1m avg)", "key_": "system.cpu.load[all,avg1]", "delay": "1m", "history": "7d", "trends": "365d", "status": "0", "value_type": "0", "trapper_hosts": "", "units": "", "logtimefmt": "", "templateid": "42209", "valuemapid": "0", "params": "", "ipmi_sensor": "", "authtype": "0", "username": "", "password": "", "publickey": "", "privatekey": "", "flags": "0", "interfaceid": "1", "description": "", "inventory_link": "0", "evaltype": "0", "jmx_endpoint": "", "master_itemid": "0", "timeout": "3s", "url": "", "query_fields": [], "posts": "", "status_codes": "200", "follow_redirects": "1", "post_type": "0", "http_proxy": "", "headers": [], "retrieve_mode": "0", "request_method": "0", "output_format": "0", "ssl_cert_file": "", "ssl_key_file": "", "ssl_key_password": "", "verify_peer": "0", "verify_host": "0", "allow_traps": "0", "uuid": "", "state": "0", "error": "", "parameters": [], "lastclock": "0", "lastns": "0", "lastvalue": "0", "prevvalue": "0" }, { "itemid": "42257", "type": "0", "snmp_oid": "", "hostid": "10084", "name": "Load average (5m avg)", "key_": "system.cpu.load[all,avg5]", "delay": "1m", "history": "7d", "trends": "365d", "status": "0", "value_type": "0", "trapper_hosts": "", "units": "", "logtimefmt": "", "templateid": "42217", "valuemapid": "0", "params": "", "ipmi_sensor": "", "authtype": "0", "username": "", "password": "", "publickey": "", "privatekey": "", "flags": "0", "interfaceid": "1", "description": "", "inventory_link": "0", "evaltype": "0", "jmx_endpoint": "", "master_itemid": "0", "timeout": "3s", "url": "", "query_fields": [], "posts": "", "status_codes": "200", "follow_redirects": "1", "post_type": "0", "http_proxy": "", "headers": [], "retrieve_mode": "0", "request_method": "0", "output_format": "0", "ssl_cert_file": "", "ssl_key_file": "", "ssl_key_password": "", "verify_peer": "0", "verify_host": "0", "allow_traps": "0", "uuid": "", "state": "0", "error": "", "parameters": [], "lastclock": "0", "lastns": "0", "lastvalue": "0", "prevvalue": "0" }, { "itemid": "42260", "type": "0", "snmp_oid": "", "hostid": "10084", "name": "Number of CPUs", "key_": "system.cpu.num", "delay": "1m", "history": "7d", "trends": "365d", "status": "0", "value_type": "3", "trapper_hosts": "", "units": "", "logtimefmt": "", "templateid": "42220", "valuemapid": "0", "params": "", "ipmi_sensor": "", "authtype": "0", "username": "", "password": "", "publickey": "", "privatekey": "", "flags": "0", "interfaceid": "1", "description": "", "inventory_link": "0", "evaltype": "0", "jmx_endpoint": "", "master_itemid": "0", "timeout": "3s", "url": "", "query_fields": [], "posts": "", "status_codes": "200", "follow_redirects": "1", "post_type": "0", "http_proxy": "", "headers": [], "retrieve_mode": "0", "request_method": "0", "output_format": "0", "ssl_cert_file": "", "ssl_key_file": "", "ssl_key_password": "", "verify_peer": "0", "verify_host": "0", "allow_traps": "0", "uuid": "", "state": "0", "error": "", "parameters": [], "lastclock": "0", "lastns": "0", "lastvalue": "0", "prevvalue": "0" } ], "id": 1 } ``` #### Flexible user parameters Flexible user parameters accept parameters with the key. This way a flexible user parameter can be the basis for creating several items. Flexible user parameters have the following syntax: UserParameter=key[*],command |Parameter|Description| |--|--------| |**Key**|Unique item key. The \[\*\] defines that this key accepts parameters within the brackets.<br>Parameters are given when configuring the item.| |**Command**|Command to be executed to evaluate value of the key.<br>*For flexible user parameters only*:<br>You may use positional references $1…$9 in the command to refer to the respective parameter in the item key.<br>Zabbix parses the parameters enclosed in \[ \] of the item key and substitutes $1,...,$9 in the command accordingly.<br>$0 will be substituted by the original command (prior to expansion of $0,...,$9) to be run.<br>Positional references are interpreted regardless of whether they are enclosed between double (") or single (') quotes.<br>To use positional references unaltered, specify a double dollar sign - for example, awk '{print $$2}'. In this case `$$2` will actually turn into `$2` when executing the command.| ::: noteimportant Positional references with the $ sign are searched for and replaced by Zabbix agent only for flexible user parameters. For simple user parameters, such reference processing is skipped and, therefore, any $ sign quoting is not necessary. ::: ::: noteimportant Certain symbols are not allowed in user parameters by default. See [UnsafeUserParameters](/manual/appendix/config/zabbix_agentd) documentation for a full list. ::: #### پارامترهای کاربر انعطاف پذیر پارامترهای کاربر انعطاف پذیر پارامترها را با کلید می پذیرند. به این ترتیب الف پارامتر کاربر انعطاف پذیر می تواند مبنایی برای ایجاد چندین آیتم باشد. پارامترهای کاربر انعطاف پذیر دارای نحو زیر هستند: UserParameter=کلید[*]، فرمان |پارامتر|توضیحات| |--|--------| |**کلید**|کلید مورد منحصر به فرد. \[\*\] تعریف می‌کند که این کلید پارامترهای درون براکت‌ها را می‌پذیرد.<br>پارامترها هنگام پیکربندی آیتم داده می‌شوند.| |**فرمان**|فرمان برای ارزیابی ارزش کلید اجرا می شود.<br>*فقط برای پارامترهای کاربر انعطاف پذیر*:<br>می توانید از ارجاعات موقعیتی $1…$9 در دستور برای ارجاع به پارامتر مربوطه در دستور استفاده کنید. کلید آیتم.<br>Zabbix پارامترهای محصور شده در \[ \] کلید آیتم را تجزیه می‌کند و بر این اساس $1،...، $9 را در دستور جایگزین می‌کند.<br>$0 با دستور اصلی (قبل از بسط) جایگزین می‌شود. از $0,...,$9) برای اجرا.<br>مرجعات موقعیتی صرف نظر از اینکه بین دو نقل قول (") یا تک (') محصور شده اند تفسیر می شوند.<br>برای استفاده از ارجاعات موقعیتی بدون تغییر، یک دوتایی مشخص کنید. علامت دلار - به عنوان مثال، awk '{print $$2}'. در این مورد، '$$2' در هنگام اجرای دستور در واقع به '$2' تبدیل می شود.| ::: نکته مهم مراجع موقعیتی با علامت $ جستجو می شوند برای و تنها برای پارامترهای کاربر انعطاف پذیر با عامل Zabbix جایگزین شده است. برای پارامترهای کاربر ساده، چنین پردازش مرجع نادیده گرفته می شود و بنابراین، هر گونه نقل قول علامت $ ضروری نیست. ::: ::: نکته مهم برخی از نمادها در پارامترهای کاربر مجاز نیستند به صورت پیش فرض. دیدن [UnsafeUserParameters](/manual/appendix/config/zabbix_agentd) اسناد برای یک لیست کامل ::: ### Float history The float history object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |clock|timestamp|Time when that value was received.| |itemid|string|ID of the related item.| |ns|integer|Nanoseconds when the value was received.| |value|float|Received value.| ### تاریخچه Float The float history object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |clock|timestamp|Time when that value was received.| |itemid|string|ID of the related item.| |ns|integer|Nanoseconds when the value was received.| |value|float|Received value.| ##### Footnotes ^**1**^A Linux-specific note. Zabbix agent must have read-only access to filesystem */proc*. Kernel patches from www.grsecurity.org limit access rights of non-privileged users. ^**2**^ `vfs.dev.read[]`, `vfs.dev.write[]`: Zabbix agent will terminate "stale" device connections if the item values are not accessed for more than 3 hours. This may happen if a system has devices with dynamically changing paths or if a device gets manually removed. Note also that these items, if using an update interval of 3 hours or more, will always return '0'. ^**3**^ `vfs.dev.read[]`, `vfs.dev.write[]`: If default *all* is used for the first parameter then the key will return summary statistics, including all block devices like sda, sdb and their partitions (sda1, sda2, sdb3...) and multiple devices (MD raid) based on those block devices/partitions and logical volumes (LVM) based on those block devices/partitions. In such cases returned values should be considered only as relative value (dynamic in time) but not as absolute values. ^**4**^ SSL (HTTPS) is supported only if agent is compiled with cURL support. Otherwise the item will turn unsupported. ##### پانویسها و منابع ^**1**^یادداشت مخصوص لینوکس. عامل Zabbix باید دسترسی فقط خواندنی داشته باشد سیستم فایل */proc*. وصله های هسته از www.grsecurity.org دسترسی را محدود می کنند حقوق کاربران غیرمجاز ^**2**^ `vfs.dev.read[]`, `vfs.dev.write[]`: عامل Zabbix خاتمه می یابد اتصالات دستگاه "کهنه" در صورتی که مقادیر آیتم برای موارد بیشتر قابل دسترسی نباشد بیش از 3 ساعت این ممکن است در صورتی اتفاق بیفتد که یک سیستم دارای دستگاه هایی با پویا باشد تغییر مسیر یا اگر دستگاهی به صورت دستی حذف شود. همچنین توجه داشته باشید که این موارد، در صورت استفاده از فاصله زمانی به روز رسانی 3 ساعت یا بیشتر، همیشه خواهند بود '0' را برگردانید. ^**3**^ `vfs.dev.read[]`, `vfs.dev.write[]`: اگر پیش فرض *all* استفاده شود برای پارامتر اول، کلید آمار خلاصه را برمی گرداند، شامل تمام دستگاه های بلوک مانند sda، sdb و پارتیشن های آنها (sda1، sda2، sdb3...) و چندین دستگاه (MD Raid) بر اساس آن بلوک دستگاه ها/پارتیشن ها و حجم های منطقی (LVM) بر اساس آن بلوک ها دستگاه ها/پارتیشن ها در چنین مواردی باید مقادیر برگشتی در نظر گرفته شود فقط به عنوان ارزش نسبی (پویا در زمان) اما نه به عنوان مقادیر مطلق. ^**4**^ SSL (HTTPS) تنها در صورتی پشتیبانی می‌شود که عامل با cURL کامپایل شده باشد حمایت کردن. در غیر این صورت مورد پشتیبانی نمی شود. ##### Footnotes ^**1**^ Default value. ##### پانویسها و منابع ^**1**^ مقدار پیش فرض. ##### Footnotes ^**1**^ For string values, only the string will be exported (e.g. "EMAIL") without the numbering used in this table. The numbers for range values (corresponding to the API values) in this table is used for ordering only. ##### پانویسها و منابع ^**1**^ برای مقادیر رشته، فقط رشته صادر خواهد شد (به عنوان مثال. "ZABBIX\_ACTIVE") بدون شماره گذاری استفاده شده در این جدول. شماره برای مقادیر محدوده (مرتبط با مقادیر API) در این جدول استفاده شده است فقط برای سفارش ##### Footnotes ^**1**^ For string values, only the string will be exported (e.g. "ZABBIX\_ACTIVE") without the numbering used in this table. The numbers for range values (corresponding to the API values) in this table is used for ordering only. ##### پانویسها و منابع ^**1**^ برای مقادیر رشته، فقط رشته صادر خواهد شد (به عنوان مثال. "ZABBIX\_ACTIVE") بدون شماره گذاری استفاده شده در این جدول. شماره برای مقادیر محدوده (مرتبط با مقادیر API) در این جدول استفاده شده است فقط برای سفارش ##### Footnotes ^**1**^ For string values, only the string will be exported (e.g. "ZABBIX\_ACTIVE") without the numbering used in this table. The numbers for range values (corresponding to the API values) in this table is used for ordering only. ##### پانویسها و منابع ^**1**^ برای مقادیر رشته، فقط رشته صادر خواهد شد (به عنوان مثال. "ZABBIX\_ACTIVE") بدون شماره گذاری استفاده شده در این جدول. شماره برای مقادیر محدوده (مرتبط با مقادیر API) در این جدول استفاده شده است فقط برای سفارش ##### Footnotes ^**1**^ If multiple macros in a field or macros mixed with text are not supported for the location, a single macro has to fill the whole field. ^**2**^ Macros used in tag names and values are resolved only during event generation process. ^**3**^ URLs that contain a [secret macro](/manual/config/macros/user_macros#configuration) will not work, as the macro in them will be resolved as "\*\*\*\*\*\*". ##### پانویسها و منابع ^**1**^ اگر چند ماکرو در یک فیلد یا ماکروهای مخلوط شده با متن نباشند برای مکان پشتیبانی می شود، یک ماکرو واحد باید کل فیلد را پر کند. ^**2**^ ماکروهای استفاده شده در نام ها و مقادیر برچسب ها فقط در طول فرآیند تولید رویداد حل می شوند. ^**3**^ URLهایی که حاوی [مخفی است macro](/manual/config/macros/user_macros#configuration) کار نخواهد کرد، زیرا ماکرو موجود در آنها به صورت "\*\*\*\*\*\*" حل می شود. ##### Form buttons Buttons at the bottom of the form allow to perform several operations. | | | |--|--------| |![](../../../assets/en/manual/config/button_add.png)|Add a report. This button is only available for new reports.| |![](../../../assets/en/manual/config/button_update.png)|Update the properties of a report.| |![](../../../assets/en/manual/config/button_clone.png)|Create another report based on the properties of the current report.| |![](../../../assets/en/manual/config/button_test.png)|Test if report configuration is correct by sending a report to the current user.| |![](../../../assets/en/manual/config/button_delete.png)|Delete the report.| |![](../../../assets/en/manual/config/button_cancel.png)|Cancel the editing of report properties.| ##### دکمه های فرم دکمه های پایین فرم امکان انجام چندین عملیات را فراهم می کند. | | | |--|--------| |![](../../../assets/en/manual/config/button_add.png)|گزارش اضافه کنید. این دکمه فقط برای گزارش های جدید موجود است.| |![](../../../assets/en/manual/config/button_update.png)|ویژگی های گزارش را به روز کنید.| |![](../../../assets/en/manual/config/button_clone.png)|گزارش دیگری بر اساس ویژگی های گزارش فعلی ایجاد کنید.| |![](../../../assets/en/manual/config/button_test.png)|با ارسال گزارشی به کاربر فعلی، درست بودن پیکربندی گزارش را آزمایش کنید.| |![](../../../assets/en/manual/config/button_delete.png)|گزارش را حذف کنید.| |![](../../../assets/en/manual/config/button_cancel.png)|ویرایش ویژگی های گزارش را لغو کنید.| #### FreeBSD See values supported for 'memtype' parameter on FreeBSD in the table. |Supported value|Description|Source in kinfo\_proc structure|Tries to be compatible with| |--|------|--|--| |vsize|Virtual memory size|kp\_eproc.e\_vm.vm\_map.size or ki\_size|ps -o vsz| |pmem|Percentage of real memory|calculated from rss|ps -o pmem| |rss|Resident set size|kp\_eproc.e\_vm.vm\_rssize or ki\_rssize|ps -o rss| |size ^[1](proc_mem_notes#footnotes)^|Size of process (code + data + stack)|tsize + dsize + ssize| | |tsize|Text (code) size|kp\_eproc.e\_vm.vm\_tsize or ki\_tsize|ps -o tsiz| |dsize|Data size|kp\_eproc.e\_vm.vm\_dsize or ki\_dsize|ps -o dsiz| |ssize|Stack size|kp\_eproc.e\_vm.vm\_ssize or ki\_ssize|ps -o ssiz| #### FreeBSD مقادیر پشتیبانی شده برای پارامتر "memtype" در FreeBSD را در جدول مشاهده کنید. |مقدار پشتیبانی شده|توضیح|منبع در ساختار kinfo\_proc|سعی می کند با| |--|------|--|--| |vsize|اندازه حافظه مجازی|kp\_eproc.e\_vm.vm\_map.size یا ki\_size|ps -o vsz| |pmem|درصد حافظه واقعی|محاسبه شده از rss|ps -o pmem| |rss|اندازه مجموعه مقیم|kp\_eproc.e\_vm.vm\_rssize یا ki\_rssize|ps -o rss| |size ^[1](proc_mem_notes#footnotes)^|اندازه فرآیند (کد + داده + پشته)|tsize + dsize + ssize| | |tsize|اندازه متن (کد)|kp\_eproc.e\_vm.vm\_tsize یا ki\_tsize|ps -o tsiz| |dsize|اندازه داده|kp\_eproc.e\_vm.vm\_dsize یا ki\_dsize|ps -o dsiz| |ssize|اندازه پشته|kp\_eproc.e\_vm.vm\_ssize یا ki\_ssize|ps -o ssiz| ## Frontend ## Frontend #### Frontend To enable encryption with certificate and database host identity verification for connections between Zabbix frontend and the database: - Check *Database TLS encryption* and *Verify database certificate* - Specify path to *Database TLS key file* - Specify path to *Database TLS CA file* - Specify path to *Database TLS certificate file* - Check *Database host verification* ![](../../../../../assets/en/manual/appendix/install/encrypt_db_verify_full2.png){width="600"} Alternatively, this can be set in */etc/zabbix/web/zabbix.conf.php:* $DB['ENCRYPTION'] = true; $DB['KEY_FILE'] = ''; $DB['CERT_FILE'] = ''; $DB['CA_FILE'] = '/etc/ssl/pgsql/root.crt'; $DB['VERIFY_HOST'] = true; $DB['CIPHER_LIST'] = ''; ... #### Frontend برای فعال کردن رمزگذاری با تأیید گواهی برای اتصالات بین زاببیکس و پایگاه داده: - بررسی *رمزگذاری TLS پایگاه داده* و *تأیید گواهی پایگاه داده* - مسیر فایل TLS CA پایگاه داده را مشخص کنید ![](../../../../../assets/en/manual/appendix/install/encrypt_db_verify_ca.png){width="600"} از طرف دیگر، این را می توان در */etc/zabbix/web/zabbix.conf.php* تنظیم کرد: ... $DB['ENCRYPTION'] = درست; $DB['KEY_FILE'] = ''; $DB['CERT_FILE'] = ''; $DB['CA_FILE'] = '/etc/ssl/mysql/ca.pem'; $DB['VERIFY_HOST'] = نادرست; $DB['CIPHER_LIST'] = ''; ... عیب‌یابی کاربر با استفاده از ابزار خط فرمان برای بررسی اینکه آیا اتصال وجود دارد یا خیر برای کاربر مورد نیاز امکان پذیر است: mysql -u zbx_web -p -h 10.211.55.9 --ssl-mode=لازم است --ssl-ca=/var/lib/mysql/ca.pem #### Frontend To enable encryption with certificate verification for connections between Zabbix frontend and the database: - Check *Database TLS encryption* and *Verify database certificate* - Specify path to Database TLS CA file ![](../../../../../assets/en/manual/appendix/install/encrypt_db_verify_ca.png){width="600"} Alternatively, this can be set in */etc/zabbix/web/zabbix.conf.php*: ... $DB['ENCRYPTION'] = true; $DB['KEY_FILE'] = ''; $DB['CERT_FILE'] = ''; $DB['CA_FILE'] = '/etc/ssl/mysql/ca.pem'; $DB['VERIFY_HOST'] = false; $DB['CIPHER_LIST'] = ''; ... Troubleshoot user using command-line tool to check if connection is possible for required user: mysql -u zbx_web -p -h 10.211.55.9 --ssl-mode=REQUIRED --ssl-ca=/var/lib/mysql/ca.pem #### Frontend برای فعال کردن رمزگذاری با تأیید گواهی برای اتصالات بین زاببیکس و پایگاه داده: - بررسی *رمزگذاری TLS پایگاه داده* و *تأیید گواهی پایگاه داده* - مسیر فایل TLS CA پایگاه داده را مشخص کنید ![](../../../../../assets/en/manual/appendix/install/encrypt_db_verify_ca.png){width="600"} از طرف دیگر، این را می توان در */etc/zabbix/web/zabbix.conf.php* تنظیم کرد: ... $DB['ENCRYPTION'] = درست; $DB['KEY_FILE'] = ''; $DB['CERT_FILE'] = ''; $DB['CA_FILE'] = '/etc/ssl/mysql/ca.pem'; $DB['VERIFY_HOST'] = نادرست; $DB['CIPHER_LIST'] = ''; ... عیب‌یابی کاربر با استفاده از ابزار خط فرمان برای بررسی اینکه آیا اتصال وجود دارد یا خیر برای کاربر مورد نیاز امکان پذیر است: mysql -u zbx_web -p -h 10.211.55.9 --ssl-mode=لازم است --ssl-ca=/var/lib/mysql/ca.pem #### Frontend To enable transport-only encryption for connections between Zabbix frontend and the database: - Check *Database TLS encryption* - Leave *Verify database certificate* unchecked ![](../../../../../assets/en/manual/appendix/install/encrypt_db_transport2.png){width="600"} #### Frontend برای فعال کردن رمزگذاری فقط حمل و نقل برای اتصالات بین Zabbix frontend و پایگاه داده: - بررسی *رمزگذاری TLS پایگاه داده* - علامت *تأیید گواهی پایگاه داده* را بدون علامت بگذارید ![](../../../../../assets/en/manual/appendix/install/encrypt_db_transport.png){width="600"} #### Frontend To enable transport-only encryption for connections between Zabbix frontend and the database: - Check *Database TLS encryption* - Leave *Verify database certificate* unchecked ![](../../../../../assets/en/manual/appendix/install/encrypt_db_transport.png){width="600"} #### Frontend برای فعال کردن رمزگذاری فقط حمل و نقل برای اتصالات بین Zabbix frontend و پایگاه داده: - بررسی *رمزگذاری TLS پایگاه داده* - علامت *تأیید گواهی پایگاه داده* را بدون علامت بگذارید ![](../../../../../assets/en/manual/appendix/install/encrypt_db_transport.png){width="600"} #### Function parameters Function parameters allow to specify: - host and item key (functions referencing the host item history only) - function-specific parameters - other expressions (not available for functions referencing the host item history, see [other expressions](#other_expressions) for examples) The host and item key can be specified as `/host/key`. The referenced item must be in a supported state (except for **nodata()** function, which is calculated for unsupported items as well). While other trigger expressions as function parameters are limited to non-history functions in triggers, this limitation does not apply in [calculated items](/manual/config/items/itemtypes/calculated). #### پارامترهای تابع پارامترهای تابع اجازه می دهد تا مشخص شود: - کلید میزبان و آیتم (توابع فقط به تاریخچه آیتم میزبان ارجاع می دهند) - پارامترهای تابع خاص - عبارات دیگر (برای توابع ارجاع دهنده میزبان موجود نیست تاریخچه آیتم، برای مشاهده [دیگر عبارات] (#other_expressions) مراجعه کنید مثال ها) کلید میزبان و آیتم را می توان به عنوان "/host/key" مشخص کرد. ارجاع شده است مورد باید در حالت پشتیبانی باشد (به جز تابع **nodata()**، که برای موارد پشتیبانی نشده نیز محاسبه می شود). در حالی که سایر عبارات ماشه به عنوان پارامترهای تابع محدود به توابع غیر تاریخی در تریگرها، این محدودیت در آنها اعمال نمی شود [موارد محاسبه شده](/دستی/پیکربندی/ایتم/مجموعه/محاسبه). #### Functions Functions allow to calculate the collected values (average, minimum, maximum, sum), find strings, reference current time and other factors. A complete list of [supported functions](/manual/appendix/functions) is available. Typically functions return numeric values for comparison. When returning strings, comparison is possible with the **=** and **<>** operators (see [example](#example_14)). #### کارکرد توابع امکان محاسبه مقادیر جمع آوری شده (متوسط، حداقل، حداکثر، مجموع)، رشته ها، زمان جاری مرجع و سایر عوامل را پیدا کنید. فهرست کاملی از [توابع پشتیبانی شده](/manual/appendix/functions) است در دسترس. توابع معمولاً مقادیر عددی را برای مقایسه برمی‌گردانند. هنگام بازگشت رشته ها، مقایسه با **=** و **<>** امکان پذیر است عملگرها (به [مثال](#example_14) مراجعه کنید). #### Functions Functions can be used at the end of JSONPath. Multiple functions can be chained if the preceding function returns value that is accepted by the following function. Supported functions: |Function|Description|Input|Output| |--|--------|----|----| |`avg`|Average value of numbers in input array.|Array of numbers.|Number.| |`min`|Minimum value of numbers in input array.|Array of numbers.|Number.| |`max`|Maximum value of numbers in input array.|Array of numbers.|Number.| |`sum`|Sum of numbers in input array.|Array of numbers.|Number.| |`length`|Number of elements in input array.|Array.|Number.| |`first`|The first array element.|Array.|A JSON construct (object, array, value) depending on input array contents.| Quoted numeric values are accepted by the JSONPath aggregate functions. It means that the values are converted from string type to numeric if aggregation is required. Incompatible input will cause the function to generate error. #### کارکرد توابع را می توان در انتهای JSONPath استفاده کرد. چندین تابع می تواند باشد اگر تابع قبلی مقداری را که توسط تابع پذیرفته شده است برگرداند، زنجیره می شود تابع زیر توابع پشتیبانی شده: |عملکرد|توضیح|ورودی|خروجی| |--|--------|----|----| |`avg`|میانگین مقدار اعداد در آرایه ورودی.|آرایه اعداد.|تعداد.| |`min`|حداقل مقدار اعداد در آرایه ورودی.|آرایه اعداد.|تعداد.| |`max`|حداکثر مقدار اعداد در آرایه ورودی.|آرایه اعداد.|تعداد.| |`sum`|مجموع اعداد در آرایه ورودی.|آرایه اعداد.|تعداد.| |`طول`|تعداد عناصر در آرایه ورودی.|آرایه.|تعداد.| |`first`|اولین عنصر آرایه.|آرایه.|یک ساختار JSON (شیء، آرایه، مقدار) بسته به محتوای آرایه ورودی.| مقادیر عددی نقل‌شده توسط توابع جمع‌آوری JSONPath پذیرفته می‌شوند. به این معنی که مقادیر از نوع رشته ای به عددی if تبدیل می شوند تجمیع مورد نیاز است. ورودی ناسازگار باعث ایجاد خطا در تابع می شود. #### Function syntax Foreach functions support two common parameters: `item filter` (see details below) and `time period`: foreach_function(item filter,time period) For example: `avg_foreach(/*/mysql.qps?[group="MySQL Servers"],5m)` will return the five-minute average of each 'mysql.qps' item in the MySQL server group. Note that some functions support additional [parameters](#additional_parameters). #### نحو تابع توابع Foreach از دو پارامتر رایج پشتیبانی می‌کنند: «فیلتر مورد» (به جزئیات زیر مراجعه کنید) و «دوره زمانی»: foreach_function (فیلتر مورد، دوره زمانی) مثلا: `avg_foreach(/*/mysql.qps?[group="MySQL Servers"],5m)` میانگین پنج دقیقه هر آیتم "mysql.qps" در گروه سرور MySQL را برمی گرداند. توجه داشته باشید که برخی از توابع از [پارامترهای] اضافی (#additional_parameters) پشتیبانی می کنند. #### Generate multiple tokens Generate two tokens. Request: ```json { "jsonrpc": "2.0", "method": "token.generate", "params": [ "1", "2" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "tokenid": "1", "token": "bbcfce79a2d95037502f7e9a534906d3466c9a1484beb6ea0f4e7be28e8b8ce2" }, { "tokenid": "2", "token": "fa1258a83d518eabd87698a96bd7f07e5a6ae8aeb8463cae33d50b91dd21bd6d" } ], "id": 0 } ``` #### حذف چندین گروه هاستی Delete two host groups. Request: ```json { "jsonrpc": "2.0", "method": "hostgroup.delete", "params": [ "107824", "107825" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "groupids": [ "107824", "107825" ] }, "id": 1 } ``` #### Get a count of standby nodes Request: ```json { "jsonrpc": "2.0", "method": "hanode.get", "params": { "countOutput": true, "filter": { "status": 0 } }, "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": "3", "id": 1 } ``` #### دریافت تعداد نودهای Standby Request: ```json { "jsonrpc": "2.0", "method": "hanode.get", "params": { "countOutput": true, "filter": { "status": 0 } }, "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": "3", "id": 1 } ``` #### Get a list of nodes ordered by status Request: ```json { "jsonrpc": "2.0", "method": "hanode.get", "params": { "preservekeys": true, "sortfield": "status", "sortorder": "DESC" }, "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "ckuo7i1nw000h0sajj3l3hh8u": { "ha_nodeid": "ckuo7i1nw000h0sajj3l3hh8u", "name": "node-active", "address": "192.168.1.13", "port": "10051", "lastaccess": "1635335704", "status": "3" }, "ckuo7i1nw000e0sajwfttc1mp": { "ha_nodeid": "ckuo7i1nw000e0sajwfttc1mp", "name": "node6", "address": "192.168.1.10", "port": "10053", "lastaccess": "1635332902", "status": "2" }, "ckuo7i1nv000c0sajz85xcrtt": { "ha_nodeid": "ckuo7i1nv000c0sajz85xcrtt", "name": "node4", "address": "192.168.1.8", "port": "10052", "lastaccess": "1635334214", "status": "1" }, "ckuo7i1nv000a0saj1fcdkeu4": { "ha_nodeid": "ckuo7i1nv000a0saj1fcdkeu4", "name": "node2", "address": "192.168.1.6", "port": "10051", "lastaccess": "1635335705", "status": "0" } }, "id": 1 } ``` #### دریافت لیست نود ها به ترتیب وضعیت Request: ```json { "jsonrpc": "2.0", "method": "hanode.get", "params": { "preservekeys": true, "sortfield": "status", "sortorder": "DESC" }, "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "ckuo7i1nw000h0sajj3l3hh8u": { "ha_nodeid": "ckuo7i1nw000h0sajj3l3hh8u", "name": "node-active", "address": "192.168.1.13", "port": "10051", "lastaccess": "1635335704", "status": "3" }, "ckuo7i1nw000e0sajwfttc1mp": { "ha_nodeid": "ckuo7i1nw000e0sajwfttc1mp", "name": "node6", "address": "192.168.1.10", "port": "10053", "lastaccess": "1635332902", "status": "2" }, "ckuo7i1nv000c0sajz85xcrtt": { "ha_nodeid": "ckuo7i1nv000c0sajz85xcrtt", "name": "node4", "address": "192.168.1.8", "port": "10052", "lastaccess": "1635334214", "status": "1" }, "ckuo7i1nv000a0saj1fcdkeu4": { "ha_nodeid": "ckuo7i1nv000a0saj1fcdkeu4", "name": "node2", "address": "192.168.1.6", "port": "10051", "lastaccess": "1635335705", "status": "0" } }, "id": 1 } ``` #### Get a list of specific nodes by their IDs Request: ```json { "jsonrpc": "2.0", "method": "hanode.get", "params": { "ha_nodeids": ["ckuo7i1nw000e0sajwfttc1mp", "ckuo7i1nv000c0sajz85xcrtt"] }, "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "ha_nodeid": "ckuo7i1nv000c0sajz85xcrtt", "name": "node4", "address": "192.168.1.8", "port": "10052", "lastaccess": "1635334214", "status": "1" }, { "ha_nodeid": "ckuo7i1nw000e0sajwfttc1mp", "name": "node6", "address": "192.168.1.10", "port": "10053", "lastaccess": "1635332902", "status": "2" } ], "id": 1 } ``` ####دریافت لیستی از نودهای خاص بر اساس ID آن ها Request: ```json { "jsonrpc": "2.0", "method": "hanode.get", "params": { "ha_nodeids": ["ckuo7i1nw000e0sajwfttc1mp", "ckuo7i1nv000c0sajz85xcrtt"] }, "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "ha_nodeid": "ckuo7i1nv000c0sajz85xcrtt", "name": "node4", "address": "192.168.1.8", "port": "10052", "lastaccess": "1635334214", "status": "1" }, { "ha_nodeid": "ckuo7i1nw000e0sajwfttc1mp", "name": "node6", "address": "192.168.1.10", "port": "10053", "lastaccess": "1635332902", "status": "2" } ], "id": 1 } ``` #### Get a list of stopped nodes Request: ```json { "jsonrpc": "2.0", "method": "hanode.get", "params": { "output": ["ha_nodeid", "address", "port"], "filter": { "status": 1 } }, "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "ha_nodeid": "ckuo7i1nw000g0sajjsjre7e3", "address": "192.168.1.12", "port": "10051" }, { "ha_nodeid": "ckuo7i1nv000c0sajz85xcrtt", "address": "192.168.1.8", "port": "10052" }, { "ha_nodeid": "ckuo7i1nv000d0sajd95y1b6x", "address": "192.168.1.9", "port": "10053" } ], "id": 1 } ``` #### دریافت لیست نودهای متوقف شده Request: ```json { "jsonrpc": "2.0", "method": "hanode.get", "params": { "output": ["ha_nodeid", "address", "port"], "filter": { "status": 1 } }, "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "ha_nodeid": "ckuo7i1nw000g0sajjsjre7e3", "address": "192.168.1.12", "port": "10051" }, { "ha_nodeid": "ckuo7i1nv000c0sajz85xcrtt", "address": "192.168.1.8", "port": "10052" }, { "ha_nodeid": "ckuo7i1nv000d0sajd95y1b6x", "address": "192.168.1.9", "port": "10053" } ], "id": 1 } ``` # graph.create ساخت گراف # graph.delete # حذف گراف # graph.get #دریافت گراف # graphitem.get # دریافت آیتم های گراف ### Graph item ::: noteclassic Graph items can only be modified via the `graph` API. ::: The graph item object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |gitemid|string|*(readonly)* ID of the graph item.| |**color**<br>(required)|string|Graph item's draw color as a hexadecimal color code.| |**itemid**<br>(required)|string|ID of the item.| |calc\_fnc|integer|Value of the item that will be displayed.<br><br>Possible values:<br>1 - minimum value;<br>2 - *(default)* average value;<br>4 - maximum value;<br>7 - all values;<br>9 - last value, used only by pie and exploded graphs.| |drawtype|integer|Draw style of the graph item.<br><br>Possible values:<br>0 - *(default)* line;<br>1 - filled region;<br>2 - bold line;<br>3 - dot;<br>4 - dashed line;<br>5 - gradient line.| |graphid|string|ID of the graph that the graph item belongs to.| |sortorder|integer|Position of the item in the graph.<br><br>Default: starts with 0 and increases by one with each entry.| |type|integer|Type of graph item.<br><br>Possible values:<br>0 - *(default)* simple;<br>2 - graph sum, used only by pie and exploded graphs.| |yaxisside|integer|Side of the graph where the graph item's Y scale will be drawn.<br><br>Possible values:<br>0 - *(default)* left side;<br>1 - right side.| ### آیتم گراف ::: noteclassic Graph items can only be modified via the `graph` API. ::: The graph item object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |gitemid|string|*(readonly)* ID of the graph item.| |**color**<br>(required)|string|Graph item's draw color as a hexadecimal color code.| |**itemid**<br>(required)|string|ID of the item.| |calc\_fnc|integer|Value of the item that will be displayed.<br><br>Possible values:<br>1 - minimum value;<br>2 - *(default)* average value;<br>4 - maximum value;<br>7 - all values;<br>9 - last value, used only by pie and exploded graphs.| |drawtype|integer|Draw style of the graph item.<br><br>Possible values:<br>0 - *(default)* line;<br>1 - filled region;<br>2 - bold line;<br>3 - dot;<br>4 - dashed line;<br>5 - gradient line.| |graphid|string|ID of the graph that the graph item belongs to.| |sortorder|integer|Position of the item in the graph.<br><br>Default: starts with 0 and increases by one with each entry.| |type|integer|Type of graph item.<br><br>Possible values:<br>0 - *(default)* simple;<br>2 - graph sum, used only by pie and exploded graphs.| |yaxisside|integer|Side of the graph where the graph item's Y scale will be drawn.<br><br>Possible values:<br>0 - *(default)* left side;<br>1 - right side.| # graphprototype.create # ساخت نمونه گراف # graphprototype.delete # حذف نمونه اولیه گراف # graphprototype.get # دریافت نمونه اولیه گراف ### Graph prototype The graph prototype object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |graphid|string|*(readonly)* ID of the graph prototype.| |**height**<br>(required)|integer|Height of the graph prototype in pixels.| |**name**<br>(required)|string|Name of the graph prototype.| |**width**<br>(required)|integer|Width of the graph prototype in pixels.| |graphtype|integer|Graph prototypes's layout type.<br><br>Possible values:<br>0 - *(default)* normal;<br>1 - stacked;<br>2 - pie;<br>3 - exploded.| |percent\_left|float|Left percentile.<br><br>Default: 0.| |percent\_right|float|Right percentile.<br><br>Default: 0.| |show\_3d|integer|Whether to show discovered pie and exploded graphs in 3D.<br><br>Possible values:<br>0 - *(default)* show in 2D;<br>1 - show in 3D.| |show\_legend|integer|Whether to show the legend on the discovered graph.<br><br>Possible values:<br>0 - hide;<br>1 - *(default)* show.| |show\_work\_period|integer|Whether to show the working time on the discovered graph.<br><br>Possible values:<br>0 - hide;<br>1 - *(default)* show.| |templateid|string|*(readonly)* ID of the parent template graph prototype.| |yaxismax|float|The fixed maximum value for the Y axis.| |yaxismin|float|The fixed minimum value for the Y axis.| |ymax\_itemid|string|ID of the item that is used as the maximum value for the Y axis.<br><br>Starting with Zabbix 6.0.7, if user have no access to specified item, the graph is rendered like ymax\_type would be set to '0' (calculated).| |ymax\_type|integer|Maximum value calculation method for the Y axis.<br><br>Possible values:<br>0 - *(default)* calculated;<br>1 - fixed;<br>2 - item.| |ymin\_itemid|string|ID of the item that is used as the minimum value for the Y axis.<br><br>Starting with Zabbix 6.0.7, if user have no access to specified item, the graph is rendered like ymin\_type would be set to '0' (calculated).| |ymin\_type|integer|Minimum value calculation method for the Y axis.<br><br>Possible values:<br>0 - *(default)* calculated;<br>1 - fixed;<br>2 - item.| |discover|integer|Graph prototype discovery status.<br><br>Possible values:<br>0 - *(default)* new graphs will be discovered;<br>1 - new graphs will not be discovered and existing graphs will be marked as lost.| |uuid|string|Universal unique identifier, used for linking imported graph prototypes to already existing ones. Used only for graph prototypes on templates. Auto-generated, if not given.<br><br>For update operations this field is *readonly*.| Note that for some methods (update, delete) the required/optional parameter combination is different. ### نمونه اولیه گراف The graph prototype object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |graphid|string|*(readonly)* ID of the graph prototype.| |**height**<br>(required)|integer|Height of the graph prototype in pixels.| |**name**<br>(required)|string|Name of the graph prototype.| |**width**<br>(required)|integer|Width of the graph prototype in pixels.| |graphtype|integer|Graph prototypes's layout type.<br><br>Possible values:<br>0 - *(default)* normal;<br>1 - stacked;<br>2 - pie;<br>3 - exploded.| |percent\_left|float|Left percentile.<br><br>Default: 0.| |percent\_right|float|Right percentile.<br><br>Default: 0.| |show\_3d|integer|Whether to show discovered pie and exploded graphs in 3D.<br><br>Possible values:<br>0 - *(default)* show in 2D;<br>1 - show in 3D.| |show\_legend|integer|Whether to show the legend on the discovered graph.<br><br>Possible values:<br>0 - hide;<br>1 - *(default)* show.| |show\_work\_period|integer|Whether to show the working time on the discovered graph.<br><br>Possible values:<br>0 - hide;<br>1 - *(default)* show.| |templateid|string|*(readonly)* ID of the parent template graph prototype.| |yaxismax|float|The fixed maximum value for the Y axis.| |yaxismin|float|The fixed minimum value for the Y axis.| |ymax\_itemid|string|ID of the item that is used as the maximum value for the Y axis.<br><br>Starting with Zabbix 6.0.7, if user have no access to specified item, the graph is rendered like ymax\_type would be set to '0' (calculated).| |ymax\_type|integer|Maximum value calculation method for the Y axis.<br><br>Possible values:<br>0 - *(default)* calculated;<br>1 - fixed;<br>2 - item.| |ymin\_itemid|string|ID of the item that is used as the minimum value for the Y axis.<br><br>Starting with Zabbix 6.0.7, if user have no access to specified item, the graph is rendered like ymin\_type would be set to '0' (calculated).| |ymin\_type|integer|Minimum value calculation method for the Y axis.<br><br>Possible values:<br>0 - *(default)* calculated;<br>1 - fixed;<br>2 - item.| |discover|integer|Graph prototype discovery status.<br><br>Possible values:<br>0 - *(default)* new graphs will be discovered;<br>1 - new graphs will not be discovered and existing graphs will be marked as lost.| |uuid|string|Universal unique identifier, used for linking imported graph prototypes to already existing ones. Used only for graph prototypes on templates. Auto-generated, if not given.<br><br>For update operations this field is *readonly*.| Note that for some methods (update, delete) the required/optional parameter combination is different. # graphprototype.update # آپدیت نمونه اولیه گراف ### Graph The graph object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |graphid|string|*(readonly)* ID of the graph.| |**height**<br>(required)|integer|Height of the graph in pixels.| |**name**<br>(required)|string|Name of the graph| |**width**<br>(required)|integer|Width of the graph in pixels.| |flags|integer|*(readonly)* Origin of the graph.<br><br>Possible values are:<br>0 - *(default)* a plain graph;<br>4 - a discovered graph.| |graphtype|integer|Graph's layout type.<br><br>Possible values:<br>0 - *(default)* normal;<br>1 - stacked;<br>2 - pie;<br>3 - exploded.| |percent\_left|float|Left percentile.<br><br>Default: 0.| |percent\_right|float|Right percentile.<br><br>Default: 0.| |show\_3d|integer|Whether to show pie and exploded graphs in 3D.<br><br>Possible values:<br>0 - *(default)* show in 2D;<br>1 - show in 3D.| |show\_legend|integer|Whether to show the legend on the graph.<br><br>Possible values:<br>0 - hide;<br>1 - *(default)* show.| |show\_work\_period|integer|Whether to show the working time on the graph.<br><br>Possible values:<br>0 - hide;<br>1 - *(default)* show.| |show\_triggers|integer|Whether to show the trigger line on the graph.<br><br>Possible values:<br>0 - hide;<br>1 - *(default)* show.| |templateid|string|*(readonly)* ID of the parent template graph.| |yaxismax|float|The fixed maximum value for the Y axis.<br><br>Default: 100.| |yaxismin|float|The fixed minimum value for the Y axis.<br><br>Default: 0.| |ymax\_itemid|string|ID of the item that is used as the maximum value for the Y axis.<br><br>Starting with Zabbix 6.0.7, if user have no access to specified item, the graph is rendered like ymax\_type would be set to '0' (calculated).| |ymax\_type|integer|Maximum value calculation method for the Y axis.<br><br>Possible values:<br>0 - *(default)* calculated;<br>1 - fixed;<br>2 - item.| |ymin\_itemid|string|ID of the item that is used as the minimum value for the Y axis.<br><br>Starting with Zabbix 6.0.7, if user have no access to specified item, the graph is rendered like ymax\_type would be set to '0' (calculated).| |ymin\_type|integer|Minimum value calculation method for the Y axis.<br><br>Possible values:<br>0 - *(default)* calculated;<br>1 - fixed;<br>2 - item.| |uuid|string|Universal unique identifier, used for linking imported graphs to already existing ones. Used only for graphs on templates. Auto-generated, if not given.<br><br>For update operations this field is *readonly*.| Note that for some methods (update, delete) the required/optional parameter combination is different. ### گراف The graph object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |graphid|string|*(readonly)* ID of the graph.| |**height**<br>(required)|integer|Height of the graph in pixels.| |**name**<br>(required)|string|Name of the graph| |**width**<br>(required)|integer|Width of the graph in pixels.| |flags|integer|*(readonly)* Origin of the graph.<br><br>Possible values are:<br>0 - *(default)* a plain graph;<br>4 - a discovered graph.| |graphtype|integer|Graph's layout type.<br><br>Possible values:<br>0 - *(default)* normal;<br>1 - stacked;<br>2 - pie;<br>3 - exploded.| |percent\_left|float|Left percentile.<br><br>Default: 0.| |percent\_right|float|Right percentile.<br><br>Default: 0.| |show\_3d|integer|Whether to show pie and exploded graphs in 3D.<br><br>Possible values:<br>0 - *(default)* show in 2D;<br>1 - show in 3D.| |show\_legend|integer|Whether to show the legend on the graph.<br><br>Possible values:<br>0 - hide;<br>1 - *(default)* show.| |show\_work\_period|integer|Whether to show the working time on the graph.<br><br>Possible values:<br>0 - hide;<br>1 - *(default)* show.| |show\_triggers|integer|Whether to show the trigger line on the graph.<br><br>Possible values:<br>0 - hide;<br>1 - *(default)* show.| |templateid|string|*(readonly)* ID of the parent template graph.| |yaxismax|float|The fixed maximum value for the Y axis.<br><br>Default: 100.| |yaxismin|float|The fixed minimum value for the Y axis.<br><br>Default: 0.| |ymax\_itemid|string|ID of the item that is used as the maximum value for the Y axis.<br><br>Starting with Zabbix 6.0.7, if user have no access to specified item, the graph is rendered like ymax\_type would be set to '0' (calculated).| |ymax\_type|integer|Maximum value calculation method for the Y axis.<br><br>Possible values:<br>0 - *(default)* calculated;<br>1 - fixed;<br>2 - item.| |ymin\_itemid|string|ID of the item that is used as the minimum value for the Y axis.<br><br>Starting with Zabbix 6.0.7, if user have no access to specified item, the graph is rendered like ymax\_type would be set to '0' (calculated).| |ymin\_type|integer|Minimum value calculation method for the Y axis.<br><br>Possible values:<br>0 - *(default)* calculated;<br>1 - fixed;<br>2 - item.| |uuid|string|Universal unique identifier, used for linking imported graphs to already existing ones. Used only for graphs on templates. Auto-generated, if not given.<br><br>For update operations this field is *readonly*.| Note that for some methods (update, delete) the required/optional parameter combination is different. # graph.update # آپدیت گراف ### Group link The group link object links a host prototype with a host group and has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**groupid**<br>(required)|string|ID of the host group.| ###لینک گروهی The group link object links a host prototype with a host group and has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**groupid**<br>(required)|string|ID of the host group.| #### groups/group |Parameter|Type|Description|Details| |---------|----|-----------|-------| |name|*string*|Group name.| | #### گروه ها / گروه |Parameter|Type|Description|Details| |---------|----|-----------|-------| |name|*string*|Group name.| | #### Handling of regular expression compilation and runtime errors If a regular expression used in `log[]`, `logrt[]`, `log.count[]` or `logrt.count[]` item cannot be compiled by PCRE or PCRE2 library then the item goes into NOTSUPPORTED state with an error message. To continue monitoring the log item, the regular expression should be fixed. If the regular expression compiles successfully, but fails at runtime (on some or on all log records), then the log item remains supported and monitoring continues. The runtime error is logged in the Zabbix agent log file (without the log file record). Note that the logging of regular expression runtime errors is supported since Zabbix 6.0.21. The logging rate is limited to one runtime error per check to allow Zabbix agent to monitor its own log file. For example, if 10 records are analyzed and 3 records fail with a regexp runtime error, one record is produced in the agent log. Exception: if MaxLinesPerSecond=1 and update interval=1 (only 1 record is allowed to analyze per check) then regexp runtime errors are not logged. zabbix_agentd logs the item key in case of a runtime error, zabbix_agent2 logs the item ID to help identify which log item has runtime errors. It is recommended to redesign the regular expression in case of runtime errors. #### مدیریت خطاهای کامپایل عبارات منظم و زمان اجرا اگر عبارت منظمی که در آیتم «log[]»، «logrt[]»، «log.count[]» یا «logrt.count[]» استفاده می‌شود، توسط کتابخانه PCRE یا PCRE2 قابل کامپایل نباشد، آیتم به حالت NOTSUPPORTED می‌رود. یک پیام خطا برای ادامه نظارت بر آیتم گزارش، عبارت منظم باید ثابت شود. اگر عبارت منظم با موفقیت کامپایل شود، اما در زمان اجرا شکست بخورد (در برخی یا در همه رکوردهای گزارش)، آنگاه آیتم گزارش پشتیبانی می‌شود و نظارت ادامه می‌یابد. خطای زمان اجرا در فایل لاگ عامل Zabbix (بدون رکورد فایل لاگ) ثبت می شود. توجه داشته باشید که ثبت خطاهای زمان اجرا عبارت منظم از Zabbix 6.0.21 پشتیبانی می شود. نرخ ورود به سیستم به یک خطای زمان اجرا در هر بررسی محدود می شود تا به عامل Zabbix اجازه دهد تا فایل گزارش خود را نظارت کند. به عنوان مثال، اگر 10 رکورد تجزیه و تحلیل شود و 3 رکورد با خطای زمان اجرا regexp ناموفق باشد، یک رکورد در گزارش عامل تولید می شود. استثنا: اگر MaxLinesPerSecond=1 و فاصله به روز رسانی=1 (فقط 1 رکورد مجاز به تجزیه و تحلیل در هر بررسی است) خطاهای زمان اجرا regexp ثبت نمی شوند. zabbix_agentd کلید آیتم را در صورت بروز خطا در زمان اجرا ثبت می‌کند، zabbix_agent2 شناسه مورد را ثبت می‌کند تا تشخیص دهد کدام آیتم گزارش دارای خطاهای زمان اجرا است. توصیه می شود در صورت بروز خطا در زمان اجرا، عبارت منظم را دوباره طراحی کنید. # hanode.get # دریافت نود HA ### High availability node ::: noteclassic Nodes are created by the Zabbix server and cannot be modified via the API. ::: The High availability node object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |ha\_nodeid|string|ID of the node.| |name|string|Name assigned to the node, using the HANodeName configuration entry of zabbix\_server.conf. Empty for a server running in standalone mode.| |address|string|IP or DNS name where the node connects from.| |port|integer|Port on which the node is running.| |lastaccess|integer|Heartbeat time, t.i. time of last update from the node. UTC timestamp.| |status|integer|State of the node.<br><br>Possible values:<br>0 - standby;<br>1 - stopped manually;<br>2 - unavailable;<br>3 - active.| ### نود HA ::: noteclassic Nodes are created by the Zabbix server and cannot be modified via the API. ::: The High availability node object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |ha\_nodeid|string|ID of the node.| |name|string|Name assigned to the node, using the HANodeName configuration entry of zabbix\_server.conf. Empty for a server running in standalone mode.| |address|string|IP or DNS name where the node connects from.| |port|integer|Port on which the node is running.| |lastaccess|integer|Heartbeat time, t.i. time of last update from the node. UTC timestamp.| |status|integer|State of the node.<br><br>Possible values:<br>0 - standby;<br>1 - stopped manually;<br>2 - unavailable;<br>3 - active.| # history.clear #پاک کردن تاریخچه # history.get # گرفتن تاریخچه # host.create # ساخت هاست # host.delete #حذف هاست # host.get # دریافت هاست ##### Host graph tags |Element|Element property|Required|Type|Range^**[1](#footnotes)**^|Description| |--|--|-|--|----|--------| |graphs| |\-| | |Root element for graphs.| | |name|x|`string`| |Graph name.| | |width|\-|`integer`|20-65535 (default: 900)|Graph width, in pixels. Used for preview and for pie/exploded graphs.| | |height|\-|`integer`|20-65535 (default: 200)|Graph height, in pixels. Used for preview and for pie/exploded graphs.| | |yaxismin|\-|`double`|Default: 0|Value of Y axis minimum.<br><br>Used if 'ymin\_type\_1' is FIXED.| | |yaxismax|\-|`double`|Default: 0|Value of Y axis maximum.<br><br>Used if 'ymax\_type\_1' is FIXED.| | |show\_work\_period|\-|`string`|0 - NO<br>1 - YES (default)|Highlight non-working hours.<br><br>Used by normal and stacked graphs.| | |show\_triggers|\-|`string`|0 - NO<br>1 - YES (default)|Display simple trigger values as a line.<br><br>Used by normal and stacked graphs.| | |type|\-|`string`|0 - NORMAL (default)<br>1 - STACKED<br>2 - PIE<br>3 - EXPLODED|Graph type.| | |show\_legend|\-|`string`|0 - NO<br>1 - YES (default)|Display graph legend.| | |show\_3d|\-|`string`|0 - NO (default)<br>1 - YES|Enable 3D style.<br><br>Used by pie and exploded pie graphs.| | |percent\_left|\-|`double`|Default:0|Show the percentile line for left axis.<br><br>Used only for normal graphs.| | |percent\_right|\-|`double`|Default:0|Show the percentile line for right axis.<br><br>Used only for normal graphs.| | |ymin\_type\_1|\-|`string`|0 - CALCULATED (default)<br>1 - FIXED<br>2 - ITEM|Minimum value of Y axis.<br><br>Used by normal and stacked graphs.| | |ymax\_type\_1|\-|`string`|0 - CALCULATED (default)<br>1 - FIXED<br>2 - ITEM|Maximum value of Y axis.<br><br>Used by normal and stacked graphs.| |ymin\_item\_1| |\-| | |Individual item details.<br><br>Required if 'ymin\_type\_1' is ITEM.| | |host|x|`string`| |Item host.| | |key|x|`string`| |Item key.| |ymax\_item\_1| |\-| | |Individual item details.<br><br>Required if 'ymax\_type\_1' is ITEM.| | |host|x|`string`| |Item host.| | |key|x|`string`| |Item key.| |graph\_items| |x| | |Root element for graph items.| | |sortorder|\-|`integer`| |Draw order. The smaller value is drawn first. Can be used to draw lines or regions behind (or in front of) another.| | |drawtype|\-|`string`|0 - SINGLE\_LINE (default)<br>1 - FILLED\_REGION<br>2 - BOLD\_LINE<br>3 - DOTTED\_LINE<br>4 - DASHED\_LINE<br>5 - GRADIENT\_LINE|Draw style of the graph item.<br><br>Used only by normal graphs.| | |color|\-|`string`| |Element color (6 symbols, hex).| | |yaxisside|\-|`string`|0 - LEFT (default)<br>1 - RIGHT|Side of the graph where the graph item's Y scale will be drawn.<br><br>Used by normal and stacked graphs.| | |calc\_fnc|\-|`string`|1 - MIN<br>2 - AVG (default)<br>4 - MAX<br>7 - ALL (minimum, average and maximum; used only by simple graphs)<br>9 - LAST (used only by pie and exploded pie graphs)|Data to draw if more than one value exists for an item.| | |type|\-|`string`|0 - SIMPLE (default)<br>2 - GRAPH\_SUM (value of the item represents the whole pie; used only by pie and exploded pie graphs)|Graph item type.| |item| |x| | |Individual item.| | |host|x|`string`| |Item host.| | |key|x|`string`| |Item key.| ##### تگ های گراف هاست ها |Element|Element property|Required|Type|Range^**[1](#footnotes)**^|Description| |--|--|-|--|----|--------| |graphs| |\-| | |Root element for graphs.| | |name|x|`string`| |Graph name.| | |width|\-|`integer`|20-65535 (default: 900)|Graph width, in pixels. Used for preview and for pie/exploded graphs.| | |height|\-|`integer`|20-65535 (default: 200)|Graph height, in pixels. Used for preview and for pie/exploded graphs.| | |yaxismin|\-|`double`|Default: 0|Value of Y axis minimum.<br><br>Used if 'ymin\_type\_1' is FIXED.| | |yaxismax|\-|`double`|Default: 0|Value of Y axis maximum.<br><br>Used if 'ymax\_type\_1' is FIXED.| | |show\_work\_period|\-|`string`|0 - NO<br>1 - YES (default)|Highlight non-working hours.<br><br>Used by normal and stacked graphs.| | |show\_triggers|\-|`string`|0 - NO<br>1 - YES (default)|Display simple trigger values as a line.<br><br>Used by normal and stacked graphs.| | |type|\-|`string`|0 - NORMAL (default)<br>1 - STACKED<br>2 - PIE<br>3 - EXPLODED|Graph type.| | |show\_legend|\-|`string`|0 - NO<br>1 - YES (default)|Display graph legend.| | |show\_3d|\-|`string`|0 - NO (default)<br>1 - YES|Enable 3D style.<br><br>Used by pie and exploded pie graphs.| | |percent\_left|\-|`double`|Default:0|Show the percentile line for left axis.<br><br>Used only for normal graphs.| | |percent\_right|\-|`double`|Default:0|Show the percentile line for right axis.<br><br>Used only for normal graphs.| | |ymin\_type\_1|\-|`string`|0 - CALCULATED (default)<br>1 - FIXED<br>2 - ITEM|Minimum value of Y axis.<br><br>Used by normal and stacked graphs.| | |ymax\_type\_1|\-|`string`|0 - CALCULATED (default)<br>1 - FIXED<br>2 - ITEM|Maximum value of Y axis.<br><br>Used by normal and stacked graphs.| |ymin\_item\_1| |\-| | |Individual item details.<br><br>Required if 'ymin\_type\_1' is ITEM.| | |host|x|`string`| |Item host.| | |key|x|`string`| |Item key.| |ymax\_item\_1| |\-| | |Individual item details.<br><br>Required if 'ymax\_type\_1' is ITEM.| | |host|x|`string`| |Item host.| | |key|x|`string`| |Item key.| |graph\_items| |x| | |Root element for graph items.| | |sortorder|\-|`integer`| |Draw order. The smaller value is drawn first. Can be used to draw lines or regions behind (or in front of) another.| | |drawtype|\-|`string`|0 - SINGLE\_LINE (default)<br>1 - FILLED\_REGION<br>2 - BOLD\_LINE<br>3 - DOTTED\_LINE<br>4 - DASHED\_LINE<br>5 - GRADIENT\_LINE|Draw style of the graph item.<br><br>Used only by normal graphs.| | |color|\-|`string`| |Element color (6 symbols, hex).| | |yaxisside|\-|`string`|0 - LEFT (default)<br>1 - RIGHT|Side of the graph where the graph item's Y scale will be drawn.<br><br>Used by normal and stacked graphs.| | |calc\_fnc|\-|`string`|1 - MIN<br>2 - AVG (default)<br>4 - MAX<br>7 - ALL (minimum, average and maximum; used only by simple graphs)<br>9 - LAST (used only by pie and exploded pie graphs)|Data to draw if more than one value exists for an item.| | |type|\-|`string`|0 - SIMPLE (default)<br>2 - GRAPH\_SUM (value of the item represents the whole pie; used only by pie and exploded pie graphs)|Graph item type.| |item| |x| | |Individual item.| | |host|x|`string`| |Item host.| | |key|x|`string`| |Item key.| # hostgroup.create # ساخت گروه هاست # hostgroup.delete # حذف گروه هاست # hostgroup.get # دریافت گروه هاستی # hostgroup.massadd # اضافه کردن گروهی هاست ها # hostgroup.massremove # حذف گروهی هاست ها # hostgroup.massupdate # به روز رسانی گروهی هاست ها ### Host group The host group object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |groupid|string|*(readonly)* ID of the host group.| |**name**<br>(required)|string|Name of the host group.| |flags|integer|*(readonly)* Origin of the host group.<br><br>Possible values:<br>0 - a plain host group;<br>4 - a discovered host group.| |internal|integer|*(readonly)* Whether the group is used internally by the system. An internal group cannot be deleted.<br><br>Possible values:<br>0 - *(default)* not internal;<br>1 - internal.| |uuid|string|Universal unique identifier, used for linking imported host groups to already existing ones. Auto-generated, if not given.| Note that for some methods (update, delete) the required/optional parameter combination is different. ### گروه هاستی The host group object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |groupid|string|*(readonly)* ID of the host group.| |**name**<br>(required)|string|Name of the host group.| |flags|integer|*(readonly)* Origin of the host group.<br><br>Possible values:<br>0 - a plain host group;<br>4 - a discovered host group.| |internal|integer|*(readonly)* Whether the group is used internally by the system. An internal group cannot be deleted.<br><br>Possible values:<br>0 - *(default)* not internal;<br>1 - internal.| |uuid|string|Universal unique identifier, used for linking imported host groups to already existing ones. Auto-generated, if not given.| Note that for some methods (update, delete) the required/optional parameter combination is different. # hostgroup.update # به روز رسانی گروه هاستی # hostinterface.create # ساخت اینترفیس هاست # hostinterface.delete # حذف اینترفیس هاست # hostinterface.get # دریافت اینترفیس هاست # hostinterface.massadd # اضافه کردن گروهی اینترفیس های هاست # hostinterface.massremove # حذف گروهی اینترفیس های هاست # hostinterface.replacehostinterfaces # جایگزینی اینترفیس های هاست # hostinterface.update # به روز رسانی اینترفیس هاست ها ### Host inventory The host inventory object has the following properties. ::: notetip Each property has it's own unique ID number, which is used to associate host inventory fields with items. ::: |ID|Property|[Type](/manual/api/reference_commentary#data_types)|Description|Maximum length| |-|--|-|-----|-----| |4|alias|string|Alias.|128 characters| |11|asset\_tag|string|Asset tag.|64 characters| |28|chassis|string|Chassis.|64 characters| |23|contact|string|Contact person.|Depends on the database used:<br>- 65535 characters for SQL databases<br>- 2048 characters for Oracle databases| |32|contract\_number|string|Contract number.|64 characters| |47|date\_hw\_decomm|string|HW decommissioning date.|64 characters| |46|date\_hw\_expiry|string|HW maintenance expiry date.|64 characters| |45|date\_hw\_install|string|HW installation date.|64 characters| |44|date\_hw\_purchase|string|HW purchase date.|64 characters| |34|deployment\_status|string|Deployment status.|64 characters| |14|hardware|string|Hardware.|255 characters| |15|hardware\_full|string|Detailed hardware.|Depends on the database used:<br>- 65535 characters for SQL databases<br>- 2048 characters for Oracle databases| |39|host\_netmask|string|Host subnet mask.|39 characters| |38|host\_networks|string|Host networks.|Depends on the database used:<br>- 65535 characters for SQL databases<br>- 2048 characters for Oracle databases| |40|host\_router|string|Host router.|39 characters| |30|hw\_arch|string|HW architecture.|32 characters| |33|installer\_name|string|Installer name.|64 characters| |24|location|string|Location.|Depends on the database used:<br>- 65535 characters for SQL databases<br>- 2048 characters for Oracle databases| |25|location\_lat|string|Location latitude.|16 characters| |26|location\_lon|string|Location longitude.|16 characters| |12|macaddress\_a|string|MAC address A.|64 characters| |13|macaddress\_b|string|MAC address B.|64 characters| |29|model|string|Model.|64 characters| |3|name|string|Name.|128 characters| |27|notes|string|Notes.|Depends on the database used:<br>- 65535 characters for SQL databases<br>- 2048 characters for Oracle databases| |41|oob\_ip|string|OOB IP address.|39 characters| |42|oob\_netmask|string|OOB host subnet mask.|39 characters| |43|oob\_router|string|OOB router.|39 characters| |5|os|string|OS name.|128 characters| |6|os\_full|string|Detailed OS name.|255 characters| |7|os\_short|string|Short OS name.|128 characters| |61|poc\_1\_cell|string|Primary POC mobile number.|64 characters| |58|poc\_1\_email|string|Primary email.|128 characters| |57|poc\_1\_name|string|Primary POC name.|128 characters| |63|poc\_1\_notes|string|Primary POC notes.|Depends on the database used:<br>- 65535 characters for SQL databases<br>- 2048 characters for Oracle databases| |59|poc\_1\_phone\_a|string|Primary POC phone A.|64 characters| |60|poc\_1\_phone\_b|string|Primary POC phone B.|64 characters| |62|poc\_1\_screen|string|Primary POC screen name.|64 characters| |68|poc\_2\_cell|string|Secondary POC mobile number.|64 characters| |65|poc\_2\_email|string|Secondary POC email.|128 characters| |64|poc\_2\_name|string|Secondary POC name.|128 characters| |70|poc\_2\_notes|string|Secondary POC notes.|Depends on the database used:<br>- 65535 characters for SQL databases<br>- 2048 characters for Oracle databases| |66|poc\_2\_phone\_a|string|Secondary POC phone A.|64 characters| |67|poc\_2\_phone\_b|string|Secondary POC phone B.|64 characters| |69|poc\_2\_screen|string|Secondary POC screen name.|64 characters| |8|serialno\_a|string|Serial number A.|64 characters| |9|serialno\_b|string|Serial number B.|64 characters| |48|site\_address\_a|string|Site address A.|128 characters| |49|site\_address\_b|string|Site address B.|128 characters| |50|site\_address\_c|string|Site address C.|128 characters| |51|site\_city|string|Site city.|128 characters| |53|site\_country|string|Site country.|64 characters| |56|site\_notes|string|Site notes.|Depends on the database used:<br>- 65535 characters for SQL databases<br>- 2048 characters for Oracle databases| |55|site\_rack|string|Site rack location.|128 characters| |52|site\_state|string|Site state.|64 characters| |54|site\_zip|string|Site ZIP/postal code.|64 characters| |16|software|string|Software.|255 characters| |18|software\_app\_a|string|Software application A.|64 characters| |19|software\_app\_b|string|Software application B.|64 characters| |20|software\_app\_c|string|Software application C.|64 characters| |21|software\_app\_d|string|Software application D.|64 characters| |22|software\_app\_e|string|Software application E.|64 characters| |17|software\_full|string|Software details.|Depends on the database used:<br>- 65535 characters for SQL databases<br>- 2048 characters for Oracle databases| |10|tag|string|Tag.|64 characters| |1|type|string|Type.|64 characters| |2|type\_full|string|Type details.|64 characters| |35|url\_a|string|URL A.|255 characters| |36|url\_b|string|URL B.|255 characters| |37|url\_c|string|URL C.|255 characters| |31|vendor|string|Vendor.|64 characters| ### جست و جو هاست The host inventory object has the following properties. ::: notetip Each property has it's own unique ID number, which is used to associate host inventory fields with items. ::: |ID|Property|[Type](/manual/api/reference_commentary#data_types)|Description|Maximum length| |-|--|-|-----|-----| |4|alias|string|Alias.|128 characters| |11|asset\_tag|string|Asset tag.|64 characters| |28|chassis|string|Chassis.|64 characters| |23|contact|string|Contact person.|Depends on the database used:<br>- 65535 characters for SQL databases<br>- 2048 characters for Oracle databases| |32|contract\_number|string|Contract number.|64 characters| |47|date\_hw\_decomm|string|HW decommissioning date.|64 characters| |46|date\_hw\_expiry|string|HW maintenance expiry date.|64 characters| |45|date\_hw\_install|string|HW installation date.|64 characters| |44|date\_hw\_purchase|string|HW purchase date.|64 characters| |34|deployment\_status|string|Deployment status.|64 characters| |14|hardware|string|Hardware.|255 characters| |15|hardware\_full|string|Detailed hardware.|Depends on the database used:<br>- 65535 characters for SQL databases<br>- 2048 characters for Oracle databases| |39|host\_netmask|string|Host subnet mask.|39 characters| |38|host\_networks|string|Host networks.|Depends on the database used:<br>- 65535 characters for SQL databases<br>- 2048 characters for Oracle databases| |40|host\_router|string|Host router.|39 characters| |30|hw\_arch|string|HW architecture.|32 characters| |33|installer\_name|string|Installer name.|64 characters| |24|location|string|Location.|Depends on the database used:<br>- 65535 characters for SQL databases<br>- 2048 characters for Oracle databases| |25|location\_lat|string|Location latitude.|16 characters| |26|location\_lon|string|Location longitude.|16 characters| |12|macaddress\_a|string|MAC address A.|64 characters| |13|macaddress\_b|string|MAC address B.|64 characters| |29|model|string|Model.|64 characters| |3|name|string|Name.|128 characters| |27|notes|string|Notes.|Depends on the database used:<br>- 65535 characters for SQL databases<br>- 2048 characters for Oracle databases| |41|oob\_ip|string|OOB IP address.|39 characters| |42|oob\_netmask|string|OOB host subnet mask.|39 characters| |43|oob\_router|string|OOB router.|39 characters| |5|os|string|OS name.|128 characters| |6|os\_full|string|Detailed OS name.|255 characters| |7|os\_short|string|Short OS name.|128 characters| |61|poc\_1\_cell|string|Primary POC mobile number.|64 characters| |58|poc\_1\_email|string|Primary email.|128 characters| |57|poc\_1\_name|string|Primary POC name.|128 characters| |63|poc\_1\_notes|string|Primary POC notes.|Depends on the database used:<br>- 65535 characters for SQL databases<br>- 2048 characters for Oracle databases| |59|poc\_1\_phone\_a|string|Primary POC phone A.|64 characters| |60|poc\_1\_phone\_b|string|Primary POC phone B.|64 characters| |62|poc\_1\_screen|string|Primary POC screen name.|64 characters| |68|poc\_2\_cell|string|Secondary POC mobile number.|64 characters| |65|poc\_2\_email|string|Secondary POC email.|128 characters| |64|poc\_2\_name|string|Secondary POC name.|128 characters| |70|poc\_2\_notes|string|Secondary POC notes.|Depends on the database used:<br>- 65535 characters for SQL databases<br>- 2048 characters for Oracle databases| |66|poc\_2\_phone\_a|string|Secondary POC phone A.|64 characters| |67|poc\_2\_phone\_b|string|Secondary POC phone B.|64 characters| |69|poc\_2\_screen|string|Secondary POC screen name.|64 characters| |8|serialno\_a|string|Serial number A.|64 characters| |9|serialno\_b|string|Serial number B.|64 characters| |48|site\_address\_a|string|Site address A.|128 characters| |49|site\_address\_b|string|Site address B.|128 characters| |50|site\_address\_c|string|Site address C.|128 characters| |51|site\_city|string|Site city.|128 characters| |53|site\_country|string|Site country.|64 characters| |56|site\_notes|string|Site notes.|Depends on the database used:<br>- 65535 characters for SQL databases<br>- 2048 characters for Oracle databases| |55|site\_rack|string|Site rack location.|128 characters| |52|site\_state|string|Site state.|64 characters| |54|site\_zip|string|Site ZIP/postal code.|64 characters| |16|software|string|Software.|255 characters| |18|software\_app\_a|string|Software application A.|64 characters| |19|software\_app\_b|string|Software application B.|64 characters| |20|software\_app\_c|string|Software application C.|64 characters| |21|software\_app\_d|string|Software application D.|64 characters| |22|software\_app\_e|string|Software application E.|64 characters| |17|software\_full|string|Software details.|Depends on the database used:<br>- 65535 characters for SQL databases<br>- 2048 characters for Oracle databases| |10|tag|string|Tag.|64 characters| |1|type|string|Type.|64 characters| |2|type\_full|string|Type details.|64 characters| |35|url\_a|string|URL A.|255 characters| |36|url\_b|string|URL B.|255 characters| |37|url\_c|string|URL C.|255 characters| |31|vendor|string|Vendor.|64 characters| ##### Host low-level discovery rule tags |Element|Element property|Required|Type|Range^**[1](#footnotes)**^|Description| |--|--|-|--|----|--------| |discovery\_rules| |\-| | |Root element for low-level discovery rules.| | |*For most of the element tag values, see element tag values for a regular item. Only the tags that are specific to low-level discovery rules, are described below.*| | | | | | |type|\-|`string`|0 - ZABBIX\_PASSIVE (default)<br>2 - TRAP<br>3 - SIMPLE<br>5 - INTERNAL<br>7 - ZABBIX\_ACTIVE<br>10 - EXTERNAL<br>11 - ODBC<br>12 - IPMI<br>13 - SSH<br>14 - TELNET<br>16 - JMX<br>18 - DEPENDENT<br>19 - HTTP\_AGENT<br>20 - SNMP\_AGENT|Item type.| | |lifetime|\-|`string`|Default: 30d|Time period after which items that are no longer discovered will be deleted. Seconds, time unit with suffix or user macro.| |filter| | | | |Individual filter.| | |evaltype|\-|`string`|0 - AND\_OR (default)<br>1 - AND<br>2 - OR<br>3 - FORMULA|Logic to use for checking low-level discovery rule filter conditions.| | |formula|\-|`string`| |Custom calculation formula for filter conditions.| |conditions| |\-| | |Root element for filter conditions.| | |macro|x|`string`| |Low-level discovery macro name.| | |value|\-|`string`| |Filter value: regular expression or global regular expression.| | |operator|\-|`string`|8 - MATCHES\_REGEX (default)<br>9 - NOT\_MATCHES\_REGEX|Condition operator.| | |formulaid|x|`character`| |Arbitrary unique ID that is used to reference a condition from the custom expression. Can only contain capital-case letters. The ID must be defined by the user when modifying filter conditions, but will be generated anew when requesting them afterward.| |lld\_macro\_paths| |\-| | |Root element for LLD macro paths.| | |lld\_macro|x|`string`| |Low-level discovery macro name.| | |path|x|`string`| |Selector for value which will be assigned to the corresponding macro.| |preprocessing| |\-| | |LLD rule value preprocessing.| |step| |\-| | |Individual LLD rule value preprocessing step.| | |*For most of the element tag values, see element tag values for a host item value preprocessing. Only the tags that are specific to low-level discovery value preprocessing, are described below.*| | | | | | |type|x|`string`|5 - REGEX<br>11 - XMLPATH<br>12 - JSONPATH<br>15 - NOT\_MATCHES\_REGEX<br>16 - CHECK\_JSON\_ERROR<br>17 - CHECK\_XML\_ERROR<br>20 - DISCARD\_UNCHANGED\_HEARTBEAT<br>21 - JAVASCRIPT<br>23 - PROMETHEUS\_TO\_JSON<br>24 - CSV\_TO\_JSON<br>25 - STR\_REPLACE<br>27 - XML\_TO\_JSON|Type of the item value preprocessing step.| |trigger\_prototypes| |\-| | |Root element for trigger prototypes.| | |*For trigger prototype element tag values, see regular [host trigger](/manual/xml_export_import/hosts#host_trigger_tags) tags.*| | | | | |graph\_prototypes| |\-| | |Root element for graph prototypes.| | |*For graph prototype element tag values, see regular [host graph](/manual/xml_export_import/hosts#host_graph_tags) tags.*| | | | | |host\_prototypes| |\-| | |Root element for host prototypes.| | |*For host prototype element tag values, see regular [host](/manual/xml_export_import/hosts#host_tags) tags.*| | | | | |item\_prototypes| |\-| | |Root element for item prototypes.| | |*For item prototype element tag values, see regular [host item](/manual/xml_export_import/hosts#host_item_tags) tags.*| | | | | |master\_item| |\-| | |Individual item prototype master item/item prototype data.| | |key|x|`string`| |Dependent item prototype master item/item prototype key value.<br><br>Required for a dependent item.| ##### تگ های قوانین LLD هاست ها |Element|Element property|Required|Type|Range^**[1](#footnotes)**^|Description| |--|--|-|--|----|--------| |discovery\_rules| |\-| | |Root element for low-level discovery rules.| | |*For most of the element tag values, see element tag values for a regular item. Only the tags that are specific to low-level discovery rules, are described below.*| | | | | | |type|\-|`string`|0 - ZABBIX\_PASSIVE (default)<br>2 - TRAP<br>3 - SIMPLE<br>5 - INTERNAL<br>7 - ZABBIX\_ACTIVE<br>10 - EXTERNAL<br>11 - ODBC<br>12 - IPMI<br>13 - SSH<br>14 - TELNET<br>16 - JMX<br>18 - DEPENDENT<br>19 - HTTP\_AGENT<br>20 - SNMP\_AGENT|Item type.| | |lifetime|\-|`string`|Default: 30d|Time period after which items that are no longer discovered will be deleted. Seconds, time unit with suffix or user macro.| |filter| | | | |Individual filter.| | |evaltype|\-|`string`|0 - AND\_OR (default)<br>1 - AND<br>2 - OR<br>3 - FORMULA|Logic to use for checking low-level discovery rule filter conditions.| | |formula|\-|`string`| |Custom calculation formula for filter conditions.| |conditions| |\-| | |Root element for filter conditions.| | |macro|x|`string`| |Low-level discovery macro name.| | |value|\-|`string`| |Filter value: regular expression or global regular expression.| | |operator|\-|`string`|8 - MATCHES\_REGEX (default)<br>9 - NOT\_MATCHES\_REGEX|Condition operator.| | |formulaid|x|`character`| |Arbitrary unique ID that is used to reference a condition from the custom expression. Can only contain capital-case letters. The ID must be defined by the user when modifying filter conditions, but will be generated anew when requesting them afterward.| |lld\_macro\_paths| |\-| | |Root element for LLD macro paths.| | |lld\_macro|x|`string`| |Low-level discovery macro name.| | |path|x|`string`| |Selector for value which will be assigned to the corresponding macro.| |preprocessing| |\-| | |LLD rule value preprocessing.| |step| |\-| | |Individual LLD rule value preprocessing step.| | |*For most of the element tag values, see element tag values for a host item value preprocessing. Only the tags that are specific to low-level discovery value preprocessing, are described below.*| | | | | | |type|x|`string`|5 - REGEX<br>11 - XMLPATH<br>12 - JSONPATH<br>15 - NOT\_MATCHES\_REGEX<br>16 - CHECK\_JSON\_ERROR<br>17 - CHECK\_XML\_ERROR<br>20 - DISCARD\_UNCHANGED\_HEARTBEAT<br>21 - JAVASCRIPT<br>23 - PROMETHEUS\_TO\_JSON<br>24 - CSV\_TO\_JSON<br>25 - STR\_REPLACE<br>27 - XML\_TO\_JSON|Type of the item value preprocessing step.| |trigger\_prototypes| |\-| | |Root element for trigger prototypes.| | |*For trigger prototype element tag values, see regular [host trigger](/manual/xml_export_import/hosts#host_trigger_tags) tags.*| | | | | |graph\_prototypes| |\-| | |Root element for graph prototypes.| | |*For graph prototype element tag values, see regular [host graph](/manual/xml_export_import/hosts#host_graph_tags) tags.*| | | | | |host\_prototypes| |\-| | |Root element for host prototypes.| | |*For host prototype element tag values, see regular [host](/manual/xml_export_import/hosts#host_tags) tags.*| | | | | |item\_prototypes| |\-| | |Root element for item prototypes.| | |*For item prototype element tag values, see regular [host item](/manual/xml_export_import/hosts#host_item_tags) tags.*| | | | | |master\_item| |\-| | |Individual item prototype master item/item prototype data.| | |key|x|`string`| |Dependent item prototype master item/item prototype key value.<br><br>Required for a dependent item.| # host.massadd # اضافه کردن گروهی هاست ها # host.massremove # حذف گروهی هاست ها # host.massupdate # آپدیت گروهی هاست ها # hostprototype.create # ساخت هاست نمونه # hostprototype.delete #حذف نمونه اولیه هاست # hostprototype.get # دریافت نمونه اولیه هاست ### Host prototype tag The host prototype tag object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**tag**<br>(required)|string|Host prototype tag name.| |value|string|Host prototype tag value.| ### تگ اولیه هاست The host prototype tag object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**tag**<br>(required)|string|Host prototype tag name.| |value|string|Host prototype tag value.| ### Host prototype The host prototype object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |hostid|string|*(readonly)* ID of the host prototype.| |**host**<br>(required)|string|Technical name of the host prototype.| |name|string|Visible name of the host prototype.<br><br>Default: `host` property value.| |status|integer|Status of the host prototype.<br><br>Possible values are:<br>0 - *(default)* monitored host;<br>1 - unmonitored host.| |inventory\_mode|integer|Host inventory population mode.<br><br>Possible values are:<br>-1 - *(default)* disabled;<br>0 - manual;<br>1 - automatic.| |templateid|string|*(readonly)* ID of the parent template host prototype.| |discover|integer|Host prototype discovery status.<br><br>Possible values:<br>0 - *(default)* new hosts will be discovered;<br>1 - new hosts will not be discovered and existing hosts will be marked as lost.| |custom\_interfaces|integer|Source of interfaces for hosts created by the host prototype.<br><br>Possible values:<br>0 - *(default)* inherit interfaces from parent host;<br>1 - use host prototypes custom interfaces.| |uuid|string|Universal unique identifier, used for linking imported host prototypes to already existing ones. Used only for host prototypes on templates. Auto-generated, if not given.| Note that for some methods (update, delete) the required/optional parameter combination is different. ### هاست نمونه The host prototype object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |hostid|string|*(readonly)* ID of the host prototype.| |**host**<br>(required)|string|Technical name of the host prototype.| |name|string|Visible name of the host prototype.<br><br>Default: `host` property value.| |status|integer|Status of the host prototype.<br><br>Possible values are:<br>0 - *(default)* monitored host;<br>1 - unmonitored host.| |inventory\_mode|integer|Host inventory population mode.<br><br>Possible values are:<br>-1 - *(default)* disabled;<br>0 - manual;<br>1 - automatic.| |templateid|string|*(readonly)* ID of the parent template host prototype.| |discover|integer|Host prototype discovery status.<br><br>Possible values:<br>0 - *(default)* new hosts will be discovered;<br>1 - new hosts will not be discovered and existing hosts will be marked as lost.| |custom\_interfaces|integer|Source of interfaces for hosts created by the host prototype.<br><br>Possible values:<br>0 - *(default)* inherit interfaces from parent host;<br>1 - use host prototypes custom interfaces.| |uuid|string|Universal unique identifier, used for linking imported host prototypes to already existing ones. Used only for host prototypes on templates. Auto-generated, if not given.| Note that for some methods (update, delete) the required/optional parameter combination is different. # hostprototype.update # به روز رسانی نمونه اولیه هاست #### Hosts/host prototypes In a [host](/manual/config/hosts/host) and [host prototype](/manual/vm_monitoring#host_prototypes) configuration, user macros can be used in the following fields: |Location|<|Multiple macros/mix with text^[1](supported_by_location_user#footnotes)^| |-|------------------------------|----------| |Interface IP/DNS|<|DNS only| |Interface port|<|no| |*SNMP v1, v2*|<|<| | |SNMP community|yes| |*SNMP v3*|<|<| | |Context name|yes| |^|Security name|yes| |^|Authentication passphrase|yes| |^|Privacy passphrase|yes| |*IPMI*|<|<| | |Username|yes| |^|Password|yes| |*Tags*^[2](supported_by_location_user#footnotes)^|<|<| | |Tag names|yes| |^|Tag values|yes| #### هاست/نمونه های اولیه میزبان در یک [host](/manual/config/hosts/host) و [host نمونه اولیه](/manual/vm_monitoring#host_prototypes) پیکربندی، کاربر ماکروها را می توان در زمینه های زیر استفاده کرد: |موقعیت|<|چند ماکرو/میکس با متن^[1](پشتیبانی_شده توسط_location_user#footnotes)^| |-|-----------------------------|----------| |IP/DNS رابط|<|فقط DNS| |پورت رابط|<|نه| |*SNMP v1, v2*|<|<| | |جامعه SNMP|بله| |*SNMP v3*|<|<| | |نام زمینه|بله| |^|نام امنیتی|بله| |^| عبارت عبور احراز هویت|بله| |^|عبارت عبور حریم خصوصی|بله| |*IPMI*|<|<| | |نام کاربری|بله| |^|رمز عبور|بله| |*برچسب ها*^[2](پشتیبانی_شده توسط_location_user#footnotes)^|<|<| | |اسامی برچسب|بله| |^|مقادیر برچسب|بله| ##### Host tags |Element|Element property|Required|Type|Range^**[1](#footnotes)**^|Description| |--|--|-|--|----|--------| |groups| |x| | |Root element for host groups.| | |name|x|`string`| |Host group name.| |hosts| |\-| | |Root element for hosts.| | |host|x|`string`| |Unique host name.| | |name|\-|`string`| |Visible host name.| | |description|\-|`text`| |Host description.| | |status|\-|`string`|0 - ENABLED (default)<br>1 - DISABLED|Host status.| | |ipmi\_authtype|\-|`string`|-1 - DEFAULT (default)<br>0 - NONE<br>1 - MD2<br>2 - MD5<br>4 - STRAIGHT<br>5 - OEM<br>6 - RMCP\_PLUS|IPMI session authentication type.| | |ipmi\_privilege|\-|`string`|1 - CALLBACK<br>2 - USER (default)<br>3 - OPERATOR<br>4 - ADMIN<br>5 - OEM|IPMI session privilege level.| | |ipmi\_username|\-|`string`| |Username for IPMI checks.| | |ipmi\_password|\-|`string`| |Password for IPMI checks.| |proxy| |\-| | |Proxy.| | |name|x|`string`| |Name of the proxy (if any) that monitors the host.| |templates| |\-| | |Root element for linked templates.| | |name|x|`string`| |Template name.| |interfaces| |\-| | |Root element for host interfaces.| | |default|\-|`string`|0 - NO<br>1 - YES (default)|Whether this is the primary host interface.<br>There can be only one primary interface of one type on a host.| | |type|\-|`string`|1 - ZABBIX (default)<br>2 - SNMP<br>3 - IPMI<br>4 - JMX|Interface type.| | |useip|\-|`string`|0 - NO<br>1 - YES (default)|Whether to use IP as the interface for connecting to the host (if not, DNS will be used).| | |ip|\-|`string`| |IP address, can be either IPv4 or IPv6.<br><br>Required if the connection is made via IP.| | |dns|\-|`string`| |DNS name.<br><br>Required if the connection is made via DNS.| | |port|\-|`string`| |Port number. Supports user macros.| | |interface\_ref|x|`string`|Format: `if<N>`|Interface reference name to be used in items.| |details| |\-| | |Root element for interface details.| | |version|\-|`string`|1 - SNMPV1<br>2 - SNMP\_V2C (default)<br>3 - SNMP\_V3|Use this SNMP version.| | |community|\-|`string`| |SNMP community.<br><br>Required by SNMPv1 and SNMPv2 items.| | |contextname|\-|`string`| |SNMPv3 context name.<br><br>Used only by SNMPv3 items.| | |securityname|\-|`string`| |SNMPv3 security name.<br><br>Used only by SNMPv3 items.| | |securitylevel|\-|`string`|0 - NOAUTHNOPRIV (default)<br>1 - AUTHNOPRIV<br>2 - AUTHPRIV|SNMPv3 security level.<br><br>Used only by SNMPv3 items.| | |authprotocol|\-|`string`|0 - MD5 (default)<br>1 - SHA1<br>2 - SHA224<br>3 - SHA256<br>4 - SHA384<br>5 - SHA512|SNMPv3 authentication protocol.<br><br>Used only by SNMPv3 items.| | |authpassphrase|\-|`string`| |SNMPv3 authentication passphrase.<br><br>Used only by SNMPv3 items.| | |privprotocol|\-|`string`|0 - DES (default)<br>1 - AES128<br>2 - AES192<br>3 - AES256<br>4 - AES192C<br>5 - AES256C|SNMPv3 privacy protocol.<br><br>Used only by SNMPv3 items.| | |privpassphrase|\-|`string`| |SNMPv3 privacy passphrase.<br><br>Used only by SNMPv3 items.| | |bulk|\-|`string`|0 - NO<br>1 - YES (default)|Use bulk requests for SNMP.| |items| |\-| | |Root element for items.| | |*For item element tag values, see host [item](/manual/xml_export_import/hosts#host_item_tags) tags.*| | | | | |tags| |\-| | |Root element for host tags.| | |tag|x|`string`| |Tag name.| | |value|\-|`string`| |Tag value.| |macros| |\-| | |Root element for macros.| | |macro|x| | |User macro name.| | |type|\-|`string`|0 - TEXT (default)<br>1 - SECRET\_TEXT<br>2 - VAULT|Type of the macro.| | |value|\-|`string`| |User macro value.| | |description|\-|`string`| |User macro description.| |inventory| |\-| | |Root element for host inventory.| | |<inventory\_property>|\-| | |Individual inventory property.<br><br>All available inventory properties are listed under the respective tags, e.g. <type>, <name>, <os> (see example above).| |inventory\_mode| |\-|`string`|-1 - DISABLED<br>0 - MANUAL (default)<br>1 - AUTOMATIC|Inventory mode.| |valuemaps| |\-| | |Root element for host value maps.| | |name|x|`string`| |Value map name.| | |mapping|\-| | |Root element for mappings.| | |value|x|`string`| |Value of a mapping.| | |newvalue|x|`string`| |New value of a mapping.| ##### تگ های هاست |Element|Element property|Required|Type|Range^**[1](#footnotes)**^|Description| |--|--|-|--|----|--------| |groups| |x| | |Root element for host groups.| | |name|x|`string`| |Host group name.| |hosts| |\-| | |Root element for hosts.| | |host|x|`string`| |Unique host name.| | |name|\-|`string`| |Visible host name.| | |description|\-|`text`| |Host description.| | |status|\-|`string`|0 - ENABLED (default)<br>1 - DISABLED|Host status.| | |ipmi\_authtype|\-|`string`|-1 - DEFAULT (default)<br>0 - NONE<br>1 - MD2<br>2 - MD5<br>4 - STRAIGHT<br>5 - OEM<br>6 - RMCP\_PLUS|IPMI session authentication type.| | |ipmi\_privilege|\-|`string`|1 - CALLBACK<br>2 - USER (default)<br>3 - OPERATOR<br>4 - ADMIN<br>5 - OEM|IPMI session privilege level.| | |ipmi\_username|\-|`string`| |Username for IPMI checks.| | |ipmi\_password|\-|`string`| |Password for IPMI checks.| |proxy| |\-| | |Proxy.| | |name|x|`string`| |Name of the proxy (if any) that monitors the host.| |templates| |\-| | |Root element for linked templates.| | |name|x|`string`| |Template name.| |interfaces| |\-| | |Root element for host interfaces.| | |default|\-|`string`|0 - NO<br>1 - YES (default)|Whether this is the primary host interface.<br>There can be only one primary interface of one type on a host.| | |type|\-|`string`|1 - ZABBIX (default)<br>2 - SNMP<br>3 - IPMI<br>4 - JMX|Interface type.| | |useip|\-|`string`|0 - NO<br>1 - YES (default)|Whether to use IP as the interface for connecting to the host (if not, DNS will be used).| | |ip|\-|`string`| |IP address, can be either IPv4 or IPv6.<br><br>Required if the connection is made via IP.| | |dns|\-|`string`| |DNS name.<br><br>Required if the connection is made via DNS.| | |port|\-|`string`| |Port number. Supports user macros.| | |interface\_ref|x|`string`|Format: `if<N>`|Interface reference name to be used in items.| |details| |\-| | |Root element for interface details.| | |version|\-|`string`|1 - SNMPV1<br>2 - SNMP\_V2C (default)<br>3 - SNMP\_V3|Use this SNMP version.| | |community|\-|`string`| |SNMP community.<br><br>Required by SNMPv1 and SNMPv2 items.| | |contextname|\-|`string`| |SNMPv3 context name.<br><br>Used only by SNMPv3 items.| | |securityname|\-|`string`| |SNMPv3 security name.<br><br>Used only by SNMPv3 items.| | |securitylevel|\-|`string`|0 - NOAUTHNOPRIV (default)<br>1 - AUTHNOPRIV<br>2 - AUTHPRIV|SNMPv3 security level.<br><br>Used only by SNMPv3 items.| | |authprotocol|\-|`string`|0 - MD5 (default)<br>1 - SHA1<br>2 - SHA224<br>3 - SHA256<br>4 - SHA384<br>5 - SHA512|SNMPv3 authentication protocol.<br><br>Used only by SNMPv3 items.| | |authpassphrase|\-|`string`| |SNMPv3 authentication passphrase.<br><br>Used only by SNMPv3 items.| | |privprotocol|\-|`string`|0 - DES (default)<br>1 - AES128<br>2 - AES192<br>3 - AES256<br>4 - AES192C<br>5 - AES256C|SNMPv3 privacy protocol.<br><br>Used only by SNMPv3 items.| | |privpassphrase|\-|`string`| |SNMPv3 privacy passphrase.<br><br>Used only by SNMPv3 items.| | |bulk|\-|`string`|0 - NO<br>1 - YES (default)|Use bulk requests for SNMP.| |items| |\-| | |Root element for items.| | |*For item element tag values, see host [item](/manual/xml_export_import/hosts#host_item_tags) tags.*| | | | | |tags| |\-| | |Root element for host tags.| | |tag|x|`string`| |Tag name.| | |value|\-|`string`| |Tag value.| |macros| |\-| | |Root element for macros.| | |macro|x| | |User macro name.| | |type|\-|`string`|0 - TEXT (default)<br>1 - SECRET\_TEXT<br>2 - VAULT|Type of the macro.| | |value|\-|`string`| |User macro value.| | |description|\-|`string`| |User macro description.| |inventory| |\-| | |Root element for host inventory.| | |<inventory\_property>|\-| | |Individual inventory property.<br><br>All available inventory properties are listed under the respective tags, e.g. <type>, <name>, <os> (see example above).| |inventory\_mode| |\-|`string`|-1 - DISABLED<br>0 - MANUAL (default)<br>1 - AUTOMATIC|Inventory mode.| |valuemaps| |\-| | |Root element for host value maps.| | |name|x|`string`| |Value map name.| | |mapping|\-| | |Root element for mappings.| | |value|x|`string`| |Value of a mapping.| | |newvalue|x|`string`| |New value of a mapping.| ### Host tag The host tag object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**tag**<br>(required)|string|Host tag name.| |value|string|Host tag value.| ### تگ هاست The host tag object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**tag**<br>(required)|string|Host tag name.| |value|string|Host tag value.| # host.update # آپدیت هاست # housekeeping.get # دریافت اطلاعات ذخیره شده ### Housekeeping The settings object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |hk\_events\_mode|integer|Enable internal housekeeping for events and alerts.<br><br>Possible values:<br>0 - Disable;<br>1 - *(default)* Enable.| |hk\_events\_trigger|string|Trigger data storage period. Accepts seconds and time unit with suffix.<br><br>Default: 365d.| |hk\_events\_service|string|Service data storage period. Accepts seconds and time unit with suffix.<br><br>Default: 1d.| |hk\_events\_internal|string|Internal data storage period. Accepts seconds and time unit with suffix.<br><br>Default: 1d.| |hk\_events\_discovery|string|Network discovery data storage period. Accepts seconds and time unit with suffix.<br><br>Default: 1d.| |hk\_events\_autoreg|string|Autoregistration data storage period. Accepts seconds and time unit with suffix.<br><br>Default: 1d.| |hk\_services\_mode|integer|Enable internal housekeeping for services.<br><br>Possible values:<br>0 - Disable;<br>1 - *(default)* Enable.| |hk\_services|string|Services data storage period. Accepts seconds and time unit with suffix.<br><br>Default: 365d.| |hk\_audit\_mode|integer|Enable internal housekeeping for audit.<br><br>Possible values:<br>0 - Disable;<br>1 - *(default)* Enable.| |hk\_audit|string|Audit data storage period. Accepts seconds and time unit with suffix.<br><br>Default: 365d.| |hk\_sessions\_mode|integer|Enable internal housekeeping for sessions.<br><br>Possible values:<br>0 - Disable;<br>1 - *(default)* Enable.| |hk\_sessions|string|Sessions data storage period. Accepts seconds and time unit with suffix.<br><br>Default: 365d.| |hk\_history\_mode|integer|Enable internal housekeeping for history.<br><br>Possible values:<br>0 - Disable;<br>1 - *(default)* Enable.| |hk\_history\_global|integer|Override item history period.<br><br>Possible values:<br>0 - Do not override;<br>1 - *(default)* Override.| |hk\_history|string|History data storage period. Accepts seconds and time unit with suffix.<br><br>Default: 90d.| |hk\_trends\_mode|integer|Enable internal housekeeping for trends.<br><br>Possible values:<br>0 - Disable;<br>1 - *(default)* Enable.| |hk\_trends\_global|integer|Override item trend period.<br><br>Possible values:<br>0 - Do not override;<br>1 - *(default)* Override.| |hk\_trends|string|Trends data storage period. Accepts seconds and time unit with suffix.<br><br>Default: 365d.| |db\_extension|string|*(readonly)* Configuration flag DB extension. If this flag is set to "timescaledb" then the server changes its behavior for housekeeping and item deletion.| |compression\_status|integer|Enable TimescaleDB compression for history and trends.<br><br>Possible values:<br>0 - *(default)* Off;<br>1 - On.| |compress\_older|string|Compress history and trends records older than specified period. Accepts seconds and time unit with suffix.<br><br>Default: 7d.| |compression\_availability|integer|*(readonly)* Compression availability.<br><br>Possible values:<br>0 - Unavailable;<br>1 - Available.| ### ذخیره سازی دیتا The settings object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |hk\_events\_mode|integer|Enable internal housekeeping for events and alerts.<br><br>Possible values:<br>0 - Disable;<br>1 - *(default)* Enable.| |hk\_events\_trigger|string|Trigger data storage period. Accepts seconds and time unit with suffix.<br><br>Default: 365d.| |hk\_events\_service|string|Service data storage period. Accepts seconds and time unit with suffix.<br><br>Default: 1d.| |hk\_events\_internal|string|Internal data storage period. Accepts seconds and time unit with suffix.<br><br>Default: 1d.| |hk\_events\_discovery|string|Network discovery data storage period. Accepts seconds and time unit with suffix.<br><br>Default: 1d.| |hk\_events\_autoreg|string|Autoregistration data storage period. Accepts seconds and time unit with suffix.<br><br>Default: 1d.| |hk\_services\_mode|integer|Enable internal housekeeping for services.<br><br>Possible values:<br>0 - Disable;<br>1 - *(default)* Enable.| |hk\_services|string|Services data storage period. Accepts seconds and time unit with suffix.<br><br>Default: 365d.| |hk\_audit\_mode|integer|Enable internal housekeeping for audit.<br><br>Possible values:<br>0 - Disable;<br>1 - *(default)* Enable.| |hk\_audit|string|Audit data storage period. Accepts seconds and time unit with suffix.<br><br>Default: 365d.| |hk\_sessions\_mode|integer|Enable internal housekeeping for sessions.<br><br>Possible values:<br>0 - Disable;<br>1 - *(default)* Enable.| |hk\_sessions|string|Sessions data storage period. Accepts seconds and time unit with suffix.<br><br>Default: 365d.| |hk\_history\_mode|integer|Enable internal housekeeping for history.<br><br>Possible values:<br>0 - Disable;<br>1 - *(default)* Enable.| |hk\_history\_global|integer|Override item history period.<br><br>Possible values:<br>0 - Do not override;<br>1 - *(default)* Override.| |hk\_history|string|History data storage period. Accepts seconds and time unit with suffix.<br><br>Default: 90d.| |hk\_trends\_mode|integer|Enable internal housekeeping for trends.<br><br>Possible values:<br>0 - Disable;<br>1 - *(default)* Enable.| |hk\_trends\_global|integer|Override item trend period.<br><br>Possible values:<br>0 - Do not override;<br>1 - *(default)* Override.| |hk\_trends|string|Trends data storage period. Accepts seconds and time unit with suffix.<br><br>Default: 365d.| |db\_extension|string|*(readonly)* Configuration flag DB extension. If this flag is set to "timescaledb" then the server changes its behavior for housekeeping and item deletion.| |compression\_status|integer|Enable TimescaleDB compression for history and trends.<br><br>Possible values:<br>0 - *(default)* Off;<br>1 - On.| |compress\_older|string|Compress history and trends records older than specified period. Accepts seconds and time unit with suffix.<br><br>Default: 7d.| |compression\_availability|integer|*(readonly)* Compression availability.<br><br>Possible values:<br>0 - Unavailable;<br>1 - Available.| # housekeeping.update # آپدیت ذخیره سازی داده ### HTTP field The HTTP field object defines a name and value that is used to specify variable, HTTP header, POST form field data of query field data. It has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**name**<br>(required)|string|Name of header / variable / POST or GET field.| |**value**<br>(required)|string|Value of header / variable / POST or GET field.| ### فیلد http The HTTP field object defines a name and value that is used to specify variable, HTTP header, POST form field data of query field data. It has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**name**<br>(required)|string|Name of header / variable / POST or GET field.| |**value**<br>(required)|string|Value of header / variable / POST or GET field.| # httptest.create # ساخت Http تست # httptest.delete # حذف Http تست # httptest.get # دریافت Http تست # httptest.update # به روز رسانی http #### Hysteresis Sometimes an interval is needed between problem and recovery states, rather than a simple threshold. For example, if we want to define a trigger that reports a problem when server room temperature goes above 20°C and we want it to stay in the problem state until the temperature drops below 15°C, a simple trigger threshold at 20°C will not be enough. Instead, we need to define a trigger expression for the problem event first (temperature above 20°C). Then we need to define an additional recovery condition (temperature below 15°C). This is done by defining an additional *Recovery expression* parameter when [defining](/manual/config/triggers/trigger) a trigger. In this case, problem recovery will take place in two steps: - First, the problem expression (temperature above 20°C) will have to evaluate to FALSE - Second, the recovery expression (temperature below 15°C) will have to evaluate to TRUE The recovery expression will be evaluated only when the problem event is resolved first. ::: notewarning The recovery expression being TRUE alone does not resolve a problem if the problem expression is still TRUE! ::: #### هیسترزیس گاهی اوقات فاصله ای بین وضعیت مشکل و بهبودی لازم است، به جای یک آستانه ساده مثلاً اگر بخواهیم a را تعریف کنیم ماشه ای که وقتی دمای اتاق سرور بالاتر می رود، مشکلی را گزارش می کند 20 درجه سانتی گراد و می خواهیم تا دما در حالت مشکل باقی بماند پایین تر از 15 درجه سانتیگراد، یک آستانه ماشه ساده در 20 درجه سانتیگراد کافی نخواهد بود. در عوض، باید یک عبارت ماشه ای برای رویداد مشکل تعریف کنیم اول (دمای بیش از 20 درجه سانتیگراد). سپس ما نیاز به تعریف اضافی داریم شرایط بازیابی (دمای زیر 15 درجه سانتیگراد). این کار با تعریف an انجام می شود پارامتر اضافی *بازیابی عبارت* وقتی [تعریف](/manual/config/triggers/trigger) یک ماشه. در این حالت، بازیابی مشکل در دو مرحله انجام می شود: - ابتدا بیان مشکل (دمای بالای 20 درجه سانتیگراد) باید ارزیابی به FALSE - دوم، بیان بازیابی (دمای زیر 15 درجه سانتیگراد) خواهد داشت برای ارزیابی به TRUE عبارت بازیابی فقط زمانی ارزیابی می شود که رویداد مشکل باشد ابتدا حل شد ::: هشدار عبارت بازیابی به تنهایی درست نیست اگر عبارت مشکل همچنان درست باشد مشکل را حل کنید! ::: ##### Icon highlighting If a map element is in problem status, it is highlighted with a round circle. The fill color of the circle corresponds to the severity color of the problem. Only problems on or above the selected severity level will be displayed with the element. If all problems are acknowledged, a thick green border around the circle is displayed. Additionally: - a host in [maintenance](/manual/maintenance) is highlighted with an orange, filled square. Note that maintenance highlighting has priority over the problem severity highlighting (since Zabbix 6.0.5, only if the map element is host). - a disabled (not-monitored) host is highlighted with a gray, filled square. Highlighting is displayed if the *Icon highlighting* check-box is marked in map [configuration](/manual/config/visualization/maps/map#creating_a_map). ##### برجسته کردن نماد اگر یک عنصر نقشه در وضعیت مشکل باشد، با یک دور برجسته می شود دایره. رنگ پر شدن دایره با رنگ شدت مطابقت دارد از مشکل فقط مشکلات در سطح شدت انتخاب شده یا بالاتر با عنصر نمایش داده خواهد شد. اگر همه مشکلات تصدیق شود، الف حاشیه سبز ضخیم اطراف دایره نمایش داده می شود. علاوه بر این: - یک میزبان در [maintenance](/manual/maintenance) با علامت مشخص شده است نارنجی، مربع پر. توجه داشته باشید که برجسته سازی تعمیر و نگهداری دارد اولویت بر برجسته کردن شدت مشکل (از Zabbix 6.0.5، فقط در صورتی که عنصر نقشه میزبان باشد). - یک میزبان غیرفعال (نظارت نشده) با رنگ خاکستری پر شده برجسته می شود مربع. اگر کادر علامت * برجسته کردن نماد* علامت گذاری شده باشد، برجسته سازی نمایش داده می شود در نقشه [پیکربندی](/manual/config/visualization/maps/map#creating_a_map). # iconmap.create # ساخت آیکون مپ # iconmap.delete # حذف آیکون مپ # iconmap.get # دریافت آیکون مپ ### Icon mapping The icon mapping object defines a specific icon to be used for hosts with a certain inventory field value. It has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |iconmappingid|string|*(readonly)* ID of the icon map.| |**iconid**<br>(required)|string|ID of the icon used by the icon mapping.| |**expression**<br>(required)|string|Expression to match the inventory field against.| |**inventory\_link**<br>(required)|integer|ID of the host inventory field.<br><br>Refer to the [host inventory object](/manual/api/reference/host/object#host_inventory) for a list of supported inventory fields.| |iconmapid|string|*(readonly)* ID of the icon map that the icon mapping belongs to.| |sortorder|integer|*(readonly)* Position of the icon mapping in the icon map.| ### آیکون مپ The icon mapping object defines a specific icon to be used for hosts with a certain inventory field value. It has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |iconmappingid|string|*(readonly)* ID of the icon map.| |**iconid**<br>(required)|string|ID of the icon used by the icon mapping.| |**expression**<br>(required)|string|Expression to match the inventory field against.| |**inventory\_link**<br>(required)|integer|ID of the host inventory field.<br><br>Refer to the [host inventory object](/manual/api/reference/host/object#host_inventory) for a list of supported inventory fields.| |iconmapid|string|*(readonly)* ID of the icon map that the icon mapping belongs to.| |sortorder|integer|*(readonly)* Position of the icon mapping in the icon map.| # iconmap.update #دکمه آپدیت نقشه If access rights to persistent storage files are removed during agent operation or other errors occur (e.g. disk full) then errors are logged into the agent log file but the log item does not become NOTSUPPORTED. اگر حقوق دسترسی به فایل‌های ذخیره‌سازی دائمی در طول عملیات عامل حذف شود یا خطاهای دیگری رخ می دهد (مثلاً دیسک پر است) سپس خطاها به گزارش عامل وارد می شوند. فایل اما مورد گزارش غیرقابل پشتیبانی نمی شود. # image.create #ساخت Image # image.delete # image.delete # image.get # image.get ### Image The image object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |imageid|string|*(readonly)* ID of the image.| |**name**<br>(required)|string|Name of the image.| |imagetype|integer|Type of image.<br><br>Possible values:<br>1 - *(default)* icon;<br>2 - background image.| Note that for some methods (update, delete) the required/optional parameter combination is different. ### همبستگی شی همبستگی دارای ویژگی های زیر است. |مخصوص|[نوع](/manual/api/reference_commentary#data_types)|توضیحات| |--|--|------| |correlationid|رشته|*(فقط خواندنی)* شناسه همبستگی.| |**نام**<br>(ضروری)|رشته|نام همبستگی.| |توضیح|رشته|توضیحات همبستگی.| |وضعیت|عدد صحیح|اینکه همبستگی فعال یا غیرفعال باشد.<br><br>مقادیر ممکن عبارتند از:<br>0 - *(پیش‌فرض)* فعال؛<br>1 - غیرفعال است.| توجه داشته باشید که برای برخی از روش ها (به روز رسانی، حذف) ترکیب پارامترهای مورد نیاز/اختیاری متفاوت است. # image.update اپدیت عکس ### Implementation details The high availability (HA) cluster is an opt-in solution and it is supported for Zabbix server. The native HA solution is designed to be simple in use, it will work across sites and does not have specific requirements for the databases that Zabbix recognizes. Users are free to use the native Zabbix HA solution, or a third-party HA solution, depending on what best suits the high availability requirements in their environment. The solution consists of multiple zabbix\_server instances or nodes. Every node: - is configured separately - uses the same database - may have several modes: active, standby, unavailable, stopped Only one node can be active (working) at a time. A standby node runs only one process - the HA manager. A standby node does no data collection, processing or other regular server activities; they do not listen on ports; they have minimum database connections. Both active and standby nodes update their last access time every 5 seconds. Each standby node monitors the last access time of the active node. If the last access time of the active node is over 'failover delay' seconds, the standby node switches itself to be the active node and assigns 'unavailable' status to the previously active node. The active node monitors its own database connectivity - if it is lost for more than `failover delay-5` seconds, it must stop all processing and switch to standby mode. The active node also monitors the status of the standby nodes - if the last access time of a standby node is over 'failover delay' seconds, the standby node is assigned the 'unavailable' status. The nodes are designed to be compatible across minor Zabbix versions. ### جزئیات پیاده سازی خوشه دسترسی بالا (HA) یک راه حل انتخابی است و همینطور است برای سرور Zabbix پشتیبانی می شود. راه حل بومی HA طراحی شده است ساده در استفاده، در سراسر سایت کار خواهد کرد و خاصی ندارد الزامات برای پایگاه های داده ای که Zabbix آنها را تشخیص می دهد. کاربران آزادند تا از راه حل بومی Zabbix HA یا یک راه حل HA شخص ثالث استفاده کنید. بسته به آنچه که به بهترین وجه با نیازهای دسترسی بالا در آنها مطابقت دارد محیط. راه حل از چندین نمونه یا گره zabbix\_server تشکیل شده است. هر گره: - به طور جداگانه پیکربندی شده است - از همان پایگاه داده استفاده می کند - ممکن است چندین حالت داشته باشد: فعال، آماده به کار، در دسترس نیست، متوقف شده است فقط یک گره می تواند در یک زمان فعال (در حال کار) باشد. یک گره آماده به کار فقط یکی را اجرا می کند فرآیند - مدیر HA. یک گره آماده به کار جمع آوری داده انجام نمی دهد، پردازش یا سایر فعالیت های منظم سرور؛ آنها گوش نمی دهند در پورت ها؛ آنها حداقل اتصالات پایگاه داده را دارند. هر دو گره فعال و آماده به کار آخرین زمان دسترسی خود را هر 5 بار به روز می کنند ثانیه هر گره آماده به کار آخرین زمان دسترسی فعال را نظارت می کند گره اگر آخرین زمان دسترسی گره فعال بیش از 'failover' باشد ثانیه تاخیر، گره آماده به کار خود را به گره فعال تبدیل می کند و وضعیت "unavailable" را به گره فعال قبلی اختصاص می دهد. گره فعال اتصال پایگاه داده خود را - در صورت از بین رفتن - نظارت می کند برای بیش از «تاخیر شکست-5» ثانیه، باید تمام پردازش را متوقف کند و به حالت آماده به کار بروید. گره فعال نیز وضعیت را کنترل می کند گره های آماده به کار - اگر آخرین زمان دسترسی یک گره آماده به کار تمام شده باشد "تاخیر شکست" در ثانیه، گره آماده به کار به "غیر قابل دسترس" اختصاص داده می شود وضعیت گره ها به گونه ای طراحی شده اند که با نسخه های کوچک Zabbix سازگار باشند. #### Important notes - Database monitoring items will become unsupported if no *odbc poller* processes are started in the server or proxy configuration. To activate ODBC pollers, set *StartODBCPollers* parameter in Zabbix [server](/manual/appendix/config/zabbix_server) configuration file or, for checks performed by proxy, in Zabbix [proxy](/manual/appendix/config/zabbix_proxy) configuration file. - Zabbix does not limit the query execution time. It is up to the user to choose queries that can be executed in a reasonable amount of time. - The [Timeout](/manual/appendix/config/zabbix_server) parameter value from Zabbix server is used as the ODBC login timeout (note that depending on ODBC drivers the login timeout setting might be ignored). - The SQL command must return a result set like any query with `select ...`. The query syntax will depend on the RDBMS which will process them. The syntax of request to a storage procedure must be started with `call` keyword. #### یادداشت های مهم - اگر هیچ فرآیند *odbc poler* در پیکربندی سرور یا پروکسی شروع نشود، موارد نظارت بر پایگاه داده پشتیبانی نمی شوند. برای فعال کردن نظرسنجی‌های ODBC، پارامتر *StartODBCPollers* را در فایل پیکربندی Zabbix [server](/manual/appendix/config/zabbix_server) یا برای بررسی‌های انجام‌شده توسط پروکسی در Zabbix [پروکسی](/manual/appendix/config/zabbix_proxy) تنظیم کنید. فایل پیکربندی. - Zabbix زمان اجرای پرس و جو را محدود نمی کند. به عهده کاربر است برای انتخاب پرس و جوهایی که می توانند در مقدار معقولی اجرا شوند زمان. - مقدار پارامتر [Timeout](/manual/appendix/config/zabbix_server) از سرور Zabbix به عنوان مهلت ورود به سیستم ODBC استفاده می شود (توجه داشته باشید که بسته به درایورهای ODBC، تنظیمات زمان ورود به سیستم ممکن است باشد نادیده گرفته شده است). - دستور SQL باید مجموعه ای از نتایج را مانند هر پرس و جوی با "انتخاب ...". نحو پرس و جو به RDBMS که بستگی دارد آنها را پردازش کنید. نحو درخواست به رویه ذخیره سازی باید باشد با کلمه کلیدی «تماس» شروع شد. #### Importing a template Import the template configuration contained in the XML string. If any items or triggers in the XML string are missing, they will be deleted from the database, and everything else will be left unchanged. Request: ```json { "jsonrpc": "2.0", "method": "configuration.import", "params": { "format": "xml", "rules": { "templates": { "createMissing": true, "updateExisting": true }, "items": { "createMissing": true, "updateExisting": true, "deleteMissing": true }, "triggers": { "createMissing": true, "updateExisting": true, "deleteMissing": true }, "valueMaps": { "createMissing": true, "updateExisting": false } }, "source": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<zabbix_export><version>6.0</version><date>2023-01-01T12:00:00Z</date><groups><group><uuid>7df96b18c230490a9a0a9e2307226338</uuid><name>Templates</name></group></groups><templates><template><uuid>5aef0444a82a4d8cb7a95dc4c0c85330</uuid><template>New template</template><name>New template</name><groups><group><name>Templates</name></group></groups><items><item><uuid>7f1e6f1e48aa4a128e5b6a958a5d11c3</uuid><name>Zabbix agent ping</name><key>agent.ping</key></item><item><uuid>77ba228662be4570830aa3c503fcdc03</uuid><name>Apache server uptime</name><type>DEPENDENT</type><key>apache.server.uptime</key><delay>0</delay><trends>0</trends><value_type>TEXT</value_type><preprocessing><step><type>REGEX</type><parameters><parameter>&lt;dt&gt;Server uptime: (.*)&lt;/dt&gt;</parameter><parameter>\\1</parameter></parameters></step></preprocessing><master_item><key>web.page.get[127.0.0.1/server-status]</key></master_item></item><item><uuid>6805d4c39a624a8bab2cc8ab63df1ab3</uuid><name>CPU load</name><key>system.cpu.load</key><value_type>FLOAT</value_type><triggers><trigger><uuid>ab4c2526c2bc42e48a633082255ebcb3</uuid><expression>avg(/New template/system.cpu.load,3m)&gt;2</expression><name>CPU load too high on 'New host' for 3 minutes</name><priority>WARNING</priority></trigger></triggers></item><item><uuid>590efe5731254f089265c76ff9320726</uuid><name>Apache server status</name><key>web.page.get[127.0.0.1/server-status]</key><trends>0</trends><value_type>TEXT</value_type></item></items><valuemaps><valuemap><uuid>8fd5814c45d44a00a15ac6eaae1f3946</uuid><name>Zabbix agent ping</name><mappings><mapping><value>1</value><newvalue>Available</newvalue></mapping><mapping><value>0</value><newvalue>Not available</newvalue></mapping></mappings></valuemap></valuemaps></template></templates></zabbix_export>\n" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": true, "id": 1 } ``` #### وارد کردن هاست و آیتم ها میزبان و موارد موجود در رشته XML را وارد کنید. اگر مواردی در XML وجود ندارد، آنها از پایگاه داده حذف خواهند شد و همه چیز بقیه بدون تغییر باقی خواهند ماند. درخواست: ``json { "jsonrpc": "2.0"، "روش": "configuration.import"، "params": { "فرمت": "xml"، "قوانین": { "valueMaps": { "createMissing": درست است، "updateExisting": نادرست }، "میزبان": { "createMissing": درست است، "updateExisting": درست است }، "موارد": { "createMissing": درست است، "updateExisting": درست است، «حذف گمشده»: درست است } }، "source": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<zabbix_export><version>5.4</version><date>2020-03-13T15:31: 45Z</date><groups><group><uuid>6f6799aa69e844b4b3918f779f2abf08</uuid><name>سرورهای Zabbix</name></group></groups><hosts><host><host>صادر کردن میزبان</host ><name>صادر کردن میزبان</name><groups><group><name>سرورهای Zabbix</name></group></groups><interfaces><interface><interface_ref>if1</interface_ref></interface </interfaces><items><item><name>مورد</name><key>item.key</key><delay>30s</delay><valuemap><name>وضعیت میزبان</name>< /valuemap><interface_ref>if1</interface_ref><request_method>POST</request_method></item></items><valuemaps><valuemap><name>وضعیت میزبان</name><mappings><mapping><value >0</value><newvalue>بالا</newvalue></mapping><mapping><value>2</value><newvalue>غیرقابل دسترسی</newvalue></mapping></mappings></valuemap>< /valuemaps></host></hosts></zabbix_export>" }، "auth": "038e1d7b1735c6a5436ee9eae095879e"، "id": 1 } ``` واکنش: ``json { "jsonrpc": "2.0"، "نتیجه": درست است، "id": 1 } ``` #### Importing To import media types, do the following: - Go to: *Administration* → *Media types* - Click on *Import* to the right - Select the import file - Mark the required options in import rules - Click on *Import* ![](../../../assets/en/manual/xml_export_import/import_media.png) A success or failure message of the import will be displayed in the frontend. Import rules: |Rule|Description| |----|-----------| |*Update existing*|Existing elements will be updated with data taken from the import file. Otherwise they will not be updated.| |*Create new*|The import will add new elements using data from the import file. Otherwise it will not add them.| |*Delete missing*|The import will remove existing elements not present in the import file. Otherwise it will not remove them.| #### وارد کردن برای وارد کردن نوع مدیا مراحل زیر را انجام دهید : - Go to: *Administration* → *Media types* - Click on *Import* to the right - Select the import file - Mark the required options in import rules - Click on *Import* ![](../../../assets/en/manual/xml_export_import/import_media.png) A success or failure message of the import will be displayed in the frontend. Import rules: |Rule|Description| |----|-----------| |*Update existing*|Existing elements will be updated with data taken from the import file. Otherwise they will not be updated.| |*Create new*|The import will add new elements using data from the import file. Otherwise it will not add them.| |*Delete missing*|The import will remove existing elements not present in the import file. Otherwise it will not remove them.| #### Importing To import network maps, do the following: - Go to: *Monitoring* → *Maps* - Click on *Import* to the right - Select the import file - Mark the required options in import rules - Click on *Import* ![](../../../assets/en/manual/xml_export_import/import_maps.png) All mandatory input fields are marked with a red asterisk. A success or failure message of the import will be displayed in the frontend. Import rules: |Rule|Description| |----|-----------| |*Update existing*|Existing maps will be updated with data taken from the import file. Otherwise they will not be updated.| |*Create new*|The import will add new maps using data from the import file. Otherwise it will not add them.| If you uncheck both map options and check the respective options for images, images only will be imported. Image importing is only available to Super Admin users. ::: notewarning If replacing an existing image, it will affect all maps that are using this image. ::: #### وارد کردن برای وارد کردن نوع مدیا مراحل زیر را انجام دهید : - Go to: *Monitoring* → *Maps* - Click on *Import* to the right - Select the import file - Mark the required options in import rules - Click on *Import* ![](../../../assets/en/manual/xml_export_import/import_maps.png) All mandatory input fields are marked with a red asterisk. A success or failure message of the import will be displayed in the frontend. Import rules: |Rule|Description| |----|-----------| |*Update existing*|Existing maps will be updated with data taken from the import file. Otherwise they will not be updated.| |*Create new*|The import will add new maps using data from the import file. Otherwise it will not add them.| If you uncheck both map options and check the respective options for images, images only will be imported. Image importing is only available to Super Admin users. ::: notewarning If replacing an existing image, it will affect all maps that are using this image. ::: - Go to: *Administration* → *Media types* - Click on *Import* to the right - Select the import file - Mark the required options in import rules - Click on *Import* ![](../../../assets/en/manual/xml_export_import/import_media.png) A success or failure message of the import will be displayed in the frontend. Import rules: |Rule|Description| |----|-----------| |*Update existing*|Existing elements will be updated with data taken from the import file. Otherwise they will not be updated.| |*Create new*|The import will add new elements using data from the import file. Otherwise it will not add them.| |*Delete missing*|The import will remove existing elements not present in the import file. Otherwise it will not remove them.| #### Individual migration of history tables * Prepare directories for Data Pump for each history table. Data Pump must have read and write permissions to these directories. Example: ``` {.bash} mkdir -pv /export/history /export/history_uint /export/history_str /export/history_log /export/history_text chown -R oracle:oracle /export ``` * Create a directory object and grant read and write permissions to this object to the user used for Zabbix authentication ('zabbix' in the example below). Under *sysdba* role, run: ``` {.sql} create directory history as '/export/history'; grant read,write on directory history to zabbix; create directory history_uint as '/export/history_uint'; grant read,write on directory history_uint to zabbix; create directory history_str as '/export/history_str'; grant read,write on directory history_str to zabbix; create directory history_log as '/export/history_log'; grant read,write on directory history_log to zabbix; create directory history_text as '/export/history_text'; grant read,write on directory history_text to zabbix; ``` * Export and import each table. Replace N with the desired thread count. ``` {.bash} expdp zabbix/password@oracle_host:1521/xe DIRECTORY=history TABLES=history_old PARALLEL=N impdp zabbix/password@oracle_host:1521/xe DIRECTORY=history TABLES=history_old REMAP_TABLE=history_old:history data_options=SKIP_CONSTRAINT_ERRORS table_exists_action=APPEND PARALLEL=N CONTENT=data_only expdp zabbix/password@oracle_host:1521/xe DIRECTORY=history_uint TABLES=history_uint_old PARALLEL=N impdp zabbix/password@oracle_host:1521/xe DIRECTORY=history_uint TABLES=history_uint_old REMAP_TABLE=history_uint_old:history_uint data_options=SKIP_CONSTRAINT_ERRORS table_exists_action=APPEND PARALLEL=N CONTENT=data_only expdp zabbix/password@oracle_host:1521/xe DIRECTORY=history_str TABLES=history_str_old PARALLEL=N impdp zabbix/password@oracle_host:1521/xe DIRECTORY=history_str TABLES=history_str_old REMAP_TABLE=history_str_old:history_str data_options=SKIP_CONSTRAINT_ERRORS table_exists_action=APPEND PARALLEL=N CONTENT=data_only expdp zabbix/password@oracle_host:1521/xe DIRECTORY=history_log TABLES=history_log_old PARALLEL=N impdp zabbix/password@oracle_host:1521/xe DIRECTORY=history_log TABLES=history_log_old REMAP_TABLE=history_log_old:history_log data_options=SKIP_CONSTRAINT_ERRORS table_exists_action=APPEND PARALLEL=N CONTENT=data_only expdp zabbix/password@oracle_host:1521/xe DIRECTORY=history_text TABLES=history_text_old PARALLEL=N impdp zabbix/password@oracle_host:1521/xe DIRECTORY=history_text TABLES=history_text_old REMAP_TABLE=history_text_old:history_text data_options=SKIP_CONSTRAINT_ERRORS table_exists_action=APPEND PARALLEL=N CONTENT=data_only ``` * Follow [post-migration instructions](#post-migration) to drop the old tables. #### مهاجرت فردی جداول تاریخچه * دایرکتوری هایی را برای Data Pump برای هر جدول تاریخچه آماده کنید. Data Pump باید مجوز خواندن و نوشتن در این دایرکتوری ها را داشته باشد. مثال: ``` {.bash} mkdir -pv /export/history /export/history_uint /export/history_str /export/history_log /export/history_text chown -R oracle:oracle /export ``` * یک شی دایرکتوری ایجاد کنید و مجوز خواندن و نوشتن را برای این شی به کاربر مورد استفاده برای احراز هویت Zabbix اعطا کنید («zabbix» در مثال زیر). در نقش *sysdba*، اجرا کنید: ``` {.sql} ایجاد تاریخچه دایرکتوری به عنوان '/export/history'. اعطای خواندن، نوشتن در تاریخچه دایرکتوری به zabbix. ایجاد دایرکتوری history_uint به عنوان '/export/history_uint'; اعطای خواندن، نوشتن در فهرست history_uint به zabbix. ایجاد دایرکتوری history_str به عنوان '/export/history_str'; اعطای خواندن، نوشتن در پوشه history_str به zabbix. ایجاد فهرست history_log به عنوان '/export/history_log'; اعطای خواندن، نوشتن در فهرست history_log به zabbix. ایجاد فهرست history_text به عنوان '/export/history_text'; اعطای خواندن، نوشتن در فهرست history_text به zabbix. ``` * صادرات و واردات هر جدول. تعداد نخ مورد نظر را جایگزین N کنید. ``` {.bash} expdp zabbix/password@oracle_host:1521/xe DIRECTORY=history TABLES=history_old PARALLEL=N impdp zabbix/password@oracle_host:1521/xe DIRECTORY=history TABLES=history_old REMAP_TABLE=history_old:history data_options=SKIP_CONSTRAINT_ERRORS table_exists_action=APPEND PARALLEL=N CONTENT expdp zabbix/password@oracle_host:1521/xe DIRECTORY=history_uint TABLES=history_uint_old PARALLEL=N impdp zabbix/password@oracle_host:1521/xe DIRECTORY=history_uint TABLES=history_uint_old REMAP_TABLE=history_uint_old:history_uint data_options=SKIP_CONSTRAINT_ERRORS جدول_وجود دارد_اون_PARALL=APPEND_Action=AP expdp zabbix/password@oracle_host:1521/xe DIRECTORY=history_str TABLES=history_str_old PARALLEL=N impdp zabbix/password@oracle_host:1521/xe DIRECTORY=history_str TABLES=history_str_old REMAP_TABLE=history_str_old:history_str data_options=SKIP_CONSTRAINT_ERRORS table_exists_action=ELPNNT CONTENT=ELPNNTENDA expdp zabbix/password@oracle_host:1521/xe DIRECTORY=history_log TABLES=history_log_old PARALLEL=N impdp zabbix/password@oracle_host:1521/xe DIRECTORY=history_log TABLES=history_log_old REMAP_TABLE=history_log_old:history_log data_options=SKIP_CONSTRAINT_ERRORS table_exists_action=ELPNNT CONTENT=ELPNENT expdp zabbix/password@oracle_host:1521/xe DIRECTORY=history_text TABLES=history_text_old PARALLEL=N impdp zabbix/password@oracle_host:1521/xe DIRECTORY=history_text TABLES=history_text_old REMAP_TABLE=history_text_old:history_text data_options=SKIP_CONSTRAINT_ERRORS table_existsNEND_PARALL = ``` * [دستورالعمل‌های پس از مهاجرت] (#post-migration) را برای حذف جداول قدیمی دنبال کنید. ##### Input data ``` {.java} { "books": [ { "category": "reference", "author": "Nigel Rees", "title": "Sayings of the Century", "price": 8.95, "id": 1 }, { "category": "fiction", "author": "Evelyn Waugh", "title": "Sword of Honour", "price": 12.99, "id": 2 }, { "category": "fiction", "author": "Herman Melville", "title": "Moby Dick", "isbn": "0-553-21311-3", "price": 8.99, "id": 3 }, { "category": "fiction", "author": "J. R. R. Tolkien", "title": "The Lord of the Rings", "isbn": "0-395-19395-8", "price": 22.99, "id": 4 } ], "services": { "delivery": { "servicegroup": 1000, "description": "Next day delivery in local town", "active": true, "price": 5 }, "bookbinding": { "servicegroup": 1001, "description": "Printing and assembling book in A5 format", "active": true, "price": 154.99 }, "restoration": { "servicegroup": 1002, "description": "Various restoration methods", "active": false, "methods": [ { "description": "Chemical cleaning", "price": 46 }, { "description": "Pressing pages damaged by moisture", "price": 24.5 }, { "description": "Rebinding torn book", "price": 99.49 } ] } }, "filters": { "price": 10, "category": "fiction", "no filters": "no \"filters\"" }, "closed message": "Store is closed", "tags": [ "a", "b", "c", "d", "e" ] } ``` |JSONPath|Type|Result|Comments| |--|--|------|------| |`$.filters.price`|definite|10| | |`$.filters.category`|definite|fiction| | |`$.filters['no filters']`|definite|no "filters"| | |`$.filters`|definite|{<br>"price": 10,<br>"category": "fiction",<br>"no filters": "no \\"filters\\""<br>}| | |`$.books[1].title`|definite|Sword of Honour| | |`$.books[-1].author`|definite|J. R. R. Tolkien| | |`$.books.length()`|definite|4| | |`$.tags[:]`|indefinite|\["a", "b", "c", "d", "e" \]| | |`$.tags[2:]`|indefinite|\["c", "d", "e" \]| | |`$.tags[:3]`|indefinite|\["a", "b", "c"\]| | |`$.tags[1:4]`|indefinite|\["b", "c", "d"\]| | |`$.tags[-2:]`|indefinite|\["d", "e"\]| | |`$.tags[:-3]`|indefinite|\["a", "b"\]| | |`$.tags[:-3].length()`|definite|2| | |`$.books[0, 2].title`|indefinite|\["Moby Dick", "Sayings of the Century"\]| | |`$.books[1]['author', "title"]`|indefinite|\["Sword of Honour", "Evelyn Waugh"\]| | |`$..id`|indefinite|\[1, 2, 3, 4\]| | |`$.services..price`|indefinite|\[154.99, 5, 46, 24.5, 99.49\]| | |`$.books[?(@.id == 4 - 0.4 * 5)].title`|indefinite|\["Sword of Honour"\]|This query shows that arithmetical operations can be used in queries. Of course this query can be simplified to `$.books[?(@.id == 2)].title`| |`$.books[?(@.id == 2 \|\| @.id == 4)].title`|indefinite|\["Sword of Honour", "The Lord of the Rings"\]| | |`$.books[?(!(@.id == 2))].title`|indefinite|\["Sayings of the Century", "Moby Dick", "The Lord of the Rings"\]| | |`$.books[?(@.id != 2)].title`|indefinite|\["Sayings of the Century", "Moby Dick", "The Lord of the Rings"\]| | |`$.books[?(@.title =~ " of ")].title`|indefinite|\["Sayings of the Century", "Sword of Honour", "The Lord of the Rings"\]| | |`$.books[?(@.price > 12.99)].title`|indefinite|\["The Lord of the Rings"\]| | |`$.books[?(@.author > "Herman Melville")].title`|indefinite|\["Sayings of the Century", "The Lord of the Rings"\]| | |`$.books[?(@.price > $.filters.price)].title`|indefinite|\["Sword of Honour", "The Lord of the Rings"\]| | |`$.books[?(@.category == $.filters.category)].title`|indefinite|\["Sword of Honour","Moby Dick","The Lord of the Rings"\]| | |`$.books[?(@.category == "fiction" && @.price < 10)].title`|indefinite|\["Moby Dick"\]| | |`$..[?(@.id)]`|indefinite|\[<br>{<br>"price": 8.95,<br>"id": 1,<br>"category": "reference",<br>"author": "Nigel Rees",<br>"title": "Sayings of the Century"<br>},<br>{<br>"price": 12.99,<br>"id": 2,<br>"category": "fiction",<br>"author": "Evelyn Waugh",<br>"title": "Sword of Honour"<br>},<br>{<br>"price": 8.99,<br>"id": 3,<br>"category": "fiction",<br>"author": "Herman Melville",<br>"title": "Moby Dick",<br>"isbn": "0-553-21311-3"<br>},<br>{<br>"price": 22.99,<br>"id": 4,<br>"category": "fiction",<br>"author": "J. R. R. Tolkien",<br>"title": "The Lord of the Rings",<br>"isbn": "0-395-19395-8"<br>}<br>\]| | |`$.services..[?(@.price > 50)].description`|indefinite|'\["Printing and assembling book in A5 format", "Rebinding torn book"\]| | |`$..id.length()`|definite|4| | |`$.books[?(@.id == 2)].title.first()`|definite|Sword of Honour| | |`$..tags.first().length()`|definite|5|$..tags is indefinite path, so it returns an array of matched elements - \[\["a", "b", "c", "d", "e" \]\], first() returns the first element - \["a", "b", "c", "d", "e" \] and finally length() calculates its length - 5.| |`$.books[*].price.min()`|definite|8.95| | |`$..price.max()`|definite|154.99| | |`$.books[?(@.category == "fiction")].price.avg()`|definite|14.99| | |`$.books[?(@.category == $.filters.xyz)].title`|indefinite| |A query without match returns NULL for definite and indefinite paths.| |`$.services[?(@.active=="true")].servicegroup`|indefinite|\[1001,1000\]|Text constants must be used in boolean value comparisons.| |`$.services[?(@.active=="false")].servicegroup`|indefinite|\[1002\]|Text constants must be used in boolean value comparisons.| |`$.services[?(@.servicegroup=="1002")]~.first()`|definite|restoration| | ##### Input data ``` {.java} { "books": [ { "category": "reference", "author": "Nigel Rees", "title": "Sayings of the Century", "price": 8.95, "id": 1 }, { "category": "fiction", "author": "Evelyn Waugh", "title": "Sword of Honour", "price": 12.99, "id": 2 }, { "category": "fiction", "author": "Herman Melville", "title": "Moby Dick", "isbn": "0-553-21311-3", "price": 8.99, "id": 3 }, { "category": "fiction", "author": "J. R. R. Tolkien", "title": "The Lord of the Rings", "isbn": "0-395-19395-8", "price": 22.99, "id": 4 } ], "services": { "delivery": { "servicegroup": 1000, "description": "Next day delivery in local town", "active": true, "price": 5 }, "bookbinding": { "servicegroup": 1001, "description": "Printing and assembling book in A5 format", "active": true, "price": 154.99 }, "restoration": { "servicegroup": 1002, "description": "Various restoration methods", "active": false, "methods": [ { "description": "Chemical cleaning", "price": 46 }, { "description": "Pressing pages damaged by moisture", "price": 24.5 }, { "description": "Rebinding torn book", "price": 99.49 } ] } }, "filters": { "price": 10, "category": "fiction", "no filters": "no \"filters\"" }, "closed message": "Store is closed", "tags": [ "a", "b", "c", "d", "e" ] } ``` |JSONPath|Type|Result|Comments| |--|--|------|------| |`$.filters.price`|definite|10| | |`$.filters.category`|definite|fiction| | |`$.filters['no filters']`|definite|no "filters"| | |`$.filters`|definite|{<br>"price": 10,<br>"category": "fiction",<br>"no filters": "no \\"filters\\""<br>}| | |`$.books[1].title`|definite|Sword of Honour| | |`$.books[-1].author`|definite|J. R. R. Tolkien| | |`$.books.length()`|definite|4| | |`$.tags[:]`|indefinite|\["a", "b", "c", "d", "e" \]| | |`$.tags[2:]`|indefinite|\["c", "d", "e" \]| | |`$.tags[:3]`|indefinite|\["a", "b", "c"\]| | |`$.tags[1:4]`|indefinite|\["b", "c", "d"\]| | |`$.tags[-2:]`|indefinite|\["d", "e"\]| | |`$.tags[:-3]`|indefinite|\["a", "b"\]| | |`$.tags[:-3].length()`|definite|2| | |`$.books[0, 2].title`|indefinite|\["Moby Dick", "Sayings of the Century"\]| | |`$.books[1]['author', "title"]`|indefinite|\["Sword of Honour", "Evelyn Waugh"\]| | |`$..id`|indefinite|\[1, 2, 3, 4\]| | |`$.services..price`|indefinite|\[154.99, 5, 46, 24.5, 99.49\]| | |`$.books[?(@.id == 4 - 0.4 * 5)].title`|indefinite|\["Sword of Honour"\]|This query shows that arithmetical operations can be used in queries. Of course this query can be simplified to `$.books[?(@.id == 2)].title`| |`$.books[?(@.id == 2 \|\| @.id == 4)].title`|indefinite|\["Sword of Honour", "The Lord of the Rings"\]| | |`$.books[?(!(@.id == 2))].title`|indefinite|\["Sayings of the Century", "Moby Dick", "The Lord of the Rings"\]| | |`$.books[?(@.id != 2)].title`|indefinite|\["Sayings of the Century", "Moby Dick", "The Lord of the Rings"\]| | |`$.books[?(@.title =~ " of ")].title`|indefinite|\["Sayings of the Century", "Sword of Honour", "The Lord of the Rings"\]| | |`$.books[?(@.price > 12.99)].title`|indefinite|\["The Lord of the Rings"\]| | |`$.books[?(@.author > "Herman Melville")].title`|indefinite|\["Sayings of the Century", "The Lord of the Rings"\]| | |`$.books[?(@.price > $.filters.price)].title`|indefinite|\["Sword of Honour", "The Lord of the Rings"\]| | |`$.books[?(@.category == $.filters.category)].title`|indefinite|\["Sword of Honour","Moby Dick","The Lord of the Rings"\]| | |`$.books[?(@.category == "fiction" && @.price < 10)].title`|indefinite|\["Moby Dick"\]| | |`$..[?(@.id)]`|indefinite|\[<br>{<br>"price": 8.95,<br>"id": 1,<br>"category": "reference",<br>"author": "Nigel Rees",<br>"title": "Sayings of the Century"<br>},<br>{<br>"price": 12.99,<br>"id": 2,<br>"category": "fiction",<br>"author": "Evelyn Waugh",<br>"title": "Sword of Honour"<br>},<br>{<br>"price": 8.99,<br>"id": 3,<br>"category": "fiction",<br>"author": "Herman Melville",<br>"title": "Moby Dick",<br>"isbn": "0-553-21311-3"<br>},<br>{<br>"price": 22.99,<br>"id": 4,<br>"category": "fiction",<br>"author": "J. R. R. Tolkien",<br>"title": "The Lord of the Rings",<br>"isbn": "0-395-19395-8"<br>}<br>\]| | |`$.services..[?(@.price > 50)].description`|indefinite|'\["Printing and assembling book in A5 format", "Rebinding torn book"\]| | |`$..id.length()`|definite|4| | |`$.books[?(@.id == 2)].title.first()`|definite|Sword of Honour| | |`$..tags.first().length()`|definite|5|$..tags is indefinite path, so it returns an array of matched elements - \[\["a", "b", "c", "d", "e" \]\], first() returns the first element - \["a", "b", "c", "d", "e" \] and finally length() calculates its length - 5.| |`$.books[*].price.min()`|definite|8.95| | |`$..price.max()`|definite|154.99| | |`$.books[?(@.category == "fiction")].price.avg()`|definite|14.99| | |`$.books[?(@.category == $.filters.xyz)].title`|indefinite| |A query without match returns NULL for definite and indefinite paths.| |`$.services[?(@.active=="true")].servicegroup`|indefinite|\[1001,1000\]|Text constants must be used in boolean value comparisons.| |`$.services[?(@.active=="false")].servicegroup`|indefinite|\[1002\]|Text constants must be used in boolean value comparisons.| |`$.services[?(@.servicegroup=="1002")]~.first()`|definite|restoration| | ##### Installation After this is done use the following command to install Zabbix agent as Windows service: C:\> c:\zabbix\zabbix_agentd.exe -c c:\zabbix\zabbix_agentd.conf -i Now you should be able to configure "Zabbix agent" service normally as any other Windows service. See [more details](/manual/appendix/install/windows_agent#installing_agent_as_windows_service) on installing and running Zabbix agent on Windows. ##### نصب و راه اندازی پس از انجام این کار از دستور زیر برای نصب agent Zabbix به عنوان استفاده کنید سرویس ویندوز: C:\> c:\zabbix\zabbix_agentd.exe -c c:\zabbix\zabbix_agentd.conf -i اکنون باید بتوانید سرویس "Zabbix agent" را به صورت عادی پیکربندی کنید هر سرویس ویندوز دیگری بیشتر ببین جزئیات](/دستی/ضمیمه/نصب/ویندوز_عامل#نصب_عامل_عنوان_سرویس_ویندوز) نصب و اجرای عامل Zabbix در ویندوز. #### Installation A new [Zabbix web service](/manual/concepts/web_service) process and Google Chrome browser should be installed to enable generation of scheduled reports. The web service may be installed on the same machine where the Zabbix server is installed or on a different machine. Google Chrome browser should be installed on the same machine, where the web service is installed. #### نصب و راه اندازی یک فرآیند جدید [Zabbix web service](/manual/concepts/web_service) و مرورگر Google Chrome باید نصب شود تا تولید گزارش‌های زمان‌بندی‌شده را فعال کند. وب سرویس ممکن است در همان دستگاهی که سرور Zabbix در آن نصب شده است یا روی دستگاه دیگری نصب شود. مرورگر گوگل کروم باید روی همان دستگاهی که وب سرویس نصب شده است نصب شود. ##### Installation See the [package installation](/manual/installation/install_from_packages) section for instructions on how to install Zabbix agent as package. Alternatively see instructions for [manual installation](/manual/installation/install#installing_zabbix_daemons) if you do not want to use packages. ::: noteimportant In general, 32bit Zabbix agents will work on 64bit systems, but may fail in some cases. ::: ##### نصب و راه اندازی [بسته install](/manual/installation/install_from_packages) بخش برای دستورالعمل نحوه نصب عامل Zabbix به عنوان بسته. یا دستورالعمل‌های [دستی install](/manual/installation/install#installing_zabbix_daemons) اگر شما نمی خواهید از بسته ها استفاده کنید. ::: نکته مهم به طور کلی، عوامل 32 بیتی Zabbix روی 64 بیت کار خواهند کرد سیستم ها، اما ممکن است در برخی موارد شکست بخورند. ::: #### Installing agent as Windows service To install a single instance of Zabbix agent with the default configuration file `c:\zabbix_agentd.conf`: zabbix_agentd.exe --install ::: noteimportant On a 64-bit system, a 64-bit Zabbix agent version is required for all checks related to running 64-bit processes to work correctly. ::: If you wish to use a configuration file other than `c:\zabbix_agentd.conf`, you should use the following command for service installation: zabbix_agentd.exe --config <your_configuration_file> --install A full path to the configuration file should be specified. Multiple instances of Zabbix agent can be installed as services like this: zabbix_agentd.exe --config <configuration_file_for_instance_1> --install --multiple-agents zabbix_agentd.exe --config <configuration_file_for_instance_2> --install --multiple-agents ... zabbix_agentd.exe --config <configuration_file_for_instance_N> --install --multiple-agents The installed service should now be visible in Control Panel. #### نصب عامل به عنوان سرویس ویندوز برای نصب یک نمونه از عامل Zabbix با پیش فرض فایل پیکربندی `c:\zabbix_agentd.conf`: zabbix_agentd.exe -- نصب کنید ::: نکته مهم در یک سیستم 64 بیتی، یک نسخه عامل 64 بیتی Zabbix برای کار کردن همه بررسی های مربوط به اجرای فرآیندهای 64 بیتی لازم است به درستی. ::: اگر می خواهید از یک فایل پیکربندی غیر از 'c:\zabbix_agentd.conf'، باید از دستور زیر استفاده کنید نصب سرویس: zabbix_agentd.exe --config <your_configuration_file> --نصب یک مسیر کامل برای فایل پیکربندی باید مشخص شود. چندین نمونه از عامل Zabbix را می توان به عنوان سرویس هایی مانند نصب کرد این: zabbix_agentd.exe --config <configuration_file_for_instance_1> --install --multiple-agents zabbix_agentd.exe --config <configuration_file_for_instance_2> --install --multiple-agents ... zabbix_agentd.exe --config <configuration_file_for_instance_N> --install --multiple-agents اکنون سرویس نصب شده باید در کنترل پنل قابل مشاهده باشد. ### Integer history The integer history object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |clock|timestamp|Time when that value was received.| |itemid|string|ID of the related item.| |ns|integer|Nanoseconds when the value was received.| |value|integer|Received value.| ### تاریخچه عدد صحیح The integer history object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |clock|timestamp|Time when that value was received.| |itemid|string|ID of the related item.| |ns|integer|Nanoseconds when the value was received.| |value|integer|Received value.| #### Internal queue items There are also another two items specifically allowing to remote query internal queue stats on another Zabbix instance: - `zabbix[stats,<ip>,<port>,queue,<from>,<to>]` internal item - for direct internal queue queries to remote Zabbix server/proxy - `zabbix.stats[<ip>,<port>,queue,<from>,<to>]` agent item - for agent-based internal queue queries to remote Zabbix server/proxy See also: [Internal items](/manual/config/items/itemtypes/internal), [Zabbix agent items](/manual/config/items/itemtypes/zabbix_agent) #### آیتم های صف داخلی همچنین دو مورد دیگر وجود دارد که به طور خاص امکان پرس و جو از راه دور را می دهد آمار صف داخلی در یک نمونه دیگر Zabbix: - مورد داخلی `zabbix[stats,<ip>,<port>,queue,<from>,<to>]` - برای پرس و جوهای صف داخلی را به سرور/پراکسی Zabbix راه دور هدایت کنید - "zabbix.stats[<ip>,<port>,queue,<from>,<to>]" عامل - برای پرس و جوهای صف داخلی مبتنی بر عامل به سرور/پراکسی Zabbix راه دور همچنین ببینید: [موارد داخلی](/دستی/تنظیم/آیتم/آیتمtypes/internal)، [اقلام عامل Zabbix](/manual/config/items/itemtypes/zabbix_agent) #### Internal workings of bulk processing Zabbix server and proxy query SNMP devices for multiple values in a single request. This affects several types of SNMP items: - regular SNMP items - SNMP items [with dynamic indexes](/manual/config/items/itemtypes/snmp/dynamicindex) - SNMP [low-level discovery rules](/manual/discovery/low_level_discovery/examples/snmp_oids) All SNMP items on a single interface with identical parameters are scheduled to be queried at the same time. The first two types of items are taken by pollers in batches of at most 128 items, whereas low-level discovery rules are processed individually, as before. On the lower level, there are two kinds of operations performed for querying values: getting multiple specified objects and walking an OID tree. For "getting", a GetRequest-PDU is used with at most 128 variable bindings. For "walking", a GetNextRequest-PDU is used for SNMPv1 and GetBulkRequest with "max-repetitions" field of at most 128 is used for SNMPv2 and SNMPv3. Thus, the benefits of bulk processing for each SNMP item type are outlined below: - regular SNMP items benefit from "getting" improvements; - SNMP items with dynamic indexes benefit from both "getting" and "walking" improvements: "getting" is used for index verification and "walking" for building the cache; - SNMP low-level discovery rules benefit from "walking" improvements. However, there is a technical issue that not all devices are capable of returning 128 values per request. Some always return a proper response, but others either respond with a "tooBig(1)" error or do not respond at all once the potential response is over a certain limit. In order to find an optimal number of objects to query for a given device, Zabbix uses the following strategy. It starts cautiously with querying 1 value in a request. If that is successful, it queries 2 values in a request. If that is successful again, it queries 3 values in a request and continues similarly by multiplying the number of queried objects by 1.5, resulting in the following sequence of request sizes: 1, 2, 3, 4, 6, 9, 13, 19, 28, 42, 63, 94, 128. However, once a device refuses to give a proper response (for example, for 42 variables), Zabbix does two things. First, for the current item batch it halves the number of objects in a single request and queries 21 variables. If the device is alive, then the query should work in the vast majority of cases, because 28 variables were known to work and 21 is significantly less than that. However, if that still fails, then Zabbix falls back to querying values one by one. If it still fails at this point, then the device is definitely not responding and request size is not an issue. The second thing Zabbix does for subsequent item batches is it starts with the last successful number of variables (28 in our example) and continues incrementing request sizes by 1 until the limit is hit. For example, assuming the largest response size is 32 variables, the subsequent requests will be of sizes 29, 30, 31, 32, and 33. The last request will fail and Zabbix will never issue a request of size 33 again. From that point on, Zabbix will query at most 32 variables for this device. If large queries fail with this number of variables, it can mean one of two things. The exact criteria that a device uses for limiting response size cannot be known, but we try to approximate that using the number of variables. So the first possibility is that this number of variables is around the device's actual response size limit in the general case: sometimes response is less than the limit, sometimes it is greater than that. The second possibility is that a UDP packet in either direction simply got lost. For these reasons, if Zabbix gets a failed query, it reduces the maximum number of variables to try to get deeper into the device's comfortable range, but (starting from 2.2.8) only up to two times. In the example above, if a query with 32 variables happens to fail, Zabbix will reduce the count to 31. If that happens to fail, too, Zabbix will reduce the count to 30. However, Zabbix will not reduce the count below 30, because it will assume that further failures are due to UDP packets getting lost, rather than the device's limit. If, however, a device cannot handle bulk requests properly for other reasons and the heuristic described above does not work, since Zabbix 2.4 there is a "Use bulk requests" setting for each interface that allows to disable bulk requests for that device. #### عملکرد داخلی پردازش فله سرور Zabbix و پراکسی پرس و جو دستگاه های SNMP برای چندین مقدار در یک درخواست این بر چندین نوع SNMP تأثیر می گذارد موارد: - آیتم های SNMP معمولی - آیتم های SNMP [با پویا ایندکس ها](/دستی/پیکربندی/آیتم/آیتمtypes/snmp/شاخص پویا) - SNMP [کشف سطح پایین قوانین](/دستی/کشف/کاوش_سطح_کم/مثال/snmp_oids) تمام موارد SNMP در یک رابط واحد با پارامترهای یکسان هستند قرار است در همان زمان استعلام شود. دو نوع اول از آیتم ها توسط نظرسنجی ها در دسته های حداکثر 128 مورد گرفته می شوند، در حالی که در سطح پایین قوانین کشف مانند قبل به صورت جداگانه پردازش می شوند. در سطح پایین تر، دو نوع عملیات انجام می شود مقادیر پرس و جو: دریافت چندین شی مشخص شده و راه رفتن در یک OID درخت برای دریافت، یک GetRequest-PDU با حداکثر 128 متغیر استفاده می شود اتصالات برای "راه رفتن"، یک GetNextRequest-PDU برای SNMPv1 و استفاده می شود GetBulkRequest با قسمت "حداکثر تکرار" حداکثر 128 برای SNMPv2 و SNMPv3. بنابراین، مزایای پردازش انبوه برای هر نوع آیتم SNMP است در زیر به آن اشاره شده است: - موارد SNMP معمولی از بهبودهای "دریافت" بهره می برند. - آیتم های SNMP با شاخص های پویا هم از «گرفتن» و هم بهره می برند بهبودهای "پیاده روی": "به دست آوردن" برای تأیید شاخص و "پیاده روی" برای ساختن حافظه پنهان؛ - قوانین کشف سطح پایین SNMP از پیشرفت های "راه رفتن" سود می برند. با این حال، یک مشکل فنی وجود دارد که همه دستگاه ها قادر به انجام آن نیستند برگرداندن 128 مقدار در هر درخواست. بعضی ها همیشه پاسخ مناسبی می دهند، اما دیگران یا با خطای "tooBig(1)" پاسخ می دهند یا در پاسخ نمی دهند همه زمانی که پاسخ بالقوه بیش از حد معینی باشد. به منظور یافتن تعداد بهینه از اشیاء برای پرس و جو برای یک معین Zabbix از استراتژی زیر استفاده می کند. با احتیاط شروع می شود درخواست 1 مقدار در یک درخواست اگر موفقیت آمیز باشد، پرس و جو می کند 2 مقادیر در یک درخواست اگر دوباره موفقیت آمیز باشد، 3 مقدار را درخواست می کند یک درخواست و به طور مشابه با ضرب تعداد پرس و جو ادامه می یابد اشیاء با 1.5، که منجر به دنباله ای از اندازه های درخواست می شود: 1، 2، 3، 4، 6، 9، 13، 19، 28، 42، 63، 94، 128. با این حال، هنگامی که یک دستگاه از دادن پاسخ مناسب خودداری می کند (به عنوان مثال، برای 42 متغیر)، Zabbix دو کار انجام می دهد. اول، برای دسته آیتم فعلی، تعداد اشیاء در a را نصف می کند تک درخواست و پرس و جو 21 متغیر. اگر دستگاه زنده است، پس پرس و جو باید در اکثر موارد کار کند، زیرا 28 مشخص شد که متغیرها کار می کنند و 21 به طور قابل توجهی کمتر از آن است. با این حال، اگر باز هم شکست بخورد، Zabbix به مقادیر پرس‌وجو بازمی‌گردد یکی یکی. اگر در این مرحله باز هم از کار بیفتد، دستگاه درست است قطعا پاسخ ندادن و اندازه درخواست مشکلی نیست. دومین کاری که Zabbix برای دسته های آیتم های بعدی انجام می دهد این است که شروع به کار می کند با آخرین تعداد موفق متغیر (در مثال ما 28) و به افزایش اندازه درخواست 1 ادامه می دهد تا زمانی که حد مجاز شود. برای به عنوان مثال، با فرض اینکه بزرگترین اندازه پاسخ 32 متغیر باشد، درخواست های بعدی در اندازه های 29، 30، 31، 32 و 33 خواهد بود. آخرین درخواست با شکست مواجه می شود و Zabbix هرگز درخواستی با اندازه 33 صادر نمی کند از نو. از آن زمان به بعد، Zabbix حداکثر 32 متغیر را پرس و جو می کند این دستگاه. اگر پرس و جوهای بزرگ با این تعداد متغیر شکست بخورند، می تواند به معنای یکی از متغیرها باشد دو چیز. معیارهای دقیقی که یک دستگاه برای محدود کردن پاسخ استفاده می کند اندازه را نمی توان شناخت، اما سعی می کنیم با استفاده از تعداد آن را تقریب کنیم متغیرها پس اولین احتمال این است که این تعداد متغیر باشد در مورد محدودیت اندازه پاسخ واقعی دستگاه در حالت کلی: گاهی اوقات پاسخ کمتر از حد است، گاهی اوقات بیشتر از که احتمال دوم این است که یک بسته UDP در هر جهت به سادگی گم شد به این دلایل، اگر Zabbix یک جستجوی ناموفق دریافت کند، آن را انجام می دهد حداکثر تعداد متغیرها را کاهش می دهد تا سعی شود بیشتر به آن وارد شود محدوده راحت دستگاه، اما (شروع از 2.2.8) فقط تا دو بار. در مثال بالا، اگر یک کوئری با 32 متغیر شکست بخورد، Zabbix تعداد را به 31 کاهش می دهد. اگر این نیز شکست خورد، Zabbix تعداد را به 30 کاهش می دهد. اما Zabbix تعداد را کاهش نمی دهد زیر 30، زیرا فرض می شود که خرابی های بیشتر به دلیل UDP است گم شدن بسته ها، به جای محدودیت دستگاه. با این حال، اگر دستگاهی نتواند درخواست های انبوه را به درستی برای سایر دستگاه ها انجام دهد دلایل و اکتشافی شرح داده شده در بالا کار نمی کند، زیرا Zabbix 2.4 یک تنظیم "استفاده از درخواست های انبوه" برای هر رابطی وجود دارد که اجازه می دهد تا درخواست های انبوه را برای آن دستگاه غیرفعال کنید. In [trigger action](/manual/config/notifications/action/conditions#trigger-actions) configuration, the condition type *Trigger name* has been renamed *Event name* to better describe its function. Note that by default, the event name matches the trigger name unless a custom event name is specified in [trigger configuration](/manual/config/triggers/trigger). در پیکربندی [trigger action](/manual/config/notifications/action/conditions#trigger-actions)، نوع شرط *نام محرک* به *نام رویداد* تغییر نام داده است تا عملکرد آن بهتر توصیف شود. توجه داشته باشید که به طور پیش‌فرض، نام رویداد با نام راه‌انداز مطابقت دارد، مگر اینکه یک نام رویداد سفارشی در [پیکربندی راه‌انداز] (/manual/config/triggers/trigger) مشخص شده باشد. # item.create #ساخت Image # item.delete # item.delete ##### Item filter syntax The item filter: /host/key[parameters]?[conditions] consists of four parts, where: * host - host name * key - item key (without parameters) * parameters - item key parameters * conditions - host group and/or item tag based conditions (as expression) Spaces are allowed only inside the conditions expression. **Wildcard usage** * Wildcard can be used to replace the host name, item key or an individual item key parameter. * Either the host or item key must be specified without wildcard. So `/host/*` and `/*/key` are valid filters, but `/*/*` is invalid. * Wildcard cannot be used for a *part* of host name, item key, item key parameter. * Wildcard does not match more than a single item key parameter. So a wildcard must be specified for each parameter in separation (i.e. `key[abc,*,*]`). **Conditions expression** The conditions expression supports: * operands: * group - host group * tag - item tag * `"<text>"` - string constant, with the `\` escape character to escape `"` and `\` * case-sensitive string comparison operators: `=`, `<>` * logical operators: `and`, `or`, `not` * grouping with parentheses: `(` `)` Quotation of string constants is mandatory. Only case-sensitive full string comparison is supported. :::notewarning When specifying tags in the filter (i.e. `tag="tagname:value"`), the colon ":" is used as a delimiter. Everything after it is considered the tag value. Thus it is currently not supported to specify a tag name containing ":" in it. ::: **Examples** A complex filter may be used, referencing the item key, host group and tags, as illustrated by the examples: |Syntax example|Description| |--|--| |`/host/key[abc,*]`|Matches similar items on this host.| |`/*/key`|Matches the same item of any host.| |`/*/key?[group="ABC" and tag="tagname:value"]`|Matches the same item of any host from the ABC group having 'tagname:value' tags.| |`/*/key[a,*,c]?[(group="ABC" and tag="Tag1") or (group="DEF" and (tag="Tag2" or tag="Tag3:value"))]`|Matches similar items of any host from the ABC or DEF group with the respective tags.| All referenced items must exist and collect data. Only enabled items on enabled hosts are included in the calculations. ::: noteimportant If the item key of a referenced item is changed, the filter must be updated manually. ::: Specifying a parent host group includes the parent group and all nested host groups with their items. ##### نحو فیلتر آیتم فیلتر مورد: /host/key[پارامترها]؟[شرایط] شامل چهار بخش است که در آن: * میزبان - نام میزبان * کلید - کلید آیتم (بدون پارامتر) * پارامترها - پارامترهای کلیدی مورد * شرایط - گروه میزبان و/یا شرایط مبتنی بر برچسب مورد (به عنوان عبارت) فضاها فقط در داخل عبارت شرط مجاز هستند. **استفاده از حروف عام** * Wildcard را می توان برای جایگزینی نام میزبان، کلید مورد یا پارامتر کلید آیتم جداگانه استفاده کرد. * کلید میزبان یا آیتم باید بدون علامت عام مشخص شود. بنابراین «/host/*» و «/*/key» فیلترهای معتبری هستند، اما «/*/*» نامعتبر است. * علامت عام را نمی توان برای یک *بخش* از نام میزبان، کلید مورد، پارامتر کلید مورد استفاده کرد. * Wildcard با بیش از یک پارامتر کلید مورد مطابقت ندارد. بنابراین باید برای هر پارامتر در جداسازی یک علامت عام مشخص شود (یعنی «کلید[abc،*،*]». **بیان شرایط** عبارت شرایط پشتیبانی می کند: * عملگرها: * گروه - گروه میزبان * برچسب - برچسب آیتم * `"<text>"` - رشته ثابت، با کاراکتر فرار "\" برای فرار از """ و `\` * عملگرهای مقایسه رشته حساس به حروف بزرگ و کوچک: `=`, `<>` * عملگرهای منطقی: "and"، "or"، "not". * گروه بندی با پرانتز: `(` `)` نقل قول ثابت های رشته ای اجباری است. فقط مقایسه رشته کامل حساس به حروف کوچک و بزرگ پشتیبانی می شود. :::توجه داشته باشید هنگام تعیین برچسب‌ها در فیلتر (یعنی «tag="tagname:value"»)، از کولون ":" به عنوان جداکننده استفاده می‌شود. همه چیز بعد از آن به عنوان مقدار برچسب در نظر گرفته می شود. بنابراین در حال حاضر از تعیین نام برچسب حاوی ":" در آن پشتیبانی نمی شود. ::: **مثال ها** ممکن است از یک فیلتر پیچیده استفاده شود که به کلید آیتم، گروه میزبان و ارجاع می دهد برچسب ها، همانطور که در مثال ها نشان داده شده است: |نمونه نحو|توضیح| |--|--| |`/host/key[abc,*]`|با موارد مشابه در این میزبان مطابقت دارد.| |`/*/key`|با یک مورد از هر میزبان مطابقت دارد.| |`/*/key?[group="ABC" and tag="tagname:value"]`|همین مورد از هر میزبانی از گروه ABC دارای برچسب 'tagname:value' مطابقت دارد.| |`/*/key[a,*,c]?[(group="ABC" and tag="Tag1") یا (group="DEF" and (tag="Tag2" or tag="Tag3:value" ))]`| موارد مشابه هر میزبانی از گروه ABC یا DEF را با برچسب های مربوطه مطابقت می دهد.| همه موارد ارجاع شده باید وجود داشته باشند و داده ها را جمع آوری کنند. فقط موارد فعال شده است میزبان های فعال در محاسبات گنجانده شده است. ::: نکته مهم اگر کلید آیتم یک مورد ارجاع شده تغییر کند، فیلتر باید به صورت دستی به روز شود. ::: تعیین یک گروه میزبان والد شامل گروه والد و همه تو در تو می شود گروه های میزبان با آیتم های خود # item.get # item.get # itemprototype.create # ساخت هاست نمونه # itemprototype.delete # ساخت هاست نمونه # itemprototype.get # دریافت نمونه اولیه هاست ### Item prototype tag The item prototype tag object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**tag**<br>(required)|string|Item prototype tag name.| |value|string|Item prototype tag value.| ### Etiqueta de prototip d'element L'objecte d'etiqueta de prototip d'element té les propietats següents: |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |**tag**<br>(obligatori)|string|Nom de l'etiqueta de prototip d'element.| |value|string|Valor de l'etiqueta de prototip d'element.| # itemprototype.update # ساخت هاست نمونه ## Items ## موارد ### Items ##### docker.container_stats The [docker.container_stats](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2#docker) item on Zabbix agent 2 now also returns a `pids_stats` property with the current number of processes/threads on the container. ### موارد ##### docker.container_stats مورد [docker.container_stats](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2#docker) در عامل Zabbix 2 اکنون همچنین یک ویژگی «pids_stats» را با تعداد فرآیندها/رشته‌های موجود در ظرف برمی‌گرداند. #### Items To configure querying of internal stats on another Zabbix instance, you may use two items: - `zabbix[stats,<ip>,<port>]` internal item - for direct remote queries of Zabbix server/proxy. <ip> and <port> are used to identify the target instance. - `zabbix.stats[<ip>,<port>]` agent item - for agent-based remote queries of Zabbix server/proxy. <ip> and <port> are used to identify the target instance. See also: [Internal items](/manual/config/items/itemtypes/internal), [Zabbix agent items](/manual/config/items/itemtypes/zabbix_agent) The following diagram illustrates the use of either item depending on the context. ![](../../../../assets/en/manual/appendix/items/ext_stats.png) - ![](../../../../assets/en/manual/appendix/items/green.png) - Server → external Zabbix instance (`zabbix[stats,<ip>,<port>]`) - ![](../../../../assets/en/manual/appendix/items/pink.png) - Server → proxy → external Zabbix instance (`zabbix[stats,<ip>,<port>]`) - ![](../../../../assets/en/manual/appendix/items/blue.png) - Server → agent → external Zabbix instance (`zabbix.stats[<ip>,<port>]`) - ![](../../../../assets/en/manual/appendix/items/red.png) - Server → proxy → agent → external Zabbix instance (`zabbix.stats[<ip>,<port>]`) To make sure that the target instance allows querying it by the external instance, list the address of the external instance in the 'StatsAllowedIP' parameter on the target instance. #### موارد برای پیکربندی پرس و جو از آمار داخلی در یک نمونه دیگر Zabbix، شما ممکن است از دو مورد استفاده شود: - "zabbix[stats,<ip>,<port>]" مورد داخلی - برای کنترل از راه دور مستقیم پرس و جوهای سرور/پراکسی Zabbix. <ip> و <port> استفاده می شود برای شناسایی نمونه هدف - مورد عامل `zabbix.stats[<ip>,<port>]` - برای کنترل از راه دور مبتنی بر عامل پرس و جوهای سرور/پراکسی Zabbix. <ip> و <port> استفاده می شود برای شناسایی نمونه هدف همچنین ببینید: [موارد داخلی](/دستی/تنظیم/آیتم/آیتمtypes/internal)، [اقلام عامل Zabbix](/manual/config/items/itemtypes/zabbix_agent) نمودار زیر استفاده از هر یک از موارد را بسته به این موضوع نشان می دهد زمینه ![](../../../../assets/en/manual/appendix/items/ext_stats.png) - ![](../../../../assets/en/manual/appendix/items/green.png) - سرور → نمونه خارجی Zabbix ('zabbix[stats,<ip>,<port>]') - ![](../../../../assets/en/manual/appendix/items/pink.png) - سرور → پروکسی → نمونه خارجی Zabbix ('zabbix[stats,<ip>,<port>]') - ![](../../../../assets/en/manual/appendix/items/blue.png) - سرور → عامل ← نمونه خارجی Zabbix (`zabbix.stats[<ip>,<port>]`) - ![](../../../../assets/en/manual/appendix/items/red.png) - سرور → پروکسی → عامل → نمونه خارجی Zabbix (`zabbix.stats[<ip>،<port>]`) برای اطمینان از اینکه نمونه هدف اجازه پرس و جو از آن توسط خارجی را می دهد به عنوان مثال، آدرس نمونه خارجی را در فهرست قرار دهید پارامتر 'StatsAllowedIP' در نمونه هدف. ### Item tag The item tag object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**tag**<br>(required)|string|Item tag name.| |value|string|Item tag value.| ### تگ هاست The host tag object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**tag**<br>(required)|string|Host tag name.| |value|string|Host tag value.| # item.update #ساخت Image ##### Item value The following parameters are supported if *Data* is set to "Item value". ::: noteclassic The first number in the *Thresholds* property name (e.g. columnsthresholds.color.0.0) references the column for which thresholds are configured, while the second number references threshold place in a list, sorted in ascending order. However, if thresholds are configured in a different order, the values will be sorted in ascending order after updating widget configuration in Zabbix frontend (e.g. `"threshold.threshold.0":"5"` → `"threshold.threshold.0":"1"`; `"threshold.threshold.1":"1"` → `"threshold.threshold.1": "5"`). ::: |Parameter|<|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-|--------|--|--------|-------------------------------| |*Item*|<|1 |columns.item.0|Valid item name.| |***Time shift***<br>(required)|<|1|columns.timeshift.0|Valid numeric or time string value (e.g. `3600` or `1h`).<br>You may use [time suffixes](/manual/appendix/suffixes#time-suffixes). Negative values are allowed.| |*Aggregation function*|<|0|columns.aggregate_function.0|0 - *(default)* none;<br>1 - min;<br>2 - max;<br>3 - avg;<br>4 - count;<br>5 - sum;<br>6 - first;<br>7 - last.| |*Aggregation interval*|<|1|columns.aggregate_interval.0|Valid time string (e.g. `3600`, `1h`, etc.).<br>You may use [time suffixes](/manual/appendix/suffixes#time-suffixes).<br><br>Parameter *Aggregation interval* not available if *Aggregation function* is set to *none*.<br><br>Default: `1h`.| |*Display*|<|0|columns.display.0|1 - *(default)* As is;<br>2 - Bar;<br>3 - Indicators.| |*Min*|<|1|columns.min.0|Any numeric value.<br><br>Parameter *Min* not available if *Display* is set to "As is".| |*Max*|<|1|columns.max.0|Any numeric value.<br><br>Parameter *Max* not available if *Display* is set to "As is".| |*History data*|<|0|columns.history.0|1 - *(default)* Auto;<br>2 - History;<br>3 - Trends.| |*Thresholds*|<|<|<|<| |<|*Color*|1|columnsthresholds.color.0.0|Hexadecimal color code (e.g. `FF0000`).<br><br>Default: `""` (empty).| |^|*Threshold*|1|columnsthresholds.threshold.0.0|Any string value.| ##### مقدار مورد اگر *داده* روی "مقدار مورد" تنظیم شده باشد، پارامترهای زیر پشتیبانی می شوند. ::: نوتکلاسیک اولین عدد در نام ویژگی *Thresholds* (به عنوان مثال columnsthresholds.color.0.0) به ستونی اشاره می کند که آستانه ها برای آن پیکربندی شده اند، در حالی که شماره دوم آستانه آستانه را در یک لیست به ترتیب صعودی مرتب می کند. با این حال، اگر آستانه‌ها به ترتیب دیگری پیکربندی شوند، پس از به‌روزرسانی پیکربندی ویجت در Zabbix frontend، مقادیر به ترتیب صعودی مرتب می‌شوند. (به عنوان مثال، "آستانه. آستانه.0":"5"` ← "آستانه.آستانه.0":"1"`؛ "آستانه.آستانه.1":"1"` → «آستانه.آستانه. 1": "5"`). ::: |پارامتر|<|[نوع](/manual/api/reference/dashboard/object#dashboard-widget-field)|نام|مقدار| |-|--------|--|--------|------------------------- -----| |*مورد*|<|1 |columns.item.0|نام مورد معتبر.| |***Time Shift***<br>(الزامی)|<|1|columns.timeshift.0|مقدار رشته عددی یا زمانی معتبر (به عنوان مثال `3600` یا `1h`).<br>می توانید از [ پسوندهای زمانی](/دستی/ضمیمه/پسوندهای#زمان-پسوند). مقادیر منفی مجاز است.| |*تابع تجمع*|<|0|columns.aggregate_function.0|0 - *(پیش‌فرض)* هیچکدام؛<br>1 - دقیقه؛<br>2 - حداکثر؛<br>3 - میانگین؛<br>4 - count;<br>5 - sum;<br>6 - first;<br>7 - آخرین.| |*فاصله تجمع*|<|1|columns.aggregate_interval.0|رشته زمان معتبر (مانند `3600`، `1h`، و غیره).<br>می توانید از [پسوندهای زمانی](/manual/appendix/suffixes) استفاده کنید #زمان-پسوند).<br><br>پارامتر *فاصله تجمع* اگر *عملکرد تجمع* روی *هیچ* تنظیم شده باشد در دسترس نیست.<br><br>پیش‌فرض: `1h`.| |*نمایش*|<|0|columns.display.0|1 - *(پیش فرض)* همانطور که هست؛<br>2 - نوار؛<br>3 - نشانگرها.| |*Min*|<|1|columns.min.0|هر مقدار عددی.<br><br>پارامتر *Min* در دسترس نیست اگر *نمایش* روی "همانطور که هست" تنظیم شده باشد.| |*Max*|<|1|columns.max.0|هر مقدار عددی.<br><br>پارامتر *Max* اگر *Display* روی "همانطور که هست" تنظیم شده باشد، در دسترس نیست| |*داده های سابقه*|<|0|columns.history.0|1 - *(پیش فرض)* خودکار؛<br>2 - سابقه;<br>3 - روندها.| |*آستانه*|<|<|<|<| |<|*Color*|1|columnsthresholds.color.0.0|کد رنگ هگزا دسیمال (مثلاً `FF0000`).<br><br>پیش‌فرض: `""` (خالی).| |^|*Threshold*|1|columnsthresholds.threshold.0.0|هر مقدار رشته.| ##### Kernel data |Item key|<|<|<| |--|--|------|------| |Description|Return value|Parameters|Comments| |**kernel.maxfiles**|<|<|<| |Maximum number of opened files supported by OS.|Integer| | | |**kernel.maxproc**|<|<|<| |Maximum number of processes supported by OS.|Integer| | | |**kernel.openfiles**|<|<|<| |Return the number of currently open file descriptors.|Integer| |This item is supported since Zabbix 6.0.| ##### داده های هسته |کلید مورد|<|<|<| |--|--|------|------| |توضیحات|مقدار بازگشتی|پارامترها|نظرات| |**kernel.maxfiles**|<|<|<| |حداکثر تعداد فایل های باز شده توسط سیستم عامل پشتیبانی می شود.|عدد صحیح| | | |**kernel.maxproc**|<|<|<| |حداکثر تعداد فرآیندهای پشتیبانی شده توسط سیستم عامل.|عدد صحیح| | | |**kernel.openfiles**|<|<|<| |تعداد توصیفگرهای فایل در حال حاضر باز را برگردانید.|عدد صحیح| |این مورد از Zabbix 6.0 پشتیبانی می شود.| #### Known issues To improve performance, you can convert the field types from *nclob* to *nvarchar2*, see [known issues](/manual/installation/known_issues#slow-configuration-sync-with-oracle). #### مشکلات شناخته شده برای بهبود عملکرد، می توانید انواع فیلدها را از *nclob* به *nvarchar2* تبدیل کنید، به [مشکلات شناخته شده](/manual/installation/known_issues#slow-configuration-sync-with-oracle) مراجعه کنید. #### Limitations Zabbix agent for Windows does not support non-standard Windows configurations where CPUs are distributed non-uniformly across NUMA nodes. If logical CPUs are distributed non-uniformly, then CPU performance metrics may not be available for some CPUs. For example, if there are 72 logical CPUs with 2 NUMA nodes, both nodes must have 36 CPUs each. #### محدودیت ها عامل Zabbix برای ویندوز پشتیبانی نمی کند پیکربندی های غیر استاندارد ویندوز که در آن CPU ها توزیع می شوند به طور غیر یکنواخت در سراسر گره های NUMA. اگر CPUهای منطقی توزیع شده باشند به طور غیر یکنواخت، ممکن است معیارهای عملکرد CPU برای آن در دسترس نباشد برخی از CPU ها به عنوان مثال، اگر 72 CPU منطقی با 2 گره NUMA وجود داشته باشد، هر دو گره باید 36 CPU داشته باشند. #### Link a group to templates Add host group "2" to two templates. Request: ```json { "jsonrpc": "2.0", "method": "template.massadd", "params": { "templates": [ { "templateid": "10085" }, { "templateid": "10086" } ], "groups": [ { "groupid": "2" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "templateids": [ "10085", "10086" ] }, "id": 1 } ``` #### حذف لینک تمپلیت ها Unlink and clear two templates from host. Request: ```json { "jsonrpc": "2.0", "method": "host.update", "params": { "hostid": "10126", "templates_clear": [ { "templateid": "10124" }, { "templateid": "10125" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "hostids": [ "10126" ] }, "id": 1 } ``` ##### Links Clicking on a map element opens a menu with some available links. ##### پیوندها با کلیک بر روی یک عنصر نقشه، منویی با برخی از پیوندهای موجود باز می شود. #### Link two templates to a template Link templates "10106" and "10104" to template. Request: ```json { "jsonrpc": "2.0", "method": "template.massadd", "params": { "templates": [ { "templateid": "10073" } ], "templates_link": [ { "templateid": "10106" }, { "templateid": "10104" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "templateids": [ "10073" ] }, "id": 1 } ``` #### حذف لینک تمپلیت ها Unlink and clear two templates from host. Request: ```json { "jsonrpc": "2.0", "method": "host.update", "params": { "hostid": "10126", "templates_clear": [ { "templateid": "10124" }, { "templateid": "10125" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "hostids": [ "10126" ] }, "id": 1 } ``` #### Linux See values supported for 'memtype' parameter on Linux in the table. |Supported value|Description|Source in /proc/<pid>/status file| |--|------|--| |vsize ^[1](proc_mem_notes#footnotes)^|Virtual memory size|VmSize| |pmem|Percentage of real memory|(VmRSS/total\_memory) \* 100| |rss|Resident set size|VmRSS| |data|Size of data segment|VmData| |exe|Size of code segment|VmExe| |hwm|Peak resident set size|VmHWM| |lck|Size of locked memory|VmLck| |lib|Size of shared libraries|VmLib| |peak|Peak virtual memory size|VmPeak| |pin|Size of pinned pages|VmPin| |pte|Size of page table entries|VmPTE| |size|Size of process code + data + stack segments|VmExe + VmData + VmStk| |stk|Size of stack segment|VmStk| |swap|Size of swap space used|VmSwap| Notes for Linux: 1. Not all 'memtype' values are supported by older Linux kernels. For example, Linux 2.4 kernels do not support `hwm`, `pin`, `peak`, `pte` and `swap` values. 2. We have noticed that self-monitoring of the Zabbix agent active check process with `proc.mem[...,...,...,...,data]` shows a value that is 4 kB larger than reported by `VmData` line in the agent's /proc/<pid>/status file. At the time of self-measurement the agent's data segment increases by 4 kB and then returns to the previous size. #### لینوکس مقادیر پشتیبانی شده برای پارامتر "memtype" در لینوکس را در جدول مشاهده کنید. |مقدار پشتیبانی شده|توضیحات|منبع در /proc/<pid>/فایل وضعیت| |--|------|--| |vsize ^[1](proc_mem_notes#footnotes)^|اندازه حافظه مجازی|VmSize| |pmem|درصد حافظه واقعی|(VmRSS/total\_memory) \* 100| |rss|اندازه مجموعه مقیم|VmRSS| |داده|اندازه بخش داده|VmData| |exe|اندازه قطعه کد|VmExe| |hwm|اندازه مجموعه مقیم پیک|VmHWM| |lck|اندازه حافظه قفل شده|VmLck| |lib|اندازه کتابخانه های مشترک|VmLib| |peak|حجم حافظه مجازی حداکثر|VmPeak| |پین|اندازه صفحات پین شده|VmPin| |pte|اندازه ورودی های جدول صفحه|VmPTE| |size|اندازه کد فرآیند + داده + بخش های پشته|VmExe + VmData + VmStk| |stk|اندازه قسمت پشته|VmStk| |swap|اندازه فضای مبادله استفاده شده|VmSwap| نکاتی برای لینوکس: 1. همه مقادیر "memtype" توسط هسته های قدیمی لینوکس پشتیبانی نمی شوند. برای به عنوان مثال، هسته‌های لینوکس 2.4 از «hwm»، «pin»، «peak» پشتیبانی نمی‌کنند، مقادیر "pte" و "swap". 2. ما متوجه شده ایم که خود نظارتی عامل Zabbix فعال است بررسی فرآیند با «proc.mem[...،...،...،...، داده]» یک مقدار را نشان می دهد که 4 کیلوبایت بزرگتر از خط "VmData" در عامل گزارش شده است فایل /proc/<pid>/status. در زمان خود اندازه گیری بخش داده های عامل 4 کیلوبایت افزایش می یابد و سپس به قسمت باز می گردد اندازه قبلی ### LLD macro path The LLD macro path has the following properties: |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**lld\_macro**<br>(required)|string|LLD macro.| |**path**<br>(required)|string|Selector for value which will be assigned to corresponding macro.| ### مسیر ماکرو LLD The LLD macro path has the following properties: |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**lld\_macro**<br>(required)|string|LLD macro.| |**path**<br>(required)|string|Selector for value which will be assigned to corresponding macro.| #### LLD rule filter condition The LLD rule filter condition object defines a separate check to perform on the value of an LLD macro. It has the following properties: |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**macro**<br>(required)|string|LLD macro to perform the check on.| |**value**<br>(required)|string|Value to compare with.| |formulaid|string|Arbitrary unique ID that is used to reference the condition from a custom expression. Can only contain capital-case letters. The ID must be defined by the user when modifying filter conditions, but will be generated anew when requesting them afterward.| |operator|integer|Condition operator.<br><br>Possible values:<br>8 - *(default)* matches regular expression;<br>9 - does not match regular expression;<br>12 - exists;<br>13 - does not exist.| ::: notetip To better understand how to use filters with various types of expressions, see examples on the [discoveryrule.get](get#retrieving_filter_conditions) and [discoveryrule.create](create#using_a_custom_expression_filter) method pages. ::: #### شرایط فیلتر قانون LLD The LLD rule filter condition object defines a separate check to perform on the value of an LLD macro. It has the following properties: |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**macro**<br>(required)|string|LLD macro to perform the check on.| |**value**<br>(required)|string|Value to compare with.| |formulaid|string|Arbitrary unique ID that is used to reference the condition from a custom expression. Can only contain capital-case letters. The ID must be defined by the user when modifying filter conditions, but will be generated anew when requesting them afterward.| |operator|integer|Condition operator.<br><br>Possible values:<br>8 - *(default)* matches regular expression;<br>9 - does not match regular expression;<br>12 - exists;<br>13 - does not exist.| ::: notetip To better understand how to use filters with various types of expressions, see examples on the [discoveryrule.get](get#retrieving_filter_conditions) and [discoveryrule.create](create#using_a_custom_expression_filter) method pages. ::: ### LLD rule filter The LLD rule filter object defines a set of conditions that can be used to filter discovered objects. It has the following properties: |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**conditions**<br>(required)|array|Set of filter conditions to use for filtering results.| |**evaltype**<br>(required)|integer|Filter condition evaluation method.<br><br>Possible values:<br>0 - and/or;<br>1 - and;<br>2 - or;<br>3 - custom expression.| |eval\_formula|string|*(readonly)* Generated expression that will be used for evaluating filter conditions. The expression contains IDs that reference specific filter conditions by its `formulaid`. The value of `eval_formula` is equal to the value of `formula` for filters with a custom expression.| |formula|string|User-defined expression to be used for evaluating conditions of filters with a custom expression. The expression must contain IDs that reference specific filter conditions by its `formulaid`. The IDs used in the expression must exactly match the ones defined in the filter conditions: no condition can remain unused or omitted.<br><br>Required for custom expression filters.| ### فیلتر قانون LLD شی فیلتر قانون LLD مجموعه ای از شرایط را تعریف می کند که می توان از آنها استفاده کرد برای فیلتر کردن اشیاء کشف شده دارای خواص زیر است: |مخصوص|[نوع](/manual/api/reference_commentary#data_types)|توضیحات| |--|--|------| |**شرایط**<br>(ضروری)|آرایه|مجموعه شرایط فیلتر برای استفاده برای فیلتر کردن نتایج.| |**evaltype**<br>(الزامی)|عدد صحیح|روش ارزیابی شرایط فیلتر.<br><br>مقادیر ممکن:<br>0 - و/یا;<br>1 - و;<br>2 - یا;<br>3 - عبارت سفارشی.| |eval\_formula|string|*(readonly)* عبارت ایجاد شده است که برای ارزیابی شرایط فیلتر استفاده خواهد شد. عبارت حاوی شناسه هایی است که به شرایط فیلتر خاص توسط «formulaid» خود ارجاع می دهند. مقدار 'eval_formula' برابر با مقدار 'formula' برای فیلترهایی با عبارت سفارشی است.| |formula|string|عبارت تعریف شده توسط کاربر برای ارزیابی شرایط فیلترها با عبارت سفارشی استفاده می شود. عبارت باید حاوی شناسه هایی باشد که با «formulaid» خود به شرایط فیلتر خاص ارجاع می دهند. شناسه های استفاده شده در عبارت باید دقیقاً مطابق با موارد تعریف شده در شرایط فیلتر باشد: هیچ شرطی نمی تواند بدون استفاده یا حذف شود.<br><br>برای فیلترهای عبارت سفارشی مورد نیاز است.| #### LLD rule override filter condition The LLD rule override filter condition object defines a separate check to perform on the value of an LLD macro. It has the following properties: |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**macro**<br>(required)|string|LLD macro to perform the check on.| |**value**<br>(required)|string|Value to compare with.| |formulaid|string|Arbitrary unique ID that is used to reference the condition from a custom expression. Can only contain capital-case letters. The ID must be defined by the user when modifying filter conditions, but will be generated anew when requesting them afterward.| |operator|integer|Condition operator.<br><br>Possible values:<br>8 - *(default)* matches regular expression;<br>9 - does not match regular expression;<br>12 - exists;<br>13 - does not exist.| #### شرایط فیلتر تکرار قانون LLD The LLD rule override filter condition object defines a separate check to perform on the value of an LLD macro. It has the following properties: |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**macro**<br>(required)|string|LLD macro to perform the check on.| |**value**<br>(required)|string|Value to compare with.| |formulaid|string|Arbitrary unique ID that is used to reference the condition from a custom expression. Can only contain capital-case letters. The ID must be defined by the user when modifying filter conditions, but will be generated anew when requesting them afterward.| |operator|integer|Condition operator.<br><br>Possible values:<br>8 - *(default)* matches regular expression;<br>9 - does not match regular expression;<br>12 - exists;<br>13 - does not exist.| #### LLD rule override filter The LLD rule override filter object defines a set of conditions that if they match the discovered object the override is applied. It has the following properties: |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**evaltype**<br>(required)|integer|Override filter condition evaluation method.<br><br>Possible values:<br>0 - and/or;<br>1 - and;<br>2 - or;<br>3 - custom expression.| |**conditions**<br>(required)|array|Set of override filter conditions to use for matching the discovered objects.| |eval\_formula|string|*(readonly)* Generated expression that will be used for evaluating override filter conditions. The expression contains IDs that reference specific override filter conditions by its `formulaid`. The value of `eval_formula` is equal to the value of `formula` for filters with a custom expression.| |formula|string|User-defined expression to be used for evaluating conditions of override filters with a custom expression. The expression must contain IDs that reference specific override filter conditions by its `formulaid`. The IDs used in the expression must exactly match the ones defined in the override filter conditions: no condition can remain unused or omitted.<br><br>Required for custom expression override filters.| #### فیلتر تکرار قانون LLD The LLD rule override filter object defines a set of conditions that if they match the discovered object the override is applied. It has the following properties: |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**evaltype**<br>(required)|integer|Override filter condition evaluation method.<br><br>Possible values:<br>0 - and/or;<br>1 - and;<br>2 - or;<br>3 - custom expression.| |**conditions**<br>(required)|array|Set of override filter conditions to use for matching the discovered objects.| |eval\_formula|string|*(readonly)* Generated expression that will be used for evaluating override filter conditions. The expression contains IDs that reference specific override filter conditions by its `formulaid`. The value of `eval_formula` is equal to the value of `formula` for filters with a custom expression.| |formula|string|User-defined expression to be used for evaluating conditions of override filters with a custom expression. The expression must contain IDs that reference specific override filter conditions by its `formulaid`. The IDs used in the expression must exactly match the ones defined in the override filter conditions: no condition can remain unused or omitted.<br><br>Required for custom expression override filters.| ##### LLD rule override operation discover LLD rule override operation discover status that is set to discovered object. It has the following properties: |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**discover**<br>(required)|integer|Override the discover status for selected object.<br><br>Possible values:<br>0 - Yes, continue discovering the objects;<br>1 - No, new objects will not be discovered and existing ones will be marked as lost.| ##### جست وجوی عملیات تکرار قانون LLD LLD rule override operation discover status that is set to discovered object. It has the following properties: |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**discover**<br>(required)|integer|Override the discover status for selected object.<br><br>Possible values:<br>0 - Yes, continue discovering the objects;<br>1 - No, new objects will not be discovered and existing ones will be marked as lost.| ##### LLD rule override operation history LLD rule override operation history value that is set to discovered item. It has the following properties: |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**history**<br>(required)|string|Override the history of item prototype which is a time unit of how long the history data should be stored. Also accepts user macro and LLD macro.| ##### تاریخچه عملیات تکرار قانون LLD LLD rule override operation history value that is set to discovered item. It has the following properties: |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**history**<br>(required)|string|Override the history of item prototype which is a time unit of how long the history data should be stored. Also accepts user macro and LLD macro.| ##### LLD rule override operation inventory LLD rule override operation inventory mode value that is set to discovered host. It has the following properties: |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**inventory\_mode**<br>(required)|integer|Override the host prototype inventory mode.<br><br>Possible values are:<br>-1 - disabled;<br>0 - *(default)* manual;<br>1 - automatic.| ##### پیدا کردن عملیات تکرار قانون LLD LLD rule override operation inventory mode value that is set to discovered host. It has the following properties: |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**inventory\_mode**<br>(required)|integer|Override the host prototype inventory mode.<br><br>Possible values are:<br>-1 - disabled;<br>0 - *(default)* manual;<br>1 - automatic.| ##### LLD rule override operation period LLD rule override operation period is an update interval value (supports custom intervals) that is set to discovered item. It has the following properties: |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**delay**<br>(required)|string|Override the update interval of the item prototype. Accepts seconds or a time unit with suffix (30s,1m,2h,1d) as well as flexible and scheduling intervals and user macros or LLD macros. Multiple intervals are separated by a semicolon.| ##### مدت زمان عملیات تکرار قانون LLD LLD rule override operation period is an update interval value (supports custom intervals) that is set to discovered item. It has the following properties: |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**delay**<br>(required)|string|Override the update interval of the item prototype. Accepts seconds or a time unit with suffix (30s,1m,2h,1d) as well as flexible and scheduling intervals and user macros or LLD macros. Multiple intervals are separated by a semicolon.| ##### LLD rule override operation severity LLD rule override operation severity value that is set to discovered trigger. It has the following properties: |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**severity**<br>(required)|integer|Override the severity of trigger prototype.<br><br>Possible values are: 0 - *(default)* not classified;<br>1 - information;<br>2 - warning;<br>3 - average;<br>4 - high;<br>5 - disaster.| ##### مرتبه عملیات تکرار قانون LLD LLD rule override operation severity value that is set to discovered trigger. It has the following properties: |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**severity**<br>(required)|integer|Override the severity of trigger prototype.<br><br>Possible values are: 0 - *(default)* not classified;<br>1 - information;<br>2 - warning;<br>3 - average;<br>4 - high;<br>5 - disaster.| ##### LLD rule override operation status LLD rule override operation status that is set to discovered object. It has the following properties: |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**status**<br>(required)|integer|Override the status for selected object.<br><br>Possible values:<br>0 - Create enabled;<br>1 - Create disabled.| ##### وضعیت عملیات تکرار قانون LLD LLD rule override operation status that is set to discovered object. It has the following properties: |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**status**<br>(required)|integer|Override the status for selected object.<br><br>Possible values:<br>0 - Create enabled;<br>1 - Create disabled.| ##### LLD rule override operation template LLD rule override operation template object that is linked to discovered host. It has the following properties: |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**templateid**<br>(required)|string|Override the template of host prototype linked templates.| ##### قالب عملیات تکرار قانون LLD LLD rule override operation template object that is linked to discovered host. It has the following properties: |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**templateid**<br>(required)|string|Override the template of host prototype linked templates.| #### LLD rule override operation The LLD rule override operation is combination of conditions and actions to perform on the prototype object. It has the following properties: |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**operationobject**<br>(required)|integer|Type of discovered object to perform the action.<br><br>Possible values:<br>0 - Item prototype;<br>1 - Trigger prototype;<br>2 - Graph prototype;<br>3 - Host prototype.| |operator|integer|Override condition operator.<br><br>Possible values:<br>0 - *(default)* equals;<br>1 - does not equal;<br>2 - contains;<br>3 - does not contain;<br>8 - matches;<br>9 - does not match.| |value|string|Pattern to match item, trigger, graph or host prototype name depending on selected object.| |opstatus|object|Override operation status object for item, trigger and host prototype objects.| |opdiscover|object|Override operation discover status object (all object types).| |opperiod|object|Override operation period (update interval) object for item prototype object.| |ophistory|object|Override operation history object for item prototype object.| |optrends|object|Override operation trends object for item prototype object.| |opseverity|object|Override operation severity object for trigger prototype object.| |optag|array|Override operation tag object for trigger and host prototype objects.| |optemplate|array|Override operation template object for host prototype object.| |opinventory|object|Override operation inventory object for host prototype object.| #### عملیات تکرار قانون LLD The LLD rule override operation is combination of conditions and actions to perform on the prototype object. It has the following properties: |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**operationobject**<br>(required)|integer|Type of discovered object to perform the action.<br><br>Possible values:<br>0 - Item prototype;<br>1 - Trigger prototype;<br>2 - Graph prototype;<br>3 - Host prototype.| |operator|integer|Override condition operator.<br><br>Possible values:<br>0 - *(default)* equals;<br>1 - does not equal;<br>2 - contains;<br>3 - does not contain;<br>8 - matches;<br>9 - does not match.| |value|string|Pattern to match item, trigger, graph or host prototype name depending on selected object.| |opstatus|object|Override operation status object for item, trigger and host prototype objects.| |opdiscover|object|Override operation discover status object (all object types).| |opperiod|object|Override operation period (update interval) object for item prototype object.| |ophistory|object|Override operation history object for item prototype object.| |optrends|object|Override operation trends object for item prototype object.| |opseverity|object|Override operation severity object for trigger prototype object.| |optag|array|Override operation tag object for trigger and host prototype objects.| |optemplate|array|Override operation template object for host prototype object.| |opinventory|object|Override operation inventory object for host prototype object.| ##### LLD rule override operation trends LLD rule override operation trends value that is set to discovered item. It has the following properties: |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**trends**<br>(required)|string|Override the trends of item prototype which is a time unit of how long the trends data should be stored. Also accepts user macro and LLD macro.| ##### ترند عملیات تکرار قانون LLD LLD rule override operation trends value that is set to discovered item. It has the following properties: |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**trends**<br>(required)|string|Override the trends of item prototype which is a time unit of how long the trends data should be stored. Also accepts user macro and LLD macro.| ### LLD rule overrides The LLD rule overrides object defines a set of rules (filters, conditions and operations) that are used to override properties of different prototype objects. It has the following properties: |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**name**<br>(required)|string|Unique override name.| |**step**<br>(required)|integer|Unique order number of the override.| |stop|integer|Stop processing next overrides if matches.<br><br>Possible values:<br>0 - *(default)* don't stop processing overrides;<br>1 - stop processing overrides if filter matches.| |filter|object|Override filter.| |operations|array|Override operations.| ### تکرار قانون LLD The LLD rule overrides object defines a set of rules (filters, conditions and operations) that are used to override properties of different prototype objects. It has the following properties: |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**name**<br>(required)|string|Unique override name.| |**step**<br>(required)|integer|Unique order number of the override.| |stop|integer|Stop processing next overrides if matches.<br><br>Possible values:<br>0 - *(default)* don't stop processing overrides;<br>1 - stop processing overrides if filter matches.| |filter|object|Override filter.| |operations|array|Override operations.| ##### Load on I/O Item's persistent file is updated after successful sending of every batch of data \(containing item's data\) to server. For example, default 'BufferSize' is 100. If a log item has found 70 matching records then the first 50 records will be sent in one batch, persistent file will be updated, then remaining 20 records will be sent \(maybe with some delay when more data is accumulated\) in the 2nd batch, and the persistent file will be updated again. ##### بارگذاری در I/O فایل دائمی مورد پس از ارسال موفقیت آمیز هر دسته به روز می شود داده \(حاوی داده های مورد\) به سرور. به عنوان مثال، "BufferSize" پیش فرض 100 است. اگر یک آیتم گزارش 70 رکورد منطبق پیدا کرده باشد، 50 رکورد اول در یک دسته ارسال می شود، فایل پایدار به روز می شود، سپس 20 فایل باقی می ماند سوابق \(شاید با کمی تأخیر زمانی که داده های بیشتری انباشته شد\) ارسال می شود دسته دوم، و فایل پایدار دوباره به روز می شود. #### Locale Note that the agent requires a UTF-8 locale so that some textual agent items can return the expected content. Most modern Unix-like systems have a UTF-8 locale as default, however, there are some systems where that may need to be set specifically. #### محلی توجه داشته باشید که عامل به محلی UTF-8 نیاز دارد تا برخی از عوامل متنی موارد می توانند محتوای مورد انتظار را برگردانند. اکثر سیستم های مدرن یونیکس مانند یک محلی UTF-8 به عنوان پیش فرض داشته باشید، با این حال، برخی از سیستم ها وجود دارند که در آنها وجود دارد که ممکن است نیاز به تنظیم خاص داشته باشد. #### Locale Note that the proxy requires a UTF-8 locale so that some textual items can be interpreted correctly. Most modern Unix-like systems have a UTF-8 locale as default, however, there are some systems where that may need to be set specifically. #### محلی توجه داشته باشید که عامل به محلی UTF-8 نیاز دارد تا برخی از عوامل متنی موارد می توانند محتوای مورد انتظار را برگردانند. اکثر سیستم های مدرن یونیکس مانند یک محلی UTF-8 به عنوان پیش فرض داشته باشید، با این حال، برخی از سیستم ها وجود دارند که در آنها وجود دارد که ممکن است نیاز به تنظیم خاص داشته باشد. #### Locale Note that the server requires a UTF-8 locale so that some textual items can be interpreted correctly. Most modern Unix-like systems have a UTF-8 locale as default, however, there are some systems where that may need to be set specifically. #### محلی توجه داشته باشید که عامل به محلی UTF-8 نیاز دارد تا برخی از عوامل متنی موارد می توانند محتوای مورد انتظار را برگردانند. اکثر سیستم های مدرن یونیکس مانند یک محلی UTF-8 به عنوان پیش فرض داشته باشید، با این حال، برخی از سیستم ها وجود دارند که در آنها وجود دارد که ممکن است نیاز به تنظیم خاص داشته باشد. ### Log history The log history object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |id|string|ID of the history entry.| |clock|timestamp|Time when that value was received.| |itemid|string|ID of the related item.| |logeventid|integer|Windows event log entry ID.| |ns|integer|Nanoseconds when the value was received.| |severity|integer|Windows event log entry level.| |source|string|Windows event log entry source.| |timestamp|timestamp|Windows event log entry time.| |value|text|Received value.| ### تاریخچه لاگ The log history object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |id|string|ID of the history entry.| |clock|timestamp|Time when that value was received.| |itemid|string|ID of the related item.| |logeventid|integer|Windows event log entry ID.| |ns|integer|Nanoseconds when the value was received.| |severity|integer|Windows event log entry level.| |source|string|Windows event log entry source.| |timestamp|timestamp|Windows event log entry time.| |value|text|Received value.| ### Log level control targets *process-type* All processes of specified type (active checks, collector, listener) *process-type,N* Process type and number (e.g., listener,3) *pid* Process identifier, up to 65535. For larger values specify target as "process-type,N" ```{=html} <!-- --> ``` **-p**, **--print** Print known items and exit. For each item either generic defaults are used, or specific defaults for testing are supplied. These defaults are listed in square brackets as item key parameters. Returned values are enclosed in square brackets and prefixed with the type of the returned value, separated by a pipe character. For user parameters type is always **t**, as the agent can not determine all possible return values. Items, displayed as working, are not guaranteed to work from the Zabbix server or zabbix\_get when querying a running agent daemon as permissions or environment may be different. Returned value types are: d Number with a decimal part. m Not supported. This could be caused by querying an item that only works in the active mode like a log monitoring item or an item that requires multiple collected values. Permission issues or incorrect user parameters could also result in the not supported state. s Text. Maximum length not limited. t Text. Same as **s**. u Unsigned integer. **-t**, **--test** *item-key* Test single item and exit. See **--print** for output description. **-h**, **--help** Display this help and exit. **-V**, **--version** Output version information and exit. [ ]{#lbAH} ### اهداف کنترل سطح ورود به سیستم *نوع فرآیند* همه فرآیندهای از نوع مشخص شده (چک‌های فعال، جمع‌آور، شنونده) *نوع فرآیند، N* نوع و تعداد فرآیند (به عنوان مثال، شنونده، 3) *پید* شناسه فرآیند، تا 65535. برای مقادیر بزرگتر، هدف را به عنوان مشخص کنید "نوع فرآیند، N" ```{=html} <!---> ``` **-p**، **--چاپ** موارد شناخته شده را چاپ کنید و خارج شوید. برای هر مورد یکی از پیش فرض های عمومی است استفاده می شود، یا پیش فرض های خاصی برای آزمایش ارائه شده است. این پیش فرض ها هستند در پرانتز به عنوان پارامترهای کلیدی آیتم فهرست شده است. مقادیر برگشتی هستند محصور در پرانتز مربع و پیشوند با نوع بازگشتی مقدار، با یک کاراکتر لوله جدا شده است. برای پارامترهای کاربر نوع همیشه است **t**، زیرا عامل نمی تواند تمام مقادیر بازگشتی ممکن را تعیین کند. موارد، نمایش داده شده به عنوان کار، تضمین نمی شود که از سرور Zabbix کار کند یا zabbix\_get در هنگام پرس و جو از یک daemon عامل در حال اجرا به عنوان مجوز یا محیط ممکن است متفاوت باشد انواع ارزش برگشتی عبارتند از: د عدد با قسمت اعشاری. متر پشتیبانی نشده. این ممکن است به دلیل پرس و جو از موردی باشد که فقط کار می کند در حالت فعال مانند یک آیتم نظارت بر گزارش یا موردی که نیاز دارد چندین مقادیر جمع آوری شده مشکلات مجوز یا کاربر نادرست پارامترها همچنین می توانند منجر به حالت پشتیبانی نشده شوند. س متن حداکثر طول محدود نیست. تی متن همان **s**. تو عدد صحیح بدون علامت **-t**، **--تست** *کلید مورد* یک مورد را تست کنید و از آن خارج شوید. برای توضیحات خروجی **--print** را ببینید. **-h**، **--راهنما** این راهنما را نمایش دهید و از آن خارج شوید. **-V**، **--نسخه** اطلاعات نسخه خروجی و خروج. [ ]{#lbAH} ###### Log request A request sent by a plugin to write a log message into the agent log file. | | | |---|---| |direction|plugin → agent| |response|no| Parameters specific to log requests: |Name|Type|Comments| |---------|--------|----------| |severity|uint32|The message severity (log level).| |message|string|The message to log.| *Example:* {"id":0,"type":1,"severity":3,"message":"message"} ###### درخواست ثبت نام یک درخواست ارسال شده توسط یک افزونه برای نوشتن یک پیام گزارش در فایل لاگ عامل. | | | |---|---| |جهت|پلاگین → عامل| |پاسخ|نه| پارامترهای خاص درخواست های لاگ: |نام|نوع|نظر| |---------|--------|----------| |severity|uint32|شدت پیام (سطح ورود).| |پیام|رشته|پیام برای ورود.| *مثال:* {"id":0,"type":1,"severity":3,"message":"message"} #### Low-level discovery In a [low-level discovery rule](/manual/discovery/low_level_discovery#configuring_low-level_discovery), user macros can be used in the following fields: |Location|<|Multiple macros/mix with text^[1](supported_by_location_user#footnotes)^| |-|------------------------------|----------| |Key parameters|<|yes| |Update interval|<|no| |Custom interval|<|no| |Keep lost resources period|<|no| |Description|<|yes| |*SNMP agent*|<|<| | |SNMP OID|yes| |*SSH agent*|<|<| | |Username|yes| |^|Public key file|yes| |^|Private key file|yes| |^|Password|yes| |^|Script|yes| |*TELNET agent*|<|<| | |Username|yes| |^|Password|yes| |^|Script|yes| |*Zabbix trapper*|<|<| | |Allowed hosts|yes| |*Database monitor*|<|<| | |Username|yes| |^|Password|yes| |^|SQL query|yes| |*JMX agent*|<|<| | |JMX endpoint|yes| |*HTTP agent*|<|<| | |URL^[3](supported_by_location_user#footnotes)^|yes| |^|Query fields|yes| |^|Timeout|no| |^|Request body|yes| |^|Headers (names and values)|yes| |^|Required status codes|yes| |^|HTTP authentication username|yes| |^|HTTP authentication password|yes| |*Filters*|<|<| | |Regular expression|yes| |*Overrides*|<|<| | |Filters: regular expression|yes| |^|Operations: update interval (for item prototypes)|no| |^|Operations: history storage period (for item prototypes)|no| |^|Operations: trend storage period (for item prototypes)|no| #### کشف سطح پایین در یک [کشف سطح پایین rule](/manual/discovery/low_level_discovery#configuring_low-level_discovery)، ماکروهای کاربر را می توان در فیلدهای زیر استفاده کرد: |موقعیت|<|چند ماکرو/میکس با متن^[1](پشتیبانی_شده توسط_location_user#footnotes)^| |-|-----------------------------|----------| |پارامترهای کلیدی|<|بله| |فاصله به روز رسانی|<|نه| |فاصله سفارشی|<|نه| |نگه داشتن دوره منابع از دست رفته|<|نه| |توضیحات|<|بله| |*عامل SNMP*|<|<| | |SNMP OID|بله| |*عامل SSH*|<|<| | |نام کاربری|بله| |^|فایل کلید عمومی|بله| |^|فایل کلید خصوصی|بله| |^|رمز عبور|بله| |^|اسکریپت|بله| |*نماینده TELNET*|<|<| | |نام کاربری|بله| |^|رمز عبور|بله| |^|اسکریپت|بله| |*تله زن زبیکس*|<|<| | | میزبان های مجاز|بله| |*مانیتور پایگاه داده*|<|<| | |نام کاربری|بله| |^|رمز عبور|بله| |^|پرس و جوی SQL|بله| |*عامل JMX*|<|<| | |نقطه پایانی JMX|بله| |*عامل HTTP*|<|<| | |URL^[3](پشتیبانی شده توسط_location_user#footnotes)^|بله| |^|فیلدهای پرس و جو|بله| |^|تایم پایان|نه| |^| بدنه درخواست|بله| |^|سرصفحه ها (نام ها و مقادیر)|بله| |^|کدهای وضعیت مورد نیاز|بله| |^|نام کاربری احراز هویت HTTP|بله| |^|گذرواژه احراز هویت HTTP|بله| |*فیلترها*|<|<| | |بیان منظم|بله| |*لغو*|<|<| | |فیلترها: عبارت منظم|بله| |^|عملیات: فاصله زمانی به روز رسانی (برای نمونه های اولیه)|خیر| |^|عملیات: دوره ذخیره تاریخچه (برای نمونه های اولیه)|نه| |^|عملیات: دوره ذخیره سازی روند (برای نمونه های اولیه)|نه| # maintenance.create # maintenance.create # maintenance.delete # maintenance.create # maintenance.get # maintenance.create # maintenance.update # maintenance.create **Mandatory and optional parameters** Parameters without angle brackets are mandatory. Parameters marked with angle brackets **<** **>** are optional. **Usage with command-line utilities** Note that when testing or using item keys with zabbix_agentd or zabbix_get from the command line you should consider shell syntax too. For example, if a certain parameter of the key has to be enclosed in double quotes you have to explicitly escape double quotes, otherwise they will be trimmed by the shell as special characters and will not be passed to the Zabbix utility. Examples: zabbix_agentd -t 'vfs.dir.count[/var/log,,,"file,dir",,0]' zabbix_agentd -t vfs.dir.count[/var/log,,,\"file,dir\",,0] **پارامترهای اجباری و اختیاری** پارامترهای بدون براکت زاویه اجباری است. پارامترهای مشخص شده با براکت های زاویه *** *** اختیاری هستند. **استفاده با ابزارهای خط فرمان** توجه داشته باشید که هنگام تست یا استفاده از کلیدهای مورد با zabbix_agentd یا zabbix_get از خط فرمان باید سینتکس پوسته را نیز در نظر بگیرید. به عنوان مثال، اگر پارامتر خاصی از کلید باید در دو گیومه قرار گیرد شما باید به صراحت از نقل قول های دوگانه فرار کنید، در غیر این صورت آنها توسط پوسته کوتاه می شوند به عنوان کاراکترهای خاص و به ابزار Zabbix منتقل نمی شود. مثال ها: zabbix_agentd -t 'vfs.dir.count[/var/log,,,'file,dir',,0]' zabbix_agentd -t vfs.dir.count[/var/log,,,\"file,dir\",,0] # map.create # sla.create # map.delete # حذف گراف #### Map lines Create a map line. Request: ```json { "jsonrpc": "2.0", "method": "map.create", "params": { "name": "Map API lines", "width": 500, "height": 500, "lines": [ { "x1": 30, "y1": 10, "x2": 100, "y2": 50, "line_type": 1, "line_width": 10, "line_color": "009900" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "sysmapids": [ "11" ] }, "id": 1 } ``` #### ساخت گراف Create a graph with two items. Request: ```json { "jsonrpc": "2.0", "method": "graph.create", "params": { "name": "MySQL bandwidth", "width": 900, "height": 200, "gitems": [ { "itemid": "22828", "color": "00AA00" }, { "itemid": "22829", "color": "3333FF" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "graphids": [ "652" ] }, "id": 1 } ``` #### Map listing ![](../../../../../assets/en/manual/web_interface/map_list.png){width="600"} Displayed data: |Column|Description| |--|--------| |*Name*|Name of the map. Click on the name to [view](/manual/web_interface/frontend_sections/monitoring/maps#viewing_maps) the map.| |*Width*|Map width is displayed.| |*Height*|Map height is displayed.| |*Actions*|Two actions are available:<br>**Properties** - edit general map [properties](/manual/config/visualization/maps/map#creating_a_map)<br>**Constructor** - access the grid for adding [map elements](/manual/config/visualization/maps/map#adding_elements)| To [configure](/manual/config/visualization/maps/map#creating_a_map) a new map, click on the *Create map* button in the top right-hand corner. To import a map from a YAML, XML, or JSON file, click on the *Import* button in the top right-hand corner. The user who imports the map will be set as its owner. Two buttons below the list offer some mass-editing options: - *Export* - export the maps to a YAML, XML, or JSON file - *Delete* - delete the maps To use these options, mark the checkboxes before the respective maps, then click on the required button. #### فهرست نقشه ![](../../../../../assets/en/manual/web_interface/map_list.png){width="600"} داده های نمایش داده شده: |ستون|توضیحات| |--|--------| |*نام*|نام نقشه. برای [مشاهده](/manual/web_interface/frontend_sections/monitoring/maps#viewing_maps) روی نام کلیک کنید.| |*عرض*|عرض نقشه نمایش داده می شود.| |*ارتفاع*|ارتفاع نقشه نمایش داده می شود.| |*عملیات*|دو عملکرد موجود است:<br>**خواص** - ویرایش نقشه کلی [خواص](/manual/config/visualization/maps/map#creating_a_map)<br>**Constructor** - دسترسی به شبکه برای افزودن [عناصر نقشه](/manual/config/visualization/maps/map#adding_elements)| برای [پیکربندی](/manual/config/visualization/maps/map#creating_a_map) نقشه جدید، روی دکمه *ایجاد نقشه* در گوشه بالا سمت راست کلیک کنید. برای وارد کردن نقشه از یک فایل YAML، XML یا JSON، روی *وارد کردن* کلیک کنید. دکمه در گوشه بالا سمت راست کاربری که نقشه را وارد می کند به عنوان مالک آن تعیین شود. دو دکمه در زیر لیست گزینه‌های ویرایش انبوه را ارائه می‌دهند: - *صادرات* - نقشه ها را به یک فایل YAML، XML یا JSON صادر کنید - *حذف* - نقشه ها را حذف کنید برای استفاده از این گزینه ها، چک باکس ها را قبل از نقشه های مربوطه علامت بزنید. سپس بر روی دکمه مورد نیاز کلیک کنید. #### Map shapes Create a map with map name title. Request: ```json { "jsonrpc": "2.0", "method": "map.create", "params": { "name": "Host map", "width": 600, "height": 600, "shapes": [ { "type": 0, "x": 0, "y": 0, "width": 600, "height": 11, "text": "{MAP.NAME}" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "sysmapids": [ "10" ] }, "id": 1 } ``` #### ساخت گراف Create a graph with two items. Request: ```json { "jsonrpc": "2.0", "method": "graph.create", "params": { "name": "MySQL bandwidth", "width": 900, "height": 200, "gitems": [ { "itemid": "22828", "color": "00AA00" }, { "itemid": "22829", "color": "3333FF" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "graphids": [ "652" ] }, "id": 1 } ``` #### Map sharing Create a map with two types of sharing (user and user group). Request: ```json { "jsonrpc": "2.0", "method": "map.create", "params": { "name": "Map sharing", "width": 600, "height": 600, "users": [ { "userid": "4", "permission": "3" } ], "userGroups": [ { "usrgrpid": "7", "permission": "2" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "sysmapids": [ "9" ] }, "id": 1 } ``` #### ساخت گراف Create a graph with two items. Request: ```json { "jsonrpc": "2.0", "method": "graph.create", "params": { "name": "MySQL bandwidth", "width": 900, "height": 200, "gitems": [ { "itemid": "22828", "color": "00AA00" }, { "itemid": "22829", "color": "3333FF" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "graphids": [ "652" ] }, "id": 1 } ``` ##### Mass editing options Buttons below the list offer some mass-editing options: - *Mass update* - update the selected problems by navigating to the [problem update](/manual/acknowledges#updating_problems) screen To use this option, mark the checkboxes before the respective problems, then click on the *Mass update* button. ##### گزینه های ویرایش انبوه دکمه‌های زیر فهرست گزینه‌های ویرایش انبوه را ارائه می‌کنند: - *به روز رسانی انبوه* - مشکلات انتخاب شده را با پیمایش به به روز رسانی کنید صفحه [به روز رسانی مشکل] (/دستی/تأیید#مشکلات_به روز رسانی) برای استفاده از این گزینه، چک باکس ها را قبل از مشکلات مربوطه علامت بزنید. سپس روی دکمه *Mass update* کلیک کنید. # mediatype.create #ساخت Image # mediatype.update #ساخت Image #### Migration with running server * Export current history, import it to the temp table, then insert the data into new tables while ignoring duplicates: ``` {.sql} \copy history_old TO '/tmp/history.csv' DELIMITER ',' CSV CREATE TEMP TABLE temp_history ( itemid bigint NOT NULL, clock integer DEFAULT '0' NOT NULL, value DOUBLE PRECISION DEFAULT '0.0000' NOT NULL, ns integer DEFAULT '0' NOT NULL ); \copy temp_history FROM '/tmp/history.csv' DELIMITER ',' CSV INSERT INTO history SELECT * FROM temp_history ON CONFLICT (itemid,clock,ns) DO NOTHING; \copy history_uint_old TO '/tmp/history_uint.csv' DELIMITER ',' CSV CREATE TEMP TABLE temp_history_uint ( itemid bigint NOT NULL, clock integer DEFAULT '0' NOT NULL, value numeric(20) DEFAULT '0' NOT NULL, ns integer DEFAULT '0' NOT NULL ); \copy temp_history_uint FROM '/tmp/history_uint.csv' DELIMITER ',' CSV INSERT INTO history_uint SELECT * FROM temp_history_uint ON CONFLICT (itemid,clock,ns) DO NOTHING; \copy history_str_old TO '/tmp/history_str.csv' DELIMITER ',' CSV CREATE TEMP TABLE temp_history_str ( itemid bigint NOT NULL, clock integer DEFAULT '0' NOT NULL, value varchar(255) DEFAULT '' NOT NULL, ns integer DEFAULT '0' NOT NULL ); \copy temp_history_str FROM '/tmp/history_str.csv' DELIMITER ',' CSV INSERT INTO history_str (itemid,clock,value,ns) SELECT * FROM temp_history_str ON CONFLICT (itemid,clock,ns) DO NOTHING; \copy history_log_old TO '/tmp/history_log.csv' DELIMITER ',' CSV CREATE TEMP TABLE temp_history_log ( itemid bigint NOT NULL, clock integer DEFAULT '0' NOT NULL, timestamp integer DEFAULT '0' NOT NULL, source varchar(64) DEFAULT '' NOT NULL, severity integer DEFAULT '0' NOT NULL, value text DEFAULT '' NOT NULL, logeventid integer DEFAULT '0' NOT NULL, ns integer DEFAULT '0' NOT NULL ); \copy temp_history_log FROM '/tmp/history_log.csv' DELIMITER ',' CSV INSERT INTO history_log SELECT * FROM temp_history_log ON CONFLICT (itemid,clock,ns) DO NOTHING; \copy history_text_old TO '/tmp/history_text.csv' DELIMITER ',' CSV CREATE TEMP TABLE temp_history_text ( itemid bigint NOT NULL, clock integer DEFAULT '0' NOT NULL, value text DEFAULT '' NOT NULL, ns integer DEFAULT '0' NOT NULL ); \copy temp_history_text FROM '/tmp/history_text.csv' DELIMITER ',' CSV INSERT INTO history_text SELECT * FROM temp_history_text ON CONFLICT (itemid,clock,ns) DO NOTHING; ``` * Follow [post-migration instructions](#post-migration) to drop the old tables. #### مهاجرت با سرور در حال اجرا * تاریخچه فعلی را صادر کنید، آن را به جدول موقت وارد کنید، سپس داده ها را در جداول جدید وارد کنید و در عین حال موارد تکراری را نادیده بگیرید: ``` {.sql} \copy history_old TO '/tmp/history.csv' DELIMITER ',' CSV CREATE TABLE TEMP temp_history ( مورد بیگنت NOT NULL، عدد صحیح ساعت پیش فرض '0' NOT NULL، مقدار DOUBLE PRECISION DEFAULT '0.0000' NOT NULL، ns عدد صحیح پیش فرض '0' NOT NULL ) \کپی temp_history FROM '/tmp/history.csv' DELIMITER '،' CSV INSERT INTO history SELECT * FROM temp_history ON CONFLICT (itemid,clock,ns) هیچ کاری نکنید. \copy history_uint_old TO '/tmp/history_uint.csv' DELIMITER ',' CSV CREATE TABLE TEMP temp_history_uint ( مورد بیگنت NOT NULL، عدد صحیح ساعت پیش فرض '0' NOT NULL، مقدار عددی (20) پیش فرض '0' NOT NULL، ns عدد صحیح پیش فرض '0' NOT NULL ) \copy temp_history_uint FROM '/tmp/history_uint.csv' DELIMITER '،' CSV INSERT INTO history_uint SELECT * FROM temp_history_uint ON CONFLICT (itemid,clock,ns) هیچ کاری نکنید. \copy history_str_old TO '/tmp/history_str.csv' DELIMITER '،' CSV CREATE TABLE TEMP temp_history_str ( مورد بیگنت NOT NULL، عدد صحیح ساعت پیش فرض '0' NOT NULL، مقدار varchar(255) DEFAULT '' NOT NULL, ns عدد صحیح پیش فرض '0' NOT NULL ) \copy temp_history_str FROM '/tmp/history_str.csv' DELIMITER '،' CSV INSERT INTO history_str (itemid,clock,value,ns) SELECT * FROM temp_history_str ON CONFLICT (itemid,clock,ns) هیچ کاری نکنید. \copy history_log_old TO '/tmp/history_log.csv' DELIMITER '،' CSV CREATE TABLE TEMP temp_history_log ( مورد بیگنت NOT NULL، عدد صحیح ساعت پیش فرض '0' NOT NULL، مهر زمان عدد صحیح پیش فرض '0' NOT NULL، منبع varchar(64) DEFAULT '' NOT NULL, شدت عدد صحیح پیش فرض '0' NOT NULL، متن مقدار DEFAULT '' NOT NULL، عدد صحیح logeventid DEFAULT '0' NOT NULL، ns عدد صحیح پیش فرض '0' NOT NULL ) \copy temp_history_log FROM '/tmp/history_log.csv' DELIMITER '،' CSV INSERT INTO history_log SELECT * FROM temp_history_log ON CONFLICT (itemid,clock,ns) هیچ کاری نکنید. \copy history_text_old TO '/tmp/history_text.csv' DELIMITER ',' CSV CREATE TABLE TEMP temp_history_text ( مورد بیگنت NOT NULL، عدد صحیح ساعت پیش فرض '0' NOT NULL، متن مقدار DEFAULT '' NOT NULL، ns عدد صحیح پیش فرض '0' NOT NULL ) \copy temp_history_text FROM '/tmp/history_text.csv' DELIMITER '،' CSV INSERT INTO history_text SELECT * FROM temp_history_text ON CONFLICT (itemid,clock,ns) هیچ کاری نکنید. ``` * [دستورالعمل‌های پس از مهاجرت] (#post-migration) را برای حذف جداول قدیمی دنبال کنید. #### Miscellaneous The *Clear history* button located in *Configuration* → *Hosts* → [*Items*](/manual/web_interface/frontend_sections/configuration/hosts/items#mass-editing-options) has been renamed *Clear history and trends* to more accurately describe its function, which is the same as the *Clear history and trends* button in the item [configuration form](/manual/config/items/item). #### متفرقه دکمه *Clear history* واقع در *Configuration* → *Hosts* → [*Items*](/manual/web_interface/frontend_sections/configuration/hosts/items# mass-editing-options) به *Clear history and trends* تغییر نام داد. برای توصیف دقیق‌تر عملکرد آن، که مانند دکمه *پاک کردن تاریخچه و روندها* در آیتم [فرم پیکربندی](/manual/config/items/item) است. #### Mismatch counting Count the number of hosts whose names do not contain the substring "ubuntu" Request: ```json { "jsonrpc": "2.0", "method": "host.get", "params": { "countOutput": true, "search": { "host": "ubuntu" }, "excludeSearch": true }, "auth": "766b71ee543230a1182ca5c44d353e36", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": "44", "id": 1 } ``` #### شمارش اشتباه : شمارش تعداد هاست هایی که نام آن ها شامل "ubuntu" نمی باشد . Request: ```json { "jsonrpc": "2.0", "method": "host.get", "params": { "countOutput": true, "search": { "host": "ubuntu" }, "excludeSearch": true }, "auth": "766b71ee543230a1182ca5c44d353e36", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": "44", "id": 1 } ``` #### MySQL configuration Set MySQL CE server configuration option (*/etc/my.cnf.d/server-tls.cnf*) to: [mysqld] ... # in this examples keys are located in the MySQL CE datadir directory ssl_ca=ca.pem ssl_cert=server-cert.pem ssl_key=server-key.pem require_secure_transport=ON tls_version=TLSv1.3 ... Keys for the MySQL CE server and client (Zabbix frontend) should be created manually according to the MySQL CE documentation: [Creating SSL and RSA certificates and keys using MySQL](https://dev.mysql.com/doc/refman/8.0/en/creating-ssl-rsa-files-using-mysql.html) or [Creating SSL certificates and keys using openssl](https://dev.mysql.com/doc/refman/5.7/en/creating-ssl-files-using-openssl.html) ::: noteimportant MySQL server certificate should contain the Common Name field set to the FQDN name as Zabbix frontend will use the DNS name to communicate with the database or IP address of the database host. ::: Create MySQL user: mysql> CREATE USER 'zbx_srv'@'%' IDENTIFIED WITH mysql_native_password BY '<strong_password>', 'zbx_web'@'%' IDENTIFIED WITH mysql_native_password BY '<strong_password>' REQUIRE X509 PASSWORD HISTORY 5; Check if it is possible to log in with that user: mysql -u zbx_web -p -h 10.211.55.9 --ssl-mode=VERIFY_IDENTITY --ssl-ca=/var/lib/mysql/ca.pem --ssl-cert=/var/lib/mysql/client-cert.pem --ssl-key=/var/lib/mysql/client-key.pem #### پیکربندی MySQL گزینه پیکربندی سرور MySQL CE را تنظیم کنید (*/etc/my.cnf.d/server-tls.cnf*) به: [mysqld] ... # در این مثال کلیدها در فهرست راهنمای MySQL CE datadir قرار دارند ssl_ca=ca.pem ssl_cert=server-cert.pem ssl_key=server-key.pem require_secure_transport=روشن tls_version=TLSv1.3 ... کلیدهای سرور MySQL CE و کلاینت (جلوهای Zabbix) باید باشند به صورت دستی مطابق با اسناد MySQL CE ایجاد شده است: [ایجاد SSL و گواهینامه ها و کلیدهای RSA با استفاده از MySQL](https://dev.mysql.com/doc/refman/8.0/en/creating-ssl-rsa-files-using-mysql.html) یا [ایجاد گواهینامه ها و کلیدهای SSL با استفاده از openssl](https://dev.mysql.com/doc/refman/5.7/en/creating-ssl-files-using-openssl.html) ::: نکته مهم گواهی سرور MySQL باید حاوی فیلد Common Name روی نام FQDN تنظیم شده است که زاببیکس از آن استفاده خواهد کرد نام DNS برای ارتباط با پایگاه داده یا آدرس IP پایگاه داده میزبان. ::: ایجاد کاربر MySQL: mysql> ایجاد کاربر 'zbx_srv'@'%' با mysql_native_password توسط '<strong_password>' شناسایی شد، 'zbx_web'@'%' با mysql_native_password توسط '<strong_password>' شناسایی شد به X509 نیاز دارید تاریخچه رمز عبور 5; بررسی کنید که آیا امکان ورود با آن کاربر وجود دارد یا خیر: mysql -u zbx_web -p -h 10.211.55.9 --ssl-mode=VERIFY_IDENTITY --ssl-ca=/var/lib/mysql/ca.pem --ssl-cert=/var/lib/mysql/client-cert .pem --ssl-key=/var/lib/mysql/client-key.pem ### MySQL Export and import must be performed in tmux/screen to ensure that the session isn't dropped. See also: [Important notes](#important-notes) ### MySQL صادرات و واردات باید در tmux/screen انجام شود تا اطمینان حاصل شود که جلسه حذف نشده است. همچنین ببینید: [یادداشت های مهم] (#important-notes) ## NAME zabbix\_agent2 - Zabbix agent 2\ \ [ ]{#lbAC} ## نام zabbix\_agent2 - Zabbix agent 2\ \ [ ]{#lbAC} ## NAME zabbix\_agentd - Zabbix agent daemon [ ]{#lbAC} ایجنت زبیکس -سرویس ایجنت زبیکس ## NAME zabbix\_get - Zabbix get utility [ ]{#lbAC} ## نام دستور zabbix\_get - ابزار دریافت مقادیر Zabbix [ ]{#lbAC} ## NAME zabbix\_js - Zabbix JS utility [ ]{#lbAC} ## نام zabbix\_js - ابزار Zabbix JS [ ]{#lbAC} ## NAME zabbix\_proxy - Zabbix proxy daemon [ ]{#lbAC} ## نام zabbix\_js - ابزار Zabbix JS [ ]{#lbAC} ## NAME zabbix\_sender - Zabbix sender utility [ ]{#lbAC} ## نام zabbix\_sender - ابزار ارسال کننده Zabbix [ ]{#lbAC} ## NAME zabbix\_server - Zabbix server daemon [ ]{#lbAC} ## نام zabbix\_server - دیمون سرور Zabbix [ ]{#lbAC} ## NAME zabbix\_web\_service - Zabbix web service [ ]{#lbAC} ## نام zabbix\_web\_service - وب سرویس Zabbix [ ]{#lbAC} ##### Naming and location of persistent files Zabbix agent distinguishes active checks by their keys. For example, logrt\[/home/zabbix/test.log\] and logrt\[/home/zabbix/test.log,\] are different items. Modifying the item logrt\[/home/zabbix/test.log,,,10\] in frontend to logrt\[/home/zabbix/test.log,,,20\] will result in deleting the item logrt[/home/zabbix/test.log,,,10] from the agent's list of active checks and creating logrt\[/home/zabbix/test.log,,,20\] item \(some attributes are carried across modification in frontend/server, not in agent\). The file name is composed of MD5 sum of item key with item key length appended to reduce possibility of collisions. For example, the state of logrt\[/home/zabbix50/test.log,,,,,,,,/home/zabbix50/agent_private\] item will be kept in persistent file c963ade4008054813bbc0a650bb8e09266. Multiple log items can use the same value of **persistent\_dir**. **persistent\_dir** is specified by taking into account specific file system layouts, mount points and mount options and storage mirroring configuration - the persistent file should be on the same mirrored filesystem as the monitored log file. If **persistent\_dir** directory cannot be created or does not exist, or access rights for Zabbix agent does not allow to create/write/read/delete files the log item becomes NOTSUPPORTED. ##### نام‌گذاری و مکان فایل‌های ماندگار عامل Zabbix چک های فعال را با کلید آنها متمایز می کند. مثلا، logrt\[/home/zabbix/test.log\] و logrt\[/home/zabbix/test.log،\] هستند آیتم های مختلف تغییر مورد logrt\[/home/zabbix/test.log,,,10\] در frontend به logrt\[/home/zabbix/test.log,,,20\] منجر به حذف مورد logrt[/home/zabbix/test.log,,,10] از لیست چک های فعال نماینده و ایجاد logrt\[/home/zabbix/test.log,,,20\] مورد \(برخی از ویژگیها در میان اصلاحات در frontend/server انجام می شود، نه در agent\). نام فایل از مجموع MD5 کلید آیتم با طول کلید آیتم ضمیمه شده تشکیل شده است برای کاهش احتمال برخورد به عنوان مثال، وضعیت logrt\[/home/zabbix50/test.log,,,,,,,,/home/zabbix50/agent_private\] مورد خواهد بود در فایل دائمی c963ade4008054813bbc0a650bb8e09266 نگهداری شود. چندین آیتم گزارش می توانند از همان مقدار **persistent\_dir** استفاده کنند. **persistent\_dir** با در نظر گرفتن سیستم فایل خاص مشخص می شود طرح‌بندی‌ها، نقاط نصب و گزینه‌های نصب و پیکربندی انعکاسی ذخیره‌سازی - فایل پایدار باید در همان سیستم فایل آینه‌ای مانند فایل نظارت شده باشد ورود به سیستم فایل. اگر دایرکتوری **persistent\_dir** نمی تواند ایجاد شود یا وجود نداشته باشد یا دسترسی داشته باشید حقوق عامل Zabbix اجازه ایجاد/نوشتن/خواندن/حذف فایل ها را نمی دهد مورد ورود به سیستم NOTSUPPORTED می شود. #### Negative problem duration It is actually possible in some common situations to have negative problem duration i.e. when the problem resolution time is earlier than problem creation time, e. g.: - If some host is monitored by proxy and a network error happens, leading to no data received from the proxy for a while, the nodata(/host/key) trigger will be fired by the server. When the connection is restored, the server will receive item data from the proxy having a time from the past. Then, the nodata(/host/key) problem will be resolved and it will have a negative problem duration; - When item data that resolve the problem event are sent by Zabbix sender and contain a timestamp earlier than the problem creation time, a negative problem duration will also be displayed. ::: noteclassic Negative problem duration is not affecting [SLA calculation](/manual/it_services) or [Availability report](/manual/web_interface/frontend_sections/reports/availability) of a particular trigger in any way; it neither reduces nor expands problem time. ::: #### مدت زمان مشکل منفی در واقع ممکن است در برخی از موقعیت های رایج منفی باشد مدت زمان مشکل یعنی زمانی که زمان حل مشکل زودتر از آن است زمان ایجاد مشکل، e. g.: - اگر برخی از هاست ها توسط پروکسی نظارت شود و خطای شبکه رخ دهد، منجر به عدم دریافت اطلاعات از پروکسی برای مدتی، تریگر nodata(/host/key) توسط سرور فعال می شود. وقتی که اتصال بازیابی می شود، سرور داده های مورد را از پروکسی که زمانی از گذشته دارد. سپس، nodata (/host/key) مشکل حل خواهد شد و مشکل منفی خواهد داشت مدت زمان؛ - هنگامی که داده های موردی که رویداد مشکل را حل می کند توسط Zabbix ارسال می شود فرستنده و حاوی یک مهر زمانی زودتر از ایجاد مشکل است زمان، مدت زمان مشکل منفی نیز نمایش داده خواهد شد. ::: نوتکلاسیک طول مدت مشکل منفی بر [SLA محاسبه](/دستی/it_services) یا [در دسترس بودن گزارش](/دستی/web_interface/frontend_sections/reports/availability) از یک محرک خاص به هر نحوی؛ نه مشکل را کاهش می دهد و نه گسترش می دهد زمان. ::: #### Net service name Since Zabbix 5.4.0 it is possible to connect to Oracle by using net service name. <net\_service\_name> is a simple name for a service that resolves to a connect descriptor. In order to use the service name for creating a connection, this service name has to be defined in the tnsnames.ora file located on both the database server and the client systems. The easiest way to make sure that the connection will succeed is to define the location of tnsnames.ora file in the TNS\_ADMIN environment variable. The default location of the tnsnames.ora file is: $ORACLE_HOME/network/admin/ A simple tnsnames.ora file example: ORCL = (DESCRIPTION = (ADDRESS = (PROTOCOL = TCP)(HOST = localhost)(PORT = 1521)) (CONNECT_DATA = (SERVER = DEDICATED) (SERVICE_NAME = ORCL) ) ) To set configuration parameters for the "Net Service Name" connection method, use one of the following options: - Set an empty parameter DBHost and set DBName as usual: ```{=html} <!-- --> ``` DBHost= DBName=ORCL - Set both parameters and leave both empty: ```{=html} <!-- --> ``` DBHost= DBName= In the second case, the TWO\_TASK environment variable has to be set. It specifies the default remote Oracle service (service name). When this variable is defined, the connector connects to the specified database by using an Oracle listener that accepts connection requests. This variable is for use on Linux and UNIX only. Use the LOCAL environment variable for Microsoft Windows. **Example:** Connect to a database using Net Service Name set as ORCL and the default port. Database parameters set in the server or proxy configuration file (zabbix\_server.conf and zabbix\_proxy.conf): DBHost= #DBPort= DBUser=myusername DBName=ORCL DBPassword=mypassword During Zabbix frontend installation, set the corresponding parameters in the *Configure DB connection* step of the setup wizard: - Database host: - Database port: 0 - Database name: ORCL - User: myusername - Password: mypassword ![](../../../../assets/en/manual/appendix/install/oracle_service_name.png){width="600"} Alternatively, these parameters can be set in the frontend configuration file (zabbix.conf.php): $DB["TYPE"] = 'ORACLE'; $DB["SERVER"] = ''; $DB["PORT"] = '0'; $DB["DATABASE"] = 'ORCL'; $DB["USER"] = 'myusername'; $DB["PASSWORD"] = 'mypassword'; Connection string used by Zabbix to establish connection: DBUser/DBPassword@ORCL #### نام سرویس Net از Zabbix 5.4.0 امکان اتصال به Oracle با استفاده از net وجود دارد نام سرویس <net\_service\_name> یک نام ساده برای سرویسی است که حل می شود به یک توصیفگر اتصال به منظور استفاده از نام سرویس برای ایجاد یک اتصال، این سرویس نام باید در فایل tnsnames.ora که در هر دو قرار دارد، تعریف شود سرور پایگاه داده و سیستم های مشتری ساده ترین راه برای اطمینان که اتصال موفق خواهد شد برای تعریف مکان است فایل tnsnames.ora در متغیر محیطی TNS\_ADMIN. به طور پیش فرض محل فایل tnsnames.ora است: $ORACLE_HOME/network/admin/ یک مثال ساده از فایل tnsnames.ora: ORCL = (توضیح = (آدرس = (پروتوکل = TCP) (HOST = میزبان محلی) (پورت = 1521)) (CONNECT_DATA = (سرور = اختصاصی) (SERVICE_NAME = ORCL) ) ) برای تنظیم پارامترهای پیکربندی برای اتصال "Net Service Name". روش، از یکی از گزینه های زیر استفاده کنید: - یک پارامتر خالی DBHost تنظیم کنید و DBName را به طور معمول تنظیم کنید: ```{=html} <!---> ``` DBHost= DBName=ORCL - هر دو پارامتر را تنظیم کنید و هر دو را خالی بگذارید: ```{=html} <!---> ``` DBHost= DBName= در حالت دوم، متغیر محیطی TWO\_TASK باید تنظیم شود. آی تی سرویس پیش‌فرض اوراکل از راه دور (نام سرویس) را مشخص می‌کند. زمانی که این متغیر تعریف شده است، اتصال دهنده به پایگاه داده مشخص شده توسط با استفاده از شنونده اوراکل که درخواست های اتصال را می پذیرد. این متغیر فقط برای استفاده در لینوکس و یونیکس است. از متغیر محیطی LOCAL استفاده کنید برای مایکروسافت ویندوز **مثال:** با استفاده از Net Service Name به عنوان ORCL و پیش فرض به پایگاه داده متصل شوید بندر. پارامترهای پایگاه داده در فایل پیکربندی سرور یا پروکسی تنظیم شده است (zabbix\_server.conf و zabbix\_proxy.conf): DBHost= #DBPort= DBUser=myusername DBName=ORCL DBPassword=mypassword در طول نصب Zabbix frontend، پارامترهای مربوطه را در آن تنظیم کنید مرحله *پیکربندی اتصال DB* جادوگر راه اندازی: - میزبان پایگاه داده: - پورت پایگاه داده: 0 - نام پایگاه داده: ORCL - کاربر: myusername - رمز عبور: mypassword ![](../../../../assets/en/manual/appendix/install/oracle_service_name.png){width="600"} متناوبا، این پارامترها را می توان در پیکربندی frontend تنظیم کرد فایل (zabbix.conf.php): $DB["TYPE"] = 'ORACLE'; $DB["SERVER"] = ''; $DB["PORT"] = '0'; $DB["DATABASE"] = 'ORCL'; $DB["USER"] = 'myusername'; $DB["PASSWORD"] = 'mypassword'; رشته اتصال که توسط Zabbix برای ایجاد اتصال استفاده می شود: DBUser/DBPassword@ORCL ##### Network data |Item key|<|<|<| |--|--|------|------| |Description|Return value|Parameters|Comments| |**net.dns**\[<ip>,name,<type>,<timeout>,<count>,<protocol>\]|<|<|<| |Checks if DNS service is up.|0 - DNS is down (server did not respond or DNS resolution failed)<br><br>1 - DNS is up|**ip** - IP address of DNS server (leave empty for the default DNS server, on Windows supported for Zabbix agent 2, ignored for Zabbix agent)<br>**name** - DNS name to query<br>**type** - record type to be queried (default is *SOA*)<br>**timeout** (ignored on Windows, unless using Zabbix agent 2 version 6.0.1 or newer) - timeout for the request in seconds (default is 1 second)<br>**count** (ignored on Windows, unless using Zabbix agent 2 version 6.0.1 or newer) - number of tries for the request (default is 2)<br>**protocol** (since version 3.0) - the protocol used to perform DNS queries: *udp* (default) or *tcp*|Example:<br>=> net.dns\[8.8.8.8,example.com,MX,2,1\]<br><br>The possible values for `type` are:<br>*ANY*, *A*, *NS*, *CNAME*, *MB*, *MG*, *MR*, *PTR*, *MD*, *MF*, *MX*, *SOA*, *NULL*, *WKS* (not supported for Zabbix agent on Windows, Zabbix agent 2 on all OS), *HINFO*, *MINFO*, *TXT*, *AAAA*, *SRV*<br><br>Internationalized domain names are not supported, please use IDNA encoded names instead.<br><br>SRV record type is supported since Zabbix 1.8.6 (Unix) and 2.0.0 (Windows).<br><br>Naming before Zabbix 2.0 (still supported): *net.tcp.dns*| |**net.dns.record**\[<ip>,name,<type>,<timeout>,<count>,<protocol>\]|<|<|<| |Performs a DNS query.|Character string with the required type of information|**ip** - IP address of DNS server (leave empty for the default DNS server, ignored on Windows, unless using Zabbix agent 2 version 6.0.1 or newer)<br>**name** - DNS name to query<br>**type** - record type to be queried (default is *SOA*)<br>**timeout** (ignored on Windows, unless using Zabbix agent 2 version 6.0.1 or newer) - timeout for the request in seconds (default is 1 second)<br>**count** (ignored on Windows, unless using Zabbix agent 2 version 6.0.1 or newer) - number of tries for the request (default is 2)<br>**protocol**(since version 3.0) - the protocol used to perform DNS queries: *udp* (default) or *tcp*|Example:<br>=> net.dns.record\[8.8.8.8,example.com,MX,2,1\]<br><br>The possible values for `type` are:<br>*ANY*, *A*, *NS*, *CNAME*, *MB*, *MG*, *MR*, *PTR*, *MD*, *MF*, *MX*, *SOA*, *NULL*, *WKS* (not supported for Zabbix agent on Windows, Zabbix agent 2 on all OS), *HINFO*, *MINFO*, *TXT*, *AAAA*, *SRV*<br><br>Internationalized domain names are not supported, please use IDNA encoded names instead.<br><br>SRV record type is supported since Zabbix 1.8.6 (Unix) and 2.0.0 (Windows).<br><br>Naming before Zabbix 2.0 (still supported): *net.tcp.dns.query*| |**net.if.collisions**\[if\]|<|<|<| |Number of out-of-window collisions.|Integer|**if** - network interface name| | |**net.if.discovery**|<|<|<| |List of network interfaces. Used for low-level discovery.|JSON object| |Supported since Zabbix 2.0.<br><br>On FreeBSD, OpenBSD and NetBSD supported since Zabbix 2.2.<br><br>Some Windows versions (for example, Server 2008) might require the latest updates installed to support non-ASCII characters in interface names.| |**net.if.in**\[if,<mode>\]|<|<|<| |Incoming traffic statistics on network interface.|Integer|**if** - network interface name (Unix); network interface full description or IPv4 address; or, if in braces, network interface GUID (Windows)<br>**mode** - possible values:<br>*bytes* - number of bytes (default)<br>*packets* - number of packets<br>*errors* - number of errors<br>*dropped* - number of dropped packets<br>*overruns (fifo)* - the number of FIFO buffer errors<br>*frame* - the number of packet framing errors<br>*compressed* - the number of compressed packets received by the device driver<br>*multicast* - the number of multicast frames received by the device driver|On Windows, the item gets values from 64-bit counters if available. 64-bit interface statistic counters were introduced in Windows Vista and Windows Server 2008. If 64-bit counters are not available, the agent uses 32-bit counters.<br><br>Multi-byte interface names on Windows are supported since Zabbix 1.8.6.<br><br>Examples:<br>=> net.if.in\[eth0,errors\]<br>=> net.if.in\[eth0\]<br><br>You may obtain network interface descriptions on Windows with net.if.discovery or net.if.list items.<br><br>You may use this key with the *Change per second* preprocessing step in order to get bytes per second statistics.| |**net.if.out**\[if,<mode>\]|<|<|<| |Outgoing traffic statistics on network interface.|Integer|**if** - network interface name (Unix); network interface full description or IPv4 address; or, if in braces, network interface GUID (Windows)<br>**mode** - possible values:<br>*bytes* - number of bytes (default)<br>*packets* - number of packets<br>*errors* - number of errors<br>*dropped* - number of dropped packets<br>*overruns (fifo)* - the number of FIFO buffer errors<br>*collisions (colls)* - the number of collisions detected on the interface<br>*carrier* - the number of carrier losses detected by the device driver<br>*compressed* - the number of compressed packets transmitted by the device driver|On Windows, the item gets values from 64-bit counters if available. 64-bit interface statistic counters were introduced in Windows Vista and Windows Server 2008. If 64-bit counters are not available, the agent uses 32-bit counters.<br><br>Multi-byte interface names on Windows are supported since Zabbix agent 1.8.6 version.<br><br>Examples:<br>=> net.if.out\[eth0,errors\]<br>=> net.if.out\[eth0\]<br><br>You may obtain network interface descriptions on Windows with net.if.discovery or net.if.list items.<br><br>You may use this key with the *Change per second* preprocessing step in order to get bytes per second statistics.| |**net.if.total**\[if,<mode>\]|<|<|<| |Sum of incoming and outgoing traffic statistics on network interface.|Integer|**if** - network interface name (Unix); network interface full description or IPv4 address; or, if in braces, network interface GUID (Windows)<br>**mode** - possible values:<br>*bytes* - number of bytes (default)<br>*packets* - number of packets<br>*errors* - number of errors<br>*dropped* - number of dropped packets<br>*overruns (fifo)* - the number of FIFO buffer errors<br>*compressed* - the number of compressed packets transmitted or received by the device driver|On Windows, the item gets values from 64-bit counters if available. 64-bit interface statistic counters were introduced in Windows Vista and Windows Server 2008. If 64-bit counters are not available, the agent uses 32-bit counters.<br><br>Examples:<br>=> net.if.total\[eth0,errors\]<br>=> net.if.total\[eth0\]<br><br>You may obtain network interface descriptions on Windows with net.if.discovery or net.if.list items.<br><br>You may use this key with the *Change per second* preprocessing step in order to get bytes per second statistics.<br><br>Note that dropped packets are supported only if both net.if.in and net.if.out work for dropped packets on your platform.| |**net.tcp.listen**\[port\]|<|<|<| |Checks if this TCP port is in LISTEN state.|0 - it is not in LISTEN state<br><br>1 - it is in LISTEN state|**port** - TCP port number|Example:<br>=> net.tcp.listen\[80\]<br><br>On Linux supported since Zabbix 1.8.4<br><br>Since Zabbix 3.0.0, on Linux kernels 2.6.14 and above, information about listening TCP sockets is obtained from the kernel's NETLINK interface, if possible. Otherwise, the information is retrieved from /proc/net/tcp and /proc/net/tcp6 files.| |**net.tcp.port**\[<ip>,port\]|<|<|<| |Checks if it is possible to make TCP connection to specified port.|0 - cannot connect<br><br>1 - can connect|**ip** - IP or DNS name (default is 127.0.0.1)<br>**port** - port number|Example:<br>=> net.tcp.port\[,80\] → can be used to test availability of web server running on port 80.<br><br>For simple TCP performance testing use net.tcp.service.perf\[tcp,<ip>,<port>\]<br><br>Note that these checks may result in additional messages in system daemon logfiles (SMTP and SSH sessions being logged usually).| |**net.tcp.service**\[service,<ip>,<port>\]|<|<|<| |Checks if service is running and accepting TCP connections.|0 - service is down<br><br>1 - service is running|**service** - either of:<br>*ssh*, *ldap*, *smtp*, *ftp*, *http*, *pop*, *nntp*, *imap*, *tcp*, *https*, *telnet* (see [details](/manual/appendix/items/service_check_details))<br>**ip** - IP or DNS name (default is 127.0.0.1)<br>**port** - port number (by default standard service port number is used)|Example:<br>=> net.tcp.service\[ftp,,45\] → can be used to test the availability of FTP server on TCP port 45.<br><br>Note that these checks may result in additional messages in system daemon logfiles (SMTP and SSH sessions being logged usually).<br><br>Checking of encrypted protocols (like IMAP on port 993 or POP on port 995) is currently not supported. As a workaround, please use net.tcp.port for checks like these.<br><br>Checking of LDAP and HTTPS on Windows is only supported by Zabbix agent 2.<br><br>Note that the telnet check looks for a login prompt (':' at the end).<br><br>*https* and *telnet* services are supported since Zabbix 2.0.| |**net.tcp.service.perf**\[service,<ip>,<port>\]|<|<|<| |Checks performance of TCP service.|Float<br><br>0 - service is down<br><br>seconds - the number of seconds spent while connecting to the service|**service** - either of:<br>*ssh*, *ldap*, *smtp*, *ftp*, *http*, *pop*, *nntp*, *imap*, *tcp*, *https*, *telnet* (see [details](/manual/appendix/items/service_check_details))<br>**ip** - IP or DNS name (default is 127.0.0.1)<br>**port** - port number (by default standard service port number is used)|Example:<br>=> net.tcp.service.perf\[ssh\] → can be used to test the speed of initial response from SSH server.<br><br>Checking of encrypted protocols (like IMAP on port 993 or POP on port 995) is currently not supported. As a workaround, please use net.tcp.service.perf\[tcp,<ip>,<port>\] for checks like these.<br><br>Checking of LDAP and HTTPS on Windows is only supported by Zabbix agent 2.<br><br>Note that the telnet check looks for a login prompt (':' at the end).<br><br>*https* and *telnet* services are supported since Zabbix 2.0.| |**net.tcp.socket.count**\[<laddr>,<lport>,<raddr>,<rport>,<state>\]|<|<|<| |Return the number of TCP sockets that match parameters.|Integer|**laddr** - local IPv4/6 address or CIDR subnet<br>**lport** - local port number or service name<br>**raddr** - remote IPv4/6 address or CIDR subnet<br>**rport** - remote port number or service name<br>**state** - connection state (*established*, *syn\_sent*, *syn\_recv*, *fin\_wait1*, *fin\_wait2*, *time\_wait*, *close*, *close\_wait*, *last\_ack*, *listen*, *closing*)|This item is supported on Linux only on both Zabbix agent/agent 2. On Zabbix agent 2 it is also supported on 64-bit Windows.<br><br>Example:<br>=> net.tcp.socket.count\[,80,,,established\] → returns the number of connections to local TCP port 80 in the *established* state<br><br>This item is supported since Zabbix 6.0.| |**net.udp.listen**\[port\]|<|<|<| |Checks if this UDP port is in LISTEN state.|0 - it is not in LISTEN state<br><br>1 - it is in LISTEN state|**port** - UDP port number|Example:<br>=> net.udp.listen\[68\]<br><br>On Linux supported since Zabbix 1.8.4| |**net.udp.service**\[service,<ip>,<port>\]|<|<|<| |Checks if service is running and responding to UDP requests.|0 - service is down<br><br>1 - service is running|**service** - *ntp* (see [details](/manual/appendix/items/service_check_details))<br>**ip** - IP or DNS name (default is 127.0.0.1)<br>**port** - port number (by default standard service port number is used)|Example:<br>=> net.udp.service\[ntp,,45\] → can be used to test the availability of NTP service on UDP port 45.<br><br>This item is supported since Zabbix 3.0.0, but *ntp* service was available for net.tcp.service\[\] item in prior versions.| |**net.udp.service.perf**\[service,<ip>,<port>\]|<|<|<| |Checks performance of UDP service.|Float<br><br>0 - service is down<br><br>seconds - the number of seconds spent waiting for response from the service|**service** - *ntp* (see [details](/manual/appendix/items/service_check_details))<br>**ip** - IP or DNS name (default is 127.0.0.1)<br>**port** - port number (by default standard service port number is used)|Example:<br>=> net.udp.service.perf\[ntp\] → can be used to test response time from NTP service.<br><br>This item is supported since Zabbix 3.0.0, but *ntp* service was available for net.tcp.service\[\] item in prior versions.| |**net.udp.socket.count**\[<laddr>,<lport>,<raddr>,<rport>,<state>\]|<|<|<| |Return the number of UDP sockets that match parameters.|Integer|**laddr** - local IPv4/6 address or CIDR subnet<br>**lport** - local port number or service name<br>**raddr** - remote IPv4/6 address or CIDR subnet<br>**rport** - remote port number or service name<br>**state** - connection state (*established*, *unconn*)|This item is supported on Linux only on both Zabbix agent/agent 2. On Zabbix agent 2 it is also supported on 64-bit Windows.<br><br>Example:<br>=> net.udp.socket.count\[,,,,established\] → returns the number of UDP sockets in the connected state<br><br>This item is supported since Zabbix 6.0.| ##### Network data |Item key|<|<|<| |--|--|------|------| |Description|Return value|Parameters|Comments| |**net.dns**\[<ip>,name,<type>,<timeout>,<count>,<protocol>\]|<|<|<| |Checks if DNS service is up.|0 - DNS is down (server did not respond or DNS resolution failed)<br><br>1 - DNS is up|**ip** - IP address of DNS server (leave empty for the default DNS server, on Windows supported for Zabbix agent 2, ignored for Zabbix agent)<br>**name** - DNS name to query<br>**type** - record type to be queried (default is *SOA*)<br>**timeout** (ignored on Windows, unless using Zabbix agent 2 version 6.0.1 or newer) - timeout for the request in seconds (default is 1 second)<br>**count** (ignored on Windows, unless using Zabbix agent 2 version 6.0.1 or newer) - number of tries for the request (default is 2)<br>**protocol** (since version 3.0) - the protocol used to perform DNS queries: *udp* (default) or *tcp*|Example:<br>=> net.dns\[8.8.8.8,example.com,MX,2,1\]<br><br>The possible values for `type` are:<br>*ANY*, *A*, *NS*, *CNAME*, *MB*, *MG*, *MR*, *PTR*, *MD*, *MF*, *MX*, *SOA*, *NULL*, *WKS* (not supported for Zabbix agent on Windows, Zabbix agent 2 on all OS), *HINFO*, *MINFO*, *TXT*, *AAAA*, *SRV*<br><br>Internationalized domain names are not supported, please use IDNA encoded names instead.<br><br>SRV record type is supported since Zabbix 1.8.6 (Unix) and 2.0.0 (Windows).<br><br>Naming before Zabbix 2.0 (still supported): *net.tcp.dns*| |**net.dns.record**\[<ip>,name,<type>,<timeout>,<count>,<protocol>\]|<|<|<| |Performs a DNS query.|Character string with the required type of information|**ip** - IP address of DNS server (leave empty for the default DNS server, ignored on Windows, unless using Zabbix agent 2 version 6.0.1 or newer)<br>**name** - DNS name to query<br>**type** - record type to be queried (default is *SOA*)<br>**timeout** (ignored on Windows, unless using Zabbix agent 2 version 6.0.1 or newer) - timeout for the request in seconds (default is 1 second)<br>**count** (ignored on Windows, unless using Zabbix agent 2 version 6.0.1 or newer) - number of tries for the request (default is 2)<br>**protocol**(since version 3.0) - the protocol used to perform DNS queries: *udp* (default) or *tcp*|Example:<br>=> net.dns.record\[8.8.8.8,example.com,MX,2,1\]<br><br>The possible values for `type` are:<br>*ANY*, *A*, *NS*, *CNAME*, *MB*, *MG*, *MR*, *PTR*, *MD*, *MF*, *MX*, *SOA*, *NULL*, *WKS* (not supported for Zabbix agent on Windows, Zabbix agent 2 on all OS), *HINFO*, *MINFO*, *TXT*, *AAAA*, *SRV*<br><br>Internationalized domain names are not supported, please use IDNA encoded names instead.<br><br>SRV record type is supported since Zabbix 1.8.6 (Unix) and 2.0.0 (Windows).<br><br>Naming before Zabbix 2.0 (still supported): *net.tcp.dns.query*| |**net.if.collisions**\[if\]|<|<|<| |Number of out-of-window collisions.|Integer|**if** - network interface name| | |**net.if.discovery**|<|<|<| |List of network interfaces. Used for low-level discovery.|JSON object| |Supported since Zabbix 2.0.<br><br>On FreeBSD, OpenBSD and NetBSD supported since Zabbix 2.2.<br><br>Some Windows versions (for example, Server 2008) might require the latest updates installed to support non-ASCII characters in interface names.| |**net.if.in**\[if,<mode>\]|<|<|<| |Incoming traffic statistics on network interface.|Integer|**if** - network interface name (Unix); network interface full description or IPv4 address; or, if in braces, network interface GUID (Windows)<br>**mode** - possible values:<br>*bytes* - number of bytes (default)<br>*packets* - number of packets<br>*errors* - number of errors<br>*dropped* - number of dropped packets<br>*overruns (fifo)* - the number of FIFO buffer errors<br>*frame* - the number of packet framing errors<br>*compressed* - the number of compressed packets received by the device driver<br>*multicast* - the number of multicast frames received by the device driver|On Windows, the item gets values from 64-bit counters if available. 64-bit interface statistic counters were introduced in Windows Vista and Windows Server 2008. If 64-bit counters are not available, the agent uses 32-bit counters.<br><br>Multi-byte interface names on Windows are supported since Zabbix 1.8.6.<br><br>Examples:<br>=> net.if.in\[eth0,errors\]<br>=> net.if.in\[eth0\]<br><br>You may obtain network interface descriptions on Windows with net.if.discovery or net.if.list items.<br><br>You may use this key with the *Change per second* preprocessing step in order to get bytes per second statistics.| |**net.if.out**\[if,<mode>\]|<|<|<| |Outgoing traffic statistics on network interface.|Integer|**if** - network interface name (Unix); network interface full description or IPv4 address; or, if in braces, network interface GUID (Windows)<br>**mode** - possible values:<br>*bytes* - number of bytes (default)<br>*packets* - number of packets<br>*errors* - number of errors<br>*dropped* - number of dropped packets<br>*overruns (fifo)* - the number of FIFO buffer errors<br>*collisions (colls)* - the number of collisions detected on the interface<br>*carrier* - the number of carrier losses detected by the device driver<br>*compressed* - the number of compressed packets transmitted by the device driver|On Windows, the item gets values from 64-bit counters if available. 64-bit interface statistic counters were introduced in Windows Vista and Windows Server 2008. If 64-bit counters are not available, the agent uses 32-bit counters.<br><br>Multi-byte interface names on Windows are supported since Zabbix agent 1.8.6 version.<br><br>Examples:<br>=> net.if.out\[eth0,errors\]<br>=> net.if.out\[eth0\]<br><br>You may obtain network interface descriptions on Windows with net.if.discovery or net.if.list items.<br><br>You may use this key with the *Change per second* preprocessing step in order to get bytes per second statistics.| |**net.if.total**\[if,<mode>\]|<|<|<| |Sum of incoming and outgoing traffic statistics on network interface.|Integer|**if** - network interface name (Unix); network interface full description or IPv4 address; or, if in braces, network interface GUID (Windows)<br>**mode** - possible values:<br>*bytes* - number of bytes (default)<br>*packets* - number of packets<br>*errors* - number of errors<br>*dropped* - number of dropped packets<br>*overruns (fifo)* - the number of FIFO buffer errors<br>*compressed* - the number of compressed packets transmitted or received by the device driver|On Windows, the item gets values from 64-bit counters if available. 64-bit interface statistic counters were introduced in Windows Vista and Windows Server 2008. If 64-bit counters are not available, the agent uses 32-bit counters.<br><br>Examples:<br>=> net.if.total\[eth0,errors\]<br>=> net.if.total\[eth0\]<br><br>You may obtain network interface descriptions on Windows with net.if.discovery or net.if.list items.<br><br>You may use this key with the *Change per second* preprocessing step in order to get bytes per second statistics.<br><br>Note that dropped packets are supported only if both net.if.in and net.if.out work for dropped packets on your platform.| |**net.tcp.listen**\[port\]|<|<|<| |Checks if this TCP port is in LISTEN state.|0 - it is not in LISTEN state<br><br>1 - it is in LISTEN state|**port** - TCP port number|Example:<br>=> net.tcp.listen\[80\]<br><br>On Linux supported since Zabbix 1.8.4<br><br>Since Zabbix 3.0.0, on Linux kernels 2.6.14 and above, information about listening TCP sockets is obtained from the kernel's NETLINK interface, if possible. Otherwise, the information is retrieved from /proc/net/tcp and /proc/net/tcp6 files.| |**net.tcp.port**\[<ip>,port\]|<|<|<| |Checks if it is possible to make TCP connection to specified port.|0 - cannot connect<br><br>1 - can connect|**ip** - IP or DNS name (default is 127.0.0.1)<br>**port** - port number|Example:<br>=> net.tcp.port\[,80\] → can be used to test availability of web server running on port 80.<br><br>For simple TCP performance testing use net.tcp.service.perf\[tcp,<ip>,<port>\]<br><br>Note that these checks may result in additional messages in system daemon logfiles (SMTP and SSH sessions being logged usually).| |**net.tcp.service**\[service,<ip>,<port>\]|<|<|<| |Checks if service is running and accepting TCP connections.|0 - service is down<br><br>1 - service is running|**service** - either of:<br>*ssh*, *ldap*, *smtp*, *ftp*, *http*, *pop*, *nntp*, *imap*, *tcp*, *https*, *telnet* (see [details](/manual/appendix/items/service_check_details))<br>**ip** - IP or DNS name (default is 127.0.0.1)<br>**port** - port number (by default standard service port number is used)|Example:<br>=> net.tcp.service\[ftp,,45\] → can be used to test the availability of FTP server on TCP port 45.<br><br>Note that these checks may result in additional messages in system daemon logfiles (SMTP and SSH sessions being logged usually).<br><br>Checking of encrypted protocols (like IMAP on port 993 or POP on port 995) is currently not supported. As a workaround, please use net.tcp.port for checks like these.<br><br>Checking of LDAP and HTTPS on Windows is only supported by Zabbix agent 2.<br><br>Note that the telnet check looks for a login prompt (':' at the end).<br><br>*https* and *telnet* services are supported since Zabbix 2.0.| |**net.tcp.service.perf**\[service,<ip>,<port>\]|<|<|<| |Checks performance of TCP service.|Float<br><br>0 - service is down<br><br>seconds - the number of seconds spent while connecting to the service|**service** - either of:<br>*ssh*, *ldap*, *smtp*, *ftp*, *http*, *pop*, *nntp*, *imap*, *tcp*, *https*, *telnet* (see [details](/manual/appendix/items/service_check_details))<br>**ip** - IP or DNS name (default is 127.0.0.1)<br>**port** - port number (by default standard service port number is used)|Example:<br>=> net.tcp.service.perf\[ssh\] → can be used to test the speed of initial response from SSH server.<br><br>Checking of encrypted protocols (like IMAP on port 993 or POP on port 995) is currently not supported. As a workaround, please use net.tcp.service.perf\[tcp,<ip>,<port>\] for checks like these.<br><br>Checking of LDAP and HTTPS on Windows is only supported by Zabbix agent 2.<br><br>Note that the telnet check looks for a login prompt (':' at the end).<br><br>*https* and *telnet* services are supported since Zabbix 2.0.| |**net.tcp.socket.count**\[<laddr>,<lport>,<raddr>,<rport>,<state>\]|<|<|<| |Return the number of TCP sockets that match parameters.|Integer|**laddr** - local IPv4/6 address or CIDR subnet<br>**lport** - local port number or service name<br>**raddr** - remote IPv4/6 address or CIDR subnet<br>**rport** - remote port number or service name<br>**state** - connection state (*established*, *syn\_sent*, *syn\_recv*, *fin\_wait1*, *fin\_wait2*, *time\_wait*, *close*, *close\_wait*, *last\_ack*, *listen*, *closing*)|This item is supported on Linux only on both Zabbix agent/agent 2. On Zabbix agent 2 it is also supported on 64-bit Windows.<br><br>Example:<br>=> net.tcp.socket.count\[,80,,,established\] → returns the number of connections to local TCP port 80 in the *established* state<br><br>This item is supported since Zabbix 6.0.| |**net.udp.listen**\[port\]|<|<|<| |Checks if this UDP port is in LISTEN state.|0 - it is not in LISTEN state<br><br>1 - it is in LISTEN state|**port** - UDP port number|Example:<br>=> net.udp.listen\[68\]<br><br>On Linux supported since Zabbix 1.8.4| |**net.udp.service**\[service,<ip>,<port>\]|<|<|<| |Checks if service is running and responding to UDP requests.|0 - service is down<br><br>1 - service is running|**service** - *ntp* (see [details](/manual/appendix/items/service_check_details))<br>**ip** - IP or DNS name (default is 127.0.0.1)<br>**port** - port number (by default standard service port number is used)|Example:<br>=> net.udp.service\[ntp,,45\] → can be used to test the availability of NTP service on UDP port 45.<br><br>This item is supported since Zabbix 3.0.0, but *ntp* service was available for net.tcp.service\[\] item in prior versions.| |**net.udp.service.perf**\[service,<ip>,<port>\]|<|<|<| |Checks performance of UDP service.|Float<br><br>0 - service is down<br><br>seconds - the number of seconds spent waiting for response from the service|**service** - *ntp* (see [details](/manual/appendix/items/service_check_details))<br>**ip** - IP or DNS name (default is 127.0.0.1)<br>**port** - port number (by default standard service port number is used)|Example:<br>=> net.udp.service.perf\[ntp\] → can be used to test response time from NTP service.<br><br>This item is supported since Zabbix 3.0.0, but *ntp* service was available for net.tcp.service\[\] item in prior versions.| |**net.udp.socket.count**\[<laddr>,<lport>,<raddr>,<rport>,<state>\]|<|<|<| |Return the number of UDP sockets that match parameters.|Integer|**laddr** - local IPv4/6 address or CIDR subnet<br>**lport** - local port number or service name<br>**raddr** - remote IPv4/6 address or CIDR subnet<br>**rport** - remote port number or service name<br>**state** - connection state (*established*, *unconn*)|This item is supported on Linux only on both Zabbix agent/agent 2. On Zabbix agent 2 it is also supported on 64-bit Windows.<br><br>Example:<br>=> net.udp.socket.count\[,,,,established\] → returns the number of UDP sockets in the connected state<br><br>This item is supported since Zabbix 6.0.| #### Network discovery In a [network discovery rule](/manual/discovery/network_discovery/rule), user macros can be used in the following fields: |Location|<|Multiple macros/mix with text^[1](supported_by_location_user#footnotes)^| |-|------------------------------|----------| |Update interval|<|no| |*SNMP v1, v2*|<|<| | |SNMP community|yes| |^|SNMP OID|yes| |*SNMP v3*|<|<| | |Context name|yes| |^|Security name|yes| |^|Authentication passphrase|yes| |^|Privacy passphrase|yes| |^|SNMP OID|yes| #### هاست/نمونه های اولیه میزبان در یک [host](/manual/config/hosts/host) و [host نمونه اولیه](/manual/vm_monitoring#host_prototypes) پیکربندی، کاربر ماکروها را می توان در زمینه های زیر استفاده کرد: |موقعیت|<|چند ماکرو/میکس با متن^[1](پشتیبانی_شده توسط_location_user#footnotes)^| |-|-----------------------------|----------| |IP/DNS رابط|<|فقط DNS| |پورت رابط|<|نه| |*SNMP v1, v2*|<|<| | |جامعه SNMP|بله| |*SNMP v3*|<|<| | |نام زمینه|بله| |^|نام امنیتی|بله| |^| عبارت عبور احراز هویت|بله| |^|عبارت عبور حریم خصوصی|بله| |*IPMI*|<|<| | |نام کاربری|بله| |^|رمز عبور|بله| |*برچسب ها*^[2](پشتیبانی_شده توسط_location_user#footnotes)^|<|<| | |اسامی برچسب|بله| |^|مقادیر برچسب|بله| #### New item for PostgreSQL Zabbix agent 2 plugin New [item](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2#postgresql), **pgsql.version**, has been added to PostgreSQL Zabbix agent 2 plugin. This item is used for returning the PostgreSQL version. #### مورد جدید برای پلاگین PostgreSQL Zabbix agent 2 [Item](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2#postgresql)، **pgsql.version** جدید به پلاگین PostgreSQL Zabbix agent 2. این مورد برای برگرداندن نسخه PostgreSQL استفاده می شود. #### New items in Zabbix agent 2 plugins The items for returning the database server version are now available in [MongoDB plugin](https://git.zabbix.com/projects/AP/repos/mongodb/browse/README.md?at=refs%2Fheads%2Frelease%2F6.0) ([`mongodb.version`](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2#mongodb)) and [Oracle Database plugin](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/oracle/README.md?at=refs%2Fheads%2Frelease%2F6.0) ([`oracle.version`](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2#oracle)). #### موارد جدید در افزونه های Zabbix agent 2 موارد برای بازگرداندن نسخه سرور پایگاه داده اکنون در [افزونه MongoDB] (https://git.zabbix.com/projects/AP/repos/mongodb/browse/README.md?at=refs%2Fheads%2Frelease%2F6) موجود است .0) ([`mongodb.version`](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2#mongodb)) و [افزونه پایگاه داده Oracle](https://git.zabbix.com/projects/ZBX/repos /zabbix/browse/src/go/plugins/oracle/README.md?at=refs%2Fheads%2Frelease%2F6.0) ([`oracle.version`](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2 #فرقه)). ### Notation ### نشانه گذاری ::: noteclassic If installing from [Zabbix Git repository](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse), you need to run the following command prior to proceeding to the next steps: <br><br> `make dbschema` ::: ::: نوتکلاسیک اگر از [مخزن Zabbix Git] (https://git.zabbix.com/projects/ZBX/repos/zabbix/browse) نصب می‌کنید، باید دستور زیر را قبل از ادامه مراحل بعدی اجرا کنید: <br><br> ساخت dbschema ::: ::: noteimportant Deprecated widgets will be removed in the upcoming major release. ::: ::: نکته مهم ویجت های منسوخ شده در نسخه اصلی آینده حذف خواهند شد. ::: ::: noteimportant This widget is deprecated and will be removed in the upcoming major release. Consider using the [*Top hosts*](/manual/api/reference/dashboard/widget_fields/top_hosts) widget instead. ::: ::: نکته مهم این ویجت منسوخ شده است و در نسخه اصلی بعدی حذف خواهد شد. به جای آن از ویجت [*Top hosts*](/manual/api/reference/dashboard/widget_fields/top_hosts) استفاده کنید. ::: Notes for AIX: 1. When choosing parameters for proc.mem[] item key on AIX, try to specify narrow process selection criteria. Otherwise there is a risk of getting unwanted processes counted into proc.mem[] result. Example: ``` $ zabbix_agentd -t proc.mem[,,,NonExistingProcess,rss] proc.mem[,,,NonExistingProcess,rss] [u|2879488] ``` This example shows how specifying only command line (regular expression to match) parameter results in Zabbix agent self-accounting - probably not what you want. نکاتی برای AIX: 1. هنگام انتخاب پارامترها برای کلید آیتم proc.mem[] در AIX، سعی کنید معیارهای انتخاب فرآیند محدودی را مشخص کنید. در غیر این صورت، خطر شمرده شدن فرآیندهای ناخواسته در نتیجه proc.mem[] وجود دارد. مثال: ``` $ zabbix_agentd -t proc.mem[,,,NonExistingProcess,rss] proc.mem[,,,NonExistingProcess,rss] [u|2879488] ``` این مثال نشان می دهد که چگونه تعیین پارامتر تنها خط فرمان (عبارت منظم برای تطبیق) منجر به خود حسابداری عامل Zabbix می شود - احتمالاً آن چیزی نیست که شما می خواهید. #### Notes on handling 'copytruncate' log file rotation `logrt` with the `copytruncate` option assumes that different log files have different records (at least their timestamps are different), therefore MD5 sums of initial blocks (up to the first 512 bytes) will be different. Two files with the same MD5 sums of initial blocks means that one of them is the original, another - a copy. `logrt` with the `copytruncate` option makes effort to correctly process log file copies without reporting duplicates. However, things like producing multiple log file copies with the same timestamp, log file rotation more often than logrt\[\] item update interval, frequent restarting of agent are not recommended. The agent tries to handle all these situations reasonably well, but good results cannot be guaranteed in all circumstances. #### نکاتی در مورد مدیریت چرخش فایل لاگ 'copytruncate' «logrt» با گزینه «copytruncate» فرض می‌کند که فایل‌های log مختلف سوابق متفاوتی دارند (حداقل مهر زمانی آنها متفاوت است) بنابراین مجموع MD5 بلوک های اولیه (تا 512 بایت اول) خواهد بود ناهمسان. دو فایل با مجموع MD5 یکسان بلوک های اولیه به این معنی است یکی از آنها اصلی است، دیگری - یک کپی. "logrt" با گزینه "copytruncate" تلاش می کند تا به درستی پردازش شود فایل لاگ بدون گزارش موارد تکراری کپی می شود. با این حال، چیزهایی مانند تولید چندین کپی فایل log با همان مهر زمانی، فایل log چرخش بیشتر از logrt\[\] فاصله به روز رسانی مورد، مکرر راه اندازی مجدد عامل توصیه نمی شود. نماینده سعی می کند همه چیز را مدیریت کند این شرایط نسبتا خوب است، اما نمی توان نتایج خوب را تضمین کرد در همه شرایط #### Notes on persistent files for log\*\[\] items #### یادداشت‌هایی در مورد فایل‌های ماندگار برای موارد گزارش\*\[\] #### OK events An OK event closes the related problem event(s) and may be created by 3 components: - triggers - based on 'OK event generation' and 'OK event closes' settings; - event correlation - task manager – when an event is [manually closed](/manual/config/events/manual_close) #### رویدادهای خوب یک رویداد OK رویداد(های) مشکل مرتبط را می بندد و ممکن است توسط 3 ایجاد شود اجزاء: - محرک ها - بر اساس "تولید رویداد OK" و "رویداد OK بسته می شود" تنظیمات؛ - همبستگی رویداد - مدیر وظیفه - زمانی که یک رویداد [دستی است بسته](/دستی/پیکربندی/رویدادها/دستی_بستن) #### Operators The following operators are supported for triggers **(in descending priority of execution)**: |Priority|Operator|Definition|**Notes for [unknown values](/manual/config/triggers/expression#expressions_with_unknown-operands)**|Force cast operand to float ^**1**^| |-|-|----|----------------|--| |**1**|**-**|Unary minus|**-**Unknown → Unknown|Yes| |**2**|**not**|Logical NOT|**not** Unknown → Unknown|Yes| |**3**|**\***|Multiplication|0 **\*** Unknown → Unknown<br>(yes, Unknown, not 0 - to not lose<br>Unknown in arithmetic operations)<br>1.2 **\*** Unknown → Unknown|Yes| |<|**/**|Division|Unknown **/** 0 → error<br>Unknown **/** 1.2 → Unknown<br>0.0 **/** Unknown → Unknown|Yes| |**4**|**+**|Arithmetical plus|1.2 **+** Unknown → Unknown|Yes| |<|**-**|Arithmetical minus|1.2 **-** Unknown → Unknown|Yes| |**5**|**\<**|Less than. The operator is defined as:<br><br>A<B ⇔ (A<B-0.000001)|1.2 **<** Unknown → Unknown|Yes| |<|**<=**|Less than or equal to. The operator is defined as:<br><br>A<=B ⇔ (A≤B+0.000001)|Unknown **<=** Unknown → Unknown|Yes| |<|**>**|More than. The operator is defined as:<br><br>A>B ⇔ (A>B+0.000001)| |Yes| |<|**>=**|More than or equal to. The operator is defined as:<br><br>A>=B ⇔ (A≥B-0.000001)| |Yes| |**6**|**=**|Is equal. The operator is defined as:<br><br>A=B ⇔ (A≥B-0.000001) and (A≤B+0.000001)| |No ^**1**^| |<|**<>**|Not equal. The operator is defined as:<br><br>A<>B ⇔ (A<B-0.000001) or (A>B+0.000001)| |No ^**1**^| |**7**|**and**|Logical AND|0 **and** Unknown → 0<br>1 **and** Unknown → Unknown<br>Unknown **and** Unknown → Unknown|Yes| |**8**|**or**|Logical OR|1 **or** Unknown → 1<br>0 **or** Unknown → Unknown<br>Unknown **or** Unknown → Unknown|Yes| ^**1**^ String operand is still cast to numeric if: - another operand is numeric - operator other than **=** or **<>** is used on an operand (If the cast fails - numeric operand is cast to a string operand and both operands get compared as strings.) **not**, **and** and **or** operators are case-sensitive and must be in lowercase. They also must be surrounded by spaces or parentheses. All operators, except unary **-** and **not**, have left-to-right associativity. Unary **-** and **not** are non-associative (meaning **-(-1)** and **not (not 1)** should be used instead of **--1** and **not not 1**). Evaluation result: - **<**, **<=**, **>**, **>=**, **=**, **<>** operators shall yield '1' in the trigger expression if the specified relation is true and '0' if it is false. If at least one operand is Unknown the result is Unknown; - **and** for known operands shall yield '1' if both of its operands compare unequal to '0'; otherwise, it yields '0'; for unknown operands **and** yields '0' only if one operand compares equal to '0'; otherwise, it yields 'Unknown'; - **or** for known operands shall yield '1' if either of its operands compare unequal to '0'; otherwise, it yields '0'; for unknown operands **or** yields '1' only if one operand compares unequal to '0'; otherwise, it yields 'Unknown'; - The result of the logical negation operator **not** for a known operand is '0' if the value of its operand compares unequal to '0'; '1' if the value of its operand compares equal to '0'. For unknown operand **not** yields 'Unknown'. #### اپراتورها عملگرهای زیر برای تریگرها **(به صورت نزولی) پشتیبانی می شوند اولویت اجرا)**: |اولویت|اپراتور|تعریف|**یادداشت ها برای [مقادیر ناشناخته](/manual/config/triggers/expression#expressions_with_unknown-operands)**|اجبار کردن عملوند cast به شناور ^**1**^| |-|-|----|----------------|--| |**1**|**-**|یکی منهای|**-**ناشناس → ناشناخته|بله| |**2**|**نه**|منطقی نه|**نه** ناشناخته → ناشناخته|بله| |**3**|**\***|ضرب|0 **\*** ناشناخته → ناشناخته<br>(بله، ناشناخته، نه 0 - برای از دست ندادن<br>نامشخص در عملیات حسابی)<br >1.2 **\*** ناشناخته → ناشناس|بله| |<|**/**|بخش|ناشناخته **/** 0 → خطا<br>ناشناخته ***/** 1.2 → ناشناخته<br>0.0 ***/** ناشناس → ناشناخته|بله| |**4**|**+**|به علاوه حساب|1.2 **+** ناشناخته → ناشناخته|بله| |<|**-**|حسابی منهای|1.2 **-** نامعلوم → ناشناخته|بله| |**5**|**\<**|کمتر از. عملگر به صورت زیر تعریف می شود:<br><br>A<B ⇔ (A<B-0.000001)|1.2 ***<** ناشناخته → ناشناخته|بله| |<|**<=**|کمتر یا مساوی. عملگر به صورت زیر تعریف می شود:<br><br>A<=B ⇔ (A≤B+0.000001)|ناشناس **<=** ناشناخته → ناشناخته|بله| |<|**>**|بیش از. عملگر به صورت زیر تعریف می شود:<br><br>A>B ⇔ (A>B+0.000001)| |بله| |<|**>=**|بیشتر یا مساوی. عملگر به صورت زیر تعریف می شود:<br><br>A>=B ⇔ (A≥B-0.000001)| |بله| |**6**|**=**|برابر است. عملگر به صورت زیر تعریف می شود:<br><br>A=B ⇔ (A≥B-0.000001) و (A≤B+0.000001)| |نه ^**1**^| |<|**<>**|مساوی نیست. عملگر به صورت زیر تعریف می شود:<br><br>A<>B ⇔ (A<B-0.000001) یا (A>B+0.000001)| |نه ^**1**^| |**7**|**و**| و منطقی|0 **و** ناشناخته → 0<br>1 **و** ناشناخته → ناشناخته<br>ناشناس **و** ناشناخته → ناشناخته| بله| |**8**|**یا**|یا منطقی|1 **یا** ناشناس → 1<br>0 **یا** ناشناخته → ناشناخته<br>ناشناس **یا** ناشناخته → ناشناخته| بله| ^**1**^ عملوند رشته همچنان به عددی تبدیل می شود اگر: - عملوند دیگر عددی است - عملگر غیر از **=** یا **<>** در عملوند استفاده می شود (اگر Cast شکست خورد - عملوند عددی به یک عملوند رشته ای ریخته می شود و هر دو عملوند به عنوان رشته مقایسه می شوند.) اپراتورهای **not**، **و** و **یا** به حروف بزرگ و کوچک حساس هستند و باید in باشند حروف کوچک همچنین باید با فاصله یا پرانتز احاطه شوند. همه عملگرها، به جز unary **-** و **not**، از چپ به راست دارند انجمنی Unary **-** و **not** غیر تداعی هستند (به معنی **-(-1)** و **نه (1)** باید به جای **--1** و **نه 1**). نتیجه ارزیابی: - ***، ***، ***، **>**، **>=**، **=**، **<>** اپراتورها در صورت مشخص شده باید "1" را در عبارت ماشه نشان دهند رابطه درست است و اگر نادرست باشد '0'. اگر حداقل یک عملوند باشد ناشناخته نتیجه ناشناخته است. - **و** برای عملوندهای شناخته شده، اگر هر دو عملوند آن باشد، "1" به دست می آید مقایسه نامساوی با '0'؛ در غیر این صورت، '0' به دست می آید. برای ناشناخته عملوندهای **و** تنها در صورتی '0' به دست می دهند که یک عملوند برابر باشد '0'; در غیر این صورت، "ناشناخته" را نشان می دهد. - **یا** برای عملوندهای شناخته شده، اگر هر یک از عملوندهای آن، "1" باشد مقایسه نامساوی با '0'؛ در غیر این صورت، '0' به دست می آید. برای ناشناخته عملوند **یا** تنها در صورتی "1" را به دست می دهد که یکی از عملوندها با '0'; در غیر این صورت، "ناشناخته" را نشان می دهد. - نتیجه عملگر نفی منطقی **نه** برای معلوم عملوند '0' است اگر مقدار عملوند آن با '0' مقایسه شود. "1" اگر مقدار عملوند آن برابر با "0" مقایسه شود. برای ناشناخته عملوند **not** "Unknown" را به دست می دهد. ## OPTIONS **-c**, **--config** *config-file* Use the alternate *config-file* instead of the default one. **-f**, **--foreground** Run Zabbix agent in foreground. **-R**, **--runtime-control** *runtime-option* Perform administrative functions according to *runtime-option*. [ ]{#lbAF} ## گزینه ها **-c**، **--config** *config-file* به جای فایل پیش فرض، از *config-file* جایگزین استفاده کنید. **-R**، **--runtime-control** *runtime-option* عملکردهای اداری را مطابق *runtime-option* انجام دهید. ## OPTIONS **-c**, **--config** *config-file* Use the alternate *config-file* instead of the default one. **-f**, **--foreground** Run Zabbix proxy in foreground. **-R**, **--runtime-control** *runtime-option* Perform administrative functions according to *runtime-option*. [ ]{#lbAF} ## گزینه ها **-c**، **--config** *config-file* به جای فایل پیش فرض، از *config-file* جایگزین استفاده کنید. **-R**، **--runtime-control** *runtime-option* عملکردهای اداری را مطابق *runtime-option* انجام دهید. ## OPTIONS **-c**, **--config** *config-file* Use the alternate *config-file* instead of the default one. **-h**, **--help** Display this help and exit. **-V**, **--version** Output version information and exit. [ ]{#lbAF} ## گزینه ها **-c**، **--config** *config-file* به جای فایل پیش فرض، از *config-file* جایگزین استفاده کنید. **-h**، **--راهنما** این راهنما را نمایش دهید و از آن خارج شوید. **-V**، **--نسخه** اطلاعات نسخه خروجی و خروج. [ ]{#lbAF} ## OPTIONS **-c**, **--config** *config-file* Use the alternate *config-file* instead of the default one. **-R**, **--runtime-control** *runtime-option* Perform administrative functions according to *runtime-option*. ## گزینه ها **-c**، **--config** *config-file* به جای فایل پیش فرض، از *config-file* جایگزین استفاده کنید. **-R**، **--runtime-control** *runtime-option* عملکردهای اداری را مطابق *runtime-option* انجام دهید. ## OPTIONS **-s**, **--host** *host-name-or-IP* Specify host name or IP address of a host. **-p**, **--port** *port-number* Specify port number of agent running on the host. Default is 10050. **-I**, **--source-address** *IP-address* Specify source IP address. **-t**, **--timeout** *seconds* Specify timeout. Valid range: 1-30 seconds (default: 30) **-k**, **--key** *item-key* Specify key of item to retrieve value for. **--tls-connect** *value* How to connect to agent. Values: [ ]{#lbAF} ## گزینه ها **-s**، **--host** *host-name-or-IP* نام میزبان یا آدرس IP یک میزبان را مشخص کنید. **-p**، **--پورت** *درگاه-شماره* شماره پورت عامل در حال اجرا بر روی هاست را مشخص کنید. پیش فرض 10050 است. **-I**، **--منبع-آدرس** *آدرس IP* آدرس IP منبع را مشخص کنید. **-t**، **--تایم اوت** *ثانیه* تایم اوت را مشخص کنید. محدوده معتبر: 1-30 ثانیه (پیش‌فرض: 30) **-k**، **--کلید** *کلید مورد* کلید مورد را برای بازیابی مقدار مشخص کنید. **--tls-connect** *value* نحوه اتصال به نماینده ارزش های: [ ]{#lbAF} ## OPTIONS **-s**, **--script** *script-file* Specify the file name of the script to execute. If '-' is specified as file name, the script will be read from stdin. **-p**, **--param** *input-param* Specify the input parameter. **-i**, **--input** *input-file* Specify the file name of the input parameter. If '-' is specified as file name, the input will be read from stdin. **-l**, **--loglevel** *log-level* Specify the log level. **-t**, **--timeout** *timeout* Specify the timeout in seconds. Valid range: 1\-60 seconds (default: 10) **-h**, **--help** Display this help and exit. **-V**, **--version** Output version information and exit. [ ]{#lbAF} ## گزینه ها **-s**، **--اسکریپت** *اسکریپت-فایل* نام فایل اسکریپت مورد نظر را برای اجرا مشخص کنید. اگر '-' به صورت مشخص شده باشد نام فایل، اسکریپت از stdin خوانده می شود. **-p**، **--param** *input-param* پارامتر ورودی را مشخص کنید. **-i**، **--ورودی** *ورودی-فایل* نام فایل پارامتر ورودی را مشخص کنید. اگر '-' به صورت مشخص شده باشد نام فایل، ورودی از stdin خوانده می شود. **-l**، **--loglevel** *log-level* سطح گزارش را مشخص کنید. **-t**، **--تایم اوت** *تایم اوت* تایم اوت را بر حسب ثانیه مشخص کنید. **-h**، **--راهنما** این راهنما را نمایش دهید و از آن خارج شوید. **-V**، **--نسخه** اطلاعات نسخه خروجی و خروج. [ ]{#lbAF} #### Oracle Instructions for creating and configuring Oracle database are provided in a separate [section](/manual/appendix/install/oracle). #### اوراکل دستورالعمل های ایجاد و پیکربندی پایگاه داده Oracle ارائه شده است در یک [بخش] جداگانه (/کتابچه راهنما/ضمیمه/نصب/اوراکل). #### Other agent options It is possible to run multiple instances of the agent on a host. A single instance can use the default configuration file or a configuration file specified in the command line. In case of multiple instances each agent instance must have its own configuration file (one of the instances can use the default configuration file). The following command line parameters can be used with Zabbix agent: |Parameter|Description| |--|--------| |**UNIX and Windows agent**|<| |-c --config <config-file>|Path to the configuration file.<br>You may use this option to specify a configuration file that is not the default one.<br>On UNIX, default is /usr/local/etc/zabbix\_agentd.conf or as set by [compile-time](/manual/installation/install#installing_zabbix_daemons) variables *--sysconfdir* or *--prefix*<br>On Windows, default is c:\\zabbix\_agentd.conf| |-p --print|Print known items and exit.<br>*Note*: To return [user parameter](/manual/config/items/userparameters) results as well, you must specify the configuration file (if it is not in the default location).| |-t --test <item key>|Test specified item and exit.<br>*Note*: To return [user parameter](/manual/config/items/userparameters) results as well, you must specify the configuration file (if it is not in the default location).| |-h --help|Display help information| |-V --version|Display version number| |**UNIX agent only**|<| |-R --runtime-control <option>|Perform administrative functions. See [runtime control](/manual/concepts/agent#runtime_control).| |**Windows agent only**|<| |-m --multiple-agents|Use multiple agent instances (with -i,-d,-s,-x functions).<br>To distinguish service names of instances, each service name will include the Hostname value from the specified configuration file.| |**Windows agent only (functions)**|<| |-i --install|Install Zabbix Windows agent as service| |-d --uninstall|Uninstall Zabbix Windows agent service| |-s --start|Start Zabbix Windows agent service| |-x --stop|Stop Zabbix Windows agent service| Specific **examples** of using command line parameters: - printing all built-in agent items with values - testing a user parameter with "mysql.ping" key defined in the specified configuration file - installing a "Zabbix Agent" service for Windows using the default path to configuration file c:\\zabbix\_agentd.conf - installing a "Zabbix Agent \[Hostname\]" service for Windows using the configuration file zabbix\_agentd.conf located in the same folder as agent executable and make the service name unique by extending it by Hostname value from the config file ```{=html} <!-- --> ``` zabbix_agentd --print zabbix_agentd -t "mysql.ping" -c /etc/zabbix/zabbix_agentd.conf zabbix_agentd.exe -i zabbix_agentd.exe -i -m -c zabbix_agentd.conf #### سایر گزینه های عامل امکان اجرای چندین نمونه از عامل بر روی یک میزبان وجود دارد. آ یک نمونه می تواند از فایل تنظیمات پیش فرض یا a استفاده کند فایل پیکربندی مشخص شده در خط فرمان در صورت تعدد نمونه هایی که هر نمونه عامل باید فایل پیکربندی خاص خود را داشته باشد (یک از نمونه ها می توانند از فایل پیکربندی پیش فرض استفاده کنند). پارامترهای خط فرمان زیر را می توان با عامل Zabbix استفاده کرد: |پارامتر|توضیحات| |--|--------| |**یونیکس و عامل ویندوز**|<| |-c --config <config-file>|مسیری به فایل پیکربندی.<br>می توانید از این گزینه برای تعیین فایل پیکربندی که فایل پیش فرض نیست استفاده کنید.<br>در یونیکس، پیش فرض /usr/local است. /etc/zabbix\_agentd.conf یا مطابق با متغیرهای [compile-time](/manual/installation/install#installing_zabbix_daemons) *--sysconfdir* یا *--prefix*<br>در ویندوز، پیش‌فرض c:\ است. \zabbix\_agentd.conf| |-p --print|چاپ موارد شناخته شده و خروج.<br>*نکته*: برای برگرداندن نتایج [user parameter](/manual/config/items/userparameters) نیز، باید فایل پیکربندی را مشخص کنید (اگر در مکان پیش فرض نیست).| |-t --test <item key>|مورد مشخص شده را آزمایش کنید و از آن خارج شوید.<br>*نکته*: برای برگرداندن نتایج [user parameter](/manual/config/items/userparameters) نیز، باید فایل پیکربندی را مشخص کنید. (اگر در مکان پیش فرض نباشد).| |-h --help|نمایش اطلاعات راهنما| |-V --version|نمایش شماره نسخه| |**فقط عامل یونیکس**|<| |-R --runtime-control <option>|عملکردهای اداری را انجام دهید. [runtime control](/manual/concepts/agent#runtime_control) را ببینید.| |**فقط عامل ویندوز**|<| |-m --multiple-agents|از چندین نمونه عامل استفاده کنید (با توابع -i,-d,-s,-x).<br>برای تشخیص نام سرویس نمونه‌ها، هر نام سرویس شامل مقدار نام میزبان از مقدار مشخص شده می‌شود. فایل پیکربندی.| |**فقط عامل ویندوز (توابع)**|<| |-i --install|Install Zabbix Windows agent as service| |-d --uninstall|حذف سرویس عامل ویندوز Zabbix| |-s --start|راه اندازی سرویس عامل ویندوز Zabbix| |-x --stop|توقف سرویس عامل ویندوز Zabbix| **نمونه*های خاص استفاده از پارامترهای خط فرمان: - چاپ تمام آیتم های عامل داخلی با مقادیر - تست یک پارامتر کاربر با کلید "mysql.ping" تعریف شده در فایل پیکربندی مشخص شده - نصب سرویس "Zabbix Agent" برای ویندوز با استفاده از پیش فرض مسیر فایل پیکربندی c:\\zabbix\_agentd.conf - نصب سرویس "Zabbix Agent \[Hostname\]" برای ویندوز با استفاده از فایل پیکربندی zabbix\_agentd.conf واقع در همان پوشه را به عنوان یک عامل اجرایی کنید و نام سرویس را منحصر به فرد کنید گسترش آن با مقدار نام میزبان از فایل پیکربندی ```{=html} <!---> ``` zabbix_agentd --print zabbix_agentd -t "mysql.ping" -c /etc/zabbix/zabbix_agentd.conf zabbix_agentd.exe -i zabbix_agentd.exe -i -m -c zabbix_agentd.conf ### Other changes and bug fixes ### سایر تغییرات و رفع اشکال ##### Other expressions Function parameters may contain other expressions, as in the following syntax: min(min(/host/key,1h),min(/host2/key2,1h)*10) Note that other expressions may not be used, if the function references item history. For example, the following syntax is not allowed: ~~`min(/host/key,#5*10)`~~ ##### عبارات دیگر پارامترهای تابع ممکن است شامل عبارات دیگری مانند موارد زیر باشد نحو: دقیقه (دقیقه (/ میزبان / کلید، 1 ساعت)، دقیقه (/ میزبان 2 / کلید 2، 1 ساعت) * 10) توجه داشته باشید که اگر تابع ارجاع دهد، ممکن است از عبارات دیگر استفاده نشود تاریخچه آیتم به عنوان مثال، نحو زیر مجاز نیست: ~~`min(/host/key,#5*10)`~~ ### Other types of discovery More detail and how-tos on other types of out-of-the-box discovery is available in the following sections: - discovery of [network interfaces](/manual/discovery/low_level_discovery/examples/network_interfaces); - discovery of [CPUs and CPU cores](/manual/discovery/low_level_discovery/examples/cpu); - discovery of [SNMP OIDs](/manual/discovery/low_level_discovery/examples/snmp_oids); - discovery of [JMX objects](/manual/discovery/low_level_discovery/examples/jmx); - discovery using [ODBC SQL queries](/manual/discovery/low_level_discovery/examples/sql_queries); - discovery of [Windows services](/manual/discovery/low_level_discovery/examples/windows_services); - discovery of [host interfaces](/manual/discovery/low_level_discovery/examples/host_interfaces) in Zabbix. For more detail on the JSON format for discovery items and an example of how to implement your own file system discoverer as a Perl script, see [creating custom LLD rules](/manual/discovery/low_level_discovery/custom_rules). ### انواع دیگر کشف جزئیات بیشتر و نحوه انجام سایر انواع کشف خارج از جعبه است در بخش های زیر موجود است: - کشف [شبکه رابط ها](/دستی/کشف/کاوش_سطح_کم/مثال/رابط_شبکه); - کشف [CPU و CPU هسته ها](/دستی/کشف/کاوش_سطح_کم/examples/cpu); - کشف [SNMP OIDs](/manual/discovery/low_level_discovery/examples/snmp_oids); - کشف [JMX اشیاء](/دستی/کشف/کاوش_سطح_کم/مثال/jmx); - کشف با استفاده از [ODBC SQL پرس و جو](/دستی/کشف/کاوش_سطح_کم/examples/sql_queries); - کشف [ویندوز خدمات](/دستی/کشف/کاوش_سطح_کم/نمونه/سرویسهای_ویندوز); - کشف [میزبان رابط‌ها](/دستی/کشف/کاوش_سطح_کم/نمونه‌ها/اینترفیس_هاست) در Zabbix. برای جزئیات بیشتر در مورد فرمت JSON برای موارد کشف و نمونه ای از چگونه کشف کننده سیستم فایل خود را به عنوان یک اسکریپت Perl پیاده سازی کنید، ببینید [ایجاد قوانین LLD سفارشی](/manual/discovery/low_level_discovery/custom_rules). #### Output value JSONPaths can be divided in definite and indefinite paths. A definite path can return only null or a single match. An indefinite path can return multiple matches, basically JSONPaths with detached, multiple name/index list, array slice or expression segments. However, when a function is used the JSONPath becomes definite, as functions always output single value. A definite path returns the object/array/value it's referencing, while indefinite path returns an array of the matched objects/arrays/values. ::: noteimportant The property order in JSONPath query results may not align with the original JSON property order due to internal optimization methods. For example, the JSONPath `$.books[1]["author", "title"]` may return `["title", "author"]`. If preserving the original property order is essential, alternative post-query processing methods should be considered. ::: #### مقدار خروجی JSONPaths را می توان به مسیرهای معین و نامحدود تقسیم کرد. یک قطعی مسیر فقط می تواند null یا یک تطابق را برگرداند. یک مسیر نامشخص می تواند منطبق‌های متعدد، اساساً JSONPaths با جدا، چندگانه را برمی‌گرداند لیست نام / فهرست، قطعه آرایه یا بخش های عبارت. با این حال، زمانی که یک از تابع استفاده می شود، JSONPath مانند توابع همیشه مشخص می شود مقدار واحد خروجی یک مسیر معین، شی/آرایه/مقداری را که به آن ارجاع می دهد، برمی گرداند مسیر نامشخص آرایه ای از اشیاء/آرایه ها/مقدارهای همسان را برمی گرداند. ::: نکته مهم ممکن است به دلیل روش‌های بهینه‌سازی داخلی، ترتیب ویژگی در نتایج جستجوی JSONPath با ترتیب ویژگی اصلی JSON مطابقت نداشته باشد. برای مثال، JSONPath `$.books[1]["author"، "title"]" ممکن است "["title"، "author"]" را برگرداند. اگر حفظ سفارش اصلی ضروری است، روش های پردازش پس از پرس و جو جایگزین باید در نظر گرفته شود. ::: #### Overview Aggregate calculations are a [calculated item](/manual/config/items/itemtypes/calculated) type allowing to collect information from several items by Zabbix server and then calculate an aggregate, depending on the aggregate function used. Only unsigned integer and float values (type of information) are supported for aggregate calculation items. Aggregate calculations do not require any agent running on the host being monitored. #### بررسی اجمالی محاسبات انبوه یک [محاسبه محاسبه شده] است (/دستی/پیکربندی/ایتم/مجموعه/محاسبه) نوع اجازه جمع آوری اطلاعات از چندین مورد توسط سرور Zabbix و سپس یک مجموع را، بسته به تابع مجموع مورد استفاده، محاسبه کنید. فقط مقادیر صحیح بدون علامت و مقادیر شناور (نوع اطلاعات) برای محاسبه انبوه پشتیبانی می شوند موارد. محاسبات انبوه به هیچ عاملی که روی میزبان اجرا می شود نیاز ندارد تحت نظارت است. #### Overview As an alternative to setting up manually or reusing an existing server for Zabbix, users may [download](http://www.zabbix.com/download_appliance) a Zabbix appliance or a Zabbix appliance installation CD image. Zabbix appliance and installation CD versions are based on AlmaLinux 8 (x86\_64). Zabbix appliance installation CD can be used for instant deployment of Zabbix server (MySQL). ::: noteimportant You can use this Appliance to evaluate Zabbix. The Appliance is not intended for serious production use. ::: #### بررسی اجمالی به عنوان جایگزینی برای راه اندازی دستی یا استفاده مجدد از سرور موجود برای Zabbix، کاربران ممکن است [دانلود](http://www.zabbix.com/download_appliance) یک دستگاه Zabbix یا یک تصویر سی دی نصب دستگاه Zabbix. نسخه های سی دی دستگاه و نصب Zabbix بر اساس AlmaLinux 8 هستند (x86\_64). سی دی نصب دستگاه Zabbix را می توان برای استقرار فوری استفاده کرد سرور Zabbix (MySQL). ::: نکته مهم شما می توانید از این Appliance برای ارزیابی Zabbix استفاده کنید. دستگاه برای استفاده جدی در تولید در نظر گرفته نشده است. ::: #### Overview A vertical menu in a sidebar provides access to various Zabbix frontend sections. The menu is dark blue in the default theme. ![](../../../assets/en/manual/introduction/vertical_menu.png){width="600"} #### بررسی اجمالی یک منوی عمودی در یک نوار کناری، دسترسی به قسمت های مختلف Zabbix را فراهم می کند. منو در قالب پیش فرض آبی تیره است. ![](../../../assets/en/manual/introduction/vertical_menu.png){width="600"} #### Overview Change of trigger status is the most frequent and most important source of events. Each time the trigger changes its state, an event is generated. The event contains details of the trigger state's change - when it happened and what the new state is. Two types of events are created by triggers - Problem and OK. #### بررسی اجمالی تغییر وضعیت ماشه شایع ترین و مهم ترین منبع است از رویدادها هر بار که ماشه حالت خود را تغییر می دهد، یک رویداد است تولید شده است. این رویداد حاوی جزئیات تغییر حالت ماشه است - چه زمانی اتفاق افتاد و وضعیت جدید چگونه است. دو نوع رویداد توسط تریگرها ایجاد می شوند - مشکل و OK. #### Overview Configuring a template requires that you first create a template by defining its general parameters and then you add entities (items, triggers, graphs, etc.) to it. #### بررسی اجمالی پیکربندی یک الگو مستلزم آن است که ابتدا یک الگو توسط پارامترهای کلی آن را تعریف کنید و سپس موجودیت ها را اضافه کنید (اقلام، محرک ها، نمودارها، و غیره) به آن. #### Overview Foreach functions are used in [aggregate calculations](/manual/config/items/itemtypes/calculated/aggregate) to return one aggregate value for each item that is selected by the used **item filter**. An array of values is returned. For example, the *avg_foreach* function will return an array of values, where each value is the *average* history value of the selected item, during the time interval that is specified. The [item filter](#item-filter-syntax) is part of the syntax used by foreach functions. The use of wildcards is supported in the item filter, thus the required items can be selected quite flexibly. #### بررسی اجمالی توابع Foreach در [محاسبات مجموع](/manual/config/items/itemtypes/calculated/aggregate) برای برگرداندن یک مقدار مجموع برای هر موردی که توسط **فیلتر مورد استفاده** انتخاب می شود استفاده می شود. آرایه ای از مقادیر برگردانده می شود. به عنوان مثال، تابع *avg_foreach* آرایه ای از مقادیر را برمی گرداند، که در آن هر مقدار مقدار *متوسط* تاریخ مورد انتخاب شده، در بازه زمانی مشخص شده است. [item filter] (#item-filter-syntax) بخشی از نحوی است که توسط توابع foreach استفاده می‌شود. استفاده از حروف عام در فیلتر مورد پشتیبانی می شود، بنابراین موارد مورد نیاز را می توان کاملاً انعطاف پذیر انتخاب کرد. ### Overview High availability (HA) is typically required in critical infrastructures that can afford virtually no downtime. So for any service that may fail there must be a failover option in place to take over should the current service fail. Zabbix offers a **native** high-availability solution that is easy to set up and does not require any previous HA expertise. Native Zabbix HA may be useful for an extra layer of protection against software/hardware failures of Zabbix server or to have less downtime due to maintenance. In the Zabbix high availability mode multiple Zabbix servers are run as nodes in a cluster. While one Zabbix server in the cluster is active, others are on standby, ready to take over if necessary. ![](../../../../assets/en/manual/config/zabbix_ha.png) Switching to Zabbix HA is non-committal. You may switch back to standalone operation at any point. See also: [Implementation details](#implementation-details) ### بررسی اجمالی در دسترس بودن بالا (HA) معمولاً در زیرساخت های حیاتی مورد نیاز است که تقریباً نمی تواند از پس هیچ زمان خرابی برآید. بنابراین برای هر سرویسی که ممکن است شکست بخورد، باید یک گزینه Failover برای تصاحب وجود داشته باشد اگر سرویس فعلی از کار بیفتد. Zabbix یک راه حل **بومی** با در دسترس بودن بالا ارائه می دهد که به راحتی قابل استفاده است راه اندازی شده و به هیچ تخصص قبلی HA نیاز ندارد. بومی Zabbix HA ممکن است برای یک لایه حفاظتی اضافی در برابر نرم افزار/سخت افزار مفید باشد خرابی سرور Zabbix یا خرابی کمتر به دلیل نگهداری. در حالت دسترسی بالا Zabbix چندین سرور Zabbix به عنوان اجرا می شود گره ها در یک خوشه در حالی که یک سرور Zabbix در خوشه فعال است، دیگران در حالت آماده باش هستند و در صورت لزوم آماده هستند تا مسئولیت را بر عهده بگیرند. ![](../../../../assets/en/manual/config/zabbix_ha.png) تغییر به Zabbix HA غیر تعهدی است. ممکن است به حالت مستقل برگردید عملیات در هر نقطه همچنین ببینید: [جزئیات پیاده سازی] (#implementation-details) #### Overview Hosts are [exported](/manual/xml_export_import) with many related objects and object relations. Host export contains: - linked host groups - host data - template linkage - host group linkage - host interfaces - directly linked items - directly linked triggers - directly linked graphs - directly linked discovery rules with all prototypes - directly linked web scenarios - host macros - host inventory data - value maps #### مرور اجمالی هاست ها به همراه موارد زیادی خروجی گرفته می شود . خروجی هاست ها شامل : - linked host groups - host data - template linkage - host group linkage - host interfaces - directly linked items - directly linked triggers - directly linked graphs - directly linked discovery rules with all prototypes - directly linked web scenarios - host macros - host inventory data - value maps #### Overview In *Monitoring → Problems* you can see what problems you currently have. Problems are those triggers that are in the "Problem" state. ![](../../../../../assets/en/manual/web_interface/problems.png){width="600"} |Column|Description| |--|-----------| |*Time*|Problem start time is displayed.| |*Severity*|Problem severity is displayed.<br>Problem severity is originally based on the severity of the underlying problem trigger, however, after the event has happened it can be updated using the *Update problem* [screen](/manual/acknowledges#updating_problems). Color of the problem severity is used as cell background during problem time.| |*Recovery time*|Problem resolution time is displayed.| |*Status*|Problem status is displayed:<br>**Problem** - unresolved problem<br>**Resolved** - recently resolved problem. You can hide recently resolved problems using the filter.<br>New and recently resolved problems blink for 2 minutes. Resolved problems are displayed for 5 minutes in total. Both of these values are configurable in *Administration* → *General* → *[Trigger displaying options](/manual/web_interface/frontend_sections/administration/general#trigger_displaying_options)*.| |*Info*|A green information icon is displayed if a problem is closed by global correlation or manually when updating the problem. Rolling a mouse over the icon will display more details:<br>![info.png](../../../../../assets/en/manual/web_interface/info.png)<br>The following icon is displayed if a suppressed problem is being shown (see *Show suppressed problems* option in the filter). Rolling a mouse over the icon will display more details:<br>![](../../../../../assets/en/manual/web_interface/info_suppressed2.png)| |*Host*|Problem host is displayed.| |*Problem*|Problem name is displayed.<br>Problem name is based on the name of the underlying problem trigger.<br>Macros in the trigger name are resolved at the time of the problem happening and the resolved values do not update any more.<br>*Note* that it is possible to append the problem name with [operational data](#operational_data_of_problems) showing some latest item values.<br>Clicking on the problem name brings up the [event menu](#event_menu).<br>Hovering on the ![](../../../../../assets/en/manual/web_interface/item_description_icon.png) icon after the problem name will bring up the trigger description (for those problems that have it).| |*Operational data*|[Operational data](#operational_data_of_problems) are displayed containing latest item values.<br>Operational data can be a combination of text and item value macros if configured on a trigger level. If no operational data is configured on a trigger level, the latest values of all items from the expression are displayed.<br>This column is only displayed if *Separately* is selected for *Show operational data* in the filter.| |*Duration*|Problem duration is displayed.<br>See also: [Negative problem duration](#negative_problem_duration)| |*Ack*|The acknowledgment status of the problem is displayed:<br>**Yes** - green text indicating that the problem is acknowledged. A problem is considered to be acknowledged if all events for it are acknowledged.<br>**No** - a red link indicating unacknowledged events.<br>If you click on the link you will be taken to the [problem update](/manual/acknowledges#updating_problems) screen where various actions can be taken on the problem, including commenting and acknowledging the problem.| |*Actions*|History of activities about the problem is displayed using symbolic icons:<br>![icon\_comment.png](../../../../../assets/en/manual/web_interface/frontend_sections/monitoring/icon_comment.png) - comments have been made. The number of comments is also displayed.<br>![icon\_sev\_up1.png](../../../../../assets/en/manual/web_interface/frontend_sections/monitoring/icon_sev_up1.png) - problem severity has been increased (e.g. Information → Warning)<br>![icon\_sev\_down1.png](../../../../../assets/en/manual/web_interface/frontend_sections/monitoring/icon_sev_down1.png) - problem severity has been decreased (e.g. Warning → Information)<br>![icon\_severity\_back.png](../../../../../assets/en/manual/web_interface/frontend_sections/monitoring/icon_severity_back.png) - problem severity has been changed, but returned to the original level (e.g. Warning → Information → Warning)<br>![icon\_actions.png](../../../../../assets/en/manual/web_interface/frontend_sections/monitoring/icon_actions.png) - actions have been taken. The number of actions is also displayed.<br>![icon\_actions\_progress1.png](../../../../../assets/en/manual/web_interface/frontend_sections/monitoring/icon_actions_progress1.png) - actions have been taken, at least one is in progress. The number of actions is also displayed.<br>![icon\_actions\_failed.png](../../../../../assets/en/manual/web_interface/frontend_sections/monitoring/icon_actions_failed.png) - actions have been taken, at least one has failed. The number of actions is also displayed.<br>When rolling the mouse over the icons, popups with details about the activity are displayed. See [viewing details](#Viewing_details) to learn more about icons used in the popup for actions taken.| |*Tags*|[Tags](/manual/config/tagging) are displayed (if any).<br>In addition, tags from an external ticketing system may also be displayed (see the *Process tags* option when configuring [webhooks](/manual/config/notifications/media/webhook)).| #### بررسی اجمالی در *مانیتورینگ → مشکلات* می توانید ببینید که در حال حاضر چه مشکلاتی دارید. مشکلات آن دسته از محرک هایی هستند که در حالت "مشکل" هستند. ![](../../../../../assets/en/manual/web_interface/problems.png){width="600"} |ستون|توضیحات| |--|-----------| |*زمان*|زمان شروع مشکل نمایش داده می شود.| |*شدت*|شدت مشکل نمایش داده می‌شود.<br>شدت مشکل در اصل بر اساس شدت عامل اصلی مشکل است، اما پس از وقوع رویداد می‌توان آن را با استفاده از *به‌روزرسانی مشکل* [صفحه](/manual به‌روزرسانی کرد. /تصدیق#مشکلات_به روز رسانی). رنگ شدت مشکل به عنوان پس زمینه سلول در زمان مشکل استفاده می شود.| |*زمان بازیابی*|زمان حل مشکل نمایش داده می شود.| |*وضعیت*|وضعیت مشکل نمایش داده می شود:<br>**مشکل** - مشکل حل نشده<br>**حل شده** - مشکل اخیراً حل شده است. می‌توانید مشکلات حل‌شده اخیر را با استفاده از فیلتر پنهان کنید.<br>مشکلات جدید و اخیراً حل‌شده به مدت ۲ دقیقه چشمک می‌زنند. مشکلات حل شده در کل به مدت 5 دقیقه نمایش داده می شوند. هر دوی این مقادیر در *Administration* → *General* → *[Trigger displaying options](/manual/web_interface/frontend_sections/administration/general#trigger_displaying_options)* قابل تنظیم هستند.| |*اطلاعات*|اگر مشکلی با همبستگی کلی یا به صورت دستی هنگام به روز رسانی مشکل بسته شود، یک نماد اطلاعات سبز نشان داده می شود. با چرخاندن ماوس روی نماد، جزئیات بیشتری نمایش داده می‌شود:<br>![info.png](../../../../../assets/en/manual/web_interface/info.png)<br >در صورت نمایش یک مشکل سرکوب شده، نماد زیر نمایش داده می شود (به گزینه *نمایش مشکلات سرکوب شده* در فیلتر مراجعه کنید). با چرخاندن ماوس روی نماد، جزئیات بیشتری نمایش داده می‌شود:<br>![](../../../../../assets/en/manual/web_interface/info_suppressed2.png)| |*میزبان*|میزبان مشکل نمایش داده می شود.| |*مشکل*|نام مشکل نمایش داده می‌شود.<br>نام مشکل بر اساس نام راه‌انداز مشکل اساسی است.<br>ماکروهای موجود در نام راه‌انداز در زمان بروز مشکل حل می‌شوند و مقادیر حل‌شده به‌روزرسانی نمی‌شوند. دیگر.<br>*توجه داشته باشید* که می‌توان نام مشکل را با [اطلاعات عملیاتی](#operational_data_of_problems) اضافه کرد که برخی از آخرین مقادیر مورد را نشان می‌دهد.<br>با کلیک بر روی نام مشکل، [ منوی رویداد] ظاهر می‌شود (# event_menu).<br>روی نماد ![](../../../../../assets/en/manual/web_interface/item_description_icon.png) بعد از نام مشکل، ماشه را نشان می دهد. توضیحات (برای مشکلاتی که آن را دارند).| |*داده های عملیاتی*|[Operational data](#operational_data_of_problems) حاوی آخرین مقادیر مورد نمایش داده می شود.<br>داده های عملیاتی می توانند ترکیبی از متن و ماکروهای مقدار مورد باشند، اگر در سطح راه اندازی پیکربندی شوند. اگر هیچ داده عملیاتی در سطح ماشه پیکربندی نشده باشد، آخرین مقادیر همه موارد از عبارت نمایش داده می شود.<br>این ستون تنها در صورتی نمایش داده می شود که *به طور جداگانه* برای *نمایش داده های عملیاتی* در فیلتر انتخاب شده باشد.| |*مدت*|مدت زمان مشکل نمایش داده می شود.<br>همچنین ببینید: [مدت زمان مشکل منفی](#negative_problem_duration)| |*Ack*|وضعیت تأیید مشکل نمایش داده می‌شود:<br>**بله** - متن سبز رنگ که نشان می‌دهد مشکل تأیید شده است. اگر همه رویدادهای مربوط به آن تأیید شوند، یک مشکل تأیید شده در نظر گرفته می شود.<br>**خیر** - یک پیوند قرمز که رویدادهای تأیید نشده را نشان می دهد.<br>اگر روی پیوند کلیک کنید، به [به روز رسانی مشکل] هدایت می شوید. صفحه نمایش (/manual/acknowledges#updating_problems) که در آن می توان اقدامات مختلفی را برای حل مشکل انجام داد، از جمله اظهار نظر و تأیید مشکل.| |*اقدامات*|تاریخچه فعالیت های مربوط به مشکل با استفاده از نمادهای نمادین نمایش داده می شود:<br>![icon\_comment.png](../../../../../assets/en/manual/ web_interface/frontend_sections/monitoring/icon_comment.png) - نظرات داده شده است. تعداد نظرات نیز نمایش داده می شود.<br>![icon\_sev\_up1.png](../../../../../assets/en/manual/web_interface/frontend_sections/monitoring/icon_sev_up1 .png) - شدت مشکل افزایش یافته است (به عنوان مثال اطلاعات → هشدار)<br>![icon\_sev\_down1.png](../../../../../assets/en/manual/ web_interface/frontend_sections/monitoring/icon_sev_down1.png) - شدت مشکل کاهش یافته است (به عنوان مثال هشدار → اطلاعات)<br>![icon\_severity\_back.png](../../../../.. /assets/en/manual/web_interface/frontend_sections/monitoring/icon_severity_back.png) - شدت مشکل تغییر کرده است، اما به سطح اصلی بازگشته است (به عنوان مثال هشدار → اطلاعات → هشدار)<br>![icon\_actions.png]( ../../../../../assets/en/manual/web_interface/frontend_sections/monitoring/icon_actions.png) - اقدامات انجام شده است. تعداد اقدامات نیز نمایش داده می شود.<br>![icon\_actions\_progress1.png](../../../../../assets/en/manual/web_interface/frontend_sections/monitoring/icon_actions_progress1 .png) - اقدامات انجام شده است، حداقل یکی در حال انجام است. تعداد اقدامات نیز نمایش داده می شود.<br>![icon\_actions\_failed.png](../../../../../assets/en/manual/web_interface/frontend_sections/monitoring/icon_actions_failed .png) - اقدامات انجام شده است، حداقل یکی شکست خورده است. تعداد اقدامات نیز نمایش داده می‌شود.<br>هنگامی که ماوس را روی نمادها می‌چرخانید، پنجره‌های بازشو با جزئیات مربوط به فعالیت نمایش داده می‌شوند. برای اطلاعات بیشتر درباره نمادهای مورد استفاده در پنجره بازشو برای اقدامات انجام شده، به [مشاهده جزئیات](#Viewing_details) مراجعه کنید.| |*برچسب‌ها*|[برچسب‌ها](/manual/config/tagging) نمایش داده می‌شوند (در صورت وجود).<br>علاوه بر این، برچسب‌ها از یک سیستم فروش بلیط خارجی نیز ممکن است نمایش داده شوند (گزینه *برچسب‌های فرآیند* را هنگام پیکربندی [ مشاهده کنید] webhooks](/manual/config/notifications/media/webhook)).| #### Overview In the *Monitoring → Maps* section you can configure, manage and view [network maps](/manual/config/visualization/maps). When you open this section, you will either see the last map you accessed or a listing of all maps you have access to. All maps can be either public or private. Public maps are available to all users, while private maps are accessible only to their owner and the users the map is shared with. #### بررسی اجمالی در بخش *Monitoring → Maps* می توانید پیکربندی، مدیریت و مشاهده کنید [نقشه های شبکه](/دستی/پیکربندی/تجسم/نقشه). وقتی این بخش را باز می کنید، آخرین نقشه خود را می بینید دسترسی داشته باشید یا فهرستی از همه نقشه هایی که به آنها دسترسی دارید. همه نقشه ها می توانند عمومی یا خصوصی باشند. نقشه های عمومی در دسترس هستند همه کاربران، در حالی که نقشه های خصوصی فقط برای مالک و مالک آنها قابل دسترسی است کاربرانی که نقشه با آنها به اشتراک گذاشته می شود. #### Overview It is possible to make some internal metrics of Zabbix server and proxy accessible remotely by another Zabbix instance or a third-party tool. This can be useful so that supporters/service providers can monitor their client Zabbix servers/proxies remotely or, in organizations where Zabbix is not the main monitoring tool, that Zabbix internal metrics can be monitored by a third-party system in an umbrella-monitoring setup. Zabbix internal stats are exposed to a configurable set of addresses listed in the new 'StatsAllowedIP' [server](/manual/appendix/config/zabbix_server)/[proxy](/manual/appendix/config/zabbix_proxy) parameter. Requests will be accepted only from these addresses. #### بررسی اجمالی امکان ایجاد برخی معیارهای داخلی سرور و پروکسی Zabbix وجود دارد از راه دور توسط یک نمونه دیگر Zabbix یا یک ابزار شخص ثالث قابل دسترسی است. این می تواند مفید باشد تا حامیان/ارائه دهندگان خدمات بتوانند نظارت کنند سرویس دهنده ها/پراکسی های Zabbix مشتری آنها از راه دور یا در سازمان هایی که در آن Zabbix ابزار نظارتی اصلی نیست که معیارهای داخلی Zabbix می توانند توسط یک سیستم شخص ثالث در یک راه اندازی نظارت چتری نظارت شود. آمار داخلی Zabbix در معرض مجموعه ای از آدرس های قابل تنظیم است فهرست شده در «StatsAllowedIP» جدید [server](/manual/appendix/config/zabbix_server)/[proxy](/manual/appendix/config/zabbix_proxy) پارامتر. درخواست فقط از این آدرس ها پذیرفته می شود. #### Overview Kerberos authentication can be used in web monitoring and HTTP items in Zabbix since version 4.4.0. This section describes an example of configuring Kerberos with Zabbix server to perform web monitoring of `www.example.com` with user 'zabbix'. #### بررسی اجمالی احراز هویت Kerberos را می توان در نظارت بر وب و موارد HTTP در آن استفاده کرد Zabbix از نسخه 4.4.0. این بخش نمونه ای از پیکربندی Kerberos با Zabbix را توضیح می دهد سرور برای انجام نظارت بر وب «www.example.com» با کاربر 'zabbix'. #### Overview Media types are [exported](/manual/xml_export_import) with all related objects and object relations. #### مرور Media types are [exported](/manual/xml_export_import) with all related objects and object relations. #### Overview Network map [export](/manual/xml_export_import) contains: - all related images - map structure - all map settings, all contained elements with their settings, map links and map link status indicators ::: notewarning Any host groups, hosts, triggers, other maps or other elements that may be related to the exported map are not exported. Thus, if at least one of the elements the map refers to is missing, importing it will fail. ::: Network map export/import is supported since Zabbix 1.8.2. #### کلیات Network map [export](/manual/xml_export_import) contains: - all related images - map structure - all map settings, all contained elements with their settings, map links and map link status indicators ::: notewarning Any host groups, hosts, triggers, other maps or other elements that may be related to the exported map are not exported. Thus, if at least one of the elements the map refers to is missing, importing it will fail. ::: Network map export/import is supported since Zabbix 1.8.2. #### Overview Problem events in Zabbix can be acknowledged by users. If a user gets notified about a problem event, they can go to Zabbix frontend, open the problem update popup window of that problem using one of the ways listed below and acknowledge the problem. When acknowledging, they can enter their comment for it, saying that they are working on it or whatever else they may feel like saying about it. This way, if another system user spots the same problem, they immediately see if it has been acknowledged and the comments so far. This way the workflow of resolving problems with more than one system user can take place in a coordinated way. Acknowledgment status is also used when defining [action operations](/manual/config/notifications/action/operation). You can define, for example, that a notification is sent to a higher level manager only if an event is not acknowledged for some time. To acknowledge events and comment on them, a user must have at least read permissions to the corresponding triggers. To change problem severity or close problem, a user must have read-write permissions to the corresponding triggers. There are **several** ways to access the problem update popup window, which allows acknowledging a problem. - You may select problems in *Monitoring* → *Problems* and then click on *Mass update* below the list - You can click in the *Ack* column showing the acknowledgment status of problems in: - *Monitoring → Dashboard* (*Problems* and *Problems by severity* widgets) - *Monitoring → Problems* - *Monitoring → Problems → Event details* The *Ack* column contains either a 'Yes' or a 'No' link, indicating an acknowledged or an unacknowledged problem respectively. Clicking on the links will take you to the problem update popup window. - You can click on an unresolved problem cell in: - *Monitoring → Dashboard* (*Trigger overview* widget) The popup menu contains an *Acknowledge* option that will take you to the problem update window. #### بررسی اجمالی رویدادهای مشکل در Zabbix توسط کاربران قابل تایید است. اگر کاربر در مورد یک رویداد مشکل مطلع شود، می تواند به Zabbix برود frontend، پنجره بازشو به روز رسانی مشکل آن مشکل را با استفاده از یکی باز کنید از راه های ذکر شده در زیر و تصدیق مشکل. چه زمانی با اذعان، می توانند نظر خود را برای آن وارد کنند و بگویند که هستند کار کردن روی آن یا هر چیز دیگری که ممکن است دوست داشته باشند در مورد آن بگویند. به این ترتیب، اگر کاربر دیگری از سیستم متوجه همان مشکل شود، آنها فورا ببینید آیا تایید شده است و نظرات تا کنون. به این ترتیب گردش کار حل مشکلات با بیش از یک سیستم کاربر می تواند به صورت هماهنگ انجام شود. هنگام تعریف [عمل، وضعیت تصدیق نیز استفاده می شود عملیات](/دستی/پیکربندی/اعلان‌ها/عملیات/عملیات). تو می توانی برای مثال تعریف کنید که یک اعلان به سطح بالاتر ارسال می شود مدیر تنها در صورتی که یک رویداد برای مدتی تایید نشده باشد. برای تأیید رویدادها و اظهار نظر در مورد آنها، یک کاربر باید حداقل داشته باشد خواندن مجوزها برای محرک های مربوطه. برای تغییر مشکل مشکل یا مشکل، کاربر باید مجوز خواندن و نوشتن داشته باشد محرک های مربوطه **چند راه** برای دسترسی به پنجره بازشو به روز رسانی مشکل وجود دارد، که اجازه می دهد تا یک مشکل را تصدیق کنید. - می توانید مشکلات را در *Monitoring* → *Problems* انتخاب کنید و سپس کلیک کنید در *به روز رسانی انبوه* در زیر لیست - می توانید در ستون *Ack* که وضعیت تایید را نشان می دهد کلیک کنید مشکلات در: - *نظارت → داشبورد* (*مشکلات* و *مشکلات بر اساس شدت* ویجت ها) - *نظارت → مشکلات* - *نظارت → مشکلات → جزئیات رویداد* ستون *Ack* حاوی یک پیوند "بله" یا "خیر" است که نشان دهنده یک است به ترتیب یک مشکل تایید شده یا تایید نشده. با کلیک بر روی پیوندها شما را به پنجره بازشو به روز رسانی مشکل می برند. - می توانید روی یک سلول مشکل حل نشده کلیک کنید: - *مانیتورینگ → داشبورد* (*نمایش کلی ماشه* ویجت) منوی بازشو حاوی یک گزینه *Acknowledge* است که شما را به آن می برد پنجره به روز رسانی مشکل #### Overview Receiving notifications on unsupported items is supported since Zabbix 2.2. It is part of the concept of internal events in Zabbix, allowing users to be notified on these occasions. [Internal events](/manual/config/events/sources#internal-events) reflect a change of state: - when items go from 'normal' to 'unsupported' (and back) - when triggers go from 'normal' to 'unknown' (and back) - when low-level discovery rules go from 'normal' to 'unsupported' (and back) This section presents a how-to for **receiving notification** when an item turns unsupported. #### بررسی اجمالی دریافت اعلان در مورد موارد پشتیبانی نشده از Zabbix پشتیبانی می شود 2.2. این بخشی از مفهوم رویدادهای داخلی در Zabbix است که به کاربران اجازه می دهد در این مواقع اطلاع رسانی شود. [رویدادهای داخلی](/manual/config/events/sources#internal-events) منعکس کننده تغییر حالت: - وقتی آیتم‌ها از «عادی» به «پشتیبانی نشده» می‌شوند (و برمی‌گردند) - زمانی که محرک ها از "عادی" به "ناشناخته" می روند (و برمی گردند) - زمانی که قوانین کشف سطح پایین از "عادی" به "پشتیبانی نشده" تبدیل می شوند (و برگشت) این بخش روشی را برای **دریافت اعلان** ارائه می دهد مورد پشتیبانی نمی شود. #### Overview Server - proxy data exchange is based on JSON format. Request and response messages must begin with [header and data length](/manual/appendix/protocols/header_datalen). #### بررسی اجمالی تبادل اطلاعات سرور - پروکسی بر اساس فرمت JSON است. پیام‌های درخواست و پاسخ باید با [سرصفحه و داده‌ها شروع شوند طول](/دستی/ضمیمه/پروتکل/هدر_داده). #### Overview Sometimes you may want to run an agent check that does not come predefined with Zabbix. This is where user parameters come to help. You may write a command that retrieves the data you need and include it in the user parameter in the [agent configuration file](/manual/appendix/config/zabbix_agentd) ('UserParameter' configuration parameter). A user parameter has the following syntax: UserParameter=<key>,<command> As you can see, a user parameter also contains a key. The key will be necessary when configuring an item. Enter a key of your choice that will be easy to reference (it must be unique within a host). Restart the agent or use the agent [runtime control](/manual/concepts/agent#runtime_control) option to pick up the new parameter, e. g.: zabbix_agentd -R userparameter_reload Then, when [configuring an item](item), enter the key to reference the command from the user parameter you want executed. User parameters are commands executed by Zabbix agent. Note that up to 16MB of data can be returned before [item value preprocessing](/manual/config/items/preprocessing) steps. **/bin/sh** is used as a command line interpreter under UNIX operating systems. User parameters obey the agent check timeout; if timeout is reached the forked user parameter process is terminated. See also: - [Step-by-step tutorial](/manual/config/items/userparameters/extending_agent) on making use of user parameters - [Command execution](/manual/appendix/command_execution) #### بررسی اجمالی گاهی اوقات ممکن است بخواهید یک چک عاملی را اجرا کنید که نمی آید با Zabbix از پیش تعریف شده است. اینجاست که پارامترهای کاربر به کمک می آیند. شما می توانید دستوری بنویسید که داده های مورد نیاز شما را بازیابی کرده و در آن قرار دهد در پارامتر کاربر در پیکربندی [agent file](/manual/appendix/config/zabbix_agentd) ('UserParameter' پارامتر پیکربندی). یک پارامتر کاربر دارای نحو زیر است: UserParameter=<key>,<command> همانطور که می بینید، یک پارامتر کاربر همچنین حاوی یک کلید است. کلید خواهد بود هنگام پیکربندی یک آیتم ضروری است. کلید دلخواه خود را وارد کنید ارجاع آسان باشد (باید در یک میزبان منحصر به فرد باشد). عامل را مجددا راه اندازی کنید یا از عامل [runtime control](/manual/concepts/agent#runtime_control) گزینه ای برای انتخاب پارامتر جدید، e. g.: zabbix_agentd -R userparameter_reload سپس، هنگام [پیکربندی یک آیتم] (مورد)، کلیدی را برای ارجاع به آن وارد کنید دستور از پارامتر کاربری که می خواهید اجرا شود. پارامترهای کاربر دستوراتی هستند که توسط عامل Zabbix اجرا می شوند. توجه داشته باشید که تا 16 مگابایت داده را می توان قبل از مراحل [preprocessing مقدار مورد](/manual/config/items/preprocessing) برگرداند. **/bin/sh** به عنوان مفسر خط فرمان تحت سیستم عامل های یونیکس استفاده می شود. پارامترهای کاربر از مهلت زمانی بررسی عامل تبعیت می کنند. در صورت رسیدن به مهلت، فرآیند پارامتر کاربر فوک شده خاتمه می یابد. همچنین ببینید: - [گام به گام tutorial](/manual/config/items/userparameters/extending_agent) در استفاده از پارامترهای کاربر - [اجرای فرمان](/دستی/ضمیمه/فرمان_اجرا) #### Overview Templates are [exported](/manual/xml_export_import) with many related objects and object relations. Template export contains: - linked host groups - template data - linkage to other templates - linkage to host groups - directly linked items - directly linked triggers - directly linked graphs - directly linked dashboards - directly linked discovery rules with all prototypes - directly linked web scenarios - value maps #### بررسی اجمالی الگوها شامل موارد ذیل و بسیاری از روابط بین اجزا (Objects)می باشند : [exported](/manual/xml_export_import) خروجی الگو ها شامل موارد ذیل است: - گروه های میزبان مرتبط - داده های قالب - پیوند به قالب های دیگر - ارتباط با گروه های میزبان - موارد مرتبط مستقیم - تریگر های مرتبط مستقیم - نمودارهای مرتبط مستقیم - داشبوردهای مرتبط مستقیم - قوانین کشف با تمام نمونه های اولیه - سناریوهای وب با پیوند مستقیم - ارتباطات مقادیر #### Overview The **memtype** parameter is supported on Linux, AIX, FreeBSD, and Solaris platforms. Three common values of 'memtype' are supported on all of these platforms: `pmem`, `rss` and `vsize`. Additionally, platform-specific 'memtype' values are supported on some platforms. #### بررسی اجمالی پارامتر **memtype** در لینوکس، AIX، FreeBSD و سکوهای سولاریس سه مقدار مشترک "memtype" در همه اینها پشتیبانی می شود پلتفرم‌ها: «pmem»، «rss» و «vsize». علاوه بر این، پلتفرم خاص مقادیر "memtype" در برخی از سیستم عامل ها پشتیبانی می شوند. #### Overview These checks use the communication with Zabbix agent for data gathering. There are [passive and active](/manual/appendix/items/activepassive) agent checks. When configuring an item, you can select the required type: - *Zabbix agent* - for passive checks - *Zabbix agent (active)* - for active checks #### بررسی اجمالی این چک ها از ارتباط با عامل Zabbix برای جمع آوری داده ها استفاده می کنند. [منفعل و فعال] وجود دارد (/دستی/ضمیمه/آیتم/فعال منفعل) چک های نمایندگی هنگام پیکربندی یک آیتم، می توانید موارد مورد نیاز را انتخاب کنید نوع: - *عامل Zabbix* - برای چک های غیرفعال - *عامل Zabbix (فعال)* - برای چک های فعال #### Overview This section contains a list of locations, where [user-definable](/manual/config/macros/user_macros) macros are supported. ::: noteclassic Only global-level user macros are supported for *Actions*, *Network discovery*, *Proxies* and all locations listed under *Other locations* section of this page. In the mentioned locations, host-level and template-level macros will not be resolved. ::: #### بررسی اجمالی این بخش شامل فهرستی از مکان‌ها است که در آن ماکروهای [قابل تعریف توسط کاربر](/manual/config/macros/user_macros) پشتیبانی. ::: نوتکلاسیک فقط ماکروهای کاربر سطح جهانی برای *Actions* پشتیبانی می شوند، *کشف شبکه*، *پراکسی*ها و همه مکان های فهرست شده در زیر *سایر بخش مکان*های این صفحه. در مکان های ذکر شده در سطح میزبان و ماکروهای سطح قالب حل نمی شوند. ::: #### Overview This section contains instructions for creating Oracle database and configuring connections between the database and Zabbix server, proxy, and frontend. #### بررسی اجمالی این بخش حاوی دستورالعمل هایی برای ایجاد پایگاه داده Oracle و پیکربندی اتصالات بین پایگاه داده و سرور Zabbix، پروکسی، و frontend #### Overview This section lists parameters supported in a Zabbix agent (Windows) configuration file (zabbix\_agentd.conf). Note that: - The default values reflect daemon defaults, not the values in the shipped configuration files; - Zabbix supports configuration files only in UTF-8 encoding without [BOM](https://en.wikipedia.org/wiki/Byte_order_mark); - Comments starting with "\#" are only supported in the beginning of the line. #### Overview This section lists parameters supported in the Ceph Zabbix agent 2 plugin configuration file (ceph.conf). Note that: - The default values reflect process defaults, not the values in the shipped configuration files; - Zabbix supports configuration files only in UTF-8 encoding without [BOM](https://en.wikipedia.org/wiki/Byte_order_mark); - Comments starting with "\#" are only supported at the beginning of the line. #### Overview This section provides details of supported JSONPath functionality in item value preprocessing steps. JSONPath consists of segments separated with dots. A segment can be either a simple word like a JSON value name, `*` or a more complex construct enclosed within square brackets `[` `]`. The separating dot before bracket segment is optional and can be omitted. For example: |Path|Description| |----|-----------| |`$.object.name`|Return the object.name contents.| |`$.object['name']`|Return the object.name contents.| |`$.object.['name']`|Return the object.name contents.| |`$["object"]['name']`|Return the object.name contents.| |`$.['object'].["name"]`|Return the object.name contents.| |`$.object.history.length()`|Return the number of object.history array elements.| |`$[?(@.name == 'Object')].price.first()`|Return the price field of the first object with name 'Object'.| |`$[?(@.name == 'Object')].history.first().length()`|Return the number of history array elements of the first object with name 'Object'.| |`$[?(@.price > 10)].length()`|Return the number of objects with price being greater than 10.| See also: [Escaping special characters from LLD macro values in JSONPath](/manual/config/items/preprocessing/jsonpath_functionality/escaping_lld_macros). #### بررسی اجمالی این بخش جزئیات عملکرد JSONPath را ارائه می دهد مراحل پیش پردازش ارزش آیتم JSONPath شامل بخش هایی است که با نقطه از هم جدا شده اند. یک بخش می تواند باشد یک کلمه ساده مانند نام مقدار JSON، «*» یا پیچیده تر ساختار محصور در داخل پرانتز "[` `]". نقطه جدا کننده قسمت قبل از براکت اختیاری است و می توان آن را حذف کرد. مثلا: |مسیر|توضیحات| |----|-----------| |`$.object.name`|محتوای object.name را برگردانید.| |`$.object['name']`|محتوای object.name را برگردانید.| |`$.object.['name']`|محتوای object.name را برگردانید.| |`$["object"]['name']`|محتوای object.name را برگردانید.| |`$.['object'].["name"]`|محتوای object.name را برگردانید.| |`$.object.history.length()`|تعداد عناصر آرایه object.history را برگردانید.| |`$[?(@.name == 'Object')].price.first()`|فیلد قیمت اولین شی را با نام 'Object' برگردانید.| |`$[?(@.name == 'Object')].history.first().length()`|تعداد عناصر آرایه تاریخ اولین شی با نام 'Object' را برگردانید.| |`$[?(@.price > 10)].length()`|تعداد اشیا با قیمت بیشتر از 10 را برگردانید.| همچنین ببینید: [گریز از کاراکترهای ویژه از مقادیر ماکرو LLD در JSONPath](/manual/config/items/preprocessing/jsonpath_functionality/escaping_lld_macros). #### Overview This section provides instructions on installing Zabbix web service and configuring Zabbix to enable generation of [scheduled reports](/manual/config/reports). ::: noteimportant Currently the support of scheduled reports is experimental. ::: #### بررسی اجمالی این بخش دستورالعمل‌هایی را در مورد نصب وب سرویس Zabbix و پیکربندی Zabbix برای فعال کردن تولید [گزارش‌های زمان‌بندی شده](/manual/config/reports) ارائه می‌کند. ::: نکته مهم در حال حاضر پشتیبانی از گزارش های برنامه ریزی شده آزمایشی است. ::: ### Overview This section provides several encryption configuration examples for CentOS 8.2 and MySQL 8.0.21 and can be used as a quickstart guide for encrypting the connection to the database.  ::: noteimportant If MySQL host is set to localhost, encryption options will not be available. In this case a connection between Zabbix frontend and the database uses a socket file (on Unix) or shared memory (on Windows) and cannot be encrypted. ::: ::: noteclassic List of encryption combinations is not limited to the ones listed on this page. There are a lot more combinations available. ::: ### بررسی اجمالی این بخش چندین نمونه پیکربندی رمزگذاری را برای شما ارائه می دهد CentOS 8.2 و MySQL 8.0.21 و می تواند به عنوان راهنمای شروع سریع برای رمزگذاری اتصال به پایگاه داده ::: نکته مهم اگر میزبان MySQL روی localhost تنظیم شده است، گزینه های رمزگذاری وجود نخواهد داشت در دسترس. در این مورد یک ارتباط بین زاببیکس frontend و پایگاه داده از یک فایل سوکت (در یونیکس) یا حافظه مشترک (در ویندوز) استفاده می کند و نمی توان رمزگذاری کرد ::: ::: نوتکلاسیک لیست رمزگذاری ترکیبات به موارد ذکر شده در این صفحه محدود نمی شود. وجود دارد ترکیبات بسیار بیشتری در دسترس است. ::: ### Overview This section provides several encryption configuration examples for CentOS 8.2 and PostgreSQL 13. ::: noteclassic Connection between Zabbix frontend and PostgreSQL cannot be encrypted (parameters in GUI are disabled), if the value of *Database host* field begins with a slash or the field is empty. ::: ### بررسی اجمالی این بخش چندین نمونه پیکربندی رمزگذاری را برای شما ارائه می دهد CentOS 8.2 و PostgreSQL 13. ::: نوتکلاسیک اتصال بین Zabbix frontend و PostgreSQL نمی تواند باشد رمزگذاری شده (پارامترها در رابط کاربری گرافیکی غیرفعال هستند)، اگر مقدار *پایگاه داده باشد فیلد میزبان* با اسلش شروع می شود یا فیلد خالی است. ::: #### Overview To configure a network discovery rule used by Zabbix to discover hosts and services: - Go to *Configuration → Discovery* - Click on *Create rule* (or on the rule name to edit an existing one) - Edit the discovery rule attributes #### بررسی اجمالی برای پیکربندی یک قانون کشف شبکه که توسط Zabbix برای کشف میزبان ها استفاده می شود و خدمات: - به *پیکربندی → کشف* بروید - روی *ایجاد قانون* کلیک کنید (یا روی نام قانون برای ویرایش یک قانون موجود) - ویژگی های قانون کشف را ویرایش کنید #### Overview With the *Scheduled reports* feature, you can set up a PDF version of a given dashboard to be sent to specified recipients at recurring intervals. ![](/assets/en/manual/web_interface/scheduled_report_pdf_example.png){width="600"} ::: noteimportant Currently the support of scheduled reports is experimental. ::: ::: noteclassic For multi-page dashboards, only the first page is included in the PDF report. ::: Pre-requisites: - Zabbix web service must be installed and configured correctly to enable scheduled report generation - see [Setting up scheduled reports](/manual/appendix/install/web_service) for instructions. - A user must have a [user role](/manual/web_interface/frontend_sections/administration/user_roles) of type *Admin* or *Super admin* with the following permissions: - *Scheduled reports* in the *Access to UI elements* block (to view reports) - *Manage scheduled reports* in the *Access to actions* block (to create/edit reports) To create a scheduled report in Zabbix frontend, do the following: - Go to: *Reports* → *Scheduled reports* - Click *Create report* in the upper right corner of the screen - Enter parameters of the report in the form You can also create a report by opening an existing one, clicking the *Clone* button, and then saving it under a different name. #### بررسی اجمالی با ویژگی *گزارش‌های زمان‌بندی شده*، می‌توانید یک نسخه PDF از یک داشبورد معین را تنظیم کنید تا در فواصل زمانی مکرر برای گیرندگان مشخص ارسال شود. ![](/assets/en/manual/web_interface/scheduled_report_pdf_example.png){width="600"} ::: نکته مهم در حال حاضر پشتیبانی از گزارش های برنامه ریزی شده آزمایشی است. ::: ::: نوتکلاسیک برای داشبوردهای چند صفحه ای، فقط صفحه اول در گزارش PDF گنجانده شده است. ::: پیش نیازها: - وب سرویس Zabbix باید به درستی نصب و پیکربندی شود تا تولید گزارش برنامه ریزی شده را فعال کند - برای دستورالعمل ها به [تنظیم گزارش های زمان بندی شده](/manual/appendix/install/web_service) مراجعه کنید. - یک کاربر باید یک [نقش کاربر](/manual/web_interface/frontend_sections/administration/user_roles) از نوع *Admin* یا *Super Admin* با مجوزهای زیر داشته باشد: - *گزارش های زمان بندی شده* در بلوک *دسترسی به عناصر رابط کاربری* (برای مشاهده گزارش ها) - *مدیریت گزارش های برنامه ریزی شده* در بلوک *دسترسی به اقدامات* (برای ایجاد/ویرایش گزارش ها) برای ایجاد یک گزارش برنامه ریزی شده در Zabbix frontend، موارد زیر را انجام دهید: - برو به: *گزارش ها* → *گزارش های برنامه ریزی شده* - روی *ایجاد گزارش* در گوشه سمت راست بالای صفحه کلیک کنید - پارامترهای گزارش را در فرم وارد کنید همچنین می‌توانید با باز کردن یک گزارش موجود، کلیک کردن روی دکمه *Clone* و سپس ذخیره آن با نام دیگری، یک گزارش ایجاد کنید. #### Overview With Zabbix you can check several availability aspects of web sites.\ ::: noteimportant To perform web monitoring Zabbix server must be initially [configured](/manual/installation/install#from_the_sources) with cURL (libcurl) support. ::: To activate web monitoring you need to define web scenarios. A web scenario consists of one or several HTTP requests or "steps". The steps are periodically executed by Zabbix server in a pre-defined order. If a host is monitored by proxy, the steps are executed by the proxy. Web scenarios are attached to hosts/templates in the same way as items, triggers, etc. That means that web scenarios can also be created on a template level and then applied to multiple hosts in one move. The following information is collected in any web scenario: - average download speed per second for all steps of whole scenario - number of the step that failed - last error message The following information is collected in any web scenario step: - download speed per second - response time - response code For more details, see [web monitoring items](/manual/web_monitoring/items). Data collected from executing web scenarios is kept in the database. The data is automatically used for graphs, triggers and notifications. Zabbix can also check if a retrieved HTML page contains a pre-defined string. It can execute a simulated login and follow a path of simulated mouse clicks on the page. Zabbix web monitoring supports both HTTP and HTTPS. When running a web scenario, Zabbix will optionally follow redirects (see option *Follow redirects* below). Maximum number of redirects is hard-coded to 10 (using cURL option [CURLOPT\_MAXREDIRS](http://curl.haxx.se/libcurl/c/CURLOPT_MAXREDIRS.html)). All cookies are preserved during the execution of a single scenario. See also [known issues](/manual/installation/known_issues#https_checks) for web monitoring using HTTPS protocol. #### مرور اجمالی With Zabbix you can check several availability aspects of web sites.\ ::: noteimportant To perform web monitoring Zabbix server must be initially [configured](/manual/installation/install#from_the_sources) with cURL (libcurl) support. ::: To activate web monitoring you need to define web scenarios. A web scenario consists of one or several HTTP requests or "steps". The steps are periodically executed by Zabbix server in a pre-defined order. If a host is monitored by proxy, the steps are executed by the proxy. Web scenarios are attached to hosts/templates in the same way as items, triggers, etc. That means that web scenarios can also be created on a template level and then applied to multiple hosts in one move. The following information is collected in any web scenario: - average download speed per second for all steps of whole scenario - number of the step that failed - last error message The following information is collected in any web scenario step: - download speed per second - response time - response code For more details, see [web monitoring items](/manual/web_monitoring/items). Data collected from executing web scenarios is kept in the database. The data is automatically used for graphs, triggers and notifications. Zabbix can also check if a retrieved HTML page contains a pre-defined string. It can execute a simulated login and follow a path of simulated mouse clicks on the page. Zabbix web monitoring supports both HTTP and HTTPS. When running a web scenario, Zabbix will optionally follow redirects (see option *Follow redirects* below). Maximum number of redirects is hard-coded to 10 (using cURL option [CURLOPT\_MAXREDIRS](http://curl.haxx.se/libcurl/c/CURLOPT_MAXREDIRS.html)). All cookies are preserved during the execution of a single scenario. See also [known issues](/manual/installation/known_issues#https_checks) for web monitoring using HTTPS protocol. #### Overview You may want to use SNMP monitoring on devices such as printers, network switches, routers or UPS that usually are SNMP-enabled and on which it would be impractical to attempt setting up complete operating systems and Zabbix agents. To be able to retrieve data provided by SNMP agents on these devices, Zabbix server must be [initially configured](/manual/installation/install#configure-the-sources) with SNMP support by specifying the `--with-net-snmp` flag. SNMP checks are performed over the UDP protocol only. Zabbix server and proxy daemons query SNMP devices for multiple values in a single request. This affects all kinds of SNMP items (regular SNMP items, SNMP items with dynamic indexes, and SNMP low-level discovery) and should make SNMP processing much more efficient. See the [bulk processing](#internal-workings-of-bulk-processing) section for technical details on how it works internally. Bulk requests can also be disabled for devices that cannot handle them properly using the "Use bulk requests" setting for each interface. Zabbix server and proxy daemons log lines similar to the following if they receive an incorrect SNMP response: SNMP response from host "gateway" does not contain all of the requested variable bindings While they do not cover all the problematic cases, they are useful for identifying individual SNMP devices for which bulk requests should be disabled. Zabbix server/proxy will always retry at least one time after an unsuccessful query attempt: either through the SNMP library's retrying mechanism or through the internal [bulk processing](#internal-workings-of-bulk-processing) mechanism. ::: notewarning If monitoring SNMPv3 devices, make sure that msgAuthoritativeEngineID (also known as snmpEngineID or "Engine ID") is never shared by two devices. According to [RFC 2571](http://www.ietf.org/rfc/rfc2571.txt) (section 3.1.1.1) it must be unique for each device. ::: ::: notewarning RFC3414 requires the SNMPv3 devices to persist their engineBoots. Some devices do not do that, which results in their SNMP messages being discarded as outdated after being restarted. In such situation, SNMP cache needs to be manually cleared on a server/proxy (by using [-R snmp\_cache\_reload](/manual/concepts/server#runtime-control)) or the server/proxy needs to be restarted. ::: #### بررسی اجمالی ممکن است بخواهید از نظارت SNMP در دستگاه هایی مانند چاپگر، شبکه استفاده کنید سوئیچ ها، روترها یا یو پی اس هایی که معمولاً دارای SNMP هستند و روی آنها فعال است تلاش برای راه اندازی سیستم عامل های کامل غیر عملی خواهد بود و عوامل Zabbix. برای اینکه بتوانید داده های ارائه شده توسط عوامل SNMP در این دستگاه ها را بازیابی کنید، سرور Zabbix باید در ابتدا [ configured](/manual/installation/install#configure-the-sources) با پشتیبانی از SNMP با مشخص کردن پرچم «--with-net-snmp». بررسی های SNMP فقط از طریق پروتکل UDP انجام می شود. سرور Zabbix و شیاطین پراکسی دستگاه های SNMP را برای مقادیر متعدد پرس و جو می کنند در یک درخواست واحد این روی انواع آیتم های SNMP (SNMP معمولی) تأثیر می گذارد آیتم ها، آیتم های SNMP با نمایه های پویا، و کشف سطح پایین SNMP) و باید پردازش SNMP را بسیار کارآمدتر کند. رجوع به [فله پردازش] (#internal-workings-of-bulk-processing) بخش برای فنی جزئیات در مورد نحوه عملکرد داخلی درخواست های انبوه را نیز می توان غیرفعال کرد برای دستگاه‌هایی که نمی‌توانند با استفاده از «استفاده انبوه تنظیم درخواست ها برای هر رابط. خطوط لاگ سرور Zabbix و proxy daemons مشابه اگر زیر است آنها یک پاسخ SNMP نادرست دریافت می کنند: پاسخ SNMP از "دروازه" میزبان شامل همه اتصالات متغیر درخواستی نیست در حالی که آنها همه موارد مشکل ساز را پوشش نمی دهند، برای آنها مفید هستند شناسایی تک تک دستگاه‌های SNMP که درخواست‌های انبوه باید برای آنها باشد معلول. سرور/پراکسی Zabbix همیشه حداقل یک بار پس از یک بار دوباره امتحان می کند تلاش ناموفق برای جستجو: یا از طریق تلاش مجدد کتابخانه SNMP مکانیسم یا از طریق داخلی [فله پردازش] (#internal-workings-of-bulk-processing) مکانیزم. ::: هشدار در صورت نظارت بر دستگاه های SNMPv3، مطمئن شوید که msgAuthoritativeEngineID (همچنین به عنوان snmpEngineID یا "Engine ID" شناخته می شود) است هرگز توسط دو دستگاه به اشتراک گذاشته نمی شود. طبق [RFC 2571] (http://www.ietf.org/rfc/rfc2571.txt) (بخش 3.1.1.1) باید منحصر به فرد برای هر دستگاه ::: ::: هشدار RFC3414 به دستگاه‌های SNMPv3 برای ادامه کار نیاز دارد بوت های موتور آنها برخی از دستگاه‌ها این کار را انجام نمی‌دهند، که منجر به آنها می‌شود پیام‌های SNMP پس از راه‌اندازی مجدد به‌عنوان منسوخ شده کنار گذاشته می‌شوند. در چنین در شرایط، کش SNMP باید به صورت دستی روی سرور/پراکسی پاک شود (توسط با استفاده از [-R snmp\_cache\_reload](/manual/concepts/server#runtime-control)) یا سرور/پراکسی نیاز به راه اندازی مجدد دارد. ::: #### Overview Zabbix agent 2 is a new generation of Zabbix agent and may be used in place of Zabbix agent. This section lists parameters supported in a Zabbix agent 2 configuration file (zabbix\_agent2.conf). Note that: - The default values reflect process defaults, not the values in the shipped configuration files; - Zabbix supports configuration files only in UTF-8 encoding without [BOM](https://en.wikipedia.org/wiki/Byte_order_mark); - Comments starting with "\#" are only supported in the beginning of the line. #### بررسی اجمالی Zabbix Agent 2 نسل جدید Zabbix Agent می باشد و ممکن است به جای Zabbix Agent از آن استفاده شود. این قسمت پارامترهای پشتیبانی شده در یک فایل پیکربندی Zabbix Agent 2 را فهرست می کند (zabbix\_agent2.conf). توجه داشته باشید که: - مقادیر پیش‌فرض منعکس‌کننده پیش‌فرض‌های فرآیند هستند، نه مقادیر موجود در فایل های پیکربندی ایجاد شده؛ - Zabbix فقط از فایل های پیکربندی با انکودینگ UTF-8 بدون [BOM](https://en.wikipedia.org/wiki/Byte_order_mark) پشتیبانی می کند؛ - نظراتی که با "\#" شروع می شوند تنها در صورتی پشتیانی می شوند که در ابتدای خط باشند. #### Overview Zabbix agent is deployed on a monitoring target to actively monitor local resources and applications (hard drives, memory, processor statistics, etc.). The agent gathers operational information locally and reports data to Zabbix server for further processing. In case of failures (such as a hard disk running full or a crashed service process), Zabbix server can actively alert the administrators of the particular machine that reported the failure. Zabbix agents are extremely efficient because of use of native system calls for gathering statistical information. #### Overview Zabbix agent is deployed on a monitoring target to actively monitor local resources and applications (hard drives, memory, processor statistics etc). The agent gathers operational information locally and reports data to Zabbix server for further processing. In case of failures (such as a hard disk running full or a crashed service process), Zabbix server can actively alert the administrators of the particular machine that reported the failure. Zabbix agents are extremely efficient because of use of native system calls for gathering statistical information. #### Overview Zabbix can be used for centralized monitoring and analysis of log files with/without log rotation support. Notifications can be used to warn users when a log file contains certain strings or string patterns. To monitor a log file you must have: - Zabbix agent running on the host - log monitoring item set up ::: noteimportant The size limit of a monitored log file depends on [large file support](/manual/appendix/items/large_file_support). ::: #### بررسی اجمالی Zabbix می تواند برای نظارت و تجزیه و تحلیل متمرکز فایل های گزارش استفاده شود با / بدون پشتیبانی از چرخش ورود به سیستم. اعلان‌ها می‌توانند برای هشدار دادن به کاربران زمانی که یک فایل گزارش حاوی موارد خاصی است استفاده شود رشته ها یا الگوهای رشته ای. برای نظارت بر یک فایل گزارش باید موارد زیر را داشته باشید: - عامل Zabbix در حال اجرا بر روی هاست - تنظیم آیتم نظارت بر گزارش ::: نکته مهم محدودیت اندازه یک فایل گزارش نظارت شده به این بستگی دارد [فایل بزرگ support](/manual/appendix/items/large_file_support). ::: #### Overview Zabbix proxy is a process that may collect monitoring data from one or more monitored devices and send the information to the Zabbix server, essentially working on behalf of the server. All collected data is buffered locally and then transferred to the Zabbix server the proxy belongs to. Deploying a proxy is optional, but may be very beneficial to distribute the load of a single Zabbix server. If only proxies collect data, processing on the server becomes less CPU and disk I/O hungry. A Zabbix proxy is the ideal solution for centralized monitoring of remote locations, branches and networks with no local administrators. Zabbix proxy requires a separate database. ::: noteimportant Note that databases supported with Zabbix proxy are SQLite, MySQL and PostgreSQL. Using Oracle is at your own risk and may contain some limitations as, for example, in [return values](/manual/discovery/low_level_discovery#overview) of low-level discovery rules. ::: See also: [Using proxies in a distributed environment](/manual/distributed_monitoring/proxies) #### بررسی اجمالی پروکسی Zabbix فرآیندی است که ممکن است داده های نظارتی را از یک یا جمع آوری کند دستگاه های نظارت شده بیشتر و ارسال اطلاعات به سرور Zabbix، اساساً از طرف سرور کار می کند. تمام داده های جمع آوری شده است به صورت محلی بافر شده و سپس پروکسی به سرور Zabbix منتقل می شود متعلق به. استقرار یک پروکسی اختیاری است، اما ممکن است برای توزیع بسیار مفید باشد بار یک سرور Zabbix. اگر فقط پراکسی ها داده ها را جمع آوری کنند، پردازش روی سرور کمتر CPU و دیسک ورودی/خروجی گرسنه می شود. یک پروکسی Zabbix راه حل ایده آل برای نظارت متمرکز است مکان ها، شعب و شبکه های راه دور بدون سرپرست محلی. پروکسی Zabbix به یک پایگاه داده جداگانه نیاز دارد. ::: نکته مهم توجه داشته باشید که پایگاه های داده با پروکسی Zabbix پشتیبانی می شوند SQLite، MySQL و PostgreSQL هستند. استفاده از اوراکل به عهده خودتان است و ممکن است دارای محدودیت هایی باشد، به عنوان مثال، در [بازگشت مقادیر](/manual/discovery/low_level_discovery#overview) از سطح پایین قوانین کشف ::: همچنین ببینید: [استفاده از پراکسی ها در توزیع شده محیط](/دستی/distributed_monitoring/پراکسی) #### Overview Zabbix server is the central process of Zabbix software. The server performs the polling and trapping of data, it calculates triggers, sends notifications to users. It is the central component to which Zabbix agents and proxies report data on availability and integrity of systems. The server can itself remotely check networked services (such as web servers and mail servers) using simple service checks. The server is the central repository in which all configuration, statistical and operational data is stored, and it is the entity in Zabbix that will actively alert administrators when problems arise in any of the monitored systems. The functioning of a basic Zabbix server is broken into three distinct components; they are: Zabbix server, web frontend and database storage. All of the configuration information for Zabbix is stored in the database, which both the server and the web frontend interact with. For example, when you create a new item using the web frontend (or API) it is added to the items table in the database. Then, about once a minute Zabbix server will query the items table for a list of the items which are active that is then stored in a cache within the Zabbix server. This is why it can take up to two minutes for any changes made in Zabbix frontend to show up in the latest data section. #### بررسی اجمالی سرور Zabbix فرآیند مرکزی نرم افزار Zabbix است. سرور نظرسنجی و به دام انداختن داده ها را انجام می دهد، محاسبه می کند باعث می شود، اعلان ها را برای کاربران ارسال می کند. این جزء مرکزی است که عوامل و پراکسی های Zabbix داده ها را در مورد در دسترس بودن و یکپارچگی سیستم ها سرور خودش می تواند شبکه را از راه دور بررسی کند خدمات (مانند وب سرورها و سرورهای پست الکترونیکی) با استفاده از سرویس ساده چک ها سرور مخزن مرکزی است که در آن تمام تنظیمات، داده های آماری و عملیاتی ذخیره می شود و موجودیت موجود در آن است Zabbix که در صورت بروز مشکل به طور فعال به مدیران هشدار می دهد هر یک از سیستم های نظارت شده عملکرد یک سرور اصلی Zabbix به سه قسمت مجزا تقسیم می شود اجزاء؛ آنها عبارتند از: سرور Zabbix، وب پیشانی و ذخیره سازی پایگاه داده. تمام اطلاعات پیکربندی Zabbix در آن ذخیره می شود پایگاه داده، که هم سرور و هم وب سایت با آن تعامل دارند. برای به عنوان مثال، هنگامی که یک آیتم جدید را با استفاده از صفحه وب (یا API) ایجاد می کنید به جدول آیتم ها در پایگاه داده اضافه می شود. سپس، تقریباً یک بار در دقیقه سرور Zabbix جدول آیتم ها را برای لیستی از موارد مورد پرس و جو می کند فعال هستند که سپس در یک کش در سرور Zabbix ذخیره می شوند. این به همین دلیل است که ممکن است برای هر تغییری که در Zabbix ایجاد شده است تا دو دقیقه طول بکشد frontend تا در آخرین بخش داده نمایش داده شود. ### Parameters `(array)` IDs of hosts to delete. ### پارامتر ها `(array)` IDs of hosts to delete. ### Parameters `(array)` IDs of items to clear. ### پارامتر ها `(array)` IDs of items to clear. ### Parameters `(array)` IDs of proxies to delete. ### پارامتر ها `(array)` IDs of hosts to delete. ### Parameters `(array)` IDs of the actions to delete. ### پارامترها شناسه «(آرایه)» های اکشن برای حذف کردن . ### Parameters `(array)` IDs of the correlations to delete. ### پارامتر ها «(آرایه)» شناسه های همبستگی برای حذف. ### Parameters `(array)` IDs of the dashboards to delete. ### پارامتر ها «(آرایه)» شناسه های همبستگی برای حذف. ### Parameters `(array)` IDs of the discovery rules to delete. ### پارامتر ها «(آرایه)» شناسه های همبستگی برای حذف. ### Parameters `(array)` IDs of the graph prototypes to delete. ###پارامتر ها `object graphprototype.delete(array graphPrototypeIds)` This method allows to delete graph prototypes. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Parameters `(array)` IDs of the graphs to delete. ### پارامتر ها `(array)` IDs of the graphs to delete. ### Parameters `(array)` IDs of the host groups to delete. ###پارامتر ها `(array)` IDs of the host groups to delete. ### Parameters `(array)` IDs of the host interfaces to delete. ### پارامتر ها `(array)` IDs of the host interfaces to delete. ### Parameters `(array)` IDs of the host prototypes to delete. ### پارامتر ها `(array)` IDs of the host prototypes to delete. ### Parameters `(array)` IDs of the icon maps to delete. ### پارامتر ها `(array)` IDs of the icon maps to delete. ### Parameters `(array)` IDs of the images to delete. #id عکس ها برای حذف ### Parameters `(array)` IDs of the item prototypes to delete. ### پارامتر ها `(array)` IDs of the host prototypes to delete. ### Parameters `(array)` IDs of the items to delete. id عکس ها برای حذف ### Parameters `(array)` IDs of the LLD rules to delete. ### پارامتر ها «(آرایه)» شناسه های همبستگی برای حذف. ### Parameters `(array)` IDs of the maintenance periods to delete. ### پارامترها شناسه «(آرایه)» های اکشن برای حذف کردن . ### Parameters `(array)` IDs of the maps to delete. ### پارامتر ها `(array)` IDs of the graphs to delete. ### Parameters `(array)` IDs of the regular expressions to delete. ### پارامترها شناسه «(آرایه)» های اکشن برای حذف کردن . ### Parameters `(array)` IDs of the scheduled reports to delete. ### پارامتر ها `(array)` IDs of the graphs to delete. ### Parameters `(array)` IDs of the scripts to delete. ### پارامتر ها `(array)` IDs of the graphs to delete. ### Parameters `(array)` IDs of the tokens to delete. id عکس ها برای حذف ### Parameters `(array)` IDs of the tokens to generate. ### پارامترها شناسه «(آرایه)» های اکشن برای حذف کردن . ### Parameters `(array)` IDs of the value maps to delete. ### پارامتر ها `(array)` IDs of the graphs to delete. ### Parameters `(array)` IDs of the web scenarios to delete. ### پارامتر ها `(array)` IDs of the web scenarios to delete. ### Parameters `(array)` The method accepts an empty array. ### پارامترها `(آرایه)` این روش یک آرایه خالی را می پذیرد. ### Parameters `(object/array)` Action properties to be updated. The `actionid` property must be defined for each action, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged. Additionally to the [standard action properties](object#action), the method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |filter|object|Action [filter](/manual/api/reference/action/object#action_filter) object to replace the current filter.| |operations|array|Action [operations](/manual/api/reference/action/object#action_operation) to replace existing operations.| |recovery\_operations|array|Action [recovery operations](/manual/api/reference/action/object#action_recovery_operation) to replace existing recovery operations.| |update\_operations|array|Action [update operations](/manual/api/reference/action/object#action_update_operation) to replace existing update operations.| ### پارامترها `(شیء/آرایه)` ویژگی های اکشن به روز می شوند. خاصیت «actionid» باید برای هر عمل تعریف شود خواص اختیاری هستند فقط ویژگی های تصویب شده به روز می شوند، همه بقیه بدون تغییر باقی خواهند ماند. علاوه بر [ویژگی‌های اقدام استاندارد] (object#action)، متد پارامترهای زیر را می پذیرد. |پارامتر|[نوع](/manual/api/reference_commentary#data_types)|توضیحات| |--|--|------| |filter|object|عمل [filter](/manual/api/reference/action/object#action_filter) برای جایگزینی فیلتر فعلی.| |عملیات|آرایه|عملیات [عملیات](/manual/api/reference/action/object#action_operation) برای جایگزینی عملیات موجود.| |بازیابی\_عملیات|آرایه|عملیات [عملیات بازیابی](/manual/api/reference/action/object#action_recovery_operation) برای جایگزینی عملیات بازیابی موجود.| |update\_operations|آرایه|عملیات [عملیات به‌روزرسانی](/manual/api/reference/action/object#action_update_operation) برای جایگزینی عملیات به‌روزرسانی موجود.| ### Parameters `(object/array)` Actions to create. Additionally to the [standard action properties](object#action), the method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |filter|object|Action [filter](/manual/api/reference/action/object#action_filter) object for the action.| |operations|array|Action [operations](/manual/api/reference/action/object#action_operation) to create for the action.| |recovery\_operations|array|Action [recovery operations](/manual/api/reference/action/object#action_recovery_operation) to create for the action.| |update\_operations|array|Action [update operations](/manual/api/reference/action/object#action_update_operation) to create for the action.| ### پارامتر ها «(شیء/آرایه)» اقداماتی برای ساخت. علاوه بر [ویژگی‌های اقدام استاندارد] (object#action)، متد پارامترهای زیر را می پذیرد. |پارامتر|[نوع](/manual/api/reference_commentary#data_types)|توضیحات| |--|--|------| |filter|object|Action [filter](/manual/api/reference/action/object#action_filter) شیء برای اکشن.| |عملیات|آرایه|عملیات [عملیات](/manual/api/reference/action/object#action_operation) برای ایجاد اکشن.| |بازیابی\_عملیات|آرایه|عملیات [عملیات بازیابی](/manual/api/reference/action/object#action_recovery_operation) برای ایجاد اکشن.| |update\_operations|آرایه|عملیات [عملیات به‌روزرسانی](/manual/api/reference/action/object#action_update_operation) برای ایجاد عمل.| ### Parameters `(object/array)` A task to create. The method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**type**<br>(required)|integer|Task type.<br><br>Possible values:<br>1 - Diagnostic information;<br>6 - Check now.| |**request**<br>(required)|object|Task request object according to the task type. Correct format of request object is described in [Task object](/manual/api/reference/task/object) section.| |proxy\_hostid|integer|Proxy about which Diagnostic information task will collect data.<br><br>Ignored for 'Check now' tasks.| *Note* that 'Check now' tasks can be created only for the following types of items/discovery rules: - Zabbix agent - SNMPv1/v2/v3 agent - Simple check - Internal check - External check - Database monitor - HTTP agent - IPMI agent - SSH agent - TELNET agent - Calculated check - JMX agent ### مولفه های «(شیء/آرایه)» وظیفه ای برای ایجاد. این روش پارامترهای زیر را می پذیرد. |پارامتر|[نوع](/manual/api/reference_commentary#data_types)|توضیحات| |--|--|------| |**نوع**<br>(الزامی)|عدد صحیح|نوع وظیفه.<br><br>مقادیر ممکن:<br>1 - اطلاعات تشخیصی؛<br>6 - اکنون بررسی کنید.| |**درخواست**<br>(لازم)|شیء|شیء درخواست وظیفه با توجه به نوع کار. فرمت صحیح شی درخواست در بخش [Task object](/manual/api/reference/task/object) توضیح داده شده است.| |پروکسی\_hostid|عدد صحیح|پراکسی که وظیفه اطلاعات تشخیصی درباره آن داده‌ها را جمع‌آوری می‌کند.<br><br>برای وظایف «اکنون بررسی کنید» نادیده گرفته می‌شود.| *توجه داشته باشید* که وظایف "اکنون بررسی کنید" را می توان فقط برای موارد زیر ایجاد کرد انواع اقلام / قوانین کشف: - عامل Zabbix - عامل SNMPv1/v2/v3 - بررسی ساده - چک داخلی - چک خارجی - مانیتور پایگاه داده - عامل HTTP - عامل IPMI - عامل SSH - عامل TELNET - چک محاسبه شده - عامل JMX ### Parameters `(object/array)` Correlation properties to be updated. The `correlationid` property must be defined for each correlation, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged. Additionally to the [standard correlation properties](object#correlation), the method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |filter|object|Correlation [filter](/manual/api/reference/correlation/object#correlation_filter) object to replace the current filter.| |operations|array|Correlation [operations](/manual/api/reference/correlation/object#correlation_operation) to replace existing operations.| ### پارامتر ها "(شیء/آرایه)" ویژگی های همبستگی به روز می شوند. ویژگی "correlationid" باید برای هر همبستگی، همه تعریف شود سایر خواص اختیاری هستند. فقط خواص پاس شده خواهد بود به روز شده، بقیه بدون تغییر باقی خواهند ماند. علاوه بر [همبستگی استاندارد خواص](object#correlation)، روش موارد زیر را می پذیرد مولفه های. |پارامتر|[نوع](/manual/api/reference_commentary#data_types)|توضیحات| |--|--|------| |filter|object|Correlation [filter](/manual/api/reference/correlation/object#correlation_filter) شیء جایگزین فیلتر فعلی.| |عملیات|آرایه|همبستگی [عملیات](/manual/api/reference/correlation/object#correlation_operation) برای جایگزینی عملیات موجود.| ### Parameters `(object/array)` Correlations to create. Additionally to the [standard correlation properties](object#correlation), the method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**operations**<br>(required)|array|Correlation [operations](/manual/api/reference/correlation/object#correlation_operation) to create for the correlation.| |**filter**<br>(required)|object|Correlation [filter](/manual/api/reference/correlation/object#correlation_filter) object for the correlation.| ### پارامتر ها "(شیء/آرایه)" همبستگی برای ایجاد. علاوه بر [همبستگی استاندارد خواص](object#correlation)، روش موارد مولفه های زیر را می پذیرد |پارامتر|[نوع](/manual/api/reference_commentary#data_types)|توضیحات| |--|--|------| |**عملیات**<br>(الزامی)|آرایه|همبستگی [عملیات](/manual/api/reference/correlation/object#correlation_operation) برای ایجاد همبستگی.| |**filter**<br>(لازم)|شیء|همبستگی [filter](/manual/api/reference/correlation/object#correlation_filter) شیء برای همبستگی.| ### Parameters `(object/array)` Dashboard properties to be updated. The `dashboardid` property must be specified for each dashboard, all other properties are optional. Only the specified properties will be updated. Additionally to the [standard dashboard properties](object#dashboard), the method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |pages|array|Dashboard [pages](object#dashboard_page) to replace the existing dashboard pages.<br><br>Dashboard pages are updated by the `dashboard_pageid` property. New dashboard pages will be created for objects without `dashboard_pageid` property and the existing dashboard pages will be deleted if not reused. Dashboard pages will be ordered in the same order as specified. Only the specified properties of the dashboard pages will be updated. At least one dashboard page object is required for `pages` property.| |users|array|Dashboard [user](object#dashboard_user) shares to replace the existing elements.| |userGroups|array|Dashboard [user group](object#dashboard_user_group) shares to replace the existing elements.| ### پارامتر ها `(object/array)` Dashboard properties to be updated. The `dashboardid` property must be specified for each dashboard, all other properties are optional. Only the specified properties will be updated. Additionally to the [standard dashboard properties](object#dashboard), the method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |pages|array|Dashboard [pages](object#dashboard_page) to replace the existing dashboard pages.<br><br>Dashboard pages are updated by the `dashboard_pageid` property. New dashboard pages will be created for objects without `dashboard_pageid` property and the existing dashboard pages will be deleted if not reused. Dashboard pages will be ordered in the same order as specified. Only the specified properties of the dashboard pages will be updated. At least one dashboard page object is required for `pages` property.| |users|array|Dashboard [user](object#dashboard_user) shares to replace the existing elements.| |userGroups|array|Dashboard [user group](object#dashboard_user_group) shares to replace the existing elements.| ### Parameters `(object/array)` Dashboards to create. Additionally to the [standard dashboard properties](object#dashboard), the method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**pages**<br>(required)|array|Dashboard [pages](object#dashboard_page) to be created for the dashboard. Dashboard pages will be ordered in the same order as specified. At least one dashboard page object is required for `pages` property.| |users|array|Dashboard [user](object#dashboard_user) shares to be created on the dashboard.| |userGroups|array|Dashboard [user group](object#dashboard_user_group) shares to be created on the dashboard.| ### پارامتر ها ### Parameters `(object/array)` Discovery rule properties to be updated. The `druleid` property must be defined for each discovery rule, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged. Additionally to the [standard discovery rule properties](object#discovery_rule), the method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |dchecks|array|Discovery [checks](/manual/api/reference/dcheck/object) to replace existing checks.| ### پارامتر ها `(object/array)` Discovery rule properties to be updated. The `druleid` property must be defined for each discovery rule, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged. Additionally to the [standard discovery rule properties](object#discovery_rule), the method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |dchecks|array|Discovery [checks](/manual/api/reference/dcheck/object) to replace existing checks.| ### Parameters `(object/array)` Discovery rules to create. Additionally to the [standard discovery rule properties](object#discovery_rule), the method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**dchecks**<br>(required)|array|Discovery [checks](/manual/api/reference/dcheck/object) to create for the discovery rule.| ### پارامتر ها "(شیء/آرایه)" ساختن برای قانون جست و جو علاوه بر [همبستگی استاندارد خواص](object#correlation)، روش موارد مولفه های زیر را می پذیرد |پارامتر|[نوع](/manual/api/reference_commentary#data_types)|توضیحات| |--|--|------| |**عملیات**<br>(الزامی)|آرایه|همبستگی [عملیات](/manual/api/reference/correlation/object#correlation_operation) برای ایجاد همبستگی.| |**filter**<br>(لازم)|شیء|همبستگی [filter](/manual/api/reference/correlation/object#correlation_filter) شیء برای همبستگی.| ### Parameters `(object/array)` [Global macro properties](object#global_macro) to be updated. The `globalmacroid` property must be defined for each global macro, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged. ### پارامتر ها `(object/array)` [Host group properties](object#host_group) to be updated. The `groupid` property must be defined for each host group, all other properties are optional. Only the given properties will be updated, all others will remain unchanged. ### Parameters `(object/array)` Graph properties to be updated. The `graphid` property must be defined for each graph, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged. Additionally to the [standard graph properties](object#graph) the method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |gitems|array|Graph [items](/manual/api/reference/graphitem/object) to replace existing graph items. If a graph item has the `gitemid` property defined it will be updated, otherwise a new graph item will be created.| ### پارامتر ها `(object/array)` Graph properties to be updated. The `graphid` property must be defined for each graph, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged. Additionally to the [standard graph properties](object#graph) the method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |gitems|array|Graph [items](/manual/api/reference/graphitem/object) to replace existing graph items. If a graph item has the `gitemid` property defined it will be updated, otherwise a new graph item will be created.| ### Parameters `(object/array)` Graph prototype properties to be updated. The `graphid` property must be defined for each graph prototype, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged. Additionally to the [standard graph prototype properties](object#graph_prototype), the method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |gitems|array|Graph [items](/manual/api/reference/graphitem/object) to replace existing graph items. If a graph item has the `gitemid` property defined it will be updated, otherwise a new graph item will be created.| ### پارامتر ها `(object/array)` Graph prototype properties to be updated. The `graphid` property must be defined for each graph prototype, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged. Additionally to the [standard graph prototype properties](object#graph_prototype), the method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |gitems|array|Graph [items](/manual/api/reference/graphitem/object) to replace existing graph items. If a graph item has the `gitemid` property defined it will be updated, otherwise a new graph item will be created.| ### Parameters `(object/array)` Graph prototypes to create. Additionally to the [standard graph prototype properties](object#graph_prototype), the method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**gitems**<br>(required)|array|Graph [items](/manual/api/reference/graphitem/object) to be created for the graph prototypes. Graph items can reference both items and item prototypes, but at least one item prototype must be present.| ### پارامتر ها `(object/array)` Graph prototypes to create. Additionally to the [standard graph prototype properties](object#graph_prototype), the method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**gitems**<br>(required)|array|Graph [items](/manual/api/reference/graphitem/object) to be created for the graph prototypes. Graph items can reference both items and item prototypes, but at least one item prototype must be present.| ### Parameters `(object/array)` Graphs to create. Additionally to the [standard graph properties](object#graph), the method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**gitems**<br>(required)|array|Graph [items](/manual/api/reference/graphitem/object) to be created for the graph.| ### پارامترها `(object/array)` Graphs to create. Additionally to the [standard graph properties](object#graph), the method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**gitems**<br>(required)|array|Graph [items](/manual/api/reference/graphitem/object) to be created for the graph.| ### Parameters `(object/array)` [Host group properties](object#host_group) to be updated. The `groupid` property must be defined for each host group, all other properties are optional. Only the given properties will be updated, all others will remain unchanged. ### پارامتر ها `(object/array)` [Host group properties](object#host_group) to be updated. The `groupid` property must be defined for each host group, all other properties are optional. Only the given properties will be updated, all others will remain unchanged. ### Parameters `(object/array)` Host groups to create. The method accepts host groups with the [standard host group properties](object#host_group). ### پارامتر ها `(object/array)` Host groups to create. The method accepts host groups with the [standard host group properties](object#host_group). ### Parameters `(object/array)` [Host interface properties](object#host_interface) to be updated. The `interfaceid` property must be defined for each host interface, all other properties are optional. Only the given properties will be updated, all others will remain unchanged. ### پارامتر ها `(object/array)` [Host interface properties](object#host_interface) to be updated. The `interfaceid` property must be defined for each host interface, all other properties are optional. Only the given properties will be updated, all others will remain unchanged. ### Parameters `(object/array)` Host interfaces to create. The method accepts host interfaces with the [standard host interface properties](object#host_interface). ### پارامتر ها `(object/array)` Host interfaces to create. The method accepts host interfaces with the [standard host interface properties](object#host_interface). ### Parameters `(object/array)` Host prototypes to create. Additionally to the [standard host prototype properties](object#host_prototype), the method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**groupLinks**<br>(required)|array|Group [links](/manual/api/reference/hostprototype/object#group_link) to be created for the host prototype.| |**ruleid**<br>(required)|string|ID of the LLD rule that the host prototype belongs to.| |groupPrototypes|array|Group [prototypes](/manual/api/reference/hostprototype/object#group_prototype) to be created for the host prototype.| |macros|object/array|[User macros](/manual/api/reference/usermacro/object) to be created for the host prototype.| |tags|object/array|Host prototype [tags](/manual/api/reference/hostprototype/object#host_prototype_tag).| |interfaces|object/array|Host prototype [custom interfaces](/manual/api/reference/hostprototype/object#custom_interface).| |templates|object/array|[Templates](/manual/api/reference/template/object) to be linked to the host prototype.<br><br>The templates must have the `templateid` property defined.| ### پارامتر ها `(object/array)` Host prototypes to create. Additionally to the [standard host prototype properties](object#host_prototype), the method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**groupLinks**<br>(required)|array|Group [links](/manual/api/reference/hostprototype/object#group_link) to be created for the host prototype.| |**ruleid**<br>(required)|string|ID of the LLD rule that the host prototype belongs to.| |groupPrototypes|array|Group [prototypes](/manual/api/reference/hostprototype/object#group_prototype) to be created for the host prototype.| |macros|object/array|[User macros](/manual/api/reference/usermacro/object) to be created for the host prototype.| |tags|object/array|Host prototype [tags](/manual/api/reference/hostprototype/object#host_prototype_tag).| |interfaces|object/array|Host prototype [custom interfaces](/manual/api/reference/hostprototype/object#custom_interface).| |templates|object/array|[Templates](/manual/api/reference/template/object) to be linked to the host prototype.<br><br>The templates must have the `templateid` property defined.| ### Parameters `(object/array)` Hosts to create. Additionally to the [standard host properties](object#host), the method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**groups**<br>(required)|object/array|Host [groups](/manual/api/reference/hostgroup/object) to add the host to.<br><br>The host groups must have the `groupid` property defined.| |interfaces|object/array|[Interfaces](/manual/api/reference/hostinterface/object) to be created for the host.| |tags|object/array|Host [tags](/manual/api/reference/host/object#host_tag).| |templates|object/array|[Templates](/manual/api/reference/template/object) to be linked to the host.<br><br>The templates must have the `templateid` property defined.| |macros|object/array|[User macros](/manual/api/reference/usermacro/object) to be created for the host.| |inventory|object|Host [inventory](/manual/api/reference/host/object#host_inventory) properties.| ### پارامتر ها `(object/array)` Hosts to create. Additionally to the [standard host properties](object#host), the method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**groups**<br>(required)|object/array|Host [groups](/manual/api/reference/hostgroup/object) to add the host to.<br><br>The host groups must have the `groupid` property defined.| |interfaces|object/array|[Interfaces](/manual/api/reference/hostinterface/object) to be created for the host.| |tags|object/array|Host [tags](/manual/api/reference/host/object#host_tag).| |templates|object/array|[Templates](/manual/api/reference/template/object) to be linked to the host.<br><br>The templates must have the `templateid` property defined.| |macros|object/array|[User macros](/manual/api/reference/usermacro/object) to be created for the host.| |inventory|object|Host [inventory](/manual/api/reference/host/object#host_inventory) properties.| ### Parameters `(object/array)` Icon map properties to be updated. The `iconmapid` property must be defined for each icon map, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged. Additionally to the [standard icon map properties](object#icon_map), the method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |mappings|array|[Icon mappings](/manual/api/reference/iconmap/object#icon_mapping) to replace the existing icon mappings.| ### پارامترها "(شیء/آرایه)" ویژگی های آیکون نقشه به روز می شود. ویژگی "iconmapid" باید برای هر آیکون نقشه تعریف شود و بقیه ویژگی ها اختیاری هستند فقط ویژگی های تصویب شده به روز می شوند، بقیه بدون تغییر باقی خواهند ماند. علاوه بر [مشخصات استاندارد icon map] (object#icon_map)، متد پارامترهای زیر را می پذیرد. |پارامتر|[نوع](/manual/api/reference_commentary#data_types)|توضیحات| |--|--|------| |mappings|آرایه|[Icon mappings](/manual/api/reference/iconmap/object#icon_mapping) برای جایگزینی نگاشت نمادهای موجود.| ### Parameters `(object/array)` Icon maps to create. Additionally to the [standard icon map properties](object#icon_map), the method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**mappings**<br>(required)|array|[Icon mappings](/manual/api/reference/iconmap/object#icon_mapping) to be created for the icon map.| ###پارامتر ها `(object/array)` Icon maps to create. Additionally to the [standard icon map properties](object#icon_map), the method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**mappings**<br>(required)|array|[Icon mappings](/manual/api/reference/iconmap/object#icon_mapping) to be created for the icon map.| ### Parameters `(object/array)` Image properties to be updated. The `imageid` property must be defined for each image, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged. Additionally to the [standard image properties](object#image), the method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |image|string|Base64 encoded image. The maximum size of the encoded image is 1 MB. Maximum size can be adjusted by changing ZBX\_MAX\_IMAGE\_SIZE constant value.<br>Supported image formats are: PNG, JPEG, GIF.| ### پارامترها "(شیء/آرایه)" ویژگی های آیکون نقشه به روز می شود. ویژگی "iconmapid" باید برای هر آیکون نقشه تعریف شود و بقیه ویژگی ها اختیاری هستند فقط ویژگی های تصویب شده به روز می شوند، بقیه بدون تغییر باقی خواهند ماند. علاوه بر [مشخصات استاندارد icon map] (object#icon_map)، متد پارامترهای زیر را می پذیرد. |پارامتر|[نوع](/manual/api/reference_commentary#data_types)|توضیحات| |--|--|------| |mappings|آرایه|[Icon mappings](/manual/api/reference/iconmap/object#icon_mapping) برای جایگزینی نگاشت نمادهای موجود.| ### Parameters `(object/array)` Images to create. Additionally to the [standard image properties](object#image), the method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**name**<br>(required)|string|Name of the image.| |**imagetype**<br>(required)|integer|Type of image.<br><br>Possible values:<br>1 - *(default)* icon;<br>2 - background image.| |**image**<br>(required)|string|Base64 encoded image. The maximum size of the encoded image is 1 MB. Maximum size can be adjusted by changing ZBX\_MAX\_IMAGE\_SIZE constant value.<br>Supported image formats are: PNG, JPEG, GIF.| ### پارامتر ها `(object/array)` Images to create. Additionally to the [standard image properties](object#image), the method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**name**<br>(required)|string|Name of the image.| |**imagetype**<br>(required)|integer|Type of image.<br><br>Possible values:<br>1 - *(default)* icon;<br>2 - background image.| |**image**<br>(required)|string|Base64 encoded image. The maximum size of the encoded image is 1 MB. Maximum size can be adjusted by changing ZBX\_MAX\_IMAGE\_SIZE constant value.<br>Supported image formats are: PNG, JPEG, GIF.| ### Parameters `(object/array)` Item properties to be updated. The `itemid` property must be defined for each item, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged. Additionally to the [standard item properties](object#item), the method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |preprocessing|array|[Item preprocessing](/manual/api/reference/item/object#item_preprocessing) options to replace the current preprocessing options.| |tags|array|Item [tags.](/manual/api/reference/item/object#item_tag)| ### پارامتر ها `(object/array)` Web scenario properties to be updated. The `httptestid` property must be defined for each web scenario, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged. Additionally to the [standard web scenario properties](object#web_scenario), the method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |steps|array|Scenario [steps](/manual/api/reference/httptest/object#scenario_step) to replace existing steps.| |tags|array|Web scenario [tags.](/manual/api/reference/httptest/object#web_scenario_tag)| ### Parameters `(object/array)` Item prototype properties to be updated. The `itemid` property must be defined for each item prototype, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged. Additionally to the [standard item prototype properties](object#item_prototype), the method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |preprocessing|array|Item prototype [preprocessing](/manual/api/reference/itemprototype/object#item_prototype_preprocessing) options to replace the current preprocessing options.| |tags|array|Item prototype [tags](/manual/api/reference/itemprototype/object#item_prototype_tag).| ### پارامتر ها `(object/array)` Web scenario properties to be updated. The `httptestid` property must be defined for each web scenario, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged. Additionally to the [standard web scenario properties](object#web_scenario), the method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |steps|array|Scenario [steps](/manual/api/reference/httptest/object#scenario_step) to replace existing steps.| |tags|array|Web scenario [tags.](/manual/api/reference/httptest/object#web_scenario_tag)| ### Parameters `(object/array)` Item prototype to create. Additionally to the [standard item prototype properties](object#item_prototype), the method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**ruleid**<br>(required)|string|ID of the LLD rule that the item belongs to.| |preprocessing|array|Item prototype [preprocessing](/manual/api/reference/itemprototype/object#item_prototype_preprocessing) options.| |tags|array|Item prototype [tags](/manual/api/reference/itemprototype/object#item_prototype_tag).| ###پارامتر ها `(object/array)` Web scenarios to create. Additionally to the [standard web scenario properties](object#web_scenario), the method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**steps**<br>(required)|array|Web scenario [steps](/manual/api/reference/httptest/object#scenario_step).| |tags|array|Web scenario [tags.](/manual/api/reference/httptest/object#web_scenario_tag)| ### Parameters `(object/array)` Items to create. Additionally to the [standard item properties](object#host), the method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |preprocessing|array|Item [preprocessing](/manual/api/reference/item/object#item_preprocessing) options.| |tags|array|Item [tags.](/manual/api/reference/item/object#item_tag)| ###پارامتر ها `(object/array)` Web scenarios to create. Additionally to the [standard web scenario properties](object#web_scenario), the method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**steps**<br>(required)|array|Web scenario [steps](/manual/api/reference/httptest/object#scenario_step).| |tags|array|Web scenario [tags.](/manual/api/reference/httptest/object#web_scenario_tag)| ### Parameters `(object/array)` Maintenance properties to be updated. The `maintenanceid` property must be defined for each maintenance, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged. Additionally to the [standard maintenance properties](object#maintenance), the method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |groups|object/array|Host [groups](/manual/api/reference/hostgroup/object) to replace the current groups.<br><br>The host groups must have the `groupid` property defined.| |hosts|object/array|[Hosts](/manual/api/reference/host/object) to replace the current hosts.<br><br>The hosts must have the `hostid` property defined.| |timeperiods|object/array|Maintenance [time periods](/manual/api/reference/maintenance/object#time_period) to replace the current periods.| |tags|object/array|[Problem tags](/manual/api/reference/maintenance/object#problem_tag) to replace the current tags.| |groupids<br>(deprecated)|array|This parameter is deprecated, please use `groups` instead.<br>IDs of the host groups that will undergo maintenance.| |hostids<br>(deprecated)|array|This parameter is deprecated, please use `hosts` instead.<br>IDs of the hosts that will undergo maintenance.| ::: noteimportant At least one host or host group must be defined for each maintenance. ::: ### مولفه های ویژگی های نگهداری `(شیء/آرایه)` به روز می شوند. ویژگی "maintenanceid" باید برای هر تعمیر و نگهداری تعریف شود سایر خواص اختیاری هستند. فقط خواص پاس شده خواهد بود به روز شده، بقیه بدون تغییر باقی خواهند ماند. علاوه بر [نگهداری استاندارد خواص](object#maintenance)، متد موارد زیر را می پذیرد مولفه های. |پارامتر|[نوع](/manual/api/reference_commentary#data_types)|توضیحات| |--|--|------| |groups|object/array|Host [groups](/manual/api/reference/hostgroup/object) برای جایگزینی گروه‌های فعلی.<br><br>گروه‌های میزبان باید دارای ویژگی «groupid» تعریف شده باشند.| |hosts|object/array|[Hosts](/manual/api/reference/host/object) برای جایگزینی میزبان‌های فعلی.<br><br>میزبان‌ها باید دارای ویژگی «hostid» تعریف شده باشند.| |timeperiods|object/array|Maintenance [دوره های زمانی](/manual/api/reference/maintenance/object#time_period) جایگزین دوره های جاری می شود.| |tags|object/array|[Problem Tags](/manual/api/reference/maintenance/object#problem_tag) برای جایگزینی برچسب های فعلی.| |groupids<br>(deprecated)|آرایه|این پارامتر منسوخ شده است، لطفاً به جای آن از «گروه‌ها» استفاده کنید.<br>شناسه‌های گروه‌های میزبان که تحت تعمیر و نگهداری قرار خواهند گرفت.| |hostids<br>(deprecated)|آرایه|این پارامتر منسوخ شده است، لطفاً به جای آن از "hosts" استفاده کنید.<br>شناسه هاست هایی که تحت تعمیر و نگهداری قرار خواهند گرفت.| ::: نکته مهم حداقل یک میزبان یا گروه میزبان باید تعریف شود برای هر تعمیر و نگهداری ::: ### Parameters `(object/array)` Maintenances to create. Additionally to the [standard maintenance properties](object#maintenance), the method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |groups|object/array|Host [groups](/manual/api/reference/hostgroup/object) that will undergo maintenance.<br><br>The host groups must have the `groupid` property defined.<br><br>At least one object of `groups` or `hosts` must be specified.| |hosts|object/array|[Hosts](/manual/api/reference/host/object) that will undergo maintenance.<br><br>The hosts must have the `hostid` property defined.<br><br>At least one object of `groups` or `hosts` must be specified.| |**timeperiods**<br>(required)|object/array|Maintenance [time periods](/manual/api/reference/maintenance/object#time_period).| |tags|object/array|[Problem tags](/manual/api/reference/maintenance/object#problem_tag).<br><br>Define what problems must be suppressed.<br>If no tags are given, all active maintenance host problems will be suppressed.| |groupids<br>(deprecated)|array|This parameter is deprecated, please use `groups` instead.<br>IDs of the host groups that will undergo maintenance.| |hostids<br>(deprecated)|array|This parameter is deprecated, please use `hosts` instead.<br>IDs of the hosts that will undergo maintenance.| ### مولفه های "(شیء/آرایه)" نگهداری برای ایجاد. علاوه بر [نگهداری استاندارد خواص](object#maintenance)، متد موارد زیر را می پذیرد مولفه های. |پارامتر|[نوع](/manual/api/reference_commentary#data_types)|توضیحات| |--|--|------| |groups|object/array|میزبان [گروه‌ها](/manual/api/reference/hostgroup/object) که تحت تعمیر و نگهداری قرار می‌گیرند.<br><br>گروه‌های میزبان باید دارای ویژگی «groupid» تعریف شده باشند.<br><br><br><br> br>حداقل یک شی از "گروه ها" یا "میزبان" باید مشخص شود.| |hosts|object/array|[Hosts](/manual/api/reference/host/object) که تحت تعمیر و نگهداری قرار می گیرد.<br><br>میزبان ها باید دارای ویژگی "hostid" تعریف شده باشند.<br><br> حداقل یک شی از "گروه ها" یا "میزبان ها" باید مشخص شود.| |**زمان‌های زمانی**<br>(الزامی)|شیء/آرایه|نگهداری [دوره‌های زمانی](/دستی/api/reference/maintenance/object#time_period).| |tags|object/array|[برچسب‌های مشکل](/manual/api/reference/maintenance/object#problem_tag).<br><br>تعریف کنید چه مشکلاتی باید سرکوب شوند.<br>اگر هیچ برچسبی داده نشد، همه فعال هستند مشکلات میزبان تعمیر و نگهداری سرکوب خواهد شد.| |groupids<br>(deprecated)|آرایه|این پارامتر منسوخ شده است، لطفاً به جای آن از «گروه‌ها» استفاده کنید.<br>شناسه‌های گروه‌های میزبان که تحت تعمیر و نگهداری قرار خواهند گرفت.| |hostids<br>(deprecated)|آرایه|این پارامتر منسوخ شده است، لطفاً به جای آن از "hosts" استفاده کنید.<br>شناسه هاست هایی که تحت تعمیر و نگهداری قرار خواهند گرفت.| ### Parameters `(object/array)` Maps to create. Additionally to the [standard map properties](object#map), the method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |links|array|Map [links](/manual/api/reference/map/object#map_link) to be created on the map.| |selements|array|Map [elements](/manual/api/reference/map/object#map_element) to be created on the map.| |urls|array|Map [URLs](/manual/api/reference/map/object#map_url) to be created on the map.| |users|array|Map [user](/manual/api/reference/map/object#map_user) shares to be created on the map.| |userGroups|array|Map [user group](/manual/api/reference/map/object#map_user_group) shares to be created on the map.| |shapes|array|Map [shapes](/manual/api/reference/map/object#map_shapes) to be created on the map.| |lines|array|Map [lines](/manual/api/reference/map/object#map_lines) to be created on the map.| ::: notetip To create map links you'll need to set a map element `selementid` to an arbitrary value and then use this value to reference this element in the links `selementid1` or `selementid2` properties. When the element is created, this value will be replaced with the correct ID generated by Zabbix. [See example.](create#create_a_host_map) ::: ### مولفه های «(شیء/آرایه)» نقشه هایی برای ایجاد. علاوه بر [مشخصات نقشه استاندارد] (object#map)، روش پارامترهای زیر را می پذیرد. |پارامتر|[نوع](/manual/api/reference_commentary#data_types)|توضیحات| |--|--|------| |پیوندها|آرایه|نقشه [پیوندها](/manual/api/reference/map/object#map_link) روی نقشه ایجاد شود.| |selements|آرایه|نقشه [element](/manual/api/reference/map/object#map_element) روی نقشه ایجاد شود.| |urls|array|نقشه [URLs](/manual/api/reference/map/object#map_url) روی نقشه ایجاد شود.| |کاربران|آرایه|نقشه [user](/manual/api/reference/map/object#map_user) به اشتراک گذاری روی نقشه ایجاد می شود.| |userGroups|آرایه|نقشه [گروه کاربر](/manual/api/reference/map/object#map_user_group) اشتراک‌گذاری‌هایی که روی نقشه ایجاد می‌شوند.| |اشکال|آرایه|نقشه [اشکال](/manual/api/reference/map/object#map_shapes) روی نقشه ایجاد شود.| |خطوط|آرایه|نقشه [خطوط](/manual/api/reference/map/object#map_lines) روی نقشه ایجاد شود.| ::: یادداشت برای ایجاد پیوندهای نقشه، باید یک عنصر نقشه را تنظیم کنید "selementid" به یک مقدار دلخواه و سپس از این مقدار برای ارجاع استفاده کنید این عنصر در پیوندهای "selementid1" یا "selementid2" خواص. هنگامی که عنصر ایجاد می شود، این مقدار با the جایگزین می شود شناسه صحیح ایجاد شده توسط Zabbix. [دیدن مثال.](create#create_a_host_map) ::: ### Parameters `(object/array)` Media type properties to be updated. The `mediatypeid` property must be defined for each media type, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged. Additionally to the [standard media type properties](object#media_type), the method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |parameters|array|[Webhook parameters](object#webhook_parameters) to replace the current webhook parameters.| |message\_templates|array|[Message templates](object#message_template) to replace the current message templates.| ### پارامترها "(شیء/آرایه)" ویژگی های آیکون نقشه به روز می شود. ویژگی "iconmapid" باید برای هر آیکون نقشه تعریف شود و بقیه ویژگی ها اختیاری هستند فقط ویژگی های تصویب شده به روز می شوند، بقیه بدون تغییر باقی خواهند ماند. علاوه بر [مشخصات استاندارد icon map] (object#icon_map)، متد پارامترهای زیر را می پذیرد. |پارامتر|[نوع](/manual/api/reference_commentary#data_types)|توضیحات| |--|--|------| |mappings|آرایه|[Icon mappings](/manual/api/reference/iconmap/object#icon_mapping) برای جایگزینی نگاشت نمادهای موجود.| ### Parameters `(object/array)` Media types to create. Additionally to the [standard media type properties](object#media_type), the method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |parameters|array|[Webhook parameters](object#webhook_parameters) to be created for the media type.| |message\_templates|array|[Message templates](object#message_template) to be created for the media type.| ### پارامترها `(object/array)` Graphs to create. Additionally to the [standard graph properties](object#graph), the method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**gitems**<br>(required)|array|Graph [items](/manual/api/reference/graphitem/object) to be created for the graph.| ### Parameters `(object/array)` Proxies to create. Additionally to the [standard proxy properties](object#proxy), the method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |hosts|array|[Hosts](/manual/api/reference/host/object) to be monitored by the proxy. If a host is already monitored by a different proxy, it will be reassigned to the current proxy.<br><br>The hosts must have the `hostid` property defined.| |interface|object|Host [interface](/manual/api/reference/hostinterface/object) to be created for the passive proxy.<br><br>Required for passive proxies.| ### مولفه های پروکسی های "(شیء/آرایه)" برای ایجاد. علاوه بر [خواص پروکسی استاندارد] (object#proxy)، متد پارامترهای زیر را می پذیرد. |پارامتر|[نوع](/manual/api/reference_commentary#data_types)|توضیحات| |--|--|------| |hosts|آرایه|[Hosts](/manual/api/reference/host/object) که باید توسط پراکسی نظارت شود. اگر میزبانی قبلاً توسط پراکسی دیگری نظارت شده باشد، دوباره به پراکسی فعلی اختصاص داده می‌شود.<br><br>میزبان‌ها باید ویژگی "hostid" را تعریف کرده باشند.| |رابط|شیء|میزبان [رابط](/manual/api/reference/hostinterface/object) برای پراکسی غیرفعال ایجاد می‌شود.<br><br>برای پراکسی‌های غیرفعال مورد نیاز است.| ### Parameters `(object/array)` Proxy properties to be updated. The `proxyid` property must be defined for each proxy, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged. Additionally to the [standard proxy properties](object#proxy), the method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |hosts|array|[Hosts](/manual/api/reference/host/object) to be monitored by the proxy. If a host is already monitored by a different proxy, it will be reassigned to the current proxy.<br><br>The hosts must have the `hostid` property defined.| |interface|object|Host [interface](/manual/api/reference/hostinterface/object) to replace the existing interface for the passive proxy.| ### پارامتر ها `(object/array)` Graph properties to be updated. The `graphid` property must be defined for each graph, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged. Additionally to the [standard graph properties](object#graph) the method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |gitems|array|Graph [items](/manual/api/reference/graphitem/object) to replace existing graph items. If a graph item has the `gitemid` property defined it will be updated, otherwise a new graph item will be created.| ### Parameters `(object/array)` Regular expression properties to be updated. The `regexpid` property must be defined for each object, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged. Additionally to the [standard properties](object#expressions), the method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |expressions|array|[Expressions](/manual/api/reference/regexp/object#expressions) options.| ### پارامترها "(شیء/آرایه)" ویژگی های آیکون نقشه به روز می شود. ویژگی "iconmapid" باید برای هر آیکون نقشه تعریف شود و بقیه ویژگی ها اختیاری هستند فقط ویژگی های تصویب شده به روز می شوند، بقیه بدون تغییر باقی خواهند ماند. علاوه بر [مشخصات استاندارد icon map] (object#icon_map)، متد پارامترهای زیر را می پذیرد. |پارامتر|[نوع](/manual/api/reference_commentary#data_types)|توضیحات| |--|--|------| |mappings|آرایه|[Icon mappings](/manual/api/reference/iconmap/object#icon_mapping) برای جایگزینی نگاشت نمادهای موجود.| ### Parameters `(object/array)` Regular expressions to create. Additionally to the [standard properties](object), the method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |expressions|array|[Expressions](/manual/api/reference/regexp/object#expressions) options.| ### پارامترها `(object/array)` Graphs to create. Additionally to the [standard graph properties](object#graph), the method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**gitems**<br>(required)|array|Graph [items](/manual/api/reference/graphitem/object) to be created for the graph.| ### Parameters `(object/array)` Scheduled reports to create. Additionally to the [standard scheduled report properties](object#report), the method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |users|object/array|[Users](object#users) to send the report to.| |user\_groups|object/array|[User groups](object#user_groups) to send the report to.| ### پارامترها `(object/array)` Graphs to create. Additionally to the [standard graph properties](object#graph), the method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**gitems**<br>(required)|array|Graph [items](/manual/api/reference/graphitem/object) to be created for the graph.| ### Parameters `(object/array)` Scripts to create. The method accepts scripts with the [standard script properties](/manual/api/reference/script/object#script). ### پارامترها اسکریپت هایی برای ایجاد `(شیء/آرایه). این روش اسکریپت هایی را با [خواص اسکریپت استاندارد می پذیرد ](/دستی/api/reference/script/object#script). ### Parameters `(object/array)` service properties to be updated. The `serviceid` property must be defined for each service, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged. Additionally to the [standard service properties](object#service), the method accepts the following parameters. | Parameter | [Type](/manual/api/reference_commentary#data_types) | Description | |---------------|-----------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------| | children | array | Child services to replace the current service children.<br><br>The children must have the `serviceid` property defined. | | parents | array | Parent services to replace the current service parents.<br><br>The parents must have the `serviceid` property defined. | | tags | array | Service [tags](/manual/api/reference/service/object#service_tag) to replace the current service tags. | | problem\_tags | array | [Problem tags](/manual/api/reference/service/object#problem_tag) to replace the current problem tags. | | status\_rules | array | [Status rules](/manual/api/reference/service/object#status_rule) to replace the current status rules. | ### مولفه های ویژگی های سرویس `(شیء/آرایه)` باید به روز شوند. ویژگی `serviceid` باید برای هر سرویس تعریف شود خواص اختیاری هستند فقط ویژگی های تصویب شده به روز می شوند، همه بقیه بدون تغییر باقی خواهند ماند. علاوه بر [خواص سرویس استاندارد] (object#service)، متد پارامترهای زیر را می پذیرد. | پارامتر | [Type](/manual/api/reference_commentary#data_types) | توضیحات | |------------------------------------------------- ------------------------------------------------- ------------------------------------------------ ------------------------------------------| | کودکان | آرایه | خدمات کودک برای جایگزینی فرزندان سرویس فعلی.<br><br>کودکان باید دارای ویژگی «serviceid» تعریف شده باشند. | | پدر و مادر | آرایه | خدمات والدین برای جایگزینی والدین خدمات فعلی.<br><br>والدین باید ویژگی "serviceid" را تعریف کنند. | | برچسب ها | آرایه | [برچسب‌ها](/manual/api/reference/service/object#service_tag) را برای جایگزینی برچسب‌های سرویس فعلی سرویس دهید. | | problem\_tags | آرایه | [برچسب‌های مشکل](/manual/api/reference/service/object#problem_tag) برای جایگزینی برچسب‌های مشکل فعلی. | | وضعیت\_قوانین | آرایه | [قوانین وضعیت](/manual/api/reference/service/object#status_rule) برای جایگزینی قوانین وضعیت فعلی. | ### Parameters `(object/array)` SLA objects to create. Additionally to the [standard SLA properties](object#sla), the method accepts the following parameters. | Parameter | [Type](/manual/api/reference_commentary#data_types) | Description | |--------------------------------|-----------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------| | **service_tags**<br>(required) | array | SLA service tags to be created for the SLA.<br>At least one service tag must be specified. | | schedule | array | SLA schedule to be created for the SLA.<br>Specifying an empty parameter will be interpreted as a 24x7 schedule.<br>Default: 24x7 schedule. | | excluded_downtimes | array | SLA excluded downtimes to be created for the SLA. | ### مولفه های اشیاء SLA برای ایجاد «(شیء/آرایه)». علاوه بر [ویژگی‌های استاندارد SLA] (object#sla)، متد پارامترهای زیر را می پذیرد. | پارامتر | [Type](/manual/api/reference_commentary#data_types) | توضیحات | |------------------------------------------------ --------------------------------------------------- ------------------------------------------------ ------------------------------------------------ -----------------------------| | **تگ_سرویس**<br>(الزامی) | آرایه | برچسب‌های سرویس SLA باید برای SLA ایجاد شوند.<br>حداقل یک برچسب سرویس باید مشخص شود. | | برنامه زمانبندی | آرایه | زمان‌بندی SLA برای SLA ایجاد می‌شود.<br>تعیین یک پارامتر خالی به‌عنوان یک زمان‌بندی 24x7 تفسیر می‌شود.<br>پیش‌فرض: زمان‌بندی 24x7. | | excluded_downtimes | آرایه | SLA زمان های خرابی ایجاد شده برای SLA را حذف کرد. | ### Parameters `(object/array)` SLA properties to be updated. The `slaid` property must be defined for each SLA, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged. Additionally to the [standard SLA properties](object#sla), the method accepts the following parameters. | Parameter | [Type](/manual/api/reference_commentary#data_types) | Description | |---------------------|-----------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | service\_tags | array | SLA [service tags](/manual/api/reference/sla/object#sla-service-tag) to replace the current SLA service tags.<br><br>At least one service tag must be specified. | | schedule | array | SLA [schedule](/manual/api/reference/sla/object#sla-schedule) to replace the current one.<br><br>Specifying parameter as empty will be interpreted as a 24x7 schedule. | | excluded\_downtimes | array | SLA [excluded downtimes](/manual/api/reference/sla/object#sla-excluded-downtime) to replace the current ones. | ### مولفه های ویژگی های SLA `(شیء/آرایه)` باید به روز شوند. خاصیت "slaid" باید برای هر SLA تعریف شود خواص اختیاری هستند فقط ویژگی های تصویب شده به روز می شوند، همه بقیه بدون تغییر باقی خواهند ماند. علاوه بر [ویژگی‌های استاندارد SLA] (object#sla)، متد پارامترهای زیر را می پذیرد. | پارامتر | [Type](/manual/api/reference_commentary#data_types) | توضیحات | |------------------------------------------------ ------------------------------------------------- ------------------------------------------------ ------------------------------------------------ ---------------------------------------------| | سرویس\_برچسب ها | آرایه | SLA [برچسب‌های سرویس](/manual/api/reference/sla/object#sla-service-tag) برای جایگزینی برچسب‌های سرویس فعلی SLA.<br><br>حداقل یک برچسب سرویس باید مشخص شود. | | برنامه زمانبندی | آرایه | SLA [زمان‌بندی](/manual/api/reference/sla/object#sla-schedule) برای جایگزینی زمان‌بندی فعلی.<br><br>تعیین پارامتر خالی به‌عنوان یک زمان‌بندی 24x7 تفسیر می‌شود. | | حذف شده\_downtimes | آرایه | SLA [حالت خرابی حذف شده](/دستی/api/reference/sla/object#sla-excluded-downtime) برای جایگزینی موارد فعلی. | ### Parameters `(object/array)` Template dashboard properties to be updated. The `dashboardid` property must be specified for each dashboard, all other properties are optional. Only the specified properties will be updated. Additionally to the [standard template dashboard properties](object#template_dashboard), the method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |pages|array|Template dashboard [pages](object#template_dashboard_page) to replace the existing dashboard pages.<br><br>Dashboard pages are updated by the `dashboard_pageid` property. New dashboard pages will be created for objects without `dashboard_pageid` property and the existing dashboard pages will be deleted if not reused. Dashboard pages will be ordered in the same order as specified. Only the specified properties of the dashboard pages will be updated. At least one dashboard page object is required for `pages` property.| ### مولفه های ویژگی های داشبورد الگو به روز می شود. ویژگی "dashboardid" باید برای هر داشبورد، همه مشخص شود سایر خواص اختیاری هستند. فقط خواص مشخص شده خواهد بود به روز شد. علاوه بر این به [داشبورد قالب استاندارد خواص](object#template_dashboard)، این روش موارد زیر را می پذیرد مولفه های. |پارامتر|[نوع](/manual/api/reference_commentary#data_types)|توضیحات| |--|--|------| |pages|array|داشبورد الگو [صفحات](object#template_dashboard_page) برای جایگزینی صفحات داشبورد موجود.<br><br>صفحات داشبورد توسط ویژگی "dashboard_pageid" به روز می شوند. صفحات داشبورد جدید برای اشیاء بدون ویژگی "dashboard_pageid" ایجاد می شود و صفحات داشبورد موجود در صورت عدم استفاده مجدد حذف خواهند شد. صفحات داشبورد به همان ترتیبی که مشخص شده است مرتب می شوند. فقط ویژگی های مشخص شده صفحات داشبورد به روز می شود. حداقل یک شی صفحه داشبورد برای ویژگی "pages" مورد نیاز است.| ### Parameters `(object/array)` Template dashboards to create. Additionally to the [standard template dashboard properties](object#template_dashboard), the method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**pages**<br>(required)|array|Template dashboard [pages](object#dashboard_page) to be created for the dashboard. Dashboard pages will be ordered in the same order as specified. At least one dashboard page object is required for `pages` property.| ### پارامتر ها ### Parameters `(object/array)` Templates to create. Additionally to the [standard template properties](object#template), the method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**groups**<br>(required)|object/array|Host [groups](/manual/api/reference/hostgroup/object) to add the template to.<br><br>The host groups must have the `groupid` property defined.| |tags|object/array|Template [tags](/manual/api/reference/template/object#template_tag).| |templates|object/array|[Templates](/manual/api/reference/template/object) to be linked to the template.<br><br>The templates must have the `templateid` property defined.| |macros|object/array|[User macros](/manual/api/reference/usermacro/object) to be created for the template.| ### پارامتر ها قالب های برای ساخت یک آبجکت یا آرایه . Additionally to the [standard template properties](object#template), the method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**groups**<br>(required)|object/array|Host [groups](/manual/api/reference/hostgroup/object) to add the template to.<br><br>The host groups must have the `groupid` property defined.| |tags|object/array|Template [tags](/manual/api/reference/template/object#template_tag).| |templates|object/array|[Templates](/manual/api/reference/template/object) to be linked to the template.<br><br>The templates must have the `templateid` property defined.| |macros|object/array|[User macros](/manual/api/reference/usermacro/object) to be created for the template.| ### Parameters `(object/array)` Trigger properties to be updated. The `triggerid` property must be defined for each trigger, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged. Additionally to the [standard trigger properties](object#trigger) the method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |dependencies|array|Triggers that the trigger is dependent on.<br><br>The triggers must have the `triggerid` property defined.| |tags|array|Trigger [tags.](/manual/api/reference/trigger/object#trigger_tag)| ::: noteimportant The trigger expression has to be given in its expanded form. ::: ### پارامتر ها `(object/array)` Web scenario properties to be updated. The `httptestid` property must be defined for each web scenario, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged. Additionally to the [standard web scenario properties](object#web_scenario), the method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |steps|array|Scenario [steps](/manual/api/reference/httptest/object#scenario_step) to replace existing steps.| |tags|array|Web scenario [tags.](/manual/api/reference/httptest/object#web_scenario_tag)| ### Parameters `(object/array)` [Trigger prototype properties](object#trigger_prototype) to be updated. The `triggerid` property must be defined for each trigger prototype, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged. Additionally to the [standard trigger prototype properties](object#trigger_prototype) the method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |dependencies|array|Triggers and trigger prototypes that the trigger prototype is dependent on.<br><br>The triggers must have the `triggerid` property defined.| |tags|array|Trigger prototype [tags](/manual/api/reference/triggerprototype/object#trigger_prototype_tag).| ::: noteimportant The trigger expression has to be given in its expanded form and must contain at least one item prototype. ::: ### پارامتر ها `(object/array)` Web scenario properties to be updated. The `httptestid` property must be defined for each web scenario, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged. Additionally to the [standard web scenario properties](object#web_scenario), the method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |steps|array|Scenario [steps](/manual/api/reference/httptest/object#scenario_step) to replace existing steps.| |tags|array|Web scenario [tags.](/manual/api/reference/httptest/object#web_scenario_tag)| ### Parameters `(object/array)` User group properties to be updated. The `usrgrpid` property must be defined for each user group, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged. Additionally to the [standard user group properties](object#user_group), the method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |rights|object/array|[Permissions](/manual/api/reference/usergroup/object#permission) to replace the current permissions assigned to the user group.| |tag\_filters|array|[Tag based permissions](/manual/api/reference/usergroup/object#tag_based_permission) to replace the current permissions assigned to the user group.| |users|object/array|[Users](/manual/api/reference/user/create) to replace the current users assigned to the user group.<br><br>The user must have only the `userid` property defined.| ### پارامتر ها `(object/array)` Graph properties to be updated. The `graphid` property must be defined for each graph, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged. Additionally to the [standard graph properties](object#graph) the method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |gitems|array|Graph [items](/manual/api/reference/graphitem/object) to replace existing graph items. If a graph item has the `gitemid` property defined it will be updated, otherwise a new graph item will be created.| ### Parameters `(object/array)` [Value map properties](object#value_map) to be updated. The `valuemapid` property must be defined for each value map, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged. ### پارامتر ها `(object/array)` [Host group properties](object#host_group) to be updated. The `groupid` property must be defined for each host group, all other properties are optional. Only the given properties will be updated, all others will remain unchanged. ### Parameters `(object/array)` Value maps to create. The method accepts value maps with the [standard value map properties](object#value_map). ### پارامتر ها `(object/array)` Host groups to create. The method accepts host groups with the [standard host group properties](object#host_group). ### Parameters `(object/array)` Web scenario properties to be updated. The `httptestid` property must be defined for each web scenario, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged. Additionally to the [standard web scenario properties](object#web_scenario), the method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |steps|array|Scenario [steps](/manual/api/reference/httptest/object#scenario_step) to replace existing steps.| |tags|array|Web scenario [tags.](/manual/api/reference/httptest/object#web_scenario_tag)| ### پارامتر ها `(object/array)` Web scenario properties to be updated. The `httptestid` property must be defined for each web scenario, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged. Additionally to the [standard web scenario properties](object#web_scenario), the method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |steps|array|Scenario [steps](/manual/api/reference/httptest/object#scenario_step) to replace existing steps.| |tags|array|Web scenario [tags.](/manual/api/reference/httptest/object#web_scenario_tag)| ### Parameters `(object/array)` Web scenarios to create. Additionally to the [standard web scenario properties](object#web_scenario), the method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**steps**<br>(required)|array|Web scenario [steps](/manual/api/reference/httptest/object#scenario_step).| |tags|array|Web scenario [tags.](/manual/api/reference/httptest/object#web_scenario_tag)| ###پارامتر ها `(object/array)` Web scenarios to create. Additionally to the [standard web scenario properties](object#web_scenario), the method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**steps**<br>(required)|array|Web scenario [steps](/manual/api/reference/httptest/object#scenario_step).| |tags|array|Web scenario [tags.](/manual/api/reference/httptest/object#web_scenario_tag)| ### Parameters `(object)` Authentication properties to be updated. ### پارامترها `(شیء)` ویژگی های احراز هویت به روز می شود. ### Parameters `(object)` Autoregistration properties to be updated. ### پارامترها `(شیء)` ویژگی های ثبت نام خودکار به روز می شود. ### Parameters `(object)` Housekeeping properties to be updated. ### پارامتر ها `(object)` Housekeeping properties to be updated. ### Parameters `(object)` Parameters containing the host interfaces to be created on the given hosts. The method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**hosts**<br>(required)|object/array|Hosts to be updated.<br><br>The hosts must have the `hostid` property defined.| |**interfaces**<br>(required)|object/array|[Host interfaces](/manual/api/reference/hostinterface/object) to create on the given hosts.| ###پارامتر ها `(object)` Parameters containing the host interfaces to be created on the given hosts. The method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**hosts**<br>(required)|object/array|Hosts to be updated.<br><br>The hosts must have the `hostid` property defined.| |**interfaces**<br>(required)|object/array|[Host interfaces](/manual/api/reference/hostinterface/object) to create on the given hosts.| ### Parameters `(object)` Parameters containing the ID of the host to be updated and the new host interfaces. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**hostid**<br>(required)|string|ID of the host to be updated.| |**interfaces**<br>(required)|object/array|[Host interfaces](/manual/api/reference/hostinterface/object) to replace the current host interfaces with.| ### پارامتر ها `(object)` Parameters containing the ID of the host to be updated and the new host interfaces. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**hostid**<br>(required)|string|ID of the host to be updated.| |**interfaces**<br>(required)|object/array|[Host interfaces](/manual/api/reference/hostinterface/object) to replace the current host interfaces with.| ### Parameters `(object)` Parameters containing the ID of the script to run and either the ID of the host or the ID of the event. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**scriptid**<br>(required)|string|ID of the script to run.| |hostid|string|ID of the host to run the script on.| |eventid|string|ID of the event to run the script on.| ###پارامتر ها `(object)` Parameters containing the IDs of the host groups to update and the objects that should be removed. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**groupids**<br>(required)|string/array|IDs of the host groups to be updated.| |hostids|string/array|Hosts to remove from all host groups.| |templateids|string/array|Templates to remove from all host groups.| ### Parameters `(object)` Parameters containing the IDs of the host groups to update and the objects that should be removed. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**groupids**<br>(required)|string/array|IDs of the host groups to be updated.| |hostids|string/array|Hosts to remove from all host groups.| |templateids|string/array|Templates to remove from all host groups.| ###پارامتر ها `(object)` Parameters containing the IDs of the host groups to update and the objects that should be removed. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**groupids**<br>(required)|string/array|IDs of the host groups to be updated.| |hostids|string/array|Hosts to remove from all host groups.| |templateids|string/array|Templates to remove from all host groups.| ### Parameters `(object)` Parameters containing the IDs of the host groups to update and the objects that should be updated. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**groups**<br>(required)|object/array|Host groups to be updated.<br><br>The host groups must have the `groupid` property defined.| |**hosts**<br>(required)|object/array|Hosts to replace the current hosts on the given host groups.<br>All other hosts, except the ones mentioned, will be excluded from host groups.<br>Discovered hosts will not be affected.<br><br>The hosts must have the `hostid` property defined.| |**templates**<br>(required)|object/array|Templates to replace the current templates on the given host groups.<br>All other templates, except the ones mentioned, will be excluded from host groups.<br><br>The templates must have the `templateid` property defined.| پارامتر ها ### Parameters `(object)` Parameters containing the IDs of the host groups to update and the objects to add to all the host groups. The method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**groups**<br>(required)|object/array|Host groups to be updated.<br><br>The host groups must have the `groupid` property defined.| |hosts|object/array|Hosts to add to all host groups.<br><br>The hosts must have the `hostid` property defined.| |templates|object/array|Templates to add to all host groups.<br><br>The templates must have the `templateid` property defined.| ### پارامتر ها `(object)` Parameters containing the IDs of the host groups to update and the objects to add to all the host groups. The method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**groups**<br>(required)|object/array|Host groups to be updated.<br><br>The host groups must have the `groupid` property defined.| |hosts|object/array|Hosts to add to all host groups.<br><br>The hosts must have the `hostid` property defined.| |templates|object/array|Templates to add to all host groups.<br><br>The templates must have the `templateid` property defined.| ### Parameters `(object)` Parameters containing the IDs of the hosts to be updated and the interfaces to be removed. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**hostids**<br>(required)|string/array|IDs of the hosts to be updated.| |**interfaces**<br>(required)|object/array|Host interfaces to remove from the given hosts.<br><br>The host interface object must have the ip, dns and port properties defined| ### پارامتر ها `(object)` Parameters containing the IDs of the hosts to be updated and the interfaces to be removed. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**hostids**<br>(required)|string/array|IDs of the hosts to be updated.| |**interfaces**<br>(required)|object/array|Host interfaces to remove from the given hosts.<br><br>The host interface object must have the ip, dns and port properties defined| ### Parameters `(object)` Parameters containing the IDs of the hosts to update and the objects that should be removed. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**hostids**<br>(required)|string/array|IDs of the hosts to be updated.| |groupids|string/array|Host groups to remove the given hosts from.| |interfaces|object/array|Host interfaces to remove from the given hosts.<br><br>The host interface object must have the `ip`, `dns` and `port` properties defined.| |macros|string/array|User macros to delete from the given hosts.| |templateids|string/array|Templates to unlink from the given hosts.| |templateids\_clear|string/array|Templates to unlink and clear from the given hosts.| ###پارامتر ها `(object)` Parameters containing the IDs of the hosts to update and the objects that should be removed. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**hostids**<br>(required)|string/array|IDs of the hosts to be updated.| |groupids|string/array|Host groups to remove the given hosts from.| |interfaces|object/array|Host interfaces to remove from the given hosts.<br><br>The host interface object must have the `ip`, `dns` and `port` properties defined.| |macros|string/array|User macros to delete from the given hosts.| |templateids|string/array|Templates to unlink from the given hosts.| |templateids\_clear|string/array|Templates to unlink and clear from the given hosts.| ### Parameters `(object)` Parameters containing the IDs of the hosts to update and the objects to add to all the hosts. The method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**hosts**<br>(required)|object/array|Hosts to be updated.<br><br>The hosts must have the `hostid` property defined.| |groups|object/array|Host groups to add to the given hosts.<br><br>The host groups must have the `groupid` property defined.| |interfaces|object/array|[Host interfaces](/manual/api/reference/hostinterface/object) to be created for the given hosts.| |macros|object/array|[User macros](/manual/api/reference/usermacro/object) to be created for the given hosts.| |templates|object/array|Templates to link to the given hosts.<br><br>The templates must have the `templateid` property defined.| ### پارامتر ها `(object)` Parameters containing the IDs of the hosts to update and the objects to add to all the hosts. The method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**hosts**<br>(required)|object/array|Hosts to be updated.<br><br>The hosts must have the `hostid` property defined.| |groups|object/array|Host groups to add to the given hosts.<br><br>The host groups must have the `groupid` property defined.| |interfaces|object/array|[Host interfaces](/manual/api/reference/hostinterface/object) to be created for the given hosts.| |macros|object/array|[User macros](/manual/api/reference/usermacro/object) to be created for the given hosts.| |templates|object/array|Templates to link to the given hosts.<br><br>The templates must have the `templateid` property defined.| ### Parameters `(object)` Parameters containing the IDs of the hosts to update and the properties that should be updated. Additionally to the [standard host properties](object#host), the method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**hosts**<br>(required)|object/array|[Hosts](/manual/api/reference/host/object) to be updated.<br><br>The hosts must have the `hostid` property defined.| |groups|object/array|Host [groups](/manual/api/reference/hostgroup/object) to replace the current host groups the hosts belong to.<br><br>The host groups must have the `groupid` property defined.| |interfaces|object/array|Host [interfaces](/manual/api/reference/hostinterface/object) to replace the current host interfaces on the given hosts.| |inventory|object|Host [inventory](/manual/api/reference/host/object#host_inventory) properties.<br><br>Host inventory mode cannot be updated using the `inventory` parameter, use `inventory_mode` instead.| |macros|object/array|[User macros](/manual/api/reference/usermacro/object) to replace the current user macros on the given hosts.| |templates|object/array|[Templates](/manual/api/reference/template/object) to replace the currently linked templates on the given hosts.<br><br>The templates must have the `templateid` property defined.| |templates\_clear|object/array|[Templates](/manual/api/reference/template/object) to unlink and clear from the given hosts.<br><br>The templates must have the `templateid` property defined.| ###پارامتر ها `(object)` Parameters containing the IDs of the hosts to update and the properties that should be updated. Additionally to the [standard host properties](object#host), the method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**hosts**<br>(required)|object/array|[Hosts](/manual/api/reference/host/object) to be updated.<br><br>The hosts must have the `hostid` property defined.| |groups|object/array|Host [groups](/manual/api/reference/hostgroup/object) to replace the current host groups the hosts belong to.<br><br>The host groups must have the `groupid` property defined.| |interfaces|object/array|Host [interfaces](/manual/api/reference/hostinterface/object) to replace the current host interfaces on the given hosts.| |inventory|object|Host [inventory](/manual/api/reference/host/object#host_inventory) properties.<br><br>Host inventory mode cannot be updated using the `inventory` parameter, use `inventory_mode` instead.| |macros|object/array|[User macros](/manual/api/reference/usermacro/object) to replace the current user macros on the given hosts.| |templates|object/array|[Templates](/manual/api/reference/template/object) to replace the currently linked templates on the given hosts.<br><br>The templates must have the `templateid` property defined.| |templates\_clear|object/array|[Templates](/manual/api/reference/template/object) to unlink and clear from the given hosts.<br><br>The templates must have the `templateid` property defined.| ### Parameters `(object)` Parameters containing the IDs of the templates to update and the objects that should be removed. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**templateids**<br>(required)|string/array|IDs of the templates to be updated.| |groupids|string/array|Host groups to remove the given templates from.| |macros|string/array|User macros to delete from the given templates.| |templateids\_clear|string/array|Templates to unlink and clear from the given templates (upstream).| |templateids\_link|string/array|Templates to unlink from the given templates (upstream).| ###پارامتر ها `(object)` Parameters containing the IDs of the hosts to update and the objects that should be removed. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**hostids**<br>(required)|string/array|IDs of the hosts to be updated.| |groupids|string/array|Host groups to remove the given hosts from.| |interfaces|object/array|Host interfaces to remove from the given hosts.<br><br>The host interface object must have the `ip`, `dns` and `port` properties defined.| |macros|string/array|User macros to delete from the given hosts.| |templateids|string/array|Templates to unlink from the given hosts.| |templateids\_clear|string/array|Templates to unlink and clear from the given hosts.| ### Parameters `(object)` Parameters containing the IDs of the templates to update and the objects to add to the templates. The method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**templates**<br>(required)|object/array|Templates to be updated.<br><br>The templates must have the `templateid` property defined.| |groups|object/array|Host groups to add the given templates to.<br><br>The host groups must have the `groupid` property defined.| |macros|object/array|User macros to be created for the given templates.| |templates\_link|object/array|Templates to link to the given templates.<br><br>The templates must have the `templateid` property defined.| ### پارامتر ها `(object)` Parameters containing the IDs of the hosts to update and the objects to add to all the hosts. The method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**hosts**<br>(required)|object/array|Hosts to be updated.<br><br>The hosts must have the `hostid` property defined.| |groups|object/array|Host groups to add to the given hosts.<br><br>The host groups must have the `groupid` property defined.| |interfaces|object/array|[Host interfaces](/manual/api/reference/hostinterface/object) to be created for the given hosts.| |macros|object/array|[User macros](/manual/api/reference/usermacro/object) to be created for the given hosts.| |templates|object/array|Templates to link to the given hosts.<br><br>The templates must have the `templateid` property defined.| ### Parameters `(object)` Parameters defining the LLD rules to copy and the target hosts. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |discoveryids|array|IDs of the LLD rules to be copied.| |hostids|array|IDs of the hosts to copy the LLD rules to.| ### پارامترها `(object)` Parameters defining the LLD rules to copy and the target hosts. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |discoveryids|array|IDs of the LLD rules to be copied.| |hostids|array|IDs of the hosts to copy the LLD rules to.| ### Parameters `(object)` Settings properties to be updated. ### پارامتر ها `(object)` Housekeeping properties to be updated. ### Parameters The following parameters are supported for the *Data overview* widget. |Parameter|<|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-|--------|--|--------|-------------------------------| |*Refresh interval*|<|0|rf_rate|0 - No refresh;<br>10 - 10 seconds;<br>30 - 30 seconds;<br>60 - *(default)* 1 minute;<br>120 - 2 minutes;<br>600 - 10 minutes;<br>900 - 15 minutes.| |*Host groups*|<|2|groupids|[Host group](/manual/api/reference/hostgroup/get) ID.<br><br>Note: To configure multiple host groups, create a dashboard widget field object for each host group.| |*Hosts*|<|3|hostids|[Host](/manual/api/reference/host/get) ID.<br><br>Note: To configure multiple hosts, create a dashboard widget field object for each host. For multiple hosts, the parameter *Host groups* must either be not configured at all or configured with at least one host group that the configured hosts belong to.| |*Tags* (the number in the property name (e.g. tags.tag.0) references tag order in the tag evaluation list)|<|<|<|<| |<|*Evaluation type*|0|evaltype|0 - *(default)* And/Or;<br>2 - Or.| |^|*Tag name*|1|tags.tag.0|Any string value.<br><br>Parameter *Tag name* required if configuring *Tags*.| |^|*Operator*|0|tags.operator.0|0 - Contains;<br>1 - Equals;<br>2 - Does not contain;<br>3 - Does not equal;<br>4 - Exists;<br>5 - Does not exist.<br><br>Parameter *Operator* required if configuring *Tags*.| |^|*Tag value*|1|tags.value.0|Any string value.<br><br>Parameter *Tag value* required if configuring *Tags*.| |*Show suppressed problems*|<|0|show_suppressed|0 - *(default)* Disabled;<br>1 - Enabled.| |*Hosts location*|<|0|style|0 - *(default)* Left;<br>1 - Top.| ### مولفه های پارامترهای زیر برای ویجت *نمای کلی داده* پشتیبانی می شوند. |پارامتر|<|[نوع](/manual/api/reference/dashboard/object#dashboard-widget-field)|نام|مقدار| |-|--------|--|--------|------------------------- -----| |*فاصله بازخوانی*|<|0|rf_rate|0 - بدون بازخوانی؛<br>10 - 10 ثانیه؛<br>30 - 30 ثانیه؛<br>60 - *(پیش‌فرض)* 1 دقیقه؛<br>120 - 2 دقیقه؛<br>600 - 10 دقیقه؛<br>900 - 15 دقیقه.| |*گروه میزبان*|<|2|گروه|[گروه میزبان](/manual/api/reference/hostgroup/get).<br><br>توجه: برای پیکربندی چند گروه میزبان، یک شی فیلد ویجت داشبورد ایجاد کنید برای هر گروه میزبان.| |*Hosts*|<|3|hostids|[Host](/manual/api/reference/host/get) ID.<br><br>توجه: برای پیکربندی چندین میزبان، یک شی فیلد ویجت داشبورد برای هر میزبان ایجاد کنید. . برای چندین میزبان، پارامتر *گروه های میزبان* باید یا اصلاً پیکربندی نشده باشد یا حداقل با یک گروه میزبان که میزبان های پیکربندی شده به آن تعلق دارند، پیکربندی شود. |*برچسب*ها (تعداد در نام دارایی (به عنوان مثال tags.tag.0) ارجاع به ترتیب برچسب در لیست ارزیابی برچسب)|<|<|<|<| |<|*نوع ارزیابی*|0|evaltype|0 - *(پیش فرض)* And/Or;<br>2 - Or.| |^|*نام برچسب*|1|tags.tag.0|هر مقدار رشته.<br><br>پارامتر *نام برچسب* در صورت پیکربندی *برچسب*ها لازم است.| |^|*اپراتور*|0|tags.operator.0|0 - شامل؛<br>1 - برابر است؛<br>2 - حاوی نیست؛<br>3 - برابر نیست؛<br>4 - وجود دارد ;<br>5 - وجود ندارد.<br><br>در صورت پیکربندی *برچسب*ها، پارامتر *اپراتور* مورد نیاز است.| |^|*مقدار برچسب*|1|tags.value.0|هر مقدار رشته.<br><br>پارامتر *مقدار برچسب* در صورت پیکربندی *برچسب*ها لازم است.| |*نمایش مشکلات سرکوب شده*|<|0|show_suppressed|0 - *(پیش فرض)* غیرفعال شده؛<br>1 - فعال است.| |*مکان میزبان*|<|0|سبک|0 - *(پیش فرض)* سمت چپ؛<br>1 - بالا.| ### Parameters The following parameters are supported for the *Top Hosts* widget. |Parameter|<|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-|--------|--|--------|-------------------------------| |*Refresh interval*|<|0|rf_rate|0 - No refresh;<br>10 - 10 seconds;<br>30 - 30 seconds;<br>60 - *(default)* 1 minute;<br>120 - 2 minutes;<br>600 - 10 minutes;<br>900 - 15 minutes.| |*Host groups*|<|2|groupids|[Host group](/manual/api/reference/hostgroup/get) ID.<br><br>Note: To configure multiple host groups, create a dashboard widget field object for each host group.| |*Hosts*|<|3|hostids|[Host](/manual/api/reference/host/get) ID.<br><br>Note: To configure multiple hosts, create a dashboard widget field object for each host. For multiple hosts, the parameter *Host groups* must either be not configured at all or configured with at least one host group that the configured hosts belong to.| |*Host Tags* (the number in the property name (e.g. tags.tag.0) references tag order in the tag evaluation list)|<|<|<|<| |<|*Evaluation type*|0|evaltype|0 - *(default)* And/Or;<br>2 - Or.| |^|*Tag name*|1|tags.tag.0|Any string value.<br><br>Parameter *Tag name* required if configuring *Tags*.| |^|*Operator*|0|tags.operator.0|0 - Contains;<br>1 - Equals;<br>2 - Does not contain;<br>3 - Does not equal;<br>4 - Exists;<br>5 - Does not exist.<br><br>Parameter *Operator* required if configuring *Tags*.| |^|*Tag value*|1|tags.value.0|Any string value.<br><br>Parameter *Tag value* required if configuring *Tags*.| |*Columns* (see below)|<|<|<|<| |*Order*|<|0|order|2 - *(default)* Top N;<br>3 - Bottom N.| |*Order column*|<|0|column|Column numeric value from the configured columns.| |*Host count*|<|0|count|Valid values range from 1-100.<br><br>Default: 10.| ### مولفه های پارامترهای زیر برای ویجت *Top Hosts* پشتیبانی می شوند. |پارامتر|<|[نوع](/manual/api/reference/dashboard/object#dashboard-widget-field)|نام|مقدار| |-|--------|--|--------|------------------------- -----| |*فاصله بازخوانی*|<|0|rf_rate|0 - بدون بازخوانی؛<br>10 - 10 ثانیه؛<br>30 - 30 ثانیه؛<br>60 - *(پیش‌فرض)* 1 دقیقه؛<br>120 - 2 دقیقه؛<br>600 - 10 دقیقه؛<br>900 - 15 دقیقه.| |*گروه میزبان*|<|2|گروه|[گروه میزبان](/manual/api/reference/hostgroup/get).<br><br>توجه: برای پیکربندی چندین گروه میزبان، یک شی فیلد ویجت داشبورد ایجاد کنید برای هر گروه میزبان.| |*Hosts*|<|3|hostids|[Host](/manual/api/reference/host/get) ID.<br><br>توجه: برای پیکربندی چندین میزبان، یک شی فیلد ویجت داشبورد برای هر میزبان ایجاد کنید. . برای چندین میزبان، پارامتر *گروه های میزبان* باید یا اصلاً پیکربندی نشده باشد یا حداقل با یک گروه میزبان که میزبان های پیکربندی شده به آن تعلق دارند، پیکربندی شود. |*برچسب های میزبان* (تعداد در نام ویژگی (به عنوان مثال tags.tag.0) ارجاع به ترتیب برچسب در لیست ارزیابی برچسب)|<|<|<|<| |<|*نوع ارزیابی*|0|evaltype|0 - *(پیش فرض)* And/Or;<br>2 - Or.| |^|*نام برچسب*|1|tags.tag.0|هر مقدار رشته.<br><br>پارامتر *نام برچسب* در صورت پیکربندی *برچسب*ها لازم است.| |^|*اپراتور*|0|tags.operator.0|0 - شامل؛<br>1 - برابر است؛<br>2 - حاوی نیست؛<br>3 - برابر نیست؛<br>4 - وجود دارد ;<br>5 - وجود ندارد.<br><br>در صورت پیکربندی *برچسب*ها، پارامتر *اپراتور* مورد نیاز است.| |^|*مقدار برچسب*|1|tags.value.0|هر مقدار رشته ای.<br><br>پارامتر *مقدار برچسب* در صورت پیکربندی *برچسب*ها لازم است.| |*ستون* (به زیر مراجعه کنید)|<|<|<|<| |*سفارش*|<|0|سفارش|2 - *(پیش فرض)* N بالا؛<br>3 - N. پایین| |*دستور ستون*|<|0|ستون|مقدار عددی ستون از ستون های پیکربندی شده.| |*تعداد میزبان*|<|0|تعداد|مقادیر معتبر از 1 تا 100 متغیر است.<br><br>پیش‌فرض: 10.| ##### Passive and active checks Zabbix agents can perform passive and active checks. In a [passive check](/manual/appendix/items/activepassive#passive_checks) the agent responds to a data request. Zabbix server (or proxy) asks for data, for example, CPU load, and Zabbix agent sends back the result. [Active checks](/manual/appendix/items/activepassive#active_checks) require more complex processing. The agent must first retrieve a list of items from Zabbix server for independent processing. Then it will periodically send new values to the server. Whether to perform passive or active checks is configured by selecting the respective monitoring [item type](/manual/config/items/itemtypes/zabbix_agent). Zabbix agent processes items of type 'Zabbix agent' or 'Zabbix agent (active)'. ##### چک های غیرفعال و فعال عوامل Zabbix می توانند بررسی های غیرفعال و فعال را انجام دهند. در یک [منفعل بررسی کنید](/دستی/ضمیمه/items/activepassive#passive_checks) عامل به درخواست داده پاسخ می دهد. سرور Zabbix (یا پروکسی) داده ها را برای به عنوان مثال، بارگذاری CPU، و عامل Zabbix نتیجه را پس می‌فرستد. [بررسی‌های فعال](/دستی/ضمیمه/آیتم/فعال منفعل#چک_فعال) نیاز به پردازش پیچیده تری دارد. عامل ابتدا باید لیستی از موارد از سرور Zabbix برای پردازش مستقل. سپس آن را انجام خواهد داد به صورت دوره ای مقادیر جدید را به سرور ارسال کنید. انجام بررسی های غیرفعال یا فعال با انتخاب پیکربندی می شود نظارت مربوطه [مورد type](/manual/config/items/itemtypes/zabbix_agent). نماینده Zabbix مواردی از نوع "عامل Zabbix" یا "عامل Zabbix (فعال)" را پردازش می کند. #### Passive proxy #### پراکسی غیرفعال ##### Payload data definition ###### Common data These parameters are present in all requests/responses: |Name|Type|Comments| |-----|--------|----------| |id |uint32|For requests - the incrementing identifier used to link requests with responses. Unique within a request direction (i.e. from agent to plugin or from plugin to agent).<br>For responses - ID of the corresponding request.| |type|uint32|The request type.| ##### تعریف داده های بار ###### داده های رایج این پارامترها در همه درخواست‌ها/پاسخ‌ها وجود دارند: |نام|نوع|نظر| |-----|--------|----------| |id |uint32|برای درخواست ها - شناسه افزایشی مورد استفاده برای پیوند درخواست ها با پاسخ ها. منحصر به فرد در جهت درخواست (یعنی از یک عامل به افزونه یا از یک افزونه به یک عامل).<br>برای پاسخ - شناسه درخواست مربوطه.| |type|uint32|نوع درخواست.| ### Payload data |Type|Size|Comments| |-----|-----|----------| |Byte| Defined by the *Size* field |JSON formatted data.| ### داده های بار |نوع|اندازه|نظرات| |-----|-----|----------| |بایت| توسط فیلد *Size* |داده های فرمت JSON.| تعریف شده است ## Plugins ## پلاگین ## Plugins ## پلاگین ### PostgreSQL Export and import must be performed in tmux/screen to ensure that the session isn't dropped. For installations with TimescaleDB, skip this section and proceed to [PostgreSQL + TimescaleDB](#postgresql-timescaledb). See also: [Important notes](#important-notes) #### Table upgrade * Rename tables using `history_pk_prepare.sql`: ``` {.bash} sudo -u zabbix psql zabbix < /usr/share/zabbix-sql-scripts/postgresql/history_pk_prepare.sql ``` #### Migration with stopped server * Export current history, import it to the temp table, then insert the data into new tables while ignoring duplicates: ``` {.sql} INSERT INTO history SELECT * FROM history_old ON CONFLICT (itemid,clock,ns) DO NOTHING; INSERT INTO history_uint SELECT * FROM history_uint_old ON CONFLICT (itemid,clock,ns) DO NOTHING; INSERT INTO history_str SELECT * FROM history_str_old ON CONFLICT (itemid,clock,ns) DO NOTHING; INSERT INTO history_log SELECT * FROM history_log_old ON CONFLICT (itemid,clock,ns) DO NOTHING; INSERT INTO history_text SELECT * FROM history_text_old ON CONFLICT (itemid,clock,ns) DO NOTHING; ``` See tips for improving INSERT performance: [PostgreSQL: Bulk Loading Huge Amounts of Data](https://www.cybertec-postgresql.com/en/postgresql-bulk-loading-huge-amounts-of-data), [Checkpoint Distance and Amount of WAL](https://www.cybertec-postgresql.com/en/checkpoint-distance-and-amount-of-wal). * Follow [post-migration instructions](#post-migration) to drop the old tables. ### PostgreSQL صادرات و واردات باید در tmux/screen انجام شود تا اطمینان حاصل شود که جلسه حذف نشده است. برای نصب با TimescaleDB، از این بخش رد شده و به [PostgreSQL + TimescaleDB] (#postgresql-timescaledb) بروید. همچنین ببینید: [یادداشت های مهم] (#important-notes) #### ارتقای جدول * تغییر نام جداول با استفاده از `history_pk_prepare.sql`: ``` {.bash} sudo -u zabbix psql zabbix < /usr/share/zabbix-sql-scripts/postgresql/history_pk_prepare.sql ``` #### مهاجرت با سرور متوقف شده * تاریخچه فعلی را صادر کنید، آن را به جدول موقت وارد کنید، سپس داده ها را در جداول جدید وارد کنید و در عین حال موارد تکراری را نادیده بگیرید: ``` {.sql} INSERT INTO history SELECT * FROM history_old ON CONFLICT (itemid,clock,ns) هیچ کاری نکنید. INSERT INTO history_uint SELECT * FROM history_uint_old ON CONFLICT (itemid,clock,ns) هیچ کاری نکنید. INSERT INTO history_str SELECT * FROM history_str_old ON CONFLICT (itemid,clock,ns) هیچ کاری نکنید. INSERT INTO history_log SELECT * FROM history_log_old ON CONFLICT (itemid,clock,ns) هیچ کاری نکنید. INSERT INTO history_text SELECT * FROM history_text_old ON CONFLICT (itemid,clock,ns) هیچ کاری نکنید. ``` نکاتی را برای بهبود عملکرد INSERT ببینید: [PostgreSQL: Bulk Loading Huge Amounts of Data](https://www.cybertec-postgresql.com/en/postgresql-bulk-loading-huge-amounts-of-data)، [Checkpoint Distance and Amount of WAL](https://www.cybertec-postgresql.com/en/checkpoint-distance-and-amount-of-wal). * [دستورالعمل‌های پس از مهاجرت] (#post-migration) را برای حذف جداول قدیمی دنبال کنید. ### Post-migration For all databases, once the migration is completed, do the following: * Verify that everything works as expected. * Drop old tables: ``` {.sql} DROP TABLE history_old; DROP TABLE history_uint_old; DROP TABLE history_str_old; DROP TABLE history_log_old; DROP TABLE history_text_old; ``` ### پس از مهاجرت برای همه پایگاه‌های داده، پس از تکمیل مهاجرت، موارد زیر را انجام دهید: * بررسی کنید که همه چیز همانطور که انتظار می رود کار می کند. * میزهای قدیمی را رها کنید: ``` {.sql} DROP TABLE history_old; DROP TABLE history_uint_old; DROP TABLE history_str_old; DROP TABLE history_log_old; DROP TABLE history_text_old; ``` ##### Preparation Zabbix agent is distributed as a zip archive. After you download the archive you need to unpack it. Choose any folder to store Zabbix agent and the configuration file, e. g. C:\zabbix Copy bin\\zabbix\_agentd.exe and conf\\zabbix\_agentd.conf files to c:\\zabbix. Edit the c:\\zabbix\\zabbix\_agentd.conf file to your needs, making sure to specify a correct "Hostname" parameter. ##### آماده سازی عامل Zabbix به عنوان یک آرشیو فشرده توزیع می شود. بعد از دانلود بایگانی باید آن را باز کنید. هر پوشه ای را برای ذخیره عامل Zabbix انتخاب کنید و فایل پیکربندی، e. g. ج:\zabbix فایل های bin\\zabbix\_agentd.exe و conf\\zabbix\_agentd.conf را در ج:\\zabbix. فایل c:\\zabbix\\zabbix\_agentd.conf را مطابق با نیاز خود ویرایش کنید، مطمئن شوید برای تعیین یک پارامتر صحیح "Hostname". ##### Preparing frontend Make sure that Zabbix server address:port is **not defined** in the frontend configuration (found in `conf/zabbix.conf.php` of the frontend files directory). ![](../../../../assets/en/manual/config/frontend_conf_server_port.png){width="600"} Zabbix frontend will autodetect the active node by reading settings from the nodes table in Zabbix database. Node address of the active node will be used as the Zabbix server address. ##### آماده سازی فرانت اند مطمئن شوید که آدرس سرور Zabbix:پورت **در قسمت تعریف نشده** باشد پیکربندی frontend (در «conf/zabbix.conf.php» از frontend یافت می شود دایرکتوری فایل ها). ![](../../../../assets/en/manual/config/frontend_conf_server_port.png){width="600"} Zabbix frontend با خواندن تنظیمات، گره فعال را به صورت خودکار شناسایی می کند از جدول گره ها در پایگاه داده Zabbix. آدرس گره گره فعال به عنوان آدرس سرور Zabbix استفاده خواهد شد. ### Pre-requisites Install MySQL database from the [official repository](https://dev.mysql.com/downloads/repo/yum/). See [MySQL documentation](https://dev.mysql.com/doc/mysql-yum-repo-quick-guide/en/) for details on how to use MySQL repo. MySQL server is ready to accept secure connections using a self-signed certificate. To see, which users are using an encrypted connection, run the following query (Performance Schema should be turned ON): mysql> SELECT sbt.variable_value AS tls_version, t2.variable_value AS cipher, processlist_user AS user, processlist_host AS host FROM performance_schema.status_by_thread AS sbt JOIN performance_schema.threads AS t ON t.thread_id = sbt.thread_id JOIN performance_schema.status_by_thread AS t2 ON t2.thread_id = t.thread_id WHERE sbt.variable_name = 'Ssl_version' and t2.variable_name = 'Ssl_cipher' ORDER BY tls_version; ### پیش نیازها پایگاه داده MySQL را از [official مخزن] (https://dev.mysql.com/downloads/repo/yum/). [MySQL مستندات](https://dev.mysql.com/doc/mysql-yum-repo-quick-guide/en/) برای جزئیات در مورد نحوه استفاده از MySQL repo. سرور MySQL آماده پذیرش اتصالات امن با استفاده از خود امضا شده است گواهی برای مشاهده اینکه کدام کاربران از اتصال رمزگذاری شده استفاده می کنند، موارد زیر را اجرا کنید پرس و جو (شما عملکرد باید روشن شود): mysql> SELECT sbt.variable_value AS tls_version، t2.variable_value AS cipher، processlist_user AS کاربر، processlist_host AS میزبان FROM performance_schema.status_by_thread AS sbt به performance_schema.threads AS t در t.thread_id = sbt.thread_id بپیوندید به performance_schema.status_by_thread AS t2 در t2.thread_id = t.thread_id بپیوندید WHERE sbt.variable_name = 'Ssl_version' و t2.variable_name = 'Ssl_cipher' سفارش توسط tls_version; #### Problem events A problem event is created: - when a trigger expression evaluates to TRUE if the trigger is in OK state; - each time a trigger expression evaluates to TRUE if multiple problem event generation is enabled for the trigger. #### رویدادهای مشکل یک رویداد مشکل ایجاد می شود: - هنگامی که یک عبارت ماشه به TRUE ارزیابی می شود اگر ماشه در حالت OK باشد حالت؛ - هر بار که یک عبارت ماشه در صورت وجود چندین مشکل به TRUE ارزیابی می شود تولید رویداد برای ماشه فعال است. # problem.get دریافت حذف قانون جست و جو ##### Problem update window If a problem arises for a trigger with the *Manual close* flag, you can open the [problem update](/manual/acknowledges#updating_problems) popup window of that problem and close the problem manually. To close the problem, check the *Close problem* option in the form and click on *Update*. ![](../../../../assets/en/manual/config/close_problem1.png) All mandatory input fields are marked with a red asterisk. The request is processed by Zabbix server. Normally it will take a few seconds to close the problem. During that process *CLOSING* is displayed in *Monitoring* → *Problems* as the status of the problem. ##### پنجره به روز رسانی مشکل اگر برای یک ماشه با پرچم *دستی بسته* مشکلی پیش آمد، می توانید باز کردن پنجره [به روز رسانی مشکل](/manual/acknowledges#updating_problems) پنجره آن مشکل را ببندید و مشکل را به صورت دستی ببندید. برای بستن مشکل، گزینه *بستن مشکل* را در فرم و تیک بزنید روی *به روز رسانی* کلیک کنید. ![](../../../../assets/en/manual/config/close_problem1.png) تمام فیلدهای ورودی اجباری با یک ستاره قرمز مشخص شده اند. درخواست توسط سرور Zabbix پردازش می شود. به طور معمول چند مورد طول می کشد چند ثانیه برای بستن مشکل در طی آن فرآیند *CLOSING* نمایش داده می شود در *مانیتورینگ* → *مشکلات* به عنوان وضعیت مشکل. ##### Process data |Item key|<|<|<| |--|--|------|------| |Description|Return value|Parameters|Comments| |**proc.cpu.util**\[<name>,<user>,<type>,<cmdline>,<mode>,<zone>\]|<|<|<| |Process CPU utilization percentage.|Float|**name** - process name (default is *all processes*)<br>**user** - user name (default is *all users*)<br>**type** - CPU utilization type:<br>*total* (default), *user*, *system*<br>**cmdline** - filter by command line (it is a regular [expression](/manual/regular_expressions#overview))<br>**mode** - data gathering mode: *avg1* (default), *avg5*, *avg15*<br>**zone** - target zone: *current* (default), *all*. This parameter is supported on Solaris only.|Examples:<br>=> proc.cpu.util\[,root\] → CPU utilization of all processes running under the "root" user<br>=> proc.cpu.util\[zabbix\_server,zabbix\] → CPU utilization of all zabbix\_server processes running under the zabbix user<br><br>The returned value is based on single CPU core utilization percentage. For example CPU utilization of a process fully using two cores is 200%.<br><br>The process CPU utilization data is gathered by a collector which supports the maximum of 1024 unique (by name, user and command line) queries. Queries not accessed during the last 24 hours are removed from the collector.<br><br>*Note* that when setting the `zone` parameter to *current* (or default) in case the agent has been compiled on a Solaris without zone support, but running on a newer Solaris where zones are supported, then the agent will return NOTSUPPORTED (the agent cannot limit results to only the current zone). However, *all* is supported in this case.<br><br>This key is supported since Zabbix 3.0.0 and is available on several platforms (see [Items supported by platform](/manual/appendix/items/supported_by_platform)).| |**proc.mem**\[<name>,<user>,<mode>,<cmdline>,<memtype>\]|<|<|<| |Memory used by process in bytes.|Integer - with `mode` as *max*, *min*, *sum*<br><br>Float - with `mode` as *avg*|**name** - process name (default is *all processes*)<br>**user** - user name (default is *all users*)<br>**mode** - possible values:<br>*avg*, *max*, *min*, *sum* (default)<br>**cmdline** - filter by command line (it is a regular [expression](/manual/regular_expressions#overview))<br>**memtype** - [type of memory](/manual/appendix/items/proc_mem_notes) used by process|Examples:<br>=> proc.mem\[,root\] → memory used by all processes running under the "root" user<br>=> proc.mem\[zabbix\_server,zabbix\] → memory used by all zabbix\_server processes running under the zabbix user<br>=> proc.mem\[,oracle,max,oracleZABBIX\] → memory used by the most memory-hungry process running under oracle having oracleZABBIX in its command line<br><br>*Note*: When several processes use shared memory, the sum of memory used by processes may result in large, unrealistic values.<br><br>See [notes](/manual/appendix/items/proc_mem_num_notes) on selecting processes with `name` and `cmdline` parameters (Linux-specific).<br><br>When this item is invoked from the command line and contains a command line parameter (e.g. using the agent test mode: `zabbix_agentd -t proc.mem[,,,apache2]`), one extra process will be counted, as the agent will count itself.<br><br>The `memtype` parameter is supported on several [platforms](/manual/appendix/items/supported_by_platform) since Zabbix 3.0.0.| |**proc.num**\[<name>,<user>,<state>,<cmdline>,<zone>\]|<|<|<| |The number of processes.|Integer|**name** - process name (default is *all processes*)<br>**user** - user name (default is *all users*)<br>**state** (*disk* and *trace* options since version 3.4.0) - possible values:<br>*all* (default),<br>*disk* - uninterruptible sleep,<br>*run* - running,<br>*sleep* - interruptible sleep,<br>*trace* - stopped,<br>*zomb* - zombie<br>**cmdline** - filter by command line (it is a regular [expression](/manual/regular_expressions#overview))<br>**zone** - target zone: *current* (default), *all*. This parameter is supported on Solaris only.|Examples:<br>=> proc.num\[,mysql\] → number of processes running under the mysql user<br>=> proc.num\[apache2,www-data\] → number of apache2 processes running under the www-data user<br>=> proc.num\[,oracle,sleep,oracleZABBIX\] → number of processes in sleep state running under oracle having oracleZABBIX in its command line<br><br>See [notes](/manual/appendix/items/proc_mem_num_notes) on selecting processes with `name` and `cmdline` parameters (Linux-specific).<br><br>On Windows, only the `name` and `user` parameters are supported.<br><br>When this item is invoked from the command line and contains a command line parameter (e.g. using the agent test mode: `zabbix_agentd -t proc.num[,,,apache2]`), one extra process will be counted, as the agent will count itself.<br><br>*Note* that when setting the `zone` parameter to *current* (or default) in case the agent has been compiled on a Solaris without zone support, but running on a newer Solaris where zones are supported, then the agent will return NOTSUPPORTED (the agent cannot limit results to only the current zone). However, *all* is supported in this case.| ##### پردازش داده ها |کلید مورد|<|<|<| |--|--|------|------| |توضیحات|مقدار بازگشتی|پارامترها|نظرات| |**proc.cpu.util**\[<name>,<user>,<type>,<cmdline>,<mode>,<zone>\]|<|<|<| |درصد استفاده از CPU فرآیند.|Float|**نام** - نام فرآیند (پیش‌فرض *همه فرآیندها*)<br>**کاربر** - نام کاربری (پیش‌فرض *همه کاربران*) است<br>**نوع ** - نوع استفاده از CPU:<br>*total* (پیش‌فرض)، *user*، *system*<br>**cmdline** - فیلتر بر اساس خط فرمان (این یک [عبارت] معمولی است (/manual/regular_expressions #نمای کلی))<br>**حالت** - حالت جمع آوری داده: *avg1* (پیش‌فرض)، *avg5*، *avg15*<br>**منطقه** - منطقه هدف: *جریان* (پیش‌فرض)، *همه*. این پارامتر فقط در Solaris پشتیبانی می‌شود.|مثال:<br>=> proc.cpu.util\[,root\] → استفاده از CPU از تمام فرآیندهایی که تحت کاربر "root" اجرا می‌شوند<br>=> proc.cpu.util \[zabbix\_server,zabbix\] → استفاده از CPU از تمام فرآیندهای zabbix\_server که تحت کاربر zabbix در حال اجرا هستند<br><br>مقدار برگشتی بر اساس درصد استفاده از هسته واحد CPU است. به عنوان مثال، استفاده از CPU از یک فرآیند به طور کامل با استفاده از دو هسته 200٪ است.<br><br>داده‌های استفاده از CPU فرآیند توسط یک جمع‌آوری جمع‌آوری می‌شود که حداکثر 1024 پرس‌وجو منحصر به فرد (بر اساس نام، کاربر و خط فرمان) را پشتیبانی می‌کند. جستارهایی که در 24 ساعت گذشته به آنها دسترسی پیدا نکرده اند از جمع کننده حذف می شوند.<br><br>*توجه داشته باشید که هنگام تنظیم پارامتر "zone" بر روی *current* (یا پیش فرض) در صورتی که عامل در سولاریس بدون کامپایل شده باشد. پشتیبانی از ناحیه، اما در یک سولاریس جدیدتر که مناطق پشتیبانی می‌شوند، اجرا می‌شود، سپس عامل NOTSUPPORTED برمی‌گردد (عامل نمی‌تواند نتایج را فقط به منطقه فعلی محدود کند). با این حال، *all* در این مورد پشتیبانی می‌شود.<br><br>این کلید از زمان Zabbix 3.0.0 پشتیبانی می‌شود و در چندین پلتفرم در دسترس است (به [موارد پشتیبانی شده توسط پلتفرم] مراجعه کنید (/manual/appendix/items/supported_by_platform) ).| |**proc.mem**\[<name>,<user>,<mode>,<cmdline>,<memtype>\]|<|<|<| |حافظه استفاده شده توسط پردازش در بایت.|عدد صحیح - با "حالت" به عنوان *max*، *min*، *sum*<br><br>Float - با "mode" به عنوان *avg*|**name** - نام فرآیند (پیش‌فرض *همه فرآیندها* است)<br>**user** - نام کاربری (پیش‌فرض *همه کاربران*)<br>**حالت** - مقادیر ممکن:<br>*avg*, *max *، *دقیقه*، *جمع* (پیش‌فرض)<br>**cmdline** - فیلتر بر اساس خط فرمان (این یک [عبارت] معمولی است(/manual/regular_expressions#overview))<br>**memtype** - [نوع حافظه](/manual/appendix/items/proc_mem_notes) مورد استفاده فرآیند|مثال‌ها:<br>=> proc.mem\[,root\] → حافظه مورد استفاده همه پردازش‌هایی که تحت کاربر "root" اجرا می‌شوند< br>=> proc.mem\[zabbix\_server,zabbix\] → حافظه مورد استفاده همه پردازشهای zabbix\_server که تحت کاربر zabbix اجرا می شوند<br>=> proc.mem\[,oracle,max,oracleZABBIX\] → حافظه مورد استفاده توسط پرحافظه‌ترین فرآیندی که تحت اوراکل اجرا می‌شود و دارای oracleZABBIX در خط فرمان آن است<br><br>*نکته*: وقتی چندین فرآیند از حافظه مشترک استفاده می‌کنند، مجموع حافظه استفاده شده توسط فرآیندها ممکن است به مقادیر بزرگ و غیر واقعی منجر شود.< br><br>به [notes](/manual/appendix/items/proc_mem_num_notes) برای انتخاب فرآیندهایی با پارامترهای «name» و «cmdline» (مخصوص لینوکس) مراجعه کنید.<br><br>وقتی این مورد از خط فرمان و شامل یک پارامتر خط فرمان (به عنوان مثال با استفاده از حالت آزمایش عامل: `zabbix_agentd -t proc.mem[,,,apache2]`، یک فرآیند اضافی شمارش می‌شود، زیرا عامل خودش را محاسبه می‌کند.<br><br>پارامتر «memtype» در چندین [پلتفرم](/دستی/ضمیمه/item/supported_by_platform) از Zabbix 3.0.0.| |**proc.num**\[<name>,<user>,<state>,<cmdline>,<zone>\]|<|<|<| |تعداد فرآیندها.|عدد صحیح|**نام** - نام فرآیند (پیش‌فرض *همه فرآیندها*) <br>**کاربر** - نام کاربری (پیش‌فرض *همه کاربران* است)<br>**وضعیت ** (گزینه‌های *disk* و *trace* از نسخه 3.4.0) - مقادیر ممکن:<br>*all* (پیش‌فرض)،<br>*disk* - خواب بدون وقفه،<br>*run* - در حال اجرا، <br>*sleep* - خواب قابل وقفه،<br>*trace* - متوقف شده،<br>*zomb* - zombie<br>**cmdline** - فیلتر بر اساس خط فرمان (این یک [عبارت] معمولی است)(/ manual/regular_expressions#overview))<br>**zone** - منطقه هدف: *current* (پیش فرض)، *all*. این پارامتر فقط در Solaris پشتیبانی می‌شود.|مثال:<br>=> proc.num\[,mysql\] → تعداد فرآیندهایی که تحت کاربر mysql اجرا می‌شوند<br>=> proc.num\[apache2,www-data\ ] ← تعداد فرآیندهای apache2 که تحت کاربر www-data اجرا می‌شوند<br>=> proc.num\[,oracle,sleep,oracleZABBIX\] → تعداد پردازش‌هایی که در حالت خواب تحت اوراکل اجرا می‌شوند دارای oracleZABBIX در خط فرمان آن هستند<br> <br>به [notes](/manual/appendix/items/proc_mem_num_notes) برای انتخاب فرآیندهایی با پارامترهای «name» و «cmdline» (مخصوص لینوکس) مراجعه کنید.<br><br>در ویندوز، فقط «نام» و پارامترهای «کاربر» پشتیبانی می‌شوند.<br><br>وقتی این مورد از خط فرمان فراخوانی می‌شود و حاوی یک پارامتر خط فرمان است (مثلاً با استفاده از حالت آزمایش عامل: «zabbix_agentd -t proc.num[,,,apache2]». )، یک فرآیند اضافی شمارش می‌شود، زیرا عامل خودش را محاسبه می‌کند.<br><br>*توجه داشته باشید* که هنگام تنظیم پارامتر "zone" روی *current* (یا پیش‌فرض) در صورتی که عامل در یک کامپایل شده باشد. سولاریس بدون پشتیبانی از ناحیه، اما روی یک سولاریس جدیدتر اجرا می‌شود که در آن زون‌ها پشتیبانی می‌شوند، سپس عامل NOTSUPPORTED برمی‌گردد (عامل نمی‌تواند نتایج را فقط به منطقه فعلی محدود کند). با این حال، *all* در این مورد پشتیبانی می شود.| #### Process user Zabbix agent on UNIX is designed to run as a non-root user. It will run as whatever non-root user it is started as. So you can run agent as any non-root user without any issues. If you will try to run it as 'root', it will switch to a hardcoded 'zabbix' user, which must be present on your system. You can only run agent as 'root' if you modify the 'AllowRoot' parameter in the agent configuration file accordingly. #### کاربر پردازش عامل Zabbix در یونیکس برای اجرا به عنوان یک کاربر غیر ریشه طراحی شده است. اجرا خواهد شد به عنوان هر کاربر غیر ریشه ای به عنوان شروع می شود. بنابراین شما می توانید عامل را به عنوان هر عاملی اجرا کنید کاربر غیر روت بدون هیچ مشکلی. اگر سعی کنید آن را به عنوان "ریشه" اجرا کنید، به یک کد سخت تبدیل می شود کاربر 'zabbix'، که باید در سیستم شما وجود داشته باشد. شما فقط می توانید بدوید اگر پارامتر "AllowRoot" را در عامل تغییر دهید، عامل به عنوان "ریشه" است فایل پیکربندی بر این اساس ##### Process user Zabbix proxy is designed to run as a non-root user. It will run as whatever non-root user it is started as. So you can run proxy as any non-root user without any issues. If you will try to run it as 'root', it will switch to a hardcoded 'zabbix' user, which must be present on your system. You can only run proxy as 'root' if you modify the 'AllowRoot' parameter in the proxy configuration file accordingly. #### کاربر پردازش عامل Zabbix در یونیکس برای اجرا به عنوان یک کاربر غیر ریشه طراحی شده است. اجرا خواهد شد به عنوان هر کاربر غیر ریشه ای به عنوان شروع می شود. بنابراین شما می توانید عامل را به عنوان هر عاملی اجرا کنید کاربر غیر روت بدون هیچ مشکلی. اگر سعی کنید آن را به عنوان "ریشه" اجرا کنید، به یک کد سخت تبدیل می شود کاربر 'zabbix'، که باید در سیستم شما وجود داشته باشد. شما فقط می توانید بدوید اگر پارامتر "AllowRoot" را در عامل تغییر دهید، عامل به عنوان "ریشه" است فایل پیکربندی بر این اساس ##### Process user Zabbix server is designed to run as a non-root user. It will run as whatever non-root user it is started as. So you can run server as any non-root user without any issues. If you will try to run it as 'root', it will switch to a hardcoded 'zabbix' user, which must be [present](/manual/installation/install) on your system. You can only run server as 'root' if you modify the 'AllowRoot' parameter in the server configuration file accordingly. If Zabbix server and [agent](agent) are run on the same machine it is recommended to use a different user for running the server than for running the agent. Otherwise, if both are run as the same user, the agent can access the server configuration file and any Admin level user in Zabbix can quite easily retrieve, for example, the database password. ##### کاربر پردازش سرور Zabbix برای اجرا به عنوان یک کاربر غیر ریشه طراحی شده است. به صورت اجرا خواهد شد هر کاربر غیر ریشه ای به عنوان شروع می شود. بنابراین شما می توانید سرور را به عنوان هر سرور اجرا کنید کاربر غیر روت بدون هیچ مشکلی اگر سعی کنید آن را به عنوان "ریشه" اجرا کنید، به یک کد سخت تبدیل می شود کاربر 'zabbix'، که باید [present](/manual/installation/install) در سیستم شما فقط در صورتی می توانید سرور را به عنوان "ریشه" اجرا کنید که آن را تغییر دهید پارامتر "AllowRoot" در فایل پیکربندی سرور بر این اساس. اگر سرور Zabbix و [agent](agent) روی یک دستگاه اجرا شوند، همان‌طور است توصیه می شود برای اجرای سرور از یک کاربر متفاوت از کاربر استفاده کنید عامل را اجرا می کند در غیر این صورت، اگر هر دو به عنوان یک کاربر اجرا شوند، عامل می تواند به فایل پیکربندی سرور و هر کاربر سطح مدیریت دسترسی داشته باشد در Zabbix می تواند به راحتی، به عنوان مثال، رمز عبور پایگاه داده را بازیابی کند. #### Property labels Some of the objects properties are marked with short labels to describe their behavior. The following labels are used: - *readonly* - the value of the property is set automatically and cannot be defined or changed by the client; - *constant* - the value of the property can be set when creating an object, but cannot be changed after. #### برچسب های اموال برخی از ویژگی های اشیا با برچسب های کوتاه برای توصیف مشخص شده اند رفتار آنها. از برچسب های زیر استفاده می شود: - *readonly* - مقدار ویژگی به صورت خودکار تنظیم می شود و توسط مشتری قابل تعریف یا تغییر نیست. - *constant* - مقدار ویژگی را می توان هنگام ایجاد یک شیء تنظیم کرد اما پس از آن قابل تغییر نیست. | Property | [Type](/manual/api/reference_commentary#data_types) | Description | |--------------------------------|-----------------------------------------------------|---------------------------------------------------------------------------------------| | **name**<br>(required) | string | Name of the excluded downtime. | | **period\_from**<br>(required) | integer | Starting time of the excluded downtime (inclusive).<br><br>Possible values: timestamp. | | **period\_to**<br>(required) | integer | Ending time of the excluded downtime (exclusive).<br><br>Possible values: timestamp. | | اموال | [Type](/manual/api/reference_commentary#data_types) | توضیحات | |------------------------------------------------ --------------------------------------------------- ------------------------------------------------ ------------------------------------------------ ---------------------| | **دوره\_از**<br>(الزامی) | عدد صحیح | زمان شروع دوره زمانی هفتگی مکرر (شامل).<br><br>مقادیر ممکن: تعداد ثانیه (شمارش از یکشنبه). | | **دوره\_تا**<br>(الزامی) | عدد صحیح | زمان پایان دوره زمانی هفتگی مکرر (انحصاری).<br><br>مقادیر ممکن: تعداد ثانیه ها (از یکشنبه شمارش می شود). | | Property | [Type](/manual/api/reference_commentary#data_types) | Description | |--------------------------------|-----------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------| | **period\_from**<br>(required) | integer | Starting time of the recurrent weekly period of time (inclusive).<br><br>Possible values: number of seconds (counting from Sunday). | | **period\_to**<br>(required) | integer | Ending time of the recurrent weekly period of time (exclusive).<br><br>Possible values: number of seconds (counting from Sunday). | | اموال | [Type](/manual/api/reference_commentary#data_types) | توضیحات | |------------------------------------------------ --------------------------------------------------- ------------------------------------------------ ------------------------------------------------ ---------------------| | **دوره\_از**<br>(الزامی) | عدد صحیح | زمان شروع دوره زمانی هفتگی مکرر (شامل).<br><br>مقادیر ممکن: تعداد ثانیه (شمارش از یکشنبه). | | **دوره\_تا**<br>(الزامی) | عدد صحیح | زمان پایان دوره زمانی هفتگی مکرر (انحصاری).<br><br>مقادیر ممکن: تعداد ثانیه ها (از یکشنبه شمارش می شود). | #### Proxies In a [proxy](/manual/distributed_monitoring/proxies#configuration) configuration, user macros can be used in the following field: |Location|<|Multiple macros/mix with text^[1](supported_by_location_user#footnotes)^| |-|------------------------------|----------| |Interface port (for passive proxy)|<|no| #### پروکسی ها در یک [پروکسی](/دستی/distributed_monitoring/proxies#configuration) پیکربندی، ماکروهای کاربر را می توان در فیلد زیر استفاده کرد: |موقعیت|<|چند ماکرو/میکس با متن^[1](پشتیبانی_شده توسط_location_user#footnotes)^| |-|-----------------------------|----------| |پورت رابط (برای پراکسی غیرفعال)|<|نه| ##### Proxy config request The `proxy config` request is sent by proxy to obtain proxy configuration data. This request is sent every `ConfigFrequency` (proxy configuration parameter) seconds. |name|<|<|<|value type|description| |-|-|-|----------|----------|----------------------------------------| |proxy→server:|<|<|<|<|<| |**request**|<|<|<|*string*|'proxy config'| |**host**|<|<|<|*string*|Proxy name.| |**version**|<|<|<|*string*|Proxy version (<major>.<minor>.<build>).| |server→proxy:|<|<|<|<|<| |**request**|<|<|<|*string*|'proxy config'| |**<table>**|<|<|<|*object*|One or more objects with <table> data.| | |**fields**|<|<|*array*|Array of field names.| |^| |\-|<|*string*|Field name.| |^|**data**|<|<|*array*|Array of rows.| |^| |\-|<|*array*|Array of columns.| |^|^| |\-|*string*,*number*|Column value with type depending on the column type in database schema.| |proxy→server:|<|<|<|<|<| |**response**|<|<|<|*string*|Request success information ('success' or 'failed').| Example: proxy→server: ``` {.javascript} { "request": "proxy config", "host": "Proxy #12", "version":"5.4.0" } ``` server→proxy: ``` {.javascript} { "globalmacro":{ "fields":[ "globalmacroid", "macro", "value" ], "data":[ [ 2, "{$SNMP_COMMUNITY}", "public" ] ] }, "hosts":{ "fields":[ "hostid", "host", "status", "ipmi_authtype", "ipmi_privilege", "ipmi_username", "ipmi_password", "name", "tls_connect", "tls_accept", "tls_issuer", "tls_subject", "tls_psk_identity", "tls_psk" ], "data":[ [ 10001, "Linux", 3, -1, 2, "", "", "Linux", 1, 1, "", "", "", "" ], [ 10050, "Zabbix Agent", 3, -1, 2, "", "", "Zabbix Agent", 1, 1, "", "", "", "" ], [ 10105, "Logger", 0, -1, 2, "", "", "Logger", 1, 1, "", "", "", "" ] ] }, "interface":{ "fields":[ "interfaceid", "hostid", "main", "type", "useip", "ip", "dns", "port", "bulk" ], "data":[ [ 2, 10105, 1, 1, 1, "127.0.0.1", "", "10050", 1 ] ] }, ... } ``` proxy→server: ``` {.javascript} { "response": "success" } ``` ##### درخواست پیکربندی پروکسی درخواست "پیکربندی پروکسی" توسط پراکسی برای دریافت پروکسی ارسال می شود داده های پیکربندی این درخواست در هر «ConfigFrequency» (پراکسی پارامتر پیکربندی) ثانیه. |نام|<|<|<|نوع مقدار|توضیح| |-|-|-|----------|----------|-------------------- -------------------| |پروکسی→سرور:|<|<|<|<|<| |**درخواست**|<|<|<|*رشته*|'پیکربندی پروکسی'| |**میزبان**|<|<|<|*string*|نام پروکسی.| |**نسخه**|<|<|<|*string*|نسخه پروکسی (<مهد>.<مینور>.<ساخت>).| |سرور→پراکسی:|<|<|<|<|<| |**درخواست**|<|<|<|*رشته*|'پیکربندی پروکسی'| |**<table>**|<|<|<|*object*|یک یا چند شی با داده <table>.| | |**فیلدها**|<|<|*آرایه*|آرایه نام فیلدها.| |^| |\-|<|*string*|نام فیلد.| |^|**داده**|<|<|*آرایه*|آرایه سطرها.| |^| |\-|<|*آرایه*|آرایه ستون ها.| |^|^| |\-|*string*,*number*|مقدار ستون با نوع بسته به نوع ستون در طرح پایگاه داده.| |پروکسی→سرور:|<|<|<|<|<| |**پاسخ**|<|<|<|*string*|درخواست اطلاعات موفقیت ('موفقیت' یا 'شکست').| مثال: پروکسی← سرور: ``` {.javascript} { "درخواست": "پیکربندی پروکسی"، "میزبان": "پراکسی شماره 12"، "نسخه": "5.4.0" } ``` سرور → پروکسی: ``` {.javascript} { "globalmacro":{ "زمینه های":[ "گلوبال ماکروید"، "کلان"، "ارزش" ]، "داده ها":[ [ 2، «{$SNMP_COMMUNITY}»، "عمومی" ] ] }، "میزبان":{ "زمینه های":[ "میزبان"، "میزبان"، "وضعیت"، "ipmi_authtype"، "ipmi_privilege"، "ipmi_username"، "ipmi_password"، "نام"، "tls_connect"، "tls_accept"، "tls_issuer"، "tls_subject"، "tls_psk_identity"، "tls_psk" ]، "داده ها":[ [ 10001، "لینوکس"، 3، -1، 2، ""، ""، "لینوکس"، 1، 1، ""، ""، ""، "" ]، [ 10050، "عامل Zabbix", 3، -1، 2، ""، ""، "عامل Zabbix", 1، 1، ""، ""، ""، "" ]، [ 10105، "متمرکز ساز"، 0، -1، 2، ""، ""، "متمرکز ساز"، 1، 1، ""، ""، ""، "" ] ] }، "رابط":{ "زمینه های":[ "رابط"، "میزبان"، "اصلی"، "نوع"، "useip"، "IP"، "dns"، "بندر"، "فله" ]، "داده ها":[ [ 2، 10105، 1، 1، 1، "127.0.0.1"، ""، "10050"، 1 ] ] }، ... } ``` پروکسی← سرور: ``` {.javascript} { "پاسخ": "موفقیت" } ``` ##### Proxy config request The `proxy config` request is sent by server to provide proxy configuration data. This request is sent every `ProxyConfigFrequency` (server configuration parameter) seconds. |name|<|<|<|value type|description| |-|-|-|----------|----------|----------------------------------------| |server→proxy:|<|<|<|<|<| |**request**|<|<|<|*string*|'proxy config'| |**<table>**|<|<|<|*object*|One or more objects with <table> data.| | |**fields**|<|<|*array*|Array of field names.| |^| |\-|<|*string*|Field name.| |^|**data**|<|<|*array*|Array of rows.| |^| |\-|<|*array*|Array of columns.| |^|^| |\-|*string*,*number*|Column value with type depending on the column type in database schema.| |proxy→server:|<|<|<|<|<| |**response**|<|<|<|*string*|Request success information ('success' or 'failed').| |**version**|<|<|<|*string*|Proxy version (<major>.<minor>.<build>).| Example: server→proxy: ``` {.javascript} { "request": "proxy config", "globalmacro":{ "fields":[ "globalmacroid", "macro", "value" ], "data":[ [ 2, "{$SNMP_COMMUNITY}", "public" ] ] }, "hosts":{ "fields":[ "hostid", "host", "status", "ipmi_authtype", "ipmi_privilege", "ipmi_username", "ipmi_password", "name", "tls_connect", "tls_accept", "tls_issuer", "tls_subject", "tls_psk_identity", "tls_psk" ], "data":[ [ 10001, "Linux", 3, -1, 2, "", "", "Linux", 1, 1, "", "", "", "" ], [ 10050, "Zabbix Agent", 3, -1, 2, "", "", "Zabbix Agent", 1, 1, "", "", "", "" ], [ 10105, "Logger", 0, -1, 2, "", "", "Logger", 1, 1, "", "", "", "" ] ] }, "interface":{ "fields":[ "interfaceid", "hostid", "main", "type", "useip", "ip", "dns", "port", "bulk" ], "data":[ [ 2, 10105, 1, 1, 1, "127.0.0.1", "", "10050", 1 ] ] }, ... } ``` proxy→server: ``` {.javascript} { "response": "success", "version": "6.0.0" } ``` ##### درخواست پیکربندی پروکسی درخواست "پیکربندی پروکسی" توسط سرور برای ارائه پروکسی ارسال می شود داده های پیکربندی این درخواست در هر «ProxyConfigFrequency» ارسال می‌شود (پارامتر پیکربندی سرور) ثانیه. |نام|<|<|<|نوع مقدار|توضیح| |-|-|-|----------|----------|-------------------- -------------------| |سرور→پراکسی:|<|<|<|<|<| |**درخواست**|<|<|<|*رشته*|'پیکربندی پروکسی'| |**<table>**|<|<|<|*object*|یک یا چند شی با داده <table>.| | |**فیلدها**|<|<|*آرایه*|آرایه نام فیلدها.| |^| |\-|<|*string*|نام فیلد.| |^|**داده**|<|<|*آرایه*|آرایه سطرها.| |^| |\-|<|*آرایه*|آرایه ستون ها.| |^|^| |\-|*string*,*number*|مقدار ستون با نوع بسته به نوع ستون در طرح پایگاه داده.| |پروکسی→سرور:|<|<|<|<|<| |**پاسخ**|<|<|<|*string*|درخواست اطلاعات موفقیت ('موفقیت' یا 'شکست').| |**نسخه**|<|<|<|*string*|نسخه پروکسی (<مهد>.<مینور>.<ساخت>).| مثال: سرور → پروکسی: ``` {.javascript} { "درخواست": "پیکربندی پروکسی"، "globalmacro":{ "زمینه های":[ "گلوبال ماکروید"، "کلان"، "ارزش" ]، "داده ها":[ [ 2، «{$SNMP_COMMUNITY}»، "عمومی" ] ] }، "میزبان":{ "زمینه های":[ "میزبان"، "میزبان"، "وضعیت"، "ipmi_authtype"، "ipmi_privilege"، "ipmi_username"، "ipmi_password"، "نام"، "tls_connect"، "tls_accept"، "tls_issuer"، "tls_subject"، "tls_psk_identity"، "tls_psk" ]، "داده ها":[ [ 10001، "لینوکس"، 3، -1، 2، ""، ""، "لینوکس"، 1، 1، ""، ""، ""، "" ]، [ 10050، "عامل Zabbix", 3، -1، 2، ""، ""، "عامل Zabbix", 1، 1، ""، ""، ""، "" ]، [ 10105، "متمرکز ساز"، 0، -1، 2، ""، ""، "متمرکز ساز"، 1، 1، ""، ""، ""، "" ] ] }، "رابط":{ "زمینه های":[ "رابط"، "میزبان"، "اصلی"، "نوع"، "useip"، "IP"، "dns"، "بندر"، "فله" ]، "داده ها":[ [ 2، 10105، 1، 1، 1، "127.0.0.1"، ""، "10050"، 1 ] ] }، ... } ``` پروکسی → سرور: ``` {.javascript} { "پاسخ": "موفقیت"، "نسخه": "6.0.0" } ``` ##### Proxy configuration HA cluster nodes (servers) must be listed in the configuration of either passive or active Zabbix proxy. For a passive proxy, the node names must be listed in the Server [parameter](/manual/appendix/config/zabbix_proxy) of the proxy, separated by a **comma**. ``` Server=zabbix-node-01,zabbix-node-02 ``` For an active proxy, the node names must be listed in the Server [parameter](/manual/appendix/config/zabbix_proxy) of the proxy, separated by a **semicolon**. ``` Server=zabbix-node-01;zabbix-node-02 ``` ##### پیکربندی پروکسی گره های خوشه HA (سرورها) باید در پیکربندی هر کدام فهرست شوند پراکسی Zabbix غیرفعال یا فعال برای یک پروکسی غیرفعال، نام گره ها باید در سرور ذکر شوند [پارامتر](/manual/appendix/config/zabbix_proxy) پروکسی، با **کاما** از هم جدا می شوند. ``` سرور=zabbix-node-01,zabbix-node-02 ``` برای یک پروکسی فعال، نام گره ها باید در سرور فهرست شوند [پارامتر](/manual/appendix/config/zabbix_proxy) پروکسی، با **نقطه ویرگول** از هم جدا شده است. ``` سرور=zabbix-node-01;zabbix-node-02 ``` # proxy.create # proxy.update ##### Proxy data request The `proxy data` request is sent by proxy to provide host interface availability, history, discovery and autoregistration data. This request is sent every `DataSenderFrequency` (proxy configuration parameter) seconds. Note that active proxy will still poll Zabbix server every second for remote command tasks (with an empty `proxy data` request). |name|<|value type|description| |-|----------|----------|----------------------------------------| |proxy→server:|<|<|<| |**request**|<|*string*|'proxy data'| |**host**|<|*string*|Proxy name.| |**session**|<|*string*|Data session token.| |**interface availability**|<|*array*|*(optional)* Array of interface availability data objects.| | |**interfaceid**|*number*|Interface identifier.| |^|**available**|*number*|Interface availability:<br><br>**0**, *INTERFACE\_AVAILABLE\_UNKNOWN* - unknown<br>**1**, *INTERFACE\_AVAILABLE\_TRUE* - available<br>**2**, *INTERFACE\_AVAILABLE\_FALSE* - unavailable| |^|**error**|*string*|Interface error message or empty string.| |**history data**|<|*array*|*(optional)* Array of history data objects.| | |**itemid**|*number*|Item identifier.| |^|**clock**|*number*|Item value timestamp (seconds).| |^|**ns**|*number*|Item value timestamp (nanoseconds).| |^|**value**|*string*|*(optional)* Item value.| |^|**id**|*number*|Value identifier (ascending counter, unique within one data session).| |^|**timestamp**|*number*|*(optional)* Timestamp of log type items.| |^|**source**|*string*|*(optional)* Eventlog item source value.| |^|**severity**|*number*|*(optional)* Eventlog item severity value.| |^|**eventid**|*number*|*(optional)* Eventlog item eventid value.| |^|**state**|*string*|*(optional)* Item state:<br>**0**, *ITEM\_STATE\_NORMAL*<br>**1**, *ITEM\_STATE\_NOTSUPPORTED*| |^|**lastlogsize**|*number*|*(optional)* Last log size of log type items.| |^|**mtime**|*number*|*(optional)* Modification time of log type items.| |**discovery data**|<|*array*|*(optional)* Array of discovery data objects.| | |**clock**|*number*|Discovery data timestamp.| |^|**druleid**|*number*|Discovery rule identifier.| |^|**dcheckid**|*number*|Discovery check identifier or null for discovery rule data.| |^|**type**|*number*|Discovery check type:<br><br>**-1** discovery rule data<br>**0**, *SVC\_SSH* - SSH service check<br>**1**, *SVC\_LDAP* - LDAP service check<br>**2**, *SVC\_SMTP* - SMTP service check<br>**3**, *SVC\_FTP* - FTP service check<br>**4**, *SVC\_HTTP* - HTTP service check<br>**5**, *SVC\_POP* - POP service check<br>**6**, *SVC\_NNTP* - NNTP service check<br>**7**, *SVC\_IMAP* - IMAP service check<br>**8**, *SVC\_TCP* - TCP port availability check<br>**9**, *SVC\_AGENT* - Zabbix agent<br>**10**, *SVC\_SNMPv1* - SNMPv1 agent<br>**11**, *SVC\_SNMPv2* - SNMPv2 agent<br>**12**, *SVC\_ICMPPING* - ICMP ping<br>**13**, *SVC\_SNMPv3* - SNMPv3 agent<br>**14**, *SVC\_HTTPS* - HTTPS service check<br>**15**, *SVC\_TELNET* - Telnet availability check| |^|**ip**|*string*|Host IP address.| |^|**dns**|*string*|Host DNS name.| |^|**port**|*number*|*(optional)* Service port number.| |^|**key\_**|*string*|*(optional)* Item key for discovery check of type **9** *SVC\_AGENT*| |^|**value**|*string*|*(optional)* Value received from the service, can be empty for most services.| |^|**status**|*number*|*(optional)* Service status:<br><br>**0**, *DOBJECT\_STATUS\_UP* - Service UP<br>**1**, *DOBJECT\_STATUS\_DOWN* - Service DOWN| |**autoregistration**|<|*array*|*(optional)* Array of autoregistration data objects.| | |**clock**|*number*|Autoregistration data timestamp.| |^|**host**|*string*|Host name.| |^|**ip**|*string*|*(optional)* Host IP address.| |^|**dns**|*string*|*(optional)* Resolved DNS name from IP address.| |^|**port**|*string*|*(optional)* Host port.| |^|**host\_metadata**|*string*|*(optional)* Host metadata sent by the agent (based on HostMetadata or HostMetadataItem agent configuration parameter).| |**tasks**|<|*array*|*(optional)* Array of tasks.| | |**type**|*number*|Task type:<br><br>**0**, *ZBX\_TM\_TASK\_PROCESS\_REMOTE\_COMMAND\_RESULT* - remote command result| |^|**status**|*number*|Remote-command execution status:<br><br>**0**, *ZBX\_TM\_REMOTE\_COMMAND\_COMPLETED* - remote command completed successfully<br>**1**, *ZBX\_TM\_REMOTE\_COMMAND\_FAILED* - remote command failed| |^|**error**|*string*|*(optional)* Error message.| |^|**parent\_taskid**|*number*|Parent task ID.| |**more**|<|*number*|*(optional)* 1 - there are more history data to send.| |**clock**|<|*number*|*(optional)* Data transfer timestamp (seconds).| |**ns**|<|*number*|*(optional)* Data transfer timestamp (nanoseconds).| |**version**|<|*string*|Proxy version (<major>.<minor>.<build>).| |server→proxy:|<|<|<| |**response**|<|*string*|Request success information ('success' or 'failed').| |**upload**|<|*string*|Upload control for historical data (history, autoregistration, host availability, network discovery).<br><br>Possible values:<br>**enabled** - normal operation<br>**disabled** - server is not accepting data (possibly due to internal cache over limit)| |**tasks**|<|*array*|*(optional)* Array of tasks.| | |**type**|*number*|Task type:<br><br>**1**, *ZBX\_TM\_TASK\_PROCESS\_REMOTE\_COMMAND* - remote command| |^|**clock**|*number*|Task creation time.| |^|**ttl**|*number*|Time in seconds after which the task expires.| |^|**commandtype**|*number*|Remote-command type:<br><br>**0**, *ZBX\_SCRIPT\_TYPE\_CUSTOM\_SCRIPT* - use custom script<br>**1**, *ZBX\_SCRIPT\_TYPE\_IPMI* - use IPMI<br>**2**, *ZBX\_SCRIPT\_TYPE\_SSH* - use SSH<br>**3**, *ZBX\_SCRIPT\_TYPE\_TELNET* - use Telnet<br>**4**, *ZBX\_SCRIPT\_TYPE\_GLOBAL\_SCRIPT* - use global script (currently functionally equivalent to custom script)| |^|**command**|*string*|Remote command to execute.| |^|**execute\_on**|*number*|Execution target for custom scripts:<br><br>**0**, *ZBX\_SCRIPT\_EXECUTE\_ON\_AGENT* - execute script on agent<br>**1**, *ZBX\_SCRIPT\_EXECUTE\_ON\_SERVER* - execute script on server<br>**2**, *ZBX\_SCRIPT\_EXECUTE\_ON\_PROXY* - execute script on proxy| |^|**port**|*number*|*(optional)* Port for Telnet and SSH commands.| |^|**authtype**|*number*|*(optional)* Authentication type for SSH commands.| |^|**username**|*string*|*(optional)* User name for Telnet and SSH commands.| |^|**password**|*string*|*(optional)* Password for Telnet and SSH commands.| |^|**publickey**|*string*|*(optional)* Public key for SSH commands.| |^|**privatekey**|*string*|*(optional)* Private key for SSH commands.| |^|**parent\_taskid**|*number*|Parent task ID.| |^|**hostid**|*number*|Target host ID.| Example: proxy→server: ``` {.javascript} { "request": "proxy data", "host": "Proxy #12", "session": "12345678901234567890123456789012", "interface availability": [ { "interfaceid": 1, "available": 1, "error": "" }, { "interfaceid": 2, "available": 2, "error": "Get value from agent failed: cannot connect to [[127.0.0.1]:10049]: [111] Connection refused" }, { "interfaceid": 3, "available": 1, "error": "" }, { "interfaceid": 4, "available": 1, "error": "" } ], "history data":[ { "itemid":"12345", "clock":1478609647, "ns":332510044, "value":"52956612", "id": 1 }, { "itemid":"12346", "clock":1478609647, "ns":330690279, "state":1, "value":"Cannot find information for this network interface in /proc/net/dev.", "id": 2 } ], "discovery data":[ { "clock":1478608764, "drule":2, "dcheck":3, "type":12, "ip":"10.3.0.10", "dns":"vdebian", "status":1 }, { "clock":1478608764, "drule":2, "dcheck":null, "type":-1, "ip":"10.3.0.10", "dns":"vdebian", "status":1 } ], "auto registration":[ { "clock":1478608371, "host":"Logger1", "ip":"10.3.0.1", "dns":"localhost", "port":"10050" }, { "clock":1478608381, "host":"Logger2", "ip":"10.3.0.2", "dns":"localhost", "port":"10050" } ], "tasks":[ { "type": 2, "clock":1478608371, "ttl": 600, "commandtype": 2, "command": "restart_service1.sh", "execute_on": 2, "port": 80, "authtype": 0, "username": "userA", "password": "password1", "publickey": "MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQCqGKukO1De7zhZj6+H0qtjTkVxwTCpvKe", "privatekey": "lsuusFncCzWBQ7RKNUSesmQRMSGkVb1/3j+skZ6UtW+5u09lHNsj6tQ5QCqGKukO1De7zhd", "parent_taskid": 10, "hostid": 10070 }, { "type": 2, "clock":1478608381, "ttl": 600, "commandtype": 1, "command": "restart_service2.sh", "execute_on": 0, "authtype": 0, "username": "", "password": "", "publickey": "", "privatekey": "", "parent_taskid": 20, "hostid": 10084 } ], "tasks":[ { "type": 0, "status": 0, "parent_taskid": 10 }, { "type": 0, "status": 1, "error": "No permissions to execute task.", "parent_taskid": 20 } ], "version":"5.4.0" } ``` server→proxy: ``` {.javascript} { "response": "success", "upload": "enabled", "tasks":[ { "type": 1, "clock": 1478608371, "ttl": 600, "commandtype": 2, "command": "restart_service1.sh", "execute_on": 2, "port": 80, "authtype": 0, "username": "userA", "password": "password1", "publickey": "MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQCqGKukO1De7zhZj6+H0qtjTkVxwTCpvKe", "privatekey": "lsuusFncCzWBQ7RKNUSesmQRMSGkVb1/3j+skZ6UtW+5u09lHNsj6tQ5QCqGKukO1De7zhd", "parent_taskid": 10, "hostid": 10070 }, { "type": 1, "clock": 1478608381, "ttl": 600, "commandtype": 1, "command": "restart_service2.sh", "execute_on": 0, "authtype": 0, "username": "", "password": "", "publickey": "", "privatekey": "", "parent_taskid": 20, "hostid": 10084 } ] } ``` ##### Proxy data request The `proxy data` request is sent by proxy to provide host interface availability, history, discovery and autoregistration data. This request is sent every `DataSenderFrequency` (proxy configuration parameter) seconds. Note that active proxy will still poll Zabbix server every second for remote command tasks (with an empty `proxy data` request). |name|<|value type|description| |-|----------|----------|----------------------------------------| |proxy→server:|<|<|<| |**request**|<|*string*|'proxy data'| |**host**|<|*string*|Proxy name.| |**session**|<|*string*|Data session token.| |**interface availability**|<|*array*|*(optional)* Array of interface availability data objects.| | |**interfaceid**|*number*|Interface identifier.| |^|**available**|*number*|Interface availability:<br><br>**0**, *INTERFACE\_AVAILABLE\_UNKNOWN* - unknown<br>**1**, *INTERFACE\_AVAILABLE\_TRUE* - available<br>**2**, *INTERFACE\_AVAILABLE\_FALSE* - unavailable| |^|**error**|*string*|Interface error message or empty string.| |**history data**|<|*array*|*(optional)* Array of history data objects.| | |**itemid**|*number*|Item identifier.| |^|**clock**|*number*|Item value timestamp (seconds).| |^|**ns**|*number*|Item value timestamp (nanoseconds).| |^|**value**|*string*|*(optional)* Item value.| |^|**id**|*number*|Value identifier (ascending counter, unique within one data session).| |^|**timestamp**|*number*|*(optional)* Timestamp of log type items.| |^|**source**|*string*|*(optional)* Eventlog item source value.| |^|**severity**|*number*|*(optional)* Eventlog item severity value.| |^|**eventid**|*number*|*(optional)* Eventlog item eventid value.| |^|**state**|*string*|*(optional)* Item state:<br>**0**, *ITEM\_STATE\_NORMAL*<br>**1**, *ITEM\_STATE\_NOTSUPPORTED*| |^|**lastlogsize**|*number*|*(optional)* Last log size of log type items.| |^|**mtime**|*number*|*(optional)* Modification time of log type items.| |**discovery data**|<|*array*|*(optional)* Array of discovery data objects.| | |**clock**|*number*|Discovery data timestamp.| |^|**druleid**|*number*|Discovery rule identifier.| |^|**dcheckid**|*number*|Discovery check identifier or null for discovery rule data.| |^|**type**|*number*|Discovery check type:<br><br>**-1** discovery rule data<br>**0**, *SVC\_SSH* - SSH service check<br>**1**, *SVC\_LDAP* - LDAP service check<br>**2**, *SVC\_SMTP* - SMTP service check<br>**3**, *SVC\_FTP* - FTP service check<br>**4**, *SVC\_HTTP* - HTTP service check<br>**5**, *SVC\_POP* - POP service check<br>**6**, *SVC\_NNTP* - NNTP service check<br>**7**, *SVC\_IMAP* - IMAP service check<br>**8**, *SVC\_TCP* - TCP port availability check<br>**9**, *SVC\_AGENT* - Zabbix agent<br>**10**, *SVC\_SNMPv1* - SNMPv1 agent<br>**11**, *SVC\_SNMPv2* - SNMPv2 agent<br>**12**, *SVC\_ICMPPING* - ICMP ping<br>**13**, *SVC\_SNMPv3* - SNMPv3 agent<br>**14**, *SVC\_HTTPS* - HTTPS service check<br>**15**, *SVC\_TELNET* - Telnet availability check| |^|**ip**|*string*|Host IP address.| |^|**dns**|*string*|Host DNS name.| |^|**port**|*number*|*(optional)* Service port number.| |^|**key\_**|*string*|*(optional)* Item key for discovery check of type **9** *SVC\_AGENT*| |^|**value**|*string*|*(optional)* Value received from the service, can be empty for most services.| |^|**status**|*number*|*(optional)* Service status:<br><br>**0**, *DOBJECT\_STATUS\_UP* - Service UP<br>**1**, *DOBJECT\_STATUS\_DOWN* - Service DOWN| |**autoregistration**|<|*array*|*(optional)* Array of autoregistration data objects.| | |**clock**|*number*|Autoregistration data timestamp.| |^|**host**|*string*|Host name.| |^|**ip**|*string*|*(optional)* Host IP address.| |^|**dns**|*string*|*(optional)* Resolved DNS name from IP address.| |^|**port**|*string*|*(optional)* Host port.| |^|**host\_metadata**|*string*|*(optional)* Host metadata sent by the agent (based on HostMetadata or HostMetadataItem agent configuration parameter).| |**tasks**|<|*array*|*(optional)* Array of tasks.| | |**type**|*number*|Task type:<br><br>**0**, *ZBX\_TM\_TASK\_PROCESS\_REMOTE\_COMMAND\_RESULT* - remote command result| |^|**status**|*number*|Remote-command execution status:<br><br>**0**, *ZBX\_TM\_REMOTE\_COMMAND\_COMPLETED* - remote command completed successfully<br>**1**, *ZBX\_TM\_REMOTE\_COMMAND\_FAILED* - remote command failed| |^|**error**|*string*|*(optional)* Error message.| |^|**parent\_taskid**|*number*|Parent task ID.| |**more**|<|*number*|*(optional)* 1 - there are more history data to send.| |**clock**|<|*number*|*(optional)* Data transfer timestamp (seconds).| |**ns**|<|*number*|*(optional)* Data transfer timestamp (nanoseconds).| |**version**|<|*string*|Proxy version (<major>.<minor>.<build>).| |server→proxy:|<|<|<| |**response**|<|*string*|Request success information ('success' or 'failed').| |**upload**|<|*string*|Upload control for historical data (history, autoregistration, host availability, network discovery).<br><br>Possible values:<br>**enabled** - normal operation<br>**disabled** - server is not accepting data (possibly due to internal cache over limit)| |**tasks**|<|*array*|*(optional)* Array of tasks.| | |**type**|*number*|Task type:<br><br>**1**, *ZBX\_TM\_TASK\_PROCESS\_REMOTE\_COMMAND* - remote command| |^|**clock**|*number*|Task creation time.| |^|**ttl**|*number*|Time in seconds after which the task expires.| |^|**commandtype**|*number*|Remote-command type:<br><br>**0**, *ZBX\_SCRIPT\_TYPE\_CUSTOM\_SCRIPT* - use custom script<br>**1**, *ZBX\_SCRIPT\_TYPE\_IPMI* - use IPMI<br>**2**, *ZBX\_SCRIPT\_TYPE\_SSH* - use SSH<br>**3**, *ZBX\_SCRIPT\_TYPE\_TELNET* - use Telnet<br>**4**, *ZBX\_SCRIPT\_TYPE\_GLOBAL\_SCRIPT* - use global script (currently functionally equivalent to custom script)| |^|**command**|*string*|Remote command to execute.| |^|**execute\_on**|*number*|Execution target for custom scripts:<br><br>**0**, *ZBX\_SCRIPT\_EXECUTE\_ON\_AGENT* - execute script on agent<br>**1**, *ZBX\_SCRIPT\_EXECUTE\_ON\_SERVER* - execute script on server<br>**2**, *ZBX\_SCRIPT\_EXECUTE\_ON\_PROXY* - execute script on proxy| |^|**port**|*number*|*(optional)* Port for Telnet and SSH commands.| |^|**authtype**|*number*|*(optional)* Authentication type for SSH commands.| |^|**username**|*string*|*(optional)* User name for Telnet and SSH commands.| |^|**password**|*string*|*(optional)* Password for Telnet and SSH commands.| |^|**publickey**|*string*|*(optional)* Public key for SSH commands.| |^|**privatekey**|*string*|*(optional)* Private key for SSH commands.| |^|**parent\_taskid**|*number*|Parent task ID.| |^|**hostid**|*number*|Target host ID.| Example: proxy→server: ``` {.javascript} { "request": "proxy data", "host": "Proxy #12", "session": "12345678901234567890123456789012", "interface availability": [ { "interfaceid": 1, "available": 1, "error": "" }, { "interfaceid": 2, "available": 2, "error": "Get value from agent failed: cannot connect to [[127.0.0.1]:10049]: [111] Connection refused" }, { "interfaceid": 3, "available": 1, "error": "" }, { "interfaceid": 4, "available": 1, "error": "" } ], "history data":[ { "itemid":"12345", "clock":1478609647, "ns":332510044, "value":"52956612", "id": 1 }, { "itemid":"12346", "clock":1478609647, "ns":330690279, "state":1, "value":"Cannot find information for this network interface in /proc/net/dev.", "id": 2 } ], "discovery data":[ { "clock":1478608764, "drule":2, "dcheck":3, "type":12, "ip":"10.3.0.10", "dns":"vdebian", "status":1 }, { "clock":1478608764, "drule":2, "dcheck":null, "type":-1, "ip":"10.3.0.10", "dns":"vdebian", "status":1 } ], "auto registration":[ { "clock":1478608371, "host":"Logger1", "ip":"10.3.0.1", "dns":"localhost", "port":"10050" }, { "clock":1478608381, "host":"Logger2", "ip":"10.3.0.2", "dns":"localhost", "port":"10050" } ], "tasks":[ { "type": 2, "clock":1478608371, "ttl": 600, "commandtype": 2, "command": "restart_service1.sh", "execute_on": 2, "port": 80, "authtype": 0, "username": "userA", "password": "password1", "publickey": "MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQCqGKukO1De7zhZj6+H0qtjTkVxwTCpvKe", "privatekey": "lsuusFncCzWBQ7RKNUSesmQRMSGkVb1/3j+skZ6UtW+5u09lHNsj6tQ5QCqGKukO1De7zhd", "parent_taskid": 10, "hostid": 10070 }, { "type": 2, "clock":1478608381, "ttl": 600, "commandtype": 1, "command": "restart_service2.sh", "execute_on": 0, "authtype": 0, "username": "", "password": "", "publickey": "", "privatekey": "", "parent_taskid": 20, "hostid": 10084 } ], "tasks":[ { "type": 0, "status": 0, "parent_taskid": 10 }, { "type": 0, "status": 1, "error": "No permissions to execute task.", "parent_taskid": 20 } ], "version":"5.4.0" } ``` server→proxy: ``` {.javascript} { "response": "success", "upload": "enabled", "tasks":[ { "type": 1, "clock": 1478608371, "ttl": 600, "commandtype": 2, "command": "restart_service1.sh", "execute_on": 2, "port": 80, "authtype": 0, "username": "userA", "password": "password1", "publickey": "MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQCqGKukO1De7zhZj6+H0qtjTkVxwTCpvKe", "privatekey": "lsuusFncCzWBQ7RKNUSesmQRMSGkVb1/3j+skZ6UtW+5u09lHNsj6tQ5QCqGKukO1De7zhd", "parent_taskid": 10, "hostid": 10070 }, { "type": 1, "clock": 1478608381, "ttl": 600, "commandtype": 1, "command": "restart_service2.sh", "execute_on": 0, "authtype": 0, "username": "", "password": "", "publickey": "", "privatekey": "", "parent_taskid": 20, "hostid": 10084 } ] } ``` # proxy.delete #حذف هاست ##### Proxy heartbeat request The `proxy heartbeat` request is sent by proxy to report that proxy is running. This request is sent every `HeartbeatFrequency` (proxy configuration parameter) seconds. |name|value type|description| |----------|----------|----------------------------------------| |proxy→server:|<|<| |**request**|*string*|'proxy heartbeat'| |**host**|*string*|Proxy name.| |**version**|*string*|Proxy version (<major>.<minor>.<build>).| |server→proxy:|<|<| |**response**|*string*|Request success information ('success' or 'failed').| proxy→server: ``` {.javascript} { "request": "proxy heartbeat", "host": "Proxy #12", "version": "5.4.0" } ``` server→proxy: ``` {.javascript} { "response": "success" } ``` ##### درخواست ضربان قلب پروکسی درخواست «پراکسی ضربان قلب» توسط پراکسی ارسال می‌شود تا آن پروکسی را گزارش کند در حال اجرا این درخواست در هر «HeartbeatFrequency» (پراکسی پارامتر پیکربندی) ثانیه. |نام|نوع مقدار|توضیحات| |----------|----------|-------------------------- -------------| |پراکسی→سرور:|<|<| |**درخواست**|*رشته*|'پراکسی ضربان قلب'| |**میزبان**|*رشته*|نام پروکسی.| |**نسخه**|*string*|نسخه پروکسی (<major>.<minor>.<build>).| |سرور→پراکسی:|<|<| |**پاسخ**|*string*|اطلاعات موفقیت را درخواست کنید ('موفقیت' یا 'شکست').| پروکسی← سرور: ``` {.javascript} { "درخواست": "تپش قلب پروکسی"، "میزبان": "پراکسی شماره 12"، "نسخه": "5.4.0" } ``` سرور → پروکسی: ``` {.javascript} { "پاسخ": "موفقیت" } ``` ### Proxy history housekeeping The limitation on the amount of outdated information deleted from the proxy database per proxy history housekeeping cycle has been removed. Previously the [housekeeper](/manual/web_interface/frontend_sections/administration/general#housekeeper) deleted only no more than 4 times the [`HousekeepingFrequency`](/manual/appendix/config/zabbix_proxy) hours of outdated information. For example, if `HousekeepingFrequency` was set to "1", no more than 4 hours of outdated information (starting from the oldest entry) was deleted. In cases when a proxy would constantly receive data older than set in [`ProxyOfflineBuffer`](/manual/appendix/config/zabbix_proxy), this could result in excessive data accumulation. Now this limitation has been removed, providing a more effective proxy history housekeeping solution. ### خانه داری تاریخچه پروکسی محدودیت در مقدار اطلاعات قدیمی حذف شده از پایگاه داده پروکسی در هر چرخه خانه داری تاریخچه پروکسی حذف شده است. قبلاً [housekeeper](/manual/web_interface/frontend_sections/administration/general#housekeeper) تنها بیش از 4 برابر ['HousekeepingFrequency'](/manual/appendix/config/zabbix_proxy) ساعت اطلاعات قدیمی را حذف می‌کرد. به عنوان مثال، اگر "فرکانس خانه" روی "1" تنظیم شده بود، بیش از 4 ساعت اطلاعات قدیمی (از قدیمی ترین ورودی شروع می شود) حذف نمی شود. در مواردی که یک پروکسی دائماً داده‌های قدیمی‌تر از تنظیم‌شده در [`ProxyOfflineBuffer`](/manual/appendix/config/zabbix_proxy) را دریافت می‌کند، این می‌تواند منجر به تجمع بیش از حد داده شود. اکنون این محدودیت برداشته شده است و راه حل کارآمدتری برای خانه داری تاریخچه پروکسی ارائه می دهد. ##### Proxy request The `proxy data` request is used to obtain host interface availability, historical, discovery and autoregistration data from proxy. This request is sent every `ProxyDataFrequency` (server configuration parameter) seconds. |name|<|value type|description| |-|----------|----------|----------------------------------------| |server→proxy:|<|<|<| |**request**|<|*string*|'proxy data'| |proxy→server:|<|<|<| |**session**|<|*string*|Data session token.| |**interface availability**|<|*array*|*(optional)* Array of interface availability data objects.| | |**interfaceid**|*number*|Interface identifier.| |^|**available**|*number*|Interface availability:<br><br>**0**, *INTERFACE\_AVAILABLE\_UNKNOWN* - unknown<br>**1**, *INTERFACE\_AVAILABLE\_TRUE* - available<br>**2**, *INTERFACE\_AVAILABLE\_FALSE* - unavailable| |^|**error**|*string*|Interface error message or empty string.| |**history data**|<|*array*|*(optional)* Array of history data objects.| | |**itemid**|*number*|Item identifier.| |^|**clock**|*number*|Item value timestamp (seconds).| |^|**ns**|*number*|Item value timestamp (nanoseconds).| |^|**value**|*string*|*(optional)* Item value.| |^|**id**|*number*|Value identifier (ascending counter, unique within one data session).| |^|**timestamp**|*number*|*(optional)* Timestamp of log type items.| |^|**source**|*string*|*(optional)* Eventlog item source value.| |^|**severity**|*number*|*(optional)* Eventlog item severity value.| |^|**eventid**|*number*|*(optional)* Eventlog item eventid value.| |^|**state**|*string*|*(optional)* Item state:<br>**0**, *ITEM\_STATE\_NORMAL*<br>**1**, *ITEM\_STATE\_NOTSUPPORTED*| |^|**lastlogsize**|*number*|*(optional)* Last log size of log type items.| |^|**mtime**|*number*|*(optional)* Modification time of log type items.| |**discovery data**|<|*array*|*(optional)* Array of discovery data objects.| | |**clock**|*number*|Discovery data timestamp.| |^|**druleid**|*number*|Discovery rule identifier.| |^|**dcheckid**|*number*|Discovery check identifier or null for discovery rule data.| |^|**type**|*number*|Discovery check type:<br><br>**-1** discovery rule data<br>**0**, *SVC\_SSH* - SSH service check<br>**1**, *SVC\_LDAP* - LDAP service check<br>**2**, *SVC\_SMTP* - SMTP service check<br>**3**, *SVC\_FTP* - FTP service check<br>**4**, *SVC\_HTTP* - HTTP service check<br>**5**, *SVC\_POP* - POP service check<br>**6**, *SVC\_NNTP* - NNTP service check<br>**7**, *SVC\_IMAP* - IMAP service check<br>**8**, *SVC\_TCP* - TCP port availability check<br>**9**, *SVC\_AGENT* - Zabbix agent<br>**10**, *SVC\_SNMPv1* - SNMPv1 agent<br>**11**, *SVC\_SNMPv2* - SNMPv2 agent<br>**12**, *SVC\_ICMPPING* - ICMP ping<br>**13**, *SVC\_SNMPv3* - SNMPv3 agent<br>**14**, *SVC\_HTTPS* - HTTPS service check<br>**15**, *SVC\_TELNET* - Telnet availability check| |^|**ip**|*string*|Host IP address.| |^|**dns**|*string*|Host DNS name.| |^|**port**|*number*|*(optional)* Service port number.| |^|**key\_**|*string*|*(optional)* Item key for discovery check of type **9** *SVC\_AGENT*| |^|**value**|*string*|*(optional)* Value received from the service, can be empty for most services.| |^|**status**|*number*|*(optional)* Service status:<br><br>**0**, *DOBJECT\_STATUS\_UP* - Service UP<br>**1**, *DOBJECT\_STATUS\_DOWN* - Service DOWN| |**auto registration**|<|*array*|*(optional)* Array of autoregistration data objects.| | |**clock**|*number*|Autoregistration data timestamp.| |^|**host**|*string*|Host name.| |^|**ip**|*string*|*(optional)* Host IP address.| |^|**dns**|*string*|*(optional)* Resolved DNS name from IP address.| |^|**port**|*string*|*(optional)* Host port.| |^|**host\_metadata**|*string*|*(optional)* Host metadata sent by the agent (based on HostMetadata or HostMetadataItem agent configuration parameter).| |**tasks**|<|*array*|*(optional)* Array of tasks.| | |**type**|*number*|Task type:<br><br>**0**, *ZBX\_TM\_TASK\_PROCESS\_REMOTE\_COMMAND\_RESULT* - remote command result| |^|**status**|*number*|Remote-command execution status:<br><br>**0**, *ZBX\_TM\_REMOTE\_COMMAND\_COMPLETED* - remote command completed successfully<br>**1**, *ZBX\_TM\_REMOTE\_COMMAND\_FAILED* - remote command failed| |^|**error**|*string*|*(optional)* Error message.| |^|**parent\_taskid**|*number*|Parent task ID.| |**more**|<|*number*|*(optional)* 1 - there are more history data to send.| |**clock**|<|*number*|*(optional)* Data transfer timestamp (seconds).| |**ns**|<|*number*|*(optional)* Data transfer timestamp (nanoseconds).| |**version**|<|*string*|Proxy version (<major>.<minor>.<build>).| |server→proxy:|<|<|<| |**response**|<|*string*|Request success information ('success' or 'failed').| |**tasks**|<|*array*|*(optional)* Array of tasks.| | |**type**|*number*|Task type:<br><br>**1**, *ZBX\_TM\_TASK\_PROCESS\_REMOTE\_COMMAND* - remote command| |^|**clock**|*number*|Task creation time.| |^|**ttl**|*number*|Time in seconds after which the task expires.| |^|**commandtype**|*number*|Remote-command type:<br><br>**0**, *ZBX\_SCRIPT\_TYPE\_CUSTOM\_SCRIPT* - use custom script<br>**1**, *ZBX\_SCRIPT\_TYPE\_IPMI* - use IPMI<br>**2**, *ZBX\_SCRIPT\_TYPE\_SSH* - use SSH<br>**3**, *ZBX\_SCRIPT\_TYPE\_TELNET* - use Telnet<br>**4**, *ZBX\_SCRIPT\_TYPE\_GLOBAL\_SCRIPT* - use global script (currently functionally equivalent to custom script)| |^|**command**|*string*|Remote command to execute.| |^|**execute\_on**|*number*|Execution target for custom scripts:<br><br>**0**, *ZBX\_SCRIPT\_EXECUTE\_ON\_AGENT* - execute script on agent<br>**1**, *ZBX\_SCRIPT\_EXECUTE\_ON\_SERVER* - execute script on server<br>**2**, *ZBX\_SCRIPT\_EXECUTE\_ON\_PROXY* - execute script on proxy| |^|**port**|*number*|*(optional)* Port for Telnet and SSH commands.| |^|**authtype**|*number*|*(optional)* Authentication type for SSH commands.| |^|**username**|*string*|*(optional)* User name for Telnet and SSH commands.| |^|**password**|*string*|*(optional)* Password for Telnet and SSH commands.| |^|**publickey**|*string*|*(optional)* Public key for SSH commands.| |^|**privatekey**|*string*|*(optional)* Private key for SSH commands.| |^|**parent\_taskid**|*number*|Parent task ID.| |^|**hostid**|*number*|Target host ID.| Example: server→proxy: ``` {.javascript} { "request": "proxy data" } ``` proxy→server: ``` {.javascript} { "session": "12345678901234567890123456789012" "interface availability": [ { "interfaceid": 1, "available": 1, "error": "" }, { "interfaceid": 2, "available": 2, "error": "Get value from agent failed: cannot connect to [[127.0.0.1]:10049]: [111] Connection refused" }, { "interfaceid": 3, "available": 1, "error": "" }, { "interfaceid": 4, "available": 1, "error": "" } ], "history data":[ { "itemid":"12345", "clock":1478609647, "ns":332510044, "value":"52956612", "id": 1 }, { "itemid":"12346", "clock":1478609647, "ns":330690279, "state":1, "value":"Cannot find information for this network interface in /proc/net/dev.", "id": 2 } ], "discovery data":[ { "clock":1478608764, "drule":2, "dcheck":3, "type":12, "ip":"10.3.0.10", "dns":"vdebian", "status":1 }, { "clock":1478608764, "drule":2, "dcheck":null, "type":-1, "ip":"10.3.0.10", "dns":"vdebian", "status":1 } ], "auto registration":[ { "clock":1478608371, "host":"Logger1", "ip":"10.3.0.1", "dns":"localhost", "port":"10050" }, { "clock":1478608381, "host":"Logger2", "ip":"10.3.0.2", "dns":"localhost", "port":"10050" } ], "tasks":[ { "type": 0, "status": 0, "parent_taskid": 10 }, { "type": 0, "status": 1, "error": "No permissions to execute task.", "parent_taskid": 20 } ], "version":"5.4.0" } ``` server→proxy: ``` {.javascript} { "response": "success", "tasks":[ { "type": 1, "clock": 1478608371, "ttl": 600, "commandtype": 2, "command": "restart_service1.sh", "execute_on": 2, "port": 80, "authtype": 0, "username": "userA", "password": "password1", "publickey": "MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQCqGKukO1De7zhZj6+H0qtjTkVxwTCpvKe", "privatekey": "lsuusFncCzWBQ7RKNUSesmQRMSGkVb1/3j+skZ6UtW+5u09lHNsj6tQ5QCqGKukO1De7zhd", "parent_taskid": 10, "hostid": 10070 }, { "type": 1, "clock": 1478608381, "ttl": 600, "commandtype": 1, "command": "restart_service2.sh", "execute_on": 0, "authtype": 0, "username": "", "password": "", "publickey": "", "privatekey": "", "parent_taskid": 20, "hostid": 10084 } ] } ``` ##### Proxy request The `proxy data` request is used to obtain host interface availability, historical, discovery and autoregistration data from proxy. This request is sent every `ProxyDataFrequency` (server configuration parameter) seconds. |name|<|value type|description| |-|----------|----------|----------------------------------------| |server→proxy:|<|<|<| |**request**|<|*string*|'proxy data'| |proxy→server:|<|<|<| |**session**|<|*string*|Data session token.| |**interface availability**|<|*array*|*(optional)* Array of interface availability data objects.| | |**interfaceid**|*number*|Interface identifier.| |^|**available**|*number*|Interface availability:<br><br>**0**, *INTERFACE\_AVAILABLE\_UNKNOWN* - unknown<br>**1**, *INTERFACE\_AVAILABLE\_TRUE* - available<br>**2**, *INTERFACE\_AVAILABLE\_FALSE* - unavailable| |^|**error**|*string*|Interface error message or empty string.| |**history data**|<|*array*|*(optional)* Array of history data objects.| | |**itemid**|*number*|Item identifier.| |^|**clock**|*number*|Item value timestamp (seconds).| |^|**ns**|*number*|Item value timestamp (nanoseconds).| |^|**value**|*string*|*(optional)* Item value.| |^|**id**|*number*|Value identifier (ascending counter, unique within one data session).| |^|**timestamp**|*number*|*(optional)* Timestamp of log type items.| |^|**source**|*string*|*(optional)* Eventlog item source value.| |^|**severity**|*number*|*(optional)* Eventlog item severity value.| |^|**eventid**|*number*|*(optional)* Eventlog item eventid value.| |^|**state**|*string*|*(optional)* Item state:<br>**0**, *ITEM\_STATE\_NORMAL*<br>**1**, *ITEM\_STATE\_NOTSUPPORTED*| |^|**lastlogsize**|*number*|*(optional)* Last log size of log type items.| |^|**mtime**|*number*|*(optional)* Modification time of log type items.| |**discovery data**|<|*array*|*(optional)* Array of discovery data objects.| | |**clock**|*number*|Discovery data timestamp.| |^|**druleid**|*number*|Discovery rule identifier.| |^|**dcheckid**|*number*|Discovery check identifier or null for discovery rule data.| |^|**type**|*number*|Discovery check type:<br><br>**-1** discovery rule data<br>**0**, *SVC\_SSH* - SSH service check<br>**1**, *SVC\_LDAP* - LDAP service check<br>**2**, *SVC\_SMTP* - SMTP service check<br>**3**, *SVC\_FTP* - FTP service check<br>**4**, *SVC\_HTTP* - HTTP service check<br>**5**, *SVC\_POP* - POP service check<br>**6**, *SVC\_NNTP* - NNTP service check<br>**7**, *SVC\_IMAP* - IMAP service check<br>**8**, *SVC\_TCP* - TCP port availability check<br>**9**, *SVC\_AGENT* - Zabbix agent<br>**10**, *SVC\_SNMPv1* - SNMPv1 agent<br>**11**, *SVC\_SNMPv2* - SNMPv2 agent<br>**12**, *SVC\_ICMPPING* - ICMP ping<br>**13**, *SVC\_SNMPv3* - SNMPv3 agent<br>**14**, *SVC\_HTTPS* - HTTPS service check<br>**15**, *SVC\_TELNET* - Telnet availability check| |^|**ip**|*string*|Host IP address.| |^|**dns**|*string*|Host DNS name.| |^|**port**|*number*|*(optional)* Service port number.| |^|**key\_**|*string*|*(optional)* Item key for discovery check of type **9** *SVC\_AGENT*| |^|**value**|*string*|*(optional)* Value received from the service, can be empty for most services.| |^|**status**|*number*|*(optional)* Service status:<br><br>**0**, *DOBJECT\_STATUS\_UP* - Service UP<br>**1**, *DOBJECT\_STATUS\_DOWN* - Service DOWN| |**auto registration**|<|*array*|*(optional)* Array of autoregistration data objects.| | |**clock**|*number*|Autoregistration data timestamp.| |^|**host**|*string*|Host name.| |^|**ip**|*string*|*(optional)* Host IP address.| |^|**dns**|*string*|*(optional)* Resolved DNS name from IP address.| |^|**port**|*string*|*(optional)* Host port.| |^|**host\_metadata**|*string*|*(optional)* Host metadata sent by the agent (based on HostMetadata or HostMetadataItem agent configuration parameter).| |**tasks**|<|*array*|*(optional)* Array of tasks.| | |**type**|*number*|Task type:<br><br>**0**, *ZBX\_TM\_TASK\_PROCESS\_REMOTE\_COMMAND\_RESULT* - remote command result| |^|**status**|*number*|Remote-command execution status:<br><br>**0**, *ZBX\_TM\_REMOTE\_COMMAND\_COMPLETED* - remote command completed successfully<br>**1**, *ZBX\_TM\_REMOTE\_COMMAND\_FAILED* - remote command failed| |^|**error**|*string*|*(optional)* Error message.| |^|**parent\_taskid**|*number*|Parent task ID.| |**more**|<|*number*|*(optional)* 1 - there are more history data to send.| |**clock**|<|*number*|*(optional)* Data transfer timestamp (seconds).| |**ns**|<|*number*|*(optional)* Data transfer timestamp (nanoseconds).| |**version**|<|*string*|Proxy version (<major>.<minor>.<build>).| |server→proxy:|<|<|<| |**response**|<|*string*|Request success information ('success' or 'failed').| |**tasks**|<|*array*|*(optional)* Array of tasks.| | |**type**|*number*|Task type:<br><br>**1**, *ZBX\_TM\_TASK\_PROCESS\_REMOTE\_COMMAND* - remote command| |^|**clock**|*number*|Task creation time.| |^|**ttl**|*number*|Time in seconds after which the task expires.| |^|**commandtype**|*number*|Remote-command type:<br><br>**0**, *ZBX\_SCRIPT\_TYPE\_CUSTOM\_SCRIPT* - use custom script<br>**1**, *ZBX\_SCRIPT\_TYPE\_IPMI* - use IPMI<br>**2**, *ZBX\_SCRIPT\_TYPE\_SSH* - use SSH<br>**3**, *ZBX\_SCRIPT\_TYPE\_TELNET* - use Telnet<br>**4**, *ZBX\_SCRIPT\_TYPE\_GLOBAL\_SCRIPT* - use global script (currently functionally equivalent to custom script)| |^|**command**|*string*|Remote command to execute.| |^|**execute\_on**|*number*|Execution target for custom scripts:<br><br>**0**, *ZBX\_SCRIPT\_EXECUTE\_ON\_AGENT* - execute script on agent<br>**1**, *ZBX\_SCRIPT\_EXECUTE\_ON\_SERVER* - execute script on server<br>**2**, *ZBX\_SCRIPT\_EXECUTE\_ON\_PROXY* - execute script on proxy| |^|**port**|*number*|*(optional)* Port for Telnet and SSH commands.| |^|**authtype**|*number*|*(optional)* Authentication type for SSH commands.| |^|**username**|*string*|*(optional)* User name for Telnet and SSH commands.| |^|**password**|*string*|*(optional)* Password for Telnet and SSH commands.| |^|**publickey**|*string*|*(optional)* Public key for SSH commands.| |^|**privatekey**|*string*|*(optional)* Private key for SSH commands.| |^|**parent\_taskid**|*number*|Parent task ID.| |^|**hostid**|*number*|Target host ID.| Example: server→proxy: ``` {.javascript} { "request": "proxy data" } ``` proxy→server: ``` {.javascript} { "session": "12345678901234567890123456789012" "interface availability": [ { "interfaceid": 1, "available": 1, "error": "" }, { "interfaceid": 2, "available": 2, "error": "Get value from agent failed: cannot connect to [[127.0.0.1]:10049]: [111] Connection refused" }, { "interfaceid": 3, "available": 1, "error": "" }, { "interfaceid": 4, "available": 1, "error": "" } ], "history data":[ { "itemid":"12345", "clock":1478609647, "ns":332510044, "value":"52956612", "id": 1 }, { "itemid":"12346", "clock":1478609647, "ns":330690279, "state":1, "value":"Cannot find information for this network interface in /proc/net/dev.", "id": 2 } ], "discovery data":[ { "clock":1478608764, "drule":2, "dcheck":3, "type":12, "ip":"10.3.0.10", "dns":"vdebian", "status":1 }, { "clock":1478608764, "drule":2, "dcheck":null, "type":-1, "ip":"10.3.0.10", "dns":"vdebian", "status":1 } ], "auto registration":[ { "clock":1478608371, "host":"Logger1", "ip":"10.3.0.1", "dns":"localhost", "port":"10050" }, { "clock":1478608381, "host":"Logger2", "ip":"10.3.0.2", "dns":"localhost", "port":"10050" } ], "tasks":[ { "type": 0, "status": 0, "parent_taskid": 10 }, { "type": 0, "status": 1, "error": "No permissions to execute task.", "parent_taskid": 20 } ], "version":"5.4.0" } ``` server→proxy: ``` {.javascript} { "response": "success", "tasks":[ { "type": 1, "clock": 1478608371, "ttl": 600, "commandtype": 2, "command": "restart_service1.sh", "execute_on": 2, "port": 80, "authtype": 0, "username": "userA", "password": "password1", "publickey": "MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQCqGKukO1De7zhZj6+H0qtjTkVxwTCpvKe", "privatekey": "lsuusFncCzWBQ7RKNUSesmQRMSGkVb1/3j+skZ6UtW+5u09lHNsj6tQ5QCqGKukO1De7zhd", "parent_taskid": 10, "hostid": 10070 }, { "type": 1, "clock": 1478608381, "ttl": 600, "commandtype": 1, "command": "restart_service2.sh", "execute_on": 0, "authtype": 0, "username": "", "password": "", "publickey": "", "privatekey": "", "parent_taskid": 20, "hostid": 10084 } ] } ``` # proxy.update # proxy.update ##### Purpose of persistent files When Zabbix agent is started it receives a list of active checks from Zabbix server or proxy. For log\*\[\] metrics it receives the processed log size and the modification time for finding where to start log file monitoring from. Depending on the actual log file size and modification time reported by file system the agent decides either to continue log file monitoring from the processed log size or re\-analyze the log file from the beginning. A running agent maintains a larger set of attributes for tracking all monitored log files between checks. This in\-memory state is lost when the agent is stopped. The new optional parameter **persistent\_dir** specifies a directory for storing this state of log\[\], log.count\[\], logrt\[\] or logrt.count\[\] item in a file. The state of log item is restored from the persistent file after the Zabbix agent is restarted. The primary use\-case is monitoring of log file located on a mirrored file system. Until some moment in time the log file is written to both mirrors. Then mirrors are split. On the active copy the log file is still growing, getting new records. Zabbix agent analyzes it and sends processed logs size and modification time to server. On the passive copy the log file stays the same, well behind the active copy. Later the operating system and Zabbix agent are rebooted from the passive copy. The processed log size and modification time the Zabbix agent receives from server may not be valid for situation on the passive copy. To continue log file monitoring from the place the agent left off at the moment of file system mirror split the agent restores its state from the persistent file. ##### هدف از فایل های ماندگار هنگامی که عامل Zabbix راه اندازی می شود، لیستی از چک های فعال را از Zabbix دریافت می کند سرور یا پروکسی برای معیارهای log\*\[\] اندازه گزارش پردازش شده و زمان اصلاح برای یافتن اینکه نظارت بر فایل لاگ از کجا شروع شود. بسته به اندازه واقعی فایل لاگ و زمان اصلاح گزارش شده توسط فایل سیستم عامل تصمیم می گیرد یا به نظارت بر فایل ورود به سیستم ادامه دهد اندازه گزارش پردازش شده یا فایل گزارش را از ابتدا دوباره تجزیه و تحلیل کنید. یک عامل در حال اجرا مجموعه بزرگتری از ویژگی ها را برای ردیابی همه نظارت شده حفظ می کند لاگ فایل ها بین چک ها این حالت در حافظه زمانی که عامل باشد از بین می رود متوقف شد. پارامتر اختیاری جدید **persistent\_dir** یک دایرکتوری را برای آن مشخص می کند ذخیره این حالت log\[\]، log.count\[\]، logrt\[\] یا logrt.count\[\] مورد در یک فایل وضعیت آیتم گزارش از فایل پایدار پس از بازیابی می شود عامل Zabbix دوباره راه اندازی می شود. مورد استفاده اولیه، نظارت بر فایل گزارش است که بر روی یک فایل آینه‌ای قرار دارد سیستم. تا زمانی که فایل log در هر دو آینه نوشته می شود. سپس آینه ها تقسیم می شوند در کپی فعال، فایل گزارش همچنان در حال رشد است و دریافت می‌شود رکوردهای جدید عامل Zabbix آن را تجزیه و تحلیل می کند و اندازه لاگ های پردازش شده را ارسال می کند زمان تغییر به سرور در کپی غیرفعال، فایل log یکسان می ماند، به خوبی پشت نسخه فعال است. بعدها سیستم عامل و عامل Zabbix هستند از کپی غیرفعال ریبوت شد. اندازه گزارش پردازش شده و زمان اصلاح عامل Zabbix که از سرور دریافت می کند ممکن است برای وضعیت موجود در سرور معتبر نباشد کپی غیرفعال برای ادامه نظارت بر فایل گزارش از جایی که عامل ترک کرده است خاموش در لحظه تقسیم آینه فایل سیستم عامل حالت خود را از آن بازیابی می کند فایل پایدار ##### Readable summary in maps A hidden "aria-label" property is available allowing map information to be read with a screen reader. Both general map description and individual element description is available, in the following format: - for map description: `<Map name>, <* of * items in problem state>, <* problems in total>.` - for describing one element with one problem: `<Element type>, Status <Element status>, <Element name>, <Problem description>.` - for describing one element with multiple problems: `<Element type>, Status <Element status>, <Element name>, <* problems>.` - for describing one element without problems: `<Element type>, Status <Element status>, <Element name>.` For example, this description is available: 'Local network, 1 of 6 elements in problem state, 1 problem in total. Host, Status problem, My host, Free disk space is less than 20% on volume \/. Host group, Status ok, Virtual servers. Host, Status ok, Server 1. Host, Status ok, Server 2. Host, Status ok, Server 3. Host, Status ok, Server 4. ' for the following map: ![](../../../../../assets/en/manual/web_interface/map_aria_label.png){width="600"} ##### خلاصه قابل خواندن در نقشه ها یک ویژگی پنهان "aria-label" در دسترس است که به اطلاعات نقشه اجازه می دهد با صفحه خوان خوانده شود هم توضیحات کلی نقشه و هم توضیحات عنصر فردی در قالب زیر موجود است: - برای توضیحات نقشه: "<نام نقشه>، <* از * موارد در وضعیت مشکل>، <* در مجموع مشکلات>." - برای توصیف یک عنصر با یک مشکل: "<نوع عنصر>، وضعیت <وضعیت عنصر>، <نام عنصر>، <شرح مشکل>." - برای توصیف یک عنصر با چندین مشکل: "<نوع عنصر>، وضعیت <وضعیت عنصر>، <نام عنصر>، <* مشکلات>." - برای توصیف یک عنصر بدون مشکل: "<نوع عنصر>، وضعیت <وضعیت عنصر>، <نام عنصر>." به عنوان مثال، این توضیحات در دسترس است: شبکه محلی، 1 عنصر از 6 عنصر در وضعیت مشکل، 1 مشکل در کل. میزبان، مشکل وضعیت، میزبان من، فضای دیسک رایگان کمتر از 20٪ در حجم \/ است. گروه میزبان، وضعیت خوب، سرورهای مجازی. میزبان، وضعیت اوکی، سرور 1. میزبان، وضعیت خوب، سرور 2. میزبان، وضعیت خوب، سرور 3. میزبان، وضعیت خوب، سرور 4. ' برای نقشه زیر: ![](../../../../../assets/en/manual/web_interface/map_aria_label.png){width="600"} ##### Recent change markers Inward pointing red triangles around an element indicate a recent trigger status change - one that's happened within the last 30 minutes. These triangles are shown if the *Mark elements on trigger status change* check-box is marked in map [configuration](/manual/config/visualization/maps/map#creating_a_map). ##### نشانگرهای تغییر اخیر مثلث های قرمز رو به داخل در اطراف یک عنصر نشان دهنده یک اخیر است تغییر وضعیت ماشه - موردی که در 30 دقیقه گذشته اتفاق افتاده است. این مثلث ها در صورتی نشان داده می شوند که عناصر * علامت گذاری بر روی وضعیت ماشه چک باکس تغییر* در نقشه مشخص شده است [پیکربندی](/manual/config/visualization/maps/map#creating_a_map). ##### Referencing a network map Network maps can be referenced by both `sysmapid` and `mapname` GET parameters. For example, http://zabbix/zabbix/zabbix.php?action=map.view&mapname=Local%20network will open the map with that name (Local network). If both `sysmapid` (map ID) and `mapname` (map name) are specified, `mapname` has higher priority. ##### ارجاع به نقشه شبکه نقشه های شبکه را می توان با «sysmapid» و «mapname» GET ارجاع داد مولفه های. مثلا، http://zabbix/zabbix/zabbix.php?action=map.view&mapname=Local%20network نقشه را با آن نام باز می کند (شبکه محلی). اگر هر دو «sysmapid» (شناسه نقشه) و «نام نقشه» (نام نقشه) مشخص شده باشند، «نام نقشه» اولویت بیشتری دارد. # regexp.create # regexp.create # regexp.delete پاک کردن قانون جست وجو # regexp.get # role.get # regexp.update # regexp.create ###### Register request A request sent by the agent during the agent startup phase to obtain provided metrics to register a plugin. | | | |---|---| |direction|agent → plugin| |response|yes| Parameters specific to register requests: |Name|Type|Comments| |---------|--------|----------| |version|string|The protocol version <major>.<minor>| *Example:* {"id":1,"type":2,"version":"1.0"} ###### درخواست ثبت نام درخواستی که توسط نماینده در مرحله راه‌اندازی نماینده برای به دست آوردن معیارهای ارائه شده برای ثبت یک افزونه ارسال شده است. | | | |---|---| |جهت|عامل → افزونه| |پاسخ|بله| پارامترهای خاص برای ثبت درخواست ها: |نام|نوع|نظر| |---------|--------|----------| |version|string|نسخه پروتکل <major>.<minor>| *مثال:* {"id":1,"type":2," version":"1.0"} ###### Register response Plugin's response to the register request. | | | |---|---| |direction|plugin → agent| |response|n/a| Parameters specific to register responses: |Name|Type|Comments| |---------|--------|----------| |name|string|The plugin name.| |metrics|array of strings (optional)|The metrics with descriptions as used in the plugin. Returns RegisterMetrics(). Absent if error is returned.| |interfaces|uint32 (optional)|The bit mask of plugin's supported interfaces. Absent if error is returned.| |error|string (optional)|An error message returned if a plugin cannot be started. Absent, if metrics are returned.| *Examples:* {"id":2,"type":3,"metrics":["external.test", "External exporter Test."], "interfaces": 4} or {"id":2,"type":3,"error":"error message"} ###### ثبت پاسخ پاسخ پلاگین به درخواست ثبت نام. | | | |---|---| |جهت|پلاگین → عامل| |پاسخ|عدم| پارامترهای خاص برای ثبت پاسخ ها: |نام|نوع|نظر| |---------|--------|----------| |name|string|نام افزونه.| |metrics|آرایه رشته ها (اختیاری)|متریک با توضیحات همانطور که در افزونه استفاده می شود. RegisterMetrics() را برمی گرداند. در صورت برگشت خطا وجود ندارد.| |واسط|uint32 (اختیاری)|بیت ماسک رابط های پشتیبانی شده افزونه. در صورت برگشت خطا وجود ندارد.| |error|string (اختیاری)|اگر پلاگینی راه اندازی نشود، پیغام خطا برگردانده می شود. وجود ندارد، در صورت بازگشت معیارها.| *مثال ها:* {"id":2,"type":3,"metrics":["external.test", "External exporter test."], "interfaces": 4} یا {"id":2,"type":3,"error":"پیام خطا"} #### Removing hosts from host groups Remove two hosts from the given host groups. Request: ```json { "jsonrpc": "2.0", "method": "hostgroup.massremove", "params": { "groupids": [ "5", "6" ], "hostids": [ "30050", "30001" ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "groupids": [ "5", "6" ] }, "id": 1 } ``` #### حذف هاست از گروه هاستی Remove two hosts from the given host groups. Request: ```json { "jsonrpc": "2.0", "method": "hostgroup.massremove", "params": { "groupids": [ "5", "6" ], "hostids": [ "30050", "30001" ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "groupids": [ "5", "6" ] }, "id": 1 } ``` #### Removing interfaces Remove the "127.0.0.1" SNMP interface from two hosts. Request: ```json { "jsonrpc": "2.0", "method": "hostinterface.massremove", "params": { "hostids": [ "30050", "30052" ], "interfaces": { "dns": "", "ip": "127.0.0.1", "port": "161" } }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "interfaceids": [ "30069", "30070" ] }, "id": 1 } ``` #### حذف اینترفیس ها Remove the "127.0.0.1" SNMP interface from two hosts. Request: ```json { "jsonrpc": "2.0", "method": "hostinterface.massremove", "params": { "hostids": [ "30050", "30052" ], "interfaces": { "dns": "", "ip": "127.0.0.1", "port": "161" } }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "interfaceids": [ "30069", "30070" ] }, "id": 1 } ``` #### Removing templates from a group Remove two templates from group "2". Request: ```json { "jsonrpc": "2.0", "method": "template.massremove", "params": { "templateids": [ "10085", "10086" ], "groupids": "2" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "templateids": [ "10085", "10086" ] }, "id": 1 } ``` #### حذف هاست از گروه هاستی Remove two hosts from the given host groups. Request: ```json { "jsonrpc": "2.0", "method": "hostgroup.massremove", "params": { "groupids": [ "5", "6" ], "hostids": [ "30050", "30001" ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "groupids": [ "5", "6" ] }, "id": 1 } ``` #### Rename icon map Rename an icon map to "OS icons". Request: ```json { "jsonrpc": "2.0", "method": "iconmap.update", "params": { "iconmapid": "1", "name": "OS icons" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "iconmapids": [ "1" ] }, "id": 1 } ``` #### تغییر نام آیکون نقشه یک آیکون نقشه را به "آیکون سیستم عامل" تغییر نام دهید. درخواست: ``json { "jsonrpc": "2.0"، "method": "iconmap.update"، "params": { "iconmapid": "1"، "name": "OS icons" }، "auth": "038e1d7b1735c6a5436ee9eae095879e"، "id": 1 } ``` پاسخ: ``json { "jsonrpc": "2.0"، "result": { "iconmapids": [ "1" ] }، "id": 1 } ``` #### Rename image Rename image to "Cloud icon". Request: ```json { "jsonrpc": "2.0", "method": "image.update", "params": { "imageid": "2", "name": "Cloud icon" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "imageids": [ "2" ] }, "id": 1 } ``` #### تغییر نام آیکون نقشه یک آیکون نقشه را به "آیکون سیستم عامل" تغییر نام دهید. درخواست: ``json { "jsonrpc": "2.0"، "method": "iconmap.update"، "params": { "iconmapid": "1"، "name": "OS icons" }، "auth": "038e1d7b1735c6a5436ee9eae095879e"، "id": 1 } ``` پاسخ: ``json { "jsonrpc": "2.0"، "result": { "iconmapids": [ "1" ] }، "id": 1 } ``` #### Renaming a dashboard Rename a dashboard to "SQL server status". Request: ```json { "jsonrpc": "2.0", "method": "dashboard.update", "params": { "dashboardid": "2", "name": "SQL server status" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "2" ] }, "id": 1 } ``` #### تغییر نام داشبورد تغییر نام یک داشبورد به SQL server status ". Request: ```json { "jsonrpc": "2.0", "method": "dashboard.update", "params": { "dashboardid": "2", "name": "SQL server status" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "2" ] }, "id": 1 } ``` #### Renaming a host group Rename a host group to "Linux hosts." Request: ```json { "jsonrpc": "2.0", "method": "hostgroup.update", "params": { "groupid": "7", "name": "Linux hosts" }, "auth": "700ca65537074ec963db7efabda78259", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "groupids": [ "7" ] }, "id": 1 } ``` #### تغییر نام گروه هاستی Rename a host group to "Linux hosts." Request: ```json { "jsonrpc": "2.0", "method": "hostgroup.update", "params": { "groupid": "7", "name": "Linux hosts" }, "auth": "700ca65537074ec963db7efabda78259", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "groupids": [ "7" ] }, "id": 1 } ``` #### Renaming a template dashboard Rename a template dashboard to "Performance graphs". Request: ```json { "jsonrpc": "2.0", "method": "templatedashboard.update", "params": { "dashboardid": "23", "name": "Performance graphs" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "23" ] }, "id": 1 } ``` #### تغییر نام داشبورد تغییر نام یک داشبورد به SQL server status ". Request: ```json { "jsonrpc": "2.0", "method": "dashboard.update", "params": { "dashboardid": "2", "name": "SQL server status" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "2" ] }, "id": 1 } ``` #### Replace conditions, but keep the evaluation method Request: ```json { "jsonrpc": "2.0", "method": "correlation.update", "params": { "correlationid": "1", "filter": { "conditions": [ { "type": 3, "oldtag": "error", "newtag": "ok" } ] } }, "auth": "343baad4f88b4106b9b5961e77437688", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "correlationids": [ "1" ] }, "id": 1 } ``` #### شرایط را جایگزین کنید، اما روش ارزیابی را حفظ کنید درخواست: ``json { "jsonrpc": "2.0"، "روش": "correlation.update"، "params": { "همبستگی": "1"، "فیلتر": { "شرایط": [ { "نوع": 3، "oldtag": "خطا"، "نیوتگ": "خوب" } ] } }، "auth": "343baad4f88b4106b9b5961e77437688", "id": 1 } ``` واکنش: ``json { "jsonrpc": "2.0"، "نتیجه": { "همبستگی ها": [ "1" ] }، "id": 1 } ``` #### Replacing host interfaces Replace all host interfaces with a single agent interface. Request: ```json { "jsonrpc": "2.0", "method": "hostinterface.replacehostinterfaces", "params": { "hostid": "30052", "interfaces": { "dns": "", "ip": "127.0.0.1", "main": 1, "port": "10050", "type": 1, "useip": 1 } }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "interfaceids": [ "30081" ] }, "id": 1 } ``` #### جایگزینی هاست های اینترفیس Replace all host interfaces with a single agent interface. Request: ```json { "jsonrpc": "2.0", "method": "hostinterface.replacehostinterfaces", "params": { "hostid": "30052", "interfaces": { "dns": "", "ip": "127.0.0.1", "main": 1, "port": "10050", "type": 1, "useip": 1 } }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "interfaceids": [ "30081" ] }, "id": 1 } ``` #### Replacing hosts and templates in a host group Replace all hosts in a host group to ones mentioned host and unlink all templates from host group. Request: ```json { "jsonrpc": "2.0", "method": "hostgroup.massupdate", "params": { "groups": [ { "groupid": "6" } ], "hosts": [ { "hostid": "30050" } ], "templates": [] }, "auth": "f223adf833b2bf2ff38574a67bba6372", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "groupids": [ "6", ] }, "id": 1 } ``` #### جیگزینی هاست و قالب و در گروه هاستی Replace all hosts in a host group to ones mentioned host and unlink all templates from host group. Request: ```json { "jsonrpc": "2.0", "method": "hostgroup.massupdate", "params": { "groups": [ { "groupid": "6" } ], "hosts": [ { "hostid": "30050" } ], "templates": [] }, "auth": "f223adf833b2bf2ff38574a67bba6372", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "groupids": [ "6", ] }, "id": 1 } ``` #### Replacing trigger prototype tags Replace tags for one trigger prototype. Request: ```json { "jsonrpc": "2.0", "method": "triggerprototype.update", "params": { "triggerid": "17373", "tags": [ { "tag": "volume", "value": "{#FSNAME}" }, { "tag": "type", "value": "{#FSTYPE}" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "triggerids": [ "17373" ] }, "id": 1 } ``` #### به روز رسانی تگ نمونه اولیه هاست Replace host prototype tags with new ones. Request: ```json { "jsonrpc": "2.0", "method": "hostprototype.update", "params": { "hostid": "10092", "tags": [ { "tag": "Datacenter", "value": "{#DATACENTER.NAME}" }, { "tag": "Instance type", "value": "{#INSTANCE_TYPE}" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "hostids": [ "10092" ] }, "id": 1 } ``` #### Replacing triggers tags Replace tags for trigger. Request: ```json { "jsonrpc": "2.0", "method": "trigger.update", "params": { "triggerid": "13938", "tags": [ { "tag": "service", "value": "{{ITEM.VALUE}.regsub(\"Service (.*) has stopped\", \"\\1\")}" }, { "tag": "error", "value": "" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "triggerids": [ "13938" ] }, "id": 1 } ``` #### به روز رسانی تگ نمونه اولیه هاست Replace host prototype tags with new ones. Request: ```json { "jsonrpc": "2.0", "method": "hostprototype.update", "params": { "hostid": "10092", "tags": [ { "tag": "Datacenter", "value": "{#DATACENTER.NAME}" }, { "tag": "Instance type", "value": "{#INSTANCE_TYPE}" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "hostids": [ "10092" ] }, "id": 1 } ``` # report.create # ساخت هاست # report.delete #حذف هاست Request: ```json { "jsonrpc": "2.0", "method": "sla.create", "params": [ { "name": "Database Uptime", "slo": "99.9995", "period": "1", "timezone": "America/Toronto", "description": "Provide excellent uptime for main database engines.", "effective_date": 1672444800, "status": 1, "schedule": [ { "period_from": 0, "period_to": 601200 } ], "service_tags": [ { "tag": "Database", "operator": "0", "value": "MySQL" }, { "tag": "Database", "operator": "0", "value": "PostgreSQL" } ], "excluded_downtimes": [ { "name": "Software version upgrade rollout", "period_from": "1648760400", "period_to": "1648764900" } ] } ], "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "slaids": [ "5" ] }, "id": 1 } ``` درخواست: ``json { "jsonrpc": "2.0"، "روش": "sla.create"، "پارامز": [ { "name": "Database Uptime", "slo": "99.9995"، "دوره 1"، "منطقه زمانی": "آمریکا/تورنتو"، "description": "ارائه آپتایم عالی برای موتورهای پایگاه داده اصلی."، "تاریخ_اجرا": 1672444800، "وضعیت": 1، "برنامه": [ { "period_from": 0، "دوره_تا": 601200 } ]، "service_tags": [ { "برچسب": "پایگاه داده"، "اپراتور": "0"، "value": "MySQL" }، { "برچسب": "پایگاه داده"، "اپراتور": "0"، "value": "PostgreSQL" } ]، "excluded_downtimes": [ { "name": "نسخه ارتقاء نرم افزار عرضه شد"، "period_from": "1648760400"، "period_to": "1648764900" } ] } ]، "auth": "038e1d7b1735c6a5436ee9eae095879e"، "id": 1 } ``` واکنش: ``json { "jsonrpc": "2.0"، "نتیجه": { "slaids": [ "5" ] }، "id": 1 } ``` ### Reserved ID value "0" Reserved ID value "0" can be used to filter elements and to remove referenced objects. For example, to remove a referenced proxy from a host, proxy\_hostid should be set to 0 ("proxy\_hostid": "0") or to filter hosts monitored by server option proxyids should be set to 0 ("proxyids": "0"). ### مقدار شناسه رزرو شده "0" از مقدار شناسه رزرو شده "0" می توان برای فیلتر کردن عناصر و حذف اشیاء ارجاع شده استفاده کرد به عنوان مثال، برای حذف یک پراکسی ارجاع شده از a میزبان، پروکسی\_hostid باید روی 0 ("proxy\_hostid": "0") یا به میزبان های فیلتر که توسط پروکسی های گزینه سرور نظارت می شوند باید روی 0 تنظیم شوند ("proxyids": "0"). #### Retrieve alerts by action ID Retrieve all alerts generated by action "3". Request: ```json { "jsonrpc": "2.0", "method": "alert.get", "params": { "output": "extend", "actionids": "3" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "alertid": "1", "actionid": "3", "eventid": "21243", "userid": "1", "clock": "1362128008", "mediatypeid": "1", "sendto": "support@company.com", "subject": "PROBLEM: Zabbix agent on Linux server is unreachable for 5 minutes: ", "message": "Trigger: Zabbix agent on Linux server is unreachable for 5 minutes: \nTrigger status: PROBLEM\nTrigger severity: Not classified", "status": "0", "retries": "3", "error": "", "esc_step": "1", "alerttype": "0", "p_eventid": "0", "acknowledgeid": "0" } ], "id": 1 } ``` #### هشدارها را با شناسه اقدام بازیابی کنید همه هشدارهای ایجاد شده توسط عمل "3" را بازیابی کنید. درخواست: ``json { "jsonrpc": "2.0"، "روش": "alert.get"، "params": { "output": "extend" "actionids": "3" }، "auth": "038e1d7b1735c6a5436ee9eae095879e"، "id": 1 } ``` واکنش: ``json { "jsonrpc": "2.0"، "نتیجه": [ { "هشدار": "1"، "actionid": "3"، "eventid": "21243", "userid": "1"، "ساعت": "1362128008", "mediatypeid": "1"، "sendto": "support@company.com"، "subject": "مشکل: عامل Zabbix در سرور لینوکس به مدت 5 دقیقه غیر قابل دسترس است: "، "پیام": "تریگر: عامل Zabbix در سرور لینوکس به مدت 5 دقیقه غیرقابل دسترسی است: \nوضعیت ماشه: مشکل\nشدت محرک: طبقه بندی نشده است" "وضعیت": "0"، "تکرار مجدد": "3"، "خطا": ""، "esc_step": "1"، "نوع هشدار": "0"، "p_eventid": "0"، "acknowlgeid": "0" } ]، "id": 1 } ``` #### Retrieve all discovery rules Retrieve all configured discovery rules and the discovery checks they use. Request: ```json { "jsonrpc": "2.0", "method": "drule.get", "params": { "output": "extend", "selectDChecks": "extend" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "druleid": "2", "proxy_hostid": "0", "name": "Local network", "iprange": "192.168.3.1-255", "delay": "5s", "nextcheck": "1348754327", "status": "0", "dchecks": [ { "dcheckid": "7", "druleid": "2", "type": "3", "key_": "", "snmp_community": "", "ports": "21", "snmpv3_securityname": "", "snmpv3_securitylevel": "0", "snmpv3_authpassphrase": "", "snmpv3_privpassphrase": "", "uniq": "0", "snmpv3_authprotocol": "0", "snmpv3_privprotocol": "0", "host_source": "1", "name_source": "0" }, { "dcheckid": "8", "druleid": "2", "type": "4", "key_": "", "snmp_community": "", "ports": "80", "snmpv3_securityname": "", "snmpv3_securitylevel": "0", "snmpv3_authpassphrase": "", "snmpv3_privpassphrase": "", "uniq": "0", "snmpv3_authprotocol": "0", "snmpv3_privprotocol": "0", "host_source": "1", "name_source": "0" } ] }, { "druleid": "6", "proxy_hostid": "0", "name": "Zabbix agent discovery", "iprange": "192.168.1.1-255", "delay": "1h", "nextcheck": "0", "status": "0", "dchecks": [ { "dcheckid": "10", "druleid": "6", "type": "9", "key_": "system.uname", "snmp_community": "", "ports": "10050", "snmpv3_securityname": "", "snmpv3_securitylevel": "0", "snmpv3_authpassphrase": "", "snmpv3_privpassphrase": "", "uniq": "0", "snmpv3_authprotocol": "0", "snmpv3_privprotocol": "0", "host_source": "2", "name_source": "3" } ] } ], "id": 1 } ``` #### دریافت تمام قوانین جست و جو Retrieve all configured discovery rules and the discovery checks they use. Request: ```json { "jsonrpc": "2.0", "method": "drule.get", "params": { "output": "extend", "selectDChecks": "extend" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "druleid": "2", "proxy_hostid": "0", "name": "Local network", "iprange": "192.168.3.1-255", "delay": "5s", "nextcheck": "1348754327", "status": "0", "dchecks": [ { "dcheckid": "7", "druleid": "2", "type": "3", "key_": "", "snmp_community": "", "ports": "21", "snmpv3_securityname": "", "snmpv3_securitylevel": "0", "snmpv3_authpassphrase": "", "snmpv3_privpassphrase": "", "uniq": "0", "snmpv3_authprotocol": "0", "snmpv3_privprotocol": "0", "host_source": "1", "name_source": "0" }, { "dcheckid": "8", "druleid": "2", "type": "4", "key_": "", "snmp_community": "", "ports": "80", "snmpv3_securityname": "", "snmpv3_securitylevel": "0", "snmpv3_authpassphrase": "", "snmpv3_privpassphrase": "", "uniq": "0", "snmpv3_authprotocol": "0", "snmpv3_privprotocol": "0", "host_source": "1", "name_source": "0" } ] }, { "druleid": "6", "proxy_hostid": "0", "name": "Zabbix agent discovery", "iprange": "192.168.1.1-255", "delay": "1h", "nextcheck": "0", "status": "0", "dchecks": [ { "dcheckid": "10", "druleid": "6", "type": "9", "key_": "system.uname", "snmp_community": "", "ports": "10050", "snmpv3_securityname": "", "snmpv3_securitylevel": "0", "snmpv3_authpassphrase": "", "snmpv3_privpassphrase": "", "uniq": "0", "snmpv3_authprotocol": "0", "snmpv3_privprotocol": "0", "host_source": "2", "name_source": "3" } ] } ], "id": 1 } ``` #### Retrieve an icon map Retrieve all data about icon map "3". Request: ```json { "jsonrpc": "2.0", "method": "iconmap.get", "params": { "iconmapids": "3", "output": "extend", "selectMappings": "extend" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "mappings": [ { "iconmappingid": "3", "iconmapid": "3", "iconid": "6", "inventory_link": "1", "expression": "server", "sortorder": "0" }, { "iconmappingid": "4", "iconmapid": "3", "iconid": "10", "inventory_link": "1", "expression": "switch", "sortorder": "1" } ], "iconmapid": "3", "name": "Host type icons", "default_iconid": "2" } ], "id": 1 } ``` #### دریافت آیکون مپ Retrieve all data about icon map "3". Request: ```json { "jsonrpc": "2.0", "method": "iconmap.get", "params": { "iconmapids": "3", "output": "extend", "selectMappings": "extend" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "mappings": [ { "iconmappingid": "3", "iconmapid": "3", "iconid": "6", "inventory_link": "1", "expression": "server", "sortorder": "0" }, { "iconmappingid": "4", "iconmapid": "3", "iconid": "10", "inventory_link": "1", "expression": "switch", "sortorder": "1" } ], "iconmapid": "3", "name": "Host type icons", "default_iconid": "2" } ], "id": 1 } ``` #### Retrieve an image Retrieve all data for image with ID "2". Request: ```json { "jsonrpc": "2.0", "method": "image.get", "params": { "output": "extend", "select_image": true, "imageids": "2" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "imageid": "2", "imagetype": "1", "name": "Cloud_(24)", "image": "iVBORw0KGgoAAAANSUhEUgAAABgAAAANCAYAAACzbK7QAAAABHNCSVQICAgIfAhkiAAAAAlwSFlzAAACmAAAApgBNtNH3wAAABl0RVh0U29mdHdhcmUAd3d3Lmlua3NjYXBlLm9yZ5vuPBoAAAIcSURBVDjLrZLbSxRRHMdPKiEiRQ89CD0s+N5j9BIMEf4Hg/jWexD2ZEXQbC9tWUFZimtLhswuZiVujK1UJmYXW9PaCUdtb83enL3P7s6ss5f5dc7EUsmqkPuFH3M4/Ob7+V0OAgC0UyDENFEU03rh1uNOs/lFG75o2i2/rkd9Y3Tgyj3HiaezbukdH9A/rP4E9vWi0u+Y4fuGnMf3DRgYc3Z/84YrQSkD3mgKhFAC+KAEK74Y2Lj3MjPoOokQ3Xyx/1GHeXCifbfO6lRPH/wi+AvZQhGSsgKxdB5CCRkCGPbDgMXBMbukTc4vK5/WRHizsq7fZl2LFuvE4T0BZDTXHtgv4TNUqlUolsqQL2qQwbDEXzBBTIJ7I4y/cfAENmHZF4XrY9Mc+X9HAFmoyXS2ddy1IOg6/KNyBcM0DFP/wFZFCcOy4N9Mw0YkCTOfhdL5AfZQXQBFn2t/ODXHC8FYVcoWjNEQ03qqwTJ5FdI44jg/msoB2Zd5ZKq3q6evA1FUS60bYyyj3AJf3V72HiLZJQxTtRLk1C2IYEg4mTNg63hPd1mOJd7Ict911OMNlWEf0nFxpCt16zcshTuLpGSwDDuPIfv0xzNyQYVGicC0cgUUDLM6Xp02lvvW/V2EBssnxlSGmWsxljw0znV9XfPLjTCW84r+cn7Jc8c2eWrbM6Wbe6/aTJbhJ/TNkWc9/xXW592Xb9iPkKnUfH8BKdLgFy0lDyQAAAAASUVORK5CYII=" } ], "id": 1 } ``` بازیابی همه داده ها برای تصویر با شناسه "2". درخواست:```json{"jsonrpc": "2.0"، "method": "image.get"، "params": {"output": "extend"،" select_image": true,"imageids": "2"},"auth": "038e1d7b1735c6a5436ee9eae095879e","id": 1}```پاسخ:```json{"jsonrpc": "2.0"،"نتیجه": [{"imageid": "2"،"imagetype": "1"،"name": "Cloud_(24)"،"image": "iVBORw0KGgoAAAANSUhEUgAAABgAAAANCAYAAACzbK7QAAAABHNCSVQICAgIfAhkiAAAAAAlwSAFAH00Az mdHdhcmUAd3d3Lmlua3NjYXBlLm9yZ5vuPBoAAAIcSURBVDjLrZLbSxRRHMdPKiEiRQ89CD0s+N5j9BIMEf4Hg/jWexD2ZEXQbC9tWUFZimtLhsJKW1PuZiLhsJKW1Pa3Lhsqw1006Lhs100000000000000000000001 ss5f5dc7EUsmqkPuFH3M4/Ob7+V0OAgC0UyDENFEU03rh1uNOs/lFG75o2i2/rkd9Y3Tgyj3HiaezbukdH9A/rP4E9vWi0u+ Y4fuGnMf3DRgYc3Z/84YrQSkD3mgKhFAC+KAEK74Y2Lj3MjPoOokQ3Xyx/1GHeXCifbfO6lRPH/wi+AvZQhGSsgKxdB5CCRkCGPbDgMXHBvKlTuKT BZDTXHtgv4TNUqlUolsqQL2qQwbDEXzBBTIJ7I4y/cfAENmHZF4XrY9Mc+X9HAFmoyXS2ddy1IOg6/KNyBcM0DFP/wFZFCcOy4N9MwZQDQYKF/wFZFCcOy4N9MwZQDQYKF WjNEQ03qqwTJ5FdI44jg/msoB2Zd5ZKq3q6evA1FUS60bYyyj3AJf3V72HiLZJQxTtRLk1C2IYEg4mTNg63hPd1mOJd7Ict911OMNzpWEFUS60bYyyj3AJf3V72HiLZJQxTtRLk1C2IYEg4mTNg63hPd1mOJd7Ict911OMNzpWEFUS60 NyQYVGicC0cgUUDLM6Xp02lvvW/V2EBssnxlSGmWsxljw0znV9XfPLjTCW84r+cn7Jc8c2eWrbM6Wbe6/aTJbhJ/TNkWc9/xXWHiPaaaKd SUVORK5CYII="}],"id": 1}``` #### Retrieve audit log Retrieve two latest audit log records. Request: ```json { "jsonrpc": "2.0", "method": "auditlog.get", "params": { "output": "extend", "sortfield": "clock", "sortorder": "DESC", "limit": 2 }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "auditid": "cksstgfam0001yhdcc41y20q2", "userid": "1", "username": "Admin", "clock": "1629975715", "ip": "127.0.0.1", "action": "1", "resourcetype": "0", "resourceid": "0", "resourcename": "Jim", "recordsetid": "cksstgfal0000yhdcso67ondl", "details": "{\"user.name\":[\"update\",\"Jim\",\"\"],\"user.medias[37]\":[\"add\"],\"user.medias[37].\":[\"add\"],\"user.medias[37].mediatypeid\":[\"add\",\"1\"],\"user.medias[37].sendto\":[\"add\",\"support123@company.com\"]}" }, { "auditid": "ckssofl0p0001yhdcqxclsg8r", "userid": "1", "username": "Admin", "clock": "1629967278", "ip": "127.0.0.1", "action": "0", "resourcetype": "0", "resourceid": "20", "resourcename": "John", "recordsetid": "ckssofl0p0000yhdcpxyo1jgo", "details": "{\"user.username\":[\"add\",\"John\"], \"user.userid:\":[\"add\",\"20\"],\"user.usrgrps[28]\":[\"add\"],\"user.usrgrps[28].usrgrpid\":[\"add\", \"7\"]}" } ], "id": 1 } ``` #### گزارش حسابرسی را بازیابی کنید دو آخرین رکورد حسابرسی را بازیابی کنید. درخواست: ``json { "jsonrpc": "2.0"، "روش": "auditlog.get"، "params": { "output": "extend" "محل مرتب سازی": "ساعت"، "مرتب‌ساز": "DESC"، "حد": 2 }، "auth": "038e1d7b1735c6a5436ee9eae095879e"، "id": 1 } ``` واکنش: ``json { "jsonrpc": "2.0"، "نتیجه": [ { "auditid": "cksstgfam0001yhdcc41y20q2"، "userid": "1"، "نام کاربری": "مدیر"، "ساعت": "1629975715"، "ip": "127.0.0.1"، "عمل": "1"، "نوع منبع": "0"، "resourceid": "0", "نام منبع": "جیم"، "recordsetid": "cksstgfal0000yhdcso67ondl"، "details": "{\"user.name\":[\"update\",\"Jim\",\"\"],\"user.medias[37]\":[\"add\" ]، \"user.medias[37].\":[\"add\"]، \"user.medias[37].mediatypeid\":[\"add\",\"1\"],\ "user.medias[37].sendto\":[\"add\",\"support123@company.com\"]}" }، { "auditid": "ckssofl0p0001yhdcqxclsg8r"، "userid": "1"، "نام کاربری": "مدیر"، "ساعت": "1629967278"، "ip": "127.0.0.1"، "عمل": "0"، "نوع منبع": "0"، "resourceid": "20"، "نام منبع": "جان"، "recordsetid": "ckssofl0p0000yhdcpxyo1jgo"، "جزئیات": "{\"user.username\":[\"add\",\"John\"], \"user.userid:\":[\"add\",\"20\"] ,\"user.usrgrps[28]\":[\"add\"],\"user.usrgrps[28].usrgrpid\":[\"add\", \"7\"]}" } ]، "id": 1 } ``` #### Retrieve correlations Retrieve all configured correlations together with correlation conditions and operations. The filter uses the "and/or" evaluation type, so the `formula` property is empty and `eval_formula` is generated automatically. Request: ```json { "jsonrpc": "2.0", "method": "correlation.get", "params": { "output": "extend", "selectOperations": "extend", "selectFilter": "extend" }, "auth": "343baad4f88b4106b9b5961e77437688", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "correlationid": "1", "name": "Correlation 1", "description": "", "status": "0", "filter": { "evaltype": "0", "formula": "", "conditions": [ { "type": "3", "oldtag": "error", "newtag": "ok", "formulaid": "A" } ], "eval_formula": "A" }, "operations": [ { "type": "0" } ] } ], "id": 1 } ``` #### همبستگی ها را بازیابی کنید همه همبستگی های پیکربندی شده را همراه با همبستگی بازیابی کنید شرایط و عملیات فیلتر از نوع ارزیابی "و/یا" استفاده می کند، بنابراین ویژگی "formula" خالی است و "eval_formula" تولید می شود بطور خودکار. درخواست: ``json { "jsonrpc": "2.0"، "روش": "correlation.get"، "params": { "output": "extend" "selectOperations": "extend", "selectFilter": "extend" }، "auth": "343baad4f88b4106b9b5961e77437688"، "id": 1 } ``` واکنش: ``json { "jsonrpc": "2.0"، "نتیجه": [ { "همبستگی": "1"، "نام": "همبستگی 1"، "شرح": ""، "وضعیت": "0"، "فیلتر": { "evaltype": "0"، "فرمول": ""، "شرایط": [ { "نوع": "3"، "oldtag": "خطا"، "نیوتگ": "خوب"، "formulaid": "A" } ]، "eval_formula": "A" }، "عملیات": [ { "نوع": "0" } ] } ]، "id": 1 } ``` #### Retrieve discovered hosts by discovery rule Retrieve all hosts and the discovered services they are running that have been detected by discovery rule "4". Request: ```json { "jsonrpc": "2.0", "method": "dhost.get", "params": { "output": "extend", "selectDServices": "extend", "druleids": "4" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "dservices": [ { "dserviceid": "1", "dhostid": "1", "type": "4", "key_": "", "value": "", "port": "80", "status": "0", "lastup": "1337697227", "lastdown": "0", "dcheckid": "5", "ip": "192.168.1.1", "dns": "station.company.lan" } ], "dhostid": "1", "druleid": "4", "status": "0", "lastup": "1337697227", "lastdown": "0" }, { "dservices": [ { "dserviceid": "2", "dhostid": "2", "type": "4", "key_": "", "value": "", "port": "80", "status": "0", "lastup": "1337697234", "lastdown": "0", "dcheckid": "5", "ip": "192.168.1.4", "dns": "john.company.lan" } ], "dhostid": "2", "druleid": "4", "status": "0", "lastup": "1337697234", "lastdown": "0" }, { "dservices": [ { "dserviceid": "3", "dhostid": "3", "type": "4", "key_": "", "value": "", "port": "80", "status": "0", "lastup": "1337697234", "lastdown": "0", "dcheckid": "5", "ip": "192.168.1.26", "dns": "printer.company.lan" } ], "dhostid": "3", "druleid": "4", "status": "0", "lastup": "1337697234", "lastdown": "0" }, { "dservices": [ { "dserviceid": "4", "dhostid": "4", "type": "4", "key_": "", "value": "", "port": "80", "status": "0", "lastup": "1337697234", "lastdown": "0", "dcheckid": "5", "ip": "192.168.1.7", "dns": "mail.company.lan" } ], "dhostid": "4", "druleid": "4", "status": "0", "lastup": "1337697234", "lastdown": "0" } ], "id": 1 } ``` #### دریافت هاست های جست و جو شده با قوانین جست جو Retrieve all hosts and the discovered services they are running that have been detected by discovery rule "4". Request: ```json { "jsonrpc": "2.0", "method": "dhost.get", "params": { "output": "extend", "selectDServices": "extend", "druleids": "4" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "dservices": [ { "dserviceid": "1", "dhostid": "1", "type": "4", "key_": "", "value": "", "port": "80", "status": "0", "lastup": "1337697227", "lastdown": "0", "dcheckid": "5", "ip": "192.168.1.1", "dns": "station.company.lan" } ], "dhostid": "1", "druleid": "4", "status": "0", "lastup": "1337697227", "lastdown": "0" }, { "dservices": [ { "dserviceid": "2", "dhostid": "2", "type": "4", "key_": "", "value": "", "port": "80", "status": "0", "lastup": "1337697234", "lastdown": "0", "dcheckid": "5", "ip": "192.168.1.4", "dns": "john.company.lan" } ], "dhostid": "2", "druleid": "4", "status": "0", "lastup": "1337697234", "lastdown": "0" }, { "dservices": [ { "dserviceid": "3", "dhostid": "3", "type": "4", "key_": "", "value": "", "port": "80", "status": "0", "lastup": "1337697234", "lastdown": "0", "dcheckid": "5", "ip": "192.168.1.26", "dns": "printer.company.lan" } ], "dhostid": "3", "druleid": "4", "status": "0", "lastup": "1337697234", "lastdown": "0" }, { "dservices": [ { "dserviceid": "4", "dhostid": "4", "type": "4", "key_": "", "value": "", "port": "80", "status": "0", "lastup": "1337697234", "lastdown": "0", "dcheckid": "5", "ip": "192.168.1.7", "dns": "mail.company.lan" } ], "dhostid": "4", "druleid": "4", "status": "0", "lastup": "1337697234", "lastdown": "0" } ], "id": 1 } ``` #### Retrieve discovery actions Retrieve all configured discovery actions together with action conditions and operations. The filter uses the "and" evaluation type, so the `formula` property is empty and `eval_formula` is generated automatically. Request: ```json { "jsonrpc": "2.0", "method": "action.get", "params": { "output": "extend", "selectOperations": "extend" "selectFilter": "extend", "filter": { "eventsource": 1 } }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "actionid": "2", "name": "Auto discovery. Linux servers.", "eventsource": "1", "status": "1", "esc_period": "0s", "pause_suppressed": "1", "filter": { "evaltype": "0", "formula": "", "conditions": [ { "conditiontype": "10", "operator": "0", "value": "0", "value2": "", "formulaid": "B" }, { "conditiontype": "8", "operator": "0", "value": "9", "value2": "", "formulaid": "C" }, { "conditiontype": "12", "operator": "2", "value": "Linux", "value2": "", "formulaid": "A" } ], "eval_formula": "A and B and C" }, "operations": [ { "operationid": "1", "actionid": "2", "operationtype": "6", "esc_period": "0s", "esc_step_from": "1", "esc_step_to": "1", "evaltype": "0", "opconditions": [], "optemplate": [ { "templateid": "10001" } ] }, { "operationid": "2", "actionid": "2", "operationtype": "4", "esc_period": "0s", "esc_step_from": "1", "esc_step_to": "1", "evaltype": "0", "opconditions": [], "opgroup": [ { "groupid": "2" } ] } ] } ], "id": 1 } ``` #### اقدامات کشف را بازیابی کنید همه اقدامات کشف پیکربندی شده را همراه با عمل بازیابی کنید شرایط و عملیات فیلتر از نوع ارزیابی "و" استفاده می کند، بنابراین ویژگی "formula" خالی است و "eval_formula" ایجاد می شود بطور خودکار. درخواست: ``json { "jsonrpc": "2.0"، "روش": "action.get"، "params": { "output": "extend" "selectOperations": "extend" "selectFilter": "extend", "فیلتر": { "منبع رویداد": 1 } }، "auth": "038e1d7b1735c6a5436ee9eae095879e"، "id": 1 } ``` واکنش: ``json { "jsonrpc": "2.0"، "نتیجه": [ { "actionid": "2"، "name": "کشف خودکار. سرورهای لینوکس."، "منبع رویداد": "1"، "وضعیت": "1"، "esc_period": "0s"، "pause_suppressed": "1"، "فیلتر": { "evaltype": "0"، "فرمول": ""، "شرایط": [ { "شرایط نوع": "10"، "اپراتور": "0"، "ارزش": "0"، "value2": "", "formulaid": "B" }، { "conditiontype": "8"، "اپراتور": "0"، "ارزش": "9"، "value2": "", "formulaid": "C" }، { "conditiontype": "12"، "اپراتور": "2"، "ارزش": "لینوکس"، "value2": "", "formulaid": "A" } ]، "eval_formula": "A و B و C" }، "عملیات": [ { "operationid": "1"، "actionid": "2"، "نوع عملیات": "6"، "esc_period": "0s"، "esc_step_from": "1"، "esc_step_to": "1"، "evaltype": "0"، "شرایط": []، "نمونه": [ { "templateid": "10001" } ] }، { "operationid": "2"، "actionid": "2"، "نوع عملیات": "4"، "esc_period": "0s"، "esc_step_from": "1"، "esc_step_to": "1"، "evaltype": "0"، "شرایط": []، "opgroup": [ { "گروهی": "2" } ] } ] } ]، "id": 1 } ``` #### Retrieve discovery checks for a discovery rule Retrieve all discovery checks used by discovery rule "6". Request: ```json { "jsonrpc": "2.0", "method": "dcheck.get", "params": { "output": "extend", "dcheckids": "6" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "dcheckid": "6", "druleid": "4", "type": "3", "key_": "", "snmp_community": "", "ports": "21", "snmpv3_securityname": "", "snmpv3_securitylevel": "0", "snmpv3_authpassphrase": "", "snmpv3_privpassphrase": "", "uniq": "0", "snmpv3_authprotocol": "0", "snmpv3_privprotocol": "0", "host_source": "1", "name_source": "0" } ], "id": 1 } ``` #### دریافت بررسی های جست و جو برای قوانین جست و جو Retrieve all discovery checks used by discovery rule "6". Request: ```json { "jsonrpc": "2.0", "method": "dcheck.get", "params": { "output": "extend", "dcheckids": "6" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "dcheckid": "6", "druleid": "4", "type": "3", "key_": "", "snmp_community": "", "ports": "21", "snmpv3_securityname": "", "snmpv3_securitylevel": "0", "snmpv3_authpassphrase": "", "snmpv3_privpassphrase": "", "uniq": "0", "snmpv3_authprotocol": "0", "snmpv3_privprotocol": "0", "host_source": "1", "name_source": "0" } ], "id": 1 } ``` #### Retrieve LLD rule by URL Retrieve LLD rule for host by rule URL field value. Only exact match of URL string defined for LLD rule is supported. Request: ```json { "jsonrpc": "2.0", "method": "discoveryrule.get", "params": { "hostids": "10257", "filter": { "type": 19, "url": "http://127.0.0.1/discoverer.php" } }, "id": 39, "auth": "d678e0b85688ce578ff061bd29a20d3b" } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "itemid": "28336", "type": "19", "snmp_oid": "", "hostid": "10257", "name": "API HTTP agent", "key_": "api_discovery_rule", "delay": "5s", "status": "0", "trapper_hosts": "", "templateid": "0", "valuemapid": "0", "params": "", "ipmi_sensor": "", "authtype": "0", "username": "", "password": "", "publickey": "", "privatekey": "", "interfaceid": "5", "description": "", "lifetime": "30d", "jmx_endpoint": "", "master_itemid": "0", "timeout": "3s", "url": "http://127.0.0.1/discoverer.php", "query_fields": [ { "mode": "json" }, { "elements": "2" } ], "posts": "", "status_codes": "200", "follow_redirects": "1", "post_type": "0", "http_proxy": "", "headers": { "X-Type": "api", "Authorization": "Bearer mF_A.B5f-2.1JcM" }, "retrieve_mode": "0", "request_method": "1", "ssl_cert_file": "", "ssl_key_file": "", "ssl_key_password": "", "verify_peer": "0", "verify_host": "0", "allow_traps": "0", "uuid": "", "state": "0", "error": "", "parameters": [] } ], "id": 39 } ``` #### دریافت قانون LLD به وسیله URL Retrieve LLD rule for host by rule URL field value. Only exact match of URL string defined for LLD rule is supported. Request: ```json { "jsonrpc": "2.0", "method": "discoveryrule.get", "params": { "hostids": "10257", "filter": { "type": 19, "url": "http://127.0.0.1/discoverer.php" } }, "id": 39, "auth": "d678e0b85688ce578ff061bd29a20d3b" } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "itemid": "28336", "type": "19", "snmp_oid": "", "hostid": "10257", "name": "API HTTP agent", "key_": "api_discovery_rule", "delay": "5s", "status": "0", "trapper_hosts": "", "templateid": "0", "valuemapid": "0", "params": "", "ipmi_sensor": "", "authtype": "0", "username": "", "password": "", "publickey": "", "privatekey": "", "interfaceid": "5", "description": "", "lifetime": "30d", "jmx_endpoint": "", "master_itemid": "0", "timeout": "3s", "url": "http://127.0.0.1/discoverer.php", "query_fields": [ { "mode": "json" }, { "elements": "2" } ], "posts": "", "status_codes": "200", "follow_redirects": "1", "post_type": "0", "http_proxy": "", "headers": { "X-Type": "api", "Authorization": "Bearer mF_A.B5f-2.1JcM" }, "retrieve_mode": "0", "request_method": "1", "ssl_cert_file": "", "ssl_key_file": "", "ssl_key_password": "", "verify_peer": "0", "verify_host": "0", "allow_traps": "0", "uuid": "", "state": "0", "error": "", "parameters": [] } ], "id": 39 } ``` #### Retrieve LLD rule with overrides Retrieve one LLD rule that has various override settings. Request: ```json { "jsonrpc": "2.0", "method": "discoveryrule.get", "params": { "output": ["name"], "itemids": "30980", "selectOverrides": ["name", "step", "stop", "filter", "operations"] }, "id": 39, "auth": "d678e0b85688ce578ff061bd29a20d3b" } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "name": "Discover database host", "overrides": [ { "name": "Discover MySQL host", "step": "1", "stop": "1", "filter": { "evaltype": "2", "formula": "", "conditions": [ { "macro": "{#UNIT.NAME}", "operator": "8", "value": "^mysqld\\.service$", "formulaid": "A" }, { "macro": "{#UNIT.NAME}", "operator": "8", "value": "^mariadb\\.service$", "formulaid": "B" } ], "eval_formula": "A or B" }, "operations": [ { "operationobject": "3", "operator": "2", "value": "Database host", "opstatus": { "status": "0" }, "optag": [ { "tag": "Database", "value": "MySQL" } ], "optemplate": [ { "templateid": "10170" } ] } ] }, { "name": "Discover PostgreSQL host", "step": "2", "stop": "1", "filter": { "evaltype": "0", "formula": "", "conditions": [ { "macro": "{#UNIT.NAME}", "operator": "8", "value": "^postgresql\\.service$", "formulaid": "A" } ], "eval_formula": "A" }, "operations": [ { "operationobject": "3", "operator": "2", "value": "Database host", "opstatus": { "status": "0" }, "optag": [ { "tag": "Database", "value": "PostgreSQL" } ], "optemplate": [ { "templateid": "10263" } ] } ] } ] } ], "id": 39 } ``` #### دریافت یک قانون LLD به همراه تکرار Retrieve one LLD rule that has various override settings. Request: ```json { "jsonrpc": "2.0", "method": "discoveryrule.get", "params": { "output": ["name"], "itemids": "30980", "selectOverrides": ["name", "step", "stop", "filter", "operations"] }, "id": 39, "auth": "d678e0b85688ce578ff061bd29a20d3b" } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "name": "Discover database host", "overrides": [ { "name": "Discover MySQL host", "step": "1", "stop": "1", "filter": { "evaltype": "2", "formula": "", "conditions": [ { "macro": "{#UNIT.NAME}", "operator": "8", "value": "^mysqld\\.service$", "formulaid": "A" }, { "macro": "{#UNIT.NAME}", "operator": "8", "value": "^mariadb\\.service$", "formulaid": "B" } ], "eval_formula": "A or B" }, "operations": [ { "operationobject": "3", "operator": "2", "value": "Database host", "opstatus": { "status": "0" }, "optag": [ { "tag": "Database", "value": "MySQL" } ], "optemplate": [ { "templateid": "10170" } ] } ] }, { "name": "Discover PostgreSQL host", "step": "2", "stop": "1", "filter": { "evaltype": "0", "formula": "", "conditions": [ { "macro": "{#UNIT.NAME}", "operator": "8", "value": "^postgresql\\.service$", "formulaid": "A" } ], "eval_formula": "A" }, "operations": [ { "operationobject": "3", "operator": "2", "value": "Database host", "opstatus": { "status": "0" }, "optag": [ { "tag": "Database", "value": "PostgreSQL" } ], "optemplate": [ { "templateid": "10263" } ] } ] } ] } ], "id": 39 } ``` #### Retrieve services discovered on a host Retrieve all discovered services detected on discovered host "11". Request: ```json { "jsonrpc": "2.0", "method": "dservice.get", "params": { "output": "extend", "dhostids": "11" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "dserviceid": "12", "dhostid": "11", "value": "", "port": "80", "status": "1", "lastup": "0", "lastdown": "1348650607", "dcheckid": "5", "ip": "192.168.1.134", "dns": "john.local" }, { "dserviceid": "13", "dhostid": "11", "value": "", "port": "21", "status": "1", "lastup": "0", "lastdown": "1348650610", "dcheckid": "6", "ip": "192.168.1.134", "dns": "john.local" } ], "id": 1 } ``` #### دریافت سرویس های جست و جو شده بر روی هاست Retrieve all discovered services detected on discovered host "11". Request: ```json { "jsonrpc": "2.0", "method": "dservice.get", "params": { "output": "extend", "dhostids": "11" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "dserviceid": "12", "dhostid": "11", "value": "", "port": "80", "status": "1", "lastup": "0", "lastdown": "1348650607", "dcheckid": "5", "ip": "192.168.1.134", "dns": "john.local" }, { "dserviceid": "13", "dhostid": "11", "value": "", "port": "21", "status": "1", "lastup": "0", "lastdown": "1348650610", "dcheckid": "6", "ip": "192.168.1.134", "dns": "john.local" } ], "id": 1 } ``` #### Retrieve trigger actions Retrieve all configured trigger actions together with action conditions and operations. Request: ```json { "jsonrpc": "2.0", "method": "action.get", "params": { "output": "extend", "selectOperations": "extend", "selectRecoveryOperations": "extend", "selectUpdateOperations": "extend", "selectFilter": "extend", "filter": { "eventsource": 0 } }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "actionid": "3", "name": "Report problems to Zabbix administrators", "eventsource": "0", "status": "1", "esc_period": "1h", "pause_suppressed": "1", "filter": { "evaltype": "0", "formula": "", "conditions": [], "eval_formula": "" }, "operations": [ { "operationid": "3", "actionid": "3", "operationtype": "0", "esc_period": "0", "esc_step_from": "1", "esc_step_to": "1", "evaltype": "0", "opconditions": [], "opmessage": [ { "default_msg": "1", "subject": "", "message": "", "mediatypeid" => "0" } ], "opmessage_grp": [ { "usrgrpid": "7" } ] } ], "recovery_operations": [ { "operationid": "7", "actionid": "3", "operationtype": "11", "evaltype": "0", "opconditions": [], "opmessage": { "default_msg": "0", "subject": "{TRIGGER.STATUS}: {TRIGGER.NAME}", "message": "Trigger: {TRIGGER.NAME}\r\nTrigger status: {TRIGGER.STATUS}\r\nTrigger severity: {TRIGGER.SEVERITY}\r\nTrigger URL: {TRIGGER.URL}\r\n\r\nItem values:\r\n\r\n1. {ITEM.NAME1} ({HOST.NAME1}:{ITEM.KEY1}): {ITEM.VALUE1}\r\n2. {ITEM.NAME2} ({HOST.NAME2}:{ITEM.KEY2}): {ITEM.VALUE2}\r\n3. {ITEM.NAME3} ({HOST.NAME3}:{ITEM.KEY3}): {ITEM.VALUE3}\r\n\r\nOriginal event ID: {EVENT.ID}", "mediatypeid": "0" } } ], "update_operations": [ { "operationid": "31", "operationtype": "12", "evaltype": "0", "opmessage": { "default_msg": "1", "subject": "", "message": "", "mediatypeid": "0" } }, { "operationid": "32", "operationtype": "0", "evaltype": "0", "opmessage": { "default_msg": "0", "subject": "Updated: {TRIGGER.NAME}", "message": "{USER.FULLNAME} updated problem at {EVENT.UPDATE.DATE} {EVENT.UPDATE.TIME} with the following message:\r\n{EVENT.UPDATE.MESSAGE}\r\n\r\nCurrent problem status is {EVENT.STATUS}", "mediatypeid": "1" }, "opmessage_grp": [ { "usrgrpid": "7" } ], "opmessage_usr": [] }, { "operationid": "33", "operationtype": "1", "evaltype": "0", "opcommand": { "scriptid": "3" }, "opcommand_hst": [ { "hostid": "10084" } ], "opcommand_grp": [] } ] } ], "id": 1 } ``` #### بازیابی اکشن تریگرها بازیابی تمام تنظیمات اکشن تریگرها به همراه شرایط و عملیات آن ها Request: ```json { "jsonrpc": "2.0", "method": "action.get", "params": { "output": "extend", "selectOperations": "extend", "selectRecoveryOperations": "extend", "selectUpdateOperations": "extend", "selectFilter": "extend", "filter": { "eventsource": 0 } }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "actionid": "3", "name": "Report problems to Zabbix administrators", "eventsource": "0", "status": "1", "esc_period": "1h", "pause_suppressed": "1", "filter": { "evaltype": "0", "formula": "", "conditions": [], "eval_formula": "" }, "operations": [ { "operationid": "3", "actionid": "3", "operationtype": "0", "esc_period": "0", "esc_step_from": "1", "esc_step_to": "1", "evaltype": "0", "opconditions": [], "opmessage": [ { "default_msg": "1", "subject": "", "message": "", "mediatypeid" => "0" } ], "opmessage_grp": [ { "usrgrpid": "7" } ] } ], "recovery_operations": [ { "operationid": "7", "actionid": "3", "operationtype": "11", "evaltype": "0", "opconditions": [], "opmessage": { "default_msg": "0", "subject": "{TRIGGER.STATUS}: {TRIGGER.NAME}", "message": "Trigger: {TRIGGER.NAME}\r\nTrigger status: {TRIGGER.STATUS}\r\nTrigger severity: {TRIGGER.SEVERITY}\r\nTrigger URL: {TRIGGER.URL}\r\n\r\nItem values:\r\n\r\n1. {ITEM.NAME1} ({HOST.NAME1}:{ITEM.KEY1}): {ITEM.VALUE1}\r\n2. {ITEM.NAME2} ({HOST.NAME2}:{ITEM.KEY2}): {ITEM.VALUE2}\r\n3. {ITEM.NAME3} ({HOST.NAME3}:{ITEM.KEY3}): {ITEM.VALUE3}\r\n\r\nOriginal event ID: {EVENT.ID}", "mediatypeid": "0" } } ], "update_operations": [ { "operationid": "31", "operationtype": "12", "evaltype": "0", "opmessage": { "default_msg": "1", "subject": "", "message": "", "mediatypeid": "0" } }, { "operationid": "32", "operationtype": "0", "evaltype": "0", "opmessage": { "default_msg": "0", "subject": "Updated: {TRIGGER.NAME}", "message": "{USER.FULLNAME} updated problem at {EVENT.UPDATE.DATE} {EVENT.UPDATE.TIME} with the following message:\r\n{EVENT.UPDATE.MESSAGE}\r\n\r\nCurrent problem status is {EVENT.STATUS}", "mediatypeid": "1" }, "opmessage_grp": [ { "usrgrpid": "7" } ], "opmessage_usr": [] }, { "operationid": "33", "operationtype": "1", "evaltype": "0", "opcommand": { "scriptid": "3" }, "opcommand_hst": [ { "hostid": "10084" } ], "opcommand_grp": [] } ] } ], "id": 1 } ``` #### Retrieving a dashboard by ID Retrieve all data about dashboards "1" and "2". Request: ```json { "jsonrpc": "2.0", "method": "dashboard.get", "params": { "output": "extend", "selectPages": "extend", "selectUsers": "extend", "selectUserGroups": "extend", "dashboardids": [ "1", "2" ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "dashboardid": "1", "name": "Dashboard", "userid": "1", "private": "0", "display_period": "30", "auto_start": "1", "users": [], "userGroups": [], "pages": [ { "dashboard_pageid": "1", "name": "", "display_period": "0", "widgets": [ { "widgetid": "9", "type": "systeminfo", "name": "", "x": "12", "y": "8", "width": "12", "height": "5", "view_mode": "0", "fields": [] }, { "widgetid": "8", "type": "problemsbysv", "name": "", "x": "12", "y": "4", "width": "12", "height": "4", "view_mode": "0", "fields": [] }, { "widgetid": "7", "type": "problemhosts", "name": "", "x": "12", "y": "0", "width": "12", "height": "4", "view_mode": "0", "fields": [] }, { "widgetid": "6", "type": "discovery", "name": "", "x": "6", "y": "9", "width": "6", "height": "4", "view_mode": "0", "fields": [] }, { "widgetid": "5", "type": "web", "name": "", "x": "0", "y": "9", "width": "6", "height": "4", "view_mode": "0", "fields": [] }, { "widgetid": "4", "type": "problems", "name": "", "x": "0", "y": "3", "width": "12", "height": "6", "view_mode": "0", "fields": [] }, { "widgetid": "3", "type": "favmaps", "name": "", "x": "8", "y": "0", "width": "4", "height": "3", "view_mode": "0", "fields": [] }, { "widgetid": "1", "type": "favgraphs", "name": "", "x": "0", "y": "0", "width": "4", "height": "3", "view_mode": "0", "fields": [] } ] }, { "dashboard_pageid": "2", "name": "", "display_period": "0", "widgets": [] }, { "dashboard_pageid": "3", "name": "Custom page name", "display_period": "60", "widgets": [] } ] }, { "dashboardid": "2", "name": "My dashboard", "userid": "1", "private": "1", "display_period": "60", "auto_start": "1", "users": [ { "userid": "4", "permission": "3" } ], "userGroups": [ { "usrgrpid": "7", "permission": "2" } ], "pages": [ { "dashboard_pageid": "4", "name": "", "display_period": "0", "widgets": [ { "widgetid": "10", "type": "problems", "name": "", "x": "0", "y": "0", "width": "12", "height": "5", "view_mode": "0", "fields": [ { "type": "2", "name": "groupids", "value": "4" } ] } ] } ] } ], "id": 1 } ``` #### دسترسی به داشبورد با ID دسترسی به تمام اطلاعات داشبورد 1 و2 ". Request: ```json { "jsonrpc": "2.0", "method": "dashboard.get", "params": { "output": "extend", "selectPages": "extend", "selectUsers": "extend", "selectUserGroups": "extend", "dashboardids": [ "1", "2" ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "dashboardid": "1", "name": "Dashboard", "userid": "1", "private": "0", "display_period": "30", "auto_start": "1", "users": [], "userGroups": [], "pages": [ { "dashboard_pageid": "1", "name": "", "display_period": "0", "widgets": [ { "widgetid": "9", "type": "systeminfo", "name": "", "x": "12", "y": "8", "width": "12", "height": "5", "view_mode": "0", "fields": [] }, { "widgetid": "8", "type": "problemsbysv", "name": "", "x": "12", "y": "4", "width": "12", "height": "4", "view_mode": "0", "fields": [] }, { "widgetid": "7", "type": "problemhosts", "name": "", "x": "12", "y": "0", "width": "12", "height": "4", "view_mode": "0", "fields": [] }, { "widgetid": "6", "type": "discovery", "name": "", "x": "6", "y": "9", "width": "6", "height": "4", "view_mode": "0", "fields": [] }, { "widgetid": "5", "type": "web", "name": "", "x": "0", "y": "9", "width": "6", "height": "4", "view_mode": "0", "fields": [] }, { "widgetid": "4", "type": "problems", "name": "", "x": "0", "y": "3", "width": "12", "height": "6", "view_mode": "0", "fields": [] }, { "widgetid": "3", "type": "favmaps", "name": "", "x": "8", "y": "0", "width": "4", "height": "3", "view_mode": "0", "fields": [] }, { "widgetid": "1", "type": "favgraphs", "name": "", "x": "0", "y": "0", "width": "4", "height": "3", "view_mode": "0", "fields": [] } ] }, { "dashboard_pageid": "2", "name": "", "display_period": "0", "widgets": [] }, { "dashboard_pageid": "3", "name": "Custom page name", "display_period": "60", "widgets": [] } ] }, { "dashboardid": "2", "name": "My dashboard", "userid": "1", "private": "1", "display_period": "60", "auto_start": "1", "users": [ { "userid": "4", "permission": "3" } ], "userGroups": [ { "usrgrpid": "7", "permission": "2" } ], "pages": [ { "dashboard_pageid": "4", "name": "", "display_period": "0", "widgets": [ { "widgetid": "10", "type": "problems", "name": "", "x": "0", "y": "0", "width": "12", "height": "5", "view_mode": "0", "fields": [ { "type": "2", "name": "groupids", "value": "4" } ] } ] } ] } ], "id": 1 } ``` #### Retrieving all SLAs Retrieve all data about all SLAs and their properties. Request: ```json { "jsonrpc": "2.0", "method": "sla.get", "params": { "output": "extend", "selectSchedule": ["period_from", "period_to"], "selectExcludedDowntimes": ["name", "period_from", "period_to"], "selectServiceTags": ["tag", "operator", "value"], "preservekeys": true }, "auth": "85dd04b94cbfad794616eb923be13c71", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "1": { "slaid": "1", "name": "Database Uptime", "period": "1", "slo": "99.9995", "effective_date": "1672444800", "timezone": "America/Toronto", "status": "1", "description": "Provide excellent uptime for main SQL database engines.", "service_tags": [ { "tag": "Database", "operator": "0", "value": "MySQL" }, { "tag": "Database", "operator": "0", "value": "PostgreSQL" } ], "schedule": [ { "period_from": "0", "period_to": "601200" } ], "excluded_downtimes": [ { "name": "Software version upgrade rollout", "period_from": "1648760400", "period_to": "1648764900" } ] } }, "id": 1 } ``` #### بازیابی همه SLA ها تمام داده‌های مربوط به همه SLA و ویژگی‌های آنها را بازیابی کنید. درخواست: ``json { "jsonrpc": "2.0"، "روش": "sla.get"، "params": { "output": "extend" "selectSchedule": ["period_from"، "period_to"]، "selectExcludedDowntimes": ["name"، "period_from"، "period_to"]، "selectServiceTags": ["برچسب"، "اپراتور"، "مقدار"]، «محفظات»: درست است }، "auth": "85dd04b94cbfad794616eb923be13c71"، "id": 1 } ``` واکنش: ``json { "jsonrpc": "2.0"، "نتیجه": { "1": { "slaid": "1"، "name": "Database Uptime", "دوره 1"، "slo": "99.9995"، "تاریخ_اجرا": "1672444800"، "منطقه زمانی": "آمریکا/تورنتو"، "وضعیت": "1"، "description": "ارائه آپتایم عالی برای موتورهای اصلی پایگاه داده SQL."، "service_tags": [ { "برچسب": "پایگاه داده"، "اپراتور": "0"، "value": "MySQL" }، { "برچسب": "پایگاه داده"، "اپراتور": "0"، "value": "PostgreSQL" } ]، "برنامه": [ { "period_from": "0"، "period_to": "601200" } ]، "excluded_downtimes": [ { "name": "نسخه ارتقاء نرم افزار عرضه شد"، "period_from": "1648760400"، "period_to": "1648764900" } ] } }، "id": 1 } ``` #### Retrieving a specific trigger prototype with tags Request: ```json { "jsonrpc": "2.0", "method": "triggerprototype.get", "params": { "output": [ "triggerid", "description" ], "selectTags": "extend", "triggerids": [ "17373" ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "triggerid": "17373", "description": "Free disk space is less than 20% on volume {#FSNAME}", "tags": [ { "tag": "volume", "value": "{#FSNAME}" }, { "tag": "type", "value": "{#FSTYPE}" } ] } ], "id": 1 } ``` #### جست وجوی هاست با تگ و تمپلیت تگ Retrieve a host with tags and all tags that are linked to parent templates. Request: ```json { "jsonrpc": "2.0", "method": "host.get", "params": { "output": ["name"], "hostids": 10502, "selectTags": ["tag", "value"], "selectInheritedTags": ["tag", "value"] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "hostid": "10502", "name": "Desktop", "tags": [ { "tag": "A", "value": "1" } ], "inheritedTags": [ { "tag": "B", "value": "2" } ] } ], "id": 1 } ``` #### Retrieving a web scenario Retrieve all data about web scenario "4". Request: ```json { "jsonrpc": "2.0", "method": "httptest.get", "params": { "output": "extend", "selectSteps": "extend", "httptestids": "9" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "httptestid": "9", "name": "Homepage check", "nextcheck": "0", "delay": "1m", "status": "0", "variables": [], "agent": "Zabbix", "authentication": "0", "http_user": "", "http_password": "", "hostid": "10084", "templateid": "0", "http_proxy": "", "retries": "1", "ssl_cert_file": "", "ssl_key_file": "", "ssl_key_password": "", "verify_peer": "0", "verify_host": "0", "headers": [], "steps": [ { "httpstepid": "36", "httptestid": "9", "name": "Homepage", "no": "1", "url": "http://example.com", "timeout": "15s", "posts": "", "required": "", "status_codes": "200", "variables": [ { "name":"{var}", "value":"12" } ], "follow_redirects": "1", "retrieve_mode": "0", "headers": [], "query_fields": [] }, { "httpstepid": "37", "httptestid": "9", "name": "Homepage / About", "no": "2", "url": "http://example.com/about", "timeout": "15s", "posts": "", "required": "", "status_codes": "200", "variables": [], "follow_redirects": "1", "retrieve_mode": "0", "headers": [], "query_fields": [] } ] } ], "id": 1 } ``` #### دریافت یک وب سناریو Retrieve all data about web scenario "4". Request: ```json { "jsonrpc": "2.0", "method": "httptest.get", "params": { "output": "extend", "selectSteps": "extend", "httptestids": "9" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "httptestid": "9", "name": "Homepage check", "nextcheck": "0", "delay": "1m", "status": "0", "variables": [], "agent": "Zabbix", "authentication": "0", "http_user": "", "http_password": "", "hostid": "10084", "templateid": "0", "http_proxy": "", "retries": "1", "ssl_cert_file": "", "ssl_key_file": "", "ssl_key_password": "", "verify_peer": "0", "verify_host": "0", "headers": [], "steps": [ { "httpstepid": "36", "httptestid": "9", "name": "Homepage", "no": "1", "url": "http://example.com", "timeout": "15s", "posts": "", "required": "", "status_codes": "200", "variables": [ { "name":"{var}", "value":"12" } ], "follow_redirects": "1", "retrieve_mode": "0", "headers": [], "query_fields": [] }, { "httpstepid": "37", "httptestid": "9", "name": "Homepage / About", "no": "2", "url": "http://example.com/about", "timeout": "15s", "posts": "", "required": "", "status_codes": "200", "variables": [], "follow_redirects": "1", "retrieve_mode": "0", "headers": [], "query_fields": [] } ] } ], "id": 1 } ``` #### Retrieving data by name Retrieve all data about two host groups named "Zabbix servers" and "Linux servers". Request: ```json { "jsonrpc": "2.0", "method": "hostgroup.get", "params": { "output": "extend", "filter": { "name": [ "Zabbix servers", "Linux servers" ] } }, "auth": "6f38cddc44cfbb6c1bd186f9a220b5a0", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "groupid": "2", "name": "Linux servers", "internal": "0" }, { "groupid": "4", "name": "Zabbix servers", "internal": "0" } ], "id": 1 } ``` #### دریافت تاریخ به وسیله نام Retrieve all data about two host groups named "Zabbix servers" and "Linux servers". Request: ```json { "jsonrpc": "2.0", "method": "hostgroup.get", "params": { "output": "extend", "filter": { "name": [ "Zabbix servers", "Linux servers" ] } }, "auth": "6f38cddc44cfbb6c1bd186f9a220b5a0", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "groupid": "2", "name": "Linux servers", "internal": "0" }, { "groupid": "4", "name": "Zabbix servers", "internal": "0" } ], "id": 1 } ``` #### Retrieving data by name Retrieve all data about two hosts named "Zabbix server" and "Linux server". Request: ```json { "jsonrpc": "2.0", "method": "host.get", "params": { "filter": { "host": [ "Zabbix server", "Linux server" ] } }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "hostid": "10160", "proxy_hostid": "0", "host": "Zabbix server", "status": "0", "lastaccess": "0", "ipmi_authtype": "-1", "ipmi_privilege": "2", "ipmi_username": "", "ipmi_password": "", "maintenanceid": "0", "maintenance_status": "0", "maintenance_type": "0", "maintenance_from": "0", "name": "Zabbix server", "flags": "0", "description": "The Zabbix monitoring server.", "tls_connect": "1", "tls_accept": "1", "tls_issuer": "", "tls_subject": "", "inventory_mode": "1" }, { "hostid": "10167", "proxy_hostid": "0", "host": "Linux server", "status": "0", "lastaccess": "0", "ipmi_authtype": "-1", "ipmi_privilege": "2", "ipmi_username": "", "ipmi_password": "", "maintenanceid": "0", "maintenance_status": "0", "maintenance_type": "0", "maintenance_from": "0", "name": "Linux server", "flags": "0", "description": "", "tls_connect": "1", "tls_accept": "1", "tls_issuer": "", "tls_subject": "", "inventory_mode": "1" } ], "id": 1 } ``` #### بازگشت مقادیر به وسیله نام Retrieve all data about two hosts named "Zabbix server" and "Linux server". Request: ```json { "jsonrpc": "2.0", "method": "host.get", "params": { "filter": { "host": [ "Zabbix server", "Linux server" ] } }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "hostid": "10160", "proxy_hostid": "0", "host": "Zabbix server", "status": "0", "lastaccess": "0", "ipmi_authtype": "-1", "ipmi_privilege": "2", "ipmi_username": "", "ipmi_password": "", "maintenanceid": "0", "maintenance_status": "0", "maintenance_type": "0", "maintenance_from": "0", "name": "Zabbix server", "flags": "0", "description": "The Zabbix monitoring server.", "tls_connect": "1", "tls_accept": "1", "tls_issuer": "", "tls_subject": "", "inventory_mode": "1" }, { "hostid": "10167", "proxy_hostid": "0", "host": "Linux server", "status": "0", "lastaccess": "0", "ipmi_authtype": "-1", "ipmi_privilege": "2", "ipmi_username": "", "ipmi_password": "", "maintenanceid": "0", "maintenance_status": "0", "maintenance_type": "0", "maintenance_from": "0", "name": "Linux server", "flags": "0", "description": "", "tls_connect": "1", "tls_accept": "1", "tls_issuer": "", "tls_subject": "", "inventory_mode": "1" } ], "id": 1 } ``` #### Retrieving discovery rules from a host Retrieve all discovery rules for specific host ID. Request: ```json { "jsonrpc": "2.0", "method": "discoveryrule.get", "params": { "output": "extend", "hostids": "10202" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "itemid": "27425", "type": "0", "snmp_oid": "", "hostid": "10202", "name": "Network interface discovery", "key_": "net.if.discovery", "delay": "1h", "status": "0", "trapper_hosts": "", "templateid": "22444", "valuemapid": "0", "params": "", "ipmi_sensor": "", "authtype": "0", "username": "", "password": "", "publickey": "", "privatekey": "", "interfaceid": "119", "description": "Discovery of network interfaces as defined in global regular expression \"Network interfaces for discovery\".", "lifetime": "30d", "jmx_endpoint": "", "master_itemid": "0", "timeout": "3s", "url": "", "query_fields": [], "posts": "", "status_codes": "200", "follow_redirects": "1", "post_type": "0", "http_proxy": "", "headers": [], "retrieve_mode": "0", "request_method": "0", "ssl_cert_file": "", "ssl_key_file": "", "ssl_key_password": "", "verify_peer": "0", "verify_host": "0", "allow_traps": "0", "uuid": "", "state": "0", "error": "", "parameters": [] }, { "itemid": "27426", "type": "0", "snmp_oid": "", "hostid": "10202", "name": "Mounted filesystem discovery", "key_": "vfs.fs.discovery", "delay": "1h", "status": "0", "trapper_hosts": "", "templateid": "22450", "valuemapid": "0", "params": "", "ipmi_sensor": "", "authtype": "0", "username": "", "password": "", "publickey": "", "privatekey": "", "interfaceid": "119", "description": "Discovery of file systems of different types as defined in global regular expression \"File systems for discovery\".", "lifetime": "30d", "jmx_endpoint": "", "master_itemid": "0", "timeout": "3s", "url": "", "query_fields": [], "posts": "", "status_codes": "200", "follow_redirects": "1", "post_type": "0", "http_proxy": "", "headers": [], "retrieve_mode": "0", "request_method": "0", "ssl_cert_file": "", "ssl_key_file": "", "ssl_key_password": "", "verify_peer": "0", "verify_host": "0", "allow_traps": "0", "uuid": "", "state": "0", "error": "", "parameters": [] } ], "id": 1 } ``` #### دریافت قوانین جست وجو از یک هاست Retrieve all discovery rules for specific host ID. Request: ```json { "jsonrpc": "2.0", "method": "discoveryrule.get", "params": { "output": "extend", "hostids": "10202" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "itemid": "27425", "type": "0", "snmp_oid": "", "hostid": "10202", "name": "Network interface discovery", "key_": "net.if.discovery", "delay": "1h", "status": "0", "trapper_hosts": "", "templateid": "22444", "valuemapid": "0", "params": "", "ipmi_sensor": "", "authtype": "0", "username": "", "password": "", "publickey": "", "privatekey": "", "interfaceid": "119", "description": "Discovery of network interfaces as defined in global regular expression \"Network interfaces for discovery\".", "lifetime": "30d", "jmx_endpoint": "", "master_itemid": "0", "timeout": "3s", "url": "", "query_fields": [], "posts": "", "status_codes": "200", "follow_redirects": "1", "post_type": "0", "http_proxy": "", "headers": [], "retrieve_mode": "0", "request_method": "0", "ssl_cert_file": "", "ssl_key_file": "", "ssl_key_password": "", "verify_peer": "0", "verify_host": "0", "allow_traps": "0", "uuid": "", "state": "0", "error": "", "parameters": [] }, { "itemid": "27426", "type": "0", "snmp_oid": "", "hostid": "10202", "name": "Mounted filesystem discovery", "key_": "vfs.fs.discovery", "delay": "1h", "status": "0", "trapper_hosts": "", "templateid": "22450", "valuemapid": "0", "params": "", "ipmi_sensor": "", "authtype": "0", "username": "", "password": "", "publickey": "", "privatekey": "", "interfaceid": "119", "description": "Discovery of file systems of different types as defined in global regular expression \"File systems for discovery\".", "lifetime": "30d", "jmx_endpoint": "", "master_itemid": "0", "timeout": "3s", "url": "", "query_fields": [], "posts": "", "status_codes": "200", "follow_redirects": "1", "post_type": "0", "http_proxy": "", "headers": [], "retrieve_mode": "0", "request_method": "0", "ssl_cert_file": "", "ssl_key_file": "", "ssl_key_password": "", "verify_peer": "0", "verify_host": "0", "allow_traps": "0", "uuid": "", "state": "0", "error": "", "parameters": [] } ], "id": 1 } ``` #### Retrieving enabled user groups Retrieve all enabled user groups. Request: ```json { "jsonrpc": "2.0", "method": "usergroup.get", "params": { "output": "extend", "status": 0 }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "usrgrpid": "7", "name": "Zabbix administrators", "gui_access": "0", "users_status": "0", "debug_mode": "1" }, { "usrgrpid": "8", "name": "Guests", "gui_access": "0", "users_status": "0", "debug_mode": "0" }, { "usrgrpid": "11", "name": "Enabled debug mode", "gui_access": "0", "users_status": "0", "debug_mode": "1" }, { "usrgrpid": "12", "name": "No access to the frontend", "gui_access": "2", "users_status": "0", "debug_mode": "0" }, { "usrgrpid": "14", "name": "Read only", "gui_access": "0", "users_status": "0", "debug_mode": "0" }, { "usrgrpid": "18", "name": "Deny", "gui_access": "0", "users_status": "0", "debug_mode": "0" } ], "id": 1 } ``` #### بازیابی گروه های کاربر فعال همه گروه های کاربری فعال را بازیابی کنید. درخواست: ``json { "jsonrpc": "2.0"، "روش": "usergroup.get"، "params": { "output": "extend" "وضعیت": 0 }، "auth": "038e1d7b1735c6a5436ee9eae095879e"، "id": 1 } ``` واکنش: ``json { "jsonrpc": "2.0"، "نتیجه": [ { "usrgrpid": "7"، "name": "مدیران Zabbix", "gui_access": "0"، "users_status": "0"، "debug_mode": "1" }، { "usrgrpid": "8"، "name": "مهمانان"، "gui_access": "0"، "users_status": "0"، "debug_mode": "0" }، { "usrgrpid": "11"، "name": "حالت اشکال زدایی فعال"، "gui_access": "0"، "users_status": "0"، "debug_mode": "1" }، { "usrgrpid": "12"، "name": "بدون دسترسی به جلو"، "gui_access": "2"، "users_status": "0"، "debug_mode": "0" }، { "usrgrpid": "14"، "name": "فقط خواندنی"، "gui_access": "0"، "users_status": "0"، "debug_mode": "0" }، { "usrgrpid": "18"، "name": "انکار"، "gui_access": "0"، "users_status": "0"، "debug_mode": "0" } ]، "id": 1 } ``` #### Retrieving filter conditions Retrieve the name of the LLD rule "24681" and its filter conditions. The filter uses the "and" evaluation type, so the `formula` property is empty and `eval_formula` is generated automatically. Request: ```json { "jsonrpc": "2.0", "method": "discoveryrule.get", "params": { "output": ["name"], "selectFilter": "extend", "itemids": ["24681"] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "itemid": "24681", "name": "Filtered LLD rule", "filter": { "evaltype": "1", "formula": "", "conditions": [ { "macro": "{#MACRO1}", "value": "@regex1", "operator": "8", "formulaid": "A" }, { "macro": "{#MACRO2}", "value": "@regex2", "operator": "9", "formulaid": "B" }, { "macro": "{#MACRO3}", "value": "", "operator": "12", "formulaid": "C" }, { "macro": "{#MACRO4}", "value": "", "operator": "13", "formulaid": "D" } ], "eval_formula": "A and B and C and D" } } ], "id": 1 } ``` #### دریافت قوانین فیلتر نام قانون LLD "24681" و شرایط فیلتر آن را بازیابی کنید. این فیلتر از نوع ارزیابی «and» استفاده می‌کند، بنابراین ویژگی «فرمول» است خالی و 'eval_formula' به طور خودکار تولید می شود. Request: ```json { "jsonrpc": "2.0", "method": "discoveryrule.get", "params": { "output": ["name"], "selectFilter": "extend", "itemids": ["24681"] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "itemid": "24681", "name": "Filtered LLD rule", "filter": { "evaltype": "1", "formula": "", "conditions": [ { "macro": "{#MACRO1}", "value": "@regex1", "operator": "8", "formulaid": "A" }, { "macro": "{#MACRO2}", "value": "@regex2", "operator": "9", "formulaid": "B" }, { "macro": "{#MACRO3}", "value": "", "operator": "12", "formulaid": "C" }, { "macro": "{#MACRO4}", "value": "", "operator": "13", "formulaid": "D" } ], "eval_formula": "A and B and C and D" } } ], "id": 1 } ``` #### Retrieving global macros Retrieve all global macros. Request: ```json { "jsonrpc": "2.0", "method": "usermacro.get", "params": { "output": "extend", "globalmacro": true }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "globalmacroid": "6", "macro": "{$SNMP_COMMUNITY}", "value": "public", "description": "", "type": "0" } ], "id": 1 } ``` #### تغییر نام آیکون نقشه یک آیکون نقشه را به "آیکون سیستم عامل" تغییر نام دهید. درخواست: ``json { "jsonrpc": "2.0"، "method": "iconmap.update"، "params": { "iconmapid": "1"، "name": "OS icons" }، "auth": "038e1d7b1735c6a5436ee9eae095879e"، "id": 1 } ``` پاسخ: ``json { "jsonrpc": "2.0"، "result": { "iconmapids": [ "1" ] }، "id": 1 } ``` #### Retrieving global regular expressions. Request: ```json { "jsonrpc": "2.0", "method": "regexp.get", "params": { "output": ["regexpid", "name"], "selectExpressions": ["expression", "expression_type"], "regexpids": [1, 2], "preservekeys": true }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ``` {.java} { "jsonrpc": "2.0", "result": { "1": { "regexpid": "1", "name": "File systems for discovery", "expressions": [ { "expression": "^(btrfs|ext2|ext3|ext4|reiser|xfs|ffs|ufs|jfs|jfs2|vxfs|hfs|apfs|refs|ntfs|fat32|zfs)$", "expression_type": "3" } ] }, "2": { "regexpid": "2", "name": "Network interfaces for discovery", "expressions": [ { "expression": "^Software Loopback Interface", "expression_type": "4" }, { "expression": "^(In)?[Ll]oop[Bb]ack[0-9._]*$", "expression_type": "4" }, { "expression": "^NULL[0-9.]*$", "expression_type": "4" }, { "expression": "^[Ll]o[0-9.]*$", "expression_type": "4" }, { "expression": "^[Ss]ystem$", "expression_type": "4" }, { "expression": "^Nu[0-9.]*$", "expression_type": "4" } ] } }, "id": 1 } ``` #### بازیابی عبارات منظم جهانی. درخواست: ``json { "jsonrpc": "2.0"، "روش": "regexp.get"، "params": { "output": ["regexpid"، "name"]، "selectExpressions": ["expression"، "expression_type"]، "regexpids": [1، 2]، «محفظات»: درست است }، "auth": "038e1d7b1735c6a5436ee9eae095879e"، "id": 1 } ``` واکنش: ``` {.java} { "jsonrpc": "2.0"، "نتیجه": { "1": { "regexpid": "1"، "name": "سیستم های فایل برای کشف"، "اصطلاحات": [ { "expression": "^(btrfs|ext2|ext3|ext4|reiser|xfs|ffs|ufs|jfs|jfs2|vxfs|hfs|apfs|refs|ntfs|fat32|zfs)$"، "expression_type": "3" } ] }، "2": { "regexpid": "2"، "name": "واسط های شبکه برای کشف"، "اصطلاحات": [ { "expression": "^Software Loopback Interface", "expression_type": "4" }، { "expression": "^(در)؟[Ll]oop[Bb]ack[0-9._]*$", "expression_type": "4" }، { "expression": "^NULL[0-9.]*$"، "expression_type": "4" }، { "expression": "^[Ll]o[0-9.]*$"، "expression_type": "4" }، { "expression": "^[Ss]ystem$", "expression_type": "4" }، { "expression": "^Nu[0-9.]*$"، "expression_type": "4" } ] } }، "id": 1 } ``` #### Retrieving graphs from hosts Retrieve all graphs from host "10107" and sort them by name. Request: ```json { "jsonrpc": "2.0", "method": "graph.get", "params": { "output": "extend", "hostids": 10107, "sortfield": "name" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "graphid": "612", "name": "CPU jumps", "width": "900", "height": "200", "yaxismin": "0", "yaxismax": "100", "templateid": "439", "show_work_period": "1", "show_triggers": "1", "graphtype": "0", "show_legend": "1", "show_3d": "0", "percent_left": "0", "percent_right": "0", "ymin_type": "0", "ymax_type": "0", "ymin_itemid": "0", "ymax_itemid": "0", "flags": "0" }, { "graphid": "613", "name": "CPU load", "width": "900", "height": "200", "yaxismin": "0", "yaxismax": "100", "templateid": "433", "show_work_period": "1", "show_triggers": "1", "graphtype": "0", "show_legend": "1", "show_3d": "0", "percent_left": "0", "percent_right": "0", "ymin_type": "1", "ymax_type": "0", "ymin_itemid": "0", "ymax_itemid": "0", "flags": "0" }, { "graphid": "614", "name": "CPU utilization", "width": "900", "height": "200", "yaxismin": "0", "yaxismax": "100", "templateid": "387", "show_work_period": "1", "show_triggers": "0", "graphtype": "1", "show_legend": "1", "show_3d": "0", "percent_left": "0", "percent_right": "0", "ymin_type": "1", "ymax_type": "1", "ymin_itemid": "0", "ymax_itemid": "0", "flags": "0" }, { "graphid": "645", "name": "Disk space usage /", "width": "600", "height": "340", "yaxismin": "0", "yaxismax": "0", "templateid": "0", "show_work_period": "0", "show_triggers": "0", "graphtype": "2", "show_legend": "1", "show_3d": "1", "percent_left": "0", "percent_right": "0", "ymin_type": "0", "ymax_type": "0", "ymin_itemid": "0", "ymax_itemid": "0", "flags": "4" } ], "id": 1 } ``` #### دریافت گراف ها از یک هاست Retrieve all graphs from host "10107" and sort them by name. Request: ```json { "jsonrpc": "2.0", "method": "graph.get", "params": { "output": "extend", "hostids": 10107, "sortfield": "name" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "graphid": "612", "name": "CPU jumps", "width": "900", "height": "200", "yaxismin": "0", "yaxismax": "100", "templateid": "439", "show_work_period": "1", "show_triggers": "1", "graphtype": "0", "show_legend": "1", "show_3d": "0", "percent_left": "0", "percent_right": "0", "ymin_type": "0", "ymax_type": "0", "ymin_itemid": "0", "ymax_itemid": "0", "flags": "0" }, { "graphid": "613", "name": "CPU load", "width": "900", "height": "200", "yaxismin": "0", "yaxismax": "100", "templateid": "433", "show_work_period": "1", "show_triggers": "1", "graphtype": "0", "show_legend": "1", "show_3d": "0", "percent_left": "0", "percent_right": "0", "ymin_type": "1", "ymax_type": "0", "ymin_itemid": "0", "ymax_itemid": "0", "flags": "0" }, { "graphid": "614", "name": "CPU utilization", "width": "900", "height": "200", "yaxismin": "0", "yaxismax": "100", "templateid": "387", "show_work_period": "1", "show_triggers": "0", "graphtype": "1", "show_legend": "1", "show_3d": "0", "percent_left": "0", "percent_right": "0", "ymin_type": "1", "ymax_type": "1", "ymin_itemid": "0", "ymax_itemid": "0", "flags": "0" }, { "graphid": "645", "name": "Disk space usage /", "width": "600", "height": "340", "yaxismin": "0", "yaxismax": "0", "templateid": "0", "show_work_period": "0", "show_triggers": "0", "graphtype": "2", "show_legend": "1", "show_3d": "1", "percent_left": "0", "percent_right": "0", "ymin_type": "0", "ymax_type": "0", "ymin_itemid": "0", "ymax_itemid": "0", "flags": "4" } ], "id": 1 } ``` #### Retrieving host groups Retrieve names of the groups host "Zabbix server" is member of, but no host details themselves. Request: ```json { "jsonrpc": "2.0", "method": "host.get", "params": { "output": ["hostid"], "selectGroups": "extend", "filter": { "host": [ "Zabbix server" ] } }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 2 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "hostid": "10085", "groups": [ { "groupid": "2", "name": "Linux servers", "internal": "0", "flags": "0" }, { "groupid": "4", "name": "Zabbix servers", "internal": "0", "flags": "0" } ] } ], "id": 2 } ``` #### دریافت گروه هاست ها Retrieve names of the groups host "Zabbix server" is member of, but no host details themselves. Request: ```json { "jsonrpc": "2.0", "method": "host.get", "params": { "output": ["hostid"], "selectGroups": "extend", "filter": { "host": [ "Zabbix server" ] } }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 2 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "hostid": "10085", "groups": [ { "groupid": "2", "name": "Linux servers", "internal": "0", "flags": "0" }, { "groupid": "4", "name": "Zabbix servers", "internal": "0", "flags": "0" } ] } ], "id": 2 } ``` #### Retrieving host macros for a host Retrieve all host macros defined for host "10198". Request: ```json { "jsonrpc": "2.0", "method": "usermacro.get", "params": { "output": "extend", "hostids": "10198" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "hostmacroid": "9", "hostid": "10198", "macro": "{$INTERFACE}", "value": "eth0", "description": "", "type": "0" }, { "hostmacroid": "11", "hostid": "10198", "macro": "{$SNMP_COMMUNITY}", "value": "public", "description": "", "type": "0" } ], "id": 1 } ``` #### دریافت بررسی های جست و جو برای قوانین جست و جو Retrieve all discovery checks used by discovery rule "6". Request: ```json { "jsonrpc": "2.0", "method": "dcheck.get", "params": { "output": "extend", "dcheckids": "6" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "dcheckid": "6", "druleid": "4", "type": "3", "key_": "", "snmp_community": "", "ports": "21", "snmpv3_securityname": "", "snmpv3_securitylevel": "0", "snmpv3_authpassphrase": "", "snmpv3_privpassphrase": "", "uniq": "0", "snmpv3_authprotocol": "0", "snmpv3_privprotocol": "0", "host_source": "1", "name_source": "0" } ], "id": 1 } ``` #### Retrieving host prototypes from an LLD rule Retrieve all host prototypes, their group links, group prototypes and tags from an LLD rule. Request: ```json { "jsonrpc": "2.0", "method": "hostprototype.get", "params": { "output": "extend", "selectInterfaces": "extend", "selectGroupLinks": "extend", "selectGroupPrototypes": "extend", "selectTags": "extend", "discoveryids": "23554" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "hostid": "10092", "host": "{#HV.UUID}", "name": "{#HV.UUID}", "status": "0", "templateid": "0", "discover": "0", "custom_interfaces": "1", "inventory_mode": "-1", "groupLinks": [ { "group_prototypeid": "4", "hostid": "10092", "groupid": "7", "templateid": "0" } ], "groupPrototypes": [ { "group_prototypeid": "7", "hostid": "10092", "name": "{#CLUSTER.NAME}", "templateid": "0" } ], "tags": [ { "tag": "Datacenter", "value": "{#DATACENTER.NAME}" }, { "tag": "Instance type", "value": "{#INSTANCE_TYPE}" } ], "interfaces": [ { "main": "1", "type": "2", "useip": "1", "ip": "127.0.0.1", "dns": "", "port": "161", "details": { "version": "2", "bulk": "1", "community": "{$SNMP_COMMUNITY}" } } ] } ], "id": 1 } ``` #### دریافت نمونه اولیه هاست از قانون LLD Retrieve all host prototypes, their group links, group prototypes and tags from an LLD rule. Request: ```json { "jsonrpc": "2.0", "method": "hostprototype.get", "params": { "output": "extend", "selectInterfaces": "extend", "selectGroupLinks": "extend", "selectGroupPrototypes": "extend", "selectTags": "extend", "discoveryids": "23554" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "hostid": "10092", "host": "{#HV.UUID}", "name": "{#HV.UUID}", "status": "0", "templateid": "0", "discover": "0", "custom_interfaces": "1", "inventory_mode": "-1", "groupLinks": [ { "group_prototypeid": "4", "hostid": "10092", "groupid": "7", "templateid": "0" } ], "groupPrototypes": [ { "group_prototypeid": "7", "hostid": "10092", "name": "{#CLUSTER.NAME}", "templateid": "0" } ], "tags": [ { "tag": "Datacenter", "value": "{#DATACENTER.NAME}" }, { "tag": "Instance type", "value": "{#INSTANCE_TYPE}" } ], "interfaces": [ { "main": "1", "type": "2", "useip": "1", "ip": "127.0.0.1", "dns": "", "port": "161", "details": { "version": "2", "bulk": "1", "community": "{$SNMP_COMMUNITY}" } } ] } ], "id": 1 } ``` #### Retrieving hosts by template Retrieve hosts that have the "10001" (*Linux by Zabbix agent*) template linked to them. Request: ```json { "jsonrpc": "2.0", "method": "template.get", "params": { "output": "templateid", "templateids": "10001", "selectHosts": ["hostid", "name"] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "templateid": "10001", "hosts": [ { "hostid": "10084", "name": "Zabbix server" }, { "hostid": "10603", "name": "Host 1" }, { "hostid": "10604", "name": "Host 2" } ] } ], "id": 1 } ``` #### جست وجوی هاست با تگ و تمپلیت تگ Retrieve a host with tags and all tags that are linked to parent templates. Request: ```json { "jsonrpc": "2.0", "method": "host.get", "params": { "output": ["name"], "hostids": 10502, "selectTags": ["tag", "value"], "selectInheritedTags": ["tag", "value"] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "hostid": "10502", "name": "Desktop", "tags": [ { "tag": "A", "value": "1" } ], "inheritedTags": [ { "tag": "B", "value": "2" } ] } ], "id": 1 } ``` #### Retrieving item history data Return 10 latest values received from a numeric(float) item. Request: ```json { "jsonrpc": "2.0", "method": "history.get", "params": { "output": "extend", "history": 0, "itemids": "23296", "sortfield": "clock", "sortorder": "DESC", "limit": 10 }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "itemid": "23296", "clock": "1351090996", "value": "0.085", "ns": "563157632" }, { "itemid": "23296", "clock": "1351090936", "value": "0.16", "ns": "549216402" }, { "itemid": "23296", "clock": "1351090876", "value": "0.18", "ns": "537418114" }, { "itemid": "23296", "clock": "1351090816", "value": "0.21", "ns": "522659528" }, { "itemid": "23296", "clock": "1351090756", "value": "0.215", "ns": "507809457" }, { "itemid": "23296", "clock": "1351090696", "value": "0.255", "ns": "495509699" }, { "itemid": "23296", "clock": "1351090636", "value": "0.36", "ns": "477708209" }, { "itemid": "23296", "clock": "1351090576", "value": "0.375", "ns": "463251343" }, { "itemid": "23296", "clock": "1351090516", "value": "0.315", "ns": "447947017" }, { "itemid": "23296", "clock": "1351090456", "value": "0.275", "ns": "435307141" } ], "id": 1 } ``` #### دریافت تاریخچه آیتم Return 10 latest values received from a numeric(float) item. Request: ```json { "jsonrpc": "2.0", "method": "history.get", "params": { "output": "extend", "history": 0, "itemids": "23296", "sortfield": "clock", "sortorder": "DESC", "limit": 10 }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "itemid": "23296", "clock": "1351090996", "value": "0.085", "ns": "563157632" }, { "itemid": "23296", "clock": "1351090936", "value": "0.16", "ns": "549216402" }, { "itemid": "23296", "clock": "1351090876", "value": "0.18", "ns": "537418114" }, { "itemid": "23296", "clock": "1351090816", "value": "0.21", "ns": "522659528" }, { "itemid": "23296", "clock": "1351090756", "value": "0.215", "ns": "507809457" }, { "itemid": "23296", "clock": "1351090696", "value": "0.255", "ns": "495509699" }, { "itemid": "23296", "clock": "1351090636", "value": "0.36", "ns": "477708209" }, { "itemid": "23296", "clock": "1351090576", "value": "0.375", "ns": "463251343" }, { "itemid": "23296", "clock": "1351090516", "value": "0.315", "ns": "447947017" }, { "itemid": "23296", "clock": "1351090456", "value": "0.275", "ns": "435307141" } ], "id": 1 } ``` #### Retrieving item prototypes from an LLD rule Retrieve all item prototypes for specific LLD rule ID. Request: ```json { "jsonrpc": "2.0", "method": "itemprototype.get", "params": { "output": "extend", "discoveryids": "27426" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "itemid": "23077", "type": "0", "snmp_oid": "", "hostid": "10079", "name": "Incoming network traffic on en0", "key_": "net.if.in[en0]", "delay": "1m", "history": "1w", "trends": "365d", "status": "0", "value_type": "3", "trapper_hosts": "", "units": "bps", "logtimefmt": "", "templateid": "0", "valuemapid": "0", "params": "", "ipmi_sensor": "", "authtype": "0", "username": "", "password": "", "publickey": "", "privatekey": "", "interfaceid": "0", "description": "", "evaltype": "0", "jmx_endpoint": "", "master_itemid": "0", "timeout": "3s", "url": "", "query_fields": [], "posts": "", "status_codes": "200", "follow_redirects": "1", "post_type": "0", "http_proxy": "", "headers": [], "retrieve_mode": "0", "request_method": "0", "output_format": "0", "ssl_cert_file": "", "ssl_key_file": "", "ssl_key_password": "", "verify_peer": "0", "verify_host": "0", "allow_traps": "0", "discover": "0", "uuid": "", "parameters": [] }, { "itemid": "10010", "type": "0", "snmp_oid": "", "hostid": "10001", "name": "Processor load (1 min average per core)", "key_": "system.cpu.load[percpu,avg1]", "delay": "1m", "history": "1w", "trends": "365d", "status": "0", "value_type": "0", "trapper_hosts": "", "units": "", "logtimefmt": "", "templateid": "0", "valuemapid": "0", "params": "", "ipmi_sensor": "", "authtype": "0", "username": "", "password": "", "publickey": "", "privatekey": "", "interfaceid": "0", "description": "The processor load is calculated as system CPU load divided by number of CPU cores.", "evaltype": "0", "jmx_endpoint": "", "master_itemid": "0", "timeout": "3s", "url": "", "query_fields": [], "posts": "", "status_codes": "200", "follow_redirects": "1", "post_type": "0", "http_proxy": "", "headers": [], "retrieve_mode": "0", "request_method": "0", "output_format": "0", "ssl_cert_file": "", "ssl_key_file": "", "ssl_key_password": "", "verify_peer": "0", "verify_host": "0", "allow_traps": "0", "lastclock": "0", "lastns": "0", "lastvalue": "0", "prevvalue": "0", "discover": "0", "uuid": "", "parameters": [] } ], "id": 1 } ``` #### بازیابی نمونه های اولیه آیتم از یک قانون LLD همه نمونه های اولیه مورد را برای شناسه قانون LLD خاص بازیابی کنید. درخواست: ``json { "jsonrpc": "2.0"، "روش": "itemprototype.get"، "params": { "output": "extend" "discoveyids": "27426" }، "auth": "038e1d7b1735c6a5436ee9eae095879e"، "id": 1 } ``` واکنش: ``json { "jsonrpc": "2.0"، "نتیجه": [ { "itemid": "23077"، "نوع": "0"، "snmp_oid": "", "hostid": "10079"، "name": "ترافیک شبکه ورودی در en0"، "key_": "net.if.in[en0]"، "تاخیر": "1 متر"، "تاریخچه": "1w"، "روند": "365d"، "وضعیت": "0"، "value_type": "3"، "trapper_hosts": "", "واحد": "bps"، "logtimefmt": "", "templateid": "0", "valuemapid": "0"، "params": "", "ipmi_sensor": "", "authtype": "0"، "نام کاربری": ""، "کلمه عبور": ""، "کلید عمومی": ""، "کلید خصوصی": ""، "interfaceid": "0"، "شرح": ""، "evaltype": "0"، "jmx_endpoint": "", "master_itemid": "0"، "تایم اوت": "3 ثانیه"، "url": "", "query_fields": []، "نوشته ها": ""، "status_codes": "200"، "follow_redirects": "1"، "پست_نوع": "0"، "http_proxy": ""، "headers": [], "retrieve_mode": "0"، "request_method": "0"، "output_format": "0"، "ssl_cert_file": ""، "ssl_key_file": ""، "ssl_key_password": ""، "verify_peer": "0"، "verify_host": "0", "allow_traps": "0"، "کشف": "0"، "uuid": ""، "مولفه های": [] }، { "itemid": "10010"، "نوع": "0"، "snmp_oid": "", "hostid": "10001"، "name": "بار پردازنده (متوسط 1 دقیقه در هر هسته)"، "key_": "system.cpu.load[percpu,avg1]"، "تاخیر": "1 متر"، "تاریخچه": "1w"، "روند": "365d"، "وضعیت": "0"، "value_type": "0"، "trapper_hosts": "", "واحد": ""، "logtimefmt": "", "templateid": "0", "valuemapid": "0"، "params": "", "ipmi_sensor": "", "authtype": "0"، "نام کاربری": ""، "کلمه عبور": ""، "کلید عمومی": ""، "کلید خصوصی": ""، "interfaceid": "0"، "description": "بار پردازنده به صورت بار CPU سیستم تقسیم بر تعداد هسته های CPU محاسبه می شود."، "evaltype": "0"، "jmx_endpoint": "", "master_itemid": "0"، "تایم اوت": "3 ثانیه"، "url": "", "query_fields": []، "نوشته ها": ""، "status_codes": "200"، "follow_redirects": "1"، "پست_نوع": "0"، "http_proxy": ""، "headers": [], "retrieve_mode": "0"، "request_method": "0"، "output_format": "0"، "ssl_cert_file": ""، "ssl_key_file": ""، "ssl_key_password": ""، "verify_peer": "0"، "verify_host": "0", "allow_traps": "0"، "آخرین ساعت": "0"، "lastns": "0"، "lastvalue": "0"، "prevvalue": "0"، "کشف": "0"، "uuid": ""، "مولفه های": [] } ]، "id": 1 } ``` #### Retrieving items with preprocessing rules Retrieve all items and their preprocessing rules for specific host ID. Request: ```json { "jsonrpc": "2.0", "method": "item.get", "params": { "output": ["itemid", "name", "key_"], "selectPreprocessing": "extend", "hostids": "10254" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemid": "23865", "name": "HTTP agent example JSON", "key_": "json", "preprocessing": [ { "type": "12", "params": "$.random", "error_handler": "1", "error_handler_params": "" } ] }, "id": 1 } ``` #### بازیابی موارد با قوانین پیش پردازش همه موارد و قوانین پیش پردازش آنها را برای شناسه میزبان خاص بازیابی کنید. درخواست: ``json { "jsonrpc": "2.0"، "روش": "item.get"، "params": { "output": ["itemid"، "name"، "key_"]، "selectPreprocessing": "extend" "hostids": "10254" }، "auth": "038e1d7b1735c6a5436ee9eae095879e"، "id": 1 } ``` واکنش: ``json { "jsonrpc": "2.0"، "نتیجه": { "itemid": "23865"، "name": "مثلاً عامل HTTP JSON"، "key_": "json", "پیش پردازش": [ { "نوع": "12"، "params": "$.random"، "error_handler": "1"، "error_handler_params": "" } ] }، "id": 1 } ``` #### Retrieving linked templates Retrieve the IDs and names of templates linked to host "10084". Request: ```json { "jsonrpc": "2.0", "method": "host.get", "params": { "output": ["hostid"], "selectParentTemplates": [ "templateid", "name" ], "hostids": "10084" }, "id": 1, "auth": "70785d2b494a7302309b48afcdb3a401" } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "hostid": "10084", "parentTemplates": [ { "name": "Linux", "templateid": "10001" }, { "name": "Zabbix Server", "templateid": "10047" } ] } ], "id": 1 } ``` #### دریافت تمپلیت های لینک شده Retrieve the IDs and names of templates linked to host "10084". Request: ```json { "jsonrpc": "2.0", "method": "host.get", "params": { "output": ["hostid"], "selectParentTemplates": [ "templateid", "name" ], "hostids": "10084" }, "id": 1, "auth": "70785d2b494a7302309b48afcdb3a401" } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "hostid": "10084", "parentTemplates": [ { "name": "Linux", "templateid": "10001" }, { "name": "Zabbix Server", "templateid": "10047" } ] } ], "id": 1 } ``` #### Retrieving maintenances Retrieve all configured maintenances, and the data about the assigned host groups, defined time periods and problem tags. Request: ```json { "jsonrpc": "2.0", "method": "maintenance.get", "params": { "output": "extend", "selectGroups": "extend", "selectTimeperiods": "extend", "selectTags": "extend" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "maintenanceid": "3", "name": "Sunday maintenance", "maintenance_type": "0", "description": "", "active_since": "1358844540", "active_till": "1390466940", "tags_evaltype": "0", "groups": [ { "groupid": "4", "name": "Zabbix servers", "internal": "0" } ], "timeperiods": [ { "timeperiod_type": "3", "every": "1", "month": "0", "dayofweek": "1", "day": "0", "start_time": "64800", "period": "3600", "start_date": "2147483647" } ], "tags": [ { "tag": "service", "operator": "0", "value": "mysqld", }, { "tag": "error", "operator": "2", "value": "" } ] } ], "id": 1 } ``` #### بازیابی تعمیرات تمام تعمیرات پیکربندی شده و اطلاعات مربوط به موارد اختصاص داده شده را بازیابی کنید گروه های میزبان، دوره های زمانی تعریف شده و برچسب های مشکل. درخواست: ``json { "jsonrpc": "2.0"، "روش": "maintenance.get"، "params": { "output": "extend" "selectGroups": "extend", "selectTimeperiods": "extend", "selectTags": "extend" }، "auth": "038e1d7b1735c6a5436ee9eae095879e"، "id": 1 } ``` واکنش: ``json { "jsonrpc": "2.0"، "نتیجه": [ { "maintenanceid": "3"، "نام": "نگهداری یکشنبه"، "نوع_نگهداری": "0"، "شرح": ""، "active_since": "1358844540"، "active_till": "1390466940", "tags_evaltype": "0"، "گروه ها": [ { "گروهی": "4"، "name": "سرورهای Zabbix", "داخلی": "0" } ]، "دوره های زمانی": [ { "timeperiod_type": "3"، "هر": "1"، "ماه": "0"، "روز هفته": "1"، "روز": "0"، "start_time": "64800"، "دوره": "3600"، "start_date": "2147483647" } ]، "برچسب ها": [ { "برچسب": "خدمات"، "اپراتور": "0"، "value": "mysqld", }، { "برچسب": "خطا"، "اپراتور": "2"، "ارزش": "" } ] } ]، "id": 1 } ``` #### Retrieving role data Retrieve "Super admin role" role data and its access rules. Request: ```json { "jsonrpc": "2.0", "method": "role.get", "params": { "output": "extend", "selectRules": "extend", "roleids": "3" }, "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "roleid": "3", "name": "Super admin role", "type": "3", "readonly": "1", "rules": { "ui": [ { "name": "inventory.hosts", "status": "1" }, { "name": "inventory.overview", "status": "1" }, { "name": "monitoring.dashboard", "status": "1" }, { "name": "monitoring.hosts", "status": "1" }, { "name": "monitoring.latest_data", "status": "1" }, { "name": "monitoring.maps", "status": "1" }, { "name": "monitoring.problems", "status": "1" }, { "name": "reports.availability_report", "status": "1" }, { "name": "reports.top_triggers", "status": "1" }, { "name": "services.services", "status": "1" }, { "name": "services.sla_report", "status": "1" }, { "name": "configuration.actions", "status": "1" }, { "name": "configuration.discovery", "status": "1" }, { "name": "configuration.host_groups", "status": "1" }, { "name": "configuration.hosts", "status": "1" }, { "name": "configuration.maintenance", "status": "1" }, { "name": "configuration.templates", "status": "1" }, { "name": "monitoring.discovery", "status": "1" }, { "name": "reports.notifications", "status": "1" }, { "name": "reports.scheduled_reports", "status": "1" }, { "name": "services.actions", "status": "1" }, { "name": "services.sla", "status": "1" }, { "name": "administration.authentication", "status": "1" }, { "name": "administration.general", "status": "1" }, { "name": "administration.media_types", "status": "1" }, { "name": "administration.proxies", "status": "1" }, { "name": "administration.queue", "status": "1" }, { "name": "administration.scripts", "status": "1" }, { "name": "administration.user_groups", "status": "1" }, { "name": "administration.user_roles", "status": "1" }, { "name": "administration.users", "status": "1" }, { "name": "configuration.event_correlation", "status": "1" }, { "name": "reports.action_log", "status": "1" }, { "name": "reports.audit", "status": "1" }, { "name": "reports.system_info", "status": "1" } ], "ui.default_access": "1", "services.read.mode": "1", "services.read.list": [], "services.read.tag": { "tag": "", "value": "" }, "services.write.mode": "1", "services.write.list": [], "services.write.tag": { "tag": "", "value": "" }, "modules": [], "modules.default_access": "1", "api.access": "1", "api.mode": "0", "api": [], "actions": [ { "name": "edit_dashboards", "status": "1" }, { "name": "edit_maps", "status": "1" }, { "name": "acknowledge_problems", "status": "1" }, { "name": "close_problems", "status": "1" }, { "name": "change_severity", "status": "1" }, { "name": "add_problem_comments", "status": "1" }, { "name": "execute_scripts", "status": "1" }, { "name": "manage_api_tokens", "status": "1" }, { "name": "edit_maintenance", "status": "1" }, { "name": "manage_scheduled_reports", "status": "1" }, { "name": "manage_sla", "status": "1" } ], "actions.default_access": "1" } } ], "id": 1 } ``` #### Retrieving role data Retrieve "Super admin role" role data and its access rules. Request: ```json { "jsonrpc": "2.0", "method": "role.get", "params": { "output": "extend", "selectRules": "extend", "roleids": "3" }, "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "roleid": "3", "name": "Super admin role", "type": "3", "readonly": "1", "rules": { "ui": [ { "name": "inventory.hosts", "status": "1" }, { "name": "inventory.overview", "status": "1" }, { "name": "monitoring.dashboard", "status": "1" }, { "name": "monitoring.hosts", "status": "1" }, { "name": "monitoring.latest_data", "status": "1" }, { "name": "monitoring.maps", "status": "1" }, { "name": "monitoring.problems", "status": "1" }, { "name": "reports.availability_report", "status": "1" }, { "name": "reports.top_triggers", "status": "1" }, { "name": "services.services", "status": "1" }, { "name": "services.sla_report", "status": "1" }, { "name": "configuration.actions", "status": "1" }, { "name": "configuration.discovery", "status": "1" }, { "name": "configuration.host_groups", "status": "1" }, { "name": "configuration.hosts", "status": "1" }, { "name": "configuration.maintenance", "status": "1" }, { "name": "configuration.templates", "status": "1" }, { "name": "monitoring.discovery", "status": "1" }, { "name": "reports.notifications", "status": "1" }, { "name": "reports.scheduled_reports", "status": "1" }, { "name": "services.actions", "status": "1" }, { "name": "services.sla", "status": "1" }, { "name": "administration.authentication", "status": "1" }, { "name": "administration.general", "status": "1" }, { "name": "administration.media_types", "status": "1" }, { "name": "administration.proxies", "status": "1" }, { "name": "administration.queue", "status": "1" }, { "name": "administration.scripts", "status": "1" }, { "name": "administration.user_groups", "status": "1" }, { "name": "administration.user_roles", "status": "1" }, { "name": "administration.users", "status": "1" }, { "name": "configuration.event_correlation", "status": "1" }, { "name": "reports.action_log", "status": "1" }, { "name": "reports.audit", "status": "1" }, { "name": "reports.system_info", "status": "1" } ], "ui.default_access": "1", "services.read.mode": "1", "services.read.list": [], "services.read.tag": { "tag": "", "value": "" }, "services.write.mode": "1", "services.write.list": [], "services.write.tag": { "tag": "", "value": "" }, "modules": [], "modules.default_access": "1", "api.access": "1", "api.mode": "0", "api": [], "actions": [ { "name": "edit_dashboards", "status": "1" }, { "name": "edit_maps", "status": "1" }, { "name": "acknowledge_problems", "status": "1" }, { "name": "close_problems", "status": "1" }, { "name": "change_severity", "status": "1" }, { "name": "add_problem_comments", "status": "1" }, { "name": "execute_scripts", "status": "1" }, { "name": "manage_api_tokens", "status": "1" }, { "name": "edit_maintenance", "status": "1" }, { "name": "manage_scheduled_reports", "status": "1" }, { "name": "manage_sla", "status": "1" } ], "actions.default_access": "1" } } ], "id": 1 } ``` #### Retrieving template dashboards Retrieve all template dashboards with widgets for a specified template. Request: ```json { "jsonrpc": "2.0", "method": "templatedashboard.get", "params": { "output": "extend", "selectPages": "extend", "templateids": "10001" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "dashboardid": "23", "name": "Docker overview", "templateid": "10001", "display_period": "30", "auto_start": "1", "uuid": "6dfcbe0bc5ad400ea9c1c2dd7649282f", "pages": [ { "dashboard_pageid": "1", "name": "", "display_period": "0", "widgets": [ { "widgetid": "220", "type": "graph", "name": "", "x": "0", "y": "0", "width": "12", "height": "5", "view_mode": "0", "fields": [ { "type": "6", "name": "graphid", "value": "1125" } ] }, { "widgetid": "221", "type": "graph", "name": "", "x": "12", "y": "0", "width": "12", "height": "5", "view_mode": "0", "fields": [ { "type": "6", "name": "graphid", "value": "1129" } ] }, { "widgetid": "222", "type": "graph", "name": "", "x": "0", "y": "5", "width": "12", "height": "5", "view_mode": "0", "fields": [ { "type": "6", "name": "graphid", "value": "1128" } ] }, { "widgetid": "223", "type": "graph", "name": "", "x": "12", "y": "5", "width": "12", "height": "5", "view_mode": "0", "fields": [ { "type": "6", "name": "graphid", "value": "1126" } ] }, { "widgetid": "224", "type": "graph", "name": "", "x": "0", "y": "10", "width": "12", "height": "5", "view_mode": "0", "fields": [ { "type": "6", "name": "graphid", "value": "1127" } ] } ] } ] } ], "id": 1 } ``` #### بازیابی داشبوردهای قالب همه داشبوردهای قالب را با ابزارک برای یک الگوی مشخص بازیابی کنید. درخواست: ``json { "jsonrpc": "2.0"، "روش": "templatedashboard.get"، "params": { "output": "extend" "selectPages": "extend", "templateids": "10001" }، "auth": "038e1d7b1735c6a5436ee9eae095879e"، "id": 1 } ``` واکنش: ``json { "jsonrpc": "2.0"، "نتیجه": [ { "dashboardid": "23", "name": "نمای کلی داکر"، "templateid": "10001"، "display_period": "30"، "auto_start": "1"، "uuid": "6dfcbe0bc5ad400ea9c1c2dd7649282f"، "صفحات": [ { "dashboard_pageid": "1"، "نام": ""، "display_period": "0"، "ویجت ها": [ { "ویجتید": "220"، "نوع": "گراف"، "نام": ""، "x": "0"، "y": "0"، "عرض": "12"، "ارتفاع": "5"، "view_mode": "0"، "زمینه های": [ { "نوع": "6"، "نام": "گرافید"، "value": "1125" } ] }، { "ویجتید": "221"، "نوع": "گراف"، "نام": ""، "x": "12"، "y": "0"، "عرض": "12"، "ارتفاع": "5"، "view_mode": "0"، "زمینه های": [ { "نوع": "6"، "نام": "گرافید"، "value": "1129" } ] }، { "ویجتید": "222"، "نوع": "گراف"، "نام": ""، "x": "0"، "y": "5"، "عرض": "12"، "ارتفاع": "5"، "view_mode": "0"، "زمینه های": [ { "نوع": "6"، "نام": "گرافید"، "value": "1128" } ] }، { "ویجتید": "223"، "نوع": "گراف"، "نام": ""، "x": "12"، "y": "5"، "عرض": "12"، "ارتفاع": "5"، "view_mode": "0"، "زمینه های": [ { "نوع": "6"، "نام": "گرافید"، "value": "1126" } ] }، { "ویجتید": "224"، "نوع": "گراف"، "نام": ""، "x": "0"، "y": "10"، "عرض": "12"، "ارتفاع": "5"، "view_mode": "0"، "زمینه های": [ { "نوع": "6"، "نام": "گرافید"، "value": "1127" } ] } ] } ] } ]، "id": 1 } ``` #### Retrieving templates by name Retrieve all data about two templates named "Linux" and "Windows". Request: ```json { "jsonrpc": "2.0", "method": "template.get", "params": { "output": "extend", "filter": { "host": [ "Linux", "Windows" ] } }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "proxy_hostid": "0", "host": "Linux", "status": "3", "disable_until": "0", "error": "", "available": "0", "errors_from": "0", "lastaccess": "0", "ipmi_authtype": "0", "ipmi_privilege": "2", "ipmi_username": "", "ipmi_password": "", "ipmi_disable_until": "0", "ipmi_available": "0", "snmp_disable_until": "0", "snmp_available": "0", "maintenanceid": "0", "maintenance_status": "0", "maintenance_type": "0", "maintenance_from": "0", "ipmi_errors_from": "0", "snmp_errors_from": "0", "ipmi_error": "", "snmp_error": "", "jmx_disable_until": "0", "jmx_available": "0", "jmx_errors_from": "0", "jmx_error": "", "name": "Linux", "flags": "0", "templateid": "10001", "description": "", "tls_connect": "1", "tls_accept": "1", "tls_issuer": "", "tls_subject": "", "tls_psk_identity": "", "tls_psk": "", "uuid": "282ffe33afc74cccaf1524d9aa9dc502" }, { "proxy_hostid": "0", "host": "Windows", "status": "3", "disable_until": "0", "error": "", "available": "0", "errors_from": "0", "lastaccess": "0", "ipmi_authtype": "0", "ipmi_privilege": "2", "ipmi_username": "", "ipmi_password": "", "ipmi_disable_until": "0", "ipmi_available": "0", "snmp_disable_until": "0", "snmp_available": "0", "maintenanceid": "0", "maintenance_status": "0", "maintenance_type": "0", "maintenance_from": "0", "ipmi_errors_from": "0", "snmp_errors_from": "0", "ipmi_error": "", "snmp_error": "", "jmx_disable_until": "0", "jmx_available": "0", "jmx_errors_from": "0", "jmx_error": "", "name": "Windows", "flags": "0", "templateid": "10081", "description": "", "tls_connect": "1", "tls_accept": "1", "tls_issuer": "", "tls_subject": "", "tls_psk_identity": "", "tls_psk": "", "uuid": "522d17e1834049be879287b7c0518e5d" } ], "id": 1 } ``` #### بازیابی الگوها بر اساس نام تمام داده های مربوط به دو قالب به نام های "لینوکس" و "ویندوز" را بازیابی کنید. درخواست: ``json { "jsonrpc": "2.0"، "روش": "template.get"، "params": { "output": "extend" "فیلتر": { "میزبان": [ "لینوکس"، "پنجره ها" ] } }، "auth": "038e1d7b1735c6a5436ee9eae095879e"، "id": 1 } ``` واکنش: ``json { "jsonrpc": "2.0"، "نتیجه": [ { "proxy_hostid": "0"، "میزبان": "لینوکس"، "وضعیت": "3"، "disable_until": "0"، "خطا": ""، "موجود": "0"، "errors_from": "0"، "lastaccess": "0"، "ipmi_authtype": "0"، "ipmi_privilege": "2"، "ipmi_username": "", "ipmi_password": ""، "ipmi_disable_until": "0"، "ipmi_available": "0"، "snmp_disable_until": "0"، "snmp_available": "0"، "maintenanceid": "0"، "status_maintenance": "0"، "نوع_نگهداری": "0"، "maintenance_from": "0"، "ipmi_errors_from": "0"، "snmp_errors_from": "0"، "ipmi_error": ""، "snmp_error": "", "jmx_disable_until": "0"، "jmx_available": "0"، "jmx_errors_from": "0"، "jmx_error": ""، "name": "Linux", "پرچم ها": "0"، "templateid": "10001"، "شرح": ""، "tls_connect": "1"، "tls_accept": "1"، "tls_issuer": ""، "tls_subject": ""، "tls_psk_identity": "", "tls_psk": ""، "uuid": "282ffe33afc74cccaf1524d9aa9dc502" }، { "proxy_hostid": "0"، "میزبان": "ویندوز"، "وضعیت": "3"، "disable_until": "0"، "خطا": ""، "موجود": "0"، "errors_from": "0"، "lastaccess": "0"، "ipmi_authtype": "0"، "ipmi_privilege": "2"، "ipmi_username": "", "ipmi_password": ""، "ipmi_disable_until": "0"، "ipmi_available": "0"، "snmp_disable_until": "0"، "snmp_available": "0"، "maintenanceid": "0"، "status_maintenance": "0"، "نوع_نگهداری": "0"، "maintenance_from": "0"، "ipmi_errors_from": "0"، "snmp_errors_from": "0"، "ipmi_error": ""، "snmp_error": "", "jmx_disable_until": "0"، "jmx_available": "0"، "jmx_errors_from": "0"، "jmx_error": ""، "name": "ویندوز"، "پرچم ها": "0"، "templateid": "10081"، "شرح": ""، "tls_connect": "1"، "tls_accept": "1"، "tls_issuer": ""، "tls_subject": ""، "tls_psk_identity": "", "tls_psk": ""، "uuid": "522d17e1834049be879287b7c0518e5d" } ]، "id": 1 } ``` #### Retrieving the version of the API Retrieve the version of the Zabbix API. Request: ```json { "jsonrpc": "2.0", "method": "apiinfo.version", "params": [], "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": "4.0.0", "id": 1 } ``` #### بازیابی نسخه API نسخه Zabbix API را بازیابی کنید. درخواست: ``json { "jsonrpc": "2.0"، "روش": "apiinfo.version"، "params": []، "id": 1 } ``` واکنش: ``json { "jsonrpc": "2.0"، "نتیجه": "4.0.0"، "id": 1 } ``` #### Retrieving value maps Retrieve all configured value maps. Request: ```json { "jsonrpc": "2.0", "method": "valuemap.get", "params": { "output": "extend" }, "auth": "57562fd409b3b3b9a4d916d45207bbcb", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "valuemapid": "4", "name": "APC Battery Replacement Status" }, { "valuemapid": "5", "name": "APC Battery Status" }, { "valuemapid": "7", "name": "Dell Open Manage System Status" } ], "id": 1 } ``` Retrieve one value map with its mappings. Request: ```json { "jsonrpc": "2.0", "method": "valuemap.get", "params": { "output": "extend", "selectMappings": "extend", "valuemapids": ["4"] }, "auth": "57562fd409b3b3b9a4d916d45207bbcb", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "valuemapid": "4", "name": "APC Battery Replacement Status", "mappings": [ { "type": "0", "value": "1", "newvalue": "unknown" }, { "type": "0", "value": "2", "newvalue": "notInstalled" }, { "type": "0", "value": "3", "newvalue": "ok" }, { "type": "0", "value": "4", "newvalue": "failed" }, { "type": "0", "value": "5", "newvalue": "highTemperature" }, { "type": "0", "value": "6", "newvalue": "replaceImmediately" }, { "type": "0", "value": "7", "newvalue": "lowCapacity" } ] } ], "id": 1 } ``` #### بازیابی نقشه های ارزش بازیابی تمام نقشه های مقدار پیکربندی شده درخواست: ``json { "jsonrpc": "2.0"، "روش": "valuemap.get"، "params": { "output": "extend" }، "auth": "57562fd409b3b3b9a4d916d45207bbcb", "id": 1 } ``` واکنش: ``json { "jsonrpc": "2.0"، "نتیجه": [ { "valuemapid": "4"، "name": "وضعیت تعویض باتری APC" }، { "valuemapid": "5"، "name": "وضعیت باتری APC" }، { "valuemapid": "7"، "name": "وضعیت سیستم مدیریت باز Dell" } ]، "id": 1 } ``` یک نقشه مقدار را با نگاشتهای آن بازیابی کنید. درخواست: ``json { "jsonrpc": "2.0"، "روش": "valuemap.get"، "params": { "output": "extend" "selectMappings": "extend", "valuemapids": ["4"] }، "auth": "57562fd409b3b3b9a4d916d45207bbcb", "id": 1 } ``` واکنش: ``json { "jsonrpc": "2.0"، "نتیجه": [ { "valuemapid": "4"، "name": "وضعیت تعویض باتری APC"، "نقشه برداری": [ { "نوع": "0"، "ارزش": "1"، "newvalue": "ناشناخته" }، { "نوع": "0"، "ارزش": "2"، "newvalue": "notInstalled" }، { "نوع": "0"، "ارزش": "3"، "newvalue": "باشه" }، { "نوع": "0"، "ارزش": "4"، "newvalue": "شکست خورده" }، { "نوع": "0"، "ارزش": "5"، "newvalue": "HighTemperature" }، { "نوع": "0"، "ارزش": "6"، "newvalue": "replace فوری" }، { "نوع": "0"، "ارزش": "7"، "newvalue": "کم ظرفیت" } ] } ]، "id": 1 } ``` ### Return values `(array)` Returns an array of objects containing the ID of the generated token under the `tokenid` property and generated authorization string under `token` property. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |tokenid|string|ID of the token.| |token|string|The generated authorization string for this token.| ### مقادیر را برگردانید `(آرایه)` آرایه ای از اشیاء حاوی شناسه تولید شده را برمی گرداند توکن تحت ویژگی «tokenid» و رشته مجوز تولید شده تحت خاصیت "token". |مخصوص|[نوع](/manual/api/reference_commentary#data_types)|توضیحات| |--|--|------| |tokenid|رشته|شناسه توکن.| |token|string|رشته مجوز تولید شده برای این نشانه.| ### Return values `(array)` Returns an array with changes in configuration, that will be made. ### مقادیر را برمی گرداند `(آرایه)` یک آرایه را با تغییراتی در پیکربندی ساخته شده است را برمی گرداند ### Return values `(array)` Returns array with the names of updated parameters. ### مقادیر را برمی گرداند `(آرایه)` آرایه ای را با نام پارامترهای به روز شده برمی گرداند. ### Return values `(array)` Returns array with the names of updated parameters. ### مقادیر را برمی گرداند `(آرایه)` آرایه ای را با نام پارامترهای به روز شده برمی گرداند. ### Return values `(array)` Returns array with the names of updated parameters. ### مقادیر را برمی گرداند `(آرایه)` آرایه ای را با نام پارامترهای به روز شده برمی گرداند. ### Return values `(boolean )` Returns boolean true as result on successful update. ### مقادیر را برمی گرداند «(بولین)» در به‌روزرسانی موفقیت‌آمیز، بولین واقعی را برمی‌گرداند. ### Return values `(boolean)` Returns `true` if importing has been successful. ### مقادیر را برمی گرداند «(بولین)» اگر وارد کردن موفقیت آمیز باشد، «درست» را برمی‌گرداند. ### Return values `(boolean)` Returns `true` if the copying was successful. ### مقادیر را برمی گرداند ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### بازگشت مقادیر «(عدد صحیح/آرایه)» یکی را برمی‌گرداند: - آرایه ای از اشیاء؛ - تعداد اشیاء بازیابی شده، اگر پارامتر "countOutput" داشته باشد استفاده شده است. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### بازگشت مقادیر «(عدد صحیح/آرایه)» یکی را برمی‌گرداند: - آرایه ای از اشیاء؛ - تعداد اشیاء بازیابی شده، اگر پارامتر "countOutput" داشته باشد استفاده شده است. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### بازگشت مقادیر «(عدد صحیح/آرایه)» یکی را برمی‌گرداند: - آرایه ای از اشیاء؛ - تعداد اشیاء بازیابی شده، اگر پارامتر "countOutput" داشته باشد استفاده شده است. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### بازگشت مقادیر «(عدد صحیح/آرایه)» یکی را برمی‌گرداند: - آرایه ای از اشیاء؛ - تعداد اشیاء بازیابی شده، اگر پارامتر "countOutput" داشته باشد استفاده شده است. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### بازگشت مقادیر «(عدد صحیح/آرایه)» یکی را برمی‌گرداند: - آرایه ای از اشیاء؛ - تعداد اشیاء بازیابی شده، اگر پارامتر "countOutput" داشته باشد استفاده شده است. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### بازگشت مقادیر «(عدد صحیح/آرایه)» یکی را برمی‌گرداند: - آرایه ای از اشیاء؛ - تعداد اشیاء بازیابی شده، اگر پارامتر "countOutput" داشته باشد استفاده شده است. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### بازگشت مقادیر «(عدد صحیح/آرایه)» یکی را برمی‌گرداند: - آرایه ای از اشیاء؛ - تعداد اشیاء بازیابی شده، اگر پارامتر "countOutput" داشته باشد استفاده شده است. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### بازگشت مقادیر «(عدد صحیح/آرایه)» یکی را برمی‌گرداند: - آرایه ای از اشیاء؛ - تعداد اشیاء بازیابی شده، اگر پارامتر "countOutput" داشته باشد استفاده شده است. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### بازگشت مقادیر «(عدد صحیح/آرایه)» یکی را برمی‌گرداند: - آرایه ای از اشیاء؛ - تعداد اشیاء بازیابی شده، اگر پارامتر "countOutput" داشته باشد استفاده شده است. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### بازگشت مقادیر «(عدد صحیح/آرایه)» یکی را برمی‌گرداند: - آرایه ای از اشیاء؛ - تعداد اشیاء بازیابی شده، اگر پارامتر "countOutput" داشته باشد استفاده شده است. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### بازگشت مقادیر «(عدد صحیح/آرایه)» یکی را برمی‌گرداند: - آرایه ای از اشیاء؛ - تعداد اشیاء بازیابی شده، اگر پارامتر "countOutput" داشته باشد استفاده شده است. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### بازگشت مقادیر «(عدد صحیح/آرایه)» یکی را برمی‌گرداند: - آرایه ای از اشیاء؛ - تعداد اشیاء بازیابی شده، اگر پارامتر "countOutput" داشته باشد استفاده شده است. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### بازگشت مقادیر «(عدد صحیح/آرایه)» یکی را برمی‌گرداند: - آرایه ای از اشیاء؛ - تعداد اشیاء بازیابی شده، اگر پارامتر "countOutput" داشته باشد استفاده شده است. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### بازگشت مقادیر «(عدد صحیح/آرایه)» یکی را برمی‌گرداند: - آرایه ای از اشیاء؛ - تعداد اشیاء بازیابی شده، اگر پارامتر "countOutput" داشته باشد استفاده شده است. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### بازگشت مقادیر «(عدد صحیح/آرایه)» یکی را برمی‌گرداند: - آرایه ای از اشیاء؛ - تعداد اشیاء بازیابی شده، اگر پارامتر "countOutput" داشته باشد استفاده شده است. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### بازگشت مقادیر «(عدد صحیح/آرایه)» یکی را برمی‌گرداند: - آرایه ای از اشیاء؛ - تعداد اشیاء بازیابی شده، اگر پارامتر "countOutput" داشته باشد استفاده شده است. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### بازگشت مقادیر «(عدد صحیح/آرایه)» یکی را برمی‌گرداند: - آرایه ای از اشیاء؛ - تعداد اشیاء بازیابی شده، اگر پارامتر "countOutput" داشته باشد استفاده شده است. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### بازگشت مقادیر «(عدد صحیح/آرایه)» یکی را برمی‌گرداند: - آرایه ای از اشیاء؛ - تعداد اشیاء بازیابی شده، اگر پارامتر "countOutput" داشته باشد استفاده شده است. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ###بازگشت مقادیر `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### بازگشت مقادیر «(عدد صحیح/آرایه)» یکی را برمی‌گرداند: - آرایه ای از اشیاء؛ - تعداد اشیاء بازیابی شده، اگر پارامتر "countOutput" داشته باشد استفاده شده است. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### بازگشت مقادیر «(عدد صحیح/آرایه)» یکی را برمی‌گرداند: - آرایه ای از اشیاء؛ - تعداد اشیاء بازیابی شده، اگر پارامتر "countOutput" داشته باشد استفاده شده است. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### بازگشت مقادیر «(عدد صحیح/آرایه)» یکی را برمی‌گرداند: - آرایه ای از اشیاء؛ - تعداد اشیاء بازیابی شده، اگر پارامتر "countOutput" داشته باشد استفاده شده است. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### بازگشت مقادیر «(عدد صحیح/آرایه)» یکی را برمی‌گرداند: - آرایه ای از اشیاء؛ - تعداد اشیاء بازیابی شده، اگر پارامتر "countOutput" داشته باشد استفاده شده است. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### بازگشت مقادیر «(عدد صحیح/آرایه)» یکی را برمی‌گرداند: - آرایه ای از اشیاء؛ - تعداد اشیاء بازیابی شده، اگر پارامتر "countOutput" داشته باشد استفاده شده است. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### بازگشت مقادیر «(عدد صحیح/آرایه)» یکی را برمی‌گرداند: - آرایه ای از اشیاء؛ - تعداد اشیاء بازیابی شده، اگر پارامتر "countOutput" داشته باشد استفاده شده است. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### بازگشت مقادیر «(عدد صحیح/آرایه)» یکی را برمی‌گرداند: - آرایه ای از اشیاء؛ - تعداد اشیاء بازیابی شده، اگر پارامتر "countOutput" داشته باشد استفاده شده است. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### بازگشت مقادیر «(عدد صحیح/آرایه)» یکی را برمی‌گرداند: - آرایه ای از اشیاء؛ - تعداد اشیاء بازیابی شده، اگر پارامتر "countOutput" داشته باشد استفاده شده است. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### بازگشت مقادیر «(عدد صحیح/آرایه)» یکی را برمی‌گرداند: - آرایه ای از اشیاء؛ - تعداد اشیاء بازیابی شده، اگر پارامتر "countOutput" داشته باشد استفاده شده است. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### بازگشت مقادیر «(عدد صحیح/آرایه)» یکی را برمی‌گرداند: - آرایه ای از اشیاء؛ - تعداد اشیاء بازیابی شده، اگر پارامتر "countOutput" داشته باشد استفاده شده است. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### بازگشت مقادیر «(عدد صحیح/آرایه)» یکی را برمی‌گرداند: - آرایه ای از اشیاء؛ - تعداد اشیاء بازیابی شده، اگر پارامتر "countOutput" داشته باشد استفاده شده است. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### بازگشت مقادیر «(عدد صحیح/آرایه)» یکی را برمی‌گرداند: - آرایه ای از اشیاء؛ - تعداد اشیاء بازیابی شده، اگر پارامتر "countOutput" داشته باشد استفاده شده است. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### بازگشت مقادیر «(عدد صحیح/آرایه)» یکی را برمی‌گرداند: - آرایه ای از اشیاء؛ - تعداد اشیاء بازیابی شده، اگر پارامتر "countOutput" داشته باشد استفاده شده است. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### بازگشت مقادیر «(عدد صحیح/آرایه)» یکی را برمی‌گرداند: - آرایه ای از اشیاء؛ - تعداد اشیاء بازیابی شده، اگر پارامتر "countOutput" داشته باشد استفاده شده است. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### بازگشت مقادیر «(عدد صحیح/آرایه)» یکی را برمی‌گرداند: - آرایه ای از اشیاء؛ - تعداد اشیاء بازیابی شده، اگر پارامتر "countOutput" داشته باشد استفاده شده است. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### بازگشت مقادیر «(عدد صحیح/آرایه)» یکی را برمی‌گرداند: - آرایه ای از اشیاء؛ - تعداد اشیاء بازیابی شده، اگر پارامتر "countOutput" داشته باشد استفاده شده است. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### بازگشت مقادیر «(عدد صحیح/آرایه)» یکی را برمی‌گرداند: - آرایه ای از اشیاء؛ - تعداد اشیاء بازیابی شده، اگر پارامتر "countOutput" داشته باشد استفاده شده است. ### Return values `(object)` Returns an object containing the IDs of the cleared items under the `itemids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the cleared items under the `itemids` property. ### Return values `(object)` Returns an object containing the IDs of the created actions under the `actionids` property. The order of the returned IDs matches the order of the passed actions. ### برگشت مقادیر `(object)` یک شی حاوی شناسه اقدامات ایجاد شده را تحت خاصیت «شناسه اکشن » برمی گرداند . ترتیب شناسه های برگشتی با ترتیب اقدامات انجام شده مطابقت دارد ### Return values `(object)` Returns an object containing the IDs of the created correlations under the `correlationids` property. The order of the returned IDs matches the order of the passed correlations. ### مقادیر را برمی گرداند `(object)` یک شی حاوی شناسه های اسکریپت های ایجاد شده را تحت ویژگی "scriptids" برمی گرداند. ترتیب شناسه های برگشتی با ترتیب اسکریپت های پاس شده مطابقت دارد ### Return values `(object)` Returns an object containing the IDs of the created dashboards under the `dashboardids` property. The order of the returned IDs matches the order of the passed dashboards. ### برگشت مقادیر `(object)` یک شی حاوی شناسه اقدامات ایجاد شده را تحت خاصیت «شناسه اکشن » برمی گرداند . ترتیب شناسه های برگشتی با ترتیب اقدامات انجام شده مطابقت دارد ### Return values `(object)` Returns an object containing the IDs of the created discovery rules under the `druleids` property. The order of the returned IDs matches the order of the passed discovery rules. ### برگشت مقادیر `(object)` یک شی حاوی شناسه اقدامات ایجاد شده را تحت خاصیت «شناسه اکشن » برمی گرداند . ترتیب شناسه های برگشتی با ترتیب اقدامات انجام شده مطابقت دارد ### Return values `(object)` Returns an object containing the IDs of the created graph prototypes under the `graphids` property. The order of the returned IDs matches the order of the passed graph prototypes. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the created graph prototypes under the `graphids` property. The order of the returned IDs matches the order of the passed graph prototypes. ### Return values `(object)` Returns an object containing the IDs of the created graphs under the `graphids` property. The order of the returned IDs matches the order of the passed graphs. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the created graphs under the `graphids` property. The order of the returned IDs matches the order of the passed graphs. ### Return values `(object)` Returns an object containing the IDs of the created host groups under the `groupids` property. The order of the returned IDs matches the order of the passed host groups. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the created hosts under the `hostids` property. The order of the returned IDs matches the order of the passed hosts. ### Return values `(object)` Returns an object containing the IDs of the created host interfaces under the `interfaceids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the created host interfaces under the `interfaceids` property. ### Return values `(object)` Returns an object containing the IDs of the created host interfaces under the `interfaceids` property. ###بازگشت مقادیر `(object)` Returns an object containing the IDs of the created host interfaces under the `interfaceids` property. ### Return values `(object)` Returns an object containing the IDs of the created host interfaces under the `interfaceids` property. The order of the returned IDs matches the order of the passed host interfaces. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the created host interfaces under the `interfaceids` property. The order of the returned IDs matches the order of the passed host interfaces. ### Return values `(object)` Returns an object containing the IDs of the created host prototypes under the `hostids` property. The order of the returned IDs matches the order of the passed host prototypes. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the created host prototypes under the `hostids` property. The order of the returned IDs matches the order of the passed host prototypes. ### Return values `(object)` Returns an object containing the IDs of the created hosts under the `hostids` property. The order of the returned IDs matches the order of the passed hosts. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the created hosts under the `hostids` property. The order of the returned IDs matches the order of the passed hosts. ### Return values `(object)` Returns an object containing the IDs of the created icon maps under the `iconmapids` property. The order of the returned IDs matches the order of the passed icon maps. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the created icon maps under the `iconmapids` property. The order of the returned IDs matches the order of the passed icon maps. ### Return values `(object)` Returns an object containing the IDs of the created images under the `imageids` property. The order of the returned IDs matches the order of the passed images. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the created images under the `imageids` property. The order of the returned IDs matches the order of the passed images. ### Return values `(object)` Returns an object containing the IDs of the created item prototypes under the `itemids` property. The order of the returned IDs matches the order of the passed item prototypes. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the created host prototypes under the `hostids` property. The order of the returned IDs matches the order of the passed host prototypes. ### Return values `(object)` Returns an object containing the IDs of the created items under the `itemids` property. The order of the returned IDs matches the order of the passed items. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the created images under the `imageids` property. The order of the returned IDs matches the order of the passed images. ### Return values `(object)` Returns an object containing the IDs of the created LLD rules under the `itemids` property. The order of the returned IDs matches the order of the passed LLD rules. ### برگشت مقادیر `(object)` یک شی حاوی شناسه اقدامات ایجاد شده را تحت خاصیت «شناسه اکشن » برمی گرداند . ترتیب شناسه های برگشتی با ترتیب اقدامات انجام شده مطابقت دارد ### Return values `(object)` Returns an object containing the IDs of the created maintenances under the `maintenanceids` property. The order of the returned IDs matches the order of the passed maintenances. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the created host interfaces under the `interfaceids` property. The order of the returned IDs matches the order of the passed host interfaces. ### Return values `(object)` Returns an object containing the IDs of the created maps under the `sysmapids` property. The order of the returned IDs matches the order of the passed maps. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the created icon maps under the `iconmapids` property. The order of the returned IDs matches the order of the passed icon maps. ### Return values `(object)` Returns an object containing the IDs of the created media types under the `mediatypeids` property. The order of the returned IDs matches the order of the passed media types. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the created images under the `imageids` property. The order of the returned IDs matches the order of the passed images. ### Return values `(object)` Returns an object containing the IDs of the created proxies under the `proxyids` property. The order of the returned IDs matches the order of the passed proxies. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the created images under the `imageids` property. The order of the returned IDs matches the order of the passed images. ### Return values `(object)` Returns an object containing the IDs of the created regular expressions under the `regexpids` property. ###بازگشت مقادیر `(object)` Returns an object containing the IDs of the deleted graphs under the `graphids` property. ### Return values `(object)` Returns an object containing the IDs of the created scheduled reports under the `reportids` property. The order of the returned IDs matches the order of the passed scheduled reports. ### مقادیر را برمی گرداند `(object)` یک شی حاوی شناسه های اسکریپت های ایجاد شده را تحت ویژگی "scriptids" برمی گرداند. ترتیب شناسه های برگشتی با ترتیب اسکریپت های پاس شده مطابقت دارد ### Return values `(object)` Returns an object containing the IDs of the created scripts under the `scriptids` property. The order of the returned IDs matches the order of the passed scripts. ### مقادیر را برمی گرداند `(object)` یک شی حاوی شناسه های اسکریپت های ایجاد شده را تحت ویژگی "scriptids" برمی گرداند. ترتیب شناسه های برگشتی با ترتیب اسکریپت های پاس شده مطابقت دارد ### Return values `(object)` Returns an object containing the IDs of the created SLAs under the `slaids` property. The order of the returned IDs matches the order of the passed SLAs. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the created hosts under the `hostids` property. The order of the returned IDs matches the order of the passed hosts. ### Return values `(object)` Returns an object containing the IDs of the created tasks under the `taskids` property. One task is created for each item and low-level discovery rule. The order of the returned IDs matches the order of the passed `itemids`. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the created images under the `imageids` property. The order of the returned IDs matches the order of the passed images. ### Return values `(object)` Returns an object containing the IDs of the created template dashboards under the `dashboardids` property. The order of the returned IDs matches the order of the passed template dashboards. ### برگشت مقادیر `(object)` یک شی حاوی شناسه اقدامات ایجاد شده را تحت خاصیت «شناسه اکشن » برمی گرداند . ترتیب شناسه های برگشتی با ترتیب اقدامات انجام شده مطابقت دارد ### Return values `(object)` Returns an object containing the IDs of the created templates under the `templateids` property. The order of the returned IDs matches the order of the passed templates. ### برگشت مقادیر `(object)` یک شی حاوی شناسه اقدامات ایجاد شده را تحت خاصیت «شناسه اکشن » برمی گرداند . ترتیب شناسه های برگشتی با ترتیب اقدامات انجام شده مطابقت دارد ### Return values `(object)` Returns an object containing the IDs of the created value maps the `valuemapids` property. The order of the returned IDs matches the order of the passed value maps. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the created icon maps under the `iconmapids` property. The order of the returned IDs matches the order of the passed icon maps. ### Return values `(object)` Returns an object containing the IDs of the created web scenarios under the `httptestids` property. The order of the returned IDs matches the order of the passed web scenarios. ###بازگشت مقادیر `(object)` Returns an object containing the IDs of the created web scenarios under the `httptestids` property. The order of the returned IDs matches the order of the passed web scenarios. ### Return values `(object)` Returns an object containing the IDs of the deleted actions under the `actionids` property. ### بازگشت مقادیر `(object)` یک شی حاوی شناسه تحت خاصیت «actionids». اقدامات حذف شده را برمی گرداند ### Return values `(object)` Returns an object containing the IDs of the deleted correlations under the `correlationids` property. ### بازگشت مقادیر `(object)` یک شی حاوی شناسه های حذف شده را برمی گرداند همبستگی تحت خاصیت "correlationids". ### Return values `(object)` Returns an object containing the IDs of the deleted dashboards under the `dashboardids` property. ### بازگشت مقادیر `(object)` یک شی حاوی شناسه های به روز شده را تحت خاصیت "dashboardids" برمی گرداند ### Return values `(object)` Returns an object containing the IDs of the deleted discovery rules under the `druleids` property. ### بازگشت مقادیر `(object)` یک شی حاوی شناسه تحت خاصیت «actionids». اقدامات حذف شده را برمی گرداند ### Return values `(object)` Returns an object containing the IDs of the deleted graph prototypes under the `graphids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the deleted graph prototypes under the `graphids` property. ### Return values `(object)` Returns an object containing the IDs of the deleted graphs under the `graphids` property. ###بازگشت مقادیر `(object)` Returns an object containing the IDs of the deleted graphs under the `graphids` property. ### Return values `(object)` Returns an object containing the IDs of the deleted host groups under the `groupids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the deleted host groups under the `groupids` property. ### Return values `(object)` Returns an object containing the IDs of the deleted host interfaces under the `interfaceids` property. ###بازگشت مقادیر `(object)` Returns an object containing the IDs of the deleted host interfaces under the `interfaceids` property. ### Return values `(object)` Returns an object containing the IDs of the deleted host interfaces under the `interfaceids` property. ###بازگشت مقادیر `(object)` Returns an object containing the IDs of the deleted host interfaces under the `interfaceids` property. ### Return values `(object)` Returns an object containing the IDs of the deleted host prototypes under the `hostids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the deleted host prototypes under the `hostids` property. ### Return values `(object)` Returns an object containing the IDs of the deleted hosts under the `hostids` property. ###بازگشت مقادیر `(object)` Returns an object containing the IDs of the deleted hosts under the `hostids` property. ### Return values `(object)` Returns an object containing the IDs of the deleted icon maps under the `iconmapids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the deleted icon maps under the `iconmapids` property. ### Return values `(object)` Returns an object containing the IDs of the deleted images under the `imageids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the cleared items under the `itemids` property. ### Return values `(object)` Returns an object containing the IDs of the deleted item prototypes under the `prototypeids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the deleted host prototypes under the `hostids` property. ### Return values `(object)` Returns an object containing the IDs of the deleted items under the `itemids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the cleared items under the `itemids` property. ### Return values `(object)` Returns an object containing the IDs of the deleted maintenance periods under the `maintenanceids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the cleared items under the `itemids` property. ### Return values `(object)` Returns an object containing the IDs of the deleted maps under the `sysmapids` property. ###بازگشت مقادیر `(object)` Returns an object containing the IDs of the deleted graphs under the `graphids` property. ### Return values `(object)` Returns an object containing the IDs of the deleted proxies under the `proxyids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the updated hosts under the `hostids` property. ### Return values `(object)` Returns an object containing the IDs of the deleted regular expressions under the `regexpids` property. ###بازگشت مقادیر `(object)` Returns an object containing the IDs of the deleted graphs under the `graphids` property. ### Return values `(object)` Returns an object containing the IDs of the deleted scheduled reports under the `reportids` property. ###بازگشت مقادیر `(object)` Returns an object containing the IDs of the deleted graphs under the `graphids` property. ### Return values `(object)` Returns an object containing the IDs of the deleted scripts under the `scriptids` property. ###بازگشت مقادیر `(object)` Returns an object containing the IDs of the deleted graphs under the `graphids` property. ### Return values `(object)` Returns an object containing the IDs of the deleted tokens under the `tokenids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the cleared items under the `itemids` property. ### Return values `(object)` Returns an object containing the IDs of the deleted value maps under the `valuemapids` property. ### مقادیر را برمی گرداند `(object)` یک شی حاوی شناسه آیکون نقشه های به روز شده را برمی گرداند که تحت ویژگی "iconmapids" می باشد . ### Return values `(object)` Returns an object containing the IDs of the deleted web scenarios under the `httptestids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the deleted web scenarios under the `httptestids` property. ### Return values `(object)` Returns an object containing the IDs of the updated actions under the `actionids` property. ### بازگشت مقادیر `(object)` یک شی حاوی شناسه اقدامات به روز شده را برمی گرداند تحت خاصیت «اکشنیدز». ### Return values `(object)` Returns an object containing the IDs of the updated correlations under the `correlationids` property. ### بازگشت مقادیر `(object)` یک شی حاوی شناسه های به روز شده را برمی گرداند همبستگی تحت خاصیت "correlationids". ### Return values `(object)` Returns an object containing the IDs of the updated dashboards under the `dashboardids` property. ### بازگشت مقادیر `(object)` یک شی حاوی شناسه های به روز شده را برمی گرداند همبستگی تحت خاصیت "correlationids". ### Return values `(object)` Returns an object containing the IDs of the updated discovery rules under the `druleids` property. ### بازگشت مقادیر `(object)` یک شی حاوی شناسه تحت خاصیت «actionids». اقدامات حذف شده را برمی گرداند ### Return values `(object)` Returns an object containing the IDs of the updated events under the `eventids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the updated events under the `eventids` property. ### Return values `(object)` Returns an object containing the IDs of the updated global macros under the `globalmacroids` property. ### مقادیر را برمی گرداند `(object)` یک شی حاوی شناسه آیکون نقشه های به روز شده را برمی گرداند که تحت ویژگی "iconmapids" می باشد . ### Return values `(object)` Returns an object containing the IDs of the updated graph prototypes under the `graphids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the updated graph prototypes under the `graphids` property. ### Return values `(object)` Returns an object containing the IDs of the updated graphs under the `graphids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the updated graphs under the `graphids` property. ### Return values `(object)` Returns an object containing the IDs of the updated host groups under the `groupids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the updated host groups under the `groupids` property. ### Return values `(object)` Returns an object containing the IDs of the updated host groups under the `groupids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the updated host groups under the `groupids` property. ### Return values `(object)` Returns an object containing the IDs of the updated host groups under the `groupids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the updated host groups under the `groupids` property. ### Return values `(object)` Returns an object containing the IDs of the updated host groups under the `groupids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the updated host groups under the `groupids` property. ### Return values `(object)` Returns an object containing the IDs of the updated host interfaces under the `interfaceids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the updated host interfaces under the `interfaceids` property. ### Return values `(object)` Returns an object containing the IDs of the updated host prototypes under the `hostids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the updated host prototypes under the `hostids` property. ### Return values `(object)` Returns an object containing the IDs of the updated hosts under the `hostids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the updated hosts under the `hostids` property. ### Return values `(object)` Returns an object containing the IDs of the updated hosts under the `hostids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the updated hosts under the `hostids` property. ### Return values `(object)` Returns an object containing the IDs of the updated hosts under the `hostids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the updated hosts under the `hostids` property. ### Return values `(object)` Returns an object containing the IDs of the updated hosts under the `hostids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the updated hosts under the `hostids` property. ### Return values `(object)` Returns an object containing the IDs of the updated icon maps under the `iconmapids` property. ### مقادیر را برمی گرداند `(object)` یک شی حاوی شناسه آیکون نقشه های به روز شده را برمی گرداند که تحت ویژگی "iconmapids" می باشد . ### Return values `(object)` Returns an object containing the IDs of the updated images under the `imageids` property. `(object)` یک شی حاوی شناسه تصاویر حذف شده را در زیر ویژگی `imageids` برمی گرداند. ### Return values `(object)` Returns an object containing the IDs of the updated item prototypes under the `itemids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the updated host prototypes under the `hostids` property. ### Return values `(object)` Returns an object containing the IDs of the updated items under the `itemids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the cleared items under the `itemids` property. ### Return values `(object)` Returns an object containing the IDs of the updated LLD rules under the `itemids` property. ### بازگشت مقادیر `(object)` یک شی حاوی شناسه تحت خاصیت «actionids». اقدامات حذف شده را برمی گرداند ### Return values `(object)` Returns an object containing the IDs of the updated maintenances under the `maintenanceids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the cleared items under the `itemids` property. ### Return values `(object)` Returns an object containing the IDs of the updated media types under the `mediatypeids` property. `(object)` یک شی حاوی شناسه تصاویر حذف شده را در زیر ویژگی `imageids` برمی گرداند. ### Return values `(object)` Returns an object containing the IDs of the updated proxies under the `proxyids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the updated hosts under the `hostids` property. ### Return values `(object)` Returns an object containing the IDs of the updated regular expressions under the `regexpids` property. ###بازگشت مقادیر `(object)` Returns an object containing the IDs of the deleted graphs under the `graphids` property. ### Return values `(object)` Returns an object containing the IDs of the updated services under the `serviceids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the updated events under the `eventids` property. ### Return values `(object)` Returns an object containing the IDs of the updated SLAs under the `slaids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the updated hosts under the `hostids` property. ### Return values `(object)` Returns an object containing the IDs of the updated template dashboards under the `dashboardids` property. ### بازگشت مقادیر `(object)` یک شی حاوی شناسه های به روز شده را برمی گرداند همبستگی تحت خاصیت "correlationids". ### Return values `(object)` Returns an object containing the IDs of the updated templates under the `templateids` property. `(object)` یک شی حاوی شناسه تصاویر حذف شده را در زیر ویژگی `imageids` برمی گرداند. ### Return values `(object)` Returns an object containing the IDs of the updated templates under the `templateids` property. `(object)` یک شی حاوی شناسه تصاویر حذف شده را در زیر ویژگی `imageids` برمی گرداند. ### Return values `(object)` Returns an object containing the IDs of the updated trigger prototypes under the `triggerids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the updated host prototypes under the `hostids` property. ### Return values `(object)` Returns an object containing the IDs of the updated triggers under the `triggerids` property. `(object)` یک شی حاوی شناسه تصاویر حذف شده را در زیر ویژگی `imageids` برمی گرداند. ### Return values `(object)` Returns an object containing the IDs of the updated user groups under the `usrgrpids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the updated host groups under the `groupids` property. ### Return values `(object)` Returns an object containing the IDs of the updated value maps under the `valuemapids` property. ### مقادیر را برمی گرداند `(object)` یک شی حاوی شناسه آیکون نقشه های به روز شده را برمی گرداند که تحت ویژگی "iconmapids" می باشد . ### Return values `(object)` Returns an object containing the IDs of the updated web scenarios under the `httptestid` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the updated web scenarios under the `httptestid` property. ### Return values `(object)` Returns authentication object. ### مقادیر را برمی گرداند `(object)` شیء احراز هویت را برمی گرداند. ### Return values `(object)` Returns autoregistration object. ### مقادیر را برمی گرداند `(object)` شیء احراز هویت را برمی گرداند. ### Return values `(object)` Returns housekeeping object. ###بازگشت مقادیر `(object)` Returns housekeeping object. ### Return values `(object)` Returns the result of script execution. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |response|string|Whether the script was run successfully.<br><br>Possible value - `success`.| |value|string|Script output.| |debug|object|Contains a [debug object](/manual/api/reference/script/object#Debug) if a webhook script is executed. For other script types, it contains empty object.| ### مقادیر را برگردانید `(object)` نتیجه اجرای اسکریپت را برمی گرداند. |مخصوص|[نوع](/manual/api/reference_commentary#data_types)|توضیحات| |--|--|------| |response|string|آیا اسکریپت با موفقیت اجرا شد یا نه.<br><br>مقدار احتمالی - `موفقیت`.| |مقدار|رشته|خروجی اسکریپت.| |debug|object|در صورتی که یک اسکریپت webhook اجرا شود، حاوی یک [اشیاء اشکال زدایی](/manual/api/reference/script/object#Debug) است. برای سایر انواع اسکریپت، حاوی شی خالی است.| ### Return values `(string)` Returns a serialized string containing the requested configuration data. ### بازگشت مقادیر `(string)` یک رشته سریالی حاوی موارد درخواستی را برمی گرداند داده های پیکربندی ### Return values `(string)` Returns the version of the Zabbix API. ::: notetip Starting from Zabbix 2.0.4 the version of the API matches the version of Zabbix. ::: ### بازگشت مقادیر `(string)` نسخه Zabbix API را برمی گرداند. ::: یادداشت شروع از Zabbix 2.0.4 نسخه API با نسخه Zabbix مطابقت دارد. ::: #### role Changes:\ [ZBXNEXT-6787](https://support.zabbix.com/browse/ZBXNEXT-6787) added support of new properties `services.read.mode`, `services.read.list`, `services.read.tag`, `services.write.mode`, `services.write.list` and `services.write.tag`.\ [ZBXNEXT-3022](https://support.zabbix.com/browse/ZBXNEXT-3022) added support of name value `manage_services`.\ #### نقش تغییرات:\ [ZBXNEXT-6787](https://support.zabbix.com/browse/ZBXNEXT-6787) پشتیبانی از ویژگی‌های جدید «services.read.mode»، «services.read.list»، «services.read.tag» را اضافه کرد. ، "services.write.mode"، "services.write.list" و "services.write.tag". [ZBXNEXT-3022](https://support.zabbix.com/browse/ZBXNEXT-3022) پشتیبانی از مقدار نام «manage_services» را اضافه کرد.\ # role.get # role.get #### Run a custom script Run a "ping" script on a host. Request: ```json { "jsonrpc": "2.0", "method": "script.execute", "params": { "scriptid": "1", "hostid": "30079" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "response": "success", "value": "PING 127.0.0.1 (127.0.0.1) 56(84) bytes of data.\n64 bytes from 127.0.0.1: icmp_req=1 ttl=64 time=0.074 ms\n64 bytes from 127.0.0.1: icmp_req=2 ttl=64 time=0.030 ms\n64 bytes from 127.0.0.1: icmp_req=3 ttl=64 time=0.030 ms\n\n--- 127.0.0.1 ping statistics ---\n3 packets transmitted, 3 received, 0% packet loss, time 1998ms\nrtt min/avg/max/mdev = 0.030/0.044/0.074/0.022 ms\n", "debug": [] }, "id": 1 } ``` #### یک اسکریپت سفارشی را اجرا کنید یک اسکریپت "پینگ" را روی هاست اجرا کنید. درخواست: ``json { "jsonrpc": "2.0"، "روش": "script.execute"، "params": { "scriptid": "1"، "hostid": "30079" }، "auth": "038e1d7b1735c6a5436ee9eae095879e"، "id": 1 } ``` واکنش: ``json { "jsonrpc": "2.0"، "نتیجه": { "پاسخ": "موفقیت"، "value": "PING 127.0.0.1 (127.0.0.1) 56 (84) بایت داده.\n64 بایت از 127.0.0.1: icmp_req=1 ttl=64 time=0.074 ms\n64 بایت از 127.0.0.0. 2 ttl=64 time=0.030 ms\n64 بایت از 127.0.0.1: icmp_req=3 ttl=64 time=0.030 ms\n\n--- 127.0.0.1 آمار پینگ ---\n3 بسته ارسال شده، 3 بسته، 0 % از دست دادن بسته، زمان 1998ms\nrtt min/avg/max/mdev = 0.030/0.044/0.074/0.022 ms\n" "اشکال زدایی": [] }، "id": 1 } ``` #### Run a webhook script Run a webhook script that sends HTTP request to external service. Request: ```json { "jsonrpc": "2.0", "method": "script.execute", "params": { "scriptid": "4", "hostid": "30079" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "response": "success", "value": "{\"status\":\"sent\",\"timestamp\":\"1611235391\"}", "debug": { "logs": [ { "level": 3, "ms": 480, "message": "[Webhook Script] HTTP status: 200." } ], "ms": 495 } }, "id": 1 } ``` #### یک اسکریپت webhook را اجرا کنید یک اسکریپت webhook را اجرا کنید که درخواست HTTP را به سرویس خارجی ارسال می کند. درخواست: ``json { "jsonrpc": "2.0"، "روش": "script.execute"، "params": { "scriptid": "4"، "hostid": "30079" }، "auth": "038e1d7b1735c6a5436ee9eae095879e"، "id": 1 } ``` واکنش: ``json { "jsonrpc": "2.0"، "نتیجه": { "پاسخ": "موفقیت"، "value": "{\"وضعیت\":\"ارسال شده\",\"مهر زمانی\":\"1611235391\"}، "اشکال زدایی": { "logs": [ { "سطح 3، "ms": 480، "پیام": "وضعیت HTTP [اسکریپت وب هوک]: 200." } ]، "ms": 495 } }، "id": 1 } ``` #### Running proxy #### پروکسی در حال اجرا #### Running server #### سرور در حال اجرا ##### Runtime control With runtime control options you may change the log level of agent processes. |Option|Description|Target| |--|------|------| |log\_level\_increase\[=<target>\]|Increase log level.<br>If target is not specified, all processes are affected.|Target can be specified as:<br>**process type** - all processes of specified type (e.g., listener)<br>See all [agent process types](#agent_process_types).<br>**process type,N** - process type and number (e.g., listener,3)<br>**pid** - process identifier (1 to 65535). For larger values specify target as 'process-type,N'.| |log\_level\_decrease\[=<target>\]|Decrease log level.<br>If target is not specified, all processes are affected.|^| |userparameter\_reload|Reload values of the *UserParameter* and *Include* options from the current configuration file.| | Examples: - increasing log level of all processes - increasing log level of the third listener process - increasing log level of process with PID 1234 - decreasing log level of all active check processes ```{=html} <!-- --> ``` zabbix_agentd -R log_level_increase zabbix_agentd -R log_level_increase=listener,3 zabbix_agentd -R log_level_increase=1234 zabbix_agentd -R log_level_decrease="active checks" ::: noteclassic Runtime control is not supported on OpenBSD, NetBSD and Windows. ::: ##### کنترل زمان اجرا با گزینه های کنترل زمان اجرا می توانید سطح گزارش عامل را تغییر دهید فرآیندها |گزینه|توضیح|هدف| |--|------|------| |log\_level\_increase\[=<target>\]|سطح گزارش را افزایش دهید.<br>اگر هدف مشخص نشده باشد، همه فرآیندها تحت تأثیر قرار می‌گیرند.|هدف را می‌توان به این صورت مشخص کرد:<br>**نوع فرآیند** - همه فرآیندهای از نوع مشخص شده (به عنوان مثال، شنونده)<br>همه [انواع فرآیند عامل] (#agent_process_types) را ببینید.<br>**نوع فرآیند،N** - نوع و تعداد فرآیند (به عنوان مثال، شنونده،3)<br >**pid** - شناسه فرآیند (1 تا 65535). برای مقادیر بزرگتر، هدف را به عنوان 'process-type,N' مشخص کنید.| |log\_level\_decrease\[=<target>\]|سطح گزارش را کاهش دهید.<br>اگر هدف مشخص نشده باشد، همه فرآیندها تحت تأثیر قرار می‌گیرند.|^| |userparameter\_reload|مقادیر بارگذاری مجدد گزینه های *UserParameter* و *Include* از فایل پیکربندی فعلی.| | مثال ها: - افزایش سطح گزارش تمام فرآیندها - افزایش سطح گزارش فرآیند شنونده سوم - افزایش سطح گزارش فرآیند با PID 1234 - کاهش سطح گزارش تمام فرآیندهای بررسی فعال ```{=html} <!---> ``` zabbix_agentd -R log_level_increase zabbix_agentd -R log_level_increase=listener,3 zabbix_agentd -R log_level_increase=1234 zabbix_agentd -R log_level_decrease="چک های فعال" ::: نوتکلاسیک کنترل زمان اجرا در OpenBSD، NetBSD و پنجره ها. ::: ### Scenario step The scenario step object defines a specific web scenario check. It has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |httpstepid|string|*(readonly)* ID of the scenario step.| |**name**<br>(required)|string|Name of the scenario step.| |**no**<br>(required)|integer|Sequence number of the step in a web scenario.| |**url**<br>(required)|string|URL to be checked.| |follow\_redirects|integer|Whether to follow HTTP redirects.<br><br>Possible values are:<br>0 - don't follow redirects;<br>1 - *(default)* follow redirects.| |headers|array of [HTTP fields](/manual/api/reference/httptest/object#HTTP field)|HTTP headers that will be sent when performing a request. Scenario step headers will overwrite headers specified for the web scenario.| |httptestid|string|*(readonly)* ID of the web scenario that the step belongs to.| |posts|string<br>array of [HTTP fields](/manual/api/reference/httptest/object#HTTP field)|HTTP POST variables as a string (raw post data) or as an array of [HTTP fields](/manual/api/reference/httptest/object#HTTP field) (form field data).| |required|string|Text that must be present in the response.| |retrieve\_mode|integer|Part of the HTTP response that the scenario step must retrieve.<br><br>Possible values are:<br>0 - *(default)* only body;<br>1 - only headers;<br>2 - headers and body.| |status\_codes|string|Ranges of required HTTP status codes separated by commas.| |timeout|string|Request timeout in seconds. Accepts seconds, time unit with suffix and user macro.<br><br>Default: 15s. Maximum: 1h. Minimum: 1s.| |variables|array of [HTTP fields](/manual/api/reference/httptest/object#HTTP field)|Scenario step variables.| |query\_fields|array of [HTTP fields](/manual/api/reference/httptest/object#HTTP field)|Query fields - array of [HTTP fields](/manual/api/reference/httptest/object#HTTP field) that will be added to URL when performing a request| ### مراحل سناریو The scenario step object defines a specific web scenario check. It has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |httpstepid|string|*(readonly)* ID of the scenario step.| |**name**<br>(required)|string|Name of the scenario step.| |**no**<br>(required)|integer|Sequence number of the step in a web scenario.| |**url**<br>(required)|string|URL to be checked.| |follow\_redirects|integer|Whether to follow HTTP redirects.<br><br>Possible values are:<br>0 - don't follow redirects;<br>1 - *(default)* follow redirects.| |headers|array of [HTTP fields](/manual/api/reference/httptest/object#HTTP field)|HTTP headers that will be sent when performing a request. Scenario step headers will overwrite headers specified for the web scenario.| |httptestid|string|*(readonly)* ID of the web scenario that the step belongs to.| |posts|string<br>array of [HTTP fields](/manual/api/reference/httptest/object#HTTP field)|HTTP POST variables as a string (raw post data) or as an array of [HTTP fields](/manual/api/reference/httptest/object#HTTP field) (form field data).| |required|string|Text that must be present in the response.| |retrieve\_mode|integer|Part of the HTTP response that the scenario step must retrieve.<br><br>Possible values are:<br>0 - *(default)* only body;<br>1 - only headers;<br>2 - headers and body.| |status\_codes|string|Ranges of required HTTP status codes separated by commas.| |timeout|string|Request timeout in seconds. Accepts seconds, time unit with suffix and user macro.<br><br>Default: 15s. Maximum: 1h. Minimum: 1s.| |variables|array of [HTTP fields](/manual/api/reference/httptest/object#HTTP field)|Scenario step variables.| |query\_fields|array of [HTTP fields](/manual/api/reference/httptest/object#HTTP field)|Query fields - array of [HTTP fields](/manual/api/reference/httptest/object#HTTP field) that will be added to URL when performing a request| # script.create #ساخت اسکریپت # script.delete # script.delete # script.execute # script.delete #### Searching by host inventory data Retrieve hosts that contain "Linux" in the host inventory "OS" field. Request: ```json { "jsonrpc": "2.0", "method": "host.get", "params": { "output": [ "host" ], "selectInventory": [ "os" ], "searchInventory": { "os": "Linux" } }, "id": 2, "auth": "7f9e00124c75e8f25facd5c093f3e9a0" } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "hostid": "10084", "host": "Zabbix server", "inventory": { "os": "Linux Ubuntu" } }, { "hostid": "10107", "host": "Linux server", "inventory": { "os": "Linux Mint" } } ], "id": 1 } ``` #### جست و جو به وسیله دیتای پیداشده هاست ها Retrieve hosts that contain "Linux" in the host inventory "OS" field. Request: ```json { "jsonrpc": "2.0", "method": "host.get", "params": { "output": [ "host" ], "selectInventory": [ "os" ], "searchInventory": { "os": "Linux" } }, "id": 2, "auth": "7f9e00124c75e8f25facd5c093f3e9a0" } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "hostid": "10084", "host": "Zabbix server", "inventory": { "os": "Linux Ubuntu" } }, { "hostid": "10107", "host": "Linux server", "inventory": { "os": "Linux Mint" } } ], "id": 1 } ``` #### Searching by host tags Retrieve hosts that have tag "Host name" equal to "Linux server". Request: ```json { "jsonrpc": "2.0", "method": "host.get", "params": { "output": ["hostid"], "selectTags": "extend", "evaltype": 0, "tags": [ { "tag": "Host name", "value": "Linux server", "operator": 1 } ] }, "auth": "7f9e00124c75e8f25facd5c093f3e9a0", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "hostid": "10085", "tags": [ { "tag": "Host name", "value": "Linux server" }, { "tag": "OS", "value": "RHEL 7" } ] } ], "id": 1 } ``` Retrieve hosts that have these tags not only on host level but also in their linked parent templates. Request: ```json { "jsonrpc": "2.0", "method": "host.get", "params": { "output": ["name"], "tags": [{"tag": "A", "value": "1", "operator": "0"}], "inheritedTags": true }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "hostid": "10623", "name": "PC room 1" }, { "hostid": "10601", "name": "Office" } ], "id": 1 } ``` #### جست و جو به وسیله تگ های هاست Retrieve hosts that have tag "Host name" equal to "Linux server". Request: ```json { "jsonrpc": "2.0", "method": "host.get", "params": { "output": ["hostid"], "selectTags": "extend", "evaltype": 0, "tags": [ { "tag": "Host name", "value": "Linux server", "operator": 1 } ] }, "auth": "7f9e00124c75e8f25facd5c093f3e9a0", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "hostid": "10085", "tags": [ { "tag": "Host name", "value": "Linux server" }, { "tag": "OS", "value": "RHEL 7" } ] } ], "id": 1 } ``` Retrieve hosts that have these tags not only on host level but also in their linked parent templates. Request: ```json { "jsonrpc": "2.0", "method": "host.get", "params": { "output": ["name"], "tags": [{"tag": "A", "value": "1", "operator": "0"}], "inheritedTags": true }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "hostid": "10623", "name": "PC room 1" }, { "hostid": "10601", "name": "Office" } ], "id": 1 } ``` #### Searching by template tags Retrieve templates that have tag "Host name" equal to "{HOST.NAME}". Request: ```json { "jsonrpc": "2.0", "method": "template.get", "params": { "output": ["hostid"], "selectTags": "extend", "evaltype": 0, "tags": [ { "tag": "Host name", "value": "{HOST.NAME}", "operator": 1 } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "hostid": "10402", "tags": [ { "tag": "Host name", "value": "{HOST.NAME}" } ] } ], "id": 1 } ``` #### جست وجوی هاست با تگ و تمپلیت تگ Retrieve a host with tags and all tags that are linked to parent templates. Request: ```json { "jsonrpc": "2.0", "method": "host.get", "params": { "output": ["name"], "hostids": 10502, "selectTags": ["tag", "value"], "selectInheritedTags": ["tag", "value"] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "hostid": "10502", "name": "Desktop", "tags": [ { "tag": "A", "value": "1" } ], "inheritedTags": [ { "tag": "B", "value": "2" } ] } ], "id": 1 } ``` #### Searching for hosts using wildcards Find hosts whose name contains word "server" and have interface ports "10050" or "10071". Sort the result by host name in descending order and limit it to 5 hosts. Request: ```json { "jsonrpc": "2.0", "method": "host.get", "params": { "output": ["hostid", "host"], "selectInterfaces": ["port"], "filter": { "port": ["10050", "10071"] }, "search": { "host": "*server*" }, "searchWildcardsEnabled": true, "searchByAny": true, "sortfield": "host", "sortorder": "DESC", "limit": 5 }, "auth": "766b71ee543230a1182ca5c44d353e36", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "hostid": "50003", "host": "WebServer-Tomcat02", "interfaces": [ { "port": "10071" } ] }, { "hostid": "50005", "host": "WebServer-Tomcat01", "interfaces": [ { "port": "10071" } ] }, { "hostid": "50004", "host": "WebServer-Nginx", "interfaces": [ { "port": "10071" } ] }, { "hostid": "99032", "host": "MySQL server 01", "interfaces": [ { "port": "10050" } ] }, { "hostid": "99061", "host": "Linux server 01", "interfaces": [ { "port": "10050" } ] } ], "id": 1 } ``` #### جستجو برای میزبان با استفاده از Wildcard ها میزبان هایی را پیدا کنید که نام آنها حاوی کلمه "سرور" است و دارای پورت های "10050" یا "10071" هستند . . نتیجه را بر اساس نام میزبان به ترتیب نزولی مرتب کنید و آن را به 5 هاست محدود کنید. Request: ```json { "jsonrpc": "2.0", "method": "host.get", "params": { "output": ["hostid", "host"], "selectInterfaces": ["port"], "filter": { "port": ["10050", "10071"] }, "search": { "host": "*server*" }, "searchWildcardsEnabled": true, "searchByAny": true, "sortfield": "host", "sortorder": "DESC", "limit": 5 }, "auth": "766b71ee543230a1182ca5c44d353e36", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "hostid": "50003", "host": "WebServer-Tomcat02", "interfaces": [ { "port": "10071" } ] }, { "hostid": "50005", "host": "WebServer-Tomcat01", "interfaces": [ { "port": "10071" } ] }, { "hostid": "50004", "host": "WebServer-Nginx", "interfaces": [ { "port": "10071" } ] }, { "hostid": "99032", "host": "MySQL server 01", "interfaces": [ { "port": "10050" } ] }, { "hostid": "99061", "host": "Linux server 01", "interfaces": [ { "port": "10050" } ] } ], "id": 1 } ``` #### Searching for hosts using wildcards with "preservekeys" If you add the parameter "preservekeys" to the previous request, the result is returned as an associative array, where the keys are the id of the objects. Request: ```json { "jsonrpc": "2.0", "method": "host.get", "params": { "output": ["hostid", "host"], "selectInterfaces": ["port"], "filter": { "port": ["10050", "10071"] }, "search": { "host": "*server*" }, "searchWildcardsEnabled": true, "searchByAny": true, "sortfield": "host", "sortorder": "DESC", "limit": 5, "preservekeys": true }, "auth": "766b71ee543230a1182ca5c44d353e36", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "50003": { "hostid": "50003", "host": "WebServer-Tomcat02", "interfaces": [ { "port": "10071" } ] }, "50005": { "hostid": "50005", "host": "WebServer-Tomcat01", "interfaces": [ { "port": "10071" } ] }, "50004": { "hostid": "50004", "host": "WebServer-Nginx", "interfaces": [ { "port": "10071" } ] }, "99032": { "hostid": "99032", "host": "MySQL server 01", "interfaces": [ { "port": "10050" } ] }, "99061": { "hostid": "99061", "host": "Linux server 01", "interfaces": [ { "port": "10050" } ] } }, "id": 1 } ``` #### جستجو برای میزبان ها با استفاده از حروف Wildcard ها با "preservekeys" اگر پارامتر "preservekeys" را به درخواست قبلی اضافه کنید، نتیجه به عنوان یک آرایه انجمنی بازگردانده می شود که در آن کلیدها شناسه اشیاء هستند. Request: ```json { "jsonrpc": "2.0", "method": "host.get", "params": { "output": ["hostid", "host"], "selectInterfaces": ["port"], "filter": { "port": ["10050", "10071"] }, "search": { "host": "*server*" }, "searchWildcardsEnabled": true, "searchByAny": true, "sortfield": "host", "sortorder": "DESC", "limit": 5, "preservekeys": true }, "auth": "766b71ee543230a1182ca5c44d353e36", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "50003": { "hostid": "50003", "host": "WebServer-Tomcat02", "interfaces": [ { "port": "10071" } ] }, "50005": { "hostid": "50005", "host": "WebServer-Tomcat01", "interfaces": [ { "port": "10071" } ] }, "50004": { "hostid": "50004", "host": "WebServer-Nginx", "interfaces": [ { "port": "10071" } ] }, "99032": { "hostid": "99032", "host": "MySQL server 01", "interfaces": [ { "port": "10050" } ] }, "99061": { "hostid": "99061", "host": "Linux server 01", "interfaces": [ { "port": "10050" } ] } }, "id": 1 } ``` #### Searching hosts by problem severity Retrieve hosts that have "Disaster" problems. Request: ```json { "jsonrpc": "2.0", "method": "host.get", "params": { "output": ["name"], "severities": 5 }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "hostid": "10160", "name": "Zabbix server" } ], "id": 1 } ``` Retrieve hosts that have "Average" and "High" problems. Request: ```json { "jsonrpc": "2.0", "method": "host.get", "params": { "output": ["name"], "severities": [3, 4] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "hostid": "20170", "name": "Database" }, { "hostid": "20183", "name": "workstation" } ], "id": 1 } ``` #### جست و جوی هاست به وسیله سطح آلارم Retrieve hosts that have "Disaster" problems. Request: ```json { "jsonrpc": "2.0", "method": "host.get", "params": { "output": ["name"], "severities": 5 }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "hostid": "10160", "name": "Zabbix server" } ], "id": 1 } ``` Retrieve hosts that have "Average" and "High" problems. Request: ```json { "jsonrpc": "2.0", "method": "host.get", "params": { "output": ["name"], "severities": [3, 4] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "hostid": "20170", "name": "Database" }, { "hostid": "20183", "name": "workstation" } ], "id": 1 } ``` #### Searching host with tags and template tags Retrieve a host with tags and all tags that are linked to parent templates. Request: ```json { "jsonrpc": "2.0", "method": "host.get", "params": { "output": ["name"], "hostids": 10502, "selectTags": ["tag", "value"], "selectInheritedTags": ["tag", "value"] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "hostid": "10502", "name": "Desktop", "tags": [ { "tag": "A", "value": "1" } ], "inheritedTags": [ { "tag": "B", "value": "2" } ] } ], "id": 1 } ``` #### جست وجوی هاست با تگ و تمپلیت تگ Retrieve a host with tags and all tags that are linked to parent templates. Request: ```json { "jsonrpc": "2.0", "method": "host.get", "params": { "output": ["name"], "hostids": 10502, "selectTags": ["tag", "value"], "selectInheritedTags": ["tag", "value"] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "hostid": "10502", "name": "Desktop", "tags": [ { "tag": "A", "value": "1" } ], "inheritedTags": [ { "tag": "B", "value": "2" } ] } ], "id": 1 } ``` ### See also 1. [Differences in the Zabbix agent configuration for active and passive checks starting from version 2.0.0](http://blog.zabbix.com/multiple-servers-for-active-agent-sure/858). ### همچنین ببینید 1. [تفاوت در پیکربندی عامل Zabbix برای فعال و بررسی های غیرفعال از نسخه شروع می شود 2.0.0](http://blog.zabbix.com/multiple-servers-for-active-agent-sure/858). ### See also - [Action filter](object#action_filter) - [Action operation](object#action_operation) ### همچنین ببینید - [Action filter](object#action_filter) - [عملیات عمل] (شیء#عمل_عملی) ### See also - [Action filter](object#action_filter) - [Action operation](object#action_operation) ### همچنین ببینید - [Action filter](object#action_filter) - [عملیات عمل] (شیء#عمل_عملی) ### See also - [Action filter](object#action_filter) - [Action operation](object#action_operation) ### همچنین ببینید - [Action filter](object#action_filter) - [عملیات عمل] (شیء#عمل_عملی) ### See also - [Alert](/manual/api/reference/alert/object) - [Item](/manual/api/reference/item/object) - [Host](/manual/api/reference/host/object) - [LLD rule](/manual/api/reference/discoveryrule/object#lld_rule) - [Trigger](/manual/api/reference/trigger/object) ### همچنین ببینید - [Alert](/manual/api/reference/alert/object) - [Item](/manual/api/reference/item/object) - [Host](/manual/api/reference/host/object) - [LLD rule](/manual/api/reference/discoveryrule/object#lld_rule) - [Trigger](/manual/api/reference/trigger/object) ### See also - [Alert](/manual/api/reference/alert/object) - [Item](/manual/api/reference/item/object) - [Host](/manual/api/reference/host/object) - [LLD rule](/manual/api/reference/discoveryrule/object#lld_rule) - [Trigger](/manual/api/reference/trigger/object) ### همچنین ببینید - [Alert](/manual/api/reference/alert/object) - [Item](/manual/api/reference/item/object) - [Host](/manual/api/reference/host/object) - [LLD rule](/manual/api/reference/discoveryrule/object#lld_rule) - [Trigger](/manual/api/reference/trigger/object) ### See also - [Audit log object](/manual/api/reference/auditlog/object) ### همچنین ببینید - [ابژه گزارش حسابرسی](/دستی/api/reference/auditlog/object) ### See also - [Correlation filter](object#correlation_filter) - [Correlation operation](object#correlation_operation) ### همچنین ببینید - [فیلتر همبستگی](شیء#همبستگی_فیلتر) - [عملیات همبستگی] (object#correlation_operation) ### See also - [Correlation filter](object#correlation_filter) - [Correlation operation](object#correlation_operation) ### همچنین ببینید - [فیلتر همبستگی](شیء#همبستگی_فیلتر) - [عملیات همبستگی] (object#correlation_operation) ### See also - [Correlation filter](object#correlation_filter) - [Correlation operation](object#correlation_operation) ### همچنین ببینید - [فیلتر همبستگی](شیء#همبستگی_فیلتر) - [عملیات همبستگی] (object#correlation_operation) ### See also - [Dashboard page](object#dashboard_page) - [Dashboard widget](object#dashboard_widget) - [Dashboard widget field](object#dashboard_widget_field) - [Dashboard user](object#dashboard_user) - [Dashboard user group](object#dashboard_user_group) ###همچنین ببینید : - [Dashboard page](object#dashboard_page) - [Dashboard widget](object#dashboard_widget) - [Dashboard widget field](object#dashboard_widget_field) - [Dashboard user](object#dashboard_user) - [Dashboard user group](object#dashboard_user_group) ### See also - [Dashboard page](object#dashboard_page) - [Dashboard widget](object#dashboard_widget) - [Dashboard widget field](object#dashboard_widget_field) - [Dashboard user](object#dashboard_user) - [Dashboard user group](object#dashboard_user_group) ###همچنین ببینید : - [Dashboard page](object#dashboard_page) - [Dashboard widget](object#dashboard_widget) - [Dashboard widget field](object#dashboard_widget_field) - [Dashboard user](object#dashboard_user) - [Dashboard user group](object#dashboard_user_group) ### See also - [Dashboard page](object#dashboard_page) - [Dashboard widget](object#dashboard_widget) - [Dashboard widget field](object#dashboard_widget_field) - [Dashboard user](object#dashboard_user) - [Dashboard user group](object#dashboard_user_group) ###همچنین ببینید : - [Dashboard page](object#dashboard_page) - [Dashboard widget](object#dashboard_widget) - [Dashboard widget field](object#dashboard_widget_field) - [Dashboard user](object#dashboard_user) - [Dashboard user group](object#dashboard_user_group) ### See also - [Dashboard widget field](/manual/api/reference/dashboard/object#dashboard-widget-field) - [`dashboard.create`](/manual/api/reference/dashboard/create) - [`dashboard.update`](/manual/api/reference/dashboard/update) ### همچنین ببینید - [فیلد ویجت داشبورد](/دستی/آپی/مرجع/داشبورد/شیء#فیلد-ویجت-داشبورد) - [`dashboard.create`](/manual/api/reference/dashboard/create) - [`dashboard.update`](/manual/api/reference/dashboard/update) ### See also - [Dashboard widget field](/manual/api/reference/dashboard/object#dashboard-widget-field) - [`dashboard.create`](/manual/api/reference/dashboard/create) - [`dashboard.update`](/manual/api/reference/dashboard/update) ### همچنین ببینید - [فیلد ویجت داشبورد](/دستی/آپی/مرجع/داشبورد/شیء#فیلد-ویجت-داشبورد) - [`dashboard.create`](/manual/api/reference/dashboard/create) - [`dashboard.update`](/manual/api/reference/dashboard/update) ### See also - [Discovered host](/manual/api/reference/dhost/object#discovered_host) - [Discovery check](/manual/api/reference/dcheck/object#discovery_check) ### همچنین ببینید - [Discovered host](/manual/api/reference/dhost/object#discovered_host) - [Discovery check](/manual/api/reference/dcheck/object#discovery_check) ### See also - [Discovered host](/manual/api/reference/dhost/object#discovered_host) - [Discovery check](/manual/api/reference/dcheck/object#discovery_check) - [Host](/manual/api/reference/host/object#host) ### همچنین ببینید - [Discovered host](/manual/api/reference/dhost/object#discovered_host) - [Discovery check](/manual/api/reference/dcheck/object#discovery_check) - [Host](/manual/api/reference/host/object#host) ### See also - [Discovered service](/manual/api/reference/dservice/object#discovered_service) - [Discovery rule](/manual/api/reference/drule/object#discovery_rule) ### همچنین ببینید - [Discovered service](/manual/api/reference/dservice/object#discovered_service) - [Discovery rule](/manual/api/reference/drule/object#discovery_rule) ### See also - [Discovery check](/manual/api/reference/dcheck/object#discovery_check) ### همچنین ببینید - [Discovery check](/manual/api/reference/dcheck/object#discovery_check) ### See also - [Discovery check](/manual/api/reference/dcheck/object#discovery_check) ### همچنین ببینید - [Discovery check](/manual/api/reference/dcheck/object#discovery_check) ### See also - [Discovery rule](/manual/api/reference/discoveryrule/object#discovery_rule) - [Graph item](/manual/api/reference/graphitem/object#graph_item) - [Item](/manual/api/reference/item/object#item) - [Host](/manual/api/reference/host/object#host) - [Host group](/manual/api/reference/hostgroup/object#host_group) - [Template](/manual/api/reference/template/object#template) ###همچنین ببینید - [Discovery rule](/manual/api/reference/discoveryrule/object#discovery_rule) - [Graph item](/manual/api/reference/graphitem/object#graph_item) - [Item](/manual/api/reference/item/object#item) - [Host](/manual/api/reference/host/object#host) - [Host group](/manual/api/reference/hostgroup/object#host_group) - [Template](/manual/api/reference/template/object#template) ### See also - [Discovery rule](/manual/api/reference/discoveryrule/object#discovery_rule) - [Graph item](/manual/api/reference/graphitem/object#graph_item) - [Item](/manual/api/reference/item/object#item) - [Host](/manual/api/reference/host/object#host) - [Host group](/manual/api/reference/hostgroup/object#host_group) - [Template](/manual/api/reference/template/object#template) ###همچنین ببینید - [Discovery rule](/manual/api/reference/discoveryrule/object#discovery_rule) - [Graph item](/manual/api/reference/graphitem/object#graph_item) - [Item](/manual/api/reference/item/object#item) - [Host](/manual/api/reference/host/object#host) - [Host group](/manual/api/reference/hostgroup/object#host_group) - [Template](/manual/api/reference/template/object#template) ### See also - [Discovery rule](/manual/api/reference/discoveryrule/object#discovery_rule) - [Graph](/manual/api/reference/graph/object#graph) - [Host](/manual/api/reference/host/object#host) - [Host interface](/manual/api/reference/hostinterface/object#host_interface) - [Trigger](/manual/api/reference/trigger/object#trigger) ###همچنین ببینید - [Discovery rule](/manual/api/reference/discoveryrule/object#discovery_rule) - [Graph item](/manual/api/reference/graphitem/object#graph_item) - [Item](/manual/api/reference/item/object#item) - [Host](/manual/api/reference/host/object#host) - [Host group](/manual/api/reference/hostgroup/object#host_group) - [Template](/manual/api/reference/template/object#template) ### See also - [Discovery rule](/manual/api/reference/discoveryrule/object#discovery_rule) - [Item](/manual/api/reference/item/object#item) - [Host](/manual/api/reference/host/object#host) - [Host group](/manual/api/reference/hostgroup/object#host_group) ###همچنین ببینید - [Discovery rule](/manual/api/reference/discoveryrule/object#discovery_rule) - [Graph item](/manual/api/reference/graphitem/object#graph_item) - [Item](/manual/api/reference/item/object#item) - [Host](/manual/api/reference/host/object#host) - [Host group](/manual/api/reference/hostgroup/object#host_group) - [Template](/manual/api/reference/template/object#template) ## SEE ALSO Documentation <https://www.zabbix.com/manuals> **[zabbix\_agent2](zabbix_agent2)**(8), **[zabbix\_agentd](zabbix_agentd)**(8), **[zabbix\_get](zabbix_get)**(1), **[zabbix\_proxy](zabbix_proxy)**(8), **[zabbix\_sender](zabbix_sender)**(1), **[zabbix\_server](zabbix_server)**(8) ------------------------------------------------------------------------ [ ]{#index} ## همچنین ببینید مستندات <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8)، ***[zabbix\_get](zabbix_get)**(8)، **[zabbix\_js](zabbix_js)**(8)، **[zabbix\_proxy](zabbix_proxy)**(8) **[zabbix\_sender](zabbix_sender)**(8) ***[zabbix\_server](zabbix_server)**(8) [ ]{#lbAI} ## SEE ALSO Documentation <https://www.zabbix.com/manuals> **[zabbix\_agent2](zabbix_agent2)**(8), **[zabbix\_get](zabbix_get)**(1), **[zabbix\_js](zabbix_js)**(1), **[zabbix\_proxy](zabbix_proxy)**(8), **[zabbix\_sender](zabbix_sender)**(1), **[zabbix\_server](zabbix_server)**(8) [ ]{#lbAJ} ## همچنین ببینید مستندات <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8)، ***[zabbix\_get](zabbix_get)**(8)، **[zabbix\_js](zabbix_js)**(8)، **[zabbix\_proxy](zabbix_proxy)**(8) **[zabbix\_sender](zabbix_sender)**(8) ***[zabbix\_server](zabbix_server)**(8) [ ]{#lbAI} ## SEE ALSO Documentation <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8), **[zabbix\_get](zabbix_get)**(1), **[zabbix\_proxy](zabbix_proxy)**(8), **[zabbix\_sender](zabbix_sender)**(1), **[zabbix\_js](zabbix_js)**(1), **[zabbix\_agent2](zabbix_agent2)**(8) [ ]{#lbAJ} ## همچنین ببینید مستندات <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8)، ***[zabbix\_get](zabbix_get)**(1)، **[zabbix\_proxy](zabbix_proxy)**(8)، ***[zabbix\_sender](zabbix_sender)**(1)، **[zabbix\_js](zabbix_js)**(1)، ***[zabbix\_agent2](zabbix_agent2)**(8) [ ]{#lbAJ} ## SEE ALSO Documentation <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8), **[zabbix\_get](zabbix_get)**(1), **[zabbix\_proxy](zabbix_proxy)**(8), **[zabbix\_sender](zabbix_sender)**(1), **[zabbix\_server](zabbix_server)**(8), **[zabbix\_js](zabbix_js)**(1), **[zabbix\_agent2](zabbix_agent2)**(8) [ ]{#lbAH} ## همچنین ببینید مستندات <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8)، ***[zabbix\_get](zabbix_get)**(1)، **[zabbix\_proxy](zabbix_proxy)**(8)، **[zabbix\_sender](zabbix_sender)**(1)، **[zabbix\_server](zabbix_server)**(8)، **[zabbix\_js](zabbix_js)**(1)، ***[zabbix\_agent2](zabbix_agent2)**(8) [ ]{#lbAH} ## SEE ALSO Documentation <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8), **[zabbix\_get](zabbix_get)**(1), **[zabbix\_proxy](zabbix_proxy)**(8), **[zabbix\_server](zabbix_server)**(8), **[zabbix\_js](zabbix_js)**(1), **[zabbix\_agent2](zabbix_agent2)**(8), **[zabbix\_web\_service](zabbix_web_service)**(8) [ ]{#lbAJ} ## همچنین ببینید مستندات <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8)، ***[zabbix\_get](zabbix_get)**(8)، **[zabbix\_js](zabbix_js)**(8)، **[zabbix\_proxy](zabbix_proxy)**(8) **[zabbix\_sender](zabbix_sender)**(8) ***[zabbix\_server](zabbix_server)**(8) [ ]{#lbAI} ## SEE ALSO Documentation <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8), **[zabbix\_get](zabbix_get)**(1), **[zabbix\_sender](zabbix_sender)**(1), **[zabbix\_server](zabbix_server)**(8), **[zabbix\_js](zabbix_js)**(1), **[zabbix\_agent2](zabbix_agent2)**(8) [ ]{#lbAJ} ## همچنین ببینید مستندات <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8)، ***[zabbix\_get](zabbix_get)**(8)، **[zabbix\_js](zabbix_js)**(8)، **[zabbix\_proxy](zabbix_proxy)**(8) **[zabbix\_sender](zabbix_sender)**(8) ***[zabbix\_server](zabbix_server)**(8) [ ]{#lbAI} ## SEE ALSO Documentation <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8), **[zabbix\_get](zabbix_get)**(8), **[zabbix\_js](zabbix_js)**(8), **[zabbix\_proxy](zabbix_proxy)**(8), **[zabbix\_sender](zabbix_sender)**(8), **[zabbix\_server](zabbix_server)**(8) [ ]{#lbAI} ## همچنین ببینید مستندات <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8)، ***[zabbix\_get](zabbix_get)**(8)، **[zabbix\_js](zabbix_js)**(8)، **[zabbix\_proxy](zabbix_proxy)**(8) **[zabbix\_sender](zabbix_sender)**(8) ***[zabbix\_server](zabbix_server)**(8) [ ]{#lbAI} ## SEE ALSO Documentation <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8), **[zabbix\_proxy](zabbix_proxy)**(8), **[zabbix\_sender](zabbix_sender)**(1), **[zabbix\_server](zabbix_server)**(8), **[zabbix\_js](zabbix_js)**(1), **[zabbix\_agent2](zabbix_agent2)**(8), **[zabbix\_web\_service](zabbix_web_service)**(8) [ ]{#lbAI} ## همچنین ببینید مستندات <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8)، ***[zabbix\_get](zabbix_get)**(8)، **[zabbix\_js](zabbix_js)**(8)، **[zabbix\_proxy](zabbix_proxy)**(8) **[zabbix\_sender](zabbix_sender)**(8) ***[zabbix\_server](zabbix_server)**(8) [ ]{#lbAI} ### See also - [Graph item](/manual/api/reference/graphitem/object#graph_item) ### همچنین ببینید - [Graph item](/manual/api/reference/graphitem/object#graph_item) ### See also - [Graph item](/manual/api/reference/graphitem/object#graph_item) ### همچنین ببینید - [Graph item](/manual/api/reference/graphitem/object#graph_item) ### See also - [Graph](/manual/api/reference/graph/object#graph) ### همچنین ببینید - [Graph item](/manual/api/reference/graphitem/object#graph_item) ### See also - [Graph prototype](/manual/api/reference/graphprototype/object#graph_prototype) - [Host](/manual/api/reference/host/object#host) - [Item prototype](/manual/api/reference/itemprototype/object#item_prototype) - [LLD rule filter](object#lld_rule_filter) - [Trigger prototype](/manual/api/reference/triggerprototype/object#trigger_prototype) ### همچنین ببینید - [Graph prototype](/manual/api/reference/graphprototype/object#graph_prototype) - [Host](/manual/api/reference/host/object#host) - [Item prototype](/manual/api/reference/itemprototype/object#item_prototype) - [LLD rule filter](object#lld_rule_filter) - [Trigger prototype](/manual/api/reference/triggerprototype/object#trigger_prototype) ### See also - [Group link](object#group_link) - [Group prototype](object#group_prototype) - [Host prototype tag](object#host_prototype_tag) - [Custom interface](object#custom_interface) - [User macro](/manual/api/reference/usermacro/object#hosttemplate_level_macro) ###همچنین ببینید - [Group link](object#group_link) - [Group prototype](object#group_prototype) - [Host prototype tag](object#host_prototype_tag) - [Custom interface](object#custom_interface) - [User macro](/manual/api/reference/usermacro/object#hosttemplate_level_macro) ### See also - [Group link](object#group_link) - [Group prototype](object#group_prototype) - [Host prototype tag](object#host_prototype_tag) - [Custom interface](object#custom_interface) - [User macro](/manual/api/reference/usermacro/object#hosttemplate_level_macro) ### همچنین ببینید - [Group link](object#group_link) - [Group prototype](object#group_prototype) - [Host prototype tag](object#host_prototype_tag) - [Custom interface](object#custom_interface) - [User macro](/manual/api/reference/usermacro/object#hosttemplate_level_macro) ### See also - [Group link](object#group_link) - [Group prototype](object#group_prototype) - [User macro](/manual/api/reference/usermacro/object#hosttemplate_level_macro) ###همچنین ببینید - [Group link](object#group_link) - [Group prototype](object#group_prototype) - [User macro](/manual/api/reference/usermacro/object#hosttemplate_level_macro) ### See also - [Host group](/manual/api/reference/hostgroup/object#host_group) - [Template](/manual/api/reference/template/object#template) - [User macro](/manual/api/reference/usermacro/object#hosttemplate_level_macro) - [Host interface](/manual/api/reference/hostinterface/object#host_interface) ### همچنین ببینید - [Host group](/manual/api/reference/hostgroup/object#host_group) - [Template](/manual/api/reference/template/object#template) - [User macro](/manual/api/reference/usermacro/object#hosttemplate_level_macro) - [Host interface](/manual/api/reference/hostinterface/object#host_interface) - [Host inventory](object#host_inventory) - [Host tag](object#host_tag) ### See also - [Host group](/manual/api/reference/hostgroup/object#host_group) - [Template](/manual/api/reference/template/object#template) - [User macro](/manual/api/reference/usermacro/object#hosttemplate_level_macro) - [Host interface](/manual/api/reference/hostinterface/object#host_interface) - [Host inventory](object#host_inventory) - [Host tag](object#host_tag) ### همچنین ببینید - [Host group](/manual/api/reference/hostgroup/object#host_group) - [Template](/manual/api/reference/template/object#template) - [User macro](/manual/api/reference/usermacro/object#hosttemplate_level_macro) - [Host interface](/manual/api/reference/hostinterface/object#host_interface) - [Host inventory](object#host_inventory) - [Host tag](object#host_tag) ### See also - [Host group](/manual/api/reference/hostgroup/object#host_group) - [Template](object#template) - [User macro](/manual/api/reference/usermacro/object#hosttemplate_level_macro) - [Host interface](/manual/api/reference/hostinterface/object#host_interface) ### همچنین ببینید - [Host group](/manual/api/reference/hostgroup/object#host_group) - [Template](/manual/api/reference/template/object#template) - [User macro](/manual/api/reference/usermacro/object#hosttemplate_level_macro) - [Host interface](/manual/api/reference/hostinterface/object#host_interface) - [Host inventory](object#host_inventory) - [Host tag](object#host_tag) ### See also - [hostgroup.update](update) - [hostgroup.massadd](massadd) - [Host](/manual/api/reference/host/object#host) - [Template](/manual/api/reference/template/object#template) ### همچنین ببینید - [hostgroup.update](update) - [hostgroup.massadd](massadd) - [Host](/manual/api/reference/host/object#host) - [Template](/manual/api/reference/template/object#template) ### See also - [hostinterface.create](create) - [host.massadd](/manual/api/reference/host/massadd) - [Host](/manual/api/reference/host/object#host) ### همچنین ببینید - [hostinterface.create](create) - [host.massadd](/manual/api/reference/host/massadd) - [Host](/manual/api/reference/host/object#host) ### See also - [hostinterface.delete](delete) - [host.massremove](/manual/api/reference/host/massremove) ### همچنین ببینید - [hostinterface.delete](delete) - [host.massremove](/manual/api/reference/host/massremove) ### See also - [hostinterface.massadd](massadd) - [host.massadd](/manual/api/reference/host/massadd) ### همچنین ببینید - [hostinterface.massadd](massadd) - [host.massadd](/manual/api/reference/host/massadd) ### See also - [hostinterface.massremove](massremove) - [host.massremove](/manual/api/reference/host/massremove) ### همچنین ببینید - [hostinterface.massremove](massremove) - [host.massremove](/manual/api/reference/host/massremove) ### See also - [Host](/manual/api/reference/host/object#host) - [Graph prototype](/manual/api/reference/graphprototype/object#graph_prototype) - [Trigger prototype](/manual/api/reference/triggerprototype/object#trigger_prototype) ### همچنین ببینید - [میزبان](/دستی/api/reference/host/object#host) - [نوع رسانه](/دستی/api/reference/mediatype/object#media_type) - [کاربر](/دستی/api/reference/user/object#user) ### See also - [Host](/manual/api/reference/host/object#host) - [Host group](/manual/api/reference/hostgroup/object#host_group) - [Time period](object#time_period) ### همچنین ببینید - [Host](/manual/api/reference/host/object#host) - [Template](/manual/api/reference/template/object#template) ### See also - [Host](/manual/api/reference/host/object#host) - [Item](/manual/api/reference/item/object#item) ###همچنین ببینید - [Host](/manual/api/reference/host/object#host) - [Item](/manual/api/reference/item/object#item) ### See also - [Host](/manual/api/reference/host/object#host) - [Media type](/manual/api/reference/mediatype/object#media_type) - [User](/manual/api/reference/user/object#user) ### همچنین ببینید - [میزبان](/دستی/api/reference/host/object#host) - [نوع رسانه](/دستی/api/reference/mediatype/object#media_type) - [کاربر](/دستی/api/reference/user/object#user) ### See also - [Host](/manual/api/reference/host/object#host) - [Proxy interface](object#proxy_interface) ### همچنین ببینید - [Host](/manual/api/reference/host/object#host) - [Scenario step](object#scenario_step) ### See also - [Host](/manual/api/reference/host/object#host) - [Proxy interface](object#proxy_interface) ### همچنین ببینید - [Host](/manual/api/reference/host/object#host) - [Scenario step](object#scenario_step) ### See also - [Host](/manual/api/reference/host/object#host) - [Scenario step](object#scenario_step) ### همچنین ببینید - [Host](/manual/api/reference/host/object#host) - [Scenario step](object#scenario_step) ### See also - [Host](/manual/api/reference/host/object#host) - [Template](/manual/api/reference/template/object#template) ### همچنین ببینید - [Host](/manual/api/reference/host/object#host) - [Template](/manual/api/reference/template/object#template) ### See also - [Host](/manual/api/reference/host/object#host) - [Template](/manual/api/reference/template/object#template) ### همچنین ببینید - [Host](/manual/api/reference/host/object#host) - [Template](/manual/api/reference/template/object#template) ### See also - [host.massadd](massadd) - [host.massupdate](massupdate) - [host.massremove](massremove) - [Host group](/manual/api/reference/hostgroup/object#host_group) - [Template](/manual/api/reference/template/object#template) - [User macro](/manual/api/reference/usermacro/object#hosttemplate_level_macro) - [Host interface](/manual/api/reference/hostinterface/object#host_interface) - [Host inventory](object#host_inventory) - [Host tag](object#host_tag) ###همچنین ببینید - [host.massadd](massadd) - [host.massupdate](massupdate) - [host.massremove](massremove) - [Host group](/manual/api/reference/hostgroup/object#host_group) - [Template](/manual/api/reference/template/object#template) - [User macro](/manual/api/reference/usermacro/object#hosttemplate_level_macro) - [Host interface](/manual/api/reference/hostinterface/object#host_interface) - [Host inventory](object#host_inventory) - [Host tag](object#host_tag) ### See also - [host.update](/manual/api/reference/host/update) - [host.massupdate](/manual/api/reference/host/massupdate) ### همچنین ببینید - [host.update](/manual/api/reference/host/update) - [host.massupdate](/manual/api/reference/host/massupdate) ### See also - [host.update](update) - [Host group](/manual/api/reference/hostgroup/object#host_group) - [Template](/manual/api/reference/template/object#template) - [User macro](/manual/api/reference/usermacro/object#hosttemplate_level_macro) - [Host interface](/manual/api/reference/hostinterface/object#host_interface) ### همچنین ببینید - [host.update](update) - [Host group](/manual/api/reference/hostgroup/object#host_group) - [Template](/manual/api/reference/template/object#template) - [User macro](/manual/api/reference/usermacro/object#hosttemplate_level_macro) - [Host interface](/manual/api/reference/hostinterface/object#host_interface) ### See also - [host.update](update) - [host.massadd](massadd) - [host.massremove](massremove) - [Host group](/manual/api/reference/hostgroup/object#host_group) - [Template](/manual/api/reference/template/object#host_group) - [User macro](/manual/api/reference/usermacro/object#hosttemplate_level_macro) - [Host interface](/manual/api/reference/hostinterface/object#host_interface) ### همچنین ببینید - [host.update](update) - [host.massadd](massadd) - [host.massremove](massremove) - [Host group](/manual/api/reference/hostgroup/object#host_group) - [Template](/manual/api/reference/template/object#host_group) - [User macro](/manual/api/reference/usermacro/object#hosttemplate_level_macro) - [Host interface](/manual/api/reference/hostinterface/object#host_interface) ### See also - [host.update](update) - [User macro](/manual/api/reference/usermacro/object#hosttemplate_level_macro) - [Host interface](/manual/api/reference/hostinterface/object#host_interface) ### همچنین ببینید - [host.update](update) - [User macro](/manual/api/reference/usermacro/object#hosttemplate_level_macro) - [Host interface](/manual/api/reference/hostinterface/object#host_interface) ### See also - [Icon mapping](object#icon_mapping) ### همچنین ببینید - [اختصاص آیکون] (آبجکت#اختصاص آیکون) ### See also - [Icon mapping](object#icon_mapping) ### همچنین ببینید - [اختصاص آیکون] (آبجکت#اختصاص آیکون) ### See also - [Icon mapping](object#icon_mapping) ### همچنین ببینید - [اختصاص آیکون] (آبجکت#اختصاص آیکون) ### See also - [LLD rule filter](object#lld_rule_filter) - [LLD macro paths](object#lld_macro_path) - [LLD rule preprocessing](object#lld_rule_preprocessing) ### همچنین ببینید - [LLD rule filter](object#lld_rule_filter) - [LLD macro paths](object#lld_macro_path) - [LLD rule preprocessing](object#lld_rule_preprocessing) ### See also - [Map element](object#map_element) - [Map link](object#map_link) - [Map URL](object#map_url) - [Map user](object#map_user) - [Map user group](object#map_user_group) - [Map shape](object#map_shapes) - [Map line](object#map_lines) ### همچنین ببینید - [عنصر نقشه](شیء#عنصر_نقشه) - [پیوند نقشه] (object#map_link) - [Map URL](object#map_url) - [کاربر نقشه] (object#map_user) - [گروه کاربری نقشه] (شیء#map_user_group) - [شکل نقشه] (ابژه#نقشه_شکل) - [خط نقشه](شیء#خطوط_نقشه) ### See also - [Permission](object#permission) ### همچنین ببینید - [مجوز] (object#permission) ### See also - [Role rules](/manual/api/reference/role/object#role_rules) - [User](/manual/api/reference/user/object#user) ###همچنین ببینید - [Host](/manual/api/reference/host/object#host) - [Item](/manual/api/reference/item/object#item) ### See also - [Scenario step](object#scenario_step) ###همچنین ببینید - [Scenario step](object#scenario_step) ### See also - [Scenario step](object#scenario_step) ###همچنین ببینید - [Scenario step](object#scenario_step) ### See also - [Task](/manual/api/reference/task/object) - ['Check now' request object](/manual/api/reference/task/object) - ['Diagnostic information' request object](/manual/api/reference/task/object) - [Statistic request object](/manual/api/reference/task/object) ### همچنین ببینید - [وظیفه] (/ دستی / api / مرجع / وظیفه / شی) - [شئ درخواست «اکنون بررسی کنید»](/manual/api/reference/task/object) - [شیء درخواست اطلاعات تشخیصی](/دستی/api/reference/task/object) - [شیء درخواست آمار](/دستی/api/reference/task/object) ### See also - [Template dashboard page](object#template_dashboard_page) - [Template dashboard widget](object#template_dashboard_widget) - [Template dashboard widget field](object#template_dashboard_widget_field) ### همچنین ببینید - [صفحه داشبورد الگو] (object#template_dashboard_page) - [ویجت داشبورد الگو] (ابجکت#الگو_ویجت_داشبورد) - [ویجت داشبورد الگو فیلد](شیء#الگوی_داشبورد_فیلد_ویجت) ### See also - [Template dashboard page](object#template_dashboard_page) - [Template dashboard widget](object#template_dashboard_widget) - [Template dashboard widget field](object#template_dashboard_widget_field) ### همچنین ببینید - [صفحه داشبورد الگو] (object#template_dashboard_page) - [ویجت داشبورد الگو] (ابجکت#الگو_ویجت_داشبورد) - [ویجت داشبورد الگو فیلد](شیء#الگوی_داشبورد_فیلد_ویجت) ### See also - [Template dashboard widget](object#template_dashboard_widget) - [Template dashboard widget field](object#template_dashboard_widget_field) ### همچنین ببینید - [ویجت داشبورد الگو] (ابجکت#الگو_ویجت_داشبورد) - [ویجت داشبورد الگو فیلد](شیء#الگوی_داشبورد_فیلد_ویجت) ### See also - [template.update](update) - [Host](/manual/api/reference/host/object#host) - [Host group](/manual/api/reference/hostgroup/object#host_group) - [User macro](/manual/api/reference/usermacro/object#hosttemplate_level_macro) ### همچنین ببینید - [میزبان](/دستی/api/reference/host/object#host) - [نوع رسانه](/دستی/api/reference/mediatype/object#media_type) - [کاربر](/دستی/api/reference/user/object#user) ### See also - [template.update](update) - [User macro](/manual/api/reference/usermacro/object#hosttemplate_level_macro) ### همچنین ببینید - [template.update] (به روز رسانی) - [ماکرو کاربر](/دستی/api/reference/usermacro/object#hosttemplate_level_macro) ### See also - [Time period](object#time_period) ### همچنین ببینید - [دوره زمانی] (شیء#زمان_دوره) ### See also - [Time period](object#time_period) ### همچنین ببینید - [دوره زمانی] (شیء#زمان_دوره) ### See also - [trigger.adddependencies](adddependencies) - [trigger.deletedependencies](deletedependencies) ### همچنین ببینید - [trigger.adddependencies](adddependencies) - [trigger.deletedependencies](deletedependencies) ### See also - [User](/manual/api/reference/user/object#user) ### همچنین ببینید - [کاربر](/دستی/api/reference/user/object#user) ### See also - [Users](object#users) - [User groups](object#user_groups) ### همچنین ببینید - [کاربران] (object#users) - [گروه‌های کاربر] (شیء#گروه_کاربر) ##### Sensor data |Item key|<|<|<| |--|--|------|------| |Description|Return value|Parameters|Comments| |**sensor**\[device,sensor,<mode>\]|<|<|<| |Hardware sensor reading.|Float|**device** - device name; can be a regular [expression](/manual/regular_expressions#overview) if mode is omitted<br>**sensor** - sensor name; can be a regular [expression](/manual/regular_expressions#overview) if mode is omitted<br>**mode** - possible values:<br>*avg*, *max*, *min* (if this parameter is omitted, device and sensor are treated verbatim).|Reads /proc/sys/dev/sensors on Linux 2.4.<br><br>Example:<br>=> sensor\[w83781d-i2c-0-2d,temp1\]<br><br>Prior to Zabbix 1.8.4, the *sensor\[temp1\]* format was used.| |^|^|^|Reads /sys/class/hwmon on Linux 2.6+.<br><br>See a more detailed description of [sensor](/manual/appendix/items/sensor) item on Linux.| |^|^|^|Reads the *hw.sensors* MIB on OpenBSD.<br><br>Examples:<br>=> sensor\[cpu0,temp0\] → temperature of one CPU<br>=> sensor\["cpu\[0-2\]$",temp,avg\] → average temperature of the first three CPU's<br><br>Supported on OpenBSD since Zabbix 1.8.4.| ##### داده های حسگر |کلید مورد|<|<|<| |--|--|------|------| |توضیحات|مقدار بازگشتی|پارامترها|نظرات| |**حسگر**\[دستگاه، حسگر،<حالت>\]|<|<|<| |خواندن سنسور سخت افزار.|شناور|**دستگاه** - نام دستگاه; اگر حالت حذف شده باشد، می تواند یک [عبارت] (/manual/regular_expressions#overview) معمولی باشد<br>**sensor** - sensor name; اگر حالت حذف شود، می تواند یک [expression](/manual/regular_expressions#overview) معمولی باشد<br>**mode** - مقادیر ممکن:<br>*avg*، *max*، *min* (اگر این پارامتر باشد حذف شده است، دستگاه و حسگر به طور کلمه مورد بررسی قرار می گیرند).|/proc/sys/dev/sensors را در Linux 2.4 می خواند.<br><br>مثال:<br>=> حسگر\[w83781d-i2c-0-2d,temp1\ ]<br><br>قبل از Zabbix 1.8.4، از فرمت *sensor\[temp1\]* استفاده می شد.| |^|^|^|/sys/class/hwmon را در لینوکس نسخه 2.6 و بالاتر می خواند.<br><br>توضیحات دقیق تر مورد [sensor](/manual/appendix/items/sensor) را در لینوکس ببینید.| |^|^|^|*hw.sensors* MIB را در OpenBSD می خواند.<br><br>مثال:<br>=> سنسور\[cpu0,temp0\] → دمای یک CPU<br>=> سنسور \["cpu\[0-2\]$",temp,avg\] → میانگین دمای سه CPU اول<br><br>پشتیبانی شده در OpenBSD از Zabbix 1.8.4.| #### Server To enable encryption with certificate and database host identity verification for connections between Zabbix server and the database, configure */etc/zabbix/zabbix\_server.conf*: ... DBHost=10.211.55.9 DBName=zabbix DBUser=zbx_srv DBPassword=<strong_password> DBTLSConnect=verify_full DBTLSCAFile=/etc/ssl/pgsql/root.crt DBTLSCertFile=/etc/ssl/pgsql/client.crt DBTLSKeyFile=/etc/ssl/pgsql/client.key ... #### سرور برای فعال کردن رمزگذاری فقط حمل و نقل برای اتصالات بین سرور و پایگاه داده، پیکربندی */etc/zabbix/zabbix\_server.conf*: ... DBHost=10.211.55.9 DBName=zabbix DBUser=zbx_srv DBPassword=<strong_password> DBTLSConnect=لازم است ... #### Server To enable encryption with certificate verification for connections between Zabbix server and the database, configure */etc/zabbix/zabbix\_server.conf*: ... DBHost=10.211.55.9 DBName=zabbix DBUser=zbx_srv DBPassword=<strong_password> DBTLSConnect=verify_ca DBTLSCAFile=/etc/ssl/mysql/ca.pem ... #### سرور برای فعال کردن رمزگذاری فقط حمل و نقل برای اتصالات بین سرور و پایگاه داده، پیکربندی */etc/zabbix/zabbix\_server.conf*: ... DBHost=10.211.55.9 DBName=zabbix DBUser=zbx_srv DBPassword=<strong_password> DBTLSConnect=لازم است ... #### Server To enable encryption with certificate verification for connections between Zabbix server and the database, configure */etc/zabbix/zabbix\_server.conf:* ... DBHost=10.211.55.9 DBName=zabbix DBUser=zbx_srv DBPassword=<strong_password> DBTLSConnect=verify_ca DBTLSCAFile=/etc/ssl/pgsql/root.crt ... #### سرور برای فعال کردن رمزگذاری فقط حمل و نقل برای اتصالات بین سرور و پایگاه داده، پیکربندی */etc/zabbix/zabbix\_server.conf*: ... DBHost=10.211.55.9 DBName=zabbix DBUser=zbx_srv DBPassword=<strong_password> DBTLSConnect=لازم است ... #### Server To enable encryption with full verification for connections between Zabbix server and the database, configure */etc/zabbix/zabbix\_server.conf*: ... DBHost=10.211.55.9 DBName=zabbix DBUser=zbx_srv DBPassword=<strong_password> DBTLSConnect=verify_full DBTLSCAFile=/etc/ssl/mysql/ca.pem DBTLSCertFile=/etc/ssl/mysql/client-cert.pem DBTLSKeyFile=/etc/ssl/mysql/client-key.pem ... #### سرور برای فعال کردن رمزگذاری فقط حمل و نقل برای اتصالات بین سرور و پایگاه داده، پیکربندی */etc/zabbix/zabbix\_server.conf*: ... DBHost=10.211.55.9 DBName=zabbix DBUser=zbx_srv DBPassword=<strong_password> DBTLSConnect=لازم است ... #### Server To enable transport-only encryption for connections between server and the database, configure */etc/zabbix/zabbix\_server.conf*: ... DBHost=10.211.55.9 DBName=zabbix DBUser=zbx_srv DBPassword=<strong_password> DBTLSConnect=required ... #### سرور برای فعال کردن رمزگذاری فقط حمل و نقل برای اتصالات بین سرور و پایگاه داده، پیکربندی */etc/zabbix/zabbix\_server.conf*: ... DBHost=10.211.55.9 DBName=zabbix DBUser=zbx_srv DBPassword=<strong_password> DBTLSConnect=لازم است ... #### Server To enable transport-only encryption for connections between server and the database, configure */etc/zabbix/zabbix\_server.conf*: ... DBHost=10.211.55.9 DBName=zabbix DBUser=zbx_srv DBPassword=<strong_password> DBTLSConnect=required ... #### سرور برای فعال کردن رمزگذاری فقط حمل و نقل برای اتصالات بین سرور و پایگاه داده، پیکربندی */etc/zabbix/zabbix\_server.conf*: ... DBHost=10.211.55.9 DBName=zabbix DBUser=zbx_srv DBPassword=<strong_password> DBTLSConnect=لازم است ... # service.update # آپدیت قانون جست و جو # settings.update # settings.update #### Setting the maximum for the Y scale Set the maximum of the Y scale to a fixed value of 100. Request: ```json { "jsonrpc": "2.0", "method": "graph.update", "params": { "graphid": "439", "ymax_type": 1, "yaxismax": 100 }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "graphids": [ "439" ] }, "id": 1 } ``` #### قراردادن مقدار حداکثر برای مقیاس y Set the maximum of the Y scale to a fixed value of 100. Request: ```json { "jsonrpc": "2.0", "method": "graph.update", "params": { "graphid": "439", "ymax_type": 1, "yaxismax": 100 }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "graphids": [ "439" ] }, "id": 1 } ``` #### Setting the parent for a service Make service with ID "3" to be the parent for service with ID "5". Request: ```json { "jsonrpc": "2.0", "method": "service.update", "params": { "serviceid": "5", "parents": [ { "serviceid": "3" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "serviceids": [ "5" ] }, "id": 1 } ``` ####غیرفعال کردن نمونه اولیه هاست Disable a host prototype, that is, set its status to 1. Request: ```json { "jsonrpc": "2.0", "method": "hostprototype.update", "params": { "hostid": "10092", "status": 1 }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "hostids": [ "10092" ] }, "id": 1 } ``` ### Size |Type|Size|Comments| |-----|-----|----------| |Byte| 4 |Size of the current payload in bytes.| ### کد |نوع|اندازه|نظرات| |-----|-----|----------| |بایت| 4 | نوع بار، در حال حاضر فقط JSON پشتیبانی می شود.| # sla.create # sla.create ### SLA excluded downtime The excluded downtime object defines periods where the connected service(s) are scheduled to be out of working order, without affecting SLI, e.g. undergoing planned maintenance. ### SLA از زمان خرابی خارج شد شیء خرابی حذف شده دوره هایی را تعریف می کند که در آن سرویس(های) متصل برنامه ریزی شده است که از حالت کار خارج شوند. بدون تأثیر بر SLI، به عنوان مثال. در حال انجام تعمیرات برنامه ریزی شده # sla.get # sla.getsli # sla.getsli # sla.getsli ### SLA Schedule The SLA schedule object defines periods where the connected service(s) are scheduled to be in working order. It has the following properties. ### برنامه SLA شی زمانبندی SLA دوره هایی را تعریف می کند که در آن سرویس(های) متصل برنامه ریزی شده است که در حالت کار باشند. دارای خواص زیر می باشد. ### SLA service tag The SLA service tag object links services to include in the calculations for the SLA. It has the following properties. ### برچسب سرویس SLA شیء تگ سرویس SLA خدماتی را پیوند می دهد تا در محاسبات SLA لحاظ شود. دارای خواص زیر می باشد. ### SLA The SLA object has the following properties. | Property | [Type](/manual/api/reference_commentary#data_types) | Description | |----------------------------|-----------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | slaid | string | *(readonly)* ID of the SLA. | | **name**<br>(required) | string | Name of the SLA. | | **period**<br>(required) | integer | Reporting period of the SLA.<br><br>Possible values:<br>0 - daily;<br>1 - weekly;<br>2 - monthly;<br>3 - quarterly;<br>4 - annually. | | **slo**<br>(required) | float | Minimum acceptable Service Level Objective expressed as a percent. If the Service Level Indicator (SLI) drops lower, the SLA is considered to be in problem/unfulfilled state.<br><br>Possible values: 0-100 (up to 4 fractional digits). | | effective_date | integer | Effective date of the SLA.<br><br>Possible values: date timestamp in UTC. | | **timezone**<br>(required) | string | Reporting time zone, for example: `Europe/London`, `UTC`.<br><br>For the full list of supported time zones please refer to [PHP documentation](https://www.php.net/manual/en/timezones.php). | | status | integer | Status of the SLA.<br><br>Possible values:<br>0 - *(default)* disabled SLA;<br>1 - enabled SLA. | | description | string | Description of the SLA. | Note that for some methods (update, delete) the required/optional parameter combination is different. ### SLA شی SLA دارای ویژگی های زیر است. | اموال | [Type](/manual/api/reference_commentary#data_types) | توضیحات | |------------------------------------------------- -------------------------------------------------- ------------------------------------------------ ------------------------------------------------ ------------------------------------------------ ------------------------------------------------ -------------------| | اسلید | رشته | *(فقط خواندن)* شناسه SLA. | | **نام**<br>(الزامی) | رشته | نام SLA. | | **دوره**<br>(الزامی) | عدد صحیح | دوره گزارش SLA.<br><br>مقادیر ممکن:<br>0 - روزانه؛<br>1 - هفتگی؛<br>2 - ماهانه؛<br>3 - سه ماهه؛<br>4 - سالانه. | | **slo**<br>(الزامی) | شناور | حداقل هدف سطح خدمات قابل قبول به صورت درصد بیان شده است. اگر نشانگر سطح سرویس (SLI) پایین‌تر بیاید، SLA در وضعیت مشکل/عدم تکمیل در نظر گرفته می‌شود.<br><br>مقادیر ممکن: 0-100 (حداکثر 4 رقم کسری). | | اثر_تاریخ | عدد صحیح | تاریخ اجرایی SLA.<br><br>مقادیر احتمالی: مهر زمانی تاریخ در UTC. | | **منطقه زمانی**<br>(الزامی) | رشته | گزارش منطقه زمانی، برای مثال: «اروپا/لندن»، «UTC».<br><br>برای لیست کامل مناطق زمانی پشتیبانی شده لطفاً به [اسناد PHP] (https://www.php.net/manual) مراجعه کنید /en/timezones.php). | | وضعیت | عدد صحیح | وضعیت SLA.<br><br>مقادیر ممکن:<br>0 - *(پیش‌فرض)* SLA غیرفعال شده؛<br>1 - SLA فعال است. | | توضیحات | رشته | شرح SLA. | توجه داشته باشید که برای برخی از روش ها (به روز رسانی، حذف) ترکیب پارامترهای مورد نیاز/اختیاری متفاوت است. # sla.update # sla.create #### Solaris See values supported for 'memtype' parameter on Solaris in the table. |Supported value|Description|Source in psinfo structure|Tries to be compatible with| |--|------|--|--| |vsize ^[1](proc_mem_notes#footnotes)^|Size of process image|pr\_size|ps -o vsz| |pmem|Percentage of real memory|pr\_pctmem|ps -o pmem| |rss|Resident set size<br>It may be underestimated - see rss description in "man ps".|pr\_rssize|ps -o rss| #### سولاریس مقادیر پشتیبانی شده برای پارامتر 'memtype' در Solaris را در جدول ببینید. |مقدار پشتیبانی شده|توضیح|منبع در ساختار psinfo|سعی می کند با| |--|------|--|--| |vsize ^[1](proc_mem_notes#footnotes)^|اندازه تصویر فرآیند|pr\_size|ps -o vsz| |pmem|درصد حافظه واقعی|pr\_pctmem|ps -o pmem| |rss|اندازه مجموعه مقیم<br>ممکن است دست کم گرفته شود - به توضیحات rss در "man ps" مراجعه کنید.|pr\_rssize|ps -o rss| ### Source CAction::create() in *ui/include/classes/api/services/CAction.php*. ### منبع CAction::create() در *ui/include/classes/api/services/CAction.php*. ### Source CAction::delete() in *ui/include/classes/api/services/CAction.php*. ### منبع CAction::delete() در *ui/include/classes/api/services/CAction.php*. ### Source CAction::get() in *ui/include/classes/api/services/CAction.php*. ### منبع CAction::get() در *ui/include/classes/api/services/CAction.php*. ### Source CAction::update() in *ui/include/classes/api/services/CAction.php*. ### منبع CAction::update() در *ui/include/classes/api/services/CAction.php*. ### Source CAlert::get() in *ui/include/classes/api/services/CAlert.php*. ### منبع CAlert::get() در *ui/include/classes/api/services/CAlert.php*. ### Source CAPIInfo::version() in *ui/include/classes/api/services/CAPIInfo.php*. ### منبع CAPIInfo::version() در *ui/include/classes/api/services/CAPIInfo.php*. ### Source CAuditLog::get() in *ui/include/classes/api/services/CAuditLog.php*. ### منبع CAuditLog::get() در *ui/include/classes/api/services/CAuditLog.php*. ### Source CAuthentication::get() in *ui/include/classes/api/services/CAuthentication.php*. ### منبع CIconMap::update() در *ui/include/classes/api/services/CIconMap.php*. ### Source CAuthentication::update() in *ui/include/classes/api/services/CAuthentication.php*. ### منبع CIconMap::update() در *ui/include/classes/api/services/CIconMap.php*. ### Source CAutoregistration::get() in *ui/include/classes/api/services/CAutoregistration.php*. ### منبع CIconMap::update() در *ui/include/classes/api/services/CIconMap.php*. ### Source CAutoregistration::update() in *ui/include/classes/api/services/CAutoregistration.php*. ### منبع CIconMap::update() در *ui/include/classes/api/services/CIconMap.php*. ### Source CConfiguration::export() in *ui/include/classes/api/services/CConfiguration.php*. ### منبع CIconMap::update() در *ui/include/classes/api/services/CIconMap.php*. ### Source CConfiguration::importcompare() in *ui/include/classes/api/services/CConfiguration.php*. ### منبع CIconMap::update() در *ui/include/classes/api/services/CIconMap.php*. ### Source CConfiguration::import() in *ui/include/classes/api/services/CConfiguration.php*. ### منبع CIconMap::update() در *ui/include/classes/api/services/CIconMap.php*. ### Source CCorrelation::create() in *ui/include/classes/api/services/CCorrelation.php*. ### منبع CIconMap::update() در *ui/include/classes/api/services/CIconMap.php*. ### Source CCorrelation::delete() in *ui/include/classes/api/services/CCorrelation.php*. ### منبع CCCorrelation::delete() در *ui/include/classes/api/services/CCorrelation.php*. ### Source CCorrelation::get() in *ui/include/classes/api/services/CCorrelation.php*. ### منبع CCorrelation::get() in *ui/include/classes/api/services/CCorrelation.php*. ### Source CCorrelation::update() in *ui/include/classes/api/services/CCorrelation.php*. ### منبع CCCorrelation::update() در *ui/include/classes/api/services/CCorrelation.php*. ### Source CDashboard::create() in *ui/include/classes/api/services/CDashboard.php*. ### منبع CDashboard::create() in *ui/include/classes/api/services/CDashboard.php*. ### Source CDashboard::delete() in *ui/include/classes/api/services/CDashboard.php*. ### منبع CDashboard::delete() in *ui/include/classes/api/services/CDashboard.php*. ### Source CDashboard::get() in *ui/include/classes/api/services/CDashboard.php*. ### منبع CDashboard::get() in *ui/include/classes/api/services/CDashboard.php*. ### Source CDashboard::update() in *ui/include/classes/api/services/CDashboard.php*. ### منبع CDashboard::update() in *ui/include/classes/api/services/CDashboard.php*. ### Source CDCheck::get() in *ui/include/classes/api/services/CDCheck.php*. ### منبع CDCheck::get() in *ui/include/classes/api/services/CDCheck.php*. ### Source CDHost::get() in *ui/include/classes/api/services/CDHost.php*. ### منبع CDHost::get() in *ui/include/classes/api/services/CDHost.php*. ### Source CDiscoveryRule::create() in *ui/include/classes/api/services/CDiscoveryRule.php*. ### منبع CDiscoveryrule::copy() in *ui/include/classes/api/services/CDiscoveryRule.php*. ### Source CDiscoveryRule::delete() in *ui/include/classes/api/services/CDiscoveryRule.php*. ### منبع CDiscoveryrule::copy() in *ui/include/classes/api/services/CDiscoveryRule.php*. ### Source CDiscoveryRule::get() in *ui/include/classes/api/services/CDiscoveryRule.php*. ### منبع CDiscoveryrule::copy() in *ui/include/classes/api/services/CDiscoveryRule.php*. ### Source CDiscoveryRule::update() in *ui/include/classes/api/services/CDiscoveryRule.php*. ### منبع CDiscoveryrule::copy() in *ui/include/classes/api/services/CDiscoveryRule.php*. ### Source CDRule::create() in *ui/include/classes/api/services/CDRule.php*. ### منابع CDRule::create() in *ui/include/classes/api/services/CDRule.php*. ### Source CDRule::delete() in *ui/include/classes/api/services/CDRule.php*. ### منبع CDRule::delete() in *ui/include/classes/api/services/CDRule.php*. ### Source CDRule::get() in *ui/include/classes/api/services/CDRule.php*. ### منبع CDRule::get() in *ui/include/classes/api/services/CDRule.php*. ### Source CDRule::update() in *ui/include/classes/api/services/CDRule.php*. ### منبع CDRule::update() in *ui/include/classes/api/services/CDRule.php*. ### Source CDService::get() in *ui/include/classes/api/services/CDService.php*. ### منبع CDService::get() in *ui/include/classes/api/services/CDService.php*. ### Source CEvent::acknowledge() in *ui/include/classes/api/services/CEvent.php*. ### منبع CEvent::acknowledge() in *ui/include/classes/api/services/CEvent.php*. ### Source CEvent::get() in *ui/include/classes/api/services/CEvent.php*. ### منبع CEvent::get() in *ui/include/classes/api/services/CEvent.php*. ### Source CEvent::get() in *ui/include/classes/api/services/CProblem.php*. ### منبع CEvent::get() in *ui/include/classes/api/services/CEvent.php*. ### Source CGraph::create() in *ui/include/classes/api/services/CGraph.php*. منبع ### Source CGraph::delete() in *ui/include/classes/api/services/CGraph.php*. ### منبع CGraph::delete() in *ui/include/classes/api/services/CGraph.php*. ### Source CGraph::get() in *ui/include/classes/api/services/CGraph.php*. ### منبع CGraph::get() in *ui/include/classes/api/services/CGraph.php*. ### Source CGraphItem::get() in *ui/include/classes/api/services/CGraphItem.php*. ### منبع CGraphItem::get() in *ui/include/classes/api/services/CGraphItem.php*. ### Source CGraphPrototype::create() in *ui/include/classes/api/services/CGraphPrototype.php*. ### منبع CGraphPrototype::create() in *ui/include/classes/api/services/CGraphPrototype.php*. ### Source CGraphPrototype::delete() in *ui/include/classes/api/services/CGraphPrototype.php*. ### منبع CGraphPrototype::delete() in *ui/include/classes/api/services/CGraphPrototype.php*. ### Source CGraphPrototype::get() in *ui/include/classes/api/services/CGraphPrototype.php*. ### منبع CGraphPrototype::get() in *ui/include/classes/api/services/CGraphPrototype.php*. ### Source CGraphPrototype::update() in *ui/include/classes/api/services/CGraphPrototype.php*. ### منبع CGraphPrototype::update() in *ui/include/classes/api/services/CGraphPrototype.php*. ### Source CGraph::update() in *ui/include/classes/api/services/CGraph.php*. ### منبع CGraph::update() in *ui/include/classes/api/services/CGraph.php*. ### Source CHaNode::get() in *ui/include/classes/api/services/CHaNode.php*. ### منبع CHaNode::get() in *ui/include/classes/api/services/CHaNode.php*. ### Source CHistory::clear() in *ui/include/classes/api/services/CHistory.php*. ### منبع CHistory::clear() in *ui/include/classes/api/services/CHistory.php*. ### Source CHistory::get() in *ui/include/classes/api/services/CHistory.php*. ###منبع CHistory::get() in *ui/include/classes/api/services/CHistory.php*. ### Source CHost::create() in *ui/include/classes/api/services/CHost.php*. ### منبع CHost::create() in *ui/include/classes/api/services/CHost.php*. ### Source CHost::delete() in *ui/include/classes/api/services/CHost.php*. ###منبع CHost::delete() in *ui/include/classes/api/services/CHost.php*. ### Source CHost::get() in *ui/include/classes/api/services/CHost.php*. ### منبع CDHost::get() in *ui/include/classes/api/services/CDHost.php*. ### Source CHostGroup::create() in *ui/include/classes/api/services/CHostGroup.php*. ### منبع CHostGroup::create() in *ui/include/classes/api/services/CHostGroup.php*. ### Source CHostGroup::delete() in *ui/include/classes/api/services/CHostGroup.php*. ### منبع CHostGroup::create() in *ui/include/classes/api/services/CHostGroup.php*. ### Source CHostGroup::get() in *ui/include/classes/api/services/CHostGroup.php*. ### منبع CHostGroup::get() in *ui/include/classes/api/services/CHostGroup.php*. ### Source CHostGroup::massAdd() in *ui/include/classes/api/services/CHostGroup.php*. ### منبع CHostGroup::massAdd() in *ui/include/classes/api/services/CHostGroup.php*. ### Source CHostGroup::massRemove() in *ui/include/classes/api/services/CHostGroup.php*. ### منبع CHostGroup::massRemove() in *ui/include/classes/api/services/CHostGroup.php*. ### Source CHostGroup::massUpdate() in *ui/include/classes/api/services/CHostGroup.php*. ### منبع CHostGroup::massUpdate() in *ui/include/classes/api/services/CHostGroup.php*. ### Source CHostGroup::update() in *ui/include/classes/api/services/CHostGroup.php*. ### منبع CHostGroup::update() in *ui/include/classes/api/services/CHostGroup.php*. ### Source CHostInterface::create() in *ui/include/classes/api/services/CHostInterface.php*. ### منبع CHostInterface::create() in *ui/include/classes/api/services/CHostInterface.php*. ### Source CHostInterface::delete() in *ui/include/classes/api/services/CHostInterface.php*. ###منبع CHostInterface::delete() in *ui/include/classes/api/services/CHostInterface.php*. ### Source CHostInterface::get() in *ui/include/classes/api/services/CHostInterface.php*. ### منبع CHostInterface::get() in *ui/include/classes/api/services/CHostInterface.php*. ### Source CHostInterface::massAdd() in *ui/include/classes/api/services/CHostInterface.php*. ### منبع CHostInterface::massAdd() in *ui/include/classes/api/services/CHostInterface.php*. ### Source CHostInterface::massRemove() in *ui/include/classes/api/services/CHostInterface.php*. ### منبع CHostInterface::massRemove() in *ui/include/classes/api/services/CHostInterface.php*. ### Source CHostInterface::replaceHostInterfaces() in *ui/include/classes/api/services/CHostInterface.php*. ### منبع CHostInterface::replaceHostInterfaces() in *ui/include/classes/api/services/CHostInterface.php*. ### Source CHostInterface::update() in *ui/include/classes/api/services/CHostInterface.php*. ### منبع CHostInterface::update() in *ui/include/classes/api/services/CHostInterface.php*. ### Source CHost::massAdd() in *ui/include/classes/api/services/CHost.php*. ### منبع CHost::massAdd() in *ui/include/classes/api/services/CHost.php*. ### Source CHost::massRemove() in *ui/include/classes/api/services/CHost.php*. ### منبع CHost::massRemove() in *ui/include/classes/api/services/CHost.php*. ### Source CHost::massUpdate() in *ui/include/classes/api/services/CHost.php*. ### منبع CHost::massUpdate() in *ui/include/classes/api/services/CHost.php*. ### Source CHostPrototype::create() in *ui/include/classes/api/services/CHostPrototype.php*. ###منبع CHostPrototype::create() in *ui/include/classes/api/services/CHostPrototype.php*. ### Source CHostPrototype::delete() in *ui/include/classes/api/services/CHostPrototype.php*. ### منبع CHostPrototype::delete() in *ui/include/classes/api/services/CHostPrototype.php*. ### Source CHostPrototype::get() in *ui/include/classes/api/services/CHostPrototype.php*. ###منبع CHostPrototype::get() in *ui/include/classes/api/services/CHostPrototype.php*. ### Source CHostPrototype::update() in *ui/include/classes/api/services/CHostPrototype.php*. ### منبع CHostPrototype::update() in *ui/include/classes/api/services/CHostPrototype.php*. ### Source CHost::update() in *ui/include/classes/api/services/CHost.php*. ### منبع CHost::create() in *ui/include/classes/api/services/CHost.php*. ### Source CHousekeeping ::get() in *ui/include/classes/api/services/CHousekeeping.php*. ### منبع CHousekeeping ::get() in *ui/include/classes/api/services/CHousekeeping.php*. ### Source CHousekeeping::update() in *ui/include/classes/api/services/CHousekeeping.php*. ### منبع CHousekeeping::update() in *ui/include/classes/api/services/CHousekeeping.php*. ### Source CHttpTest::create() in *ui/include/classes/api/services/CHttpTest.php*. ### منبع CHttpTest::create() in *ui/include/classes/api/services/CHttpTest.php*. ### Source CHttpTest::delete() in *ui/include/classes/api/services/CHttpTest.php*. ###منبع CHttpTest::delete() in *ui/include/classes/api/services/CHttpTest.php*. ### Source CHttpTest::get() in *ui/include/classes/api/services/CHttpTest.php*. ###منبع CHttpTest::get() in *ui/include/classes/api/services/CHttpTest.php*. ### Source CHttpTest::update() in *ui/include/classes/api/services/CHttpTest.php*. ###منبع CHttpTest::update() in *ui/include/classes/api/services/CHttpTest.php*. ### Source CIconMap::create() in *ui/include/classes/api/services/CIconMap.php*. ### منبع CIconMap::update() در *ui/include/classes/api/services/CIconMap.php*. ### Source CIconMap::delete() in *ui/include/classes/api/services/CIconMap.php*. ###منبع CIconMap::delete() in *ui/include/classes/api/services/CIconMap.php*. ### Source CIconMap::get() in *ui/include/classes/api/services/CIconMap.php*. ### منبع CIconMap::update() در *ui/include/classes/api/services/CIconMap.php*. ### Source CIconMap::update() in *ui/include/classes/api/services/CIconMap.php*. ### منبع CIconMap::update() در *ui/include/classes/api/services/CIconMap.php*. ### Source CImage::create() in *ui/include/classes/api/services/CImage.php*. ### منبع CImage::create() in *ui/include/classes/api/services/CImage.php*. ### Source CImage::delete() in *ui/include/classes/api/services/CImage.php*. ### منبع CImage::create() in *ui/include/classes/api/services/CImage.php*. ### Source CImage::get() in *ui/include/classes/api/services/CImage.php*. منبع ### Source CImage::update() in *ui/include/classes/api/services/CImage.php*. ### منبع CImage::create() in *ui/include/classes/api/services/CImage.php*. ### Source CItem::create() in *ui/include/classes/api/services/CItem.php*. ### منبع CImage::create() in *ui/include/classes/api/services/CImage.php*. ### Source CItem::delete() in *ui/include/classes/api/services/CItem.php*. ### منبع CImage::create() in *ui/include/classes/api/services/CImage.php*. ### Source CItem::get() in *ui/include/classes/api/services/CItem.php*. ### منبع CImage::create() in *ui/include/classes/api/services/CImage.php*. ### Source CItemPrototype::create() in *ui/include/classes/api/services/CItemPrototype.php*. ###منبع CHostPrototype::create() in *ui/include/classes/api/services/CHostPrototype.php*. ### Source CItemPrototype::delete() in *ui/include/classes/api/services/CItemPrototype.php*. ###منبع CHostPrototype::create() in *ui/include/classes/api/services/CHostPrototype.php*. ### Source CItemPrototype::get() in *ui/include/classes/api/services/CItemPrototype.php*. ###منبع CHostPrototype::create() in *ui/include/classes/api/services/CHostPrototype.php*. ### Source CItemPrototype::update() in *ui/include/classes/api/services/CItemPrototype.php*. ###منبع CHostPrototype::create() in *ui/include/classes/api/services/CHostPrototype.php*. ### Source CItem::update() in *ui/include/classes/api/services/CItem.php*. ### منبع CImage::create() in *ui/include/classes/api/services/CImage.php*. ### Source CMaintenance::create() in *ui/include/classes/api/services/CMaintenance.php*. ### منبع CImage::create() in *ui/include/classes/api/services/CImage.php*. ### Source CMaintenance::delete() in *ui/include/classes/api/services/CMaintenance.php*. ### منبع CImage::create() in *ui/include/classes/api/services/CImage.php*. ### Source CMaintenance::get() in *ui/include/classes/api/services/CMaintenance.php*. ### منبع CImage::create() in *ui/include/classes/api/services/CImage.php*. ### Source CMaintenance::update() in *ui/include/classes/api/services/CMaintenance.php*. ### منبع CImage::create() in *ui/include/classes/api/services/CImage.php*. ### Source CMap::create() in *ui/include/classes/api/services/CMap.php*. منبع ### Source CMap::delete() in *ui/include/classes/api/services/CMap.php*. منبع ### Source CMediaType::create() in *ui/include/classes/api/services/CMediaType.php*. منبع ### Source CMediaType::update() in *ui/include/classes/api/services/CMediaType.php*. منبع ### Source CProxy::create() in *ui/include/classes/api/services/CProxy.php*. ### منبع CHost::create() in *ui/include/classes/api/services/CHost.php*. ### Source CProxy::delete() in *ui/include/classes/api/services/CProxy.php*. ### منبع CHost::create() in *ui/include/classes/api/services/CHost.php*. ### Source CProxy::update() in *ui/include/classes/api/services/CProxy.php*. ### منبع CHost::create() in *ui/include/classes/api/services/CHost.php*. ### Source CRegexp::create() in *ui/include/classes/api/services/CRegexp.php*. منبع ### Source CRegexp::delete() in *ui/include/classes/api/services/CRegexp.php*. منبع ### Source CRegexp::get() in *ui/include/classes/api/services/CRegexp.php*. منبع ### Source CRegexp::update() in *ui/include/classes/api/services/CRegexp.php*. منبع ### Source CReport::create() in *ui/include/classes/api/services/CReport.php*. منبع ### Source CReport::delete() in *ui/include/classes/api/services/CReport.php*. منبع ### Source CRole::get() in *ui/include/classes/api/services/CRole.php*. ### منبع CDRule::get() in *ui/include/classes/api/services/CDRule.php*. ### Source CScript::create() in *ui/include/classes/api/services/CScript.php*. ### منبع CIconMap::update() در *ui/include/classes/api/services/CIconMap.php*. ### Source CScript::delete() in *ui/include/classes/api/services/CScript.php*. ### منبع CIconMap::update() در *ui/include/classes/api/services/CIconMap.php*. ### Source CScript::execute() in *ui/include/classes/api/services/CScript.php*. ### منبع CIconMap::update() در *ui/include/classes/api/services/CIconMap.php*. ### Source CService::update() in *ui/include/classes/api/services/CService.php*. ### منبع CDService::get() in *ui/include/classes/api/services/CDService.php*. ### Source CSettings::update() in *ui/include/classes/api/services/CSettings.php*. ### منبع CAction::update() در *ui/include/classes/api/services/CAction.php*. ### Source CSla::create() in *ui/include/classes/api/services/CSla.php*. منبع ### Source CSla:get() in *ui/include/classes/api/services/CSla.php*. ### منبع CDRule::get() in *ui/include/classes/api/services/CDRule.php*. ### Source CSla::getSli() in *ui/include/classes/api/services/CSla.php* ### منبع CDRule::get() in *ui/include/classes/api/services/CDRule.php*. ### Source CSla::update() in *ui/include/classes/api/services/CSla.php*. ### منبع CDRule::get() in *ui/include/classes/api/services/CDRule.php*. ### Source CTask::create() in *ui/include/classes/api/services/CTask.php*. منبع ### Source CTemplate::create() in *ui/include/classes/api/services/CTemplate.php*. ### منبع CTemplate::create() in *ui/include/classes/api/services/CTemplate.php*. ### Source CTemplateDashboard::create() in *ui/include/classes/api/services/CTemplateDashboard.php*. ### منبع CDashboard::create() in *ui/include/classes/api/services/CDashboard.php*. ### Source CTemplateDashboard::get() in *ui/include/classes/api/services/CTemplateDashboard.php*. ### منبع CDashboard::create() in *ui/include/classes/api/services/CDashboard.php*. ### Source CTemplateDashboard::update() in *ui/include/classes/api/services/CTemplateDashboard.php*. ### منبع CDashboard::create() in *ui/include/classes/api/services/CDashboard.php*. ### Source CTemplate::get() in *ui/include/classes/api/services/CTemplate.php*. ### منبع CTemplate::create() in *ui/include/classes/api/services/CTemplate.php*. ### Source CTemplate::massAdd() in *ui/include/classes/api/services/CTemplate.php*. ### منبع CTemplate::create() in *ui/include/classes/api/services/CTemplate.php*. ### Source CTemplate::massRemove() in *ui/include/classes/api/services/CTemplate.php*. ### منبع CTemplate::create() in *ui/include/classes/api/services/CTemplate.php*. ### Source CToken::delete() in *ui/include/classes/api/services/CToken.php*. ### منبع CImage::create() in *ui/include/classes/api/services/CImage.php*. ### Source CToken::generate() in *ui/include/classes/api/services/CToken.php*. ### منبع CImage::create() in *ui/include/classes/api/services/CImage.php*. ### Source CTriggerPrototype::get() in *ui/include/classes/api/services/CTriggerPrototype.php*. ###منبع CHostPrototype::create() in *ui/include/classes/api/services/CHostPrototype.php*. ### Source CTriggerPrototype::update() in *ui/include/classes/api/services/CTriggerPrototype.php*. ###منبع CHostPrototype::create() in *ui/include/classes/api/services/CHostPrototype.php*. ### Source CTrigger::update() in *ui/include/classes/api/services/CTrigger.php*. ### منبع CImage::create() in *ui/include/classes/api/services/CImage.php*. ### Source CUserGroup::get() in *ui/include/classes/api/services/CUserGroup.php*. ### منبع CAlert::get() در *ui/include/classes/api/services/CAlert.php*. ### Source CUserGroup::update() in *ui/include/classes/api/services/CUserGroup.php*. ### منبع CAlert::get() در *ui/include/classes/api/services/CAlert.php*. ### Source CUserMacro::get() in *ui/include/classes/api/services/CUserMacro.php*. ### منبع CAlert::get() در *ui/include/classes/api/services/CAlert.php*. ### Source CUserMacro::updateGlobal() in *ui/include/classes/api/services/CUserMacro.php*. ### منبع CAlert::get() در *ui/include/classes/api/services/CAlert.php*. ### Source CValueMap::create() in *ui/include/classes/api/services/CValueMap.php*. ### منبع CIconMap::update() در *ui/include/classes/api/services/CIconMap.php*. ### Source CValueMap::delete() in *ui/include/classes/api/services/CValueMap.php*. ### منبع CIconMap::update() در *ui/include/classes/api/services/CIconMap.php*. ### Source CValueMap::get() in *ui/include/classes/api/services/CValueMap.php*. ### منبع CIconMap::update() در *ui/include/classes/api/services/CIconMap.php*. ### Source CValueMap::update() in *ui/include/classes/api/services/CValueMap.php*. ### منبع CIconMap::update() در *ui/include/classes/api/services/CIconMap.php*. #### SQLite Using SQLite is supported for **Zabbix proxy** only! The database will be automatically created if it does not exist. Return to the [installation section](/manual/installation/install). #### SQLite استفاده از SQLite فقط برای **پراکسی Zabbix** پشتیبانی می شود! پایگاه داده خواهد بود اگر وجود نداشته باشد به طور خودکار ایجاد می شود. به [بخش نصب](/دستی/نصب/نصب) برگردید. #### Starting agent To start the agent service, you can use Control Panel or do it from command line. To start a single instance of Zabbix agent with the default configuration file: zabbix_agentd.exe --start To start a single instance of Zabbix agent with another configuration file: zabbix_agentd.exe --config <your_configuration_file> --start To start one of multiple instances of Zabbix agent: zabbix_agentd.exe --config <configuration_file_for_this_instance> --start --multiple-agents #### عامل شروع برای راه اندازی سرویس عامل، می توانید از کنترل پنل استفاده کنید یا آن را از آن انجام دهید خط فرمان. برای شروع یک نمونه از عامل Zabbix با پیش فرض فایل پیکربندی: zabbix_agentd.exe --start برای شروع یک نمونه از عامل Zabbix با پیکربندی دیگر فایل: zabbix_agentd.exe --config <your_configuration_file> -- start برای شروع یکی از چندین نمونه عامل Zabbix: zabbix_agentd.exe --config <configuration_file_for_this_instance> --start --multiple-agents ###### Start request A request to execute the Start function of the Runner interface. | | | |---|---| |direction|agent → plugin| |response|no| The request doesn't have specific parameters, it only contains [common data](#common-data) parameters. *Example:* {"id":3,"type":4} ###### درخواست شروع درخواستی برای اجرای تابع Start رابط Runner. | | | |---|---| |جهت|عامل → افزونه| |پاسخ|نه| درخواست پارامترهای خاصی ندارد، فقط شامل پارامترهای [common data] (#common-data) است. *مثال:* {"id":3,"type":4} ##### Start up manually If the above does not work you have to start it manually. Find the path to the zabbix\_agentd binary and execute: zabbix_agentd ##### راه اندازی دستی اگر موارد بالا جواب نداد، باید آن را به صورت دستی شروع کنید. مسیر را پیدا کنید به باینری zabbix\_agentd و اجرا کنید: zabbix_agentd ##### Start up manually If the above does not work you have to start it manually. Find the path to the zabbix\_proxy binary and execute: zabbix_proxy You can use the following command line parameters with Zabbix proxy: -c --config <file> path to the configuration file -f --foreground run Zabbix proxy in foreground -R --runtime-control <option> perform administrative functions -h --help give this help -V --version display version number Examples of running Zabbix proxy with command line parameters: zabbix_proxy -c /usr/local/etc/zabbix_proxy.conf zabbix_proxy --help zabbix_proxy -V ##### راه اندازی دستی اگر موارد بالا جواب نداد، باید آن را به صورت دستی شروع کنید. مسیر را پیدا کنید به باینری zabbix\_server و اجرا کنید: zabbix_server می توانید از پارامترهای خط فرمان زیر با سرور Zabbix استفاده کنید: -c --config مسیر <file> به فایل پیکربندی (پیش‌فرض /usr/local/etc/zabbix_server.conf است) -f --foreground سرور Zabbix را در پیش زمینه اجرا کنید -R --runtime-control <option> عملکردهای مدیریتی را انجام می دهد -h - کمک به این کمک کنید -V - شماره نسخه نمایش نسخه نمونه هایی از اجرای سرور Zabbix با پارامترهای خط فرمان: zabbix_server -c /usr/local/etc/zabbix_server.conf zabbix_server --help zabbix_server -V ##### Start up manually If the above does not work you have to start it manually. Find the path to the zabbix\_server binary and execute: zabbix_server You can use the following command line parameters with Zabbix server: -c --config <file> path to the configuration file (default is /usr/local/etc/zabbix_server.conf) -f --foreground run Zabbix server in foreground -R --runtime-control <option> perform administrative functions -h --help give this help -V --version display version number Examples of running Zabbix server with command line parameters: zabbix_server -c /usr/local/etc/zabbix_server.conf zabbix_server --help zabbix_server -V ##### راه اندازی دستی اگر موارد بالا جواب نداد، باید آن را به صورت دستی شروع کنید. مسیر را پیدا کنید به باینری zabbix\_server و اجرا کنید: zabbix_server می توانید از پارامترهای خط فرمان زیر با سرور Zabbix استفاده کنید: -c --config مسیر <file> به فایل پیکربندی (پیش‌فرض /usr/local/etc/zabbix_server.conf است) -f --foreground سرور Zabbix را در پیش زمینه اجرا کنید -R --runtime-control <option> عملکردهای مدیریتی را انجام می دهد -h - کمک به این کمک کنید -V - شماره نسخه نمایش نسخه نمونه هایی از اجرای سرور Zabbix با پارامترهای خط فرمان: zabbix_server -c /usr/local/etc/zabbix_server.conf zabbix_server --help zabbix_server -V ##### Start-up scripts The scripts are used to automatically start/stop Zabbix processes during system's start-up/shutdown. The scripts are located under directory misc/init.d. ##### اسکریپت های راه اندازی اسکریپت ها برای شروع/توقف خودکار فرآیندهای Zabbix در طول استفاده می شوند راه اندازی/خاموش شدن سیستم اسکریپت ها در زیر دایرکتوری قرار دارند misc/init.d. ##### Step 1 Configure [some media](media), such as e-mail, SMS, or script to use for the notifications. Refer to the corresponding sections of the manual to perform this task. ::: noteimportant For notifying on internal events the default severity ('Not classified') is used, so leave it checked when configuring [user media](/manual/config/notifications/media/email#user_media) if you want to receive notifications for internal events. ::: ##### مرحله 1 [برخی رسانه] (رسانه)، مانند ایمیل، پیامک یا اسکریپت را برای استفاده پیکربندی کنید اطلاعیه ها به بخش های مربوطه در دفترچه راهنما مراجعه کنید این وظیفه را انجام دهد. ::: نکته مهم برای اطلاع رسانی در مورد رویدادهای داخلی به طور پیش فرض شدت ("طبقه بندی نشده") استفاده می شود، بنابراین در چه زمانی آن را بررسی کنید پیکربندی [کاربر رسانه](/دستی/پیکربندی/اعلان‌ها/رسانه/ایمیل#user_media) در صورت تمایل برای دریافت اعلان رویدادهای داخلی ::: ##### Step 1 Defining a network discovery rule for our IP range. ![](../../../../assets/en/manual/discovery/network_discovery/discovery.png) Zabbix will try to discover hosts in the IP range of 192.168.1.1-192.168.1.254 by connecting to Zabbix agents and getting the value from the **system.uname** key. The value received from the agent can be used to name the hosts and also to apply different actions for different operating systems. For example, link Windows servers to the template *Windows*, Linux servers to the template *Linux*. The rule will be executed every 10 minutes. When this rule is added, Zabbix will automatically start the discovery and generation of the discovery-based events for further processing. ##### مرحله 1 تعریف قانون کشف شبکه برای محدوده IP ما. ![](../../../../assets/en/manual/discovery/network_discovery/discovery.png) Zabbix سعی خواهد کرد میزبان ها را در محدوده IP کشف کند 192.168.1.1-192.168.1.254 با اتصال به عوامل Zabbix و دریافت مقدار از کلید **system.uname**. ارزش دریافتی از نماینده می توان برای نامگذاری هاست ها و همچنین اعمال اعمال مختلف برای آنها استفاده کرد سیستم عامل های مختلف به عنوان مثال، سرورهای ویندوز را به قالب *ویندوز*، سرورهای لینوکس به قالب *لینوکس*. این قانون هر 10 دقیقه یکبار اجرا می شود. هنگامی که این قانون اضافه می شود، Zabbix به طور خودکار کشف را شروع می کند و تولید رویدادهای مبتنی بر کشف برای پردازش بیشتر. ##### Step 1 Find out the SNMP string (or OID) of the item you want to monitor. To get a list of SNMP strings, use the **snmpwalk** command (part of [net-snmp](http://www.net-snmp.org/) software which you should have installed as part of the Zabbix installation) or equivalent tool: snmpwalk -v 2c -c public <host IP> . As '2c' here stands for SNMP version, you may also substitute it with '1', to indicate SNMP Version 1 on the device. This should give you a list of SNMP strings and their last value. If it doesn't then it is possible that the SNMP 'community' is different from the standard 'public' in which case you will need to find out what it is. You can then go through the list until you find the string you want to monitor, e.g. if you wanted to monitor the bytes coming in to your switch on port 3 you would use the `IF-MIB::ifHCInOctets.3` string from this line: IF-MIB::ifHCInOctets.3 = Counter64: 3409739121 You may now use the **snmpget** command to find out the numeric OID for 'IF-MIB::ifHCInOctets.3': snmpget -v 2c -c public -On <host IP> IF-MIB::ifHCInOctets.3 Note that the last number in the string is the port number you are looking to monitor. See also: [Dynamic indexes](/manual/config/items/itemtypes/snmp/dynamicindex). This should give you something like the following: .1.3.6.1.2.1.31.1.1.1.6.3 = Counter64: 3472126941 Again, the last number in the OID is the port number. ::: notetip Some of the most used SNMP OIDs are [translated automatically to a numeric representation](/manual/config/items/itemtypes/snmp/special_mibs) by Zabbix. ::: In the last example above value type is "Counter64", which internally corresponds to ASN\_COUNTER64 type. The full list of supported types is ASN\_COUNTER, ASN\_COUNTER64, ASN\_UINTEGER, ASN\_UNSIGNED64, ASN\_INTEGER, ASN\_INTEGER64, ASN\_FLOAT, ASN\_DOUBLE, ASN\_TIMETICKS, ASN\_GAUGE, ASN\_IPADDRESS, ASN\_OCTET\_STR and ASN\_OBJECT\_ID. These types roughly correspond to "Counter32", "Counter64", "UInteger32", "INTEGER", "Float", "Double", "Timeticks", "Gauge32", "IpAddress", "OCTET STRING", "OBJECT IDENTIFIER" in **snmpget** output, but might also be shown as "STRING", "Hex-STRING", "OID" and other, depending on the presence of a display hint. ##### مرحله 1 رشته SNMP (یا OID) موردی را که می خواهید نظارت کنید پیدا کنید. برای دریافت لیستی از رشته های SNMP، از دستور **snmpwalk** (بخشی از [net-snmp](http://www.net-snmp.org/) نرم افزاری که باید داشته باشید نصب شده به عنوان بخشی از نصب Zabbix) یا ابزار معادل: snmpwalk -v 2c -c public <host IP> . از آنجایی که '2c' در اینجا مخفف نسخه SNMP است، می توانید آن را نیز جایگزین کنید '1'، برای نشان دادن SNMP نسخه 1 در دستگاه. این باید لیستی از رشته های SNMP و آخرین مقدار آنها را به شما ارائه دهد. اگر این پس این امکان وجود ندارد که «جامعه» SNMP با آن متفاوت باشد استاندارد "عمومی" که در این صورت شما باید بفهمید که چیست است. سپس می توانید لیست را مرور کنید تا زمانی که رشته مورد نظر خود را پیدا کنید مانیتور، به عنوان مثال اگر می‌خواهید بایت‌هایی که به شما وارد می‌شوند را نظارت کنید پورت 3 را روشن کنید و از رشته «IF-MIB::ifHCinOctets.3» استفاده کنید. این خط: IF-MIB::ifHCinOctets.3 = Counter64: 3409739121 اکنون می توانید از دستور **snmpget** برای پیدا کردن OID عددی برای آن استفاده کنید 'IF-MIB::ifHCinOctets.3': snmpget -v 2c -c public -On <host IP> IF-MIB::ifHCInOctets.3 توجه داشته باشید که آخرین عدد در رشته، شماره پورتی است که شما هستید به دنبال نظارت همچنین ببینید: [پویا indexes](/manual/config/item/itemtypes/snmp/dynamicindex). این باید چیزی شبیه به زیر به شما بدهد: .1.3.6.1.2.1.31.1.1.1.6.3 = Counter64: 3472126941 باز هم آخرین عدد در OID شماره پورت است. ::: یادداشت برخی از پرکاربردترین OIDهای SNMP [ترجمه شده است به طور خودکار به یک عدد نمایندگی](/manual/config/items/itemtypes/snmp/special_mibs) توسط زبیکس. ::: در آخرین مثال بالا نوع مقدار "Counter64" است که به صورت داخلی مربوط به نوع ASN\_COUNTER64 است. لیست کامل انواع پشتیبانی شده است ASN\_COUNTER، ASN\_COUNTER64، ASN\_UINTEGER، ASN\_UNSIGNED64، ASN\_INTEGER، ASN\_INTEGER64، ASN\_FLOAT، ASN\_DOUBLE، ASN\_TIMETICKS، ASN\_GAUGE، ASN\_IPADDRESS، ASN\_OCTET\_STR و ASN\_OBJECT\_ID. این انواع تقریباً با "Counter32" مطابقت دارند، "Counter64"، "UInteger32"، "INTEGER"، "Float"، "Double"، "Timeticks"، "Gauge32"، "IPAddress"، "OCTET STRING"، "OBJECT IDENTIFIER" در خروجی **snmpget**، اما ممکن است به صورت "STRING"، "Hex-STRING" نیز نشان داده شود. "OID" و موارد دیگر، بسته به وجود یک اشاره نمایشگر. ##### Step 1 Install Kerberos package. For Debian/Ubuntu: apt install krb5-user For RHEL: dnf install krb5-workstation ##### مرحله 1 بسته Kerberos را نصب کنید. برای دبیان/اوبونتو: apt install krb5-user برای RHEL: dnf نصب krb5-workstation ##### Step 2 [Create a host](/manual/config/hosts/host) corresponding to a device. ![](../../../../../assets/en/manual/config/items/itemtypes/snmp/snmp_host.png) Add an SNMP interface for the host: - Enter the IP address/DNS name and port number - Select the *SNMP version* from the dropdown - Add interface credentials depending on the selected SNMP version: - SNMPv1, v2 require only the community (usually 'public') - SNMPv3 requires more specific options (see below) - Leave the *Use bulk requests* checkbox marked to allow bulk processing of SNMP requests |SNMPv3 parameter|Description| |--|--------| |*Context name*|Enter context name to identify item on SNMP subnet.<br>*Context name* is supported for SNMPv3 items since Zabbix 2.2.<br>User macros are resolved in this field.| |*Security name*|Enter security name.<br>User macros are resolved in this field.| |*Security level*|Select security level:<br>**noAuthNoPriv** - no authentication nor privacy protocols are used<br>**AuthNoPriv** - authentication protocol is used, privacy protocol is not<br>**AuthPriv** - both authentication and privacy protocols are used| |*Authentication protocol*|Select authentication protocol - *MD5*, *SHA1*, *SHA224*, *SHA256*, *SHA384* or *SHA512*.| |*Authentication passphrase*|Enter authentication passphrase.<br>User macros are resolved in this field.| |*Privacy protocol*|Select privacy protocol - *DES*, *AES128*, *AES192*, *AES256*, *AES192C* (Cisco) or *AES256C* (Cisco).<br>Note that:<br>- on some older systems net-snmp may not support AES256;<br>- on some newer systems (for example, RHEL9) support of DES may be dropped for the net-snmp package.| |*Privacy passphrase*|Enter privacy passphrase.<br>User macros are resolved in this field.| In case of wrong SNMPv3 credentials (security name, authentication protocol/passphrase, privacy protocol): - Zabbix receives an ERROR from net-snmp, except for wrong *Privacy passphrase* in which case Zabbix receives a TIMEOUT error from net-snmp; - (since Zabbix 6.0.13) SNMP interface availability will switch to red (unavailable). ::: notewarning Changes in *Authentication protocol*, *Authentication passphrase*, *Privacy protocol* or *Privacy passphrase*, made without changing the *Security name*, will take effect only after the cache on a server/proxy is manually cleared (by using [-R snmp\_cache\_reload](/manual/concepts/server#running_server)) or the server/proxy is restarted. In cases, where *Security name* is also changed, all parameters will be updated immediately. ::: You can use one of the provided SNMP templates (*Template SNMP Device* and others) that will automatically add a set of items. However, the template may not be compatible with the host. Click on *Add* to save the host. ##### گام 2 [یک میزبان] (/دستی/پیکربندی/میزبان/میزبان) مربوط به یک دستگاه. ![](../../../../../assets/en/manual/config/items/itemtypes/snmp/snmp_host.png) یک رابط SNMP برای میزبان اضافه کنید: - آدرس IP/نام DNS و شماره پورت را وارد کنید - *نسخه SNMP* را از منوی بازشو انتخاب کنید - اعتبار رابط را بسته به نسخه SNMP انتخاب شده اضافه کنید: - SNMPv1، v2 فقط به انجمن نیاز دارند (معمولاً "عمومی") - SNMPv3 به گزینه های خاص تری نیاز دارد (به زیر مراجعه کنید) - کادر انتخاب *استفاده از درخواست های انبوه* را علامت گذاری کنید تا حجیم مجاز باشد پردازش درخواست های SNMP |پارامتر SNMPv3|توضیحات| |--|--------| |*Context name*|نام زمینه را برای شناسایی مورد در زیرشبکه SNMP وارد کنید.<br>*نام زمینه* از Zabbix 2.2 برای موارد SNMPv3 پشتیبانی می شود.<br>ماکروهای کاربر در این قسمت حل می شوند.| |*نام امنیتی*|نام امنیتی را وارد کنید.<br>ماکروهای کاربر در این قسمت حل می شوند.| |*سطح امنیتی*|سطح امنیتی را انتخاب کنید:<br>**noAuthNoPriv** - هیچ احراز هویت و پروتکل های حریم خصوصی استفاده نمی شود<br>**AuthNoPriv** - پروتکل احراز هویت استفاده می شود، پروتکل حریم خصوصی نیست<br>**AuthPriv ** - هر دو پروتکل احراز هویت و حریم خصوصی استفاده می شود| |*پروتکل احراز هویت*|پروتکل احراز هویت را انتخاب کنید - *MD5*، *SHA1*، *SHA224*، *SHA256*، *SHA384* یا *SHA512*.| |*عبارت عبور احراز هویت*|عبارت عبور احراز هویت را وارد کنید.<br>ماکروهای کاربر در این قسمت حل می شوند.| |*پروتکل حریم خصوصی*|پروتکل حریم خصوصی را انتخاب کنید - *DES*، *AES128*، *AES192*، *AES256*، *AES192C* (سیسکو) یا *AES256C* (سیسکو).<br>توجه داشته باشید که:<br>- در برخی از سیستم های قدیمی net-snmp ممکن است AES256 را پشتیبانی نکند؛<br>- در برخی از سیستم های جدیدتر (به عنوان مثال، RHEL9) ممکن است پشتیبانی از DES برای بسته net-snmp حذف شود.| |*عبارات عبور حریم خصوصی*|عبارت عبور حریم خصوصی را وارد کنید.<br>ماکروهای کاربر در این قسمت حل می شوند.| در صورت اشتباه بودن اعتبارنامه SNMPv3 (نام امنیتی، احراز هویت پروتکل / عبارت عبور، پروتکل حریم خصوصی): - Zabbix یک ERROR از net-snmp دریافت می کند، به جز برای *عبارت عبور حریم خصوصی* اشتباه است که در این صورت Zabbix یک خطای TIMEOUT از net-snmp دریافت می کند. - (از Zabbix 6.0.13) در دسترس بودن رابط SNMP به قرمز تغییر می کند (در دسترس نیست). ::: هشدار تغییرات در *پروتکل احراز هویت*، *عبارت عبور احراز هویت*، *پروتکل حریم خصوصی* یا *عبارت عبور حریم خصوصی*، ساخته شده بدون تغییر *نام امنیتی*، فقط پس از آن اعمال می شود کش روی سرور/پراکسی به صورت دستی پاک می شود (با استفاده از [-R snmp\_cache\_reload](/manual/concepts/server#running_server)) یا سرور/پراکسی دوباره راه اندازی می شود. در مواردی که *نام امنیتی* نیز وجود دارد تغییر کرد، تمام پارامترها بلافاصله به روز می شوند. ::: می توانید از یکی از الگوهای SNMP ارائه شده استفاده کنید (*SNMP Device* و دیگران) که به طور خودکار مجموعه ای از موارد را اضافه می کند. با این حال ممکن است قالب با هاست سازگار نباشد. برای ذخیره روی *افزودن* کلیک کنید میزبان. ##### Step 2 Defining a discovery [action](/manual/config/notifications/action) for adding the discovered Linux servers to the respective group/template. ![](../../../../assets/en/manual/discovery/network_discovery/discov_action.png) The action will be activated if: - the "Zabbix agent" service is "up" - the value of system.uname (the Zabbix agent key we used in rule definition) contains "Linux" - Uptime is 1 hour (3600 seconds) or more ![](../../../../assets/en/manual/discovery/network_discovery/discov_action_b.png) The action will execute the following operations: - add the discovered host to the "Linux servers" group (and also add host if it wasn't added previously) - link host to the *Linux* template. Zabbix will automatically start monitoring the host using items and triggers from the "Linux" template. ##### گام 2 تعریف یک اکتشاف [عمل](/دستی/تنظیم/اعلان/عمل) برای افزودن سرورهای لینوکس کشف شده به گروه/الگوی مربوطه. ![](../../../../assets/en/manual/discovery/network_discovery/discov_action.png) عمل فعال خواهد شد اگر: - سرویس "عامل Zabbix" "بالا" است - مقدار system.uname (کلید عامل Zabbix که در قانون استفاده کردیم تعریف) حاوی "لینوکس" است - زمان کار 1 ساعت (3600 ثانیه) یا بیشتر است ![](../../../../assets/en/manual/discovery/network_discovery/discov_action_b.png) این اکشن عملیات زیر را اجرا می کند: - میزبان کشف شده را به گروه "سرورهای لینوکس" اضافه کنید (و همچنین اضافه کنید میزبان اگر قبلا اضافه نشده بود) - پیوند میزبان به قالب *لینوکس*. Zabbix به طور خودکار شروع می شود نظارت بر هاست با استفاده از آیتم ها و محرک های "لینوکس" قالب. ##### Step 2 Go to *Configuration → Actions* and select *Internal actions* from the third level menu (or page title dropdown). ![](../../../../assets/en/manual/config/internal_actions.png){width="600"} Click on *Create action* to the right to open an action configuration form. ##### گام 2 به *Configuration → Actions* بروید و *Internal actions* را از قسمت انتخاب کنید منوی سطح سوم (یا کشویی عنوان صفحه). ![](../../../../assets/en/manual/config/internal_actions.png){width="600"} روی *Create action* در سمت راست کلیک کنید تا یک پیکربندی عمل باز شود فرم. ##### Step 3 Create a Kerberos ticket for user *zabbix*. Run the following command as user *zabbix*: kinit zabbix ::: noteimportant It is important to run the above command as user *zabbix*. If you run it as *root* the authentication will not work. ::: ##### مرحله 3 یک بلیط Kerberos برای کاربر *zabbix* ایجاد کنید. دستور زیر را به صورت اجرا کنید کاربر *zabbix*: kinit zabbix ::: نکته مهم اجرای دستور بالا به عنوان کاربر مهم است *zabbix*. اگر آن را به صورت *root* اجرا کنید، احراز هویت انجام نمی شود کار کردن ::: ##### Step 3 Defining a discovery action for adding the discovered Windows servers to the respective group/template. ![](../../../../assets/en/manual/discovery/network_discovery/discov_action_win.png) ![](../../../../assets/en/manual/discovery/network_discovery/discov_action_win_b.png) ##### مرحله 3 تعریف یک عمل کشف برای افزودن سرورهای ویندوز کشف شده به گروه/الگوی مربوطه ![](../../../../assets/en/manual/discovery/network_discovery/discov_action_win.png) ![](../../../../assets/en/manual/discovery/network_discovery/discov_action_win_b.png) ##### Step 3 In the **Action** tab enter a name for the action. Then click on *Add* in the condition block to add a new condition. In the new condition popup window select *Event type* as the condition type and then select *Item in "not supported" state* as the event type value. ![](../../../../assets/en/manual/config/notifications/action/report_unsupported_cond.png) Don't forget to click on *Add* to actually list the condition in the *Conditions* block. ##### مرحله 3 در تب **عمل** نامی برای عمل وارد کنید. سپس روی *افزودن* کلیک کنید در بلوک شرط برای اضافه کردن یک شرط جدید. در پنجره بازشو شرط جدید، *نوع رویداد* را به عنوان شرط انتخاب کنید تایپ کنید و سپس *Item in "not supported"* را به عنوان نوع رویداد انتخاب کنید ارزش. ![](../../../../assets/en/manual/config/notifications/action/report_unsupported_cond.png) فراموش نکنید که روی *افزودن* کلیک کنید تا در واقع شرایط را در لیست لیست کنید بلوک *شرایط*. ##### Step 4 Create a web scenario or HTTP agent item with Kerberos authentication type. Optionally can be tested with the following curl command: curl -v --negotiate -u : http://example.com Note that for lengthy web monitoring it is necessary to take care of renewing the Kerberos ticket. Default time of ticket expiration is 10h. ##### مرحله 4 یک سناریو وب یا آیتم عامل HTTP با احراز هویت Kerberos ایجاد کنید نوع به صورت اختیاری می توان با دستور curl زیر آزمایش کرد: curl -v --negotiate -u : http://example.com توجه داشته باشید که برای نظارت طولانی مدت باید مراقب باشید تمدید بلیط Kerberos. زمان پیش فرض انقضای بلیط 10 ساعت است. ##### Step 4 Defining a discovery action for removing lost servers. ![](../../../../assets/en/manual/discovery/network_discovery/discov_action_remove.png) ![](../../../../assets/en/manual/discovery/network_discovery/discov_action_remove_b.png) A server will be removed if "Zabbix agent" service is 'down' for more than 24 hours (86400 seconds). ##### مرحله 4 تعریف یک اقدام کشف برای حذف سرورهای از دست رفته. ![](../../../../assets/en/manual/discovery/network_discovery/discov_action_remove.png) ![](../../../../assets/en/manual/discovery/network_discovery/discov_action_remove_b.png) اگر سرویس "عامل Zabbix" برای موارد بیشتر "پایین" باشد، سرور حذف خواهد شد بیش از 24 ساعت (86400 ثانیه). ##### Step 4 In the **Operations** tab, click on *Add* in the *Operations* block and select some recipients of the message (user groups/users) and the media types (or 'All') to use for delivery. Select *Custom message* checkbox if you wish to enter the custom subject/content of the problem message. ![](../../../../assets/en/manual/config/unsupp_operation.png) ![](../../../../assets/en/manual/config/unsupp_operation_b.png) Click on *Add* to actually list the operation in the *Operations* block. If you wish to receive more than one notification, set the operation step duration (interval between messages sent) and add another step. ##### مرحله 4 در تب **عملیات** روی *افزودن* در بلوک *عملیات* کلیک کنید و برخی از گیرندگان پیام (گروه های کاربر/کاربران) و رسانه را انتخاب کنید انواع (یا "همه") برای استفاده برای تحویل. اگر می‌خواهید سفارشی را وارد کنید، کادر *پیام سفارشی* را انتخاب کنید موضوع/محتوای پیام مشکل ![](../../../../assets/en/manual/config/unsupp_operation.png) ![](../../../../assets/en/manual/config/unsupp_operation_b.png) روی *افزودن* کلیک کنید تا عملاً عملیات در بلوک *عملیات* فهرست شود. اگر می خواهید بیش از یک اعلان دریافت کنید، عملیات را تنظیم کنید مدت زمان مرحله (فاصله بین پیام های ارسال شده) و یک مرحله دیگر اضافه کنید. ##### Step 5 The **Recovery operations** block allows to configure a recovery notification when an item goes back to the normal state. Click on *Add* in the *Recovery operations* block, select the operation type, the recipients of the message (user groups/users) and the media types (or 'All') to use for delivery. Select *Custom message* checkbox if you wish to enter the custom subject/content of the problem message. ![](../../../../assets/en/manual/config/unsupp_recovery.png) Click on *Add* in the *Operation details* popup window to actually list the operation in the *Recovery operations* block. ##### مرحله 5 بلوک **عملیات بازیابی** امکان پیکربندی یک بازیابی را فراهم می کند هنگامی که یک مورد به حالت عادی باز می گردد، اطلاع رسانی می شود. روی *افزودن* کلیک کنید در بلوک *عملیات بازیابی*، نوع عملیات را انتخاب کنید گیرندگان پیام (گروه های کاربر/کاربران) و انواع رسانه (یا «همه») برای تحویل استفاده کنید. اگر می‌خواهید سفارشی را وارد کنید، کادر *پیام سفارشی* را انتخاب کنید موضوع/محتوای پیام مشکل ![](../../../../assets/en/manual/config/unsupp_recovery.png) روی *افزودن* در پنجره بازشو *جزئیات عملیات* کلیک کنید تا در واقع لیست شود عملیات در بلوک *عملیات بازیابی*. ##### Step 6 When finished, click on the **Add** button at the bottom of the form. And that's it, you're done! Now you can look forward to receiving your first notification from Zabbix if some item turns unsupported. ##### مرحله 6 پس از اتمام، روی دکمه **افزودن** در پایین فرم کلیک کنید. و تمام شد، تمام شد! اکنون می توانید منتظر دریافت خود باشید در صورت عدم پشتیبانی از برخی موارد، اولین اعلان از Zabbix. #### Steps #### مراحل #### Stopping agent To stop the agent service, you can use Control Panel or do it from command line. To stop a single instance of Zabbix agent started with the default configuration file: zabbix_agentd.exe --stop To stop a single instance of Zabbix agent started with another configuration file: zabbix_agentd.exe --config <your_configuration_file> --stop To stop one of multiple instances of Zabbix agent: zabbix_agentd.exe --config <configuration_file_for_this_instance> --stop --multiple-agents #### عامل شروع برای راه اندازی سرویس عامل، می توانید از کنترل پنل استفاده کنید یا آن را از آن انجام دهید خط فرمان. برای شروع یک نمونه از عامل Zabbix با پیش فرض فایل پیکربندی: zabbix_agentd.exe --start برای شروع یک نمونه از عامل Zabbix با پیکربندی دیگر فایل: zabbix_agentd.exe --config <your_configuration_file> -- start برای شروع یکی از چندین نمونه عامل Zabbix: zabbix_agentd.exe --config <configuration_file_for_this_instance> --start --multiple-agents #### Storing history data in multiple date-based indices This section describes additional steps required to work with pipelines and ingest nodes. To begin with, you must create templates for indices. The following example shows a request for creating uint template: ``` {.java} curl -X PUT \ http://your-elasticsearch.here:9200/_template/uint_template \ -H 'content-type:application/json' \ -d '{ "index_patterns": [ "uint*" ], "settings": { "index": { "number_of_replicas": 1, "number_of_shards": 5 } }, "mappings": { "properties": { "itemid": { "type": "long" }, "clock": { "format": "epoch_second", "type": "date" }, "value": { "type": "long" } } } }' ``` To create other templates, user should change the URL (last part is the name of template), change `"index_patterns"` field to match index name and to set valid mapping, which can be taken from `database/elasticsearch/elasticsearch.map`. For example, the following command can be used to create a template for text index: ``` {.java} curl -X PUT \ http://your-elasticsearch.here:9200/_template/text_template \ -H 'content-type:application/json' \ -d '{ "index_patterns": [ "text*" ], "settings": { "index": { "number_of_replicas": 1, "number_of_shards": 5 } }, "mappings": { "properties": { "itemid": { "type": "long" }, "clock": { "format": "epoch_second", "type": "date" }, "value": { "fields": { "analyzed": { "index": true, "type": "text", "analyzer": "standard" } }, "index": false, "type": "text" } } } }' ``` This is required to allow Elasticsearch to set valid mapping for indices created automatically. Then it is required to create the pipeline definition. Pipeline is some sort of preprocessing of data before putting data in indices. The following command can be used to create pipeline for uint index: ``` {.java} curl -X PUT \ http://your-elasticsearch.here:9200/_ingest/pipeline/uint-pipeline \ -H 'content-type:application/json' \ -d '{ "description": "daily uint index naming", "processors": [ { "date_index_name": { "field": "clock", "date_formats": [ "UNIX" ], "index_name_prefix": "uint-", "date_rounding": "d" } } ] }' ``` User can change the rounding parameter ("date\_rounding") to set a specific index rotation period. To create other pipelines, user should change the URL (last part is the name of pipeline) and change "index\_name\_prefix" field to match index name. See also [Elasticsearch documentation](https://www.elastic.co/guide/en/elasticsearch/reference/master/date-index-name-processor.html). Additionally, storing history data in multiple date-based indices should also be enabled in the new parameter in Zabbix server configuration: ### Option: HistoryStorageDateIndex # Enable preprocessing of history values in history storage to store values in different indices based on date. # 0 - disable # 1 - enable # # Mandatory: no # Default: # HistoryStorageDateIndex=0 #### ذخیره داده های تاریخچه در چندین شاخص مبتنی بر تاریخ این بخش مراحل اضافی مورد نیاز برای کار با خطوط لوله را توضیح می دهد و گره ها را بلعید. برای شروع، باید الگوهایی برای شاخص ها ایجاد کنید. مثال زیر درخواست ایجاد قالب uint را نشان می دهد: ``` {.java} حلقه -X قرار دادن \ http://your-elasticsearch.here:9200/_template/uint_template \ -H 'content-type:application/json' \ -d'{ "index_patterns": [ "بی حسی*" ]، "تنظیمات": { "فهرست مطالب": { "تعداد_مثل": 1، "تعداد_شارد": 5 } }، "نقشه برداری": { "خواص": { "itemid": { "نوع": "طولانی" }، "ساعت": { "format": "epoch_second", "نوع": "تاریخ" }، "ارزش": { "نوع": "طولانی" } } } }' ``` برای ایجاد سایر قالب ها، کاربر باید URL را تغییر دهد (بخش آخر این است نام الگو)، فیلد «index_patterns» را برای مطابقت با نام فهرست تغییر دهید و برای تنظیم نقشه برداری معتبر، که می توان از آن برداشت کرد "پایگاه داده/elasticsearch/elasticsearch.map". برای مثال می توان از دستور زیر برای ایجاد یک قالب برای استفاده کرد نمایه متن: ``` {.java} curl -X PUT \ http://your-elasticsearch.here:9200/_template/text_template \ -H 'content-type:application/json' \ -d'{ "index_patterns": [ "متن*" ]، "تنظیمات": { "فهرست مطالب": { "تعداد_مثل": 1، "تعداد_شارد": 5 } }، "نقشه برداری": { "خواص": { "itemid": { "نوع": "طولانی" }، "ساعت": { "format": "epoch_second", "نوع": "تاریخ" }، "ارزش": { "زمینه های": { "تجزیه و تحلیل": { «شاخص»: درست، "متن را تایپ کنید"، "تحلیل کننده": "استاندارد" } }، «شاخص»: نادرست، "متن را تایپ کنید" } } } }' ``` این مورد برای اجازه دادن به Elasticsearch برای تنظیم نقشه‌برداری معتبر برای شاخص‌ها لازم است به صورت خودکار ایجاد شده است. سپس لازم است خط لوله ایجاد شود تعریف. خط لوله نوعی پیش پردازش داده های قبلی است قرار دادن داده ها در شاخص ها برای ایجاد می توان از دستور زیر استفاده کرد خط لوله برای شاخص Uint: ``` {.java} حلقه -X قرار دادن \ http://your-elasticsearch.here:9200/_ingest/pipeline/uint-pipeline \ -H 'content-type:application/json' \ -d'{ "توضیحات": "نامگذاری فهرست روزانه uint"، "پردازنده ها": [ { "date_index_name": { "فیلد": "ساعت"، "Date_formats": [ "یونیکس" ]، "index_name_prefix": "unint-", "date_rounding": "d" } } ] }' ``` کاربر می تواند پارامتر گرد کردن ("date\_rounding") را برای تنظیم a تغییر دهد دوره چرخش شاخص خاص برای ایجاد خطوط لوله دیگر، کاربر باید URL را تغییر دهید (بخش آخر نام خط لوله است) و تغییر دهید فیلد "index\_name\_prefix" برای مطابقت با نام فهرست. [Elasticsearch مستندات] (https://www.elastic.co/guide/en/elasticsearch/reference/master/date-index-name-processor.html). علاوه بر این، ذخیره داده های تاریخچه در چندین شاخص مبتنی بر تاریخ باید همچنین در پارامتر جدید در پیکربندی سرور Zabbix فعال شود: ### گزینه: HistoryStorageDateIndex # پیش پردازش مقادیر تاریخچه را در ذخیره سازی تاریخ فعال کنید تا مقادیر را بر اساس تاریخ در شاخص های مختلف ذخیره کنید. # 0 - غیرفعال کنید شماره 1 - فعال کردن # # اجباری: خیر # پیش فرض: # HistoryStorageDateIndex=0 ### String history The string history object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |clock|timestamp|Time when that value was received.| |itemid|string|ID of the related item.| |ns|integer|Nanoseconds when the value was received.| |value|string|Received value.| ### تاریخچه رشته The string history object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |clock|timestamp|Time when that value was received.| |itemid|string|ID of the related item.| |ns|integer|Nanoseconds when the value was received.| |value|string|Received value.| #### Strings Strings should be enclosed with single ' or double " quotes. Inside the strings, single or double quotes (depending on which are used to enclose it) and backslashes `\` are escaped with the backslash `\` character. #### رشته های رشته ها باید با گیومه های یک یا دوتایی محصور شوند. در داخل رشته‌ها، نقل‌قول‌های تک یا دوتایی (بسته به اینکه کدام مورد برای محصور کردن استفاده می‌شود it) و بک اسلش های `\` با کاراکتر بک اسلش `\` حذف می شوند. #### Supported functions |Function|Description| |--|--------| |*avg_foreach*|Returns the average value for each item.| |*bucket_rate_foreach*|Returns pairs (bucket upper bound, rate value) suitable for use in the [histogram\_quantile()](/manual/appendix/functions/aggregate#aggregate_functions1) function, where "bucket upper bound" is the value of item key parameter defined by the <parameter number> [parameter](#additional_parameters).| |*count_foreach*|Returns the number of values for each item.| |*exists_foreach*|Returns '1' for each enabled item.| |*last_foreach*|Returns the last value for each item.| |*max_foreach*|Returns the maximum value for each item.| |*min_foreach*|Returns the minimum value for each item.| |*sum_foreach*|Returns the sum of values for each item.| #### توابع پشتیبانی شده |عملکرد|توضیح| |--|--------| |*avg_foreach*|مقدار متوسط هر مورد را برمی‌گرداند.| |*bucket_rate_foreach*|جفت‌ها (کران بالای سطل، مقدار نرخ) مناسب برای استفاده در تابع [histogram\_quantile()](/manual/appendix/functions/aggregate#aggregate_functions1) را برمی‌گرداند، که در آن «کران بالای سطل» مقدار است. پارامتر کلید آیتم تعریف شده توسط <parameter number> [parameter](#additional_parameters).| |*count_foreach*|تعداد مقادیر هر مورد را برمی‌گرداند.| |*exists_foreach*|«1» را برای هر مورد فعال برمی‌گرداند.| |*last_foreach*|آخرین مقدار را برای هر مورد برمی‌گرداند.| |*max_foreach*|حداکثر مقدار را برای هر مورد برمی‌گرداند.| |*min_foreach*|حداقل مقدار را برای هر مورد برمی‌گرداند.| |*sum_foreach*|مجموع مقادیر هر مورد را برمی‌گرداند.| #### Supported item keys The table provides details on the item keys that you can use with Zabbix agent items grouped by the item family. See also: - [Items supported by platform](/manual/appendix/items/supported_by_platform) - [Item keys supported by Zabbix agent 2](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2) - [Item keys specific for Windows agent](/manual/config/items/itemtypes/zabbix_agent/win_keys) - [Minimum permission level for Windows agent items](/manual/appendix/items/win_permissions) #### کلیدهای مورد پشتیبانی شده جدول جزئیات کلیدهای موردی را ارائه می دهد که می توانید با Zabbix استفاده کنید اقلام عامل گروه بندی شده توسط خانواده اقلام. همچنین ببینید: - [موارد پشتیبانی شده توسط پلت فرم](/دستی/ضمیمه/آیتم/supported_by_platform) - [کلیدهای مورد پشتیبانی شده توسط عامل Zabbix 2](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2) - [کلیدهای مورد خاص برای ویندوز agent](/manual/config/items/itemtypes/zabbix_agent/win_keys) - [حداقل سطح مجوز برای عامل ویندوز موارد](/دستی/ضمیمه/آیتم/مجوزهای_win) #### Supported platforms Due to the security requirements and mission-critical nature of server operation, UNIX is the only operating system that can consistently deliver the necessary performance, fault tolerance and resilience. Zabbix operates on market leading versions. Zabbix server is tested on the following platforms: - Linux - Solaris - AIX - HP-UX - Mac OS X - FreeBSD - OpenBSD - NetBSD - SCO Open Server - Tru64/OSF1 ::: noteclassic Zabbix may work on other Unix-like operating systems as well. ::: #### پلتفرم های پشتیبانی شده با توجه به الزامات امنیتی و ماهیت ماموریت حیاتی سرور یونیکس تنها سیستم عاملی است که می تواند به طور مداوم عملکرد، تحمل خطا و انعطاف پذیری لازم را ارائه دهد. Zabbix بر روی نسخه های پیشرو بازار کار می کند. سرور Zabbix بر روی پلتفرم های زیر تست شده است: - لینوکس - سولاریس - AIX - HP-UX - Mac OS X - FreeBSD - OpenBSD - NetBSD - سرور باز SCO - Tru64/OSF1 ::: نوتکلاسیک Zabbix ممکن است بر روی سایر سیستم عامل های مشابه یونیکس کار کند خوب. ::: #### Supported platforms Zabbix agent is [supported](https://www.zabbix.com/download_agents?version=6.0+LTS&release=6.0.12&os=Windows&os_version=Any&hardware=amd64&encryption=OpenSSL&packaging=MSI&show_legacy=0) on the following platforms: - Windows (all desktop and server versions since XP) - Linux (also available in [distribution packages](https://www.zabbix.com/download?zabbix=6.0&os_distribution=alma_linux&os_version=9&components=agent&db=&ws=)) - macOS - IBM AIX - FreeBSD - OpenBSD - Solaris It is also possible to download legacy Zabbix agent binaries for [NetBSD](https://www.zabbix.com/download_agents?version=3.2&release=3.2.0&os=NetBSD&os_version=5.0&hardware=i386&encryption=No+encryption&packaging=Archive&show_legacy=1) and [HP-UX](https://www.zabbix.com/download_agents?version=2.4&release=2.4.4&os=HPUX&os_version=11.31&hardware=amd64&encryption=No+encryption&packaging=Archive&show_legacy=1), and those are compatible with current Zabbix server/proxy version. #### پلتفرم های پشتیبانی شده عامل Zabbix [پشتیبانی می‌شود](https://www.zabbix.com/download_agents?version=6.0+LTS&release=6.0.12&os=Windows&os_version=Any&hardware=amd64&encryption=OpenSSL&packaging=MSI&show_legacy=0): - ویندوز (همه نسخه های دسکتاپ و سرور از XP) - لینوکس (همچنین در [بسته‌های توزیع] موجود است (https://www.zabbix.com/download?zabbix=6.0&os_distribution=alma_linux&os_version=9&components=agent&db=&ws=)) - سیستم عامل مک - IBM AIX - FreeBSD - OpenBSD - سولاریس همچنین امکان دانلود باینری های عامل Zabbix قدیمی برای [NetBSD](https://www.zabbix.com/download_agents?version=3.2&release=3.2.0&os=NetBSD&os_version=5.0&hardware=i386&encryption=No+encryption&packsaging=No+encryption&1 ) و [HP-UX](https://www.zabbix.com/download_agents?version=2.4&release=2.4.4&os=HPUX&os_version=11.31&hardware=amd64&encryption=No+encryption&packaging=Archive&show_legacy=1) و قابل سازگاری هستند نسخه فعلی سرور/پراکسی Zabbix. #### Supported platforms Zabbix proxy runs on the same list of [supported platforms](/manual/concepts/server#supported_platforms) as Zabbix server. #### پلتفرم های پشتیبانی شده پروکسی Zabbix در همان لیست اجرا می شود [پلتفرم های پشتیبانی شده](/دستی/مفاهیم/سرور#پلتفرم های_پشتیبانی شده) به عنوان سرور Zabbix. #### Supported segments |Segment|Description| |--|--------| |`<name>`|Match object property by name.| |`*`|Match all object properties.| |`['<name>']`|Match object property by name.| |`['<name>', '<name>', ...]`|Match object property by any of the listed names.| |`[<index>]`|Match array element by the index.| |`[<number>, <number>, ...]`|Match array element by any of the listed indexes.| |`[*]`|Match all object properties or array elements.| |`[<start>:<end>]`|Match array elements by the defined range:<br>**<start>** - the first index to match (including). If not specified matches all array elements from the beginning. If negative specifies starting offset from the end of array.<br>**<end>** - the last index to match (excluding). If not specified matches all array elements to the end. If negative specifies starting offset from the end of array.| |`[?(<expression>)]`|Match objects/array elements by applying a filter expression.| To find a matching segment ignoring its ancestry (detached segment) it must be prefixed with '..' , for example `$..name` or `$..['name']` return values of all 'name' properties. Matched element names can be extracted by adding a `~` suffix to the JSONPath. It returns the name of the matched object or an index in string format of the matched array item. The output format follows the same rules as other JSONPath queries - definite path results are returned 'as is' and indefinite path results are returned in array. However there is not much point of extracting the name of an element matching a definite path - it's already known. #### بخش های پشتیبانی شده |قسمت|توضیحات| |--|--------| |`<name>`|ویژگی شی را با نام مطابقت دهید.| |`*`|همه خصوصیات شیء را مطابقت دهید.| |`['<name>']`|ویژگی شی را با نام مطابقت دهید.| |`['<name>', '<name>', ...]`|ویژگی شی را با هر یک از نام های فهرست شده مطابقت دهید.| |`[<index>]`|تطبیق عنصر آرایه بر اساس نمایه.| |`[<شماره>، <تعداد>، ...]`|عنصر آرایه را با هر یک از فهرست‌های فهرست شده مطابقت دهید.| |`[*]`|همه خصوصیات شی یا عناصر آرایه را مطابقت دهید.| |`[<شروع>:<پایان>]`|تطابق عناصر آرایه بر اساس محدوده تعریف شده:<br>**<start>** - اولین شاخصی که مطابقت دارد (از جمله). اگر مشخص نشده باشد با تمام عناصر آرایه از ابتدا مطابقت دارد. اگر منفی شروع آفست را از انتهای آرایه مشخص می کند.<br>**<end>** - آخرین شاخصی که مطابقت دارد (به استثنای). اگر مشخص نشده باشد با تمام عناصر آرایه تا انتها مطابقت دارد. اگر منفی شروع آفست از انتهای آرایه را مشخص می کند.| |`[?(<expression>)]`|تطابق اشیاء/عناصر آرایه با اعمال یک عبارت فیلتر.| برای پیدا کردن یک بخش منطبق با نادیده گرفتن اصل و نسب آن (بخش جدا شده) آن باید با «..» پیشوند باشد، برای مثال «$..name» یا «$..['name']». مقادیر همه ویژگی های 'name' را برمی گرداند. نام عناصر منطبق را می توان با افزودن پسوند «~» به آن استخراج کرد JSONPath. نام شی منطبق یا یک فهرست را در برمی‌گرداند قالب رشته ای مورد آرایه منطبق. فرمت خروجی به شرح زیر است قوانین مشابه سایر پرس و جوهای JSONPath - نتایج مسیر قطعی هستند همانگونه که هست برگردانده می شود و نتایج مسیر نامشخص در آرایه برگردانده می شوند. با این حال استخراج نام یک عنصر فایده زیادی ندارد مطابقت با یک مسیر مشخص - قبلاً شناخته شده است. ## SYNOPSIS **zabbix\_agentd** \[**-c** *config-file*\]\ **zabbix\_agentd** \[**-c** *config-file*\] **-p**\ **zabbix\_agentd** \[**-c** *config-file*\] **-t** *item-key*\ **zabbix\_agentd** \[**-c** *config-file*\] **-R** *runtime-option*\ **zabbix\_agentd -h**\ **zabbix\_agentd -V** [ ]{#lbAD} ## خلاصه **zabbix\_agent2** \[**-c** *config-file*\]\ **zabbix\_agent2** \[**-c** *config-file*\] **-p**\ **zabbix\_agent2** \[**-c** *config-file*\] **-t** *item-key*\ **zabbix\_agent2** \[**-c** *config-file*\] **-R** *runtime-option*\ **zabbix\_agent2 -h**\ **zabbix\_agent2 -V**\ \ [ ]{#lbAD} ## SYNOPSIS **zabbix\_get -s** *host-name-or-IP* \[**-p** *port-number*\] \[**-I** *IP-address*\] \[**-t** *timeout*\] **-k** *item-key*\ **zabbix\_get -s** *host-name-or-IP* \[**-p** *port-number*\] \[**-I** *IP-address*\] \[**-t** *timeout*\] **--tls-connect** **cert** **--tls-ca-file** *CA-file* \[**--tls-crl-file** *CRL-file*\] \[**--tls-agent-cert-issuer** *cert-issuer*\] \[**--tls-agent-cert-subject** *cert-subject*\] **--tls-cert-file** *cert-file* **--tls-key-file** *key-file* \[**--tls-cipher13** *cipher-string*\] \[**--tls-cipher** *cipher-string*\] **-k** *item-key*\ **zabbix\_get -s** *host-name-or-IP* \[**-p** *port-number*\] \[**-I** *IP-address*\] \[**-t** *timeout*\] **--tls-connect** **psk** **--tls-psk-identity** *PSK-identity* **--tls-psk-file** *PSK-file* \[**--tls-cipher13** *cipher-string*\] \[**--tls-cipher** *cipher-string*\] **-k** *item-key*\ **zabbix\_get -h**\ **zabbix\_get -V** [ ]{#lbAD} ## نحوه استفاده **zabbix\_get -s** *host-name-or-IP* \[**-p** *port-number*\] \[**-I** *IP-address*\] \[**-t** *timeout*\] **-k** *item-key*\ **zabbix\_get -s** *host-name-or-IP* \[**-p** *port-number*\] \[**-I** *IP-address*\] \[**-t** *timeout*\] **--tls-connect** **cert** **--tls-ca-file** *CA-file* \[**--tls-crl-file** *CRL-file*\] \[**--tls-agent-cert-issuer** *cert-issuer*\] \[**--tls-agent-cert-subject** *cert-subject*\] **--tls-cert-file** *cert-file* **--tls-key-file** *key-file* \[**--tls-cipher13** *cipher-string*\] \[**--tls-cipher** *cipher-string*\] **-k** *item-key*\ **zabbix\_get -s** *host-name-or-IP* \[**-p** *port-number*\] \[**-I** *IP-address*\] \[**-t** *timeout*\] **--tls-connect** **psk** **--tls-psk-identity** *PSK-identity* **--tls-psk-file** *PSK-file* \[**--tls-cipher13** *cipher-string*\] \[**--tls-cipher** *cipher-string*\] **-k** *item-key*\ **zabbix\_get -h**\ **zabbix\_get -V** [ ]{#lbAD} ## SYNOPSIS **zabbix\_js -s** *script-file* **-p** *input-param* \[**-l** *log-level*\] \[**-t** *timeout*\]\ **zabbix\_js -s** *script-file* **-i** *input-file* \[**-l** *log-level*\] \[**-t** *timeout*\]\ **zabbix\_js -h**\ **zabbix\_js -V** [ ]{#lbAD} ## خلاصه **zabbix\_js -s** *اسکریپت-فایل* **-p** *input-param* \[**-l** *log-level*\] \[**-t** *timeout*\]\ **zabbix\_js -s** *script-file* **-i** *input-file* \[**-l** *log-level*\] \[**-t** *timeout*\]\ **zabbix\_js -h**\ **zabbix\_js -V** [ ]{#lbAD} ## SYNOPSIS **zabbix\_proxy** \[**-c** *config-file*\]\ **zabbix\_proxy** \[**-c** *config-file*\] **-R** *runtime-option*\ **zabbix\_proxy -h**\ **zabbix\_proxy -V** [ ]{#lbAD} ## خلاصه **zabbix\_proxy** \[**-c** *config-file*\]\ **zabbix\_proxy** \[**-c** *config-file*\] **-R** *runtime-option*\ **zabbix\_proxy -h**\ **zabbix\_proxy -V** [ ]{#lbAD} ## SYNOPSIS **zabbix\_sender** \[**-v**\] **-z** *server* \[**-p** *port*\] \[**-I** *IP-address*\] \[**-t** *timeout*\] **-s** *host* **-k** *key* **-o** *value*\ **zabbix\_sender** \[**-v**\] **-z** *server* \[**-p** *port*\] \[**-I** *IP-address*\] \[**-t** *timeout*\] \[**-s** *host*\] \[**-T**\] \[**-N**\] \[**-r**\] **-i** *input-file*\ **zabbix\_sender** \[**-v**\] **-c** *config-file* \[**-z** *server*\] \[**-p** *port*\] \[**-I** *IP-address*\] \[**-t** *timeout*\] \[**-s** *host*\] **-k** *key* **-o** *value*\ **zabbix\_sender** \[**-v**\] **-c** *config-file* \[**-z** *server*\] \[**-p** *port*\] \[**-I** *IP-address*\] \[**-t** *timeout*\] \[**-s** *host*\] \[**-T**\] \[**-N**\] \[**-r**\] **-i** *input-file*\ **zabbix\_sender** \[**-v**\] **-z** *server* \[**-p** *port*\] \[**-I** *IP-address*\] \[**-t** *timeout*\] **-s** *host* **--tls-connect** **cert** **--tls-ca-file** *CA-file* \[**--tls-crl-file** *CRL-file*\] \[**--tls-server-cert-issuer** *cert-issuer*\] \[**--tls-server-cert-subject** *cert-subject*\] **--tls-cert-file** *cert-file* **--tls-key-file** *key-file* \[**--tls-cipher13** *cipher-string*\] \[**--tls-cipher** *cipher-string*\] **-k** *key* **-o** *value*\ **zabbix\_sender** \[**-v**\] **-z** *server* \[**-p** *port*\] \[**-I** *IP-address*\] \[**-t** *timeout*\] \[**-s** *host*\] **--tls-connect** **cert** **--tls-ca-file** *CA-file* \[**--tls-crl-file** *CRL-file*\] \[**--tls-server-cert-issuer** *cert-issuer*\] \[**--tls-server-cert-subject** *cert-subject*\] **--tls-cert-file** *cert-file* **--tls-key-file** *key-file* \[**--tls-cipher13** *cipher-string*\] \[**--tls-cipher** *cipher-string*\] \[**-T**\] \[**-N**\] \[**-r**\] **-i** *input-file*\ **zabbix\_sender** \[**-v**\] **-c** *config-file* \[**-z** *server*\] \[**-p** *port*\] \[**-I** *IP-address*\] \[**-t** *timeout*\] \[**-s** *host*\] **--tls-connect** **cert** **--tls-ca-file** *CA-file* \[**--tls-crl-file** *CRL-file*\] \[**--tls-server-cert-issuer** *cert-issuer*\] \[**--tls-server-cert-subject** *cert-subject*\] **--tls-cert-file** *cert-file* **--tls-key-file** *key-file* \[**--tls-cipher13** *cipher-string*\] \[**--tls-cipher** *cipher-string*\] **-k** *key* **-o** *value*\ **zabbix\_sender** \[**-v**\] **-c** *config-file* \[**-z** *server*\] \[**-p** *port*\] \[**-I** *IP-address*\] \[**-t** *timeout*\] \[**-s** *host*\] **--tls-connect** **cert** **--tls-ca-file** *CA-file* \[**--tls-crl-file** *CRL-file*\] \[**--tls-server-cert-issuer** *cert-issuer*\] \[**--tls-server-cert-subject** *cert-subject*\] **--tls-cert-file** *cert-file* **--tls-key-file** *key-file* \[**--tls-cipher13** *cipher-string*\] \[**--tls-cipher** *cipher-string*\] \[**-T**\] \[**-N**\] \[**-r**\] **-i** *input-file*\ **zabbix\_sender** \[**-v**\] **-z** *server* \[**-p** *port*\] \[**-I** *IP-address*\] \[**-t** *timeout*\] **-s** *host* **--tls-connect** **psk** **--tls-psk-identity** *PSK-identity* **--tls-psk-file** *PSK-file* \[**--tls-cipher13** *cipher-string*\] \[**--tls-cipher** *cipher-string*\] **-k** *key* **-o** *value*\ **zabbix\_sender** \[**-v**\] **-z** *server* \[**-p** *port*\] \[**-I** *IP-address*\] \[**-t** *timeout*\] \[**-s** *host*\] **--tls-connect** **psk** **--tls-psk-identity** *PSK-identity* **--tls-psk-file** *PSK-file* \[**--tls-cipher13** *cipher-string*\] \[**--tls-cipher** *cipher-string*\] \[**-T**\] \[**-N**\] \[**-r**\] **-i** *input-file*\ **zabbix\_sender** \[**-v**\] **-c** *config-file* \[**-z** *server*\] \[**-p** *port*\] \[**-I** *IP-address*\] \[**-t** *timeout*\] \[**-s** *host*\] **--tls-connect** **psk** **--tls-psk-identity** *PSK-identity* **--tls-psk-file** *PSK-file* \[**--tls-cipher13** *cipher-string*\] \[**--tls-cipher** *cipher-string*\] **-k** *key* **-o** *value*\ **zabbix\_sender** \[**-v**\] **-c** *config-file* \[**-z** *server*\] \[**-p** *port*\] \[**-I** *IP-address*\] \[**-t** *timeout*\] \[**-s** *host*\] **--tls-connect** **psk** **--tls-psk-identity** *PSK-identity* **--tls-psk-file** *PSK-file* \[**--tls-cipher13** *cipher-string*\] \[**--tls-cipher** *cipher-string*\] \[**-T**\] \[**-N**\] \[**-r**\] **-i** *input-file*\ **zabbix\_sender -h**\ **zabbix\_sender -V** [ ]{#lbAD} ## خلاصه **zabbix\_sender** \[**-v**\] **-z** *سرور* \[**-p** *port*\] \[**-I** *آدرس IP*\] \[**-t** *timeout*\] **-s** *host* **-k** *key* **-o** *ارزش*\ **zabbix\_sender** \[**-v**\] **-z** *سرور* \[**-p** *port*\] \[**-I** *آدرس IP*\] \[**-t** *timeout*\] \[**-s** *host*\] \[**-T**\] \[**-N**\] \[**-r**\] **-i** *input-file*\ **zabbix\_sender** \[**-v**\] **-c** *config-file* \[**-z** *server*\] \[**-p** *port*\] \[**-I** *آدرس IP*\] \[**-t** *timeout*\] \[**-s** *میزبان*\] **-k** *کلید* **-o** *مقدار*\ **zabbix\_sender** \[**-v**\] **-c** *config-file* \[**-z** *server*\] \[**-p** *port*\] \[**-I** *آدرس IP*\] \[**-t** *timeout*\] \[**-s** *میزبان*\] \[**-T**\] \[**-N**\] \[**-r**\] **-i** *input-file*\ **zabbix\_sender** \[**-v**\] **-z** *سرور* \[**-p** *port*\] \[**-I** *آدرس IP*\] \[**-t** *timeout*\] **-s** *host* **--tls-connect** **cert** **--tls-ca-file** *CA-file* \[**--tls-crl-file** *CRL-file*\] \[**--tls-server-cert-issuer** *cert-issuer*\] \[**--tls-server-cert-subject** *cert-subject*\] **--tls-cert-file** *cert-file* **--tls-key-file** *key-file* \[**--tls-cipher13** *رشته رمز*\] \[**--tls-cipher** *cipher-string*\] **-k** *key* **-o** *ارزش*\ **zabbix\_sender** \[**-v**\] **-z** *سرور* \[**-p** *port*\] \[**-I** *آدرس IP*\] \[**-t** *timeout*\] \[**-s** *host*\] **--tls-connect** **cert** **--tls-ca-file** *CA-file* \[**--tls-crl-file** *CRL-file*\] \[**--tls-server-cert-issuer** *cert-issuer*\] \[**--tls-server-cert-subject** *cert-subject*\] **--tls-cert-file** *cert-file* **--tls-key-file** *key-file* \[**--tls-cipher13** *رشته رمزی*\] \[**--tls-cipher** *cipher-string*\] \[**-T**\] \[**-N**\] \[**-r**\] **-i** *input-file*\ **zabbix\_sender** \[**-v**\] **-c** *config-file* \[**-z** *server*\] \[**-p** *port*\] \[**-I** *آدرس IP*\] \[**-t** *timeout*\] \[**-s** *میزبان*\] **--tls-connect** **cert** **--tls-ca-file** *CA-file* \[**--tls-crl-file** *CRL-file*\] \[**--tls-server-cert-issuer** *گواهی صادرکننده*\] \[**--tls-server-cert-subject** *cert-subject*\] **--tls-cert-file** *cert-file* **--tls-key-file** *key-file* \[**--tls-cipher13** *cipher-string*\] \[**--tls-cipher** *رشته رمز*\] **-k** *کلید* **-o** *مقدار*\ **zabbix\_sender** \[**-v**\] **-c** *config-file* \[**-z** *server*\] \[**-p** *port*\] \[**-I** *آدرس IP*\] \[**-t** *timeout*\] \[**-s** *میزبان*\] **--tls-connect** **cert** **--tls-ca-file** *CA-file* \[**--tls-crl-file** *CRL-file*\] \[**--tls-server-cert-issuer** *گواهی صادرکننده*\] \[**--tls-server-cert-subject** *cert-subject*\] **--tls-cert-file** *cert-file* **--tls-key-file** *key-file* \[**--tls-cipher13** *cipher-string*\] \[**--tls-cipher** *رشته رمز*\] \[**-T**\] \[**-N**\] \[**-r**\] **-i** *input-file*\ **zabbix\_sender** \[**-v**\] **-z** *سرور* \[**-p** *port*\] \[**-I** *آدرس IP*\] \[**-t** *timeout*\] **-s** *host* **--tls-connect** **psk** **--tls-psk-identity** *PSK-identity* **--tls-psk-file** *فایل PSK* \[**--tls-cipher13** *cipher-string*\] \[**--tls-cipher** *رشته رمز*\] **-k** *کلید* **-o** *مقدار*\ **zabbix\_sender** \[**-v**\] **-z** *سرور* \[**-p** *port*\] \[**-I** *آدرس IP*\] \[**-t** *timeout*\] \[**-s** *host*\] **--tls-connect** **psk** **--tls-psk-identity** *PSK-identity* **--tls-psk-file** *فایل PSK* \[**--tls-cipher13** *cipher-string*\] \[**--tls-cipher** *رشته رمز*\] \[**-T**\] \[**-N**\] \[**-r**\] **-i** *input-file*\ **zabbix\_sender** \[**-v**\] **-c** *config-file* \[**-z** *server*\] \[**-p** *port*\] \[**-I** *آدرس IP*\] \[**-t** *timeout*\] \[**-s** *میزبان*\] **--tls-connect** **psk** **--tls-psk-identity** *PSK-identity* **--tls-psk-file** *PSK-file* \[**--tls-cipher13** *cipher-string*\] \[**--tls-cipher** *cipher-string*\] **-k** *key* **-o** *value*\ **zabbix\_sender** \[**-v**\] **-c** *config-file* \[**-z** *server*\] \[**-p** *port*\] \[**-I** *آدرس IP*\] \[**-t** *timeout*\] \[**-s** *میزبان*\] **--tls-connect** **psk** **--tls-psk-identity** *PSK-identity* **--tls-psk-file** *PSK-file* \[**--tls-cipher13** *cipher-string*\] \[**--tls-cipher** *cipher-string*\] \[**-T**\] \[**-N**\] \[**-r**\] **-i** *input-file*\ **zabbix\_sender -h**\ **zabbix\_sender -V** [ ]{#lbAD} ## SYNOPSIS **zabbix\_server** \[**-c** *config-file*\]\ **zabbix\_server** \[**-c** *config-file*\] **-R** *runtime-option*\ **zabbix\_server -h**\ **zabbix\_server -V** [ ]{#lbAD} ## خلاصه **zabbix\_server** \[**-c** *config-file*\]\ **zabbix\_server** \[**-c** *config-file*\] **-R** *runtime-option*\ **zabbix\_server -h**\ **zabbix\_server -V** [ ]{#lbAD} ## SYNOPSIS **zabbix\_web\_service** \[**-c** *config-file*\]\ **zabbix\_web\_service -h**\ **zabbix\_web\_service -V** [ ]{#lbAD} ## خلاصه **zabbix\_web\_service** \[**-c** *config-file*\]\ **zabbix\_web\_service -h**\ **zabbix\_web\_service -V** [ ]{#lbAD} ##### System requirements: - *RAM*: 1.5 GB - *Disk space*: at least 8 GB should be allocated for the virtual machine. Zabbix installation CD/DVD boot menu: ![](../../assets/en/manual/installation_cd_boot_menu1.png){width="600"} Zabbix appliance contains a Zabbix server (configured and running on MySQL) and a frontend. Zabbix virtual appliance is available in the following formats: - VMware (.vmx) - Open virtualization format (.ovf) - Microsoft Hyper-V 2012 (.vhdx) - Microsoft Hyper-V 2008 (.vhd) - KVM, Parallels, QEMU, USB stick, VirtualBox, Xen (.raw) - KVM, QEMU (.qcow2) To get started, boot the appliance and point a browser at the IP the appliance has received over DHCP. ::: noteimportant DHCP must be enabled on the host. ::: To get the IP address from inside the virtual machine run: ip addr show To access Zabbix frontend, go to **http://<host\_ip>** (for access from the host's browser bridged mode should be enabled in the VM network settings). ::: notetip If the appliance fails to start up in Hyper-V, you may want to press `Ctrl+Alt+F2` to switch tty sessions. ::: ##### سیستم مورد نیاز: - *رم*: 1.5 گیگابایت - *فضای دیسک*: حداقل 8 گیگابایت باید به فضای مجازی اختصاص داده شود دستگاه. منوی بوت CD/DVD نصب Zabbix: ![](../../assets/en/manual/installation_cd_boot_menu1.png){width="600"} ابزار Zabbix حاوی یک سرور Zabbix (پیکربندی شده و در حال اجرا است MySQL) و یک فرانت اند. ابزار مجازی Zabbix در قالب های زیر موجود است: - VMware (vmx.) - باز کردن فرمت مجازی سازی (ovf.) - Microsoft Hyper-V 2012 (vhdx.) - Microsoft Hyper-V 2008 (.vhd) - KVM، Parallels، QEMU، USB stick، VirtualBox، Xen (.raw) - KVM، QEMU (.qcow2) برای شروع، دستگاه را راه‌اندازی کنید و مرورگر را روی IP قرار دهید دستگاه از طریق DHCP دریافت کرده است. ::: نکته مهم DHCP باید در هاست فعال باشد. ::: برای دریافت آدرس IP از داخل ماشین مجازی: نمایش ip Adr برای دسترسی به Zabbix frontend، به **http://<host\_ip>** (برای دسترسی از مرورگر میزبان حالت پل شده باید در شبکه VM فعال شود تنظیمات). ::: یادداشت اگر دستگاه در Hyper-V راه اندازی نشد، ممکن است می‌خواهید «Ctrl+Alt+F2» را برای جابه‌جایی جلسات tty فشار دهید. ::: # task.create # sla.create ##### Task manager If the 'Allow manual close' setting is enabled for trigger, then it's possible to manually close problem events generated by the trigger. This is done in the frontend when [updating a problem](/manual/acknowledges#updating_problems). The event is not closed directly – instead a 'close event' task is created, which is handled by the task manager shortly. The task manager will generate a corresponding OK event and the problem event will be closed. ##### Task Manager اگر تنظیم «مجاز بستن دستی» برای راه‌اندازی فعال باشد، در این صورت است بسته شدن دستی رویدادهای مشکل ایجاد شده توسط ماشه امکان پذیر است. این در قسمت جلویی هنگام [به روز رسانی a problem](/manual/acnowledges#updating_problems). رویداد نیست به طور مستقیم بسته شد - به جای آن یک کار "رویداد بسته" ایجاد می شود، که است به زودی توسط مدیر وظیفه رسیدگی می شود. مدیر وظیفه یک را ایجاد می کند رویداد OK مربوطه و رویداد مشکل بسته خواهد شد. # template.create # ساخت قالب # templatedashboard.create # templatedashboard.create # templatedashboard.get # templatedashboard.create ##### Template dashboard tags |Element|Element property|Required|Type|Range^**[1](#footnotes)**^|Description| |--|--|-|--|----|--------| |dashboards| |\-| | |Root element for template dashboards.| | |uuid|x|`string`| |Unique identifier for this dashboard.| | |name|x|`string`| |Template dashboard name.| | |display period|\-|`integer`| |Display period of dashboard pages.| | |auto\_start|\-|`string`|0 - no<br>1 - yes|Slideshow auto start.| |pages| |\-| | |Root element for template dashboard pages.| | |name|\-|`string`| |Page name.| | |display period|\-|`integer`| |Page display period.| | |sortorder|\-|`integer`| |Page sorting order.| |widgets| |\-| | |Root element for template dashboard widgets.| | |type|x|`string`| |Widget type.| | |name|\-|`string`| |Widget name.| | |x|\-|`integer`|0-23|Horizontal position from the left side of the template dashboard.| | |y|\-|`integer`|0-62|Vertical position from the top of the template dashboard.| | |width|\-|`integer`|1-24|Widget width.| | |height|\-|`integer`|2-32|Widget height.| | |hide\_header|\-|`string`|0 - no<br>1 - yes|Hide widget header.| |fields| |\-| | |Root element for the template dashboard widget fields.| | |type|x|`string`|0 - INTEGER<br>1 - STRING<br>3 - HOST<br>4 - ITEM<br>5 - ITEM\_PROTOTYPE<br>6 - GRAPH<br>7 - GRAPH\_PROTOTYPE|Widget field type.| | |name|x|`string`| |Widget field name.| | |value|x|mixed| |Widget field value, depending on the field type.| ##### تگ های داشبورد الگو |عنصر|ویژگی عنصر|لازم|نوع|محدوده^**[1](#پاورقی)**^|توضیحات| |--|--|-|--|----|--------| |داشبورد| |\-| | |عنصر ریشه برای داشبوردهای قالب.| | |uuid|x|`رشته`| |شناسه منحصر به فرد این داشبورد.| | |نام|x|`رشته`| |نام داشبورد قالب.| | |دوره نمایش|\-|`عدد صحیح`| |دوره نمایش صفحات داشبورد.| | |auto\_start|\-|`string`|0 - no<br>1 - yes|شروع خودکار نمایش اسلاید.| |صفحات| |\-| | |عنصر ریشه برای صفحات داشبورد قالب.| | |نام|\-|`رشته`| |نام صفحه.| | |دوره نمایش|\-|`عدد صحیح`| |دوره نمایش صفحه.| | | مرتب کننده|\-|`عدد صحیح`| | ترتیب مرتب سازی صفحات.| |ابزارک| |\-| | |عنصر ریشه برای ویجت های داشبورد الگو.| | |نوع|x|`رشته`| |نوع ویجت.| | |نام|\-|`رشته`| |نام ویجت.| | |x|\-|`عدد صحیح`|0-23|موقعیت افقی از سمت چپ داشبورد الگو.| | |y|\-|`عدد صحیح`|0-62|موقعیت عمودی از بالای داشبورد الگو.| | |عرض|\-|`عدد صحیح`|1-24|عرض ویجت.| | |ارتفاع|\-|`عدد صحیح`|2-32|ارتفاع ویجت.| | |hide\_header|\-|`string`|0 - no<br>1 - yes|پنهان کردن سرصفحه ویجت.| | زمینه ها| |\-| | |عنصر ریشه برای فیلدهای ویجت داشبورد الگو.| | |type|x|`string`|0 - INTEGER<br>1 - STRING<br>3 - HOST<br>4 - ITEM<br>5 - ITEM\_PROTOTYPE<br>6 - GRAPH<br>7 - GRAPH \_PROTOTYPE|نوع فیلد ویجت.| | |نام|x|`رشته`| |نام فیلد ویجت.| | | ارزش|x|مختلط| |مقدار فیلد ویجت، بسته به نوع فیلد.| # templatedashboard.update # templatedashboard.create # template.get # ساخت قالب ##### Template graph tags |Element|Element property|Required|Type|Range^**[1](#footnotes)**^|Description| |--|--|-|--|----|--------| |graphs| |\-| | |Root element for graphs.| | |uuid|x|`string`| |Unique identifier for this graph.| | |name|x|`string`| |Graph name.| | |width|\-|`integer`|20-65535 (default: 900)|Graph width, in pixels. Used for preview and for pie/exploded graphs.| | |height|\-|`integer`|20-65535 (default: 200)|Graph height, in pixels. Used for preview and for pie/exploded graphs.| | |yaxismin|\-|`double`|Default: 0|Value of Y axis minimum.<br><br>Used if 'ymin\_type\_1' is FIXED.| | |yaxismax|\-|`double`|Default: 0|Value of Y axis maximum.<br><br>Used if 'ymax\_type\_1' is FIXED.| | |show\_work\_period|\-|`string`|0 - NO<br>1 - YES (default)|Highlight non-working hours.<br><br>Used by normal and stacked graphs.| | |show\_triggers|\-|`string`|0 - NO<br>1 - YES (default)|Display simple trigger values as a line.<br><br>Used by normal and stacked graphs.| | |type|\-|`string`|0 - NORMAL (default)<br>1 - STACKED<br>2 - PIE<br>3 - EXPLODED|Graph type.| | |show\_legend|\-|`string`|0 - NO<br>1 - YES (default)|Display graph legend.| | |show\_3d|\-|`string`|0 - NO (default)<br>1 - YES|Enable 3D style.<br><br>Used by pie and exploded pie graphs.| | |percent\_left|\-|`double`|Default:0|Show the percentile line for left axis.<br><br>Used only for normal graphs.| | |percent\_right|\-|`double`|Default:0|Show the percentile line for right axis.<br><br>Used only for normal graphs.| | |ymin\_type\_1|\-|`string`|0 - CALCULATED (default)<br>1 - FIXED<br>2 - ITEM|Minimum value of Y axis.<br><br>Used by normal and stacked graphs.| | |ymax\_type\_1|\-|`string`|0 - CALCULATED (default)<br>1 - FIXED<br>2 - ITEM|Maximum value of Y axis.<br><br>Used by normal and stacked graphs.| |ymin\_item\_1| |\-| | |Individual item details.<br><br>Required if 'ymin\_type\_1' is ITEM.| | |host|x|`string`| |Item host.| | |key|x|`string`| |Item key.| |ymax\_item\_1| |\-| | |Individual item details.<br><br>Required if 'ymax\_type\_1' is ITEM.| | |host|x|`string`| |Item host.| | |key|x|`string`| |Item key.| |graph\_items| |x| | |Root element for graph items.| | |sortorder|\-|`integer`| |Draw order. The smaller value is drawn first. Can be used to draw lines or regions behind (or in front of) another.| | |drawtype|\-|`string`|0 - SINGLE\_LINE (default)<br>1 - FILLED\_REGION<br>2 - BOLD\_LINE<br>3 - DOTTED\_LINE<br>4 - DASHED\_LINE<br>5 - GRADIENT\_LINE|Draw style of the graph item.<br><br>Used only by normal graphs.| | |color|\-|`string`| |Element color (6 symbols, hex).| | |yaxisside|\-|`string`|0 - LEFT (default)<br>1 - RIGHT|Side of the graph where the graph item's Y scale will be drawn.<br><br>Used by normal and stacked graphs.| | |calc\_fnc|\-|`string`|1 - MIN<br>2 - AVG (default)<br>4 - MAX<br>7 - ALL (minimum, average and maximum; used only by simple graphs)<br>9 - LAST (used only by pie and exploded pie graphs)|Data to draw if more than one value exists for an item.| | |type|\-|`string`|0 - SIMPLE (default)<br>2 - GRAPH\_SUM (value of the item represents the whole pie; used only by pie and exploded pie graphs)|Graph item type.| |item| |x| | |Individual item.| | |host|x|`string`| |Item host.| | |key|x|`string`| |Item key.| ##### تگ های نمودار الگو |عنصر|ویژگی عنصر|لازم|نوع|محدوده^**[1](#پاورقی)**^|توضیحات| |--|--|-|--|----|--------| | نمودار| |\-| | |عنصر ریشه برای نمودارها.| | |uuid|x|`رشته`| |شناسه منحصر به فرد برای این نمودار.| | |نام|x|`رشته`| |نام نمودار.| | |عرض|\-|`عدد صحیح`|20-65535 (پیش‌فرض: 900)|عرض نمودار، بر حسب پیکسل. برای پیش نمایش و برای نمودارهای پای/منفجر شده استفاده می شود.| | |height|\-|`عدد صحیح`|20-65535 (پیش‌فرض: 200)|ارتفاع نمودار، بر حسب پیکسل. برای پیش نمایش و برای نمودارهای پای/منفجر شده استفاده می شود.| | |yaxismin|\-|`double`|پیش‌فرض: 0|مقدار حداقل محور Y.<br><br>اگر 'ymin\_type\_1' ثابت باشد استفاده می‌شود.| | |yaxismax|\-|`double`|پیش‌فرض: 0|مقدار حداکثر محور Y.<br><br>اگر "ymax\_type\_1" ثابت باشد استفاده می‌شود.| | |show\_work\_period|\-|`string`|0 - NO<br>1 - YES (پیش‌فرض)| ساعات غیر کاری را برجسته کنید.<br><br>در نمودارهای معمولی و پشته‌ای استفاده می‌شود.| | |show\_triggers|\-|`string`|0 - NO<br>1 - YES (پیش‌فرض)|مقادیر راه‌انداز ساده را به‌صورت یک خط نمایش دهید.<br><br>در نمودارهای معمولی و پشته‌ای استفاده می‌شود.| | |نوع|\-|`رشته`|0 - NORMAL (پیش فرض)<br>1 - انباشته<br>2 - PIE<br>3 - EXPLODED|نوع نمودار.| | |show\_legend|\-|`string`|0 - NO<br>1 - YES (پیش‌فرض)|نمایش افسانه نمودار.| | |show\_3d|\-|`string`|0 - NO (پیش‌فرض)<br>1 - YES|فعال کردن سبک سه‌بعدی.<br><br>استفاده شده توسط نمودارهای پای و دایره‌ای منفجر شده.| | |percent\_left|\-|`double`|پیش‌فرض:0|نمایش خط صدک برای محور چپ.<br><br>فقط برای نمودارهای معمولی استفاده می‌شود.| | |%\_right|\-|`double`|پیش‌فرض:0|نمایش خط صدک برای محور سمت راست.<br><br>فقط برای نمودارهای معمولی استفاده می‌شود.| | |ymin\_type\_1|\-|`string`|0 - CALCULATED (پیش‌فرض)<br>1 - ثابت<br>2 - ITEM|حداقل مقدار محور Y.<br><br>استفاده شده توسط عادی و پشته‌ای نمودارها.| | |ymax\_type\_1|\-|`string`|0 - CALCULATED (پیش‌فرض)<br>1 - ثابت<br>2 - ITEM|حداکثر مقدار محور Y.<br><br>استفاده شده توسط عادی و پشته‌ای نمودارها.| |ymin\_item\_1| |\-| | |جزئیات هر مورد.<br><br>اگر 'ymin\_type\_1' ITEM باشد، الزامی است.| | | میزبان|x|`رشته`| | میزبان آیتم.| | |کلید|x|`رشته`| |کلید مورد.| |ymax\_item\_1| |\-| | |جزئیات هر مورد.<br><br>اگر 'ymax\_type\_1' ITEM باشد الزامی است.| | | میزبان|x|`رشته`| | میزبان آیتم.| | |کلید|x|`رشته`| |کلید مورد.| |گراف\_اقلام| |x| | |عنصر ریشه برای آیتم های گراف.| | | مرتب کننده|\-|`عدد صحیح`| | ترتیب قرعه کشی. ابتدا مقدار کوچکتر ترسیم می شود. می توان از آن برای ترسیم خطوط یا مناطق پشت (یا جلوی) دیگری استفاده کرد.| | |drawtype|\-|`string`|0 - SINGLE\_LINE (پیش‌فرض)<br>1 - FILLED\_REGION<br>2 - BOLD\_LINE<br>3 - DOTTED\_LINE<br>4 - DASHED\_LINE <br>5 - GRADIENT\_LINE|سبک مورد گراف را بکشید.<br><br>فقط توسط نمودارهای معمولی استفاده می‌شود.| | |رنگ|\-|`رشته`| |رنگ عنصر (6 علامت، هگزا).| | |yaxisside|\-|`string`|0 - LEFT (پیش‌فرض)<br>1 - RIGHT|سمت نمودار که در آن مقیاس Y مورد نمودار ترسیم می‌شود.<br><br>در نمودارهای معمولی و پشته‌ای استفاده می‌شود. | | |calc\_fnc|\-|`string`|1 - MIN<br>2 - AVG (پیش‌فرض)<br>4 - MAX<br>7 - ALL (حداقل، متوسط و حداکثر؛ فقط توسط نمودارهای ساده استفاده می‌شود)< br>9 - LAST (فقط توسط نمودارهای پای و دایره منفجر شده استفاده می شود)|داده هایی برای ترسیم در صورتی که بیش از یک مقدار برای یک آیتم وجود داشته باشد.| | |type|\-|`string`|0 - SIMPLE (پیش‌فرض)<br>2 - GRAPH\_SUM (مقدار مورد کل پای را نشان می‌دهد؛ فقط توسط نمودارهای پای و دایره منفجر شده استفاده می‌شود)|نوع مورد نمودار.| | آیتم| |x| | |مورد تکی.| | | میزبان|x|`رشته`| | میزبان آیتم.| | |کلید|x|`رشته`| |کلید مورد.| ##### Template low-level discovery rule tags |Element|Element property|Required|Type|Range|Description| |--|--|-|--|----|--------| |discovery\_rules| |\-| | |Root element for low-level discovery rules.| | |*For most of the element tag values, see element tag values for a regular item. Only the tags that are specific to low-level discovery rules, are described below.*| | | | | | |type|\-|`string`|0 - ZABBIX\_PASSIVE (default)<br>2 - TRAP<br>3 - SIMPLE<br>5 - INTERNAL<br>7 - ZABBIX\_ACTIVE<br>10 - EXTERNAL<br>11 - ODBC<br>12 - IPMI<br>13 - SSH<br>14 - TELNET<br>16 - JMX<br>18 - DEPENDENT<br>19 - HTTP\_AGENT<br>20 - SNMP\_AGENT|Item type.| | |lifetime|\-|`string`|Default: 30d|Time period after which items that are no longer discovered will be deleted. Seconds, time unit with suffix or user macro.| |filter| | | | |Individual filter.| | |evaltype|\-|`string`|0 - AND\_OR (default)<br>1 - AND<br>2 - OR<br>3 - FORMULA|Logic to use for checking low-level discovery rule filter conditions.| | |formula|\-|`string`| |Custom calculation formula for filter conditions.| |conditions| |\-| | |Root element for filter conditions.| | |macro|x|`string`| |Low-level discovery macro name.| | |value|\-|`string`| |Filter value: regular expression or global regular expression.| | |operator|\-|`string`|8 - MATCHES\_REGEX (default)<br>9 - NOT\_MATCHES\_REGEX|Condition operator.| | |formulaid|x|`character`| |Arbitrary unique ID that is used to reference a condition from the custom expression. Can only contain capital-case letters. The ID must be defined by the user when modifying filter conditions, but will be generated anew when requesting them afterward.| |lld\_macro\_paths| |\-| | |Root element for LLD macro paths.| | |lld\_macro|x|`string`| |Low-level discovery macro name.| | |path|x|`string`| |Selector for value which will be assigned to the corresponding macro.| |preprocessing| |\-| | |LLD rule value preprocessing.| |step| |\-| | |Individual LLD rule value preprocessing step.| | |*For most of the element tag values, see element tag values for a template item value preprocessing. Only the tags that are specific to template low-level discovery value preprocessing, are described below.*| | | | | | |type|x|`string`|5 - REGEX<br>11 - XMLPATH<br>12 - JSONPATH<br>15 - NOT\_MATCHES\_REGEX<br>16 - CHECK\_JSON\_ERROR<br>17 - CHECK\_XML\_ERROR<br>20 - DISCARD\_UNCHANGED\_HEARTBEAT<br>21 - JAVASCRIPT<br>23 - PROMETHEUS\_TO\_JSON<br>24 - CSV\_TO\_JSON<br>25 - STR\_REPLACE|Type of the item value preprocessing step.| |trigger\_prototypes| |\-| | |Root element for trigger prototypes.| | |*For trigger prototype element tag values, see regular [template trigger](/manual/xml_export_import/templates#template_trigger_tags) tags.*| | | | | |graph\_prototypes| |\-| | |Root element for graph prototypes.| | |*For graph prototype element tag values, see regular [template graph](/manual/xml_export_import/templates#template_graph_tags) tags.*| | | | | |host\_prototypes| |\-| | |Root element for host prototypes.| | |*For host prototype element tag values, see regular [host](/manual/xml_export_import/hosts#host_tags) tags.*| | | | | |item\_prototypes| |\-| | |Root element for item prototypes.| | |*For item prototype element tag values, see regular [template item](/manual/xml_export_import/templates#template_item_tags) tags.*| | | | | |master\_item| |\-| | |Individual item prototype master item/item prototype data.| | |key|x|`string`| |Dependent item prototype master item/item prototype key value.<br><br>Required for a dependent item.| ##### Tags des règles de découverte de bas niveau du modèle |Élément|Propriété de l'élément|Requis|Type|Intervalle|Description| |-------|----------------|--------|----|-----|-----------| |discovery\_rules|<|\-|<|<|Élément racine pour les règles de découverte de bas niveau.| |<|*Pour la plupart des valeurs de tag d'élément, voir les valeurs de tag d'élément pour un élément standard. Seules les tags spécifiques aux règles de découverte de bas niveau sont décrits ci-dessous.*|<|<|<|<| |<|type|\-|`chaîne`|0 - ZABBIX\_PASSIVE (par défaut)<br>2 - TRAP<br>3 - SIMPLE<br>5 - INTERNAL<br>7 - ZABBIX\_ACTIVE<br>10 - EXTERNAL<br>11 - ODBC<br>12 - IPMI<br>13 - SSH<br>14 - TELNET<br>16 - JMX<br>18 - DEPENDENT<br>19 - HTTP\_AGENT<br>20 - SNMP\_AGENT|Type d'élément.| |<|lifetime|\-|`chaîne`|Par défaut : 30d|Période après laquelle les éléments qui ne sont plus découverts seront supprimés. Secondes, unité de temps avec suffixe ou macro utilisateur.| |filter|<|<|<|<|Filtre individuel.| |<|evaltype|\-|`chaîne`|0 - AND\_OR (par défaut)<br>1 - AND<br>2 - OR<br>3 - FORMULA|Logique à utiliser pour vérifier les conditions de filtrage des règles de découverte de bas niveau.| |<|formula|\-|`chaîne`|<| Formule de calcul personnalisée pour les conditions de filtre.| |conditions|<|\-|<|<|Élément racine pour les conditions de filtres.| |<|macro|x|`chaîne`|<|Nom de macro de découverte de bas niveau.| |<|value|\-|`chaîne`|<|Valeur du filtre : expression régulière ou expression régulière globale.| |<|operator|\-|`chaîne`|8 - MATCHES\_REGEX (par défaut)<br>9 - NOT\_MATCHES\_REGEX|Opérateur de condition.| |<|formulaid|x|`caractère`|<|ID unique arbitraire utilisé pour référencer une condition à partir de l'expression personnalisée. Ne peut contenir que des lettres majuscules. L'ID doit être défini par l'utilisateur lors de la modification des conditions de filtrage, mais sera généré à nouveau lors de sa demande ultérieure.| |lld\_macro\_paths|<|\-|<|<|Élément racine pour les chemins de macro LLD.| |<|lld\_macro|x|`chaîne`|<|Nom de la macro de découverte de bas niveau.| |<|path|x|`chaîne`|<|Sélecteur de valeur qui sera affectée à la macro correspondante.| |preprocessing|<|\-|<|<|Prétraitement de la valeur de la règle LLD.| |step|<|\-|<|<|Étape de prétraitement de la valeur de la règle LLD individuelle.| |<|*Pour la plupart des valeurs de tag d'élément, voir les valeurs de tag d'élément pour un élément standard. Seules les tags spécifiques aux règles de découverte de bas niveau sont décrits ci-dessous.*|<|<|<|<| |<|type|x|`chaîne`|5 - REGEX<br>11 - XMLPATH<br>12 - JSONPATH<br>15 - NOT\_MATCHES\_REGEX<br>16 - CHECK\_JSON\_ERROR<br>17 - CHECK\_XML\_ERROR<br>20 - DISCARD\_UNCHANGED\_HEARTBEAT<br>21 - JAVASCRIPT<br>23 - PROMETHEUS\_TO\_JSON<br>24 - CSV\_TO\_JSON<br>25 - STR\_REPLACE|Type d'étape de prétraitement de la valeur de l'élément.| |trigger\_prototypes|<|\-|<|<|Élément racine pour les prototypes de déclencheur.| |<|*Pour les valeurs de tag de prototype de déclencheur, consulter les tags réguliers de [déclencheur du modèle](/manual/xml_export_import/templates#template_trigger_tags).*|<|<|<|<| |graph\_prototypes|<|\-|<|<|Élément racine pour les prototypes de graphique.| |<|*Pour les valeurs de tag de prototype de graphique, consulter les tags de [graphique de modèle](/manual/xml_export_import/templates#template_graph_tags).*|<|<|<|<| |host\_prototypes|<|\-|<|<|Élément racine pour les prototypes d'hôte.| |<|*Pour les valeurs de tag de prototype de hôte, consulter les tags réguliers des [hôtes](/manual/xml_export_import/hosts#host_tags).*|<|<|<|<| |item\_prototypes|<|\-|<|<|Élément racine pour les prototypes d'élément.| |<|*Pour les valeurs de tag de prototype d'élément, consulter les tags réguliers des [éléments](/manual/xml_export_import/templates#template_item_tags).*|<|<|<|<| |master\_item|<|\-|<|<|Elément principale du prototype d'élément individuel/données du prototype d'élément.| |<|key|x|`chaîne`|<| Valeur de clé de prototype d'élément principal de l'élément dépendant.<br><br>Obligatoire pour les éléments dépendants.| # template.massadd # template.massadd # template.massremove # ساخت قالب ## Templates ## الگوها ## Templates ## الگوها #### Templates In a [template](/manual/config/templates/template) configuration, user macros can be used in the following fields: |Location|<|Multiple macros/mix with text^[1](supported_by_location_user#footnotes)^| |-|------------------------------|----------| |*Tags*^[2](supported_by_location_user#footnotes)^|<|<| | |Tag names|yes| |^|Tag values|yes| #### پروکسی ها در یک [پروکسی](/دستی/distributed_monitoring/proxies#configuration) پیکربندی، ماکروهای کاربر را می توان در فیلد زیر استفاده کرد: |موقعیت|<|چند ماکرو/میکس با متن^[1](پشتیبانی_شده توسط_location_user#footnotes)^| |-|-----------------------------|----------| |پورت رابط (برای پراکسی غیرفعال)|<|نه| ##### Template tags |Element|Element property|Required|Type|Range|Description| |--|--|-|--|----|--------| |templates| |\-| | |Root element for templates.| | |uuid|x|`string`| |Unique identifier for this template.| | |template|x|`string`| |Unique template name.| | |name|\-|`string`| |Visible template name.| | |description|\-|`text`| |Template description.| |groups| |x| | |Root element for template host groups.| | |uuid|x|`string`| |Unique identifier for this host group.| | |name|x|`string`| |Host group name.| |templates| |\-| | |Root element for linked templates.| | |name|x|`string`| |Template name.| |tags| |\-| | |Root element for template tags.| | |tag|x|`string`| |Tag name.| | |value|\-|`string`| |Tag value.| |macros| |\-| | |Root element for template user macros.| | |macro|x|`string`| |User macro name.| | |type|\-|`string`|0 - TEXT (default)<br>1 - SECRET\_TEXT<br>2 - VAULT|Type of the macro.| | |value|\-|`string`| |User macro value.| | |description|\-|`string`| |User macro description.| |valuemaps| |\-| | |Root element for template value maps.| | |uuid|x|`string`| |Unique identifier for this value map.| | |name|x|`string`| |Value map name.| | |mapping|\-| | |Root element for mappings.| | |value|x|`string`| |Value of a mapping.| | |newvalue|x|`string`| |New value of a mapping.| ##### تگ های قالب |عنصر|ویژگی عنصر|لازم|نوع|محدوده|توضیحات| |--|--|-|--|----|--------| |قالب ها| |\-| | |عنصر ریشه برای قالب ها.| | |uuid|x|`رشته`| |شناسه منحصر به فرد برای این الگو.| | |قالب|x|`رشته`| |نام قالب منحصر به فرد.| | |نام|\-|`رشته`| |نام قالب قابل مشاهده.| | |توضیحات|\-|`متن`| |شرح قالب.| |گروه| |x| | |عنصر ریشه برای گروه های میزبان الگو.| | |uuid|x|`رشته`| |شناسه منحصر به فرد برای این گروه میزبان.| | |نام|x|`رشته`| |نام گروه میزبان.| |قالب ها| |\-| | |عنصر ریشه برای الگوهای پیوند داده شده.| | |نام|x|`رشته`| |نام قالب.| | برچسب ها| |\-| | |عنصر ریشه برای تگ های قالب.| | |برچسب|x|`رشته`| |نام تگ.| | |مقدار|\-|`رشته`| |مقدار برچسب.| |ماکروها| |\-| | |عنصر ریشه برای ماکروهای کاربر الگو.| | |ماکرو|x|`رشته`| |نام ماکرو کاربر.| | |type|\-|`string`|0 - TEXT (پیش‌فرض)<br>1 - SECRET\_TEXT<br>2 - VAULT|نوع ماکرو.| | |مقدار|\-|`رشته`| |مقدار کلان کاربر.| | |توضیحات|\-|`رشته`| |توضیحات ماکرو کاربر.| |نقشه های ارزش| |\-| | |عنصر ریشه برای نقشه های ارزش الگو.| | |uuid|x|`رشته`| |شناسه منحصر به فرد برای این نقشه مقدار.| | |نام|x|`رشته`| |نام نقشه ارزش.| | |نقشه برداری|\-| | |عنصر ریشه برای نگاشت.| | |مقدار|x|`رشته`| | ارزش یک نقشه برداری.| | |newvalue|x|`string`| |مقدار جدید یک نقشه برداری.| ###### Terminate request A request sent by the agent to shutdown a plugin. | | | |---|---| |direction|agent → plugin| |response|no| The request doesn't have specific parameters, it only contains [common data](#common-data) parameters. *Example:* {"id":3,"type":5} ###### درخواست شروع درخواستی برای اجرای تابع Start رابط Runner. | | | |---|---| |جهت|عامل → افزونه| |پاسخ|نه| درخواست پارامترهای خاصی ندارد، فقط شامل پارامترهای [common data] (#common-data) است. *مثال:* {"id":3,"type":4} ##### Testing To test a report, click the *Test* button at the bottom of the report configuration form. ::: noteclassic The *Test* button is not available if the report configuration form has been opened from the dashboard [action menu](/manual/web_interface/frontend_sections/monitoring/dashboard#viewing_and_editing_a_dashboard). ::: If the configuration is correct, the test report is sent immediately to the current user. For test reports, subscribers and *Generate report by* user settings are ignored. If the configuration is incorrect, an error message is displayed describing the possible cause. ![](../../../assets/en/manual/web_interface/report_test_error.png) ##### آزمایش کردن برای آزمایش یک گزارش، روی دکمه *تست* در پایین فرم پیکربندی گزارش کلیک کنید. ::: نوتکلاسیک اگر فرم پیکربندی گزارش از داشبورد [منوی عملکرد] (/manual/web_interface/frontend_sections/monitoring/dashboard#viewing_and_editing_a_dashboard) باز شده باشد، دکمه *Test* موجود نیست. ::: اگر پیکربندی صحیح باشد، گزارش آزمایش بلافاصله برای کاربر فعلی ارسال می شود. برای گزارش‌های آزمایشی، تنظیمات مشترک و *ایجاد گزارش توسط* کاربر نادیده گرفته می‌شوند. اگر پیکربندی نادرست باشد، یک پیغام خطا نشان داده می شود که علت احتمالی را توضیح می دهد. ![](../../../assets/en/manual/web_interface/report_test_error.png) ### Text history The text history object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |id|string|ID of the history entry.| |clock|timestamp|Time when that value was received.| |itemid|string|ID of the related item.| |ns|integer|Nanoseconds when the value was received.| |value|text|Received value.| ### تاریخچه رشته The text history object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |id|string|ID of the history entry.| |clock|timestamp|Time when that value was received.| |itemid|string|ID of the related item.| |ns|integer|Nanoseconds when the value was received.| |value|text|Received value.| ##### Text The following parameters are supported if *Data* is set to "Text". |Parameter|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-----|-|-----|-------------------| |*Text*|1|columns.text.0|Any string value, including macros.<br>Supported macros: {HOST.\*}, {INVENTORY.\*}.<br><br>Parameter *Text* required if *Data* is set to "Text".| ##### متن اگر *داده* روی "متن" تنظیم شده باشد، پارامترهای زیر پشتیبانی می شوند. |پارامتر|[نوع](/manual/api/reference/dashboard/object#dashboard-widget-field)|نام|مقدار| |-----|-|-----|-------------------| |*Text*|1|columns.text.0|هر مقدار رشته، از جمله ماکروها.<br>ماکروهای پشتیبانی شده: {HOST.\*}، {INVENTORY.\*}.<br><br>Parameter *Text* اگر *داده* روی "متن" تنظیم شده باشد، لازم است| The 1st criterion is a process name (argument <name>). In our example Zabbix agent will see it as 'topasrec'. In order to match, you need to either specify 'topasrec' or to leave it empty. The 2nd criterion is a user name (argument <user>). To match, you need to either specify 'root' or to leave it empty. The 3rd criterion used in process selection is an argument <cmdline>. Zabbix agent will see its value as '/usr/bin/topasrec -L -s 300 -R 1 -r 6 -o /var/perf/daily/ -ypersistent=1 -O type=bin -ystart_time=04:08:54,Mar16,2023'. To match, you need to either specify a regular expression which matches this string or to leave it empty. Arguments <mode> and <memtype> are applied after using the three criteria mentioned above. معیار اول یک نام فرآیند است (آرگمون <نام>). در مثال ما عامل Zabbix آن را به عنوان "topasrec" می بیند. برای مطابقت، باید یا "topasrec" را مشخص کنید یا آن را خالی بگذارید. معیار دوم یک نام کاربری است (Argument <user>). برای مطابقت، باید یا «ریشه» را مشخص کنید یا آن را خالی بگذارید. سومین معیار مورد استفاده در انتخاب فرآیند آرگومان <cmdline> است. عامل Zabbix مقدار خود را به صورت '/usr/bin/topasrec -L -s 300 -R 1 -r 6 -o /var/perf/daily/ -ypersistent=1 -O type=bin -ystart_time=04:08 خواهد دید: 54، مارس 16، 2023 '. برای تطبیق، باید یا یک عبارت منظم را مشخص کنید که با این رشته مطابقت دارد یا آن را خالی بگذارید. آرگومان های <mode> و <memtype> پس از استفاده از سه معیار ذکر شده در بالا اعمال می شوند. The following parameters are supported for all columns. |Parameter|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-----|-|-----|-------------------| |*Name*|1|columns.name.0|Any string value.| |***Data***<br>(required)|0|columns.data.0|1 - Item value;<br>2 - Host name;<br>3 - Text.| |***Base color***<br>(required)|1|columns.base_color.0|Hexadecimal color code (e.g. `FF0000`).| پارامترهای زیر برای همه ستون ها پشتیبانی می شوند. |پارامتر|[نوع](/manual/api/reference/dashboard/object#dashboard-widget-field)|نام|مقدار| |-----|-|-----|-------------------| |*Name*|1|columns.name.0|هر مقدار رشته.| |***داده***<br>(ضروری)|0|columns.data.0|1 - مقدار مورد؛<br>2 - نام میزبان؛<br>3 - متن.| |***رنگ پایه***<br>(الزامی)|1|columns.base_color.0|کد رنگ هگزا دسیمال (به عنوان مثال `FF0000`).| The official zabbix-web-service package is available in the [Zabbix repository](http://repo.zabbix.com/). Google Chrome browser is not included into these packages and has to be installed separately. بسته رسمی zabbix-web-service در [مخزن Zabbix] (http://repo.zabbix.com/) موجود است. مرورگر Google Chrome در این بسته ها گنجانده نشده است و باید جداگانه نصب شود. This page contains navigation links for dashboard widget parameters and possible property values for the respective [dashboard widget field](/manual/api/reference/dashboard/object#dashboard-widget-field) objects. To see the parameters and property values for each widget, go to individual widget pages for: - [Action log](/manual/api/reference/dashboard/widget_fields/action_log) - [Clock](/manual/api/reference/dashboard/widget_fields/clock) - [Discovery status](/manual/api/reference/dashboard/widget_fields/discovery_status) - [Favorite graphs](/manual/api/reference/dashboard/widget_fields/favorite_graphs) - [Favorite maps](/manual/api/reference/dashboard/widget_fields/favorite_maps) - [Geomap](/manual/api/reference/dashboard/widget_fields/geomap) - [Graph](/manual/api/reference/dashboard/widget_fields/graph) - [Graph (classic)](/manual/api/reference/dashboard/widget_fields/graph_classic) - [Graph prototype](/manual/api/reference/dashboard/widget_fields/graph_prototype) - [Host availability](/manual/api/reference/dashboard/widget_fields/host_availability) - [Item value](/manual/api/reference/dashboard/widget_fields/item_value) - [Map](/manual/api/reference/dashboard/widget_fields/map) - [Map navigation tree](/manual/api/reference/dashboard/widget_fields/map_tree) - [Plain text](/manual/api/reference/dashboard/widget_fields/plain_text) - [Problem hosts](/manual/api/reference/dashboard/widget_fields/problem_hosts) - [Problems](/manual/api/reference/dashboard/widget_fields/problems) - [SLA report](/manual/api/reference/dashboard/widget_fields/sla_report) - [System information](/manual/api/reference/dashboard/widget_fields/system) - [Problems by severity](/manual/api/reference/dashboard/widget_fields/problems_severity) - [Top hosts](/manual/api/reference/dashboard/widget_fields/top_hosts) - [Trigger overview](/manual/api/reference/dashboard/widget_fields/trigger_overview) - [URL](/manual/api/reference/dashboard/widget_fields/url) - [Web monitoring](/manual/api/reference/dashboard/widget_fields/web_monitoring) Deprecated widgets: - [Data overview](/manual/api/reference/dashboard/widget_fields/data_overview) این صفحه حاوی پیوندهای ناوبری برای پارامترهای ویجت داشبورد است و مقادیر اموال ممکن برای اشیاء [فیلد ویجت داشبورد](/manual/api/reference/dashboard/object#dashboard-widget-field) مربوطه. برای مشاهده پارامترها و مقادیر ویژگی برای هر ویجت، به صفحات ویجت جداگانه بروید: - [گزارش اقدام](/دستی/api/reference/dashboard/widget_fields/action_log) - [ساعت](/دستی/api/مرجع/داشبورد/فیلدهای_ویجت/ساعت) - [وضعیت کشف](/دستی/api/reference/dashboard/widget_fields/discovery_status) - [نمودارهای دلخواه](/دستی/آپی/مرجع/داشبورد/فیلدهای_ویجت/گرافهای_مورد علاقه) - [نقشه های مورد علاقه] (/دستی/api/reference/dashboard/widget_fields/favorite_maps) - [Geomap](/دستی/api/reference/dashboard/widget_fields/geomap) - [گراف](/دستی/api/مرجع/داشبورد/فیلدهای_ویجت/گراف) - [گراف (کلاسیک)](/دستی/آپی/مرجع/داشبورد/فیلدهای_ویجت/گراف_کلاسیک) - [نمونه اولیه نمودار](/دستی/api/reference/dashboard/widget_fields/graph_prototype) - [در دسترس بودن میزبان](/دستی/api/مرجع/داشبورد/فیلدهای_ویجت/دسترسی_میزبان) - [مقدار مورد](/دستی/api/reference/dashboard/widget_fields/item_value) - [نقشه](/دستی/api/reference/dashboard/widget_fields/map) - [درخت ناوبری نقشه](/دستی/api/reference/dashboard/widget_fields/map_tree) - [متن ساده](/دستی/api/مرجع/داشبورد/فیلدهای_ویجت/متن_ساده) - [میزبان‌های مشکل](/دستی/api/reference/dashboard/widget_fields/problem_hosts) - [مشکلات](/دستی/api/reference/dashboard/widget_fields/problems) - [گزارش SLA](/دستی/api/reference/dashboard/widget_fields/sla_report) - [اطلاعات سیستم] (/دستی/api/reference/dashboard/widget_fields/system) - [مشکلات بر اساس شدت](/دستی/api/reference/dashboard/widget_fields/problems_severity) - [میزبان های برتر](/دستی/api/reference/dashboard/widget_fields/top_hosts) - [نمایش کلی ماشه](/دستی/api/reference/dashboard/widget_fields/trigger_overview) - [URL](/دستی/api/reference/dashboard/widget_fields/url) - [نظارت وب](/دستی/api/مرجع/داشبورد/فیلدهای_ویجت/نظارت_وب) ویجت های منسوخ شده: - [نمایش کلی داده ها] (/دستی/api/مرجع/داشبورد/فیلدهای_ویجت/نمایش_داده) # This topic does not exist yet. We are sorry, the page you are looking for cannot be found. Return to the homepage, try searching, or get [help](https://www.zabbix.com/support). # این موضوع هنوز وجود ندارد. متأسفیم، صفحه مورد نظر شما یافت نشد. به صفحه اصلی بازگردید، جستجو کنید یا [راهنما] (https://www.zabbix.com/support) را دریافت کنید. ##### Time period The **second** parameter allows to specify the time period for aggregation. The time period can only be expressed as time, the amount of values (prefixed with **\#**) is not supported. [Supported unit symbols](/manual/appendix/suffixes) can be used in this parameter for convenience, for example '5m' (five minutes) instead of '300s' (300 seconds) or '1d' (one day) instead of '86400' (86400 seconds). Time period is ignored by the server if passed with the *last\_foreach* function and can thus be omitted: last_foreach(/*/key?[group="host group"]) Time period is not supported with the *exists\_foreach* function. ##### بازه زمانی پارامتر **دومین** اجازه می دهد تا دوره زمانی را مشخص کنید تجمع. دوره زمانی را فقط می توان به صورت زمان، مقدار بیان کرد از مقادیر (با پیشوند **\#**) پشتیبانی نمی شود. [نمادهای واحد پشتیبانی شده](/دستی/ضمیمه/پسوندها) را می توان در این مورد استفاده کرد پارامتر برای راحتی، به عنوان مثال '5m' (پنج دقیقه) به جای '300s' (300 ثانیه) یا '1d' (یک روز) به جای '86400' (86400) ثانیه). اگر با *last\_foreach* سپری شود، بازه زمانی توسط سرور نادیده گرفته می شود. تابع و بنابراین می توان آن را حذف کرد: last_foreach(/*/key?[group="گروه میزبان"]) دوره زمانی با تابع *exists\_foreach* پشتیبانی نمی شود. #### TimescaleDB 2.12 support Support for TimescaleDB version 2.12 is now available. #### پشتیبانی از TimescaleDB 2.12 پشتیبانی از TimescaleDB نسخه 2.12 اکنون در دسترس است. #### TimescaleDB Instructions for creating and configuring TimescaleDB are provided in a separate [section](/manual/appendix/install/timescaledb). #### TimescaleDB دستورالعمل های ایجاد و پیکربندی TimescaleDB در a ارائه شده است جدا [بخش](/دستی/ضمیمه/نصب/timescaledb). ##### Time shift An optional time shift is supported with time or value count as the function parameter. This parameter allows to reference data from a period of time in the past. Time shift starts with `now` - specifying the current time, and is followed by `+N<time unit>` or `-N<time unit>` - to add or subtract N time units. For example, `avg(/host/key,1h:now-1d)` will return the average value for an hour one day ago. ::: noteimportant Time shift specified in months (M) and years (y) is only supported for [trend functions](/manual/appendix/functions/trends). Other functions support seconds (s), minutes (m), hours (h), days (d), and weeks (w). ::: **Time shift with absolute time periods** Absolute time periods are supported in the time shift parameter, for example, midnight to midnight for a day, Monday-Sunday for a week, first day-last day of the month for a month. Time shift for absolute time periods starts with `now` - specifying the current time, and is followed by any number of time operations: `/<time unit>` - defines the beginning and end of the time unit, for example, midnight to midnight for a day, `+N<time unit>` or `-N<time unit>` - to add or subtract N time units. Please note that the value of time shift can be greater or equal to 0, while the time period minimum value is 1. |Parameter|Description| |--|--------| |1d:now/d|Yesterday| |1d:now/d+1d|Today| |2d:now/d+1d|Last 2 days| |1w:now/w|Last week| |1w:now/w+1w|This week| ##### تغییر زمان یک تغییر زمانی اختیاری با شمارش زمان یا مقدار به عنوان پشتیبانی می شود پارامتر تابع این پارامتر اجازه می دهد تا به داده ها از a دوره زمانی در گذشته تغییر زمان با "اکنون" شروع می شود - زمان فعلی را مشخص می کند و است به دنبال آن "+N<واحد زمان>" یا "-N<واحد زمان>" - برای اضافه یا تفریق N واحدهای زمانی برای مثال، `avg(/host/key,1h:now-1d)` مقدار متوسط را برمی گرداند. یک روز پیش برای یک ساعت ::: نکته مهم تغییر زمانی مشخص شده در ماه (M) و سال (y) فقط برای [عملکردهای روند] (/دستی/ضمیمه/توابع/روندها) پشتیبانی می‌شود. سایر توابع از ثانیه (s)، دقیقه (m)، ساعت (h)، روز (d) و هفته (w) پشتیبانی می کنند. ::: **تغییر زمانی با دوره های زمانی مطلق** دوره های زمانی مطلق در پارامتر تغییر زمانی پشتیبانی می شوند، به عنوان مثال، نیمه شب تا نیمه شب برای یک روز، دوشنبه تا یکشنبه برای یک هفته، روز اول - آخرین روز از ماه برای یک ماه تغییر زمانی برای دوره‌های زمانی مطلق با «اکنون» شروع می‌شود - با مشخص کردن آن زمان فعلی و هر تعداد عملیات زمانی به دنبال آن می آید: `/<واحد زمان>` - ابتدا و انتهای واحد زمان را برای به عنوان مثال، نیمه شب تا نیمه شب برای یک روز، `+N<واحد زمان>` یا `-N<واحد زمان>` - برای اضافه یا تفریق N واحد زمان. لطفاً توجه داشته باشید که مقدار تغییر زمانی می تواند بزرگتر یا مساوی 0 باشد. در حالی که حداقل مقدار دوره زمانی 1 است. |پارامتر|توضیحات| |--|--------| |1d:now/d|دیروز| |1d:now/d+1d|امروز| |2d:now/d+1d|2 روز گذشته| |1w:now/w|هفته گذشته| |1w:now/w+1w|این هفته| To compile Zabbix web service from sources, see [Installing Zabbix web service](/manual/installation/install#installing_zabbix_web_service). After the installation, run zabbix\_web\_service on the machine, where the web service is installed: zabbix_web_service برای کامپایل وب سرویس Zabbix از منابع، به [نصب سرویس وب Zabbix](/manual/installation/install#installing_zabbix_web_service) مراجعه کنید. پس از نصب، zabbix\_web\_service را در دستگاهی که وب سرویس نصب شده است اجرا کنید: zabbix_web_service # token.delete پاک کردن عکس # token.generate # token.generate #### Trapper process Receiving internal metric requests from an external Zabbix instance is handled by the trapper process that validates the request, gathers the metrics, creates the JSON data buffer and sends the prepared JSON back, for example, from server: ``` {.java} { "response": "success", "data": { "boottime": N, "uptime": N, "hosts": N, "items": N, "items_unsupported": N, "preprocessing_queue": N, "process": { "alert manager": { "busy": { "avg": N, "max": N, "min": N }, "idle": { "avg": N, "max": N, "min": N }, "count": N }, ... }, "queue": N, "rcache": { "total": N, "free": N, "pfree": N, "used": N, "pused": N }, "requiredperformance": N, "triggers": N, "uptime": N, "vcache": { "buffer": { "total": N, "free": N, "pfree": N, "used": N, "pused": N }, "cache": { "requests": N, "hits": N, "misses": N, "mode": N } }, "vmware": { "total": N, "free": N, "pfree": N, "used": N, "pused": N }, "version": "N", "wcache": { "values": { "all": N, "float": N, "uint": N, "str": N, "log": N, "text": N, "not supported": N }, "history": { "pfree": N, "free": N, "total": N, "used": N, "pused": N }, "index": { "pfree": N, "free": N, "total": N, "used": N, "pused": N }, "trend": { "pfree": N, "free": N, "total": N, "used": N, "pused": N } } } } ``` #### فرآیند Trapper دریافت درخواست های متریک داخلی از یک نمونه خارجی Zabbix است توسط فرآیند trapper که درخواست را تایید می کند، مدیریت می شود معیارها، بافر داده JSON را ایجاد می کند و JSON آماده شده را پس می فرستد، به عنوان مثال، از سرور: ``` {.java} { "پاسخ": "موفقیت"، "داده ها": { "boottime": N، "Uptime": N، "میزبان": N، "اقلام": N، "items_unsupported": N, "preprocessing_queue": N، "روند": { "Alert Manager": { "مشغول": { "متوسط": N، "حداکثر": N، "دقیقه": ن }، "بیکار": { "متوسط": N، "حداکثر": N، "دقیقه": ن }، «شمارش»: ن }، ... }، "صف": N، "rcache": { "کل": N، "رایگان": N، "pfree": N، "استفاده شده": N، "پوسیده": ن }، "عملکرد مورد نیاز": N، "محرک ها": N، "Uptime": N، "vcache": { "بافر": { "کل": N، "رایگان": N، "pfree": N، "استفاده شده": N، "پوسیده": ن }، "کش": { "درخواست ها": N, "Hits": N, "از دست دادن": N، "حالت": N } }، "vmware": { "کل": N، "رایگان": N، "pfree": N، "استفاده شده": N، "پوسیده": ن }، "نسخه": "N", "wcache": { "ارزش های": { "همه": N، "شناور": N، "unint": N، "خیابان": N، "log": N، "متن": N، "پشتیبانی نمی شود": N }، "تاریخ": { "pfree": N، "رایگان": N، "کل": N، "استفاده شده": N، "پوسیده": ن }، "فهرست مطالب": { "pfree": N، "رایگان": N، "کل": N، "استفاده شده": N، "پوسیده": ن }، "روند": { "pfree": N، "رایگان": N، "کل": N، "استفاده شده": N، "پوسیده": ن } } } } ``` ##### Trigger configuration In trigger configuration, enable the *Allow manual close* option. ![](../../../../assets/en/manual/config/manual_close_conf1.png) ##### پیکربندی ماشه در پیکربندی ماشه، گزینه *Allow manual close* را فعال کنید. ![](../../../../assets/en/manual/config/manual_close_conf1.png) # triggerprototype.get # دریافت نمونه اولیه گراف # triggerprototype.update # ساخت هاست نمونه #### Triggers In a [trigger](/manual/config/triggers/trigger) configuration, user macros can be used in the following fields: |Location|<|Multiple macros/mix with text^[1](supported_by_location_user#footnotes)^| |-|------------------------------|----------| |Name|<|yes| |Operational data|<|yes| |Expression (only in constants and function parameters; secret macros are not supported)|<|yes| |Description|<|yes| |URL^[3](supported_by_location_user#footnotes)^|<|yes| |Tag for matching|<|yes| |*Tags*^[2](supported_by_location_user#footnotes)^|<|<| | |Tag names|yes| |^|Tag values|yes| #### محرک ها در یک پیکربندی [trigger](/manual/config/triggers/trigger)، کاربر ماکروها را می توان در زمینه های زیر استفاده کرد: |موقعیت|<|چند ماکرو/میکس با متن^[1](پشتیبانی_شده توسط_location_user#footnotes)^| |-|-----------------------------|----------| |نام|<|بله| |داده های عملیاتی|<|بله| |عبارت (فقط در ثابت ها و پارامترهای تابع؛ ماکروهای مخفی پشتیبانی نمی شوند)|<|بله| |توضیحات|<|بله| |URL^[3](supported_location_user#footnotes)^|<|بله| |برچسب مطابقت|<|بله| |*برچسب ها*^[2](پشتیبانی_شده توسط_location_user#footnotes)^|<|<| | |اسامی برچسب|بله| |^|مقادیر برچسب|بله| ##### Triggers Triggers have an 'OK event generation' setting that controls how OK events are generated: - *Expression* - an OK event is generated for a trigger in problem state when its expression evaluates to FALSE. This is the simplest setting, enabled by default. - *Recovery expression* - an OK event is generated for a trigger in problem state when its expression evaluates to FALSE and the recovery expression evaluates to TRUE. This can be used if trigger recovery criteria is different from problem criteria. - *None* - an OK event is never generated. This can be used in conjunction with multiple problem event generation to simply send a notification when something happens. Additionally triggers have an 'OK event closes' setting that controls which problem events are closed: - *All problems* - an OK event will close all open problems created by the trigger - *All problems if tag values match* - an OK event will close open problems created by the trigger and having at least one matching tag value. The tag is defined by 'Tag for matching' trigger setting. If there are no problem events to close then OK event is not generated. This is often called trigger level event correlation. ##### محرک ها راه‌اندازها یک تنظیم «تولید رویداد تأیید» دارند که میزان تأیید را کنترل می‌کند رویدادها ایجاد می شوند: - *بیان* - یک رویداد OK برای یک ماشه در مشکل ایجاد می شود حالت زمانی که عبارت آن به FALSE ارزیابی شود. این ساده ترین است تنظیم، به طور پیش فرض فعال است. - *عبارت بازیابی* - یک رویداد OK برای یک ماشه در ایجاد می شود حالت مشکل زمانی که عبارت آن به FALSE و مقدار ارزیابی شود عبارت بازیابی به TRUE ارزیابی می شود. این می تواند در صورت ماشه استفاده شود معیارهای بازیابی با معیارهای مشکل متفاوت است. - *هیچ* - یک رویداد OK هرگز تولید نمی شود. این را می توان در استفاده کرد در ارتباط با تولید رویدادهای متعدد مشکل به سادگی ارسال یک اطلاع رسانی زمانی که اتفاقی می افتد علاوه بر این، ماشه‌ها دارای یک تنظیم «تأیید رویداد بسته می‌شوند» هستند که کنترل می‌کند کدام رویدادهای مشکل بسته هستند: - *همه مشکلات* - یک رویداد OK همه مشکلات باز ایجاد شده توسط را می بندد ماشه تفنگ - *همه مشکلات در صورت مطابقت مقادیر برچسب* - یک رویداد OK باز می شود مشکلات ایجاد شده توسط ماشه و داشتن حداقل یک تگ مطابق ارزش. برچسب با تنظیم ماشه "برچسب برای مطابقت" تعریف می شود. اگر هیچ رویداد مشکلی برای بسته شدن وجود ندارد، پس رویداد OK ایجاد نمی شود. این اغلب همبستگی رویداد سطح ماشه نامیده می شود. # trigger.update اپدیت عکس #### Troubleshooting agent items - If used with the passive agent, *Timeout* value in server configuration may need to be higher than *Timeout* in the agent configuration file. Otherwise the item may not get any value because the server request to agent timed out first. #### عیب یابی آیتم های عامل - در صورت استفاده با عامل غیرفعال، مقدار *Timeout* در سرور ممکن است لازم باشد پیکربندی بالاتر از *Timeout* در عامل باشد فایل پیکربندی. در غیر این صورت ممکن است مورد ارزشی نداشته باشد زیرا زمان درخواست سرور به نماینده ابتدا تمام شد. #### Troubleshooting The following steps may help you troubleshoot problems with Elasticsearch setup: 1. Check if the mapping is correct (GET request to required index URL like `http://localhost:9200/uint`). 2. Check if shards are not in failed state (restart of Elasticsearch should help). 3. Check the configuration of Elasticsearch. Configuration should allow access from the Zabbix frontend host and the Zabbix server host. 4. Check Elasticsearch logs. If you are still experiencing problems with your installation then please create a bug report with all the information from this list (mapping, error logs, configuration, version, etc.) #### عیب یابی مراحل زیر ممکن است به شما در رفع مشکلات کمک کند راه اندازی Elasticsearch: 1. بررسی کنید که آیا نقشه برداری درست است (دریافت درخواست به URL فهرست مورد نیاز مانند "http://localhost:9200/uint"). 2. بررسی کنید که آیا خرده ها در وضعیت ناموفق نیستند (Elasticsearch را مجدداً راه اندازی کنید باید کمک کند). 3. پیکربندی Elasticsearch را بررسی کنید. پیکربندی باید اجازه دهد دسترسی از میزبان جلویی Zabbix و میزبان سرور Zabbix. 4. سیاهههای مربوط به Elasticsearch را بررسی کنید. اگر هنوز در نصب خود با مشکل مواجه هستید لطفا یک گزارش اشکال با تمام اطلاعات این لیست ایجاد کنید (نقشه نگاری، گزارش خطا، پیکربندی، نسخه و غیره) ### **unencrypted** connect without encryption (default) ```{=html} <!-- --> ``` **psk** connect using TLS and a pre-shared key ```{=html} <!-- --> ``` **cert** connect using TLS and a certificate ```{=html} <!-- --> ``` **--tls-ca-file** *CA-file* Full pathname of a file containing the top-level CA(s) certificates for peer certificate verification. **--tls-crl-file** *CRL-file* Full pathname of a file containing revoked certificates. **--tls-agent-cert-issuer** *cert-issuer* Allowed agent certificate issuer. **--tls-agent-cert-subject** *cert-subject* Allowed agent certificate subject. **--tls-cert-file** *cert-file* Full pathname of a file containing the certificate or certificate chain. **--tls-key-file** *key-file* Full pathname of a file containing the private key. **--tls-psk-identity** *PSK-identity* PSK-identity string. **--tls-psk-file** *PSK-file* Full pathname of a file containing the pre-shared key. **--tls-cipher13** *cipher-string* Cipher string for OpenSSL 1.1.1 or newer for TLS 1.3. Override the default ciphersuite selection criteria. This option is not available if OpenSSL version is less than 1.1.1. **--tls-cipher** *cipher-string* GnuTLS priority string (for TLS 1.2 and up) or OpenSSL cipher string (only for TLS 1.2). Override the default ciphersuite selection criteria. **-h**, **--help** Display this help and exit. **-V**, **--version** Output version information and exit. [ ]{#lbAG} ### **رمزگذاری نشده** اتصال بدون رمزگذاری (پیش‌فرض) ```{=html} <!---> ``` **psk** با استفاده از TLS و یک کلید مشترک از قبل متصل شوید ```{=html} <!---> ``` **گواهی** با استفاده از TLS و گواهی متصل شوید ```{=html} <!---> ``` **--tls-ca-file** *CA-file* نام مسیر کامل یک فایل حاوی گواهی (های) CA سطح بالا برای تایید گواهی همتا **--tls-crl-file** *CRL-file* نام مسیر کامل یک فایل حاوی گواهی های باطل شده است. **--tls-agent-cert-ssuer** *cert-ssuer* صادرکننده گواهی نماینده مجاز. **--tls-agent-cert-subject** *cert-subject* موضوع گواهی نماینده مجاز **--tls-cert-file** *cert-file* نام مسیر کامل یک فایل حاوی گواهی یا زنجیره گواهی. **--tls-key-file** *key-file* نام مسیر کامل یک فایل حاوی کلید خصوصی. **--tls-psk-identity** *PSK-identity* رشته هویت PSK. **--tls-psk-file** *PSK-file* نام مسیر کامل یک فایل حاوی کلید از پیش مشترک. **--tls-cipher13** *رشته رمز* رشته رمز برای OpenSSL 1.1.1 یا جدیدتر برای TLS 1.3. نادیده گرفتن معیارهای انتخاب مجموعه رمز پیش فرض این گزینه در دسترس نیست اگر نسخه OpenSSL کمتر از 1.1.1 است. **--tls-cipher** *cipher-string* رشته اولویت GnuTLS (برای TLS 1.2 و بالاتر) یا رشته رمز OpenSSL (فقط برای TLS 1.2). معیارهای انتخاب مجموعه رمز پیش فرض را نادیده بگیرید. **-h**، **--راهنما** این راهنما را نمایش دهید و از آن خارج شوید. **-V**، **--نسخه** اطلاعات نسخه خروجی و خروج. [ ]{#lbAG} ### **unencrypted** connect without encryption (default) ```{=html} <!-- --> ``` **psk** connect using TLS and a pre-shared key ```{=html} <!-- --> ``` **cert** connect using TLS and a certificate ```{=html} <!-- --> ``` **--tls-ca-file** *CA-file* Full pathname of a file containing the top-level CA(s) certificates for peer certificate verification. **--tls-crl-file** *CRL-file* Full pathname of a file containing revoked certificates. **--tls-server-cert-issuer** *cert-issuer* Allowed server certificate issuer. **--tls-server-cert-subject** *cert-subject* Allowed server certificate subject. **--tls-cert-file** *cert-file* Full pathname of a file containing the certificate or certificate chain. **--tls-key-file** *key-file* Full pathname of a file containing the private key. **--tls-psk-identity** *PSK-identity* PSK-identity string. **--tls-psk-file** *PSK-file* Full pathname of a file containing the pre-shared key. **--tls-cipher13** *cipher-string* Cipher string for OpenSSL 1.1.1 or newer for TLS 1.3. Override the default ciphersuite selection criteria. This option is not available if OpenSSL version is less than 1.1.1. **--tls-cipher** *cipher-string* GnuTLS priority string (for TLS 1.2 and up) or OpenSSL cipher string (only for TLS 1.2). Override the default ciphersuite selection criteria. **-v**, **--verbose** Verbose mode, **-vv** for more details. **-h**, **--help** Display this help and exit. **-V**, **--version** Output version information and exit. [ ]{#lbAG} ### **رمزگذاری نشده** اتصال بدون رمزگذاری (پیش‌فرض) ```{=html} <!---> ``` **psk** با استفاده از TLS و یک کلید مشترک از قبل متصل شوید ```{=html} <!---> ``` **گواهی** با استفاده از TLS و گواهی متصل شوید ```{=html} <!---> ``` **--tls-ca-file** *CA-file* نام مسیر کامل یک فایل حاوی گواهی (های) CA سطح بالا برای تایید گواهی همتا **--tls-crl-file** *CRL-file* نام مسیر کامل یک فایل حاوی گواهی های باطل شده است. **--tls-server-cert-issuer** *cert-ssuer* صادرکننده گواهی سرور مجاز است. **--tls-server-cert-subject** *cert-subject* موضوع گواهی سرور مجاز است. **--tls-cert-file** *cert-file* نام مسیر کامل یک فایل حاوی گواهی یا زنجیره گواهی. **--tls-key-file** *key-file* نام مسیر کامل یک فایل حاوی کلید خصوصی. **--tls-psk-identity** *PSK-identity* رشته هویت PSK. **--tls-psk-file** *PSK-file* نام مسیر کامل یک فایل حاوی کلید از پیش مشترک. **--tls-cipher13** *رشته رمز* رشته رمز برای OpenSSL 1.1.1 یا جدیدتر برای TLS 1.3. نادیده گرفتن معیارهای انتخاب مجموعه رمز پیش فرض این گزینه در دسترس نیست اگر نسخه OpenSSL کمتر از 1.1.1 است. **--tls-cipher** *cipher-string* رشته اولویت GnuTLS (برای TLS 1.2 و بالاتر) یا رشته رمز OpenSSL (فقط برای TLS 1.2). معیارهای انتخاب مجموعه رمز پیش فرض را نادیده بگیرید. **-v**، **-- پرحرف** حالت پرمخاطب، **-vv** برای جزئیات بیشتر. **-h**، **--راهنما** این راهنما را نمایش دهید و از آن خارج شوید. **-V**، **--نسخه** اطلاعات نسخه خروجی و خروج. [ ]{#lbAG} #### Uninstalling agent Windows service To uninstall a single instance of Zabbix agent using the default configuration file: zabbix_agentd.exe --uninstall To uninstall a single instance of Zabbix agent using a non-default configuration file: zabbix_agentd.exe --config <your_configuration_file> --uninstall To uninstall multiple instances of Zabbix agent from Windows services: zabbix_agentd.exe --config <configuration_file_for_instance_1> --uninstall --multiple-agents zabbix_agentd.exe --config <configuration_file_for_instance_2> --uninstall --multiple-agents ... zabbix_agentd.exe --config <configuration_file_for_instance_N> --uninstall --multiple-agents #### حذف سرویس عامل ویندوز برای حذف یک نمونه از عامل Zabbix با استفاده از پیش فرض فایل پیکربندی: zabbix_agentd.exe -- حذف نصب کنید برای حذف یک نمونه از عامل Zabbix با استفاده از یک غیر پیش فرض فایل پیکربندی: zabbix_agentd.exe --config <your_configuration_file> -- uninstall برای حذف چند نمونه از عامل Zabbix از سرویس های ویندوز: zabbix_agentd.exe --config <configuration_file_for_instance_1> --uninstall --multiple-agents zabbix_agentd.exe --config <configuration_file_for_instance_2> --uninstall --multiple-agents ... zabbix_agentd.exe --config <configuration_file_for_instance_N> --uninstall --multiple-agents #### Unlinking templates from a host Unlink templates "10106", "10104" from template "10085". Request: ```json { "jsonrpc": "2.0", "method": "template.massremove", "params": { "templateids": "10085", "templateids_link": [ "10106", "10104" ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "templateids": [ "10085" ] }, "id": 1 } ``` #### حذف هاست از گروه هاستی Remove two hosts from the given host groups. Request: ```json { "jsonrpc": "2.0", "method": "hostgroup.massremove", "params": { "groupids": [ "5", "6" ], "hostids": [ "30050", "30001" ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "groupids": [ "5", "6" ] }, "id": 1 } ``` #### Unlinking templates Unlink and clear two templates from host. Request: ```json { "jsonrpc": "2.0", "method": "host.update", "params": { "hostid": "10126", "templates_clear": [ { "templateid": "10124" }, { "templateid": "10125" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "hostids": [ "10126" ] }, "id": 1 } ``` #### حذف لینک تمپلیت ها Unlink and clear two templates from host. Request: ```json { "jsonrpc": "2.0", "method": "host.update", "params": { "hostid": "10126", "templates_clear": [ { "templateid": "10124" }, { "templateid": "10125" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "hostids": [ "10126" ] }, "id": 1 } ``` #### Unlinking templates Unlink a template from two hosts and delete all of the templated entities. Request: ```json { "jsonrpc": "2.0", "method": "host.massremove", "params": { "hostids": ["69665", "69666"], "templateids_clear": "325" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "hostids": [ "69665", "69666" ] }, "id": 1 } ``` #### حذف تمپلیت های لینک شده Unlink a template from two hosts and delete all of the templated entities. Request: ```json { "jsonrpc": "2.0", "method": "host.massremove", "params": { "hostids": ["69665", "69666"], "templateids_clear": "325" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "hostids": [ "69665", "69666" ] }, "id": 1 } ``` #### Update dependent item prototype Update Dependent item prototype with new Master item prototype ID. Only dependencies on same host (template/discovery rule) are allowed, therefore Master and Dependent item should have same hostid and ruleid. Request: ```json { "jsonrpc": "2.0", "method": "itemprototype.update", "params": { "master_itemid": "25570", "itemid": "189030" }, "auth": "700ca65537074ec963db7efabda78259", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "189030" ] }, "id": 1 } ``` #### ایجاد آیتم وابسته یک مورد وابسته برای آیتم اصلی با شناسه 24759 ایجاد کنید. فقط وابستگی به همان میزبان مجاز است، بنابراین master و the آیتم وابسته باید میزبان یکسانی داشته باشد. درخواست: ``json { "jsonrpc": "2.0"، "روش": "item.create", "params": { "hostid": "30074"، "name": "آیتم آزمایشی وابسته"، "key_": "dependent.item", "نوع": 18، "master_itemid": "24759"، "نوع_ارزش": 2 }، "auth": "038e1d7b1735c6a5436ee9eae095879e"، "id": 1 } ``` واکنش: ``json { "jsonrpc": "2.0"، "نتیجه": { "اقلام": [ "44211" ] }، "id": 1 } ``` #### Update dependent item Update Dependent item name and Master item ID. Only dependencies on same host are allowed, therefore Master and Dependent item should have same hostid. Request: ```json { "jsonrpc": "2.0", "method": "item.update", "params": { "name": "Dependent item updated name", "master_itemid": "25562", "itemid": "189019" }, "auth": "700ca65537074ec963db7efabda78259", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "189019" ] }, "id": 1 } ``` #### ایجاد آیتم وابسته یک مورد وابسته برای آیتم اصلی با شناسه 24759 ایجاد کنید. فقط وابستگی به همان میزبان مجاز است، بنابراین master و the آیتم وابسته باید میزبان یکسانی داشته باشد. درخواست: ``json { "jsonrpc": "2.0"، "روش": "item.create", "params": { "hostid": "30074"، "name": "آیتم آزمایشی وابسته"، "key_": "dependent.item", "نوع": 18، "master_itemid": "24759"، "نوع_ارزش": 2 }، "auth": "038e1d7b1735c6a5436ee9eae095879e"، "id": 1 } ``` واکنش: ``json { "jsonrpc": "2.0"، "نتیجه": { "اقلام": [ "44211" ] }، "id": 1 } ``` #### Updated templates Integration with OpenShift has been added to [Kubernetes cluster state by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/kubernetes_http/kubernetes_state_http?at=refs%2Fheads%2Frelease%2F6.0) template. #### قالب های به روز شده ادغام با OpenShift به [Kubernetes Cluster State توسط HTTP] اضافه شده است (https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/kubernetes_http/kubernetes_state_http?at=refs%2Fheads%2Frelease قالب %2F6.0). #### Updated templates [PostgreSQL by ODBC](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/postgresql_odbc?at=refs%2Fheads%2Frelease%2F6.0) and [PostgreSQL by Zabbix agent 2](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/postgresql_agent2?at=refs%2Fheads%2Frelease%2F6.0) templates now include the item and trigger for monitoring PostgreSQL version. [Cisco Meraki organization by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/net/meraki_http?at=release%2F6.0) template has been supplemented with items, item prototypes, LLD rules, and macros related to authentication, licenses, networks, SAML roles, and VPN statuses. #### قالب های به روز شده [PostgreSQL توسط ODBC](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/postgresql_odbc?at=refs%2Fheads%2Frelease%2F6.0) و [PostgreSQL توسط Zabbix agent 2](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/postgresql_agent2?at=refs%2Fheads%2Frelease%2F6.0) الگوها اکنون شامل آیتم و ماشه برای نظارت بر نسخه PostgreSQL هستند. [سازمان سیسکو Meraki توسط HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/net/meraki_http?at=release%2F6.0) الگو با آیتم ها، نمونه های اولیه آیتم ها، قوانین LLD و ماکروهای مربوط به تکمیل شده است احراز هویت، مجوزها، شبکه‌ها، نقش‌های SAML و وضعیت‌های VPN. #### Update HTTP agent item Enable item value trapping. Request: ```json { "jsonrpc": "2.0", "method": "item.update", "params": { "itemid": "23856", "allow_traps": 1 }, "auth": "700ca65537074ec963db7efabda78259", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "23856" ] }, "id": 1 } ``` #### فعال سازی وب سناریو Enable a web scenario, that is, set its status to "0". Request: ```json { "jsonrpc": "2.0", "method": "httptest.update", "params": { "httptestid": "5", "status": 0 }, "auth": "700ca65537074ec963db7efabda78259", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "httptestids": [ "5" ] }, "id": 1 } ``` #### Update HTTP agent item prototype Change query fields and remove all custom headers. Request: ```json { "jsonrpc": "2.0", "method": "itemprototype.update", "params": { "itemid":"28305", "query_fields": [ { "random": "qwertyuiopasdfghjklzxcvbnm" } ], "headers": [] } "auth": "700ca65537074ec963db7efabda78259", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "28305" ] }, "id": 1 } ``` #### به روز رسانی آپشن های پیش پردازش قانون LLD Update an LLD rule with preprocessing rule “JSONPath”. Request: ```json { "jsonrpc": "2.0", "method": "discoveryrule.update", "params": { "itemid": "44211", "preprocessing": [ { "type": 12, "params": "$.path.to.json", "error_handler": 2, "error_handler_params": "5" } ] }, "auth": "700ca65537074ec963db7efabda78259", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "44211" ] }, "id": 1 } ``` #### Updating an item with preprocessing Update an item with item preprocessing rule "In range". Request: ```json { "jsonrpc": "2.0", "method": "item.update", "params": { "itemid": "23856", "preprocessing": [ { "type": 13, "params": "\n100", "error_handler": 1, "error_handler_params": "" } ] }, "auth": "700ca65537074ec963db7efabda78259", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "23856" ] }, "id": 1 } ``` #### به روز رسانی آپشن های پیش پردازش قانون LLD Update an LLD rule with preprocessing rule “JSONPath”. Request: ```json { "jsonrpc": "2.0", "method": "discoveryrule.update", "params": { "itemid": "44211", "preprocessing": [ { "type": 12, "params": "$.path.to.json", "error_handler": 2, "error_handler_params": "5" } ] }, "auth": "700ca65537074ec963db7efabda78259", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "44211" ] }, "id": 1 } ``` ##### Updating a report To update an existing report, click the report name, make the required configuration changes, and then click the *Update* button. If an existing report is updated by another user and this user changes the Dashboard, upon clicking the *Update* button, a warning message "Report generated by other users will be changed to the current user" will be displayed. ![](../../../assets/en/manual/web_interface/report_update.png) Clicking *OK* at this step will lead to the following changes: - *Generate report by* settings will be updated to display the user who edited the report last (unless *Generate report by* is set to the recipient). - Users that have been displayed as "Inaccessible user" or "Inaccessible user group" will be deleted from the list of report subscribers. Clicking *Cancel* will close the configuration form and cancel the report update. ##### به روز رسانی گزارش برای به روز رسانی یک گزارش موجود، روی نام گزارش کلیک کنید، تغییرات پیکربندی لازم را انجام دهید و سپس روی دکمه *به روز رسانی* کلیک کنید. در صورتی که یک گزارش موجود توسط کاربر دیگری به روز شود و این کاربر داشبورد را تغییر دهد، با کلیک بر روی دکمه *به روز رسانی*، پیام هشدار "گزارش ایجاد شده توسط سایر کاربران به کاربر فعلی تغییر خواهد کرد" نمایش داده می شود. ![](../../../assets/en/manual/web_interface/report_update.png) با کلیک بر روی *OK* در این مرحله تغییرات زیر ایجاد می شود: - تنظیمات *تولید گزارش توسط* برای نمایش کاربری که آخرین گزارش را ویرایش کرده است به روز می شود (مگر اینکه *تولید گزارش توسط* برای گیرنده تنظیم شده باشد). - کاربرانی که به عنوان «کاربر غیرقابل دسترسی» یا «گروه کاربری غیرقابل دسترسی» نمایش داده شده اند از فهرست مشترکان گزارش حذف خواهند شد. با کلیک بر روی *لغو* فرم پیکربندی بسته می شود و به روز رسانی گزارش لغو می شود. #### Updating a script item prototype Update a script item prototype with a different script and remove unnecessary parameters that were used by previous script. Request: ```json { "jsonrpc": "2.0", "method": "itemprototype.update", "params": { "itemid": "23865", "parameters": [], "script": "Zabbix.Log(3, 'Log test');\nreturn 1;" }, "auth": "700ca65537074ec963db7efabda78259", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "23865" ] }, "id": 1 } ``` #### به روز رسانی اسکریپت قانون LLD Update an LLD rule script with a different script and remove unnecessary parameters that were used by previous script. Request: ```json { "jsonrpc": "2.0", "method": "discoveryrule.update", "params": { "itemid": "23865", "parameters": [], "script": "Zabbix.Log(3, 'Log test');\nreturn 1;" }, "auth": "700ca65537074ec963db7efabda78259", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "23865" ] }, "id": 1 } ``` #### Updating dashboard pages Rename the first dashboard page, replace widgets on the second dashboard page and add a new page as the third one. Delete all other dashboard pages. Request: ```json { "jsonrpc": "2.0", "method": "dashboard.update", "params": { "dashboardid": "2", "pages": [ { "dashboard_pageid": 1, "name": 'Renamed Page' }, { "dashboard_pageid": 2, "widgets": [ { "type": "clock", "x": 0, "y": 0, "width": 4, "height": 3 } ] }, { "display_period": 60 } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "2" ] }, "id": 2 } ``` #### به روز رسانی صفحات داشبورد Rename the first dashboard page, replace widgets on the second dashboard page and add a new page as the third one. Delete all other dashboard pages. Request: ```json { "jsonrpc": "2.0", "method": "dashboard.update", "params": { "dashboardid": "2", "pages": [ { "dashboard_pageid": 1, "name": 'Renamed Page' }, { "dashboard_pageid": 2, "widgets": [ { "type": "clock", "x": 0, "y": 0, "width": 4, "height": 3 } ] }, { "display_period": 60 } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "2" ] }, "id": 2 } ``` #### Updating global regular expression for file systems discovery. Request: ```json { "jsonrpc": "2.0", "method": "regexp.update", "params": { "regexpid": "1", "name": "File systems for discovery", "test_string": "", "expressions": [ { "expression": "^(btrfs|ext2|ext3|ext4|reiser|xfs|ffs|ufs|jfs|jfs2|vxfs|hfs|apfs|refs|zfs)$", "expression_type": "3", "exp_delimiter": ",", "case_sensitive": "0" }, { "expression": "^(ntfs|fat32|fat16)$", "expression_type": "3", "exp_delimiter": ",", "case_sensitive": "0" } ] }, "auth": "700ca65537074ec963db7efabda78259", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "regexpids": [ "1" ] }, "id": 1 } ``` #### ساخت گراف Create a graph with two items. Request: ```json { "jsonrpc": "2.0", "method": "graph.create", "params": { "name": "MySQL bandwidth", "width": 900, "height": 200, "gitems": [ { "itemid": "22828", "color": "00AA00" }, { "itemid": "22829", "color": "3333FF" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "graphids": [ "652" ] }, "id": 1 } ``` #### Updating host inventory Change inventory mode and add location Request: ```json { "jsonrpc": "2.0", "method": "host.update", "params": { "hostid": "10387", "inventory_mode": 0, "inventory": { "location": "Latvia, Riga" } }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "hostids": [ "10387" ] }, "id": 1 } ``` #### به روز رسانی جست و جوی هاست Change inventory mode and add location Request: ```json { "jsonrpc": "2.0", "method": "host.update", "params": { "hostid": "10387", "inventory_mode": 0, "inventory": { "location": "Latvia, Riga" } }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "hostids": [ "10387" ] }, "id": 1 } ``` #### Updating host macros Replace all host macros with two new ones. Request: ```json { "jsonrpc": "2.0", "method": "host.update", "params": { "hostid": "10126", "macros": [ { "macro": "{$PASS}", "value": "password" }, { "macro": "{$DISC}", "value": "sda", "description": "Updated description" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "hostids": [ "10126" ] }, "id": 1 } ``` #### به روز رسانی ماکروهای هاست Replace all host macros with two new ones. Request: ```json { "jsonrpc": "2.0", "method": "host.update", "params": { "hostid": "10126", "macros": [ { "macro": "{$PASS}", "value": "password" }, { "macro": "{$DISC}", "value": "sda", "description": "Updated description" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "hostids": [ "10126" ] }, "id": 1 } ``` #### Updating host prototype custom interfaces Replace inherited interfaces with host prototype custom interfaces. Request: ```json { "jsonrpc": "2.0", "method": "hostprototype.update", "params": { "hostid": "10092", "custom_interfaces": "1", "interfaces": [ { "main": "1", "type": "2", "useip": "1", "ip": "127.0.0.1", "dns": "", "port": "161", "details": { "version": "2", "bulk": "1", "community": "{$SNMP_COMMUNITY}" } } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "hostids": [ "10092" ] }, "id": 1 } ``` ####به روز رسانی اینترفیس خاص هاست اولیه Replace inherited interfaces with host prototype custom interfaces. Request: ```json { "jsonrpc": "2.0", "method": "hostprototype.update", "params": { "hostid": "10092", "custom_interfaces": "1", "interfaces": [ { "main": "1", "type": "2", "useip": "1", "ip": "127.0.0.1", "dns": "", "port": "161", "details": { "version": "2", "bulk": "1", "community": "{$SNMP_COMMUNITY}" } } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "hostids": [ "10092" ] }, "id": 1 } ``` #### Updating host prototype tags Replace host prototype tags with new ones. Request: ```json { "jsonrpc": "2.0", "method": "hostprototype.update", "params": { "hostid": "10092", "tags": [ { "tag": "Datacenter", "value": "{#DATACENTER.NAME}" }, { "tag": "Instance type", "value": "{#INSTANCE_TYPE}" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "hostids": [ "10092" ] }, "id": 1 } ``` #### به روز رسانی تگ نمونه اولیه هاست Replace host prototype tags with new ones. Request: ```json { "jsonrpc": "2.0", "method": "hostprototype.update", "params": { "hostid": "10092", "tags": [ { "tag": "Datacenter", "value": "{#DATACENTER.NAME}" }, { "tag": "Instance type", "value": "{#INSTANCE_TYPE}" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "hostids": [ "10092" ] }, "id": 1 } ``` #### Updating host tags Replace all host tags with a new one. Request: ```json { "jsonrpc": "2.0", "method": "host.update", "params": { "hostid": "10387", "tags": { "tag": "OS", "value": "RHEL 7" } }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "hostids": [ "10387" ] }, "id": 1 } ``` #### به روز رسانی تگ های هاست Replace all host tags with a new one. Request: ```json { "jsonrpc": "2.0", "method": "host.update", "params": { "hostid": "10387", "tags": { "tag": "OS", "value": "RHEL 7" } }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "hostids": [ "10387" ] }, "id": 1 } ``` #### Updating item preprocessing options Update an item prototype with item preprocessing rule “Custom multiplier”. Request: ```json { "jsonrpc": "2.0", "method": "itemprototype.update", "params": { "itemid": "44211", "preprocessing": [ { "type": 1, "params": "4", "error_handler": 2, "error_handler_params": "5" } ] }, "auth": "700ca65537074ec963db7efabda78259", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "44211" ] }, "id": 1 } ``` #### به روز رسانی آپشن های پیش پردازش قانون LLD Update an LLD rule with preprocessing rule “JSONPath”. Request: ```json { "jsonrpc": "2.0", "method": "discoveryrule.update", "params": { "itemid": "44211", "preprocessing": [ { "type": 12, "params": "$.path.to.json", "error_handler": 2, "error_handler_params": "5" } ] }, "auth": "700ca65537074ec963db7efabda78259", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "44211" ] }, "id": 1 } ``` #### Updating LLD rule preprocessing options Update an LLD rule with preprocessing rule “JSONPath”. Request: ```json { "jsonrpc": "2.0", "method": "discoveryrule.update", "params": { "itemid": "44211", "preprocessing": [ { "type": 12, "params": "$.path.to.json", "error_handler": 2, "error_handler_params": "5" } ] }, "auth": "700ca65537074ec963db7efabda78259", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "44211" ] }, "id": 1 } ``` #### به روز رسانی آپشن های پیش پردازش قانون LLD Update an LLD rule with preprocessing rule “JSONPath”. Request: ```json { "jsonrpc": "2.0", "method": "discoveryrule.update", "params": { "itemid": "44211", "preprocessing": [ { "type": 12, "params": "$.path.to.json", "error_handler": 2, "error_handler_params": "5" } ] }, "auth": "700ca65537074ec963db7efabda78259", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "44211" ] }, "id": 1 } ``` #### Updating LLD rule script Update an LLD rule script with a different script and remove unnecessary parameters that were used by previous script. Request: ```json { "jsonrpc": "2.0", "method": "discoveryrule.update", "params": { "itemid": "23865", "parameters": [], "script": "Zabbix.Log(3, 'Log test');\nreturn 1;" }, "auth": "700ca65537074ec963db7efabda78259", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "23865" ] }, "id": 1 } ``` #### به روز رسانی اسکریپت قانون LLD Update an LLD rule script with a different script and remove unnecessary parameters that were used by previous script. Request: ```json { "jsonrpc": "2.0", "method": "discoveryrule.update", "params": { "itemid": "23865", "parameters": [], "script": "Zabbix.Log(3, 'Log test');\nreturn 1;" }, "auth": "700ca65537074ec963db7efabda78259", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "23865" ] }, "id": 1 } ``` #### Updating problems The problem update popup allows to: - comment on the problem - view comments and actions so far - change problem severity - acknowledge/unacknowledge problem - manually close problem ![](../../assets/en/manual/acknowledges/update_problem.png){width="600"} All mandatory input fields are marked with a red asterisk. |Parameter|Description| |--|--------| |*Problem*|If only one problem is selected, the problem name is displayed.<br>If several problems are selected, *N problems selected* is displayed.| |*Message*|Enter text to comment on the problem (maximum 2048 characters).| |*History*|Previous activities and comments on the problem are listed, along with the time and user details.<br>For the meaning of icons used to denote user actions see the [event detail](/manual/web_interface/frontend_sections/monitoring/problems#viewing_details) page.<br>Note that history is displayed if only one problem is selected for the update.| |*Scope*|Define the scope of such actions as changing severity, acknowledging or manually closing problems:<br>**Only selected problem** - will affect this event only<br>**Selected and all other problems of related triggers** - in case of acknowledgment/closing problem, will affect this event and all other problems that are not acknowledged/closed so far. If the scope contains problems already acknowledged or closed, these problems will not be acknowledged/closed repeatedly. On the other hand, the number of message and severity change operations are not limited.| |*Change severity*|Mark the checkbox and click on the severity button to update problem severity.<br>The checkbox for changing severity is available if read-write permissions exist for at least one of the selected problems. Only those problems that are read-writable will be updated when clicking on *Update*.<br>If read-write permissions exist for none of the selected triggers, the checkbox is disabled.| |*Acknowledge*|Mark the checkbox to acknowledge the problem.<br>This checkbox is available if there is at least one unacknowledged problem among the selected.<br>It is not possible to add another acknowledgment for an already acknowledged problem (it is possible to add another comment though).| |*Unacknowledge*|Mark the checkbox to unacknowledge the problem.<br>This checkbox is available if there is at least one acknowledged problem among the selected.| |*Close problem*|Mark the checkbox to manually close the selected problem(s).<br>The checkbox for closing a problem is available if the *Allow manual close* option is checked in [trigger configuration](/manual/config/triggers/trigger) for at least one of the selected problems. Only those problems will be closed that are allowed to be closed when clicking on *Update*.<br>If no problem is manually closeable, the checkbox is disabled.<br>Already closed problems will not be closed repeatedly.| #### مشکلات به روز رسانی پنجره به روز رسانی مشکل اجازه می دهد تا: - نظر در مورد مشکل - مشاهده نظرات و اقدامات تا کنون - تغییر شدت مشکل - تصدیق/عدم تصدیق مشکل - مشکل را به صورت دستی ببندید ![](../../assets/en/manual/acknowledges/update_problem.png){width="600"} تمام فیلدهای ورودی اجباری با یک ستاره قرمز مشخص شده اند. |پارامتر|توضیحات| |--|--------| |*مشکل*|اگر فقط یک مشکل انتخاب شده باشد، نام مشکل نمایش داده می شود.<br>اگر چندین مشکل انتخاب شده باشد، *N مشکل انتخاب شده* نمایش داده می شود.| |*پیام*|متن را برای نظر دادن در مورد مشکل وارد کنید (حداکثر 2048 کاراکتر).| |*سابقه*|فعالیت ها و نظرات قبلی در مورد مشکل همراه با زمان و جزئیات کاربر فهرست شده است.<br>برای اطلاع از معنی نمادهای مورد استفاده برای نشان دادن اقدامات کاربر به [جزئیات رویداد](/manual/web_interface/frontend_sections/ مراجعه کنید. صفحه monitoring/problems#viewing_details).<br>توجه داشته باشید که اگر فقط یک مشکل برای به‌روزرسانی انتخاب شود، تاریخچه نمایش داده می‌شود.| |*حوزه*|حوزه اقداماتی مانند تغییر شدت، تأیید یا بستن دستی مشکلات را تعریف کنید:<br>**فقط مشکل انتخاب شده** - فقط بر این رویداد تأثیر می گذارد<br>**انتخاب شده و همه مشکلات دیگر محرک های مرتبط ** - در صورت بروز مشکل تصدیق/بستن، بر این رویداد و سایر مشکلاتی که تا کنون اعتراف/تعطیل نشده اند تأثیر خواهد گذاشت. اگر محدوده شامل مشکلاتی باشد که قبلاً تأیید یا بسته شده اند، این مشکلات به طور مکرر تأیید / بسته نمی شوند. از طرفی تعداد عملیات تغییر پیام و شدت محدود نیست.| |*تغییر شدت*|چک باکس را علامت بزنید و روی دکمه شدت کلیک کنید تا شدت مشکل به‌روزرسانی شود.<br>در صورتی که مجوز خواندن و نوشتن برای حداقل یکی از مشکلات انتخاب شده وجود داشته باشد، کادر تأیید تغییر شدت در دسترس است. تنها مشکلاتی که قابل خواندن و نوشتن هستند با کلیک بر روی *به روز رسانی* به روز می شوند.<br>اگر مجوزهای خواندن-نوشتن برای هیچ یک از محرک های انتخاب شده وجود نداشته باشد، کادر انتخاب غیرفعال می شود.| |*Acknowledge*|برای تصدیق مشکل، کادر را علامت بزنید.<br>اگر حداقل یک مشکل تأیید نشده در میان انتخاب شده وجود داشته باشد، این کادر تأیید در دسترس است.<br>افزودن تأیید دیگری برای مشکلی که قبلاً تأیید شده است، امکان پذیر نیست ( هر چند امکان اضافه کردن نظر دیگری وجود دارد).| |*Unacknowledge*|برای عدم تأیید مشکل، کادر را علامت بزنید.<br>اگر حداقل یک مشکل تأیید شده در میان انتخاب شده وجود داشته باشد، این کادر تأیید در دسترس است.| |*بستن مشکل*|برای بستن دستی مشکل(های) انتخاب شده، کادر را علامت بزنید.<br>در صورتی که گزینه *اجازه بستن دستی* در [پیکربندی راه اندازی](/manual/config) علامت زده شود، کادر انتخاب برای بستن یک مشکل در دسترس است. /triggers/trigger) برای حداقل یکی از مشکلات انتخاب شده. فقط مشکلاتی بسته می‌شوند که با کلیک بر روی *به‌روزرسانی* بسته می‌شوند.<br>اگر مشکلی به‌صورت دستی قابل بسته نباشد، چک باکس غیرفعال می‌شود.<br>مشکلات از قبل بسته‌شده به‌طور مکرر بسته نمی‌شوند.| #### Updating service tags Make SLA with ID "5" to be calculated at monthly intervals for NoSQL related services, without changing its schedule or excluded downtimes; set SLO to 95%. Request: ```json { "jsonrpc": "2.0", "method": "sla.update", "params": [ { "slaid": "5", "name": "NoSQL Database engines", "slo": "95", "period": 2, "service_tags": [ { "tag": "Database", "operator": "0", "value": "Redis" }, { "tag": "Database", "operator": "0", "value": "MongoDB" } ] } ], "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "slaids": [ "5" ] }, "id": 1 } ``` ####به روز رسانی اینترفیس خاص هاست اولیه Replace inherited interfaces with host prototype custom interfaces. Request: ```json { "jsonrpc": "2.0", "method": "hostprototype.update", "params": { "hostid": "10092", "custom_interfaces": "1", "interfaces": [ { "main": "1", "type": "2", "useip": "1", "ip": "127.0.0.1", "dns": "", "port": "161", "details": { "version": "2", "bulk": "1", "community": "{$SNMP_COMMUNITY}" } } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "hostids": [ "10092" ] }, "id": 1 } ``` #### Updating template dashboard pages Rename the first dashboard page, replace widgets on the second dashboard page and add a new page as the third one. Delete all other dashboard pages. Request: ```json { "jsonrpc": "2.0", "method": "templatedashboard.update", "params": { "dashboardid": "2", "pages": [ { "dashboard_pageid": 1, "name": 'Renamed Page' }, { "dashboard_pageid": 2, "widgets": [ { "type": "clock", "x": 0, "y": 0, "width": 4, "height": 3 } ] }, { "display_period": 60 } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "2" ] }, "id": 2 } ``` ####به روز رسانی اینترفیس خاص هاست اولیه Replace inherited interfaces with host prototype custom interfaces. Request: ```json { "jsonrpc": "2.0", "method": "hostprototype.update", "params": { "hostid": "10092", "custom_interfaces": "1", "interfaces": [ { "main": "1", "type": "2", "useip": "1", "ip": "127.0.0.1", "dns": "", "port": "161", "details": { "version": "2", "bulk": "1", "community": "{$SNMP_COMMUNITY}" } } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "hostids": [ "10092" ] }, "id": 1 } ``` #### Usage examples Examples of keys for aggregate calculations. #### مثال های استفاده نمونه هایی از کلیدها برای محاسبات کل. # usergroup.get # دریافت گروه هاستی # usergroup.update # به روز رسانی گروه هاستی # usermacro.get # usermacro.get # usermacro.updateglobal # usermacro.updateglobal #### User permission check Does the user have permission to write to hosts whose names begin with "MySQL" or "Linux" ? Request: ```json { "jsonrpc": "2.0", "method": "host.get", "params": { "countOutput": true, "search": { "host": ["MySQL", "Linux"] }, "editable": true, "startSearch": true, "searchByAny": true }, "auth": "766b71ee543230a1182ca5c44d353e36", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": "0", "id": 1 } ``` ::: noteclassic Zero result means no hosts with read/write permissions. ::: #### بررسی مجوز کاربر آیا کاربر اجازه دارد به هاست هایی که نامشان با MySQL" یا "Linux"؟ شروع می شود بنویسد ؟ " Request: ```json { "jsonrpc": "2.0", "method": "host.get", "params": { "countOutput": true, "search": { "host": ["MySQL", "Linux"] }, "editable": true, "startSearch": true, "searchByAny": true }, "auth": "766b71ee543230a1182ca5c44d353e36", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": "0", "id": 1 } ``` ::: noteclassic Zero result means no hosts with read/write permissions. ::: #### Using a custom expression filter Create a correlation that will use a custom filter condition. The formula IDs "A" or "B" have been chosen arbitrarily. Condition type will be "Host group" with operator "<>". Request: ```json { "jsonrpc": "2.0", "method": "correlation.create", "params": { "name": "new host group correlation", "description": "a custom description", "status": 0, "filter": { "evaltype": 3, "formula": "A or B", "conditions": [ { "type": 2, "operator": 1, "formulaid": "A" }, { "type": 2, "operator": 1, "formulaid": "B" } ] }, "operations": [ { "type": 1 } ] }, "auth": "343baad4f88b4106b9b5961e77437688", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "correlationids": [ "2" ] }, "id": 1 } ``` #### استفاده از یک فیلتر عبارت سفارشی یک همبستگی ایجاد کنید که از یک شرط فیلتر سفارشی استفاده کند. این شناسه فرمول "A" یا "B" خودسرانه انتخاب شده است. نوع شرط خواهد بود "گروه میزبان" با عملگر "<>" باشد. درخواست: ``json { "jsonrpc": "2.0"، "روش": "همبستگی.ایجاد"، "params": { "نام": "همبستگی گروه میزبان جدید"، "description": "یک توصیف سفارشی"، "وضعیت": 0، "فیلتر": { "evaltype": 3، "فرمول": "الف یا ب"، "شرایط": [ { "نوع": 2، "اپراتور": 1، "formulaid": "A" }، { "نوع": 2، "اپراتور": 1، "formulaid": "B" } ] }، "عملیات": [ { "نوع": 1 } ] }، "auth": "343baad4f88b4106b9b5961e77437688"، "id": 1 } ``` واکنش: ``json { "jsonrpc": "2.0"، "نتیجه": { "همبستگی ها": [ "2" ] }، "id": 1 } ``` #### Using a custom expression filter Create an LLD rule with a filter that will use a custom expression to evaluate the conditions. The LLD rule must only discover objects the "{\#MACRO1}" macro value of which matches both regular expression "regex1" and "regex2", and the value of "{\#MACRO2}" matches either "regex3" or "regex4". The formula IDs "A", "B", "C" and "D" have been chosen arbitrarily. Request: ```json { "jsonrpc": "2.0", "method": "discoveryrule.create", "params": { "name": "Filtered LLD rule", "key_": "lld", "hostid": "10116", "type": 0, "interfaceid": "13", "delay": "30s", "filter": { "evaltype": 3, "formula": "(A and B) and (C or D)", "conditions": [ { "macro": "{#MACRO1}", "value": "@regex1", "formulaid": "A" }, { "macro": "{#MACRO1}", "value": "@regex2", "formulaid": "B" }, { "macro": "{#MACRO2}", "value": "@regex3", "formulaid": "C" }, { "macro": "{#MACRO2}", "value": "@regex4", "formulaid": "D" } ] } }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "27665" ] }, "id": 1 } ``` #### Using a custom expression filter یک قانون LLD با فیلتری ایجاد کنید که از یک عبارت سفارشی برای استفاده کند شرایط را ارزیابی کنید قانون LLD فقط باید اشیاء را کشف کند مقدار کلان «{\#MACRO1}» که با هر دو عبارت معمولی مطابقت دارد "regex1" و "regex2"، و مقدار "{\#MACRO2}" با هر یک مطابقت دارد "regex3" یا "regex4". شناسه فرمول "A"، "B"، "C" و "D" بوده است خودسرانه انتخاب شده است. Request: ```json { "jsonrpc": "2.0", "method": "discoveryrule.create", "params": { "name": "Filtered LLD rule", "key_": "lld", "hostid": "10116", "type": 0, "interfaceid": "13", "delay": "30s", "filter": { "evaltype": 3, "formula": "(A and B) and (C or D)", "conditions": [ { "macro": "{#MACRO1}", "value": "@regex1", "formulaid": "A" }, { "macro": "{#MACRO1}", "value": "@regex2", "formulaid": "B" }, { "macro": "{#MACRO2}", "value": "@regex3", "formulaid": "C" }, { "macro": "{#MACRO2}", "value": "@regex4", "formulaid": "D" } ] } }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "27665" ] }, "id": 1 } ``` #### Using a custom expression filter Create a trigger action that will use a custom filter condition. The action must send a message for each trigger with severity higher or equal to "Warning" for hosts "10084" and "10106". The formula IDs "A", "B" and "C" have been chosen arbitrarily. Request: ```json { "jsonrpc": "2.0", "method": "action.create", "params": { "name": "Trigger action", "eventsource": 0, "status": 0, "esc_period": "2m", "filter": { "evaltype": 3, "formula": "A and (B or C)", "conditions": [ { "conditiontype": 4, "operator": 5, "value": "2", "formulaid": "A" }, { "conditiontype": 1, "operator": 0, "value": "10084", "formulaid": "B" }, { "conditiontype": 1, "operator": 0, "value": "10106", "formulaid": "C" } ] }, "operations": [ { "operationtype": 0, "esc_period": "0s", "esc_step_from": 1, "esc_step_to": 2, "evaltype": 0, "opmessage_grp": [ { "usrgrpid": "7" } ], "opmessage": { "default_msg": 1, "mediatypeid": "1" } } ], "pause_suppressed": "0", "notify_if_canceled": "0" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "actionids": [ "18" ] }, "id": 1 } ``` #### با استفاده از یک فیلتر عبارت سفارشی یک اقدام ماشه ای ایجاد کنید که از یک شرط فیلتر سفارشی استفاده کند. این اقدام باید برای هر محرک با شدت بالاتر یا پیامی ارسال کند برابر با "هشدار" برای میزبان "10084" و "10106". شناسه فرمول "A"، «ب» و «ج» خودسرانه انتخاب شده اند. درخواست: ``json { "jsonrpc": "2.0"، "روش": "اقدام. ایجاد"، "params": { "name": "عمل ماشه"، "منبع رویداد": 0، "وضعیت": 0، "esc_period": "2m"، "فیلتر": { "evaltype": 3، "فرمول": "A و (B یا C)"، "شرایط": [ { "شرایط نوع": 4، "اپراتور": 5، "ارزش": "2"، "formulaid": "A" }، { "شرایط نوع": 1، "اپراتور": 0، "value": "10084"، "formulaid": "B" }، { "شرایط نوع": 1، "اپراتور": 0، "value": "10106"، "formulaid": "C" } ] }، "عملیات": [ { "نوع عملیات": 0، "esc_period": "0s"، "esc_step_from": 1، "esc_step_to": 2، "evaltype": 0، "opmessage_grp": [ { "usrgrpid": "7" } ]، "opmessage": { "default_msg": 1، "mediatypeid": "1" } } ]، "pause_suppressed": "0"، "notify_if_cancelled": "0" }، "auth": "038e1d7b1735c6a5436ee9eae095879e"، "id": 1 } ``` واکنش: ``json { "jsonrpc": "2.0"، "نتیجه": { "actionids": [ "18" ] }، "id": 1 } ``` #### Using a filter Create an LLD rule with a set of conditions to filter the results by. The conditions will be grouped together using the logical "and" operator. Request: ```json { "jsonrpc": "2.0", "method": "discoveryrule.create", "params": { "name": "Filtered LLD rule", "key_": "lld", "hostid": "10116", "type": 0, "interfaceid": "13", "delay": "30s", "filter": { "evaltype": 1, "conditions": [ { "macro": "{#MACRO1}", "value": "@regex1" }, { "macro": "{#MACRO2}", "value": "@regex2", "operator": "9" }, { "macro": "{#MACRO3}", "value": "", "operator": "12" }, { "macro": "{#MACRO4}", "value": "", "operator": "13" } ] } }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "27665" ] }, "id": 1 } ``` #### hsjthni hc ّهمفثق Create an LLD rule with a set of conditions to filter the results by. The conditions will be grouped together using the logical "and" operator. Request: ```json { "jsonrpc": "2.0", "method": "discoveryrule.create", "params": { "name": "Filtered LLD rule", "key_": "lld", "hostid": "10116", "type": 0, "interfaceid": "13", "delay": "30s", "filter": { "evaltype": 1, "conditions": [ { "macro": "{#MACRO1}", "value": "@regex1" }, { "macro": "{#MACRO2}", "value": "@regex2", "operator": "9" }, { "macro": "{#MACRO3}", "value": "", "operator": "12" }, { "macro": "{#MACRO4}", "value": "", "operator": "13" } ] } }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "27665" ] }, "id": 1 } ``` ##### Using filter You can use the filter to display only the maps you are interested in. For better search performance, data is searched with macros unresolved. ##### استفاده از فیلتر شما می توانید از فیلتر برای نمایش تنها نقشه های مورد علاقه خود استفاده کنید. برای عملکرد بهتر جستجو، داده ها با ماکروهای حل نشده جستجو می شوند. #### Using filter You can use the filter to display only the problems you are interested in. For better search performance, data is searched with macros unresolved. The filter is located above the table. Favorite filter settings can be saved as tabs and then quickly accessed by clicking on the [tabs above the filter](/manual/web_interface/frontend_sections/monitoring/problems#tabs_for_favorite_filters). ![](../../../../../assets/en/manual/web_interface/frontend_sections/monitoring/problem_filter.png){width="600"} |Parameter|Description| |--|--------| |*Show*|Filter by problem status:<br>**Recent problems** - unresolved and recently resolved problems are displayed (default)<br>**Problems** - unresolved problems are displayed<br>**History** - history of all events is displayed| |*Host groups*|Filter by one or more host groups.<br>Specifying a parent host group implicitly selects all nested host groups.| |*Hosts*|Filter by one or more hosts.| |*Triggers*|Filter by one or more triggers.| |*Problem*|Filter by problem name.| |*Severity*|Filter by trigger (problem) severity.| |*Age less than*|Filter by how old the problem is.| |*Host inventory*|Filter by inventory type and value.| |*Tags*|Filter by [event tag](/manual/config/tagging) name and value. It is possible to include as well as exclude specific tags and tag values. Several conditions can be set. Tag name matching is always case-sensitive.<br>There are several operators available for each condition:<br>**Exists** - include the specified tag names<br>**Equals** - include the specified tag names and values (case-sensitive)<br>**Contains** - include the specified tag names where the tag values contain the entered string (substring match, case-insensitive)<br>**Does not exist** - exclude the specified tag names<br>**Does not equal** - exclude the specified tag names and values (case-sensitive)<br>**Does not contain** - exclude the specified tag names where the tag values contain the entered string (substring match, case-insensitive)<br>There are two calculation types for conditions:<br>**And/Or** - all conditions must be met, conditions having the same tag name will be grouped by the Or condition<br>**Or** - enough if one condition is met<br>When filtered, the tags specified here will be displayed first with the problem, unless overridden by the *Tag display priority* (see below) list.| |*Show tags*|Select the number of displayed tags:<br>**None** - no *Tags* column in *Monitoring → Problems*<br>**1** - *Tags* column contains one tag<br>**2** - *Tags* column contains two tags<br>**3** - *Tags* column contains three tags<br>To see all tags for the problem roll your mouse over the three dots icon.| |*Tag name*|Select tag name display mode:<br>**Full** - tag names and values are displayed in full<br>**Shortened** - tag names are shortened to 3 symbols; tag values are displayed in full<br>**None** - only tag values are displayed; no names| |*Tag display priority*|Enter tag display priority for a problem, as a comma-separated list of tags (for example: `Services,Applications,Application`). Tag names only should be used, no values. The tags of this list will always be displayed first, overriding the natural ordering by alphabet.| |*Show operational data*|Select the mode for displaying [operational data](#operational_data_of_problems):<br>**None** - no operational data is displayed<br>**Separately** - operational data is displayed in a separate column<br>**With problem name** - append operational data to the problem name, using parentheses for the operational data| |*Show suppressed problems*|Mark the checkbox to display problems that would otherwise be suppressed (not shown) because of host maintenance.| |*Compact view*|Mark the checkbox to enable compact view.| |*Show details*|Mark the checkbox to display underlying trigger expressions of the problems. Disabled if *Compact view* checkbox is marked.| |*Show unacknowledged only*|Mark the checkbox to display unacknowledged problems only.| |*Show timeline*|Mark the checkbox to display the visual timeline and grouping. Disabled if *Compact view* checkbox is marked.| |*Highlight whole row*|Mark the checkbox to highlight the full line for unresolved problems. The problem severity color is used for highlighting.<br>Enabled only if the *Compact view* checkbox is marked in the standard blue and dark themes. *Highlight whole row* is not available in the high-contrast themes.| #### استفاده از فیلتر شما می توانید از فیلتر برای نمایش تنها مشکلات مورد نظر خود استفاده کنید برای عملکرد بهتر جستجو، داده ها با ماکروها جستجو می شوند حل نشده فیلتر بالای جدول قرار دارد. تنظیمات فیلتر مورد علاقه می تواند باشد به‌عنوان برگه‌ها ذخیره می‌شود و سپس با کلیک بر روی [برگه‌های بالا، به سرعت به آن دسترسی پیدا می‌کنید را filter](/manual/web_interface/frontend_sections/monitoring/problems#tabs_for_favorite_filters). ![](../../../../../assets/en/manual/web_interface/frontend_sections/monitoring/problem_filter.png){width="600"} |پارامتر|توضیحات| |--|--------| |*نمایش*|فیلتر بر اساس وضعیت مشکل:<br>**مشکلات اخیر** - مشکلات حل نشده و اخیراً حل نشده نمایش داده می شوند (پیش فرض)<br>**مشکلات** - مشکلات حل نشده نمایش داده می شوند<br>**تاریخچه* * - تاریخچه همه رویدادها نمایش داده می شود| |*گروه های میزبان*|فیلتر بر اساس یک یا چند گروه میزبان.<br>مشخص کردن یک گروه میزبان والد به طور ضمنی همه گروه های میزبان تودرتو را انتخاب می کند.| |*میزبان*|فیلتر بر اساس یک یا چند میزبان.| |*محرک*|بر اساس یک یا چند محرک فیلتر کنید.| |*مشکل*|فیلتر بر اساس نام مشکل.| |*شدت*|فیلتر بر اساس شدت ماشه (مشکل).| |*سن کمتر از*|بر اساس سن مشکل فیلتر کنید.| |*موجودی میزبان*|فیلتر بر اساس نوع و مقدار موجودی.| |*برچسب*|بر اساس نام و مقدار [برچسب رویداد](/manual/config/tagging) فیلتر کنید. امکان گنجاندن و همچنین حذف تگ ها و مقادیر تگ خاص وجود دارد. چند شرط را می توان تنظیم کرد. تطبیق نام برچسب همیشه به حروف کوچک و بزرگ حساس است.<br>برای هر شرط چندین عملگر موجود است:<br>**Exists** - شامل نام تگ های مشخص شده<br>**برابر** - شامل نام تگ های مشخص شده و مقادیر (حساس به حروف کوچک و بزرگ)<br>**حاوی** - شامل نام تگ های مشخص شده است که در آن مقادیر برچسب حاوی رشته وارد شده است (تطابق رشته های فرعی، حساس به حروف کوچک و بزرگ)<br>**وجود ندارد** - موارد مشخص شده را حذف می کند نام‌های برچسب<br>**برابر نیست** - نام‌ها و مقادیر تگ‌های مشخص شده را حذف می‌کند (حساس به حروف کوچک و بزرگ)<br>**حاوی نمی‌شود** - نام‌های برچسب مشخص‌شده را که در آن مقادیر برچسب حاوی رشته وارد شده هستند، حذف می‌کند ( مطابقت زیر رشته، حساس به حروف کوچک و بزرگ)<br>دو نوع محاسبه برای شرایط وجود دارد:<br>**And/Or** - همه شرایط باید برآورده شوند، شرایطی که نام برچسب یکسانی دارند با شرط Or گروه بندی می شوند<br >**یا** - اگر یک شرط برآورده شود کافی است<br>وقتی فیلتر شد، برچسب های مشخص شده در اینجا ابتدا با مشکل نمایش داده می شوند، مگر اینکه توسط لیست *اولویت نمایش برچسب* (به زیر مراجعه کنید) لغو شود.| |*نمایش برچسب*|تعداد برچسب های نمایش داده شده را انتخاب کنید:<br>**هیچ** - بدون ستون *برچسب*ها در *نظارت → مشکلات*<br>**1** - ستون *برچسب*ها دارای یک تگ است< br>**2** - ستون *برچسب*ها شامل دو تگ است<br>**3** - ستون *برچسب*ها شامل سه تگ است<br>برای دیدن همه تگهای مشکل، ماوس خود را روی نماد سه نقطه قرار دهید. | |*نام برچسب*|حالت نمایش نام تگ را انتخاب کنید:<br>**کامل** - نام تگ ها و مقادیر به صورت کامل نمایش داده می شوند<br>**کوتاه شده** - نام برچسب ها به 3 علامت کوتاه می شوند. مقادیر تگ به صورت کامل نمایش داده می شوند<br>**هیچ** - فقط مقادیر برچسب نمایش داده می شوند. بدون نام| |*اولویت نمایش برچسب*|اولویت نمایش برچسب را برای یک مشکل، به عنوان لیستی از برچسب ها که با کاما جدا شده اند وارد کنید (به عنوان مثال: "سرویس ها، برنامه ها، برنامه"). فقط باید از نام تگ استفاده شود، بدون مقدار. برچسب‌های این لیست همیشه اول نمایش داده می‌شوند و ترتیب طبیعی بر اساس حروف الفبا را لغو می‌کنند.| |*نمایش داده های عملیاتی*|حالت نمایش [داده های عملیاتی](#عملیات_داده_مشکلات):<br>**هیچ** - هیچ داده عملیاتی نمایش داده نمی شود<br>**به طور جداگانه** - داده های عملیاتی در یک نمایش داده می شود ستون جداگانه<br>**با نام مشکل** - اضافه کردن داده های عملیاتی به نام مشکل، با استفاده از پرانتز برای داده های عملیاتی| |*نمایش مشکلات سرکوب شده*|چک باکس را برای نمایش مشکلاتی که در غیر این صورت به دلیل نگهداری میزبان سرکوب می شوند (نمایش داده نمی شوند) علامت بزنید.| |*نمای فشرده*|برای فعال کردن نمای فشرده، کادر را علامت بزنید.| |*نمایش جزئیات*|برای نمایش عبارات محرک اصلی مشکلات، کادر را علامت بزنید. اگر کادر چک *نمای فشرده* علامت گذاری شده باشد غیرفعال می شود.| |*فقط نمایش ناشناس*|چک باکس را علامت بزنید تا فقط مشکلات تأیید نشده نمایش داده شود.| |*نمایش جدول زمانی*|برای نمایش جدول زمانی بصری و گروه بندی، کادر را علامت بزنید. اگر کادر چک *نمای فشرده* علامت گذاری شده باشد غیرفعال می شود.| |*کل ردیف را برجسته کنید*|باکس را علامت بزنید تا خط کامل برای مشکلات حل نشده برجسته شود. رنگ شدت مشکل برای برجسته کردن استفاده می‌شود.<br>فقط در صورتی فعال می‌شود که کادر چک *نمای فشرده* در طرح‌های زمینه آبی و تیره استاندارد علامت‌گذاری شده باشد. * برجسته کردن کل ردیف* در تم های با کنتراست بالا موجود نیست.| #### Using maxdelay parameter The 'maxdelay' parameter in log items allows ignoring some older lines from log files in order to get the most recent lines analyzed within the 'maxdelay' seconds. ::: notewarning Specifying 'maxdelay' > 0 may lead to **ignoring important log file records and missed alerts**. Use it carefully at your own risk only when necessary. ::: By default items for log monitoring follow all new lines appearing in the log files. However, there are applications which in some situations start writing an enormous number of messages in their log files. For example, if a database or a DNS server is unavailable, such applications flood log files with thousands of nearly identical error messages until normal operation is restored. By default, all those messages will be dutifully analyzed and matching lines sent to server as configured in `log` and `logrt` items. Built-in protection against overload consists of a configurable 'maxlines' parameter (protects server from too many incoming matching log lines) and a 10\*'maxlines' limit (protects host CPU and I/O from overloading by agent in one check). Still, there are 2 problems with the built-in protection. First, a large number of potentially not-so-informative messages are reported to server and consume space in the database. Second, due to the limited number of lines analyzed per second the agent may lag behind the newest log records for hours. Quite likely, you might prefer to be sooner informed about the current situation in the log files instead of crawling through old records for hours. The solution to both problems is using the 'maxdelay' parameter. If 'maxdelay' > 0 is specified, during each check the number of processed bytes, the number of remaining bytes and processing time is measured. From these numbers the agent calculates an estimated delay - how many seconds it would take to analyze all remaining records in a log file. If the delay does not exceed 'maxdelay' then the agent proceeds with analyzing the log file as usual. If the delay is greater than 'maxdelay' then the agent **ignores a chunk of a log file by "jumping" over it** to a new estimated position so that the remaining lines could be analyzed within 'maxdelay' seconds. Note that agent does not even read ignored lines into buffer, but calculates an approximate position to jump to in a file. The fact of skipping log file lines is logged in the agent log file like this: 14287:20160602:174344.206 item:"logrt["/home/zabbix32/test[0-9].log",ERROR,,1000,,,120.0]" logfile:"/home/zabbix32/test1.log" skipping 679858 bytes (from byte 75653115 to byte 76332973) to meet maxdelay The "to byte" number is approximate because after the "jump" the agent adjusts the position in the file to the beginning of a log line which may be further in the file or earlier. Depending on how the speed of growing compares with the speed of analyzing the log file you may see no "jumps", rare or often "jumps", large or small "jumps", or even a small "jump" in every check. Fluctuations in the system load and network latency also affect the calculation of delay and hence, "jumping" ahead to keep up with the "maxdelay" parameter. Setting 'maxdelay' < 'update interval' is not recommended (it may result in frequent small "jumps"). #### با استفاده از پارامتر maxdelay پارامتر "maxdelay" در آیتم های گزارش امکان نادیده گرفتن برخی از خطوط قدیمی تر را می دهد از فایل های ورود به سیستم به منظور به دست آوردن آخرین خطوط تجزیه و تحلیل در داخل "maxdelay" ثانیه. ::: هشدار تعیین "maxdelay" > 0 ممکن است منجر به **نادیده گرفتن شود سوابق مهم فایل لاگ و هشدارهای از دست رفته**. با دقت از آن استفاده کنید فقط در صورت لزوم خود را به خطر می اندازد. ::: به‌طور پیش‌فرض، موارد برای نظارت بر گزارش، تمام خطوط جدیدی را که در آن ظاهر می‌شوند، دنبال می‌کنند فایل های گزارش با این حال، برنامه هایی وجود دارد که در برخی شرایط شروع به نوشتن تعداد زیادی پیام در پرونده های گزارش خود کنید. برای به عنوان مثال، اگر یک پایگاه داده یا یک سرور DNS در دسترس نباشد، چنین برنامه هایی فایل های گزارش سیل با هزاران پیام خطای تقریباً یکسان تا عملکرد عادی بازیابی می شود. به طور پیش فرض، همه آن پیام ها خواهند بود به دقت تجزیه و تحلیل شده و خطوط مطابق با پیکربندی به سرور ارسال می شود موارد "log" و "logrt". حفاظت داخلی در برابر اضافه بار شامل یک قابل تنظیم است پارامتر 'maxlines' (سرور را از تطابق بیش از حد ورودی محافظت می کند خطوط log) و محدودیت 10\* 'maxlines' (از CPU میزبان و I/O محافظت می کند اضافه بار توسط نماینده در یک چک). با این حال، 2 مشکل در مورد وجود دارد حفاظت داخلی اول، تعداد زیادی از بالقوه پیام های نه چندان آموزنده به سرور گزارش می شوند و فضا را در آن مصرف می کنند پایگاه داده. دوم، به دلیل محدود بودن تعداد خطوط تحلیل شده در هر دوم ممکن است عامل ساعت ها از جدیدترین رکوردهای گزارش عقب بماند. کاملا احتمالاً، ممکن است ترجیح دهید زودتر از جریان فعلی مطلع شوید وضعیت در فایل های گزارش به جای خزیدن در پرونده های قدیمی برای ساعت ها. راه حل هر دو مشکل استفاده از پارامتر "maxdelay" است. اگر 'maxdelay' > 0 مشخص شده است، در طول هر بررسی تعداد بایت های پردازش شده، تعداد بایت های باقی مانده و زمان پردازش است اندازه گیری شده. از این اعداد، عامل تاخیر تخمینی را محاسبه می کند - چند ثانیه طول می کشد تا تمام رکوردهای باقی مانده در یک گزارش تجزیه و تحلیل شود فایل. اگر تأخیر از «maxdelay» تجاوز نکند، نماینده کار را ادامه می دهد تجزیه و تحلیل فایل log طبق معمول اگر تاخیر بیشتر از "maxdelay" باشد، عامل **یک تکه را نادیده می گیرد یک فایل log با "پرش" از روی آن** به یک موقعیت تخمینی جدید به طوری که خطوط باقیمانده را می توان در عرض "maxdelay" ثانیه تجزیه و تحلیل کرد. توجه داشته باشید که عامل حتی خطوط نادیده گرفته شده را در بافر نمی خواند، اما موقعیت تقریبی را برای پرش در یک فایل محاسبه می کند. واقعیت پرش از خطوط فایل لاگ مانند فایل لاگ عامل ثبت می شود این: 14287:20160602:174344.206 مورد:"logrt["/home/zabbix32/test[0-9].log",ERROR,,1000,,,,120.0]" logfile:"/home/zabbix32/test1.log" پرش از 679858 بایت (از بایت 75653115 تا بایت 76332973) برای دیدار با maxdelay عدد "به بایت" تقریبی است زیرا پس از "پرش" عامل است موقعیت را در فایل به ابتدای یک خط ورود تنظیم می کند که ممکن است بیشتر در فایل یا قبل از آن باشد. بسته به اینکه سرعت رشد چگونه با سرعت رشد مقایسه می شود در تجزیه و تحلیل فایل گزارش، ممکن است هیچ "پرش"، نادر یا اغلب "پرش" مشاهده نشود، "پرش" بزرگ یا کوچک، یا حتی یک "پرش" کوچک در هر چک. نوسانات بار سیستم و تأخیر شبکه نیز بر آن تأثیر می گذارد محاسبه تاخیر و از این رو، "پریدن" به جلو برای همگام شدن با پارامتر "maxdelay". تنظیم 'maxdelay' < 'update interval' توصیه نمی شود (ممکن است منجر به "پرش" های کوچک مکرر می شود). ### UTF-8 BOM in configuration import [Configuration import](/manual/xml_export_import#details-about-import) now supports files with a UTF-8 byte-order mark (BOM). ### UTF-8 BOM در وارد کردن پیکربندی [Iconfiguration import](/manual/xml_export_import#details-about-import) اکنون از فایل‌هایی با علامت ترتیب بایت UTF-8 (BOM) پشتیبانی می‌کند. ###### Validate request A request to execute *Validate* function of the *Configurator* interface. | | | |---|---| |direction|agent → plugin| |response|yes| Parameters specific to *Validate* requests: |Name|Type|Comments| |---------|--------|----------| |private_options|JSON object (optional)|JSON object containing private plugin configuration options, if provided.| *Example:* {"id":7,"type":9,"private_options":{...}} ###### پیکربندی درخواست درخواستی برای اجرای تابع *Configure* رابط *Configurator*. | | | |---|---| |جهت|عامل → افزونه| |پاسخ|عدم| پارامترهای خاص درخواست های *پیکربندی*: |نام|نوع|نظر| |---------|--------|----------| |global_options|شیء JSON|شیء JSON حاوی گزینه‌های پیکربندی عامل جهانی.| |private_options|شیء JSON (اختیاری)|شیء JSON حاوی گزینه‌های پیکربندی افزونه خصوصی، در صورت ارائه.| *مثال:* {"id":6,"type":8,"global_options":{...},"private_options":{...}} ###### Validate response Response from *Validate* function of *Configurator* interface. | | | |---|---| |direction|plugin → agent| |response|n/a| Parameters specific to *Validate* responses: |Name|Type|Comments| |---------|--------|----------| |error|string (optional)|An error message returned if the Validate function is not executed successfully. Absent if executed successfully.| *Example:* {"id":8,"type":10} or {"id":8,"type":10,"error":"error message"} ###### پاسخ صادرات پاسخ از تابع صادرات رابط صادرکننده. | | | |---|---| |جهت|پلاگین → عامل| |پاسخ|عدم| پارامترهای خاص برای پاسخ های صادراتی: |نام|نوع|نظر| |---------|--------|----------| | مقدار | رشته (اختیاری) | مقدار پاسخ از تابع Export. وجود ندارد، در صورت بازگشت خطا.| |error|string (اختیاری) |پیام خطا در صورتی که تابع Export با موفقیت اجرا نشده باشد. وجود ندارد، در صورت بازگشت مقدار.| *مثال ها:* {"id":5,"type":7,"value":"response"} یا {"id":5,"type":7,"error":"پیام خطا"} #### Value caching Values required for trigger evaluation are cached by Zabbix server. Because of this trigger evaluation causes a higher database load for some time after the server restarts. The value cache is not cleared when item history values are removed (either manually or by housekeeper), so the server will use the cached values until they are older than the time periods defined in trigger functions or server is restarted. #### ذخیره مقدار مقادیر مورد نیاز برای ارزیابی ماشه توسط سرور Zabbix ذخیره می شوند. به دلیل این ارزیابی ماشه باعث بارگذاری بیشتر پایگاه داده برای مدتی پس از راه اندازی مجدد سرور کش ارزش پاک نمی شود مقادیر تاریخچه آیتم ها حذف می شوند (به صورت دستی یا توسط خانه دار)، بنابراین سرور از مقادیر ذخیره شده استفاده می کند تا زمانی که آنها قدیمی تر از زمان باشند دوره های تعریف شده در توابع ماشه یا سرور راه اندازی مجدد می شود. # valuemap.create # ساخت آیکون مپ # valuemap.delete #دکمه آپدیت نقشه # valuemap.get #دکمه آپدیت نقشه # valuemap.update #دکمه آپدیت نقشه #### Verification It can be verified that a problem has been closed manually: - in event details, available through *Monitoring* → *Problems*; - by using the {EVENT.UPDATE.HISTORY} macro in notification messages that will provide this information. #### تایید می توان تأیید کرد که یک مشکل به صورت دستی بسته شده است: - در جزئیات رویداد، از طریق *مانیتورینگ* → *مشکلات* در دسترس است. - با استفاده از ماکرو {EVENT.UPDATE.HISTORY} در پیام‌های اعلان که این اطلاعات را ارائه خواهد کرد. ##### Verify agent parameters Make sure that in the [agent configuration file](/manual/appendix/config/zabbix_agentd): - 'Hostname' parameter matches the host name in the frontend - Servers in the 'ServerActive' parameter are specified for the processing of active checks ##### پارامترهای عامل را بررسی کنید مطمئن شوید که در پیکربندی [agent file](/manual/appendix/config/zabbix_agentd): - پارامتر "Hostname" با نام میزبان در قسمت جلو مطابقت دارد - سرورها در پارامتر "ServerActive" برای پردازش چک های فعال #### Viewing maps To view a map, click on its name in the list of all maps. ![](../../../../../assets/en/manual/web_interface/maps.png){width="600"} You can use the drop-down in the map title bar to select the lowest severity level of the problem triggers to display. The severity marked as *default* is the level set in the map configuration. If the map contains a sub-map, navigating to the sub-map will retain the higher-level map severity (except if it is *Not classified*, in this case, it will not be passed to the sub-map). #### مشاهده نقشه ها برای مشاهده نقشه، روی نام آن در لیست همه نقشه ها کلیک کنید. ![](../../../../../assets/en/manual/web_interface/maps.png){width="600"} می توانید از منوی کشویی در نوار عنوان نقشه برای انتخاب کمترین استفاده کنید سطح شدت مشکل باعث نمایش آن می شود. شدت مشخص شده است به عنوان *پیش فرض* سطح تنظیم شده در پیکربندی نقشه است. اگر نقشه حاوی یک نقشه فرعی است، با حرکت به نقشه فرعی، این نقشه را حفظ می کند شدت نقشه سطح بالاتر (به جز اگر *طبقه بندی نشده* باشد، در این مورد، به نقشه فرعی منتقل نمی شود). ##### Virtual memory data |Item key|<|<|<| |--|--|------|------| |Description|Return value|Parameters|Comments| |**vm.memory.size**\[<mode>\]|<|<|<| |Memory size in bytes or in percentage from total.|Integer - for bytes<br><br>Float - for percentage|**mode** - possible values:<br>*total* (default), *active*, *anon*, *buffers*, *cached*, *exec*, *file*, *free*, *inactive*, *pinned*, *shared*, *slab*, *wired*, *used*, *pused* (used, percentage), *available*, *pavailable* (available, percentage)<br>See also [platform-specific](/manual/appendix/items/supported_by_platform) support and [additional details](/manual/appendix/items/vm.memory.size_params) for this parameter.|This item accepts three categories of parameters:<br><br>1) *total* - total amount of memory;<br>2) platform-specific memory types: *active*, *anon*, *buffers*, *cached*, *exec*, *file*, *free*, *inactive*, *pinned*, *shared*, *slab*, *wired*;<br>3) user-level estimates on how much memory is used and available: *used*, *pused*, *available*, *pavailable*.| ##### داده های حافظه مجازی |کلید مورد|<|<|<| |--|--|------|------| |توضیحات|مقدار بازگشتی|پارامترها|نظرات| |**vm.memory.size**\[<mode>\]|<|<|<| |اندازه حافظه بر حسب بایت یا درصد از کل.|عدد صحیح - برای بایت<br><br>Float - برای درصد|**حالت** - مقادیر ممکن:<br>*total* (پیش‌فرض)، *فعال*، *anon*، *buffers*، *cached*، *exec*، *file*، *رایگان*، *غیرفعال*، *پین شده*، *اشتراک گذاشته شده*، *slab*، *wired*، *used*، *pused * (استفاده شده، درصد)، *موجود*، *موجود* (موجود، درصد)<br>همچنین به [پلتفرم خاص](/manual/appendix/items/supported_by_platform) و [جزئیات اضافی](/manual/appendix) مراجعه کنید /items/vm.memory.size_params) برای این پارامتر.|این مورد سه دسته پارامتر را می پذیرد:<br><br>1) *total* - مقدار کل حافظه؛<br>2) انواع حافظه مخصوص پلت فرم: *فعال*، *آنون*، *بافر*، *کش*شده*، *exec*، *فایل*، *رایگان*، *غیرفعال*، *پین*شده*، *اشتراک*گذاری*، *slab*، *سیمی*؛<br >3) برآوردهای سطح کاربر در مورد مقدار حافظه استفاده شده و موجود: *استفاده شده*، *پوسید*، *در دسترس*، *در دسترس*.| #### Web scenario In a [web scenario](/manual/web_monitoring) configuration, user macros can be used in the following fields: |Location|<|Multiple macros/mix with text^[1](supported_by_location_user#footnotes)^| |-|------------------------------|----------| |Name|<|yes| |Update interval|<|no| |Agent|<|yes| |HTTP proxy|<|yes| |Variables (values only)|<|yes| |Headers (names and values)|<|yes| |*Steps*|<|<| | |Name|yes| |^|URL^[3](supported_by_location_user#footnotes)^|yes| |^|Variables (values only)|yes| |^|Headers (names and values)|yes| |^|Timeout|no| |^|Required string|yes| |^|Required status codes|no| |*Authentication*|<|<| | |User|yes| |^|Password|yes| |^|SSL certificate|yes| |^|SSL key file|yes| |^|SSL key password|yes| |*Tags*^[2](supported_by_location_user#footnotes)^|<|<| | |Tag names|yes| |^|Tag values|yes| #### سناریوی وب در پیکربندی [سناریو وب](/manual/web_monitoring)، ماکروهای کاربر می تواند در زمینه های زیر استفاده شود: |موقعیت|<|چند ماکرو/میکس با متن^[1](پشتیبانی_شده توسط_location_user#footnotes)^| |-|-----------------------------|----------| |نام|<|بله| |فاصله به روز رسانی|<|نه| |نماینده|<|بله| |پراکسی HTTP|<|بله| |متغیرها (فقط مقادیر)|<|بله| |سرصفحه ها (نام ها و مقادیر)|<|بله| |*مراحل*|<|<| | |نام|بله| |^|URL^[3](supported_location_user#footnotes)^|بله| |^|متغیرها (فقط مقادیر)|بله| |^|سرصفحه ها (نام ها و مقادیر)|بله| |^|تایم پایان|نه| |^|رشته مورد نیاز|بله| |^|کدهای وضعیت مورد نیاز|خیر| |*احراز هویت*|<|<| | |کاربر|بله| |^|رمز عبور|بله| |^|گواهی SSL|بله| |^|فایل کلید SSL|بله| |^|رمز عبور کلید SSL|بله| |*برچسب ها*^[2](پشتیبانی_شده توسط_location_user#footnotes)^|<|<| | |اسامی برچسب|بله| |^|مقادیر برچسب|بله| ### Web scenario tag The web scenario tag object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**tag**<br>(required)|string|Web scenario tag name.| |value|string|Web scenario tag value.| ### تگ وب سناریو The web scenario tag object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**tag**<br>(required)|string|Web scenario tag name.| |value|string|Web scenario tag value.| ##### What can be exported/imported Objects that can be exported/imported are: - [host groups](/manual/xml_export_import/groups) (*through Zabbix API only*) - [templates](/manual/xml_export_import/templates) - [hosts](/manual/xml_export_import/hosts) - [network maps](/manual/xml_export_import/maps) - [media types](/manual/xml_export_import/media) - images ##### چه چیزی را می توان صادر/وارد کرد اشیایی که می توانند صادر یا وارد شوند عبارتند از: - [گروه‌های میزبان](/manual/xml_export_import/groups) (*از طریق Zabbix API فقط*) - [قالب‌ها](/دستی/xml_export_import/templates) - [hosts](/manual/xml_export_import/hosts) - [نقشه های شبکه](/manual/xml_export_import/maps) - [انواع رسانه] (/دستی/xml_export_import/media) - تصاویر #### Whitespace Whitespace (space, tab characters) can be freely used in bracket notation segments and expressions, for example, `$[ 'a' ][ 0 ][ ?( $.b == 'c' ) ][ : -1 ].first( )`. #### فضای سفید فضای خالی (فضا، کاراکترهای برگه) را می توان آزادانه در براکت استفاده کرد به عنوان مثال، بخش ها و عبارات نمادگذاری، `$[ 'a' ][ 0 ][ ?( $.b == 'c' ) ][ : -1 ].first( )». # Zabbix API changes in 6.0 # تغییرات Zabbix API در نسخه 6.0 #### Zabbix configuration #### پیکربندی Zabbix # Zabbix documentation 6.0 These pages contain official Zabbix documentation. Use the sidebar navigation to browse documentation pages. To be able to watch pages, log in with your [Zabbix forums](http://www.zabbix.com/forum/) username and password. # مستندات Zabbix 6.0 این صفحات حاوی اسناد رسمی Zabbix هستند. از پیمایش نوار کناری برای مرور صفحات اسناد استفاده کنید. برای اینکه بتوانید صفحات را تماشا کنید، با [Zabbix] خود وارد شوید forums](http://www.zabbix.com/forum/) نام کاربری و رمز عبور. # Zabbix manpages These are Zabbix manpages for Zabbix processes. # صفحات راهنمای زبیکس صفحات راهنمای جاری مربوط به فرایند های زبیکس می باشند. # Zabbix Manual Welcome to the user manual for Zabbix software. These pages are created to help users successfully manage their monitoring tasks with Zabbix, from the simple to the more complex ones. # دفترچه راهنمای Zabbix به راهنمای کاربر نرم افزار Zabbix خوش آمدید. این صفحات ایجاد شده اند تا به کاربران کمک کند وظایف مانیتورینگ خود را با Zabbix، از ساده تا پیچیده، با موفقیت مدیریت کنند. ##### Zabbix server and frontend Zabbix server configuration file draft with parameters to be updated: ### Option: HistoryStorageURL # History storage HTTP[S] URL. # # Mandatory: no # Default: # HistoryStorageURL= ### Option: HistoryStorageTypes # Comma separated list of value types to be sent to the history storage. # # Mandatory: no # Default: # HistoryStorageTypes=uint,dbl,str,log,text Example parameter values to fill the Zabbix server configuration file with: HistoryStorageURL=http://test.elasticsearch.lan:9200 HistoryStorageTypes=str,log,text This configuration forces Zabbix Server to store history values of numeric types in the corresponding database and textual history data in Elasticsearch. Elasticsearch supports the following item types: uint,dbl,str,log,text Supported item type explanation: | | | | |---|---|---| |**Item value type**|**Database table**|**Elasticsearch type**| |Numeric (unsigned)|history\_uint|uint| |Numeric (float)|history|dbl| |Character|history\_str|str| |Log|history\_log|log| |Text|history\_text|text| Zabbix frontend configuration file (`conf/zabbix.conf.php`) draft with parameters to be updated: // Elasticsearch url (can be string if same url is used for all types). $HISTORY['url'] = [ 'uint' => 'http://localhost:9200', 'text' => 'http://localhost:9200' ]; // Value types stored in Elasticsearch. $HISTORY['types'] = ['uint', 'text']; Example parameter values to fill the Zabbix frontend configuration file with: $HISTORY['url'] = 'http://test.elasticsearch.lan:9200'; $HISTORY['types'] = ['str', 'text', 'log']; This configuration forces to store `Text`, `Character` and `Log` history values in Elasticsearch. It is also required to make $HISTORY global in `conf/zabbix.conf.php` to ensure everything is working properly (see `conf/zabbix.conf.php.example` for how to do it): // Zabbix GUI configuration file. global $DB, $HISTORY; ##### سرور Zabbix و frontend پیش نویس فایل پیکربندی سرور Zabbix با پارامترهایی که باید به روز شوند: ### گزینه: HistoryStorageURL # نشانی وب HTTP[S] ذخیره سازی سابقه. # # اجباری: خیر # پیش فرض: # HistoryStorageURL= ### گزینه: HistoryStorageTypes # فهرست انواع مقادیر جدا شده با کاما برای ارسال به ذخیره‌سازی تاریخچه. # # اجباری: خیر # پیش فرض: # HistoryStorageTypes=uint,dbl,str,log,text مقادیر پارامتر نمونه برای پر کردن فایل پیکربندی سرور Zabbix با: HistoryStorageURL=http://test.elasticsearch.lan:9200 HistoryStorageTypes=str,log,text این پیکربندی سرور Zabbix را مجبور می‌کند تا مقادیر تاریخچه را ذخیره کند انواع عددی در پایگاه داده مربوطه و داده های تاریخ متنی در Elasticsearch. Elasticsearch انواع موارد زیر را پشتیبانی می کند: uint,dbl,str,log,text توضیح نوع مورد پشتیبانی شده: | | | | |---|---|---| |**نوع مقدار مورد**|**جدول پایگاه**|**نوع Elasticsearch**| |عددی (بدون امضا)|history\_uint|unint| |عددی (شناور)|تاریخچه|dbl| |شخصیت|تاریخ\_str|خیابان| |گزارش|تاریخچه\_log|log| |متن|تاریخ\_متن|متن| پیش نویس فایل پیکربندی ظاهری Zabbix (`conf/zabbix.conf.php`) با پارامترهایی که باید به روز شوند: // url Elasticsearch (اگر از همان URL برای همه انواع استفاده شود، می تواند رشته ای باشد). $HISTORY['url'] = [ 'uint' => 'http://localhost:9200'، 'text' => 'http://localhost:9200' ]؛ // انواع مقادیر ذخیره شده در Elasticsearch. $HISTORY['types'] = ['unint', 'text']; مقادیر پارامتر نمونه برای پر کردن فایل پیکربندی frontend Zabbix با: $HISTORY['url'] = 'http://test.elasticsearch.lan:9200'; $HISTORY['types'] = ['str', 'text', 'log']; این پیکربندی مجبور به ذخیره تاریخچه «متن»، «شخصیت» و «Log» می‌شود مقادیر در Elasticsearch همچنین لازم است $HISTORY در «conf/zabbix.conf.php» جهانی شود. اطمینان حاصل کنید که همه چیز به درستی کار می کند (نگاه کنید به «conf/zabbix.conf.php.example» برای نحوه انجام آن): // فایل پیکربندی رابط کاربری گرافیکی Zabbix. جهانی $DB، $HISTORY; ### ### # 11 Time zones # 11 منطقه زمانی # 14. Configuration export/import # 14. وارد کردن یا خروجی گرفتن از تنظیمات # 1 Menu # 1 منو # 4 Zabbix agent 2 (UNIX) # Zabbix Agent 2 (یونیکس) # 9. Web monitoring مانیتورینگ وب # action.create # ساخت اکشن # action.delete #پاک کردن اکشن # action.get # دریافت اکشن # > Action object The following objects are directly related to the `action` API. # > آبجکت اکشن اشیاء زیر مستقیماً با API «action» مرتبط هستند. # Action This class is designed to work with actions. Object references:\ - [Action](/manual/api/reference/action/object#action) - [Action condition](/manual/api/reference/action/object#action_condition) - [Action operation](/manual/api/reference/action/object#action_operation) Available methods:\ - [action.create](/manual/api/reference/action/create) - create new actions - [action.delete](/manual/api/reference/action/delete) - delete actions - [action.get](/manual/api/reference/action/get) - retrieve actions - [action.update](/manual/api/reference/action/update) - update actions # اکشن این کلاس برای کار با اکشن ها طراحی شده است. ارجاعات شیء:\ - [Action](/manual/api/reference/action/object#action) - [عمل شرط](/دستی/api/reference/action/object#action_condition) - [عمل عملیات](/دستی/api/reference/action/object#action_operation) روش های موجود:\ - [action.create](/manual/api/reference/action/create) - ایجاد جدید اقدامات - [action.delete](/manual/api/reference/action/delete) - حذف اقدامات - [action.get](/manual/api/reference/action/get) - بازیابی اقدامات - [action.update](/manual/api/reference/action/update) - به روز رسانی اقدامات # action.update # action.update # alert.get # alert.get # > Alert object The following objects are directly related to the `alert` API. # > آبجکت هشدار اشیاء زیر مستقیماً با API «هشدار» مرتبط هستند. # Alert This class is designed to work with alerts. Object references:\ - [Alert](/manual/api/reference/alert/object#alert) Available methods:\ - [alert.get](/manual/api/reference/alert/get) - retrieve alerts #هشدار این کلاس برای کار با هشدار طراحی شده است. ارجاعات شیء:\ - [هشدار](/دستی/api/reference/alert/object#alert) روش های موجود:\ - [alert.get](/manual/api/reference/alert/get) - هشدارها را بازیابی کنید # API info This class is designed to retrieve meta information about the API. Available methods:\ - [apiinfo.version](/manual/api/reference/apiinfo/version) - retrieving the version of the Zabbix API # اطلاعات API این کلاس برای بازیابی اطلاعات متا در مورد API طراحی شده است. روش های موجود:\ - [apiinfo.version](/manual/api/reference/apiinfo/version) - بازیابی نسخه Zabbix API # apiinfo.version # apiinfo.version # Appendix 1. Reference commentary # ضمیمه 1. تفسیر مرجع # auditlog.get # auditlog.get # > Audit log object The following objects are directly related to the `auditlog` API. # > شئ گزارش حسابرسی اشیاء زیر مستقیماً با API «auditlog» مرتبط هستند. # Audit log This class is designed to work with audit log. Object references:\ - [Audit log object](/manual/api/reference/auditlog/object) Available methods:\ - [auditlog.get](/manual/api/reference/auditlog/get) - retrieve audit log records # گزارش حسابرسی این کلاس برای کار با گزارش حسابرسی طراحی شده است. ارجاعات آبجکت:\ - [آبجکت گزارش حسابرسی](/manual/api/reference/auditlog/object) روش های موجود:\ - [auditlog.get](/manual/api/reference/auditlog/get) - بازیابی رکوردهای گزارش ممیزی # authentication.get دریافت احرازهویت # > Authentication object The following objects are directly related to the `authentication` API. # > شیء احراز هویت اشیاء زیر مستقیماً با API «احراز هویت» مرتبط هستند. # Authentication This class is designed to work with authentication settings. Object references:\ - [Authentication](/manual/api/reference/authentication/object#authentication) Available methods:\ - [authentication.get](/manual/api/reference/authentication/get) - retrieve authentication - [authentication.update](/manual/api/reference/authentication/update) - update authentication # احراز هویت این کلاس برای کار با تنظیمات احراز هویت طراحی شده است. مراجع شیء:\ - [احراز هویت](/دستی/api/reference/authentication/object#authentication) روش های موجود:\ - [authentication.get](/manual/api/reference/authentication/get) - بازیابی احراز هویت - [authentication.update](/manual/api/reference/authentication/update) - به روز رسانی احراز هویت # authentication.update به روز رسانی احرازهویت ## AUTHOR Alexei Vladishev <<alex@zabbix.com>> ------------------------------------------------------------------------ [ ]{#index} ## نویسنده الکسی ولادیشف <<alex@zabbix.com>> ------------------------------------------------ ---------------------- [ ]{#فهرست مطالب} ## AUTHOR Alexei Vladishev <<alex@zabbix.com>> ------------------------------------------------------------------------ [ ]{#index} ## نویسنده الکسی ولادیشف <<alex@zabbix.com>> ------------------------------------------------ ---------------------- [ ]{#فهرست مطالب} ## AUTHOR Alexei Vladishev <<alex@zabbix.com>> ------------------------------------------------------------------------ [ ]{#index} ## نویسنده Zabbix LLC ------------------------------------------------ ---------------------- [ ]{#فهرست مطالب} ## AUTHOR Zabbix LLC ------------------------------------------------------------------------ [ ]{#index} ## نویسنده Zabbix LLC ------------------------------------------------ ---------------------- [ ]{#فهرست مطالب} ## AUTHOR Zabbix LLC ------------------------------------------------------------------------ [ ]{#index} ## نویسنده Zabbix LLC ------------------------------------------------ ---------------------- [ ]{#فهرست مطالب} # autoregistration.get دریافت ثبت خودکار # > Autoregistration object The following objects are directly related to the `autoregistration` API. # > شیء احراز هویت اشیاء زیر مستقیماً با API «احراز هویت» مرتبط هستند. # Autoregistration This class is designed to work with autoregistration. Object references:\ - [Autoregistration](/manual/api/reference/autoregistration/object#autoregistration) Available methods:\ - [autoregistration.get](/manual/api/reference/autoregistration/get) - retrieve autoregistration - [autoregistration.update](/manual/api/reference/autoregistration/update) - update autoregistration # احراز هویت این کلاس برای کار با تنظیمات احراز هویت طراحی شده است. مراجع شیء:\ - [احراز هویت](/دستی/api/reference/authentication/object#authentication) روش های موجود:\ - [authentication.get](/manual/api/reference/authentication/get) - بازیابی احراز هویت - [authentication.update](/manual/api/reference/authentication/update) - به روز رسانی احراز هویت # autoregistration.update دریافت ثبت خودکار ##### Collapsed menu When the menu is collapsed to icons only, a full menu reappears as soon as the mouse cursor is placed upon it. Note that it reappears over page content; to move page content to the right you have to click on the expand button. If the mouse cursor again is placed outside the full menu, the menu will collapse again after two seconds. You can also make a collapsed menu reappear fully by hitting the Tab key. Hitting the Tab key repeatedly will allow to focus on the next menu element. ##### Collapsed menu When the menu is collapsed to icons only, a full menu reappears as soon as the mouse cursor is placed upon it. Note that it reappears over page content; to move page content to the right you have to click on the expand button. If the mouse cursor again is placed outside the full menu, the menu will collapse again after two seconds. You can also make a collapsed menu reappear fully by hitting the Tab key. Hitting the Tab key repeatedly will allow to focus on the next menu element. # configuration.export خروجی گرفتن از تنظیمات # configuration.import وارد کردن تنظیمات # configuration.importcompare مقایسه تنظیمات وارد شده #### Configuring authentication The **Authentication** tab allows you to configure scenario authentication options. A green dot next to the tab name indicates that some type of HTTP authentication is enabled. ![](../../assets/en/manual/config/scenario_d.png) Authentication parameters: |Parameter|Description| |--|--------| |*Authentication*|Authentication options.<br>**None** - no authentication used.<br>**Basic** - basic authentication is used.<br>**NTLM** - NTLM ([Windows NT LAN Manager)](http://en.wikipedia.org/wiki/NTLM) authentication is used.<br>**Kerberos** - Kerberos authentication is used. See also: [Configuring Kerberos with Zabbix](/manual/appendix/items/kerberos).<br>**Digest** - Digest authentication is used.<br>Selecting an authentication method will provide two additional fields for entering a user name and password.<br>User macros can be used in user and password fields.| |*SSL verify peer*|Mark the checkbox to verify the SSL certificate of the web server.<br>The server certificate will be automatically taken from system-wide certificate authority (CA) location. You can override the location of CA files using Zabbix server or proxy configuration parameter [SSLCALocation](/manual/appendix/config/zabbix_server).<br>This sets the [CURLOPT\_SSL\_VERIFYPEER](http://curl.haxx.se/libcurl/c/CURLOPT_SSL_VERIFYPEER.html) cURL option.| |*SSL verify host*|Mark the checkbox to verify that the *Common Name* field or the *Subject Alternate Name* field of the web server certificate matches.<br>This sets the [CURLOPT\_SSL\_VERIFYHOST](http://curl.haxx.se/libcurl/c/CURLOPT_SSL_VERIFYHOST.html) cURL option.| |*SSL certificate file*|Name of the SSL certificate file used for client authentication. The certificate file must be in PEM^1^ format. If the certificate file contains also the private key, leave the *SSL key file* field empty. If the key is encrypted, specify the password in *SSL key password* field. The directory containing this file is specified by Zabbix server or proxy configuration parameter [SSLCertLocation](/manual/appendix/config/zabbix_server).<br>`HOST.*` macros and user macros can be used in this field.<br>This sets the [CURLOPT\_SSLCERT](http://curl.haxx.se/libcurl/c/CURLOPT_SSLCERT.html) cURL option.| |*SSL key file*|Name of the SSL private key file used for client authentication. The private key file must be in PEM^1^ format. The directory containing this file is specified by Zabbix server or proxy configuration parameter [SSLKeyLocation](/manual/appendix/config/zabbix_server).<br>`HOST.*` macros and user macros can be used in this field.<br>This sets the [CURLOPT\_SSLKEY](http://curl.haxx.se/libcurl/c/CURLOPT_SSLKEY.html) cURL option.| |*SSL key password*|SSL private key file password.<br>User macros can be used in this field.<br>This sets the [CURLOPT\_KEYPASSWD](http://curl.haxx.se/libcurl/c/CURLOPT_KEYPASSWD.html) cURL option.| ::: noteimportant \[1\] Zabbix supports certificate and private key files in PEM format only. In case you have your certificate and private key data in PKCS \#12 format file (usually with extension \*.p12 or \*.pfx) you may generate the PEM file from it using the following commands: openssl pkcs12 -in ssl-cert.p12 -clcerts -nokeys -out ssl-cert.pem openssl pkcs12 -in ssl-cert.p12 -nocerts -nodes -out ssl-cert.key ::: ::: noteclassic Zabbix server picks up changes in certificates without a restart. ::: ::: noteclassic If you have client certificate and private key in a single file just specify it in a "SSL certificate file" field and leave "SSL key file" field empty. The certificate and key must still be in PEM format. Combining certificate and key is easy: cat client.crt client.key > client.pem ::: #### تنظیم احراز هویت The **Authentication** tab allows you to configure scenario authentication options. A green dot next to the tab name indicates that some type of HTTP authentication is enabled. ![](../../assets/en/manual/config/scenario_d.png) Authentication parameters: |Parameter|Description| |--|--------| |*Authentication*|Authentication options.<br>**None** - no authentication used.<br>**Basic** - basic authentication is used.<br>**NTLM** - NTLM ([Windows NT LAN Manager)](http://en.wikipedia.org/wiki/NTLM) authentication is used.<br>**Kerberos** - Kerberos authentication is used. See also: [Configuring Kerberos with Zabbix](/manual/appendix/items/kerberos).<br>**Digest** - Digest authentication is used.<br>Selecting an authentication method will provide two additional fields for entering a user name and password.<br>User macros can be used in user and password fields.| |*SSL verify peer*|Mark the checkbox to verify the SSL certificate of the web server.<br>The server certificate will be automatically taken from system-wide certificate authority (CA) location. You can override the location of CA files using Zabbix server or proxy configuration parameter [SSLCALocation](/manual/appendix/config/zabbix_server).<br>This sets the [CURLOPT\_SSL\_VERIFYPEER](http://curl.haxx.se/libcurl/c/CURLOPT_SSL_VERIFYPEER.html) cURL option.| |*SSL verify host*|Mark the checkbox to verify that the *Common Name* field or the *Subject Alternate Name* field of the web server certificate matches.<br>This sets the [CURLOPT\_SSL\_VERIFYHOST](http://curl.haxx.se/libcurl/c/CURLOPT_SSL_VERIFYHOST.html) cURL option.| |*SSL certificate file*|Name of the SSL certificate file used for client authentication. The certificate file must be in PEM^1^ format. If the certificate file contains also the private key, leave the *SSL key file* field empty. If the key is encrypted, specify the password in *SSL key password* field. The directory containing this file is specified by Zabbix server or proxy configuration parameter [SSLCertLocation](/manual/appendix/config/zabbix_server).<br>`HOST.*` macros and user macros can be used in this field.<br>This sets the [CURLOPT\_SSLCERT](http://curl.haxx.se/libcurl/c/CURLOPT_SSLCERT.html) cURL option.| |*SSL key file*|Name of the SSL private key file used for client authentication. The private key file must be in PEM^1^ format. The directory containing this file is specified by Zabbix server or proxy configuration parameter [SSLKeyLocation](/manual/appendix/config/zabbix_server).<br>`HOST.*` macros and user macros can be used in this field.<br>This sets the [CURLOPT\_SSLKEY](http://curl.haxx.se/libcurl/c/CURLOPT_SSLKEY.html) cURL option.| |*SSL key password*|SSL private key file password.<br>User macros can be used in this field.<br>This sets the [CURLOPT\_KEYPASSWD](http://curl.haxx.se/libcurl/c/CURLOPT_KEYPASSWD.html) cURL option.| ::: noteimportant \[1\] Zabbix supports certificate and private key files in PEM format only. In case you have your certificate and private key data in PKCS \#12 format file (usually with extension \*.p12 or \*.pfx) you may generate the PEM file from it using the following commands: openssl pkcs12 -in ssl-cert.p12 -clcerts -nokeys -out ssl-cert.pem openssl pkcs12 -in ssl-cert.p12 -nocerts -nodes -out ssl-cert.key ::: ::: noteclassic Zabbix server picks up changes in certificates without a restart. ::: ::: noteclassic If you have client certificate and private key in a single file just specify it in a "SSL certificate file" field and leave "SSL key file" field empty. The certificate and key must still be in PEM format. Combining certificate and key is easy: cat client.crt client.key > client.pem ::: #### Configuring tags The **Tags** tab allows to define scenario-level [tags](/manual/config/tagging). ![](../../assets/en/manual/config/scenario_c.png) Tagging allows to filter web scenarios and web monitoring [items](/manual/web_monitoring/items). #### تنظیم تگ ها The **Tags** tab allows to define scenario-level [tags](/manual/config/tagging). ![](../../assets/en/manual/config/scenario_c.png) Tagging allows to filter web scenarios and web monitoring [items](/manual/web_monitoring/items). # correlation.create # ایجاد همبستگی # correlation.delete # correlation.delete # correlation.get # correlation.get # > Correlation object The following objects are directly related to the `correlation` API. # > آبجکت همبستگی اشیاء زیر مستقیماً با API «همبستگی» مرتبط هستند. # Correlation This class is designed to work with correlations. Object references:\ - [Correlation](/manual/api/reference/correlation/object#correlation) Available methods:\ - [correlation.create](/manual/api/reference/correlation/create) - creating new correlations - [correlation.delete](/manual/api/reference/correlation/delete) - deleting correlations - [correlation.get](/manual/api/reference/correlation/get) - retrieving correlations - [correlation.update](/manual/api/reference/correlation/update) - updating correlations # همبستگی این کلاس برای کار با همبستگی طراحی شده است. ارجاعات شیء:\ - [همبستگی] (/ دستی / api / مرجع / همبستگی / شی # همبستگی) روش های موجود:\ - [correlation.create](/manual/api/reference/correlation/create) - ایجاد همبستگی های جدید - [correlation.delete](/manual/api/reference/correlation/delete) - حذف همبستگی ها - [correlation.get](/manual/api/reference/correlation/get) - بازیابی همبستگی ها - [correlation.update](/manual/api/reference/correlation/update) - به روز رسانی همبستگی ها # correlation.update # correlation.update # dashboard.create ساخت داشبورد # dashboard.delete حذف داشبورد # dashboard.get # دریافت داشبورد # > Dashboard object The following objects are directly related to the `dashboard` API. # > شی داشبورد آبجکت های زیر مستقیما به API داشبورد مرتبط می شوند . # Dashboard This class is designed to work with dashboards. Object references:\ - [Dashboard](/manual/api/reference/dashboard/object#dashboard) - [Dashboard page](/manual/api/reference/dashboard/object#dashboard_page) - [Dashboard widget](/manual/api/reference/dashboard/object#dashboard_widget) - [Dashboard widget field](/manual/api/reference/dashboard/object#dashboard_widget_field) - [Dashboard user](/manual/api/reference/dashboard/object#dashboard_user) - [Dashboard user group](/manual/api/reference/dashboard/object#dashboard_user_group) Available methods:\ - [dashboard.create](/manual/api/reference/dashboard/create) - creating new dashboards - [dashboard.delete](/manual/api/reference/dashboard/delete) - deleting dashboards - [dashboard.get](/manual/api/reference/dashboard/get) - retrieving dashboards - [dashboard.update](/manual/api/reference/dashboard/update) - updating dashboards # داشبورد This class is designed to work with dashboards. Object references:\ - [Dashboard](/manual/api/reference/dashboard/object#dashboard) - [Dashboard page](/manual/api/reference/dashboard/object#dashboard_page) - [Dashboard widget](/manual/api/reference/dashboard/object#dashboard_widget) - [Dashboard widget field](/manual/api/reference/dashboard/object#dashboard_widget_field) - [Dashboard user](/manual/api/reference/dashboard/object#dashboard_user) - [Dashboard user group](/manual/api/reference/dashboard/object#dashboard_user_group) Available methods:\ - [dashboard.create](/manual/api/reference/dashboard/create) - creating new dashboards - [dashboard.delete](/manual/api/reference/dashboard/delete) - deleting dashboards - [dashboard.get](/manual/api/reference/dashboard/get) - retrieving dashboards - [dashboard.update](/manual/api/reference/dashboard/update) - updating dashboards # dashboard.update به روز رسانی داشبورد # dcheck.get # dcheck.get ### Description `string apiinfo.version(array)` This method allows to retrieve the version of the Zabbix API. ::: noteimportant This method is only available to unauthenticated users and must be called without the `auth` parameter in the JSON-RPC request. ::: ### شرح `string apiinfo.version(array)` این روش امکان بازیابی نسخه Zabbix API را فراهم می کند. ::: نکته مهم این روش فقط برای غیر احراز هویت در دسترس است کاربران و باید بدون پارامتر «auth» در JSON-RPC فراخوانی شوند درخواست. ::: ## DESCRIPTION **zabbix\_agent2** is an application for monitoring parameters of various services.\ \ [ ]{#lbAE} ## شرح **zabbix\_agent2** یک برنامه کاربردی برای نظارت بر پارامترهای است خدمات مختلف.\ \ [ ]{#lbAE} ## DESCRIPTION **zabbix\_agentd** is a daemon for monitoring various server parameters. [ ]{#lbAE} ## شرح **zabbix\_agentd** دیمونی برای نظارت بر پارامترهای مختلف سرور است. [ ]{#lbAE} ## DESCRIPTION **zabbix\_get** is a command line utility for getting data from Zabbix agent. [ ]{#lbAE} ## شرح **zabbix\_get** یک ابزار خط فرمان برای دریافت داده از عامل Zabbix است. [ ]{#lbAE} ## DESCRIPTION **zabbix\_js** is a command line utility that can be used for embedded script testing. [ ]{#lbAE} ## شرح **zabbix\_js** یک ابزار خط فرمان است که می تواند برای جاسازی استفاده شود تست اسکریپت [ ]{#lbAE} ## DESCRIPTION **zabbix\_proxy** is a daemon that collects monitoring data from devices and sends it to Zabbix server. [ ]{#lbAE} ## شرح **zabbix\_proxy** دیمونی است که داده های نظارتی را از دستگاه ها جمع آوری می کند و آن را به سرور Zabbix ارسال می کند. [ ]{#lbAE} ## DESCRIPTION **zabbix\_sender** is a command line utility for sending monitoring data to Zabbix server or proxy. On the Zabbix server an item of type **Zabbix trapper** should be created with corresponding key. Note that incoming values will only be accepted from hosts specified in **Allowed hosts** field for this item. [ ]{#lbAE} ## شرح **zabbix\_sender** یک ابزار خط فرمان برای ارسال داده های نظارت است به سرور یا پروکسی Zabbix. در سرور Zabbix موردی از نوع **Zabbix trapper** باید با کلید مربوطه ایجاد شود. توجه داشته باشید که ورودی مقادیر فقط از میزبان های مشخص شده در **میزبان های مجاز** پذیرفته می شود. فیلد برای این مورد [ ]{#lbAE} ## DESCRIPTION **zabbix\_server** is the core daemon of Zabbix software. [ ]{#lbAE} ## شرح **zabbix\_server** دیمون اصلی نرم افزار Zabbix است. [ ]{#lbAE} ## DESCRIPTION **zabbix\_web\_service** is an application for providing web services to Zabbix components. [ ]{#lbAE} ## شرح **zabbix\_web\_service** اپلیکیشنی برای ارائه خدمات وب به اجزای Zabbix [ ]{#lbAE} #### Details about export - All supported elements are exported in one file. - Host and template entities (items, triggers, graphs, discovery rules) that are inherited from linked templates are not exported. Any changes made to those entities on a host level (such as changed item interval, modified regular expression or added prototypes to the low-level discovery rule) will be lost when exporting; when importing, all entities from linked templates are re-created as on the original linked template. - Entities created by low-level discovery and any entities depending on them are not exported. For example, a trigger created for an LLD-rule generated item will not be exported. #### جزئیات در مورد خروجی گرفتن - تمام عناصر پشتیبانی شده در یک فایل صادر می شوند. - موجودیت های میزبان و قالب (اقلام، محرک ها، نمودارها، کشف قوانین) که از الگوهای پیوندی به ارث رسیده اند صادر نمی شوند. هر گونه تغییری که در آن نهادها در سطح میزبان ایجاد شود (مانند تغییر فاصله آیتم، بیان منظم اصلاح شده یا نمونه های اولیه اضافه شده به قانون کشف سطح پایین) هنگام صادرات از بین خواهد رفت. چه زمانی با وارد کردن، همه موجودیت‌ها از قالب‌های پیوندی مجدداً ایجاد می‌شوند الگوی لینک شده اصلی - موجودیت های ایجاد شده توسط اکتشاف سطح پایین و هر موجودیت وابسته بر روی آنها صادر نمی شود. به عنوان مثال، یک ماشه ایجاد شده برای یک مورد ایجاد شده با قانون LLD صادر نخواهد شد. # dhost.get # dhost.get ### Discovered host ::: noteclassic Discovered host are created by the Zabbix server and cannot be modified via the API. ::: The discovered host object contains information about a host discovered by a network discovery rule. It has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |dhostid|string|ID of the discovered host.| |druleid|string|ID of the discovery rule that detected the host.| |lastdown|timestamp|Time when the discovered host last went down.| |lastup|timestamp|Time when the discovered host last went up.| |status|integer|Whether the discovered host is up or down. A host is up if it has at least one active discovered service.<br><br>Possible values:<br>0 - host up;<br>1 - host down.| ### هاست های پیدا شده ::: noteclassic Discovered host are created by the Zabbix server and cannot be modified via the API. ::: The discovered host object contains information about a host discovered by a network discovery rule. It has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |dhostid|string|ID of the discovered host.| |druleid|string|ID of the discovery rule that detected the host.| |lastdown|timestamp|Time when the discovered host last went down.| |lastup|timestamp|Time when the discovered host last went up.| |status|integer|Whether the discovered host is up or down. A host is up if it has at least one active discovered service.<br><br>Possible values:<br>0 - host up;<br>1 - host down.| # > Discovered host object The following objects are directly related to the `dhost` API. # > آبجکت های هاست جست و جو شده The following objects are directly related to the `dhost` API. # Discovered host This class is designed to work with discovered hosts. Object references:\ - [Discovered host](/manual/api/reference/dhost/object#discovered_host) Available methods:\ - [dhost.get](/manual/api/reference/dhost/get) - retrieve discovered hosts # هاست های پیدا شده این کلاس برای کار با هاست های پیدا شده طراحی شده است . Object references:\ - [Discovered host](/manual/api/reference/dhost/object#discovered_host) Available methods:\ - [dhost.get](/manual/api/reference/dhost/get) - retrieve discovered hosts ### Discovered service ::: noteclassic Discovered services are created by the Zabbix server and cannot be modified via the API. ::: The discovered service object contains information about a service discovered by a network discovery rule on a host. It has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |dserviceid|string|ID of the discovered service.| |dcheckid|string|ID of the discovery check used to detect the service.| |dhostid|string|ID of the discovered host running the service.| |dns|string|DNS of the host running the service.| |ip|string|IP address of the host running the service.| |lastdown|timestamp|Time when the discovered service last went down.| |lastup|timestamp|Time when the discovered service last went up.| |port|integer|Service port number.| |status|integer|Status of the service.<br><br>Possible values:<br>0 - service up;<br>1 - service down.| |value|string|Value returned by the service when performing a Zabbix agent, SNMPv1, SNMPv2 or SNMPv3 discovery check.| ### سرویس جست و جو شده ::: noteclassic Discovered services are created by the Zabbix server and cannot be modified via the API. ::: The discovered service object contains information about a service discovered by a network discovery rule on a host. It has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |dserviceid|string|ID of the discovered service.| |dcheckid|string|ID of the discovery check used to detect the service.| |dhostid|string|ID of the discovered host running the service.| |dns|string|DNS of the host running the service.| |ip|string|IP address of the host running the service.| |lastdown|timestamp|Time when the discovered service last went down.| |lastup|timestamp|Time when the discovered service last went up.| |port|integer|Service port number.| |status|integer|Status of the service.<br><br>Possible values:<br>0 - service up;<br>1 - service down.| |value|string|Value returned by the service when performing a Zabbix agent, SNMPv1, SNMPv2 or SNMPv3 discovery check.| # > Discovered service object The following objects are directly related to the `dservice` API. # > آبجکت سرویس جست و جو شده The following objects are directly related to the `dservice` API. # Discovered service This class is designed to work with discovered services. Object references:\ - [Discovered service](/manual/api/reference/dservice/object#discovered_service) Available methods:\ - [dservice.get](/manual/api/reference/dservice/get) - retrieve discovered services # سرویس های جست وجو شده This class is designed to work with discovered services. Object references:\ - [Discovered service](/manual/api/reference/dservice/object#discovered_service) Available methods:\ - [dservice.get](/manual/api/reference/dservice/get) - retrieve discovered services # > Discovery check object The following objects are directly related to the `dcheck` API. # > آبجکت های بررسی جست جو ها The following objects are directly related to the `dcheck` API. # Discovery check This class is designed to work with discovery checks. Object references:\ - [Discovery check](/manual/api/reference/dcheck/object#discovery_check) Available methods:\ - [dcheck.get](/manual/api/reference/dcheck/get) - retrieve discovery checks # Discovery check This class is designed to work with discovery checks. Object references:\ - [Discovery check](/manual/api/reference/dcheck/object#discovery_check) Available methods:\ - [dcheck.get](/manual/api/reference/dcheck/get) - retrieve discovery checks ##### Discovery of disabled systemd units Since Zabbix 6.0.1 it is also possible to discover **disabled** systemd units. In this case three macros are returned in the resulting JSON: - {#UNIT.PATH} - {#UNIT.ACTIVESTATE} - {#UNIT.UNITFILESTATE}. ::: noteimportant To have items and triggers created from prototypes for disabled systemd units, make sure to adjust (or remove) prohibiting LLD filters for {#UNIT.ACTIVESTATE} and {#UNIT.UNITFILESTATE}. ::: ##### Discovery of disabled systemd units Since Zabbix 6.0.1 it is also possible to discover **disabled** systemd units. In this case three macros are returned in the resulting JSON: - {#UNIT.PATH} - {#UNIT.ACTIVESTATE} - {#UNIT.UNITFILESTATE}. ::: noteimportant To have items and triggers created from prototypes for disabled systemd units, make sure to adjust (or remove) prohibiting LLD filters for {#UNIT.ACTIVESTATE} and {#UNIT.UNITFILESTATE}. ::: # discoveryrule.copy # کپی کردن قوانین جست وجو # discoveryrule.create # ساختن قوانین جست وجو # discoveryrule.delete # پاک کردن قوانین جست وجو # discoveryrule.get # گرفتن قوانین جست وجو # > Discovery rule object The following objects are directly related to the `drule` API. # >آبجکت قانون جست و جو The following objects are directly related to the `drule` API. # Discovery rule This class is designed to work with network discovery rules. ::: notetip This API is meant to work with network discovery rules. For the low-level discovery rules see the [LLD rule API](discoveryrule). ::: Object references:\ - [Discovery rule](/manual/api/reference/drule/object#discovery_rule) Available methods:\ - [drule.create](/manual/api/reference/drule/create) - create new discovery rules - [drule.delete](/manual/api/reference/drule/delete) - delete discovery rules - [drule.get](/manual/api/reference/drule/get) - retrieve discovery rules - [drule.update](/manual/api/reference/drule/update) - update discovery rules # قانون جست و جو This class is designed to work with network discovery rules. ::: notetip This API is meant to work with network discovery rules. For the low-level discovery rules see the [LLD rule API](discoveryrule). ::: Object references:\ - [Discovery rule](/manual/api/reference/drule/object#discovery_rule) Available methods:\ - [drule.create](/manual/api/reference/drule/create) - create new discovery rules - [drule.delete](/manual/api/reference/drule/delete) - delete discovery rules - [drule.get](/manual/api/reference/drule/get) - retrieve discovery rules - [drule.update](/manual/api/reference/drule/update) - update discovery rules # discoveryrule.update # به روز رسانی قوانین جست وجو # drule.create # ساختن # drule.delete پاک کردن قانون جست وجو # drule.get دریافت حذف قانون جست و جو # drule.update # آپدیت قانون جست و جو # dservice.get # دریافت سرویس جست و جو #### Element tags Element tag values are explained in the table below. #### برچسب های عنصر مقادیر تگ عنصر در جدول زیر توضیح داده شده است. #### Element tags Element tag values are explained in the table below. #### برچسب های عنصر مقادیر تگ عنصر در جدول زیر توضیح داده شده است. # event.acknowledge # تایید رویداد # event.get دریافت رخداد # > Event object The following objects are directly related to the `event` API. # > آبکت رویداد The following objects are directly related to the `event` API. ### Event tag The event tag object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |tag|string|Event tag name.| |value|string|Event tag value.| ### تگ رویداد The event tag object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |tag|string|Event tag name.| |value|string|Event tag value.| # Event This class is designed to work with events. Object references:\ - [Event](/manual/api/reference/event/object#host) Available methods:\ - [event.get](/manual/api/reference/event/get) - retrieving events - [event.acknowledge](/manual/api/reference/event/acknowledge) - acknowledging events # رویداد This class is designed to work with events. Object references:\ - [Event](/manual/api/reference/event/object#host) Available methods:\ - [event.get](/manual/api/reference/event/get) - retrieving events - [event.acknowledge](/manual/api/reference/event/acknowledge) - acknowledging events ### Example ### مثال ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ## EXAMPLES **zabbix\_get -s 127.0.0.1 -p 10050 -k "system.cpu.load\[all,avg1\]"**\ **zabbix\_get -s 127.0.0.1 -p 10050 -k "system.cpu.load\[all,avg1\]" --tls-connect cert --tls-ca-file /home/zabbix/zabbix\_ca\_file --tls-agent-cert-issuer "CN=Signing CA,OU=IT operations,O=Example Corp,DC=example,DC=com" --tls-agent-cert-subject "CN=server1,OU=IT operations,O=Example Corp,DC=example,DC=com" --tls-cert-file /home/zabbix/zabbix\_get.crt --tls-key-file /home/zabbix/zabbix\_get.key\ zabbix\_get -s 127.0.0.1 -p 10050 -k "system.cpu.load\[all,avg1\]" --tls-connect psk --tls-psk-identity "PSK ID Zabbix agentd" --tls-psk-file /home/zabbix/zabbix\_agentd.psk** [ ]{#lbAH} ## مثال ها **zabbix\_get -s 127.0.0.1 -p 10050 -k "system.cpu.load\[all,avg1\]"**\ **zabbix\_get -s 127.0.0.1 -p 10050 -k "system.cpu.load\[all,avg1\]" --tls-connect Cert --tls-ca-file /home/zabbix/zabbix\_ca\_file --tls-agent-cert-issuer "CN=امضای عملیات CA,OU=IT,O=مثال Corp,DC=example,DC=com" --tls-agent-cert-subject "CN=server1,OU=IT عملیات,O=Example Corp,DC=example,DC=com" --tls-cert-file /home/zabbix/zabbix\_get.crt --tls-key-file /home/zabbix/zabbix\_get.key\ zabbix\_get -s 127.0.0.1 -p 10050 -k "system.cpu.load\[all,avg1\]" --tls-connect psk --tls-psk-identity "PSK ID Zabbix agentd" --tls-psk-file /home/zabbix/zabbix\_agentd.psk** [ ]{#lbAH} ## EXAMPLES **zabbix\_js -s script-file.js -p example** [ ]{#lbAG} ## مثال ها **zabbix\_js -s script-file.js -p مثال** [ ]{#lbAG} ## EXAMPLES **zabbix\_sender -c /etc/zabbix/zabbix\_agentd.conf -k mysql.queries -o 342.45**\ Send **342.45** as the value for **mysql.queries** item of monitored host. Use monitored host and Zabbix server defined in agent configuration file. **zabbix\_sender -c /etc/zabbix/zabbix\_agentd.conf -s "Monitored Host" -k mysql.queries -o 342.45**\ Send **342.45** as the value for **mysql.queries** item of **Monitored Host** host using Zabbix server defined in agent configuration file. \ **zabbix\_sender -z 192.168.1.113 -i data\_values.txt** \ Send values from file **data\_values.txt** to Zabbix server with IP **192.168.1.113**. Host names and keys are defined in the file. \ **echo "- hw.serial.number 1287872261 SQ4321ASDF" | zabbix\_sender -c /usr/local/etc/zabbix\_agentd.conf -T -i -**\ Send a timestamped value from the commandline to Zabbix server, specified in the agent configuration file. Dash in the input data indicates that hostname also should be used from the same configuration file. \ **echo '"Zabbix server" trapper.item ""' | zabbix\_sender -z 192.168.1.113 -p 10000 -i -**\ Send empty value of an item to the Zabbix server with IP address **192.168.1.113** on port **10000** from the commandline. Empty values must be indicated by empty double quotes. **zabbix\_sender -z 192.168.1.113 -s "Monitored Host" -k mysql.queries -o 342.45 --tls-connect cert --tls-ca-file /home/zabbix/zabbix\_ca\_file --tls-cert-file /home/zabbix/zabbix\_agentd.crt --tls-key-file /home/zabbix/zabbix\_agentd.key**\ Send **342.45** as the value for **mysql.queries** item in **Monitored Host** host to server with IP **192.168.1.113** using TLS with certificate. **zabbix\_sender -z 192.168.1.113 -s "Monitored Host" -k mysql.queries -o 342.45 --tls-connect psk --tls-psk-identity "PSK ID Zabbix agentd" --tls-psk-file /home/zabbix/zabbix\_agentd.psk**\ Send **342.45** as the value for **mysql.queries** item in **Monitored Host** host to server with IP **192.168.1.113** using TLS with pre-shared key (PSK). [ ]{#lbAI} ## مثال ها **zabbix\_sender -c /etc/zabbix/zabbix\_agentd.conf -k mysql.queries -o 342.45**\ ارسال **342.45** به عنوان مقدار برای **mysql.queries** مورد نظارت شده میزبان. از میزبان نظارت شده و سرور Zabbix تعریف شده در عامل استفاده کنید فایل پیکربندی. **zabbix\_sender -c /etc/zabbix/zabbix\_agentd.conf -s "میزبان نظارت شده" -k mysql.queries -o 342.45**\ ارسال **342.45** به عنوان مقدار برای **mysql.queries** مورد **Monitored میزبان ** با استفاده از سرور Zabbix تعریف شده در فایل پیکربندی عامل. \ **zabbix\_sender -z 192.168.1.113 -i data\_values.txt** \ مقادیر را از فایل **data\_values.txt** به سرور Zabbix با IP ارسال کنید **192.168.1.113**. نام هاست و کلیدها در فایل تعریف شده است. \ **echo "- hw.serial.number 1287872261 SQ4321ASDF" | zabbix\_sender -c /usr/local/etc/zabbix\_agentd.conf -T -i -**\ یک مقدار مهر زمانی از خط فرمان به سرور Zabbix ارسال کنید، در فایل پیکربندی عامل مشخص شده است. خط تیره در داده های ورودی نشان می دهد که نام میزبان نیز باید از همان پیکربندی استفاده شود فایل. \ **echo '"سرور Zabbix" trapper.item ""' | zabbix\_sender -z 192.168.1.113 -p 10000 -i -**\ مقدار خالی یک مورد را با آدرس IP به سرور Zabbix ارسال کنید **192.168.1.113** در پورت **10000** از خط فرمان. ارزش های خالی باید با دو نقل قول خالی نشان داده شود. **zabbix\_sender -z 192.168.1.113 -s "میزبان نظارت شده" -k mysql.queries -o 342.45 --tls-connect Cert --tls-ca-file /home/zabbix/zabbix\_ca\_file --tls-cert-file /home/zabbix/zabbix\_agentd.crt --tls-key-file /home/zabbix/zabbix\_agentd.key**\ ارسال **342.45** به عنوان مقدار مورد **mysql.queries** در **Monitored میزبان ** میزبان به سرور با IP **192.168.1.113** با استفاده از TLS با گواهی **zabbix\_sender -z 192.168.1.113 -s "میزبان نظارت شده" -k mysql.queries -o 342.45 --tls-connect psk --tls-psk-identity "PSK ID Zabbix agent" --tls-psk-file /home/zabbix/zabbix\_agentd.psk**\ ارسال **342.45** به عنوان مقدار مورد **mysql.queries** در **Monitored میزبان ** میزبان به سرور با IP **192.168.1.113** با استفاده از TLS با کلید از پیش مشترک (PSK). [ ]{#lbAI} ## EXIT STATUS The exit status is 0 if the values were sent and all of them were successfully processed by server. If data was sent, but processing of at least one of the values failed, the exit status is 2. If data sending failed, the exit status is 1. [ ]{#lbAH} ## وضعیت خروج اگر مقادیر ارسال شده باشند و همه آنها ارسال شده باشند، وضعیت خروج 0 است با موفقیت توسط سرور پردازش شد. اگر داده ها ارسال شد، اما پردازش در حداقل یکی از مقادیر ناموفق، وضعیت خروج 2 است. در صورت ارسال داده ها ناموفق، وضعیت خروج 1 است. [ ]{#lbAH} ##### Export format Data can be exported using the Zabbix web frontend or [Zabbix API](/manual/api/reference/configuration). Supported export formats are YAML, XML and JSON. ##### فرمت صادرات داده ها را می توان با استفاده از صفحه وب Zabbix یا [Zabbix صادر کرد API](/دستی/api/reference/configuration). فرمت های صادراتی پشتیبانی شده هستند YAML، XML و JSON. #### Extended monitoring Sometimes it is necessary to log received HTML page content. This is especially useful if some web scenario step fails. Debug level 5 (trace) serves that purpose. This level can be set in [server](/manual/appendix/config/zabbix_server) and [proxy](/manual/appendix/config/zabbix_proxy) configuration files or using a runtime control option (`-R log_level_increase="http poller,N"`, where N is the process number). The following examples demonstrate how extended monitoring can be started provided debug level 4 is already set: Increase log level of all http pollers: shell> zabbix_server -R log_level_increase="http poller" Increase log level of second http poller: shell> zabbix_server -R log_level_increase="http poller,2" If extended web monitoring is not required it can be stopped using the `-R log_level_decrease` option. #### گسترش مانیتورینگ Sometimes it is necessary to log received HTML page content. This is especially useful if some web scenario step fails. Debug level 5 (trace) serves that purpose. This level can be set in [server](/manual/appendix/config/zabbix_server) and [proxy](/manual/appendix/config/zabbix_proxy) configuration files or using a runtime control option (`-R log_level_increase="http poller,N"`, where N is the process number). The following examples demonstrate how extended monitoring can be started provided debug level 4 is already set: Increase log level of all http pollers: shell> zabbix_server -R log_level_increase="http poller" Increase log level of second http poller: shell> zabbix_server -R log_level_increase="http poller,2" If extended web monitoring is not required it can be stopped using the `-R log_level_decrease` option. ## FILES */usr/local/etc/zabbix\_agent2.conf* Default location of Zabbix agent 2 configuration file (if not modified during compile time). [ ]{#lbAH} ## فایل ها */usr/local/etc/zabbix\_agent2.conf* محل پیش‌فرض فایل پیکربندی عامل Zabbix 2 (در صورت عدم تغییر در طول زمان کامپایل). [ ]{#lbAH} ## FILES */usr/local/etc/zabbix\_agentd.conf* Default location of Zabbix agent configuration file (if not modified during compile time). [ ]{#lbAI} ## فایل ها */usr/local/etc/zabbix\_agent2.conf* محل پیش‌فرض فایل پیکربندی عامل Zabbix 2 (در صورت عدم تغییر در طول زمان کامپایل). [ ]{#lbAH} ## FILES */usr/local/etc/zabbix\_proxy.conf* Default location of Zabbix proxy configuration file (if not modified during compile time). [ ]{#lbAI} ## فایل ها */usr/local/etc/zabbix\_agent2.conf* محل پیش‌فرض فایل پیکربندی عامل Zabbix 2 (در صورت عدم تغییر در طول زمان کامپایل). [ ]{#lbAH} ## FILES */usr/local/etc/zabbix\_server.conf* Default location of Zabbix server configuration file (if not modified during compile time). [ ]{#lbAI} ## فایل ها */usr/local/etc/zabbix\_server.conf* محل پیش‌فرض فایل پیکربندی سرور Zabbix (در صورت عدم تغییر در طول زمان کامپایل). [ ]{#lbAI} ## FILES */usr/local/etc/zabbix\_web\_service.conf* Default location of Zabbix web service configuration file (if not modified during compile time). [ ]{#lbAG} ## فایل ها */usr/local/etc/zabbix\_web\_service.conf* محل پیش‌فرض فایل پیکربندی وب سرویس Zabbix (اگر نه در طول زمان کامپایل اصلاح شد). [ ]{#lbAG} ### Float history The float history object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |clock|timestamp|Time when that value was received.| |itemid|string|ID of the related item.| |ns|integer|Nanoseconds when the value was received.| |value|float|Received value.| ### تاریخچه Float The float history object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |clock|timestamp|Time when that value was received.| |itemid|string|ID of the related item.| |ns|integer|Nanoseconds when the value was received.| |value|float|Received value.| ##### Footnotes ^**1**^ For string values, only the string will be exported (e.g. "EMAIL") without the numbering used in this table. The numbers for range values (corresponding to the API values) in this table is used for ordering only. ##### پانویسها و منابع ^**1**^ برای مقادیر رشته، فقط رشته صادر خواهد شد (به عنوان مثال. "ZABBIX\_ACTIVE") بدون شماره گذاری استفاده شده در این جدول. شماره برای مقادیر محدوده (مرتبط با مقادیر API) در این جدول استفاده شده است فقط برای سفارش ##### Footnotes ^**1**^ For string values, only the string will be exported (e.g. "ZABBIX\_ACTIVE") without the numbering used in this table. The numbers for range values (corresponding to the API values) in this table is used for ordering only. ##### پانویسها و منابع ^**1**^ برای مقادیر رشته، فقط رشته صادر خواهد شد (به عنوان مثال. "ZABBIX\_ACTIVE") بدون شماره گذاری استفاده شده در این جدول. شماره برای مقادیر محدوده (مرتبط با مقادیر API) در این جدول استفاده شده است فقط برای سفارش ##### Footnotes ^**1**^ For string values, only the string will be exported (e.g. "ZABBIX\_ACTIVE") without the numbering used in this table. The numbers for range values (corresponding to the API values) in this table is used for ordering only. ##### پانویسها و منابع ^**1**^ برای مقادیر رشته، فقط رشته صادر خواهد شد (به عنوان مثال. "ZABBIX\_ACTIVE") بدون شماره گذاری استفاده شده در این جدول. شماره برای مقادیر محدوده (مرتبط با مقادیر API) در این جدول استفاده شده است فقط برای سفارش # graph.create ساخت گراف # graph.delete # حذف گراف # graph.get #دریافت گراف # graphitem.get # دریافت آیتم های گراف # > Graph item object The following objects are directly related to the `graphitem` API. # > آبجکت های آیتم گراف The following objects are directly related to the `graphitem` API. # Graph item This class is designed to work with graph items. Object references:\ - [Graph item](/manual/api/reference/graphitem/object#graph_item) Available methods:\ - [graphitem.get](/manual/api/reference/graphitem/get) - retrieving graph items # آیتم گراف This class is designed to work with graph items. Object references:\ - [Graph item](/manual/api/reference/graphitem/object#graph_item) Available methods:\ - [graphitem.get](/manual/api/reference/graphitem/get) - retrieving graph items # > Graph object The following objects are directly related to the `graph` API. # > آبجکت گراف The following objects are directly related to the `graph` API. # graphprototype.create # ساخت نمونه گراف # graphprototype.delete # حذف نمونه اولیه گراف # graphprototype.get # دریافت نمونه اولیه گراف # > Graph prototype object The following objects are directly related to the `graphprototype` API. # > آبجکت نمونه اولیه گراف The following objects are directly related to the `graphprototype` API. # Graph prototype This class is designed to work with graph prototypes. Object references:\ - [Graph prototype](/manual/api/reference/graphprototype/object#graph_prototype) Available methods:\ - [graphprototype.create](/manual/api/reference/graphprototype/create) - creating new graph prototypes - [graphprototype.delete](/manual/api/reference/graphprototype/delete) - deleting graph prototypes - [graphprototype.get](/manual/api/reference/graphprototype/get) - retrieving graph prototypes - [graphprototype.update](/manual/api/reference/graphprototype/update) - updating graph prototypes # نمونه اولیه گراف This class is designed to work with graph prototypes. Object references:\ - [Graph prototype](/manual/api/reference/graphprototype/object#graph_prototype) Available methods:\ - [graphprototype.create](/manual/api/reference/graphprototype/create) - creating new graph prototypes - [graphprototype.delete](/manual/api/reference/graphprototype/delete) - deleting graph prototypes - [graphprototype.get](/manual/api/reference/graphprototype/get) - retrieving graph prototypes - [graphprototype.update](/manual/api/reference/graphprototype/update) - updating graph prototypes # graphprototype.update # آپدیت نمونه اولیه گراف # Graph This class is designed to work with graphs. Object references:\ - [Graph](/manual/api/reference/graph/object#graph) Available methods:\ - [graph.create](/manual/api/reference/graph/create) - creating new graphs - [graph.delete](/manual/api/reference/graph/delete) - deleting graphs - [graph.get](/manual/api/reference/graph/get) - retrieving graphs - [graph.update](/manual/api/reference/graph/update) - updating graphs # نمونه اولیه گراف This class is designed to work with graph prototypes. Object references:\ - [Graph prototype](/manual/api/reference/graphprototype/object#graph_prototype) Available methods:\ - [graphprototype.create](/manual/api/reference/graphprototype/create) - creating new graph prototypes - [graphprototype.delete](/manual/api/reference/graphprototype/delete) - deleting graph prototypes - [graphprototype.get](/manual/api/reference/graphprototype/get) - retrieving graph prototypes - [graphprototype.update](/manual/api/reference/graphprototype/update) - updating graph prototypes # graph.update # آپدیت گراف # hanode.get # دریافت نود HA ##### Hidden menu Even when the menu is hidden completely, a full menu is just one mouse click away, by clicking on the burger icon. Note that it reappears over page content; to move page content to the right you have to unhide the menu by clicking on the show sidebar button. ##### Hidden menu Even when the menu is hidden completely, a full menu is just one mouse click away, by clicking on the burger icon. Note that it reappears over page content; to move page content to the right you have to unhide the menu by clicking on the show sidebar button. # > High availability node object The following object is related to operating a High availability cluster of Zabbix servers. # > آبجکت نود HA The following object is related to operating a High availability cluster of Zabbix servers. # High availability node This class is designed to work with server nodes that are part of a High availability cluster, or a standalone server instance. Object references:\ - [High availability node](/manual/api/reference/hanode/object#hanode) Available methods:\ - [hanode.get](/manual/api/reference/hanode/get) - retrieving nodes # نود HA This class is designed to work with server nodes that are part of a High availability cluster, or a standalone server instance. Object references:\ - [High availability node](/manual/api/reference/hanode/object#hanode) Available methods:\ - [hanode.get](/manual/api/reference/hanode/get) - retrieving nodes # history.clear #پاک کردن تاریخچه # history.get # گرفتن تاریخچه # > History object The following objects are directly related to the `history` API. ::: noteclassic History objects differ depending on the item's type of information. They are created by the Zabbix server and cannot be modified via the API. ::: # > آبجکت تاریخچه The following objects are directly related to the `history` API. ::: noteclassic History objects differ depending on the item's type of information. They are created by the Zabbix server and cannot be modified via the API. ::: # History This class is designed to work with history data. Object references:\ - [History](/manual/api/reference/history/object#history) Available methods:\ - [history.get](/manual/api/reference/history/get) - retrieving history data. #تاریخچه This class is designed to work with history data. Object references:\ - [History](/manual/api/reference/history/object#history) Available methods:\ - [history.get](/manual/api/reference/history/get) - retrieving history data. # host.create # ساخت هاست # host.delete #حذف هاست # host.get # دریافت هاست ##### Host graph tags |Element|Element property|Required|Type|Range^**[1](#footnotes)**^|Description| |--|--|-|--|----|--------| |graphs| |\-| | |Root element for graphs.| | |name|x|`string`| |Graph name.| | |width|\-|`integer`|20-65535 (default: 900)|Graph width, in pixels. Used for preview and for pie/exploded graphs.| | |height|\-|`integer`|20-65535 (default: 200)|Graph height, in pixels. Used for preview and for pie/exploded graphs.| | |yaxismin|\-|`double`|Default: 0|Value of Y axis minimum.<br><br>Used if 'ymin\_type\_1' is FIXED.| | |yaxismax|\-|`double`|Default: 0|Value of Y axis maximum.<br><br>Used if 'ymax\_type\_1' is FIXED.| | |show\_work\_period|\-|`string`|0 - NO<br>1 - YES (default)|Highlight non-working hours.<br><br>Used by normal and stacked graphs.| | |show\_triggers|\-|`string`|0 - NO<br>1 - YES (default)|Display simple trigger values as a line.<br><br>Used by normal and stacked graphs.| | |type|\-|`string`|0 - NORMAL (default)<br>1 - STACKED<br>2 - PIE<br>3 - EXPLODED|Graph type.| | |show\_legend|\-|`string`|0 - NO<br>1 - YES (default)|Display graph legend.| | |show\_3d|\-|`string`|0 - NO (default)<br>1 - YES|Enable 3D style.<br><br>Used by pie and exploded pie graphs.| | |percent\_left|\-|`double`|Default:0|Show the percentile line for left axis.<br><br>Used only for normal graphs.| | |percent\_right|\-|`double`|Default:0|Show the percentile line for right axis.<br><br>Used only for normal graphs.| | |ymin\_type\_1|\-|`string`|0 - CALCULATED (default)<br>1 - FIXED<br>2 - ITEM|Minimum value of Y axis.<br><br>Used by normal and stacked graphs.| | |ymax\_type\_1|\-|`string`|0 - CALCULATED (default)<br>1 - FIXED<br>2 - ITEM|Maximum value of Y axis.<br><br>Used by normal and stacked graphs.| |ymin\_item\_1| |\-| | |Individual item details.<br><br>Required if 'ymin\_type\_1' is ITEM.| | |host|x|`string`| |Item host.| | |key|x|`string`| |Item key.| |ymax\_item\_1| |\-| | |Individual item details.<br><br>Required if 'ymax\_type\_1' is ITEM.| | |host|x|`string`| |Item host.| | |key|x|`string`| |Item key.| |graph\_items| |x| | |Root element for graph items.| | |sortorder|\-|`integer`| |Draw order. The smaller value is drawn first. Can be used to draw lines or regions behind (or in front of) another.| | |drawtype|\-|`string`|0 - SINGLE\_LINE (default)<br>1 - FILLED\_REGION<br>2 - BOLD\_LINE<br>3 - DOTTED\_LINE<br>4 - DASHED\_LINE<br>5 - GRADIENT\_LINE|Draw style of the graph item.<br><br>Used only by normal graphs.| | |color|\-|`string`| |Element color (6 symbols, hex).| | |yaxisside|\-|`string`|0 - LEFT (default)<br>1 - RIGHT|Side of the graph where the graph item's Y scale will be drawn.<br><br>Used by normal and stacked graphs.| | |calc\_fnc|\-|`string`|1 - MIN<br>2 - AVG (default)<br>4 - MAX<br>7 - ALL (minimum, average and maximum; used only by simple graphs)<br>9 - LAST (used only by pie and exploded pie graphs)|Data to draw if more than one value exists for an item.| | |type|\-|`string`|0 - SIMPLE (default)<br>2 - GRAPH\_SUM (value of the item represents the whole pie; used only by pie and exploded pie graphs)|Graph item type.| |item| |x| | |Individual item.| | |host|x|`string`| |Item host.| | |key|x|`string`| |Item key.| ##### تگ های گراف هاست ها |Element|Element property|Required|Type|Range^**[1](#footnotes)**^|Description| |--|--|-|--|----|--------| |graphs| |\-| | |Root element for graphs.| | |name|x|`string`| |Graph name.| | |width|\-|`integer`|20-65535 (default: 900)|Graph width, in pixels. Used for preview and for pie/exploded graphs.| | |height|\-|`integer`|20-65535 (default: 200)|Graph height, in pixels. Used for preview and for pie/exploded graphs.| | |yaxismin|\-|`double`|Default: 0|Value of Y axis minimum.<br><br>Used if 'ymin\_type\_1' is FIXED.| | |yaxismax|\-|`double`|Default: 0|Value of Y axis maximum.<br><br>Used if 'ymax\_type\_1' is FIXED.| | |show\_work\_period|\-|`string`|0 - NO<br>1 - YES (default)|Highlight non-working hours.<br><br>Used by normal and stacked graphs.| | |show\_triggers|\-|`string`|0 - NO<br>1 - YES (default)|Display simple trigger values as a line.<br><br>Used by normal and stacked graphs.| | |type|\-|`string`|0 - NORMAL (default)<br>1 - STACKED<br>2 - PIE<br>3 - EXPLODED|Graph type.| | |show\_legend|\-|`string`|0 - NO<br>1 - YES (default)|Display graph legend.| | |show\_3d|\-|`string`|0 - NO (default)<br>1 - YES|Enable 3D style.<br><br>Used by pie and exploded pie graphs.| | |percent\_left|\-|`double`|Default:0|Show the percentile line for left axis.<br><br>Used only for normal graphs.| | |percent\_right|\-|`double`|Default:0|Show the percentile line for right axis.<br><br>Used only for normal graphs.| | |ymin\_type\_1|\-|`string`|0 - CALCULATED (default)<br>1 - FIXED<br>2 - ITEM|Minimum value of Y axis.<br><br>Used by normal and stacked graphs.| | |ymax\_type\_1|\-|`string`|0 - CALCULATED (default)<br>1 - FIXED<br>2 - ITEM|Maximum value of Y axis.<br><br>Used by normal and stacked graphs.| |ymin\_item\_1| |\-| | |Individual item details.<br><br>Required if 'ymin\_type\_1' is ITEM.| | |host|x|`string`| |Item host.| | |key|x|`string`| |Item key.| |ymax\_item\_1| |\-| | |Individual item details.<br><br>Required if 'ymax\_type\_1' is ITEM.| | |host|x|`string`| |Item host.| | |key|x|`string`| |Item key.| |graph\_items| |x| | |Root element for graph items.| | |sortorder|\-|`integer`| |Draw order. The smaller value is drawn first. Can be used to draw lines or regions behind (or in front of) another.| | |drawtype|\-|`string`|0 - SINGLE\_LINE (default)<br>1 - FILLED\_REGION<br>2 - BOLD\_LINE<br>3 - DOTTED\_LINE<br>4 - DASHED\_LINE<br>5 - GRADIENT\_LINE|Draw style of the graph item.<br><br>Used only by normal graphs.| | |color|\-|`string`| |Element color (6 symbols, hex).| | |yaxisside|\-|`string`|0 - LEFT (default)<br>1 - RIGHT|Side of the graph where the graph item's Y scale will be drawn.<br><br>Used by normal and stacked graphs.| | |calc\_fnc|\-|`string`|1 - MIN<br>2 - AVG (default)<br>4 - MAX<br>7 - ALL (minimum, average and maximum; used only by simple graphs)<br>9 - LAST (used only by pie and exploded pie graphs)|Data to draw if more than one value exists for an item.| | |type|\-|`string`|0 - SIMPLE (default)<br>2 - GRAPH\_SUM (value of the item represents the whole pie; used only by pie and exploded pie graphs)|Graph item type.| |item| |x| | |Individual item.| | |host|x|`string`| |Item host.| | |key|x|`string`| |Item key.| # hostgroup.create # ساخت گروه هاست # hostgroup.delete # حذف گروه هاست # hostgroup.get # دریافت گروه هاستی # hostgroup.massadd # اضافه کردن گروهی هاست ها # hostgroup.massremove # حذف گروهی هاست ها # hostgroup.massupdate # به روز رسانی گروهی هاست ها # > Host group object The following objects are directly related to the `hostgroup` API. # > آیجکت گروه هاستی The following objects are directly related to the `hostgroup` API. # hostgroup.update # به روز رسانی گروه هاستی # hostinterface.create # ساخت اینترفیس هاست # hostinterface.delete # حذف اینترفیس هاست # hostinterface.get # دریافت اینترفیس هاست # hostinterface.massadd # اضافه کردن گروهی اینترفیس های هاست # hostinterface.massremove # حذف گروهی اینترفیس های هاست # > Host interface object The following objects are directly related to the `hostinterface` API. # >آبجکت های اینترفیس هاست The following objects are directly related to the `hostinterface` API. # hostinterface.replacehostinterfaces # جایگزینی اینترفیس های هاست # Host interface This class is designed to work with host interfaces. Object references:\ - [Host interface](/manual/api/reference/hostinterface/object#host_interface) Available methods:\ - [hostinterface.create](/manual/api/reference/hostinterface/create) - creating new host interfaces - [hostinterface.delete](/manual/api/reference/hostinterface/delete) - deleting host interfaces - [hostinterface.get](/manual/api/reference/hostinterface/get) - retrieving host interfaces - [hostinterface.massadd](/manual/api/reference/hostinterface/massadd) - adding host interfaces to hosts - [hostinterface.massremove](/manual/api/reference/hostinterface/massremove) - removing host interfaces from hosts - [hostinterface.replacehostinterfaces](/manual/api/reference/hostinterface/replacehostinterfaces) - replacing host interfaces on a host - [hostinterface.update](/manual/api/reference/hostinterface/update) - updating host interfaces # اینترفیس هاست This class is designed to work with host interfaces. Object references:\ - [Host interface](/manual/api/reference/hostinterface/object#host_interface) Available methods:\ - [hostinterface.create](/manual/api/reference/hostinterface/create) - creating new host interfaces - [hostinterface.delete](/manual/api/reference/hostinterface/delete) - deleting host interfaces - [hostinterface.get](/manual/api/reference/hostinterface/get) - retrieving host interfaces - [hostinterface.massadd](/manual/api/reference/hostinterface/massadd) - adding host interfaces to hosts - [hostinterface.massremove](/manual/api/reference/hostinterface/massremove) - removing host interfaces from hosts - [hostinterface.replacehostinterfaces](/manual/api/reference/hostinterface/replacehostinterfaces) - replacing host interfaces on a host - [hostinterface.update](/manual/api/reference/hostinterface/update) - updating host interfaces # hostinterface.update # به روز رسانی اینترفیس هاست ها ### Host inventory The host inventory object has the following properties. ::: notetip Each property has it's own unique ID number, which is used to associate host inventory fields with items. ::: |ID|Property|[Type](/manual/api/reference_commentary#data_types)|Description|Maximum length| |-|--|-|-----|-----| |4|alias|string|Alias.|128 characters| |11|asset\_tag|string|Asset tag.|64 characters| |28|chassis|string|Chassis.|64 characters| |23|contact|string|Contact person.|Depends on the database used:<br>- 65535 characters for SQL databases<br>- 2048 characters for Oracle databases| |32|contract\_number|string|Contract number.|64 characters| |47|date\_hw\_decomm|string|HW decommissioning date.|64 characters| |46|date\_hw\_expiry|string|HW maintenance expiry date.|64 characters| |45|date\_hw\_install|string|HW installation date.|64 characters| |44|date\_hw\_purchase|string|HW purchase date.|64 characters| |34|deployment\_status|string|Deployment status.|64 characters| |14|hardware|string|Hardware.|255 characters| |15|hardware\_full|string|Detailed hardware.|Depends on the database used:<br>- 65535 characters for SQL databases<br>- 2048 characters for Oracle databases| |39|host\_netmask|string|Host subnet mask.|39 characters| |38|host\_networks|string|Host networks.|Depends on the database used:<br>- 65535 characters for SQL databases<br>- 2048 characters for Oracle databases| |40|host\_router|string|Host router.|39 characters| |30|hw\_arch|string|HW architecture.|32 characters| |33|installer\_name|string|Installer name.|64 characters| |24|location|string|Location.|Depends on the database used:<br>- 65535 characters for SQL databases<br>- 2048 characters for Oracle databases| |25|location\_lat|string|Location latitude.|16 characters| |26|location\_lon|string|Location longitude.|16 characters| |12|macaddress\_a|string|MAC address A.|64 characters| |13|macaddress\_b|string|MAC address B.|64 characters| |29|model|string|Model.|64 characters| |3|name|string|Name.|128 characters| |27|notes|string|Notes.|Depends on the database used:<br>- 65535 characters for SQL databases<br>- 2048 characters for Oracle databases| |41|oob\_ip|string|OOB IP address.|39 characters| |42|oob\_netmask|string|OOB host subnet mask.|39 characters| |43|oob\_router|string|OOB router.|39 characters| |5|os|string|OS name.|128 characters| |6|os\_full|string|Detailed OS name.|255 characters| |7|os\_short|string|Short OS name.|128 characters| |61|poc\_1\_cell|string|Primary POC mobile number.|64 characters| |58|poc\_1\_email|string|Primary email.|128 characters| |57|poc\_1\_name|string|Primary POC name.|128 characters| |63|poc\_1\_notes|string|Primary POC notes.|Depends on the database used:<br>- 65535 characters for SQL databases<br>- 2048 characters for Oracle databases| |59|poc\_1\_phone\_a|string|Primary POC phone A.|64 characters| |60|poc\_1\_phone\_b|string|Primary POC phone B.|64 characters| |62|poc\_1\_screen|string|Primary POC screen name.|64 characters| |68|poc\_2\_cell|string|Secondary POC mobile number.|64 characters| |65|poc\_2\_email|string|Secondary POC email.|128 characters| |64|poc\_2\_name|string|Secondary POC name.|128 characters| |70|poc\_2\_notes|string|Secondary POC notes.|Depends on the database used:<br>- 65535 characters for SQL databases<br>- 2048 characters for Oracle databases| |66|poc\_2\_phone\_a|string|Secondary POC phone A.|64 characters| |67|poc\_2\_phone\_b|string|Secondary POC phone B.|64 characters| |69|poc\_2\_screen|string|Secondary POC screen name.|64 characters| |8|serialno\_a|string|Serial number A.|64 characters| |9|serialno\_b|string|Serial number B.|64 characters| |48|site\_address\_a|string|Site address A.|128 characters| |49|site\_address\_b|string|Site address B.|128 characters| |50|site\_address\_c|string|Site address C.|128 characters| |51|site\_city|string|Site city.|128 characters| |53|site\_country|string|Site country.|64 characters| |56|site\_notes|string|Site notes.|Depends on the database used:<br>- 65535 characters for SQL databases<br>- 2048 characters for Oracle databases| |55|site\_rack|string|Site rack location.|128 characters| |52|site\_state|string|Site state.|64 characters| |54|site\_zip|string|Site ZIP/postal code.|64 characters| |16|software|string|Software.|255 characters| |18|software\_app\_a|string|Software application A.|64 characters| |19|software\_app\_b|string|Software application B.|64 characters| |20|software\_app\_c|string|Software application C.|64 characters| |21|software\_app\_d|string|Software application D.|64 characters| |22|software\_app\_e|string|Software application E.|64 characters| |17|software\_full|string|Software details.|Depends on the database used:<br>- 65535 characters for SQL databases<br>- 2048 characters for Oracle databases| |10|tag|string|Tag.|64 characters| |1|type|string|Type.|64 characters| |2|type\_full|string|Type details.|64 characters| |35|url\_a|string|URL A.|255 characters| |36|url\_b|string|URL B.|255 characters| |37|url\_c|string|URL C.|255 characters| |31|vendor|string|Vendor.|64 characters| ### جست و جو هاست The host inventory object has the following properties. ::: notetip Each property has it's own unique ID number, which is used to associate host inventory fields with items. ::: |ID|Property|[Type](/manual/api/reference_commentary#data_types)|Description|Maximum length| |-|--|-|-----|-----| |4|alias|string|Alias.|128 characters| |11|asset\_tag|string|Asset tag.|64 characters| |28|chassis|string|Chassis.|64 characters| |23|contact|string|Contact person.|Depends on the database used:<br>- 65535 characters for SQL databases<br>- 2048 characters for Oracle databases| |32|contract\_number|string|Contract number.|64 characters| |47|date\_hw\_decomm|string|HW decommissioning date.|64 characters| |46|date\_hw\_expiry|string|HW maintenance expiry date.|64 characters| |45|date\_hw\_install|string|HW installation date.|64 characters| |44|date\_hw\_purchase|string|HW purchase date.|64 characters| |34|deployment\_status|string|Deployment status.|64 characters| |14|hardware|string|Hardware.|255 characters| |15|hardware\_full|string|Detailed hardware.|Depends on the database used:<br>- 65535 characters for SQL databases<br>- 2048 characters for Oracle databases| |39|host\_netmask|string|Host subnet mask.|39 characters| |38|host\_networks|string|Host networks.|Depends on the database used:<br>- 65535 characters for SQL databases<br>- 2048 characters for Oracle databases| |40|host\_router|string|Host router.|39 characters| |30|hw\_arch|string|HW architecture.|32 characters| |33|installer\_name|string|Installer name.|64 characters| |24|location|string|Location.|Depends on the database used:<br>- 65535 characters for SQL databases<br>- 2048 characters for Oracle databases| |25|location\_lat|string|Location latitude.|16 characters| |26|location\_lon|string|Location longitude.|16 characters| |12|macaddress\_a|string|MAC address A.|64 characters| |13|macaddress\_b|string|MAC address B.|64 characters| |29|model|string|Model.|64 characters| |3|name|string|Name.|128 characters| |27|notes|string|Notes.|Depends on the database used:<br>- 65535 characters for SQL databases<br>- 2048 characters for Oracle databases| |41|oob\_ip|string|OOB IP address.|39 characters| |42|oob\_netmask|string|OOB host subnet mask.|39 characters| |43|oob\_router|string|OOB router.|39 characters| |5|os|string|OS name.|128 characters| |6|os\_full|string|Detailed OS name.|255 characters| |7|os\_short|string|Short OS name.|128 characters| |61|poc\_1\_cell|string|Primary POC mobile number.|64 characters| |58|poc\_1\_email|string|Primary email.|128 characters| |57|poc\_1\_name|string|Primary POC name.|128 characters| |63|poc\_1\_notes|string|Primary POC notes.|Depends on the database used:<br>- 65535 characters for SQL databases<br>- 2048 characters for Oracle databases| |59|poc\_1\_phone\_a|string|Primary POC phone A.|64 characters| |60|poc\_1\_phone\_b|string|Primary POC phone B.|64 characters| |62|poc\_1\_screen|string|Primary POC screen name.|64 characters| |68|poc\_2\_cell|string|Secondary POC mobile number.|64 characters| |65|poc\_2\_email|string|Secondary POC email.|128 characters| |64|poc\_2\_name|string|Secondary POC name.|128 characters| |70|poc\_2\_notes|string|Secondary POC notes.|Depends on the database used:<br>- 65535 characters for SQL databases<br>- 2048 characters for Oracle databases| |66|poc\_2\_phone\_a|string|Secondary POC phone A.|64 characters| |67|poc\_2\_phone\_b|string|Secondary POC phone B.|64 characters| |69|poc\_2\_screen|string|Secondary POC screen name.|64 characters| |8|serialno\_a|string|Serial number A.|64 characters| |9|serialno\_b|string|Serial number B.|64 characters| |48|site\_address\_a|string|Site address A.|128 characters| |49|site\_address\_b|string|Site address B.|128 characters| |50|site\_address\_c|string|Site address C.|128 characters| |51|site\_city|string|Site city.|128 characters| |53|site\_country|string|Site country.|64 characters| |56|site\_notes|string|Site notes.|Depends on the database used:<br>- 65535 characters for SQL databases<br>- 2048 characters for Oracle databases| |55|site\_rack|string|Site rack location.|128 characters| |52|site\_state|string|Site state.|64 characters| |54|site\_zip|string|Site ZIP/postal code.|64 characters| |16|software|string|Software.|255 characters| |18|software\_app\_a|string|Software application A.|64 characters| |19|software\_app\_b|string|Software application B.|64 characters| |20|software\_app\_c|string|Software application C.|64 characters| |21|software\_app\_d|string|Software application D.|64 characters| |22|software\_app\_e|string|Software application E.|64 characters| |17|software\_full|string|Software details.|Depends on the database used:<br>- 65535 characters for SQL databases<br>- 2048 characters for Oracle databases| |10|tag|string|Tag.|64 characters| |1|type|string|Type.|64 characters| |2|type\_full|string|Type details.|64 characters| |35|url\_a|string|URL A.|255 characters| |36|url\_b|string|URL B.|255 characters| |37|url\_c|string|URL C.|255 characters| |31|vendor|string|Vendor.|64 characters| ##### Host low-level discovery rule tags |Element|Element property|Required|Type|Range^**[1](#footnotes)**^|Description| |--|--|-|--|----|--------| |discovery\_rules| |\-| | |Root element for low-level discovery rules.| | |*For most of the element tag values, see element tag values for a regular item. Only the tags that are specific to low-level discovery rules, are described below.*| | | | | | |type|\-|`string`|0 - ZABBIX\_PASSIVE (default)<br>2 - TRAP<br>3 - SIMPLE<br>5 - INTERNAL<br>7 - ZABBIX\_ACTIVE<br>10 - EXTERNAL<br>11 - ODBC<br>12 - IPMI<br>13 - SSH<br>14 - TELNET<br>16 - JMX<br>18 - DEPENDENT<br>19 - HTTP\_AGENT<br>20 - SNMP\_AGENT|Item type.| | |lifetime|\-|`string`|Default: 30d|Time period after which items that are no longer discovered will be deleted. Seconds, time unit with suffix or user macro.| |filter| | | | |Individual filter.| | |evaltype|\-|`string`|0 - AND\_OR (default)<br>1 - AND<br>2 - OR<br>3 - FORMULA|Logic to use for checking low-level discovery rule filter conditions.| | |formula|\-|`string`| |Custom calculation formula for filter conditions.| |conditions| |\-| | |Root element for filter conditions.| | |macro|x|`string`| |Low-level discovery macro name.| | |value|\-|`string`| |Filter value: regular expression or global regular expression.| | |operator|\-|`string`|8 - MATCHES\_REGEX (default)<br>9 - NOT\_MATCHES\_REGEX|Condition operator.| | |formulaid|x|`character`| |Arbitrary unique ID that is used to reference a condition from the custom expression. Can only contain capital-case letters. The ID must be defined by the user when modifying filter conditions, but will be generated anew when requesting them afterward.| |lld\_macro\_paths| |\-| | |Root element for LLD macro paths.| | |lld\_macro|x|`string`| |Low-level discovery macro name.| | |path|x|`string`| |Selector for value which will be assigned to the corresponding macro.| |preprocessing| |\-| | |LLD rule value preprocessing.| |step| |\-| | |Individual LLD rule value preprocessing step.| | |*For most of the element tag values, see element tag values for a host item value preprocessing. Only the tags that are specific to low-level discovery value preprocessing, are described below.*| | | | | | |type|x|`string`|5 - REGEX<br>11 - XMLPATH<br>12 - JSONPATH<br>15 - NOT\_MATCHES\_REGEX<br>16 - CHECK\_JSON\_ERROR<br>17 - CHECK\_XML\_ERROR<br>20 - DISCARD\_UNCHANGED\_HEARTBEAT<br>21 - JAVASCRIPT<br>23 - PROMETHEUS\_TO\_JSON<br>24 - CSV\_TO\_JSON<br>25 - STR\_REPLACE<br>27 - XML\_TO\_JSON|Type of the item value preprocessing step.| |trigger\_prototypes| |\-| | |Root element for trigger prototypes.| | |*For trigger prototype element tag values, see regular [host trigger](/manual/xml_export_import/hosts#host_trigger_tags) tags.*| | | | | |graph\_prototypes| |\-| | |Root element for graph prototypes.| | |*For graph prototype element tag values, see regular [host graph](/manual/xml_export_import/hosts#host_graph_tags) tags.*| | | | | |host\_prototypes| |\-| | |Root element for host prototypes.| | |*For host prototype element tag values, see regular [host](/manual/xml_export_import/hosts#host_tags) tags.*| | | | | |item\_prototypes| |\-| | |Root element for item prototypes.| | |*For item prototype element tag values, see regular [host item](/manual/xml_export_import/hosts#host_item_tags) tags.*| | | | | |master\_item| |\-| | |Individual item prototype master item/item prototype data.| | |key|x|`string`| |Dependent item prototype master item/item prototype key value.<br><br>Required for a dependent item.| ##### تگ های قوانین LLD هاست ها |Element|Element property|Required|Type|Range^**[1](#footnotes)**^|Description| |--|--|-|--|----|--------| |discovery\_rules| |\-| | |Root element for low-level discovery rules.| | |*For most of the element tag values, see element tag values for a regular item. Only the tags that are specific to low-level discovery rules, are described below.*| | | | | | |type|\-|`string`|0 - ZABBIX\_PASSIVE (default)<br>2 - TRAP<br>3 - SIMPLE<br>5 - INTERNAL<br>7 - ZABBIX\_ACTIVE<br>10 - EXTERNAL<br>11 - ODBC<br>12 - IPMI<br>13 - SSH<br>14 - TELNET<br>16 - JMX<br>18 - DEPENDENT<br>19 - HTTP\_AGENT<br>20 - SNMP\_AGENT|Item type.| | |lifetime|\-|`string`|Default: 30d|Time period after which items that are no longer discovered will be deleted. Seconds, time unit with suffix or user macro.| |filter| | | | |Individual filter.| | |evaltype|\-|`string`|0 - AND\_OR (default)<br>1 - AND<br>2 - OR<br>3 - FORMULA|Logic to use for checking low-level discovery rule filter conditions.| | |formula|\-|`string`| |Custom calculation formula for filter conditions.| |conditions| |\-| | |Root element for filter conditions.| | |macro|x|`string`| |Low-level discovery macro name.| | |value|\-|`string`| |Filter value: regular expression or global regular expression.| | |operator|\-|`string`|8 - MATCHES\_REGEX (default)<br>9 - NOT\_MATCHES\_REGEX|Condition operator.| | |formulaid|x|`character`| |Arbitrary unique ID that is used to reference a condition from the custom expression. Can only contain capital-case letters. The ID must be defined by the user when modifying filter conditions, but will be generated anew when requesting them afterward.| |lld\_macro\_paths| |\-| | |Root element for LLD macro paths.| | |lld\_macro|x|`string`| |Low-level discovery macro name.| | |path|x|`string`| |Selector for value which will be assigned to the corresponding macro.| |preprocessing| |\-| | |LLD rule value preprocessing.| |step| |\-| | |Individual LLD rule value preprocessing step.| | |*For most of the element tag values, see element tag values for a host item value preprocessing. Only the tags that are specific to low-level discovery value preprocessing, are described below.*| | | | | | |type|x|`string`|5 - REGEX<br>11 - XMLPATH<br>12 - JSONPATH<br>15 - NOT\_MATCHES\_REGEX<br>16 - CHECK\_JSON\_ERROR<br>17 - CHECK\_XML\_ERROR<br>20 - DISCARD\_UNCHANGED\_HEARTBEAT<br>21 - JAVASCRIPT<br>23 - PROMETHEUS\_TO\_JSON<br>24 - CSV\_TO\_JSON<br>25 - STR\_REPLACE<br>27 - XML\_TO\_JSON|Type of the item value preprocessing step.| |trigger\_prototypes| |\-| | |Root element for trigger prototypes.| | |*For trigger prototype element tag values, see regular [host trigger](/manual/xml_export_import/hosts#host_trigger_tags) tags.*| | | | | |graph\_prototypes| |\-| | |Root element for graph prototypes.| | |*For graph prototype element tag values, see regular [host graph](/manual/xml_export_import/hosts#host_graph_tags) tags.*| | | | | |host\_prototypes| |\-| | |Root element for host prototypes.| | |*For host prototype element tag values, see regular [host](/manual/xml_export_import/hosts#host_tags) tags.*| | | | | |item\_prototypes| |\-| | |Root element for item prototypes.| | |*For item prototype element tag values, see regular [host item](/manual/xml_export_import/hosts#host_item_tags) tags.*| | | | | |master\_item| |\-| | |Individual item prototype master item/item prototype data.| | |key|x|`string`| |Dependent item prototype master item/item prototype key value.<br><br>Required for a dependent item.| # host.massadd # اضافه کردن گروهی هاست ها # host.massremove # حذف گروهی هاست ها # host.massupdate # آپدیت گروهی هاست ها # > Host object The following objects are directly related to the host API. # > آبجکت هاست The following objects are directly related to the host API. # hostprototype.create # ساخت هاست نمونه # hostprototype.delete #حذف نمونه اولیه هاست # hostprototype.get # دریافت نمونه اولیه هاست # > Host prototype object The following objects are directly related to the `hostprototype` API. # > آبجکت نمونه اولیه هاست The following objects are directly related to the `hostprototype` API. # Host prototype This class is designed to work with host prototypes. Object references:\ - [Host prototype](/manual/api/reference/hostprototype/object#host_prototype) - [Host prototype inventory](/manual/api/reference/hostprototype/object#host_prototype_inventory) - [Group link](/manual/api/reference/hostprototype/object#group_link) - [Group prototype](/manual/api/reference/hostprototype/object#group_prototype) Available methods:\ - [hostprototype.create](/manual/api/reference/hostprototype/create) - creating new host prototypes - [hostprototype.delete](/manual/api/reference/hostprototype/delete) - deleting host prototypes - [hostprototype.get](/manual/api/reference/hostprototype/get) - retrieving host prototypes - [hostprototype.update](/manual/api/reference/hostprototype/update) - updating host prototypes # نمونه اولیه هاست This class is designed to work with host prototypes. Object references:\ - [Host prototype](/manual/api/reference/hostprototype/object#host_prototype) - [Host prototype inventory](/manual/api/reference/hostprototype/object#host_prototype_inventory) - [Group link](/manual/api/reference/hostprototype/object#group_link) - [Group prototype](/manual/api/reference/hostprototype/object#group_prototype) Available methods:\ - [hostprototype.create](/manual/api/reference/hostprototype/create) - creating new host prototypes - [hostprototype.delete](/manual/api/reference/hostprototype/delete) - deleting host prototypes - [hostprototype.get](/manual/api/reference/hostprototype/get) - retrieving host prototypes - [hostprototype.update](/manual/api/reference/hostprototype/update) - updating host prototypes # hostprototype.update # به روز رسانی نمونه اولیه هاست # Host This class is designed to work with hosts. Object references:\ - [Host](/manual/api/reference/host/object#host) - [Host inventory](/manual/api/reference/host/object#host_inventory) Available methods:\ - [host.create](/manual/api/reference/host/create) - creating new hosts - [host.delete](/manual/api/reference/host/delete) - deleting hosts - [host.get](/manual/api/reference/host/get) - retrieving hosts - [host.massadd](/manual/api/reference/host/massadd) - adding related objects to hosts - [host.massremove](/manual/api/reference/host/massremove) - removing related objects from hosts - [host.massupdate](/manual/api/reference/host/massupdate) - replacing or removing related objects from hosts - [host.update](/manual/api/reference/host/update) - updating hosts # هاست This class is designed to work with hosts. Object references:\ - [Host](/manual/api/reference/host/object#host) - [Host inventory](/manual/api/reference/host/object#host_inventory) Available methods:\ - [host.create](/manual/api/reference/host/create) - creating new hosts - [host.delete](/manual/api/reference/host/delete) - deleting hosts - [host.get](/manual/api/reference/host/get) - retrieving hosts - [host.massadd](/manual/api/reference/host/massadd) - adding related objects to hosts - [host.massremove](/manual/api/reference/host/massremove) - removing related objects from hosts - [host.massupdate](/manual/api/reference/host/massupdate) - replacing or removing related objects from hosts - [host.update](/manual/api/reference/host/update) - updating hosts # host.update # آپدیت هاست # housekeeping.get # دریافت اطلاعات ذخیره شده # > Housekeeping object The following objects are directly related to the `housekeeping` API. # > آبجکت نگهداری داده ها The following objects are directly related to the `housekeeping` API. # Housekeeping This class is designed to work with housekeeping. Object references:\ - [Housekeeping](/manual/api/reference/housekeeping/object#housekeeping) Available methods:\ - [housekeeping.get](/manual/api/reference/housekeeping/get) - retrieve housekeeping - [housekeeping.update](/manual/api/reference/housekeeping/update) - update housekeeping # ذخیره سازی This class is designed to work with housekeeping. Object references:\ - [Housekeeping](/manual/api/reference/housekeeping/object#housekeeping) Available methods:\ - [housekeeping.get](/manual/api/reference/housekeeping/get) - retrieve housekeeping - [housekeeping.update](/manual/api/reference/housekeeping/update) - update housekeeping # housekeeping.update # آپدیت ذخیره سازی داده # httptest.create # ساخت Http تست # httptest.delete # حذف Http تست # httptest.get # دریافت Http تست # httptest.update # به روز رسانی http # iconmap.create # ساخت آیکون مپ # iconmap.delete # حذف آیکون مپ # iconmap.get # دریافت آیکون مپ # > Icon map object The following objects are directly related to the `iconmap` API. # >آبجکت مپ ایکون The following objects are directly related to the `iconmap` API. # Icon map This class is designed to work with icon maps. Object references:\ - [Icon map](/manual/api/reference/iconmap/object#icon_map) - [Icon mapping](/manual/api/reference/iconmap/object#icon_mapping) Available methods:\ - [iconmap.create](/manual/api/reference/iconmap/create) - create new icon maps - [iconmap.delete](/manual/api/reference/iconmap/delete) - delete icon maps - [iconmap.get](/manual/api/reference/iconmap/get) - retrieve icon maps - [iconmap.update](/manual/api/reference/iconmap/update) - update icon maps # آیکون مپ This class is designed to work with icon maps. Object references:\ - [Icon map](/manual/api/reference/iconmap/object#icon_map) - [Icon mapping](/manual/api/reference/iconmap/object#icon_mapping) Available methods:\ - [iconmap.create](/manual/api/reference/iconmap/create) - create new icon maps - [iconmap.delete](/manual/api/reference/iconmap/delete) - delete icon maps - [iconmap.get](/manual/api/reference/iconmap/get) - retrieve icon maps - [iconmap.update](/manual/api/reference/iconmap/update) - update icon maps # iconmap.update #دکمه آپدیت نقشه # image.create #ساخت Image #### Installing locales To list all installed languages, run: locale -a If some languages that are needed are not listed, open the */etc/locale.gen* file and uncomment the required locales. Since Zabbix uses UTF-8 encoding, you need to select locales with UTF-8 charset. Now run: locale-gen Restart the web server. The locales should now be installed. It may be required to reload Zabbix frontend page in browser using Ctrl + F5 for new languages to appear. #### Installing locales To list all installed languages, run: locale -a If some languages that are needed are not listed, open the */etc/locale.gen* file and uncomment the required locales. Since Zabbix uses UTF-8 encoding, you need to select locales with UTF-8 charset. Now, run: locale-gen Restart the web server. The locales should now be installed. It may be required to reload Zabbix frontend page in browser using Ctrl + F5 for new languages to appear. ### Integer history The integer history object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |clock|timestamp|Time when that value was received.| |itemid|string|ID of the related item.| |ns|integer|Nanoseconds when the value was received.| |value|integer|Received value.| ### تاریخچه عدد صحیح The integer history object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |clock|timestamp|Time when that value was received.| |itemid|string|ID of the related item.| |ns|integer|Nanoseconds when the value was received.| |value|integer|Received value.| # > LLD rule object The following objects are directly related to the `discoveryrule` API. # > آبجکت قانون LLD The following objects are directly related to the `discoveryrule` API. # LLD rule This class is designed to work with low level discovery rules. Object references:\ - [LLD rule](/manual/api/reference/discoveryrule/object#lld_rule) Available methods:\ - [discoveryrule.copy](/manual/api/reference/discoveryrule/copy) - copying LLD rules - [discoveryrule.create](/manual/api/reference/discoveryrule/create) - creating new LLD rules - [discoveryrule.delete](/manual/api/reference/discoveryrule/delete) - deleting LLD rules - [discoveryrule.get](/manual/api/reference/discoveryrule/get) - retrieving LLD rules - [discoveryrule.update](/manual/api/reference/discoveryrule/update) - updating LLD rules # قانون LLD This class is designed to work with low level discovery rules. Object references:\ - [LLD rule](/manual/api/reference/discoveryrule/object#lld_rule) Available methods:\ - [discoveryrule.copy](/manual/api/reference/discoveryrule/copy) - copying LLD rules - [discoveryrule.create](/manual/api/reference/discoveryrule/create) - creating new LLD rules - [discoveryrule.delete](/manual/api/reference/discoveryrule/delete) - deleting LLD rules - [discoveryrule.get](/manual/api/reference/discoveryrule/get) - retrieving LLD rules - [discoveryrule.update](/manual/api/reference/discoveryrule/update) - updating LLD rules ### Log history The log history object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |id|string|ID of the history entry.| |clock|timestamp|Time when that value was received.| |itemid|string|ID of the related item.| |logeventid|integer|Windows event log entry ID.| |ns|integer|Nanoseconds when the value was received.| |severity|integer|Windows event log entry level.| |source|string|Windows event log entry source.| |timestamp|timestamp|Windows event log entry time.| |value|text|Received value.| ### تاریخچه لاگ The log history object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |id|string|ID of the history entry.| |clock|timestamp|Time when that value was received.| |itemid|string|ID of the related item.| |logeventid|integer|Windows event log entry ID.| |ns|integer|Nanoseconds when the value was received.| |severity|integer|Windows event log entry level.| |source|string|Windows event log entry source.| |timestamp|timestamp|Windows event log entry time.| |value|text|Received value.| ### Log level control targets *process-type* All processes of specified type (active checks, collector, listener) *process-type,N* Process type and number (e.g., listener,3) *pid* Process identifier, up to 65535. For larger values specify target as "process-type,N" ```{=html} <!-- --> ``` **-p**, **--print** Print known items and exit. For each item either generic defaults are used, or specific defaults for testing are supplied. These defaults are listed in square brackets as item key parameters. Returned values are enclosed in square brackets and prefixed with the type of the returned value, separated by a pipe character. For user parameters type is always **t**, as the agent can not determine all possible return values. Items, displayed as working, are not guaranteed to work from the Zabbix server or zabbix\_get when querying a running agent daemon as permissions or environment may be different. Returned value types are: d Number with a decimal part. m Not supported. This could be caused by querying an item that only works in the active mode like a log monitoring item or an item that requires multiple collected values. Permission issues or incorrect user parameters could also result in the not supported state. s Text. Maximum length not limited. t Text. Same as **s**. u Unsigned integer. **-t**, **--test** *item-key* Test single item and exit. See **--print** for output description. **-h**, **--help** Display this help and exit. **-V**, **--version** Output version information and exit. [ ]{#lbAH} ### اهداف کنترل سطح ورود به سیستم *نوع فرآیند* همه فرآیندهای از نوع مشخص شده (چک‌های فعال، جمع‌آور، شنونده) *نوع فرآیند، N* نوع و تعداد فرآیند (به عنوان مثال، شنونده، 3) *پید* شناسه فرآیند، تا 65535. برای مقادیر بزرگتر، هدف را به عنوان مشخص کنید "نوع فرآیند، N" ```{=html} <!---> ``` **-p**، **--چاپ** موارد شناخته شده را چاپ کنید و خارج شوید. برای هر مورد یکی از پیش فرض های عمومی است استفاده می شود، یا پیش فرض های خاصی برای آزمایش ارائه شده است. این پیش فرض ها هستند در پرانتز به عنوان پارامترهای کلیدی آیتم فهرست شده است. مقادیر برگشتی هستند محصور در پرانتز مربع و پیشوند با نوع بازگشتی مقدار، با یک کاراکتر لوله جدا شده است. برای پارامترهای کاربر نوع همیشه است **t**، زیرا عامل نمی تواند تمام مقادیر بازگشتی ممکن را تعیین کند. موارد، نمایش داده شده به عنوان کار، تضمین نمی شود که از سرور Zabbix کار کند یا zabbix\_get در هنگام پرس و جو از یک daemon عامل در حال اجرا به عنوان مجوز یا محیط ممکن است متفاوت باشد انواع ارزش برگشتی عبارتند از: د عدد با قسمت اعشاری. متر پشتیبانی نشده. این ممکن است به دلیل پرس و جو از موردی باشد که فقط کار می کند در حالت فعال مانند یک آیتم نظارت بر گزارش یا موردی که نیاز دارد چندین مقادیر جمع آوری شده مشکلات مجوز یا کاربر نادرست پارامترها همچنین می توانند منجر به حالت پشتیبانی نشده شوند. س متن حداکثر طول محدود نیست. تی متن همان **s**. تو عدد صحیح بدون علامت **-t**، **--تست** *کلید مورد* یک مورد را تست کنید و از آن خارج شوید. برای توضیحات خروجی **--print** را ببینید. **-h**، **--راهنما** این راهنما را نمایش دهید و از آن خارج شوید. **-V**، **--نسخه** اطلاعات نسخه خروجی و خروج. [ ]{#lbAH} ##### Mass editing options Buttons below the list offer some mass-editing options: - *Enable* - change trigger status to *Enabled*. - *Disable* - change trigger status to *Disabled*. - *Copy* - copy the triggers to other hosts or templates. - *Mass update* - update several properties for a number of triggers at once. - *Delete* - delete the triggers. To use these options, mark the checkboxes before the respective triggers, then click on the required button. ##### Mass editing options Buttons below the list offer some mass-editing options: - *Enable* - change trigger status to *Enabled* - *Disable* - change trigger status to *Disabled* - *Copy* - copy the triggers to other hosts or templates - *Mass update* - update several properties for a number of triggers at once - *Delete* - delete the triggers To use these options, mark the checkboxes before the respective triggers, then click on the required button. ## NAME zabbix\_agent2 - Zabbix agent 2\ \ [ ]{#lbAC} ## نام zabbix\_agent2 - Zabbix agent 2\ \ [ ]{#lbAC} ## NAME zabbix\_agentd - Zabbix agent daemon [ ]{#lbAC} ایجنت زبیکس -سرویس ایجنت زبیکس ## NAME zabbix\_get - Zabbix get utility [ ]{#lbAC} ## نام دستور zabbix\_get - ابزار دریافت مقادیر Zabbix [ ]{#lbAC} ## NAME zabbix\_js - Zabbix JS utility [ ]{#lbAC} ## نام zabbix\_js - ابزار Zabbix JS [ ]{#lbAC} ## NAME zabbix\_proxy - Zabbix proxy daemon [ ]{#lbAC} ## نام zabbix\_js - ابزار Zabbix JS [ ]{#lbAC} ## NAME zabbix\_sender - Zabbix sender utility [ ]{#lbAC} ## نام zabbix\_sender - ابزار ارسال کننده Zabbix [ ]{#lbAC} ## NAME zabbix\_server - Zabbix server daemon [ ]{#lbAC} ## نام zabbix\_server - دیمون سرور Zabbix [ ]{#lbAC} ## NAME zabbix\_web\_service - Zabbix web service [ ]{#lbAC} ## نام zabbix\_web\_service - وب سرویس Zabbix [ ]{#lbAC} ### Notation ### نشانه گذاری ## OPTIONS **-c**, **--config** *config-file* Use the alternate *config-file* instead of the default one. **-f**, **--foreground** Run Zabbix agent in foreground. **-R**, **--runtime-control** *runtime-option* Perform administrative functions according to *runtime-option*. [ ]{#lbAF} ## گزینه ها **-c**، **--config** *config-file* به جای فایل پیش فرض، از *config-file* جایگزین استفاده کنید. **-R**، **--runtime-control** *runtime-option* عملکردهای اداری را مطابق *runtime-option* انجام دهید. ## OPTIONS **-c**, **--config** *config-file* Use the alternate *config-file* instead of the default one. **-f**, **--foreground** Run Zabbix proxy in foreground. **-R**, **--runtime-control** *runtime-option* Perform administrative functions according to *runtime-option*. [ ]{#lbAF} ## گزینه ها **-c**، **--config** *config-file* به جای فایل پیش فرض، از *config-file* جایگزین استفاده کنید. **-R**، **--runtime-control** *runtime-option* عملکردهای اداری را مطابق *runtime-option* انجام دهید. ## OPTIONS **-c**, **--config** *config-file* Use the alternate *config-file* instead of the default one. **-h**, **--help** Display this help and exit. **-V**, **--version** Output version information and exit. [ ]{#lbAF} ## گزینه ها **-c**، **--config** *config-file* به جای فایل پیش فرض، از *config-file* جایگزین استفاده کنید. **-h**، **--راهنما** این راهنما را نمایش دهید و از آن خارج شوید. **-V**، **--نسخه** اطلاعات نسخه خروجی و خروج. [ ]{#lbAF} ## OPTIONS **-c**, **--config** *config-file* Use the alternate *config-file* instead of the default one. **-R**, **--runtime-control** *runtime-option* Perform administrative functions according to *runtime-option*. ## گزینه ها **-c**، **--config** *config-file* به جای فایل پیش فرض، از *config-file* جایگزین استفاده کنید. **-R**، **--runtime-control** *runtime-option* عملکردهای اداری را مطابق *runtime-option* انجام دهید. #### Options |Parameter|Description| |---------|-----------| |-V --version|Print the plugin version and license information.| |-h --help|Print help information (shorthand).| #### Options |Parameter|Description| |---------|-----------| |-V --version|Print the plugin version and license information.| |-h --help|Print help information (shorthand).| ## OPTIONS **-s**, **--host** *host-name-or-IP* Specify host name or IP address of a host. **-p**, **--port** *port-number* Specify port number of agent running on the host. Default is 10050. **-I**, **--source-address** *IP-address* Specify source IP address. **-t**, **--timeout** *seconds* Specify timeout. Valid range: 1-30 seconds (default: 30) **-k**, **--key** *item-key* Specify key of item to retrieve value for. **--tls-connect** *value* How to connect to agent. Values: [ ]{#lbAF} ## گزینه ها **-s**، **--host** *host-name-or-IP* نام میزبان یا آدرس IP یک میزبان را مشخص کنید. **-p**، **--پورت** *درگاه-شماره* شماره پورت عامل در حال اجرا بر روی هاست را مشخص کنید. پیش فرض 10050 است. **-I**، **--منبع-آدرس** *آدرس IP* آدرس IP منبع را مشخص کنید. **-t**، **--تایم اوت** *ثانیه* تایم اوت را مشخص کنید. محدوده معتبر: 1-30 ثانیه (پیش‌فرض: 30) **-k**، **--کلید** *کلید مورد* کلید مورد را برای بازیابی مقدار مشخص کنید. **--tls-connect** *value* نحوه اتصال به نماینده ارزش های: [ ]{#lbAF} ## OPTIONS **-s**, **--script** *script-file* Specify the file name of the script to execute. If '-' is specified as file name, the script will be read from stdin. **-p**, **--param** *input-param* Specify the input parameter. **-i**, **--input** *input-file* Specify the file name of the input parameter. If '-' is specified as file name, the input will be read from stdin. **-l**, **--loglevel** *log-level* Specify the log level. **-t**, **--timeout** *timeout* Specify the timeout in seconds. Valid range: 1\-60 seconds (default: 10) **-h**, **--help** Display this help and exit. **-V**, **--version** Output version information and exit. [ ]{#lbAF} ## گزینه ها **-s**، **--اسکریپت** *اسکریپت-فایل* نام فایل اسکریپت مورد نظر را برای اجرا مشخص کنید. اگر '-' به صورت مشخص شده باشد نام فایل، اسکریپت از stdin خوانده می شود. **-p**، **--param** *input-param* پارامتر ورودی را مشخص کنید. **-i**، **--ورودی** *ورودی-فایل* نام فایل پارامتر ورودی را مشخص کنید. اگر '-' به صورت مشخص شده باشد نام فایل، ورودی از stdin خوانده می شود. **-l**، **--loglevel** *log-level* سطح گزارش را مشخص کنید. **-t**، **--تایم اوت** *تایم اوت* تایم اوت را بر حسب ثانیه مشخص کنید. **-h**، **--راهنما** این راهنما را نمایش دهید و از آن خارج شوید. **-V**، **--نسخه** اطلاعات نسخه خروجی و خروج. [ ]{#lbAF} ### Overview In Zabbix 6.0, [service monitoring](/manual/it_services) functionality has been reworked significantly (see [What's new in Zabbix 6.0.0](https://www.zabbix.com/documentation/6.0/en/manual/introduction/whatsnew600#services) for the list of changes). This page describes how services and SLAs, defined in earlier Zabbix versions, are changed during an upgrade to Zabbix 6.0 or newer. ### Overview In Zabbix 6.0, [service monitoring](/manual/it_services) functionality has been reworked significantly (see [What's new in Zabbix 6.0.0](https://www.zabbix.com/documentation/6.0/en/manual/introduction/whatsnew600#services) for the list of changes). This page describes how services and SLAs defined in earlier Zabbix versions are changed during an upgrade to Zabbix 6.0 or newer. #### Overview Media types are [exported](/manual/xml_export_import) with all related objects and object relations. #### مرور Media types are [exported](/manual/xml_export_import) with all related objects and object relations. #### Overview This section lists parameters supported in the Ceph Zabbix agent 2 plugin configuration file (ceph.conf). Note that: - The default values reflect process defaults, not the values in the shipped configuration files; - Zabbix supports configuration files only in UTF-8 encoding without [BOM](https://en.wikipedia.org/wiki/Byte_order_mark); - Comments starting with "\#" are only supported at the beginning of the line. #### Overview This section lists parameters supported in the Ceph Zabbix agent 2 plugin configuration file (ceph.conf). Note that: - The default values reflect process defaults, not the values in the shipped configuration files; - Zabbix supports configuration files only in UTF-8 encoding without [BOM](https://en.wikipedia.org/wiki/Byte_order_mark); - Comments starting with "\#" are only supported at the beginning of the line. #### Overview This section lists parameters supported in the Docker Zabbix agent 2 plugin configuration file (docker.conf). Note that: - The default values reflect process defaults, not the values in the shipped configuration files; - Zabbix supports configuration files only in UTF-8 encoding without [BOM](https://en.wikipedia.org/wiki/Byte_order_mark); - Comments starting with "\#" are only supported at the beginning of the line. #### Overview This section lists parameters supported in the Docker Zabbix agent 2 plugin configuration file (docker.conf). Note that: - The default values reflect process defaults, not the values in the shipped configuration files; - Zabbix supports configuration files only in UTF-8 encoding without [BOM](https://en.wikipedia.org/wiki/Byte_order_mark); - Comments starting with "\#" are only supported at the beginning of the line. #### Overview This section lists parameters supported in the Memcached Zabbix agent 2 plugin configuration file (memcached.conf). Note that: - The default values reflect process defaults, not the values in the shipped configuration files; - Zabbix supports configuration files only in UTF-8 encoding without [BOM](https://en.wikipedia.org/wiki/Byte_order_mark); - Comments starting with "\#" are only supported at the beginning of the line. #### Overview This section lists parameters supported in the Memcached Zabbix agent 2 plugin configuration file (memcached.conf). Note that: - The default values reflect process defaults, not the values in the shipped configuration files; - Zabbix supports configuration files only in UTF-8 encoding without [BOM](https://en.wikipedia.org/wiki/Byte_order_mark); - Comments starting with "\#" are only supported at the beginning of the line. #### Overview This section lists parameters supported in the Modbus Zabbix agent 2 plugin configuration file (modbus.conf). Note that: - The default values reflect process defaults, not the values in the shipped configuration files; - Zabbix supports configuration files only in UTF-8 encoding without [BOM](https://en.wikipedia.org/wiki/Byte_order_mark); - Comments starting with "\#" are only supported at the beginning of the line. #### Overview This section lists parameters supported in the Modbus Zabbix agent 2 plugin configuration file (modbus.conf). Note that: - The default values reflect process defaults, not the values in the shipped configuration files; - Zabbix supports configuration files only in UTF-8 encoding without [BOM](https://en.wikipedia.org/wiki/Byte_order_mark); - Comments starting with "\#" are only supported at the beginning of the line. #### Overview This section lists parameters supported in the MQTT Zabbix agent 2 plugin configuration file (mqtt.conf). Note that: - The default values reflect process defaults, not the values in the shipped configuration files; - Zabbix supports configuration files only in UTF-8 encoding without [BOM](https://en.wikipedia.org/wiki/Byte_order_mark); - Comments starting with "\#" are only supported at the beginning of the line. #### Overview This section lists parameters supported in the MQTT Zabbix agent 2 plugin configuration file (mqtt.conf). Note that: - The default values reflect process defaults, not the values in the shipped configuration files; - Zabbix supports configuration files only in UTF-8 encoding without [BOM](https://en.wikipedia.org/wiki/Byte_order_mark); - Comments starting with "\#" are only supported at the beginning of the line. #### Overview This section lists parameters supported in the MySQL Zabbix agent 2 plugin configuration file (mysql.conf). Note that: - The default values reflect process defaults, not the values in the shipped configuration files; - Zabbix supports configuration files only in UTF-8 encoding without [BOM](https://en.wikipedia.org/wiki/Byte_order_mark); - Comments starting with "\#" are only supported at the beginning of the line. #### Overview This section lists parameters supported in the MySQL Zabbix agent 2 plugin configuration file (mysql.conf). Note that: - The default values reflect process defaults, not the values in the shipped configuration files; - Zabbix supports configuration files only in UTF-8 encoding without [BOM](https://en.wikipedia.org/wiki/Byte_order_mark); - Comments starting with "\#" are only supported at the beginning of the line. #### Overview With escalations you can create custom scenarios for sending notifications or executing remote commands. In practical terms it means that: - Users can be informed about new problems immediately. - Notifications can be repeated until the problem is resolved. - Sending a notification can be delayed. - Notifications can be escalated to another "higher" user group. - Remote commands can be executed immediately or when a problem is not resolved for a lengthy period. Actions are escalated based on the **escalation step**. Each step has a duration in time. You can define both the default duration and a custom duration of an individual step. The minimum duration of one escalation step is 60 seconds. You can start actions, such as sending notifications or executing commands, from any step. Step one is for immediate actions. If you want to delay an action, you can assign it to a later step. For each step, several actions can be defined. The number of escalation steps is not limited. Escalations are defined when [configuring an operation](operation#configuring_an_operation). Escalations are supported for problem operations only, not recovery. #### Overview With escalations you can create custom scenarios for sending notifications or executing remote commands. In practical terms it means that: - Users can be informed about new problems immediately - Notifications can be repeated until the problem is resolved - Sending a notification can be delayed - Notifications can be escalated to another "higher" user group - Remote commands can be executed immediately or when a problem is not resolved for a lengthy period Actions are escalated based on the **escalation step**. Each step has a duration in time. You can define both the default duration and a custom duration of an individual step. The minimum duration of one escalation step is 60 seconds. You can start actions, such as sending notifications or executing commands, from any step. Step one is for immediate actions. If you want to delay an action, you can assign it to a later step. For each step, several actions can be defined. The number of escalation steps is not limited. Escalations are defined when [configuring an operation](operation#configuring_an_operation). Escalations are supported for problem operations only, not recovery. ### Parameters `(array)` IDs of hosts to delete. ### پارامتر ها `(array)` IDs of hosts to delete. ### Parameters `(array)` IDs of items to clear. ### پارامتر ها `(array)` IDs of items to clear. ### Parameters `(array)` IDs of the actions to delete. ### پارامترها شناسه «(آرایه)» های اکشن برای حذف کردن . ### Parameters `(array)` IDs of the correlations to delete. ### پارامتر ها «(آرایه)» شناسه های همبستگی برای حذف. ### Parameters `(array)` IDs of the dashboards to delete. ### پارامتر ها «(آرایه)» شناسه های همبستگی برای حذف. ### Parameters `(array)` IDs of the discovery rules to delete. ### پارامتر ها «(آرایه)» شناسه های همبستگی برای حذف. ### Parameters `(array)` IDs of the graph prototypes to delete. ###پارامتر ها `object graphprototype.delete(array graphPrototypeIds)` This method allows to delete graph prototypes. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Parameters `(array)` IDs of the graphs to delete. ### پارامتر ها `(array)` IDs of the graphs to delete. ### Parameters `(array)` IDs of the host groups to delete. ###پارامتر ها `(array)` IDs of the host groups to delete. ### Parameters `(array)` IDs of the host interfaces to delete. ### پارامتر ها `(array)` IDs of the host interfaces to delete. ### Parameters `(array)` IDs of the host prototypes to delete. ### پارامتر ها `(array)` IDs of the host prototypes to delete. ### Parameters `(array)` IDs of the icon maps to delete. ### پارامتر ها `(array)` IDs of the icon maps to delete. ### Parameters `(array)` IDs of the LLD rules to delete. ### پارامتر ها «(آرایه)» شناسه های همبستگی برای حذف. ### Parameters `(array)` IDs of the web scenarios to delete. ### پارامتر ها `(array)` IDs of the web scenarios to delete. ### Parameters `(array)` The method accepts an empty array. ### پارامترها `(آرایه)` این روش یک آرایه خالی را می پذیرد. ### Parameters `(object/array)` Actions to create. Additionally to the [standard action properties](object#action), the method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |filter|object|Action [filter](/manual/api/reference/action/object#action_filter) object for the action.| |operations|array|Action [operations](/manual/api/reference/action/object#action_operation) to create for the action.| |recovery\_operations|array|Action [recovery operations](/manual/api/reference/action/object#action_recovery_operation) to create for the action.| |update\_operations|array|Action [update operations](/manual/api/reference/action/object#action_update_operation) to create for the action.| ### پارامتر ها «(شیء/آرایه)» اقداماتی برای ساخت. علاوه بر [ویژگی‌های اقدام استاندارد] (object#action)، متد پارامترهای زیر را می پذیرد. |پارامتر|[نوع](/manual/api/reference_commentary#data_types)|توضیحات| |--|--|------| |filter|object|Action [filter](/manual/api/reference/action/object#action_filter) شیء برای اکشن.| |عملیات|آرایه|عملیات [عملیات](/manual/api/reference/action/object#action_operation) برای ایجاد اکشن.| |بازیابی\_عملیات|آرایه|عملیات [عملیات بازیابی](/manual/api/reference/action/object#action_recovery_operation) برای ایجاد اکشن.| |update\_operations|آرایه|عملیات [عملیات به‌روزرسانی](/manual/api/reference/action/object#action_update_operation) برای ایجاد عمل.| ### Parameters `(object/array)` Correlation properties to be updated. The `correlationid` property must be defined for each correlation, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged. Additionally to the [standard correlation properties](object#correlation), the method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |filter|object|Correlation [filter](/manual/api/reference/correlation/object#correlation_filter) object to replace the current filter.| |operations|array|Correlation [operations](/manual/api/reference/correlation/object#correlation_operation) to replace existing operations.| ### پارامتر ها "(شیء/آرایه)" ویژگی های همبستگی به روز می شوند. ویژگی "correlationid" باید برای هر همبستگی، همه تعریف شود سایر خواص اختیاری هستند. فقط خواص پاس شده خواهد بود به روز شده، بقیه بدون تغییر باقی خواهند ماند. علاوه بر [همبستگی استاندارد خواص](object#correlation)، روش موارد زیر را می پذیرد مولفه های. |پارامتر|[نوع](/manual/api/reference_commentary#data_types)|توضیحات| |--|--|------| |filter|object|Correlation [filter](/manual/api/reference/correlation/object#correlation_filter) شیء جایگزین فیلتر فعلی.| |عملیات|آرایه|همبستگی [عملیات](/manual/api/reference/correlation/object#correlation_operation) برای جایگزینی عملیات موجود.| ### Parameters `(object/array)` Discovery rule properties to be updated. The `druleid` property must be defined for each discovery rule, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged. Additionally to the [standard discovery rule properties](object#discovery_rule), the method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |dchecks|array|Discovery [checks](/manual/api/reference/dcheck/object) to replace existing checks.| ### پارامتر ها `(object/array)` Discovery rule properties to be updated. The `druleid` property must be defined for each discovery rule, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged. Additionally to the [standard discovery rule properties](object#discovery_rule), the method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |dchecks|array|Discovery [checks](/manual/api/reference/dcheck/object) to replace existing checks.| ### Parameters `(object/array)` Graph properties to be updated. The `graphid` property must be defined for each graph, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged. Additionally to the [standard graph properties](object#graph) the method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |gitems|array|Graph [items](/manual/api/reference/graphitem/object) to replace existing graph items. If a graph item has the `gitemid` property defined it will be updated, otherwise a new graph item will be created.| ### پارامتر ها `(object/array)` Graph properties to be updated. The `graphid` property must be defined for each graph, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged. Additionally to the [standard graph properties](object#graph) the method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |gitems|array|Graph [items](/manual/api/reference/graphitem/object) to replace existing graph items. If a graph item has the `gitemid` property defined it will be updated, otherwise a new graph item will be created.| ### Parameters `(object/array)` Graph prototype properties to be updated. The `graphid` property must be defined for each graph prototype, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged. Additionally to the [standard graph prototype properties](object#graph_prototype), the method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |gitems|array|Graph [items](/manual/api/reference/graphitem/object) to replace existing graph items. If a graph item has the `gitemid` property defined it will be updated, otherwise a new graph item will be created.| ### پارامتر ها `(object/array)` Graph prototype properties to be updated. The `graphid` property must be defined for each graph prototype, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged. Additionally to the [standard graph prototype properties](object#graph_prototype), the method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |gitems|array|Graph [items](/manual/api/reference/graphitem/object) to replace existing graph items. If a graph item has the `gitemid` property defined it will be updated, otherwise a new graph item will be created.| ### Parameters `(object/array)` [Host group properties](object#host_group) to be updated. The `groupid` property must be defined for each host group, all other properties are optional. Only the given properties will be updated, all others will remain unchanged. ### پارامتر ها `(object/array)` [Host group properties](object#host_group) to be updated. The `groupid` property must be defined for each host group, all other properties are optional. Only the given properties will be updated, all others will remain unchanged. ### Parameters `(object/array)` [Host interface properties](object#host_interface) to be updated. The `interfaceid` property must be defined for each host interface, all other properties are optional. Only the given properties will be updated, all others will remain unchanged. ### پارامتر ها `(object/array)` [Host interface properties](object#host_interface) to be updated. The `interfaceid` property must be defined for each host interface, all other properties are optional. Only the given properties will be updated, all others will remain unchanged. ### Parameters `(object/array)` Host properties to be updated. The `hostid` property must be defined for each host, all other properties are optional. Only the given properties will be updated, all others will remain unchanged. Note, however, that updating the host technical name will also update the host's visible name (if not given or empty) by the host's technical name value. Additionally to the [standard host properties](object#host), the method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |groups|object/array|Host [groups](/manual/api/reference/hostgroup/object#host_group) to replace the current host groups the host belongs to.<br><br>The host groups must have the `groupid` property defined. All host groups that are not listed in the request will be unlinked.| |interfaces|object/array|Host [interfaces](/manual/api/reference/hostinterface/object) to replace the current host interfaces.<br><br>All interfaces that are not listed in the request will be removed.| |tags|object/array|Host [tags](/manual/api/reference/host/object#host_tag) to replace the current host tags.<br><br>All tags that are not listed in the request will be removed.| |inventory|object|Host [inventory](/manual/api/reference/host/object#host_inventory) properties.| |macros|object/array|[User macros](/manual/api/reference/usermacro/object) to replace the current user macros.<br><br>All macros that are not listed in the request will be removed.| |templates|object/array|[Templates](/manual/api/reference/template/object) to replace the currently linked templates. All templates that are not listed in the request will be only unlinked.<br><br>The templates must have the `templateid` property defined.| |templates\_clear|object/array|[Templates](/manual/api/reference/template/object) to unlink and clear from the host.<br><br>The templates must have the `templateid` property defined.| ::: notetip As opposed to the Zabbix frontend, when `name` (visible host name) is the same as `host` (technical host name), updating `host` via API will not automatically update `name`. Both properties need to be updated explicitly. ::: ### پارامترها `(object/array)` Host properties to be updated. The `hostid` property must be defined for each host, all other properties are optional. Only the given properties will be updated, all others will remain unchanged. Note, however, that updating the host technical name will also update the host's visible name (if not given or empty) by the host's technical name value. Additionally to the [standard host properties](object#host), the method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |groups|object/array|Host [groups](/manual/api/reference/hostgroup/object#host_group) to replace the current host groups the host belongs to.<br><br>The host groups must have the `groupid` property defined. All host groups that are not listed in the request will be unlinked.| |interfaces|object/array|Host [interfaces](/manual/api/reference/hostinterface/object) to replace the current host interfaces.<br><br>All interfaces that are not listed in the request will be removed.| |tags|object/array|Host [tags](/manual/api/reference/host/object#host_tag) to replace the current host tags.<br><br>All tags that are not listed in the request will be removed.| |inventory|object|Host [inventory](/manual/api/reference/host/object#host_inventory) properties.| |macros|object/array|[User macros](/manual/api/reference/usermacro/object) to replace the current user macros.<br><br>All macros that are not listed in the request will be removed.| |templates|object/array|[Templates](/manual/api/reference/template/object) to replace the currently linked templates. All templates that are not listed in the request will be only unlinked.<br><br>The templates must have the `templateid` property defined.| |templates\_clear|object/array|[Templates](/manual/api/reference/template/object) to unlink and clear from the host.<br><br>The templates must have the `templateid` property defined.| ::: notetip As opposed to the Zabbix frontend, when `name` (visible host name) is the same as `host` (technical host name), updating `host` via API will not automatically update `name`. Both properties need to be updated explicitly. ::: ### Parameters `(object/array)` Icon map properties to be updated. The `iconmapid` property must be defined for each icon map, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged. Additionally to the [standard icon map properties](object#icon_map), the method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |mappings|array|[Icon mappings](/manual/api/reference/iconmap/object#icon_mapping) to replace the existing icon mappings.| ### پارامترها "(شیء/آرایه)" ویژگی های آیکون نقشه به روز می شود. ویژگی "iconmapid" باید برای هر آیکون نقشه تعریف شود و بقیه ویژگی ها اختیاری هستند فقط ویژگی های تصویب شده به روز می شوند، بقیه بدون تغییر باقی خواهند ماند. علاوه بر [مشخصات استاندارد icon map] (object#icon_map)، متد پارامترهای زیر را می پذیرد. |پارامتر|[نوع](/manual/api/reference_commentary#data_types)|توضیحات| |--|--|------| |mappings|آرایه|[Icon mappings](/manual/api/reference/iconmap/object#icon_mapping) برای جایگزینی نگاشت نمادهای موجود.| ### Parameters `(object/array)` Scripts to create. The method accepts scripts with the [standard script properties](/manual/api/reference/script/object#script). ### پارامترها اسکریپت هایی برای ایجاد `(شیء/آرایه). این روش اسکریپت هایی را با [خواص اسکریپت استاندارد می پذیرد ](/دستی/api/reference/script/object#script). ### Parameters `(object/array)` Web scenario properties to be updated. The `httptestid` property must be defined for each web scenario, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged. Additionally to the [standard web scenario properties](object#web_scenario), the method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |steps|array|Scenario [steps](/manual/api/reference/httptest/object#scenario_step) to replace existing steps.| |tags|array|Web scenario [tags](/manual/api/reference/httptest/object#web_scenario_tag).| ### پارامتر ها `(object/array)` Web scenario properties to be updated. The `httptestid` property must be defined for each web scenario, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged. Additionally to the [standard web scenario properties](object#web_scenario), the method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |steps|array|Scenario [steps](/manual/api/reference/httptest/object#scenario_step) to replace existing steps.| |tags|array|Web scenario [tags.](/manual/api/reference/httptest/object#web_scenario_tag)| ### Parameters `(object)` Parameters defining the desired output. The method supports only one parameter. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |output|query|This parameter being common for all `get` methods described in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters).| ### پارامترها `(شیء)` پارامترهای تعیین کننده خروجی مورد نظراست . این روش تنها از یک پارامتر پشتیبانی می کند. |پارامتر|[نوع](/manual/api/reference_commentary#data_types)|توضیحات| |--|--|------| |output|query|این پارامتر برای همه روش‌های «get» که در [تفسیر مرجع] توضیح داده شده مشترک است (/manual/api/reference_commentary#common_get_method_parameters).| ### Parameters `(object)` Parameters defining the desired output. The method supports only one parameter. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |output|query|This parameter being common for all `get` methods described in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters).| ### پارامترها `(شیء)` پارامترهای تعیین کننده خروجی مورد نظراست . این روش تنها از یک پارامتر پشتیبانی می کند. |پارامتر|[نوع](/manual/api/reference_commentary#data_types)|توضیحات| |--|--|------| |output|query|این پارامتر برای همه روش‌های «get» که در [تفسیر مرجع] توضیح داده شده مشترک است (/manual/api/reference_commentary#common_get_method_parameters).| ### Parameters `(object)` Parameters defining the desired output. The method supports only one parameter. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |output|query|This parameter being common for all `get` methods described in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters).| ### پارامترها `(شیء)` پارامترهای تعیین کننده خروجی مورد نظراست . این روش تنها از یک پارامتر پشتیبانی می کند. |پارامتر|[نوع](/manual/api/reference_commentary#data_types)|توضیحات| |--|--|------| |output|query|این پارامتر برای همه روش‌های «get» که در [تفسیر مرجع] توضیح داده شده مشترک است (/manual/api/reference_commentary#common_get_method_parameters).| ### Parameters `(object)` Parameters defining the LLD rules to copy and the target hosts. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |discoveryids|array|IDs of the LLD rules to be copied.| |hostids|array|IDs of the hosts to copy the LLD rules to.| ### پارامترها `(object)` Parameters defining the LLD rules to copy and the target hosts. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |discoveryids|array|IDs of the LLD rules to be copied.| |hostids|array|IDs of the hosts to copy the LLD rules to.| # Plugins # Plugins #### Possible deadlocks with MySQL/MariaDB When running under high load, and with more than one LLD worker involved, it is possible to run into a deadlock caused by an InnoDB error related to the row-locking strategy (see [upstream bug](https://github.com/mysql/mysql-server/commit/7037a0bdc83196755a3bf3e935cfb3c0127715d5)). The error has been fixed in MySQL since 8.0.29, but not in MariaDB. For more details, see [ZBX-21506](https://support.zabbix.com/browse/ZBX-21506). #### Possible deadlocks with MySQL/MariaDB When running under high load, and with more than one LLD worker involved, it is possible to run into a deadlock caused by an InnoDB error related to the row-locking strategy (see [upstream bug](https://github.com/mysql/mysql-server/commit/7037a0bdc83196755a3bf3e935cfb3c0127715d5)). The error has been fixed in MySQL since 8.0.29, but not in MariaDB. For more details, see [ZBX-21506](https://support.zabbix.com/browse/ZBX-21506). ### Reserved ID value "0" Reserved ID value "0" can be used to filter elements and to remove referenced objects. For example, to remove a referenced proxy from a host, proxy\_hostid should be set to 0 ("proxy\_hostid": "0") or to filter hosts monitored by server option proxyids should be set to 0 ("proxyids": "0"). ### مقدار شناسه رزرو شده "0" از مقدار شناسه رزرو شده "0" می توان برای فیلتر کردن عناصر و حذف اشیاء ارجاع شده استفاده کرد به عنوان مثال، برای حذف یک پراکسی ارجاع شده از a میزبان، پروکسی\_hostid باید روی 0 ("proxy\_hostid": "0") یا به میزبان های فیلتر که توسط پروکسی های گزینه سرور نظارت می شوند باید روی 0 تنظیم شوند ("proxyids": "0"). ### Return values `(array)` Returns an array with changes in configuration, that will be made. ### مقادیر را برمی گرداند `(آرایه)` یک آرایه را با تغییراتی در پیکربندی ساخته شده است را برمی گرداند ### Return values `(boolean )` Returns boolean true as result on successful update. ### مقادیر را برمی گرداند «(بولین)» در به‌روزرسانی موفقیت‌آمیز، بولین واقعی را برمی‌گرداند. ### Return values `(boolean)` Returns `true` if importing has been successful. ### مقادیر را برمی گرداند «(بولین)» اگر وارد کردن موفقیت آمیز باشد، «درست» را برمی‌گرداند. ### Return values `(boolean)` Returns `true` if the copying was successful. ### مقادیر را برمی گرداند ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### بازگشت مقادیر «(عدد صحیح/آرایه)» یکی را برمی‌گرداند: - آرایه ای از اشیاء؛ - تعداد اشیاء بازیابی شده، اگر پارامتر "countOutput" داشته باشد استفاده شده است. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### بازگشت مقادیر «(عدد صحیح/آرایه)» یکی را برمی‌گرداند: - آرایه ای از اشیاء؛ - تعداد اشیاء بازیابی شده، اگر پارامتر "countOutput" داشته باشد استفاده شده است. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### بازگشت مقادیر «(عدد صحیح/آرایه)» یکی را برمی‌گرداند: - آرایه ای از اشیاء؛ - تعداد اشیاء بازیابی شده، اگر پارامتر "countOutput" داشته باشد استفاده شده است. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### بازگشت مقادیر «(عدد صحیح/آرایه)» یکی را برمی‌گرداند: - آرایه ای از اشیاء؛ - تعداد اشیاء بازیابی شده، اگر پارامتر "countOutput" داشته باشد استفاده شده است. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### بازگشت مقادیر «(عدد صحیح/آرایه)» یکی را برمی‌گرداند: - آرایه ای از اشیاء؛ - تعداد اشیاء بازیابی شده، اگر پارامتر "countOutput" داشته باشد استفاده شده است. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### بازگشت مقادیر «(عدد صحیح/آرایه)» یکی را برمی‌گرداند: - آرایه ای از اشیاء؛ - تعداد اشیاء بازیابی شده، اگر پارامتر "countOutput" داشته باشد استفاده شده است. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### بازگشت مقادیر «(عدد صحیح/آرایه)» یکی را برمی‌گرداند: - آرایه ای از اشیاء؛ - تعداد اشیاء بازیابی شده، اگر پارامتر "countOutput" داشته باشد استفاده شده است. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### بازگشت مقادیر «(عدد صحیح/آرایه)» یکی را برمی‌گرداند: - آرایه ای از اشیاء؛ - تعداد اشیاء بازیابی شده، اگر پارامتر "countOutput" داشته باشد استفاده شده است. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### بازگشت مقادیر «(عدد صحیح/آرایه)» یکی را برمی‌گرداند: - آرایه ای از اشیاء؛ - تعداد اشیاء بازیابی شده، اگر پارامتر "countOutput" داشته باشد استفاده شده است. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### بازگشت مقادیر «(عدد صحیح/آرایه)» یکی را برمی‌گرداند: - آرایه ای از اشیاء؛ - تعداد اشیاء بازیابی شده، اگر پارامتر "countOutput" داشته باشد استفاده شده است. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### بازگشت مقادیر «(عدد صحیح/آرایه)» یکی را برمی‌گرداند: - آرایه ای از اشیاء؛ - تعداد اشیاء بازیابی شده، اگر پارامتر "countOutput" داشته باشد استفاده شده است. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### بازگشت مقادیر «(عدد صحیح/آرایه)» یکی را برمی‌گرداند: - آرایه ای از اشیاء؛ - تعداد اشیاء بازیابی شده، اگر پارامتر "countOutput" داشته باشد استفاده شده است. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### بازگشت مقادیر «(عدد صحیح/آرایه)» یکی را برمی‌گرداند: - آرایه ای از اشیاء؛ - تعداد اشیاء بازیابی شده، اگر پارامتر "countOutput" داشته باشد استفاده شده است. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ###بازگشت مقادیر `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### بازگشت مقادیر «(عدد صحیح/آرایه)» یکی را برمی‌گرداند: - آرایه ای از اشیاء؛ - تعداد اشیاء بازیابی شده، اگر پارامتر "countOutput" داشته باشد استفاده شده است. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### بازگشت مقادیر «(عدد صحیح/آرایه)» یکی را برمی‌گرداند: - آرایه ای از اشیاء؛ - تعداد اشیاء بازیابی شده، اگر پارامتر "countOutput" داشته باشد استفاده شده است. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### بازگشت مقادیر «(عدد صحیح/آرایه)» یکی را برمی‌گرداند: - آرایه ای از اشیاء؛ - تعداد اشیاء بازیابی شده، اگر پارامتر "countOutput" داشته باشد استفاده شده است. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### بازگشت مقادیر «(عدد صحیح/آرایه)» یکی را برمی‌گرداند: - آرایه ای از اشیاء؛ - تعداد اشیاء بازیابی شده، اگر پارامتر "countOutput" داشته باشد استفاده شده است. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### بازگشت مقادیر «(عدد صحیح/آرایه)» یکی را برمی‌گرداند: - آرایه ای از اشیاء؛ - تعداد اشیاء بازیابی شده، اگر پارامتر "countOutput" داشته باشد استفاده شده است. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### بازگشت مقادیر «(عدد صحیح/آرایه)» یکی را برمی‌گرداند: - آرایه ای از اشیاء؛ - تعداد اشیاء بازیابی شده، اگر پارامتر "countOutput" داشته باشد استفاده شده است. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### بازگشت مقادیر «(عدد صحیح/آرایه)» یکی را برمی‌گرداند: - آرایه ای از اشیاء؛ - تعداد اشیاء بازیابی شده، اگر پارامتر "countOutput" داشته باشد استفاده شده است. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### بازگشت مقادیر «(عدد صحیح/آرایه)» یکی را برمی‌گرداند: - آرایه ای از اشیاء؛ - تعداد اشیاء بازیابی شده، اگر پارامتر "countOutput" داشته باشد استفاده شده است. ### Return values `(object)` Returns an object containing the IDs of the cleared items under the `itemids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the cleared items under the `itemids` property. ### Return values `(object)` Returns an object containing the IDs of the created actions under the `actionids` property. The order of the returned IDs matches the order of the passed actions. ### برگشت مقادیر `(object)` یک شی حاوی شناسه اقدامات ایجاد شده را تحت خاصیت «شناسه اکشن » برمی گرداند . ترتیب شناسه های برگشتی با ترتیب اقدامات انجام شده مطابقت دارد ### Return values `(object)` Returns an object containing the IDs of the created correlations under the `correlationids` property. The order of the returned IDs matches the order of the passed correlations. ### مقادیر را برمی گرداند `(object)` یک شی حاوی شناسه های اسکریپت های ایجاد شده را تحت ویژگی "scriptids" برمی گرداند. ترتیب شناسه های برگشتی با ترتیب اسکریپت های پاس شده مطابقت دارد ### Return values `(object)` Returns an object containing the IDs of the created dashboards under the `dashboardids` property. The order of the returned IDs matches the order of the passed dashboards. ### برگشت مقادیر `(object)` یک شی حاوی شناسه اقدامات ایجاد شده را تحت خاصیت «شناسه اکشن » برمی گرداند . ترتیب شناسه های برگشتی با ترتیب اقدامات انجام شده مطابقت دارد ### Return values `(object)` Returns an object containing the IDs of the created discovery rules under the `druleids` property. The order of the returned IDs matches the order of the passed discovery rules. ### برگشت مقادیر `(object)` یک شی حاوی شناسه اقدامات ایجاد شده را تحت خاصیت «شناسه اکشن » برمی گرداند . ترتیب شناسه های برگشتی با ترتیب اقدامات انجام شده مطابقت دارد ### Return values `(object)` Returns an object containing the IDs of the created graph prototypes under the `graphids` property. The order of the returned IDs matches the order of the passed graph prototypes. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the created graph prototypes under the `graphids` property. The order of the returned IDs matches the order of the passed graph prototypes. ### Return values `(object)` Returns an object containing the IDs of the created graphs under the `graphids` property. The order of the returned IDs matches the order of the passed graphs. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the created graphs under the `graphids` property. The order of the returned IDs matches the order of the passed graphs. ### Return values `(object)` Returns an object containing the IDs of the created host groups under the `groupids` property. The order of the returned IDs matches the order of the passed host groups. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the created hosts under the `hostids` property. The order of the returned IDs matches the order of the passed hosts. ### Return values `(object)` Returns an object containing the IDs of the created host interfaces under the `interfaceids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the created host interfaces under the `interfaceids` property. ### Return values `(object)` Returns an object containing the IDs of the created host interfaces under the `interfaceids` property. ###بازگشت مقادیر `(object)` Returns an object containing the IDs of the created host interfaces under the `interfaceids` property. ### Return values `(object)` Returns an object containing the IDs of the created host interfaces under the `interfaceids` property. The order of the returned IDs matches the order of the passed host interfaces. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the created host interfaces under the `interfaceids` property. The order of the returned IDs matches the order of the passed host interfaces. ### Return values `(object)` Returns an object containing the IDs of the created host prototypes under the `hostids` property. The order of the returned IDs matches the order of the passed host prototypes. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the created host prototypes under the `hostids` property. The order of the returned IDs matches the order of the passed host prototypes. ### Return values `(object)` Returns an object containing the IDs of the created hosts under the `hostids` property. The order of the returned IDs matches the order of the passed hosts. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the created hosts under the `hostids` property. The order of the returned IDs matches the order of the passed hosts. ### Return values `(object)` Returns an object containing the IDs of the created icon maps under the `iconmapids` property. The order of the returned IDs matches the order of the passed icon maps. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the created icon maps under the `iconmapids` property. The order of the returned IDs matches the order of the passed icon maps. ### Return values `(object)` Returns an object containing the IDs of the created images under the `imageids` property. The order of the returned IDs matches the order of the passed images. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the created images under the `imageids` property. The order of the returned IDs matches the order of the passed images. ### Return values `(object)` Returns an object containing the IDs of the created LLD rules under the `itemids` property. The order of the returned IDs matches the order of the passed LLD rules. ### برگشت مقادیر `(object)` یک شی حاوی شناسه اقدامات ایجاد شده را تحت خاصیت «شناسه اکشن » برمی گرداند . ترتیب شناسه های برگشتی با ترتیب اقدامات انجام شده مطابقت دارد ### Return values `(object)` Returns an object containing the IDs of the created scripts under the `scriptids` property. The order of the returned IDs matches the order of the passed scripts. ### مقادیر را برمی گرداند `(object)` یک شی حاوی شناسه های اسکریپت های ایجاد شده را تحت ویژگی "scriptids" برمی گرداند. ترتیب شناسه های برگشتی با ترتیب اسکریپت های پاس شده مطابقت دارد ### Return values `(object)` Returns an object containing the IDs of the created templates under the `templateids` property. The order of the returned IDs matches the order of the passed templates. ### برگشت مقادیر `(object)` یک شی حاوی شناسه اقدامات ایجاد شده را تحت خاصیت «شناسه اکشن » برمی گرداند . ترتیب شناسه های برگشتی با ترتیب اقدامات انجام شده مطابقت دارد ### Return values `(object)` Returns an object containing the IDs of the created web scenarios under the `httptestids` property. The order of the returned IDs matches the order of the passed web scenarios. ###بازگشت مقادیر `(object)` Returns an object containing the IDs of the created web scenarios under the `httptestids` property. The order of the returned IDs matches the order of the passed web scenarios. ### Return values `(object)` Returns an object containing the IDs of the deleted actions under the `actionids` property. ### بازگشت مقادیر `(object)` یک شی حاوی شناسه تحت خاصیت «actionids». اقدامات حذف شده را برمی گرداند ### Return values `(object)` Returns an object containing the IDs of the deleted correlations under the `correlationids` property. ### بازگشت مقادیر `(object)` یک شی حاوی شناسه های حذف شده را برمی گرداند همبستگی تحت خاصیت "correlationids". ### Return values `(object)` Returns an object containing the IDs of the deleted dashboards under the `dashboardids` property. ### بازگشت مقادیر `(object)` یک شی حاوی شناسه های به روز شده را تحت خاصیت "dashboardids" برمی گرداند ### Return values `(object)` Returns an object containing the IDs of the deleted discovery rules under the `druleids` property. ### بازگشت مقادیر `(object)` یک شی حاوی شناسه تحت خاصیت «actionids». اقدامات حذف شده را برمی گرداند ### Return values `(object)` Returns an object containing the IDs of the deleted graph prototypes under the `graphids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the deleted graph prototypes under the `graphids` property. ### Return values `(object)` Returns an object containing the IDs of the deleted graphs under the `graphids` property. ###بازگشت مقادیر `(object)` Returns an object containing the IDs of the deleted graphs under the `graphids` property. ### Return values `(object)` Returns an object containing the IDs of the deleted host groups under the `groupids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the deleted host groups under the `groupids` property. ### Return values `(object)` Returns an object containing the IDs of the deleted host interfaces under the `interfaceids` property. ###بازگشت مقادیر `(object)` Returns an object containing the IDs of the deleted host interfaces under the `interfaceids` property. ### Return values `(object)` Returns an object containing the IDs of the deleted host interfaces under the `interfaceids` property. ###بازگشت مقادیر `(object)` Returns an object containing the IDs of the deleted host interfaces under the `interfaceids` property. ### Return values `(object)` Returns an object containing the IDs of the deleted host prototypes under the `hostids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the deleted host prototypes under the `hostids` property. ### Return values `(object)` Returns an object containing the IDs of the deleted hosts under the `hostids` property. ###بازگشت مقادیر `(object)` Returns an object containing the IDs of the deleted hosts under the `hostids` property. ### Return values `(object)` Returns an object containing the IDs of the deleted icon maps under the `iconmapids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the deleted icon maps under the `iconmapids` property. ### Return values `(object)` Returns an object containing the IDs of the deleted web scenarios under the `httptestids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the deleted web scenarios under the `httptestids` property. ### Return values `(object)` Returns an object containing the IDs of the updated actions under the `actionids` property. ### بازگشت مقادیر `(object)` یک شی حاوی شناسه اقدامات به روز شده را برمی گرداند تحت خاصیت «اکشنیدز». ### Return values `(object)` Returns an object containing the IDs of the updated correlations under the `correlationids` property. ### بازگشت مقادیر `(object)` یک شی حاوی شناسه های به روز شده را برمی گرداند همبستگی تحت خاصیت "correlationids". ### Return values `(object)` Returns an object containing the IDs of the updated dashboards under the `dashboardids` property. ### بازگشت مقادیر `(object)` یک شی حاوی شناسه های به روز شده را برمی گرداند همبستگی تحت خاصیت "correlationids". ### Return values `(object)` Returns an object containing the IDs of the updated discovery rules under the `druleids` property. ### بازگشت مقادیر `(object)` یک شی حاوی شناسه تحت خاصیت «actionids». اقدامات حذف شده را برمی گرداند ### Return values `(object)` Returns an object containing the IDs of the updated events under the `eventids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the updated events under the `eventids` property. ### Return values `(object)` Returns an object containing the IDs of the updated graph prototypes under the `graphids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the updated graph prototypes under the `graphids` property. ### Return values `(object)` Returns an object containing the IDs of the updated graphs under the `graphids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the updated graphs under the `graphids` property. ### Return values `(object)` Returns an object containing the IDs of the updated host groups under the `groupids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the updated host groups under the `groupids` property. ### Return values `(object)` Returns an object containing the IDs of the updated host groups under the `groupids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the updated host groups under the `groupids` property. ### Return values `(object)` Returns an object containing the IDs of the updated host groups under the `groupids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the updated host groups under the `groupids` property. ### Return values `(object)` Returns an object containing the IDs of the updated host groups under the `groupids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the updated host groups under the `groupids` property. ### Return values `(object)` Returns an object containing the IDs of the updated host interfaces under the `interfaceids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the updated host interfaces under the `interfaceids` property. ### Return values `(object)` Returns an object containing the IDs of the updated host prototypes under the `hostids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the updated host prototypes under the `hostids` property. ### Return values `(object)` Returns an object containing the IDs of the updated hosts under the `hostids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the updated hosts under the `hostids` property. ### Return values `(object)` Returns an object containing the IDs of the updated hosts under the `hostids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the updated hosts under the `hostids` property. ### Return values `(object)` Returns an object containing the IDs of the updated hosts under the `hostids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the updated hosts under the `hostids` property. ### Return values `(object)` Returns an object containing the IDs of the updated hosts under the `hostids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the updated hosts under the `hostids` property. ### Return values `(object)` Returns an object containing the IDs of the updated icon maps under the `iconmapids` property. ### مقادیر را برمی گرداند `(object)` یک شی حاوی شناسه آیکون نقشه های به روز شده را برمی گرداند که تحت ویژگی "iconmapids" می باشد . ### Return values `(object)` Returns an object containing the IDs of the updated LLD rules under the `itemids` property. ### بازگشت مقادیر `(object)` یک شی حاوی شناسه تحت خاصیت «actionids». اقدامات حذف شده را برمی گرداند ### Return values `(object)` Returns an object containing the IDs of the updated web scenarios under the `httptestid` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the updated web scenarios under the `httptestid` property. ### Return values `(object)` Returns authentication object. ### مقادیر را برمی گرداند `(object)` شیء احراز هویت را برمی گرداند. ### Return values `(object)` Returns autoregistration object. ### مقادیر را برمی گرداند `(object)` شیء احراز هویت را برمی گرداند. ### Return values `(object)` Returns housekeeping object. ###بازگشت مقادیر `(object)` Returns housekeeping object. ### Return values `(string)` Returns a serialized string containing the requested configuration data. ### بازگشت مقادیر `(string)` یک رشته سریالی حاوی موارد درخواستی را برمی گرداند داده های پیکربندی ### Return values `(string)` Returns the version of the Zabbix API. ::: notetip Starting from Zabbix 2.0.4 the version of the API matches the version of Zabbix. ::: ### بازگشت مقادیر `(string)` نسخه Zabbix API را برمی گرداند. ::: یادداشت شروع از Zabbix 2.0.4 نسخه API با نسخه Zabbix مطابقت دارد. ::: ### Runtime control options **config\_cache\_reload** Reload configuration cache. Ignored if cache is being currently loaded. Active Zabbix proxy will connect to the Zabbix server and request configuration data. Default configuration file (unless **-c** option is specified) will be used to find PID file and signal will be sent to process, listed in PID file. **snmp\_cache\_reload** Reload SNMP cache. **housekeeper\_execute** Execute the housekeeper. Ignored if housekeeper is being currently executed. **diaginfo**\[=*section*\] Log internal diagnostic information of the specified section. Section can be *historycache*, *preprocessing*. By default diagnostic information of all sections is logged. **log\_level\_increase**\[=*target*\] Increase log level, affects all processes if target is not specified. **log\_level\_decrease**\[=*target*\] Decrease log level, affects all processes if target is not specified. [ ]{#lbAG} ### گزینه های کنترل زمان اجرا **config\_cache\_reload** بارگذاری مجدد کش پیکربندی اگر کش در حال بارگیری باشد نادیده گرفته می شود. پروکسی فعال Zabbix به سرور Zabbix متصل می شود و درخواست می کند داده های پیکربندی فایل پیکربندی پیش فرض (مگر اینکه گزینه **-c** باشد مشخص شده) برای یافتن فایل PID استفاده می شود و سیگنال به آن ارسال می شود فرآیند، در فایل PID فهرست شده است. **snmp\_cache\_reload** بارگیری مجدد حافظه پنهان SNMP. **خانه دار\_اجرا** خانه دار را اعدام کنید. اگر در حال حاضر خانه دار باشد نادیده گرفته می شود اجرا شده. **اطلاعات دیاگ**\[=*بخش*\] اطلاعات تشخیصی داخلی بخش مشخص شده را ثبت کنید. بخش می تواند *historycache*، *preprocessing* باشد. به طور پیش فرض تشخیصی اطلاعات تمام بخش ها ثبت می شود. **ورود\_سطح\_افزایش**\[=*هدف*\] اگر هدف مشخص نشده باشد، سطح گزارش را افزایش دهید، بر همه فرآیندها تأثیر می گذارد. **ورود\_سطح\_کاهش**\[=*هدف*\] سطح گزارش را کاهش دهید، اگر هدف مشخص نشده باشد، بر تمام فرآیندها تأثیر می گذارد. [ ]{#lbAG} # script.create #ساخت اسکریپت ### See also - [Action filter](object#action_filter) - [Action operation](object#action_operation) ### همچنین ببینید - [Action filter](object#action_filter) - [عملیات عمل] (شیء#عمل_عملی) ### See also - [Action filter](object#action_filter) - [Action operation](object#action_operation) ### همچنین ببینید - [Action filter](object#action_filter) - [عملیات عمل] (شیء#عمل_عملی) ### See also - [Alert](/manual/api/reference/alert/object) - [Item](/manual/api/reference/item/object) - [Host](/manual/api/reference/host/object) - [LLD rule](/manual/api/reference/discoveryrule/object#lld_rule) - [Trigger](/manual/api/reference/trigger/object) ### همچنین ببینید - [Alert](/manual/api/reference/alert/object) - [Item](/manual/api/reference/item/object) - [Host](/manual/api/reference/host/object) - [LLD rule](/manual/api/reference/discoveryrule/object#lld_rule) - [Trigger](/manual/api/reference/trigger/object) ### See also - [Audit log object](/manual/api/reference/auditlog/object) ### همچنین ببینید - [ابژه گزارش حسابرسی](/دستی/api/reference/auditlog/object) ### See also - [Correlation filter](object#correlation_filter) - [Correlation operation](object#correlation_operation) ### همچنین ببینید - [فیلتر همبستگی](شیء#همبستگی_فیلتر) - [عملیات همبستگی] (object#correlation_operation) ### See also - [Correlation filter](object#correlation_filter) - [Correlation operation](object#correlation_operation) ### همچنین ببینید - [فیلتر همبستگی](شیء#همبستگی_فیلتر) - [عملیات همبستگی] (object#correlation_operation) ### See also - [Correlation filter](object#correlation_filter) - [Correlation operation](object#correlation_operation) ### همچنین ببینید - [فیلتر همبستگی](شیء#همبستگی_فیلتر) - [عملیات همبستگی] (object#correlation_operation) ### See also - [Dashboard page](object#dashboard_page) - [Dashboard widget](object#dashboard_widget) - [Dashboard widget field](object#dashboard_widget_field) - [Dashboard user](object#dashboard_user) - [Dashboard user group](object#dashboard_user_group) ###همچنین ببینید : - [Dashboard page](object#dashboard_page) - [Dashboard widget](object#dashboard_widget) - [Dashboard widget field](object#dashboard_widget_field) - [Dashboard user](object#dashboard_user) - [Dashboard user group](object#dashboard_user_group) ### See also - [Dashboard page](object#dashboard_page) - [Dashboard widget](object#dashboard_widget) - [Dashboard widget field](object#dashboard_widget_field) - [Dashboard user](object#dashboard_user) - [Dashboard user group](object#dashboard_user_group) ###همچنین ببینید : - [Dashboard page](object#dashboard_page) - [Dashboard widget](object#dashboard_widget) - [Dashboard widget field](object#dashboard_widget_field) - [Dashboard user](object#dashboard_user) - [Dashboard user group](object#dashboard_user_group) ### See also - [Dashboard page](object#dashboard_page) - [Dashboard widget](object#dashboard_widget) - [Dashboard widget field](object#dashboard_widget_field) - [Dashboard user](object#dashboard_user) - [Dashboard user group](object#dashboard_user_group) ###همچنین ببینید : - [Dashboard page](object#dashboard_page) - [Dashboard widget](object#dashboard_widget) - [Dashboard widget field](object#dashboard_widget_field) - [Dashboard user](object#dashboard_user) - [Dashboard user group](object#dashboard_user_group) ### See also - [Discovered host](/manual/api/reference/dhost/object#discovered_host) - [Discovery check](/manual/api/reference/dcheck/object#discovery_check) ### همچنین ببینید - [Discovered host](/manual/api/reference/dhost/object#discovered_host) - [Discovery check](/manual/api/reference/dcheck/object#discovery_check) ### See also - [Discovered host](/manual/api/reference/dhost/object#discovered_host) - [Discovery check](/manual/api/reference/dcheck/object#discovery_check) - [Host](/manual/api/reference/host/object#host) ### همچنین ببینید - [Discovered host](/manual/api/reference/dhost/object#discovered_host) - [Discovery check](/manual/api/reference/dcheck/object#discovery_check) - [Host](/manual/api/reference/host/object#host) ### See also - [Discovered service](/manual/api/reference/dservice/object#discovered_service) - [Discovery rule](/manual/api/reference/drule/object#discovery_rule) ### همچنین ببینید - [Discovered service](/manual/api/reference/dservice/object#discovered_service) - [Discovery rule](/manual/api/reference/drule/object#discovery_rule) ### See also - [Discovery check](/manual/api/reference/dcheck/object#discovery_check) ### همچنین ببینید - [Discovery check](/manual/api/reference/dcheck/object#discovery_check) ### See also - [Discovery check](/manual/api/reference/dcheck/object#discovery_check) ### همچنین ببینید - [Discovery check](/manual/api/reference/dcheck/object#discovery_check) ## SEE ALSO Documentation <https://www.zabbix.com/manuals> **[zabbix\_agent2](zabbix_agent2)**(8), **[zabbix\_agentd](zabbix_agentd)**(8), **[zabbix\_get](zabbix_get)**(1), **[zabbix\_proxy](zabbix_proxy)**(8), **[zabbix\_sender](zabbix_sender)**(1), **[zabbix\_server](zabbix_server)**(8) ------------------------------------------------------------------------ [ ]{#index} ## همچنین ببینید مستندات <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8)، ***[zabbix\_get](zabbix_get)**(8)، **[zabbix\_js](zabbix_js)**(8)، **[zabbix\_proxy](zabbix_proxy)**(8) **[zabbix\_sender](zabbix_sender)**(8) ***[zabbix\_server](zabbix_server)**(8) [ ]{#lbAI} ## SEE ALSO Documentation <https://www.zabbix.com/manuals> **[zabbix\_agent2](zabbix_agent2)**(8), **[zabbix\_get](zabbix_get)**(1), **[zabbix\_js](zabbix_js)**(1), **[zabbix\_proxy](zabbix_proxy)**(8), **[zabbix\_sender](zabbix_sender)**(1), **[zabbix\_server](zabbix_server)**(8) [ ]{#lbAJ} ## همچنین ببینید مستندات <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8)، ***[zabbix\_get](zabbix_get)**(8)، **[zabbix\_js](zabbix_js)**(8)، **[zabbix\_proxy](zabbix_proxy)**(8) **[zabbix\_sender](zabbix_sender)**(8) ***[zabbix\_server](zabbix_server)**(8) [ ]{#lbAI} ## SEE ALSO Documentation <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8), **[zabbix\_get](zabbix_get)**(1), **[zabbix\_proxy](zabbix_proxy)**(8), **[zabbix\_sender](zabbix_sender)**(1), **[zabbix\_js](zabbix_js)**(1), **[zabbix\_agent2](zabbix_agent2)**(8) [ ]{#lbAJ} ## همچنین ببینید مستندات <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8)، ***[zabbix\_get](zabbix_get)**(1)، **[zabbix\_proxy](zabbix_proxy)**(8)، ***[zabbix\_sender](zabbix_sender)**(1)، **[zabbix\_js](zabbix_js)**(1)، ***[zabbix\_agent2](zabbix_agent2)**(8) [ ]{#lbAJ} ## SEE ALSO Documentation <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8), **[zabbix\_get](zabbix_get)**(1), **[zabbix\_proxy](zabbix_proxy)**(8), **[zabbix\_sender](zabbix_sender)**(1), **[zabbix\_server](zabbix_server)**(8), **[zabbix\_js](zabbix_js)**(1), **[zabbix\_agent2](zabbix_agent2)**(8) [ ]{#lbAH} ## همچنین ببینید مستندات <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8)، ***[zabbix\_get](zabbix_get)**(1)، **[zabbix\_proxy](zabbix_proxy)**(8)، **[zabbix\_sender](zabbix_sender)**(1)، **[zabbix\_server](zabbix_server)**(8)، **[zabbix\_js](zabbix_js)**(1)، ***[zabbix\_agent2](zabbix_agent2)**(8) [ ]{#lbAH} ## SEE ALSO Documentation <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8), **[zabbix\_get](zabbix_get)**(1), **[zabbix\_proxy](zabbix_proxy)**(8), **[zabbix\_server](zabbix_server)**(8), **[zabbix\_js](zabbix_js)**(1), **[zabbix\_agent2](zabbix_agent2)**(8), **[zabbix\_web\_service](zabbix_web_service)**(8) [ ]{#lbAJ} ## همچنین ببینید مستندات <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8)، ***[zabbix\_get](zabbix_get)**(8)، **[zabbix\_js](zabbix_js)**(8)، **[zabbix\_proxy](zabbix_proxy)**(8) **[zabbix\_sender](zabbix_sender)**(8) ***[zabbix\_server](zabbix_server)**(8) [ ]{#lbAI} ## SEE ALSO Documentation <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8), **[zabbix\_get](zabbix_get)**(1), **[zabbix\_sender](zabbix_sender)**(1), **[zabbix\_server](zabbix_server)**(8), **[zabbix\_js](zabbix_js)**(1), **[zabbix\_agent2](zabbix_agent2)**(8) [ ]{#lbAJ} ## همچنین ببینید مستندات <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8)، ***[zabbix\_get](zabbix_get)**(8)، **[zabbix\_js](zabbix_js)**(8)، **[zabbix\_proxy](zabbix_proxy)**(8) **[zabbix\_sender](zabbix_sender)**(8) ***[zabbix\_server](zabbix_server)**(8) [ ]{#lbAI} ## SEE ALSO Documentation <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8), **[zabbix\_get](zabbix_get)**(8), **[zabbix\_js](zabbix_js)**(8), **[zabbix\_proxy](zabbix_proxy)**(8), **[zabbix\_sender](zabbix_sender)**(8), **[zabbix\_server](zabbix_server)**(8) [ ]{#lbAI} ## همچنین ببینید مستندات <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8)، ***[zabbix\_get](zabbix_get)**(8)، **[zabbix\_js](zabbix_js)**(8)، **[zabbix\_proxy](zabbix_proxy)**(8) **[zabbix\_sender](zabbix_sender)**(8) ***[zabbix\_server](zabbix_server)**(8) [ ]{#lbAI} ## SEE ALSO Documentation <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8), **[zabbix\_proxy](zabbix_proxy)**(8), **[zabbix\_sender](zabbix_sender)**(1), **[zabbix\_server](zabbix_server)**(8), **[zabbix\_js](zabbix_js)**(1), **[zabbix\_agent2](zabbix_agent2)**(8), **[zabbix\_web\_service](zabbix_web_service)**(8) [ ]{#lbAI} ## همچنین ببینید مستندات <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8)، ***[zabbix\_get](zabbix_get)**(8)، **[zabbix\_js](zabbix_js)**(8)، **[zabbix\_proxy](zabbix_proxy)**(8) **[zabbix\_sender](zabbix_sender)**(8) ***[zabbix\_server](zabbix_server)**(8) [ ]{#lbAI} ### See also - [Graph item](/manual/api/reference/graphitem/object#graph_item) ### همچنین ببینید - [Graph item](/manual/api/reference/graphitem/object#graph_item) ### See also - [Graph item](/manual/api/reference/graphitem/object#graph_item) ### همچنین ببینید - [Graph item](/manual/api/reference/graphitem/object#graph_item) ### See also - [Graph](/manual/api/reference/graph/object#graph) ### همچنین ببینید - [Graph item](/manual/api/reference/graphitem/object#graph_item) ### See also - [Graph prototype](/manual/api/reference/graphprototype/object#graph_prototype) - [Host](/manual/api/reference/host/object#host) - [Item prototype](/manual/api/reference/itemprototype/object#item_prototype) - [LLD rule filter](object#lld_rule_filter) - [Trigger prototype](/manual/api/reference/triggerprototype/object#trigger_prototype) ### همچنین ببینید - [Graph prototype](/manual/api/reference/graphprototype/object#graph_prototype) - [Host](/manual/api/reference/host/object#host) - [Item prototype](/manual/api/reference/itemprototype/object#item_prototype) - [LLD rule filter](object#lld_rule_filter) - [Trigger prototype](/manual/api/reference/triggerprototype/object#trigger_prototype) ### See also - [Group link](object#group_link) - [Group prototype](object#group_prototype) - [Host prototype tag](object#host_prototype_tag) - [Custom interface](object#custom_interface) - [User macro](/manual/api/reference/usermacro/object#hosttemplate_level_macro) ###همچنین ببینید - [Group link](object#group_link) - [Group prototype](object#group_prototype) - [Host prototype tag](object#host_prototype_tag) - [Custom interface](object#custom_interface) - [User macro](/manual/api/reference/usermacro/object#hosttemplate_level_macro) ### See also - [Group link](object#group_link) - [Group prototype](object#group_prototype) - [Host prototype tag](object#host_prototype_tag) - [Custom interface](object#custom_interface) - [User macro](/manual/api/reference/usermacro/object#hosttemplate_level_macro) ### همچنین ببینید - [Group link](object#group_link) - [Group prototype](object#group_prototype) - [Host prototype tag](object#host_prototype_tag) - [Custom interface](object#custom_interface) - [User macro](/manual/api/reference/usermacro/object#hosttemplate_level_macro) ### See also - [Group link](object#group_link) - [Group prototype](object#group_prototype) - [User macro](/manual/api/reference/usermacro/object#hosttemplate_level_macro) ###همچنین ببینید - [Group link](object#group_link) - [Group prototype](object#group_prototype) - [User macro](/manual/api/reference/usermacro/object#hosttemplate_level_macro) ### See also - [hostinterface.create](create) - [host.massadd](/manual/api/reference/host/massadd) - [Host](/manual/api/reference/host/object#host) ### همچنین ببینید - [hostinterface.create](create) - [host.massadd](/manual/api/reference/host/massadd) - [Host](/manual/api/reference/host/object#host) ### See also - [hostinterface.delete](delete) - [host.massremove](/manual/api/reference/host/massremove) ### همچنین ببینید - [hostinterface.delete](delete) - [host.massremove](/manual/api/reference/host/massremove) ### See also - [hostinterface.massadd](massadd) - [host.massadd](/manual/api/reference/host/massadd) ### همچنین ببینید - [hostinterface.massadd](massadd) - [host.massadd](/manual/api/reference/host/massadd) ### See also - [hostinterface.massremove](massremove) - [host.massremove](/manual/api/reference/host/massremove) ### همچنین ببینید - [hostinterface.massremove](massremove) - [host.massremove](/manual/api/reference/host/massremove) ### See also - [Host](/manual/api/reference/host/object#host) - [Item](/manual/api/reference/item/object#item) ###همچنین ببینید - [Host](/manual/api/reference/host/object#host) - [Item](/manual/api/reference/item/object#item) ### See also - [Host](/manual/api/reference/host/object#host) - [Media type](/manual/api/reference/mediatype/object#media_type) - [User](/manual/api/reference/user/object#user) ### همچنین ببینید - [میزبان](/دستی/api/reference/host/object#host) - [نوع رسانه](/دستی/api/reference/mediatype/object#media_type) - [کاربر](/دستی/api/reference/user/object#user) ### See also - [Host](/manual/api/reference/host/object#host) - [Scenario step](object#scenario_step) ### همچنین ببینید - [Host](/manual/api/reference/host/object#host) - [Scenario step](object#scenario_step) ### See also - [host.update](/manual/api/reference/host/update) - [host.massupdate](/manual/api/reference/host/massupdate) ### همچنین ببینید - [host.update](/manual/api/reference/host/update) - [host.massupdate](/manual/api/reference/host/massupdate) ### See also - [host.update](update) - [Host group](/manual/api/reference/hostgroup/object#host_group) - [Template](/manual/api/reference/template/object#template) - [User macro](/manual/api/reference/usermacro/object#hosttemplate_level_macro) - [Host interface](/manual/api/reference/hostinterface/object#host_interface) ### همچنین ببینید - [host.update](update) - [Host group](/manual/api/reference/hostgroup/object#host_group) - [Template](/manual/api/reference/template/object#template) - [User macro](/manual/api/reference/usermacro/object#hosttemplate_level_macro) - [Host interface](/manual/api/reference/hostinterface/object#host_interface) ### See also - [host.update](update) - [host.massadd](massadd) - [host.massremove](massremove) - [Host group](/manual/api/reference/hostgroup/object#host_group) - [Template](/manual/api/reference/template/object#host_group) - [User macro](/manual/api/reference/usermacro/object#hosttemplate_level_macro) - [Host interface](/manual/api/reference/hostinterface/object#host_interface) ### همچنین ببینید - [host.update](update) - [host.massadd](massadd) - [host.massremove](massremove) - [Host group](/manual/api/reference/hostgroup/object#host_group) - [Template](/manual/api/reference/template/object#host_group) - [User macro](/manual/api/reference/usermacro/object#hosttemplate_level_macro) - [Host interface](/manual/api/reference/hostinterface/object#host_interface) ### See also - [host.update](update) - [User macro](/manual/api/reference/usermacro/object#hosttemplate_level_macro) - [Host interface](/manual/api/reference/hostinterface/object#host_interface) ### همچنین ببینید - [host.update](update) - [User macro](/manual/api/reference/usermacro/object#hosttemplate_level_macro) - [Host interface](/manual/api/reference/hostinterface/object#host_interface) ### See also - [Icon mapping](object#icon_mapping) ### همچنین ببینید - [اختصاص آیکون] (آبجکت#اختصاص آیکون) ### See also - [Icon mapping](object#icon_mapping) ### همچنین ببینید - [اختصاص آیکون] (آبجکت#اختصاص آیکون) ### See also - [Icon mapping](object#icon_mapping) ### همچنین ببینید - [اختصاص آیکون] (آبجکت#اختصاص آیکون) ### See also - [LLD rule filter](object#lld_rule_filter) - [LLD macro paths](object#lld_macro_path) - [LLD rule preprocessing](object#lld_rule_preprocessing) ### همچنین ببینید - [LLD rule filter](object#lld_rule_filter) - [LLD macro paths](object#lld_macro_path) - [LLD rule preprocessing](object#lld_rule_preprocessing) ### See also - [Scenario step](object#scenario_step) ###همچنین ببینید - [Scenario step](object#scenario_step) ### See also - [Scenario step](object#scenario_step) ###همچنین ببینید - [Scenario step](object#scenario_step) ### Source CAction::create() in *ui/include/classes/api/services/CAction.php*. ### منبع CAction::create() در *ui/include/classes/api/services/CAction.php*. ### Source CAction::delete() in *ui/include/classes/api/services/CAction.php*. ### منبع CAction::delete() در *ui/include/classes/api/services/CAction.php*. ### Source CAction::get() in *ui/include/classes/api/services/CAction.php*. ### منبع CAction::get() در *ui/include/classes/api/services/CAction.php*. ### Source CAction::update() in *ui/include/classes/api/services/CAction.php*. ### منبع CAction::update() در *ui/include/classes/api/services/CAction.php*. ### Source CAlert::get() in *ui/include/classes/api/services/CAlert.php*. ### منبع CAlert::get() در *ui/include/classes/api/services/CAlert.php*. ### Source CAPIInfo::version() in *ui/include/classes/api/services/CAPIInfo.php*. ### منبع CAPIInfo::version() در *ui/include/classes/api/services/CAPIInfo.php*. ### Source CAuditLog::get() in *ui/include/classes/api/services/CAuditLog.php*. ### منبع CAuditLog::get() در *ui/include/classes/api/services/CAuditLog.php*. ### Source CAutoregistration::get() in *ui/include/classes/api/services/CAutoregistration.php*. ### منبع CIconMap::update() در *ui/include/classes/api/services/CIconMap.php*. ### Source CAutoregistration::update() in *ui/include/classes/api/services/CAutoregistration.php*. ### منبع CIconMap::update() در *ui/include/classes/api/services/CIconMap.php*. ### Source CConfiguration::export() in *ui/include/classes/api/services/CConfiguration.php*. ### منبع CIconMap::update() در *ui/include/classes/api/services/CIconMap.php*. ### Source CConfiguration::importcompare() in *ui/include/classes/api/services/CConfiguration.php*. ### منبع CIconMap::update() در *ui/include/classes/api/services/CIconMap.php*. ### Source CConfiguration::import() in *ui/include/classes/api/services/CConfiguration.php*. ### منبع CIconMap::update() در *ui/include/classes/api/services/CIconMap.php*. ### Source CCorrelation::create() in *ui/include/classes/api/services/CCorrelation.php*. ### منبع CIconMap::update() در *ui/include/classes/api/services/CIconMap.php*. ### Source CCorrelation::delete() in *ui/include/classes/api/services/CCorrelation.php*. ### منبع CCCorrelation::delete() در *ui/include/classes/api/services/CCorrelation.php*. ### Source CCorrelation::get() in *ui/include/classes/api/services/CCorrelation.php*. ### منبع CCorrelation::get() in *ui/include/classes/api/services/CCorrelation.php*. ### Source CCorrelation::update() in *ui/include/classes/api/services/CCorrelation.php*. ### منبع CCCorrelation::update() در *ui/include/classes/api/services/CCorrelation.php*. ### Source CDashboard::create() in *ui/include/classes/api/services/CDashboard.php*. ### منبع CDashboard::create() in *ui/include/classes/api/services/CDashboard.php*. ### Source CDashboard::delete() in *ui/include/classes/api/services/CDashboard.php*. ### منبع CDashboard::delete() in *ui/include/classes/api/services/CDashboard.php*. ### Source CDashboard::get() in *ui/include/classes/api/services/CDashboard.php*. ### منبع CDashboard::get() in *ui/include/classes/api/services/CDashboard.php*. ### Source CDashboard::update() in *ui/include/classes/api/services/CDashboard.php*. ### منبع CDashboard::update() in *ui/include/classes/api/services/CDashboard.php*. ### Source CDCheck::get() in *ui/include/classes/api/services/CDCheck.php*. ### منبع CDCheck::get() in *ui/include/classes/api/services/CDCheck.php*. ### Source CDHost::get() in *ui/include/classes/api/services/CDHost.php*. ### منبع CDHost::get() in *ui/include/classes/api/services/CDHost.php*. ### Source CDiscoveryRule::create() in *ui/include/classes/api/services/CDiscoveryRule.php*. ### منبع CDiscoveryrule::copy() in *ui/include/classes/api/services/CDiscoveryRule.php*. ### Source CDiscoveryRule::delete() in *ui/include/classes/api/services/CDiscoveryRule.php*. ### منبع CDiscoveryrule::copy() in *ui/include/classes/api/services/CDiscoveryRule.php*. ### Source CDiscoveryRule::get() in *ui/include/classes/api/services/CDiscoveryRule.php*. ### منبع CDiscoveryrule::copy() in *ui/include/classes/api/services/CDiscoveryRule.php*. ### Source CDiscoveryRule::update() in *ui/include/classes/api/services/CDiscoveryRule.php*. ### منبع CDiscoveryrule::copy() in *ui/include/classes/api/services/CDiscoveryRule.php*. ### Source CDRule::create() in *ui/include/classes/api/services/CDRule.php*. ### منابع CDRule::create() in *ui/include/classes/api/services/CDRule.php*. ### Source CDRule::delete() in *ui/include/classes/api/services/CDRule.php*. ### منبع CDRule::delete() in *ui/include/classes/api/services/CDRule.php*. ### Source CDRule::get() in *ui/include/classes/api/services/CDRule.php*. ### منبع CDRule::get() in *ui/include/classes/api/services/CDRule.php*. ### Source CDRule::update() in *ui/include/classes/api/services/CDRule.php*. ### منبع CDRule::update() in *ui/include/classes/api/services/CDRule.php*. ### Source CDService::get() in *ui/include/classes/api/services/CDService.php*. ### منبع CDService::get() in *ui/include/classes/api/services/CDService.php*. ### Source CEvent::acknowledge() in *ui/include/classes/api/services/CEvent.php*. ### منبع CEvent::acknowledge() in *ui/include/classes/api/services/CEvent.php*. ### Source CEvent::get() in *ui/include/classes/api/services/CEvent.php*. ### منبع CEvent::get() in *ui/include/classes/api/services/CEvent.php*. ### Source CGraph::create() in *ui/include/classes/api/services/CGraph.php*. منبع ### Source CGraph::delete() in *ui/include/classes/api/services/CGraph.php*. ### منبع CGraph::delete() in *ui/include/classes/api/services/CGraph.php*. ### Source CGraph::get() in *ui/include/classes/api/services/CGraph.php*. ### منبع CGraph::get() in *ui/include/classes/api/services/CGraph.php*. ### Source CGraphItem::get() in *ui/include/classes/api/services/CGraphItem.php*. ### منبع CGraphItem::get() in *ui/include/classes/api/services/CGraphItem.php*. ### Source CGraphPrototype::create() in *ui/include/classes/api/services/CGraphPrototype.php*. ### منبع CGraphPrototype::create() in *ui/include/classes/api/services/CGraphPrototype.php*. ### Source CGraphPrototype::delete() in *ui/include/classes/api/services/CGraphPrototype.php*. ### منبع CGraphPrototype::delete() in *ui/include/classes/api/services/CGraphPrototype.php*. ### Source CGraphPrototype::get() in *ui/include/classes/api/services/CGraphPrototype.php*. ### منبع CGraphPrototype::get() in *ui/include/classes/api/services/CGraphPrototype.php*. ### Source CGraphPrototype::update() in *ui/include/classes/api/services/CGraphPrototype.php*. ### منبع CGraphPrototype::update() in *ui/include/classes/api/services/CGraphPrototype.php*. ### Source CGraph::update() in *ui/include/classes/api/services/CGraph.php*. ### منبع CGraph::update() in *ui/include/classes/api/services/CGraph.php*. ### Source CHaNode::get() in *ui/include/classes/api/services/CHaNode.php*. ### منبع CHaNode::get() in *ui/include/classes/api/services/CHaNode.php*. ### Source CHistory::clear() in *ui/include/classes/api/services/CHistory.php*. ### منبع CHistory::clear() in *ui/include/classes/api/services/CHistory.php*. ### Source CHistory::get() in *ui/include/classes/api/services/CHistory.php*. ###منبع CHistory::get() in *ui/include/classes/api/services/CHistory.php*. ### Source CHost::create() in *ui/include/classes/api/services/CHost.php*. ### منبع CHost::create() in *ui/include/classes/api/services/CHost.php*. ### Source CHost::delete() in *ui/include/classes/api/services/CHost.php*. ###منبع CHost::delete() in *ui/include/classes/api/services/CHost.php*. ### Source CHost::get() in *ui/include/classes/api/services/CHost.php*. ### منبع CDHost::get() in *ui/include/classes/api/services/CDHost.php*. ### Source CHostGroup::create() in *ui/include/classes/api/services/CHostGroup.php*. ### منبع CHostGroup::create() in *ui/include/classes/api/services/CHostGroup.php*. ### Source CHostGroup::delete() in *ui/include/classes/api/services/CHostGroup.php*. ### منبع CHostGroup::create() in *ui/include/classes/api/services/CHostGroup.php*. ### Source CHostGroup::get() in *ui/include/classes/api/services/CHostGroup.php*. ### منبع CHostGroup::get() in *ui/include/classes/api/services/CHostGroup.php*. ### Source CHostGroup::massAdd() in *ui/include/classes/api/services/CHostGroup.php*. ### منبع CHostGroup::massAdd() in *ui/include/classes/api/services/CHostGroup.php*. ### Source CHostGroup::massRemove() in *ui/include/classes/api/services/CHostGroup.php*. ### منبع CHostGroup::massRemove() in *ui/include/classes/api/services/CHostGroup.php*. ### Source CHostGroup::massUpdate() in *ui/include/classes/api/services/CHostGroup.php*. ### منبع CHostGroup::massUpdate() in *ui/include/classes/api/services/CHostGroup.php*. ### Source CHostGroup::update() in *ui/include/classes/api/services/CHostGroup.php*. ### منبع CHostGroup::update() in *ui/include/classes/api/services/CHostGroup.php*. ### Source CHostInterface::create() in *ui/include/classes/api/services/CHostInterface.php*. ### منبع CHostInterface::create() in *ui/include/classes/api/services/CHostInterface.php*. ### Source CHostInterface::delete() in *ui/include/classes/api/services/CHostInterface.php*. ###منبع CHostInterface::delete() in *ui/include/classes/api/services/CHostInterface.php*. ### Source CHostInterface::get() in *ui/include/classes/api/services/CHostInterface.php*. ### منبع CHostInterface::get() in *ui/include/classes/api/services/CHostInterface.php*. ### Source CHostInterface::massAdd() in *ui/include/classes/api/services/CHostInterface.php*. ### منبع CHostInterface::massAdd() in *ui/include/classes/api/services/CHostInterface.php*. ### Source CHostInterface::massRemove() in *ui/include/classes/api/services/CHostInterface.php*. ### منبع CHostInterface::massRemove() in *ui/include/classes/api/services/CHostInterface.php*. ### Source CHostInterface::replaceHostInterfaces() in *ui/include/classes/api/services/CHostInterface.php*. ### منبع CHostInterface::replaceHostInterfaces() in *ui/include/classes/api/services/CHostInterface.php*. ### Source CHostInterface::update() in *ui/include/classes/api/services/CHostInterface.php*. ### منبع CHostInterface::update() in *ui/include/classes/api/services/CHostInterface.php*. ### Source CHost::massAdd() in *ui/include/classes/api/services/CHost.php*. ### منبع CHost::massAdd() in *ui/include/classes/api/services/CHost.php*. ### Source CHost::massRemove() in *ui/include/classes/api/services/CHost.php*. ### منبع CHost::massRemove() in *ui/include/classes/api/services/CHost.php*. ### Source CHost::massUpdate() in *ui/include/classes/api/services/CHost.php*. ### منبع CHost::massUpdate() in *ui/include/classes/api/services/CHost.php*. ### Source CHostPrototype::create() in *ui/include/classes/api/services/CHostPrototype.php*. ###منبع CHostPrototype::create() in *ui/include/classes/api/services/CHostPrototype.php*. ### Source CHostPrototype::delete() in *ui/include/classes/api/services/CHostPrototype.php*. ### منبع CHostPrototype::delete() in *ui/include/classes/api/services/CHostPrototype.php*. ### Source CHostPrototype::get() in *ui/include/classes/api/services/CHostPrototype.php*. ###منبع CHostPrototype::get() in *ui/include/classes/api/services/CHostPrototype.php*. ### Source CHostPrototype::update() in *ui/include/classes/api/services/CHostPrototype.php*. ### منبع CHostPrototype::update() in *ui/include/classes/api/services/CHostPrototype.php*. ### Source CHost::update() in *ui/include/classes/api/services/CHost.php*. ### منبع CHost::create() in *ui/include/classes/api/services/CHost.php*. ### Source CHousekeeping ::get() in *ui/include/classes/api/services/CHousekeeping.php*. ### منبع CHousekeeping ::get() in *ui/include/classes/api/services/CHousekeeping.php*. ### Source CHousekeeping::update() in *ui/include/classes/api/services/CHousekeeping.php*. ### منبع CHousekeeping::update() in *ui/include/classes/api/services/CHousekeeping.php*. ### Source CHttpTest::create() in *ui/include/classes/api/services/CHttpTest.php*. ### منبع CHttpTest::create() in *ui/include/classes/api/services/CHttpTest.php*. ### Source CHttpTest::delete() in *ui/include/classes/api/services/CHttpTest.php*. ###منبع CHttpTest::delete() in *ui/include/classes/api/services/CHttpTest.php*. ### Source CHttpTest::get() in *ui/include/classes/api/services/CHttpTest.php*. ###منبع CHttpTest::get() in *ui/include/classes/api/services/CHttpTest.php*. ### Source CHttpTest::update() in *ui/include/classes/api/services/CHttpTest.php*. ###منبع CHttpTest::update() in *ui/include/classes/api/services/CHttpTest.php*. ### Source CIconMap::create() in *ui/include/classes/api/services/CIconMap.php*. ### منبع CIconMap::update() در *ui/include/classes/api/services/CIconMap.php*. ### Source CIconMap::delete() in *ui/include/classes/api/services/CIconMap.php*. ###منبع CIconMap::delete() in *ui/include/classes/api/services/CIconMap.php*. ### Source CIconMap::get() in *ui/include/classes/api/services/CIconMap.php*. ### منبع CIconMap::update() در *ui/include/classes/api/services/CIconMap.php*. ### Source CIconMap::update() in *ui/include/classes/api/services/CIconMap.php*. ### منبع CIconMap::update() در *ui/include/classes/api/services/CIconMap.php*. ### Source CImage::create() in *ui/include/classes/api/services/CImage.php*. ### منبع CImage::create() in *ui/include/classes/api/services/CImage.php*. ### Source CScript::create() in *ui/include/classes/api/services/CScript.php*. ### منبع CIconMap::update() در *ui/include/classes/api/services/CIconMap.php*. ### Source CTemplate::create() in *ui/include/classes/api/services/CTemplate.php*. ### منبع CTemplate::create() in *ui/include/classes/api/services/CTemplate.php*. ### String history The string history object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |clock|timestamp|Time when that value was received.| |itemid|string|ID of the related item.| |ns|integer|Nanoseconds when the value was received.| |value|string|Received value.| ### تاریخچه رشته The string history object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |clock|timestamp|Time when that value was received.| |itemid|string|ID of the related item.| |ns|integer|Nanoseconds when the value was received.| |value|string|Received value.| ## SYNOPSIS **zabbix\_agent2** \[**-c** *config-file*\]\ **zabbix\_agent2** \[**-c** *config-file*\] **-p**\ **zabbix\_agent2** \[**-c** *config-file*\] **-t** *item-key*\ **zabbix\_agent2** \[**-c** *config-file*\] **-R** *runtime-option*\ **zabbix\_agent2 -h**\ **zabbix\_agent2 -V**\ \ [ ]{#lbAD} ## خلاصه **zabbix\_agent2** \[**-c** *config-file*\]\ **zabbix\_agent2** \[**-c** *config-file*\] **-p**\ **zabbix\_agent2** \[**-c** *config-file*\] **-t** *item-key*\ **zabbix\_agent2** \[**-c** *config-file*\] **-R** *runtime-option*\ **zabbix\_agent2 -h**\ **zabbix\_agent2 -V**\ \ [ ]{#lbAD} ## SYNOPSIS **zabbix\_agentd** \[**-c** *config-file*\]\ **zabbix\_agentd** \[**-c** *config-file*\] **-p**\ **zabbix\_agentd** \[**-c** *config-file*\] **-t** *item-key*\ **zabbix\_agentd** \[**-c** *config-file*\] **-R** *runtime-option*\ **zabbix\_agentd -h**\ **zabbix\_agentd -V** [ ]{#lbAD} ## خلاصه **zabbix\_agent2** \[**-c** *config-file*\]\ **zabbix\_agent2** \[**-c** *config-file*\] **-p**\ **zabbix\_agent2** \[**-c** *config-file*\] **-t** *item-key*\ **zabbix\_agent2** \[**-c** *config-file*\] **-R** *runtime-option*\ **zabbix\_agent2 -h**\ **zabbix\_agent2 -V**\ \ [ ]{#lbAD} ## SYNOPSIS **zabbix\_get -s** *host-name-or-IP* \[**-p** *port-number*\] \[**-I** *IP-address*\] \[**-t** *timeout*\] **-k** *item-key*\ **zabbix\_get -s** *host-name-or-IP* \[**-p** *port-number*\] \[**-I** *IP-address*\] \[**-t** *timeout*\] **--tls-connect** **cert** **--tls-ca-file** *CA-file* \[**--tls-crl-file** *CRL-file*\] \[**--tls-agent-cert-issuer** *cert-issuer*\] \[**--tls-agent-cert-subject** *cert-subject*\] **--tls-cert-file** *cert-file* **--tls-key-file** *key-file* \[**--tls-cipher13** *cipher-string*\] \[**--tls-cipher** *cipher-string*\] **-k** *item-key*\ **zabbix\_get -s** *host-name-or-IP* \[**-p** *port-number*\] \[**-I** *IP-address*\] \[**-t** *timeout*\] **--tls-connect** **psk** **--tls-psk-identity** *PSK-identity* **--tls-psk-file** *PSK-file* \[**--tls-cipher13** *cipher-string*\] \[**--tls-cipher** *cipher-string*\] **-k** *item-key*\ **zabbix\_get -h**\ **zabbix\_get -V** [ ]{#lbAD} ## نحوه استفاده **zabbix\_get -s** *host-name-or-IP* \[**-p** *port-number*\] \[**-I** *IP-address*\] \[**-t** *timeout*\] **-k** *item-key*\ **zabbix\_get -s** *host-name-or-IP* \[**-p** *port-number*\] \[**-I** *IP-address*\] \[**-t** *timeout*\] **--tls-connect** **cert** **--tls-ca-file** *CA-file* \[**--tls-crl-file** *CRL-file*\] \[**--tls-agent-cert-issuer** *cert-issuer*\] \[**--tls-agent-cert-subject** *cert-subject*\] **--tls-cert-file** *cert-file* **--tls-key-file** *key-file* \[**--tls-cipher13** *cipher-string*\] \[**--tls-cipher** *cipher-string*\] **-k** *item-key*\ **zabbix\_get -s** *host-name-or-IP* \[**-p** *port-number*\] \[**-I** *IP-address*\] \[**-t** *timeout*\] **--tls-connect** **psk** **--tls-psk-identity** *PSK-identity* **--tls-psk-file** *PSK-file* \[**--tls-cipher13** *cipher-string*\] \[**--tls-cipher** *cipher-string*\] **-k** *item-key*\ **zabbix\_get -h**\ **zabbix\_get -V** [ ]{#lbAD} ## SYNOPSIS **zabbix\_js -s** *script-file* **-p** *input-param* \[**-l** *log-level*\] \[**-t** *timeout*\]\ **zabbix\_js -s** *script-file* **-i** *input-file* \[**-l** *log-level*\] \[**-t** *timeout*\]\ **zabbix\_js -h**\ **zabbix\_js -V** [ ]{#lbAD} ## خلاصه **zabbix\_js -s** *اسکریپت-فایل* **-p** *input-param* \[**-l** *log-level*\] \[**-t** *timeout*\]\ **zabbix\_js -s** *script-file* **-i** *input-file* \[**-l** *log-level*\] \[**-t** *timeout*\]\ **zabbix\_js -h**\ **zabbix\_js -V** [ ]{#lbAD} ## SYNOPSIS **zabbix\_proxy** \[**-c** *config-file*\]\ **zabbix\_proxy** \[**-c** *config-file*\] **-R** *runtime-option*\ **zabbix\_proxy -h**\ **zabbix\_proxy -V** [ ]{#lbAD} ## خلاصه **zabbix\_proxy** \[**-c** *config-file*\]\ **zabbix\_proxy** \[**-c** *config-file*\] **-R** *runtime-option*\ **zabbix\_proxy -h**\ **zabbix\_proxy -V** [ ]{#lbAD} ## SYNOPSIS **zabbix\_sender** \[**-v**\] **-z** *server* \[**-p** *port*\] \[**-I** *IP-address*\] \[**-t** *timeout*\] **-s** *host* **-k** *key* **-o** *value*\ **zabbix\_sender** \[**-v**\] **-z** *server* \[**-p** *port*\] \[**-I** *IP-address*\] \[**-t** *timeout*\] \[**-s** *host*\] \[**-T**\] \[**-N**\] \[**-r**\] **-i** *input-file*\ **zabbix\_sender** \[**-v**\] **-c** *config-file* \[**-z** *server*\] \[**-p** *port*\] \[**-I** *IP-address*\] \[**-t** *timeout*\] \[**-s** *host*\] **-k** *key* **-o** *value*\ **zabbix\_sender** \[**-v**\] **-c** *config-file* \[**-z** *server*\] \[**-p** *port*\] \[**-I** *IP-address*\] \[**-t** *timeout*\] \[**-s** *host*\] \[**-T**\] \[**-N**\] \[**-r**\] **-i** *input-file*\ **zabbix\_sender** \[**-v**\] **-z** *server* \[**-p** *port*\] \[**-I** *IP-address*\] \[**-t** *timeout*\] **-s** *host* **--tls-connect** **cert** **--tls-ca-file** *CA-file* \[**--tls-crl-file** *CRL-file*\] \[**--tls-server-cert-issuer** *cert-issuer*\] \[**--tls-server-cert-subject** *cert-subject*\] **--tls-cert-file** *cert-file* **--tls-key-file** *key-file* \[**--tls-cipher13** *cipher-string*\] \[**--tls-cipher** *cipher-string*\] **-k** *key* **-o** *value*\ **zabbix\_sender** \[**-v**\] **-z** *server* \[**-p** *port*\] \[**-I** *IP-address*\] \[**-t** *timeout*\] \[**-s** *host*\] **--tls-connect** **cert** **--tls-ca-file** *CA-file* \[**--tls-crl-file** *CRL-file*\] \[**--tls-server-cert-issuer** *cert-issuer*\] \[**--tls-server-cert-subject** *cert-subject*\] **--tls-cert-file** *cert-file* **--tls-key-file** *key-file* \[**--tls-cipher13** *cipher-string*\] \[**--tls-cipher** *cipher-string*\] \[**-T**\] \[**-N**\] \[**-r**\] **-i** *input-file*\ **zabbix\_sender** \[**-v**\] **-c** *config-file* \[**-z** *server*\] \[**-p** *port*\] \[**-I** *IP-address*\] \[**-t** *timeout*\] \[**-s** *host*\] **--tls-connect** **cert** **--tls-ca-file** *CA-file* \[**--tls-crl-file** *CRL-file*\] \[**--tls-server-cert-issuer** *cert-issuer*\] \[**--tls-server-cert-subject** *cert-subject*\] **--tls-cert-file** *cert-file* **--tls-key-file** *key-file* \[**--tls-cipher13** *cipher-string*\] \[**--tls-cipher** *cipher-string*\] **-k** *key* **-o** *value*\ **zabbix\_sender** \[**-v**\] **-c** *config-file* \[**-z** *server*\] \[**-p** *port*\] \[**-I** *IP-address*\] \[**-t** *timeout*\] \[**-s** *host*\] **--tls-connect** **cert** **--tls-ca-file** *CA-file* \[**--tls-crl-file** *CRL-file*\] \[**--tls-server-cert-issuer** *cert-issuer*\] \[**--tls-server-cert-subject** *cert-subject*\] **--tls-cert-file** *cert-file* **--tls-key-file** *key-file* \[**--tls-cipher13** *cipher-string*\] \[**--tls-cipher** *cipher-string*\] \[**-T**\] \[**-N**\] \[**-r**\] **-i** *input-file*\ **zabbix\_sender** \[**-v**\] **-z** *server* \[**-p** *port*\] \[**-I** *IP-address*\] \[**-t** *timeout*\] **-s** *host* **--tls-connect** **psk** **--tls-psk-identity** *PSK-identity* **--tls-psk-file** *PSK-file* \[**--tls-cipher13** *cipher-string*\] \[**--tls-cipher** *cipher-string*\] **-k** *key* **-o** *value*\ **zabbix\_sender** \[**-v**\] **-z** *server* \[**-p** *port*\] \[**-I** *IP-address*\] \[**-t** *timeout*\] \[**-s** *host*\] **--tls-connect** **psk** **--tls-psk-identity** *PSK-identity* **--tls-psk-file** *PSK-file* \[**--tls-cipher13** *cipher-string*\] \[**--tls-cipher** *cipher-string*\] \[**-T**\] \[**-N**\] \[**-r**\] **-i** *input-file*\ **zabbix\_sender** \[**-v**\] **-c** *config-file* \[**-z** *server*\] \[**-p** *port*\] \[**-I** *IP-address*\] \[**-t** *timeout*\] \[**-s** *host*\] **--tls-connect** **psk** **--tls-psk-identity** *PSK-identity* **--tls-psk-file** *PSK-file* \[**--tls-cipher13** *cipher-string*\] \[**--tls-cipher** *cipher-string*\] **-k** *key* **-o** *value*\ **zabbix\_sender** \[**-v**\] **-c** *config-file* \[**-z** *server*\] \[**-p** *port*\] \[**-I** *IP-address*\] \[**-t** *timeout*\] \[**-s** *host*\] **--tls-connect** **psk** **--tls-psk-identity** *PSK-identity* **--tls-psk-file** *PSK-file* \[**--tls-cipher13** *cipher-string*\] \[**--tls-cipher** *cipher-string*\] \[**-T**\] \[**-N**\] \[**-r**\] **-i** *input-file*\ **zabbix\_sender -h**\ **zabbix\_sender -V** [ ]{#lbAD} ## خلاصه **zabbix\_sender** \[**-v**\] **-z** *سرور* \[**-p** *port*\] \[**-I** *آدرس IP*\] \[**-t** *timeout*\] **-s** *host* **-k** *key* **-o** *ارزش*\ **zabbix\_sender** \[**-v**\] **-z** *سرور* \[**-p** *port*\] \[**-I** *آدرس IP*\] \[**-t** *timeout*\] \[**-s** *host*\] \[**-T**\] \[**-N**\] \[**-r**\] **-i** *input-file*\ **zabbix\_sender** \[**-v**\] **-c** *config-file* \[**-z** *server*\] \[**-p** *port*\] \[**-I** *آدرس IP*\] \[**-t** *timeout*\] \[**-s** *میزبان*\] **-k** *کلید* **-o** *مقدار*\ **zabbix\_sender** \[**-v**\] **-c** *config-file* \[**-z** *server*\] \[**-p** *port*\] \[**-I** *آدرس IP*\] \[**-t** *timeout*\] \[**-s** *میزبان*\] \[**-T**\] \[**-N**\] \[**-r**\] **-i** *input-file*\ **zabbix\_sender** \[**-v**\] **-z** *سرور* \[**-p** *port*\] \[**-I** *آدرس IP*\] \[**-t** *timeout*\] **-s** *host* **--tls-connect** **cert** **--tls-ca-file** *CA-file* \[**--tls-crl-file** *CRL-file*\] \[**--tls-server-cert-issuer** *cert-issuer*\] \[**--tls-server-cert-subject** *cert-subject*\] **--tls-cert-file** *cert-file* **--tls-key-file** *key-file* \[**--tls-cipher13** *رشته رمز*\] \[**--tls-cipher** *cipher-string*\] **-k** *key* **-o** *ارزش*\ **zabbix\_sender** \[**-v**\] **-z** *سرور* \[**-p** *port*\] \[**-I** *آدرس IP*\] \[**-t** *timeout*\] \[**-s** *host*\] **--tls-connect** **cert** **--tls-ca-file** *CA-file* \[**--tls-crl-file** *CRL-file*\] \[**--tls-server-cert-issuer** *cert-issuer*\] \[**--tls-server-cert-subject** *cert-subject*\] **--tls-cert-file** *cert-file* **--tls-key-file** *key-file* \[**--tls-cipher13** *رشته رمزی*\] \[**--tls-cipher** *cipher-string*\] \[**-T**\] \[**-N**\] \[**-r**\] **-i** *input-file*\ **zabbix\_sender** \[**-v**\] **-c** *config-file* \[**-z** *server*\] \[**-p** *port*\] \[**-I** *آدرس IP*\] \[**-t** *timeout*\] \[**-s** *میزبان*\] **--tls-connect** **cert** **--tls-ca-file** *CA-file* \[**--tls-crl-file** *CRL-file*\] \[**--tls-server-cert-issuer** *گواهی صادرکننده*\] \[**--tls-server-cert-subject** *cert-subject*\] **--tls-cert-file** *cert-file* **--tls-key-file** *key-file* \[**--tls-cipher13** *cipher-string*\] \[**--tls-cipher** *رشته رمز*\] **-k** *کلید* **-o** *مقدار*\ **zabbix\_sender** \[**-v**\] **-c** *config-file* \[**-z** *server*\] \[**-p** *port*\] \[**-I** *آدرس IP*\] \[**-t** *timeout*\] \[**-s** *میزبان*\] **--tls-connect** **cert** **--tls-ca-file** *CA-file* \[**--tls-crl-file** *CRL-file*\] \[**--tls-server-cert-issuer** *گواهی صادرکننده*\] \[**--tls-server-cert-subject** *cert-subject*\] **--tls-cert-file** *cert-file* **--tls-key-file** *key-file* \[**--tls-cipher13** *cipher-string*\] \[**--tls-cipher** *رشته رمز*\] \[**-T**\] \[**-N**\] \[**-r**\] **-i** *input-file*\ **zabbix\_sender** \[**-v**\] **-z** *سرور* \[**-p** *port*\] \[**-I** *آدرس IP*\] \[**-t** *timeout*\] **-s** *host* **--tls-connect** **psk** **--tls-psk-identity** *PSK-identity* **--tls-psk-file** *فایل PSK* \[**--tls-cipher13** *cipher-string*\] \[**--tls-cipher** *رشته رمز*\] **-k** *کلید* **-o** *مقدار*\ **zabbix\_sender** \[**-v**\] **-z** *سرور* \[**-p** *port*\] \[**-I** *آدرس IP*\] \[**-t** *timeout*\] \[**-s** *host*\] **--tls-connect** **psk** **--tls-psk-identity** *PSK-identity* **--tls-psk-file** *فایل PSK* \[**--tls-cipher13** *cipher-string*\] \[**--tls-cipher** *رشته رمز*\] \[**-T**\] \[**-N**\] \[**-r**\] **-i** *input-file*\ **zabbix\_sender** \[**-v**\] **-c** *config-file* \[**-z** *server*\] \[**-p** *port*\] \[**-I** *آدرس IP*\] \[**-t** *timeout*\] \[**-s** *میزبان*\] **--tls-connect** **psk** **--tls-psk-identity** *PSK-identity* **--tls-psk-file** *PSK-file* \[**--tls-cipher13** *cipher-string*\] \[**--tls-cipher** *cipher-string*\] **-k** *key* **-o** *value*\ **zabbix\_sender** \[**-v**\] **-c** *config-file* \[**-z** *server*\] \[**-p** *port*\] \[**-I** *آدرس IP*\] \[**-t** *timeout*\] \[**-s** *میزبان*\] **--tls-connect** **psk** **--tls-psk-identity** *PSK-identity* **--tls-psk-file** *PSK-file* \[**--tls-cipher13** *cipher-string*\] \[**--tls-cipher** *cipher-string*\] \[**-T**\] \[**-N**\] \[**-r**\] **-i** *input-file*\ **zabbix\_sender -h**\ **zabbix\_sender -V** [ ]{#lbAD} ## SYNOPSIS **zabbix\_server** \[**-c** *config-file*\]\ **zabbix\_server** \[**-c** *config-file*\] **-R** *runtime-option*\ **zabbix\_server -h**\ **zabbix\_server -V** [ ]{#lbAD} ## خلاصه **zabbix\_server** \[**-c** *config-file*\]\ **zabbix\_server** \[**-c** *config-file*\] **-R** *runtime-option*\ **zabbix\_server -h**\ **zabbix\_server -V** [ ]{#lbAD} ## SYNOPSIS **zabbix\_web\_service** \[**-c** *config-file*\]\ **zabbix\_web\_service -h**\ **zabbix\_web\_service -V** [ ]{#lbAD} ## خلاصه **zabbix\_web\_service** \[**-c** *config-file*\]\ **zabbix\_web\_service -h**\ **zabbix\_web\_service -V** [ ]{#lbAD} # template.create # ساخت قالب ##### Template dashboard tags |Element|Element property|Required|Type|Range^**[1](#footnotes)**^|Description| |--|--|-|--|----|--------| |dashboards| |\-| | |Root element for template dashboards.| | |uuid|x|`string`| |Unique identifier for this dashboard.| | |name|x|`string`| |Template dashboard name.| | |display period|\-|`integer`| |Display period of dashboard pages.| | |auto\_start|\-|`string`|0 - no<br>1 - yes|Slideshow auto start.| |pages| |\-| | |Root element for template dashboard pages.| | |name|\-|`string`| |Page name.| | |display period|\-|`integer`| |Page display period.| | |sortorder|\-|`integer`| |Page sorting order.| |widgets| |\-| | |Root element for template dashboard widgets.| | |type|x|`string`| |Widget type.| | |name|\-|`string`| |Widget name.| | |x|\-|`integer`|0-23|Horizontal position from the left side of the template dashboard.| | |y|\-|`integer`|0-62|Vertical position from the top of the template dashboard.| | |width|\-|`integer`|1-24|Widget width.| | |height|\-|`integer`|2-32|Widget height.| | |hide\_header|\-|`string`|0 - no<br>1 - yes|Hide widget header.| |fields| |\-| | |Root element for the template dashboard widget fields.| | |type|x|`string`|0 - INTEGER<br>1 - STRING<br>3 - HOST<br>4 - ITEM<br>5 - ITEM\_PROTOTYPE<br>6 - GRAPH<br>7 - GRAPH\_PROTOTYPE|Widget field type.| | |name|x|`string`| |Widget field name.| | |value|x|mixed| |Widget field value, depending on the field type.| ##### تگ های داشبورد الگو |عنصر|ویژگی عنصر|لازم|نوع|محدوده^**[1](#پاورقی)**^|توضیحات| |--|--|-|--|----|--------| |داشبورد| |\-| | |عنصر ریشه برای داشبوردهای قالب.| | |uuid|x|`رشته`| |شناسه منحصر به فرد این داشبورد.| | |نام|x|`رشته`| |نام داشبورد قالب.| | |دوره نمایش|\-|`عدد صحیح`| |دوره نمایش صفحات داشبورد.| | |auto\_start|\-|`string`|0 - no<br>1 - yes|شروع خودکار نمایش اسلاید.| |صفحات| |\-| | |عنصر ریشه برای صفحات داشبورد قالب.| | |نام|\-|`رشته`| |نام صفحه.| | |دوره نمایش|\-|`عدد صحیح`| |دوره نمایش صفحه.| | | مرتب کننده|\-|`عدد صحیح`| | ترتیب مرتب سازی صفحات.| |ابزارک| |\-| | |عنصر ریشه برای ویجت های داشبورد الگو.| | |نوع|x|`رشته`| |نوع ویجت.| | |نام|\-|`رشته`| |نام ویجت.| | |x|\-|`عدد صحیح`|0-23|موقعیت افقی از سمت چپ داشبورد الگو.| | |y|\-|`عدد صحیح`|0-62|موقعیت عمودی از بالای داشبورد الگو.| | |عرض|\-|`عدد صحیح`|1-24|عرض ویجت.| | |ارتفاع|\-|`عدد صحیح`|2-32|ارتفاع ویجت.| | |hide\_header|\-|`string`|0 - no<br>1 - yes|پنهان کردن سرصفحه ویجت.| | زمینه ها| |\-| | |عنصر ریشه برای فیلدهای ویجت داشبورد الگو.| | |type|x|`string`|0 - INTEGER<br>1 - STRING<br>3 - HOST<br>4 - ITEM<br>5 - ITEM\_PROTOTYPE<br>6 - GRAPH<br>7 - GRAPH \_PROTOTYPE|نوع فیلد ویجت.| | |نام|x|`رشته`| |نام فیلد ویجت.| | | ارزش|x|مختلط| |مقدار فیلد ویجت، بسته به نوع فیلد.| ##### Template graph tags |Element|Element property|Required|Type|Range^**[1](#footnotes)**^|Description| |--|--|-|--|----|--------| |graphs| |\-| | |Root element for graphs.| | |uuid|x|`string`| |Unique identifier for this graph.| | |name|x|`string`| |Graph name.| | |width|\-|`integer`|20-65535 (default: 900)|Graph width, in pixels. Used for preview and for pie/exploded graphs.| | |height|\-|`integer`|20-65535 (default: 200)|Graph height, in pixels. Used for preview and for pie/exploded graphs.| | |yaxismin|\-|`double`|Default: 0|Value of Y axis minimum.<br><br>Used if 'ymin\_type\_1' is FIXED.| | |yaxismax|\-|`double`|Default: 0|Value of Y axis maximum.<br><br>Used if 'ymax\_type\_1' is FIXED.| | |show\_work\_period|\-|`string`|0 - NO<br>1 - YES (default)|Highlight non-working hours.<br><br>Used by normal and stacked graphs.| | |show\_triggers|\-|`string`|0 - NO<br>1 - YES (default)|Display simple trigger values as a line.<br><br>Used by normal and stacked graphs.| | |type|\-|`string`|0 - NORMAL (default)<br>1 - STACKED<br>2 - PIE<br>3 - EXPLODED|Graph type.| | |show\_legend|\-|`string`|0 - NO<br>1 - YES (default)|Display graph legend.| | |show\_3d|\-|`string`|0 - NO (default)<br>1 - YES|Enable 3D style.<br><br>Used by pie and exploded pie graphs.| | |percent\_left|\-|`double`|Default:0|Show the percentile line for left axis.<br><br>Used only for normal graphs.| | |percent\_right|\-|`double`|Default:0|Show the percentile line for right axis.<br><br>Used only for normal graphs.| | |ymin\_type\_1|\-|`string`|0 - CALCULATED (default)<br>1 - FIXED<br>2 - ITEM|Minimum value of Y axis.<br><br>Used by normal and stacked graphs.| | |ymax\_type\_1|\-|`string`|0 - CALCULATED (default)<br>1 - FIXED<br>2 - ITEM|Maximum value of Y axis.<br><br>Used by normal and stacked graphs.| |ymin\_item\_1| |\-| | |Individual item details.<br><br>Required if 'ymin\_type\_1' is ITEM.| | |host|x|`string`| |Item host.| | |key|x|`string`| |Item key.| |ymax\_item\_1| |\-| | |Individual item details.<br><br>Required if 'ymax\_type\_1' is ITEM.| | |host|x|`string`| |Item host.| | |key|x|`string`| |Item key.| |graph\_items| |x| | |Root element for graph items.| | |sortorder|\-|`integer`| |Draw order. The smaller value is drawn first. Can be used to draw lines or regions behind (or in front of) another.| | |drawtype|\-|`string`|0 - SINGLE\_LINE (default)<br>1 - FILLED\_REGION<br>2 - BOLD\_LINE<br>3 - DOTTED\_LINE<br>4 - DASHED\_LINE<br>5 - GRADIENT\_LINE|Draw style of the graph item.<br><br>Used only by normal graphs.| | |color|\-|`string`| |Element color (6 symbols, hex).| | |yaxisside|\-|`string`|0 - LEFT (default)<br>1 - RIGHT|Side of the graph where the graph item's Y scale will be drawn.<br><br>Used by normal and stacked graphs.| | |calc\_fnc|\-|`string`|1 - MIN<br>2 - AVG (default)<br>4 - MAX<br>7 - ALL (minimum, average and maximum; used only by simple graphs)<br>9 - LAST (used only by pie and exploded pie graphs)|Data to draw if more than one value exists for an item.| | |type|\-|`string`|0 - SIMPLE (default)<br>2 - GRAPH\_SUM (value of the item represents the whole pie; used only by pie and exploded pie graphs)|Graph item type.| |item| |x| | |Individual item.| | |host|x|`string`| |Item host.| | |key|x|`string`| |Item key.| ##### تگ های نمودار الگو |عنصر|ویژگی عنصر|لازم|نوع|محدوده^**[1](#پاورقی)**^|توضیحات| |--|--|-|--|----|--------| | نمودار| |\-| | |عنصر ریشه برای نمودارها.| | |uuid|x|`رشته`| |شناسه منحصر به فرد برای این نمودار.| | |نام|x|`رشته`| |نام نمودار.| | |عرض|\-|`عدد صحیح`|20-65535 (پیش‌فرض: 900)|عرض نمودار، بر حسب پیکسل. برای پیش نمایش و برای نمودارهای پای/منفجر شده استفاده می شود.| | |height|\-|`عدد صحیح`|20-65535 (پیش‌فرض: 200)|ارتفاع نمودار، بر حسب پیکسل. برای پیش نمایش و برای نمودارهای پای/منفجر شده استفاده می شود.| | |yaxismin|\-|`double`|پیش‌فرض: 0|مقدار حداقل محور Y.<br><br>اگر 'ymin\_type\_1' ثابت باشد استفاده می‌شود.| | |yaxismax|\-|`double`|پیش‌فرض: 0|مقدار حداکثر محور Y.<br><br>اگر "ymax\_type\_1" ثابت باشد استفاده می‌شود.| | |show\_work\_period|\-|`string`|0 - NO<br>1 - YES (پیش‌فرض)| ساعات غیر کاری را برجسته کنید.<br><br>در نمودارهای معمولی و پشته‌ای استفاده می‌شود.| | |show\_triggers|\-|`string`|0 - NO<br>1 - YES (پیش‌فرض)|مقادیر راه‌انداز ساده را به‌صورت یک خط نمایش دهید.<br><br>در نمودارهای معمولی و پشته‌ای استفاده می‌شود.| | |نوع|\-|`رشته`|0 - NORMAL (پیش فرض)<br>1 - انباشته<br>2 - PIE<br>3 - EXPLODED|نوع نمودار.| | |show\_legend|\-|`string`|0 - NO<br>1 - YES (پیش‌فرض)|نمایش افسانه نمودار.| | |show\_3d|\-|`string`|0 - NO (پیش‌فرض)<br>1 - YES|فعال کردن سبک سه‌بعدی.<br><br>استفاده شده توسط نمودارهای پای و دایره‌ای منفجر شده.| | |percent\_left|\-|`double`|پیش‌فرض:0|نمایش خط صدک برای محور چپ.<br><br>فقط برای نمودارهای معمولی استفاده می‌شود.| | |%\_right|\-|`double`|پیش‌فرض:0|نمایش خط صدک برای محور سمت راست.<br><br>فقط برای نمودارهای معمولی استفاده می‌شود.| | |ymin\_type\_1|\-|`string`|0 - CALCULATED (پیش‌فرض)<br>1 - ثابت<br>2 - ITEM|حداقل مقدار محور Y.<br><br>استفاده شده توسط عادی و پشته‌ای نمودارها.| | |ymax\_type\_1|\-|`string`|0 - CALCULATED (پیش‌فرض)<br>1 - ثابت<br>2 - ITEM|حداکثر مقدار محور Y.<br><br>استفاده شده توسط عادی و پشته‌ای نمودارها.| |ymin\_item\_1| |\-| | |جزئیات هر مورد.<br><br>اگر 'ymin\_type\_1' ITEM باشد، الزامی است.| | | میزبان|x|`رشته`| | میزبان آیتم.| | |کلید|x|`رشته`| |کلید مورد.| |ymax\_item\_1| |\-| | |جزئیات هر مورد.<br><br>اگر 'ymax\_type\_1' ITEM باشد الزامی است.| | | میزبان|x|`رشته`| | میزبان آیتم.| | |کلید|x|`رشته`| |کلید مورد.| |گراف\_اقلام| |x| | |عنصر ریشه برای آیتم های گراف.| | | مرتب کننده|\-|`عدد صحیح`| | ترتیب قرعه کشی. ابتدا مقدار کوچکتر ترسیم می شود. می توان از آن برای ترسیم خطوط یا مناطق پشت (یا جلوی) دیگری استفاده کرد.| | |drawtype|\-|`string`|0 - SINGLE\_LINE (پیش‌فرض)<br>1 - FILLED\_REGION<br>2 - BOLD\_LINE<br>3 - DOTTED\_LINE<br>4 - DASHED\_LINE <br>5 - GRADIENT\_LINE|سبک مورد گراف را بکشید.<br><br>فقط توسط نمودارهای معمولی استفاده می‌شود.| | |رنگ|\-|`رشته`| |رنگ عنصر (6 علامت، هگزا).| | |yaxisside|\-|`string`|0 - LEFT (پیش‌فرض)<br>1 - RIGHT|سمت نمودار که در آن مقیاس Y مورد نمودار ترسیم می‌شود.<br><br>در نمودارهای معمولی و پشته‌ای استفاده می‌شود. | | |calc\_fnc|\-|`string`|1 - MIN<br>2 - AVG (پیش‌فرض)<br>4 - MAX<br>7 - ALL (حداقل، متوسط و حداکثر؛ فقط توسط نمودارهای ساده استفاده می‌شود)< br>9 - LAST (فقط توسط نمودارهای پای و دایره منفجر شده استفاده می شود)|داده هایی برای ترسیم در صورتی که بیش از یک مقدار برای یک آیتم وجود داشته باشد.| | |type|\-|`string`|0 - SIMPLE (پیش‌فرض)<br>2 - GRAPH\_SUM (مقدار مورد کل پای را نشان می‌دهد؛ فقط توسط نمودارهای پای و دایره منفجر شده استفاده می‌شود)|نوع مورد نمودار.| | آیتم| |x| | |مورد تکی.| | | میزبان|x|`رشته`| | میزبان آیتم.| | |کلید|x|`رشته`| |کلید مورد.| ### Text history The text history object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |id|string|ID of the history entry.| |clock|timestamp|Time when that value was received.| |itemid|string|ID of the related item.| |ns|integer|Nanoseconds when the value was received.| |value|text|Received value.| ### تاریخچه رشته The text history object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |id|string|ID of the history entry.| |clock|timestamp|Time when that value was received.| |itemid|string|ID of the related item.| |ns|integer|Nanoseconds when the value was received.| |value|text|Received value.| ### **unencrypted** connect without encryption (default) ```{=html} <!-- --> ``` **psk** connect using TLS and a pre-shared key ```{=html} <!-- --> ``` **cert** connect using TLS and a certificate ```{=html} <!-- --> ``` **--tls-ca-file** *CA-file* Full pathname of a file containing the top-level CA(s) certificates for peer certificate verification. **--tls-crl-file** *CRL-file* Full pathname of a file containing revoked certificates. **--tls-agent-cert-issuer** *cert-issuer* Allowed agent certificate issuer. **--tls-agent-cert-subject** *cert-subject* Allowed agent certificate subject. **--tls-cert-file** *cert-file* Full pathname of a file containing the certificate or certificate chain. **--tls-key-file** *key-file* Full pathname of a file containing the private key. **--tls-psk-identity** *PSK-identity* PSK-identity string. **--tls-psk-file** *PSK-file* Full pathname of a file containing the pre-shared key. **--tls-cipher13** *cipher-string* Cipher string for OpenSSL 1.1.1 or newer for TLS 1.3. Override the default ciphersuite selection criteria. This option is not available if OpenSSL version is less than 1.1.1. **--tls-cipher** *cipher-string* GnuTLS priority string (for TLS 1.2 and up) or OpenSSL cipher string (only for TLS 1.2). Override the default ciphersuite selection criteria. **-h**, **--help** Display this help and exit. **-V**, **--version** Output version information and exit. [ ]{#lbAG} ### **رمزگذاری نشده** اتصال بدون رمزگذاری (پیش‌فرض) ```{=html} <!---> ``` **psk** با استفاده از TLS و یک کلید مشترک از قبل متصل شوید ```{=html} <!---> ``` **گواهی** با استفاده از TLS و گواهی متصل شوید ```{=html} <!---> ``` **--tls-ca-file** *CA-file* نام مسیر کامل یک فایل حاوی گواهی (های) CA سطح بالا برای تایید گواهی همتا **--tls-crl-file** *CRL-file* نام مسیر کامل یک فایل حاوی گواهی های باطل شده است. **--tls-agent-cert-ssuer** *cert-ssuer* صادرکننده گواهی نماینده مجاز. **--tls-agent-cert-subject** *cert-subject* موضوع گواهی نماینده مجاز **--tls-cert-file** *cert-file* نام مسیر کامل یک فایل حاوی گواهی یا زنجیره گواهی. **--tls-key-file** *key-file* نام مسیر کامل یک فایل حاوی کلید خصوصی. **--tls-psk-identity** *PSK-identity* رشته هویت PSK. **--tls-psk-file** *PSK-file* نام مسیر کامل یک فایل حاوی کلید از پیش مشترک. **--tls-cipher13** *رشته رمز* رشته رمز برای OpenSSL 1.1.1 یا جدیدتر برای TLS 1.3. نادیده گرفتن معیارهای انتخاب مجموعه رمز پیش فرض این گزینه در دسترس نیست اگر نسخه OpenSSL کمتر از 1.1.1 است. **--tls-cipher** *cipher-string* رشته اولویت GnuTLS (برای TLS 1.2 و بالاتر) یا رشته رمز OpenSSL (فقط برای TLS 1.2). معیارهای انتخاب مجموعه رمز پیش فرض را نادیده بگیرید. **-h**، **--راهنما** این راهنما را نمایش دهید و از آن خارج شوید. **-V**، **--نسخه** اطلاعات نسخه خروجی و خروج. [ ]{#lbAG} ### **unencrypted** connect without encryption (default) ```{=html} <!-- --> ``` **psk** connect using TLS and a pre-shared key ```{=html} <!-- --> ``` **cert** connect using TLS and a certificate ```{=html} <!-- --> ``` **--tls-ca-file** *CA-file* Full pathname of a file containing the top-level CA(s) certificates for peer certificate verification. **--tls-crl-file** *CRL-file* Full pathname of a file containing revoked certificates. **--tls-server-cert-issuer** *cert-issuer* Allowed server certificate issuer. **--tls-server-cert-subject** *cert-subject* Allowed server certificate subject. **--tls-cert-file** *cert-file* Full pathname of a file containing the certificate or certificate chain. **--tls-key-file** *key-file* Full pathname of a file containing the private key. **--tls-psk-identity** *PSK-identity* PSK-identity string. **--tls-psk-file** *PSK-file* Full pathname of a file containing the pre-shared key. **--tls-cipher13** *cipher-string* Cipher string for OpenSSL 1.1.1 or newer for TLS 1.3. Override the default ciphersuite selection criteria. This option is not available if OpenSSL version is less than 1.1.1. **--tls-cipher** *cipher-string* GnuTLS priority string (for TLS 1.2 and up) or OpenSSL cipher string (only for TLS 1.2). Override the default ciphersuite selection criteria. **-v**, **--verbose** Verbose mode, **-vv** for more details. **-h**, **--help** Display this help and exit. **-V**, **--version** Output version information and exit. [ ]{#lbAG} ### **رمزگذاری نشده** اتصال بدون رمزگذاری (پیش‌فرض) ```{=html} <!---> ``` **psk** با استفاده از TLS و یک کلید مشترک از قبل متصل شوید ```{=html} <!---> ``` **گواهی** با استفاده از TLS و گواهی متصل شوید ```{=html} <!---> ``` **--tls-ca-file** *CA-file* نام مسیر کامل یک فایل حاوی گواهی (های) CA سطح بالا برای تایید گواهی همتا **--tls-crl-file** *CRL-file* نام مسیر کامل یک فایل حاوی گواهی های باطل شده است. **--tls-server-cert-issuer** *cert-ssuer* صادرکننده گواهی سرور مجاز است. **--tls-server-cert-subject** *cert-subject* موضوع گواهی سرور مجاز است. **--tls-cert-file** *cert-file* نام مسیر کامل یک فایل حاوی گواهی یا زنجیره گواهی. **--tls-key-file** *key-file* نام مسیر کامل یک فایل حاوی کلید خصوصی. **--tls-psk-identity** *PSK-identity* رشته هویت PSK. **--tls-psk-file** *PSK-file* نام مسیر کامل یک فایل حاوی کلید از پیش مشترک. **--tls-cipher13** *رشته رمز* رشته رمز برای OpenSSL 1.1.1 یا جدیدتر برای TLS 1.3. نادیده گرفتن معیارهای انتخاب مجموعه رمز پیش فرض این گزینه در دسترس نیست اگر نسخه OpenSSL کمتر از 1.1.1 است. **--tls-cipher** *cipher-string* رشته اولویت GnuTLS (برای TLS 1.2 و بالاتر) یا رشته رمز OpenSSL (فقط برای TLS 1.2). معیارهای انتخاب مجموعه رمز پیش فرض را نادیده بگیرید. **-v**، **-- پرحرف** حالت پرمخاطب، **-vv** برای جزئیات بیشتر. **-h**، **--راهنما** این راهنما را نمایش دهید و از آن خارج شوید. **-V**، **--نسخه** اطلاعات نسخه خروجی و خروج. [ ]{#lbAG} # > Web scenario object The following objects are directly related to the `webcheck` API. # > آبجکت وب سناریو The following objects are directly related to the `webcheck` API. # Web scenario This class is designed to work with web scenarios. Object references:\ - [Web scenario](/manual/api/reference/httptest/object#web_scenario) - [Scenario step](/manual/api/reference/httptest/object#scenario_step) Available methods:\ - [httptest.create](/manual/api/reference/httptest/create) - creating new web scenarios - [httptest.delete](/manual/api/reference/httptest/delete) - deleting web scenarios - [httptest.get](/manual/api/reference/httptest/get) - retrieving web scenarios - [httptest.update](/manual/api/reference/httptest/update) - updating web scenarios # وب سناریو This class is designed to work with web scenarios. Object references:\ - [Web scenario](/manual/api/reference/httptest/object#web_scenario) - [Scenario step](/manual/api/reference/httptest/object#scenario_step) Available methods:\ - [httptest.create](/manual/api/reference/httptest/create) - creating new web scenarios - [httptest.delete](/manual/api/reference/httptest/delete) - deleting web scenarios - [httptest.get](/manual/api/reference/httptest/get) - retrieving web scenarios - [httptest.update](/manual/api/reference/httptest/update) - updating web scenarios # Zabbix manpages These are Zabbix manpages for Zabbix processes. # صفحات راهنمای زبیکس صفحات راهنمای جاری مربوط به فرایند های زبیکس می باشند. # Zabbix Manual Welcome to the user manual for Zabbix software. These pages are created to help users successfully manage their monitoring tasks with Zabbix, from the simple to the more complex ones. # دفترچه راهنمای Zabbix به راهنمای کاربر نرم افزار Zabbix خوش آمدید. این صفحات ایجاد شده اند تا به کاربران کمک کند وظایف مانیتورینگ خود را با Zabbix، از ساده تا پیچیده، با موفقیت مدیریت کنند. ### ### # 10 Virtual machine monitoring # 10. Virtual machine monitoring # 11 Maintenance # 11. Maintenance # 11 Time zones # 11 منطقه زمانی # 12 Regular expressions # 12. Regular expressions # 13 Problem acknowledgment # 13. Problem acknowledgment # 14 Configuration export/import # 14. وارد کردن یا خروجی گرفتن از تنظیمات # 16 Distributed monitoring # 16. Distributed monitoring # 17 Encryption # 17. Encryption # 18 Web interface # 18. Web interface # 1 Menu # 1 منو # 1 Monitor Linux with Zabbix agent # 1. Monitor Linux with Zabbix agent # 2 Definitions # 2. Definitions # 3 Database upgrade to primary keys # 3 Database upgrade to primary keys # 3 Installation from sources You can get the very latest version of Zabbix by compiling it from the sources. A step-by-step tutorial for installing Zabbix from the sources is provided here. # 3 Installation from sources You can get the very latest version of Zabbix by compiling it from the sources. A step-by-step tutorial for installing Zabbix from the sources is provided here. # 3 Monitor Apache via HTTP # 3. Monitor Apache via HTTP # 4 Installation from packages # 4 Installation from packages # 4 Monitor MySQL with Zabbix agent 2 # 4. Monitor MySQL with Zabbix agent 2 # 4 Zabbix agent 2 (UNIX) # Zabbix Agent 2 (یونیکس) # 5 Installation from containers # 5 Installation from containers # 6 Zabbix appliance # 6. Zabbix appliance # 7 Upgrade procedure # 7 Upgrade procedure # 8 Service monitoring # 8. Service monitoring # 9 Web monitoring مانیتورینگ وب # action.create # ساخت اکشن # action.delete #پاک کردن اکشن # action.get # دریافت اکشن # action.update # action.update # alert.get # alert.get # apiinfo.version # apiinfo.version # Appendix 1. Reference commentary # ضمیمه 1. تفسیر مرجع # auditlog.get # auditlog.get # authentication.get دریافت احرازهویت # authentication.update به روز رسانی احرازهویت ## AUTHOR Alexei Vladishev <<alex@zabbix.com>> ------------------------------------------------------------------------ [ ]{#index} ## نویسنده الکسی ولادیشف <<alex@zabbix.com>> ------------------------------------------------ ---------------------- [ ]{#فهرست مطالب} ## AUTHOR Alexei Vladishev <<alex@zabbix.com>> ------------------------------------------------------------------------ [ ]{#index} ## نویسنده الکسی ولادیشف <<alex@zabbix.com>> ------------------------------------------------ ---------------------- [ ]{#فهرست مطالب} ## AUTHOR Alexei Vladishev <<alex@zabbix.com>> ------------------------------------------------------------------------ [ ]{#index} ## نویسنده Zabbix LLC ------------------------------------------------ ---------------------- [ ]{#فهرست مطالب} ## AUTHOR Zabbix LLC ------------------------------------------------------------------------ [ ]{#index} ## نویسنده Zabbix LLC ------------------------------------------------ ---------------------- [ ]{#فهرست مطالب} ## AUTHOR Zabbix LLC ------------------------------------------------------------------------ [ ]{#index} ## نویسنده Zabbix LLC ------------------------------------------------ ---------------------- [ ]{#فهرست مطالب} # autoregistration.get دریافت ثبت خودکار # autoregistration.update دریافت ثبت خودکار ##### BufferSend The time interval in seconds which determines how often values are sent from the buffer to Zabbix server.<br>Note that if the buffer is full, the data will be sent sooner. Default: `5`<br> Range: 1-3600 ##### BufferSend The time interval in seconds which determines how often values are sent from the buffer to Zabbix server.<br>Note, that if the buffer is full, the data will be sent sooner. Default: `5`<br> Range: 1-3600 ##### Collapsed menu When the menu is collapsed to icons only, a full menu reappears as soon as the mouse cursor is placed upon it. Note that it reappears over page content; to move page content to the right you have to click on the expand button. If the mouse cursor again is placed outside the full menu, the menu will collapse again after two seconds. You can also make a collapsed menu reappear fully by hitting the Tab key. Hitting the Tab key repeatedly will allow to focus on the next menu element. ##### Collapsed menu When the menu is collapsed to icons only, a full menu reappears as soon as the mouse cursor is placed upon it. Note that it reappears over page content; to move page content to the right you have to click on the expand button. If the mouse cursor again is placed outside the full menu, the menu will collapse again after two seconds. You can also make a collapsed menu reappear fully by hitting the Tab key. Hitting the Tab key repeatedly will allow to focus on the next menu element. # configuration.export خروجی گرفتن از تنظیمات # configuration.import وارد کردن تنظیمات # configuration.importcompare مقایسه تنظیمات وارد شده #### Configuring tags The **Tags** tab allows to define scenario-level [tags](/manual/config/tagging). ![](../../assets/en/manual/config/scenario_c.png) Tagging allows to filter web scenarios and web monitoring [items](/manual/web_monitoring/items). #### تنظیم تگ ها The **Tags** tab allows to define scenario-level [tags](/manual/config/tagging). ![](../../assets/en/manual/config/scenario_c.png) Tagging allows to filter web scenarios and web monitoring [items](/manual/web_monitoring/items). # correlation.create # ایجاد همبستگی # correlation.delete # correlation.delete # correlation.get # correlation.get # correlation.update # correlation.update # Create a module (tutorial) # Create a module (tutorial) # Create a widget (tutorial) # Create a widget (tutorial) # dashboard.create ساخت داشبورد # dashboard.delete حذف داشبورد # dashboard.get # دریافت داشبورد # dashboard.update به روز رسانی داشبورد # dcheck.get # dcheck.get ### Description `string apiinfo.version(array)` This method allows to retrieve the version of the Zabbix API. ::: noteimportant This method is only available to unauthenticated users and must be called without the `auth` parameter in the JSON-RPC request. ::: ### شرح `string apiinfo.version(array)` این روش امکان بازیابی نسخه Zabbix API را فراهم می کند. ::: نکته مهم این روش فقط برای غیر احراز هویت در دسترس است کاربران و باید بدون پارامتر «auth» در JSON-RPC فراخوانی شوند درخواست. ::: ## DESCRIPTION **zabbix\_agent2** is an application for monitoring parameters of various services.\ \ [ ]{#lbAE} ## شرح **zabbix\_agent2** یک برنامه کاربردی برای نظارت بر پارامترهای است خدمات مختلف.\ \ [ ]{#lbAE} ## DESCRIPTION **zabbix\_agentd** is a daemon for monitoring various server parameters. [ ]{#lbAE} ## شرح **zabbix\_agentd** دیمونی برای نظارت بر پارامترهای مختلف سرور است. [ ]{#lbAE} ## DESCRIPTION **zabbix\_proxy** is a daemon that collects monitoring data from devices and sends it to Zabbix server. [ ]{#lbAE} ## شرح **zabbix\_proxy** دیمونی است که داده های نظارتی را از دستگاه ها جمع آوری می کند و آن را به سرور Zabbix ارسال می کند. [ ]{#lbAE} ## DESCRIPTION **zabbix\_sender** is a command line utility for sending monitoring data to Zabbix server or proxy. On the Zabbix server an item of type **Zabbix trapper** should be created with corresponding key. Note that incoming values will only be accepted from hosts specified in **Allowed hosts** field for this item. [ ]{#lbAE} ## شرح **zabbix\_sender** یک ابزار خط فرمان برای ارسال داده های نظارت است به سرور یا پروکسی Zabbix. در سرور Zabbix موردی از نوع **Zabbix trapper** باید با کلید مربوطه ایجاد شود. توجه داشته باشید که ورودی مقادیر فقط از میزبان های مشخص شده در **میزبان های مجاز** پذیرفته می شود. فیلد برای این مورد [ ]{#lbAE} ## DESCRIPTION **zabbix\_server** is the core daemon of Zabbix software. [ ]{#lbAE} ## شرح **zabbix\_server** دیمون اصلی نرم افزار Zabbix است. [ ]{#lbAE} ## DESCRIPTION **zabbix\_web\_service** is an application for providing web services to Zabbix components. [ ]{#lbAE} ## شرح **zabbix\_web\_service** اپلیکیشنی برای ارائه خدمات وب به اجزای Zabbix [ ]{#lbAE} # dhost.get # dhost.get # discoveryrule.copy # کپی کردن قوانین جست وجو # discoveryrule.create # ساختن قوانین جست وجو # discoveryrule.delete # پاک کردن قوانین جست وجو # discoveryrule.get # گرفتن قوانین جست وجو # discoveryrule.update # به روز رسانی قوانین جست وجو # drule.create # ساختن # drule.delete پاک کردن قانون جست وجو # drule.get دریافت حذف قانون جست و جو # drule.update # آپدیت قانون جست و جو # dservice.get # دریافت سرویس جست و جو # event.acknowledge # تایید رویداد # event.get دریافت رخداد ### Example ### مثال ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ## EXAMPLES **zabbix\_get -s 127.0.0.1 -p 10050 -k "system.cpu.load\[all,avg1\]"**\ **zabbix\_get -s 127.0.0.1 -p 10050 -k "system.cpu.load\[all,avg1\]" --tls-connect cert --tls-ca-file /home/zabbix/zabbix\_ca\_file --tls-agent-cert-issuer "CN=Signing CA,OU=IT operations,O=Example Corp,DC=example,DC=com" --tls-agent-cert-subject "CN=server1,OU=IT operations,O=Example Corp,DC=example,DC=com" --tls-cert-file /home/zabbix/zabbix\_get.crt --tls-key-file /home/zabbix/zabbix\_get.key\ zabbix\_get -s 127.0.0.1 -p 10050 -k "system.cpu.load\[all,avg1\]" --tls-connect psk --tls-psk-identity "PSK ID Zabbix agentd" --tls-psk-file /home/zabbix/zabbix\_agentd.psk** [ ]{#lbAH} ## مثال ها **zabbix\_get -s 127.0.0.1 -p 10050 -k "system.cpu.load\[all,avg1\]"**\ **zabbix\_get -s 127.0.0.1 -p 10050 -k "system.cpu.load\[all,avg1\]" --tls-connect Cert --tls-ca-file /home/zabbix/zabbix\_ca\_file --tls-agent-cert-issuer "CN=امضای عملیات CA,OU=IT,O=مثال Corp,DC=example,DC=com" --tls-agent-cert-subject "CN=server1,OU=IT عملیات,O=Example Corp,DC=example,DC=com" --tls-cert-file /home/zabbix/zabbix\_get.crt --tls-key-file /home/zabbix/zabbix\_get.key\ zabbix\_get -s 127.0.0.1 -p 10050 -k "system.cpu.load\[all,avg1\]" --tls-connect psk --tls-psk-identity "PSK ID Zabbix agentd" --tls-psk-file /home/zabbix/zabbix\_agentd.psk** [ ]{#lbAH} ## EXAMPLES **zabbix\_js -s script-file.js -p example** [ ]{#lbAG} ## مثال ها **zabbix\_js -s script-file.js -p مثال** [ ]{#lbAG} ## EXAMPLES **zabbix\_sender -c /etc/zabbix/zabbix\_agentd.conf -k mysql.queries -o 342.45**\ Send **342.45** as the value for **mysql.queries** item of monitored host. Use monitored host and Zabbix server defined in agent configuration file. **zabbix\_sender -c /etc/zabbix/zabbix\_agentd.conf -s "Monitored Host" -k mysql.queries -o 342.45**\ Send **342.45** as the value for **mysql.queries** item of **Monitored Host** host using Zabbix server defined in agent configuration file. \ **zabbix\_sender -z 192.168.1.113 -i data\_values.txt** \ Send values from file **data\_values.txt** to Zabbix server with IP **192.168.1.113**. Host names and keys are defined in the file. \ **echo "- hw.serial.number 1287872261 SQ4321ASDF" | zabbix\_sender -c /usr/local/etc/zabbix\_agentd.conf -T -i -**\ Send a timestamped value from the commandline to Zabbix server, specified in the agent configuration file. Dash in the input data indicates that hostname also should be used from the same configuration file. \ **echo '"Zabbix server" trapper.item ""' | zabbix\_sender -z 192.168.1.113 -p 10000 -i -**\ Send empty value of an item to the Zabbix server with IP address **192.168.1.113** on port **10000** from the commandline. Empty values must be indicated by empty double quotes. **zabbix\_sender -z 192.168.1.113 -s "Monitored Host" -k mysql.queries -o 342.45 --tls-connect cert --tls-ca-file /home/zabbix/zabbix\_ca\_file --tls-cert-file /home/zabbix/zabbix\_agentd.crt --tls-key-file /home/zabbix/zabbix\_agentd.key**\ Send **342.45** as the value for **mysql.queries** item in **Monitored Host** host to server with IP **192.168.1.113** using TLS with certificate. **zabbix\_sender -z 192.168.1.113 -s "Monitored Host" -k mysql.queries -o 342.45 --tls-connect psk --tls-psk-identity "PSK ID Zabbix agentd" --tls-psk-file /home/zabbix/zabbix\_agentd.psk**\ Send **342.45** as the value for **mysql.queries** item in **Monitored Host** host to server with IP **192.168.1.113** using TLS with pre-shared key (PSK). [ ]{#lbAI} ## مثال ها **zabbix\_sender -c /etc/zabbix/zabbix\_agentd.conf -k mysql.queries -o 342.45**\ ارسال **342.45** به عنوان مقدار برای **mysql.queries** مورد نظارت شده میزبان. از میزبان نظارت شده و سرور Zabbix تعریف شده در عامل استفاده کنید فایل پیکربندی. **zabbix\_sender -c /etc/zabbix/zabbix\_agentd.conf -s "میزبان نظارت شده" -k mysql.queries -o 342.45**\ ارسال **342.45** به عنوان مقدار برای **mysql.queries** مورد **Monitored میزبان ** با استفاده از سرور Zabbix تعریف شده در فایل پیکربندی عامل. \ **zabbix\_sender -z 192.168.1.113 -i data\_values.txt** \ مقادیر را از فایل **data\_values.txt** به سرور Zabbix با IP ارسال کنید **192.168.1.113**. نام هاست و کلیدها در فایل تعریف شده است. \ **echo "- hw.serial.number 1287872261 SQ4321ASDF" | zabbix\_sender -c /usr/local/etc/zabbix\_agentd.conf -T -i -**\ یک مقدار مهر زمانی از خط فرمان به سرور Zabbix ارسال کنید، در فایل پیکربندی عامل مشخص شده است. خط تیره در داده های ورودی نشان می دهد که نام میزبان نیز باید از همان پیکربندی استفاده شود فایل. \ **echo '"سرور Zabbix" trapper.item ""' | zabbix\_sender -z 192.168.1.113 -p 10000 -i -**\ مقدار خالی یک مورد را با آدرس IP به سرور Zabbix ارسال کنید **192.168.1.113** در پورت **10000** از خط فرمان. ارزش های خالی باید با دو نقل قول خالی نشان داده شود. **zabbix\_sender -z 192.168.1.113 -s "میزبان نظارت شده" -k mysql.queries -o 342.45 --tls-connect Cert --tls-ca-file /home/zabbix/zabbix\_ca\_file --tls-cert-file /home/zabbix/zabbix\_agentd.crt --tls-key-file /home/zabbix/zabbix\_agentd.key**\ ارسال **342.45** به عنوان مقدار مورد **mysql.queries** در **Monitored میزبان ** میزبان به سرور با IP **192.168.1.113** با استفاده از TLS با گواهی **zabbix\_sender -z 192.168.1.113 -s "میزبان نظارت شده" -k mysql.queries -o 342.45 --tls-connect psk --tls-psk-identity "PSK ID Zabbix agent" --tls-psk-file /home/zabbix/zabbix\_agentd.psk**\ ارسال **342.45** به عنوان مقدار مورد **mysql.queries** در **Monitored میزبان ** میزبان به سرور با IP **192.168.1.113** با استفاده از TLS با کلید از پیش مشترک (PSK). [ ]{#lbAI} ## EXIT STATUS The exit status is 0 if the values were sent and all of them were successfully processed by server. If data was sent, but processing of at least one of the values failed, the exit status is 2. If data sending failed, the exit status is 1. [ ]{#lbAH} ## وضعیت خروج اگر مقادیر ارسال شده باشند و همه آنها ارسال شده باشند، وضعیت خروج 0 است با موفقیت توسط سرور پردازش شد. اگر داده ها ارسال شد، اما پردازش در حداقل یکی از مقادیر ناموفق، وضعیت خروج 2 است. در صورت ارسال داده ها ناموفق، وضعیت خروج 1 است. [ ]{#lbAH} ##### Export format Data can be exported using the Zabbix web frontend or [Zabbix API](/manual/api/reference/configuration). Supported export formats are YAML, XML and JSON. ##### فرمت صادرات داده ها را می توان با استفاده از صفحه وب Zabbix یا [Zabbix صادر کرد API](/دستی/api/reference/configuration). فرمت های صادراتی پشتیبانی شده هستند YAML، XML و JSON. ## FILES */usr/local/etc/zabbix\_agent2.conf* Default location of Zabbix agent 2 configuration file (if not modified during compile time). [ ]{#lbAH} ## فایل ها */usr/local/etc/zabbix\_agent2.conf* محل پیش‌فرض فایل پیکربندی عامل Zabbix 2 (در صورت عدم تغییر در طول زمان کامپایل). [ ]{#lbAH} ## FILES */usr/local/etc/zabbix\_agentd.conf* Default location of Zabbix agent configuration file (if not modified during compile time). [ ]{#lbAI} ## فایل ها */usr/local/etc/zabbix\_agent2.conf* محل پیش‌فرض فایل پیکربندی عامل Zabbix 2 (در صورت عدم تغییر در طول زمان کامپایل). [ ]{#lbAH} ## FILES */usr/local/etc/zabbix\_proxy.conf* Default location of Zabbix proxy configuration file (if not modified during compile time). [ ]{#lbAI} ## فایل ها */usr/local/etc/zabbix\_agent2.conf* محل پیش‌فرض فایل پیکربندی عامل Zabbix 2 (در صورت عدم تغییر در طول زمان کامپایل). [ ]{#lbAH} ## FILES */usr/local/etc/zabbix\_server.conf* Default location of Zabbix server configuration file (if not modified during compile time). [ ]{#lbAI} ## فایل ها */usr/local/etc/zabbix\_server.conf* محل پیش‌فرض فایل پیکربندی سرور Zabbix (در صورت عدم تغییر در طول زمان کامپایل). [ ]{#lbAI} ## FILES */usr/local/etc/zabbix\_web\_service.conf* Default location of Zabbix web service configuration file (if not modified during compile time). [ ]{#lbAG} ## فایل ها */usr/local/etc/zabbix\_web\_service.conf* محل پیش‌فرض فایل پیکربندی وب سرویس Zabbix (اگر نه در طول زمان کامپایل اصلاح شد). [ ]{#lbAG} # graph.create ساخت گراف # graph.delete # حذف گراف # graph.get #دریافت گراف # graphitem.get # دریافت آیتم های گراف # graphprototype.create # ساخت نمونه گراف # graphprototype.delete # حذف نمونه اولیه گراف # graphprototype.get # دریافت نمونه اولیه گراف # graphprototype.update # آپدیت نمونه اولیه گراف # graph.update # آپدیت گراف # hanode.get # دریافت نود HA #### Header processing The CSV file header line can be processed in two different ways: - If the *With header row* checkbox is marked - header line values are interpreted as column names. In this case the column names must be unique and the data row should not contain more columns than the header row. - If the *With header row* checkbox is not marked - the header line is interpreted as data. Column names are generated automatically (1,2,3,4...). CSV file example: Nr,Item name,Key,Qty 1,active agent item,agent.hostname,33 "2","passive agent item","agent.version","44" 3,"active,passive agent items",agent.ping,55 ::: noteclassic A quotation character within a quoted field in the input must be escaped by preceding it with another quotation character. ::: **Processing header line** JSON output when a header line is expected: ``` {.json} [ { "Nr":"1", "Item name":"active agent item", "Key":"agent.hostname", "Qty":"33" }, { "Nr":"2", "Item name":"passive agent item", "Key":"agent.version", "Qty":"44" }, { "Nr":"3", "Item name":"active,passive agent items", "Key":"agent.ping", "Qty":"55" } ] ``` **No header line processing** JSON output when a header line is not expected: ``` {.json} [ { "1":"Nr", "2":"Item name", "3":"Key" "4":"Qty" }, { "1":"1", "2":"active agent item", "3":"agent.hostname" "4":"33" }, { "1":"2", "2":"passive agent item", "3":"agent.version" "4":"44" }, { "1":"3", "2":"active,passive agent items", "3":"agent.ping" "4":"55" } ] ``` #### Header processing The CSV file header line can be processed in two different ways: - If the *With header row* checkbox is marked - header line values are interpreted as column names. In this case the column names must be unique and the data row should not contain more columns than the header row; - If the *With header row* checkbox is not marked - the header line is interpreted as data. Column names are generated automatically (1,2,3,4...) CSV file example: Nr,Item name,Key,Qty 1,active agent item,agent.hostname,33 "2","passive agent item","agent.version","44" 3,"active,passive agent items",agent.ping,55 ::: noteclassic A quotation character within a quoted field in the input must be escaped by preceding it with another quotation character. ::: **Processing header line** JSON output when a header line is expected: ``` {.json} [ { "Nr":"1", "Item name":"active agent item", "Key":"agent.hostname", "Qty":"33" }, { "Nr":"2", "Item name":"passive agent item", "Key":"agent.version", "Qty":"44" }, { "Nr":"3", "Item name":"active,passive agent items", "Key":"agent.ping", "Qty":"55" } ] ``` **No header line processing** JSON output when a header line is not expected: ``` {.json} [ { "1":"Nr", "2":"Item name", "3":"Key" "4":"Qty" }, { "1":"1", "2":"active agent item", "3":"agent.hostname" "4":"33" }, { "1":"2", "2":"passive agent item", "3":"agent.version" "4":"44" }, { "1":"3", "2":"active,passive agent items", "3":"agent.ping" "4":"55" } ] ``` # history.clear #پاک کردن تاریخچه # history.get # گرفتن تاریخچه # host.create # ساخت هاست # host.delete #حذف هاست # host.get # دریافت هاست # hostgroup.create # ساخت گروه هاست # hostgroup.delete # حذف گروه هاست # hostgroup.get # دریافت گروه هاستی # hostgroup.massadd # اضافه کردن گروهی هاست ها # hostgroup.massremove # حذف گروهی هاست ها # hostgroup.massupdate # به روز رسانی گروهی هاست ها # hostgroup.update # به روز رسانی گروه هاستی # hostinterface.create # ساخت اینترفیس هاست # hostinterface.delete # حذف اینترفیس هاست # hostinterface.get # دریافت اینترفیس هاست # hostinterface.massadd # اضافه کردن گروهی اینترفیس های هاست # hostinterface.massremove # حذف گروهی اینترفیس های هاست # hostinterface.replacehostinterfaces # جایگزینی اینترفیس های هاست # hostinterface.update # به روز رسانی اینترفیس هاست ها # host.massadd # اضافه کردن گروهی هاست ها # host.massremove # حذف گروهی هاست ها # host.massupdate # آپدیت گروهی هاست ها # hostprototype.create # ساخت هاست نمونه # hostprototype.delete #حذف نمونه اولیه هاست # hostprototype.get # دریافت نمونه اولیه هاست # hostprototype.update # به روز رسانی نمونه اولیه هاست # host.update # آپدیت هاست # housekeeping.get # دریافت اطلاعات ذخیره شده # housekeeping.update # آپدیت ذخیره سازی داده # httptest.create # ساخت Http تست # httptest.delete # حذف Http تست # httptest.get # دریافت Http تست # httptest.update # به روز رسانی http # iconmap.create # ساخت آیکون مپ # iconmap.delete # حذف آیکون مپ # iconmap.get # دریافت آیکون مپ # iconmap.update #دکمه آپدیت نقشه # image.create #ساخت Image ##### Mass editing options Buttons below the list offer some mass-editing options: - *Enable* - change trigger status to *Enabled*. - *Disable* - change trigger status to *Disabled*. - *Copy* - copy the triggers to other hosts or templates. - *Mass update* - update several properties for a number of triggers at once. - *Delete* - delete the triggers. To use these options, mark the checkboxes before the respective triggers, then click on the required button. ##### Mass editing options Buttons below the list offer some mass-editing options: - *Enable* - change trigger status to *Enabled* - *Disable* - change trigger status to *Disabled* - *Copy* - copy the triggers to other hosts or templates - *Mass update* - update several properties for a number of triggers at once - *Delete* - delete the triggers To use these options, mark the checkboxes before the respective triggers, then click on the required button. ## NAME zabbix\_agent2 - Zabbix agent 2\ \ [ ]{#lbAC} ## نام zabbix\_agent2 - Zabbix agent 2\ \ [ ]{#lbAC} ## NAME zabbix\_agentd - Zabbix agent daemon [ ]{#lbAC} ایجنت زبیکس -سرویس ایجنت زبیکس ## NAME zabbix\_get - Zabbix get utility [ ]{#lbAC} ## نام دستور zabbix\_get - ابزار دریافت مقادیر Zabbix [ ]{#lbAC} ## NAME zabbix\_js - Zabbix JS utility [ ]{#lbAC} ## نام zabbix\_js - ابزار Zabbix JS [ ]{#lbAC} ## NAME zabbix\_proxy - Zabbix proxy daemon [ ]{#lbAC} ## نام zabbix\_js - ابزار Zabbix JS [ ]{#lbAC} ## NAME zabbix\_sender - Zabbix sender utility [ ]{#lbAC} ## نام zabbix\_sender - ابزار ارسال کننده Zabbix [ ]{#lbAC} ## NAME zabbix\_server - Zabbix server daemon [ ]{#lbAC} ## نام zabbix\_server - دیمون سرور Zabbix [ ]{#lbAC} ## NAME zabbix\_web\_service - Zabbix web service [ ]{#lbAC} ## نام zabbix\_web\_service - وب سرویس Zabbix [ ]{#lbAC} ### Notation ### نشانه گذاری ## OPTIONS **-c**, **--config** *config-file* Use the alternate *config-file* instead of the default one. **-f**, **--foreground** Run Zabbix agent in foreground. **-R**, **--runtime-control** *runtime-option* Perform administrative functions according to *runtime-option*. [ ]{#lbAF} ## گزینه ها **-c**، **--config** *config-file* به جای فایل پیش فرض، از *config-file* جایگزین استفاده کنید. **-R**، **--runtime-control** *runtime-option* عملکردهای اداری را مطابق *runtime-option* انجام دهید. ## OPTIONS **-c**, **--config** *config-file* Use the alternate *config-file* instead of the default one. **-f**, **--foreground** Run Zabbix proxy in foreground. **-R**, **--runtime-control** *runtime-option* Perform administrative functions according to *runtime-option*. [ ]{#lbAF} ## گزینه ها **-c**، **--config** *config-file* به جای فایل پیش فرض، از *config-file* جایگزین استفاده کنید. **-R**، **--runtime-control** *runtime-option* عملکردهای اداری را مطابق *runtime-option* انجام دهید. ## OPTIONS **-c**, **--config** *config-file* Use the alternate *config-file* instead of the default one. **-R**, **--runtime-control** *runtime-option* Perform administrative functions according to *runtime-option*. ## گزینه ها **-c**، **--config** *config-file* به جای فایل پیش فرض، از *config-file* جایگزین استفاده کنید. **-R**، **--runtime-control** *runtime-option* عملکردهای اداری را مطابق *runtime-option* انجام دهید. #### Options |Parameter|Description| |---------|-----------| |-V --version|Print the plugin version and license information.| |-h --help|Print help information (shorthand).| #### Options |Parameter|Description| |---------|-----------| |-V --version|Print the plugin version and license information.| |-h --help|Print help information (shorthand).| ### Overview In Zabbix 6.0, [service monitoring](/manual/it_services) functionality has been reworked significantly (see [What's new in Zabbix 6.0.0](https://www.zabbix.com/documentation/6.0/en/manual/introduction/whatsnew600#services) for the list of changes). This page describes how services and SLAs, defined in earlier Zabbix versions, are changed during an upgrade to Zabbix 6.0 or newer. ### Overview In Zabbix 6.0, [service monitoring](/manual/it_services) functionality has been reworked significantly (see [What's new in Zabbix 6.0.0](https://www.zabbix.com/documentation/6.0/en/manual/introduction/whatsnew600#services) for the list of changes). This page describes how services and SLAs defined in earlier Zabbix versions are changed during an upgrade to Zabbix 6.0 or newer. #### Overview This section lists parameters supported in the Ceph Zabbix agent 2 plugin configuration file (ceph.conf). Note that: - The default values reflect process defaults, not the values in the shipped configuration files; - Zabbix supports configuration files only in UTF-8 encoding without [BOM](https://en.wikipedia.org/wiki/Byte_order_mark); - Comments starting with "\#" are only supported at the beginning of the line. #### Overview This section lists parameters supported in the Ceph Zabbix agent 2 plugin configuration file (ceph.conf). Note that: - The default values reflect process defaults, not the values in the shipped configuration files; - Zabbix supports configuration files only in UTF-8 encoding without [BOM](https://en.wikipedia.org/wiki/Byte_order_mark); - Comments starting with "\#" are only supported at the beginning of the line. #### Overview This section lists parameters supported in the Docker Zabbix agent 2 plugin configuration file (docker.conf). Note that: - The default values reflect process defaults, not the values in the shipped configuration files; - Zabbix supports configuration files only in UTF-8 encoding without [BOM](https://en.wikipedia.org/wiki/Byte_order_mark); - Comments starting with "\#" are only supported at the beginning of the line. #### Overview This section lists parameters supported in the Docker Zabbix agent 2 plugin configuration file (docker.conf). Note that: - The default values reflect process defaults, not the values in the shipped configuration files; - Zabbix supports configuration files only in UTF-8 encoding without [BOM](https://en.wikipedia.org/wiki/Byte_order_mark); - Comments starting with "\#" are only supported at the beginning of the line. #### Overview This section lists parameters supported in the Memcached Zabbix agent 2 plugin configuration file (memcached.conf). Note that: - The default values reflect process defaults, not the values in the shipped configuration files; - Zabbix supports configuration files only in UTF-8 encoding without [BOM](https://en.wikipedia.org/wiki/Byte_order_mark); - Comments starting with "\#" are only supported at the beginning of the line. #### Overview This section lists parameters supported in the Memcached Zabbix agent 2 plugin configuration file (memcached.conf). Note that: - The default values reflect process defaults, not the values in the shipped configuration files; - Zabbix supports configuration files only in UTF-8 encoding without [BOM](https://en.wikipedia.org/wiki/Byte_order_mark); - Comments starting with "\#" are only supported at the beginning of the line. #### Overview This section lists parameters supported in the Modbus Zabbix agent 2 plugin configuration file (modbus.conf). Note that: - The default values reflect process defaults, not the values in the shipped configuration files; - Zabbix supports configuration files only in UTF-8 encoding without [BOM](https://en.wikipedia.org/wiki/Byte_order_mark); - Comments starting with "\#" are only supported at the beginning of the line. #### Overview This section lists parameters supported in the Modbus Zabbix agent 2 plugin configuration file (modbus.conf). Note that: - The default values reflect process defaults, not the values in the shipped configuration files; - Zabbix supports configuration files only in UTF-8 encoding without [BOM](https://en.wikipedia.org/wiki/Byte_order_mark); - Comments starting with "\#" are only supported at the beginning of the line. #### Overview This section lists parameters supported in the MQTT Zabbix agent 2 plugin configuration file (mqtt.conf). Note that: - The default values reflect process defaults, not the values in the shipped configuration files; - Zabbix supports configuration files only in UTF-8 encoding without [BOM](https://en.wikipedia.org/wiki/Byte_order_mark); - Comments starting with "\#" are only supported at the beginning of the line. #### Overview This section lists parameters supported in the MQTT Zabbix agent 2 plugin configuration file (mqtt.conf). Note that: - The default values reflect process defaults, not the values in the shipped configuration files; - Zabbix supports configuration files only in UTF-8 encoding without [BOM](https://en.wikipedia.org/wiki/Byte_order_mark); - Comments starting with "\#" are only supported at the beginning of the line. #### Overview This section lists parameters supported in the MySQL Zabbix agent 2 plugin configuration file (mysql.conf). Note that: - The default values reflect process defaults, not the values in the shipped configuration files; - Zabbix supports configuration files only in UTF-8 encoding without [BOM](https://en.wikipedia.org/wiki/Byte_order_mark); - Comments starting with "\#" are only supported at the beginning of the line. #### Overview This section lists parameters supported in the MySQL Zabbix agent 2 plugin configuration file (mysql.conf). Note that: - The default values reflect process defaults, not the values in the shipped configuration files; - Zabbix supports configuration files only in UTF-8 encoding without [BOM](https://en.wikipedia.org/wiki/Byte_order_mark); - Comments starting with "\#" are only supported at the beginning of the line. ### Parameters `(array)` IDs of hosts to delete. ### پارامتر ها `(array)` IDs of hosts to delete. ### Parameters `(array)` IDs of items to clear. ### پارامتر ها `(array)` IDs of items to clear. ### Parameters `(array)` IDs of the actions to delete. ### پارامترها شناسه «(آرایه)» های اکشن برای حذف کردن . ### Parameters `(array)` IDs of the correlations to delete. ### پارامتر ها «(آرایه)» شناسه های همبستگی برای حذف. ### Parameters `(array)` IDs of the dashboards to delete. ### پارامتر ها «(آرایه)» شناسه های همبستگی برای حذف. ### Parameters `(array)` IDs of the discovery rules to delete. ### پارامتر ها «(آرایه)» شناسه های همبستگی برای حذف. ### Parameters `(array)` IDs of the graph prototypes to delete. ###پارامتر ها `object graphprototype.delete(array graphPrototypeIds)` This method allows to delete graph prototypes. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Parameters `(array)` IDs of the graphs to delete. ### پارامتر ها `(array)` IDs of the graphs to delete. ### Parameters `(array)` IDs of the host groups to delete. ###پارامتر ها `(array)` IDs of the host groups to delete. ### Parameters `(array)` IDs of the host interfaces to delete. ### پارامتر ها `(array)` IDs of the host interfaces to delete. ### Parameters `(array)` IDs of the host prototypes to delete. ### پارامتر ها `(array)` IDs of the host prototypes to delete. ### Parameters `(array)` IDs of the icon maps to delete. ### پارامتر ها `(array)` IDs of the icon maps to delete. ### Parameters `(array)` IDs of the LLD rules to delete. ### پارامتر ها «(آرایه)» شناسه های همبستگی برای حذف. ### Parameters `(array)` IDs of the web scenarios to delete. ### پارامتر ها `(array)` IDs of the web scenarios to delete. ### Parameters `(array)` The method accepts an empty array. ### پارامترها `(آرایه)` این روش یک آرایه خالی را می پذیرد. ### Parameters `(object/array)` Scripts to create. The method accepts scripts with the [standard script properties](/manual/api/reference/script/object#script). ### پارامترها اسکریپت هایی برای ایجاد `(شیء/آرایه). این روش اسکریپت هایی را با [خواص اسکریپت استاندارد می پذیرد ](/دستی/api/reference/script/object#script). ## Part I - "Hello, world!" In this section you will learn how to create the minimum required widget elements and add a new widget to Zabbix frontend. ## Part I - "Hello, world!" In this section you will learn how to create the minimum required widget elements and add a new widget to Zabbix frontend. ## Part II - Gauge chart ## Part II - Gauge chart # Plugins # Plugins ### Return values `(array)` Returns an array with changes in configuration, that will be made. ### مقادیر را برمی گرداند `(آرایه)` یک آرایه را با تغییراتی در پیکربندی ساخته شده است را برمی گرداند ### Return values `(boolean )` Returns boolean true as result on successful update. ### مقادیر را برمی گرداند «(بولین)» در به‌روزرسانی موفقیت‌آمیز، بولین واقعی را برمی‌گرداند. ### Return values `(boolean)` Returns `true` if importing has been successful. ### مقادیر را برمی گرداند «(بولین)» اگر وارد کردن موفقیت آمیز باشد، «درست» را برمی‌گرداند. ### Return values `(boolean)` Returns `true` if the copying was successful. ### مقادیر را برمی گرداند ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### بازگشت مقادیر «(عدد صحیح/آرایه)» یکی را برمی‌گرداند: - آرایه ای از اشیاء؛ - تعداد اشیاء بازیابی شده، اگر پارامتر "countOutput" داشته باشد استفاده شده است. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### بازگشت مقادیر «(عدد صحیح/آرایه)» یکی را برمی‌گرداند: - آرایه ای از اشیاء؛ - تعداد اشیاء بازیابی شده، اگر پارامتر "countOutput" داشته باشد استفاده شده است. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### بازگشت مقادیر «(عدد صحیح/آرایه)» یکی را برمی‌گرداند: - آرایه ای از اشیاء؛ - تعداد اشیاء بازیابی شده، اگر پارامتر "countOutput" داشته باشد استفاده شده است. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### بازگشت مقادیر «(عدد صحیح/آرایه)» یکی را برمی‌گرداند: - آرایه ای از اشیاء؛ - تعداد اشیاء بازیابی شده، اگر پارامتر "countOutput" داشته باشد استفاده شده است. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### بازگشت مقادیر «(عدد صحیح/آرایه)» یکی را برمی‌گرداند: - آرایه ای از اشیاء؛ - تعداد اشیاء بازیابی شده، اگر پارامتر "countOutput" داشته باشد استفاده شده است. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### بازگشت مقادیر «(عدد صحیح/آرایه)» یکی را برمی‌گرداند: - آرایه ای از اشیاء؛ - تعداد اشیاء بازیابی شده، اگر پارامتر "countOutput" داشته باشد استفاده شده است. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ###بازگشت مقادیر `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### بازگشت مقادیر «(عدد صحیح/آرایه)» یکی را برمی‌گرداند: - آرایه ای از اشیاء؛ - تعداد اشیاء بازیابی شده، اگر پارامتر "countOutput" داشته باشد استفاده شده است. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### بازگشت مقادیر «(عدد صحیح/آرایه)» یکی را برمی‌گرداند: - آرایه ای از اشیاء؛ - تعداد اشیاء بازیابی شده، اگر پارامتر "countOutput" داشته باشد استفاده شده است. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### بازگشت مقادیر «(عدد صحیح/آرایه)» یکی را برمی‌گرداند: - آرایه ای از اشیاء؛ - تعداد اشیاء بازیابی شده، اگر پارامتر "countOutput" داشته باشد استفاده شده است. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### بازگشت مقادیر «(عدد صحیح/آرایه)» یکی را برمی‌گرداند: - آرایه ای از اشیاء؛ - تعداد اشیاء بازیابی شده، اگر پارامتر "countOutput" داشته باشد استفاده شده است. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### بازگشت مقادیر «(عدد صحیح/آرایه)» یکی را برمی‌گرداند: - آرایه ای از اشیاء؛ - تعداد اشیاء بازیابی شده، اگر پارامتر "countOutput" داشته باشد استفاده شده است. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### بازگشت مقادیر «(عدد صحیح/آرایه)» یکی را برمی‌گرداند: - آرایه ای از اشیاء؛ - تعداد اشیاء بازیابی شده، اگر پارامتر "countOutput" داشته باشد استفاده شده است. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### بازگشت مقادیر «(عدد صحیح/آرایه)» یکی را برمی‌گرداند: - آرایه ای از اشیاء؛ - تعداد اشیاء بازیابی شده، اگر پارامتر "countOutput" داشته باشد استفاده شده است. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### بازگشت مقادیر «(عدد صحیح/آرایه)» یکی را برمی‌گرداند: - آرایه ای از اشیاء؛ - تعداد اشیاء بازیابی شده، اگر پارامتر "countOutput" داشته باشد استفاده شده است. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### بازگشت مقادیر «(عدد صحیح/آرایه)» یکی را برمی‌گرداند: - آرایه ای از اشیاء؛ - تعداد اشیاء بازیابی شده، اگر پارامتر "countOutput" داشته باشد استفاده شده است. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### بازگشت مقادیر «(عدد صحیح/آرایه)» یکی را برمی‌گرداند: - آرایه ای از اشیاء؛ - تعداد اشیاء بازیابی شده، اگر پارامتر "countOutput" داشته باشد استفاده شده است. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### بازگشت مقادیر «(عدد صحیح/آرایه)» یکی را برمی‌گرداند: - آرایه ای از اشیاء؛ - تعداد اشیاء بازیابی شده، اگر پارامتر "countOutput" داشته باشد استفاده شده است. ### Return values `(object)` Returns an object containing the IDs of the cleared items under the `itemids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the cleared items under the `itemids` property. ### Return values `(object)` Returns an object containing the IDs of the created actions under the `actionids` property. The order of the returned IDs matches the order of the passed actions. ### برگشت مقادیر `(object)` یک شی حاوی شناسه اقدامات ایجاد شده را تحت خاصیت «شناسه اکشن » برمی گرداند . ترتیب شناسه های برگشتی با ترتیب اقدامات انجام شده مطابقت دارد ### Return values `(object)` Returns an object containing the IDs of the created correlations under the `correlationids` property. The order of the returned IDs matches the order of the passed correlations. ### مقادیر را برمی گرداند `(object)` یک شی حاوی شناسه های اسکریپت های ایجاد شده را تحت ویژگی "scriptids" برمی گرداند. ترتیب شناسه های برگشتی با ترتیب اسکریپت های پاس شده مطابقت دارد ### Return values `(object)` Returns an object containing the IDs of the created dashboards under the `dashboardids` property. The order of the returned IDs matches the order of the passed dashboards. ### برگشت مقادیر `(object)` یک شی حاوی شناسه اقدامات ایجاد شده را تحت خاصیت «شناسه اکشن » برمی گرداند . ترتیب شناسه های برگشتی با ترتیب اقدامات انجام شده مطابقت دارد ### Return values `(object)` Returns an object containing the IDs of the created discovery rules under the `druleids` property. The order of the returned IDs matches the order of the passed discovery rules. ### برگشت مقادیر `(object)` یک شی حاوی شناسه اقدامات ایجاد شده را تحت خاصیت «شناسه اکشن » برمی گرداند . ترتیب شناسه های برگشتی با ترتیب اقدامات انجام شده مطابقت دارد ### Return values `(object)` Returns an object containing the IDs of the created graph prototypes under the `graphids` property. The order of the returned IDs matches the order of the passed graph prototypes. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the created graph prototypes under the `graphids` property. The order of the returned IDs matches the order of the passed graph prototypes. ### Return values `(object)` Returns an object containing the IDs of the created graphs under the `graphids` property. The order of the returned IDs matches the order of the passed graphs. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the created graphs under the `graphids` property. The order of the returned IDs matches the order of the passed graphs. ### Return values `(object)` Returns an object containing the IDs of the created host groups under the `groupids` property. The order of the returned IDs matches the order of the passed host groups. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the created hosts under the `hostids` property. The order of the returned IDs matches the order of the passed hosts. ### Return values `(object)` Returns an object containing the IDs of the created host interfaces under the `interfaceids` property. ###بازگشت مقادیر `(object)` Returns an object containing the IDs of the created host interfaces under the `interfaceids` property. ### Return values `(object)` Returns an object containing the IDs of the created host interfaces under the `interfaceids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the created host interfaces under the `interfaceids` property. ### Return values `(object)` Returns an object containing the IDs of the created host interfaces under the `interfaceids` property. The order of the returned IDs matches the order of the passed host interfaces. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the created host interfaces under the `interfaceids` property. The order of the returned IDs matches the order of the passed host interfaces. ### Return values `(object)` Returns an object containing the IDs of the created host prototypes under the `hostids` property. The order of the returned IDs matches the order of the passed host prototypes. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the created host prototypes under the `hostids` property. The order of the returned IDs matches the order of the passed host prototypes. ### Return values `(object)` Returns an object containing the IDs of the created hosts under the `hostids` property. The order of the returned IDs matches the order of the passed hosts. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the created hosts under the `hostids` property. The order of the returned IDs matches the order of the passed hosts. ### Return values `(object)` Returns an object containing the IDs of the created icon maps under the `iconmapids` property. The order of the returned IDs matches the order of the passed icon maps. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the created icon maps under the `iconmapids` property. The order of the returned IDs matches the order of the passed icon maps. ### Return values `(object)` Returns an object containing the IDs of the created images under the `imageids` property. The order of the returned IDs matches the order of the passed images. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the created images under the `imageids` property. The order of the returned IDs matches the order of the passed images. ### Return values `(object)` Returns an object containing the IDs of the created LLD rules under the `itemids` property. The order of the returned IDs matches the order of the passed LLD rules. ### برگشت مقادیر `(object)` یک شی حاوی شناسه اقدامات ایجاد شده را تحت خاصیت «شناسه اکشن » برمی گرداند . ترتیب شناسه های برگشتی با ترتیب اقدامات انجام شده مطابقت دارد ### Return values `(object)` Returns an object containing the IDs of the created scripts under the `scriptids` property. The order of the returned IDs matches the order of the passed scripts. ### مقادیر را برمی گرداند `(object)` یک شی حاوی شناسه های اسکریپت های ایجاد شده را تحت ویژگی "scriptids" برمی گرداند. ترتیب شناسه های برگشتی با ترتیب اسکریپت های پاس شده مطابقت دارد ### Return values `(object)` Returns an object containing the IDs of the created templates under the `templateids` property. The order of the returned IDs matches the order of the passed templates. ### برگشت مقادیر `(object)` یک شی حاوی شناسه اقدامات ایجاد شده را تحت خاصیت «شناسه اکشن » برمی گرداند . ترتیب شناسه های برگشتی با ترتیب اقدامات انجام شده مطابقت دارد ### Return values `(object)` Returns an object containing the IDs of the created web scenarios under the `httptestids` property. The order of the returned IDs matches the order of the passed web scenarios. ###بازگشت مقادیر `(object)` Returns an object containing the IDs of the created web scenarios under the `httptestids` property. The order of the returned IDs matches the order of the passed web scenarios. ### Return values `(object)` Returns an object containing the IDs of the deleted actions under the `actionids` property. ### بازگشت مقادیر `(object)` یک شی حاوی شناسه تحت خاصیت «actionids». اقدامات حذف شده را برمی گرداند ### Return values `(object)` Returns an object containing the IDs of the deleted correlations under the `correlationids` property. ### بازگشت مقادیر `(object)` یک شی حاوی شناسه های حذف شده را برمی گرداند همبستگی تحت خاصیت "correlationids". ### Return values `(object)` Returns an object containing the IDs of the deleted dashboards under the `dashboardids` property. ### بازگشت مقادیر `(object)` یک شی حاوی شناسه های به روز شده را تحت خاصیت "dashboardids" برمی گرداند ### Return values `(object)` Returns an object containing the IDs of the deleted discovery rules under the `druleids` property. ### بازگشت مقادیر `(object)` یک شی حاوی شناسه تحت خاصیت «actionids». اقدامات حذف شده را برمی گرداند ### Return values `(object)` Returns an object containing the IDs of the deleted graph prototypes under the `graphids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the deleted graph prototypes under the `graphids` property. ### Return values `(object)` Returns an object containing the IDs of the deleted graphs under the `graphids` property. ###بازگشت مقادیر `(object)` Returns an object containing the IDs of the deleted graphs under the `graphids` property. ### Return values `(object)` Returns an object containing the IDs of the deleted host groups under the `groupids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the deleted host groups under the `groupids` property. ### Return values `(object)` Returns an object containing the IDs of the deleted host interfaces under the `interfaceids` property. ###بازگشت مقادیر `(object)` Returns an object containing the IDs of the deleted host interfaces under the `interfaceids` property. ### Return values `(object)` Returns an object containing the IDs of the deleted host interfaces under the `interfaceids` property. ###بازگشت مقادیر `(object)` Returns an object containing the IDs of the deleted host interfaces under the `interfaceids` property. ### Return values `(object)` Returns an object containing the IDs of the deleted host prototypes under the `hostids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the deleted host prototypes under the `hostids` property. ### Return values `(object)` Returns an object containing the IDs of the deleted hosts under the `hostids` property. ###بازگشت مقادیر `(object)` Returns an object containing the IDs of the deleted hosts under the `hostids` property. ### Return values `(object)` Returns an object containing the IDs of the deleted icon maps under the `iconmapids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the deleted icon maps under the `iconmapids` property. ### Return values `(object)` Returns an object containing the IDs of the deleted web scenarios under the `httptestids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the deleted web scenarios under the `httptestids` property. ### Return values `(object)` Returns an object containing the IDs of the updated actions under the `actionids` property. ### بازگشت مقادیر `(object)` یک شی حاوی شناسه اقدامات به روز شده را برمی گرداند تحت خاصیت «اکشنیدز». ### Return values `(object)` Returns an object containing the IDs of the updated correlations under the `correlationids` property. ### بازگشت مقادیر `(object)` یک شی حاوی شناسه های به روز شده را برمی گرداند همبستگی تحت خاصیت "correlationids". ### Return values `(object)` Returns an object containing the IDs of the updated dashboards under the `dashboardids` property. ### بازگشت مقادیر `(object)` یک شی حاوی شناسه های به روز شده را برمی گرداند همبستگی تحت خاصیت "correlationids". ### Return values `(object)` Returns an object containing the IDs of the updated discovery rules under the `druleids` property. ### بازگشت مقادیر `(object)` یک شی حاوی شناسه تحت خاصیت «actionids». اقدامات حذف شده را برمی گرداند ### Return values `(object)` Returns an object containing the IDs of the updated graph prototypes under the `graphids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the updated graph prototypes under the `graphids` property. ### Return values `(object)` Returns an object containing the IDs of the updated graphs under the `graphids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the updated graphs under the `graphids` property. ### Return values `(object)` Returns an object containing the IDs of the updated host groups under the `groupids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the updated host groups under the `groupids` property. ### Return values `(object)` Returns an object containing the IDs of the updated host groups under the `groupids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the updated host groups under the `groupids` property. ### Return values `(object)` Returns an object containing the IDs of the updated host groups under the `groupids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the updated host groups under the `groupids` property. ### Return values `(object)` Returns an object containing the IDs of the updated host groups under the `groupids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the updated host groups under the `groupids` property. ### Return values `(object)` Returns an object containing the IDs of the updated host interfaces under the `interfaceids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the updated host interfaces under the `interfaceids` property. ### Return values `(object)` Returns an object containing the IDs of the updated host prototypes under the `hostids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the updated host prototypes under the `hostids` property. ### Return values `(object)` Returns an object containing the IDs of the updated hosts under the `hostids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the updated hosts under the `hostids` property. ### Return values `(object)` Returns an object containing the IDs of the updated hosts under the `hostids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the updated hosts under the `hostids` property. ### Return values `(object)` Returns an object containing the IDs of the updated hosts under the `hostids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the updated hosts under the `hostids` property. ### Return values `(object)` Returns an object containing the IDs of the updated hosts under the `hostids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the updated hosts under the `hostids` property. ### Return values `(object)` Returns an object containing the IDs of the updated icon maps under the `iconmapids` property. ### مقادیر را برمی گرداند `(object)` یک شی حاوی شناسه آیکون نقشه های به روز شده را برمی گرداند که تحت ویژگی "iconmapids" می باشد . ### Return values `(object)` Returns an object containing the IDs of the updated LLD rules under the `itemids` property. ### بازگشت مقادیر `(object)` یک شی حاوی شناسه تحت خاصیت «actionids». اقدامات حذف شده را برمی گرداند ### Return values `(object)` Returns an object containing the IDs of the updated web scenarios under the `httptestid` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the updated web scenarios under the `httptestid` property. ### Return values `(object)` Returns authentication object. ### مقادیر را برمی گرداند `(object)` شیء احراز هویت را برمی گرداند. ### Return values `(object)` Returns autoregistration object. ### مقادیر را برمی گرداند `(object)` شیء احراز هویت را برمی گرداند. ### Return values `(object)` Returns housekeeping object. ###بازگشت مقادیر `(object)` Returns housekeeping object. ### Return values `(string)` Returns a serialized string containing the requested configuration data. ### بازگشت مقادیر `(string)` یک رشته سریالی حاوی موارد درخواستی را برمی گرداند داده های پیکربندی ### Return values `(string)` Returns the version of the Zabbix API. ::: notetip Starting from Zabbix 2.0.4 the version of the API matches the version of Zabbix. ::: ### بازگشت مقادیر `(string)` نسخه Zabbix API را برمی گرداند. ::: یادداشت شروع از Zabbix 2.0.4 نسخه API با نسخه Zabbix مطابقت دارد. ::: # script.create #ساخت اسکریپت ### See also - [Audit log object](/manual/api/reference/auditlog/object) ### همچنین ببینید - [ابژه گزارش حسابرسی](/دستی/api/reference/auditlog/object) ## SEE ALSO Documentation <https://www.zabbix.com/manuals> **[zabbix\_agent2](zabbix_agent2)**(8), **[zabbix\_agentd](zabbix_agentd)**(8), **[zabbix\_get](zabbix_get)**(1), **[zabbix\_proxy](zabbix_proxy)**(8), **[zabbix\_sender](zabbix_sender)**(1), **[zabbix\_server](zabbix_server)**(8) ------------------------------------------------------------------------ [ ]{#index} ## همچنین ببینید مستندات <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8)، ***[zabbix\_get](zabbix_get)**(8)، **[zabbix\_js](zabbix_js)**(8)، **[zabbix\_proxy](zabbix_proxy)**(8) **[zabbix\_sender](zabbix_sender)**(8) ***[zabbix\_server](zabbix_server)**(8) [ ]{#lbAI} ## SEE ALSO Documentation <https://www.zabbix.com/manuals> **[zabbix\_agent2](zabbix_agent2)**(8), **[zabbix\_get](zabbix_get)**(1), **[zabbix\_js](zabbix_js)**(1), **[zabbix\_proxy](zabbix_proxy)**(8), **[zabbix\_sender](zabbix_sender)**(1), **[zabbix\_server](zabbix_server)**(8) [ ]{#lbAJ} ## همچنین ببینید مستندات <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8)، ***[zabbix\_get](zabbix_get)**(8)، **[zabbix\_js](zabbix_js)**(8)، **[zabbix\_proxy](zabbix_proxy)**(8) **[zabbix\_sender](zabbix_sender)**(8) ***[zabbix\_server](zabbix_server)**(8) [ ]{#lbAI} ## SEE ALSO Documentation <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8), **[zabbix\_get](zabbix_get)**(1), **[zabbix\_proxy](zabbix_proxy)**(8), **[zabbix\_sender](zabbix_sender)**(1), **[zabbix\_js](zabbix_js)**(1), **[zabbix\_agent2](zabbix_agent2)**(8) [ ]{#lbAJ} ## همچنین ببینید مستندات <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8)، ***[zabbix\_get](zabbix_get)**(1)، **[zabbix\_proxy](zabbix_proxy)**(8)، ***[zabbix\_sender](zabbix_sender)**(1)، **[zabbix\_js](zabbix_js)**(1)، ***[zabbix\_agent2](zabbix_agent2)**(8) [ ]{#lbAJ} ## SEE ALSO Documentation <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8), **[zabbix\_get](zabbix_get)**(1), **[zabbix\_proxy](zabbix_proxy)**(8), **[zabbix\_sender](zabbix_sender)**(1), **[zabbix\_server](zabbix_server)**(8), **[zabbix\_js](zabbix_js)**(1), **[zabbix\_agent2](zabbix_agent2)**(8) [ ]{#lbAH} ## همچنین ببینید مستندات <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8)، ***[zabbix\_get](zabbix_get)**(1)، **[zabbix\_proxy](zabbix_proxy)**(8)، **[zabbix\_sender](zabbix_sender)**(1)، **[zabbix\_server](zabbix_server)**(8)، **[zabbix\_js](zabbix_js)**(1)، ***[zabbix\_agent2](zabbix_agent2)**(8) [ ]{#lbAH} ## SEE ALSO Documentation <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8), **[zabbix\_get](zabbix_get)**(1), **[zabbix\_proxy](zabbix_proxy)**(8), **[zabbix\_server](zabbix_server)**(8), **[zabbix\_js](zabbix_js)**(1), **[zabbix\_agent2](zabbix_agent2)**(8), **[zabbix\_web\_service](zabbix_web_service)**(8) [ ]{#lbAJ} ## همچنین ببینید مستندات <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8)، ***[zabbix\_get](zabbix_get)**(8)، **[zabbix\_js](zabbix_js)**(8)، **[zabbix\_proxy](zabbix_proxy)**(8) **[zabbix\_sender](zabbix_sender)**(8) ***[zabbix\_server](zabbix_server)**(8) [ ]{#lbAI} ## SEE ALSO Documentation <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8), **[zabbix\_get](zabbix_get)**(1), **[zabbix\_sender](zabbix_sender)**(1), **[zabbix\_server](zabbix_server)**(8), **[zabbix\_js](zabbix_js)**(1), **[zabbix\_agent2](zabbix_agent2)**(8) [ ]{#lbAJ} ## همچنین ببینید مستندات <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8)، ***[zabbix\_get](zabbix_get)**(8)، **[zabbix\_js](zabbix_js)**(8)، **[zabbix\_proxy](zabbix_proxy)**(8) **[zabbix\_sender](zabbix_sender)**(8) ***[zabbix\_server](zabbix_server)**(8) [ ]{#lbAI} ## SEE ALSO Documentation <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8), **[zabbix\_get](zabbix_get)**(8), **[zabbix\_js](zabbix_js)**(8), **[zabbix\_proxy](zabbix_proxy)**(8), **[zabbix\_sender](zabbix_sender)**(8), **[zabbix\_server](zabbix_server)**(8) [ ]{#lbAI} ## همچنین ببینید مستندات <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8)، ***[zabbix\_get](zabbix_get)**(8)، **[zabbix\_js](zabbix_js)**(8)، **[zabbix\_proxy](zabbix_proxy)**(8) **[zabbix\_sender](zabbix_sender)**(8) ***[zabbix\_server](zabbix_server)**(8) [ ]{#lbAI} ## SEE ALSO Documentation <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8), **[zabbix\_proxy](zabbix_proxy)**(8), **[zabbix\_sender](zabbix_sender)**(1), **[zabbix\_server](zabbix_server)**(8), **[zabbix\_js](zabbix_js)**(1), **[zabbix\_agent2](zabbix_agent2)**(8), **[zabbix\_web\_service](zabbix_web_service)**(8) [ ]{#lbAI} ## همچنین ببینید مستندات <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8)، ***[zabbix\_get](zabbix_get)**(8)، **[zabbix\_js](zabbix_js)**(8)، **[zabbix\_proxy](zabbix_proxy)**(8) **[zabbix\_sender](zabbix_sender)**(8) ***[zabbix\_server](zabbix_server)**(8) [ ]{#lbAI} ### See also - [Graph](/manual/api/reference/graph/object#graph) ### همچنین ببینید - [Graph item](/manual/api/reference/graphitem/object#graph_item) ### See also - [hostinterface.create](create) - [host.massadd](/manual/api/reference/host/massadd) - [Host](/manual/api/reference/host/object#host) ### همچنین ببینید - [hostinterface.create](create) - [host.massadd](/manual/api/reference/host/massadd) - [Host](/manual/api/reference/host/object#host) ### See also - [hostinterface.delete](delete) - [host.massremove](/manual/api/reference/host/massremove) ### همچنین ببینید - [hostinterface.delete](delete) - [host.massremove](/manual/api/reference/host/massremove) ### See also - [hostinterface.massadd](massadd) - [host.massadd](/manual/api/reference/host/massadd) ### همچنین ببینید - [hostinterface.massadd](massadd) - [host.massadd](/manual/api/reference/host/massadd) ### See also - [hostinterface.massremove](massremove) - [host.massremove](/manual/api/reference/host/massremove) ### همچنین ببینید - [hostinterface.massremove](massremove) - [host.massremove](/manual/api/reference/host/massremove) ### See also - [Host](/manual/api/reference/host/object#host) - [Item](/manual/api/reference/item/object#item) ###همچنین ببینید - [Host](/manual/api/reference/host/object#host) - [Item](/manual/api/reference/item/object#item) ### See also - [host.update](/manual/api/reference/host/update) - [host.massupdate](/manual/api/reference/host/massupdate) ### همچنین ببینید - [host.update](/manual/api/reference/host/update) - [host.massupdate](/manual/api/reference/host/massupdate) ### Source CAction::create() in *ui/include/classes/api/services/CAction.php*. ### منبع CAction::create() در *ui/include/classes/api/services/CAction.php*. ### Source CAction::delete() in *ui/include/classes/api/services/CAction.php*. ### منبع CAction::delete() در *ui/include/classes/api/services/CAction.php*. ### Source CAction::get() in *ui/include/classes/api/services/CAction.php*. ### منبع CAction::get() در *ui/include/classes/api/services/CAction.php*. ### Source CAction::update() in *ui/include/classes/api/services/CAction.php*. ### منبع CAction::update() در *ui/include/classes/api/services/CAction.php*. ### Source CAlert::get() in *ui/include/classes/api/services/CAlert.php*. ### منبع CAlert::get() در *ui/include/classes/api/services/CAlert.php*. ### Source CAPIInfo::version() in *ui/include/classes/api/services/CAPIInfo.php*. ### منبع CAPIInfo::version() در *ui/include/classes/api/services/CAPIInfo.php*. ### Source CAuditLog::get() in *ui/include/classes/api/services/CAuditLog.php*. ### منبع CAuditLog::get() در *ui/include/classes/api/services/CAuditLog.php*. ### Source CAutoregistration::get() in *ui/include/classes/api/services/CAutoregistration.php*. ### منبع CIconMap::update() در *ui/include/classes/api/services/CIconMap.php*. ### Source CAutoregistration::update() in *ui/include/classes/api/services/CAutoregistration.php*. ### منبع CIconMap::update() در *ui/include/classes/api/services/CIconMap.php*. ### Source CConfiguration::export() in *ui/include/classes/api/services/CConfiguration.php*. ### منبع CIconMap::update() در *ui/include/classes/api/services/CIconMap.php*. ### Source CConfiguration::importcompare() in *ui/include/classes/api/services/CConfiguration.php*. ### منبع CIconMap::update() در *ui/include/classes/api/services/CIconMap.php*. ### Source CConfiguration::import() in *ui/include/classes/api/services/CConfiguration.php*. ### منبع CIconMap::update() در *ui/include/classes/api/services/CIconMap.php*. ### Source CCorrelation::create() in *ui/include/classes/api/services/CCorrelation.php*. ### منبع CIconMap::update() در *ui/include/classes/api/services/CIconMap.php*. ### Source CCorrelation::delete() in *ui/include/classes/api/services/CCorrelation.php*. ### منبع CCCorrelation::delete() در *ui/include/classes/api/services/CCorrelation.php*. ### Source CCorrelation::get() in *ui/include/classes/api/services/CCorrelation.php*. ### منبع CCorrelation::get() in *ui/include/classes/api/services/CCorrelation.php*. ### Source CCorrelation::update() in *ui/include/classes/api/services/CCorrelation.php*. ### منبع CCCorrelation::update() در *ui/include/classes/api/services/CCorrelation.php*. ### Source CDashboard::create() in *ui/include/classes/api/services/CDashboard.php*. ### منبع CDashboard::create() in *ui/include/classes/api/services/CDashboard.php*. ### Source CDashboard::delete() in *ui/include/classes/api/services/CDashboard.php*. ### منبع CDashboard::delete() in *ui/include/classes/api/services/CDashboard.php*. ### Source CDashboard::get() in *ui/include/classes/api/services/CDashboard.php*. ### منبع CDashboard::get() in *ui/include/classes/api/services/CDashboard.php*. ### Source CDashboard::update() in *ui/include/classes/api/services/CDashboard.php*. ### منبع CDashboard::update() in *ui/include/classes/api/services/CDashboard.php*. ### Source CDCheck::get() in *ui/include/classes/api/services/CDCheck.php*. ### منبع CDCheck::get() in *ui/include/classes/api/services/CDCheck.php*. ### Source CDHost::get() in *ui/include/classes/api/services/CDHost.php*. ### منبع CDHost::get() in *ui/include/classes/api/services/CDHost.php*. ### Source CDiscoveryRule::create() in *ui/include/classes/api/services/CDiscoveryRule.php*. ### منبع CDiscoveryrule::copy() in *ui/include/classes/api/services/CDiscoveryRule.php*. ### Source CDiscoveryRule::delete() in *ui/include/classes/api/services/CDiscoveryRule.php*. ### منبع CDiscoveryrule::copy() in *ui/include/classes/api/services/CDiscoveryRule.php*. ### Source CDiscoveryRule::get() in *ui/include/classes/api/services/CDiscoveryRule.php*. ### منبع CDiscoveryrule::copy() in *ui/include/classes/api/services/CDiscoveryRule.php*. ### Source CDiscoveryRule::update() in *ui/include/classes/api/services/CDiscoveryRule.php*. ### منبع CDiscoveryrule::copy() in *ui/include/classes/api/services/CDiscoveryRule.php*. ### Source CDRule::create() in *ui/include/classes/api/services/CDRule.php*. ### منابع CDRule::create() in *ui/include/classes/api/services/CDRule.php*. ### Source CDRule::delete() in *ui/include/classes/api/services/CDRule.php*. ### منبع CDRule::delete() in *ui/include/classes/api/services/CDRule.php*. ### Source CDRule::get() in *ui/include/classes/api/services/CDRule.php*. ### منبع CDRule::get() in *ui/include/classes/api/services/CDRule.php*. ### Source CDRule::update() in *ui/include/classes/api/services/CDRule.php*. ### منبع CDRule::update() in *ui/include/classes/api/services/CDRule.php*. ### Source CDService::get() in *ui/include/classes/api/services/CDService.php*. ### منبع CDService::get() in *ui/include/classes/api/services/CDService.php*. ### Source CEvent::acknowledge() in *ui/include/classes/api/services/CEvent.php*. ### منبع CEvent::acknowledge() in *ui/include/classes/api/services/CEvent.php*. ### Source CEvent::get() in *ui/include/classes/api/services/CEvent.php*. ### منبع CEvent::get() in *ui/include/classes/api/services/CEvent.php*. ### Source CGraph::create() in *ui/include/classes/api/services/CGraph.php*. منبع ### Source CGraph::delete() in *ui/include/classes/api/services/CGraph.php*. ### منبع CGraph::delete() in *ui/include/classes/api/services/CGraph.php*. ### Source CGraph::get() in *ui/include/classes/api/services/CGraph.php*. ### منبع CGraph::get() in *ui/include/classes/api/services/CGraph.php*. ### Source CGraphItem::get() in *ui/include/classes/api/services/CGraphItem.php*. ### منبع CGraphItem::get() in *ui/include/classes/api/services/CGraphItem.php*. ### Source CGraphPrototype::create() in *ui/include/classes/api/services/CGraphPrototype.php*. ### منبع CGraphPrototype::create() in *ui/include/classes/api/services/CGraphPrototype.php*. ### Source CGraphPrototype::delete() in *ui/include/classes/api/services/CGraphPrototype.php*. ### منبع CGraphPrototype::delete() in *ui/include/classes/api/services/CGraphPrototype.php*. ### Source CGraphPrototype::get() in *ui/include/classes/api/services/CGraphPrototype.php*. ### منبع CGraphPrototype::get() in *ui/include/classes/api/services/CGraphPrototype.php*. ### Source CGraphPrototype::update() in *ui/include/classes/api/services/CGraphPrototype.php*. ### منبع CGraphPrototype::update() in *ui/include/classes/api/services/CGraphPrototype.php*. ### Source CGraph::update() in *ui/include/classes/api/services/CGraph.php*. ### منبع CGraph::update() in *ui/include/classes/api/services/CGraph.php*. ### Source CHaNode::get() in *ui/include/classes/api/services/CHaNode.php*. ### منبع CHaNode::get() in *ui/include/classes/api/services/CHaNode.php*. ### Source CHistory::clear() in *ui/include/classes/api/services/CHistory.php*. ### منبع CHistory::clear() in *ui/include/classes/api/services/CHistory.php*. ### Source CHistory::get() in *ui/include/classes/api/services/CHistory.php*. ###منبع CHistory::get() in *ui/include/classes/api/services/CHistory.php*. ### Source CHost::create() in *ui/include/classes/api/services/CHost.php*. ### منبع CHost::create() in *ui/include/classes/api/services/CHost.php*. ### Source CHost::delete() in *ui/include/classes/api/services/CHost.php*. ###منبع CHost::delete() in *ui/include/classes/api/services/CHost.php*. ### Source CHost::get() in *ui/include/classes/api/services/CHost.php*. ### منبع CDHost::get() in *ui/include/classes/api/services/CDHost.php*. ### Source CHostGroup::create() in *ui/include/classes/api/services/CHostGroup.php*. ### منبع CHostGroup::create() in *ui/include/classes/api/services/CHostGroup.php*. ### Source CHostGroup::delete() in *ui/include/classes/api/services/CHostGroup.php*. ### منبع CHostGroup::create() in *ui/include/classes/api/services/CHostGroup.php*. ### Source CHostGroup::get() in *ui/include/classes/api/services/CHostGroup.php*. ### منبع CHostGroup::get() in *ui/include/classes/api/services/CHostGroup.php*. ### Source CHostGroup::massAdd() in *ui/include/classes/api/services/CHostGroup.php*. ### منبع CHostGroup::massAdd() in *ui/include/classes/api/services/CHostGroup.php*. ### Source CHostGroup::massRemove() in *ui/include/classes/api/services/CHostGroup.php*. ### منبع CHostGroup::massRemove() in *ui/include/classes/api/services/CHostGroup.php*. ### Source CHostGroup::massUpdate() in *ui/include/classes/api/services/CHostGroup.php*. ### منبع CHostGroup::massUpdate() in *ui/include/classes/api/services/CHostGroup.php*. ### Source CHostGroup::update() in *ui/include/classes/api/services/CHostGroup.php*. ### منبع CHostGroup::update() in *ui/include/classes/api/services/CHostGroup.php*. ### Source CHostInterface::create() in *ui/include/classes/api/services/CHostInterface.php*. ### منبع CHostInterface::create() in *ui/include/classes/api/services/CHostInterface.php*. ### Source CHostInterface::delete() in *ui/include/classes/api/services/CHostInterface.php*. ###منبع CHostInterface::delete() in *ui/include/classes/api/services/CHostInterface.php*. ### Source CHostInterface::get() in *ui/include/classes/api/services/CHostInterface.php*. ### منبع CHostInterface::get() in *ui/include/classes/api/services/CHostInterface.php*. ### Source CHostInterface::massAdd() in *ui/include/classes/api/services/CHostInterface.php*. ### منبع CHostInterface::massAdd() in *ui/include/classes/api/services/CHostInterface.php*. ### Source CHostInterface::massRemove() in *ui/include/classes/api/services/CHostInterface.php*. ### منبع CHostInterface::massRemove() in *ui/include/classes/api/services/CHostInterface.php*. ### Source CHostInterface::replaceHostInterfaces() in *ui/include/classes/api/services/CHostInterface.php*. ### منبع CHostInterface::replaceHostInterfaces() in *ui/include/classes/api/services/CHostInterface.php*. ### Source CHostInterface::update() in *ui/include/classes/api/services/CHostInterface.php*. ### منبع CHostInterface::update() in *ui/include/classes/api/services/CHostInterface.php*. ### Source CHost::massAdd() in *ui/include/classes/api/services/CHost.php*. ### منبع CHost::massAdd() in *ui/include/classes/api/services/CHost.php*. ### Source CHost::massRemove() in *ui/include/classes/api/services/CHost.php*. ### منبع CHost::massRemove() in *ui/include/classes/api/services/CHost.php*. ### Source CHost::massUpdate() in *ui/include/classes/api/services/CHost.php*. ### منبع CHost::massUpdate() in *ui/include/classes/api/services/CHost.php*. ### Source CHostPrototype::create() in *ui/include/classes/api/services/CHostPrototype.php*. ###منبع CHostPrototype::create() in *ui/include/classes/api/services/CHostPrototype.php*. ### Source CHostPrototype::delete() in *ui/include/classes/api/services/CHostPrototype.php*. ### منبع CHostPrototype::delete() in *ui/include/classes/api/services/CHostPrototype.php*. ### Source CHostPrototype::get() in *ui/include/classes/api/services/CHostPrototype.php*. ###منبع CHostPrototype::get() in *ui/include/classes/api/services/CHostPrototype.php*. ### Source CHostPrototype::update() in *ui/include/classes/api/services/CHostPrototype.php*. ### منبع CHostPrototype::update() in *ui/include/classes/api/services/CHostPrototype.php*. ### Source CHost::update() in *ui/include/classes/api/services/CHost.php*. ### منبع CHost::create() in *ui/include/classes/api/services/CHost.php*. ### Source CHousekeeping ::get() in *ui/include/classes/api/services/CHousekeeping.php*. ### منبع CHousekeeping ::get() in *ui/include/classes/api/services/CHousekeeping.php*. ### Source CHousekeeping::update() in *ui/include/classes/api/services/CHousekeeping.php*. ### منبع CHousekeeping::update() in *ui/include/classes/api/services/CHousekeeping.php*. ### Source CHttpTest::create() in *ui/include/classes/api/services/CHttpTest.php*. ### منبع CHttpTest::create() in *ui/include/classes/api/services/CHttpTest.php*. ### Source CHttpTest::delete() in *ui/include/classes/api/services/CHttpTest.php*. ###منبع CHttpTest::delete() in *ui/include/classes/api/services/CHttpTest.php*. ### Source CHttpTest::get() in *ui/include/classes/api/services/CHttpTest.php*. ###منبع CHttpTest::get() in *ui/include/classes/api/services/CHttpTest.php*. ### Source CHttpTest::update() in *ui/include/classes/api/services/CHttpTest.php*. ###منبع CHttpTest::update() in *ui/include/classes/api/services/CHttpTest.php*. ### Source CIconMap::create() in *ui/include/classes/api/services/CIconMap.php*. ### منبع CIconMap::update() در *ui/include/classes/api/services/CIconMap.php*. ### Source CIconMap::delete() in *ui/include/classes/api/services/CIconMap.php*. ###منبع CIconMap::delete() in *ui/include/classes/api/services/CIconMap.php*. ### Source CIconMap::get() in *ui/include/classes/api/services/CIconMap.php*. ### منبع CIconMap::update() در *ui/include/classes/api/services/CIconMap.php*. ### Source CIconMap::update() in *ui/include/classes/api/services/CIconMap.php*. ### منبع CIconMap::update() در *ui/include/classes/api/services/CIconMap.php*. ### Source CImage::create() in *ui/include/classes/api/services/CImage.php*. ### منبع CImage::create() in *ui/include/classes/api/services/CImage.php*. ### Source CScript::create() in *ui/include/classes/api/services/CScript.php*. ### منبع CIconMap::update() در *ui/include/classes/api/services/CIconMap.php*. ### Source CTemplate::create() in *ui/include/classes/api/services/CTemplate.php*. ### منبع CTemplate::create() in *ui/include/classes/api/services/CTemplate.php*. #### Structure The header consists of four fields. All numbers in the header are formatted as little-endian. |Field|Size|Size<br>(large packet)|Description| |--|-|-|------| |`<PROTOCOL>`|4|4|`"ZBXD"` or `5A 42 58 44`| |`<FLAGS>`|1|1|Protocol flags:<br>`0x01` - Zabbix communications protocol<br>`0x02` - compression<br>`0x04` - large packet| |`<DATALEN>`|4|8|Data length.| |`<RESERVED>`|4|8|When compression is used (`0x02` flag) - the length of uncompressed data<br>When compression is not used - `00 00 00 00`| #### Structure The header consists of four fields. All numbers in the header are formatted as little-endian. |Field|Size|Size<br>(large packet)|Description| |--|-|-|------| |`<PROTOCOL>`|4|4|`"ZBXD"` or `5A 42 58 44`| |`<FLAGS>`|1|1|Protocol flags:<br>`0x01` - Zabbix communications protocol<br>`0x02` - compression<br>`0x04` - large packet| |`<DATALEN>`|4|8|Data length.| |`<RESERVED>`|4|8|When compression is used (`0x02` flag) - the length of uncompressed data<br>When compression is not used - `00 00 00 00`| ## SYNOPSIS **zabbix\_get -s** *host-name-or-IP* \[**-p** *port-number*\] \[**-I** *IP-address*\] \[**-t** *timeout*\] **-k** *item-key*\ **zabbix\_get -s** *host-name-or-IP* \[**-p** *port-number*\] \[**-I** *IP-address*\] \[**-t** *timeout*\] **--tls-connect** **cert** **--tls-ca-file** *CA-file* \[**--tls-crl-file** *CRL-file*\] \[**--tls-agent-cert-issuer** *cert-issuer*\] \[**--tls-agent-cert-subject** *cert-subject*\] **--tls-cert-file** *cert-file* **--tls-key-file** *key-file* \[**--tls-cipher13** *cipher-string*\] \[**--tls-cipher** *cipher-string*\] **-k** *item-key*\ **zabbix\_get -s** *host-name-or-IP* \[**-p** *port-number*\] \[**-I** *IP-address*\] \[**-t** *timeout*\] **--tls-connect** **psk** **--tls-psk-identity** *PSK-identity* **--tls-psk-file** *PSK-file* \[**--tls-cipher13** *cipher-string*\] \[**--tls-cipher** *cipher-string*\] **-k** *item-key*\ **zabbix\_get -h**\ **zabbix\_get -V** [ ]{#lbAD} ## نحوه استفاده **zabbix\_get -s** *host-name-or-IP* \[**-p** *port-number*\] \[**-I** *IP-address*\] \[**-t** *timeout*\] **-k** *item-key*\ **zabbix\_get -s** *host-name-or-IP* \[**-p** *port-number*\] \[**-I** *IP-address*\] \[**-t** *timeout*\] **--tls-connect** **cert** **--tls-ca-file** *CA-file* \[**--tls-crl-file** *CRL-file*\] \[**--tls-agent-cert-issuer** *cert-issuer*\] \[**--tls-agent-cert-subject** *cert-subject*\] **--tls-cert-file** *cert-file* **--tls-key-file** *key-file* \[**--tls-cipher13** *cipher-string*\] \[**--tls-cipher** *cipher-string*\] **-k** *item-key*\ **zabbix\_get -s** *host-name-or-IP* \[**-p** *port-number*\] \[**-I** *IP-address*\] \[**-t** *timeout*\] **--tls-connect** **psk** **--tls-psk-identity** *PSK-identity* **--tls-psk-file** *PSK-file* \[**--tls-cipher13** *cipher-string*\] \[**--tls-cipher** *cipher-string*\] **-k** *item-key*\ **zabbix\_get -h**\ **zabbix\_get -V** [ ]{#lbAD} ## SYNOPSIS **zabbix\_js -s** *script-file* **-p** *input-param* \[**-l** *log-level*\] \[**-t** *timeout*\]\ **zabbix\_js -s** *script-file* **-i** *input-file* \[**-l** *log-level*\] \[**-t** *timeout*\]\ **zabbix\_js -h**\ **zabbix\_js -V** [ ]{#lbAD} ## خلاصه **zabbix\_js -s** *اسکریپت-فایل* **-p** *input-param* \[**-l** *log-level*\] \[**-t** *timeout*\]\ **zabbix\_js -s** *script-file* **-i** *input-file* \[**-l** *log-level*\] \[**-t** *timeout*\]\ **zabbix\_js -h**\ **zabbix\_js -V** [ ]{#lbAD} # template.create # ساخت قالب ### **unencrypted** connect without encryption (default) ```{=html} <!-- --> ``` **psk** connect using TLS and a pre-shared key ```{=html} <!-- --> ``` **cert** connect using TLS and a certificate ```{=html} <!-- --> ``` **--tls-ca-file** *CA-file* Full pathname of a file containing the top-level CA(s) certificates for peer certificate verification. **--tls-crl-file** *CRL-file* Full pathname of a file containing revoked certificates. **--tls-server-cert-issuer** *cert-issuer* Allowed server certificate issuer. **--tls-server-cert-subject** *cert-subject* Allowed server certificate subject. **--tls-cert-file** *cert-file* Full pathname of a file containing the certificate or certificate chain. **--tls-key-file** *key-file* Full pathname of a file containing the private key. **--tls-psk-identity** *PSK-identity* PSK-identity string. **--tls-psk-file** *PSK-file* Full pathname of a file containing the pre-shared key. **--tls-cipher13** *cipher-string* Cipher string for OpenSSL 1.1.1 or newer for TLS 1.3. Override the default ciphersuite selection criteria. This option is not available if OpenSSL version is less than 1.1.1. **--tls-cipher** *cipher-string* GnuTLS priority string (for TLS 1.2 and up) or OpenSSL cipher string (only for TLS 1.2). Override the default ciphersuite selection criteria. **-v**, **--verbose** Verbose mode, **-vv** for more details. **-h**, **--help** Display this help and exit. **-V**, **--version** Output version information and exit. [ ]{#lbAG} ### **رمزگذاری نشده** اتصال بدون رمزگذاری (پیش‌فرض) ```{=html} <!---> ``` **psk** با استفاده از TLS و یک کلید مشترک از قبل متصل شوید ```{=html} <!---> ``` **گواهی** با استفاده از TLS و گواهی متصل شوید ```{=html} <!---> ``` **--tls-ca-file** *CA-file* نام مسیر کامل یک فایل حاوی گواهی (های) CA سطح بالا برای تایید گواهی همتا **--tls-crl-file** *CRL-file* نام مسیر کامل یک فایل حاوی گواهی های باطل شده است. **--tls-server-cert-issuer** *cert-ssuer* صادرکننده گواهی سرور مجاز است. **--tls-server-cert-subject** *cert-subject* موضوع گواهی سرور مجاز است. **--tls-cert-file** *cert-file* نام مسیر کامل یک فایل حاوی گواهی یا زنجیره گواهی. **--tls-key-file** *key-file* نام مسیر کامل یک فایل حاوی کلید خصوصی. **--tls-psk-identity** *PSK-identity* رشته هویت PSK. **--tls-psk-file** *PSK-file* نام مسیر کامل یک فایل حاوی کلید از پیش مشترک. **--tls-cipher13** *رشته رمز* رشته رمز برای OpenSSL 1.1.1 یا جدیدتر برای TLS 1.3. نادیده گرفتن معیارهای انتخاب مجموعه رمز پیش فرض این گزینه در دسترس نیست اگر نسخه OpenSSL کمتر از 1.1.1 است. **--tls-cipher** *cipher-string* رشته اولویت GnuTLS (برای TLS 1.2 و بالاتر) یا رشته رمز OpenSSL (فقط برای TLS 1.2). معیارهای انتخاب مجموعه رمز پیش فرض را نادیده بگیرید. **-v**، **-- پرحرف** حالت پرمخاطب، **-vv** برای جزئیات بیشتر. **-h**، **--راهنما** این راهنما را نمایش دهید و از آن خارج شوید. **-V**، **--نسخه** اطلاعات نسخه خروجی و خروج. [ ]{#lbAG} #### Using mass update To mass-update some triggers, do the following: - Mark the checkboxes of the triggers you want to update in the list - Click on *Mass update* below the list - Navigate to the tab with required attributes (*Trigger*, *Tags* or *Dependencies*) - Mark the checkboxes of any attribute to update ![](../../../../assets/en/manual/config/triggers/trigger_mass.png) ![](../../../../assets/en/manual/config/triggers/trigger_mass_b.png) The following options are available when selecting the respective button for tag update: - *Add* - allows to add new tags for the triggers; - *Replace* - will remove any existing tags from the trigger and replace them with the one(s) specified below; - *Remove* - will remove specified tags from triggers. Note that tags with the same name but different values are not considered 'duplicates' and can be added to the same trigger. ![](../../../../assets/en/manual/config/triggers/trigger_mass_c.png) *Replace dependencies* - will remove any existing dependencies from the trigger and replace them with the one(s) specified. Click on *Update* to apply the changes. #### Using mass update To mass-update some triggers, do the following: - Mark the checkboxes of the triggers you want to update in the list - Click on *Mass update* below the list - Navigate to the tab with required attributes (*Trigger*, *Tags* or *Dependencies*) - Mark the checkboxes of any attribute to update ![](../../../../assets/en/manual/config/triggers/trigger_mass.png) ![](../../../../assets/en/manual/config/triggers/trigger_mass_b.png) The following options are available when selecting the respective button for tag update: - *Add* - allows to add new tags for the triggers; - *Replace* - will remove any existing tags from the trigger and replace them with the one(s) specified below; - *Remove* - will remove specified tags from triggers. Note, that tags with the same name, but different values are not considered 'duplicates' and can be added to the same trigger. ![](../../../../assets/en/manual/config/triggers/trigger_mass_c.png) *Replace dependencies* - will remove any existing dependencies from the trigger and replace them with the one(s) specified. Click on *Update* to apply the changes. # Zabbix Manual Welcome to the user manual for Zabbix software. These pages are created to help users successfully manage their monitoring tasks with Zabbix, from the simple to the more complex ones. # دفترچه راهنمای Zabbix به راهنمای کاربر نرم افزار Zabbix خوش آمدید. این صفحات ایجاد شده اند تا به کاربران کمک کند وظایف مانیتورینگ خود را با Zabbix، از ساده تا پیچیده، با موفقیت مدیریت کنند. ### ### # 10 Graph prototype # 10 Graph prototype # 10 Graph prototype # 10 Graph prototype # 10 Virtual machine monitoring # 10. Virtual machine monitoring # 11 Maintenance # 11. Maintenance # 11 Time zones # 11 منطقه زمانی # 12 Regular expressions # 12. Regular expressions # 13 Problem acknowledgment # 13. Problem acknowledgment # 14 Configuration export/import # 14. وارد کردن یا خروجی گرفتن از تنظیمات # 15 Discovery Please use the sidebar to access content in the Discovery section. # 15. Discovery Please use the sidebar to access content in the Discovery section. # 16 Distributed monitoring # 16. Distributed monitoring # 17 Encryption # 17. Encryption # 18 Web interface # 18. Web interface # 1 Introduction Please use the sidebar to access content in the Introduction section. # 1. Introduction Please use the sidebar to access content in the Introduction section. # 1 Menu # 1 منو # 1 Monitor Linux with Zabbix agent # 1. Monitor Linux with Zabbix agent # 2 Definitions # 2. Definitions # 3 Database upgrade to primary keys # 3 Database upgrade to primary keys # 3 Installation from sources You can get the very latest version of Zabbix by compiling it from the sources. A step-by-step tutorial for installing Zabbix from the sources is provided here. # 3 Installation from sources You can get the very latest version of Zabbix by compiling it from the sources. A step-by-step tutorial for installing Zabbix from the sources is provided here. # 3 Monitor Apache via HTTP # 3. Monitor Apache via HTTP # 3 Zabbix processes Please use the sidebar to access content in the Zabbix process section. # 3. Zabbix processes Please use the sidebar to access content in the Zabbix process section. # 4 Installation from packages # 4 Installation from packages # 4 Installation Please use the sidebar to access content in the Installation section. # 4. Installation Please use the sidebar to access content in the Installation section. # 4 Monitor MySQL with Zabbix agent 2 # 4. Monitor MySQL with Zabbix agent 2 # 4 Zabbix agent 2 (UNIX) # Zabbix Agent 2 (یونیکس) # 5 Installation from containers # 5 Installation from containers # 5 Quickstart Please use the sidebar to access content in the Quickstart section. # 5. Quickstart Please use the sidebar to access content in the Quickstart section. # 6 Web interface installation This section provides step-by-step instructions for installing Zabbix web interface. Zabbix frontend is written in PHP, so to run it a PHP supported webserver is needed. # 6 Web interface installation This section provides step-by-step instructions for installing Zabbix web interface. Zabbix frontend is written in PHP, so to run it a PHP supported webserver is needed. # 6 Zabbix appliance # 6. Zabbix appliance # 7 Configuration Please use the sidebar to access content in the Configuration section. # 7. Configuration Please use the sidebar to access content in the Configuration section. # 7 Geomap # 7 Geomap # 7 Geomap # 7 Geomap # 7 Upgrade procedure # 7 Upgrade procedure # 8 Graph # 8 Graph # 8 Graph # 8 Graph # 8 Service monitoring # 8. Service monitoring # 9 Graph (classic) # 9 Graph (classic) # 9 Graph (classic) # 9 Graph (classic) # 9 Web monitoring مانیتورینگ وب # action.create # ساخت اکشن # action.delete #پاک کردن اکشن # action.get # دریافت اکشن # action.update # action.update # alert.get # alert.get # apiinfo.version # apiinfo.version # Appendix 1. Reference commentary # ضمیمه 1. تفسیر مرجع # auditlog.get # auditlog.get # authentication.get دریافت احرازهویت # authentication.update به روز رسانی احرازهویت # autoregistration.get دریافت ثبت خودکار # autoregistration.update دریافت ثبت خودکار ##### BufferSend The time interval in seconds which determines how often values are sent from the buffer to Zabbix server.<br>Note that if the buffer is full, the data will be sent sooner. Default: `5`<br> Range: 1-3600 ##### BufferSend The time interval in seconds which determines how often values are sent from the buffer to Zabbix server.<br>Note, that if the buffer is full, the data will be sent sooner. Default: `5`<br> Range: 1-3600 ##### Collapsed menu When the menu is collapsed to icons only, a full menu reappears as soon as the mouse cursor is placed upon it. Note that it reappears over page content; to move page content to the right you have to click on the expand button. If the mouse cursor again is placed outside the full menu, the menu will collapse again after two seconds. You can also make a collapsed menu reappear fully by hitting the Tab key. Hitting the Tab key repeatedly will allow to focus on the next menu element. ##### Collapsed menu When the menu is collapsed to icons only, a full menu reappears as soon as the mouse cursor is placed upon it. Note that it reappears over page content; to move page content to the right you have to click on the expand button. If the mouse cursor again is placed outside the full menu, the menu will collapse again after two seconds. You can also make a collapsed menu reappear fully by hitting the Tab key. Hitting the Tab key repeatedly will allow to focus on the next menu element. ##### Configuration examples For a basic example of how to set up Zabbix for monitoring VMware using the *VMware FQDN* template, see [*Monitor VMware with Zabbix*](/manual/guides/monitor_vmware). For a more detailed example of how to create a host, a low-level discovery rule, and a host prototype for monitoring VMware, see [*Setup example*](/manual/vm_monitoring/example). ##### Configuration examples For a basic example of how to set up Zabbix for monitoring VMware using the *VMware FQDN* template, see [*Monitor VMware with Zabbix*](/manual/guides/monitor_vmware). For a more detailed example of how to create a host, a low-level discovery rule, and a host prototype for monitoring VMware, see [*Setup example*](/manual/vm_monitoring/example). # configuration.export خروجی گرفتن از تنظیمات # configuration.import وارد کردن تنظیمات # configuration.importcompare مقایسه تنظیمات وارد شده #### Configuration To configure a CSV to JSON preprocessing step: - Go to the Preprocessing tab in [item](/manual/config/items/preprocessing)/[discovery rule](/manual/discovery/low_level_discovery#preprocessing) configuration - Click on *Add* - Select the *CSV to JSON* option ![](../../../../../assets/en/manual/appendix/csv_to_json_params.png){width="600"} The first parameter allows to set a custom delimiter. Note that if the first line of CSV input starts with "Sep=" and is followed by a single UTF-8 character then that character will be used as the delimiter in case the first parameter is not set. If the first parameter is not set and a delimiter is not retrieved from the "Sep=" line, then a comma is used as a separator. The second optional parameter allows to set a quotation symbol. If the *With header row* checkbox is marked, the header line values will be interpreted as column names (see [Header processing](#csv_header_processing) for more information). If the *Custom on fail* checkbox is marked, the item will not become unsupported in case of a failed preprocessing step. Additionally, custom error handling options may be set: discard the value, set a specified value or set a specified error message. #### Configuration To configure a CSV to JSON preprocessing step: - Go to the Preprocessing tab in [item](/manual/config/items/preprocessing)/[discovery rule](/manual/discovery/low_level_discovery#preprocessing) configuration - Click on *Add* - Select the *CSV to JSON* option ![](../../../../../assets/en/manual/appendix/csv_to_json_params.png){width="600"} The first parameter allows to set a custom delimiter. Note that if the first line of CSV input starts with "Sep=" and is followed by a single UTF-8 character then that character will be used as the delimiter in case the first parameter is not set. If the first parameter is not set and a delimiter is not retrieved from the "Sep=" line, then a comma is used as a separator. The second optional parameter allows to set a quotation symbol. If the *With header row* checkbox is marked, the header line values will be interpreted as column names (see [Header processing](#csv_header_processing) for more information). If the *Custom on fail* checkbox is marked, the item will not become unsupported in case of a failed preprocessing step. Additionally custom error handling options may be set: discard the value, set a specified value or set a specified error message. #### Configuring tags The **Tags** tab allows to define scenario-level [tags](/manual/config/tagging). ![](../../assets/en/manual/config/scenario_c.png) Tagging allows to filter web scenarios and web monitoring [items](/manual/web_monitoring/items). #### تنظیم تگ ها The **Tags** tab allows to define scenario-level [tags](/manual/config/tagging). ![](../../assets/en/manual/config/scenario_c.png) Tagging allows to filter web scenarios and web monitoring [items](/manual/web_monitoring/items). # correlation.create # ایجاد همبستگی # correlation.delete # correlation.delete # correlation.get # correlation.get # correlation.update # correlation.update # Create a module (tutorial) # Create a module (tutorial) # Create a widget (tutorial) # Create a widget (tutorial) # dashboard.create ساخت داشبورد # dashboard.delete حذف داشبورد # dashboard.get # دریافت داشبورد # dashboard.update به روز رسانی داشبورد # dcheck.get # dcheck.get ## DESCRIPTION **zabbix\_agent2** is an application for monitoring parameters of various services.\ \ [ ]{#lbAE} ## شرح **zabbix\_agent2** یک برنامه کاربردی برای نظارت بر پارامترهای است خدمات مختلف.\ \ [ ]{#lbAE} ## DESCRIPTION **zabbix\_agentd** is a daemon for monitoring various server parameters. [ ]{#lbAE} ## شرح **zabbix\_agentd** دیمونی برای نظارت بر پارامترهای مختلف سرور است. [ ]{#lbAE} ## DESCRIPTION **zabbix\_get** is a command line utility for getting data from Zabbix agent. [ ]{#lbAE} ## شرح **zabbix\_get** یک ابزار خط فرمان برای دریافت داده از عامل Zabbix است. [ ]{#lbAE} ## DESCRIPTION **zabbix\_js** is a command line utility that can be used for embedded script testing. [ ]{#lbAE} ## شرح **zabbix\_js** یک ابزار خط فرمان است که می تواند برای جاسازی استفاده شود تست اسکریپت [ ]{#lbAE} ## DESCRIPTION **zabbix\_proxy** is a daemon that collects monitoring data from devices and sends it to Zabbix server. [ ]{#lbAE} ## شرح **zabbix\_proxy** دیمونی است که داده های نظارتی را از دستگاه ها جمع آوری می کند و آن را به سرور Zabbix ارسال می کند. [ ]{#lbAE} ## DESCRIPTION **zabbix\_sender** is a command line utility for sending monitoring data to Zabbix server or proxy. On the Zabbix server an item of type **Zabbix trapper** should be created with corresponding key. Note that incoming values will only be accepted from hosts specified in **Allowed hosts** field for this item. [ ]{#lbAE} ## شرح **zabbix\_sender** یک ابزار خط فرمان برای ارسال داده های نظارت است به سرور یا پروکسی Zabbix. در سرور Zabbix موردی از نوع **Zabbix trapper** باید با کلید مربوطه ایجاد شود. توجه داشته باشید که ورودی مقادیر فقط از میزبان های مشخص شده در **میزبان های مجاز** پذیرفته می شود. فیلد برای این مورد [ ]{#lbAE} ## DESCRIPTION **zabbix\_server** is the core daemon of Zabbix software. [ ]{#lbAE} ## شرح **zabbix\_server** دیمون اصلی نرم افزار Zabbix است. [ ]{#lbAE} ## DESCRIPTION **zabbix\_web\_service** is an application for providing web services to Zabbix components. [ ]{#lbAE} ## شرح **zabbix\_web\_service** اپلیکیشنی برای ارائه خدمات وب به اجزای Zabbix [ ]{#lbAE} # dhost.get # dhost.get # discoveryrule.create # ساختن قوانین جست وجو # discoveryrule.delete # پاک کردن قوانین جست وجو # discoveryrule.get # گرفتن قوانین جست وجو # discoveryrule.update # به روز رسانی قوانین جست وجو # drule.create # ساختن # drule.delete پاک کردن قانون جست وجو # drule.get دریافت حذف قانون جست و جو # drule.update # آپدیت قانون جست و جو # dservice.get # دریافت سرویس جست و جو # event.acknowledge # تایید رویداد # event.get دریافت رخداد ### Event tag The event tag object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |tag|string|Event tag name.| |value|string|Event tag value.| ### تگ رویداد The event tag object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |tag|string|Event tag name.| |value|string|Event tag value.| ### Example ### مثال ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ## EXAMPLES **zabbix\_get -s 127.0.0.1 -p 10050 -k "system.cpu.load\[all,avg1\]"**\ **zabbix\_get -s 127.0.0.1 -p 10050 -k "system.cpu.load\[all,avg1\]" --tls-connect cert --tls-ca-file /home/zabbix/zabbix\_ca\_file --tls-agent-cert-issuer "CN=Signing CA,OU=IT operations,O=Example Corp,DC=example,DC=com" --tls-agent-cert-subject "CN=server1,OU=IT operations,O=Example Corp,DC=example,DC=com" --tls-cert-file /home/zabbix/zabbix\_get.crt --tls-key-file /home/zabbix/zabbix\_get.key\ zabbix\_get -s 127.0.0.1 -p 10050 -k "system.cpu.load\[all,avg1\]" --tls-connect psk --tls-psk-identity "PSK ID Zabbix agentd" --tls-psk-file /home/zabbix/zabbix\_agentd.psk** [ ]{#lbAH} ## مثال ها **zabbix\_get -s 127.0.0.1 -p 10050 -k "system.cpu.load\[all,avg1\]"**\ **zabbix\_get -s 127.0.0.1 -p 10050 -k "system.cpu.load\[all,avg1\]" --tls-connect Cert --tls-ca-file /home/zabbix/zabbix\_ca\_file --tls-agent-cert-issuer "CN=امضای عملیات CA,OU=IT,O=مثال Corp,DC=example,DC=com" --tls-agent-cert-subject "CN=server1,OU=IT عملیات,O=Example Corp,DC=example,DC=com" --tls-cert-file /home/zabbix/zabbix\_get.crt --tls-key-file /home/zabbix/zabbix\_get.key\ zabbix\_get -s 127.0.0.1 -p 10050 -k "system.cpu.load\[all,avg1\]" --tls-connect psk --tls-psk-identity "PSK ID Zabbix agentd" --tls-psk-file /home/zabbix/zabbix\_agentd.psk** [ ]{#lbAH} ## EXAMPLES **zabbix\_js -s script-file.js -p example** [ ]{#lbAG} ## مثال ها **zabbix\_js -s script-file.js -p مثال** [ ]{#lbAG} ## EXAMPLES **zabbix\_sender -c /etc/zabbix/zabbix\_agentd.conf -k mysql.queries -o 342.45**\ Send **342.45** as the value for **mysql.queries** item of monitored host. Use monitored host and Zabbix server defined in agent configuration file. **zabbix\_sender -c /etc/zabbix/zabbix\_agentd.conf -s "Monitored Host" -k mysql.queries -o 342.45**\ Send **342.45** as the value for **mysql.queries** item of **Monitored Host** host using Zabbix server defined in agent configuration file. \ **zabbix\_sender -z 192.168.1.113 -i data\_values.txt** \ Send values from file **data\_values.txt** to Zabbix server with IP **192.168.1.113**. Host names and keys are defined in the file. \ **echo "- hw.serial.number 1287872261 SQ4321ASDF" | zabbix\_sender -c /usr/local/etc/zabbix\_agentd.conf -T -i -**\ Send a timestamped value from the commandline to Zabbix server, specified in the agent configuration file. Dash in the input data indicates that hostname also should be used from the same configuration file. \ **echo '"Zabbix server" trapper.item ""' | zabbix\_sender -z 192.168.1.113 -p 10000 -i -**\ Send empty value of an item to the Zabbix server with IP address **192.168.1.113** on port **10000** from the commandline. Empty values must be indicated by empty double quotes. **zabbix\_sender -z 192.168.1.113 -s "Monitored Host" -k mysql.queries -o 342.45 --tls-connect cert --tls-ca-file /home/zabbix/zabbix\_ca\_file --tls-cert-file /home/zabbix/zabbix\_agentd.crt --tls-key-file /home/zabbix/zabbix\_agentd.key**\ Send **342.45** as the value for **mysql.queries** item in **Monitored Host** host to server with IP **192.168.1.113** using TLS with certificate. **zabbix\_sender -z 192.168.1.113 -s "Monitored Host" -k mysql.queries -o 342.45 --tls-connect psk --tls-psk-identity "PSK ID Zabbix agentd" --tls-psk-file /home/zabbix/zabbix\_agentd.psk**\ Send **342.45** as the value for **mysql.queries** item in **Monitored Host** host to server with IP **192.168.1.113** using TLS with pre-shared key (PSK). [ ]{#lbAI} ## مثال ها **zabbix\_sender -c /etc/zabbix/zabbix\_agentd.conf -k mysql.queries -o 342.45**\ ارسال **342.45** به عنوان مقدار برای **mysql.queries** مورد نظارت شده میزبان. از میزبان نظارت شده و سرور Zabbix تعریف شده در عامل استفاده کنید فایل پیکربندی. **zabbix\_sender -c /etc/zabbix/zabbix\_agentd.conf -s "میزبان نظارت شده" -k mysql.queries -o 342.45**\ ارسال **342.45** به عنوان مقدار برای **mysql.queries** مورد **Monitored میزبان ** با استفاده از سرور Zabbix تعریف شده در فایل پیکربندی عامل. \ **zabbix\_sender -z 192.168.1.113 -i data\_values.txt** \ مقادیر را از فایل **data\_values.txt** به سرور Zabbix با IP ارسال کنید **192.168.1.113**. نام هاست و کلیدها در فایل تعریف شده است. \ **echo "- hw.serial.number 1287872261 SQ4321ASDF" | zabbix\_sender -c /usr/local/etc/zabbix\_agentd.conf -T -i -**\ یک مقدار مهر زمانی از خط فرمان به سرور Zabbix ارسال کنید، در فایل پیکربندی عامل مشخص شده است. خط تیره در داده های ورودی نشان می دهد که نام میزبان نیز باید از همان پیکربندی استفاده شود فایل. \ **echo '"سرور Zabbix" trapper.item ""' | zabbix\_sender -z 192.168.1.113 -p 10000 -i -**\ مقدار خالی یک مورد را با آدرس IP به سرور Zabbix ارسال کنید **192.168.1.113** در پورت **10000** از خط فرمان. ارزش های خالی باید با دو نقل قول خالی نشان داده شود. **zabbix\_sender -z 192.168.1.113 -s "میزبان نظارت شده" -k mysql.queries -o 342.45 --tls-connect Cert --tls-ca-file /home/zabbix/zabbix\_ca\_file --tls-cert-file /home/zabbix/zabbix\_agentd.crt --tls-key-file /home/zabbix/zabbix\_agentd.key**\ ارسال **342.45** به عنوان مقدار مورد **mysql.queries** در **Monitored میزبان ** میزبان به سرور با IP **192.168.1.113** با استفاده از TLS با گواهی **zabbix\_sender -z 192.168.1.113 -s "میزبان نظارت شده" -k mysql.queries -o 342.45 --tls-connect psk --tls-psk-identity "PSK ID Zabbix agent" --tls-psk-file /home/zabbix/zabbix\_agentd.psk**\ ارسال **342.45** به عنوان مقدار مورد **mysql.queries** در **Monitored میزبان ** میزبان به سرور با IP **192.168.1.113** با استفاده از TLS با کلید از پیش مشترک (PSK). [ ]{#lbAI} ## EXIT STATUS The exit status is 0 if the values were sent and all of them were successfully processed by server. If data was sent, but processing of at least one of the values failed, the exit status is 2. If data sending failed, the exit status is 1. [ ]{#lbAH} ## وضعیت خروج اگر مقادیر ارسال شده باشند و همه آنها ارسال شده باشند، وضعیت خروج 0 است با موفقیت توسط سرور پردازش شد. اگر داده ها ارسال شد، اما پردازش در حداقل یکی از مقادیر ناموفق، وضعیت خروج 2 است. در صورت ارسال داده ها ناموفق، وضعیت خروج 1 است. [ ]{#lbAH} ##### Export format Data can be exported using the Zabbix web frontend or [Zabbix API](/manual/api/reference/configuration). Supported export formats are YAML, XML and JSON. ##### فرمت صادرات داده ها را می توان با استفاده از صفحه وب Zabbix یا [Zabbix صادر کرد API](/دستی/api/reference/configuration). فرمت های صادراتی پشتیبانی شده هستند YAML، XML و JSON. ## FILES */usr/local/etc/zabbix\_agent2.conf* Default location of Zabbix agent 2 configuration file (if not modified during compile time). [ ]{#lbAH} ## فایل ها */usr/local/etc/zabbix\_agent2.conf* محل پیش‌فرض فایل پیکربندی عامل Zabbix 2 (در صورت عدم تغییر در طول زمان کامپایل). [ ]{#lbAH} ## FILES */usr/local/etc/zabbix\_agentd.conf* Default location of Zabbix agent configuration file (if not modified during compile time). [ ]{#lbAI} ## فایل ها */usr/local/etc/zabbix\_agent2.conf* محل پیش‌فرض فایل پیکربندی عامل Zabbix 2 (در صورت عدم تغییر در طول زمان کامپایل). [ ]{#lbAH} ## FILES */usr/local/etc/zabbix\_proxy.conf* Default location of Zabbix proxy configuration file (if not modified during compile time). [ ]{#lbAI} ## فایل ها */usr/local/etc/zabbix\_agent2.conf* محل پیش‌فرض فایل پیکربندی عامل Zabbix 2 (در صورت عدم تغییر در طول زمان کامپایل). [ ]{#lbAH} ## FILES */usr/local/etc/zabbix\_server.conf* Default location of Zabbix server configuration file (if not modified during compile time). [ ]{#lbAI} ## فایل ها */usr/local/etc/zabbix\_server.conf* محل پیش‌فرض فایل پیکربندی سرور Zabbix (در صورت عدم تغییر در طول زمان کامپایل). [ ]{#lbAI} ## FILES */usr/local/etc/zabbix\_web\_service.conf* Default location of Zabbix web service configuration file (if not modified during compile time). [ ]{#lbAG} ## فایل ها */usr/local/etc/zabbix\_web\_service.conf* محل پیش‌فرض فایل پیکربندی وب سرویس Zabbix (اگر نه در طول زمان کامپایل اصلاح شد). [ ]{#lbAG} # graph.create ساخت گراف # graph.delete # حذف گراف # graph.get #دریافت گراف # graphitem.get # دریافت آیتم های گراف # graphprototype.create # ساخت نمونه گراف # graphprototype.delete # حذف نمونه اولیه گراف # graphprototype.get # دریافت نمونه اولیه گراف # graphprototype.update # آپدیت نمونه اولیه گراف # graph.update # آپدیت گراف # hanode.get # دریافت نود HA #### Header processing The CSV file header line can be processed in two different ways: - If the *With header row* checkbox is marked - header line values are interpreted as column names. In this case the column names must be unique and the data row should not contain more columns than the header row. - If the *With header row* checkbox is not marked - the header line is interpreted as data. Column names are generated automatically (1,2,3,4...). CSV file example: Nr,Item name,Key,Qty 1,active agent item,agent.hostname,33 "2","passive agent item","agent.version","44" 3,"active,passive agent items",agent.ping,55 ::: noteclassic A quotation character within a quoted field in the input must be escaped by preceding it with another quotation character. ::: **Processing header line** JSON output when a header line is expected: ``` {.json} [ { "Nr":"1", "Item name":"active agent item", "Key":"agent.hostname", "Qty":"33" }, { "Nr":"2", "Item name":"passive agent item", "Key":"agent.version", "Qty":"44" }, { "Nr":"3", "Item name":"active,passive agent items", "Key":"agent.ping", "Qty":"55" } ] ``` **No header line processing** JSON output when a header line is not expected: ``` {.json} [ { "1":"Nr", "2":"Item name", "3":"Key", "4":"Qty" }, { "1":"1", "2":"active agent item", "3":"agent.hostname", "4":"33" }, { "1":"2", "2":"passive agent item", "3":"agent.version", "4":"44" }, { "1":"3", "2":"active,passive agent items", "3":"agent.ping", "4":"55" } ] ``` #### Header processing The CSV file header line can be processed in two different ways: - If the *With header row* checkbox is marked - header line values are interpreted as column names. In this case the column names must be unique and the data row should not contain more columns than the header row; - If the *With header row* checkbox is not marked - the header line is interpreted as data. Column names are generated automatically (1,2,3,4...) CSV file example: Nr,Item name,Key,Qty 1,active agent item,agent.hostname,33 "2","passive agent item","agent.version","44" 3,"active,passive agent items",agent.ping,55 ::: noteclassic A quotation character within a quoted field in the input must be escaped by preceding it with another quotation character. ::: **Processing header line** JSON output when a header line is expected: ``` {.json} [ { "Nr":"1", "Item name":"active agent item", "Key":"agent.hostname", "Qty":"33" }, { "Nr":"2", "Item name":"passive agent item", "Key":"agent.version", "Qty":"44" }, { "Nr":"3", "Item name":"active,passive agent items", "Key":"agent.ping", "Qty":"55" } ] ``` **No header line processing** JSON output when a header line is not expected: ``` {.json} [ { "1":"Nr", "2":"Item name", "3":"Key" "4":"Qty" }, { "1":"1", "2":"active agent item", "3":"agent.hostname" "4":"33" }, { "1":"2", "2":"passive agent item", "3":"agent.version" "4":"44" }, { "1":"3", "2":"active,passive agent items", "3":"agent.ping" "4":"55" } ] ``` # history.clear #پاک کردن تاریخچه # history.get # گرفتن تاریخچه # host.create # ساخت هاست # host.delete #حذف هاست # host.get # دریافت هاست # hostgroup.create # ساخت گروه هاست # hostgroup.delete # حذف گروه هاست # hostgroup.get # دریافت گروه هاستی # hostgroup.massadd # اضافه کردن گروهی هاست ها # hostgroup.massremove # حذف گروهی هاست ها # hostgroup.massupdate # به روز رسانی گروهی هاست ها # hostgroup.update # به روز رسانی گروه هاستی # hostinterface.create # ساخت اینترفیس هاست # hostinterface.delete # حذف اینترفیس هاست # hostinterface.get # دریافت اینترفیس هاست # hostinterface.massadd # اضافه کردن گروهی اینترفیس های هاست # hostinterface.massremove # حذف گروهی اینترفیس های هاست # hostinterface.replacehostinterfaces # جایگزینی اینترفیس های هاست # hostinterface.update # به روز رسانی اینترفیس هاست ها # host.massadd # اضافه کردن گروهی هاست ها # host.massremove # حذف گروهی هاست ها # host.massupdate # آپدیت گروهی هاست ها # hostprototype.create # ساخت هاست نمونه # hostprototype.delete #حذف نمونه اولیه هاست # hostprototype.get # دریافت نمونه اولیه هاست # hostprototype.update # به روز رسانی نمونه اولیه هاست # host.update # آپدیت هاست # housekeeping.get # دریافت اطلاعات ذخیره شده # housekeeping.update # آپدیت ذخیره سازی داده # httptest.create # ساخت Http تست # httptest.delete # حذف Http تست # httptest.get # دریافت Http تست # httptest.update # به روز رسانی http # iconmap.create # ساخت آیکون مپ # iconmap.delete # حذف آیکون مپ # iconmap.get # دریافت آیکون مپ # iconmap.update #دکمه آپدیت نقشه # image.create #ساخت Image #### Installing locales To list all installed languages, run: locale -a If some languages that are needed are not listed, open the */etc/locale.gen* file and uncomment the required locales. Since Zabbix uses UTF-8 encoding, you need to select locales with UTF-8 charset. Now run: locale-gen Restart the web server. The locales should now be installed. It may be required to reload Zabbix frontend page in browser using Ctrl + F5 for new languages to appear. #### Installing locales To list all installed languages, run: locale -a If some languages that are needed are not listed, open the */etc/locale.gen* file and uncomment the required locales. Since Zabbix uses UTF-8 encoding, you need to select locales with UTF-8 charset. Now, run: locale-gen Restart the web server. The locales should now be installed. It may be required to reload Zabbix frontend page in browser using Ctrl + F5 for new languages to appear. ##### Mass editing options Buttons below the list offer some mass-editing options: - *Enable* - change trigger status to *Enabled*. - *Disable* - change trigger status to *Disabled*. - *Copy* - copy the triggers to other hosts or templates. - *Mass update* - update several properties for a number of triggers at once. - *Delete* - delete the triggers. To use these options, mark the checkboxes before the respective triggers, then click on the required button. ##### Mass editing options Buttons below the list offer some mass-editing options: - *Enable* - change trigger status to *Enabled* - *Disable* - change trigger status to *Disabled* - *Copy* - copy the triggers to other hosts or templates - *Mass update* - update several properties for a number of triggers at once - *Delete* - delete the triggers To use these options, mark the checkboxes before the respective triggers, then click on the required button. ## NAME zabbix\_agent2 - Zabbix agent 2\ \ [ ]{#lbAC} ## نام zabbix\_agent2 - Zabbix agent 2\ \ [ ]{#lbAC} ## NAME zabbix\_agentd - Zabbix agent daemon [ ]{#lbAC} ایجنت زبیکس -سرویس ایجنت زبیکس ## NAME zabbix\_get - Zabbix get utility [ ]{#lbAC} ## نام دستور zabbix\_get - ابزار دریافت مقادیر Zabbix [ ]{#lbAC} ## NAME zabbix\_js - Zabbix JS utility [ ]{#lbAC} ## نام zabbix\_js - ابزار Zabbix JS [ ]{#lbAC} ## NAME zabbix\_proxy - Zabbix proxy daemon [ ]{#lbAC} ## نام zabbix\_js - ابزار Zabbix JS [ ]{#lbAC} ## NAME zabbix\_sender - Zabbix sender utility [ ]{#lbAC} ## نام zabbix\_sender - ابزار ارسال کننده Zabbix [ ]{#lbAC} ## NAME zabbix\_server - Zabbix server daemon [ ]{#lbAC} ## نام zabbix\_server - دیمون سرور Zabbix [ ]{#lbAC} ## NAME zabbix\_web\_service - Zabbix web service [ ]{#lbAC} ## نام zabbix\_web\_service - وب سرویس Zabbix [ ]{#lbAC} ### Notation ### نشانه گذاری ## OPTIONS **-c**, **--config** *config-file* Use the alternate *config-file* instead of the default one. **-f**, **--foreground** Run Zabbix agent in foreground. **-R**, **--runtime-control** *runtime-option* Perform administrative functions according to *runtime-option*. [ ]{#lbAF} ## گزینه ها **-c**، **--config** *config-file* به جای فایل پیش فرض، از *config-file* جایگزین استفاده کنید. **-R**، **--runtime-control** *runtime-option* عملکردهای اداری را مطابق *runtime-option* انجام دهید. ## OPTIONS **-c**, **--config** *config-file* Use the alternate *config-file* instead of the default one. **-f**, **--foreground** Run Zabbix proxy in foreground. **-R**, **--runtime-control** *runtime-option* Perform administrative functions according to *runtime-option*. [ ]{#lbAF} ## گزینه ها **-c**، **--config** *config-file* به جای فایل پیش فرض، از *config-file* جایگزین استفاده کنید. **-R**، **--runtime-control** *runtime-option* عملکردهای اداری را مطابق *runtime-option* انجام دهید. ## OPTIONS **-c**, **--config** *config-file* Use the alternate *config-file* instead of the default one. **-R**, **--runtime-control** *runtime-option* Perform administrative functions according to *runtime-option*. ## گزینه ها **-c**، **--config** *config-file* به جای فایل پیش فرض، از *config-file* جایگزین استفاده کنید. **-R**، **--runtime-control** *runtime-option* عملکردهای اداری را مطابق *runtime-option* انجام دهید. #### Options |Parameter|Description| |---------|-----------| |-V --version|Print the plugin version and license information.| |-h --help|Print help information (shorthand).| #### Options |Parameter|Description| |---------|-----------| |-V --version|Print the plugin version and license information.| |-h --help|Print help information (shorthand).| ### Overview In Zabbix 6.0, [service monitoring](/manual/it_services) functionality has been reworked significantly (see [What's new in Zabbix 6.0.0](https://www.zabbix.com/documentation/6.0/en/manual/introduction/whatsnew600#services) for the list of changes). This page describes how services and SLAs, defined in earlier Zabbix versions, are changed during an upgrade to Zabbix 6.0 or newer. ### Overview In Zabbix 6.0, [service monitoring](/manual/it_services) functionality has been reworked significantly (see [What's new in Zabbix 6.0.0](https://www.zabbix.com/documentation/6.0/en/manual/introduction/whatsnew600#services) for the list of changes). This page describes how services and SLAs defined in earlier Zabbix versions are changed during an upgrade to Zabbix 6.0 or newer. #### Overview With escalations you can create custom scenarios for sending notifications or executing remote commands. In practical terms it means that: - Users can be informed about new problems immediately. - Notifications can be repeated until the problem is resolved. - Sending a notification can be delayed. - Notifications can be escalated to another "higher" user group. - Remote commands can be executed immediately or when a problem is not resolved for a lengthy period. Actions are escalated based on the **escalation step**. Each step has a duration in time. You can define both the default duration and a custom duration of an individual step. The minimum duration of one escalation step is 60 seconds. You can start actions, such as sending notifications or executing commands, from any step. Step one is for immediate actions. If you want to delay an action, you can assign it to a later step. For each step, several actions can be defined. The number of escalation steps is not limited. Escalations are defined when [configuring an operation](operation#configuring_an_operation). Escalations are supported for problem operations only, not recovery. #### Overview With escalations you can create custom scenarios for sending notifications or executing remote commands. In practical terms it means that: - Users can be informed about new problems immediately - Notifications can be repeated until the problem is resolved - Sending a notification can be delayed - Notifications can be escalated to another "higher" user group - Remote commands can be executed immediately or when a problem is not resolved for a lengthy period Actions are escalated based on the **escalation step**. Each step has a duration in time. You can define both the default duration and a custom duration of an individual step. The minimum duration of one escalation step is 60 seconds. You can start actions, such as sending notifications or executing commands, from any step. Step one is for immediate actions. If you want to delay an action, you can assign it to a later step. For each step, several actions can be defined. The number of escalation steps is not limited. Escalations are defined when [configuring an operation](operation#configuring_an_operation). Escalations are supported for problem operations only, not recovery. ### Parameters `(array)` IDs of hosts to delete. ### پارامتر ها `(array)` IDs of hosts to delete. ### Parameters `(array)` IDs of items to clear. ### پارامتر ها `(array)` IDs of items to clear. ### Parameters `(array)` IDs of the actions to delete. ### پارامترها شناسه «(آرایه)» های اکشن برای حذف کردن . ### Parameters `(array)` IDs of the correlations to delete. ### پارامتر ها «(آرایه)» شناسه های همبستگی برای حذف. ### Parameters `(array)` IDs of the dashboards to delete. ### پارامتر ها «(آرایه)» شناسه های همبستگی برای حذف. ### Parameters `(array)` IDs of the discovery rules to delete. ### پارامتر ها «(آرایه)» شناسه های همبستگی برای حذف. ### Parameters `(array)` IDs of the graph prototypes to delete. ###پارامتر ها `object graphprototype.delete(array graphPrototypeIds)` This method allows to delete graph prototypes. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Parameters `(array)` IDs of the graphs to delete. ### پارامتر ها `(array)` IDs of the graphs to delete. ### Parameters `(array)` IDs of the host groups to delete. ###پارامتر ها `(array)` IDs of the host groups to delete. ### Parameters `(array)` IDs of the host interfaces to delete. ### پارامتر ها `(array)` IDs of the host interfaces to delete. ### Parameters `(array)` IDs of the host prototypes to delete. ### پارامتر ها `(array)` IDs of the host prototypes to delete. ### Parameters `(array)` IDs of the icon maps to delete. ### پارامتر ها `(array)` IDs of the icon maps to delete. ### Parameters `(array)` IDs of the LLD rules to delete. ### پارامتر ها «(آرایه)» شناسه های همبستگی برای حذف. ### Parameters `(array)` IDs of the web scenarios to delete. ### پارامتر ها `(array)` IDs of the web scenarios to delete. ### Parameters `(array)` The method accepts an empty array. ### پارامترها `(آرایه)` این روش یک آرایه خالی را می پذیرد. ### Parameters `(object/array)` [Host group properties](object#host_group) to be updated. The `groupid` property must be defined for each host group, all other properties are optional. Only the given properties will be updated, all others will remain unchanged. ### پارامتر ها `(object/array)` [Host group properties](object#host_group) to be updated. The `groupid` property must be defined for each host group, all other properties are optional. Only the given properties will be updated, all others will remain unchanged. ### Parameters `(object/array)` [Host interface properties](object#host_interface) to be updated. The `interfaceid` property must be defined for each host interface, all other properties are optional. Only the given properties will be updated, all others will remain unchanged. ### پارامتر ها `(object/array)` [Host interface properties](object#host_interface) to be updated. The `interfaceid` property must be defined for each host interface, all other properties are optional. Only the given properties will be updated, all others will remain unchanged. ### Parameters `(object/array)` Icon map properties to be updated. The `iconmapid` property must be defined for each icon map, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged. Additionally to the [standard icon map properties](object#icon_map), the method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |mappings|array|[Icon mappings](/manual/api/reference/iconmap/object#icon_mapping) to replace the existing icon mappings.| ### پارامترها "(شیء/آرایه)" ویژگی های آیکون نقشه به روز می شود. ویژگی "iconmapid" باید برای هر آیکون نقشه تعریف شود و بقیه ویژگی ها اختیاری هستند فقط ویژگی های تصویب شده به روز می شوند، بقیه بدون تغییر باقی خواهند ماند. علاوه بر [مشخصات استاندارد icon map] (object#icon_map)، متد پارامترهای زیر را می پذیرد. |پارامتر|[نوع](/manual/api/reference_commentary#data_types)|توضیحات| |--|--|------| |mappings|آرایه|[Icon mappings](/manual/api/reference/iconmap/object#icon_mapping) برای جایگزینی نگاشت نمادهای موجود.| ### Parameters `(object/array)` Scripts to create. The method accepts scripts with the [standard script properties](/manual/api/reference/script/object#script). ### پارامترها اسکریپت هایی برای ایجاد `(شیء/آرایه). این روش اسکریپت هایی را با [خواص اسکریپت استاندارد می پذیرد ](/دستی/api/reference/script/object#script). ## Part I - "Hello, world!" In this section you will learn how to create the minimum required widget elements and add a new widget to Zabbix frontend. ## Part I - "Hello, world!" In this section you will learn how to create the minimum required widget elements and add a new widget to Zabbix frontend. ## Part II - Gauge chart ## Part II - Gauge chart # Plugins # Plugins ### Return values `(array)` Returns an array with changes in configuration, that will be made. ### مقادیر را برمی گرداند `(آرایه)` یک آرایه را با تغییراتی در پیکربندی ساخته شده است را برمی گرداند ### Return values `(boolean )` Returns boolean true as result on successful update. ### مقادیر را برمی گرداند «(بولین)» در به‌روزرسانی موفقیت‌آمیز، بولین واقعی را برمی‌گرداند. ### Return values `(boolean)` Returns `true` if importing has been successful. ### مقادیر را برمی گرداند «(بولین)» اگر وارد کردن موفقیت آمیز باشد، «درست» را برمی‌گرداند. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### بازگشت مقادیر «(عدد صحیح/آرایه)» یکی را برمی‌گرداند: - آرایه ای از اشیاء؛ - تعداد اشیاء بازیابی شده، اگر پارامتر "countOutput" داشته باشد استفاده شده است. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### بازگشت مقادیر «(عدد صحیح/آرایه)» یکی را برمی‌گرداند: - آرایه ای از اشیاء؛ - تعداد اشیاء بازیابی شده، اگر پارامتر "countOutput" داشته باشد استفاده شده است. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### بازگشت مقادیر «(عدد صحیح/آرایه)» یکی را برمی‌گرداند: - آرایه ای از اشیاء؛ - تعداد اشیاء بازیابی شده، اگر پارامتر "countOutput" داشته باشد استفاده شده است. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### بازگشت مقادیر «(عدد صحیح/آرایه)» یکی را برمی‌گرداند: - آرایه ای از اشیاء؛ - تعداد اشیاء بازیابی شده، اگر پارامتر "countOutput" داشته باشد استفاده شده است. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### بازگشت مقادیر «(عدد صحیح/آرایه)» یکی را برمی‌گرداند: - آرایه ای از اشیاء؛ - تعداد اشیاء بازیابی شده، اگر پارامتر "countOutput" داشته باشد استفاده شده است. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### بازگشت مقادیر «(عدد صحیح/آرایه)» یکی را برمی‌گرداند: - آرایه ای از اشیاء؛ - تعداد اشیاء بازیابی شده، اگر پارامتر "countOutput" داشته باشد استفاده شده است. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### بازگشت مقادیر «(عدد صحیح/آرایه)» یکی را برمی‌گرداند: - آرایه ای از اشیاء؛ - تعداد اشیاء بازیابی شده، اگر پارامتر "countOutput" داشته باشد استفاده شده است. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### بازگشت مقادیر «(عدد صحیح/آرایه)» یکی را برمی‌گرداند: - آرایه ای از اشیاء؛ - تعداد اشیاء بازیابی شده، اگر پارامتر "countOutput" داشته باشد استفاده شده است. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### بازگشت مقادیر «(عدد صحیح/آرایه)» یکی را برمی‌گرداند: - آرایه ای از اشیاء؛ - تعداد اشیاء بازیابی شده، اگر پارامتر "countOutput" داشته باشد استفاده شده است. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### بازگشت مقادیر «(عدد صحیح/آرایه)» یکی را برمی‌گرداند: - آرایه ای از اشیاء؛ - تعداد اشیاء بازیابی شده، اگر پارامتر "countOutput" داشته باشد استفاده شده است. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### بازگشت مقادیر «(عدد صحیح/آرایه)» یکی را برمی‌گرداند: - آرایه ای از اشیاء؛ - تعداد اشیاء بازیابی شده، اگر پارامتر "countOutput" داشته باشد استفاده شده است. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### بازگشت مقادیر «(عدد صحیح/آرایه)» یکی را برمی‌گرداند: - آرایه ای از اشیاء؛ - تعداد اشیاء بازیابی شده، اگر پارامتر "countOutput" داشته باشد استفاده شده است. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### بازگشت مقادیر «(عدد صحیح/آرایه)» یکی را برمی‌گرداند: - آرایه ای از اشیاء؛ - تعداد اشیاء بازیابی شده، اگر پارامتر "countOutput" داشته باشد استفاده شده است. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### بازگشت مقادیر «(عدد صحیح/آرایه)» یکی را برمی‌گرداند: - آرایه ای از اشیاء؛ - تعداد اشیاء بازیابی شده، اگر پارامتر "countOutput" داشته باشد استفاده شده است. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### بازگشت مقادیر «(عدد صحیح/آرایه)» یکی را برمی‌گرداند: - آرایه ای از اشیاء؛ - تعداد اشیاء بازیابی شده، اگر پارامتر "countOutput" داشته باشد استفاده شده است. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### بازگشت مقادیر «(عدد صحیح/آرایه)» یکی را برمی‌گرداند: - آرایه ای از اشیاء؛ - تعداد اشیاء بازیابی شده، اگر پارامتر "countOutput" داشته باشد استفاده شده است. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### بازگشت مقادیر «(عدد صحیح/آرایه)» یکی را برمی‌گرداند: - آرایه ای از اشیاء؛ - تعداد اشیاء بازیابی شده، اگر پارامتر "countOutput" داشته باشد استفاده شده است. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### بازگشت مقادیر «(عدد صحیح/آرایه)» یکی را برمی‌گرداند: - آرایه ای از اشیاء؛ - تعداد اشیاء بازیابی شده، اگر پارامتر "countOutput" داشته باشد استفاده شده است. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ###بازگشت مقادیر `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### بازگشت مقادیر «(عدد صحیح/آرایه)» یکی را برمی‌گرداند: - آرایه ای از اشیاء؛ - تعداد اشیاء بازیابی شده، اگر پارامتر "countOutput" داشته باشد استفاده شده است. ### Return values `(object)` Returns an object containing the IDs of the cleared items under the `itemids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the cleared items under the `itemids` property. ### Return values `(object)` Returns an object containing the IDs of the created actions under the `actionids` property. The order of the returned IDs matches the order of the passed actions. ### برگشت مقادیر `(object)` یک شی حاوی شناسه اقدامات ایجاد شده را تحت خاصیت «شناسه اکشن » برمی گرداند . ترتیب شناسه های برگشتی با ترتیب اقدامات انجام شده مطابقت دارد ### Return values `(object)` Returns an object containing the IDs of the created correlations under the `correlationids` property. The order of the returned IDs matches the order of the passed correlations. ### مقادیر را برمی گرداند `(object)` یک شی حاوی شناسه های اسکریپت های ایجاد شده را تحت ویژگی "scriptids" برمی گرداند. ترتیب شناسه های برگشتی با ترتیب اسکریپت های پاس شده مطابقت دارد ### Return values `(object)` Returns an object containing the IDs of the created dashboards under the `dashboardids` property. The order of the returned IDs matches the order of the passed dashboards. ### برگشت مقادیر `(object)` یک شی حاوی شناسه اقدامات ایجاد شده را تحت خاصیت «شناسه اکشن » برمی گرداند . ترتیب شناسه های برگشتی با ترتیب اقدامات انجام شده مطابقت دارد ### Return values `(object)` Returns an object containing the IDs of the created discovery rules under the `druleids` property. The order of the returned IDs matches the order of the passed discovery rules. ### برگشت مقادیر `(object)` یک شی حاوی شناسه اقدامات ایجاد شده را تحت خاصیت «شناسه اکشن » برمی گرداند . ترتیب شناسه های برگشتی با ترتیب اقدامات انجام شده مطابقت دارد ### Return values `(object)` Returns an object containing the IDs of the created graph prototypes under the `graphids` property. The order of the returned IDs matches the order of the passed graph prototypes. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the created graph prototypes under the `graphids` property. The order of the returned IDs matches the order of the passed graph prototypes. ### Return values `(object)` Returns an object containing the IDs of the created graphs under the `graphids` property. The order of the returned IDs matches the order of the passed graphs. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the created graphs under the `graphids` property. The order of the returned IDs matches the order of the passed graphs. ### Return values `(object)` Returns an object containing the IDs of the created host groups under the `groupids` property. The order of the returned IDs matches the order of the passed host groups. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the created hosts under the `hostids` property. The order of the returned IDs matches the order of the passed hosts. ### Return values `(object)` Returns an object containing the IDs of the created host interfaces under the `interfaceids` property. ###بازگشت مقادیر `(object)` Returns an object containing the IDs of the created host interfaces under the `interfaceids` property. ### Return values `(object)` Returns an object containing the IDs of the created host interfaces under the `interfaceids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the created host interfaces under the `interfaceids` property. ### Return values `(object)` Returns an object containing the IDs of the created host interfaces under the `interfaceids` property. The order of the returned IDs matches the order of the passed host interfaces. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the created host interfaces under the `interfaceids` property. The order of the returned IDs matches the order of the passed host interfaces. ### Return values `(object)` Returns an object containing the IDs of the created host prototypes under the `hostids` property. The order of the returned IDs matches the order of the passed host prototypes. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the created host prototypes under the `hostids` property. The order of the returned IDs matches the order of the passed host prototypes. ### Return values `(object)` Returns an object containing the IDs of the created hosts under the `hostids` property. The order of the returned IDs matches the order of the passed hosts. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the created hosts under the `hostids` property. The order of the returned IDs matches the order of the passed hosts. ### Return values `(object)` Returns an object containing the IDs of the created icon maps under the `iconmapids` property. The order of the returned IDs matches the order of the passed icon maps. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the created icon maps under the `iconmapids` property. The order of the returned IDs matches the order of the passed icon maps. ### Return values `(object)` Returns an object containing the IDs of the created images under the `imageids` property. The order of the returned IDs matches the order of the passed images. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the created images under the `imageids` property. The order of the returned IDs matches the order of the passed images. ### Return values `(object)` Returns an object containing the IDs of the created LLD rules under the `itemids` property. The order of the returned IDs matches the order of the passed LLD rules. ### برگشت مقادیر `(object)` یک شی حاوی شناسه اقدامات ایجاد شده را تحت خاصیت «شناسه اکشن » برمی گرداند . ترتیب شناسه های برگشتی با ترتیب اقدامات انجام شده مطابقت دارد ### Return values `(object)` Returns an object containing the IDs of the created scripts under the `scriptids` property. The order of the returned IDs matches the order of the passed scripts. ### مقادیر را برمی گرداند `(object)` یک شی حاوی شناسه های اسکریپت های ایجاد شده را تحت ویژگی "scriptids" برمی گرداند. ترتیب شناسه های برگشتی با ترتیب اسکریپت های پاس شده مطابقت دارد ### Return values `(object)` Returns an object containing the IDs of the created templates under the `templateids` property. The order of the returned IDs matches the order of the passed templates. ### برگشت مقادیر `(object)` یک شی حاوی شناسه اقدامات ایجاد شده را تحت خاصیت «شناسه اکشن » برمی گرداند . ترتیب شناسه های برگشتی با ترتیب اقدامات انجام شده مطابقت دارد ### Return values `(object)` Returns an object containing the IDs of the created web scenarios under the `httptestids` property. The order of the returned IDs matches the order of the passed web scenarios. ###بازگشت مقادیر `(object)` Returns an object containing the IDs of the created web scenarios under the `httptestids` property. The order of the returned IDs matches the order of the passed web scenarios. ### Return values `(object)` Returns an object containing the IDs of the deleted actions under the `actionids` property. ### بازگشت مقادیر `(object)` یک شی حاوی شناسه تحت خاصیت «actionids». اقدامات حذف شده را برمی گرداند ### Return values `(object)` Returns an object containing the IDs of the deleted correlations under the `correlationids` property. ### بازگشت مقادیر `(object)` یک شی حاوی شناسه های حذف شده را برمی گرداند همبستگی تحت خاصیت "correlationids". ### Return values `(object)` Returns an object containing the IDs of the deleted dashboards under the `dashboardids` property. ### بازگشت مقادیر `(object)` یک شی حاوی شناسه های به روز شده را تحت خاصیت "dashboardids" برمی گرداند ### Return values `(object)` Returns an object containing the IDs of the deleted discovery rules under the `druleids` property. ### بازگشت مقادیر `(object)` یک شی حاوی شناسه تحت خاصیت «actionids». اقدامات حذف شده را برمی گرداند ### Return values `(object)` Returns an object containing the IDs of the deleted graph prototypes under the `graphids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the deleted graph prototypes under the `graphids` property. ### Return values `(object)` Returns an object containing the IDs of the deleted graphs under the `graphids` property. ###بازگشت مقادیر `(object)` Returns an object containing the IDs of the deleted graphs under the `graphids` property. ### Return values `(object)` Returns an object containing the IDs of the deleted host groups under the `groupids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the deleted host groups under the `groupids` property. ### Return values `(object)` Returns an object containing the IDs of the deleted host interfaces under the `interfaceids` property. ###بازگشت مقادیر `(object)` Returns an object containing the IDs of the deleted host interfaces under the `interfaceids` property. ### Return values `(object)` Returns an object containing the IDs of the deleted host interfaces under the `interfaceids` property. ###بازگشت مقادیر `(object)` Returns an object containing the IDs of the deleted host interfaces under the `interfaceids` property. ### Return values `(object)` Returns an object containing the IDs of the deleted host prototypes under the `hostids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the deleted host prototypes under the `hostids` property. ### Return values `(object)` Returns an object containing the IDs of the deleted hosts under the `hostids` property. ###بازگشت مقادیر `(object)` Returns an object containing the IDs of the deleted hosts under the `hostids` property. ### Return values `(object)` Returns an object containing the IDs of the deleted icon maps under the `iconmapids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the deleted icon maps under the `iconmapids` property. ### Return values `(object)` Returns an object containing the IDs of the deleted web scenarios under the `httptestids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the deleted web scenarios under the `httptestids` property. ### Return values `(object)` Returns an object containing the IDs of the updated actions under the `actionids` property. ### بازگشت مقادیر `(object)` یک شی حاوی شناسه اقدامات به روز شده را برمی گرداند تحت خاصیت «اکشنیدز». ### Return values `(object)` Returns an object containing the IDs of the updated correlations under the `correlationids` property. ### بازگشت مقادیر `(object)` یک شی حاوی شناسه های به روز شده را برمی گرداند همبستگی تحت خاصیت "correlationids". ### Return values `(object)` Returns an object containing the IDs of the updated dashboards under the `dashboardids` property. ### بازگشت مقادیر `(object)` یک شی حاوی شناسه های به روز شده را برمی گرداند همبستگی تحت خاصیت "correlationids". ### Return values `(object)` Returns an object containing the IDs of the updated discovery rules under the `druleids` property. ### بازگشت مقادیر `(object)` یک شی حاوی شناسه تحت خاصیت «actionids». اقدامات حذف شده را برمی گرداند ### Return values `(object)` Returns an object containing the IDs of the updated events under the `eventids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the updated events under the `eventids` property. ### Return values `(object)` Returns an object containing the IDs of the updated graph prototypes under the `graphids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the updated graph prototypes under the `graphids` property. ### Return values `(object)` Returns an object containing the IDs of the updated graphs under the `graphids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the updated graphs under the `graphids` property. ### Return values `(object)` Returns an object containing the IDs of the updated host groups under the `groupids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the updated host groups under the `groupids` property. ### Return values `(object)` Returns an object containing the IDs of the updated host groups under the `groupids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the updated host groups under the `groupids` property. ### Return values `(object)` Returns an object containing the IDs of the updated host groups under the `groupids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the updated host groups under the `groupids` property. ### Return values `(object)` Returns an object containing the IDs of the updated host groups under the `groupids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the updated host groups under the `groupids` property. ### Return values `(object)` Returns an object containing the IDs of the updated host interfaces under the `interfaceids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the updated host interfaces under the `interfaceids` property. ### Return values `(object)` Returns an object containing the IDs of the updated host prototypes under the `hostids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the updated host prototypes under the `hostids` property. ### Return values `(object)` Returns an object containing the IDs of the updated hosts under the `hostids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the updated hosts under the `hostids` property. ### Return values `(object)` Returns an object containing the IDs of the updated hosts under the `hostids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the updated hosts under the `hostids` property. ### Return values `(object)` Returns an object containing the IDs of the updated hosts under the `hostids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the updated hosts under the `hostids` property. ### Return values `(object)` Returns an object containing the IDs of the updated hosts under the `hostids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the updated hosts under the `hostids` property. ### Return values `(object)` Returns an object containing the IDs of the updated icon maps under the `iconmapids` property. ### مقادیر را برمی گرداند `(object)` یک شی حاوی شناسه آیکون نقشه های به روز شده را برمی گرداند که تحت ویژگی "iconmapids" می باشد . ### Return values `(object)` Returns an object containing the IDs of the updated LLD rules under the `itemids` property. ### بازگشت مقادیر `(object)` یک شی حاوی شناسه تحت خاصیت «actionids». اقدامات حذف شده را برمی گرداند ### Return values `(object)` Returns an object containing the IDs of the updated web scenarios under the `httptestid` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the updated web scenarios under the `httptestid` property. ### Return values `(object)` Returns authentication object. ### مقادیر را برمی گرداند `(object)` شیء احراز هویت را برمی گرداند. ### Return values `(object)` Returns autoregistration object. ### مقادیر را برمی گرداند `(object)` شیء احراز هویت را برمی گرداند. ### Return values `(object)` Returns housekeeping object. ###بازگشت مقادیر `(object)` Returns housekeeping object. ### Return values `(string)` Returns a serialized string containing the requested configuration data. ### بازگشت مقادیر `(string)` یک رشته سریالی حاوی موارد درخواستی را برمی گرداند داده های پیکربندی ### Return values `(string)` Returns the version of the Zabbix API. ::: notetip Starting from Zabbix 2.0.4 the version of the API matches the version of Zabbix. ::: ### بازگشت مقادیر `(string)` نسخه Zabbix API را برمی گرداند. ::: یادداشت شروع از Zabbix 2.0.4 نسخه API با نسخه Zabbix مطابقت دارد. ::: # script.create #ساخت اسکریپت ### See also - [Action filter](object#action_filter) - [Action operation](object#action_operation) ### همچنین ببینید - [Action filter](object#action_filter) - [عملیات عمل] (شیء#عمل_عملی) ### See also - [Action filter](object#action_filter) - [Action operation](object#action_operation) ### همچنین ببینید - [Action filter](object#action_filter) - [عملیات عمل] (شیء#عمل_عملی) ### See also - [Audit log object](/manual/api/reference/auditlog/object) ### همچنین ببینید - [ابژه گزارش حسابرسی](/دستی/api/reference/auditlog/object) ### See also - [Correlation filter](object#correlation_filter) - [Correlation operation](object#correlation_operation) ### همچنین ببینید - [فیلتر همبستگی](شیء#همبستگی_فیلتر) - [عملیات همبستگی] (object#correlation_operation) ### See also - [Correlation filter](object#correlation_filter) - [Correlation operation](object#correlation_operation) ### همچنین ببینید - [فیلتر همبستگی](شیء#همبستگی_فیلتر) - [عملیات همبستگی] (object#correlation_operation) ### See also - [Correlation filter](object#correlation_filter) - [Correlation operation](object#correlation_operation) ### همچنین ببینید - [فیلتر همبستگی](شیء#همبستگی_فیلتر) - [عملیات همبستگی] (object#correlation_operation) ### See also - [Dashboard page](object#dashboard_page) - [Dashboard widget](object#dashboard_widget) - [Dashboard widget field](object#dashboard_widget_field) - [Dashboard user](object#dashboard_user) - [Dashboard user group](object#dashboard_user_group) ###همچنین ببینید : - [Dashboard page](object#dashboard_page) - [Dashboard widget](object#dashboard_widget) - [Dashboard widget field](object#dashboard_widget_field) - [Dashboard user](object#dashboard_user) - [Dashboard user group](object#dashboard_user_group) ### See also - [Dashboard page](object#dashboard_page) - [Dashboard widget](object#dashboard_widget) - [Dashboard widget field](object#dashboard_widget_field) - [Dashboard user](object#dashboard_user) - [Dashboard user group](object#dashboard_user_group) ###همچنین ببینید : - [Dashboard page](object#dashboard_page) - [Dashboard widget](object#dashboard_widget) - [Dashboard widget field](object#dashboard_widget_field) - [Dashboard user](object#dashboard_user) - [Dashboard user group](object#dashboard_user_group) ### See also - [Dashboard page](object#dashboard_page) - [Dashboard widget](object#dashboard_widget) - [Dashboard widget field](object#dashboard_widget_field) - [Dashboard user](object#dashboard_user) - [Dashboard user group](object#dashboard_user_group) ###همچنین ببینید : - [Dashboard page](object#dashboard_page) - [Dashboard widget](object#dashboard_widget) - [Dashboard widget field](object#dashboard_widget_field) - [Dashboard user](object#dashboard_user) - [Dashboard user group](object#dashboard_user_group) ### See also - [Discovered host](/manual/api/reference/dhost/object#discovered_host) - [Discovery check](/manual/api/reference/dcheck/object#discovery_check) ### همچنین ببینید - [Discovered host](/manual/api/reference/dhost/object#discovered_host) - [Discovery check](/manual/api/reference/dcheck/object#discovery_check) ### See also - [Discovered host](/manual/api/reference/dhost/object#discovered_host) - [Discovery check](/manual/api/reference/dcheck/object#discovery_check) - [Host](/manual/api/reference/host/object#host) ### همچنین ببینید - [Discovered host](/manual/api/reference/dhost/object#discovered_host) - [Discovery check](/manual/api/reference/dcheck/object#discovery_check) - [Host](/manual/api/reference/host/object#host) ### See also - [Discovered service](/manual/api/reference/dservice/object#discovered_service) - [Discovery rule](/manual/api/reference/drule/object#discovery_rule) ### همچنین ببینید - [Discovered service](/manual/api/reference/dservice/object#discovered_service) - [Discovery rule](/manual/api/reference/drule/object#discovery_rule) ### See also - [Discovery check](/manual/api/reference/dcheck/object#discovery_check) ### همچنین ببینید - [Discovery check](/manual/api/reference/dcheck/object#discovery_check) ### See also - [Discovery check](/manual/api/reference/dcheck/object#discovery_check) ### همچنین ببینید - [Discovery check](/manual/api/reference/dcheck/object#discovery_check) ## SEE ALSO Documentation <https://www.zabbix.com/manuals> **[zabbix\_agent2](zabbix_agent2)**(8), **[zabbix\_agentd](zabbix_agentd)**(8), **[zabbix\_get](zabbix_get)**(1), **[zabbix\_proxy](zabbix_proxy)**(8), **[zabbix\_sender](zabbix_sender)**(1), **[zabbix\_server](zabbix_server)**(8) ------------------------------------------------------------------------ [ ]{#index} ## همچنین ببینید مستندات <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8)، ***[zabbix\_get](zabbix_get)**(8)، **[zabbix\_js](zabbix_js)**(8)، **[zabbix\_proxy](zabbix_proxy)**(8) **[zabbix\_sender](zabbix_sender)**(8) ***[zabbix\_server](zabbix_server)**(8) [ ]{#lbAI} ## SEE ALSO Documentation <https://www.zabbix.com/manuals> **[zabbix\_agent2](zabbix_agent2)**(8), **[zabbix\_get](zabbix_get)**(1), **[zabbix\_js](zabbix_js)**(1), **[zabbix\_proxy](zabbix_proxy)**(8), **[zabbix\_sender](zabbix_sender)**(1), **[zabbix\_server](zabbix_server)**(8) [ ]{#lbAJ} ## همچنین ببینید مستندات <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8)، ***[zabbix\_get](zabbix_get)**(8)، **[zabbix\_js](zabbix_js)**(8)، **[zabbix\_proxy](zabbix_proxy)**(8) **[zabbix\_sender](zabbix_sender)**(8) ***[zabbix\_server](zabbix_server)**(8) [ ]{#lbAI} ## SEE ALSO Documentation <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8), **[zabbix\_get](zabbix_get)**(1), **[zabbix\_proxy](zabbix_proxy)**(8), **[zabbix\_sender](zabbix_sender)**(1), **[zabbix\_js](zabbix_js)**(1), **[zabbix\_agent2](zabbix_agent2)**(8) [ ]{#lbAJ} ## همچنین ببینید مستندات <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8)، ***[zabbix\_get](zabbix_get)**(1)، **[zabbix\_proxy](zabbix_proxy)**(8)، ***[zabbix\_sender](zabbix_sender)**(1)، **[zabbix\_js](zabbix_js)**(1)، ***[zabbix\_agent2](zabbix_agent2)**(8) [ ]{#lbAJ} ## SEE ALSO Documentation <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8), **[zabbix\_get](zabbix_get)**(1), **[zabbix\_proxy](zabbix_proxy)**(8), **[zabbix\_sender](zabbix_sender)**(1), **[zabbix\_server](zabbix_server)**(8), **[zabbix\_js](zabbix_js)**(1), **[zabbix\_agent2](zabbix_agent2)**(8) [ ]{#lbAH} ## همچنین ببینید مستندات <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8)، ***[zabbix\_get](zabbix_get)**(1)، **[zabbix\_proxy](zabbix_proxy)**(8)، **[zabbix\_sender](zabbix_sender)**(1)، **[zabbix\_server](zabbix_server)**(8)، **[zabbix\_js](zabbix_js)**(1)، ***[zabbix\_agent2](zabbix_agent2)**(8) [ ]{#lbAH} ## SEE ALSO Documentation <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8), **[zabbix\_get](zabbix_get)**(1), **[zabbix\_proxy](zabbix_proxy)**(8), **[zabbix\_server](zabbix_server)**(8), **[zabbix\_js](zabbix_js)**(1), **[zabbix\_agent2](zabbix_agent2)**(8), **[zabbix\_web\_service](zabbix_web_service)**(8) [ ]{#lbAJ} ## همچنین ببینید مستندات <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8)، ***[zabbix\_get](zabbix_get)**(8)، **[zabbix\_js](zabbix_js)**(8)، **[zabbix\_proxy](zabbix_proxy)**(8) **[zabbix\_sender](zabbix_sender)**(8) ***[zabbix\_server](zabbix_server)**(8) [ ]{#lbAI} ## SEE ALSO Documentation <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8), **[zabbix\_get](zabbix_get)**(1), **[zabbix\_sender](zabbix_sender)**(1), **[zabbix\_server](zabbix_server)**(8), **[zabbix\_js](zabbix_js)**(1), **[zabbix\_agent2](zabbix_agent2)**(8) [ ]{#lbAJ} ## همچنین ببینید مستندات <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8)، ***[zabbix\_get](zabbix_get)**(8)، **[zabbix\_js](zabbix_js)**(8)، **[zabbix\_proxy](zabbix_proxy)**(8) **[zabbix\_sender](zabbix_sender)**(8) ***[zabbix\_server](zabbix_server)**(8) [ ]{#lbAI} ## SEE ALSO Documentation <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8), **[zabbix\_get](zabbix_get)**(8), **[zabbix\_js](zabbix_js)**(8), **[zabbix\_proxy](zabbix_proxy)**(8), **[zabbix\_sender](zabbix_sender)**(8), **[zabbix\_server](zabbix_server)**(8) [ ]{#lbAI} ## همچنین ببینید مستندات <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8)، ***[zabbix\_get](zabbix_get)**(8)، **[zabbix\_js](zabbix_js)**(8)، **[zabbix\_proxy](zabbix_proxy)**(8) **[zabbix\_sender](zabbix_sender)**(8) ***[zabbix\_server](zabbix_server)**(8) [ ]{#lbAI} ## SEE ALSO Documentation <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8), **[zabbix\_proxy](zabbix_proxy)**(8), **[zabbix\_sender](zabbix_sender)**(1), **[zabbix\_server](zabbix_server)**(8), **[zabbix\_js](zabbix_js)**(1), **[zabbix\_agent2](zabbix_agent2)**(8), **[zabbix\_web\_service](zabbix_web_service)**(8) [ ]{#lbAI} ## همچنین ببینید مستندات <https://www.zabbix.com/manuals> **[zabbix\_agentd](zabbix_agentd)**(8)، ***[zabbix\_get](zabbix_get)**(8)، **[zabbix\_js](zabbix_js)**(8)، **[zabbix\_proxy](zabbix_proxy)**(8) **[zabbix\_sender](zabbix_sender)**(8) ***[zabbix\_server](zabbix_server)**(8) [ ]{#lbAI} ### See also - [Graph item](/manual/api/reference/graphitem/object#graph_item) ### همچنین ببینید - [Graph item](/manual/api/reference/graphitem/object#graph_item) ### See also - [Graph item](/manual/api/reference/graphitem/object#graph_item) ### همچنین ببینید - [Graph item](/manual/api/reference/graphitem/object#graph_item) ### See also - [Graph](/manual/api/reference/graph/object#graph) ### همچنین ببینید - [Graph item](/manual/api/reference/graphitem/object#graph_item) ### See also - [Graph prototype](/manual/api/reference/graphprototype/object#graph_prototype) - [Host](/manual/api/reference/host/object#host) - [Item prototype](/manual/api/reference/itemprototype/object#item_prototype) - [LLD rule filter](object#lld_rule_filter) - [Trigger prototype](/manual/api/reference/triggerprototype/object#trigger_prototype) ### همچنین ببینید - [Graph prototype](/manual/api/reference/graphprototype/object#graph_prototype) - [Host](/manual/api/reference/host/object#host) - [Item prototype](/manual/api/reference/itemprototype/object#item_prototype) - [LLD rule filter](object#lld_rule_filter) - [Trigger prototype](/manual/api/reference/triggerprototype/object#trigger_prototype) ### See also - [Group link](object#group_link) - [Group prototype](object#group_prototype) - [Host prototype tag](object#host_prototype_tag) - [Custom interface](object#custom_interface) - [User macro](/manual/api/reference/usermacro/object#hosttemplate_level_macro) ###همچنین ببینید - [Group link](object#group_link) - [Group prototype](object#group_prototype) - [Host prototype tag](object#host_prototype_tag) - [Custom interface](object#custom_interface) - [User macro](/manual/api/reference/usermacro/object#hosttemplate_level_macro) ### See also - [Group link](object#group_link) - [Group prototype](object#group_prototype) - [Host prototype tag](object#host_prototype_tag) - [Custom interface](object#custom_interface) - [User macro](/manual/api/reference/usermacro/object#hosttemplate_level_macro) ### همچنین ببینید - [Group link](object#group_link) - [Group prototype](object#group_prototype) - [Host prototype tag](object#host_prototype_tag) - [Custom interface](object#custom_interface) - [User macro](/manual/api/reference/usermacro/object#hosttemplate_level_macro) ### See also - [Group link](object#group_link) - [Group prototype](object#group_prototype) - [User macro](/manual/api/reference/usermacro/object#hosttemplate_level_macro) ###همچنین ببینید - [Group link](object#group_link) - [Group prototype](object#group_prototype) - [User macro](/manual/api/reference/usermacro/object#hosttemplate_level_macro) ### See also - [hostinterface.create](create) - [host.massadd](/manual/api/reference/host/massadd) - [Host](/manual/api/reference/host/object#host) ### همچنین ببینید - [hostinterface.create](create) - [host.massadd](/manual/api/reference/host/massadd) - [Host](/manual/api/reference/host/object#host) ### See also - [hostinterface.delete](delete) - [host.massremove](/manual/api/reference/host/massremove) ### همچنین ببینید - [hostinterface.delete](delete) - [host.massremove](/manual/api/reference/host/massremove) ### See also - [hostinterface.massadd](massadd) - [host.massadd](/manual/api/reference/host/massadd) ### همچنین ببینید - [hostinterface.massadd](massadd) - [host.massadd](/manual/api/reference/host/massadd) ### See also - [hostinterface.massremove](massremove) - [host.massremove](/manual/api/reference/host/massremove) ### همچنین ببینید - [hostinterface.massremove](massremove) - [host.massremove](/manual/api/reference/host/massremove) ### See also - [Host](/manual/api/reference/host/object#host) - [Item](/manual/api/reference/item/object#item) ###همچنین ببینید - [Host](/manual/api/reference/host/object#host) - [Item](/manual/api/reference/item/object#item) ### See also - [Host](/manual/api/reference/host/object#host) - [Media type](/manual/api/reference/mediatype/object#media_type) - [User](/manual/api/reference/user/object#user) ### همچنین ببینید - [میزبان](/دستی/api/reference/host/object#host) - [نوع رسانه](/دستی/api/reference/mediatype/object#media_type) - [کاربر](/دستی/api/reference/user/object#user) ### See also - [Host](/manual/api/reference/host/object#host) - [Scenario step](object#scenario_step) ### همچنین ببینید - [Host](/manual/api/reference/host/object#host) - [Scenario step](object#scenario_step) ### See also - [host.update](/manual/api/reference/host/update) - [host.massupdate](/manual/api/reference/host/massupdate) ### همچنین ببینید - [host.update](/manual/api/reference/host/update) - [host.massupdate](/manual/api/reference/host/massupdate) ### See also - [host.update](update) - [Host group](/manual/api/reference/hostgroup/object#host_group) - [Template](/manual/api/reference/template/object#template) - [User macro](/manual/api/reference/usermacro/object#hosttemplate_level_macro) - [Host interface](/manual/api/reference/hostinterface/object#host_interface) ### همچنین ببینید - [host.update](update) - [Host group](/manual/api/reference/hostgroup/object#host_group) - [Template](/manual/api/reference/template/object#template) - [User macro](/manual/api/reference/usermacro/object#hosttemplate_level_macro) - [Host interface](/manual/api/reference/hostinterface/object#host_interface) ### See also - [host.update](update) - [host.massadd](massadd) - [host.massremove](massremove) - [Host group](/manual/api/reference/hostgroup/object#host_group) - [Template](/manual/api/reference/template/object#host_group) - [User macro](/manual/api/reference/usermacro/object#hosttemplate_level_macro) - [Host interface](/manual/api/reference/hostinterface/object#host_interface) ### همچنین ببینید - [host.update](update) - [host.massadd](massadd) - [host.massremove](massremove) - [Host group](/manual/api/reference/hostgroup/object#host_group) - [Template](/manual/api/reference/template/object#host_group) - [User macro](/manual/api/reference/usermacro/object#hosttemplate_level_macro) - [Host interface](/manual/api/reference/hostinterface/object#host_interface) ### See also - [host.update](update) - [User macro](/manual/api/reference/usermacro/object#hosttemplate_level_macro) - [Host interface](/manual/api/reference/hostinterface/object#host_interface) ### همچنین ببینید - [host.update](update) - [User macro](/manual/api/reference/usermacro/object#hosttemplate_level_macro) - [Host interface](/manual/api/reference/hostinterface/object#host_interface) ### See also - [Icon mapping](object#icon_mapping) ### همچنین ببینید - [اختصاص آیکون] (آبجکت#اختصاص آیکون) ### See also - [Icon mapping](object#icon_mapping) ### همچنین ببینید - [اختصاص آیکون] (آبجکت#اختصاص آیکون) ### See also - [Icon mapping](object#icon_mapping) ### همچنین ببینید - [اختصاص آیکون] (آبجکت#اختصاص آیکون) ### See also - [LLD rule filter](object#lld_rule_filter) - [LLD macro paths](object#lld_macro_path) - [LLD rule preprocessing](object#lld_rule_preprocessing) ### همچنین ببینید - [LLD rule filter](object#lld_rule_filter) - [LLD macro paths](object#lld_macro_path) - [LLD rule preprocessing](object#lld_rule_preprocessing) ### See also - [Scenario step](object#scenario_step) ###همچنین ببینید - [Scenario step](object#scenario_step) ### See also - [Scenario step](object#scenario_step) ###همچنین ببینید - [Scenario step](object#scenario_step) ### Source CAction::create() in *ui/include/classes/api/services/CAction.php*. ### منبع CAction::create() در *ui/include/classes/api/services/CAction.php*. ### Source CAction::delete() in *ui/include/classes/api/services/CAction.php*. ### منبع CAction::delete() در *ui/include/classes/api/services/CAction.php*. ### Source CAction::get() in *ui/include/classes/api/services/CAction.php*. ### منبع CAction::get() در *ui/include/classes/api/services/CAction.php*. ### Source CAction::update() in *ui/include/classes/api/services/CAction.php*. ### منبع CAction::update() در *ui/include/classes/api/services/CAction.php*. ### Source CAlert::get() in *ui/include/classes/api/services/CAlert.php*. ### منبع CAlert::get() در *ui/include/classes/api/services/CAlert.php*. ### Source CAPIInfo::version() in *ui/include/classes/api/services/CAPIInfo.php*. ### منبع CAPIInfo::version() در *ui/include/classes/api/services/CAPIInfo.php*. ### Source CAuditLog::get() in *ui/include/classes/api/services/CAuditLog.php*. ### منبع CAuditLog::get() در *ui/include/classes/api/services/CAuditLog.php*. ### Source CAutoregistration::get() in *ui/include/classes/api/services/CAutoregistration.php*. ### منبع CIconMap::update() در *ui/include/classes/api/services/CIconMap.php*. ### Source CAutoregistration::update() in *ui/include/classes/api/services/CAutoregistration.php*. ### منبع CIconMap::update() در *ui/include/classes/api/services/CIconMap.php*. ### Source CConfiguration::export() in *ui/include/classes/api/services/CConfiguration.php*. ### منبع CIconMap::update() در *ui/include/classes/api/services/CIconMap.php*. ### Source CConfiguration::importcompare() in *ui/include/classes/api/services/CConfiguration.php*. ### منبع CIconMap::update() در *ui/include/classes/api/services/CIconMap.php*. ### Source CConfiguration::import() in *ui/include/classes/api/services/CConfiguration.php*. ### منبع CIconMap::update() در *ui/include/classes/api/services/CIconMap.php*. ### Source CCorrelation::create() in *ui/include/classes/api/services/CCorrelation.php*. ### منبع CIconMap::update() در *ui/include/classes/api/services/CIconMap.php*. ### Source CCorrelation::delete() in *ui/include/classes/api/services/CCorrelation.php*. ### منبع CCCorrelation::delete() در *ui/include/classes/api/services/CCorrelation.php*. ### Source CCorrelation::get() in *ui/include/classes/api/services/CCorrelation.php*. ### منبع CCorrelation::get() in *ui/include/classes/api/services/CCorrelation.php*. ### Source CCorrelation::update() in *ui/include/classes/api/services/CCorrelation.php*. ### منبع CCCorrelation::update() در *ui/include/classes/api/services/CCorrelation.php*. ### Source CDashboard::create() in *ui/include/classes/api/services/CDashboard.php*. ### منبع CDashboard::create() in *ui/include/classes/api/services/CDashboard.php*. ### Source CDashboard::delete() in *ui/include/classes/api/services/CDashboard.php*. ### منبع CDashboard::delete() in *ui/include/classes/api/services/CDashboard.php*. ### Source CDashboard::get() in *ui/include/classes/api/services/CDashboard.php*. ### منبع CDashboard::get() in *ui/include/classes/api/services/CDashboard.php*. ### Source CDashboard::update() in *ui/include/classes/api/services/CDashboard.php*. ### منبع CDashboard::update() in *ui/include/classes/api/services/CDashboard.php*. ### Source CDCheck::get() in *ui/include/classes/api/services/CDCheck.php*. ### منبع CDCheck::get() in *ui/include/classes/api/services/CDCheck.php*. ### Source CDHost::get() in *ui/include/classes/api/services/CDHost.php*. ### منبع CDHost::get() in *ui/include/classes/api/services/CDHost.php*. ### Source CDiscoveryRule::create() in *ui/include/classes/api/services/CDiscoveryRule.php*. ### منبع CDiscoveryrule::copy() in *ui/include/classes/api/services/CDiscoveryRule.php*. ### Source CDiscoveryRule::delete() in *ui/include/classes/api/services/CDiscoveryRule.php*. ### منبع CDiscoveryrule::copy() in *ui/include/classes/api/services/CDiscoveryRule.php*. ### Source CDiscoveryRule::get() in *ui/include/classes/api/services/CDiscoveryRule.php*. ### منبع CDiscoveryrule::copy() in *ui/include/classes/api/services/CDiscoveryRule.php*. ### Source CDiscoveryRule::update() in *ui/include/classes/api/services/CDiscoveryRule.php*. ### منبع CDiscoveryrule::copy() in *ui/include/classes/api/services/CDiscoveryRule.php*. ### Source CDRule::create() in *ui/include/classes/api/services/CDRule.php*. ### منابع CDRule::create() in *ui/include/classes/api/services/CDRule.php*. ### Source CDRule::delete() in *ui/include/classes/api/services/CDRule.php*. ### منبع CDRule::delete() in *ui/include/classes/api/services/CDRule.php*. ### Source CDRule::get() in *ui/include/classes/api/services/CDRule.php*. ### منبع CDRule::get() in *ui/include/classes/api/services/CDRule.php*. ### Source CDRule::update() in *ui/include/classes/api/services/CDRule.php*. ### منبع CDRule::update() in *ui/include/classes/api/services/CDRule.php*. ### Source CDService::get() in *ui/include/classes/api/services/CDService.php*. ### منبع CDService::get() in *ui/include/classes/api/services/CDService.php*. ### Source CEvent::acknowledge() in *ui/include/classes/api/services/CEvent.php*. ### منبع CEvent::acknowledge() in *ui/include/classes/api/services/CEvent.php*. ### Source CEvent::get() in *ui/include/classes/api/services/CEvent.php*. ### منبع CEvent::get() in *ui/include/classes/api/services/CEvent.php*. ### Source CGraph::create() in *ui/include/classes/api/services/CGraph.php*. منبع ### Source CGraph::delete() in *ui/include/classes/api/services/CGraph.php*. ### منبع CGraph::delete() in *ui/include/classes/api/services/CGraph.php*. ### Source CGraph::get() in *ui/include/classes/api/services/CGraph.php*. ### منبع CGraph::get() in *ui/include/classes/api/services/CGraph.php*. ### Source CGraphItem::get() in *ui/include/classes/api/services/CGraphItem.php*. ### منبع CGraphItem::get() in *ui/include/classes/api/services/CGraphItem.php*. ### Source CGraphPrototype::create() in *ui/include/classes/api/services/CGraphPrototype.php*. ### منبع CGraphPrototype::create() in *ui/include/classes/api/services/CGraphPrototype.php*. ### Source CGraphPrototype::delete() in *ui/include/classes/api/services/CGraphPrototype.php*. ### منبع CGraphPrototype::delete() in *ui/include/classes/api/services/CGraphPrototype.php*. ### Source CGraphPrototype::get() in *ui/include/classes/api/services/CGraphPrototype.php*. ### منبع CGraphPrototype::get() in *ui/include/classes/api/services/CGraphPrototype.php*. ### Source CGraphPrototype::update() in *ui/include/classes/api/services/CGraphPrototype.php*. ### منبع CGraphPrototype::update() in *ui/include/classes/api/services/CGraphPrototype.php*. ### Source CGraph::update() in *ui/include/classes/api/services/CGraph.php*. ### منبع CGraph::update() in *ui/include/classes/api/services/CGraph.php*. ### Source CHaNode::get() in *ui/include/classes/api/services/CHaNode.php*. ### منبع CHaNode::get() in *ui/include/classes/api/services/CHaNode.php*. ### Source CHistory::clear() in *ui/include/classes/api/services/CHistory.php*. ### منبع CHistory::clear() in *ui/include/classes/api/services/CHistory.php*. ### Source CHistory::get() in *ui/include/classes/api/services/CHistory.php*. ###منبع CHistory::get() in *ui/include/classes/api/services/CHistory.php*. ### Source CHost::create() in *ui/include/classes/api/services/CHost.php*. ### منبع CHost::create() in *ui/include/classes/api/services/CHost.php*. ### Source CHost::delete() in *ui/include/classes/api/services/CHost.php*. ###منبع CHost::delete() in *ui/include/classes/api/services/CHost.php*. ### Source CHost::get() in *ui/include/classes/api/services/CHost.php*. ### منبع CDHost::get() in *ui/include/classes/api/services/CDHost.php*. ### Source CHostGroup::create() in *ui/include/classes/api/services/CHostGroup.php*. ### منبع CHostGroup::create() in *ui/include/classes/api/services/CHostGroup.php*. ### Source CHostGroup::delete() in *ui/include/classes/api/services/CHostGroup.php*. ### منبع CHostGroup::create() in *ui/include/classes/api/services/CHostGroup.php*. ### Source CHostGroup::get() in *ui/include/classes/api/services/CHostGroup.php*. ### منبع CHostGroup::get() in *ui/include/classes/api/services/CHostGroup.php*. ### Source CHostGroup::massAdd() in *ui/include/classes/api/services/CHostGroup.php*. ### منبع CHostGroup::massAdd() in *ui/include/classes/api/services/CHostGroup.php*. ### Source CHostGroup::massRemove() in *ui/include/classes/api/services/CHostGroup.php*. ### منبع CHostGroup::massRemove() in *ui/include/classes/api/services/CHostGroup.php*. ### Source CHostGroup::massUpdate() in *ui/include/classes/api/services/CHostGroup.php*. ### منبع CHostGroup::massUpdate() in *ui/include/classes/api/services/CHostGroup.php*. ### Source CHostGroup::update() in *ui/include/classes/api/services/CHostGroup.php*. ### منبع CHostGroup::update() in *ui/include/classes/api/services/CHostGroup.php*. ### Source CHostInterface::create() in *ui/include/classes/api/services/CHostInterface.php*. ### منبع CHostInterface::create() in *ui/include/classes/api/services/CHostInterface.php*. ### Source CHostInterface::delete() in *ui/include/classes/api/services/CHostInterface.php*. ###منبع CHostInterface::delete() in *ui/include/classes/api/services/CHostInterface.php*. ### Source CHostInterface::get() in *ui/include/classes/api/services/CHostInterface.php*. ### منبع CHostInterface::get() in *ui/include/classes/api/services/CHostInterface.php*. ### Source CHostInterface::massAdd() in *ui/include/classes/api/services/CHostInterface.php*. ### منبع CHostInterface::massAdd() in *ui/include/classes/api/services/CHostInterface.php*. ### Source CHostInterface::massRemove() in *ui/include/classes/api/services/CHostInterface.php*. ### منبع CHostInterface::massRemove() in *ui/include/classes/api/services/CHostInterface.php*. ### Source CHostInterface::replaceHostInterfaces() in *ui/include/classes/api/services/CHostInterface.php*. ### منبع CHostInterface::replaceHostInterfaces() in *ui/include/classes/api/services/CHostInterface.php*. ### Source CHostInterface::update() in *ui/include/classes/api/services/CHostInterface.php*. ### منبع CHostInterface::update() in *ui/include/classes/api/services/CHostInterface.php*. ### Source CHost::massAdd() in *ui/include/classes/api/services/CHost.php*. ### منبع CHost::massAdd() in *ui/include/classes/api/services/CHost.php*. ### Source CHost::massRemove() in *ui/include/classes/api/services/CHost.php*. ### منبع CHost::massRemove() in *ui/include/classes/api/services/CHost.php*. ### Source CHost::massUpdate() in *ui/include/classes/api/services/CHost.php*. ### منبع CHost::massUpdate() in *ui/include/classes/api/services/CHost.php*. ### Source CHostPrototype::create() in *ui/include/classes/api/services/CHostPrototype.php*. ###منبع CHostPrototype::create() in *ui/include/classes/api/services/CHostPrototype.php*. ### Source CHostPrototype::delete() in *ui/include/classes/api/services/CHostPrototype.php*. ### منبع CHostPrototype::delete() in *ui/include/classes/api/services/CHostPrototype.php*. ### Source CHostPrototype::get() in *ui/include/classes/api/services/CHostPrototype.php*. ###منبع CHostPrototype::get() in *ui/include/classes/api/services/CHostPrototype.php*. ### Source CHostPrototype::update() in *ui/include/classes/api/services/CHostPrototype.php*. ### منبع CHostPrototype::update() in *ui/include/classes/api/services/CHostPrototype.php*. ### Source CHost::update() in *ui/include/classes/api/services/CHost.php*. ### منبع CHost::create() in *ui/include/classes/api/services/CHost.php*. ### Source CHousekeeping ::get() in *ui/include/classes/api/services/CHousekeeping.php*. ### منبع CHousekeeping ::get() in *ui/include/classes/api/services/CHousekeeping.php*. ### Source CHousekeeping::update() in *ui/include/classes/api/services/CHousekeeping.php*. ### منبع CHousekeeping::update() in *ui/include/classes/api/services/CHousekeeping.php*. ### Source CHttpTest::create() in *ui/include/classes/api/services/CHttpTest.php*. ### منبع CHttpTest::create() in *ui/include/classes/api/services/CHttpTest.php*. ### Source CHttpTest::delete() in *ui/include/classes/api/services/CHttpTest.php*. ###منبع CHttpTest::delete() in *ui/include/classes/api/services/CHttpTest.php*. ### Source CHttpTest::get() in *ui/include/classes/api/services/CHttpTest.php*. ###منبع CHttpTest::get() in *ui/include/classes/api/services/CHttpTest.php*. ### Source CHttpTest::update() in *ui/include/classes/api/services/CHttpTest.php*. ###منبع CHttpTest::update() in *ui/include/classes/api/services/CHttpTest.php*. ### Source CIconMap::create() in *ui/include/classes/api/services/CIconMap.php*. ### منبع CIconMap::update() در *ui/include/classes/api/services/CIconMap.php*. ### Source CIconMap::delete() in *ui/include/classes/api/services/CIconMap.php*. ###منبع CIconMap::delete() in *ui/include/classes/api/services/CIconMap.php*. ### Source CIconMap::get() in *ui/include/classes/api/services/CIconMap.php*. ### منبع CIconMap::update() در *ui/include/classes/api/services/CIconMap.php*. ### Source CIconMap::update() in *ui/include/classes/api/services/CIconMap.php*. ### منبع CIconMap::update() در *ui/include/classes/api/services/CIconMap.php*. ### Source CImage::create() in *ui/include/classes/api/services/CImage.php*. ### منبع CImage::create() in *ui/include/classes/api/services/CImage.php*. ### Source CScript::create() in *ui/include/classes/api/services/CScript.php*. ### منبع CIconMap::update() در *ui/include/classes/api/services/CIconMap.php*. ### Source CTemplate::create() in *ui/include/classes/api/services/CTemplate.php*. ### منبع CTemplate::create() in *ui/include/classes/api/services/CTemplate.php*. #### Structure The header consists of four fields. All numbers in the header are formatted as little-endian. |Field|Size|Size<br>(large packet)|Description| |--|-|-|------| |`<PROTOCOL>`|4|4|`"ZBXD"` or `5A 42 58 44`| |`<FLAGS>`|1|1|Protocol flags:<br>`0x01` - Zabbix communications protocol<br>`0x02` - compression<br>`0x04` - large packet| |`<DATALEN>`|4|8|Data length.| |`<RESERVED>`|4|8|When compression is used (`0x02` flag) - the length of uncompressed data<br>When compression is not used - `00 00 00 00`| #### Structure The header consists of four fields. All numbers in the header are formatted as little-endian. |Field|Size|Size<br>(large packet)|Description| |--|-|-|------| |`<PROTOCOL>`|4|4|`"ZBXD"` or `5A 42 58 44`| |`<FLAGS>`|1|1|Protocol flags:<br>`0x01` - Zabbix communications protocol<br>`0x02` - compression<br>`0x04` - large packet| |`<DATALEN>`|4|8|Data length.| |`<RESERVED>`|4|8|When compression is used (`0x02` flag) - the length of uncompressed data<br>When compression is not used - `00 00 00 00`| ## SYNOPSIS **zabbix\_get -s** *host-name-or-IP* \[**-p** *port-number*\] \[**-I** *IP-address*\] \[**-t** *timeout*\] **-k** *item-key*\ **zabbix\_get -s** *host-name-or-IP* \[**-p** *port-number*\] \[**-I** *IP-address*\] \[**-t** *timeout*\] **--tls-connect** **cert** **--tls-ca-file** *CA-file* \[**--tls-crl-file** *CRL-file*\] \[**--tls-agent-cert-issuer** *cert-issuer*\] \[**--tls-agent-cert-subject** *cert-subject*\] **--tls-cert-file** *cert-file* **--tls-key-file** *key-file* \[**--tls-cipher13** *cipher-string*\] \[**--tls-cipher** *cipher-string*\] **-k** *item-key*\ **zabbix\_get -s** *host-name-or-IP* \[**-p** *port-number*\] \[**-I** *IP-address*\] \[**-t** *timeout*\] **--tls-connect** **psk** **--tls-psk-identity** *PSK-identity* **--tls-psk-file** *PSK-file* \[**--tls-cipher13** *cipher-string*\] \[**--tls-cipher** *cipher-string*\] **-k** *item-key*\ **zabbix\_get -h**\ **zabbix\_get -V** [ ]{#lbAD} ## نحوه استفاده **zabbix\_get -s** *host-name-or-IP* \[**-p** *port-number*\] \[**-I** *IP-address*\] \[**-t** *timeout*\] **-k** *item-key*\ **zabbix\_get -s** *host-name-or-IP* \[**-p** *port-number*\] \[**-I** *IP-address*\] \[**-t** *timeout*\] **--tls-connect** **cert** **--tls-ca-file** *CA-file* \[**--tls-crl-file** *CRL-file*\] \[**--tls-agent-cert-issuer** *cert-issuer*\] \[**--tls-agent-cert-subject** *cert-subject*\] **--tls-cert-file** *cert-file* **--tls-key-file** *key-file* \[**--tls-cipher13** *cipher-string*\] \[**--tls-cipher** *cipher-string*\] **-k** *item-key*\ **zabbix\_get -s** *host-name-or-IP* \[**-p** *port-number*\] \[**-I** *IP-address*\] \[**-t** *timeout*\] **--tls-connect** **psk** **--tls-psk-identity** *PSK-identity* **--tls-psk-file** *PSK-file* \[**--tls-cipher13** *cipher-string*\] \[**--tls-cipher** *cipher-string*\] **-k** *item-key*\ **zabbix\_get -h**\ **zabbix\_get -V** [ ]{#lbAD} ## SYNOPSIS **zabbix\_js -s** *script-file* **-p** *input-param* \[**-l** *log-level*\] \[**-t** *timeout*\]\ **zabbix\_js -s** *script-file* **-i** *input-file* \[**-l** *log-level*\] \[**-t** *timeout*\]\ **zabbix\_js -h**\ **zabbix\_js -V** [ ]{#lbAD} ## خلاصه **zabbix\_js -s** *اسکریپت-فایل* **-p** *input-param* \[**-l** *log-level*\] \[**-t** *timeout*\]\ **zabbix\_js -s** *script-file* **-i** *input-file* \[**-l** *log-level*\] \[**-t** *timeout*\]\ **zabbix\_js -h**\ **zabbix\_js -V** [ ]{#lbAD} # template.create # ساخت قالب ### **unencrypted** connect without encryption (default) ```{=html} <!-- --> ``` **psk** connect using TLS and a pre-shared key ```{=html} <!-- --> ``` **cert** connect using TLS and a certificate ```{=html} <!-- --> ``` **--tls-ca-file** *CA-file* Full pathname of a file containing the top-level CA(s) certificates for peer certificate verification. **--tls-crl-file** *CRL-file* Full pathname of a file containing revoked certificates. **--tls-agent-cert-issuer** *cert-issuer* Allowed agent certificate issuer. **--tls-agent-cert-subject** *cert-subject* Allowed agent certificate subject. **--tls-cert-file** *cert-file* Full pathname of a file containing the certificate or certificate chain. **--tls-key-file** *key-file* Full pathname of a file containing the private key. **--tls-psk-identity** *PSK-identity* PSK-identity string. **--tls-psk-file** *PSK-file* Full pathname of a file containing the pre-shared key. **--tls-cipher13** *cipher-string* Cipher string for OpenSSL 1.1.1 or newer for TLS 1.3. Override the default ciphersuite selection criteria. This option is not available if OpenSSL version is less than 1.1.1. **--tls-cipher** *cipher-string* GnuTLS priority string (for TLS 1.2 and up) or OpenSSL cipher string (only for TLS 1.2). Override the default ciphersuite selection criteria. **-h**, **--help** Display this help and exit. **-V**, **--version** Output version information and exit. [ ]{#lbAG} ### **رمزگذاری نشده** اتصال بدون رمزگذاری (پیش‌فرض) ```{=html} <!---> ``` **psk** با استفاده از TLS و یک کلید مشترک از قبل متصل شوید ```{=html} <!---> ``` **گواهی** با استفاده از TLS و گواهی متصل شوید ```{=html} <!---> ``` **--tls-ca-file** *CA-file* نام مسیر کامل یک فایل حاوی گواهی (های) CA سطح بالا برای تایید گواهی همتا **--tls-crl-file** *CRL-file* نام مسیر کامل یک فایل حاوی گواهی های باطل شده است. **--tls-agent-cert-ssuer** *cert-ssuer* صادرکننده گواهی نماینده مجاز. **--tls-agent-cert-subject** *cert-subject* موضوع گواهی نماینده مجاز **--tls-cert-file** *cert-file* نام مسیر کامل یک فایل حاوی گواهی یا زنجیره گواهی. **--tls-key-file** *key-file* نام مسیر کامل یک فایل حاوی کلید خصوصی. **--tls-psk-identity** *PSK-identity* رشته هویت PSK. **--tls-psk-file** *PSK-file* نام مسیر کامل یک فایل حاوی کلید از پیش مشترک. **--tls-cipher13** *رشته رمز* رشته رمز برای OpenSSL 1.1.1 یا جدیدتر برای TLS 1.3. نادیده گرفتن معیارهای انتخاب مجموعه رمز پیش فرض این گزینه در دسترس نیست اگر نسخه OpenSSL کمتر از 1.1.1 است. **--tls-cipher** *cipher-string* رشته اولویت GnuTLS (برای TLS 1.2 و بالاتر) یا رشته رمز OpenSSL (فقط برای TLS 1.2). معیارهای انتخاب مجموعه رمز پیش فرض را نادیده بگیرید. **-h**، **--راهنما** این راهنما را نمایش دهید و از آن خارج شوید. **-V**، **--نسخه** اطلاعات نسخه خروجی و خروج. [ ]{#lbAG} ### **unencrypted** connect without encryption (default) ```{=html} <!-- --> ``` **psk** connect using TLS and a pre-shared key ```{=html} <!-- --> ``` **cert** connect using TLS and a certificate ```{=html} <!-- --> ``` **--tls-ca-file** *CA-file* Full pathname of a file containing the top-level CA(s) certificates for peer certificate verification. **--tls-crl-file** *CRL-file* Full pathname of a file containing revoked certificates. **--tls-server-cert-issuer** *cert-issuer* Allowed server certificate issuer. **--tls-server-cert-subject** *cert-subject* Allowed server certificate subject. **--tls-cert-file** *cert-file* Full pathname of a file containing the certificate or certificate chain. **--tls-key-file** *key-file* Full pathname of a file containing the private key. **--tls-psk-identity** *PSK-identity* PSK-identity string. **--tls-psk-file** *PSK-file* Full pathname of a file containing the pre-shared key. **--tls-cipher13** *cipher-string* Cipher string for OpenSSL 1.1.1 or newer for TLS 1.3. Override the default ciphersuite selection criteria. This option is not available if OpenSSL version is less than 1.1.1. **--tls-cipher** *cipher-string* GnuTLS priority string (for TLS 1.2 and up) or OpenSSL cipher string (only for TLS 1.2). Override the default ciphersuite selection criteria. **-v**, **--verbose** Verbose mode, **-vv** for more details. **-h**, **--help** Display this help and exit. **-V**, **--version** Output version information and exit. [ ]{#lbAG} ### **رمزگذاری نشده** اتصال بدون رمزگذاری (پیش‌فرض) ```{=html} <!---> ``` **psk** با استفاده از TLS و یک کلید مشترک از قبل متصل شوید ```{=html} <!---> ``` **گواهی** با استفاده از TLS و گواهی متصل شوید ```{=html} <!---> ``` **--tls-ca-file** *CA-file* نام مسیر کامل یک فایل حاوی گواهی (های) CA سطح بالا برای تایید گواهی همتا **--tls-crl-file** *CRL-file* نام مسیر کامل یک فایل حاوی گواهی های باطل شده است. **--tls-server-cert-issuer** *cert-ssuer* صادرکننده گواهی سرور مجاز است. **--tls-server-cert-subject** *cert-subject* موضوع گواهی سرور مجاز است. **--tls-cert-file** *cert-file* نام مسیر کامل یک فایل حاوی گواهی یا زنجیره گواهی. **--tls-key-file** *key-file* نام مسیر کامل یک فایل حاوی کلید خصوصی. **--tls-psk-identity** *PSK-identity* رشته هویت PSK. **--tls-psk-file** *PSK-file* نام مسیر کامل یک فایل حاوی کلید از پیش مشترک. **--tls-cipher13** *رشته رمز* رشته رمز برای OpenSSL 1.1.1 یا جدیدتر برای TLS 1.3. نادیده گرفتن معیارهای انتخاب مجموعه رمز پیش فرض این گزینه در دسترس نیست اگر نسخه OpenSSL کمتر از 1.1.1 است. **--tls-cipher** *cipher-string* رشته اولویت GnuTLS (برای TLS 1.2 و بالاتر) یا رشته رمز OpenSSL (فقط برای TLS 1.2). معیارهای انتخاب مجموعه رمز پیش فرض را نادیده بگیرید. **-v**، **-- پرحرف** حالت پرمخاطب، **-vv** برای جزئیات بیشتر. **-h**، **--راهنما** این راهنما را نمایش دهید و از آن خارج شوید. **-V**، **--نسخه** اطلاعات نسخه خروجی و خروج. [ ]{#lbAG} #### Using mass update To mass-update some triggers, do the following: - Mark the checkboxes of the triggers you want to update in the list - Click on *Mass update* below the list - Navigate to the tab with required attributes (*Trigger*, *Tags* or *Dependencies*) - Mark the checkboxes of any attribute to update ![](../../../../assets/en/manual/config/triggers/trigger_mass.png) ![](../../../../assets/en/manual/config/triggers/trigger_mass_b.png) The following options are available when selecting the respective button for tag update: - *Add* - allows to add new tags for the triggers; - *Replace* - will remove any existing tags from the trigger and replace them with the one(s) specified below; - *Remove* - will remove specified tags from triggers. Note that tags with the same name but different values are not considered 'duplicates' and can be added to the same trigger. ![](../../../../assets/en/manual/config/triggers/trigger_mass_c.png) *Replace dependencies* - will remove any existing dependencies from the trigger and replace them with the one(s) specified. Click on *Update* to apply the changes. #### Using mass update To mass-update some triggers, do the following: - Mark the checkboxes of the triggers you want to update in the list - Click on *Mass update* below the list - Navigate to the tab with required attributes (*Trigger*, *Tags* or *Dependencies*) - Mark the checkboxes of any attribute to update ![](../../../../assets/en/manual/config/triggers/trigger_mass.png) ![](../../../../assets/en/manual/config/triggers/trigger_mass_b.png) The following options are available when selecting the respective button for tag update: - *Add* - allows to add new tags for the triggers; - *Replace* - will remove any existing tags from the trigger and replace them with the one(s) specified below; - *Remove* - will remove specified tags from triggers. Note, that tags with the same name, but different values are not considered 'duplicates' and can be added to the same trigger. ![](../../../../assets/en/manual/config/triggers/trigger_mass_c.png) *Replace dependencies* - will remove any existing dependencies from the trigger and replace them with the one(s) specified. Click on *Update* to apply the changes. # Zabbix manpages These are Zabbix manpages for Zabbix processes. # صفحات راهنمای زبیکس صفحات راهنمای جاری مربوط به فرایند های زبیکس می باشند. # Zabbix Manual Welcome to the user manual for Zabbix software. These pages are created to help users successfully manage their monitoring tasks with Zabbix, from the simple to the more complex ones. # دفترچه راهنمای Zabbix به راهنمای کاربر نرم افزار Zabbix خوش آمدید. این صفحات ایجاد شده اند تا به کاربران کمک کند وظایف مانیتورینگ خود را با Zabbix، از ساده تا پیچیده، با موفقیت مدیریت کنند. ### ### ## # 10 Graph prototype # 10 Graph prototype # 10 Graph prototype # 10 Graph prototype # 10 Virtual machine monitoring # 10. Virtual machine monitoring # 11 Maintenance # 11. Maintenance # 11 Time zones # 11 منطقه زمانی # 12 Regular expressions # 12. Regular expressions # 13 Problem acknowledgment # 13. تایید مشکل # 14 Configuration export/import # ۱۴ خروجی/وارد کردن پیکربندی # 16 Distributed monitoring # 16. Distributed monitoring # 17 Encryption # 17. Encryption # 18 Web interface # 18. تحت وب # 1 Action log گزارش اقدامات شماره ۱ # 1 Global notifications نوتیف های کلی # 1 High availability # 1 در دسترس بودن بالا # 1 Menu # 1 منو # 1 Monitor Linux with Zabbix agent # 1. Monitor Linux with Zabbix agent # 1 Problem suppression #1 سرکوب مشکل # 1 Template groups #### Overview In the frontend, template groups can be [exported](/manual/xml_export_import) only with template export. When a template is exported, all groups it belongs to are exported with it automatically. API allows exporting template groups independently of templates. # ۱ گروههای قالب #### مرور کلی در بخش کاربری، گروههای قالب را میتوان فقط با استفاده از template export، [exported](/manual/xml_export_import) کرد. هنگامی که یک قالب export میشود، تمام گروههایی که به آن تعلق دارند به طور خودکار با آن export میشوند. API امکان export کردن گروههای قالب را مستقل از قالبها فراهم میکند. # 1 Web monitoring items موارد نظارت بر وب شماره ۱ # 20 API # 19. API # 21 Pie chart نمودار دایرهای شماره ۲۱ # 27 Top hosts هاست های غالب # 2 Active agent autoregistration ثبت خودکار نماینده فعال # 2 Agent نماینده شماره 2 # 2 Clock ساعت # 2 Definitions # 2. Definitions # 2 Host groups #### Overview In the frontend, host groups can be [exported](/manual/xml_export_import) only with host export. When a host is exported, all groups it belongs to are exported with it automatically. API allows exporting host groups independently of hosts. # ۱ گروههای قالب #### مرور کلی در بخش کاربری، گروههای قالب را میتوان فقط با استفاده از template export، [exported](/manual/xml_export_import) کرد. هنگامی که یک قالب export میشود، تمام گروههایی که به آن تعلق دارند به طور خودکار با آن export میشوند. API امکان export کردن گروههای قالب را مستقل از قالبها فراهم میکند. # 2 Item value preprocessing پیشپردازش مقدار آیتم # 2 Real-life scenario # سناریو محیط واقعی # 2 Triggers تریگر # 32 Web monitoring مانیتورینگ وب # 3 Database upgrade to primary keys # 3 Database upgrade to primary keys # 3 Discovery status وضعیت کشف # 3 Installation from sources You can get the very latest version of Zabbix by compiling it from the sources. A step-by-step tutorial for installing Zabbix from the sources is provided here. # 3 Installation from sources You can get the very latest version of Zabbix by compiling it from the sources. A step-by-step tutorial for installing Zabbix from the sources is provided here. # 3 Monitor Apache via HTTP # 3. Monitor Apache via HTTP # 3 Templates # 2 قالب # 3 User settings تنظیمات کاربر # 4 Favorite graphs نمودارهای مورد علاقه # 4 Hosts # هاست ها # 4 Installation from packages # 4 Installation from packages # 4 Maps نقشه # 4 Monitor MySQL with Zabbix agent 2 # 4. Monitor MySQL with Zabbix agent 2 # 4 Proxy پروکسی # 4 Zabbix agent 2 (UNIX) # Zabbix Agent 2 (یونیکس) # 5 Favorite maps نقشه های مورد علاقه # 5 Installation from containers # 5 Installation from containers # 5 Network maps نقشههای شبکه شماره ۵ # 6 Media types # ۶ انواع رسانه # 6 Zabbix appliance # 6. Zabbix appliance ## 7.4.3 7.4.3 # 7 Geomap # 7 Geomap # 7 Geomap # 7 Geomap # 7 Upgrade procedure # 7 Upgrade procedure # 8 Graph # 8 Graph # 8 Graph # 8 Graph # 8 Service monitoring # 8. Service monitoring # 9 Graph (classic) # 9 Graph (classic) # 9 Graph (classic) # 9 Graph (classic) # 9 Web monitoring مانیتورینگ وب ## Access filters tab The *Access filters* tab lets you restrict access to your Zabbix node by IP address or subnet. ![](../../assets/en/cloud/quickstart/access_filters_tab.png){width="600"} To configure an access filter, complete the following fields: - *Type* - use the dropdown to choose which Zabbix component to limit: frontend/API only, server only, or both. - *IP address or CIDR* - enter the IP address or CIDR manually, or complete the field automatically by selecting the relevant option. - *Optional IP address or CIDR description* - add an optional description for each IP or subnet. After completing the fields, click *Add filter*. Added filters appear in the table below, showing status, type, IP address or subnet, and description. ::: notewarning During node initialization, an access filter is automatically created for the IP address you used. If you later connect from a different IP or network, you must add that address here or you will be blocked. ::: You can: - ![](../../assets/en/cloud/quickstart/edit_button.png){width="30"} - edit a filter. - ![](../../assets/en/cloud/quickstart/delete_button.png){width="30"} - delete a filter or multiple filters using the checkboxes. ## تب فیلترهای دسترسی تب *فیلترهای دسترسی* به شما امکان میدهد دسترسی به گره زبیکس خود را بر اساس آدرس IP یا زیرشبکه محدود کنید. ![](../../assets/en/cloud/quickstart/access_filters_tab.png){width="600"} برای پیکربندی فیلتر دسترسی، فیلدهای زیر را تکمیل کنید: - *نوع* - از منوی کشویی برای انتخاب اینکه کدام مؤلفه زبیکس را محدود کنید استفاده کنید: فقط frontend/API، فقط سرور یا هر دو. - *آدرس IP یا CIDR* - آدرس IP یا CIDR را به صورت دستی وارد کنید، یا با انتخاب گزینه مربوطه، فیلد را به طور خودکار تکمیل کنید. - *آدرس IP یا توضیحات CIDR اختیاری* - برای هر IP یا زیرشبکه یک توضیح اختیاری اضافه کنید. پس از تکمیل فیلدها، روی *افزودن فیلتر* کلیک کنید. فیلترهای اضافه شده در جدول زیر ظاهر میشوند و وضعیت، نوع، آدرس IP یا زیرشبکه و توضیحات را نشان میدهند. ::: notewarning در طول مقداردهی اولیه گره، یک فیلتر دسترسی به طور خودکار برای آدرس IP که استفاده کردهاید ایجاد میشود. اگر بعداً از یک IP یا شبکه دیگر متصل شوید، باید آن آدرس را اینجا اضافه کنید در غیر این صورت مسدود خواهید شد. ::: شما میتوانید: - ![](../../assets/en/cloud/quickstart/edit_button.png){width="30"} - یک فیلتر را ویرایش کنید. - ![](../../assets/en/cloud/quickstart/delete_button.png){width="30"} - یک یا چند فیلتر را با استفاده از کادرهای انتخاب حذف کنید. # action.create # ساخت اکشن # action.delete #پاک کردن اکشن # action.get # دریافت اکشن # Action object The following objects are directly related to the `action` API. # > آبجکت اکشن اشیاء زیر مستقیماً با API «action» مرتبط هستند. # Actions Actions are responsible for 'business logic' of the module. An action usually consists of a [controller](#controller) and an [action view](views#action-view). A module can: - Call actions that are already defined in Zabbix frontend. - Override default actions with custom actions. - Define completely new actions. To override a default action behavior with some custom behavior, define an action with the same name in the module configuration. When the action is called, the module action will be executed instead of the default Zabbix action. Action files should be stored in the *actions* folder. The actions need to be specified in the [manifest.json](manifest). # اکشنها اکشنها مسئول «منطق تجاری» ماژول هستند. یک اکشن معمولاً از یک [controller](#controller) و یک [action view](views#action-view) تشکیل شده است. یک ماژول میتواند: - اکشنهایی را که از قبل در frontend زبیکس تعریف شدهاند، فراخوانی کند. - اکشنهای پیشفرض را با اکشنهای سفارشی لغو کند. - اکشنهای کاملاً جدید تعریف کند. برای لغو رفتار یک اکشن پیشفرض با یک رفتار سفارشی، یک اکشن با همان نام در پیکربندی ماژول تعریف کنید. هنگامی که اکشن فراخوانی میشود، اکشن ماژول به جای اکشن پیشفرض زبیکس اجرا میشود. فایلهای اکشن باید در پوشه *actions* ذخیره شوند. اکشنها باید در [manifest.json](manifest) مشخص شوند. ### actions Actions to register with the module. Defining *class* object key for each action is required, other action keys are optional. *Type*: Object Supported object keys if *[type](#type)* is *module*: - **write.your.action.name** (object) - action name, should be written in lowercase [a-z], separating words with dots. Supports the keys: - **class** (string; required) - action class name. - **layout** (string) - action layout. Supported values: *layout.json*, *layout.htmlpage* (default), *null*. - **view** (string) - action view. *Example*: ```json "actions": { "module.example.list": { "class": "ExampleList", "view": "example.list", "layout": "layout.htmlpage" } } ``` Supported object keys if *[type](#type)* is *widget*: - **widget.{id}.view** (object) - file and class name for widget view. Replace **{id}** with the widget's [id](#id) value (for example, *widget.example_clock.view*). Supports the keys: - **class** (string; required) - action class name for widget view mode to extend the default CControllerDashboardWidgetView class. The class source file must be located in the *actions* directory. - **view** (string) - widget view. Must be located in the *views* directory. If the view file is *widget.view.php*, which is expected by default, this parameter maybe omitted. If using a different name, specify it here. - **widget.{id}.edit** (object) - file name for widget configuration view. Replace **{id}** with the widget's [id](#id) value (for example, *widget.example_clock.edit*). Supports the keys: - **class** (string; required) - action class name for widget configuration view mode. The class source file must be located in the *actions* directory. - **view** (string) - widget configuration view. Must be located in the *views* directory. If the view file is *widget.edit.php*, which is expected by default, this parameter maybe omitted. If using a different name, specify it here. *Example*: ```json "actions": { "widget.tophosts.view": { "class": "WidgetView" }, "widget.tophosts.column.edit": { "class": "ColumnEdit", "view": "column.edit", "layout": "layout.json" } } ``` ### اقدامات اقدامات برای ثبت در ماژول. تعریف کلید شیء *class* برای هر اقدام الزامی است، سایر کلیدهای اقدام اختیاری هستند. *Type*: شیء کلیدهای شیء پشتیبانی شده اگر *[type](#type)* برابر با *module* باشد: - **write.your.action.name** (شیء) - نام عمل، باید با حروف کوچک [a-z] نوشته شود و کلمات با نقطه از هم جدا شوند. از کلیدها پشتیبانی میکند: - **class** (رشته؛ الزامی) - نام کلاس عمل. - **layout** (رشته) - طرحبندی عمل. مقادیر پشتیبانی شده: *layout.json*، *layout.htmlpage* (پیشفرض)، *null*. - **view** (رشته) - نمای عمل. *مثال*: ```json "actions": { "module.example.list": { "class": "ExampleList", "view": "example.list", "layout": "layout.htmlpage" } } ``` کلیدهای شیء پشتیبانی شده اگر *[type](#type)* برابر با *widget* باشد: - **widget.{id}.view** (object) - نام فایل و کلاس برای نمای ویجت. **{id}** را با مقدار [id](#id) ویجت جایگزین کنید (برای مثال، *widget.example_clock.view*). از کلیدها پشتیبانی میکند: - **class** (string; required) - نام کلاس اکشن برای حالت نمای ویجت برای بسط کلاس پیشفرض CControllerDashboardWidgetView. فایل منبع کلاس باید در دایرکتوری *actions* قرار داشته باشد. - **view** (string) - نمای ویجت. باید در دایرکتوری *views* قرار داشته باشد. اگر فایل view، *widget.view.php* باشد، که به طور پیشفرض انتظار میرود، ممکن است این پارامتر حذف شود. اگر از نام دیگری استفاده میکنید، آن را اینجا مشخص کنید. - **widget.{id}.edit** (object) - نام فایل برای نمای پیکربندی ویجت. **{id}** را با مقدار [id](#id) ویجت جایگزین کنید (برای مثال، *widget.example_clock.edit*). از کلیدها پشتیبانی میکند: - **class** (string; required) - نام کلاس action برای حالت نمای پیکربندی ویجت. فایل منبع کلاس باید در دایرکتوری *actions* قرار داشته باشد. - **view** (string) - نمای پیکربندی ویجت. باید در دایرکتوری *views* قرار داشته باشد. اگر فایل view، *widget.edit.php* باشد، که به طور پیشفرض انتظار میرود، ممکن است این پارامتر حذف شود. اگر از نام دیگری استفاده میکنید، آن را اینجا مشخص کنید. *مثال*: ```json "actions": { "widget.tophosts.view": { "class": "WidgetView" }, "widget.tophosts.column.edit": { "class": "ColumnEdit", "view": "column.edit", "layout": "layout.json" } } ```` #### Actions and alerts Define actions and operations to notify users about certain events or automatically execute remote commands. Gain access to information about generated alerts and their receivers. [Action API](/manual/api/reference/action) | [Alert API](/manual/api/reference/alert) #### اقدامات و هشدارها اقدامات و عملیاتی را برای اطلاعرسانی به کاربران در مورد رویدادهای خاص یا اجرای خودکار دستورات از راه دور تعریف کنید. به اطلاعات مربوط به هشدارهای تولید شده و گیرندههای آنها دسترسی پیدا کنید.[Action API](/manual/api/reference/action) | [AlertAPI](/manual/api/reference/alert) # action.update # action.update ### Action view This is a reference file for defining an action view. ````php <?php declare(strict_types = 1); /** * @var CView $this */ $this->includeJsFile('example.something.view.js.php'); (new CWidget()) ->setTitle(_('Something view')) ->addItem(new CDiv($data['name'])) ->addItem(new CPartial('module.example.something.reusable', [ 'contacts' => $data['contacts'] ]) ->show(); ```` ### نمای اکشن این یک فایل مرجع برای تعریف یک نمای اکشن است. ````php <?php declare(strict_types = 1); /** * @var CView $this */ $this->includeJsFile('example.something.view.js.php'); (new CWidget()) ->setTitle(_('Something view')) ->addItem(new CDiv($data['name'])) ->addItem(new CPartial('module.example.something.reusable', [ 'contacts' => $data['contacts'] ]) ->show(); ````` ##### Active check interface [Active checks](/manual/appendix/items/activepassive#active-checks) in the cloud automatically create a host interface with an IP unrelated to your on-premise network. By default, this IP may be external. To maintain consistency, you can manually delete or adjust the host interface after creation. ### رابط بررسیهای فعال [بررسیهای فعال](/manual/appendix/items/activepassive#active-checks) در فضای ابری به طور خودکار یک رابط میزبان با یک IP غیرمرتبط با شبکه داخلی شما ایجاد میکند. به طور پیشفرض، این IP ممکن است خارجی باشد. برای حفظ سازگاری، میتوانید رابط میزبان را پس از ایجاد به صورت دستی حذف یا تنظیم کنید. ### Add a widget view :::noteclassic The widget's **view** file should be located in the *views* directory (for this tutorial, *ui/modules/lesson_gauge_chart/views/*). If the file has the default name *widget.view.php*, you do not need to register it in the *manifest.json* file. If the file has a different name, specify it in the *actions/widget.lesson_gauge_chart.view* section of the [manifest.json](/devel/modules/file_structure/manifest) file. ::: 1. Create a directory *views* in the *lesson_gauge_chart* directory. 2. Create a *widget.view.php* file in the *views* directory. **ui/modules/lesson_gauge_chart/views/widget.view.php** ```php <?php /** * Gauge chart widget view. * * @var CView $this * @var array $data */ (new CWidgetView($data)) ->addItem( new CTag('h1', true, 'Hello, world!') ) ->show(); ``` 3. Refresh the dashboard. The *Gauge chart* widget now displays "Hello, world!". ![](../../../../assets/en/devel/modules/tutorials/widget/widget_hello_world.png){width="600"} ### افزودن نمای ویجت :::noteclassic فایل **نمای** ویجت باید در دایرکتوری *views* قرار داشته باشد (برای این آموزش، *ui/modules/lesson_gauge_chart/views/*). اگر نام پیشفرض فایل *widget.view.php* است، نیازی به ثبت آن در فایل *manifest.json* ندارید. اگر نام فایل متفاوت است، آن را در بخش *actions/widget.lesson_gauge_chart.view* از فایل [manifest.json](devel/modules/file_structure/manifest) مشخص کنید. :: 1. یک دایرکتوری *views* در دایرکتوری *lesson_gauge_chart* ایجاد کنید. 2. یک فایل *widget.view.php* در دایرکتوری *views* ایجاد کنید. **ui/modules/lesson_gauge_chart/views/widget.view.php** ```php <?php /** * نمای ویجت نمودار گیج. * * @var CView $this * @var array $data / (new CWidgetView($data)) ->addItem( new CTag('h1', true, 'Hello, world!') ) ->show(); ``` ۳. داشبورد را رفرش کنید. ویجت *نمودار گیج* اکنون "Hello, world!" را نمایش میدهد. ![](../../../../assets/en/devel/modules/tutorials/widget/widget_hello_world.png){width="600"} ### Add CSS styles to the widget In this section you will learn how to add custom CSS styles to make the widget look more appealing. 1. For widget styles, create a new directory *css* in the *assets* directory. 2. Create a *widget.css* file in the *assets/css* directory. To style widget elements, use the selector *div.dashboard-widget-{widget id}*. To configure CSS for the whole widget, use the selector *form.dashboard-widget-{widget id}* **ui/modules/lesson_gauge_chart/assets/css/widget.css** ```css div.dashboard-widget-lesson_gauge_chart { display: grid; grid-template-rows: 1fr; padding: 0; } div.dashboard-widget-lesson_gauge_chart .chart { display: grid; align-items: center; justify-items: center; } div.dashboard-widget-lesson_gauge_chart .chart canvas { background: white; } div.dashboard-widget-lesson_gauge_chart .description { padding-bottom: 8px; font-size: 1.750em; line-height: 1.2; text-align: center; } .dashboard-grid-widget-hidden-header div.dashboard-widget-lesson_gauge_chart .chart { margin-top: 8px; } ``` 3. Open *manifest.json* and add the CSS file name (*widget.css*) to the array in the *assets/css* section. This will allow the CSS styles defined in *widget.css* to load with the dashboard page. **ui/modules/lesson_gauge_chart/manifest.json** ```json { "manifest_version": 2.0, "id": "lesson_gauge_chart", "type": "widget", "name": "Gauge chart", "namespace": "LessonGaugeChart", "version": "1.0", "author": "Zabbix", "actions": { "widget.lesson_gauge_chart.view": { "class": "WidgetView" } }, "widget": { "js_class": "WidgetLessonGaugeChart" }, "assets": { "css": ["widget.css"], "js": ["class.widget.js"] } } ``` 4. Refresh the dashboard page to see the finished version of the widget. ![](../../../../assets/en/devel/modules/tutorials/widget/widget_view_finished.png){width="600"} ### اضافه کردن استایلهای CSS به ویجت در این بخش یاد خواهید گرفت که چگونه استایلهای CSS سفارشی را برای جذابتر کردن ویجت اضافه کنید. ۱. برای استایلهای ویجت، یک دایرکتوری جدید *css* در دایرکتوری *assets* ایجاد کنید. ۲. یک فایل *widget.css* در دایرکتوری *assets/css* ایجاد کنید. برای استایلدهی به عناصر ویجت، از انتخابگر *div.dashboard-widget-{widget id}* استفاده کنید. برای پیکربندی CSS برای کل ویجت، از انتخابگر *form.dashboard-widget-{widget id}* استفاده کنید. **ui/modules/lesson_gauge_chart/assets/css/widget.css** ```css div.dashboard-widget-lesson_gauge_chart { display: grid; grid-template-rows: 1fr; padding: 0; } div.dashboard-widget-lesson_gauge_chart.chart { display: grid; align-items: center; justify-items: center; } div.dashboard-widget-lesson_gauge_chart.chart canvas { background: white; } div.dashboard-widget-lesson_gauge_chart.description { padding-bottom: 8px; font-size: 1.750em; line-height: 1.2; text-align: center; } .dashboard-grid-widget-hidden-header div.dashboard-widget-lesson_gauge_chart.chart { margin-top: 8px; } ``` ۳. فایل *manifest.json* را باز کنید و نام فایل CSS (*widget.css*) را به آرایه در بخش *assets/css* اضافه کنید. این کار به استایلهای CSS تعریف شده در *widget.css* اجازه میدهد تا با صفحه داشبورد بارگذاری شوند. **ui/modules/lesson_gauge_chart/manifest.json** ```json { "manifest_version": 2.0, "id": "lesson_gauge_chart", "type": "widget", "name": "نمودار گیج", "namespace": "LessonGaugeChart", "version": "1.0", "author": "Zabbix", "actions": { "widget.lesson_gauge_chart.view": { "class": "WidgetView" } }, "widget": { "js_class": "WidgetLessonGaugeChart" }, "assets": { "css": ["widget.css"], "js": ["class.widget.js"] } } ``` ۴. برای دیدن نسخه نهایی ویجت، صفحه داشبورد را رفرش کنید. ![](../../../../assets/en/devel/modules/tutorials/widget/widget_view_finished.png){width="600"} # Adding users #3 اضافه کردن کاربران ## Adding users to nodes To add the user to the node: 1. Go to the *Nodes* tab. 2. Click *Grant Access*. 3. Select a user [added to the organization](#adding-users-to-organizations) from the dropdown. 4. Click *Grant access*. ![](../../assets/en/cloud/quickstart/nodes_tab.png){width="600"} Alternatively, you can grant access from the [*Node configuration*](/cloud/node_configuration) window: 1. Click the ![](../../assets/en/cloud/quickstart/organization_management_button.png){width="30"} settings button. 2. Select *Add user*. 3. Choose a user and click *Grant access*. Invited users must accept the invitation by creating a Zabbix Cloud account using the same email address where the invitation was sent. If the user already has a Zabbix Cloud account under that email, they must sign in and confirm the invitation. Invitations are tied to a specific email address and cannot be accepted from a different account. ## افزودن کاربران به گرهها برای افزودن کاربر به گره: 1. به برگه *گرهها* بروید. 2. روی *اعطای دسترسی* کلیک کنید. 3. یک کاربر [اضافه شده به سازمان](#adding-users-to-organizations) را از منوی کشویی انتخاب کنید. 4. روی *اعطای دسترسی* کلیک کنید. ![](../../assets/en/cloud/quickstart/nodes_tab.png){width="600"} همچنین، میتوانید از پنجره [*Node configuration*](/cloud/node_configuration) دسترسی را اعطا کنید: 1. روی دکمه تنظیمات ![](../../assets/en/cloud/quickstart/organization_management_button.png){width="30"} کلیک کنید. 2. *افزودن کاربر* را انتخاب کنید. 3. یک کاربر انتخاب کنید و روی *اعطای دسترسی* کلیک کنید. کاربران دعوتشده باید با ایجاد یک حساب کاربری Zabbix Cloud با استفاده از همان آدرس ایمیلی که دعوتنامه برای آن ارسال شده است، دعوتنامه را بپذیرند. اگر کاربر از قبل یک حساب کاربری Zabbix Cloud تحت آن ایمیل دارد، باید وارد سیستم شود و دعوتنامه را تأیید کند. دعوتنامهها به یک آدرس ایمیل خاص مرتبط هستند و نمیتوان آنها را از یک حساب کاربری دیگر پذیرفت. ## Adding users to organizations Similar to [users](/manual/config/users_and_usergroups) in Zabbix, you can create users in Zabbix Cloud and assign them roles to control what they can do within an organization and its nodes. To add users to your organization: 1\. Open the *All organizations* page. 2\. Click the ![](../../assets/en/cloud/quickstart/organization_management_button.png){width="30"} settings button of the particular organization to enter its management menu. ![](../../assets/en/cloud/quickstart/private_organization_management.png){width="600"} 3\. In the *Users* or *Admins* tab, click *Add new user*. 4\. Enter the user's email and select a role: *Administrator* or *User*. Note that selecting the *User* role adds the user to the organization, but does not [grant access](#adding-users-to-nodes) to any nodes. Each role grants a different level of access: - **User** - can access nodes they're assigned to and can perform configuration tasks that do not generate charges, for example: - Manage [access filters](/cloud/node_configuration#access-filters-tab) - Configure [encryption](/cloud/node_configuration#encryption-tab) - Set [history/trend](/cloud/node_configuration#history-tab) retention periods - Schedule [maintenance](/cloud/node_configuration#maintenance-tab) - **Administrator** - has all User permissions and can also perform actions that may generate charges, for example: - Create and restore [backups](/cloud/node_configuration#backups-tab) - [Upgrade or downgrade](/cloud/node_configuration#upgrade-tab) node resources (compute tier and disk size) - Cancel subscriptions - **Owner** - has full control over the organization. In addition to all Administrator permissions, the Owner can: - [Create and destroy](/cloud/node_configuration) nodes - Add or remove Users and Administrators - Rename or delete the organization - Manage billing details ::: noteimportant The Owner's payment method is charged for all services. If bank confirmation is required, the Owner must authorize the transaction, even if it was initiated by an Administrator. ::: The invited user will be added with a *Pending* status. You can revoke the invite or resend it (resending is available once every 10 minutes—the button will be disabled if this limit is reached). ![](../../assets/en/cloud/quickstart/pending_invitation.png){width="600"} ## افزودن کاربران به سازمانها مشابه با [users](/manual/config/users_and_usergroups) در Zabbix، میتوانید در Zabbix Cloud کاربرانی ایجاد کنید و به آنها نقشهایی اختصاص دهید تا بتوانید کارهایی را که میتوانند در یک سازمان و گرههای آن انجام دهند، کنترل کنید. برای افزودن کاربران به سازمان خود: 1\. صفحه *همه سازمانها* را باز کنید. 2\. برای ورود به منوی مدیریت سازمان خاص، روی دکمه تنظیمات ![](../../assets/en/cloud/quickstart/organization_management_button.png){width="30"} کلیک کنید. ![](../../assets/en/cloud/quickstart/private_organization_management.png){width="600"} 3\. در تب *Users* یا *Admins*، روی *Add new user* کلیک کنید. 4\. ایمیل کاربر را وارد کنید و یک نقش انتخاب کنید: *Administrator* یا *User*. توجه داشته باشید که انتخاب نقش *کاربر*، کاربر را به سازمان اضافه میکند، اما [دسترسی](#adding-users-to-nodes) را به هیچ گرهای اعطا نمیکند. هر نقش سطح دسترسی متفاوتی را اعطا میکند: - **کاربر** - میتواند به گرههایی که به آنها اختصاص داده شده است دسترسی داشته باشد و میتواند وظایف پیکربندی را که هزینهای ایجاد نمیکنند، انجام دهد، به عنوان مثال: - مدیریت [فیلترهای دسترسی](/cloud/node_configuration#access-filters-tab) - پیکربندی [رمزگذاری](/cloud/node_configuration#encryption-tab) - تنظیم دورههای نگهداری [history/trend](/cloud/node_configuration#history-tab) - برنامهریزی [maintenance](/cloud/node_configuration#maintenance-tab) - **مدیر** - دارای تمام مجوزهای کاربری است و همچنین میتواند اقداماتی را انجام دهد که ممکن است هزینه ایجاد کند، به عنوان مثال: - ایجاد و بازیابی [backups](/cloud/node_configuration#backups-tab) - [ارتقاء یا تنزل رتبه](/cloud/node_configuration#upgrade-tab) منابع گره (ردیف محاسباتی و اندازه دیسک) - لغو اشتراکها - **مالک** - کنترل کامل بر سازمان دارد. علاوه بر تمام مجوزهای مدیر، مالک میتواند: - [ایجاد و نابود کردن](/cloud/node_configuration) گرهها - اضافه یا حذف کاربران و مدیران - تغییر نام یا حذف سازمان - مدیریت جزئیات صورتحساب ::: نکته مهم روش پرداخت مالک برای همه خدمات هزینه دارد. در صورت نیاز به تأیید بانک، مالک باید تراکنش را تأیید کند، حتی اگر توسط یک مدیر آغاز شده باشد. :: کاربر دعوت شده با وضعیت *در انتظار* اضافه خواهد شد. شما میتوانید دعوت را لغو کنید یا دوباره ارسال کنید (ارسال مجدد هر 10 دقیقه یک بار در دسترس است - در صورت رسیدن به این حد، دکمه غیرفعال میشود). ![](../../assets/en/cloud/quickstart/pending_invitation.png){width="600"} ## Administration With the Zabbix API you can change administration settings of your monitoring system. ## مدیریتبا استفاده از API زبیکس میتوانید تنظیمات مدیریت سیستم مانیتورینگ خود را تغییر دهید. #### Advanced configuration The following advanced configuration parameters are supported if *Clock type* is set to "Digital". |Parameter|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-----|-|-----|-------------------| |*Background color*|1|bg_color|Hexadecimal color code (e.g. `FF0000`).<br><br>Default: `""` (empty).| #### تنظیمات اختصاصی The following advanced configuration parameters are supported if *Clock type* is set to "Digital". |Parameter|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-----|-|-----|-------------------| |*Background color*|1|bg_color|Hexadecimal color code (e.g. `FF0000`).<br><br>Default: `""` (empty).| #### Agent on Windows systems Zabbix agent on Windows runs as a Windows service. #### عامل در سیستم های ویندوز عامل Zabbix در ویندوز به عنوان یک سرویس ویندوز اجرا می شود. # alert.get دریافت رخداد # Alert object The following objects are directly related to the `alert` API. # > آبجکت هشدار اشیاء زیر مستقیماً با API «هشدار» مرتبط هستند. ## Alerts The Zabbix API allows you to manage the actions and alerts of your monitoring system. ## هشدارها API زبیکس به شما امکان میدهد اقدامات و هشدارهای سیستم مانیتورینگ خود را مدیریت کنید. ### API information Retrieve the version of the Zabbix API so that your application could use version-specific features. [API info API](/manual/api/reference/apiinfo) ### اطلاعات API نسخه API زبیکس را بازیابی کنید تا برنامه شما بتواند از ویژگیهای خاص نسخه استفاده کند.[API info API](/manual/api/reference/apiinfo) # apiinfo.version # apiinfo.version #### API requests After you've logged in, you can make any API requests by calling methods described in the Zabbix API [method reference](/manual/api/reference). API methods are called using the following format: ```python api_instance.zabbix_object.method(parameters) ``` ::: noteclassic Some Zabbix API method or object names use words that are reserved keywords in Python (e.g., `import`). To avoid Python errors, add an underscore to the method or object name when using it in Python (e.g., `api.configuration.import_`). ::: For example, to see a list of hosts with [`host.get`](/manual/api/reference/host/get): ```python # 1. Import ZabbixAPI from zabbix_utils: from zabbix_utils import ZabbixAPI # 2. Create the ZabbixAPI instance and log in: api = ZabbixAPI(url="127.0.0.1/zabbix") api.login(user="Admin", password="zabbix") # 3. Retrieve hosts matching a filter: hosts = api.host.get( filter={ "host": [ "Zabbix server", "Linux server" ] } ) # 4. Iterate over returned hosts and print each host's details: for host in hosts: print(host) # 5. Log out from the API to close the session: api.logout() ``` #### درخواستهای API (API Requests) پس از ورود به سیستم، میتوانید هرگونه درخواست API را با فراخوانی متدهای موجود در مرجع متدهای Zabbix API انجام دهید. متدهای API به شکل زیر فراخوانی میشوند: ```python id="k8m3tq" api_instance.zabbix_object.method(parameters) ``` > **توجه:** > برخی از نامهای متد یا آبجکتهای Zabbix API از کلماتی استفاده میکنند که در Python رزرو شدهاند (مثلاً `import`). > برای جلوگیری از خطاهای Python، کافی است یک **underscore** به انتهای نام متد یا آبجکت اضافه کنید (مثال: `api.configuration.import_`). مثال: برای مشاهده لیست Hostها با استفاده از [`host.get`](/manual/api/reference/host/get): ```python id="m1h8xq" # 1. وارد کردن ZabbixAPI از zabbix_utils from zabbix_utils import ZabbixAPI # 2. ایجاد نمونه ZabbixAPI و ورود به سیستم api = ZabbixAPI(url="127.0.0.1/zabbix") api.login(user="Admin", password="zabbix") # 3. دریافت Hostهایی که با فیلتر مشخص شده مطابقت دارند hosts = api.host.get(filter={"host": ["Zabbix server", "Linux server"]}) # 4. پیمایش روی Hostهای برگشتی و چاپ جزئیات هر Host for host in hosts: print(host) # 5. خروج از API برای بستن جلسه api.logout() ``` #### API Tokens Manage authorization tokens. [Token API](/manual/api/reference/token) #### توکنهای APIمدیریت توکنهای احراز هویت.[Token API](/manual/api/reference/token) # Appendix 1. Reference commentary # ضمیمه 1. تفسیر مرجع # Appendix 2. Changes from 7.2 to 7.4 # پیوست ۲. تغییرات از ۷.۲ به ۷.۴ # Appendix 3. Changes in 7.4 تغییرات در 7.4 ### assets/css *assets/css* is reserved and should only contain CSS style files. To be used by the widget, specify these files in the *[manifest.json](/devel/modules/file_structure/manifest)*. For example: ```json "assets": { "css": ["mywidget.css"] } ``` ### assets/css *assets/css* رزرو شده است و فقط باید شامل فایلهای استایل CSS باشد. برای استفاده توسط ویجت، این فایلها را در *[manifest.json](/devel/modules/file_structure/manifest)* مشخص کنید. به عنوان مثال: ```json "assets": { "css": ["mywidget.css"] } ```` ### assets CSS styles and JavaScript files to include. *Type*: Object *Supported object keys:* - **css** (array) - CSS files to include. The files must be located in the *assets/css*. - **js** (array) - JavaScript files to include. The files must be located in the *assets/js*. *Example*: ```json "assets": { "css": ["widget.css"], "js": ["class.widget.js"] } ``` ### assets سبکهای CSS و فایلهای جاوا اسکریپت برای گنجاندن. *نوع*: شیء *کلیدهای شیء پشتیبانی شده:* - **css** (آرایه) - فایلهای CSS برای گنجاندن. فایلها باید در *assets/css* قرار داشته باشند. - **js** (آرایه) - فایلهای جاوا اسکریپت برای گنجاندن. فایلها باید در *assets/js* قرار داشته باشند. *مثال*: ```json "assets": { "css": ["widget.css"]، "js": ["class.widget.js"] } ```` ### assets/js *assets/js* directory is reserved and should only contain JavaScript files. To be used by the widget, specify these files in the *[manifest.json](/devel/modules/file_structure/manifest)*. For example: ```json "assets": { "js": ["class.widget.js"] } ``` ### assets/js دایرکتوری *assets/js* رزرو شده است و فقط باید شامل فایلهای جاوا اسکریپت باشد. برای استفاده توسط ویجت، این فایلها را در *[manifest.json](/devel/modules/file_structure/manifest)* مشخص کنید. به عنوان مثال: ```json "assets": { "js": ["class.widget.js"] } ```` # Assets The folder *assets* may contain any files and subfolders that do not belong to other directories. You can use it for: - JavaScript styles (must be inside *[assets/js](#assetsjs)*); - CSS styles (must be inside *[assets/css](#assetscss)*); - Images; - Fonts; - Anything else you need to include. # داراییها پوشه *assets* میتواند شامل هر فایل و زیرپوشهای باشد که به دایرکتوریهای دیگر تعلق ندارد. میتوانید از آن برای موارد زیر استفاده کنید: - استایلهای جاوا اسکریپت (باید داخل *[assets/js](#assetsjs)* باشد)؛ - استایلهای CSS (باید داخل *[assets/css](#assetscss)* باشد)؛ - تصاویر؛ - فونتها؛ - هر چیز دیگری که نیاز به وارد کردن آن دارید. ##### Asynchronous mode Asynchronous mode lets your script send API requests without waiting for each one to finish. This can make your script more efficient when it needs to perform many API requests or when some requests take a long time. When using asynchronous mode, there are important differences compared to synchronous mode: - Import Python's `asyncio` module (you must first [install](/devel/python/install) the required dependencies). - Import `AsyncZabbixAPI` instead of `ZabbixAPI`. - Write your code inside an `async` function. - Use `await` when calling API methods, including `login()` and `logout()`. ::: noteimportant When creating an `AsyncZabbixAPI` instance, you cannot log in [during initialization](#during-initialization). ::: For example, to see a list of hosts with [`host.get`](/manual/api/reference/host/get) in asynchronous mode: ```python # 1. Import asyncio for asynchronous mode, and AsyncZabbixAPI from zabbix_utils: import asyncio from zabbix_utils import AsyncZabbixAPI # 2. Define the main async function where all API operations will run: async def main(): # 3. Create an AsyncZabbixAPI instance and log in (must await): api = AsyncZabbixAPI(url="127.0.0.1") await api.login(user="User", password="zabbix") # 4. Retrieve hosts matching a filter (must await): hosts = await api.host.get( filter={ "host": [ "Zabbix server", "Linux server" ] } ) # 5. Iterate over returned hosts and print each host's details: for host in hosts: print(host) # 6. Log out from the API to close the session (must await): await api.logout() # 7. Run the async main() function using asyncio's event loop: asyncio.run(main()) ``` ##### حالت غیرهمزمان (Asynchronous Mode) حالت **غیرهمزمان** به اسکریپت شما اجازه میدهد که درخواستهای API را بدون انتظار برای تکمیل هر کدام ارسال کند. این حالت زمانی مفید است که: * اسکریپت شما نیاز به انجام **تعداد زیادی درخواست API** دارد * برخی درخواستها **زمان زیادی** برای پاسخدهی میگیرند هنگام استفاده از حالت غیرهمزمان، تفاوتهای مهمی نسبت به حالت همزمان وجود دارد: * ماژول Python `asyncio` را وارد کنید (قبل از آن باید وابستگیهای مورد نیاز را نصب کنید). * به جای `ZabbixAPI` از `AsyncZabbixAPI` استفاده کنید. * کد خود را داخل یک تابع `async` بنویسید. * هنگام فراخوانی متدهای API، شامل `login()` و `logout()` از کلمه کلیدی `await` استفاده کنید. > **توجه مهم:** > هنگام ایجاد یک نمونه `AsyncZabbixAPI`، نمیتوانید [در زمان مقداردهی اولیه](#during-initialization) وارد سیستم شوید. مثال: برای مشاهده لیست Hostها با استفاده از [`host.get`](/manual/api/reference/host/get) در حالت غیرهمزمان: ```python id="s8w2lh" # 1. وارد کردن asyncio برای حالت غیرهمزمان و AsyncZabbixAPI از zabbix_utils import asyncio from zabbix_utils import AsyncZabbixAPI # 2. تعریف تابع async اصلی که تمام عملیات API داخل آن اجرا میشوند async def main(): # 3. ایجاد نمونه AsyncZabbixAPI و ورود به سیستم (با await) api = AsyncZabbixAPI(url="127.0.0.1") await api.login(user="User", password="zabbix") # 4. دریافت Hostهایی که با فیلتر مشخص شده مطابقت دارند (با await) hosts = await api.host.get(filter={"host": ["Zabbix server", "Linux server"]}) # 5. پیمایش روی Hostهای برگشتی و چاپ جزئیات هر Host for host in hosts: print(host) # 6. خروج از API برای بستن جلسه (با await) await api.logout() # 7. اجرای تابع async اصلی با استفاده از event loop ماژول asyncio asyncio.run(main()) ``` # Audit log Audit log # auditlog.get # auditlog.get #### Audit log Track configuration changes each user has done. [Audit log API](/manual/api/reference/auditlog) #### پیگیری تغییرات پیکربندی لاگ حسابرسی که هر کاربر انجام داده است.[API لاگ حسابرسی](/manual/api/reference/auditlog) #### Authenticating a user Authenticate a user. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "user.login", "params": { "username": "Admin", "password": "zabbix" }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": "0424bd59b807674191e7d77572075f33", "id": 1 } ``` #### حذف چندین کانکتور دو ورودی کانکتور را حذف کنید. [درخواست](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "connector.delete", "params": [ 3, 5 ], "id": 1 } ``` پاسخ: ```json { "jsonrpc": "2.0", "result": { "connectorids": [ "3", "5" ] }, "id": 1 } ``` #### Authentication Change authentication configuration options. [Authentication API](/manual/api/reference/authentication) #### گزینههای پیکربندی احراز هویت را تغییر دهید.[API احراز هویت](/manual/api/reference/authentication) # authentication.get دریافت احرازهویت # authentication.update به روز رسانی احرازهویت #### Authorization methods متد احراز هویت ### author Module author. The author will be displayed in the Administration section. *Type*: String *Example*: ```json "author": "John Smith" ``` ### نویسنده نویسنده ماژول. نویسنده در بخش مدیریت نمایش داده خواهد شد. *نوع*: رشته *مثال*: ```json "نویسنده": "جان اسمیت" ``` # autoregistration.get دریافت ثبت خودکار # autoregistration.update دریافت ثبت خودکار ## Backups tab The *Backups* tab lets you view, create, restore, and delete backups of your Zabbix node. You can restore your instance from any saved backup or create a new manual backup at any time. The tab also shows the date of the next scheduled backup. ![](../../assets/en/cloud/quickstart/backup_tab.png){width="600"} To create a backup: 1. Click *Create backup* button. 2. Enter an optional description in the popup window. 3. Click *Create* to confirm. ::: notewarning Additional backups are charged monthly based on storage usage. ::: ## تب پشتیبانگیری تب *پشتیبانگیری* به شما امکان مشاهده، ایجاد، بازیابی و حذف پشتیبانهای گره زبیکس خود را میدهد. شما میتوانید نمونه خود را از هر پشتیبان ذخیرهشده بازیابی کنید یا در هر زمان یک پشتیبان دستی جدید ایجاد کنید. این تب همچنین تاریخ پشتیبانگیری برنامهریزیشده بعدی را نشان میدهد. ![](../../assets/en/cloud/quickstart/backup_tab.png){width="600"} برای ایجاد پشتیبان: 1. روی دکمه *ایجاد پشتیبان* کلیک کنید. 2. یک توضیح اختیاری در پنجره بازشو وارد کنید. 3. برای تأیید روی *ایجاد* کلیک کنید. ::: notewarning هزینه پشتیبانگیریهای اضافی ماهانه و بر اساس میزان استفاده از فضای ذخیرهسازی محاسبه میشود. ::: ## Backward incompatible changes ## تغییرات ناسازگار با نسخههای قبلی ::: banner{.banner-cloud-top} # Zabbix Cloud Discover the available configuration options and access controls for organizations and nodes in Zabbix Cloud. Please note that Zabbix Cloud nodes currently run **Zabbix 7.0**.<br> For in-depth information on Zabbix 7.0, see [official documentation](https://www.zabbix.com/documentation/7.0/en/manual). ::: ::: banner{.banner-cloud-top} # ابر Zabbix (Zabbix Cloud) گزینههای پیکربندی موجود و کنترلهای دسترسی برای سازمانها و نودها در ابر Zabbix را کشف کنید. ::: ##### Boolean to decimal {#boolean} Convert the value from boolean format to decimal. Comments: - The textual representation is translated into either 0 or 1. Thus, 'TRUE' is stored as 1 and 'FALSE' is stored as 0. All values are matched in a case-insensitive way. Currently recognized values are, for *TRUE* - true, t, yes, y, on, up, running, enabled, available, ok, master; for *FALSE* - false, f, no, n, off, down, unused, disabled, unavailable, err, slave. Additionally, any non-zero numeric value is considered to be TRUE and zero is considered to be FALSE.<br> - If you mark the *Custom on fail* checkbox, it is possible to specify custom error-handling options: either to discard the value, set a specified value, or set a specified error message. In case of a failed preprocessing step, the item will not become unsupported if the option to discard the value or set a specified value is selected. ##### مقدار بولی به دهدهی {#boolean}مقدار را از قالب بولی به دهدهی تبدیل کنید. توضیحات: نمایش متنی به ۰ یا ۱ ترجمه میشود. بنابراین، 'TRUE' به عنوان ۱ و 'FALSE' به عنوان ۰ ذخیره میشود. همه مقادیر به صورت غیر حساس به حروف کوچک و بزرگ تطبیق داده میشوند. مقادیر شناخته شده فعلی برای *TRUE* عبارتند از: true، t، yes، y، on، up، running، enabled، available، ok، master؛ برای *FALSE* - false، f، no، n، off، down، unused، disabled، unavailable، err، slave. علاوه بر این، هر مقدار عددی غیر صفر به عنوان TRUE و صفر به عنوان FALSE در نظر گرفته میشود.<br>- اگر کادر *Custom on fail* را علامت بزنید، میتوانید گزینههای سفارشی مدیریت خطا را تعیین کنید: یا مقدار را حذف کنید، یک مقدار مشخص تنظیم کنید یا یک پیام خطای مشخص تنظیم کنید. در صورت شکست یک مرحله پیشپردازش، اگر گزینه حذف مقدار یا تنظیم یک مقدار مشخص انتخاب شود، مورد پشتیبانی نشده باقی میماند. ##### BufferSend The time interval in seconds which determines how often values are sent from the buffer to Zabbix server.<br>Note that if the buffer is full, the data will be sent sooner. Default: `5`<br> Range: 1-3600 ##### BufferSend The time interval in seconds which determines how often values are sent from the buffer to Zabbix server.<br>Note, that if the buffer is full, the data will be sent sooner. Default: `5`<br> Range: 1-3600 ##### By "Authorization" header All API requests require an authentication or an API token. You can provide the credentials by using the Authorization header in the request: ```bash curl --request POST \ --url 'https://example.com/zabbix/api_jsonrpc.php' \ --header 'Authorization: Bearer 0424bd59b807674191e7d77572075f33' ``` ::: noteimportant If you are experiencing authentication issues, see [Authorization header forwarding](/manual/installation/known_issues#authorization-header-forwarding). ::: Zabbix API accepts headers in a case-insensitive way (e.g., `authorization`, `Authorization`, and `AUTHORIZATION` are treated the same). The Authorization header is supported in cross-origin requests ([CORS](https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS)). ##### توسط سرآیند "Authorization" تمام درخواستهای API نیاز به احراز هویت یا توکن API دارند. میتوانید با استفاده از سرآیند Authorization در درخواست، اعتبارنامهها را ارائه دهید: ##### By Zabbix cookie A *"zbx_session"* cookie is used to authorize an API request from Zabbix UI performed using JavaScript (from a module or a custom widget). ##### توسط زبیکس cookieA *"zbx_session"* cookie برای تأیید درخواست API از رابط کاربری زبیکس که با استفاده از جاوا اسکریپت (از یک ماژول یا یک ویجت سفارشی) انجام میشود، استفاده میشود. #### Calculation of queues during maintenance ::: noteimportant The Zabbix proxy is not aware of maintenance periods; see [Calculation of queues during maintenance](/manual/maintenance#calculation-of-queues-during-maintenance) for details. ::: #### محاسبه صفها در طول نگهداری::: نکته: مهم است. پروکسی زبیکس از دورههای نگهداری آگاه نیست؛ برای جزئیات بیشتر به [محاسبه صفها در طول نگهداری](/manual/maintenance#calculation-of-queues-during-maintenance) مراجعه کنید.::: ::: card #### Adding users Find out how to add and assign roles to users within a Zabbix Cloud organization and its nodes. [](/cloud/adding_users){.card-link} ::: نحوه افزودن و تخصیص نقشها به کاربران درون یک سازمان ابر Zabbix و گرههای آن را بیاموزید. [](/cloud/adding_users){.card-link} ::: card #### Explore Zabbix Cloud Get an overview of Zabbix Cloud, including its key features, perks, and what comes with a subscription. For common questions on setup and usage, see the FAQ. [](https://www.zabbix.com/cloud){.card-link} ::: یک نمای کلی از ابر Zabbix (Zabbix Cloud) دریافت کنید، شامل ویژگیهای کلیدی، مزایا و آنچه همراه با اشتراک ارائه میشود. برای سوالات رایج درباره راهاندازی و استفاده، به بخش سوالات متداول مراجعه کنید. [](https://www.zabbix.com/cloud){.card-link} ::: card #### Node configuration Learn how to set up your Zabbix Cloud node, focusing on access, data handling, and resource settings. [](/cloud/node_configuration){.card-link} ::: تنظیمات گره (node) ابر Zabbix خود را بیاموزید، با تمرکز بر دسترسی، مدیریت داده و تنظیمات منابع. [](/cloud/node_configuration){.card-link} ::: card #### Start using Zabbix Cloud Guided instructions to get your Zabbix Cloud instance up and running quickly, including initial configuration and connecting your monitored devices. [](/cloud/quickstart){.card-link} ::: ::: کارت #### شروع استفاده از ابر Zabbix دستورالعملهای گامبهگام برای راهاندازی سریع نمونه ابر Zabbix خود، شامل پیکربندی اولیه و اتصال دستگاههای تحت نظارت. [](/cloud/quickstart){.card-link} ::: ::: card #### Zabbix Cloud vs. on-premises Compare the differences in management, scalability, and maintenance between the two deployments, and learn which can support your workflow most seamlessly. [](/cloud/key_differences){.card-link} ::: ::: کارت #### ابر Zabbix در مقابل نسخه داخلی (on-premises) تفاوتهای مدیریت، مقیاسپذیری و نگهداری بین دو روش استقرار را مقایسه کنید و بیاموزید کدام یک میتواند از گردش کاری شما بهطور یکپارچه پشتیبانی کند. [](/cloud/key_differences){.card-link} ::: ##### Change per second {#changepersec} Calculate the value change (difference between the current and previous value) speed per second. Comments: - This step is useful for calculating the speed per second of a constantly growing value;<br> - As this calculation may produce floating-point numbers, it is recommended to set the 'Type of information' to *Numeric (float)*, even if the incoming raw values are integers. This is especially relevant for small numbers where the decimal part matters. If the floating-point values are large and may exceed the 'float' field length in which case the entire value may be lost, it is actually recommended to use *Numeric (unsigned)* and thus trim only the decimal part.<br> - Evaluated as (**value**-**prev\_value**)/(**time**-**prev\_time**), where *value* - the current value; *prev\_value* - the previously received value; *time* - the current timestamp; *prev\_time* - the timestamp of the previous value;<br> - Only one change operation per item ("Simple change" or "Change per second") is allowed; - If the current value is smaller than the previous value, Zabbix discards that difference (stores nothing) and waits for another value. This helps to work correctly with, for instance, a wrapping (overflow) of 32-bit SNMP counters.<br> - If you mark the *Custom on fail* checkbox, it is possible to specify custom error-handling options: either to discard the value, set a specified value, or set a specified error message. In case of a failed preprocessing step, the item will not become unsupported if the option to discard the value or set a specified value is selected. ##### تغییر در ثانیه {#changepersec}سرعت تغییر مقدار (اختلاف بین مقدار فعلی و قبلی) در ثانیه را محاسبه کنید. توضیحات:- این مرحله برای محاسبه سرعت در ثانیه یک مقدار که دائماً در حال رشد است مفید است.<br>- از آنجایی که این محاسبه ممکن است اعداد اعشاری تولید کند، توصیه میشود 'نوع اطلاعات' را روی *عددی (float)* تنظیم کنید، حتی اگر مقادیر خام ورودی عدد صحیح باشند. این امر به ویژه برای اعداد کوچک که قسمت اعشاری آنها مهم است، اهمیت دارد. اگر مقادیر اعشاری بزرگ باشند و ممکن است از طول فیلد 'شناور' تجاوز کنند که در این صورت ممکن است کل مقدار از بین برود، در واقع توصیه میشود از *عددی (unsigned)* استفاده کنید و بنابراین فقط قسمت اعشاری را حذف کنید.<br>- به صورت (**value**-**prev\_value**)/(**time**-**prev\_time**) ارزیابی میشود، که در آن *value* - مقدار فعلی؛ *prev\_value* - مقدار دریافتی قبلی؛ *time* - مهر زمانی فعلی؛ *prev\_time* - مهر زمانی مقدار قبلی؛<br>-فقط یک عملیات تغییر برای هر مورد ("تغییر ساده" یا "تغییر در هر ثانیه") مجاز است؛-اگر مقدار فعلی کوچکتر از مقدار قبلی باشد، زبیکس آن تفاوت را نادیده میگیرد (چیزی ذخیره نمیکند) و منتظر مقدار دیگری میماند. این به عنوان مثال، به کار صحیح با یک پوشش (سرریز) از شمارندههای SNMP 32 بیتی کمک میکند.<br>-اگر کادر *سفارشی در صورت خرابی* را علامت بزنید، میتوانید گزینههای مدیریت خطای سفارشی را تعیین کنید: یا مقدار را نادیده بگیرید، یا یک مقدار مشخص تنظیم کنید. # Changes to extension development This page lists all changes (if any) to developing custom Zabbix extensions. # تغییرات در توسعه افزونهها این صفحه تمام تغییرات (در صورت وجود) در توسعه افزونههای سفارشی زبیکس را فهرست میکند. #### Changing HTTP authentication type Change HTTP authentication type to Bearer for connector with ID "3". [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "connector.update", "params": { "connectorid": 3, "authtype": 5, "token": "{$DATA_EXPORT_BEARER_TOKEN}" }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "connectorids": [ "3" ] }, "id": 1 } ``` ####تغییر متد authentication برای http Change HTTP authentication type to Bearer for connector with ID "3". [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "connector.update", "params": { "connectorid": 3, "authtype": 5, "token": "{$DATA_EXPORT_BEARER_TOKEN}" }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "connectorids": [ "3" ] }, "id": 1 } ``` #### Changing the interface of an item prototype Change the host interface that will be used by discovered items. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "itemprototype.update", "params": { "itemid": "27428", "interfaceid": "132" }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "27428" ] }, "id": 1 } ``` #### تغییر رابط نمونه اولیه یک آیتم رابط میزبانی که توسط آیتمهای کشفشده استفاده خواهد شد را تغییر دهید.[درخواست](/manual/api#performing-requests):```json{"jsonrpc": "2.0","method": "itemprototype.update","params": {"itemid": "27428","interfaceid": "132"},"id": 1}```پاسخ:```json{"jsonrpc": "2.0","result": {"itemids": ["27428"]},"id": 1}```` ##### Check for error in JSON {#errorinjson} Check for an application-level error message located at JSONPath. Stop processing if succeeded and the message is not empty; otherwise, continue processing with the value that was before this preprocessing step. Comments: - These external service errors are reported to the user as is, without adding preprocessing step information;<br> - No error will be reported in case of failing to parse invalid JSON;<br> - If you mark the *Custom on fail* checkbox, it is possible to specify custom error-handling options: either to discard the value, set a specified value, or set a specified error message. In case of a failed preprocessing step, the item will not become unsupported if the option to discard the value or set a specified value is selected. ##### بررسی خطا در JSON {#errorinjson}پیام خطای سطح برنامه واقع در JSONPath را بررسی کنید. در صورت موفقیتآمیز بودن و خالی نبودن پیام، پردازش را متوقف کنید؛ در غیر این صورت، پردازش را با مقداری که قبل از این مرحله پیشپردازش بوده است، ادامه دهید. توضیحات: - این خطاهای سرویس خارجی بدون اضافه کردن اطلاعات مرحله پیشپردازش، به کاربر گزارش میشوند؛<br>- در صورت عدم موفقیت در تجزیه JSON نامعتبر، هیچ خطایی گزارش نخواهد شد؛<br>- اگر کادر *سفارشی در صورت عدم موفقیت* را علامت بزنید، میتوانید گزینههای سفارشی مدیریت خطا را تعیین کنید: یا مقدار را حذف کنید، یک مقدار مشخص شده را تنظیم کنید یا یک پیام خطای مشخص شده را تنظیم کنید. در صورت شکست مرحله پیشپردازش، اگر گزینه حذف مقدار یا تنظیم یک مقدار مشخص شده انتخاب شود، مورد پشتیبانی نشده باقی میماند. ##### Check for error in XML {#errorinxml} Check for an application-level error message located at XPath. Stop processing if succeeded and the message is not empty; otherwise, continue processing with the value that was before this preprocessing step. Comments: - These external service errors are reported to the user as is, without adding preprocessing step information;<br> - No error will be reported in case of failing to parse invalid XML;<br> - If you mark the *Custom on fail* checkbox, it is possible to specify custom error-handling options: either to discard the value, set a specified value, or set a specified error message. In case of a failed preprocessing step, the item will not become unsupported if the option to discard the value or set a specified value is selected. ##### بررسی خطا در XML {#errorinxml}پیام خطای سطح برنامه واقع در XPath را بررسی کنید. در صورت موفقیتآمیز بودن و خالی نبودن پیام، پردازش را متوقف کنید؛ در غیر این صورت، پردازش را با مقداری که قبل از این مرحله پیشپردازش بود، ادامه دهید. توضیحات: - این خطاهای سرویس خارجی بدون اضافه کردن اطلاعات مرحله پیشپردازش، به کاربر گزارش میشوند؛<br>- در صورت عدم موفقیت در تجزیه XML نامعتبر، هیچ خطایی گزارش نخواهد شد؛<br>- اگر کادر *سفارشی در صورت عدم موفقیت* را علامت بزنید، میتوانید گزینههای سفارشی مدیریت خطا را تعیین کنید: یا مقدار را حذف کنید، یک مقدار مشخص شده را تنظیم کنید یا یک پیام خطای مشخص شده را تنظیم کنید. در صورت شکست مرحله پیشپردازش، اگر گزینه حذف مقدار یا تنظیم یک مقدار مشخص شده انتخاب شود، مورد پشتیبانی نشده باقی میماند. ##### Check for error using a regular expression {#errorbyregexp} Check for an application-level error message using a regular expression. Stop processing if succeeded and the message is not empty; otherwise, continue processing with the value that was before this preprocessing step. Parameters: - **pattern** - the regular expression;<br> - **output** - the output formatting template. An \\N (where N=1…9) escape sequence is replaced with the Nth matched group. A \\0 escape sequence is replaced with the matched text. Comments: - These external service errors are reported to the user as is, without adding preprocessing step information;<br> - If you mark the *Custom on fail* checkbox, it is possible to specify custom error-handling options: either to discard the value, set a specified value, or set a specified error message. In case of a failed preprocessing step, the item will not become unsupported if the option to discard the value or set a specified value is selected. ##### بررسی خطا با استفاده از یک عبارت منظم {#errorbyregexp}بررسی پیام خطای سطح برنامه با استفاده از یک عبارت منظم. در صورت موفقیتآمیز بودن و خالی نبودن پیام، پردازش را متوقف کنید؛ در غیر این صورت، پردازش را با مقداری که قبل از این مرحله پیشپردازش بود، ادامه دهید. پارامترها: -**pattern** - عبارت منظم؛<br>-**output** - الگوی قالببندی خروجی. یک دنباله escape با Nامین گروه منطبق جایگزین میشود. یک دنباله escape با متن منطبق جایگزین میشود. توضیحات: -این خطاهای سرویس خارجی به همان صورت و بدون اضافه کردن اطلاعات مرحله پیشپردازش به کاربر گزارش میشوند؛<br> -اگر کادر *Custom on fail* را علامت بزنید، میتوانید گزینههای سفارشی مدیریت خطا را تعیین کنید: یا مقدار را حذف کنید، یک مقدار مشخص شده را تنظیم کنید یا یک پیام خطای مشخص شده را تنظیم کنید. در صورت شکست یک مرحله پیشپردازش، اگر گزینه حذف مقدار یا تنظیم یک مقدار مشخص انتخاب شود، مورد پشتیبانی نشده باقی میماند. ##### Check for not supported value {#checkunsupported} Check if no item value could be retrieved. Specify how the failure should be processed, based on inspecting the returned error message. Parameters: - **scope** - select the error processing scope:<br>*any error* - any error;<br>*error matches* - only the error that matches the regular expression specified in *pattern*;<br>*error does not match* - only the error that does not match the regular expression specified in *pattern*<br> - **pattern** - the regular expression to match the error to. If *any error* is selected in the scope parameter, this field is not displayed. If displayed, this field is mandatory.<br> Comments: - Normally, the absence/failure to retrieve a value would lead to the item becoming unsupported. This preprocessing step allows you to modify this behavior. If you mark the *Custom on fail* checkbox (always marked and grayed out for this preprocessing step), it is possible to specify custom error-handling options: either to discard the value, set a specified value, or set a specified error message. In case of a failed preprocessing step, the item will not become unsupported if the option to discard the value or set a specified value is selected. - This preprocessing step only checks if no item value could be retrieved. It does not check, for example, if the type of the retrieved value (e.g., string) matches the item's type of information (e.g., numeric); for details, see [Preprocessing examples](/manual/config/items/preprocessing/examples#checking-for-not-supported-value). If there is a type mismatch, the item may still become unsupported after all preprocessing steps are executed. To check for a type mismatch, you may use, for example, the *Custom multiplier* preprocessing step; see [Preprocessing examples](/manual/config/items/preprocessing/examples#checking-retrieved-value-type). - Capturing regular expression groups is supported in the *Set value to* or *Set error to* fields. Use \\N (where N=1…9) to retrieve the Nth matched group; use \\0 to retrieve the matched text; - These steps are always executed as the first preprocessing steps and are placed above all others after saving changes to the item; - Multiple *Check for not supported value* steps are supported, in the specified order. A step for *any error* will be automatically placed as the last step in this group. بررسی مقدار پشتیبانی نشده {#checkunsupported}بررسی کنید که آیا هیچ مقداری از آیتم قابل بازیابی نیست. نحوه پردازش خطا را بر اساس بررسی پیام خطای برگشتی مشخص کنید. پارامترها:-**scope** - محدوده پردازش خطا را انتخاب کنید:<br>*any error* - هر خطایی؛<br>*error matches* - فقط خطایی که با عبارت منظم مشخص شده در *pattern* مطابقت دارد؛<br>*error does not match* - فقط خطایی که با عبارت منظم مشخص شده در *pattern* مطابقت ندارد<br>-**pattern** - عبارت منظمی که خطا با آن مطابقت دارد. اگر *any error* در پارامتر scope انتخاب شود، این فیلد نمایش داده نمیشود. در صورت نمایش، این فیلد اجباری است.<br>توضیحات:-به طور معمول، عدم وجود/عدم موفقیت در بازیابی یک مقدار منجر به عدم پشتیبانی از آیتم میشود. این مرحله پیشپردازش به شما امکان میدهد این رفتار را تغییر دهید. اگر کادر انتخاب *Custom on fail* (که همیشه برای این مرحله پیشپردازش علامتگذاری و خاکستری شده است) را علامت بزنید، میتوانید مدیریت خطای سفارشی را مشخص کنید. گزینهها: یا برای صرف نظر کردن از مقدار، تنظیم یک مقدار مشخص، یا تنظیم یک پیام خطای مشخص. در صورت عدم موفقیت در مرحله پیشپردازش، اگر گزینه صرف نظر کردن از مقدار یا تنظیم یک مقدار مشخص انتخاب شود، آیتم پشتیبانی نشده باقی میماند. - این مرحله پیشپردازش فقط بررسی میکند که آیا هیچ مقدار آیتمی قابل بازیابی نیست یا خیر. برای مثال، بررسی نمیکند که آیا نوع مقدار بازیابی شده (مثلاً رشته) با نوع اطلاعات آیتم (مثلاً عددی) مطابقت دارد یا خیر. #### Cloud nodes and organizations Cloud nodes and organizations are created using the [Zabbix Cloud](https://cloud.zabbix.com) user interface. A **cloud node** is the equivalent of a Zabbix instance, based in the cloud. It includes Zabbix server, the database, and the web frontend. A cloud node has dedicated computing resources (CPU, memory) and disk storage. Users may create one or more cloud nodes. Cloud nodes can be grouped into **organizations** (structural, regional, etc), creating a distributed monitoring setup. ### Cloud Nodes و Organizationها **Cloud Node**‌ها و **Organization**ها با استفاده از رابط کاربری Zabbix Cloud ایجاد می‌شوند. یک **Cloud Node** معادل یک Instance از Zabbix است که در بستر Cloud قرار دارد. این نود شامل موارد زیر می‌باشد: * Zabbix Server * دیتابیس * Web Frontend هر Cloud Node دارای منابع پردازشی اختصاصی (CPU و حافظه) و فضای ذخیره‌سازی دیسک است. کاربران می‌توانند یک یا چند Cloud Node ایجاد کنند. همچنین Cloud Nodeها را می‌توان در قالب **Organization**ها (ساختاری، منطقه‌ای و غیره) گروه‌بندی کرد تا یک زیرساخت مانیتورینگ توزیع‌شده ایجاد شود. # Collect data from Zabbix agent جمعآوری داده از Zabbix Agent #### Columns Columns have common parameters and additional parameters depending on the configuration of the parameter *Data*. ::: noteclassic For all parameters related to columns the number in the property name (e.g. columns.0.name) references a column for which the parameter is configured. ::: #### Columns Columns have common parameters and additional parameters depending on the configuration of the parameter *Data*. ::: noteclassic For all parameters related to columns the number in the property name (e.g. columns.name.0) references a column for which the parameter is configured. ::: #### Comparison table While most of the functionality overlaps between on-premise Zabbix installations and cloud nodes, there are also differences. A summary comparison table is provided below. Subsequent sections describe selected items in detail. |Feature / Aspect|Zabbix Cloud|Zabbix on‑premises| |--|----|----| |*Release cycle*|In step with LTS [releases](https://www.zabbix.com/life_cycle_and_release_policy)|You choose your Zabbix version (stable, beta, custom builds)| |*Ease of use*|Ready-to-use platform, fully managed by Zabbix|Requires [installation](/manual/installation), configuration and maintenance| |*Vulnerability patching*|Automatic OS/Zabbix patching|Manual patching by user| |*HTTPS certificate*|Valid certificate out‑of‑the‑box (no Let's Encrypt)|Self‑signed by default (Let's Encrypt or other CA can be configured)| |*DB performance*<br>(INSERT/UPDATE/SELECT)|Auto‑partitioning for max speed; no long-running DELETEs|Manual partitioning & cleanup (long DELETE transactions possible)| |*Performance tuning*|Pre‑tuned by Zabbix Cloud team (no changelogs)|Full visibility & control over tuning parameters| |*Firewall control*|Managed by Zabbix Cloud team; GUI/trapper ports not exposed publicly|Full control of firewall rules and port exposure| |*DB isolation & protection*|Highly isolated, no direct DB/SSH access|Depends on your network and host [security](/manual/best_practices/security)| |*High availability (HA)*|Runs on a highly-available cloud platform,<br>Zabbix proxies can be used for higher data-collection resilience|User-managed HA| |*[SNMP traps](#snmp-traps)*|Only via dedicated proxy (no HA/load‑balanced trap receiver)|Direct or via proxy, HA/load‑balance possible| |*[SNMP polling](#snmp-polling)*|Hard without proxies (each device needs NAT/custom port)|Native [SNMP polling](/manual/config/items/itemtypes/snmp); proxy optional| |*[Retention settings](#retention-settings)*|[History/Trends/Audit](/cloud/node_configuration#history-tab) only via UI (no API or configuration file)|Configurable in Zabbix [server configuration file](/manual/appendix/config/zabbix_server) or via [API](/manual/api/reference#monitoring)| |*[Custom scripts](#custom-scripts)*|[`AlertScriptsPath`](/manual/appendix/config/zabbix_server#alertscriptspath), [`ExternalScripts`](/manual/appendix/config/zabbix_server#externalscripts), frontend & community modules not supported|Fully supported ([scripts](/manual/config/notifications/media/script) path, [modules](/manual/extensions/frontendmodules), integrations)| |*[ODBC monitoring](#odbc-monitoring)*|Only PostgreSQL (driver `{postgresql}`); MariaDB plugin present as a placeholder|ODBC for PostgreSQL, MySQL, Oracle, etc. - fully configurable| |*Limiting ODBC calls*|Not possible ([`StartODBCPollers=1`]((/manual/appendix/config/zabbix_server#startodbcpollers)) only; heavy sync queries block other work)|Fully tunable poller count & scheduling| |*[SAML certificate upload](#saml-certificate-upload)*|Not supported|Supported via UI or API| |*[Scheduled reports](#scheduled-reports)*|Must [create](/manual/config/notifications/media#configuring-media-type) own Email media (script media unsupported)|Supports both script and Email media out‑of‑the‑box| |*[Host interface for active checks](#active-checks-interface)*|Platform-issued IP address (created automatically)|Interfaces managed by you; IPs under your control| #### جدول مقایسه در حالی که بیشتر قابلیتها بین نصبهای **On-Premise زبیکس** و نودهای **Cloud** همپوشانی دارند، تفاوتهایی نیز وجود دارد. خلاصهای از مقایسه در جدول زیر ارائه شده است. بخشهای بعدی برخی موارد را با جزئیات توضیح میدهند. | ویژگی / جنبه | Zabbix Cloud | Zabbix On-Premises | | -------------------------------------------- | -------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------- | | **چرخه انتشار** | همگام با نسخههای LTS | انتخاب نسخه زبیکس توسط شما (پایدار، بتا، بیلد سفارشی) | | **سهولت استفاده** | پلتفرم آماده استفاده، کاملاً مدیریتشده توسط تیم Zabbix | نیازمند نصب، پیکربندی و نگهداری | | **وصلههای امنیتی (Vulnerability Patching)** | بهروزرسانی خودکار سیستمعامل و Zabbix | بهروزرسانی دستی توسط کاربر | | **گواهی HTTPS** | دارای گواهی معتبر بهصورت پیشفرض (بدون Let's Encrypt) | بهصورت پیشفرض Self-Signed (قابل پیکربندی با Let's Encrypt یا سایر CAها) | | **کارایی دیتابیس (INSERT/UPDATE/SELECT)** | پارتیشنبندی خودکار برای حداکثر سرعت؛ بدون DELETEهای طولانیمدت | پارتیشنبندی و پاکسازی دستی (امکان تراکنشهای DELETE طولانی وجود دارد) | | **تنظیم عملکرد (Performance Tuning)** | از پیش تنظیمشده توسط تیم Zabbix Cloud | مشاهده و کنترل کامل روی پارامترهای تنظیم | | **کنترل فایروال** | مدیریتشده توسط تیم Zabbix Cloud؛ پورتهای GUI/trapper بهصورت عمومی در دسترس نیستند | کنترل کامل قوانین فایروال و پورتها | | **ایزولهسازی و حفاظت دیتابیس** | ایزولاسیون بالا، بدون دسترسی مستقیم DB/SSH | وابسته به امنیت شبکه و میزبان شما | | **دسترسپذیری بالا (HA)** | اجرا روی پلتفرم Cloud با HA بالا؛ امکان استفاده از Zabbix Proxy برای افزایش تابآوری جمعآوری داده | HA توسط کاربر مدیریت میشود | | **SNMP Traps** | فقط از طریق Proxy اختصاصی (بدون HA یا Load Balance برای Trap Receiver) | مستقیم یا از طریق Proxy، با امکان HA و Load Balance | | **SNMP Polling** | بدون Proxy دشوار (هر دستگاه نیاز به NAT/پورت سفارشی دارد) | SNMP Polling بومی؛ Proxy اختیاری | | **تنظیمات نگهداری داده (Retention)** | فقط از طریق UI (بدون API یا فایل پیکربندی) | قابل پیکربندی در فایل سرور Zabbix یا از طریق API | | **اسکریپتهای سفارشی** | پشتیبانی نمیشود (AlertScriptsPath، ExternalScripts، ماژولهای فرانتاند و Community) | پشتیبانی کامل (مسیر اسکریپتها، ماژولها، یکپارچهسازیها) | | **مانیتورینگ ODBC** | فقط PostgreSQL (درایور `{postgresql}`)؛ پلاگین MariaDB فقط بهعنوان Placeholder | ODBC برای PostgreSQL، MySQL، Oracle و غیره — کاملاً قابل تنظیم | | **محدودسازی فراخوانیهای ODBC** | امکانپذیر نیست (فقط `StartODBCPollers=1`)؛ کوئریهای سنگین سایر کارها را مسدود میکنند | تنظیم کامل تعداد Pollerها و زمانبندی | | **آپلود گواهی SAML** | پشتیبانی نمیشود | از طریق UI یا API پشتیبانی میشود | | **گزارشهای زمانبندیشده** | نیاز به ایجاد Email Media اختصاصی (Script Media پشتیبانی نمیشود) | پشتیبانی پیشفرض از Script و Email Media | | **Host Interface برای Active Checks** | آدرس IP صادرشده توسط پلتفرم (ایجاد خودکار) | اینترفیسها توسط شما مدیریت میشوند؛ IPها تحت کنترل شما هستند | ### Complete source code ```go package main import ( "io" "net/http" "golang.zabbix.com/sdk/errs" "golang.zabbix.com/sdk/plugin" "golang.zabbix.com/sdk/plugin/container" ) var _ plugin.Exporter = (*myIP)(nil) type myIP struct { plugin.Base } func main() { err := run() if err != nil { panic(err) } } func run() error { p := &myIP{} // Register the `myip` item key. err := plugin.RegisterMetrics( p, "MyIP", // Plugin name "myip", // Item key name "Returns the host's IP address.", // Item key description ) if err != nil { return errs.Wrap(err, "failed to register metrics") } // Create a new handler. h, err := container.NewHandler("MyIP") // Plugin name if err != nil { return errs.Wrap(err, "failed to create new handler") } // Setup logging to forward logs from the plugin to the agent. // Available via p.Logger.Infof, p.Logger.Debugf, etc. p.Logger = h // Start plugin execution. // Blocks until a termination request from the agent is received. err = h.Execute() if err != nil { return errs.Wrap(err, "failed to execute plugin handler") } return nil } func (p *myIP) Export( key string, params []string, context plugin.ContextProvider, ) (any, error) { // The plugin can use different data collection logic based on the `key` parameter. // This implementation only verifies that the provided `key` is supported. if key != "myip" { return nil, errs.Errorf("unknown item key %q", key) } // The log will get forwarded to the agent 2 log. p.Infof( "received request to handle %q key with %d parameters", key, len(params), ) // Collect the data and return it. resp, err := http.Get("https://api.ipify.org") if err != nil { return nil, errs.Wrap(err, "failed to get IP address") } defer resp.Body.Close() body, err := io.ReadAll(resp.Body) if err != nil { return nil, errs.Wrap(err, "failed to read response body") } return string(body), nil } ``` ### کد منبع کامل ```go package main import ("io" "net/http" "golang.zabbix.com/sdk/errs" "golang.zabbix.com/sdk/plugin" "golang.zabbix.com/sdk/plugin/container" ) var _ plugin.Exporter = (*myIP)(nil) type myIP struct { plugin.Base } func main() { err := run() if err != nil { panic(err) } } func run() error { p := &myIP{} // کلید آیتم `myip` را ثبت کنید. err := plugin.RegisterMetrics( p, "MyIP", // نام افزونه "myip", // نام کلید آیتم "آدرس IP میزبان را برمیگرداند.", // توضیحات کلید آیتم ) if err != nil { return errs.Wrap(err, "ثبت معیارها ناموفق بود") } // ایجاد یک هندلر جدید. h, err := container.NewHandler("MyIP") // نام افزونه if err != nil { return errs.Wrap(err, "ایجاد هندلر جدید ناموفق بود") } // راهاندازی ثبت وقایع برای ارسال گزارشها از افزونه به عامل. // از طریق p.Logger.Infof، p.Logger.Debugf و غیره در دسترس است. p.Logger = h // شروع اجرای افزونه. // تا زمانی که درخواست خاتمه از عامل دریافت نشود، مسدود میشود. err = h.Execute() اگر err != nil { return errs.Wrap(err, "اجرای کنترلکننده افزونه ناموفق بود") return nil } func (p *myIP) Export( key string, params []string, context plugin.ContextProvider, ) (any, error) { // افزونه میتواند از منطق جمعآوری دادههای مختلف بر اساس پارامتر `key` استفاده کند. // این پیادهسازی فقط تأیید میکند که `key` ارائه شده پشتیبانی میشود. if key != "myip" { return nil, errs.Errorf("کلید آیتم ناشناخته %q", key) } // گزارش به گزارش عامل ۲ ارسال میشود. p.Infof("درخواست دریافت شده برای مدیریت کلید %q با پارامترهای %d", key, len(params), ) // دادهها را جمعآوری کرده و برمیگرداند. resp, err := http.Get("https://api.ipify.org") if err != nil { return nil, errs.Wrap(err, "دریافت آدرس IP ناموفق بود") } defer resp.Body.Close() body, err := io.ReadAll(resp.Body) if err != nil { return nil, errs.Wrap(err, "خواندن بدنه پاسخ ناموفق بود") } return string(body), nil } ```` ### config Default values for the module options. The object may contain any custom keys. If specified, these values will be written into the database during module registration. New variables added later will be written upon the first call. Afterwards, the variable values can only be changed directly in the database. *Type*: Object *Example*: ```json "config": { "username": "Admin", "password": "", "auth_url": "https://example.com/auth" } ``` ### پیکربندی مقادیر پیشفرض برای گزینههای ماژول. شیء میتواند شامل هر کلید سفارشی باشد. در صورت مشخص شدن، این مقادیر در هنگام ثبت ماژول در پایگاه داده نوشته میشوند. متغیرهای جدیدی که بعداً اضافه میشوند، در اولین فراخوانی نوشته میشوند. پس از آن، مقادیر متغیر فقط میتوانند مستقیماً در پایگاه داده تغییر کنند. *نوع*: شیء *مثال*: ```json "config": { "username": "Admin", "password": "", "auth_url": "https://example.com/auth" } ```` #### Configuration پیکربندی #### Configuration A problem can be suppressed through the **[problem update](/manual/acknowledgment#updating-problems)** window, where suppression is one of the problem update options along with commenting, changing severity, acknowledging, etc. A problem may also be unsuppressed through the same problem update window. #### پیکربندی یک مشکل میتواند از طریق پنجره **[problem update](/manual/acknowledgment#updating-problems)** سرکوب شود، که در آن سرکوب یکی از گزینههای بهروزرسانی مشکل به همراه نظردهی، تغییر شدت، تأیید و غیره است. همچنین ممکن است یک مشکل از طریق همان پنجره بهروزرسانی مشکل، سرکوب نشود. ##### Configuration examples For a basic example of how to set up Zabbix for monitoring VMware using the *VMware FQDN* template, see [*Monitor VMware with Zabbix*](/manual/guides/monitor_vmware). For a more detailed example of how to create a host, a low-level discovery rule, and a host prototype for monitoring VMware, see [*Setup example*](/manual/vm_monitoring/example). ##### Configuration examples For a basic example of how to set up Zabbix for monitoring VMware using the *VMware FQDN* template, see [*Monitor VMware with Zabbix*](/manual/guides/monitor_vmware). For a more detailed example of how to create a host, a low-level discovery rule, and a host prototype for monitoring VMware, see [*Setup example*](/manual/vm_monitoring/example). # configuration.export خروجی گرفتن از تنظیمات #### Configuration Global notifications can be enabled per user in the **Frontend notifications** tab of [Notifications](/manual/web_interface/user_profile#notifications) section. ![profile\_c.png](../../../../assets/en/manual/web_interface/profile_c.png) |Parameter|Description| |--|--------| |*Frontend notifications*|Mark the checkbox to enable global notifications.| |*Message timeout*|Set the duration for which the message will be displayed. By default, messages remain on the screen for 60 seconds.<br>[Time suffixes](/manual/appendix/suffixes) are supported, for example: 30s, 5m, 2h, 1d.| |*Play sound*|Set the duration for which the sound will be played.<br>**Once** - sound is played once and fully;<br>**10 seconds** - sound is repeated for 10 seconds;<br>**Message timeout** - sound is repeated while the message is visible.| |*Trigger severity*|Set the trigger severities for which global notifications and sounds will be activated. You can also select sounds appropriate for various severities.<br>If no severity is marked, no messages will be displayed.<br>Additionally, recovery messages will only be displayed for marked severities. For instance, if *Recovery* and *Disaster* are marked, global notifications will be displayed for problems and recoveries of *Disaster* severity triggers.| |*Show suppressed problems*|Mark the checkbox to display notifications for problems that would otherwise be suppressed (not shown) due to host maintenance.| #### Configuration Global notifications can be enabled per user in the *Messaging* tab of [profile configuration](/manual/web_interface/user_profile). ![profile\_c.png](../../../../assets/en/manual/web_interface/profile_c.png) |Parameter|Description| |---------|-----------| |*Frontend messaging*|Mark the checkbox to enable global notifications.| |*Message timeout*|You can set for how long the message will be displayed. By default, messages will stay on screen for 60 seconds.<br>[Time suffixes](/manual/appendix/suffixes) are supported, e.g. 30s, 5m, 2h, 1d.| |*Play sound*|You can set how long the sound will be played.<br>**Once** - sound is played once and fully.<br>**10 seconds** - sound is repeated for 10 seconds.<br>**Message timeout** - sound is repeated while the message is visible.| |*Trigger severity*|You can set the trigger severities that global notifications and sounds will be activated for. You can also select the sounds appropriate for various severities.<br>If no severity is marked then no messages will be displayed at all.<br>Also, recovery messages will only be displayed for those severities that are marked. So if you mark *Recovery* and *Disaster*, global notifications will be displayed for the problems and the recoveries of disaster severity triggers.| |*Show suppressed problems*|Mark the checkbox to display notifications for problems which would otherwise be suppressed (not shown) because of host maintenance.| # configuration.import وارد کردن تنظیمات # configuration.importcompare مقایسه تنظیمات وارد شده # Configuration This page describes classes that can be used to create a widget configuration view with custom configuration fields. The widget configuration view is the part of the widget that allows the user to configure widget parameters for [presentation](/presentation). # پیکربندی این صفحه کلاسهایی را شرح میدهد که میتوانند برای ایجاد نمای پیکربندی ویجت با فیلدهای پیکربندی سفارشی استفاده شوند. نمای پیکربندی ویجت بخشی از ویجت است که به کاربر اجازه میدهد پارامترهای ویجت را برای [presentation](/presentation) پیکربندی کند. #### Configuration To configure, select *Graph prototype* as widget type: ![](../../../../../../assets/en/manual/web_interface/frontend_sections/dashboards/widgets/graph_prototype.png){width="600"} In addition to the parameters that are [common](/manual/web_interface/frontend_sections/dashboards/widgets#common-parameters) for all widgets, you may set the following specific options: | | | |--|--------| |*Source*|Select the source of the graphs: **Graph prototype** or **Simple graph prototype**.| |*Graph prototype*|Select a graph prototype to display graphs discovered by the graph prototype.<br>This parameter is available if *Source* is set to "Graph prototype".| |*Item prototype*|Select an item prototype to display simple graphs for items discovered by the item prototype.<br>This parameter is available if *Source* is set to "Simple graph prototype".| |*Time period*|Set a time period for which to display data in the graphs. Select the [data source](/manual/web_interface/frontend_sections/dashboards/widgets#dynamic-parameters) for the time period:<br>**Dashboard** - set the *Time period* selector as the data source;<br>**Widget** - set a compatible widget specified in the *Widget* parameter as the data source;<br>**Custom** - set the time period specified in the *From* and *To* parameters as the data source; if set, a clock icon will be displayed in the upper-right corner of the widget, indicating the set time on mouseover.| |*Widget*|Enter or select a compatible widget as the data source for the time period.<br>This parameter is available if *Time period* is set to "Widget".| |*From*|Enter or select the start of the time period.<br>[Relative time syntax](/manual/web_interface/time_period_selector) (`now`, `now/d`, `now/w-1w`, etc.) is supported.<br>This parameter is available if *Time period* is set to "Custom".| |*To*|Enter or select the end of the time period.<br>[Relative time syntax](/manual/web_interface/time_period_selector) (`now`, `now/d`, `now/w-1w`, etc.) is supported.<br>This parameter is available if *Time period* is set to "Custom".| |*Show legend*|Unmark this checkbox to hide the legend on the graphs (marked by default).| |*Override host*|Select a compatible widget or the dashboard as the [data source](/manual/web_interface/frontend_sections/dashboards/widgets/#dynamic-parameters) for hosts.<br>This parameter is not available when configuring the widget on a [template dashboard](/manual/config/templates/template#adding-dashboards).| |*Columns*|Enter the number of columns of graphs to display within a graph prototype widget.| |*Rows*|Enter the number of rows of graphs to display within a graph prototype widget.| The legend of the graph consists of three sections: - Items and their aggregated values - Percentiles (if configured) - Triggers (if any are associated with the displayed items) If the height of the graph within the widget is insufficient, the legend may not be displayed or may be displayed only partially. Triggers and percentiles are hidden first, followed by the item legend. To display the full legend, increase the widget's vertical size. ::: noteclassic No more than 3 trigger lines can be displayed. If there are more triggers then the triggers with lower severity are prioritized for display. ::: While the *Columns* and *Rows* parameters allow fitting more than one graph in the widget, there still may be more discovered graphs than there are columns/rows in the widget. In this case, paging becomes available in the widget, and a slide-up header allows to switch between pages using the left and right arrows: ![](../../../../../../assets/en/manual/config/visualization/host_dashboards_discovered.png) #### Configuration To configure, select *Graph prototype* as widget type: ![](../../../../../../assets/en/manual/web_interface/frontend_sections/dashboards/widgets/graph_prototype.png) In addition to the parameters that are [common](/manual/web_interface/frontend_sections/dashboards/widgets#common-parameters) for all widgets, you may set the following specific options: | | | |--|--------| |*Source*|Select source: either a **Graph prototype** or a **Simple graph prototype**.| |*Graph prototype*|Select a graph prototype to display discovered graphs of the graph prototype.<br>This option is available if 'Graph prototype' is selected as Source.| |*Item prototype*|Select an item prototype to display simple graphs based on discovered items of an item prototype.<br>This option is available if 'Simple graph prototype' is selected as Source.| |*Show legend*|Mark this checkbox to show the legend on the graphs (marked by default).| |*[Enable host selection](/manual/web_interface/frontend_sections/dashboards#dynamic_widgets)*|Set graphs to display different data depending on the selected host.| |*Columns*|Enter the number of columns of graphs to display within a graph prototype widget.| |*Rows*|Enter the number of rows of graphs to display within a graph prototype widget.| While the *Columns* and *Rows* settings allow fitting more than one graph in the widget, there still may be more discovered graphs than there are columns/rows in the widget. In this case paging becomes available in the widget and a slide-up header allows to switch between pages using the left and right arrows. ![](../../../../../../assets/en/manual/config/visualization/host_dashboards_discovered.png) #### Configuring a *Clock* widget Configure a *Clock* widget that displays local date, time and time zone in a customized digital clock. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "clock", "name": "Clock", "x": 0, "y": 0, "width": 12, "height": 3, "view_mode": 0, "fields": [ { "type": 0, "name": "clock_type", "value": 1 }, { "type": 0, "name": "show.0", "value": 1 }, { "type": 0, "name": "show.1", "value": 2 }, { "type": 0, "name": "show.2", "value": 3 }, { "type": 1, "name": "date_color", "value": "E1E1E1" }, { "type": 0, "name": "time_bold", "value": 1 }, { "type": 1, "name": "tzone_color", "value": "E1E1E1" }, { "type": 1, "name": "tzone_timezone", "value": "Europe/Riga" }, { "type": 0, "name": "tzone_format", "value": 1 } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### تنطیم ویجت ساعت Configure a *Clock* widget that displays local date, time and time zone in a customized digital clock. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "clock", "name": "Clock", "x": 0, "y": 0, "width": 4, "height": 3, "view_mode": 0, "fields": [ { "type": 0, "name": "clock_type", "value": 1 }, { "type": 0, "name": "show", "value": 1 }, { "type": 0, "name": "show", "value": 2 }, { "type": 0, "name": "show", "value": 3 }, { "type": 0, "name": "adv_conf", "value": 1 }, { "type": 0, "name": "date_size", "value": 20 }, { "type": 1, "name": "date_color", "value": "E1E1E1" }, { "type": 0, "name": "time_bold", "value": 1 }, { "type": 0, "name": "tzone_size", "value": 10 }, { "type": 1, "name": "tzone_color", "value": "E1E1E1" }, { "type": 1, "name": "tzone_timezone", "value": "Europe/Riga" }, { "type": 0, "name": "tzone_format", "value": 1 } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### Configuring a *Favorite graphs* widget Configure a *Favorite graphs* widget with the refresh interval set to 10 minutes. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "favgraphs", "name": "Favorite graphs", "x": 0, "y": 0, "width": 12, "height": 3, "view_mode": 0, "fields": [ { "type": 0, "name": "rf_rate", "value": 600 } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### پیکربندی ویجت *نمودارهای مورد علاقه* یک ویجت *نمودارهای مورد علاقه* را با فاصله زمانی تازهسازی تنظیم شده روی ۱۰ دقیقه پیکربندی کنید.[درخواست](/manual/api#performing-requests): #### Configuring a *Favorite maps* widget Configure a *Favorite maps* widget with the refresh interval set to 10 minutes. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "favmaps", "name": "Favorite maps", "x": 0, "y": 0, "width": 12, "height": 3, "view_mode": 0, "fields": [ { "type": 0, "name": "rf_rate", "value": 600 } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### پیکربندی ویجت *نقشههای مورد علاقه* یک ویجت *نقشههای مورد علاقه* را با فاصله زمانی بهروزرسانی 10 دقیقه پیکربندی کنید.[درخواست](/manual/api#performing-requests): #### Configuring an *Action log* widget Configure an *Action log* widget that displays 10 entries of action operation details, sorted by time (in ascending order). In addition, display details only for those action operations that attempted to send an email to user "1", but were unsuccessful. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "actionlog", "name": "Action log", "x": 0, "y": 0, "width": 36, "height": 5, "view_mode": 0, "fields": [ { "type": 0, "name": "show_lines", "value": 10 }, { "type": 0, "name": "sort_triggers", "value": 3 }, { "type": 11, "name": "userids.0", "value": 1 }, { "type": 13, "name": "mediatypeids.0", "value": 1 }, { "type": 0, "name": "statuses.0", "value": 2 } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### پیکربندی ویجت *گزارش عملیات* یک ویجت *گزارش عملیات* را پیکربندی کنید که 10 ورودی از جزئیات عملیات عملیات را به ترتیب زمان (به ترتیب صعودی) نمایش دهد. علاوه بر این، جزئیات را فقط برای آن دسته از عملیاتهای عملیاتی که سعی در ارسال ایمیل به کاربر "1" داشتهاند اما ناموفق بودهاند، نمایش دهد. [درخواست](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "داشبورد من", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "actionlog", "name": "Action log", "x": 0, "y": 0, "width": 36, "height": 5, "view_mode": 0, "fields": [ { "type": 0, "name": "show_lines", "value": 10 }, { "type": 0, "name": "sort_triggers", "value": ۳ }, { "type": 11, "name": "userids.0", "value": 1 }, { "type": 13, "name": "mediatypeids.0", "value": 1 }, { "type": 0, "name": "statuses.0", "value": 2 } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "id": 1 } ``` پاسخ: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### Configuring a *Top hosts* widget Configure a *Top hosts* widget that displays top hosts by CPU utilization in host group "4". In addition, configure the following custom columns: "Host name", "CPU utilization in %", "1m avg", "5m avg", "15m avg", "Processes". [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "tophosts", "name": "Top hosts", "x": 0, "y": 0, "width": 36, "height": 5, "view_mode": 0, "fields": [ { "type": 2, "name": "groupids.0", "value": 4 }, { "type": 1, "name": "columns.0.name", "value": "Host" }, { "type": 0, "name": "columns.0.data", "value": 2 }, { "type": 1, "name": "columns.0.base_color", "value": "FFFFFF" }, { "type": 1, "name": "columns.1.name", "value": "CPU utilization in %" }, { "type": 0, "name": "columns.1.data", "value": 1 }, { "type": 1, "name": "columns.1.base_color", "value": "4CAF50" }, { "type": 1, "name": "columns.1.item", "value": "CPU utilization" }, { "type": 0, "name": "columns.1.display", "value": 3 }, { "type": 1, "name": "columns.1.min", "value": "0" }, { "type": 1, "name": "columns.1.max", "value": "100" }, { "type": 1, "name": "columnsthresholds.1.color.0", "value": "FFFF00" }, { "type": 1, "name": "columnsthresholds.1.threshold.0", "value": "50" }, { "type": 1, "name": "columnsthresholds.1.color.1", "value": "FF8000" }, { "type": 1, "name": "columnsthresholds.1.threshold.1", "value": "80" }, { "type": 1, "name": "columnsthresholds.1.color.2", "value": "FF4000" }, { "type": 1, "name": "columnsthresholds.1.threshold.2", "value": "90" }, { "type": 1, "name": "columns.2.name", "value": "1m avg" }, { "type": 0, "name": "columns.2.data", "value": 1 }, { "type": 1, "name": "columns.2.base_color", "value": "FFFFFF" }, { "type": 1, "name": "columns.2.item", "value": "Load average (1m avg)" }, { "type": 1, "name": "columns.3.name", "value": "5m avg" }, { "type": 0, "name": "columns.3.data", "value": 1 }, { "type": 1, "name": "columns.3.base_color", "value": "FFFFFF" }, { "type": 1, "name": "columns.3.item", "value": "Load average (5m avg)" }, { "type": 1, "name": "columns.4.name", "value": "15m avg" }, { "type": 0, "name": "columns.4.data", "value": 1 }, { "type": 1, "name": "columns.4.base_color", "value": "FFFFFF" }, { "type": 1, "name": "columns.4.item", "value": "Load average (15m avg)" }, { "type": 1, "name": "columns.5.name", "value": "Processes" }, { "type": 0, "name": "columns.5.data", "value": 1 }, { "type": 1, "name": "columns.5.base_color", "value": "FFFFFF" }, { "type": 1, "name": "columns.5.item", "value": "Number of processes" }, { "type": 0, "name": "columns.5.decimal_places", "value": 0 }, { "type": 0, "name": "column", "value": 1 } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### Configuring a *Top hosts* widget Configure a *Top hosts* widget that displays top hosts by CPU utilization in host group "4". In addition, configure the following custom columns: "Host name", "CPU utilization in %", "1m avg", "5m avg", "15m avg", "Processes". [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "tophosts", "name": "Top hosts", "x": 0, "y": 0, "width": 12, "height": 5, "view_mode": 0, "fields": [ { "type": 2, "name": "groupids", "value": 4 }, { "type": 1, "name": "columns.name.0", "value": "" }, { "type": 0, "name": "columns.data.0", "value": 2 }, { "type": 1, "name": "columns.base_color.0", "value": "FFFFFF" }, { "type": 1, "name": "columns.item.0", "value": "System name" }, { "type": 1, "name": "columns.timeshift.0", "value": "" }, { "type": 1, "name": "columns.name.1", "value": "CPU utilization in %" }, { "type": 0, "name": "columns.data.1", "value": 1 }, { "type": 1, "name": "columns.base_color.1", "value": "4CAF50" }, { "type": 1, "name": "columns.item.1", "value": "CPU utilization" }, { "type": 1, "name": "columns.timeshift.1", "value": "" }, { "type": 0, "name": "columns.display.1", "value": 3 }, { "type": 1, "name": "columns.min.1", "value": "0" }, { "type": 1, "name": "columns.max.1", "value": "100" }, { "type": 1, "name": "columnsthresholds.color.1.0", "value": "FFFF00" }, { "type": 1, "name": "columnsthresholds.threshold.1.0", "value": "50" }, { "type": 1, "name": "columnsthresholds.color.1.1", "value": "FF8000" }, { "type": 1, "name": "columnsthresholds.threshold.1.1", "value": "80" }, { "type": 1, "name": "columnsthresholds.color.1.2", "value": "FF4000" }, { "type": 1, "name": "columnsthresholds.threshold.1.2", "value": "90" }, { "type": 1, "name": "columns.name.2", "value": "1m avg" }, { "type": 0, "name": "columns.data.2", "value": 1 }, { "type": 1, "name": "columns.base_color.2", "value": "FFFFFF" }, { "type": 1, "name": "columns.item.2", "value": "Load average (1m avg)" }, { "type": 1, "name": "columns.timeshift.2", "value": "" }, { "type": 1, "name": "columns.name.3", "value": "5m avg" }, { "type": 0, "name": "columns.data.3", "value": 1 }, { "type": 1, "name": "columns.base_color.3", "value": "FFFFFF" }, { "type": 1, "name": "columns.item.3", "value": "Load average (5m avg)" }, { "type": 1, "name": "columns.timeshift.3", "value": "" }, { "type": 1, "name": "columns.name.4", "value": "15m avg" }, { "type": 0, "name": "columns.data.4", "value": 1 }, { "type": 1, "name": "columns.base_color.4", "value": "FFFFFF" }, { "type": 1, "name": "columns.item.4", "value": "Load average (15m avg)" }, { "type": 1, "name": "columns.timeshift.4", "value": "" }, { "type": 1, "name": "columns.name.5", "value": "Processes" }, { "type": 0, "name": "columns.data.5", "value": 1 }, { "type": 1, "name": "columns.base_color.5", "value": "FFFFFF" }, { "type": 1, "name": "columns.item.5", "value": "Number of processes" }, { "type": 1, "name": "columns.timeshift.5", "value": "" }, { "type": 0, "name": "columns.decimal_places.5", "value": 0 }, { "type": 0, "name": "column", "value": 1 } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### Configuring authentication The **Authentication** tab allows you to configure scenario authentication options. A green dot next to the tab name indicates that some type of HTTP authentication is enabled. ![](../../assets/en/manual/config/scenario_d.png) Authentication parameters: |Parameter|Description| |--|--------| |*HTTP authentication*|Select the authentication option:<br>**None** - no authentication used;<br>**Basic** - basic authentication is used;<br>**NTLM** - NTLM ([Windows NT LAN Manager](http://en.wikipedia.org/wiki/NTLM)) authentication is used;<br>**Kerberos** - Kerberos authentication is used (see also: [Configuring Kerberos with Zabbix](/manual/appendix/items/kerberos));<br>**Digest** - Digest authentication is used.| |*User*|Enter the user name (up to 255 characters).<br>This field is available if *HTTP authentication* is set to Basic, NTLM, Kerberos, or Digest. User macros are supported. | |*Password*|Enter the user password (up to 255 characters).<br>This field is available if *HTTP authentication* is set to Basic, NTLM, Kerberos, or Digest. User macros are supported. | |*SSL verify peer*|Mark the checkbox to verify the SSL certificate of the web server.<br>The server certificate will be automatically taken from system-wide certificate authority (CA) location. You can override the location of CA files using Zabbix server or proxy configuration parameter [SSLCALocation](/manual/appendix/config/zabbix_server#sslcalocation).<br>This sets the [CURLOPT\_SSL\_VERIFYPEER](http://curl.haxx.se/libcurl/c/CURLOPT_SSL_VERIFYPEER.html) cURL option.| |*SSL verify host*|Mark the checkbox to verify that the *Common Name* field or the *Subject Alternate Name* field of the web server certificate matches.<br>This sets the [CURLOPT\_SSL\_VERIFYHOST](http://curl.haxx.se/libcurl/c/CURLOPT_SSL_VERIFYHOST.html) cURL option.| |*SSL certificate file*|Name of the SSL certificate file used for client authentication. The certificate file must be in PEM^1^ format. If the certificate file contains also the private key, leave the *SSL key file* field empty. If the key is encrypted, specify the password in *SSL key password* field. The directory containing this file is specified by Zabbix server or proxy configuration parameter [SSLCertLocation](/manual/appendix/config/zabbix_server).<br>`HOST.*` macros and user macros can be used in this field.<br>This sets the [CURLOPT\_SSLCERT](http://curl.haxx.se/libcurl/c/CURLOPT_SSLCERT.html) cURL option.| |*SSL key file*|Name of the SSL private key file used for client authentication. The private key file must be in PEM^1^ format. The directory containing this file is specified by Zabbix server or proxy configuration parameter [SSLKeyLocation](/manual/appendix/config/zabbix_server).<br>`HOST.*` macros and user macros can be used in this field.<br>This sets the [CURLOPT\_SSLKEY](http://curl.haxx.se/libcurl/c/CURLOPT_SSLKEY.html) cURL option.| |*SSL key password*|SSL private key file password.<br>User macros can be used in this field.<br>This sets the [CURLOPT\_KEYPASSWD](http://curl.haxx.se/libcurl/c/CURLOPT_KEYPASSWD.html) cURL option.| ::: noteimportant \[1\] Zabbix supports certificate and private key files in PEM format only. In case you have your certificate and private key data in PKCS \#12 format file (usually with extension \*.p12 or \*.pfx) you may generate the PEM file from it using the following commands: openssl pkcs12 -in ssl-cert.p12 -clcerts -nokeys -out ssl-cert.pem openssl pkcs12 -in ssl-cert.p12 -nocerts -nodes -out ssl-cert.key ::: ::: noteclassic Zabbix server picks up changes in certificates without a restart. ::: ::: noteclassic If you have client certificate and private key in a single file just specify it in a "SSL certificate file" field and leave "SSL key file" field empty. The certificate and key must still be in PEM format. Combining certificate and key is easy: cat client.crt client.key > client.pem ::: #### تنظیم احراز هویت The **Authentication** tab allows you to configure scenario authentication options. A green dot next to the tab name indicates that some type of HTTP authentication is enabled. ![](../../assets/en/manual/config/scenario_d.png) Authentication parameters: |Parameter|Description| |--|--------| |*Authentication*|Authentication options.<br>**None** - no authentication used.<br>**Basic** - basic authentication is used.<br>**NTLM** - NTLM ([Windows NT LAN Manager)](http://en.wikipedia.org/wiki/NTLM) authentication is used.<br>**Kerberos** - Kerberos authentication is used. See also: [Configuring Kerberos with Zabbix](/manual/appendix/items/kerberos).<br>**Digest** - Digest authentication is used.<br>Selecting an authentication method will provide two additional fields for entering a user name and password.<br>User macros can be used in user and password fields.| |*SSL verify peer*|Mark the checkbox to verify the SSL certificate of the web server.<br>The server certificate will be automatically taken from system-wide certificate authority (CA) location. You can override the location of CA files using Zabbix server or proxy configuration parameter [SSLCALocation](/manual/appendix/config/zabbix_server).<br>This sets the [CURLOPT\_SSL\_VERIFYPEER](http://curl.haxx.se/libcurl/c/CURLOPT_SSL_VERIFYPEER.html) cURL option.| |*SSL verify host*|Mark the checkbox to verify that the *Common Name* field or the *Subject Alternate Name* field of the web server certificate matches.<br>This sets the [CURLOPT\_SSL\_VERIFYHOST](http://curl.haxx.se/libcurl/c/CURLOPT_SSL_VERIFYHOST.html) cURL option.| |*SSL certificate file*|Name of the SSL certificate file used for client authentication. The certificate file must be in PEM^1^ format. If the certificate file contains also the private key, leave the *SSL key file* field empty. If the key is encrypted, specify the password in *SSL key password* field. The directory containing this file is specified by Zabbix server or proxy configuration parameter [SSLCertLocation](/manual/appendix/config/zabbix_server).<br>`HOST.*` macros and user macros can be used in this field.<br>This sets the [CURLOPT\_SSLCERT](http://curl.haxx.se/libcurl/c/CURLOPT_SSLCERT.html) cURL option.| |*SSL key file*|Name of the SSL private key file used for client authentication. The private key file must be in PEM^1^ format. The directory containing this file is specified by Zabbix server or proxy configuration parameter [SSLKeyLocation](/manual/appendix/config/zabbix_server).<br>`HOST.*` macros and user macros can be used in this field.<br>This sets the [CURLOPT\_SSLKEY](http://curl.haxx.se/libcurl/c/CURLOPT_SSLKEY.html) cURL option.| |*SSL key password*|SSL private key file password.<br>User macros can be used in this field.<br>This sets the [CURLOPT\_KEYPASSWD](http://curl.haxx.se/libcurl/c/CURLOPT_KEYPASSWD.html) cURL option.| ::: noteimportant \[1\] Zabbix supports certificate and private key files in PEM format only. In case you have your certificate and private key data in PKCS \#12 format file (usually with extension \*.p12 or \*.pfx) you may generate the PEM file from it using the following commands: openssl pkcs12 -in ssl-cert.p12 -clcerts -nokeys -out ssl-cert.pem openssl pkcs12 -in ssl-cert.p12 -nocerts -nodes -out ssl-cert.key ::: ::: noteclassic Zabbix server picks up changes in certificates without a restart. ::: ::: noteclassic If you have client certificate and private key in a single file just specify it in a "SSL certificate file" field and leave "SSL key file" field empty. The certificate and key must still be in PEM format. Combining certificate and key is easy: cat client.crt client.key > client.pem ::: #### Configuring a *Web monitoring* widget Configure a *Web monitoring* widget that displays a status summary of the active web monitoring scenarios for host group "4". [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "web", "name": "Web monitoring", "x": 0, "y": 0, "width": 18, "height": 3, "view_mode": 0, "fields": [ { "type": 2, "name": "groupids.0", "value": 4 } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### Configuring a *Web monitoring* widget Configure a *Web monitoring* widget that displays a status summary of the active web monitoring scenarios for host group "4". [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "web", "name": "Web monitoring", "x": 0, "y": 0, "width": 6, "height": 3, "view_mode": 0, "fields": [ { "type": 2, "name": "groupids", "value": 4 } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### Configuring *Discovery status* widget Configure a *Discovery status* widget with the refresh interval set to 15 minutes. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "discovery", "name": "Discovery status", "x": 0, "y": 0, "width": 18, "height": 3, "view_mode": 0, "fields": [ { "type": 0, "name": "rf_rate", "value": 900 } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### پیکربندی ویجت *وضعیت اکتشاف* یک ویجت *وضعیت اکتشاف* را با فاصله زمانی رفرش ۱۵ دقیقه پیکربندی کنید.[درخواست](/manual/api#performing-requests):```json{"jsonrpc": "2.0","method": "dashboard.create","params": {"name": "داشبورد من","display_period": 30,"auto_start": 1,"pages": [{"widgets": [{"type": "discovery","name": "وضعیت اکتشاف","x": 0,"y": 0,"width": 18,"height": 3,"view_mode": 0,"fields": [{"type": 0,"name": "rf_rate","value": 900}]}]}],"userGroups": [{"usrgrpid": 7,"permission": 2}],"users": [{"userid": 1,"permission": 3}]},"id": 1}```پاسخ:```json{"jsonrpc": "2.0","result": {"dashboardids": ["3"]},"id": 1}``` #### Configuring tags The **Tags** tab allows to define scenario-level [tags](/manual/config/tagging). ![](../../assets/en/manual/config/scenario_c.png) Tagging allows to filter web scenarios and web monitoring [items](/manual/web_monitoring/items). #### تنظیم تگ ها The **Tags** tab allows to define scenario-level [tags](/manual/config/tagging). ![](../../assets/en/manual/config/scenario_c.png) Tagging allows to filter web scenarios and web monitoring [items](/manual/web_monitoring/items). # connector.create # کانکتور.ایجاد # connector.delete # کانکتور.حذف # connector.get # کانکتور.ایجاد # Connector object The following objects are directly related to the `connector` API. # > آبجکت همبستگی اشیاء زیر مستقیماً با API «همبستگی» مرتبط هستند. # Connector This class is designed to work with connectors. Object references: - [Connector](/manual/api/reference/connector/object#connector) - [Tag filter](/manual/api/reference/connector/object#tag-filter) Available methods: - [connector.create](/manual/api/reference/connector/create) - create new connectors - [connector.delete](/manual/api/reference/connector/delete) - delete connectors - [connector.get](/manual/api/reference/connector/get) - retrieve connectors - [connector.update](/manual/api/reference/connector/update) - update connectors # آیکون مپ This class is designed to work with icon maps. Object references:\ - [Icon map](/manual/api/reference/iconmap/object#icon_map) - [Icon mapping](/manual/api/reference/iconmap/object#icon_mapping) Available methods:\ - [iconmap.create](/manual/api/reference/iconmap/create) - create new icon maps - [iconmap.delete](/manual/api/reference/iconmap/delete) - delete icon maps - [iconmap.get](/manual/api/reference/iconmap/get) - retrieve icon maps - [iconmap.update](/manual/api/reference/iconmap/update) - update icon maps # connector.update متصل کننده به روز شد ### Controller Action controller workflow: 1. Check that all parameters passed in an HTTP request are valid: - Call the controller's *checkInput()* method; - Use validation rules defined in CNewValidator.php; - Call *validateInput()* method. 2. Check user permissions. 3. Prepare the data according to passed parameters: if *checkInput()* returns true, Zabbix calls the controller's *doAction()* method. 4. Prepare the **$data** array for the view. Use *CControllerResponseData* and *setResponse()* method to store response in the **$data** array. Example: ````php /** * Validate input parameters. * * @return bool */ protected function checkInput(): bool { $ret = $this->validateInput([ 'status' => 'in '.implode(',', [HOST_STATUS_MONITORED, HOST_STATUS_NOT_MONITORED]) ]); if (!$ret) { $this->setResponse(new CControllerResponseFatal()); } return $ret; } /** * Check user permissions. * * @return bool */ protected function checkPermissions() { return $this->getUserType() >= USER_TYPE_ZABBIX_ADMIN; } /** * Execute action and generate response object. */ protected function do Action(): void { $data = [ 'hosts_count' => API::Host()->get([ 'countOutput' => true, 'filter' => [ 'status' => $this->getInput('status') ] ]) ]; $this->setResponse(new CControllerResponseData($data)); } ```` ::: notetip You can view the full list of available controller classes in Zabbix [source code](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/ui/app/controllers?at=refs%2Fheads%2Frelease%2F7.4). ::: ### کنترلر گردش کار کنترلر اکشن: ۱) بررسی کنید که تمام پارامترهای ارسالی در یک درخواست HTTP معتبر باشند: - فراخوانی متد *checkInput()* کنترلر - استفاده از قوانین اعتبارسنجی تعریف شده در CNewValidator.php - فراخوانی متد *validateInput()* ۲) بررسی مجوزهای کاربر. ۳) آمادهسازی دادهها بر اساس پارامترهای ارسالی: اگر *checkInput()* مقدار true را برگرداند، زبیکس متد *doAction()* کنترلر را فراخوانی میکند. ۴) آرایه **$data** را برای نما آماده کنید. از متدهای *CControllerResponseData* و *setResponse()* برای ذخیره پاسخ در آرایه **$data** استفاده کنید. مثال: ````php /** * اعتبارسنجی پارامترهای ورودی. * * @return bool */ تابع محافظتشده checkInput(): bool { $ret = $this->validateInput([ 'status' => 'in '.implode(',', [HOST_STATUS_MONITORED, HOST_STATUS_NOT_MONITORED]) ]); if (!$ret) { $this->setResponse(new CControllerResponseFatal()); } return $ret; } /** * مجوزهای کاربر را بررسی کنید. * * @return bool */ تابع محافظتشده checkPermissions() { return $this->getUserType() >= USER_TYPE_ZABBIX_ADMIN; } /** * اجرای عملیات و تولید شیء پاسخ. */ تابع محافظتشده do Action(): void { $data = [ 'hosts_count' => API::Host()->get([ 'countOutput' => true, 'filter' => [ 'status' => $this->getInput('status') ] ]) ]; $this->setResponse(new CControllerResponseData($data)); } ```` ::: notetip شما میتوانید لیست کامل کلاسهای کنترلر موجود در Zabbix [کد منبع] را مشاهده کنید (https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/ui/app/controllers?at=refs%2Fheads%2Frelease%2F7.4). ::: ### Copyright notice Zabbix documentation is NOT distributed under the AGPL-3.0 license. Use of Zabbix documentation is subject to the following terms: You may create a printed copy of this documentation solely for your own personal use. Conversion to other formats is allowed as long as the actual content is not altered or edited in any way. You shall not publish or distribute this documentation in any form or on any media, except if you distribute the documentation in a manner similar to how Zabbix disseminates it (that is, electronically for download on a Zabbix web site) or on a USB or similar medium, provided however that the documentation is disseminated together with the software on the same medium. Any other use, such as any dissemination of printed copies or use of this documentation, in whole or in part, in another publication, requires the prior written consent from an authorized representative of Zabbix. Zabbix reserves any and all rights to this documentation not expressly granted above. ### اعلامیه کپی رایت اسناد Zabbix تحت مجوز GPL توزیع نمی شود. استفاده از اسناد Zabbix مشمول شرایط زیر است: شما می توانید یک نسخه چاپی از این اسناد را صرفاً برای استفاده شخصی خود تهیه نمایید. تبدیل به فرمت های دیگر تا جایی مجاز است که محتوای اصلی به هیچ وجه تغییر یا ویرایش نشده باشد. شما نباید این مستندات را به هیچ شکلی یا در هیچ رسانه ای منتشر یا توزیع کنید، مگر اینکه اسناد را به روشی مشابه به نحوه انتشار Zabbix (یعنی به صورت الکترونیکی برای دانلود در یک وب سایت Zabbix) یا در یک USB یا رسانه مشابه ارائه شده است، هرچند که مستندات همراه با نرم افزار منتشر شده باشند، توزیع کنید. هر گونه استفاده دیگر، مانند هر گونه انتشار نسخه چاپ شده یا استفاده از این سند، به طور کامل یا جزئی، در دیگر انتشارات، نیاز به رضایت کتبی قبلی از یک نماینده مجاز Zabbix دارد. Zabbix تمامی حقوق این مورد را برای خود محفوظ می دارد اسنادی که صریحاً در بالا ارائه نشده است. ### Copyright notice Zabbix documentation is NOT distributed under the AGPL-3.0 license. Use of Zabbix documentation is subject to the following terms: You may create a printed copy of this documentation solely for your own personal use. Conversion to other formats is allowed as long as the actual content is not altered or edited in any way. You shall not publish or distribute this documentation in any form or on any media, except if you distribute the documentation in a manner similar to how Zabbix disseminates it (that is, electronically for download on a Zabbix web site) or on a USB or similar medium, provided however that the documentation is disseminated together with the software on the same medium. Any other use, such as any dissemination of printed copies or use of this documentation, in whole or in part, in another publication, requires the prior written consent from an authorized representative of Zabbix. Zabbix reserves any and all rights to this documentation not expressly granted above. ### اطلاعیه حق نشر مستندات Zabbix تحت مجوز AGPL-3.0 توزیع نمی‌شود. استفاده از مستندات Zabbix تابع شرایط زیر است: شما می‌توانید یک نسخه چاپی از این مستندات را صرفاً برای استفاده شخصی خود ایجاد کنید. تبدیل به فرمت‌های دیگر تا زمانی که محتوای اصلی به هیچ وجه تغییر یا ویرایش نشود، مجاز است. شما نباید این مستندات را به هیچ شکلی یا در هیچ رسانه‌ای منتشر یا توزیع کنید، مگر اینکه مستندات را به روشی مشابه نحوه انتشار Zabbix (یعنی به صورت الکترونیکی برای دانلود در وب‌سایت Zabbix) یا روی USB یا رسانه مشابه توزیع کنید، البته به شرطی که مستندات به همراه نرم‌افزار در همان رسانه منتشر شوند. هرگونه استفاده دیگر، مانند هرگونه انتشار نسخه‌های چاپی یا استفاده از این مستندات، به طور کامل یا جزئی، در انتشار دیگری، نیاز به رضایت کتبی قبلی از نماینده مجاز Zabbix دارد. زبیکس هرگونه حقی را در مورد این مستندات که صراحتاً در بالا اعطا نشده است، برای خود محفوظ می‌دارد. #### Copyright notice Zabbix documentation is NOT distributed under the AGPL-3.0 license. Use of Zabbix documentation is subject to the following terms: You may create a printed copy of this documentation solely for your own personal use. Conversion to other formats is allowed as long as the actual content is not altered or edited in any way. You shall not publish or distribute this documentation in any form or on any media, except if you distribute the documentation in a manner similar to how Zabbix disseminates it (that is, electronically for download on a Zabbix web site) or on a USB or similar medium, provided however that the documentation is disseminated together with the software on the same medium. Any other use, such as any dissemination of printed copies or use of this documentation, in whole or in part, in another publication, requires the prior written consent from an authorized representative of Zabbix. Zabbix reserves any and all rights to this documentation not expressly granted above. ### اطلاعیه حق نشر مستندات Zabbix تحت مجوز AGPL-3.0 توزیع نمی‌شود. استفاده از مستندات Zabbix تابع شرایط زیر است: شما می‌توانید یک نسخه چاپی از این مستندات را صرفاً برای استفاده شخصی خود ایجاد کنید. تبدیل به فرمت‌های دیگر تا زمانی که محتوای اصلی به هیچ وجه تغییر یا ویرایش نشود، مجاز است. شما نباید این مستندات را به هیچ شکلی یا در هیچ رسانه‌ای منتشر یا توزیع کنید، مگر اینکه مستندات را به روشی مشابه نحوه انتشار Zabbix (یعنی به صورت الکترونیکی برای دانلود در وب‌سایت Zabbix) یا روی USB یا رسانه مشابه توزیع کنید، البته به شرطی که مستندات به همراه نرم‌افزار در همان رسانه منتشر شوند. هرگونه استفاده دیگر، مانند هرگونه انتشار نسخه‌های چاپی یا استفاده از این مستندات، به طور کامل یا جزئی، در انتشار دیگری، نیاز به رضایت کتبی قبلی از نماینده مجاز Zabbix دارد. Zabbix هرگونه و تمام حقوقی را که صراحتاً در بالا اعطا نشده است، برای این مستندات محفوظ می‌دارد. # Copyright notice Zabbix documentation is NOT distributed under the AGPL-3.0 license. Use of Zabbix documentation is subject to the following terms: You may create a printed copy of this documentation solely for your own personal use. Conversion to other formats is allowed as long as the actual content is not altered or edited in any way. You shall not publish or distribute this documentation in any form or on any media, except if you distribute the documentation in a manner similar to how Zabbix disseminates it (that is, electronically for download on a Zabbix web site) or on a USB or similar medium, provided however that the documentation is disseminated together with the software on the same medium. Any other use, such as any dissemination of printed copies or use of this documentation, in whole or in part, in another publication, requires the prior written consent from an authorized representative of Zabbix. Zabbix reserves any and all rights to this documentation not expressly granted above. ##### اطلاعیه حق نشر مستندات Zabbix تحت مجوز AGPL-3.0 توزیع نمیشوند. استفاده از مستندات Zabbix تابع شرایط زیر است: میتوانید یک نسخه چاپی از این مستندات را صرفاً برای استفاده شخصی خود تهیه کنید. تبدیل به فرمتهای دیگر مجاز است، به شرطی که محتوای واقعی به هیچ وجه تغییر یا ویرایش نشود. نمیتوانید این مستندات را به هیچ شکلی یا در هیچ رسانهای منتشر یا توزیع کنید، مگر اینکه مستندات را به روشی مشابه با نحوه توزیع Zabbix (یعنی به صورت الکترونیکی برای دانلود در وبسایت Zabbix) یا روی USB یا رسانه مشابه توزیع کنید، با این شرط که مستندات همراه با نرمافزار روی همان رسانه توزیع شوند. هر گونه استفاده دیگر، مانند توزیع نسخههای چاپی یا استفاده از این مستندات به طور کامل یا جزئی در نشریه دیگری، نیازمند موافقت کتبی قبلی از یک نماینده مجاز Zabbix است. Zabbix هرگونه و تمام حقوق مربوط به این مستندات را که در بالا به طور صریح اعطا نشده است، برای خود محفوظ میدارد. # correlation.create # ایجاد همبستگی # correlation.delete # correlation.delete # correlation.get # correlation.get # Correlation object The following objects are directly related to the `correlation` API. # > آبجکت همبستگی اشیاء زیر مستقیماً با API «همبستگی» مرتبط هستند. # correlation.update # correlation.update #### Create a discovery action Create a discovery action that will link template "10001" to discovered hosts. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "action.create", "params": { "name": "Discovery action", "eventsource": 1, "filter": { "evaltype": 0, "conditions": [ { "conditiontype": 21, "operator": 0, "value": "1" }, { "conditiontype": 10, "operator": 0, "value": "2" } ] }, "operations": [ { "operationtype": 6, "optemplate": [ { "templateid": "10001" } ] } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "actionids": [ "18" ] }, "id": 1 } ``` #### ساخت اکشن جست وجو اقدامی ایجاد کنید که میزبان های کشف شده را به الگوی "10091" پیوند دهد. درخواست: ``json { "jsonrpc": "2.0"، "روش": "اقدام. ایجاد"، "params": { "name": "اقدام کشف"، "منبع رویداد": 1، "وضعیت": 0، "فیلتر": { "evaltype": 0، "شرایط": [ { "شرایط نوع": 21، "اپراتور": 0، "ارزش": "1" }، { "شرایط نوع": 10، "اپراتور": 0، "ارزش": "2" } ] }، "عملیات": [ { "نوع عملیات": 6، "نمونه": [ { "templateid": "10091" } ] } ] }، "auth": "038e1d7b1735c6a5436ee9eae095879e"، "id": 1 } ``` واکنش: ``json { "jsonrpc": "2.0"، "نتیجه": { "actionids": [ "18" ] }، "id": 1 } ``` #### Create agent autoregistration rule Create an autoregistration action that adds a host to host group "2" when the host name contains "SRV" or metadata contains "AlmaLinux". [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "action.create", "params": { "name": "Register Linux servers", "eventsource": "2", "filter": { "evaltype": "2", "conditions": [ { "conditiontype": "22", "operator": "2", "value": "SRV" }, { "conditiontype": "24", "operator": "2", "value": "AlmaLinux" } ] }, "operations": [ { "operationtype": "4", "opgroup": [ { "groupid": "2" } ] } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "actionids": [ 19 ] }, "id": 1 } ``` #### ساخت قانون ثبت خودکار ایجنت وقتی نام میزبان حاوی "SRV" یا متادیتا حاوی "AlmaLinux" باشد یک میزبان به گروه میزبان "سرورهای لینوکس" اضافه کنید. درخواست: ``json { "jsonrpc": "2.0"، "روش": "اقدام. ایجاد"، "params": { "name": "ثبت سرورهای لینوکس"، "منبع رویداد": "2"، "وضعیت": "0"، "فیلتر": { "evaltype": "2"، "شرایط": [ { "conditiontype": "22"، "اپراتور": "2"، "value": "SRV" }، { "conditiontype": "24"، "اپراتور": "2"، "value": "AlmaLinux" } ] }، "عملیات": [ { "نوع عملیات": "4"، "opgroup": [ { "گروهی": "2" } ] } ] }، "auth": "038e1d7b1735c6a5436ee9eae095879e"، "id": 1 } ``` واکنش: ``json { "jsonrpc": "2.0"، "نتیجه": { "actionids": [ 19 ] }، "id": 1 } ``` #### Create agent autoregistration rule with host tags Create an autoregistration action that adds a host to host group "2" and adds two host tags. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "action.create", "params": { "name": "Register Linux servers with tags", "eventsource": "2", "operations": [ { "operationtype": "4", "opgroup": [ { "groupid": "2" } ] }, { "operationtype": "13", "optag": [ { "tag": "location", "value": "office" }, { "tag": "city", "value": "Riga" } ] } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "actionids": [ 20 ] }, "id": 1 } ``` #### ایجاد قانون ثبتنام خودکار (autoregistration) با برچسبهای میزبان ایجاد یک اقدام (action) ثبتنام خودکار که یک میزبان را به گروه میزبان "2" اضافه میکند و دو برچسب میزبان اضافه مینماید. [درخواست](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "action.create", "params": { "name": "ثبت سرورهای لینوکس با برچسبها", "eventsource": "2", "operations": [ { "operationtype": "4", "opgroup": [ {"groupid": "2"} ] }, { "operationtype": "13", "optag": [ {"tag": "location", "value": "office"}, {"tag": "city", "value": "Riga"} ] } ] }, "id": 1 } ``` پاسخ: ```json { "jsonrpc": "2.0", "result": { "actionids": [20] }, "id": 1 } ``` #### Create a host map Create a map with two host elements and a link between them. Note the use of temporary "selementid1" and "selementid2" values in the map link object to refer to map elements. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "map.create", "params": { "name": "Host map", "width": 600, "height": 600, "selements": [ { "selementid": "1", "elements": [ {"hostid": "1033"} ], "elementtype": 0, "iconid_off": "2" }, { "selementid": "2", "elements": [ {"hostid": "1037"} ], "elementtype": 0, "iconid_off": "2" } ], "links": [ { "selementid1": "1", "selementid2": "2" } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "sysmapids": [ "9" ] }, "id": 1 } ``` #### ایجاد یک نقشه میزبانیک نقشه با دو عنصر میزبان و یک پیوند بین آنها ایجاد کنید. به استفاده از مقادیر موقت "selementid1" و "selementid2" در شیء link نقشه برای ارجاع به عناصر نقشه توجه کنید.[Request](/manual/api#performing-requests):```json{"jsonrpc": "2.0","method": "map.create","params": {"name": "Host map","width": 600,"height": 600,"selements": [{"selementid": "1","elements": [{"hostid": "1033"}],"elementtype": 0,"iconid_off": "2"},{"selementid": "2","elements": [{"hostid": "1037"}],"elementtype": 0,"iconid_off": "2"}],"links": [{"selementid1": "1","selementid2": "2"}]},"id": 1}```پاسخ:```json{"jsonrpc": "2.0","result": {"sysmapids": ["9"]},"id": 1}``` # Create a module (tutorial) # ایجاد یک ماژول (آموزش) #### Create an empty map Create a map with no elements. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "map.create", "params": { "name": "Map", "width": 600, "height": 600 }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "sysmapids": [ "8" ] }, "id": 1 } ``` #### حذف چندین کانکتور دو ورودی کانکتور را حذف کنید. [درخواست](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "connector.delete", "params": [ 3, 5 ], "id": 1 } ``` پاسخ: ```json { "jsonrpc": "2.0", "result": { "connectorids": [ "3", "5" ] }, "id": 1 } ``` # Create a plugin (tutorial) This is a step-by-step tutorial on how to create a simple loadable plugin for Zabbix agent 2. You can also use the [example repository](https://git.zabbix.com/projects/AP/repos/example/browse) as a template or guide for creating your own plugins. # ایجاد یک افزونه (آموزش) این یک آموزش گام به گام در مورد نحوه ایجاد یک افزونه ساده قابل بارگذاری برای Zabbix agent 2 است. همچنین میتوانید از [مخزن نمونه](https://git.zabbix.com/projects/AP/repos/example/browse) به عنوان الگو یا راهنما برای ایجاد افزونههای خود استفاده کنید. #### Create a trigger action Create a trigger action that will begin once a trigger (with the word "memory" in its name) from host "10084" goes into a PROBLEM state. The action will have 4 configured operations. The first and immediate operation will send a message to all users in user group "7" via media type "1". If the event is not resolved in 30 minutes, the second operation will run [script](/manual/web_interface/frontend_sections/alerts/scripts#configuring-a-global-script) "5" (script with scope "Action operation") on all hosts in group "2". If the event is resolved, a recovery operation will notify all users who received any messages regarding the problem. If the event is updated, an acknowledge/update operation will notify (with a custom subject and message) all users who received any messages regarding the problem. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "action.create", "params": { "name": "Trigger action", "eventsource": 0, "esc_period": "30m", "filter": { "evaltype": 0, "conditions": [ { "conditiontype": 1, "operator": 0, "value": "10084" }, { "conditiontype": 3, "operator": 2, "value": "memory" } ] }, "operations": [ { "operationtype": 0, "esc_step_from": 1, "esc_step_to": 1, "opmessage_grp": [ { "usrgrpid": "7" } ], "opmessage": { "default_msg": 1, "mediatypeid": "1" } }, { "operationtype": 1, "esc_step_from": 2, "esc_step_to": 2, "opconditions": [ { "conditiontype": 14, "operator": 0, "value": "0" } ], "opcommand_grp": [ { "groupid": "2" } ], "opcommand": { "scriptid": "5" } } ], "recovery_operations": [ { "operationtype": "11", "opmessage": { "default_msg": 1 } } ], "update_operations": [ { "operationtype": "12", "opmessage": { "default_msg": 0, "message": "Custom update operation message body", "subject": "Custom update operation message subject" } } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "actionids": [ "17" ] }, "id": 1 } ``` #### ساخت تریگر یک عمل ایجاد کنید که زمانی که یک ماشه از میزبان "10084" اجرا می شود کلمه "حافظه" را در نام خود دارد به حالت مشکل می رود. عمل ابتدا باید برای همه کاربران گروه کاربری "7" پیام ارسال کند. اگر رویداد در 4 دقیقه حل نمی شود، اسکریپت "3" را در همه میزبان ها اجرا می کند گروه "2". در بازیابی ماشه به همه کاربرانی که هر کدام را دریافت کردهاند اطلاع میدهد پیام های مربوط به مشکل قبلی در بهروزرسانی ماشه، پیام با موضوع و بدنه سفارشی برای همه کسانی که تقدیرنامه و نظرات از طریق انواع رسانه ها درخواست: ``json { "jsonrpc": "2.0"، "روش": "اقدام. ایجاد"، "params": { "name": "عمل ماشه"، "منبع رویداد": 0، "وضعیت": 0، "esc_period": "2m"، "فیلتر": { "evaltype": 0، "شرایط": [ { "شرایط نوع": 1، "اپراتور": 0، "value": "10084" }، { "شرایط نوع": 3، "اپراتور": 2، "ارزش": "حافظه" } ] }، "عملیات": [ { "نوع عملیات": 0، "esc_period": "0s"، "esc_step_from": 1، "esc_step_to": 2، "evaltype": 0، "opmessage_grp": [ { "usrgrpid": "7" } ]، "opmessage": { "default_msg": 1، "mediatypeid": "1" } }، { "نوع عملیات": 1، "esc_step_from": 3، "esc_step_to": 4، "evaltype": 0، "شرایط": [ { "شرایط نوع": 14، "اپراتور": 0، "ارزش": "0" } ]، "opcommand_grp": [ { "گروهی": "2" } ]، "opcommand": { "scriptid": "3" } } ]، "بازیابی_عملیات": [ { "نوع عملیات": "11"، "opmessage": { "default_msg": 1 } } ]، "update_operations": [ { "نوع عملیات": "12"، "opmessage": { "default_msg": 0، "پیام": "بدنه پیام عملیات به روز رسانی سفارشی"، "موضوع": "موضوع پیام عملیات به روز رسانی سفارشی" } } ]، "pause_suppressed": "0"، "notify_if_cancelled": "0" }، "auth": "038e1d7b1735c6a5436ee9eae095879e"، "id": 1 } ``` واکنش: ``json { "jsonrpc": "2.0"، "نتیجه": { "actionids": [ "17" ] }، "id": 1 } ``` #### Create a trigger map Create a map with trigger element, which contains two triggers. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "map.create", "params": { "name": "Trigger map", "width": 600, "height": 600, "selements": [ { "elements": [ {"triggerid": "12345"}, {"triggerid": "67890"} ], "elementtype": 2, "iconid_off": "2" } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "sysmapids": [ "10" ] }, "id": 1 } ``` #### ایجاد یک نقشه ماشه یک نقشه با عنصر ماشه ایجاد کنید که شامل دو ماشه باشد.[درخواست](/manual/api#performing-requests):```json{"jsonrpc": "2.0","method": "map.create","params": {"name": "نقشه ماشه","width": 600,"height": 600,"selements": [{"elements": [{"triggerid": "12345"},{"triggerid": "67890"}],"elementtype": 2,"iconid_off": "2"}]},"id": 1}```Response:```json{"jsonrpc": "2.0","result": {"sysmapids": ["10"]},"id": 1}```` # Create a widget (tutorial) # ایجاد یک ویجت (آموزش) #### Creating a connector Create a connector to export trigger events with a tag filter. HTTP authentication will be performed using Bearer token. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "connector.create", "params": [ { "name": "Export of events", "data_type": 1, "url": "{$DATA_EXPORT_URL}", "authtype": 5, "token": "{$DATA_EXPORT_BEARER_TOKEN}", "tags": [ { "tag": "service", "operator": 0, "value": "mysqld" } ] } ], "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "connectorid": [ "3" ] }, "id": 1 } ``` #### ایجاد یک رابط یک رابط برای خروجی گرفتن از رویدادهای تریگر با فیلتر برچسب ایجاد کنید. احراز هویت HTTP با استفاده از توکن Bearer انجام خواهد شد. [درخواست](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "connector.create", "params": [ { "name": "خروجی رویدادها", "data_type": 1, "url": "{$DATA_EXPORT_URL}", "authtype": 5, "token": "{$DATA_EXPORT_BEARER_TOKEN}", "tags": [ { "tag": "service", "operator": 0, "value": "mysqld" } ] } ], "id": 1 } ``` پاسخ: ```json { "jsonrpc": "2.0", "result": { "connectorid": [ "3" ] }, "id": 1 } ``` ## Creating a node A node is a self-contained Zabbix instance running in a dedicated cloud environment. Nodes provide: - Zabbix server and frontend accessible via a unique URL - Dedicated compute resources (CPU, memory) and disk storage - Isolation from other nodes, so you can test, monitor, or upgrade independently - Region-based deployment for data sovereignty and latency optimization To create a node: 1\. Click *Create New Node* in *All organizations* page. 2\. In the *Create New Node* window, configure the following: - Name - enter a display name for your node. After creation, this name appears as a clickable link in the organization list, taking you to that node frontend. - Region - select the data-center location closest to the systems you monitor or the end users of your service. Choosing a nearby region reduces network latency; also consider data-sovereignty requirements if you collect sensitive metrics. - Compute tier - pick the resource level (CPU, memory) that matches your expected load. To determine what level of resources you need, see [pricing details](https://www.zabbix.com/cloud#pricing). You can always upgrade later if you need more power. - Disk size - the slider defaults to a recommended minimum based on tier. Increase it if you store large volumes of history or trends. Be aware that larger disks incur higher monthly costs and that you cannot shrink a disk yourself—you'd need to contact support to reduce it. Optionally, enable a 5-day free trial before creating the node. Enabling the trial lets you evaluate Zabbix Cloud at no cost and it does not require billing information. You will not be charged during the trial period, but once it ends, your node will expire and be removed if not converted to a paid node. A billing method will be required before creating a non-trial node. Add billing information via the *Billing* menu. ![](../../assets/en/cloud/quickstart/create_node.png){width="600"} After creation, the node will appear in the organization view: ![](../../assets/en/cloud/quickstart/node_starting.png){width="600"} Once your node is running, see [Node configuration](/cloud/node_configuration) for details on managing its settings (access filters, encryption, backups, etc.). ![](../../assets/en/cloud/quickstart/node_running.png){width="600"} After the node is initialized, its status changes from *Initializing* to *Running*, and you can log in to Zabbix frontend on your node. ## ایجاد یک گره یک گره یک نمونه مستقل زبیکس است که در یک محیط ابری اختصاصی اجرا می‌شود. گره‌ها موارد زیر را ارائه می‌دهند: - سرور زبیکس و frontend از طریق یک URL منحصر به فرد قابل دسترسی هستند. - منابع محاسباتی اختصاصی (CPU، حافظه) و فضای ذخیره‌سازی دیسک - جداسازی از سایر گره‌ها، بنابراین می‌توانید به طور مستقل آزمایش، نظارت یا ارتقا دهید. - استقرار مبتنی بر منطقه برای حاکمیت داده‌ها و بهینه‌سازی تأخیر برای ایجاد یک گره: 1\. روی *ایجاد گره جدید* در صفحه *همه سازمان‌ها* کلیک کنید. 2\. در پنجره *ایجاد گره جدید*، موارد زیر را پیکربندی کنید: - نام - یک نام نمایشی برای گره خود وارد کنید. پس از ایجاد، این نام به عنوان یک لینک قابل کلیک در لیست سازمان ظاهر می‌شود و شما را به frontend آن گره می‌برد. - منطقه - نزدیکترین مکان مرکز داده به سیستم‌هایی که مانیتور می‌کنید یا کاربران نهایی سرویس شما را انتخاب کنید. انتخاب یک منطقه نزدیک، تأخیر شبکه را کاهش می‌دهد. همچنین در صورت جمع‌آوری معیارهای حساس، الزامات حاکمیت داده‌ها را در نظر بگیرید. - سطح محاسبات - سطح منابع (CPU، حافظه) را که با بار مورد انتظار شما مطابقت دارد، انتخاب کنید. برای تعیین سطح منابع مورد نیاز، به [جزئیات قیمت‌گذاری] (https://www.zabbix.com/cloud#pricing) مراجعه کنید. در صورت نیاز به قدرت بیشتر، همیشه می‌توانید بعداً ارتقا دهید. - اندازه دیسک - نوار لغزنده بر اساس سطح، به طور پیش‌فرض روی حداقل توصیه شده قرار دارد. اگر حجم زیادی از تاریخچه یا روندها را ذخیره می‌کنید، آن را افزایش دهید. توجه داشته باشید که دیسک‌های بزرگتر هزینه‌های ماهانه بالاتری دارند و شما نمی‌توانید خودتان یک دیسک را کوچک کنید - برای کاهش آن باید با پشتیبانی تماس بگیرید. به صورت اختیاری، قبل از ایجاد گره، یک دوره آزمایشی رایگان 5 روزه را فعال کنید. فعال کردن دوره آزمایشی به شما امکان می‌دهد Zabbix Cloud را بدون هیچ هزینه‌ای ارزیابی کنید و نیازی به اطلاعات صورتحساب ندارد. در طول دوره آزمایشی هزینه‌ای از شما دریافت نمی‌شود، اما پس از پایان دوره، گره شما منقضی شده و در صورت عدم تبدیل به یک گره پولی، حذف می‌شود. قبل از ایجاد یک گره غیر آزمایشی، یک روش صورتحساب مورد نیاز خواهد بود. اطلاعات صورتحساب را از طریق منوی *صورتحساب* اضافه کنید. ![](../../assets/en/cloud/quickstart/create_node.png){width="600"} پس از ایجاد، گره در نمای سازمان ظاهر می‌شود: ![](../../assets/en/cloud/quickstart/node_starting.png){width="600"} پس از اجرای گره، برای جزئیات مربوط به مدیریت تنظیمات آن (فیلترهای دسترسی، رمزگذاری، پشتیبان‌گیری و غیره) به [Node configuration](/cloud/node_configuration) مراجعه کنید. ![](../../assets/en/cloud/quickstart/node_running.png){width="600"} پس از مقداردهی اولیه گره، وضعیت آن از *در حال مقداردهی اولیه* به *در حال اجرا* تغییر می‌کند و می‌توانید در گره خود به رابط کاربری زبیکس وارد شوید. ##### CSS styles CSS files may contain a custom attribute `theme` to define different style for a specific frontend themes. Available themes and their attribute values: - **Blue** - [theme='blue-theme'] - **Dark** - [theme='dark-theme'] - **High-contrast light** - [theme='hc-light'] - **High-contrast dark** - [theme='hc-dark'] Example: ```css .widget { background-color: red; } [theme='dark-theme'] .widget { background-color: green; } ``` ##### سبکهای CSS فایلهای CSS ممکن است حاوی یک ویژگی سفارشی `theme` باشند تا سبک متفاوتی را برای یک تم خاص frontend تعریف کنند. تمهای موجود و مقادیر ویژگی آنها: - **آبی** - [theme='blue-theme'] - **تیره** - [theme='dark-theme'] - **روشنایی با کنتراست بالا** - [theme='hc-light'] - **تیرگی با کنتراست بالا** - [theme='hc-dark'] مثال: ```css .widget { background-color: red; } [theme='dark-theme'] .widget { background-color: green; } ```` ##### Custom multiplier {#multiplier} Multiply the value by the specified integer or floating-point value. Comments: - Use this option to convert values received in KB, MBps, etc., into B, Bps. Otherwise, Zabbix cannot correctly set [prefixes](/manual/appendix/suffixes) (K, M, G, etc.).<br> - Note that if the item type of information is *Numeric (unsigned)*, incoming values with a fractional part will be trimmed (i.e., '0.9' will become '0') before the custom multiplier is applied;<br> - If you use a custom multiplier or store value as *Change per second* for items with the type of information set to *Numeric (unsigned)* and the resulting calculated value is actually a float number, the calculated value is still accepted as a correct one by trimming the decimal part and storing the value as an integer;<br> - Supported: scientific notation, for example, `1e+70`; user macros and LLD macros; strings that include macros, for example, `{#MACRO}e+10`, `{$MACRO1}e+{$MACRO2}`. The macros must resolve to an integer or a floating-point number. - If you mark the *Custom on fail* checkbox, it is possible to specify custom error-handling options: either to discard the value, set a specified value, or set a specified error message. In case of a failed preprocessing step, the item will not become unsupported if the option to discard the value or set a specified value is selected. ##### ضربکننده سفارشی {#multiplier}مقدار را در مقدار صحیح یا ممیز شناور مشخص شده ضرب کنید. توضیحات:-از این گزینه برای تبدیل مقادیر دریافتی بر حسب کیلوبایت، مگابایت بر ثانیه و غیره به B، Bps استفاده کنید. در غیر این صورت، زبیکس نمیتواند [پیشوندها](/manual/appendix/suffixes) (K، M، G و غیره) را به درستی تنظیم کند.<br>-توجه داشته باشید که اگر نوع اطلاعات آیتم *عددی (بدون علامت)* باشد، مقادیر ورودی با بخش کسری قبل از اعمال ضربکننده سفارشی، حذف میشوند (یعنی '0.9' به '0' تبدیل میشود).<br>-اگر از یک ضربکننده سفارشی استفاده میکنید یا مقدار را به عنوان *تغییر در ثانیه* برای آیتمهایی با نوع اطلاعات تنظیم شده روی *عددی (بدون علامت)* ذخیره میکنید و مقدار محاسبه شده حاصل در واقع یک عدد اعشاری است، مقدار محاسبه شده همچنان با حذف بخش اعشاری و ذخیره مقدار به عنوان یک عدد صحیح پذیرفته میشود. عدد صحیح؛<br>-پشتیبانیشده: نمادگذاری علمی، برای مثال، `1e+70`؛ ماکروهای کاربر و ماکروهای LLD؛ رشتههایی که شامل ماکرو هستند، برای مثال، `{#MACRO}e+10`، `{$MACRO1}e+{$MACRO2}`. ماکروها باید به یک عدد صحیح یا یک عدد اعشاری تبدیل شوند.-اگر کادر *سفارشی در صورت عدم موفقیت* را علامت بزنید، میتوانید گزینههای سفارشی برای مدیریت خطا را مشخص کنید: یا مقدار را حذف کنید، یک مقدار مشخص را تنظیم کنید یا یک پیام خطای مشخص را تنظیم کنید. در صورت شکست یک مرحله پیشپردازش، اگر گزینه حذف مقدار یا تنظیم یک مقدار مشخص انتخاب شود، مورد پشتیبانی نشده باقی میماند. ##### Custom scripts The following custom script types are not supported by Zabbix Cloud: - Alert scripts (`AlertScriptsPath`) - External scripts (`ExternalScripts`) - Frontend scripts on Zabbix Server Community-developed frontend modules cannot be installed. ### اسکریپتهای سفارشی انواع اسکریپتهای سفارشی زیر در Zabbix Cloud پشتیبانی نمیشوند: - اسکریپتهای هشدار (`AlertScriptsPath`) - اسکریپتهای خارجی (`ExternalScripts`) - اسکریپتهای Frontend در ماژولهای frontend توسعهیافته توسط Zabbix ServerCommunity قابل نصب نیستند. ### CWidgetFormView The *CWidgetFormView* class is required for specifying the presentation logic of the fields defined in the *WidgetForm* class, determining their appearance and behavior when rendered in the configuration view. The *CWidgetFormView* class supports the following methods: - *addField()* - receives an instance of the *CWidgetFieldView* class as a parameter; each [*CWidgetField*](#cwidgetfield) class, has a respective *CWidgetFieldView* class for using in the widget configuration view. - *addFieldset()* - receives an instance of the *CWidgetFieldsGroupView* class that combines fields into a collapsible container. - *addFieldsGroup()* - receives an instance of *CWidgetFormFieldsetCollapsibleView* that visually (with a border) combines fields into a group. - *includeJsFile()* - allows to add a JavaScript file to the widget configuration view. - *addJavaScript()* - allows to add inline JavaScript that will be executed as soon as the widget configuration view is loaded. The *CWidgetFormView* class should be located in the *views* directory. **views/widget.edit.php example** ```php <?php /** * My custom widget form view. * * @var CView $this * @var array $data */ use Modules\MyCustomWidget\Includes\WidgetForm; (new CWidgetFormView($data)) ->addField( (new CWidgetFieldMultiSelectItemView($data['fields']['itemid']))->setPopupParameter('numeric', true) ) ->addFieldset( (new CWidgetFormFieldsetCollapsibleView(_('Advanced configuration'))) ->addField( new CWidgetFieldTextBoxView($data['fields']['description']) ) ->addField( new CWidgetFieldColorView($data['fields']['chart_color']) ) ) ->includeJsFile('widget.edit.js.php') ->addJavaScript('my_custom_widget_form.init('.json_encode([ 'color_palette' => WidgetForm::DEFAULT_COLOR_PALETTE ]).');') ->show(); ``` ### CWidgetFormView کلاس *CWidgetFormView* برای مشخص کردن منطق نمایش فیلدهای تعریف شده در کلاس *WidgetForm* مورد نیاز است، و ظاهر و رفتار آنها را هنگام رندر شدن در نمای پیکربندی تعیین میکند. کلاس *CWidgetFormView* از متدهای زیر پشتیبانی میکند: - *addField()* - یک نمونه از کلاس *CWidgetFieldView* را به عنوان پارامتر دریافت میکند؛ هر کلاس [*CWidgetField*](#cwidgetfield) دارای یک کلاس *CWidgetFieldView* مربوط به خود برای استفاده در نمای پیکربندی ویجت است. - *addFieldset()* - یک نمونه از کلاس *CWidgetFieldsGroupView* را دریافت میکند که فیلدها را در یک ظرف قابل جمع شدن ترکیب میکند. - *addFieldsGroup()* - یک نمونه از *CWidgetFormFieldsetCollapsibleView* دریافت میکند که به صورت بصری (با یک حاشیه) فیلدها را در یک گروه ترکیب میکند. *includeJsFile()* - امکان اضافه کردن یک فایل جاوا اسکریپت به نمای پیکربندی ویجت را فراهم میکند. *addJavaScript()* - امکان اضافه کردن جاوا اسکریپت درونخطی را فراهم میکند که به محض بارگذاری نمای پیکربندی ویجت اجرا میشود. کلاس *CWidgetFormView* باید در دایرکتوری *views* قرار داشته باشد. **views/widget.edit.php example** ```php <?php /** * نمای فرم ویجت سفارشی من. * * @var CView $this * @var array $data use Modules\MyCustomWidget\Includes\WidgetForm; (new CWidgetFormView($data)) ->addField( (new CWidgetFieldMultiSelectItemView($data['fields']['itemid']))->setPopupParameter('numeric', true) ) ->addFieldset( (new CWidgetFormFieldsetCollapsibleView(_('پیکربندی پیشرفته'))) ->addField( new CWidgetFieldTextBoxView($data['fields']['description']) ) ->addField( new CWidgetFieldColorView($data['fields']['chart_color']) ) ) ->includeJsFile('widget.edit.js.php') ->addJavaScript('my_custom_widget_form.init('.json_encode([ 'color_palette' => WidgetForm::DEFAULT_COLOR_PALETTE ]).');') ->show(); ``` # dashboard.create ساخت داشبورد # dashboard.delete حذف داشبورد # dashboard.get # دریافت داشبورد # Dashboard object The following objects are directly related to the `dashboard` API. # > اجزا داشبورد آبجکت های زیر مستقیما به API داشبورد مرتبط می شوند . #### Dashboards Manage dashboards and make scheduled reports based on them. [Dashboard API](/manual/api/reference/dashboard) | [Template dashboard API](/manual/api/reference/templatedashboard) | [Report API](/manual/api/reference/report) #### داشبوردها داشبوردها را مدیریت کنید و بر اساس آنها گزارشهای زمانبندیشده تهیه کنید.[Dashboard API](/manual/api/reference/dashboard) | [Template dashboardAPI](/manual/api/reference/templatedashboard) | [ReportAPI](/manual/api/reference/report) # dashboard.update به روز رسانی داشبورد #### dashboard [ZBXNEXT-10143](https://support.zabbix.com/browse/ZBXNEXT-10143) Added new dashboard widget field `highlight_row` in [problems](/manual/api/reference/dashboard/widget_fields/problems) widget. #### داشبورد [ZBXNEXT-10143](https://support.zabbix.com/browse/ZBXNEXT-10143) فیلد ویجت داشبورد جدید `highlight_row` در ویجت [مشکلات (problems)](/manual/api/reference/dashboard/widget_fields/problems) اضافه شد. ## Data collection The Zabbix API allows you to manage the configuration of your monitoring system. ## جمعآوری دادهها API زبیکس به شما امکان میدهد پیکربندی سیستم مانیتورینگ خود را مدیریت کنید. ##### Date The following advanced configuration parameters are supported if *Clock type* is set to "Digital", and *Show* is set to "Date". |Parameter|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-----|-|-----|-------------------| |*Bold*|0|date_bold|0 - *(default)* Disabled;<br>1 - Enabled.| |*Color*|1|date_color|Hexadecimal color code (e.g. `FF0000`).<br><br>Default: `""` (empty).| ##### تاریخ The following advanced configuration parameters are supported if *Clock type* is set to "Digital", and *Show* is set to "Date". |Parameter|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-----|-|-----|-------------------| |*Bold*|0|date_bold|0 - *(default)* Disabled;<br>1 - Enabled.| |*Color*|1|date_color|Hexadecimal color code (e.g. `FF0000`).<br><br>Default: `""` (empty).| # dcheck.get # dcheck.get # Debug logging To troubleshoot issues when working with Zabbix API, collecting data from Zabbix agent, or sending data to Zabbix server or proxy, you can enable debug logging. The zabbix\_utils library uses Python's standard `logging` module. To see detailed debug messages from the library: 1. Import Python's `logging` module in your script. 2. Configure the logging system to output messages in a readable format and set the logging level to DEBUG. ```python import logging from zabbix_utils import Getter logging.basicConfig( format=u'[%(asctime)s] %(levelname)s %(message)s', level=logging.DEBUG ) agent = Getter(host='127.0.0.1', port=10050) resp = agent.get('system.uname') print(resp.value) ``` With debug logging enabled, detailed information about requests and responses is printed, for example: ```bash [2023-10-01 12:00:01,587] DEBUG Content of the packet: b'ZBXD\x01\x0c\x00\x00\x00\x00\x00\x00\x00system.uname' [2023-10-01 12:00:01,722] DEBUG Zabbix response header: b'ZBXD\x01C\x00\x00\x00C\x00\x00\x00' [2023-10-01 12:00:01,723] DEBUG Zabbix response body: Linux test_server 5.15.0-3.60.5.1.el9uek.x86_64 [2023-10-01 12:00:01,724] DEBUG Response from [127.0.0.1:10050]: Linux test_server 5.15.0-3.60.5.1.el9uek.x86_64 Linux test_server 5.15.0-3.60.5.1.el9uek.x86_64 ``` ### فعالسازی Debug Logging برای عیبیابی هنگام کار با Zabbix API، جمعآوری داده از **Zabbix Agent** یا ارسال داده به **Zabbix Server** یا **Proxy**، میتوانید **Debug Logging** را فعال کنید. کتابخانه **zabbix_utils** از ماژول استاندارد Python به نام `logging` استفاده میکند. برای مشاهده پیامهای دقیق Debug از کتابخانه: 1. ماژول `logging` را در اسکریپت خود وارد کنید. 2. سیستم logging را طوری پیکربندی کنید که پیامها در فرمت قابل خواندن نمایش داده شوند و سطح Logging روی `DEBUG` تنظیم شود. مثال: ```python id="b7q2xf" import logging from zabbix_utils import Getter # پیکربندی logging logging.basicConfig( format=u'[%(asctime)s] %(levelname)s %(message)s', level=logging.DEBUG ) # ایجاد نمونه Getter برای ارتباط با Zabbix Agent agent = Getter(host='127.0.0.1', port=10050) # دریافت مقدار آیتم system.uname resp = agent.get('system.uname') print(resp.value) ``` با فعال شدن Debug Logging، اطلاعات جزئی درباره **درخواستها و پاسخها** چاپ میشود، مثلاً: ```bash id="g8l5wv" [2023-10-01 12:00:01,587] DEBUG Content of the packet: b'ZBXD\x01\x0c\x00\x00\x00\x00\x00\x00\x00system.uname' [2023-10-01 12:00:01,722] DEBUG Zabbix response header: b'ZBXD\x01C\x00\x00\x00C\x00\x00\x00' [2023-10-01 12:00:01,723] DEBUG Zabbix response body: Linux test_server 5.15.0-3.60.5.1.el9uek.x86_64 [2023-10-01 12:00:01,724] DEBUG Response from [127.0.0.1:10050]: Linux test_server 5.15.0-3.60.5.1.el9uek.x86_64 Linux test_server 5.15.0-3.60.5.1.el9uek.x86_64 ``` این اطلاعات برای **تشخیص مشکلات ارتباط با Agent یا Server** و بررسی محتویات بستهها بسیار مفید است. #### Deleting multiple connectors Delete two connector entries. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "connector.delete", "params": [ 3, 5 ], "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "connectorids": [ "3", "5" ] }, "id": 1 } ``` #### حذف چندین کانکتور دو ورودی کانکتور را حذف کنید. [درخواست](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "connector.delete", "params": [ 3, 5 ], "id": 1 } ``` پاسخ: ```json { "jsonrpc": "2.0", "result": { "connectorids": [ "3", "5" ] }, "id": 1 } ``` # Deploy Zabbix in the cloud #1 نصب زبیکس با زبیکس کلود ### Description `integer/array alert.get(object parameters)` The method allows to retrieve alerts according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### شرح `alert.get(پارامترهای شیء) عدد صحیح/آرایه` این روش اجازه می دهد تا هشدارها را با توجه به پارامترهای داده شده بازیابی کنید. ::: نوتکلاسیک این روش برای کاربران از هر نوع در دسترس است. مجوزها برای فراخوانی روش را می توان در تنظیمات نقش کاربر لغو کرد. [کاربر roles](/manual/web_interface/frontend_sections/administration/user_roles) برای اطلاعات بیشتر. ::: ### Description `integer/array connector.get(object parameters)` The method allows to retrieve connector objects according to the given parameters. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### شرح `alert.get(پارامترهای شیء) عدد صحیح/آرایه` این روش اجازه می دهد تا هشدارها را با توجه به پارامترهای داده شده بازیابی کنید. ::: نوتکلاسیک این روش برای کاربران از هر نوع در دسترس است. مجوزها برای فراخوانی روش را می توان در تنظیمات نقش کاربر لغو کرد. [کاربر roles](/manual/web_interface/frontend_sections/administration/user_roles) برای اطلاعات بیشتر. ::: ### Description `integer/array itemprototype.get(object parameters)` The method allows to retrieve item prototypes according to the given parameters. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: # توضیحات:`integer/array image.get(object parameters)` این روش اجازه می دهد تا تصاویر را با توجه به پارامترهای داده شده بازیابی کنید.::: noteclassicاین روش برای کاربران از هر نوع در دسترس است. مجوز برای فراخوانی روش را می توان در تنظیمات نقش کاربر لغو کرد. برای اطلاعات بیشتر به [Userroles](/manual/web_interface/frontend_sections/administration/user_roles) مراجعه کنید. ### description Module description. *Type*: String *Example*: ```json "description": "This is a clock widget." ``` ### توضیحات توضیحات ماژول. *نوع*: رشته *مثال*: ```json "توضیحات": "این یک ویجت ساعت است." ``` ### Description `object action.create(object/array actions)` This method allows to create new actions. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### شرح "عملکرد شیء. ایجاد (عملکردهای شی/آرایه)". این روش امکان ایجاد اقدامات جدید را فراهم می کند. ::: توجه این روش فقط برای *Admin* و *Super Admin* در دسترس است انواع کاربر مجوزهای فراخوانی متد را می توان در نقش کاربر لغو کرد تنظیمات. [کاربر roles](/manual/web_interface/frontend_sections/administration/user_roles) برای اطلاعات بیشتر. ::: ### Description `object connector.create(object/array connectors)` This method allows to create new connector objects. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### توضیحات `object connector.create(object/array connectors)` این متد امکان ایجاد اشیاء کانکتور جدید را فراهم میکند. ::: noteclassic این متد فقط برای نوع کاربر *Super admin* در دسترس است. مجوزهای فراخوانی متد را میتوان در تنظیمات نقش کاربر لغو کرد. برای اطلاعات بیشتر به [نقشهای کاربر](/manual/web_interface/frontend_sections/users/user_roles) مراجعه کنید. ::: ### Description `object connector.delete(array connectorids)` This method allows to delete connector entries. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### توضیحات `object connector.delete(array connectorids)` این متد امکان حذف ورودیهای کانکتور را فراهم میکند. ::: noteclassic این متد فقط برای نوع کاربر *Super admin* در دسترس است. مجوزهای فراخوانی متد را میتوان در تنظیمات نقش کاربر لغو کرد. برای اطلاعات بیشتر به [نقشهای کاربر](/manual/web_interface/frontend_sections/users/user_roles) مراجعه کنید. ::: ### Description `object connector.update(object/array connectors)` This method allows to update existing connectors. ::: noteclassic This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### توضیحات `object connector.create(object/array connectors)` این متد امکان ایجاد اشیاء کانکتور جدید را فراهم میکند. ::: noteclassic این متد فقط برای نوع کاربر *Super admin* در دسترس است. مجوزهای فراخوانی متد را میتوان در تنظیمات نقش کاربر لغو کرد. برای اطلاعات بیشتر به [نقشهای کاربر](/manual/web_interface/frontend_sections/users/user_roles) مراجعه کنید. ::: ### Description `object hostgroup.update(object/array hostGroups)` This method allows to update existing hosts groups. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ###توضیحات `object hostgroup.update(object/array hostGroups)` This method allows to update existing hosts groups. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Description `object itemprototype.update(object/array itemPrototypes)` This method allows to update existing item prototypes. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### توضیحات`object itemprototype.update(object/array itemPrototypes)`این متد امکان بهروزرسانی نمونههای اولیه آیتمهای موجود را فراهم میکند.::: noteclassic این متد فقط برای کاربران با سطح دسترسی *Admin* و *Super admin* در دسترس است. مجوزهای فراخوانی این متد را میتوان در تنظیمات نقش کاربر لغو کرد. برای اطلاعات بیشتر به [Userroles](/manual/web_interface/frontend_sections/users/user_roles) مراجعه کنید.::: ### Description `object map.create(object/array maps)` This method allows to create new maps. ::: noteclassic This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information. ::: ### شرح این روش اجازه می دهد تا داشبورد موجود را به روز کنید. ::: توجه : این روش فقط برای کاربر *Super Admin* موجود است. دسترسی امکان لغو روش های فراخوانی در بخش تنظیمات کاربر می باشد . (در مسیر زیر) (/manual/web_interface/frontend_sections/administration/user_roles) برای اطلاعات بیشتر. ::: ### Description `string/object user.login(object parameters)` This method allows to log in to the API and generate an authentication token. ::: notewarning When using this method, you also need to do [user.logout](/manual/api/reference/user/logout) to prevent the generation of a large number of open session records. ::: ::: noteimportant This method is only available to unauthenticated users who do not belong to any [user group](/manual/api/reference/usergroup/object#user-group) with enabled multi-factor authentication. ::: ### توضیحات`string/object user.login(object parameters)`این متد امکان ورود به API و تولید یک توکن احراز هویت را فراهم میکند.::: notewarningهنگام استفاده از این متد، برای جلوگیری از تولید تعداد زیادی رکورد جلسه باز، باید دستور [user.logout](/manual/api/reference/user/logout) را نیز اجرا کنید.::::: noteimportantاین متد فقط برای کاربران احراز هویت نشدهای که به هیچ [گروه کاربری](/manual/api/reference/usergroup/object#user-group) با احراز هویت چند عاملی فعال تعلق ندارند، در دسترس است.::: ### Description These parameters and the possible property values for the respective dashboard widget field objects allow to configure the [*Action log*](/manual/web_interface/frontend_sections/dashboards/widgets/action_log) widget in `dashboard.create` and `dashboard.update` methods. ::: noteimportant Widget `fields` properties are not validated during the creation or update of a dashboard. This allows users to modify [built-in widgets](/manual/web_interface/frontend_sections/dashboards/widgets) and create [custom widgets](/devel/modules/tutorials/widget), but also introduces the risk of creating or updating widgets incorrectly. To ensure the successful creation or update of the *Action log* widget, please refer to the parameter behavior outlined in the tables below. ::: ### توضیحات این پارامترها و مقادیر ممکن برای اشیاء فیلد ویجت داشبورد مربوطه، امکان پیکربندی ویجت [*Action log*](/manual/web_interface/frontend_sections/dashboards/widgets/action_log) را در متدهای `dashboard.create` و `dashboard.update` فراهم میکنند. ::: نکته مهم ویژگیهای ویجت `fields` در طول ایجاد یا بهروزرسانی داشبورد اعتبارسنجی نمیشوند. این به کاربران اجازه میدهد تا [built-in widgets](/manual/web_interface/frontend_sections/dashboards/widgets) را تغییر داده و [custom widgets](/devel/modules/tutorials/widget) ایجاد کنند، اما همچنین خطر ایجاد یا بهروزرسانی نادرست ویجتها را نیز ایجاد میکند. برای اطمینان از ایجاد یا بهروزرسانی موفقیتآمیز ویجت *Action log*، لطفاً به رفتار پارامتر ذکر شده در جداول زیر مراجعه کنید. ::: ### Description These parameters and the possible property values for the respective dashboard widget field objects allow to configure the [*Clock*](/manual/web_interface/frontend_sections/dashboards/widgets/clock) widget in `dashboard.create` and `dashboard.update` methods. ::: noteimportant Widget `fields` properties are not validated during the creation or update of a dashboard. This allows users to modify [built-in widgets](/manual/web_interface/frontend_sections/dashboards/widgets) and create [custom widgets](/devel/modules/tutorials/widget), but also introduces the risk of creating or updating widgets incorrectly. To ensure the successful creation or update of the *Clock* widget, please refer to the parameter behavior outlined in the tables below. ::: ### توضیحات این پارامترها و مقادیر ممکن برای اشیاء فیلد ویجت داشبورد مربوطه، امکان پیکربندی ویجت [*Action log*](/manual/web_interface/frontend_sections/dashboards/widgets/action_log) را در متدهای `dashboard.create` و `dashboard.update` فراهم میکنند. ::: نکته مهم ویژگیهای ویجت `fields` در طول ایجاد یا بهروزرسانی داشبورد اعتبارسنجی نمیشوند. این به کاربران اجازه میدهد تا [built-in widgets](/manual/web_interface/frontend_sections/dashboards/widgets) را تغییر داده و [custom widgets](/devel/modules/tutorials/widget) ایجاد کنند، اما همچنین خطر ایجاد یا بهروزرسانی نادرست ویجتها را نیز ایجاد میکند. برای اطمینان از ایجاد یا بهروزرسانی موفقیتآمیز ویجت *Action log*، لطفاً به رفتار پارامتر ذکر شده در جداول زیر مراجعه کنید. ::: ### Description These parameters and the possible property values for the respective dashboard widget field objects allow to configure the [*Discovery status*](/manual/web_interface/frontend_sections/dashboards/widgets/discovery_status) widget in `dashboard.create` and `dashboard.update` methods. ### توضیحات این پارامترها و مقادیر ممکن برای ویژگیهای مربوط به اشیاء فیلد ویجت داشبورد مربوطه، امکان پیکربندی ویجت [*Discovery status*](/manual/web_interface/frontend_sections/dashboards/widgets/discovery_status) را در متدهای `dashboard.create` و `dashboard.update` فراهم میکنند. ### Description These parameters and the possible property values for the respective dashboard widget field objects allow to configure the [*Favorite graphs*](/manual/web_interface/frontend_sections/dashboards/widgets/favorite_graphs) widget in `dashboard.create` and `dashboard.update` methods. ### توضیحات این پارامترها و مقادیر ممکن برای ویژگیهای مربوط به اشیاء فیلد ویجت داشبورد مربوطه، امکان پیکربندی ویجت [*Discovery status*](/manual/web_interface/frontend_sections/dashboards/widgets/discovery_status) را در متدهای `dashboard.create` و `dashboard.update` فراهم میکنند. ### Description These parameters and the possible property values for the respective dashboard widget field objects allow to configure the [*Favorite maps*](/manual/web_interface/frontend_sections/dashboards/widgets/favorite_maps) widget in `dashboard.create` and `dashboard.update` methods. ### توضیحات این پارامترها و مقادیر ممکن برای ویژگیهای مربوط به اشیاء فیلد ویجت داشبورد مربوطه، امکان پیکربندی ویجت [*Discovery status*](/manual/web_interface/frontend_sections/dashboards/widgets/discovery_status) را در متدهای `dashboard.create` و `dashboard.update` فراهم میکنند. ### Description These parameters and the possible property values for the respective dashboard widget field objects allow to configure the [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts) widget in `dashboard.create` and `dashboard.update` methods. ::: noteimportant Widget `fields` properties are not validated during the creation or update of a dashboard. This allows users to modify [built-in widgets](/manual/web_interface/frontend_sections/dashboards/widgets) and create [custom widgets](/devel/modules/tutorials/widget), but also introduces the risk of creating or updating widgets incorrectly. To ensure the successful creation or update of the *Top hosts* widget, please refer to the parameter behavior outlined in the tables below. ::: ### توضیحات این پارامترها و مقادیر ممکن برای اشیاء فیلد ویجت داشبورد مربوطه، امکان پیکربندی ویجت [*Action log*](/manual/web_interface/frontend_sections/dashboards/widgets/action_log) را در متدهای `dashboard.create` و `dashboard.update` فراهم میکنند. ::: نکته مهم ویژگیهای ویجت `fields` در طول ایجاد یا بهروزرسانی داشبورد اعتبارسنجی نمیشوند. این به کاربران اجازه میدهد تا [built-in widgets](/manual/web_interface/frontend_sections/dashboards/widgets) را تغییر داده و [custom widgets](/devel/modules/tutorials/widget) ایجاد کنند، اما همچنین خطر ایجاد یا بهروزرسانی نادرست ویجتها را نیز ایجاد میکند. برای اطمینان از ایجاد یا بهروزرسانی موفقیتآمیز ویجت *Action log*، لطفاً به رفتار پارامتر ذکر شده در جداول زیر مراجعه کنید. ::: ### Description These parameters and the possible property values for the respective dashboard widget field objects allow to configure the [*Web monitoring*](/manual/web_interface/frontend_sections/dashboards/widgets/web_monitoring) widget in `dashboard.create` and `dashboard.update` methods. ::: noteimportant Widget `fields` properties are not validated during the creation or update of a dashboard. This allows users to modify [built-in widgets](/manual/web_interface/frontend_sections/dashboards/widgets) and create [custom widgets](/devel/modules/tutorials/widget), but also introduces the risk of creating or updating widgets incorrectly. To ensure the successful creation or update of the *Web monitoring* widget, please refer to the parameter behavior outlined in the tables below. ::: ### توضیحات این پارامترها و مقادیر ویژگی ممکن برای اشیاء فیلد ویجت داشبورد مربوطه، امکان پیکربندی ویجت [*Pie chart*](/manual/web_interface/frontend_sections/dashboards/widgets/pie_chart) را در متدهای `dashboard.create` و `dashboard.update` فراهم میکنند. ::: نکته مهم ویژگیهای `fields` ویجت در طول ایجاد یا بهروزرسانی داشبورد اعتبارسنجی نمیشوند. این به کاربران اجازه میدهد تا [built-in widgets](/manual/web_interface/frontend_sections/dashboards/widgets) را تغییر داده و [custom widgets](/devel/modules/tutorials/widget) ایجاد کنند، اما همچنین خطر ایجاد یا بهروزرسانی نادرست ویجتها را نیز ایجاد میکند. برای اطمینان از ایجاد یا بهروزرسانی موفقیتآمیز ویجت *Pie chart*، لطفاً به رفتار پارامتر ذکر شده در جداول زیر مراجعه کنید. ::: #### Details about export - All supported elements are exported in one file. - Host and template entities (items, triggers, graphs, discovery rules) that are inherited from linked templates are not exported. Any changes made to those entities on a host level (such as changed item interval, modified regular expression or added prototypes to the low-level discovery rule) will be lost when exporting; when importing, all entities from linked templates are re-created as on the original linked template. - Entities created by low-level discovery and any entities depending on them are not exported. For example, a trigger created for an LLD-rule generated item will not be exported. - When the exported host/template contains entities supporting timeouts, the timeout values will be exported if these entities have their own timeouts configured. #### جزئیات مربوط به صادرات - تمام عناصر پشتیبانی شده در یک فایل صادر میشوند. - موجودیتهای میزبان و قالب (آیتمها، تریگرها، نمودارها، قوانین اکتشاف) که از قالبهای پیوند شده به ارث رسیدهاند، صادر نمیشوند. هرگونه تغییری که در سطح میزبان در آن موجودیتها ایجاد شود (مانند تغییر فاصله آیتم، اصلاح عبارت منظم یا اضافه کردن نمونههای اولیه به قانون اکتشاف سطح پایین) هنگام صادرات از بین میرود. هنگام واردات، تمام موجودیتها از قالبهای پیوند شده مانند الگوی پیوند شده اصلی دوباره ایجاد میشوند. - موجودیتهای ایجاد شده توسط اکتشاف سطح پایین و هر موجودیت وابسته به آنها صادر نمیشوند. به عنوان مثال، تریگر ایجاد شده برای یک آیتم تولید شده توسط قانون LLD صادر نمیشود. - هنگامی که میزبان/قالب صادر شده حاوی موجودیتهایی باشد که از وقفههای زمانی پشتیبانی میکنند، مقادیر وقفه زمانی در صورتی صادر میشوند که این موجودیتها وقفههای زمانی خود را پیکربندی کرده باشند. #### Details about import - Import stops at the first error. - When updating existing images during image import, "imagetype" field is ignored, i.e., it is impossible to change image type via import. - When importing hosts/templates using the "Delete missing" option, host/template macros not present in the import file will be deleted from the host/template after the import. - Empty tags for items, triggers, graphs, discoveryRules, itemPrototypes, triggerPrototypes, graphPrototypes are meaningless, i.e., it's the same as if it was missing. - If entities of the imported host/template have their own timeouts configured, they will be applied; otherwise, proxy/global timeouts will be applied. - Import supports YAML, XML and JSON, the import file must have a correct file extension: .yaml and .yml for YAML, .xml for XML and .json for JSON. See [compatibility information](/manual/appendix/compatibility) about supported XML versions. - Import supports configuration files only in UTF-8 encoding (with or without [BOM](https://en.wikipedia.org/wiki/Byte_order_mark)); other encodings (UTF16LE, UTF16BE, UTF32LE, UTF32BE, etc.) will result in an import conversion error. #### جزئیات مربوط به واردات - واردات در اولین خطا متوقف میشود. - هنگام بهروزرسانی تصاویر موجود در حین واردات تصویر، فیلد "imagetype" نادیده گرفته میشود، یعنی تغییر نوع تصویر از طریق واردات غیرممکن است. - هنگام واردات میزبانها/قالبها با استفاده از گزینه "حذف موارد گمشده"، ماکروهای میزبان/قالب که در فایل واردات وجود ندارند، پس از واردات از میزبان/قالب حذف میشوند. - برچسبهای خالی برای موارد، تریگرها، گرافها، discoverRules، itemPrototypes، triggerPrototypes، graphPrototypes بیمعنی هستند، یعنی مانند این است که فاقد آن باشند. - اگر موجودیتهای میزبان/قالب وارد شده، مهلتهای زمانی خود را پیکربندی کرده باشند، اعمال میشوند. در غیر این صورت، مهلتهای زمانی پروکسی/سراسری اعمال میشوند. - ایمپورت از YAML، XML و JSON پشتیبانی میکند، فایل ایمپورت باید پسوند فایل صحیحی داشته باشد: .yaml و .yml برای YAML، .xml برای XML و .json برای JSON. برای نسخههای XML پشتیبانیشده به [compatibility information](/manual/appendix/compatibility) مراجعه کنید. - ایمپورت فقط از فایلهای پیکربندی با کدگذاری UTF-8 (با یا بدون [BOM](https://en.wikipedia.org/wiki/Byte_order_mark)) پشتیبانی میکند. سایر کدگذاریها (UTF16LE، UTF16BE، UTF32LE، UTF32BE و غیره) منجر به خطای تبدیل ایمپورت خواهند شد. # dhost.get # dhost.get ##### Discard unchanged {#discardunchanged} Discard a value if it has not changed. Comments: - If a value is discarded, it is not saved in the database and Zabbix server has no knowledge that this value was received. No trigger expressions will be evaluated, as a result, no problems for related triggers will be created/resolved. Functions will work only based on data that is actually saved in the database. As trends are built based on data in the database, if there is no value saved for an hour then there will also be no trends data for that hour.<br> - Only one throttling option can be specified per item. ##### حذف بدون تغییر {#discardunchanged} اگر مقداری تغییر نکرده باشد، آن را حذف کنید. توضیحات: - اگر مقداری حذف شود، در پایگاه داده ذخیره نمیشود و سرور زبیکس هیچ اطلاعی از دریافت این مقدار ندارد. هیچ عبارت تریگری ارزیابی نخواهد شد، در نتیجه، هیچ مشکلی برای تریگرهای مرتبط ایجاد/حل نخواهد شد. توابع فقط بر اساس دادههایی که واقعاً در پایگاه داده ذخیره شدهاند، کار خواهند کرد. از آنجایی که روندها بر اساس دادههای موجود در پایگاه داده ساخته میشوند، اگر هیچ مقداری برای یک ساعت ذخیره نشده باشد، هیچ داده روندی نیز برای آن ساعت وجود نخواهد داشت.<br>- فقط یک گزینه محدودسازی برای هر مورد میتوان مشخص کرد. ##### Discard unchanged with heartbeat {#discardwithheartbeat} Discard a value if it has not changed within the defined time period (in seconds). Comments: - Positive integer values are supported to specify the seconds (minimum - 1 second);<br> - Time suffixes can be used (e.g., 30s, 1m, 2h, 1d);<br> - User macros and low-level discovery macros can be used;<br> - If a value is discarded, it is not saved in the database and Zabbix server has no knowledge that this value was received. No trigger expressions will be evaluated, as a result, no problems for related triggers will be created/resolved. Functions will work only based on data that is actually saved in the database. As trends are built based on data in the database, if there is no value saved for an hour then there will also be no trends data for that hour.<br> - Only one throttling option can be specified per item. ##### بدون تغییر با ضربان قلب حذف شود {#discardwithheartbeat}اگر مقداری در بازه زمانی تعریف شده (به ثانیه) تغییر نکرده باشد، آن را حذف کنید. توضیحات:-مقادیر صحیح مثبت برای مشخص کردن ثانیه پشتیبانی میشوند (حداقل - ۱ ثانیه)؛<br>-میتوان از پسوندهای زمانی استفاده کرد (مثلاً ۳۰ ثانیه، ۱ دقیقه، ۲ ساعت، ۱ روز)؛<br>-میتوان از ماکروهای کاربر و ماکروهای کشف سطح پایین استفاده کرد؛<br>-اگر مقداری حذف شود، در پایگاه داده ذخیره نمیشود و سرور زبیکس هیچ اطلاعی از دریافت این مقدار ندارد. هیچ عبارت تریگری ارزیابی نخواهد شد، در نتیجه، هیچ مشکلی برای تریگرهای مرتبط ایجاد/حل نخواهد شد. توابع فقط بر اساس دادههایی که واقعاً در پایگاه داده ذخیره شدهاند، کار خواهند کرد. از آنجایی که روندها بر اساس دادههای موجود در پایگاه داده ساخته میشوند، اگر هیچ مقداری برای یک ساعت ذخیره نشده باشد، هیچ داده روندی نیز برای آن ساعت وجود نخواهد داشت.<br>-فقط یک گزینه محدودسازی میتواند برای هر مورد مشخص شود. # discoveryrule.create # ساختن قوانین جست وجو # discoveryrule.delete # پاک کردن قوانین جست وجو # discoveryrule.get # گرفتن قوانین جست وجو # discoveryrule.update # به روز رسانی قوانین جست وجو #### Displaying options The following parameters are supported for configuring *Displaying options*. |Parameter|<|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-|--------|--|--------|-------------------------------| |*History data selection*|<|0|source|0 - *(default)* Auto;<br>1 - History;<br>2 - Trends.| |*Draw*|<|0|draw_type|0 - *(default)* Pie;<br>1 - Doughnut.| |<|*Width*|0|width|20 - 20% of the radius;<br>30 - 30% of the radius;<br>40 - 40% of the radius;<br>50 - *(default)* 50% of the radius.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Draw* is set to "Doughnut"| |^|*Stroke width*|0|stroke|Possible values range from 0-10.<br><br>Default: 0.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Draw* is set to "Doughnut"| |^|*Show total value*|0|total_show|0 - *(default)* Disabled;<br>1 - Enabled.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Draw* is set to "Doughnut"| |^|*Size*|0|value_size_type|0 - *(default)* Auto;<br>1 - Custom.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Show total value* is set to "Enabled"| |^|*Size* (value for custom size)|0|value_size|Possible values range from 1-100.<br><br>Default: 20.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Show total value* is set to "Enabled"| |^|*Decimal places*|0|decimal_places|Possible values range from 0-6.<br><br>Default: 2.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Show total value* is set to "Enabled"| |^|*Units* (checkbox)|0|units_show|0 - *(default)* Disabled;<br>1 - Enabled.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Show total value* is set to "Enabled"| |^|*Units* (value)|1|units|Any string value.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Units* (checkbox) is set to "Enabled"| |^|*Bold*|0|value_bold|0 - *(default)* Disabled;<br>1 - Enabled.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Show total value* is set to "Enabled"| |^|*Color*|1|value_color|Hexadecimal color code (e.g. `FF0000`).<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Show total value* is set to "Enabled"| |*Space between sectors*|<|0|space|Possible values range from 0-10.<br><br>Default: 1.| |*Merge sectors smaller than N%* (checkbox)|<|0|merge|0 - *(default)* Disabled;<br>1 - Enabled.| |*Merge sectors smaller than N%* (value)|<|0|merge_percent|Possible values range from 1-10.<br><br>Default: 1.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Merge sectors smaller than N%* (checkbox) is set to "Enabled"| |*Merge sectors smaller than N%* (color)|<|1|merge_color|Hexadecimal color code (e.g. `FF0000`).<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Merge sectors smaller than N%* (checkbox) is set to "Enabled"| #### گزینههای نمایش پارامترهای زیر برای پیکربندی *گزینههای نمایش* پشتیبانی میشوند. |پارامتر|<|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-|-------|--|--------|---------------------------| |*انتخاب دادههای تاریخچه*|<|0|منبع|0 - *(پیشفرض)* خودکار;<br>1 - تاریخچه;<br>2 - روندها.| |*ترسیم*|<|0|draw_type|0 - *(پیشفرض)* پای;<br>1 - دونات.| |<|*عرض*|0|عرض|20 - 20% شعاع;<br>30 - 30% شعاع;<br>40 - 40% شعاع;<br>50 - *(پیشفرض)* 50% شعاع.<br><br>[رفتار پارامتر](/manual/api/reference_commentary#parameter-behavior):<br>- *پشتیبانی* اگر *Draw* روی "Doughnut" تنظیم شده باشد| |^|*عرض خط دور*|0|خط دور|مقادیر ممکن از 0 تا 10 متغیر است.<br><br>پیشفرض: 0.<br><br>[رفتار پارامتر](/manual/api/reference_commentary#parameter-behavior):<br>- *پشتیبانی* اگر *Draw* روی "Doughnut" تنظیم شده باشد| |^|*نمایش مقدار کل*|0|total_show|0 - *(پیشفرض)* غیرفعال؛<br>1 - فعال.<br><br>[رفتار پارامتر](/manual/api/reference_commentary#parameter-behavior):<br>- *پشتیبانی* اگر *Draw* روی "Doughnut" تنظیم شده باشد| |^|*Size*|0|value_size_type|0 - *(پیشفرض)* Auto;<br>1 - سفارشی.<br><br>[رفتار پارامتر](/manual/api/reference_commentary#parameter-behavior):<br>- *پشتیبانی* اگر *نمایش مقدار کل* روی "Enabled" تنظیم شده باشد| |^|*اندازه* (مقدار برای اندازه سفارشی)|0|اندازه_مقدار|مقادیر ممکن از 1 تا 100 متغیر است.<br><br>پیشفرض: 20.<br><br>[رفتار پارامتر](/manual/api/reference_commentary#parameter-behavior):<br>- *پشتیبانی* اگر *نمایش مقدار کل* روی "فعال" تنظیم شده باشد| |^|*رقم اعشار*|0|اعداد اعشاری|مقادیر ممکن از 0 تا 6 متغیر است.<br><br>پیشفرض: 2.<br><br>[رفتار پارامتر](/manual/api/reference_commentary#parameter-behavior):<br>- *پشتیبانی* اگر *نمایش مقدار کل* روی "فعال" تنظیم شده باشد| |^|*واحدها* (چکباکس)|0|units_show|0 - *(پیشفرض)* غیرفعال؛<br>1 - فعال.<br><br>[رفتار پارامتر](/manual/api/reference_commentary#parameter-behavior):<br>- *پشتیبانی* اگر *نمایش مقدار کل* روی "فعال" تنظیم شده باشد| |^|*واحدها* (مقدار)|1|واحدها|هر مقدار رشتهای.<br><br>[رفتار پارامتر](/manual/api/reference_commentary#parameter-behavior):<br>- *پشتیبانی* اگر *واحدها* (چکباکس) روی "فعال" تنظیم شده باشد| |^|*Bold*|0|value_bold|0 - *(پیشفرض)* غیرفعال؛<br>1 - فعال.<br><br>[رفتار پارامتر](/manual/api/reference_commentary#parameter-behavior):<br>- *پشتیبانی* اگر *نمایش مقدار کل* روی "فعال" تنظیم شده باشد| |^|*رنگ*|1|value_color|کد رنگ هگزادسیمال (مثلاً `FF0000`).<br><br>[رفتار پارامتر](/manual/api/reference_commentary#parameter-behavior):<br>- *پشتیبانی* اگر *نمایش مقدار کل* روی "فعال" تنظیم شده باشد| |*فاصله بین سکتورها*|<|0|فاصله|مقادیر ممکن از 0 تا 10 متغیر است.<br><br>پیشفرض: 1.| |*ادغام سکتورهای کوچکتر از N%* (چکباکس)|<|0|ادغام|0 - *(پیشفرض)* غیرفعال؛<br>1 - فعال.| |*ادغام سکتورهای کوچکتر از N%* (مقدار)|<|0|ادغام_درصد|مقادیر ممکن از 1 تا 10 متغیر است.<br><br>پیشفرض: 1.<br><br>[رفتار پارامتر](/manual/api/reference_commentary#parameter-behavior):<br>- *پشتیبانی* اگر *ادغام سکتورهای کوچکتر از N%* (چکباکس) روی "فعال" تنظیم شده باشد| |*ادغام سکتورهای کوچکتر از N%* (رنگ)|<|1|ادغام_رنگ|کد رنگ هگزادسیمال (مثلاً `FF0000`).<br><br>[رفتار پارامتر](/manual/api/reference_commentary#parameter-behavior):<br>- *پشتیبانی* اگر *ادغام سکتورهای کوچکتر از N%* (کادر انتخاب) روی "فعال" تنظیم شده باشد| #### Display Once suppressed the problem is marked by a blinking ![](../../../assets/en/manual/web_interface/frontend_sections/monitoring/icon_suppression.png) suppression icon in the *Info* column, before being hidden. The suppression icon is blinking while the suppression task is in the waiting list. Once the task manager has suppressed the problem, the icon will stop blinking. If the suppression icon keeps blinking for a long time, this may indicate a server problem, for example, if the server is down and the task manager cannot complete the task. The same logic applies to unsuppression. In the short period after the task is submitted and the server has not completed it, the unsuppression icon is blinking. A suppressed problem may be both hidden or shown, depending on the problem filter/widget settings. When shown in the problem list, a suppressed problem is marked by the suppression icon and suppression details are shown on mouseover: ![](../../../assets/en/manual/web_interface/suppressed_problem_listed.png) Suppression details are also displayed in a popup when positioning the mouse on the suppression icon in the *Actions* column. #### نمایش پس از سرکوب، مشکل با یک چشمک زن مشخص میشود ![](../../../assets/en/manual/web_interface/frontend_sections/monitoring/icon_suppression.png) آیکون سرکوب در ستون *اطلاعات*، قبل از پنهان شدن. آیکون سرکوب در حالی که وظیفه سرکوب در لیست انتظار است، چشمک میزند. پس از سرکوب مشکل توسط مدیر وظیفه، چشمک زدن آیکون متوقف میشود. اگر آیکون سرکوب برای مدت طولانی چشمک بزند، ممکن است نشان دهنده یک مشکل سرور باشد، به عنوان مثال، اگر سرور از کار افتاده باشد و مدیر وظیفه نتواند وظیفه را تکمیل کند. همین منطق در مورد رفع سرکوب نیز صدق میکند. در مدت کوتاهی پس از ارسال وظیفه و عدم تکمیل آن توسط سرور، آیکون رفع سرکوب چشمک میزند. یک مشکل سرکوب شده ممکن است بسته به تنظیمات فیلتر/ویجت مشکل، پنهان یا نمایش داده شود. وقتی در لیست مشکلات نشان داده میشود، یک مشکل سرکوبشده با نماد سرکوب مشخص میشود و جزئیات سرکوب با بردن ماوس نمایش داده میشود: ![](../../../assets/en/manual/web_interface/suppressed_problem_listed.png) جزئیات سرکوب همچنین هنگام قرار دادن ماوس روی نماد سرکوب در ستون *اقدامات* در یک پنجره بازشو نمایش داده میشود. ##### Does not match regular expression {#doesnotmatchregexp} Specify a regular expression that a value must not match. If you mark the *Custom on fail* checkbox, it is possible to specify custom error-handling options: either to discard the value, set a specified value, or set a specified error message. In case of a failed preprocessing step, the item will not become unsupported if the option to discard the value or set a specified value is selected. اگر کادر *سفارشیسازی در صورت عدم موفقیت* را علامت بزنید، میتوانید گزینههای سفارشی برای مدیریت خطا را تعیین کنید: یا مقدار را حذف کنید، یک مقدار مشخص تنظیم کنید یا یک پیام خطای مشخص تنظیم کنید. در صورت شکست یک مرحله پیشپردازش، اگر گزینه حذف مقدار یا تنظیم یک مقدار مشخص انتخاب شود، مورد پشتیبانی نشده باقی میماند. # drule.create # ساختن # drule.delete پاک کردن قانون جست وجو # drule.get دریافت حذف قانون جست و جو # drule.update # آپدیت قانون جست و جو # dservice.get # دریافت سرویس جست و جو ##### During initialization When creating a `ZabbixAPI` instance, you can provide the Zabbix web interface URL and your credentials all at once: ```python # Username and password: api = ZabbixAPI(url="127.0.0.1/zabbix", user="Admin", password="zabbix") # API token: api = ZabbixAPI(url="127.0.0.1/zabbix", token="your_api_token") ``` If you prefer to group connection parameters, you can pass them as a Python dictionary and unpack it using Python's keyword argument syntax: ```python ZABBIX_AUTH = { "url": "127.0.0.1/zabbix", "user": "Admin", "password": "zabbix" } api = ZabbixAPI(**ZABBIX_AUTH) ``` ##### هنگام مقداردهی اولیه (Initialization) هنگام ایجاد یک نمونه از `ZabbixAPI` برای اتصال به Zabbix، میتوانید آدرس رابط وب Zabbix و اطلاعات احراز هویت خود را بهصورت همزمان وارد کنید: ```python # استفاده از نام کاربری و رمز عبور: api = ZabbixAPI(url="127.0.0.1/zabbix", user="Admin", password="zabbix") # استفاده از API Token: api = ZabbixAPI(url="127.0.0.1/zabbix", token="your_api_token") ``` اگر ترجیح میدهید پارامترهای اتصال را بهصورت گروهبندیشده وارد کنید، میتوانید آنها را در قالب یک دیکشنری Python تعریف کرده و با استفاده از ساختار Keyword Argument به تابع ارسال کنید: ```python ZABBIX_AUTH = { "url": "127.0.0.1/zabbix", "user": "Admin", "password": "zabbix" } api = ZabbixAPI(**ZABBIX_AUTH) ``` **Email** The following additional elements are exported only for the *Email* media type. |Element|<|Type|Description| |-|---|---|-----------------------| |provider|<|string|Email provider.| |smtp\_server|<|string|SMTP server.| |smtp\_port|<|integer|SMTP server port to connect to.<br>Default: 25.| |smtp\_helo|<|string|SMTP helo.| |smtp\_email|<|string|Email address from which notifications will be sent.| |smtp\_security|<|string|SMTP connection security level to use.<br>Possible values:^[1](#footnotes)^ NONE (0, default), STARTTLS (1), SSL\_OR\_TLS (2).| |smtp\_verify\_host|<|string|SSL verify host for SMTP.<br>Possible values:^[1](#footnotes)^ NO (0, default), YES (1).| |smtp\_verify\_peer|<|string|SSL verify peer for SMTP.<br>Possible values:^[1](#footnotes)^ NO (0, default), YES (1).| |smtp\_authentication|<|string|SMTP authentication method to use.<br>Possible values:^[1](#footnotes)^ NONE (0, default), PASSWORD (1), OAUTH (2).| |username|<|string|Username.| |password|<|string|Authentication password.| |redirection\_url|<|string|Zabbix frontend URL to redirect back OAuth authorization.| |client\_id|<|string|The client identifier registered within the OAuth authorization server.| |authorization\_url|<|string|OAuth URL, with parameters, to get access and refresh tokens.| |token\_url|<|string|OAuth URL to exchange authorization token to access and refresh tokens.| |message\_format|<|string|Message format.<br>Possible values:^[1](#footnotes)^ TEXT (0), HTML (1, default).| ::: noteclassic See also: [Media type object](/manual/api/reference/mediatype/object) (refer to the relevant property with a matching name). ::: **ایمیل** عناصر اضافی زیر فقط برای نوع رسانه *ایمیل* صادر میشوند. |عنصر|<|نوع|توضیحات| |-|---|---|---------------------| |ارائهدهنده|<|رشته|ارائهدهنده ایمیل.| |smtp\_server|<|رشته|سرور SMTP.| |smtp\_port|<|عدد صحیح|پورت سرور SMTP برای اتصال.<br>پیشفرض: ۲۵.| |smtp\_helo|<|رشته|SMTP helo.| |smtp\_email|<|رشته|آدرس ایمیلی که اعلانها از آن ارسال میشوند.| |smtp\_security|<|string|سطح امنیت اتصال SMTP برای استفاده.<br>مقادیر ممکن:^[1](#footnotes)^ NONE (0, default), STARTTLS (1), SSL\_OR\_TLS (2).| |smtp\_verify\_host|<|string|SSL میزبان را برای SMTP تأیید میکند.<br>مقادیر ممکن:^[1](#footnotes)^ خیر (0, default), YES (1).| |smtp\_verify\_peer|<|string|SSL همتا را برای SMTP تأیید میکند.<br>مقادیر ممکن:^[1](#footnotes)^ خیر (0, default), YES (1).| |smtp\_authentication|<|string|روش احراز هویت SMTP برای استفاده.<br>مقادیر ممکن: ^[1](#footnotes)^ هیچکدام (0، پیشفرض)، رمز عبور (1)، OAUTH (2).| |نام کاربری|<|string|نام کاربری.| |رمز عبور|<|string|رمز عبور احراز هویت.| |redirection\_url|<|string|URL frontend زبیکس برای هدایت مجدد مجوز OAuth.| |client\_id|<|string|شناسه کلاینت ثبت شده در سرور مجوز OAuth.| |authorization\_url|<|string|URL OAuth، با پارامترها، برای دریافت توکنهای دسترسی و بهروزرسانی.| |token\_url|<|string|URL OAuth برای تبادل توکن مجوز برای دسترسی و بهروزرسانی توکنها.| |message\_format|<|string|قالب پیام.<br>مقادیر ممکن:^[1](#footnotes)^ TEXT (0)، HTML (1، پیشفرض).| ::: noteclassic همچنین ببینید: [Media type object](/manual/api/reference/mediatype/object) (به ویژگی مربوطه با نام منطبق مراجعه کنید). ::: ### Enabling high availability ### فعال کردن در دسترس بودن بالا ## Encryption tab The *Encryption* tab lets you configure TLS [encryption](/manual/encryption) between Zabbix components by uploading the required certificate files. To enable secure communication using certificates, select *CERTIFICATE* and upload the following files from your computer: - *Root CA certificates* - used to verify the authenticity of peer certificates. Click *Choose file* and select the file containing trusted Root CA certificates (typically a `.crt` or `.pem` file, PEM-encoded). - *Certificate chain* - represents the chain of trust for your own certificate. Click *Choose file* and select the PEM-encoded file (e.g., `.crt` or `.pem`) that includes your certificate and any intermediate CA certificates. - *Private key* - the private key corresponding to your certificate. Click *Choose file* and select the PEM-encoded `.key` file. - *Revoked certificates* (optional) - if you maintain a Certificate Revocation List (CRL), click *Choose file* and select the CRL file to specify certificates that should no longer be trusted. After selecting the files, click *Save*. The files will be uploaded, validated, and applied to configure TLS encryption between Zabbix components. ![](../../assets/en/cloud/quickstart/encryption_tab.png){width="600"} ## تب رمزگذاری تب *رمزگذاری* به شما امکان میدهد TLS [رمزگذاری](/manual/encryption) را بین اجزای Zabbix با آپلود فایلهای گواهی مورد نیاز پیکربندی کنید. برای فعال کردن ارتباط امن با استفاده از گواهیها، *CERTIFICATE* را انتخاب کرده و فایلهای زیر را از رایانه خود آپلود کنید: - *گواهینامههای Root CA* - برای تأیید صحت گواهیهای همتا استفاده میشود. روی *انتخاب فایل* کلیک کنید و فایل حاوی گواهیهای Root CA معتبر (معمولاً یک فایل `.crt` یا `.pem`، رمزگذاری شده با PEM) را انتخاب کنید. - *زنجیره گواهی* - زنجیره اعتماد برای گواهی خود را نشان میدهد. روی *انتخاب فایل* کلیک کنید و فایل رمزگذاری شده با PEM (مثلاً `.crt` یا `.pem`) را که شامل گواهی شما و هرگونه گواهی CA واسطه است، انتخاب کنید. - *کلید خصوصی* - کلید خصوصی مربوط به گواهی شما. روی *انتخاب فایل* کلیک کنید و فایل `.key` رمزگذاری شده با PEM را انتخاب کنید. - *گواهینامههای ابطالشده* (اختیاری) - اگر فهرست ابطال گواهی (CRL) را نگهداری میکنید، روی *انتخاب فایل* کلیک کنید و فایل CRL را برای مشخص کردن گواهینامههایی که دیگر نباید مورد اعتماد باشند، انتخاب کنید. پس از انتخاب فایلها، روی *ذخیره* کلیک کنید. فایلها آپلود، اعتبارسنجی و برای پیکربندی رمزگذاری TLS بین اجزای Zabbix اعمال میشوند. ![](../../assets/en/cloud/quickstart/encryption_tab.png){width="600"} # event.acknowledge # تایید رویداد #### Event correlation Create custom event correlation rules. [Correlation API](/manual/api/reference/correlation) #### همبستگی رویدادقوانین همبستگی رویداد سفارشی ایجاد کنید.[رابط برنامهنویسی همبستگی](/manual/api/reference/correlation) # event.get دریافت رخداد #### Events Retrieve events generated by triggers, network discovery and other Zabbix systems for more flexible situation management or third-party tool integration. [Event API](/manual/api/reference/event) #### رویدادها رویدادهای تولید شده توسط triggerها، کشف شبکه و سایر سیستمهای Zabbix را برای مدیریت انعطافپذیرتر موقعیت یا ادغام ابزار شخص ثالث بازیابی کنید.[Event API](/manual/api/reference/event) ### Example ### مثال ##### Example 1 To create a "Web scenario failed" trigger, you can define a trigger expression: last(/host/web.test.fail[Scenario])<>0 Make sure to replace 'Scenario' with the real name of your scenario. ##### مثال ۱ برای ایجاد یک تریگر "سناریوی وب ناموفق بود"، میتوانید یک عبارت تریگر تعریف کنید: last(/host/web.test.fail[Scenario])<>0 مطمئن شوید که 'Scenario' را با نام واقعی سناریوی خود جایگزین میکنید. ##### Example 2 To create a "Web scenario failed" trigger with a useful problem description in the trigger name, you can define a trigger with name: Web scenario "Scenario" failed: {ITEM.VALUE} and trigger expression: length(last(/host/web.test.error[Scenario]))>0 and last(/host/web.test.fail[Scenario])>0 Make sure to replace 'Scenario' with the real name of your scenario. ##### مثال ۲ برای ایجاد یک تریگر "سناریوی وب ناموفق" با شرح مشکل مفید در نام تریگر، میتوانید تریگری با نام زیر تعریف کنید: سناریوی وب "سناریو" ناموفق: {ITEM.VALUE} و عبارت تریگر: length(last(/host/web.test.error[Scenario]))>0 و last(/host/web.test.fail[Scenario])>0 مطمئن شوید که 'Scenario' را با نام واقعی سناریوی خود جایگزین میکنید. ##### Example 3 To create a "Web application is slow" trigger, you can define a trigger expression: last(/host/web.test.in[Scenario,,bps])<10000 Make sure to replace 'Scenario' with the real name of your scenario. ##### مثال ۳ برای ایجاد یک تریگر "برنامه وب کند است"، میتوانید یک عبارت تریگر تعریف کنید: last(/host/web.test.in[Scenario,,bps])<10000 مطمئن شوید که 'Scenario' را با نام واقعی سناریوی خود جایگزین میکنید. ### Examples ### Examples ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثالها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples ### مثال ها ### Examples The following examples aim to only describe the configuration of the dashboard widget field objects for the *Action log* widget. For more information on configuring a dashboard, see [`dashboard.create`](/manual/api/reference/dashboard/create). ### مثالها مثالهای زیر فقط پیکربندی اشیاء فیلد ویجت داشبورد را برای ویجت *Action log* شرح میدهند. برای اطلاعات بیشتر در مورد پیکربندی داشبورد، به [`dashboard.create`](/manual/api/reference/dashboard/create) مراجعه کنید. ### Examples The following examples aim to only describe the configuration of the dashboard widget field objects for the *Clock* widget. For more information on configuring a dashboard, see [`dashboard.create`](/manual/api/reference/dashboard/create). ### مثالها مثالهای زیر فقط پیکربندی اشیاء فیلد ویجت داشبورد را برای ویجت *Action log* شرح میدهند. برای اطلاعات بیشتر در مورد پیکربندی داشبورد، به [`dashboard.create`](/manual/api/reference/dashboard/create) مراجعه کنید. ### Examples The following examples aim to only describe the configuration of the dashboard widget field objects for the *Discovery status* widget. For more information on configuring a dashboard, see [`dashboard.create`](/manual/api/reference/dashboard/create). ### مثال ها هدف مثالهای زیر فقط تشریح پیکربندی اشیاء فیلد ویجت داشبورد برای ویجت *نمای کلی داده* است. برای اطلاعات بیشتر در مورد پیکربندی داشبورد، به [`dashboard.create`](/manual/api/reference/dashboard/create) مراجعه کنید. ### Examples The following examples aim to only describe the configuration of the dashboard widget field objects for the *Favorite graphs* widget. For more information on configuring a dashboard, see [`dashboard.create`](/manual/api/reference/dashboard/create). ### مثالها مثالهای زیر فقط پیکربندی اشیاء فیلد ویجت داشبورد را برای ویجت *Action log* شرح میدهند. برای اطلاعات بیشتر در مورد پیکربندی داشبورد، به [`dashboard.create`](/manual/api/reference/dashboard/create) مراجعه کنید. ### Examples The following examples aim to only describe the configuration of the dashboard widget field objects for the *Favorite maps* widget. For more information on configuring a dashboard, see [`dashboard.create`](/manual/api/reference/dashboard/create). ### مثالها مثالهای زیر فقط پیکربندی اشیاء فیلد ویجت داشبورد را برای ویجت *Action log* شرح میدهند. برای اطلاعات بیشتر در مورد پیکربندی داشبورد، به [`dashboard.create`](/manual/api/reference/dashboard/create) مراجعه کنید. ### Examples The following examples aim to only describe the configuration of the dashboard widget field objects for the *Pie chart* widget. For more information on configuring a dashboard, see [`dashboard.create`](/manual/api/reference/dashboard/create). ### مثالها مثالهای زیر فقط پیکربندی اشیاء فیلد ویجت داشبورد را برای ویجت *نمودار دایرهای* شرح میدهند. برای اطلاعات بیشتر در مورد پیکربندی داشبورد، به [`dashboard.create`](/manual/api/reference/dashboard/create) مراجعه کنید. ### Examples The following examples aim to only describe the configuration of the dashboard widget field objects for the *Top hosts* widget. For more information on configuring a dashboard, see [`dashboard.create`](/manual/api/reference/dashboard/create). ### مثال ها هدف مثالهای زیر فقط تشریح پیکربندی اشیاء فیلد ویجت داشبورد برای ویجت *نمای کلی داده* است. برای اطلاعات بیشتر در مورد پیکربندی داشبورد، به [`dashboard.create`](/manual/api/reference/dashboard/create) مراجعه کنید. ### Examples The following examples aim to only describe the configuration of the dashboard widget field objects for the *Web monitoring* widget. For more information on configuring a dashboard, see [`dashboard.create`](/manual/api/reference/dashboard/create). ### مثالها مثالهای زیر تنها با هدف توصیف پیکربندی اشیاء فیلد ویجت داشبورد برای ویجت *نظارت وب (Web monitoring)* ارائه شدهاند. برای اطلاعات بیشتر درباره پیکربندی داشبورد، به [`dashboard.create`](/manual/api/reference/dashboard/create) مراجعه کنید. #### Examples The following examples show common Zabbix API tasks using the zabbix\_utils library. Additional examples are available in the `examples` directory of the [zabbix_utils](https://github.com/zabbix/python-zabbix-utils) GitHub repository. #### مثالها (Examples) نمونههای زیر برخی از **کارهای رایج با Zabbix API** را با استفاده از کتابخانه **zabbix_utils** نشان میدهند. مثالهای بیشتر در دایرکتوری `examples` موجود در مخزن GitHub مربوط به zabbix_utils قابل دسترسی هستند: [GitHub – zabbix_utils](https://github.com/zabbix/python-zabbix-utils) # Examples This section provides files of sample modules and widgets, which you can use as a base for your custom modules. To use a module: 1. Download the ZIP archive. 2. Unpack the content into a separate directory inside the *modules* directory of your Zabbix frontend installation (for example, *zabbix/ui/modules*). 3. Register the module in Zabbix frontend. # مثالها این بخش فایلهایی از ماژولها و ویجتهای نمونه را ارائه میدهد که میتوانید از آنها به عنوان پایه برای ماژولهای سفارشی خود استفاده کنید. برای استفاده از یک ماژول: 1. فایل فشرده را دانلود کنید. 2. محتوا را در یک پوشه جداگانه در داخل پوشه *modules* از محل نصب زبیکس فرانتاند خود (به عنوان مثال، *zabbix/ui/modules*) از حالت فشرده خارج کنید. 3. ماژول را در زبیکس فرانتاند ثبت کنید. # Examples You can use several empty examples, as well as existing loadable plugins provided by Zabbix, as a reference: - [Example plugin for Zabbix agent 2](https://git.zabbix.com/projects/AP/repos/example/browse) - [MSSQL plugin](https://git.zabbix.com/projects/AP/repos/mssql/browse) - [MongoDB plugin](https://git.zabbix.com/projects/AP/repos/mongodb/browse) - [PostgreSQL plugin](https://git.zabbix.com/projects/AP/repos/postgresql/browse) See the full list of [plugins](/manual/extensions/plugins#builtin-plugins) provided by Zabbix. # مثال شما میتوانید از چندین مثال خالی و همچنین افزونههای قابل بارگذاری موجود ارائه شده توسط Zabbix به عنوان مرجع استفاده کنید: - [مثال افزونه برای Zabbix agent 2](https://git.zabbix.com/projects/AP/repos/example/browse) - [مثال افزونه MSSQl](https://git.zabbix.com/projects/AP/repos/mssql/browse) - [مثال افزونه MongoDB](https://git.zabbix.com/projects/AP/repos/mongodb/browse) - [جمله افزونه PostgreSQL](https://git.zabbix.com/projects/AP/repos/postgresql/browse) #### Export and import Export and import Zabbix configuration data for configuration backups, migration or large-scale configuration updates. [Configuration API](/manual/api/reference/configuration) دادههای پیکربندی زبیکس را برای پشتیبانگیری از پیکربندی، مهاجرت یا بهروزرسانیهای پیکربندی در مقیاس بزرگ، استخراج و وارد کنید.[API پیکربندی](/manual/api/reference/configuration) #### Exported elements |Element|Type|Description| |------|---|---------| |uuid|string|Unique identifier for this host group. | |name|string|Group name.| #### عناصر صادر شده |عنصر|نوع|توضیحات| |------|---|--------| |uuid|string|شناسه منحصر به فرد برای این گروه الگو. | |name|string|نام گروه.| #### Exported elements |Element|Type|Description| |------|---|---------| |uuid|string|Unique identifier for this template group. | |name|string|Group name.| #### عناصر صادر شده |عنصر|نوع|توضیحات| |------|---|--------| |uuid|string|شناسه منحصر به فرد برای این گروه الگو. | |name|string|نام گروه.| ### Exported elements Exported elements are explained in the table below. |Element|<|Type|Description| |-|---|---|-----------------------| |images|<| |Root element for images.| |<|name|string|Unique image name.| |^|imagetype|integer|Image type.<br>Possible values:<br>1 - Image;<br>2 - Background.| |^|encodedImage|string|Base64 encoded image.| |maps|<| |Root element for [maps](#maps).| ### عناصر خروجی عناصر خروجی در جدول زیر توضیح داده شدهاند. |عنصر|<|نوع|توضیحات| |-|---|---|---------------------| |تصاویر|<| |عنصر ریشه برای تصاویر.| |<|نام|رشته|نام تصویر منحصر به فرد.| |^|نوع تصویر|عدد صحیح|نوع تصویر.<br>مقادیر ممکن:<br>1 - تصویر؛<br>2 - پسزمینه.| |^|تصویر کدگذاری شده|رشته|تصویر کدگذاری شده Base64.| |نقشهها|<| |عنصر ریشه برای [نقشهها](#نقشهها).| #### Exported elements Exported elements are explained in the table below. |Element|<|Type|Description| |-|---|---|-----------------------| |name|<|string|(required) Media type name.| |type|<|string|(required) Transport used by the media type.<br>Possible values:^[1](#footnotes)^ EMAIL (0), SMS (1), SCRIPT (2), WEBHOOK (4).| |status|<|string|Whether the media type is enabled.<br>Possible values:^[1](#footnotes)^ ENABLED (0, default), DISABLED (1)| |max\_sessions|<|integer|The maximum number of alerts that can be processed in parallel.<br>Possible values for SMS:^[1](#footnotes)^ 1 (default).<br>Possible values for other media types:^[1](#footnotes)^ 0-100 (where 0 - unlimited).| |attempts|<|integer|The maximum number of attempts to send an alert.<br>Possible values:^[1](#footnotes)^ 1-10 (default: 3).| |attempt\_interval|<|string|The interval (using seconds or [time suffix](/manual/appendix/suffixes#time-suffixes)) between retry attempts.<br>Possible values:^[1](#footnotes)^ 0-60s (default: 10s).| |description|<|string|Media type description.| |message\_templates|<| |Root element for media type message templates.| |<|event\_source|string|(required) Event source.<br>Possible values:^[1](#footnotes)^ TRIGGERS (0), DISCOVERY (1), AUTOREGISTRATION (2), INTERNAL (3), SERVICE (4).| |^|operation\_mode|string|Operation mode.<br>Possible values:^[1](#footnotes)^ PROBLEM (0), RECOVERY (1), UPDATE (2).| |^|subject|string|Message subject.| |^|message|string|Message body.| ::: noteclassic See also: [Media type object](/manual/api/reference/mediatype/object) (refer to the relevant property with a matching name). ::: #### عناصر خروجی گرفته شده عناصر خروجی گرفته شده در جدول زیر توضیح داده شدهاند. |عنصر|<|نوع|توضیحات| |-|---|---|----------------------| |نام|<|رشته|(الزامی) نام نوع رسانه.| |نوع|<|رشته|(الزامی) انتقال مورد استفاده توسط نوع رسانه.<br>مقادیر ممکن:^[1](#footnotes)^ EMAIL (0)، SMS (1)، SCRIPT (2)، WEBHOOK (4).| |وضعیت|<|رشته|آیا نوع رسانه فعال است.<br>مقادیر ممکن:^[1](#footnotes)^ ENABLED (0، پیشفرض)، DISABLED (1)| |max\_sessions|<|integer|حداکثر تعداد هشدارهایی که میتوانند به صورت موازی پردازش شوند.<br>مقادیر ممکن برای پیامک:^[1](#footnotes)^ 1 (پیشفرض).<br>مقادیر ممکن برای سایر انواع رسانه:^[1](#footnotes)^ 0-100 (که در آن 0 - نامحدود).| |attempts|<|integer|حداکثر تعداد تلاش برای ارسال هشدار.<br>مقادیر ممکن:^[1](#footnotes)^ 1-10 (پیشفرض: 3).| |attempt\_interval|<|string|فاصله زمانی (با استفاده از ثانیه یا [پسوند زمان](/manual/appendix/suffixes#time-suffixes)) بین تلاشهای مجدد.<br>مقادیر ممکن:^[1](#footnotes)^ 0-60 ثانیه (پیشفرض: 10 ثانیه).| |شرح|<|رشته|شرح نوع رسانه.| |الگوهای پیام|<| |عنصر ریشه برای قالبهای پیام از نوع رسانه.| |<|منبع رویداد|رشته|(الزامی) منبع رویداد.<br>مقادیر ممکن:^[1](#footnotes)^ محرکها (0)، کشف (1)، ثبت خودکار (2)، داخلی (3)، سرویس (4).| |^|حالت عملیات|رشته|حالت عملیات.<br>مقادیر ممکن:^[1](#footnotes)^ مشکل (0)، بازیابی (1)، بهروزرسانی (2).| |^|موضوع|رشته|موضوع پیام.| |^|پیام|رشته|بدنه پیام.| ::: noteclassic همچنین ببینید: [شیء نوع رسانه](/manual/api/reference/mediatype/object) (به ویژگی مربوطه با نام منطبق مراجعه کنید). ::: ##### Export format Data can be exported using the Zabbix web frontend or [Zabbix API](/manual/api/reference/configuration). Supported export formats are YAML, XML and JSON. ##### فرمت خروجی دادهها را میتوان با استفاده از رابط وب زبیکس یا [Zabbix API](/manual/api/reference/configuration) خروجی گرفت. فرمتهای خروجی پشتیبانیشده عبارتند از YAML، XML و JSON. #### Export format Export to YAML: ```yaml zabbix_export: version: '7.4' images: - name: Zabbix_server_3D_(128) imagetype: '1' encodedImage: iVBOR...5CYII= maps: - name: 'Local network' width: '680' height: '200' label_type: '0' label_location: '0' highlight: '1' expandproblem: '1' markelements: '1' show_unack: '0' severity_min: '0' show_suppressed: '0' grid_size: '50' grid_show: '1' grid_align: '1' label_format: '0' label_type_host: '2' label_type_hostgroup: '2' label_type_trigger: '2' label_type_map: '2' label_type_image: '2' label_string_host: '' label_string_hostgroup: '' label_string_trigger: '' label_string_map: '' label_string_image: '' expand_macros: '1' background: { } iconmap: { } urls: { } selements: - elementtype: '0' elements: - host: 'Zabbix server' label: | {HOST.NAME} {HOST.CONN} label_location: '0' x: '111' 'y': '61' elementsubtype: '0' areatype: '0' width: '200' height: '200' viewtype: '0' use_iconmap: '0' selementid: '1' icon_off: name: Zabbix_server_3D_(128) icon_on: { } icon_disabled: { } icon_maintenance: { } urls: { } evaltype: '0' shapes: - type: '0' x: '0' 'y': '0' width: '680' height: '15' text: '{MAP.NAME}' font: '9' font_size: '11' font_color: '000000' text_halign: '0' text_valign: '0' border_type: '0' border_width: '0' border_color: '000000' background_color: '' zindex: '0' lines: { } links: { } ``` #### فرمت خروجی خروجی به YAML: ```yaml zabbix_export: نسخه: '7.4' تصاویر: - نام: Zabbix_server_3D_(128) نوع تصویر: '1' تصویر کدگذاری شده: iVBOR...5CYII= نقشهها: - نام: 'شبکه محلی' عرض: '680' ارتفاع: '200' نوع برچسب: '0' محل برچسب: '0' هایلایت: '1' مشکل گسترش: '1' عناصر نشانهگذاری: '1' نمایش خطا: '0' شدت خطا: '0' نمایش خطا: '0' اندازه شبکه: '50' نمایش خطا: '1' تراز شبکه: '1' قالب برچسب: '0' نوع برچسب: میزبان: '2' گروه نوع برچسب: '2' label_type_trigger: '2' label_type_map: '2' label_type_image: '2' label_string_host: '' label_string_hostgroup: '' label_string_trigger: '' label_string_map: '' label_string_image: '' expand_macros: '1' background: { } iconmap: { } urls: { } elements: - elementtype: '0' elements: - host: 'Zabbix server' label: | {HOST.NAME} {HOST.CONN} label_location: '0' x: '111' 'y': '61' elementssubtype: '0' areatype: '0' width: '200' height: '200' viewtype: '0' use_iconmap: '0' selementid: '1' icon_off: name: Zabbix_server_3D_(128) icon_on: { } icon_disabled: { } icon_maintenance: { } urls: { } evaltype: '0' shapes: - type: '0' x: '0' 'y': '0' width: '680' height: '15' text: '{MAP.NAME}' font: '9' font_size: '11' font_color: '000000' text_halign: '0' text_valign: '0' border_type: '0' border_width: '0' border_color: '000000' background_color: '' zindex: '0' lines: { } links: { } ``` #### Export format Export to YAML: ```yaml zabbix_export: version: '7.4' media_types: - name: Pushover type: WEBHOOK parameters: - name: endpoint value: 'https://api.pushover.net/1/messages.json' - name: eventid value: '{EVENT.ID}' - name: event_nseverity value: '{EVENT.NSEVERITY}' - name: event_source value: '{EVENT.SOURCE}' - name: event_value value: '{EVENT.VALUE}' - name: expire value: '1200' - name: message value: '{ALERT.MESSAGE}' - name: priority_average value: '0' - name: priority_default value: '0' - name: priority_disaster value: '0' - name: priority_high value: '0' - name: priority_information value: '0' - name: priority_not_classified value: '0' - name: priority_warning value: '0' - name: retry value: '60' - name: title value: '{ALERT.SUBJECT}' - name: token value: '<PUSHOVER TOKEN HERE>' - name: triggerid value: '{TRIGGER.ID}' - name: url value: '{$ZABBIX.URL}' - name: url_title value: Zabbix - name: user value: '{ALERT.SENDTO}' status: DISABLED max_sessions: '0' script: | try { var params = JSON.parse(value), request = new HttpRequest(), data, response, severities = [ {name: 'not_classified', color: '#97AAB3'}, {name: 'information', color: '#7499FF'}, {name: 'warning', color: '#FFC859'}, {name: 'average', color: '#FFA059'}, {name: 'high', color: '#E97659'}, {name: 'disaster', color: '#E45959'}, {name: 'resolved', color: '#009900'}, {name: 'default', color: '#000000'} ], priority; if (typeof params.HTTPProxy === 'string' && params.HTTPProxy.trim() !== '') { request.setProxy(params.HTTPProxy); } if ([0, 1, 2, 3].indexOf(parseInt(params.event_source)) === -1) { throw 'Incorrect "event_source" parameter given: "' + params.event_source + '".\nMust be 0-3.'; } if (params.event_value !== '0' && params.event_value !== '1' && (params.event_source === '0' || params.event_source === '3')) { throw 'Incorrect "event_value" parameter given: ' + params.event_value + '\nMust be 0 or 1.'; } if ([0, 1, 2, 3, 4, 5].indexOf(parseInt(params.event_nseverity)) === -1) { params.event_nseverity = '7'; } if (params.event_value === '0') { params.event_nseverity = '6'; } priority = params['priority_' + severities[params.event_nseverity].name] || params.priority_default; if (isNaN(priority) || priority < -2 || priority > 2) { throw '"priority" should be -2..2'; } if (params.event_source === '0' && isNaN(params.triggerid)) { throw 'field "triggerid" is not a number'; } if (isNaN(params.eventid)) { throw 'field "eventid" is not a number'; } if (typeof params.message !== 'string' || params.message.trim() === '') { throw 'field "message" cannot be empty'; } data = { token: params.token, user: params.user, title: params.title, message: params.message, url: (params.event_source === '0') ? params.url + '/tr_events.php?triggerid=' + params.triggerid + '&eventid=' + params.eventid : params.url, url_title: params.url_title, priority: priority }; if (priority == 2) { if (isNaN(params.retry) || params.retry < 30) { throw 'field "retry" should be a number with value of at least 30 if "priority" is set to 2'; } if (isNaN(params.expire) || params.expire > 10800) { throw 'field "expire" should be a number with value of at most 10800 if "priority" is set to 2'; } data.retry = params.retry; data.expire = params.expire; } data = JSON.stringify(data); Zabbix.log(4, '[ Pushover Webhook ] Sending request: ' + params.endpoint + '\n' + data); request.addHeader('Content-Type: application/json'); response = request.post(params.endpoint, data); Zabbix.log(4, '[ Pushover Webhook ] Received response with status code ' + request.getStatus() + '\n' + response); if (response !== null) { try { response = JSON.parse(response); } catch (error) { Zabbix.log(4, '[ Pushover Webhook ] Failed to parse response received from Pushover'); response = null; } } if (request.getStatus() != 200 || response === null || typeof response !== 'object' || response.status !== 1) { if (response !== null && typeof response === 'object' && typeof response.errors === 'object' && typeof response.errors[0] === 'string') { throw response.errors[0]; } else { throw 'Unknown error. Check debug log for more information.'; } } return 'OK'; } catch (error) { Zabbix.log(4, '[ Pushover Webhook ] Pushover notification failed: ' + error); throw 'Pushover notification failed: ' + error; } description: | Please refer to setup guide here: https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/pushover?at=refs%2Fheads%2Frelease%2F7.4 Set token parameter with to your Pushover application key. When assigning Pushover media to the Zabbix user - add user key into send to field. message_templates: - event_source: TRIGGERS operation_mode: PROBLEM subject: 'Problem: {EVENT.NAME}' message: | Problem started at {EVENT.TIME} on {EVENT.DATE} Problem name: {EVENT.NAME} Host: {HOST.NAME} Severity: {EVENT.SEVERITY} Operational data: {EVENT.OPDATA} Original problem ID: {EVENT.ID} {TRIGGER.URL} - event_source: TRIGGERS operation_mode: RECOVERY subject: 'Resolved in {EVENT.DURATION}: {EVENT.NAME}' message: | Problem has been resolved at {EVENT.RECOVERY.TIME} on {EVENT.RECOVERY.DATE} Problem name: {EVENT.NAME} Problem duration: {EVENT.DURATION} Host: {HOST.NAME} Severity: {EVENT.SEVERITY} Original problem ID: {EVENT.ID} {TRIGGER.URL} - event_source: TRIGGERS operation_mode: UPDATE subject: 'Updated problem in {EVENT.AGE}: {EVENT.NAME}' message: | {USER.FULLNAME} {EVENT.UPDATE.ACTION} problem at {EVENT.UPDATE.DATE} {EVENT.UPDATE.TIME}. {EVENT.UPDATE.MESSAGE} Current problem status is {EVENT.STATUS}, age is {EVENT.AGE}, acknowledged: {EVENT.ACK.STATUS}. - event_source: DISCOVERY operation_mode: PROBLEM subject: 'Discovery: {DISCOVERY.DEVICE.STATUS} {DISCOVERY.DEVICE.IPADDRESS}' message: | Discovery rule: {DISCOVERY.RULE.NAME} Device IP: {DISCOVERY.DEVICE.IPADDRESS} Device DNS: {DISCOVERY.DEVICE.DNS} Device status: {DISCOVERY.DEVICE.STATUS} Device uptime: {DISCOVERY.DEVICE.UPTIME} Device service name: {DISCOVERY.SERVICE.NAME} Device service port: {DISCOVERY.SERVICE.PORT} Device service status: {DISCOVERY.SERVICE.STATUS} Device service uptime: {DISCOVERY.SERVICE.UPTIME} - event_source: AUTOREGISTRATION operation_mode: PROBLEM subject: 'Autoregistration: {HOST.HOST}' message: | Host name: {HOST.HOST} Host IP: {HOST.IP} Agent port: {HOST.PORT} ``` #### فرمت خروجی Export to YAML: ```yaml zabbix_export: version: '6.0' date: '2021-08-31T13:34:17Z' media_types: - name: Pushover type: WEBHOOK parameters: - name: endpoint value: 'https://api.pushover.net/1/messages.json' - name: eventid value: '{EVENT.ID}' - name: event_nseverity value: '{EVENT.NSEVERITY}' - name: event_source value: '{EVENT.SOURCE}' - name: event_value value: '{EVENT.VALUE}' - name: expire value: '1200' - name: message value: '{ALERT.MESSAGE}' - name: priority_average value: '0' - name: priority_default value: '0' - name: priority_disaster value: '0' - name: priority_high value: '0' - name: priority_information value: '0' - name: priority_not_classified value: '0' - name: priority_warning value: '0' - name: retry value: '60' - name: title value: '{ALERT.SUBJECT}' - name: token value: '<PUSHOVER TOKEN HERE>' - name: triggerid value: '{TRIGGER.ID}' - name: url value: '{$ZABBIX.URL}' - name: url_title value: Zabbix - name: user value: '{ALERT.SENDTO}' max_sessions: '0' script: | try { var params = JSON.parse(value), request = new HttpRequest(), data, response, severities = [ {name: 'not_classified', color: '#97AAB3'}, {name: 'information', color: '#7499FF'}, {name: 'warning', color: '#FFC859'}, {name: 'average', color: '#FFA059'}, {name: 'high', color: '#E97659'}, {name: 'disaster', color: '#E45959'}, {name: 'resolved', color: '#009900'}, {name: 'default', color: '#000000'} ], priority; if (typeof params.HTTPProxy === 'string' && params.HTTPProxy.trim() !== '') { request.setProxy(params.HTTPProxy); } if ([0, 1, 2, 3].indexOf(parseInt(params.event_source)) === -1) { throw 'Incorrect "event_source" parameter given: "' + params.event_source + '".\nMust be 0-3.'; } if (params.event_value !== '0' && params.event_value !== '1' && (params.event_source === '0' || params.event_source === '3')) { throw 'Incorrect "event_value" parameter given: ' + params.event_value + '\nMust be 0 or 1.'; } if ([0, 1, 2, 3, 4, 5].indexOf(parseInt(params.event_nseverity)) === -1) { params.event_nseverity = '7'; } if (params.event_value === '0') { params.event_nseverity = '6'; } priority = params['priority_' + severities[params.event_nseverity].name] || params.priority_default; if (isNaN(priority) || priority < -2 || priority > 2) { throw '"priority" should be -2..2'; } if (params.event_source === '0' && isNaN(params.triggerid)) { throw 'field "triggerid" is not a number'; } if (isNaN(params.eventid)) { throw 'field "eventid" is not a number'; } if (typeof params.message !== 'string' || params.message.trim() === '') { throw 'field "message" cannot be empty'; } data = { token: params.token, user: params.user, title: params.title, message: params.message, url: (params.event_source === '0') ? params.url + '/tr_events.php?triggerid=' + params.triggerid + '&eventid=' + params.eventid : params.url, url_title: params.url_title, priority: priority }; if (priority == 2) { if (isNaN(params.retry) || params.retry < 30) { throw 'field "retry" should be a number with value of at least 30 if "priority" is set to 2'; } if (isNaN(params.expire) || params.expire > 10800) { throw 'field "expire" should be a number with value of at most 10800 if "priority" is set to 2'; } data.retry = params.retry; data.expire = params.expire; } data = JSON.stringify(data); Zabbix.log(4, '[ Pushover Webhook ] Sending request: ' + params.endpoint + '\n' + data); request.addHeader('Content-Type: application/json'); response = request.post(params.endpoint, data); Zabbix.log(4, '[ Pushover Webhook ] Received response with status code ' + request.getStatus() + '\n' + response); if (response !== null) { try { response = JSON.parse(response); } catch (error) { Zabbix.log(4, '[ Pushover Webhook ] Failed to parse response received from Pushover'); response = null; } } if (request.getStatus() != 200 || response === null || typeof response !== 'object' || response.status !== 1) { if (response !== null && typeof response === 'object' && typeof response.errors === 'object' && typeof response.errors[0] === 'string') { throw response.errors[0]; } else { throw 'Unknown error. Check debug log for more information.'; } } return 'OK'; } catch (error) { Zabbix.log(4, '[ Pushover Webhook ] Pushover notification failed: ' + error); throw 'Pushover notification failed: ' + error; } description: | Please refer to setup guide here: https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/pushover Set token parameter with to your Pushover application key. When assigning Pushover media to the Zabbix user - add user key into send to field. message_templates: - event_source: TRIGGERS operation_mode: PROBLEM subject: 'Problem: {EVENT.NAME}' message: | Problem started at {EVENT.TIME} on {EVENT.DATE} Problem name: {EVENT.NAME} Host: {HOST.NAME} Severity: {EVENT.SEVERITY} Operational data: {EVENT.OPDATA} Original problem ID: {EVENT.ID} {TRIGGER.URL} - event_source: TRIGGERS operation_mode: RECOVERY subject: 'Resolved in {EVENT.DURATION}: {EVENT.NAME}' message: | Problem has been resolved at {EVENT.RECOVERY.TIME} on {EVENT.RECOVERY.DATE} Problem name: {EVENT.NAME} Problem duration: {EVENT.DURATION} Host: {HOST.NAME} Severity: {EVENT.SEVERITY} Original problem ID: {EVENT.ID} {TRIGGER.URL} - event_source: TRIGGERS operation_mode: UPDATE subject: 'Updated problem in {EVENT.AGE}: {EVENT.NAME}' message: | {USER.FULLNAME} {EVENT.UPDATE.ACTION} problem at {EVENT.UPDATE.DATE} {EVENT.UPDATE.TIME}. {EVENT.UPDATE.MESSAGE} Current problem status is {EVENT.STATUS}, age is {EVENT.AGE}, acknowledged: {EVENT.ACK.STATUS}. - event_source: DISCOVERY operation_mode: PROBLEM subject: 'Discovery: {DISCOVERY.DEVICE.STATUS} {DISCOVERY.DEVICE.IPADDRESS}' message: | Discovery rule: {DISCOVERY.RULE.NAME} Device IP: {DISCOVERY.DEVICE.IPADDRESS} Device DNS: {DISCOVERY.DEVICE.DNS} Device status: {DISCOVERY.DEVICE.STATUS} Device uptime: {DISCOVERY.DEVICE.UPTIME} Device service name: {DISCOVERY.SERVICE.NAME} Device service port: {DISCOVERY.SERVICE.PORT} Device service status: {DISCOVERY.SERVICE.STATUS} Device service uptime: {DISCOVERY.SERVICE.UPTIME} - event_source: AUTOREGISTRATION operation_mode: PROBLEM subject: 'Autoregistration: {HOST.HOST}' message: | Host name: {HOST.HOST} Host IP: {HOST.IP} Agent port: {HOST.PORT} ``` #### Export format When a host is exported, Zabbix generates a structured YAML, JSON, or XML format. The export includes host elements, such as host metadata, items, macros, triggers, and more. Each element serves a specific purpose and may contain nested elements. The following sections describe each element in the export format. The examples use a host with the [MySQL by Zabbix agent 2](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/mysql_agent2) template. For element demonstration purposes, the template is unlinked after the host is created. Unlinking keeps all elements in the configuration (unlike unlinking and clearing, which removes them). An ellipsis `(...)` indicates elements omitted for brevity. The note `(see table below)` is used when the element is explained in more detail in later sections. #### فرمت خروجی هنگامی که یک میزبان خروجی گرفته میشود، زبیکس یک فرمت ساختارمند YAML، JSON یا XML تولید میکند. خروجی شامل عناصر میزبان، مانند فراداده میزبان، آیتمها، ماکروها، تریگرها و موارد دیگر است. هر عنصر هدف خاصی را دنبال میکند و ممکن است حاوی عناصر تو در تو باشد. بخشهای زیر هر عنصر را در فرمت خروجی شرح میدهند. مثالها از یک میزبان با الگوی [MySQL by Zabbix agent 2](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/mysql_agent2) استفاده میکنند. برای اهداف نمایشی عنصر، الگو پس از ایجاد میزبان، پیوند خود را از دست میدهد. حذف پیوند، تمام عناصر را در پیکربندی نگه میدارد (برخلاف حذف پیوند و پاکسازی، که آنها را حذف میکند). یک حذف `(...)` عناصری را که برای اختصار حذف شدهاند، نشان میدهد. یادداشت «(به جدول زیر مراجعه کنید)» زمانی استفاده میشود که عنصر در بخشهای بعدی با جزئیات بیشتری توضیح داده شود. ## Export format When a template is exported, Zabbix generates a structured YAML, JSON, or XML format. The export includes template elements, such as template metadata, items, macros, triggers, dashboards, and more. Each element serves a specific purpose and may contain nested elements. The following sections describe each element in the export format. The examples use the [Linux by Zabbix agent](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/os/linux/template_os_linux.yaml) template. An ellipsis `(...)` indicates elements omitted for brevity. The note `(see table below)` is used when the element is explained in more detail in later sections. ## قالب خروجی هنگامی که یک الگو خروجی گرفته میشود، زبیکس یک قالب ساختارمند YAML، JSON یا XML تولید میکند. خروجی شامل عناصر الگو، مانند فرادادههای الگو، آیتمها، ماکروها، تریگرها، داشبوردها و موارد دیگر است. هر عنصر هدف خاصی را دنبال میکند و ممکن است حاوی عناصر تو در تو باشد. بخشهای زیر هر عنصر را در قالب خروجی شرح میدهند. مثالها از قالب [لینوکس توسط عامل زبیکس](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/os/linux/template_os_linux.yaml) استفاده میکنند. علامت `(...)` نشاندهنده عناصر حذف شده برای اختصار است. یادداشت `(به جدول زیر مراجعه کنید)` زمانی استفاده میشود که عنصر در بخشهای بعدی با جزئیات بیشتری توضیح داده شود. #### Export format ```yaml host_groups: - uuid: 6f6799aa69e844b4b3918f779f2abf08 name: 'Zabbix servers' ``` ##### فرمت خروجی ``` {.yaml} host_groups: - uuid: 6f6799aa69e844b4b3918f779f2abf08 name: 'Zabbix servers' ``` #### Export format ```yaml template_groups: - uuid: 36bff6c29af64692839d077febfc7079 name: 'Network devices' ``` #### فرمت خروجی ```yaml template_groups: - uuid: 36bff6c29af64692839d077febfc7079 name: 'دستگاههای شبکه' ``` #### Extended monitoring Sometimes it is necessary to log received HTML page content. This is especially useful if some web scenario step fails. Debug level 5 (trace) serves that purpose. This level can be set in [server](/manual/appendix/config/zabbix_server#debuglevel) and [proxy](/manual/appendix/config/zabbix_proxy#debuglevel) configuration files or using a [runtime control](/manual/concepts/server#runtime-control) option (`-R log_level_increase="http poller,N"`, where N is the process number). The following examples demonstrate how extended monitoring can be started provided debug level 4 is already set: # Increase log level of all http pollers: zabbix_server -R log_level_increase="http poller" # Increase log level of second http poller: zabbix_server -R log_level_increase="http poller,2" If extended web monitoring is not required it can be stopped using the `-R log_level_decrease` option. #### گسترش مانیتورینگ Sometimes it is necessary to log received HTML page content. This is especially useful if some web scenario step fails. Debug level 5 (trace) serves that purpose. This level can be set in [server](/manual/appendix/config/zabbix_server) and [proxy](/manual/appendix/config/zabbix_proxy) configuration files or using a runtime control option (`-R log_level_increase="http poller,N"`, where N is the process number). The following examples demonstrate how extended monitoring can be started provided debug level 4 is already set: Increase log level of all http pollers: shell> zabbix_server -R log_level_increase="http poller" Increase log level of second http poller: shell> zabbix_server -R log_level_increase="http poller,2" If extended web monitoring is not required it can be stopped using the `-R log_level_decrease` option. #### Feature differences تفاوت ویژگی ها #### Find HTTP agent item prototype Find HTTP agent item prototype with request method HEAD for specific host ID. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "itemprototype.get", "params": { "hostids": "10254", "filter": { "type": 19, "request_method": 3 } }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "itemid": "28257", "type": "19", "snmp_oid": "", "hostid": "10254", "name": "discovered", "key_": "item[{#INAME}]", "delay": "{#IUPDATE}", "history": "90d", "trends": "30d", "status": "0", "value_type": "3", "trapper_hosts": "", "units": "", "logtimefmt": "", "templateid": "28255", "valuemapid": "0", "params": "", "ipmi_sensor": "", "authtype": "0", "username": "", "password": "", "publickey": "", "privatekey": "", "flags": "2", "interfaceid": "2", "description": "", "evaltype": "0", "jmx_endpoint": "", "master_itemid": "0", "timeout": "", "url": "{#IURL}", "query_fields": [], "posts": "", "status_codes": "", "follow_redirects": "0", "post_type": "0", "http_proxy": "", "headers": [], "retrieve_mode": "0", "request_method": "3", "output_format": "0", "ssl_cert_file": "", "ssl_key_file": "", "ssl_key_password": "", "verify_peer": "0", "verify_host": "0", "allow_traps": "0", "discover": "0", "uuid": "", "parameters": [] } ], "id": 1 } ``` #### یافتن نمونه اولیه آیتم عامل HTTP یافتن نمونه اولیه آیتم عامل HTTP با روش درخواست HEAD برای شناسه میزبان خاص.[درخواست](/manual/api#performing-requests):```json{"jsonrpc": "2.0","method": "itemprototype.get","params": {"hostids": "10254","filter": {"type": 19,"request_method": 3}},"id": 1}```Response:```json{"jsonrpc": "2.0","result": [{"itemid": "28257","type": "19","snmp_oid": "","hostid": "10254","name": "discovered","key_": "item[{#INAME}]","delay": "{#IUPDATE}","history": "90d","trends": "30d","status": "0","value_type": "3","trapper_hosts": "","units": "","logtimefmt": "","templateid": "28255","valuemapid": "0","params": "","ipmi_sensor": "","authtype": "0","username": "","password": "","publickey": "","privatekey": "","flags": "2","interfaceid": "2","description": "","evaltype": "0","jmx_endpoint": "","master_itemid": "0","timeout": "","url": "{#IURL}","query_fields": [],"posts": "","status_codes": "","follow_redirects": "0","post_type": "0","http_proxy": "","headers": [],"retrieve_mode": "0","request_method": "3","output_format": "0","ssl_cert_file": "","ssl_key_file": "","ssl_key_password": "","verify_peer": "0","verify_host": "0","allow_traps": "0","discover": "0","uuid": "","parameters": []}],"id": 1}``` #### Finding dependent item Find one Dependent item for specific item ID. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "item.get", "params": { "output": "extend", "filter": { "type": 18, "master_itemid": "25545" }, "limit": "1" }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "itemid": "25547", "type": "18", "snmp_oid": "", "hostid": "10116", "name": "Seconds", "key_": "apache.status.uptime.seconds", "delay": "0", "history": "90d", "trends": "365d", "status": "0", "value_type": "3", "trapper_hosts": "", "units": "", "logtimefmt": "", "templateid": "0", "valuemapid": "0", "params": "", "ipmi_sensor": "", "authtype": "0", "username": "", "password": "", "publickey": "", "privatekey": "", "flags": "0", "interfaceid": "0", "description": "", "evaltype": "0", "master_itemid": "25545", "jmx_endpoint": "", "timeout": "", "url": "", "query_fields": [], "posts": "", "status_codes": "200", "follow_redirects": "1", "post_type": "0", "http_proxy": "", "headers": [], "retrieve_mode": "0", "request_method": "0", "output_format": "0", "ssl_cert_file": "", "ssl_key_file": "", "ssl_key_password": "", "verify_peer": "0", "verify_host": "0", "allow_traps": "0", "discover": "0", "uuid": "", "parameters": [] } ], "id": 1 } ``` #### یافتن آیتم وابسته یافتن یک آیتم وابسته برای یک آیتم خاص با شناسه [Request](/manual/api#performing-requests):```json{"jsonrpc": "2.0","method": "item.get","params": {"output": "extend","filter": {"type": 18,"master_itemid": "25545"},"limit": "1"},"id": 1}```Response:```json{"jsonrpc": "2.0","result": [{"itemid": "25547","type": "18","snmp_oid": "","hostid": "10116","name": "Seconds","key_": "apache.status.uptime.seconds","delay": "0","history": "90d","trends": "365d","status": "0","value_type": "3","trapper_hosts": "","units": "","logtimefmt": "","templateid": "0","valuemapid": "0","params": "","ipmi_sensor": "","authtype": "0","username": "","password": "","publickey": "","privatekey": "","flags": "0","interfaceid": "0","description": "","evaltype": "0","master_itemid": "25545","jmx_endpoint": "","timeout": "","url": "","query_fields": [],"posts": "","status_codes": "200","follow_redirects": "1","post_type": "0","http_proxy": "","headers": [],"retrieve_mode": "0","request_method": "0","output_format": "0","ssl_cert_file": "","ssl_key_file": "","ssl_key_password": "","verify_peer": "0","verify_host": "0","allow_traps": "0","discover": "0","uuid": "","parameters": []}],"id": 1}``` ## Footnotes ^1^ API integer values in brackets, for example, ENABLED (0), are mentioned only for reference. For more information, see the linked API object page in the table entry or at the end of each section. ## پاورقیها ^1^ مقادیر صحیح API داخل پرانتز، برای مثال، ENABLED (0)، فقط برای مرجع ذکر شدهاند. برای اطلاعات بیشتر، به صفحه شیء API لینکشده در ورودی جدول یا در انتهای هر بخش مراجعه کنید. ## Footnotes ^1^ API integer values in brackets, for example, ENABLED (0), are mentioned only for reference. For more information, see the linked API object page in the table entry or at the end of each section. ##### پانویسها و منابع ^**1**^ برای مقادیر رشته، فقط رشته صادر خواهد شد (به عنوان مثال. "ZABBIX\_ACTIVE") بدون شماره گذاری استفاده شده در این جدول. شماره برای مقادیر محدوده (مرتبط با مقادیر API) در این جدول استفاده شده است فقط برای سفارش #### Footnotes ^1^ API integer values in brackets, for example, ENABLED (0), are mentioned only for reference. For more information, see the linked API object page in the table entry or at the end of each section. #### پاورقیها ^1^ مقادیر صحیح API داخل پرانتز، برای مثال، ENABLED (0)، فقط برای مرجع ذکر شدهاند. برای اطلاعات بیشتر، به صفحه شیء API لینکشده در ورودی جدول یا در انتهای هر بخش مراجعه کنید. ### Frontend help A help link ![](../../assets/en/manual/web_interface/help_link.png) is provided in Zabbix frontend forms with direct links to the corresponding parts of the documentation. بخش کمک وب #### General Change certain global configuration options. [Autoregistration API](/manual/api/reference/autoregistration) | [Icon map API](/manual/api/reference/iconmap) | [Image API](/manual/api/reference/image) | [Settings API](/manual/api/reference/settings) | [Regular expression API](/manual/api/reference/regexp) | [Module API](/manual/api/reference/module) | [Connector API](/manual/api/reference/connector) #### عمومی تغییر برخی از گزینههای پیکربندی سراسری.[API ثبت خودکار](/manual/api/reference/autoregistration) | [API نقشه آیکون](/manual/api/reference/iconmap) | [API تصویر](/manual/api/reference/image) | [API تنظیمات](/manual/api/reference/settings) | [API عبارت منظم](/manual/api/reference/regexp) | [API ماژول](/manual/api/reference/module) | [API رابط](/manual/api/reference/connector) ##### Global messages displayed As messages arrive, they are displayed in a floating section on the right-hand side. You can freely reposition this section by dragging the section header. ![global\_messages.png](../../../../assets/en/manual/web_interface/global_messages.png) For this section, several controls are available: - ![](../../../../assets/en/manual/about/message_button_snooze.png) **Snooze** button silences the currently active alarm sound; - ![](../../../../assets/en/manual/about/message_button_mute.png) **Mute/Unmute** button switches between playing and not playing the alarm sounds at all. ##### Global messages displayed As the messages arrive, they are displayed in a floating section on the right hand side. This section can be repositioned freely by dragging the section header. ![global\_messages.png](../../../../assets/en/manual/web_interface/global_messages.png) For this section, several controls are available: - ![](../../../../assets/en/manual/about/message_button_snooze.png) **Snooze** button silences the currently active alarm sound; - ![](../../../../assets/en/manual/about/message_button_mute.png) **Mute/Unmute** button switches between playing and not playing the alarm sounds at all. # graph.create ساخت گراف # graph.delete # حذف گراف # graph.get #دریافت گراف # graphitem.get # دریافت آیتم های گراف # graphprototype.create # ساخت نمونه گراف # graphprototype.delete # حذف نمونه اولیه گراف # graphprototype.get # دریافت نمونه اولیه گراف # graphprototype.update # آپدیت نمونه اولیه گراف #### Graphs Edit graphs or separate graph items for better presentation of the gathered data. [Graph API](/manual/api/reference/graph) | [Graph item API](/manual/api/reference/graphitem) برای نمایش بهتر دادههای جمعآوریشده، نمودارها را ویرایش کنید یا موارد نمودار را از هم جدا کنید.[Graph API](/manual/api/reference/graph) | [Graph itemAPI](/manual/api/reference/graphitem) # graph.update # آپدیت گراف # hanode.get # دریافت نود HA #### Header processing The CSV file header line can be processed in two different ways: - If the *With header row* checkbox is marked - header line values are interpreted as column names. In this case the column names must be unique and the data row should not contain more columns than the header row. - If the *With header row* checkbox is not marked - the header line is interpreted as data. Column names are generated automatically (1,2,3,4...). CSV file example: Nr,Item name,Key,Qty 1,active agent item,agent.hostname,33 "2","passive agent item","agent.version","44" 3,"active,passive agent items",agent.ping,55 ::: noteclassic A quotation character within a quoted field in the input must be escaped by preceding it with another quotation character. ::: **Processing header line** JSON output when a header line is expected: ``` {.json} [ { "Nr":"1", "Item name":"active agent item", "Key":"agent.hostname", "Qty":"33" }, { "Nr":"2", "Item name":"passive agent item", "Key":"agent.version", "Qty":"44" }, { "Nr":"3", "Item name":"active,passive agent items", "Key":"agent.ping", "Qty":"55" } ] ``` **No header line processing** JSON output when a header line is not expected: ``` {.json} [ { "1":"Nr", "2":"Item name", "3":"Key", "4":"Qty" }, { "1":"1", "2":"active agent item", "3":"agent.hostname", "4":"33" }, { "1":"2", "2":"passive agent item", "3":"agent.version", "4":"44" }, { "1":"3", "2":"active,passive agent items", "3":"agent.ping", "4":"55" } ] ``` #### Header processing The CSV file header line can be processed in two different ways: - If the *With header row* checkbox is marked - header line values are interpreted as column names. In this case the column names must be unique and the data row should not contain more columns than the header row; - If the *With header row* checkbox is not marked - the header line is interpreted as data. Column names are generated automatically (1,2,3,4...) CSV file example: Nr,Item name,Key,Qty 1,active agent item,agent.hostname,33 "2","passive agent item","agent.version","44" 3,"active,passive agent items",agent.ping,55 ::: noteclassic A quotation character within a quoted field in the input must be escaped by preceding it with another quotation character. ::: **Processing header line** JSON output when a header line is expected: ``` {.json} [ { "Nr":"1", "Item name":"active agent item", "Key":"agent.hostname", "Qty":"33" }, { "Nr":"2", "Item name":"passive agent item", "Key":"agent.version", "Qty":"44" }, { "Nr":"3", "Item name":"active,passive agent items", "Key":"agent.ping", "Qty":"55" } ] ``` **No header line processing** JSON output when a header line is not expected: ``` {.json} [ { "1":"Nr", "2":"Item name", "3":"Key" "4":"Qty" }, { "1":"1", "2":"active agent item", "3":"agent.hostname" "4":"33" }, { "1":"2", "2":"passive agent item", "3":"agent.version" "4":"44" }, { "1":"3", "2":"active,passive agent items", "3":"agent.ping" "4":"55" } ] ``` ##### Hexadecimal to decimal {#hexadecimal} Convert the value from hexadecimal format to decimal. If you mark the *Custom on fail* checkbox, it is possible to specify custom error-handling options: either to discard the value, set a specified value, or set a specified error message. In case of a failed preprocessing step, the item will not become unsupported if the option to discard the value or set a specified value is selected. ##### هگزادسیمال به دهدهی {#هگزادسیمال}مقدار را از قالب هگزادسیمال به دهدهی تبدیل کنید. اگر کادر *سفارشی شدن در صورت عدم موفقیت* را علامت بزنید، میتوانید گزینههای سفارشی برای مدیریت خطا را تعیین کنید: یا مقدار را حذف کنید، یک مقدار مشخص شده را تنظیم کنید یا یک پیام خطای مشخص شده را تنظیم کنید. در صورت شکست یک مرحله پیشپردازش، اگر گزینه حذف مقدار یا تنظیم یک مقدار مشخص شده انتخاب شود، مورد پشتیبانی نشده باقی میماند. #### High availability cluster Retrieve a list of server nodes and their status. [High availability cluster API](/manual/api/reference/hanode) #### خوشه با قابلیت دسترسی بالافهرستی از گرههای سرور و وضعیت آنها را بازیابی کنید.[رابط برنامهنویسی خوشه با قابلیت دسترسی بالا](/manual/api/reference/hanode) # history.clear #پاک کردن تاریخچه # history.get # گرفتن تاریخچه #### History Retrieve historical values gathered by Zabbix monitoring processes for presentation or further processing. [History API](/manual/api/reference/history) #### Historyمقادیر تاریخی جمعآوریشده توسط فرآیندهای مانیتورینگ زبیکس را برای ارائه یا پردازش بیشتر بازیابی میکند.[History API](/manual/api/reference/history) ## History tab The *History* tab lets you configure how long different types of historical data are stored. ![](../../assets/en/cloud/quickstart/history_tab.png){width="600"} You can set the storage period for each data type (e.g., numeric, text, logs) and choose the unit (days, months, years). Changes can be made up to three times every 24 hours. After updating the values, click *Save* to apply the changes. ::: notewarning Longer retention periods can increase disk usage and may impact performance. It is recommended to configure retention periods based on your actual data and analysis needs.<br> Zabbix Cloud uses database partitioning to manage data storage instead of traditional Zabbix housekeeping. This enables faster performance and more predictable retention handling. ::: ## تب تاریخچه تب *تاریخچه* به شما امکان میدهد مدت زمان ذخیره انواع مختلف دادههای تاریخی را پیکربندی کنید. ![](../../assets/en/cloud/quickstart/history_tab.png){width="600"} شما میتوانید دوره ذخیرهسازی را برای هر نوع داده (مثلاً عددی، متنی، لاگها) تنظیم کنید و واحد (روز، ماه، سال) را انتخاب کنید. تغییرات را میتوان تا سه بار در هر 24 ساعت انجام داد. پس از بهروزرسانی مقادیر، برای اعمال تغییرات روی *ذخیره* کلیک کنید. ::: notewarning دورههای نگهداری طولانیتر میتواند استفاده از دیسک را افزایش دهد و ممکن است بر عملکرد تأثیر بگذارد. توصیه میشود دورههای نگهداری را بر اساس نیازهای واقعی دادهها و تجزیه و تحلیل خود پیکربندی کنید.<br> Zabbix Cloud به جای مدیریت سنتی Zabbix، از پارتیشنبندی پایگاه داده برای مدیریت ذخیرهسازی دادهها استفاده میکند. این امر عملکرد سریعتر و مدیریت نگهداری قابل پیشبینیتری را ممکن میسازد. ::: # host.create # ساخت هاست # host.delete #حذف هاست # host.get # دریافت هاست ##### Host graph items ```yaml zabbix_export: (...) graphs: - name: 'MySQL: Bandwidth' graph_items: - drawtype: GRADIENT_LINE color: 199C0D item: host: 'MySQL server' key: mysql.bytes_received.rate - sortorder: '1' drawtype: GRADIENT_LINE color: F63100 item: host: 'MySQL server' key: mysql.bytes_sent.rate (...) ``` |Element|<|Type|Description| |-|---|---|-----------------------| |sortorder|<|integer|Draw order. The smaller value is drawn first. Can be used to draw lines or regions behind (or in front of) another.| |drawtype|<|string|Draw style of the graph item.<br>Supported for NORMAL graphs.<br>Possible values:^[1](#footnotes)^ SINGLE\_LINE (0, default), FILLED\_REGION (1), BOLD\_LINE (2), DOTTED\_LINE (3), DASHED\_LINE (4), GRADIENT\_LINE (5).| |color|<|string|Element color (6 symbols, hex).| |yaxisside|<|string|Side of the graph where the graph item's Y scale will be drawn.<br>Supported for NORMAL and STACKED graphs.|<br>Possible values:^[1](#footnotes)^ LEFT (0, default), RIGHT (1).| |calc\_fnc|<|string|Data to draw if more than one value exists for an item.<br>Possible values:^[1](#footnotes)^ MIN (1), AVG (2, default), MAX (4), ALL (7; minimum, average, and maximum; supported for simple graphs), LAST (9, supported for pie/exploded graphs).| |type|<|string|Graph item type.<br>Possible values:^[1](#footnotes)^ SIMPLE (0, default), GRAPH\_SUM (2; value of the item represents the whole pie; supported for pie/exploded graphs).| |item|<| |(required) Individual item.| |<|host|string|(required) Item host.| |^|key|string|(required) Item key.| ::: noteclassic See also: [Graph item object](/manual/api/reference/graphitem/object) (refer to the relevant property with a matching name). ::: ##### آیتمهای گراف میزبان ```yaml zabbix_export: (...) graphs: - name: 'MySQL: Bandwidth' graph_items: - drawtype: GRADIENT_LINE color: 199C0D item: host: 'MySQL server' key: mysql.bytes_received.rate - sortorder: '1' drawtype: GRADIENT_LINE color: F63100 item: host: 'MySQL server' key: mysql.bytes_sent.rate (...) ``` |Element|<|Type|Description| |-|---|---|----------------------| |sortorder|<|integer|ترتیب رسم. مقدار کوچکتر ابتدا رسم میشود. میتوان از آن برای رسم خطوط یا نواحی پشت (یا جلوی) دیگری استفاده کرد.| |drawtype|<|string|سبک رسم آیتم نمودار.<br>برای نمودارهای معمولی پشتیبانی میشود.<br>مقادیر ممکن:^[1](#footnotes)^ SINGLE\_LINE (0، پیشفرض)، FILLED\_REGION (1)، BOLD\_LINE (2)، DOTTED\_LINE (3)، DASHED\_LINE (4)، GRADIENT\_LINE (5).| |color|<|string|رنگ عنصر (6 نماد، هگز).| |yaxisside|<|string|سمتی از نمودار که مقیاس Y آیتم نمودار در آن رسم خواهد شد.<br>برای نمودارهای معمولی و انباشته پشتیبانی میشود.|<br>مقادیر ممکن:^[1](#footnotes)^ LEFT (0، پیشفرض)، RIGHT (1).| |calc\_fnc|<|string|دادهای که در صورت وجود بیش از یک مقدار برای یک آیتم، ترسیم میشود.<br>مقادیر ممکن:^[1](#footnotes)^ MIN (1)، AVG (2، پیشفرض)، MAX (4)، ALL (7؛ حداقل، میانگین و حداکثر؛ پشتیبانی شده برای نمودارهای ساده)، LAST (9، پشتیبانی شده برای نمودارهای دایرهای/منفجر شده).| |type|<|string|نوع آیتم گراف.<br>مقادیر ممکن:^[1](#footnotes)^ SIMPLE (0، پیشفرض)، GRAPH\_SUM (2؛ مقدار آیتم نشان دهنده کل دایره است؛ پشتیبانی شده برای نمودارهای دایرهای/منفجر شده).| |item|<| |(الزامی) آیتم تکی.| |<|host|string|(الزامی) میزبان آیتم.| |^|key|string|(الزامی) کلید آیتم.| ::: noteclassic همچنین ببینید: [Graph item object](/manual/api/reference/graphitem/object) (به ویژگی مربوطه با نام منطبق مراجعه کنید). ::: #### Host graphs ```yaml zabbix_export: (...) graphs: - name: 'MySQL: Bandwidth' graph_items: (see table below) (...) ``` |Element|<|Type|Description| |-|---|---|-----------------------| |uuid|<|string|Unique identifier of the graph.| |name|<|string|(required) Graph name.| |width|<|integer|Graph width, in pixels.<br>Used for preview and for pie/exploded graphs.<br>Possible values:^[1](#footnotes)^ 20-65535 (default: 900).| |height|<|integer|Graph height, in pixels.<br>Used for preview and for pie/exploded graphs.<br>Possible values:^[1](#footnotes)^ 20-65535 (default: 900).| |yaxismin|<|double|Value of Y axis minimum.<br>Supported for FIXED minimum value of Y axis.<br>Default: 0.| |yaxismax|<|double|Value of Y axis maximum.<br>Supported for FIXED minimum value of X axis.<br>Default: 0.| |show\_work\_period|<|string|Highlight non-working hours.<br>Supported for NORMAL and STACKED graphs.<br>Possible values:^[1](#footnotes)^ NO (0), YES (1, default).| |show\_triggers|<|string|Display simple trigger values as a line.<br>Supported for NORMAL and STACKED graphs.<br>Possible values:^[1](#footnotes)^ NO (0), YES (1, default).| |type|<|string|Graph type.<br>Possible values:^[1](#footnotes)^ NORMAL (0, default), STACKED (1), PIE (2), EXPLODED (3).| |show\_legend|<|string|Display graph legend.<br>Possible values:^[1](#footnotes)^ NO (0), YES (1, default).| |show\_3d|<|string|Enable 3D style.<br>Supported for NORMAL and STACKED graphs.<br>Possible values:^[1](#footnotes)^ NO (0, default), YES (1).| |percent\_left|<|double|Show the percentile line for left axis.<br>Supported for NORMAL graphs.<br>Default: 0.| |percent\_right|<|double|Show the percentile line for right axis.<br>Supported for NORMAL graphs.<br>Default: 0.| |ymin\_type\_1|<|string|Minimum value of Y axis.<br>Supported for NORMAL and STACKED graphs.<br>Possible values:^[1](#footnotes)^ CALCULATED (0, default), FIXED (1), ITEM (2).| |ymin\_item\_1|<| |(required if `ymin_type_1` is set to `ITEM`) Root element for individual item details.| |<|host|string|(required) Item host.| |^|key|string|(required) Item key.| |ymax\_type\_1|<|string|Maximum value of Y axis.<br>Supported for NORMAL and STACKED graphs.<br>Possible values:^[1](#footnotes)^ CALCULATED (0, default), FIXED (1), ITEM (2).| |ymax\_item\_1|<| |(required if `ymax_type_1` is set to `ITEM`) Root element for individual item details.| |<|host|string|(required) Item host.| |^|key|string|(required) Item key.| |graph\_items|<| |(required) Root element for [host graph items](#host-graph-items).| ::: noteclassic See also: [Graph object](/manual/api/reference/graph/object) (refer to the relevant property with a matching name). ::: #### گرافهای میزبان ```yaml zabbix_export: (...) graphs: - name: 'MySQL: Bandwidth' graph_items: (به جدول زیر مراجعه کنید) (...) ``` |عنصر|<|نوع|توضیحات| |-|---|---|---------------------| |uuid|<|string|شناسه منحصر به فرد گراف.| |name|<|string|(الزامی) نام گراف.| |width|<|integer|عرض گراف، به پیکسل.<br>برای پیشنمایش و برای گرافهای دایرهای/منبسطشده استفاده میشود.<br>مقادیر ممکن:^[1](#footnotes)^ 20-65535 (پیشفرض: 900).| |height|<|integer|ارتفاع نمودار، بر حسب پیکسل.<br>برای پیشنمایش و برای نمودارهای دایرهای/منبسطشده استفاده میشود.<br>مقادیر ممکن:^[1](#footnotes)^ 20-65535 (پیشفرض: 900).| |yaxismin|<|double|مقدار حداقل محور Y.<br>برای حداقل مقدار ثابت محور Y پشتیبانی میشود.<br>پیشفرض: 0.| |yaxismax|<|double|مقدار حداکثر محور Y.<br>برای حداقل مقدار ثابت محور X پشتیبانی میشود.<br>پیشفرض: 0.| |show\_work\_period|<|string|هایلایت کردن ساعات غیر کاری.<br>برای نمودارهای معمولی و انباشته پشتیبانی میشود.<br>مقادیر ممکن:^[1](#footnotes)^ خیر (0)، بله (1، پیشفرض).| |show\_triggers|<|string|نمایش مقادیر ماشه ساده به صورت خط.<br>پشتیبانی شده برای نمودارهای معمولی و انباشته.<br>مقادیر ممکن:^[1](#footnotes)^ خیر (0)، بله (1، پیشفرض).| |type|<|string|نوع نمودار.<br>مقادیر ممکن:^[1](#footnotes)^ معمولی (0، پیشفرض)، انباشته (1)، پای (2)، منفجر شده (3).| |show\_legend|<|string|نمایش شرح نمودار.<br>مقادیر ممکن:^[1](#footnotes)^ خیر (0)، بله (1، پیشفرض).| |show\_3d|<|string|فعال کردن سبک سهبعدی.<br>برای نمودارهای معمولی و پشتهای پشتیبانی میشود.<br>مقادیر ممکن:^[1](#footnotes)^ خیر (0، پیشفرض)، بله (1).| |percent\_left|<|double|خط صدک را برای محور چپ نشان بده.<br>برای نمودارهای معمولی پشتیبانی میشود.<br>پیشفرض: 0.| |percent\_right|<|double|خط صدک را برای محور راست نشان بده.<br>برای نمودارهای معمولی پشتیبانی میشود.<br>پیشفرض: 0.| |ymin\_type\_1|<|string|حداقل مقدار محور Y.<br>برای نمودارهای معمولی و انباشته پشتیبانی میشود.<br>مقادیر ممکن:^[1](#footnotes)^ محاسبهشده (0، پیشفرض)، ثابت (1)، مورد (2).| |ymin\_item\_1|<| |(اگر `ymin_type_1` روی `ITEM` تنظیم شده باشد، لازم است) عنصر ریشه برای جزئیات تکی مورد.| |<|host|string|(الزامی) میزبان مورد.| |^|key|string|(الزامی) کلید مورد.| |ymax\_type\_1|<|string|حداکثر مقدار محور Y.<br>برای نمودارهای معمولی و انباشته پشتیبانی میشود.<br>مقادیر ممکن:^[1](#footnotes)^ محاسبهشده (0، پیشفرض)، ثابت (1)، مورد (2).| |ymax\_item\_1|<| |(در صورتی که `ymax_type_1` روی `ITEM` تنظیم شده باشد، الزامی است) عنصر ریشه برای جزئیات تک تک آیتمها.| |<|host|string|(الزامی) میزبان آیتم.| |^|key|string|(الزامی) کلید آیتم.| |graph\_items|<| |(الزامی) عنصر ریشه برای [host graph items](#host-graph-items).| ::: noteclassic همچنین ببینید: [Graph object](/manual/api/reference/graph/object) (به ویژگی مربوطه با نام منطبق مراجعه کنید). ::: # hostgroup.create # ساخت گروه هاست # hostgroup.delete # حذف گروه هاست # hostgroup.get # دریافت گروه هاستی # hostgroup.massadd # اضافه کردن گروهی هاست ها # hostgroup.massremove # حذف گروهی هاست ها # hostgroup.massupdate # به روز رسانی گروهی هاست ها # hostgroup.update # به روز رسانی گروه هاستی # hostinterface.create # ساخت اینترفیس هاست # hostinterface.delete # حذف اینترفیس هاست # hostinterface.get # دریافت اینترفیس هاست # hostinterface.massadd # اضافه کردن گروهی اینترفیس های هاست # hostinterface.massremove # حذف گروهی اینترفیس های هاست # hostinterface.replacehostinterfaces # جایگزینی اینترفیس های هاست # hostinterface.update # به روز رسانی اینترفیس هاست ها #### Host items ```yaml zabbix_export: (...) hosts: - host: 'MySQL server' (...) items: (...) - name: 'Binlog cache disk use' type: DEPENDENT key: mysql.binlog_cache_disk_use value_type: FLOAT description: 'Number of transactions that used a temporary disk cache because they could not fit in the regular binary log cache, being larger than `binlog_cache_size`.' preprocessing: (see table below) master_item: key: 'mysql.get_status_variables["{$MYSQL.DSN}","{$MYSQL.USER}","{$MYSQL.PASSWORD}"]' tags: - tag: component value: cache (...) - name: 'Buffer pool utilization' type: CALCULATED key: mysql.buffer_pool_utilization value_type: FLOAT units: '%' params: | ( last(//mysql.innodb_buffer_pool_pages_total) - last(//mysql.innodb_buffer_pool_pages_free) ) / ( last(//mysql.innodb_buffer_pool_pages_total) + ( last(//mysql.innodb_buffer_pool_pages_total) = 0 ) ) * 100 * ( last(//mysql.innodb_buffer_pool_pages_total) > 0 ) description: 'Ratio of used to total pages in the buffer pool.' tags: - tag: component value: memory triggers: (see table below) (...) - name: Uptime type: DEPENDENT key: mysql.uptime units: uptime description: 'Number of seconds that the server has been up.' preprocessing: (see table below) master_item: key: 'mysql.get_status_variables["{$MYSQL.DSN}","{$MYSQL.USER}","{$MYSQL.PASSWORD}"]' tags: - tag: component value: application triggers: (see table below) (...) ``` |Element|<|Type|Description| |-|---|---|-----------------------| |name|<|string|(required) Item name.| |type|<|string|Item type.<br>Possible values:^[1](#footnotes)^ ZABBIX\_PASSIVE (0, default), TRAP (2), SIMPLE (3), INTERNAL (5), ZABBIX\_ACTIVE (7), EXTERNAL (10), ODBC (11), IPMI (12), SSH (13), TELNET (14), CALCULATED (15), JMX (16), SNMP\_TRAP (17), DEPENDENT (18), HTTP\_AGENT (19), SNMP\_AGENT (20), ITEM\_TYPE\_SCRIPT (21), ITEM\_TYPE\_BROWSER (22), ITEM\_TYPE\_NESTED (23).| |snmp\_oid|<|string|(required for SNMP\_AGENT items) SNMP object ID.| |key|<|string|(required) Item key.| |delay|<|string|Update interval of the item.<br>Default: 1m. The value will always be 0 for TRAP items.| |history|<|string|Time period (using [time suffix](/manual/appendix/suffixes#time-suffixes), [user macro](/manual/config/macros/user_macros) or [LLD macro](/manual/config/macros/lld_macros)) of how long the history data should be stored.<br>Default: 31d.| |trends|<|string|Time period (using [time suffix](/manual/appendix/suffixes#time-suffixes), [user macro](/manual/config/macros/user_macros) or [LLD macro](/manual/config/macros/lld_macros)) of how long the trends data should be stored.<br>Default: 365d.| |status|<|string|Item status.<br>Possible values:^[1](#footnotes)^ ENABLED (0, default), DISABLED (1).| |value\_type|<|string|Received value type.<br>Possible values:^[1](#footnotes)^ FLOAT (0), CHAR (1), LOG (2), UNSIGNED (3, default), TEXT (4), BINARY (5).| |allowed\_hosts|<|string|List of comma-delimited IP addresses of hosts allowed to send data for the item.<br>Supported for TRAP and HTTP\_AGENT items.| |units|<|string|Received value units (bps, B, etc.).| |params|<|text|Additional parameters depending on the type of the item (executed script for SSH and TELNET items; SQL query for ODBC items; formula for CALCULATED items; the script for ITEM\_TYPE\_SCRIPT and ITEM\_TYPE\_BROWSER items).| |ipmi\_sensor|<|string|IPMI sensor.<br>Supported for IPMI items.| |authtype|<|string|Authentication type.<br>Supported for SSH and HTTP\_AGENT items.<br>Possible values for SSH items:^[1](#footnotes)^ PASSWORD (0, default), PUBLIC\_KEY (1).<br>Possible values for HTTP\_AGENT items:^[1](#footnotes)^ NONE (0, default), BASIC (1), NTLM (2), Kerberos (3), or Digest (4).| |username|<|string|(required for SSH and TELNET items) Username for authentication.<br>Supported for SIMPLE, ODBC, JMX and HTTP\_AGENT items.<br>When used for JMX items, `password` (see below) should also be specified or both elements should be left blank.| |password|<|string|(required for SSH and TELNET items) Password for authentication.<br>Supported for SIMPLE, ODBC, JMX and HTTP\_AGENT items.<br>When used for JMX items, `username` (see above) should also be specified or both elements should be left blank.| |publickey|<|string|(required for SSH items) Name of the public key file.| |privatekey|<|string|(required for SSH items) Name of the private key file.| |description|<|text|Item description.| |inventory\_link|<|string|Host inventory field that is populated by the item.<br>Possible values:^[1](#footnotes)^ NONE (0), ALIAS (4), etc. (see [Host inventory](/manual/api/reference/host/object#host-inventory) for supported fields).| |valuemap|<| |Root element for item value maps.| | |name|string|(required) Name of the value map to use for the item.| |logtimefmt|<|string|Format of the time in log entries.<br>Supported for items of LOG value type.| |preprocessing|<| |Root element for item value preprocessing.| | |step| |Root element for [host item value preprocessing steps](#host-item-value-preprocessing-steps).| |interface\_ref|<|string|Reference to the host interface (format: `if<N>`).| |jmx\_endpoint|<|string|JMX endpoint.<br>Supported for JMX items.| |master_item|<| |(required for DEPENDENT items) Root element for dependent item's master item.| | |key|string|(required) Dependent item's master item key.| |timeout|<|string|Item data polling request timeout.<br>Supported for the [Timeouts](/manual/web_interface/frontend_sections/administration/general#timeouts) list of item types.| |url|<|string|(required for HTTP\_AGENT items) URL string.| |query_fields|<| |Root element for query parameters.<br>Supported for HTTP\_AGENT items.| |<|name|string|(required for HTTP\_AGENT items) Query parameter name.| |^|value|string|Query parameter value.<br>Supported for HTTP\_AGENT items.| |parameters|<| |Root element for user-defined parameters.<br>Supported for ITEM\_TYPE\_SCRIPT and ITEM\_TYPE\_BROWSER items.| |<|name|string|(required for ITEM\_TYPE\_SCRIPT and ITEM\_TYPE\_BROWSER items) User-defined parameter name.| |^|value|string|User-defined parameter value.<br>Supported for ITEM\_TYPE\_SCRIPT and ITEM\_TYPE\_BROWSER items.| |posts|<|string|HTTP(S) request body data.<br>Supported for HTTP\_AGENT items.| |status\_codes|<|string|Ranges of required HTTP status codes, separated by commas.<br>Supported for HTTP\_AGENT items.| |follow\_redirects|<|string|Follow response redirects while polling data.<br>Supported for HTTP\_AGENT items.<br>Possible values:^[1](#footnotes)^ NO (0), YES (1, default).| |post\_type|<|string|Type of post data body.<br>Supported for HTTP\_AGENT items.<br>Possible values:^[1](#footnotes)^ RAW (0, default), JSON (2), XML (3).| |http\_proxy|<|string|HTTP(S) proxy connection string.<br>Supported for HTTP\_AGENT items.| |headers|<| |Root element for HTTP(S) request headers.<br>Supported for HTTP\_AGENT items.| |<|name|string|(required for HTTP\_AGENT items) Header name.| |^|value|string|(required for HTTP\_AGENT items) Header value.| |retrieve\_mode|<|string|What part of response should be stored.<br>Supported for HTTP\_AGENT items.<br>Possible values:^[1](#footnotes)^ BODY (0, default), HEADERS (1), BOTH (2).| |request\_method|<|string|Request method type.<br>Supported for HTTP\_AGENT items.<br>Possible values:^[1](#footnotes)^ GET (0, default), POST (1), PUT (2), HEAD (3).| |output\_format|<|string|How to process response.<br>Supported for HTTP\_AGENT items.<br>Possible values:^[1](#footnotes)^ RAW (0, default), JSON (1).| |allow\_traps|<|string|Allow to populate value similarly to the trapper item.<br>Supported for HTTP\_AGENT items.<br>Possible values:^[1](#footnotes)^ NO (0, default), YES (1).| |ssl\_cert\_file|<|string|Public SSL Key file path.<br>Supported for HTTP\_AGENT items.| |ssl\_key\_file|<|string|Private SSL Key file path.<br>Supported for HTTP\_AGENT items.| |ssl\_key\_password|<|string|Password for SSL Key file.<br>Supported for HTTP\_AGENT items.| |verify\_peer|<|string|Whether to validate that the host's certificate is authentic.<br>Supported for HTTP\_AGENT items.<br>Possible values:^[1](#footnotes)^ NO (0, default), YES (1).| |verify\_host|<|string|Whether to validate that the host name for the connection matches the one in the host's certificate.<br>Supported for HTTP\_AGENT items.<br>Possible values:^[1](#footnotes)^ NO (0, default), YES (1).| |tags|<| |Root element for item tags.| |<|tag|string|(required) Tag name.| |^|value|string|Tag value.| |triggers|<| |Root element for [host item triggers](#host-item-triggers).| ::: noteclassic See also: [Item object](/manual/api/reference/item/object) (refer to the relevant property with a matching name). ::: ##### تگ های آیتم هاست ها |Element|Element property|Required|Type|Range^**[1](#footnotes)**^|Description| |--|--|-|--|----|--------| |items| |\-| | |Root element for items.| | |name|x|`string`| |Item name.| | |type|\-|`string`|0 - ZABBIX\_PASSIVE (default)<br>2 - TRAP<br>3 - SIMPLE<br>5 - INTERNAL<br>7 - ZABBIX\_ACTIVE<br>10 - EXTERNAL<br>11 - ODBC<br>12 - IPMI<br>13 - SSH<br>14 - TELNET<br>15 - CALCULATED<br>16 - JMX<br>17 - SNMP\_TRAP<br>18 - DEPENDENT<br>19 - HTTP\_AGENT<br>20 - SNMP\_AGENT<br>21 - ITEM\_TYPE\_SCRIPT|Item type.| | |snmp\_oid|\-|`string`| |SNMP object ID.<br><br>Required by SNMP items.| | |key|x|`string`| |Item key.| | |delay|\-|`string`|Default: 1m|Update interval of the item.<br><br>Note that `delay` will be always '0' for trapper items.<br><br>Accepts seconds or a time unit with suffix (30s, 1m, 2h, 1d).<br>Optionally one or more [custom intervals](/manual/config/items/item/custom_intervals) can be specified either as flexible intervals or scheduling.<br>Multiple intervals are separated by a semicolon.<br>User macros may be used. A single macro has to fill the whole field. Multiple macros in a field or macros mixed with text are not supported.<br>Flexible intervals may be written as two macros separated by a forward slash (e.g. `{$FLEX_INTERVAL}/{$FLEX_PERIOD}`).| | |history|\-|`string`|Default: 90d|A time unit of how long the history data should be stored. Time unit with suffix, user macro or LLD macro.| | |trends|\-|`string`|Default: 365d|A time unit of how long the trends data should be stored. Time unit with suffix, user macro or LLD macro.| | |status|\-|`string`|0 - ENABLED (default)<br>1 - DISABLED|Item status.| | |value\_type|\-|`string`|0 - FLOAT<br>1 - CHAR<br>2 - LOG<br>3 - UNSIGNED (default)<br>4 - TEXT|Received value type.| | |allowed\_hosts|\-|`string`| |List of IP addresses (comma delimited) of hosts allowed sending data for the item.<br><br>Used by trapper and HTTP agent items.| | |units|\-|`string`| |Units of returned values (bps, B, etc).| | |params|\-|`text`| |Additional parameters depending on the type of the item:<br>- executed script for Script, SSH and Telnet items;<br>- SQL query for database monitor items;<br>- formula for calculated items.| | |ipmi\_sensor|\-|`string`| |IPMI sensor.<br><br>Used only by IPMI items.| | |authtype|\-|`string`|Authentication type for SSH agent items:<br>0 - PASSWORD (default)<br>1 - PUBLIC\_KEY<br><br>Authentication type for HTTP agent items:<br>0 - NONE (default)<br>1 - BASIC<br>2 - NTLM|Authentication type.<br><br>Used only by SSH and HTTP agent items.| | |username|\-|`string`| |Username for authentication.<br>Used by simple check, SSH, Telnet, database monitor, JMX and HTTP agent items.<br><br>Required by SSH and Telnet items.<br>When used by JMX agent, password should also be specified together with the username or both properties should be left blank.| | |password|\-|`string`| |Password for authentication.<br>Used by simple check, SSH, Telnet, database monitor, JMX and HTTP agent items.<br><br>When used by JMX agent, username should also be specified together with the password or both properties should be left blank.| | |publickey|\-|`string`| |Name of the public key file.<br><br>Required for SSH agent items.| | |privatekey|\-|`string`| |Name of the private key file.<br><br>Required for SSH agent items.| | |description|\-|`text`| |Item description.| | |inventory\_link|\-|`string`|0 - NONE<br><br>Capitalized host inventory field name. For example:<br>4 - ALIAS<br>6 - OS\_FULL<br>14 - HARDWARE<br>etc.|Host inventory field that is populated by the item.<br><br>Refer to the [host inventory page](/manual/api/reference/host/object#host_inventory) for a list of supported host inventory fields and their IDs.| | |logtimefmt|\-|`string`| |Format of the time in log entries.<br>Used only by log items.| | |interface\_ref|\-|`string`|Format: `if<N>`|Reference to the host interface.| | |jmx\_endpoint|\-|`string`| |JMX endpoint.<br><br>Used only by JMX agent items.| | |url|\-|`string`| |URL string.<br><br>Required only for HTTP agent items.| | |allow\_traps|\-|`string`|0 - NO (default)<br>1 - YES|Allow to populate value as in a trapper item.<br><br>Used only by HTTP agent items.| | |follow\_redirects|\-|`string`|0 - NO<br>1 - YES (default)|Follow HTTP response redirects while pooling data.<br><br>Used only by HTTP agent items.| |headers| |\-| | |Root element for HTTP(S) request headers, where header name is used as key and header value as value.<br>Used only by HTTP agent items.| | |name|x|`string`| |Header name.| | |value|x|`string`| |Header value.| | |http\_proxy|\-|`string`| |HTTP(S) proxy connection string.<br><br>Used only by HTTP agent items.| | |output\_format|\-|`string`|0 - RAW (default)<br>1 - JSON|How to process response.<br><br>Used only by HTTP agent items.| | |post\_type|\-|`string`|0 - RAW (default)<br>2 - JSON<br>3 - XML|Type of post data body.<br><br>Used only by HTTP agent items.| | |posts|\-|`string`| |HTTP(S) request body data.<br><br>Used only by HTTP agent items.| |query\_fields| |\-| | |Root element for query parameters.<br><br>Used only by HTTP agent items.| | |name|x|`string`| |Parameter name.| | |value|\-|`string`| |Parameter value.| | |request\_method|\-|`string`|0 - GET (default)<br>1 - POST<br>2 - PUT<br>3 - HEAD|Request method.<br><br>Used only by HTTP agent items.| | |retrieve\_mode|\-|`string`|0 - BODY (default)<br>1 - HEADERS<br>2 - BOTH|What part of response should be stored.<br><br>Used only by HTTP agent items.| | |ssl\_cert\_file|\-|`string`| |Public SSL Key file path.<br><br>Used only by HTTP agent items.| | |ssl\_key\_file|\-|`string`| |Private SSL Key file path.<br><br>Used only by HTTP agent items.| | |ssl\_key\_password|\-|`string`| |Password for SSL Key file.<br><br>Used only by HTTP agent items.| | |status\_codes|\-|`string`| |Ranges of required HTTP status codes separated by commas. Supports user macros.<br>Example: 200,200-{$M},{$M},200-400<br><br>Used only by HTTP agent items.| | |timeout|\-|`string`| |Item data polling request timeout. Supports user macros.<br><br>Used by HTTP agent and Script items.| | |verify\_host|\-|`string`|0 - NO (default)<br>1 - YES|Validate if host name in URL is in Common Name field or a Subject Alternate Name field of host certificate.<br><br>Used only by HTTP agent items.| | |verify\_peer|\-|`string`|0 - NO (default)<br>1 - YES|Validate if host certificate is authentic.<br><br>Used only by HTTP agent items.| |parameters| |\-| | |Root element for user-defined parameters.<br><br>Used only by Script items.| | |name|x|`string`| |Parameter name.<br><br>Used only by Script items.| | |value|\-|`string`| |Parameter value.<br><br>Used only by Script items.| |value map| |\-| | |Value map.| | |name|x|`string`| |Name of the value map to use for the item.| |preprocessing| |\-| | |Root element for item value preprocessing.| |step| |\-| | |Individual item value preprocessing step.| | |type|x|`string`|1 - MULTIPLIER<br>2 - RTRIM<br>3 - LTRIM<br>4 - TRIM<br>5 - REGEX<br>6 - BOOL\_TO\_DECIMAL<br>7 - OCTAL\_TO\_DECIMAL<br>8 - HEX\_TO\_DECIMAL<br>9 - SIMPLE\_CHANGE (calculated as (received value-previous value))<br>10 - CHANGE\_PER\_SECOND (calculated as (received value-previous value)/(time now-time of last check))<br>11 - XMLPATH<br>12 - JSONPATH<br>13 - IN\_RANGE<br>14 - MATCHES\_REGEX<br>15 - NOT\_MATCHES\_REGEX<br>16 - CHECK\_JSON\_ERROR<br>17 - CHECK\_XML\_ERROR<br>18 - CHECK\_REGEX\_ERROR<br>19 - DISCARD\_UNCHANGED<br>20 - DISCARD\_UNCHANGED\_HEARTBEAT<br>21 - JAVASCRIPT<br>22 - PROMETHEUS\_PATTERN<br>23 - PROMETHEUS\_TO\_JSON<br>24 - CSV\_TO\_JSON<br>25 - STR\_REPLACE<br>26 - CHECK\_NOT\_SUPPORTED<br>27 - XML\_TO\_JSON|Type of the item value preprocessing step.| | |parameters|\-| | |Root element for parameters of the item value preprocessing step.| | |parameter|x|`string`| |Individual parameter of the item value preprocessing step.| | |error\_handler|\-|`string`|0 - ORIGINAL\_ERROR (default)<br>1 - DISCARD\_VALUE<br>2 - CUSTOM\_VALUE<br>3 - CUSTOM\_ERROR|Action type used in case of preprocessing step failure.| | |error\_handler\_params|\-|`string`| |Error handler parameters used with 'error\_handler'.| |master\_item| |\-| | |Individual item master item.<br><br>Required by dependent items.| | |key|x|`string`| |Dependent item master item key value.<br><br>Recursion up to 3 dependent items and maximum count of dependent items equal to 29999 are allowed.| |triggers| |\-| | |Root element for simple triggers.| | |*For trigger element tag values, see host [trigger tags](/manual/xml_export_import/hosts#host_trigger_tags).*| | | | | |tags| |\-| | |Root element for item tags.| | |tag|x|`string`| |Tag name.| | |value|\-|`string`| |Tag value.| ##### Host item triggers ```yaml zabbix_export: (...) hosts: - host: 'MySQL server' (...) items: (...) - name: Uptime (...) triggers: - expression: 'nodata(/MySQL server/mysql.uptime,30m)=1' name: 'MySQL: Failed to fetch info data' event_name: 'MySQL: Failed to fetch info data (or no data for 30m)' priority: INFO description: 'Zabbix has not received any data for items for the last 30 minutes.' dependencies: - name: 'MySQL: Service is down' expression: 'last(/MySQL server/mysql.ping["{$MYSQL.DSN}","{$MYSQL.USER}","{$MYSQL.PASSWORD}"])=0' tags: - tag: scope value: availability - expression: 'last(/MySQL server/mysql.uptime)<10m' name: 'MySQL: Service has been restarted' event_name: 'MySQL: Service has been restarted (uptime < 10m)' priority: INFO description: 'MySQL uptime is less than 10 minutes.' tags: - tag: scope value: notice (...) ``` |Element|<|Type|Description| |-|---|---|-----------------------| |uuid|<|string|(required) Unique identifier for this trigger.| |expression|<|string|(required) Trigger expression.| |recovery\_mode|<|string|Basis for generating OK events.<br>Possible values:^[1](#footnotes)^ EXPRESSION (0, default), RECOVERY\_EXPRESSION (1), NONE (2).| |recovery\_expression|<|string|Trigger recovery expression.| |correlation\_mode|<|string|Correlation mode (no event correlation or event correlation by tag).<br>Possible values:^[1](#footnotes)^ DISABLED (0, default), TAG\_VALUE (1).| |correlation\_tag|<|string|The tag name to be used for event correlation.| |name|<|string|(required) Trigger name.| |event\_name|<|string|Event name.| |opdata|<|string|Operational data.| |url\_name|<|string|Label for the URL associated with the trigger.| |url|<|string|URL associated with the trigger.| |status|<|string|Trigger status.<br>Possible values:^[1](#footnotes)^ ENABLED (0, default), DISABLED (1).| |priority|<|string|Trigger severity.<br>Possible values:^[1](#footnotes)^ NOT\_CLASSIFIED (0, default), INFO (1), WARNING (2), AVERAGE (3), HIGH (4), DISASTER (5).| |description|<|text|Trigger description.| |type|<|string|Event generation type (single problem event or multiple problem events).<br>Possible values:^[1](#footnotes)^ SINGLE (0, default), MULTIPLE (1).| |manual\_close|<|string|Manual closing of problem events.<br>Possible values:^[1](#footnotes)^ NO (0, default), YES (1).| |dependencies|<| |Root element for dependencies.| |<|name|string|(required) Dependency trigger name.| |^|expression|string|(required) Dependency trigger expression.| |^|recovery\_expression|string|Dependency trigger recovery expression.| |tags|<| |Root element for trigger tags.| |<|tag|string|(required) Tag name.| |^|value|string|Tag value.| ::: noteclassic See also: [Trigger object](/manual/api/reference/trigger/object) (refer to the relevant property with a matching name). ::: ##### محرکهای آیتم میزبان ```yaml zabbix_export: (...) hosts: - host: 'MySQL server' (...) items: (...) - name: Uptime (...) triggers: - expression: 'nodata(/MySQL server/mysql.uptime,30m)=1' name: 'MySQL: دریافت دادههای اطلاعاتی ناموفق بود' event_name: 'MySQL: دریافت دادههای اطلاعاتی ناموفق بود (یا هیچ دادهای برای 30 دقیقه وجود ندارد)' priority: INFO description: 'Zabbix در 30 دقیقه گذشته هیچ دادهای برای آیتمها دریافت نکرده است.' وابستگیها: - نام: 'MySQL: سرویس از کار افتاده است' عبارت: 'last(/MySQL server/mysql.ping["{$MYSQL.DSN}","{$MYSQL.USER}","{$MYSQL.PASSWORD}"])=0' برچسبها: - برچسب: scope مقدار: availability - عبارت: 'last(/MySQL server/mysql.uptime)<10m' نام: 'MySQL: سرویس مجدداً راهاندازی شده است' event_name: 'MySQL: سرویس مجدداً راهاندازی شده است (زمان روشن بودن < 10m)' اولویت: INFO توضیحات: 'زمان روشن بودن MySQL کمتر از 10 دقیقه است.' برچسبها: - برچسب: scope مقدار: notice (...) ``` |Element|<|Type|Description| |-|---|---|----------------------| |uuid|<|string|(الزامی) شناسه منحصر به فرد برای این تریگر.| |عبارت|<|string|(الزامی) عبارت تریگر.| |recovery\_mode|<|string|مبنای تولید رویدادهای OK.<br>مقادیر ممکن:^[1](#footnotes)^ EXPRESSION (0، پیشفرض)، RECOVERY\_EXPRESSION (1)، NONE (2).| |recovery\_expression|<|string|عبارت بازیابی تریگر.| |correlation\_mode|<|string|حالت همبستگی (بدون همبستگی رویداد یا همبستگی رویداد بر اساس برچسب).<br>مقادیر ممکن:^[1](#footnotes)^ DISABLED (0، پیشفرض)، TAG\_VALUE (1).| |correlation\_tag|<|string|نام برچسبی که برای همبستگی رویداد استفاده میشود.| |name|<|string|(الزامی) نام تریگر.| |event\_name|<|string|نام رویداد.| |opdata|<|string|دادههای عملیاتی.| |url\_name|<|string|برچسب برای URL مرتبط با trigger.| |url|<|string|URL مرتبط با trigger.| |status|<|string|وضعیت trigger.<br>مقادیر ممکن:^[1](#footnotes)^ فعال (0، پیشفرض)، غیرفعال (1).| |priority|<|string|شدت trigger.<br>مقادیر ممکن:^[1](#footnotes)^ NOT\_CLASSIFIED (0، پیشفرض)، INFO (1)، WARNING (2)، AVERAGE (3)، HIGH (4)، DISASTER (5).| |description|<|text|توضیحات trigger.| |نوع|<|رشته|نوع تولید رویداد (رویداد تک مسئله یا چندین رویداد مسئله).<br>مقادیر ممکن:^[1](#footnotes)^ تک (0، پیشفرض)، چندگانه (1).| |دستی\_بستن|<|رشته|بستن دستی رویدادهای مسئله.<br>مقادیر ممکن:^[1](#footnotes)^ خیر (0، پیشفرض)، بله (1).| |وابستگیها|<| |عنصر ریشه برای وابستگیها.| |<|نام|رشته|(الزامی) نام ماشه وابستگی.| |^|عبارت|رشته|(الزامی) عبارت ماشه وابستگی.| |^|عبارت بازیابی\_عبارت|رشته|عبارت بازیابی ماشه وابستگی.| |برچسبها|<| |عنصر ریشه برای برچسبهای ماشه.| |<|برچسب|رشته|(الزامی) نام برچسب.| |^|مقدار|رشته|مقدار برچسب.| ::: noteclassic همچنین ببینید: [Trigger object](/manual/api/reference/trigger/object) (به ویژگی مربوطه با نام منطبق مراجعه کنید). ::: ##### Host item value preprocessing steps ```yaml zabbix_export: (...) hosts: - host: 'MySQL server' (...) items: (...) - name: 'Binlog cache disk use' (...) preprocessing: - type: JSONPATH parameters: - $.Binlog_cache_disk_use - type: DISCARD_UNCHANGED_HEARTBEAT parameters: - 6h (...) ``` |Element|<|Type|Description| |-|---|---|-----------------------| |type|<|string|(required) The item value preprocessing step type.<br>Possible values:^[1](#footnotes)^ MULTIPLIER (1), RTRIM (2), LTRIM (3), TRIM (4), REGEX (5), BOOL\_TO\_DECIMAL (6), OCTAL\_TO\_DECIMAL (7), HEX\_TO\_DECIMAL (8), SIMPLE\_CHANGE (9, calculated: received value - previous value), CHANGE\_PER\_SECOND (10, calculated: (received value - previous value)/(time now - time of last check)), XMLPATH (11), JSONPATH (12), IN\_RANGE (13), MATCHES\_REGEX (14), NOT\_MATCHES\_REGEX (15), CHECK\_JSON\_ERROR (16), CHECK\_XML\_ERROR (17), CHECK\_REGEX\_ERROR (18), DISCARD\_UNCHANGED (19), DISCARD\_UNCHANGED\_HEARTBEAT (20), JAVASCRIPT (21), PROMETHEUS\_PATTERN (22), PROMETHEUS\_TO\_JSON (23), CSV\_TO\_JSON (24), STR\_REPLACE (25), CHECK\_NOT\_SUPPORTED (26), XML\_TO\_JSON (27), SNMP\_WALK\_VALUE (28), SNMP\_WALK\_TO\_JSON (29), SNMP\_GET\_VALUE (30).| |parameters|<| |(required) Root element for parameters of the item value preprocessing step.| | |parameter|string|Individual parameter of the item value preprocessing step.| |error\_handler|<|string|Action type used in case of preprocessing step failure.<br>Possible values:^[1](#footnotes)^ ORIGINAL\_ERROR (0, default), DISCARD\_VALUE (1), CUSTOM\_VALUE (2), CUSTOM\_ERROR (3).| |error\_handler\_params|<|string|Error handler parameters.| ::: noteclassic See also: [Item preprocessing object](/manual/api/reference/item/object#item-preprocessing) (refer to the relevant property with a matching name). ::: ##### مراحل پیشپردازش مقدار آیتم میزبان ```yaml zabbix_export: (...) hosts: - host: 'MySQL server' (...) items: (...) - name: 'Binlog cache disk use' (...) پیشپردازش: - type: JSONPATH parameters: - $.Binlog_cache_disk_use - type: DISCARD_UNCHANGED_HEARTBEAT parameters: - 6h (...) ``` |Element|<|Type|Description| |-|---|---|----------------------| |type|<|string|(الزامی) نوع مرحله پیشپردازش مقدار آیتم.<br>مقادیر ممکن: ^[1](#footnotes)^ MULTIPLIER (1)، RTRIM (2)، LTRIM (3)، TRIM (4)، REGEX (5)، BOOL\_TO\_DECIMAL (6)، OCTAL\_TO\_DECIMAL (7)، HEX\_TO\_DECIMAL (8)، SIMPLE\_CHANGE (9، محاسبه شده: مقدار دریافتی - مقدار قبلی)، CHANGE\_PER\_SECOND (10، محاسبه شده: (مقدار دریافتی - مقدار قبلی)/(زمان اکنون - زمان آخرین بررسی))، XMLPATH (11)، JSONPATH (12)، IN\_RANGE (13)، MATCHES\_REGEX (14)، NOT\_MATCHES\_REGEX (15)، CHECK\_JSON\_ERROR (16)، بررسی\_XML\_ERROR (17)، بررسی\_REGEX\_ERROR (18)، DISCARD\_UNCHANGED (19)، DISCARD\_UNCHANGED\_HEARTBEAT (20)، JAVASCRIPT (21)، PROMETHEUS\_PATTERN (22)، PROMETHEUS\_TO\_JSON (23)، CSV\_TO\_JSON (24)، STR\_REPLACE (25)، بررسی\_NOT\_SUPPORTED (26)، XML\_TO\_JSON (27)، SNMP\_WALK\_VALUE (28)، SNMP\_WALK\_TO\_JSON (29)، SNMP\_GET\_VALUE (30).| |parameters|<| |(الزامی) عنصر ریشه برای پارامترهای مرحله پیشپردازش مقدار آیتم.| | |parameter|string|پارامتر منحصر به فرد مرحله پیشپردازش مقدار آیتم.| |error\_handler|<|string|نوع عملی که در صورت شکست مرحله پیشپردازش استفاده میشود.<br>مقادیر ممکن:^[1](#footnotes)^ ORIGINAL\_ERROR (0، پیشفرض)، DISCARD\_VALUE (1)، CUSTOM\_VALUE (2)، CUSTOM\_ERROR (3).| |error\_handler\_params|<|string|پارامترهای مدیریت خطا.| ::: noteclassic همچنین ببینید: [شیء پیشپردازش آیتم](/manual/api/reference/item/object#item-preprocessing) (به ویژگی مربوطه با نام منطبق مراجعه کنید). ::: ##### Host low-level discovery rule filters ```yaml zabbix_export: (...) hosts: - host: 'MySQL server' (...) discovery_rules: - name: 'Database discovery' (...) filter: evaltype: AND conditions: - macro: '{#DATABASE}' value: '{$MYSQL.DBNAME.MATCHES}' - macro: '{#DATABASE}' value: '{$MYSQL.DBNAME.NOT_MATCHES}' operator: NOT_MATCHES_REGEX (...) ``` |Element|<|Type|Description| |-|---|---|-----------------------| |evaltype|<|string|Override filter condition evaluation method.<br>Possible values:^[1](#footnotes)^ AND\_OR (0, default), AND (1), OR (2), FORMULA (3).| |formula|<|string|Custom calculation formula for filter conditions.| |conditions|<| |Root element for filter conditions.| |<|macro|string|(required) The name of the low-level discovery macro to perform the check on.| |^|value|string|Value to compare with.| |^|operator|string|Condition operator.<br>Possible values:^[1](#footnotes)^ MATCHES\_REGEX (8, default), NOT\_MATCHES\_REGEX (9).| |^|formulaid|string|(required) Arbitrary unique ID that is used to reference a condition from the custom expression. Can only contain capital-case letters. The ID must be defined by the user when modifying filter conditions, but will be generated anew when requesting them afterward.| ::: noteclassic See also: [LLD rule filter object](/manual/api/reference/discoveryrule/object#lld-rule-filter) (refer to the relevant property with a matching name). ::: ##### فیلترهای قانون کشف سطح پایین میزبان ```yaml zabbix_export: (...) hosts: - host: 'MySQL server' (...) discovery_rules: - name: 'کشف پایگاه داده' (...) filter: evaltype: AND conditions: - macro: '{#DATABASE}' value: '{$MYSQL.DBNAME.MATCHES}' - macro: '{#DATABASE}' value: '{$MYSQL.DBNAME.NOT_MATCHES}' operator: NOT_MATCHES_REGEX (...) ``` |Element|<|Type|Description| |-|---|---|----------------------| |evaltype|<|string|روش ارزیابی شرط فیلتر را لغو کنید.<br>مقادیر ممکن:^[1](#footnotes)^ AND\_OR (0، پیشفرض)، AND (1)، OR (2)، FORMULA (3).| |formula|<|string|فرمول محاسبه سفارشی برای شرطهای فیلتر.| |conditions|<| |عنصر ریشه برای شرطهای فیلتر.| |<|macro|string|(الزامی) نام ماکروی اکتشافی سطح پایین برای انجام بررسی.| |^|مقدار|رشته|مقداری که باید با آن مقایسه شود.| |^|عملگر|رشته|عملگر شرط.<br>مقادیر ممکن:^[1](#footnotes)^ MATCHES\_REGEX (8، پیشفرض)، NOT\_MATCHES\_REGEX (9).| |^|formulaid|string|(الزامی) شناسه منحصر به فرد دلخواه که برای ارجاع به یک شرط از عبارت سفارشی استفاده میشود. فقط میتواند شامل حروف بزرگ باشد. شناسه باید هنگام تغییر شرایط فیلتر توسط کاربر تعریف شود، اما هنگام درخواست مجدد آنها، دوباره تولید میشود.| ::: noteclassic همچنین ببینید: [شیء فیلتر قانون LLD](/manual/api/reference/discoveryrule/object#lld-rule-filter) (به ویژگی مربوطه با نام منطبق مراجعه کنید). ::: ##### Host low-level discovery rule override operations |Element|<|Type|Description| |-|---|---|-----------------------| |operationobject|<|string|Object to which the operation is applied.<br>Possible values:^[1](#footnotes)^ ITEM_PROTOTYPE (0), TRIGGER_PROTOTYPE (1), GRAPH_PROTOTYPE (2), HOST_PROTOTYPE (3), DISCOVERY_PROTOTYPE (4).| |operator|<|string|Override condition operator.<br>Possible values:^[1](#footnotes)^ EQUAL (1), NOT_EQUAL (2), LIKE (3), NOT_LIKE (4), REGEXP (5), NOT_REGEXP (6).| |value|<|string|A regular expression or a string for the override condition operator.| |status|<|string|Status of the object upon the override operation.| |discover|<|string|Whether the object is added as a result of the discovery.| |delay|<|string|Update interval set for the item prototype upon the override operation.| |history|<|string|History storage period set for the item prototype upon the override operation.| |trends|<|string|Trend storage period set for the item prototype upon the override operation.| |severity|<|string|Trigger prototype severity set upon the override operation.| |tags|<| |Root element for the tags set for the object upon the override operation.| |<|tag|string|(required) Tag name.| |^|value|string|Tag value.| |templates|<| |Root element for the templates linked to the host prototype upon the override operation.| | |name|string|(required) Template name.| |inventory_mode|<|string|Host prototype inventory mode set upon the override operation.| ::: noteclassic See also: [LLD rule override operation object](/manual/api/reference/discoveryrule/object#lld-rule-override-operation) (refer to the relevant property with a matching name). ::: ##### عملیات لغو قانون کشف سطح پایین میزبان |عنصر|<|نوع|توضیحات| |-|---|---|----------------------| |شیء عملیات|<|رشته|شیئی که عملیات روی آن اعمال میشود.<br>مقادیر ممکن:^[1](#footnotes)^ ITEM_PROTOTYPE (0)، TRIGGER_PROTOTYPE (1)، GRAPH_PROTOTYPE (2)، HOST_PROTOTYPE (3)، DISCOVERY_PROTOTYPE (4).| |عملگر|<|رشته|عملگر شرط لغو.<br>مقادیر ممکن:^[1](#footnotes)^ EQUAL (1)، NOT_EQUAL (2)، LIKE (3)، NOT_LIKE (4)، REGEXP (5)، NOT_REGEXP (6).| |مقدار|<|رشته|یک عبارت منظم یا یک رشته برای عملگر شرط لغو.| |وضعیت|<|رشته|وضعیت شیء پس از عملیات لغو.| |کشف|<|رشته|اینکه آیا شیء در نتیجه کشف اضافه شده است یا خیر.| |تأخیر|<|رشته|فاصله زمانی بهروزرسانی برای نمونه اولیه کالا پس از عملیات لغو تنظیم شده است.| |تاریخچه|<|رشته|دوره ذخیرهسازی تاریخچه برای نمونه اولیه کالا پس از عملیات لغو تنظیم شده است.| |روندها|<|رشته|دوره ذخیرهسازی روند برای نمونه اولیه کالا پس از عملیات لغو تنظیم شده است.| |شدت|<|رشته|شدت نمونه اولیه فعال شده پس از عملیات لغو تنظیم شده است.| |برچسبها|<| |عنصر ریشه برای برچسبهای تنظیم شده برای شیء پس از عملیات لغو.| |<|برچسب|رشته|(الزامی) نام برچسب.| |^|مقدار|رشته|مقدار برچسب.| |قالبها|<| |عنصر ریشه برای قالبهایی که پس از عملیات لغو به نمونه اولیه میزبان پیوند داده میشوند.| | |نام|رشته|(الزامی) نام الگو.| |حالت_موجودی|<|رشته|حالت موجودی نمونه اولیه میزبان که پس از عملیات لغو تنظیم میشود.| ::: noteclassic همچنین ببینید: [شیء عملیات لغو قانون LLD](/manual/api/reference/discoveryrule/object#lld-rule-override-operation) (به ویژگی مربوطه با نام منطبق مراجعه کنید). ::: #### Host low-level discovery rules ```yaml zabbix_export: (...) hosts: - host: 'MySQL server' (...) discovery_rules: - name: 'Database discovery' key: 'mysql.db.discovery["{$MYSQL.DSN}","{$MYSQL.USER}","{$MYSQL.PASSWORD}"]' delay: 1h filter: (see table below) description: 'Scanning databases in DBMS.' interface_ref: if1 item_prototypes: - name: 'Size of database {#DATABASE}' key: 'mysql.db.size["{$MYSQL.DSN}","{$MYSQL.USER}","{$MYSQL.PASSWORD}","{#DATABASE}"]' delay: 5m units: B description: 'Database size.' preprocessing: - type: DISCARD_UNCHANGED_HEARTBEAT parameters: - 1h interface_ref: if1 tags: - tag: component value: storage - tag: database value: '{#DATABASE}' lld_macro_paths: - lld_macro: '{#DATABASE}' path: $.Database preprocessing: - type: DISCARD_UNCHANGED_HEARTBEAT parameters: - 1d (...) ``` ::: noteimportant Most host low-level discovery rule elements are the same as for [host items](#host-items). The table below describes those elements that differ from host items. ::: |Element|<|Type|Description| |-|---|---|-----------------------| |type|<|string|Item type.<br>Possible values:^[1](#footnotes)^ ZABBIX\_PASSIVE (0, default), TRAP (2), SIMPLE (3), INTERNAL (5), ZABBIX\_ACTIVE (7), EXTERNAL (10), ODBC (11), IPMI (12), SSH (13), TELNET (14), JMX (16), DEPENDENT (18), HTTP\_AGENT (19), SNMP\_AGENT (20), ITEM\_TYPE\_SCRIPT (21), ITEM\_TYPE\_BROWSER (22).| |key|<|string|(required) The low-level discovery rule key.| |filter|<| |Root element for [host low-level discovery rule filters](#host-low-level-discovery-rule-filters).| |lifetime|<|string|Time period (using seconds, [time suffix](/manual/appendix/suffixes#time-suffixes), or [user macro](/manual/config/macros/user_macros)), after which no longer discovered resources will be deleted.<br>Default: 7d.| |lifetime_type|<|string|Scenario for deleting lost LLD resources.<br>Possible values: DELETE\_NEVER, DELETE\_IMMEDIATELY, DELETE\_AFTER.| |enabled_lifetime|<|string|Time period (using seconds, [time suffix](/manual/appendix/suffixes#time-suffixes), or [user macro](/manual/config/macros/user_macros)), after which no longer discovered resources will be disabled.| |enabled_lifetime_type|<|string|Scenario for disabling lost LLD resources.<br>Possible values: DISABLE\_NEVER, DISABLE\_IMMEDIATELY, DISABLE\_AFTER.| |item\_prototypes|<| |Root element for host item prototype elements, which are the same as for [host items](#host-items).| |trigger\_prototypes|<| |Root element for host trigger prototype elements, which are the same as for [host item triggers](#host-item-triggers).| |graph\_prototypes|<| |Root element for host graph prototypes, which are the same as for [host graphs](#host-graphs).| |host\_prototypes|<| |Root element for host prototypes, which are the same as for [hosts](#hosts).| |parent\_discovery\_rule|<| |Root element for the parent low-level discovery rule (or rule prototype) of the low-level discovery rule prototype. This property denotes that it is an LLD rule prototype, direct child of the referenced rule/rule prototype.| |<|key|string|(required) The parent low-level discovery rule (or rule prototype) key.| |master\_item|<|string|(required for DEPENDENT rules) Root element for the dependent rule's master item.| |lld\_macro\_paths|<| |Root element for low-level discovery rule macro paths.| |<|lld\_macro|string|(required) Low-level discovery rule macro name.| |^|path|string|(required) Selector for value, which will be assigned to the corresponding macro.| |preprocessing|<| |Root element for low-level discovery rule value preprocessing.| | |step| |Root element for low-level discovery rule value preprocessing step elements, which are the same as for [host item value preprocessing steps](#host-item-preprocessing-steps), except with fewer possible values. See also: [LLD rule preprocessing object](/manual/api/reference/discoveryrule/object#lld-rule-preprocessing).| |overrides|<| |Root element for low-level discovery rule override rules.| |<|name|string|(required) Unique override name.| |^|step|string|(required) Unique order number of the override.| |^|stop|string|Stop processing next overrides if matches.| |^|filter| |Root element for low-level discovery rule override rule filter elements, which are the same as for [host low-level discovery rule filters](#host-low-level-discovery-rule-filters).| |^|operations| |Root element for [host low-level discovery rule override operations](#host-low-level-discovery-rule-override-operations).| ::: noteclassic See also: [LLD rule object](/manual/api/reference/discoveryrule/object) (refer to the relevant property with a matching name). ::: #### قوانین کشف سطح پایین میزبان ```yaml zabbix_export: (...) hosts: - host: 'MySQL server' (...) discovery_rules: - name: 'کشف پایگاه داده' key: 'mysql.db.discovery["{$MYSQL.DSN}","{$MYSQL.USER}","{$MYSQL.PASSWORD}"]' delay: 1h filter: (به جدول زیر مراجعه کنید) description: 'اسکن پایگاههای داده در DBMS.' interface_ref: if1 item_prototypes: - name: 'اندازه پایگاه داده {#DATABASE}' key: 'mysql.db.size["{$MYSQL.DSN}","{$MYSQL.USER}","{$MYSQL.PASSWORD}","{#DATABASE}"]' delay: 5m unit: B description: 'اندازه پایگاه داده.' پیشپردازش: - نوع: DISCARD_UNCHANGED_HEARTBEAT پارامترها: - 1h interface_ref: if1 برچسبها: - برچسب: کامپوننت مقدار: ذخیرهسازی - برچسب: پایگاه داده مقدار: '{#DATABASE}' lld_macro_paths: - lld_macro: '{#DATABASE}' مسیر: $.Database پیشپردازش: - نوع: DISCARD_UNCHANGED_HEARTBEAT پارامترها: - 1d (...) ``` ::: نکته مهم بیشتر عناصر قانون کشف سطح پایین میزبان مانند [host items](#host-items) هستند. جدول زیر عناصری را که با اقلام میزبان متفاوت هستند، شرح میدهد. ::: |عنصر|<|نوع|توضیحات| |-|---|---|----------------------| |type|<|string|نوع آیتم.<br>مقادیر ممکن:^[1](#footnotes)^ ZABBIX\_PASSIVE (0، پیشفرض)، TRAP (2)، SIMPLE (3)، INTERNAL (5)، ZABBIX\_ACTIVE (7)، EXTERNAL (10)، ODBC (11)، IPMI (12)، SSH (13)، TELNET (14)، JMX (16)، DEPENDENT (18)، HTTP\_AGENT (19)، SNMP\_AGENT (20)، ITEM\_TYPE\_SCRIPT (21)، ITEM\_TYPE\_BROWSER (22).| |key|<|string|(الزامی) کلید قانون کشف سطح پایین.| |filter|<| |عنصر ریشه برای [فیلترهای قانون کشف سطح پایین میزبان](#host-low-level-discovery-rule-filters).| |lifetime|<|string|دوره زمانی (با استفاده از ثانیه، [پسوند زمان](/manual/appendix/suffixes#time-suffixes)، یا [ماکرو کاربر](/manual/config/macros/user_macros))، که پس از آن دیگر منابع کشف نشده حذف میشوند.<br>پیشفرض: 7d.| |lifetime_type|<|string|سناریو برای حذف منابع LLD از دست رفته.<br>مقادیر ممکن: DELETE\_NEVER، DELETE\_IMMEDIATELY، DELETE\_AFTER.| |enabled_lifetime|<|string|دوره زمانی (با استفاده از ثانیه، [پسوند زمان](/manual/appendix/suffixes#time-suffixes)، یا [ماکرو کاربر](/manual/config/macros/user_macros))، که پس از آن دیگر منابع کشف نشده غیرفعال میشوند.| |enabled_lifetime_type|<|string|سناریو برای غیرفعال کردن منابع LLD از دست رفته.<br>مقادیر ممکن: غیرفعال کردن\_هرگز، غیرفعال کردن\_فوراً، غیرفعال کردن\_بعد.| |item\_prototypes|<| |عنصر ریشه برای عناصر نمونه اولیه آیتم میزبان، که مشابه [host items](#host-items) هستند.| |trigger\_prototypes|<| |عنصر ریشه برای عناصر نمونه اولیه تریگر میزبان، که مشابه [host item triggers](#host-item-triggers) هستند.| |graph\_prototypes|<| |عنصر ریشه برای نمونههای اولیه گراف میزبان، که مشابه [host graphs](#host-graphs) هستند.| |host\_prototypes|<| |عنصر ریشه برای نمونههای اولیه گراف میزبان، که مشابه [hosts](#hosts) هستند.| |parent\_discovery\_rule|<| |عنصر ریشه برای قانون کشف سطح پایین والد (یا نمونه اولیه قانون) از نمونه اولیه قانون کشف سطح پایین. این ویژگی نشان میدهد که این یک نمونه اولیه قانون LLD، فرزند مستقیم قانون/نمونه اولیه قانون ارجاع شده است.| |<|key|string|(الزامی) کلید قانون کشف سطح پایین والد (یا نمونه اولیه قانون).| |master\_item|<|string|(الزامی برای قوانین وابسته) عنصر ریشه برای مورد اصلی قانون وابسته.| |lld\_macro\_paths|<| |عنصر ریشه برای مسیرهای ماکروی قانون کشف سطح پایین.| |<|lld\_macro|string|(الزامی) نام ماکروی قانون کشف سطح پایین.| |^|path|string|(الزامی) انتخابگر برای مقداری که به ماکروی مربوطه اختصاص داده میشود.| |پیشپردازش|<| |عنصر ریشه برای پیشپردازش مقدار قانون کشف سطح پایین.| | |step| |عنصر ریشه برای عناصر مرحله پیشپردازش مقدار قانون کشف سطح پایین، که مشابه [مراحل پیشپردازش مقدار آیتم میزبان](#host-item-preprocessing-steps) هستند، با این تفاوت که مقادیر ممکن کمتری دارند. همچنین ببینید: [شیء پیشپردازش قانون LLD](/manual/api/reference/discoveryrule/object#lld-rule-preprocessing).| |overrides|<| |عنصر ریشه برای قوانین لغو قانون کشف سطح پایین.| |<|name|string|(required) نام لغو منحصر به فرد.| |^|step|string|(required) شماره ترتیب منحصر به فرد لغو.| |^|stop|string|در صورت تطابق، پردازش لغوهای بعدی را متوقف کنید.| |^|filter| |عنصر ریشه برای عناصر فیلتر قانون لغو قانون کشف سطح پایین، که مشابه [فیلترهای قانون کشف سطح پایین میزبان](#host-low-level-discovery-rule-filters) هستند.| |^|operations| |عنصر ریشه برای [عملیات لغو قانون کشف سطح پایین میزبان](#host-low-level-discovery-rule-override-operations).| ::: noteclassic همچنین ببینید: [شیء قانون LLD](/manual/api/reference/discoveryrule/object) (به ویژگی مربوطه با نام منطبق مراجعه کنید). ::: # host.massadd # اضافه کردن گروهی هاست ها # host.massremove # حذف گروهی هاست ها # host.massupdate # آپدیت گروهی هاست ها ## Host metadata ```yaml zabbix_export: version: '7.4' host_groups: - uuid: 748ad4d098d447d492bb935c907f652f name: Databases hosts: (see table below) graphs: (see table below) ``` |Element|<|Type|Description| |-|---|---|-----------------------| |version|<|string|(required) Zabbix version.| |host_groups|<| |(required) Root element for host groups.| |<|uuid|string|(required) Unique identifier for this host group.| |^|name|string|(required) Host group name.| |hosts|<| |Root element for [hosts](#hosts).| |graphs|<| |Root element for [host graphs](#host-graphs).| ## فراداده میزبان ```yaml zabbix_export: نسخه: '7.4' host_groups: - uuid: 748ad4d098d447d492bb935c907f652f نام: پایگاههای داده میزبانها: (به جدول زیر مراجعه کنید) نمودارها: (به جدول زیر مراجعه کنید) ``` |عنصر|<|نوع|توضیحات| |-|---|---|---------------------| |نسخه|<|رشته|(الزامی) نسخه Zabbix.| |host_groups|<| |(الزامی) عنصر ریشه برای گروههای میزبان.| |<|uuid|رشته|(الزامی) شناسه منحصر به فرد برای این گروه میزبان.| |^|نام|رشته|(الزامی) نام گروه میزبان.| |hosts|<| |عنصر ریشه برای [میزبانها](#میزبانها).| |نمودارها|<| |عنصر ریشه برای [گرافهای میزبان](#گرافهای میزبان).| # hostprototype.create # ساخت هاست نمونه # hostprototype.delete #حذف نمونه اولیه هاست # hostprototype.get # دریافت نمونه اولیه هاست # hostprototype.update # به روز رسانی نمونه اولیه هاست #### Hosts and host groups Manage host groups, hosts and everything related to them, including host interfaces, host macros and maintenance periods. [Host API](/manual/api/reference/host) | [Host group API](/manual/api/reference/hostgroup) | [Host interface API](/manual/api/reference/hostinterface) | [User macro API](/manual/api/reference/usermacro) | [Value map API](/manual/api/reference/valuemap) | [Maintenance API](/manual/api/reference/maintenance) #### میزبانها و گروههای میزبان مدیریت گروههای میزبان، میزبانها و هر چیزی که مربوط به آنهاست، از جمله رابطهای میزبان، ماکروهای میزبان و دورههای نگهداری.[Host API](/manual/api/reference/host) | [Host groupAPI](/manual/api/reference/hostgroup) | [Host interfaceAPI](/manual/api/reference/hostinterface) | [User macroAPI](/manual/api/reference/usermacro) | [Value mapAPI](/manual/api/reference/valuemap) | [MaintenanceAPI](/manual/api/reference/maintenance) # host.update # آپدیت هاست #### Host value maps ```yaml zabbix_export: (...) hosts: - host: 'MySQL server' (...) valuemaps: - name: Example value map mappings: - value: '1' newvalue: Example value (...) ``` |Element|<|Type|Description| |-|---|---|-----------------------| |uuid|<|string|(required) Unique identifier for this value map.| |name|<|string|(required) Value map name.| |mapping|<| |Root element for mappings.| |<|type|string|Mapping match type.<br>Possible values:^[1](#footnotes)^ EQUAL (0, default), GREATER_OR_EQUAL (2), LESS_OR_EQUAL (3), IN_RANGE (4), REGEXP (5), DEFAULT (6).| |^|value|string|Original value.| |^|newvalue|string|(required) Value to which the original value is mapped to.| ::: noteclassic See also: [Value map object](/manual/api/reference/valuemap/object) (refer to the relevant property with a matching name). ::: #### نقشههای مقدار میزبان ```yaml zabbix_export: (...) hosts: - host: 'MySQL server' (...) valuemaps: - name: مثال نقشه مقدار نگاشتها: - value: '1' newvalue: مثال مقدار (...) ``` |Element|<|Type|Description| |-|---|---|---------------------| |uuid|<|string|(required) شناسه منحصر به فرد برای این نقشه مقدار.| |name|<|string|(required) نام نقشه مقدار.| |mapping|<| |عنصر ریشه برای نگاشتها.| |<|type|string|نگاشت نوع تطابق.<br>مقادیر ممکن:^[1](#footnotes)^ EQUAL (0، پیشفرض)، GREATER_OR_EQUAL (2)، LESS_OR_EQUAL (3)، IN_RANGE (4)، REGEXP (5)، DEFAULT (6).| |^|value|string|مقدار اصلی.| |^|newvalue|string|(الزامی) مقداری که مقدار اصلی به آن نگاشت شده است.| ::: noteclassic همچنین ببینید: [Value map object](/manual/api/reference/valuemap/object) (به ویژگی مربوطه با نام منطبق مراجعه کنید). ::: #### Host web scenarios |Element|<|Type|Description| |-|---|---|-----------------------| |uuid|<|string|(required) Unique identifier for this web scenario.| |name|<|string|(required) Web scenario name.| |delay|<|string|Frequency (using seconds, [time suffix](/manual/appendix/suffixes#time-suffixes), or [user macro](/manual/config/macros/user_macros)) of executing web scenario.<br>Default: 1m.| |attempts|<|integer|The number of attempts for executing web scenario steps.<br>Possible values: 1-10 (default: 1).| |agent|<|string|Client agent. Zabbix will pretend to be the selected browser.<br>This is useful when a website returns different content for different browsers.<br>Default: Zabbix.| |http\_proxy|<|string|Proxy that will be used by the web scenario given as: `http://[username[:password]@]proxy.example.com[:port]`| |variables|<| |Root element for web scenario variables that may be used in scenario steps.| |<|name|string|(required) Variable name.| |^|value|text|(required) Variable value.| |headers|<| |Root element for HTTP headers to be sent when performing a request.<br>Headers should be listed using the same syntax as they would appear in the HTTP protocol.| |<|name|string|(required) Header name.| |^|value|text|(required) Header value.| |status|<|string|Web scenario status.<br>Possible values:^[1](#footnotes)^ ENABLED (0, default), DISABLED (1).| |authentication|<|string|Authentication method.<br>Possible values:^[1](#footnotes)^ NONE (0, default), BASIC (1), NTLM (2), Kerberos (3), or Digest (4).| |http\_user|<|string|User name used for BASIC (HTTP), NTLM, Kerberos, or Digest authentication.| |http\_password|<|string|Password used for BASIC (HTTP), NTLM, Kerberos, or Digest authentication.| |verify\_peer|<|string|Verify the SSL certificate of the web server.<br>Possible values:^[1](#footnotes)^ NO (0, default), YES (1).| |verify\_host|<|string|Verify that the *Common Name* field or the *Subject Alternate Name* field of the web server certificate matches.<br>Possible values:^[1](#footnotes)^ NO (0, default), YES (1).| |ssl\_cert\_file|<|string|Name of the SSL certificate file used for client authentication (must be in PEM format).| |ssl\_key\_file|<|string|Name of the SSL private key file used for client authentication (must be in PEM format).| |ssl\_key\_password|<|string|SSL private key file password.| |steps|<| |(required) Root element for [host web scenario steps](#host-web-scenario-steps).| |tags|<| |Root element for web scenario tags.| |<|tag|string|(required) Tag name.| |^|value|string|Tag value.| ::: noteclassic See also: [Web scenario object](/manual/api/reference/httptest/object) (refer to the relevant property with a matching name). ::: ##### تگ های وب سناریو هاست ها |Element|Element property|Required|Type|Range^**[1](#footnotes)**^|Description| |--|--|-|--|----|--------| |httptests| |\-| | |Root element for web scenarios.| | |name|x|`string`| |Web scenario name.| | |delay|\-|`string`|Default: 1m|Frequency of executing the web scenario. Seconds, time unit with suffix or user macro.| | |attempts|\-|`integer`|1-10 (default: 1)|The number of attempts for executing web scenario steps.| | |agent|\-|`string`|Default: Zabbix|Client agent. Zabbix will pretend to be the selected browser. This is useful when a website returns different content for different browsers.| | |http\_proxy|\-|`string`| |Specify an HTTP proxy to use, using the format: `http://[username[:password]@]proxy.example.com[:port]`| |variables| |\-| | |Root element for scenario-level variables (macros) that may be used in scenario steps.| | |name|x|`text`| |Variable name.| | |value|x|`text`| |Variable value.| |headers| |\-| | |Root element for HTTP headers that will be sent when performing a request. Headers should be listed using the same syntax as they would appear in the HTTP protocol.| | |name|x|`text`| |Header name.| | |value|x|`text`| |Header value.| | |status|\-|`string`|0 - ENABLED (default)<br>1 - DISABLED|Web scenario status.| | |authentication|\-|`string`|0 - NONE (default)<br>1 - BASIC<br>2 - NTLM|Authentication method.| | |http\_user|\-|`string`| |User name used for basic, HTTP or NTLM authentication.| | |http\_password|\-|`string`| |Password used for basic, HTTP or NTLM authentication.| | |verify\_peer|\-|`string`|0 - NO (default)<br>1 - YES|Verify the SSL certificate of the web server.| | |verify\_host|\-|`string`|0 - NO (default)<br>1 - YES|Verify that the Common Name field or the Subject Alternate Name field of the web server certificate matches.| | |ssl\_cert\_file|\-|`string`| |Name of the SSL certificate file used for client authentication (must be in PEM format).| | |ssl\_key\_file|\-|`string`| |Name of the SSL private key file used for client authentication (must be in PEM format).| | |ssl\_key\_password|\-|`string`| |SSL private key file password.| |steps| |x| | |Root element for web scenario steps.| | |name|x|`string`| |Web scenario step name.| | |url|x|`string`| |URL for monitoring.| |query\_fields| |\-| | |Root element for query fields - an array of HTTP fields that will be added to the URL when performing a request.| | |name|x|`string`| |Query field name.| | |value|\-|`string`| |Query field value.| |posts| |\-| | |HTTP POST variables as a string (raw post data) or as an array of HTTP fields (form field data).| | |name|x|`string`| |Post field name.| | |value|x|`string`| |Post field value.| |variables| |\-| | |Root element of step-level variables (macros) that should be applied after this step.<br><br>If the variable value has a 'regex:' prefix, then its value is extracted from the data returned by this step according to the regular expression pattern following the 'regex:' prefix| | |name|x|`string`| |Variable name.| | |value|x|`string`| |Variable value.| |headers| |\-| | |Root element for HTTP headers that will be sent when performing a request. Headers should be listed using the same syntax as they would appear in the HTTP protocol.| | |name|x|`string`| |Header name.| | |value|x|`string`| |Header value.| | |follow\_redirects|\-|`string`|0 - NO<br>1 - YES (default)|Follow HTTP redirects.| | |retrieve\_mode|\-|`string`|0 - BODY (default)<br>1 - HEADERS<br>2 - BOTH|HTTP response retrieve mode.| | |timeout|\-|`string`|Default: 15s|Timeout of step execution. Seconds, time unit with suffix or user macro.| | |required|\-|`string`| |Text that must be present in the response. Ignored if empty.| | |status\_codes|\-|`string`| |A comma delimited list of accepted HTTP status codes. Ignored if empty. For example: 200-201,210-299| |tags| |\-| | |Root element for web scenario tags.| | |tag|x|`string`| |Tag name.| | |value|\-|`string`| |Tag value.| ##### Host web scenario steps |Element|<|Type|Description| |-|---|---|-----------------------| |name|<|string|(required) Web scenario step name.| |url|<|string|(required) URL for monitoring.| |query\_fields|<| |Root element for query parameters (an array of HTTP fields to be added to the URL when performing a request).| |<|name|string|(required) Query parameter name.| |^|value|string|Query parameter value.| |posts|<| |Root element for HTTP POST variables (a string (raw post data) or an array of HTTP fields (form field data)).| |<|name|string|(required) Post field name.| |^|value|string|(required) Post field value.| |variables|<| |Root element of step-level variables (macros) that should be applied after this step.<br>If the variable value has a 'regex:' prefix, then its value is extracted from the data returned by this step according to the regular expression pattern following the 'regex:' prefix| |<|name|string|(required) Variable name.| |^|value|text|(required) Variable value.| |headers|<| |Root element for HTTP headers to be sent when performing a request.| |<|name|string|(required) Header name.| |^|value|text|(required) Header value.| |follow\_redirects|<|string|Follow HTTP redirects.<br>Possible values:^[1](#footnotes)^ NO (0), YES (1, default).| |retrieve\_mode|<|string|HTTP response retrieve mode.<br>Possible values:^[1](#footnotes)^ BODY (0, default), HEADERS (1), BOTH (2).| |timeout|<|string|Timeout (using seconds, [time suffix](/manual/appendix/suffixes#time-suffixes), or [user macro](/manual/config/macros/user_macros)) of step execution.<br>Default: 15s.| |required|<|string|Text that must be present in the response (ignored if empty).| |status\_codes|<|string|A comma-delimited list of accepted HTTP status codes (e.g., `200-201,210-299`; ignored if empty).| ::: noteclassic See also: [Web scenario step object](/manual/api/reference/httptest/object#scenario-step) (refer to the relevant property with a matching name). ::: ##### مراحل سناریوی وب میزبان |عنصر|<|نوع|توضیحات| |-|---|---|----------------------| |نام|<|رشته|(الزامی) نام مرحله سناریوی وب.| |آدرس|<|رشته|(الزامی) آدرس اینترنتی برای نظارت.| |پرسش\_فیلدها|<| |عنصر ریشه برای پارامترهای پرس و جو (آرایهای از فیلدهای HTTP که هنگام انجام یک درخواست به URL اضافه میشوند).| |<|نام|رشته|(الزامی) نام پارامتر پرس و جو.| |^|مقدار|رشته|مقدار پارامتر پرس و جو.| |پستها|<| |عنصر ریشه برای متغیرهای HTTP POST (یک رشته (دادههای خام پست) یا آرایهای از فیلدهای HTTP (دادههای فیلد فرم)).| |<|نام|رشته|(الزامی) نام فیلد پست.| |^|مقدار|رشته|(الزامی) مقدار فیلد پست.| |متغیرها|<| |عنصر ریشه متغیرهای سطح مرحله (ماکروها) که باید پس از این مرحله اعمال شوند.<br>اگر مقدار متغیر دارای پیشوند 'regex:' باشد، مقدار آن از دادههای برگردانده شده توسط این مرحله طبق الگوی عبارت منظم پس از پیشوند 'regex:' استخراج میشود.| |<|name|string|(الزامی) نام متغیر.| |^|value|text|(الزامی) مقدار متغیر.| |headers|<| |عنصر ریشه برای هدرهای HTTP که هنگام انجام درخواست ارسال میشوند.| |<|name|string|(الزامی) نام هدر.| |^|value|text|(الزامی) مقدار هدر.| |follow\_redirects|<|string|Follow HTTP redirects.<br>مقادیر ممکن:^[1](#footnotes)^ خیر (0)، بله (1، پیشفرض).| |retrieve\_mode|<|string|HTTP response retrieve mode.<br>مقادیر ممکن:^[1](#footnotes)^ BODY (0، پیشفرض)، HEADERS (1)، هر دو (2).| |timeout|<|string|Timeout (با استفاده از ثانیه، [time suffix](/manual/appendix/suffixes#time-suffixes)، یا [user macro](/manual/config/macros/user_macros)) از اجرای مرحله.<br>پیشفرض: 15 ثانیه.| |required|<|string|متنی که باید در پاسخ وجود داشته باشد (در صورت خالی بودن نادیده گرفته میشود).| |status\_codes|<|string|لیستی از کدهای وضعیت HTTP پذیرفته شده که با کاما از هم جدا شدهاند (مثلاً `200-201,210-299`؛ در صورت خالی بودن نادیده گرفته میشوند).| ::: noteclassic همچنین ببینید: [Web scenario step object](/manual/api/reference/httptest/object#scenario-step) (به ویژگی مربوطه با نام منطبق مراجعه کنید). ::: #### Housekeeping Configure housekeeping. [Housekeeping API](/manual/api/reference/housekeeping) #### خانهداری پیکربندی خانهداری.[رابط برنامهنویسی خانهداری](/manual/api/reference/housekeeping) # housekeeping.get # دریافت اطلاعات ذخیره شده # housekeeping.update # آپدیت ذخیره سازی داده ### How modules work - An enabled module is launched on each HTTP request, before executing the action code. - The module will register new actions or redefine the existing ones. - The module will add new frontend sections and remove or redefine the existing ones. - The module will hook to frontend events like onBeforeAction and onTerminate, if needed. - The requested action is finally executed by running the action code - either the default one, or module-defined. ### نحوه کار ماژولها - قبل از اجرای کد اکشن، یک ماژول فعالشده در هر درخواست HTTP راهاندازی میشود. - ماژول اکشنهای جدید را ثبت میکند یا اکشنهای موجود را دوباره تعریف میکند. - ماژول بخشهای جدید frontend را اضافه و بخشهای موجود را حذف یا دوباره تعریف میکند. - در صورت نیاز، ماژول به رویدادهای frontend مانند onBeforeAction و onTerminate متصل میشود. - اکشن درخواستی در نهایت با اجرای کد اکشن - چه کد پیشفرض و چه کد تعریفشده توسط ماژول - اجرا میشود. # httptest.create # ساخت Http تست # httptest.delete # حذف Http تست # httptest.get # دریافت Http تست # httptest.update # به روز رسانی http # iconmap.create # ساخت آیکون مپ # iconmap.delete # حذف آیکون مپ # iconmap.get # دریافت آیکون مپ # iconmap.update #دکمه آپدیت نقشه ### id Module ID. Must be unique. To avoid future naming conflicts, it is recommended to use prefix for modules (author or company name, or any other). For example, if a module is an example for lessons and the module name is "My module", then the ID will be "example_my_module". *Type*: String *Example*: ```json "id": "example_my_module" ``` ### شناسه شناسه ماژول. باید منحصر به فرد باشد. برای جلوگیری از تداخل نامگذاری در آینده، توصیه میشود از پیشوند برای ماژولها (نام نویسنده یا شرکت یا هر چیز دیگری) استفاده کنید. به عنوان مثال، اگر یک ماژول نمونهای برای درسها باشد و نام ماژول "ماژول من" باشد، شناسه "example_my_module" خواهد بود. *نوع*: رشته *مثال*: ```json "id": "example_my_module" ```` ##### If installed as package Zabbix proxy runs as a daemon process. The proxy can be started by executing: ```bash systemctl start zabbix-proxy ``` This will work on most of GNU/Linux systems. On other systems you may need to run: ```bash /etc/init.d/zabbix-proxy start ``` Similarly, for stopping/restarting/viewing status of Zabbix proxy, use the following commands: ```bash systemctl stop zabbix-proxy systemctl restart zabbix-proxy systemctl status zabbix-proxy ``` ##### اگر به عنوان بسته نصب شود، پروکسی زبیکس به عنوان یک فرآیند دیمن اجرا میشود. پروکسی را میتوان با اجرای دستور زیر آغاز کرد:```bashsystemctl start zabbix-proxy```این دستور روی اکثر سیستمهای گنو/لینوکس کار میکند. در سایر سیستمها ممکن است لازم باشد دستور زیر را اجرا کنید:```bash/etc/init.d/zabbix-proxy start```به طور مشابه، برای توقف/راهاندازی مجدد/مشاهده وضعیت پروکسی زبیکس، از دستورات زیر استفاده کنید:```bashsystemctl stop zabbix-proxysystemctl restart zabbix-proxysystemctl status zabbix-proxy``` # image.create #ساخت Image #### Importing To import hosts, do the following: 1. Go to *Data collection* → *Hosts*. 2. Click *Import* in the upper-right corner. 3. Select the import file. 4. Click *Import* in the lower-right corner of the configuration form. ![](../../../assets/en/manual/xml_export_import/import_hosts.png){width="600"} If you mark the *Advanced options* checkbox, a detailed list of all importable elements will be displayed - mark or unmark each import rule as required. If you click the checkbox in the *All* row, all elements below it will be marked/unmarked. Import rules: |Rule|Description| |----|-----------| |*Update existing*|Existing elements will be updated using data from the import file. Otherwise, they will not be updated.| |*Create new*|New elements will be created using data from the import file. Otherwise, they will not be created.| |*Delete missing*|Existing elements not present in the import file will be removed. Otherwise, they will not be removed.<br>If *Delete missing* is marked for *Template linkage*, current template linkage not present in the import file will be unlinked. Entities (items, triggers, graphs, etc.) inherited from the unlinked templates will not be removed (unless the *Delete missing* option is selected for each entity as well).| A success or failure message of the import will be displayed in the frontend. #### وارد کردن برای وارد کردن میزبانها، موارد زیر را انجام دهید: 1. به *مجموعه دادهها* → *میزبانها* بروید. 2. در گوشه بالا سمت راست روی *وارد کردن* کلیک کنید. 3. فایل وارد کردن را انتخاب کنید. 4. در گوشه پایین سمت راست فرم پیکربندی، روی *وارد کردن* کلیک کنید. ![](../../../assets/en/manual/xml_export_import/import_hosts.png){width="600"} اگر کادر انتخاب *گزینههای پیشرفته* را علامت بزنید، لیست مفصلی از تمام عناصر قابل وارد کردن نمایش داده میشود - هر قانون وارد کردن را در صورت نیاز علامت بزنید یا علامت آن را بردارید. اگر کادر انتخاب در ردیف *همه* را کلیک کنید، تمام عناصر زیر آن علامتگذاری/بدون علامت میشوند. قوانین وارد کردن: |قانون|توضیحات| |----|-----------| |*بهروزرسانی موجود*|عناصر موجود با استفاده از دادههای فایل واردات بهروزرسانی میشوند. در غیر این صورت، بهروزرسانی نخواهند شد.| |*ایجاد جدید*|عناصر جدید با استفاده از دادههای فایل واردات ایجاد میشوند. در غیر این صورت، ایجاد نخواهند شد.| |*حذف موارد گمشده*|عناصر موجودی که در فایل واردات وجود ندارند حذف میشوند. در غیر این صورت، حذف نخواهند شد.<br>اگر *حذف موارد گمشده* برای *پیوند الگو* علامتگذاری شده باشد، پیوند الگوی فعلی که در فایل واردات وجود ندارد، لغو پیوند میشود. موجودیتها (آیتمها، تریگرها، نمودارها و غیره) که از قالبهای بدون پیوند به ارث بردهاند، حذف نخواهند شد (مگر اینکه گزینه *حذف موارد گمشده* نیز برای هر موجودیت انتخاب شده باشد).| پیام موفقیت یا شکست واردات در ظاهر نمایش داده میشود. #### Importing To import media types, do the following: 1. Go to *Alerts* → *Media types*. 2. Click *Import* in the upper-right corner. 3. Select the import file. 4. Mark the required options in import rules. 5. Click *Import* in the lower-right corner of the configuration form. ![](../../../assets/en/manual/xml_export_import/import_media.png){width="600"} Import rules: |Rule|Description| |----|-----------| |*Update existing*|Existing elements will be updated using data from the import file. Otherwise, they will not be updated.| |*Create new*|New elements will be created using data from the import file. Otherwise, they will not be created.| A success or failure message of the import will be displayed in the frontend. #### وارد کردن برای وارد کردن انواع رسانه، موارد زیر را انجام دهید: 1. به *هشدارها* → *انواع رسانه* بروید. 2. در گوشه بالا سمت راست روی *وارد کردن* کلیک کنید. 3. فایل وارد کردن را انتخاب کنید. 4. گزینههای مورد نیاز را در قوانین وارد کردن علامت بزنید. 5. در گوشه پایین سمت راست فرم پیکربندی روی *وارد کردن* کلیک کنید. ![](../../../assets/en/manual/xml_export_import/import_media.png){width="600"} قوانین وارد کردن: |قانون|توضیحات| |----|----------| |*بهروزرسانی موجود*|عناصر موجود با استفاده از دادههای فایل وارد کردن بهروزرسانی میشوند. در غیر این صورت، بهروزرسانی نمیشوند.| |*ایجاد جدید*|عناصر جدید با استفاده از دادههای فایل وارد کردن ایجاد میشوند. در غیر این صورت، آنها ایجاد نخواهند شد.| پیام موفقیت یا عدم موفقیت واردات در قسمت کاربری نمایش داده خواهد شد. #### Importing To import network maps, do the following: 1. Go to *Monitoring* → *Maps*. 2. Click *Import* in the upper-right corner. 3. Select the import file. 4. Mark the required options in import rules. 5. Click *Import* in the lower-right corner of the configuration form. ![](../../../assets/en/manual/xml_export_import/import_maps.png){width="600"} Import rules: |Rule|Description| |----|-----------| |*Update existing*|Existing maps will be updated using data from the import file. Otherwise, they will not be updated.| |*Create new*|New maps will be created using data from the import file. Otherwise, they will not be created.| If you uncheck both map options and check the respective options for images, images only will be imported. Image importing is only available to *Super admin* users. A success or failure message of the import will be displayed in the frontend. ::: notewarning If replacing an existing image, it will affect all maps that are using this image. ::: #### وارد کردن برای وارد کردن نقشههای شبکه، موارد زیر را انجام دهید: 1. به *Monitoring* → *Maps* بروید. 2. در گوشه بالا سمت راست روی *Import* کلیک کنید. 3. فایل وارد کردن را انتخاب کنید. 4. گزینههای مورد نیاز را در قسمت import rules علامت بزنید. 5. در گوشه پایین سمت راست فرم پیکربندی، روی *Import* کلیک کنید. ![](../../../assets/en/manual/xml_export_import/import_maps.png){width="600"} وارد کردن قوانین: |Rule|Description| |----|-----------| |*بهروزرسانی موجود*|نقشههای موجود با استفاده از دادههای فایل وارد کردن بهروزرسانی میشوند. در غیر این صورت، بهروزرسانی نخواهند شد.| |*ایجاد جدید*|نقشههای جدید با استفاده از دادههای فایل وارد کردن ایجاد میشوند. در غیر این صورت، آنها ایجاد نخواهند شد.| اگر هر دو گزینه نقشه را بردارید و گزینههای مربوط به تصاویر را علامت بزنید، فقط تصاویر وارد میشوند. وارد کردن تصویر فقط برای کاربران *مدیر ارشد* در دسترس است. پیام موفقیت یا عدم موفقیت وارد کردن در قسمت کاربری نمایش داده میشود. ::: notewarning اگر یک تصویر موجود جایگزین شود، بر تمام نقشههایی که از این تصویر استفاده میکنند تأثیر میگذارد. ::: #### Importing To import templates, do the following: 1. Go to *Data collection* → *Templates*. 2. Click *Import* in the upper-right corner. 3. Select the import file. 4. Click *Import* in the lower-right corner of the configuration form. ![](../../../assets/en/manual/xml_export_import/import_templates.png){width="600"} If you mark the *Advanced options* checkbox, a detailed list of all importable elements will be displayed - mark or unmark each import rule as required. If you click the checkbox in the *All* row, all elements below it will be marked/unmarked. Import rules: |Rule|Description| |----|-----------| |*Update existing*|Existing elements will be updated using data from the import file. Otherwise, they will not be updated.| |*Create new*|New elements will be created using data from the import file. Otherwise, they will not be created.| |*Delete missing*|Existing elements not present in the import file will be removed. Otherwise, they will not be removed.<br>If *Delete missing* is marked for *Template linkage*, current template linkage not present in the import file will be unlinked. Entities (items, triggers, graphs, etc.) inherited from the unlinked templates will not be removed (unless the *Delete missing* option is selected for each entity as well).| ::: noteimportant If templates with the same names already exist, the *Delete missing* options should be checked when importing to achieve a clean import. This way, the old items that are no longer in the updated template will be removed (note that it will mean losing history of these old items). ::: On the next screen, you will be able to view the content of a template being imported. If this is a new template, all elements will be listed in green. If updating an existing template, new template elements will be highlighted in green; removed template elements will be highlighted in red; elements that have not changed will be listed on a gray background. ![](../../../assets/en/manual/xml_export_import/import_templates_details.png){width="600"} The menu on the left can be used to navigate through the list of changes. The *Updated* section highlights all changes made to existing template elements. The *Added* section lists new template elements. The elements in each section are grouped by element type; click the gray arrow to expand or collapse the group of elements. ![](../../../assets/en/manual/xml_export_import/import_templates_menu.png) Review template changes and then click *Import* to perform the template import. A success or failure message of the import will be displayed in the frontend. #### وارد کردن برای وارد کردن قالبها، موارد زیر را انجام دهید: 1. به *مجموعه دادهها* → *قالبها* بروید. 2. در گوشه بالا سمت راست روی *وارد کردن* کلیک کنید. 3. فایل وارد کردن را انتخاب کنید. 4. در گوشه پایین سمت راست فرم پیکربندی، روی *وارد کردن* کلیک کنید. ![](../../../assets/en/manual/xml_export_import/import_templates.png){width="600"} اگر کادر انتخاب *گزینههای پیشرفته* را علامت بزنید، لیست مفصلی از تمام عناصر قابل وارد کردن نمایش داده میشود - هر قانون وارد کردن را در صورت نیاز علامت بزنید یا علامت آن را بردارید. اگر کادر انتخاب در ردیف *همه* را کلیک کنید، تمام عناصر زیر آن علامتگذاری/بدون علامت میشوند. قوانین وارد کردن: |قانون|توضیحات| |----|-----------| |*بهروزرسانی موجود*|عناصر موجود با استفاده از دادههای فایل واردات بهروزرسانی میشوند. در غیر این صورت، بهروزرسانی نخواهند شد.| |*ایجاد جدید*|عناصر جدید با استفاده از دادههای فایل واردات ایجاد میشوند. در غیر این صورت، ایجاد نخواهند شد.| |*حذف موارد از دست رفته*|عناصر موجودی که در فایل واردات وجود ندارند حذف میشوند. در غیر این صورت، حذف نخواهند شد.<br>اگر *حذف موارد از دست رفته* برای *پیوند الگو* علامتگذاری شده باشد، پیوند الگوی فعلی که در فایل واردات وجود ندارد، لغو پیوند میشود. موجودیتها (آیتمها، تریگرها، نمودارها و غیره) که از قالبهای بدون پیوند به ارث بردهاند، حذف نخواهند شد (مگر اینکه گزینه *حذف موارد از دست رفته* برای هر موجودیت نیز انتخاب شده باشد).| در صفحه بعد، میتوانید محتوای یک قالب در حال وارد شدن را مشاهده کنید. اگر این یک قالب جدید باشد، همه عناصر به رنگ سبز فهرست میشوند. در صورت بهروزرسانی یک قالب موجود، عناصر قالب جدید به رنگ سبز برجسته میشوند؛ عناصر قالب حذف شده به رنگ قرمز برجسته میشوند؛ عناصری که تغییر نکردهاند، روی یک پسزمینه خاکستری فهرست میشوند. ![](../../../assets/en/manual/xml_export_import/import_templates_details.png){width="600"} از منوی سمت چپ میتوان برای پیمایش در لیست تغییرات استفاده کرد. بخش *بهروزرسانیشده* تمام تغییرات ایجاد شده در عناصر قالب موجود را برجسته میکند. بخش *اضافهشده* عناصر قالب جدید را فهرست میکند. عناصر هر بخش بر اساس نوع عنصر گروهبندی شدهاند؛ برای باز یا بسته کردن گروه عناصر، روی پیکان خاکستری کلیک کنید. ![](../../../assets/en/manual/xml_export_import/import_templates_menu.png) تغییرات قالب را بررسی کنید و سپس برای انجام وارد کردن قالب، روی *وارد کردن* کلیک کنید. پیام موفقیت یا شکست وارد کردن در ظاهر نمایش داده میشود. #### Import To use zabbix\_utils for collecting item values, import the `Getter` class in your Python script: ```python from zabbix_utils import Getter ``` #### وارد کردن ماژول (Import) برای استفاده از **zabbix_utils** جهت جمعآوری مقادیر آیتمها، کلاس `Getter` را در اسکریپت Python خود وارد کنید: ```python from zabbix_utils import Getter ``` #### Import To use zabbix\_utils for working with Zabbix API, import the `ZabbixAPI` class in your script: ```python from zabbix_utils import ZabbixAPI ``` ::: noteclassic If you already use a [community Python library](https://www.zabbix.com/integrations/python), you can usually replace that import with `ZabbixAPI` from zabbix\_utils. ::: > **توجه:** > اگر از قبل از یک کتابخانه Python مبتنی بر Community استفاده میکنید (ارائهشده در بخش Python در Zabbix)، معمولاً میتوانید دستور import فعلی را با `ZabbixAPI` از کتابخانه **zabbix_utils** جایگزین کنید. ## Index [NAME](#lbAB) [SYNOPSIS](#lbAC) [DESCRIPTION](#lbAD) [OPTIONS](#lbAE) [EXAMPLES](#lbAF) [SEE ALSO](#lbAG) ------------------------------------------------------------------------ This document was created on: 21:23:35 GMT, March 18, 2020 ## فهرست مطالب [NAME](#lbAB) [خلاصه] (#lbAC) [DESCRIPTION](#lbAD) [OPTIONS](#lbAE) [](#lbAF) [FILES](#lbAG) [همچنین ببینید] (#lbAH) [AUTHOR](#lbAI) ------------------------------------------------ ---------------------- این سند توسط [man2html](/man/man2html)، با استفاده از راهنما ایجاد شده است صفحات.\ زمان: 14:07:57 GMT، 22 نوامبر 2021 ## Index [NAME](#lbAB) [SYNOPSIS](#lbAC) [DESCRIPTION](#lbAD) [OPTIONS](#lbAE) [FILES](#lbAF) [SEE ALSO](#lbAG) [AUTHOR](#lbAH) ------------------------------------------------------------------------ This document was created on: 12:58:30 GMT, June 11, 2021 ## فهرست مطالب [NAME](#lbAB) [خلاصه] (#lbAC) [DESCRIPTION](#lbAD) [OPTIONS](#lbAE) [FILES](#lbAF) [همچنین ببینید] (#lbAG) [AUTHOR](#lbAH) ------------------------------------------------ ---------------------- این سند توسط [man2html](/documentation/6.0/manpages) ایجاد شده است. با استفاده از صفحات دستی.\ زمان: 12:58:30 GMT، 11 ژوئن 2021 ## Index [NAME](#lbAB) [SYNOPSIS](#lbAC) [DESCRIPTION](#lbAD) [OPTIONS](#lbAE) [](#lbAF) [EXAMPLES](#lbAG) [SEE ALSO](#lbAH) [AUTHOR](#lbAI) ------------------------------------------------------------------------ This document was created on: 08:42:29 GMT, June 11, 2021 ## فهرست مطالب [NAME](#lbAB) [خلاصه] (#lbAC) [DESCRIPTION](#lbAD) [OPTIONS](#lbAE) [](#lbAF) [FILES](#lbAG) [همچنین ببینید] (#lbAH) [AUTHOR](#lbAI) ------------------------------------------------ ---------------------- این سند توسط [man2html](/man/man2html)، با استفاده از راهنما ایجاد شده است صفحات.\ زمان: 14:07:57 GMT، 22 نوامبر 2021 ## Index [NAME](#lbAB) [SYNOPSIS](#lbAC) [DESCRIPTION](#lbAD) [OPTIONS](#lbAE) [](#lbAF) [EXIT STATUS](#lbAG) [EXAMPLES](#lbAH) [SEE ALSO](#lbAI) [AUTHOR](#lbAJ) ------------------------------------------------------------------------ This document was created on: 08:42:39 GMT, June 11, 2021 ## فهرست مطالب [NAME](#lbAB) [خلاصه] (#lbAC) [DESCRIPTION](#lbAD) [OPTIONS](#lbAE) [](#lbAF) [FILES](#lbAG) [همچنین ببینید] (#lbAH) [AUTHOR](#lbAI) ------------------------------------------------ ---------------------- این سند توسط [man2html](/man/man2html)، با استفاده از راهنما ایجاد شده است صفحات.\ زمان: 14:07:57 GMT، 22 نوامبر 2021 ## Index [NAME](#lbAB) [SYNOPSIS](#lbAC) [DESCRIPTION](#lbAD) [OPTIONS](#lbAE) [](#lbAF) [FILES](#lbAG) [SEE ALSO](#lbAH) [AUTHOR](#lbAI) ------------------------------------------------------------------------ This document was created on: 14:07:57 GMT, November 22, 2021 ## فهرست مطالب [NAME](#lbAB) [خلاصه] (#lbAC) [DESCRIPTION](#lbAD) [OPTIONS](#lbAE) [](#lbAF) [FILES](#lbAG) [همچنین ببینید] (#lbAH) [AUTHOR](#lbAI) ------------------------------------------------ ---------------------- این سند توسط [man2html](/man/man2html)، با استفاده از راهنما ایجاد شده است صفحات.\ زمان: 14:07:57 GMT، 22 نوامبر 2021 ## Index [NAME](#lbAB) [SYNOPSIS](#lbAC) [DESCRIPTION](#lbAD) [OPTIONS](#lbAE) [](#lbAF) [](#lbAG) [FILES](#lbAH) [SEE ALSO](#lbAI) [AUTHOR](#lbAJ) ------------------------------------------------------------------------ This document was created on: 16:12:14 GMT, September 04, 2020 ## فهرست مطالب [NAME](#lbAB) [خلاصه] (#lbAC) [DESCRIPTION](#lbAD) [OPTIONS](#lbAE) [](#lbAF) [](#lbAG) [FILES](#lbAH) [همچنین ببینید] (#lbAI) [AUTHOR](#lbAJ) ------------------------------------------------ ---------------------- این سند توسط [man2html](/documentation/5.2/manpages) ایجاد شده است. با استفاده از صفحات دستی.\ زمان: 16:12:14 GMT، 04 سپتامبر 2020 ## Index [NAME](#lbAB) [SYNOPSIS](#lbAC) [DESCRIPTION](#lbAD) [OPTIONS](#lbAE) [](#lbAF) [](#lbAG) [FILES](#lbAH) [SEE ALSO](#lbAI) [AUTHOR](#lbAJ) ------------------------------------------------------------------------ This document was created on: 16:12:22 GMT, September 04, 2020 ## فهرست مطالب [NAME](#lbAB) [خلاصه] (#lbAC) [DESCRIPTION](#lbAD) [OPTIONS](#lbAE) [](#lbAF) [FILES](#lbAG) [همچنین ببینید] (#lbAH) [AUTHOR](#lbAI) ------------------------------------------------ ---------------------- این سند توسط [man2html](/man/man2html)، با استفاده از راهنما ایجاد شده است صفحات.\ زمان: 14:07:57 GMT، 22 نوامبر 2021 ## Index [NAME](#lbAB) [SYNOPSIS](#lbAC) [DESCRIPTION](#lbAD) [OPTIONS](#lbAE) [](#lbAF) [](#lbAG) [FILES](#lbAH) [SEE ALSO](#lbAI) [AUTHOR](#lbAJ) ------------------------------------------------------------------------ This document was created on: 20:50:13 GMT, November 22, 2021 ## فهرست مطالب [NAME](#lbAB) [خلاصه] (#lbAC) [DESCRIPTION](#lbAD) [OPTIONS](#lbAE) [](#lbAF) [FILES](#lbAG) [همچنین ببینید] (#lbAH) [AUTHOR](#lbAI) ------------------------------------------------ ---------------------- این سند توسط [man2html](/man/man2html)، با استفاده از راهنما ایجاد شده است صفحات.\ زمان: 14:07:57 GMT، 22 نوامبر 2021 ##### In range {#inrange} Define a range that a value should be in by specifying minimum/maximum values (inclusive). Comments: - Numeric values are accepted (including any number of digits, optional decimal part and optional exponential part, negative values);<br> - The minimum value should be less than the maximum;<br> - At least one value must exist;<br> - User macros and low-level discovery macros can be used;<br> - If you mark the *Custom on fail* checkbox, it is possible to specify custom error-handling options: either to discard the value, set a specified value, or set a specified error message. In case of a failed preprocessing step, the item will not become unsupported if the option to discard the value or set a specified value is selected. ##### در محدوده {#inrange} با مشخص کردن حداقل/حداکثر مقادیر (شامل)، محدودهای را که یک مقدار باید در آن باشد، تعریف کنید. توضیحات: - مقادیر عددی پذیرفته میشوند (شامل هر تعداد رقم، بخش اعشاری اختیاری و بخش نمایی اختیاری، مقادیر منفی)؛ <br> - حداقل مقدار باید کمتر از حداکثر باشد؛ <br> - حداقل یک مقدار باید وجود داشته باشد؛ <br> - ماکروهای کاربر و ماکروهای کشف سطح پایین قابل استفاده هستند؛ <br> - اگر کادر *سفارشی در صورت عدم موفقیت* را علامت بزنید، میتوانید گزینههای سفارشی مدیریت خطا را تعیین کنید: یا مقدار را حذف کنید، یک مقدار مشخص را تنظیم کنید یا یک پیام خطای مشخص را تنظیم کنید. در صورت شکست یک مرحله پیشپردازش، اگر گزینه حذف مقدار یا تنظیم یک مقدار مشخص انتخاب شود، مورد پشتیبانی نشده باقی میماند. ## Introduction The following examples describe how to add users to your organization and nodes. :::noteclassic Copying, clearing, and resetting frontend password can be only performed by the owner. ::: ## مقدمه مثالهای زیر نحوه اضافه کردن کاربران به سازمان و نودهای شما را شرح میدهند. # itemprototype.get # دریافت نمونه اولیه هاست # itemprototype.update # به روز رسانی نمونه اولیه هاست #### Items Define items to monitor. [Item API](/manual/api/reference/item) #### ItemsDefine items to monitor.[Item API](/manual/api/reference/item) ##### Item value The following parameters are supported if *Data* is set to "Item value". ::: noteclassic The first number in the *Thresholds* property name (e.g. columnsthresholds.0.color.0) references the column for which thresholds are configured, while the second number references threshold place in a list, sorted in ascending order. However, if thresholds are configured in a different order, the values will be sorted in ascending order after updating widget configuration in Zabbix frontend (e.g. `"threshold.0.threshold":"5"` → `"threshold.0.threshold":"1"`; `"threshold.1.threshold":"1"` → `"threshold.1.threshold": "5"`). ::: |Parameter|<|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-|--------|--|--------|-------------------------------| |*Item*|<|1 |columns.0.item|Valid item name.<br><br>When configuring the widget on a [template dashboard](/manual/api/reference/templatedashboard/object), only items configured on the template should be set.| |*Display item value as*|<|0|columns.0.display_value_as|0 - *(default)* Numeric;<br>1 - Text;<br>2 - Binary.| |*Display*|<|0|columns.0.display|1 - *(default)* As is;<br>2 - Bar;<br>3 - Indicators;<br>6 - Sparkline.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Display item value as* is set to "Numeric"| |*Min*|<|1|columns.0.min|Any numeric value.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Display item value as* is set to "Numeric" and *Display* is set to "Bar" or "Indicators"| |*Max*|<|1|columns.0.max|Any numeric value.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Display item value as* is set to "Numeric" and *Display* is set to "Bar" or "Indicators"| |*Decimal places*|<|0|columns.0.decimal_places|Possible values range from 0-10.<br><br>Default: 2.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Display item value as* is set to "Numeric"| |*Sparkline*|<|<|<|<| |<|*Width*|0|columns.0.sparkline.width|Possible values range from 0-10.<br><br>Default: 1.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Display item value as* is set to "Numeric" and *Display* is set to "Sparkline"| |^|*Fill*|0|columns.0.sparkline.fill|Possible values range from 0-10.<br><br>Default: 3.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Display item value as* is set to "Numeric" and *Display* is set to "Sparkline"| |^|*Color*|1|columns.0.sparkline.color|Hexadecimal color code (e.g. `FF0000`).<br><br>Default: `42A5F5`.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Display item value as* is set to "Numeric" and *Display* is set to "Sparkline"| |^|*Time period*|1|columns.0.sparkline.time_period.\_reference|`DASHBOARD._timeperiod` - set the [*Time period* selector](/manual/web_interface/time_period_selector) as the data source;<br>`ABCDE._timeperiod` - set a [compatible widget](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (with its `reference` parameter equal to `ABCDE`) as the data source.<br><br>Default: `DASHBOARD._timeperiod`<br><br>Alternatively, you can set the time period only in the *From* and *To* parameters.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Display item value as* is set to "Numeric" and *Display* is set to "Sparkline"| |^|*From*|1|columns.0.sparkline.time_period.from|Valid time string in absolute (`YYYY-MM-DD hh:mm:ss`) or [relative](/manual/web_interface/time_period_selector) time syntax (`now`, `now/d`, `now/w-1w`, etc.).<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Display item value as* is set to "Numeric" and *Display* is set to "Sparkline"<br>- *required* if `columns.0.sparkline.time_period.to` is set| |^|*To*|1|columns.0.sparkline.time_period.to|Valid time string in absolute (`YYYY-MM-DD hh:mm:ss`) or [relative](/manual/web_interface/time_period_selector) time syntax (`now`, `now/d`, `now/w-1w`, etc.).<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Display item value as* is set to "Numeric" and *Display* is set to "Sparkline"<br>- *required* if `columns.0.sparkline.time_period.from` is set| |^|*History data*|0|columns.0.sparkline.history|0 - *(default)* Auto;<br>1 - History;<br>2 - Trends.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Display item value as* is set to "Numeric" and *Display* is set to "Sparkline"| |*Thresholds*|<|<|<|<| |<|*Color*|1|columnsthresholds.0.color.0|Hexadecimal color code (e.g. `FF0000`).<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Display item value as* is set to "Numeric"| |^|*Threshold*|1|columnsthresholds.0.threshold.0|Any string value.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Display item value as* is set to "Numeric"| |*Highlights*|<|<|<|<| |<|*Color*|1|columns.0.highlights.0.color|Hexadecimal color code (e.g. `FF0000`).<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Display item value as* is set to "Text"| |^|*Pattern*|1|columns.0.highlights.0.pattern|Any string value.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Display item value as* is set to "Text"| |*Show thumbnail*|<|0|columns.0.show_thumbnail|0 - *(default)* Disabled;<br>1 - Enabled.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Display item value as* is set to "Binary"| |*Aggregation function*|<|0|columns.0.aggregate_function|0 - *(default)* not used;<br>1 - min;<br>2 - max;<br>3 - avg;<br>4 - count;<br>5 - sum;<br>6 - first;<br>7 - last.| |*Time period*|<|1|columns.0.time_period.\_reference|`DASHBOARD._timeperiod` - set the [*Time period* selector](/manual/web_interface/time_period_selector) as the data source;<br>`ABCDE._timeperiod` - set a [compatible widget](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (with its `reference` parameter equal to `ABCDE`) as the data source.<br><br>Default: `DASHBOARD._timeperiod`<br><br>Alternatively, you can set the time period only in the *From* and *To* parameters.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Aggregation function* is set to "min", "max", "avg", "count", "sum", "first", "last"| |<|*From*|1|columns.0.time_period.from|Valid time string in absolute (`YYYY-MM-DD hh:mm:ss`) or [relative](/manual/web_interface/time_period_selector) time syntax (`now`, `now/d`, `now/w-1w`, etc.).<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Time period* is not set and *Aggregation function* is set to "min", "max", "avg", "count", "sum", "first", "last"<br>- *required* if `columns.0.time_period.to` is set<br>- *required* if `columns.0.time_period.to` is set| |^|*To*|1|columns.0.time_period.to|Valid time string in absolute (`YYYY-MM-DD hh:mm:ss`) or [relative](/manual/web_interface/time_period_selector) time syntax (`now`, `now/d`, `now/w-1w`, etc.).<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Time period* is not set and *Aggregation function* is set to "min", "max", "avg", "count", "sum", "first", "last"<br>- *required* if `columns.0.time_period.from` is set| |*History data*|<|0|columns.0.history|0 - *(default)* Auto;<br>1 - History;<br>2 - Trends.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Display item value as* is set to "Numeric"| |*Reference*|<|1|reference|Any string value consisting of 5 characters (e.g., `ABCDE` or `JBPNL`). This value must be unique within the dashboard to which the widget belongs.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required*| ##### مقدار آیتم (Item value) پارامترهای زیر در صورتی پشتیبانی میشوند که *داده (Data)* روی "مقدار آیتم" تنظیم شده باشد. ::: note کلاسیک عدد اول در نام ویژگی *آستانهها (Thresholds)* (به عنوان مثال columns.thresholds.0.color.0) به ستونی اشاره دارد که آستانهها برای آن پیکربندی شدهاند، در حالی که عدد دوم به جایگاه آستانه در یک لیست اشاره دارد که به ترتیب صعودی مرتب شدهاند. با این حال، اگر آستانهها به ترتیب متفاوتی پیکربندی شده باشند، مقادیر پس از بهروزرسانی پیکربندی ویجت در پیشخوان Zabbix به ترتیب صعودی مرتب میشوند (به عنوان مثال `"threshold.0.threshold":"5"` → `"threshold.0.threshold":"1"`; `"threshold.1.threshold":"1"` → `"threshold.1.threshold": "5"`). ::: | پارامتر | < | [نوع](/manual/api/reference/dashboard/object#dashboard-widget-field) | نام | مقدار | |---------|--|--------|------|-------| | *آیتم (Item)* | < | 1 | columns.0.item | نام آیتم معتبر.<br><br>هنگام پیکربندی ویجت در [داشبورد تمپلیت](/manual/api/reference/templatedashboard/object)، فقط آیتمهای پیکربندی شده روی تمپلیت باید تنظیم شوند. | | *نمایش مقدار آیتم به عنوان* | < | 0 | columns.0.display_value_as | 0 - *(پیشفرض)* عددی (Numeric);<br>1 - متن (Text);<br>2 - باینری (Binary). | | *نمایش (Display)* | < | 0 | columns.0.display | 1 - *(پیشفرض)* به صورت اصلی (As is);<br>2 - نوار (Bar);<br>3 - نشانگرها (Indicators);<br>6 - خطنقاط (Sparkline).<br><br>[رفتار پارامتر](/manual/api/reference_commentary#parameter-behavior):<br>- *پشتیبانی میشود* اگر *نمایش مقدار آیتم به عنوان* روی "عددی" تنظیم شده باشد | | *حداقل (Min)* | < | 1 | columns.0.min | هر مقدار عددی.<br><br>[رفتار پارامتر](/manual/api/reference_commentary#parameter-behavior):<br>- *پشتیبانی میشود* اگر *نمایش مقدار آیتم به عنوان* روی "عددی" و *نمایش* روی "نوار" یا "نشانگرها" تنظیم شده باشد | | *حداکثر (Max)* | < | 1 | columns.0.max | هر مقدار عددی.<br><br>[رفتار پارامتر](/manual/api/reference_commentary#parameter-behavior):<br>- *پشتیبانی میشود* اگر *نمایش مقدار آیتم به عنوان* روی "عددی" و *نمایش* روی "نوار" یا "نشانگرها" تنظیم شده باشد | | *ارقام اعشاری* | < | 0 | columns.0.decimal_places | مقادیر ممکن از 0 تا 10.<br><br>پیشفرض: 2.<br><br>[رفتار پارامتر](/manual/api/reference_commentary#parameter-behavior):<br>- *پشتیبانی میشود* اگر *نمایش مقدار آیتم به عنوان* روی "عددی" تنظیم شده باشد | | *خطنقاط (Sparkline)* | < | < | < | < | | < | *عرض (Width)* | 0 | columns.0.sparkline.width | مقادیر ممکن از 0 تا 10.<br><br>پیشفرض: 1.<br><br>[رفتار پارامتر](/manual/api/reference_commentary#parameter-behavior):<br>- *پشتیبانی میشود* اگر *نمایش مقدار آیتم به عنوان* روی "عددی" و *نمایش* روی "خطنقاط" تنظیم شده باشد | | ^ | *پر کردن (Fill)* | 0 | columns.0.sparkline.fill | مقادیر ممکن از 0 تا 10.<br><br>پیشفرض: 3.<br><br>[رفتار پارامتر](/manual/api/reference_commentary#parameter-behavior):<br>- *پشتیبانی میشود* اگر *نمایش مقدار آیتم به عنوان* روی "عددی" و *نمایش* روی "خطنقاط" تنظیم شده باشد | | ^ | *رنگ (Color)* | 1 | columns.0.sparkline.color | کد رنگ هگزادسیمال (به عنوان مثال `FF0000`).<br><br>پیشفرض: `42A5F5`.<br><br>[رفتار پارامتر](/manual/api/reference_commentary#parameter-behavior):<br>- *پشتیبانی میشود* اگر *نمایش مقدار آیتم به عنوان* روی "عددی" و *نمایش* روی "خطنقاط" تنظیم شده باشد | | ^ | *دوره زمانی (Time period)* | 1 | columns.0.sparkline.time_period.\_reference | `DASHBOARD._timeperiod` - تنظیم [انتخابگر *دوره زمانی*](/manual/web_interface/time_period_selector) به عنوان منبع داده؛<br>`ABCDE._timeperiod` - تنظیم یک [ویجت سازگار](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (با پارامتر `reference` آن برابر با `ABCDE`) به عنوان منبع داده.<br><br>پیشفرض: `DASHBOARD._timeperiod`<br><br>همچنین میتوانید دوره زمانی را فقط در پارامترهای *از* و *تا* تنظیم کنید.<br><br>[رفتار پارامتر](/manual/api/reference_commentary#parameter-behavior):<br>- *پشتیبانی میشود* اگر *نمایش مقدار آیتم به عنوان* روی "عددی" و *نمایش* روی "خطنقاط" تنظیم شده باشد | | ^ | *از (From)* | 1 | columns.0.sparkline.time_period.from | رشته زمانی معتبر در نحو مطلق (`YYYY-MM-DD hh:mm:ss`) یا [نسبی](/manual/web_interface/time_period_selector) (`now`, `now/d`, `now/w-1w`, و غیره).<br><br>[رفتار پارامتر](/manual/api/reference_commentary#parameter-behavior):<br>- *پشتیبانی میشود* اگر *نمایش مقدار آیتم به عنوان* روی "عددی" و *نمایش* روی "خطنقاط" تنظیم شده باشد<br>- *الزامی* اگر `columns.0.sparkline.time_period.to` تنظیم شده باشد | | ^ | *تا (To)* | 1 | columns.0.sparkline.time_period.to | رشته زمانی معتبر در نحو مطلق (`YYYY-MM-DD hh:mm:ss`) یا [نسبی](/manual/web_interface/time_period_selector) (`now`, `now/d`, `now/w-1w`, و غیره).<br><br>[رفتار پارامتر](/manual/api/reference_commentary#parameter-behavior):<br>- *پشتیبانی میشود* اگر *نمایش مقدار آیتم به عنوان* روی "عددی" و *نمایش* روی "خطنقاط" تنظیم شده باشد<br>- *الزامی* اگر `columns.0.sparkline.time_period.from` تنظیم شده باشد | | ^ | *داده تاریخچه* | 0 | columns.0.sparkline.history | 0 - *(پیشفرض)* خودکار (Auto);<br>1 - تاریخچه (History);<br>2 - روندها (Trends).<br><br>[رفتار پارامتر](/manual/api/reference_commentary#parameter-behavior):<br>- *پشتیبانی میشود* اگر *نمایش مقدار آیتم به عنوان* روی "عددی" و *نمایش* روی "خطنقاط" تنظیم شده باشد | | *آستانهها (Thresholds)* | < | < | < | < | | < | *رنگ (Color)* | 1 | columnsthresholds.0.color.0 | کد رنگ هگزادسیمال (به عنوان مثال `FF0000`).<br><br>[رفتار پارامتر](/manual/api/reference_commentary#parameter-behavior):<br>- *پشتیبانی میشود* اگر *نمایش مقدار آیتم به عنوان* روی "عددی" تنظیم شده باشد | | ^ | *آستانه (Threshold)* | 1 | columnsthresholds.0.threshold.0 | هر مقدار رشتهای.<br><br>[رفتار پارامتر](/manual/api/reference_commentary#parameter-behavior):<br>- *پشتیبانی میشود* اگر *نمایش مقدار آیتم به عنوان* روی "عددی" تنظیم شده باشد | | *برجستهسازیها (Highlights)* | < | < | < | < | | < | *رنگ (Color)* | 1 | columns.0.highlights.0.color | کد رنگ هگزادسیمال (به عنوان مثال `FF0000`).<br><br>[رفتار پارامتر](/manual/api/reference_commentary#parameter-behavior):<br>- *پشتیبانی میشود* اگر *نمایش مقدار آیتم به عنوان* روی "متن" تنظیم شده باشد | | ^ | *الگو (Pattern)* | 1 | columns.0.highlights.0.pattern | هر مقدار رشتهای.<br><br>[رفتار پارامتر](/manual/api/reference_commentary#parameter-behavior):<br>- *پشتیبانی میشود* اگر *نمایش مقدار آیتم به عنوان* روی "متن" تنظیم شده باشد | | *نمایش تصویر کوچک* | < | 0 | columns.0.show_thumbnail | 0 - *(پیشفرض)* غیرفعال (Disabled);<br>1 - فعال (Enabled).<br><br>[رفتار پارامتر](/manual/api/reference_commentary#parameter-behavior):<br>- *پشتیبانی میشود* اگر *نمایش مقدار آیتم به عنوان* روی "باینری" تنظیم شده باشد | | *تابع تجمیع (Aggregation function)* | < | 0 | columns.0.aggregate_function | 0 - *(پیشفرض)* استفاده نشود (not used);<br>1 - min;<br>2 - max;<br>3 - avg;<br>4 - count;<br>5 - sum;<br>6 - first;<br>7 - last. | | *دوره زمانی (Time period)* | < | 1 | columns.0.time_period.\_reference | `DASHBOARD._timeperiod` - تنظیم [انتخابگر *دوره زمانی*](/manual/web_interface/time_period_selector) به عنوان منبع داده؛<br>`ABCDE._timeperiod` - تنظیم یک [ویجت سازگار](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (با پارامتر `reference` آن برابر با `ABCDE`) به عنوان منبع داده.<br><br>پیشفرض: `DASHBOARD._timeperiod`<br><br>همچنین میتوانید دوره زمانی را فقط در پارامترهای *از* و *تا* تنظیم کنید.<br><br>[رفتار پارامتر](/manual/api/reference_commentary#parameter-behavior):<br>- *پشتیبانی میشود* اگر *تابع تجمیع* روی "min"، "max"، "avg"، "count"، "sum"، "first"، "last" تنظیم شده باشد | | < | *از (From)* | 1 | columns.0.time_period.from | رشته زمانی معتبر در نحو مطلق (`YYYY-MM-DD hh:mm:ss`) یا [نسبی](/manual/web_interface/time_period_selector) (`now`, `now/d`, `now/w-1w`, و غیره).<br><br>[رفتار پارامتر](/manual/api/reference_commentary#parameter-behavior):<br>- *پشتیبانی میشود* اگر *دوره زمانی* تنظیم نشده باشد و *تابع تجمیع* روی "min"، "max"، "avg"، "count"، "sum"، "first"، "last" تنظیم شده باشد<br>- *الزامی* اگر `columns.0.time_period.to` تنظیم شده باشد | | ^ | *تا (To)* | 1 | columns.0.time_period.to | رشته زمانی معتبر در نحو مطلق (`YYYY-MM-DD hh:mm:ss`) یا [نسبی](/manual/web_interface/time_period_selector) (`now`, `now/d`, `now/w-1w`, و غیره).<br><br>[رفتار پارامتر](/manual/api/reference_commentary#parameter-behavior):<br>- *پشتیبانی میشود* اگر *دوره زمانی* تنظیم نشده باشد و *تابع تجمیع* روی "min"، "max"، "avg"، "count"، "sum"، "first"، "last" تنظیم شده باشد<br>- *الزامی* اگر `columns.0.time_period.from` تنظیم شده باشد | | *داده تاریخچه* | < | 0 | columns.0.history | 0 - *(پیشفرض)* خودکار (Auto);<br>1 - تاریخچه (History);<br>2 - روندها (Trends).<br><br>[رفتار پارامتر](/manual/api/reference_commentary#parameter-behavior):<br>- *پشتیبانی میشود* اگر *نمایش مقدار آیتم به عنوان* روی "عددی" تنظیم شده باشد | | *مرجع (Reference)* | < | 1 | reference | هر مقدار رشتهای متشکل از ۵ کاراکتر (به عنوان مثال `ABCDE` یا `JBPNL`). این مقدار باید در داشبوردی که ویجت به آن تعلق دارد یکتا باشد.<br><br>[رفتار پارامتر](/manual/api/reference_commentary#parameter-behavior):<br>- *الزامی* | ### JavaScript A JavaScript class can be used to add dynamic behavior and interactivity to the widget configuration view. For example, you can initialize a color picker, defined in the [*CWidgetFormView*](#cwidgetformview) class. The JavaScript class should be loaded with the form, therefore it should be referenced in the [*CWidgetFormView*](#cwidgetformview) class by using the methods *includeJsFile()* and *addJavaScript()*. In the example below, a singleton class instance is immediately created and stored under the *window.my_custom_widget_form* name. Thus, opening the form for the second time will re-create the instance. The JavaScript class should be located in the *views* directory. **views/widget.edit.js.php example** ```php <?php use Modules\MyCustomWidget\Widget; ?> window.my_custom_widget_form = new class { init({color_palette}) { colorPalette.setThemeColors(color_palette); for (const colorpicker of jQuery('.<?= ZBX_STYLE_COLOR_PICKER ?> input')) { jQuery(colorpicker).colorpicker(); } const overlay = overlays_stack.getById('widget_properties'); for (const event of ['overlay.reload', 'overlay.close']) { overlay.$dialogue[0].addEventListener(event, () => { jQuery.colorpicker('hide'); }); } } }; ``` ### جاوا اسکریپت یک کلاس جاوا اسکریپت میتواند برای افزودن رفتار پویا و تعامل به نمای پیکربندی ویجت استفاده شود. برای مثال، میتوانید یک انتخابگر رنگ را که در کلاس [*CWidgetFormView*](#cwidgetformview) تعریف شده است، مقداردهی اولیه کنید. کلاس جاوا اسکریپت باید با فرم بارگذاری شود، بنابراین باید با استفاده از متدهای *includeJsFile()* و *addJavaScript()* در کلاس [*CWidgetFormView*](#cwidgetformview) به آن ارجاع داده شود. در مثال زیر، یک نمونه کلاس singleton بلافاصله ایجاد و تحت نام *window.my_custom_widget_form* ذخیره میشود. بنابراین، باز کردن فرم برای بار دوم، نمونه را دوباره ایجاد میکند. کلاس جاوا اسکریپت باید در دایرکتوری *views* قرار داشته باشد. **views/widget.edit.js.php example** ```php <?php use Modules\MyCustomWidget\Widget; ?> window.my_custom_widget_form = new class { init({color_palette}) { colorPalette.setThemeColors(color_palette); for (const colorpicker of jQuery('.<?= ZBX_STYLE_COLOR_PICKER ?> input')) { JQuery(colorpicker).colorpicker(); } const overlay = overlays_stack.getById('widget_properties'); برای (رویداد ثابت ['overlay.reload', 'overlay.close']) { overlay.$dialogue[0].addEventListener(event, () => { jQuery.colorpicker('hide'); }); } } }; ``` ##### JavaScript {#javascript} Enter JavaScript code in the modal editor that opens when clicking in the parameter field or on the pencil icon next to it. :::noteimportant Do not use undeclared assignments in preprocessing JavaScript. Use `var` to declare local variables. ::: Comments: - The available JavaScript length depends on the [database used](/manual/config/items/item#custom-script-limit);<br> - For more information, see: [Javascript preprocessing](/manual/config/items/preprocessing/javascript). ##### جاوا اسکریپت {#javascript}کد جاوا اسکریپت را در ویرایشگر modal که با کلیک روی فیلد پارامتر یا روی آیکون مداد کنار آن باز میشود، وارد کنید.:::نکته مهمدر پیشپردازش جاوا اسکریپت از مقادیر تعریف نشده استفاده نکنید. از `var` برای تعریف متغیرهای محلی استفاده کنید.:::نظرات:-طول جاوا اسکریپت موجود به [پایگاه داده مورد استفاده](/manual/config/items/item#custom-script-limit) بستگی دارد.<br>-برای اطلاعات بیشتر، به: [پیشپردازش جاوا اسکریپت](/manual/config/items/preprocessing/javascript) مراجعه کنید. ### JavaScript The JavaScript class is responsible for determining widget behavior, such as updating widget data, resizing the widget, displaying widget elements, etc. All JavaScript operations use and/or extend the base JavaScript class of all dashboard widgets - *CWidget*. The *CWidget* class contains a set of methods with the default implementation for widget behavior. Depending on widget complexity, these methods can be utilized as is or extended. The *CWidget* class contains the following methods: - Methods that define widget lifecycle: *onInitialize()*, *onStart()*, *onActivate()*, *onDeactivate()*, *onDestroy()*, *onEdit()*. - Methods that handle updating and displaying widget data: *promiseUpdate()*, *getUpdateRequestData()*, *processUpdateResponse(response)*, *processUpdateErrorResponse(error)*, *setContents(response)*. - Methods that modify widget appearance: *onResize()*, *hasPadding()*. The JavaScript class should be located in the *assets/js* directory and specified in the [*assets*](/devel/modules/file_structure/manifest#assets) (*assets/js*) parameter in the *manifest.json* file. ### جاوا اسکریپت کلاس جاوا اسکریپت مسئول تعیین رفتار ویجت، مانند بهروزرسانی دادههای ویجت، تغییر اندازه ویجت، نمایش عناصر ویجت و غیره است. تمام عملیات جاوا اسکریپت از کلاس پایه جاوا اسکریپت تمام ویجتهای داشبورد - *CWidget* - استفاده و/یا آن را توسعه میدهند. کلاس *CWidget* شامل مجموعهای از متدها با پیادهسازی پیشفرض برای رفتار ویجت است. بسته به پیچیدگی ویجت، این متدها میتوانند به صورت موجود یا توسعهیافته استفاده شوند. کلاس *CWidget* شامل متدهای زیر است: - متدهایی که چرخه عمر ویجت را تعریف میکنند: *onInitialize()*، *onStart()*، *onActivate()*، *onDeactivate()*، *onDestroy()*، *onEdit()*. - متدهایی که بهروزرسانی و نمایش دادههای ویجت را مدیریت میکنند: *promiseUpdate()*، *getUpdateRequestData()*، *processUpdateResponse(response)*، *processUpdateErrorResponse(error)*، *setContents(response)*. متدهایی که ظاهر ویجت را تغییر میدهند: *onResize()*، *hasPadding()*. کلاس جاوا اسکریپت باید در دایرکتوری *assets/js* قرار داشته باشد و در پارامتر [*assets*](/devel/modules/file_structure/manifest#assets) (*assets/js*) در فایل *manifest.json* مشخص شود. #### JSON format The JSON export format contains the following objects: - Root object for Zabbix JSON export - Export version ```json { "zabbix_export": { "version": "7.4" } } ``` Other objects are dependent on exported objects. #### فرمت JSON فرمت خروجی JSON شامل اشیاء زیر است: - شیء ریشه برای خروجی JSON زبیکس - نسخه خروجی ```json { "zabbix_export": { "version": "7.4" } } ``` سایر اشیاء به اشیاء خروجی وابسته هستند. ##### JSON Path {#jsonpath} Extract value or fragment from JSON data using [JSONPath functionality](/manual/config/items/preprocessing/jsonpath_functionality). If you mark the *Custom on fail* checkbox, it is possible to specify custom error-handling options: either to discard the value, set a specified value, or set a specified error message. In case of a failed preprocessing step, the item will not become unsupported if the option to discard the value or set a specified value is selected. اگر کادر *سفارشیسازی در صورت عدم موفقیت* را علامت بزنید، میتوانید گزینههای سفارشی برای مدیریت خطا را تعیین کنید: یا مقدار را حذف کنید، یک مقدار مشخص تنظیم کنید یا یک پیام خطای مشخص تنظیم کنید. در صورت شکست یک مرحله پیشپردازش، اگر گزینه حذف مقدار یا تنظیم یک مقدار مشخص انتخاب شود، مورد پشتیبانی نشده باقی میماند. # Key differences of Zabbix Cloud تفاوت کلیدی بین زبیکس بر روی cloud و یا بر روی محیط شخضی ## Learn about Zabbix Cloud یادیگیری در مورد زبیکس تحت ابر ##### Left trim {#ltrim} Remove specified characters from the beginning of the value. تریم از چپ #### Legend The following parameters are supported for configuring *Legend*. |Parameter|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-----|-|-----|-------------------| |*Show legend*|0|legend|0 - Disabled;<br>1 - *(default)* Enabled.| |*Show value*|0|legend_value|0 - *(default)* Disabled;<br>1 - Enabled.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Show legend* is set to "Enabled"| |*Show aggregation function*|0|legend_aggregation|0 - *(default)* Disabled;<br>1 - Enabled.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Show legend* is set to "Enabled"| |*Rows*|0|legend_lines_mode|0 - *(default)* Fixed;<br>1 - Variable.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Show legend* is set to "Enabled"| |*Number of rows/*<br>*Maximum number of rows*|0|legend_lines|Possible values range from 1-10.<br><br>Default: 1.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Show legend* is set to "Enabled"| |*Number of columns*|0|legend_columns|Possible values range from 1-4.<br><br>Default: 4.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Show legend* is set to "Enabled", and *Show value* is set to "Disabled"| #### راهنما پارامترهای زیر برای پیکربندی *شرح* پشتیبانی میشوند. |پارامتر|[نوع](/manual/api/reference/dashboard/object#dashboard-widget-field)|نام|مقدار| |-----|-----|------------------| |*نمایش راهنما*|0|شرح|0 - غیرفعال;<br>1 - *(پیشفرض)* فعال.| |*نمایش مقدار*|0|مقدار_افسانهای|0 - *(پیشفرض)* غیرفعال;<br>1 - فعال.<br><br>[رفتار پارامتر](/manual/api/reference_commentary#parameter-behavior):<br>- *پشتیبانی* اگر *نمایش راهنما* روی "فعال" تنظیم شده باشد| |*تابع تجمیع را نشان بده*|0|legend_aggregation|0 - *(پیشفرض)* غیرفعال؛<br>1 - فعال.<br><br>[رفتار پارامتر](/manual/api/reference_commentary#parameter-behavior):<br>- *پشتیبانی* اگر *نمایش راهنما* روی "فعال" تنظیم شده باشد| |*ردیفها*|0|legend_lines_mode|0 - *(پیشفرض)* ثابت؛<br>1 - متغیر.<br><br>[رفتار پارامتر](/manual/api/reference_commentary#parameter-behavior):<br>- *پشتیبانی* اگر *نمایش راهنما* روی "فعال" تنظیم شده باشد| |*تعداد سطرها/*<br>*حداکثر تعداد سطرها*|0|legend_lines|مقادیر ممکن از ۱ تا ۱۰ متغیر است.<br><br>پیشفرض: ۱.<br><br>[رفتار پارامتر](/manual/api/reference_commentary#parameter-behavior):<br>- *پشتیبانی* اگر *نمایش راهنما* روی "فعال" تنظیم شده باشد| |*تعداد ستونها*|0|legend_columns|مقادیر ممکن از ۱ تا ۴ متغیر است.<br><br>پیشفرض: ۴.<br><br>[رفتار پارامتر](/manual/api/reference_commentary#parameter-behavior):<br>- *پشتیبانی* اگر *نمایش راهنما* روی "فعال" تنظیم شده باشد و *نمایش مقدار* روی "غیرفعال" تنظیم شده باشد| ##### Lifecycle methods The widget lifecycle methods are invoked by the dashboard, and at different stages of the widget's lifecycle during its existence within the dashboard. ##### متدهای چرخه حیات متدهای چرخه حیات ویجت توسط داشبورد و در مراحل مختلف چرخه حیات ویجت در طول وجود آن در داشبورد فراخوانی میشوند. # LLD rule object The following objects are directly related to the `discoveryrule` API. # > آبجکت قانون LLD The following objects are directly related to the `discoveryrule` API. #### Locale Note that the proxy requires a UTF-8 locale so that some textual items can be interpreted correctly. Most modern Unix-like systems have a UTF-8 locale as default, however, there are some systems where that may need to be set specifically. #### محلی توجه داشته باشید که عامل به محلی UTF-8 نیاز دارد تا برخی از عوامل متنی موارد می توانند محتوای مورد انتظار را برگردانند. اکثر سیستم های مدرن یونیکس مانند یک محلی UTF-8 به عنوان پیش فرض داشته باشید، با این حال، برخی از سیستم ها وجود دارند که در آنها وجود دارد که ممکن است نیاز به تنظیم خاص داشته باشد. #### Log in Before making API requests, you must create a `ZabbixAPI` instance and log in to Zabbix API. Choose the method that best fits how you manage credentials. You can use your username and password or [API tokens](/manual/web_interface/frontend_sections/users/api_tokens). ### ورود به سیستم (Log in) قبل از ارسال درخواستهای API، باید یک نمونه از `ZabbixAPI` ایجاد کرده و به Zabbix API وارد شوید. روشی را انتخاب کنید که با نحوه مدیریت اطلاعات احراز هویت شما بیشترین سازگاری را دارد. میتوانید از یکی از روشهای زیر استفاده کنید: * **نام کاربری و رمز عبور** * **API Token** (توکن API) #### Log out If you logged in using a username and password, call the `logout()` method after completing your API operations: ```python from zabbix_utils import ZabbixAPI api = ZabbixAPI(url="127.0.0.1/zabbix") api.login(user="Admin", password="zabbix") # API actions go here api.logout() ``` ::: noteclassic Calling the `logout()` method is not required when using API tokens. ::: #### خروج از سیستم (Log out) اگر با استفاده از **نام کاربری و رمز عبور** به Zabbix وارد شدهاید، پس از اتمام عملیات API باید متد `logout()` را فراخوانی کنید: ```python id="t9v2ac" from zabbix_utils import ZabbixAPI api = ZabbixAPI(url="127.0.0.1/zabbix") api.login(user="Admin", password="zabbix") # انجام عملیات API api.logout() ``` > **توجه:** > در صورت استفاده از **API Token**، فراخوانی متد `logout()` الزامی نیست. #### Low-level discovery Configure low-level discovery rules as well as item, trigger and graph prototypes to monitor dynamic entities. [LLD rule API](/manual/api/reference/discoveryrule) | [Item prototype API](/manual/api/reference/itemprototype) | [Trigger prototype API](/manual/api/reference/triggerprototype) | [Graph prototype API](/manual/api/reference/graphprototype) | [Host prototype API](/manual/api/reference/hostprototype) #### کشف سطح پایینقوانین کشف سطح پایین و همچنین آیتم، تریگر و نمونههای اولیه گراف را برای نظارت بر موجودیتهای پویا پیکربندی کنید.[API قاعده LLD](/manual/api/reference/discoveryrule) | [API نمونه اولیه آیتم](/manual/api/reference/itemprototype) | [API نمونه اولیه تریگر](/manual/api/reference/triggerprototype) | [API نمونه اولیه گراف](/manual/api/reference/graphprototype) | [API نمونه اولیه میزبان](/manual/api/reference/hostprototype) #### Macros Manage macros. [User macro API](/manual/api/reference/usermacro) #### مدیریت ماکروها.[API ماکروی کاربر](/manual/api/reference/usermacro) #### Macro support [User macros](/manual/config/macros/user_macros) and user macros with context are supported in: - preprocessing step parameters, including JavaScript code; - custom error-handling parameters (*Set value to* and *Set error to* fields). ::: noteclassic The macro context is ignored when a macro is replaced with its value. The macro value is inserted in the code as is, it is not possible to add additional escaping before placing the value in the JavaScript code. Please be advised that this can cause JavaScript errors in some cases. ::: #### پشتیبانی از ماکرو [ماکروهای کاربر](/manual/config/macros/user_macros) و ماکروهای کاربر با زمینه در موارد زیر پشتیبانی میشوند: - پارامترهای مرحله پیشپردازش، شامل کد جاوا اسکریپت؛ - پارامترهای سفارشی مدیریت خطا (فیلدهای *مقدار را روی* و *خطا را روی* تنظیم کن).::: noteclassic زمینه ماکرو هنگام جایگزینی یک ماکرو با مقدار آن نادیده گرفته میشود. مقدار ماکرو به همان صورت در کد وارد میشود، امکان اضافه کردن escape اضافی قبل از قرار دادن مقدار در کد جاوا اسکریپت وجود ندارد. لطفاً توجه داشته باشید که این امر در برخی موارد میتواند باعث خطاهای جاوا اسکریپت شود.::: ## Maintenance tab The *Maintenance* tab lets you to define acceptable maintenance windows when updates or adjustments can be performed on your node. ![](../../assets/en/cloud/quickstart/maintenance_tab.png){width="600"} You must: - Select your time zone from the dropdown. - Choose at least one day and one hourly window for maintenance. Click *Save* to apply changes. If no day or time window is selected, an error will be displayed. ![](../../assets/en/cloud/quickstart/maintenance_error.png){width="600"} ## تب تعمیر و نگهداری تب *تعمیر و نگهداری* به شما امکان میدهد تا زمانهای مجاز برای انجام بهروزرسانیها یا تنظیمات روی گره خود را تعریف کنید. ![](../../assets/en/cloud/quickstart/maintenance_tab.png){width="600"} شما باید: - منطقه زمانی خود را از منوی کشویی انتخاب کنید. - حداقل یک روز و یک ساعت برای تعمیر و نگهداری انتخاب کنید. برای اعمال تغییرات روی *ذخیره* کلیک کنید. اگر هیچ روز یا زمانی انتخاب نشود، خطایی نمایش داده میشود. ![](../../assets/en/cloud/quickstart/maintenance_error.png){width="600"} ### manifest_version {#manifest-version} Manifest version of the module. Currently, supported version is **2.0**. *Type*: Double *Example*: ```json "manifest_version": 2.0 ``` ### manifest_version {#manifest-version} نسخه مانیفست ماژول. در حال حاضر، نسخه پشتیبانی شده **2.0** است. *نوع*: Double *مثال*: ```json "manifest_version": 2.0 ``` # map.create ساخت گراف #### Map lines Create a map line. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "map.create", "params": { "name": "Map API lines", "width": 500, "height": 500, "lines": [ { "x1": 30, "y1": 10, "x2": 100, "y2": 50, "line_type": 1, "line_width": 10, "line_color": "009900" } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "sysmapids": [ "11" ] }, "id": 1 } ``` #### ساخت نمونه اولیه گراف Create a graph prototype with two items. Request: ```json { "jsonrpc": "2.0", "method": "graphprototype.create", "params": { "name": "Disk space usage {#FSNAME}", "width": 900, "height": 200, "gitems": [ { "itemid": "22828", "color": "00AA00" }, { "itemid": "22829", "color": "3333FF" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "graphids": [ "652" ] }, "id": 1 } ``` ##### Map link status indicators |Element|<|Type|Description| |-|---|---|-----------------------| |drawtype|<|integer|Link style when trigger is in the 'Problem' state.<br>Possible values:<br>0 - Line;<br>2 - Bold line;<br>3 - Dotted line;<br>4 - Dashed line.| |color|<|string|Link color (6 symbols, hex) when trigger is in the 'Problem' state.| |trigger|<| |Root element for trigger used to indicate link status.| |<|description|string|Trigger name.| |^|expression|string|Trigger expression.| |^|recovery\_expression|string|Trigger recovery expression.| ::: noteclassic See also: [Map link trigger object](/manual/api/reference/map/object#map-link-trigger) (refer to the relevant property with a matching name). ::: ##### شاخصهای وضعیت لینک نقشه |عنصر|<|نوع|توضیحات| |-|---|---|----------------------| |drawtype|<|عدد صحیح|سبک لینک وقتی تریگر در حالت 'مشکل' است.<br>مقادیر ممکن:<br>0 - خط;<br>2 - خط پررنگ;<br>3 - خط نقطهچین;<br>4 - خط چین.| |رنگ|<|رشته|رنگ لینک (6 نماد، هگز) وقتی تریگر در حالت 'مشکل' است.| |تریگر|<| |عنصر ریشه برای تریگر که برای نشان دادن وضعیت لینک استفاده میشود.| |<|توضیحات|رشته|نام تریگر.| |^|عبارت|رشته|عبارت تریگر.| |^|بازیابی\_عبارت|رشته|عبارت بازیابی تریگر.| ::: noteclassic همچنین ببینید: [شیء تریگر لینک نقشه](/manual/api/reference/map/object#map-link-trigger) (به ویژگی مربوطه با نام منطبق مراجعه کنید). ::: #### Maps Configure maps to create detailed dynamic representations of your IT infrastructure. [Map API](/manual/api/reference/map) #### نقشهها را پیکربندی کنید تا نمایشهای پویا و دقیقی از زیرساخت فناوری اطلاعات خود ایجاد کنید.[Map API](/manual/api/reference/map) #### Maps |Element|<|Type|Description| |-|---|---|-----------------------| |name|<|string|Unique map name.| |width|<|integer|Map width, in pixels.| |height|<|integer|Map height, in pixels.| |label\_type|<|integer|Map element label type.<br>Possible values:<br>0 - Label;<br>1 - Host IP address;<br>2 - Element name;<br>3 - Status only;<br>4 - Nothing.| |label\_location|<|integer|Map element label location by default.<br>Possible values:<br>0 - Bottom;<br>1 - Left;<br>2 - Right;<br>3 - Top.| |highlight|<|integer|Enable icon highlighting for active triggers and host statuses.<br>Possible values:<br>0 - No;<br>1 - Yes.| |expandproblem|<|integer|Display problem trigger for elements with a single problem.<br>Possible values:<br>0 - No;<br>1 - Yes.| |markelements|<|integer|Highlight map elements that have recently changed their status.<br>Possible values:<br>0 - No;<br>1 - Yes.| |show\_unack|<|integer|Problem display.<br>Possible values:<br>0 - Count of all problems;<br>1 - Count of unacknowledged problems;<br>2 - Count of acknowledged and unacknowledged problems separately.| |severity\_min|<|integer|Minimum trigger severity to show on the map by default.<br>Possible values:<br>0 - Not classified;<br>1 - Information;<br>2 - Warning;<br>3 - Average;<br>4 - High;<br>5 - Disaster.| |show\_suppressed|<|integer|Display problems, which would otherwise be suppressed (not shown) because of host maintenance.<br>Possible values:<br>0 - No;<br>1 - Yes.| |grid\_size|<|integer|Cell size of a map grid in pixels.<br>Supported if `grid_show` is set to `0`.<br>Possible values: 20, 40, 50, 75 or 100.| |grid\_show|<|integer|Display a grid in map configuration.<br>Possible values:<br>0 - Yes;<br>1 - No.| |grid\_align|<|integer|Automatically align icons in map configuration.<br>Possible values:<br>0 - Yes;<br>1 - No.| |label\_format|<|integer|Use advanced label configuration.<br>Possible values:<br>0 - No;<br>1 - Yes.| |label\_type\_host|<|integer|Display label as host label.<br>Supported if `label_format` is set to `1`.<br>Possible values:<br>0 - Label;<br>1 - Host IP address;<br>2 - Element name;<br>3 - Status only;<br>4 - Nothing;<br>5 - Custom label.| |label\_type\_hostgroup|<|integer|Display label as host group label.<br>Supported if `label_format` is set to `1`.<br>Possible values:<br>0 - Label;<br>2 - Element name;<br>3 - Status only;<br>4 - Nothing;<br>5 - Custom label.| |label\_type\_trigger|<|integer|Display label as trigger label.<br>Supported if `label_format` is set to `1`.<br>Possible values:<br>0 - Label;<br>2 - Element name;<br>3 - Status only;<br>4 - Nothing;<br>5 - Custom label.| |label\_type\_map|<|integer|Display label as map label.<br>Supported if `label_format` is set to `1`.<br>Possible values:<br>0 - Label;<br>2 - Element name;<br>3 - Status only;<br>4 - Nothing;<br>5 - Custom label.| |label\_type\_image|<|integer|Display label as image label.<br>Supported if `label_format` is set to `1`.<br>Possible values:<br>0 - Label;<br>2 - Element name;<br>4 - Nothing;<br>5 - Custom label.| |label\_string\_host|<|string|Custom label for host elements.<br>Supported if `label_type_host` is set to `5`.| |label\_string\_hostgroup|<|string|Custom label for host group elements.<br>Supported if `label_type_hostgroup` is set to `5`.| |label\_string\_trigger|<|string|Custom label for trigger elements.<br>Supported if `label_type_trigger` is set to `5`.| |label\_string\_map|<|string|Custom label for map elements.<br>Supported if `label_type_map` is set to `5`.| |label\_string\_image|<|string|Custom label for image elements.<br>Supported if `label_type_image` is set to `5`.| |expand\_macros|<|integer|Expand macros in labels in map configuration.<br>Possible values:<br>0 - No;<br>1 - Yes.| |background|<| |Root element for background image (if any).<br>Supported if `imagetype` is set to `2`.| | |name|string|Background image name.| |iconmap|<| |Root element for icon mapping (if any).| | |name|string|Icon mapping name.| |urls|<| |Root element for URLs used by maps or each map element.| |<|name|string|Link name.| |^|url|string|Link URL.| |^|elementtype|integer|Map item type the link belongs to.<br>Possible values:<br>0 - Host;<br>1 - Map;<br>2 - Trigger;<br>3 - Host group;<br>4 - Image.| |selements|<| |Root element for [map selements](#map-selements).| |shapes|<| |Root element for map shapes.| |<|type|integer|Shape type.<br>Possible values:<br>0 - Rectangle;<br>1 - Ellipse.| |^|x|integer|X coordinates of the shape in pixels.| |^|y|integer|Y coordinates of the shape in pixels.| |^|width|integer|Shape width.| |^|height|integer|Shape height.| |^|text|string|Text inside of shape.| |^|font|integer|Text font style.<br>Possible values:<br>0 - Georgia, serif;<br>1 - "Palatino Linotype", "Book Antiqua", Palatino, serif;<br>2 - "Times New Roman", Times, serif;<br>3 - Arial, Helvetica, sans-serif;<br>4 - "Arial Black", Gadget, sans-serif;<br>5 - "Comic Sans MS", cursive, sans-serif;<br>6 - Impact, Charcoal, sans-serif;<br>7 - "Lucida Sans Unicode", "Lucida Grande", sans-serif;<br>8 - Tahoma, Geneva, sans-serif;<br>9 - "Trebuchet MS", Helvetica, sans-serif;<br>10 - Verdana, Geneva, sans-serif;<br>11 - "Courier New", Courier, monospace;<br>12 - "Lucida Console", Monaco, monospace.| |^|font\_size|integer|Font size in pixels.| |^|font\_color|string|Font color represented in hexadecimal code.| |^|text\_halign|integer|Horizontal alignment of text.<br>Possible values:<br>0 - Center;<br>1 - Left;<br>2 - Right.| |^|text\_valign|integer|Vertical alignment of text.<br>Possible values:<br>0 - Middle;<br>1 - Top;<br>2 - Bottom.| |^|border\_type|integer|Type of the border for the shape.<br>Possible values:<br>0 - None;<br>1 - Bold line;<br>2 - Dotted line;<br>3 - Dashed line.| |^|border\_width|integer|Width of the border in pixels.| |^|border\_color|string|Border color represented in hexadecimal code.| |^|background\_color|string|Background (fill) color represented in hexadecimal code.| |^|zindex|integer|Value for ordering all shapes and lines (z-index).| |lines|<| |Root element for map lines.| |<|x1|integer|X coordinates of the line point 1 in pixels.| |^|y1|integer|Y coordinates of the line point 1 in pixels.| |^|x2|integer|X coordinates of the line point 2 in pixels.| |^|y2|integer|Y coordinates of the line point 2 in pixels.| |^|line\_type|integer|Line type.<br>Possible values:<br>0 - None;<br>1 - Bold line;<br>2 - Dotted line;<br>3 - Dashed line.| |^|line\_width|integer|Line width in pixels.| |^|line\_color|string|Line color represented in hexadecimal code.| |^|zindex|integer|Value for ordering all shapes and lines (z-index).| |links|<| |Root element for links between map elements.| |<|drawtype|integer|Link style.<br>Possible values:<br>0 - Line;<br>2 - Bold line;<br>3 - Dotted line;<br>4 - Dashed line.| |^|color|string|Link color (6 symbols, hex).| |^|label|string|Link label.| |^|selementid1|id|ID of one element to connect.| |^|selementid2|id|ID of the other element to connect.| |linktriggers|<| |Root element for [link status indicators](#map-link-status-indicators).| ::: noteclassic See also: [Map object](/manual/api/reference/map/object) (refer to the relevant property with a matching name). ::: #### نقشه ها |Element|<|Type|Description| |-|---|---|-----------------------| |name|<|string|Unique map name.| |width|<|integer|Map width, in pixels.| |height|<|integer|Map height, in pixels.| |label\_type|<|integer|Map element label type.<br>Possible values:<br>0 - Label;<br>1 - Host IP address;<br>2 - Element name;<br>3 - Status only;<br>4 - Nothing.| |label\_location|<|integer|Map element label location by default.<br>Possible values:<br>0 - Bottom;<br>1 - Left;<br>2 - Right;<br>3 - Top.| |highlight|<|integer|Enable icon highlighting for active triggers and host statuses.<br>Possible values:<br>0 - No;<br>1 - Yes.| |expandproblem|<|integer|Display problem trigger for elements with a single problem.<br>Possible values:<br>0 - No;<br>1 - Yes.| |markelements|<|integer|Highlight map elements that have recently changed their status.<br>Possible values:<br>0 - No;<br>1 - Yes.| |show\_unack|<|integer|Problem display.<br>Possible values:<br>0 - Count of all problems;<br>1 - Count of unacknowledged problems;<br>2 - Count of acknowledged and unacknowledged problems separately.| |severity\_min|<|integer|Minimum trigger severity to show on the map by default.<br>Possible values:<br>0 - Not classified;<br>1 - Information;<br>2 - Warning;<br>3 - Average;<br>4 - High;<br>5 - Disaster.| |show\_suppressed|<|integer|Display problems, which would otherwise be suppressed (not shown) because of host maintenance.<br>Possible values:<br>0 - No;<br>1 - Yes.| |grid\_size|<|integer|Cell size of a map grid in pixels.<br>Supported if `grid_show` is set to `0`.<br>Possible values: 20, 40, 50, 75 or 100.| |grid\_show|<|integer|Display a grid in map configuration.<br>Possible values:<br>0 - Yes;<br>1 - No.| |grid\_align|<|integer|Automatically align icons in map configuration.<br>Possible values:<br>0 - Yes;<br>1 - No.| |label\_format|<|integer|Use advanced label configuration.<br>Possible values:<br>0 - No;<br>1 - Yes.| |label\_type\_host|<|integer|Display label as host label.<br>Supported if `label_format` is set to `1`.<br>Possible values:<br>0 - Label;<br>1 - Host IP address;<br>2 - Element name;<br>3 - Status only;<br>4 - Nothing;<br>5 - Custom label.| |label\_type\_hostgroup|<|integer|Display label as host group label.<br>Supported if `label_format` is set to `1`.<br>Possible values:<br>0 - Label;<br>2 - Element name;<br>3 - Status only;<br>4 - Nothing;<br>5 - Custom label.| |label\_type\_trigger|<|integer|Display label as trigger label.<br>Supported if `label_format` is set to `1`.<br>Possible values:<br>0 - Label;<br>2 - Element name;<br>3 - Status only;<br>4 - Nothing;<br>5 - Custom label.| |label\_type\_map|<|integer|Display label as map label.<br>Supported if `label_format` is set to `1`.<br>Possible values:<br>0 - Label;<br>2 - Element name;<br>3 - Status only;<br>4 - Nothing;<br>5 - Custom label.| |label\_type\_image|<|integer|Display label as image label.<br>Supported if `label_format` is set to `1`.<br>Possible values:<br>0 - Label;<br>2 - Element name;<br>4 - Nothing;<br>5 - Custom label.| |label\_string\_host|<|string|Custom label for host elements.<br>Supported if `label_type_host` is set to `5`.| |label\_string\_hostgroup|<|string|Custom label for host group elements.<br>Supported if `label_type_hostgroup` is set to `5`.| |label\_string\_trigger|<|string|Custom label for trigger elements.<br>Supported if `label_type_trigger` is set to `5`.| |label\_string\_map|<|string|Custom label for map elements.<br>Supported if `label_type_map` is set to `5`.| |label\_string\_image|<|string|Custom label for image elements.<br>Supported if `label_type_image` is set to `5`.| |expand\_macros|<|integer|Expand macros in labels in map configuration.<br>Possible values:<br>0 - No;<br>1 - Yes.| |background|<| |Root element for background image (if any).<br>Supported if `imagetype` is set to `2`.| | |name|string|Background image name.| |iconmap|<| |Root element for icon mapping (if any).| | |name|string|Icon mapping name.| |urls|<| |Root element for URLs used by maps or each map element.| |<|name|string|Link name.| |^|url|string|Link URL.| |^|elementtype|integer|Map item type the link belongs to.<br>Possible values:<br>0 - Host;<br>1 - Map;<br>2 - Trigger;<br>3 - Host group;<br>4 - Image.| |selements|<| |Root element for [map selements](#map-selements).| |shapes|<| |Root element for map shapes.| |<|type|integer|Shape type.<br>Possible values:<br>0 - Rectangle;<br>1 - Ellipse.| |^|x|integer|X coordinates of the shape in pixels.| |^|y|integer|Y coordinates of the shape in pixels.| |^|width|integer|Shape width.| |^|height|integer|Shape height.| |^|text|string|Text inside of shape.| |^|font|integer|Text font style.<br>Possible values:<br>0 - Georgia, serif;<br>1 - "Palatino Linotype", "Book Antiqua", Palatino, serif;<br>2 - "Times New Roman", Times, serif;<br>3 - Arial, Helvetica, sans-serif;<br>4 - "Arial Black", Gadget, sans-serif;<br>5 - "Comic Sans MS", cursive, sans-serif;<br>6 - Impact, Charcoal, sans-serif;<br>7 - "Lucida Sans Unicode", "Lucida Grande", sans-serif;<br>8 - Tahoma, Geneva, sans-serif;<br>9 - "Trebuchet MS", Helvetica, sans-serif;<br>10 - Verdana, Geneva, sans-serif;<br>11 - "Courier New", Courier, monospace;<br>12 - "Lucida Console", Monaco, monospace.| |^|font\_size|integer|Font size in pixels.| |^|font\_color|string|Font color represented in hexadecimal code.| |^|text\_halign|integer|Horizontal alignment of text.<br>Possible values:<br>0 - Center;<br>1 - Left;<br>2 - Right.| |^|text\_valign|integer|Vertical alignment of text.<br>Possible values:<br>0 - Middle;<br>1 - Top;<br>2 - Bottom.| |^|border\_type|integer|Type of the border for the shape.<br>Possible values:<br>0 - None;<br>1 - Bold line;<br>2 - Dotted line;<br>3 - Dashed line.| |^|border\_width|integer|Width of the border in pixels.| |^|border\_color|string|Border color represented in hexadecimal code.| |^|background\_color|string|Background (fill) color represented in hexadecimal code.| |^|zindex|integer|Value for ordering all shapes and lines (z-index).| |lines|<| |Root element for map lines.| |<|x1|integer|X coordinates of the line point 1 in pixels.| |^|y1|integer|Y coordinates of the line point 1 in pixels.| |^|x2|integer|X coordinates of the line point 2 in pixels.| |^|y2|integer|Y coordinates of the line point 2 in pixels.| |^|line\_type|integer|Line type.<br>Possible values:<br>0 - None;<br>1 - Bold line;<br>2 - Dotted line;<br>3 - Dashed line.| |^|line\_width|integer|Line width in pixels.| |^|line\_color|string|Line color represented in hexadecimal code.| |^|zindex|integer|Value for ordering all shapes and lines (z-index).| |links|<| |Root element for links between map elements.| |<|drawtype|integer|Link style.<br>Possible values:<br>0 - Line;<br>2 - Bold line;<br>3 - Dotted line;<br>4 - Dashed line.| |^|color|string|Link color (6 symbols, hex).| |^|label|string|Link label.| |^|selementid1|id|ID of one element to connect.| |^|selementid2|id|ID of the other element to connect.| |linktriggers|<| |Root element for [link status indicators](#map-link-status-indicators).| ::: noteclassic See also: [Map object](/manual/api/reference/map/object) (refer to the relevant property with a matching name). ::: #### Map shapes Create a map with map name title. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "map.create", "params": { "name": "Host map", "width": 600, "height": 600, "shapes": [ { "type": 0, "x": 0, "y": 0, "width": 600, "height": 11, "text": "{MAP.NAME}" } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "sysmapids": [ "10" ] }, "id": 1 } ``` ####ساخت Icon map Create an icon map to display hosts of different types. Request: ```json { "jsonrpc": "2.0", "method": "iconmap.create", "params": { "name": "Type icons", "default_iconid": "2", "mappings": [ { "inventory_link": 1, "expression": "server", "iconid": "3" }, { "inventory_link": 1, "expression": "switch", "iconid": "4" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "iconmapids": [ "2" ] }, "id": 1 } ``` #### Map sharing Create a map with two types of sharing (user and user group). [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "map.create", "params": { "name": "Map sharing", "width": 600, "height": 600, "users": [ { "userid": "4", "permission": "3" } ], "userGroups": [ { "usrgrpid": "7", "permission": "2" } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "sysmapids": [ "9" ] }, "id": 1 } ``` #### ایجاد یک رابط یک رابط برای خروجی گرفتن از رویدادهای تریگر با فیلتر برچسب ایجاد کنید. احراز هویت HTTP با استفاده از توکن Bearer انجام خواهد شد. [درخواست](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "connector.create", "params": [ { "name": "خروجی رویدادها", "data_type": 1, "url": "{$DATA_EXPORT_URL}", "authtype": 5, "token": "{$DATA_EXPORT_BEARER_TOKEN}", "tags": [ { "tag": "service", "operator": 0, "value": "mysqld" } ] } ], "id": 1 } ``` پاسخ: ```json { "jsonrpc": "2.0", "result": { "connectorid": [ "3" ] }, "id": 1 } ``` ##### Matches regular expression {#matchesregexp} Specify a regular expression that a value must match. If you mark the *Custom on fail* checkbox, it is possible to specify custom error-handling options: either to discard the value, set a specified value, or set a specified error message. In case of a failed preprocessing step, the item will not become unsupported if the option to discard the value or set a specified value is selected. اگر کادر *سفارشیسازی در صورت عدم موفقیت* را علامت بزنید، میتوانید گزینههای سفارشی برای مدیریت خطا را تعیین کنید: یا مقدار را حذف کنید، یک مقدار مشخص تنظیم کنید یا یک پیام خطای مشخص تنظیم کنید. در صورت شکست یک مرحله پیشپردازش، اگر گزینه حذف مقدار یا تنظیم یک مقدار مشخص انتخاب شود، مورد پشتیبانی نشده باقی میماند. #### Media types Configure media types and multiple ways users will receive alerts. [Media type API](/manual/api/reference/mediatype) #### انواع رسانه پیکربندی انواع رسانه و روشهای مختلف دریافت هشدار توسط کاربران.[رابط برنامهنویسی نوع رسانه](/manual/api/reference/mediatype) ##### Menu levels There are up to three levels in the menu. ![](../../../assets/en/manual/web_interface/menu_levels.png) #### Menu levels There are up to three levels in the menu. ![](../../../assets/en/manual/web_interface/menu_levels.png) # Method reference This section provides an overview of the functions provided by the Zabbix API and will help you find your way around the available classes and methods. # مرجع متد این بخش مروری بر توابع ارائه شده توسط API زبیکس ارائه میدهد و به شما کمک میکند تا راه خود را در مورد کلاسها و متدهای موجود پیدا کنید. ### Module example - When creating a host group, grant read permissions to configured user groups - [hg_auto_perm.zip](/../assets/en/devel/modules/examples/hg_auto_perm.zip) ### مثال ماژول - هنگام ایجاد یک گروه میزبان، مجوزهای خواندن را به گروههای کاربری پیکربندی شده اعطا کنید - [hg_auto_perm.zip](/../assets/en/devel/modules/examples/hg_auto_perm.zip) # Module file structure All code related to a module is stored in a single directory inside the **modules** directory of your Zabbix frontend installation (for example, *zabbix/ui/modules*). # ساختار فایل ماژول تمام کدهای مربوط به یک ماژول در یک دایرکتوری واحد در داخل دایرکتوری **modules** از نصب فرانتاند زبیکس شما ذخیره میشوند (برای مثال، *zabbix/ui/modules*). ### Module file tree ````yaml example_module_directory/ (required) manifest.json (required) Metadata and action definition. Module.php Module initialization and event handling. actions/ Action controller files. SomethingView.php SomethingCreate.php SomethingDelete.php data_export/ ExportAsXml.php ExportAsExcel.php views/ View files. example.something.view.php example.something.delete.php assets/ Any additional files to be used in views. Must be specified in manifest.json. js/ JavaScript files used in views. example.something.view.js.php css/ CSS files used in views. example.something.css image.png Images used in views. example.something.file Any file for using in views. ```` ### درخت فایل ماژول ````yaml example_module_directory/ (الزامی) manifest.json (الزامی) تعریف فراداده و اکشن. Module.php مقداردهی اولیه ماژول و مدیریت رویداد. actions/ فایلهای کنترلکننده اکشن. SomethingView.php SomeCreate.php SomeDelete.php data_export/ ExportAsXml.php ExportAsExcel.php views/ فایلهای View. example.something.view.php example.something.delete.php assets/ هر فایل اضافی که قرار است در Viewها استفاده شود. باید در manifest.json مشخص شود. js/ فایلهای جاوا اسکریپت مورد استفاده در Viewها. example.something.view.js.php css/ فایلهای CSS مورد استفاده در Viewها. example.something.css image.png تصاویر مورد استفاده در Viewها. example.something.file هر فایلی برای استفاده در Viewها. ```` # Modules # ماژولها ## Monitoring The Zabbix API allows you to access history and other data gathered during monitoring. ### Monitoring The Zabbix API allows you to access history and other data gathered during monitoring. ### name Module name that will be displayed in the Administration section. *Type*: String *Example*: ```json "name": "My module" ``` ### نام نام ماژولی که در بخش مدیریت نمایش داده خواهد شد. *نوع*: رشته *مثال*: ```json "name": "ماژول من" ``` ### namespace PHP namespace for module classes. *Type*: String *Example*: ```json "namespace": "ClockWidget" ``` ### فضای نام فضای نام PHP برای کلاسهای ماژول. *نوع*: رشته *مثال*: ```json "فضای نام": "ClockWidget" ``` #### Network discovery Manage network-level discovery rules to automatically find and monitor new hosts. Gain full access to information about discovered services and hosts. [Discovery rule API](/manual/api/reference/drule) | [Discovery check API](/manual/api/reference/dcheck) | [Discovered host API](/manual/api/reference/dhost) | [Discovered service API](/manual/api/reference/dservice) #### کشف شبکه قوانین کشف سطح شبکه را مدیریت کنید تا میزبانهای جدید به طور خودکار پیدا و رصد شوند. به اطلاعات کامل در مورد سرویسها و میزبانهای کشف شده دسترسی پیدا کنید.[API قانون کشف](/manual/api/reference/drule) | [API بررسی کشف](/manual/api/reference/dcheck) | [API میزبان کشف شده](/manual/api/reference/dhost) | [API سرویس کشف شده](/manual/api/reference/dservice) # Node configuration پیکربندی گره شماره ۲ ### Notation ### نشانه گذاری ##### Octal to decimal {#octal} Convert the value from octal format to decimal. If you mark the *Custom on fail* checkbox, it is possible to specify custom error-handling options: either to discard the value, set a specified value, or set a specified error message. In case of a failed preprocessing step, the item will not become unsupported if the option to discard the value or set a specified value is selected. ###### اکتال به دهدهی {#اکتال}مقدار را از قالب اکتال به دهدهی تبدیل کنید. اگر کادر *سفارشی شدن در صورت عدم موفقیت* را علامت بزنید، میتوانید گزینههای سفارشی برای مدیریت خطا را تعیین کنید: یا مقدار را حذف کنید، یک مقدار مشخص شده را تنظیم کنید یا یک پیام خطای مشخص شده را تنظیم کنید. در صورت شکست یک مرحله پیشپردازش، اگر گزینه حذف مقدار یا تنظیم یک مقدار مشخص شده انتخاب شود، مورد پشتیبانی نشده باقی میماند. ##### ODBC monitoring Zabbix Cloud supports [ODBC monitoring](/manual/config/items/itemtypes/odbc_checks) only for PostgreSQL. Use the official Zabbix [ODBC template](/manual/config/templates_out_of_the_box/odbc_checks) and define the connection string in the template using: ```yaml Driver={postgresql} ``` A MariaDB plugin is also installed but currently not functional. If used, define: ```yaml Driver={mysql} ``` ::: noteimportant There is no known working configuration for Oracle MySQL 8.0 in Zabbix Cloud. While simple queries (such as `SELECT 1`) may succeed, more complex queries return `SQL_ERROR`.<br><br> It is not possible to limit ODBC calls (`StartODBCPollers=1` only). Heavy synchronous reporting may impact performance, and only a single `SELECT` can run at a time. ::: ### نظارت بر ODBC، زبیکس کلود از [ODBC monitoring](/manual/config/items/itemtypes/odbc_checks) فقط برای PostgreSQL پشتیبانی میکند. از الگوی رسمی زبیکس [ODBC](/manual/config/templates_out_of_the_box/odbc_checks) استفاده کنید و رشته اتصال را در الگو با استفاده از:```yamlDriver={postgresql}``` تعریف کنید. یک افزونه MariaDB نیز نصب شده است اما در حال حاضر کاربردی نیست. در صورت استفاده، تعریف کنید:```yamlDriver={mysql}```::: نکته: مهم: هیچ پیکربندی شناخته شدهای برای Oracle MySQL 8.0 در زبیکس کلود وجود ندارد. در حالی که پرسوجوهای ساده (مانند `SELECT 1`) ممکن است موفق شوند، پرسوجوهای پیچیدهتر `SQL_ERROR` را برمیگردانند.<br><br>محدود کردن فراخوانیهای ODBC امکانپذیر نیست (فقط `StartODBCPollers=1`). گزارشدهی همزمان سنگین ممکن است بر عملکرد تأثیر بگذارد و فقط یک `SELECT` واحد میتواند همزمان اجرا شود.::: ## OPTIONS **-c**, **--config** *config-file* Use the alternate *config-file* instead of the default one. **-R**, **--runtime-control** *runtime-option* Perform administrative functions according to *runtime-option*. ## گزینهها **-c**, **--config** *config-file* از *config-file* جایگزین به جای فایل پیشفرض استفاده کنید. **-R**, **--runtime-control** *runtime-option* عملکردهای مدیریتی را طبق *runtime-option* انجام دهید. #### Options |Parameter|Description| |---------|-----------| |-V --version|Print the plugin version and license information.| |-h --help|Print help information (shorthand).| #### Options |Parameter|Description| |---------|-----------| |-V --version|Print the plugin version and license information.| |-h --help|Print help information (shorthand).| #### Organization management An organization is a container for one or more nodes. Organizations also help you structure your resources and delegate responsibilities, such as: - Node management - Billing When you log in to Zabbix Cloud, the *All organizations* page is displayed. By default, a private organization is created for your account. ![](../../assets/en/cloud/quickstart/all_organizations.png){width="500"} As the owner of this organization, you can manage users, admins, nodes, and the organization name. Click the ![](../../assets/en/cloud/quickstart/organization_management_button.png){width="30"} settings button to access management options. ## مدیریت سازمان یک سازمان، ظرفی برای یک یا چند گره است. سازمانها همچنین به شما در ساختاردهی منابع و تفویض مسئولیتها کمک میکنند، مانند: - مدیریت گره - صورتحساب - مشاهده فعالیت گره هنگامی که وارد Zabbix Cloud میشوید، صفحه *همه سازمانها* نمایش داده میشود. هر سازمان به عنوان ظرفی برای یک یا چند گره عمل میکند. به طور پیشفرض، یک سازمان خصوصی برای حساب شما ایجاد میشود. ![](../../assets/en/cloud/quickstart/all_organizations.png){width="600"} به عنوان مالک این سازمان، میتوانید کاربران، مدیران، گرهها و نام سازمان را مدیریت کنید. برای دسترسی به گزینههای مدیریتی، روی دکمه تنظیمات ![](../../assets/en/cloud/quickstart/organization_management_button.png){width="30"} کلیک کنید. ## Other changes and bug fixes ## سایر تغییرات و رفع اشکالات ## Overview A **cloud node** is the equivalent of a Zabbix instance, based in the cloud. It includes Zabbix server, the database, and the web frontend. A cloud node has dedicated computing resources (CPU, memory) and disk storage. Users may create one or more cloud nodes. Cloud nodes can be grouped into **organizations** (structural, regional, etc), creating a distributed monitoring setup. Cloud nodes and organizations are created using the [Zabbix Cloud](https://cloud.zabbix.com) user interface. To access the node configuration page, click the node either in *All organizations*, from your [organization menu](/cloud/quickstart), or using the *Node configuration page* link shown after a node is [launched](/cloud/quickstart#creating-a-node). In the node configuration view, each tab lets you manage a specific aspect of your node: - [Overview](#overview-tab) - view node details, open its frontend, and manage node users. - [Access filters](#access-filters-tab) - control access by IP address or subnet. - [Encryption](#encryption-tab) - configure TLS by uploading certificates, keys, and optional CRLs. - [Backups](#backups-tab) - create, restore, and delete node snapshots; view the next scheduled backup. - [History](#history-tab) - set retention periods for audit logs, history, and trends, with preset units and a 3x/day update limit. - [Maintenance](#maintenance-tab) - define weekly maintenance windows by time zone, day, and hour. - [Upgrade](#upgrade-tab) - scale compute/storage resources or manage your trial/payment status. ![](../../assets/en/cloud/quickstart/node_configuration.png){width="600"} :::noteclassic Some tabs may be unavailable depending on the [type of user](/cloud/adding_users#adding-users-to-organizations) who views the page and node status (trial/non-trial). ::: ## مرور کلی برای دسترسی به صفحه پیکربندی گره، روی گره مورد نظر در *همه سازمانها*، از [منوی سازمان](/cloud/quickstart) یا با استفاده از پیوند *صفحه پیکربندی گره* که پس از [راهاندازی] یک گره نشان داده میشود، کلیک کنید(/cloud/quickstart#creating-a-node). در نمای پیکربندی گره، هر برگه به شما امکان میدهد جنبه خاصی از گره خود را مدیریت کنید: - [Overview](#overview-tab) - جزئیات گره را مشاهده کنید، ظاهر آن را باز کنید و کاربران گره را مدیریت کنید. - [Access filters](#access-filters-tab) - دسترسی را بر اساس آدرس IP یا زیرشبکه کنترل کنید. - [Encryption](#encryption-tab) - TLS را با آپلود گواهیها، کلیدها و CRLهای اختیاری پیکربندی کنید. - [Backups](#backups-tab) - عکسهای فوری گره را ایجاد، بازیابی و حذف کنید؛ پشتیبانگیری برنامهریزیشده بعدی را مشاهده کنید. - [History](#history-tab) - دورههای نگهداری برای گزارشهای حسابرسی، تاریخچه و روندها را با واحدهای از پیش تعیینشده و محدودیت بهروزرسانی ۳ بار در روز تنظیم کنید. - [Maintenance](#maintenance-tab) - پنجرههای نگهداری هفتگی را بر اساس منطقه زمانی، روز و ساعت تعریف کنید. - [Upgrade](#upgrade-tab) - منابع محاسباتی/ذخیرهسازی را مقیاسبندی کنید یا وضعیت آزمایشی/پرداخت خود را مدیریت کنید. ![](../../assets/en/cloud/quickstart/node_configuration.png){width="600"} :::noteclassic بسته به [type of user](/cloud/adding_users#adding-users-to-organizations) که صفحه را مشاهده میکند و وضعیت گره (آزمایشی/غیرآزمایشی)، ممکن است برخی از تبها در دسترس نباشند. :: #### Overview A vertical menu in a sidebar provides access to various Zabbix frontend sections. The menu is dark blue in the default theme. ![](../../../assets/en/manual/web_interface/vertical_menu.png){width="600"} #### بررسی اجمالی یک منوی عمودی در یک نوار کناری، دسترسی به قسمت های مختلف Zabbix را فراهم می کند. منو در قالب پیش فرض آبی تیره است. ![](../../../assets/en/manual/introduction/vertical_menu.png){width="600"} ### Overview Custom loadable plugins extend Zabbix agent 2 functionality. They are compiled separately, but use a package shared with Zabbix agent 2. Each plugin is a *Go* package that defines the structure and implements one or several plugin interfaces (*Exporter*, *Configurator*, *Runner*). Jump to: - [Write your first plugin](/devel/plugins/how_to) - [Plugin interfaces](/devel/plugins/interfaces) See also: - [Example plugin for Zabbix agent 2](https://git.zabbix.com/projects/AP/repos/example/browse) ### Connection diagram Zabbix agent 2 connects bidirectionally to the plugins using UNIX sockets on Linux and Named Pipes on Windows. The connection diagram below illustrates the communication process between Zabbix agent 2 and a loadable plugin and the metrics collection process. ![](../../assets/en/devel/plugin/connection_diagram.png) ### مرور کلی افزونههای قابل بارگذاری سفارشی، قابلیتهای Zabbix agent 2 را گسترش میدهند. آنها بهطور جداگانه کامپایل میشوند، اما از بستهای مشترک با Zabbix agent 2 استفاده میکنند. هر افزونه یک بسته *Go* است که ساختار را تعریف میکند و یک یا چند رابط افزونه را پیادهسازی میکند (*Exporter*، *Configurator*، *Runner*). برو به: - [اولین افزونه خود را بنویسید](/devel/plugins/how_to) - [رابطهای افزونه](/devel/plugins/interfaces) همچنین ببینید: - [مثال افزونه برای Zabbix agent 2](https://git.zabbix.com/projects/AP/repos/example/browse) ### نمودار اتصال Zabbix agent 2 با استفاده از سوکتهای UNIX در لینوکس و Named Pipes در ویندوز، بهصورت دوطرفه به افزونهها متصل میشود. نمودار اتصال زیر فرآیند ارتباط بین Zabbix agent 2 و یک افزونه قابل بارگذاری و فرآیند جمعآوری معیارها را نشان میدهد. ![](../../assets/en/devel/plugin/connection_diagram.png) #### Overview Depending on user role permissions, the *User settings* section may contain the following pages: - *Profile* or *User profile* - for customizing certain Zabbix frontend features; - *Notifications* - for customizing current user notifications; - *API tokens* - for managing API tokens assigned to the current user. The list of available pages appears upon clicking the ![](../../../assets/en/manual/web_interface/user_profile.png) user icon near the bottom of the Zabbix menu (not available for the *guest* user). It is also possible to switch between pages by using the title dropdown in the upper-left corner. | | | |---|---| |![](../../../assets/en/manual/web_interface/user_settings_menu.png)|![](../../../assets/en/manual/web_interface/user_settings_selector.png)| |Third-level menu.|Title dropdown.| #### مرور اجمالی Depending on user role permissions, the *User settings* section may contain the following pages: - *User profile* - for customizing certain Zabbix frontend features; - *API tokens* - for managing API tokens assigned to the current user. The list of available pages appears upon pressing on the ![](../../../assets/en/manual/web_interface/user_profile.png) user icon near the bottom of the Zabbix menu (not available for a guest user). It is also possible to switch between pages by using a title dropdown in the top left corner. | | | |---|---| |![](../../../assets/en/manual/web_interface/user_menu.png){width="300"}|![](../../../assets/en/manual/web_interface/user_selector.png){width="300"}| |Third-level menu.|Title dropdown.| ### Overview For an easy access to Zabbix from anywhere and from any platform, the web-based interface is provided. ::: noteclassic If using more than one frontend instance make sure that the locales and libraries (LDAP, SAML etc.) are installed and configured identically for all frontends. ::: #### Overview For an easy access to Zabbix from anywhere and from any platform, the web-based interface is provided. ::: noteclassic If using more than one frontend instance make sure that the locales and libraries (LDAP, SAML etc.) are installed and configured identically for all frontends. ::: #### Overview Global notifications provide a way to display real-time issues directly on your current screen within Zabbix frontend. Without global notifications, when working outside the *Problems* or *Dashboard* sections, you would not receive any information about current issues. Global notifications ensure that this information is displayed, regardless of your current location within the Zabbix frontend. Global notifications include both [displaying a message](#global-messages-displayed) and [playing a sound](sound). ::: noteimportant The autoplay of sounds might be disabled (by default) in recent browser versions. In such cases, you need to enable this setting manually. ::: #### Overview Global notifications are a way of displaying issues that are currently happening right on the screen you're at in Zabbix frontend. Without global notifications, working in some other location than *Problems* or the *Dashboard* would not show any information regarding issues that are currently happening. Global notifications will display this information regardless of where you are. Global notifications involve both showing a message and [playing a sound](sound). ::: noteimportant The auto play of sounds may be disabled in recent browser versions by default. In this case, you need to change this setting manually. ::: #### Overview Hosts are [exported](/manual/xml_export_import) with many related objects and object relations. Host export contains: - Linked [host groups](/manual/xml_export_import/hostgroups) - Host data - Template linkage - Host group linkage - Host interfaces - Directly linked items - Directly linked triggers - Directly linked discovery rules with all prototypes - Directly linked web scenarios - Host macros - Host inventory data - Value maps - Linked [graphs](/manual/xml_export_import/hosts#host-graphs) #### مرور کلی میزبانها [exported](/manual/xml_export_import) با اشیاء مرتبط و روابط اشیاء زیادی هستند. خروجی میزبان شامل موارد زیر است: - [گروههای میزبان] پیوندی(/manual/xml_export_import/hostgroups) - دادههای میزبان - پیوند الگو - پیوند گروه میزبان - رابطهای میزبان - موارد پیوند مستقیم - محرکهای پیوند مستقیم - قوانین کشف پیوند مستقیم با تمام نمونههای اولیه - سناریوهای وب پیوند مستقیم - ماکروهای میزبان - دادههای موجودی میزبان - نقشههای ارزش - [graphs] پیوندی(/manual/xml_export_import/hosts#host-graphs) #### Overview In the graph prototype widget, you can display a grid of graphs created from either a graph prototype or an item prototype by low-level discovery. #### Overview In the graph prototype widget, you can display a grid of graphs created from either a graph prototype or an item prototype by low-level discovery. #### Overview In the *Monitoring → Maps* section you can configure, manage and view [network maps](/manual/config/visualization/maps). When you open this section, you will either see the last map you accessed or a listing of all maps you have access to. All maps can be either public or private. Public maps are available to all users, while private maps are accessible only to their owner and the users the map is shared with. #### بررسی اجمالی در بخش *Monitoring → Maps* می توانید پیکربندی، مدیریت و مشاهده کنید [نقشه های شبکه](/دستی/پیکربندی/تجسم/نقشه). وقتی این بخش را باز می کنید، آخرین نقشه خود را می بینید دسترسی داشته باشید یا فهرستی از همه نقشه هایی که به آنها دسترسی دارید. همه نقشه ها می توانند عمومی یا خصوصی باشند. نقشه های عمومی در دسترس هستند همه کاربران، در حالی که نقشه های خصوصی فقط برای مالک و مالک آنها قابل دسترسی است کاربرانی که نقشه با آنها به اشتراک گذاشته می شود. ### Overview In Zabbix 6.0, [service monitoring](/manual/it_services) functionality has been reworked significantly (see [What's new in Zabbix 6.0.0](https://www.zabbix.com/documentation/6.0/en/manual/introduction/whatsnew600#services) for the list of changes). This page describes how services and SLAs, defined in earlier Zabbix versions, are changed during an upgrade to Zabbix 6.0 or newer. ### Overview In Zabbix 6.0, [service monitoring](/manual/it_services) functionality has been reworked significantly (see [What's new in Zabbix 6.0.0](https://www.zabbix.com/documentation/6.0/en/manual/introduction/whatsnew600#services) for the list of changes). This page describes how services and SLAs defined in earlier Zabbix versions are changed during an upgrade to Zabbix 6.0 or newer. #### Overview Media types are [exported](/manual/xml_export_import) with all related objects and object relations. #### مرور کلی انواع رسانه به همراه تمام اشیاء مرتبط و روابط اشیاء، [exported](/manual/xml_export_import) هستند. #### Overview Network map [export](/manual/xml_export_import) contains: - All related images - Map structure (all map settings, all contained elements with their settings, map links and map link status indicators) ::: notewarning Any host groups, hosts, triggers, other maps or other elements that may be related to the exported map are not exported. Thus, if at least one of the elements the map refers to is missing, importing it will fail. ::: #### مرور کلی نقشه شبکه [export](/manual/xml_export_import) شامل موارد زیر است: - تمام تصاویر مرتبط - ساختار نقشه (تمام تنظیمات نقشه، تمام عناصر موجود به همراه تنظیمات، لینکهای نقشه و شاخصهای وضعیت لینک نقشه) ::: notewarning هر گروه میزبان، میزبان، تریگر، نقشههای دیگر یا عناصر دیگری که ممکن است به نقشه صادر شده مربوط باشند، صادر نمیشوند. بنابراین، اگر حداقل یکی از عناصری که نقشه به آن اشاره دارد، وجود نداشته باشد، وارد کردن آن با شکست مواجه خواهد شد. ::: #### Overview Problem suppression offers a way of temporarily hiding a problem that can be dealt with later. This is useful for cleaning up the problem list in order to give the highest priority to the most urgent issues. For example, sometimes an issue may arise on the weekend that is not urgent enough to be dealt with immediately, so it can be "snoozed" until Monday morning. Problem suppression allows to hide a *single* problem, in contrast to problem suppression through host maintenance when all problems of the maintenance host are hidden. Operations for trigger actions will be paused for suppressed problems the same way as it is done with [host maintenance](/manual/maintenance). #### مرور کلی مهار مشکل، راهی برای پنهان کردن موقت مشکلی ارائه میدهد که میتوان بعداً به آن رسیدگی کرد. این روش برای تمیز کردن لیست مشکلات به منظور اولویت دادن به فوریترین مسائل مفید است. به عنوان مثال، گاهی اوقات ممکن است مشکلی در آخر هفته پیش بیاید که به اندازه کافی فوری نیست که فوراً به آن رسیدگی شود، بنابراین میتوان آن را تا صبح دوشنبه "به تعویق انداخت". مهار مشکل، برخلاف سرکوب مشکل از طریق نگهداری میزبان که در آن همه مشکلات میزبان نگهداری پنهان میشوند، امکان پنهان کردن یک *مشکل* را فراهم میکند. عملیات مربوط به اقدامات محرک برای مشکلات سرکوب شده به همان روشی که با [نگهداری میزبان](/manual/maintenance) انجام میشود، متوقف خواهد شد. #### Overview Some new items are automatically added for monitoring when web scenarios are created. All items inherit tags from the web scenario. #### مرور کلی برخی از موارد جدید به طور خودکار برای نظارت هنگام ایجاد سناریوهای وب اضافه میشوند. همه موارد برچسبهایی را از سناریوی وب به ارث میبرند. ## Overview tab The *Overview* tab provides detailed information about the node. ![](../../assets/en/cloud/quickstart/overview_tab.png){width="600"} It is divided into three sections: *Connection info*: - Clickable frontend URL with a copy-to-clipboard option - Password settings - Current encryption method *Configuration and usage*: - Compute tier, maximum storage, region - Zabbix components version - Disk utilization *Node info*/*Payment Info*: - Expiration date (for trial and prepaid nodes) - A context-specific button is shown depending on the node type after the node completes initialization: - *Upgrade to paid* - available for nodes on a free trial - *Cancel subscription* - available for paid nodes with an active subscription - *Resubscribe to paid* - shown if a subscription has been canceled - No action button is displayed for prepaid nodes, which have long validity and cannot be canceled ## تب مرور کلی تب *مرور کلی* اطلاعات دقیقی در مورد گره ارائه میدهد. ![](../../assets/en/cloud/quickstart/overview_tab.png){width="600"} این بخش به سه بخش تقسیم شده است: *اطلاعات اتصال*: - URL قابل کلیک در frontend با گزینه کپی به کلیپ بورد - تنظیمات رمز عبور - روش رمزگذاری فعلی *پیکربندی و نحوه استفاده*: - سطح محاسبات، حداکثر فضای ذخیرهسازی، منطقه - نسخه اجزای Zabbix - میزان استفاده از دیسک *اطلاعات گره*/*اطلاعات پرداخت*: - تاریخ انقضا (برای گرههای آزمایشی و پیشپرداخت) - یک دکمه خاص زمینه بسته به نوع گره پس از تکمیل مقداردهی اولیه گره نشان داده میشود: - *ارتقا به پولی* - برای گرههای آزمایشی رایگان در دسترس است *لغو اشتراک* - برای گرههای پولی با اشتراک فعال در دسترس است *اشتراک مجدد در پولی* - در صورت لغو اشتراک نشان داده میشود - هیچ دکمه عملیاتی برای گرههای پیشپرداخت که اعتبار طولانی دارند و قابل لغو نیستند، نمایش داده نمیشود #### Overview Templates are [exported](/manual/xml_export_import) with many related objects and object relations. Template export contains: - Linked template groups - Linked host groups (if used in [host prototype](/manual/discovery/low_level_discovery/host_prototypes) configuration) - Template data - Linkage to other templates - Linkage to template groups - Directly linked items - Directly linked triggers - Directly linked graphs - Directly linked dashboards - Directly linked discovery rules with all prototypes - Directly linked web scenarios - Value maps #### مرور کلی قالبها به صورت [exported](/manual/xml_export_import) با اشیاء مرتبط و روابط اشیاء متعدد هستند. export قالب شامل موارد زیر است: - گروههای قالب مرتبط - گروههای میزبان مرتبط (در صورت استفاده در پیکربندی [host prototype](/manual/discovery/low_level_discovery/host_prototypes)) - دادههای قالب - پیوند به سایر قالبها - پیوند به گروههای قالب - موارد پیوند مستقیم - محرکهای پیوند مستقیم - نمودارهای پیوند مستقیم - داشبوردهای پیوند مستقیم - قوانین پیوند مستقیم با تمام نمونههای اولیه - سناریوهای وب پیوند مستقیم - نقشههای ارزش #### Overview This section presents a step-by-step real-life example of how web monitoring can be used. Zabbix web monitoring will be used to monitor Zabbix frontend. The goal is to determine if it is available, provides the right content, and how quickly it works. To achieve this, several steps are required, including checking the availability of the first page, logging in with a username and password, verifying the login success, logging out, and confirming the logout. #### مرور اجمالی This section presents a step-by-step real-life example of how web monitoring can be used. Zabbix web monitoring will be used to monitor Zabbix frontend. The goal is to determine if it is available, provides the right content, and how quickly it works. To achieve this, several steps are required, including checking the availability of the first page, logging in with a username and password, verifying the login success, logging out, and confirming the logout. #### Overview Zabbix export/import functionality makes it possible to exchange various configuration entities between one Zabbix system and another. Typical use cases for this functionality: - share templates or network maps - Zabbix users may share their configuration parameters - upload a template to [Zabbix Community templates](https://github.com/zabbix/community-templates). Then others can download the template and import the file into Zabbix. - integrate with third-party tools - universal YAML, XML and JSON formats make integration and data import/export possible with third-party tools and applications #### مرور کلی قابلیت export/import زبیکس امکان تبادل موجودیتهای پیکربندی مختلف بین یک سیستم زبیکس و سیستم دیگر را فراهم میکند. موارد استفاده معمول برای این قابلیت: - اشتراکگذاری قالبها یا نقشههای شبکه - کاربران زبیکس میتوانند پارامترهای پیکربندی خود را به اشتراک بگذارند - یک قالب را در [قالبهای انجمن زبیکس] (https://github.com/zabbix/community-templates) آپلود کنند. سپس دیگران میتوانند قالب را دانلود کرده و فایل را به زبیکس وارد کنند. - ادغام با ابزارهای شخص ثالث - فرمتهای جهانی YAML، XML و JSON ادغام و وارد کردن/صادر کردن دادهها را با ابزارها و برنامههای شخص ثالث امکانپذیر میکنند. #### Overview Zabbix proxy is a process that may collect monitoring data from one or more monitored devices and send the information to the Zabbix server, essentially working on behalf of the server. All collected data is buffered locally and then transferred to the Zabbix server the proxy belongs to. Deploying a proxy is optional, but may be very beneficial to distribute the load of a single Zabbix server. If only proxies collect data, processing on the server becomes less CPU and disk I/O hungry. A Zabbix proxy is the ideal solution for centralized monitoring of remote locations, branches and networks with no local administrators. Zabbix proxy requires a separate database. ::: noteimportant Note that databases supported with Zabbix proxy are SQLite, MySQL and PostgreSQL. ::: See also: [Using proxies in a distributed environment](/manual/distributed_monitoring/proxies) #### مرور کلی پروکسی زبیکس فرآیندی است که ممکن است دادههای مانیتورینگ را از یک یا چند دستگاه تحت نظارت جمعآوری کرده و اطلاعات را به سرور زبیکس ارسال کند، که اساساً به نمایندگی از سرور کار میکند. تمام دادههای جمعآوریشده به صورت محلی بافر شده و سپس به سرور زبیکس که پروکسی به آن تعلق دارد منتقل میشوند. استقرار یک پروکسی اختیاری است، اما میتواند برای توزیع بار یک سرور زبیکس بسیار مفید باشد. اگر فقط پروکسیها دادهها را جمعآوری کنند، پردازش روی سرور کمتر به CPU و دیسک I/O نیاز پیدا میکند. پروکسی زبیکس راهحل ایدهآلی برای نظارت متمرکز بر مکانها، شعب و شبکههای از راه دور بدون مدیران محلی است. پروکسی زبیکس به یک پایگاه داده جداگانه نیاز دارد.::: توجه: مهم است توجه داشته باشید که پایگاههای داده پشتیبانی شده با پروکسی زبیکس SQLite، MySQL و PostgreSQL هستند.:::همچنین ببینید: [استفاده از پروکسیها در یک محیط توزیعشده](/manual/distributed_monitoring/proxies) #### Overview [zabbix\_utils](https://github.com/zabbix/python-zabbix-utils/blob/main/README.md) lets you collect data from Zabbix agent (similarly to [Zabbix get](/manual/concepts/get)). Data can be collected in synchronous or asynchronous mode: - In synchronous mode, your Python script requests and waits for data before continuing, which is suitable for simple, sequential, and predictable operations. - In asynchronous mode, the script requests data without waiting for each response, allowing other operations to proceed in parallel; this is more efficient for slow requests or large batches of data. The examples on this page focus on synchronous mode, though [asynchronous mode](#asynchronous-mode) follows similar patterns. Additional examples are available in the [zabbix_utils](https://github.com/zabbix/python-zabbix-utils/tree/main/examples) GitHub repository. ### استفاده از Zabbix API zabbix_utils به شما این امکان را میدهد که از Zabbix API برای مدیریت آبجکتهای Zabbix استفاده کنید؛ از جمله: * ایجاد Hostها * بهروزرسانی Itemها * دریافت Eventها * و موارد دیگر درخواستهای API میتوانند به دو صورت **همزمان (Synchronous)** یا **غیرهمزمان (Asynchronous)** ارسال شوند: * **حالت همزمان (Synchronous):** در این حالت، اسکریپت پایتون شما یک درخواست ارسال میکند و قبل از ادامه اجرای برنامه، منتظر دریافت پاسخ میماند. این روش برای عملیات ساده، ترتیبی و قابل پیشبینی مناسب است. * **حالت غیرهمزمان (Asynchronous):** در این حالت، اسکریپت بدون انتظار برای دریافت پاسخ هر درخواست، درخواستهای بعدی را ارسال میکند. این امکان اجرای موازی سایر عملیات را فراهم کرده و برای درخواستهای کند یا حجم زیاد داده کارآمدتر است. مثالهای ارائهشده در این صفحه بر حالت همزمان تمرکز دارند، اگرچه حالت غیرهمزمان نیز از الگوهای مشابهی پیروی میکند. مثالهای بیشتر در مخزن GitHub مربوط به zabbix_utils GitHub repository در دسترس هستند. ### Parameters `(array)` IDs of hosts to delete. ### پارامتر ها `(array)` IDs of hosts to delete. ### Parameters `(array)` IDs of items to clear. ### پارامتر ها `(array)` IDs of items to clear. ### Parameters `(array)` IDs of the actions to delete. ### پارامترها شناسه «(آرایه)» های اکشن برای حذف کردن . ### Parameters `(array)` IDs of the connectors to delete. ### پارامترها `(array)` شناسههای کانکتورهایی که باید حذف شوند. ### Parameters `(array)` IDs of the correlations to delete. ### پارامتر ها «(آرایه)» شناسه های همبستگی برای حذف. ### Parameters `(array)` IDs of the dashboards to delete. ### پارامتر ها «(آرایه)» شناسه های همبستگی برای حذف. ### Parameters `(array)` IDs of the discovery rules to delete. ### پارامتر ها «(آرایه)» شناسه های همبستگی برای حذف. ### Parameters `(array)` IDs of the graph prototypes to delete. ###پارامتر ها `object graphprototype.delete(array graphPrototypeIds)` This method allows to delete graph prototypes. ::: noteclassic This method is only available to *Admin* and *Super admin* user types. Permissions to call the method can be revoked in user role settings. See [User roles](/manual/web_interface/frontend_sections/administration/user_roles) for more information. ::: ### Parameters `(array)` IDs of the graphs to delete. ### پارامتر ها `(array)` IDs of the graphs to delete. ### Parameters `(array)` IDs of the host groups to delete. ###پارامتر ها `(array)` IDs of the host groups to delete. ### Parameters `(array)` IDs of the host interfaces to delete. ### پارامتر ها `(array)` IDs of the host interfaces to delete. ### Parameters `(array)` IDs of the host prototypes to delete. ### پارامتر ها `(array)` IDs of the host prototypes to delete. ### Parameters `(array)` IDs of the icon maps to delete. ### پارامتر ها `(array)` IDs of the icon maps to delete. ### Parameters `(array)` IDs of the LLD rules to delete. ### پارامتر ها «(آرایه)» شناسه های همبستگی برای حذف. ### Parameters `(array)` IDs of the web scenarios to delete. ### پارامتر ها `(array)` IDs of the web scenarios to delete. ### Parameters `(array)` The method accepts an empty array. ### پارامترها `(آرایه)` این روش یک آرایه خالی را می پذیرد. ### Parameters `(object/array)` Actions to create. Additionally to the [standard action properties](object#action), the method accepts the following parameters. |Parameter|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |filter|object|[Action filter](/manual/api/reference/action/object#action-filter) object for the action.| |operations|array|[Action operations](/manual/api/reference/action/object#action-operation) to create for the action.| |recovery\_operations|array|[Action recovery operations](/manual/api/reference/action/object#action-recovery-operation) to create for the action.| |update\_operations|array|[Action update operations](/manual/api/reference/action/object#action-update-operation) to create for the action.| ### پارامتر ها «(شیء/آرایه)» اقداماتی برای ساخت. علاوه بر [ویژگیهای اقدام استاندارد] (object#action)، متد پارامترهای زیر را می پذیرد. |پارامتر|[نوع](/manual/api/reference_commentary#data_types)|توضیحات| |--|--|------| |filter|object|Action [filter](/manual/api/reference/action/object#action_filter) شیء برای اکشن.| |عملیات|آرایه|عملیات [عملیات](/manual/api/reference/action/object#action_operation) برای ایجاد اکشن.| |بازیابی\_عملیات|آرایه|عملیات [عملیات بازیابی](/manual/api/reference/action/object#action_recovery_operation) برای ایجاد اکشن.| |update\_operations|آرایه|عملیات [عملیات بهروزرسانی](/manual/api/reference/action/object#action_update_operation) برای ایجاد عمل.| ### Parameters `(object/array)` [Host group properties](object#host-group) to be updated. The `groupid` property must be defined for each host group, all other properties are optional. Only the given properties will be updated, all others will remain unchanged. ### پارامتر ها `(object/array)` [Host group properties](object#host_group) to be updated. The `groupid` property must be defined for each host group, all other properties are optional. Only the given properties will be updated, all others will remain unchanged. ### Parameters `(object/array)` Scripts to create. The method accepts scripts with the [standard script properties](/manual/api/reference/script/object#script). ### پارامترها اسکریپت هایی برای ایجاد `(شیء/آرایه). این روش اسکریپت هایی را با [خواص اسکریپت استاندارد می پذیرد ](/دستی/api/reference/script/object#script). ### Parameters The following parameters are supported for the *Action log* widget. |Parameter|<|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-|-----|-|-----|-------------------| |*Refresh interval*|<|0|rf_rate|0 - No refresh;<br>10 - 10 seconds;<br>30 - 30 seconds;<br>60 - *(default)* 1 minute;<br>120 - 2 minutes;<br>600 - 10 minutes;<br>900 - 15 minutes.| |*Recipients*|<|11|userids.0|[User](/manual/api/reference/user/get) ID.<br><br>Note: To configure multiple users, create a dashboard widget field object for each user with an incremented number in the property name.| |*Actions*|<|12|actionids.0|[Action](/manual/api/reference/action/get) ID.<br><br>Note: To configure multiple actions, create a dashboard widget field object for each action with an incremented number in the property name.| |*Media types*|<|13|mediatypeids.0|[Media type](/manual/api/reference/mediatype/get) ID.<br><br>Note: To configure multiple media types, create a dashboard widget field object for each media type with an incremented number in the property name.| |*Status*|<|0|statuses.0|0 - In progress;<br>1 - Sent/Executed;<br>2 - Failed.<br><br>Note: To configure multiple values, create a dashboard widget field object for each value with an incremented number in the property name.| |*Search string*|<|1|message|Any string value.| |*Time period*|<|1|time_period.\_reference|`DASHBOARD._timeperiod` - set the [*Time period* selector](/manual/web_interface/time_period_selector) as the data source;<br>`ABCDE._timeperiod` - set a [compatible widget](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (with its *Reference* parameter set to "`ABCDE`") as the data source.<br><br>Default: `DASHBOARD._timeperiod`<br><br>Alternatively, you can set the time period only in the *From* and *To* parameters.| |<|*From*|1|time_period.from|Valid time string in absolute (`YYYY-MM-DD hh:mm:ss`) or [relative](/manual/web_interface/time_period_selector) time syntax (`now`, `now/d`, `now/w-1w`, etc.).<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Time period* is not set<br>- *required* if `time_period.to` is set| |^|*To*|1|time_period.to|Valid time string in absolute (`YYYY-MM-DD hh:mm:ss`) or [relative](/manual/web_interface/time_period_selector) time syntax (`now`, `now/d`, `now/w-1w`, etc.).<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Time period* is not set<br>- *required* if `time_period.from` is set| |*Sort entries by*|<|0|sort_triggers|3 - Time (ascending);<br>4 - *(default)* Time (descending);<br>5 - Type (ascending);<br>6 - Type (descending);<br>7 - Status (ascending);<br>8 - Status (descending);<br>11 - Recipient (ascending);<br>12 - Recipient (descending).| |*Show lines*|<|0|show_lines|Possible values range from 1-100.<br><br>Default: 25.| ### پارامترها پارامترهای زیر برای ویجت *گزارش اقدامات* پشتیبانی میشوند. |پارامتر|<|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-|-----|-|-----|------------------| |*فاصله زمانی تازهسازی*|<|0|rf_rate|0 - بدون تازهسازی؛<br>10 - 10 ثانیه؛<br>30 - 30 ثانیه؛<br>60 - *(پیشفرض)* 1 دقیقه؛<br>120 - 2 دقیقه؛<br>600 - 10 دقیقه؛<br>900 - 15 دقیقه.| شناسه |*Recipients*|<|11|userids.0|[User](/manual/api/reference/user/get).<br><br>توجه: برای پیکربندی چندین کاربر، برای هر کاربر یک شیء فیلد ویجت داشبورد با یک عدد افزایشی در نام ویژگی ایجاد کنید.| |*Actions*|<|12|actionids.0|[Action](/manual/api/reference/action/get) شناسه.<br><br>توجه: برای پیکربندی چندین اقدام، برای هر اقدام یک شیء فیلد ویجت داشبورد با یک عدد افزایشی در نام ویژگی ایجاد کنید.| |*Media types*|<|13|mediatypeids.0|[Media type](/manual/api/reference/mediatype/get) شناسه.<br><br>توجه: برای پیکربندی چندین نوع رسانه، برای هر نوع رسانه یک شیء فیلد ویجت داشبورد با یک عدد افزایشی در نام ویژگی ایجاد کنید.| |*وضعیت*|<|0|statuses.0|0 - در حال انجام؛<br>1 - ارسال/اجرا شده؛<br>2 - ناموفق.<br><br>توجه: برای پیکربندی چندین مقدار، برای هر مقدار یک شیء فیلد ویجت داشبورد با یک عدد افزایشی در نام ویژگی ایجاد کنید.| |*رشته جستجو*|<|1|پیام|هر مقدار رشتهای.| |*دوره زمانی*|<|1|time_period.\_reference|`DASHBOARD._timeperiod` - انتخابگر [*Time period*](/manual/web_interface/time_period_selector) را به عنوان منبع داده تنظیم کنید؛<br>`ABCDE._timeperiod` - یک [ویجت سازگار](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (با پارامتر *Reference* آن که روی "`ABCDE`" تنظیم شده باشد) را به عنوان منبع داده تنظیم کنید.<br><br>پیشفرض: `DASHBOARD._timeperiod`<br><br>روش دیگر، میتوانید دوره زمانی را فقط در پارامترهای *From* و *To* تنظیم کنید.| |<|*از*|1|time_period.from|رشته زمان معتبر در سینتکس زمان مطلق (`YYYY-MM-DD hh:mm:ss`) یا [نسبی](/manual/web_interface/time_period_selector) (`now`، `now/d`، `now/w-1w` و غیره).<br><br>[رفتار پارامتر](/manual/api/reference_commentary#parameter-behavior):<br>- *پشتیبانی* اگر *دوره زمانی* تنظیم نشده باشد| |^|*به*|1|time_period.to|رشته زمان معتبر در سینتکس زمان مطلق (`YYYY-MM-DD hh:mm:ss`) یا [نسبی](/manual/web_interface/time_period_selector) (`now`، `now/d`، `now/w-1w` و غیره).<br><br>[رفتار پارامتر](/manual/api/reference_commentary#parameter-behavior):<br>- *پشتیبانی* اگر *دوره زمانی* تنظیم نشده باشد| |*مرتبسازی ورودیها بر اساس*|<|0|راهاندازهای مرتبسازی|3 - زمان (صعودی)؛<br>4 - *(پیشفرض)* زمان (نزولی)؛<br>5 - نوع (صعودی)؛<br>6 - نوع (نزولی)؛<br>7 - وضعیت (صعودی)؛<br>8 - وضعیت (نزولی)؛<br>11 - گیرنده (صعودی)؛<br>12 - گیرنده (نزولی).| |*نمایش خطوط*|<|0|show_lines|مقادیر ممکن از 1 تا 100 متغیر است.<br><br>پیشفرض: 25.| ### Parameters The following parameters are supported for the *Clock* widget. |Parameter|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-----|-|-----|-------------------| |*Refresh interval*|0|rf_rate|0 - No refresh;<br>10 - 10 seconds;<br>30 - 30 seconds;<br>60 - 1 minute;<br>120 - 2 minutes;<br>600 - 10 minutes;<br>900 - *(default)* 15 minutes.| |*Time type*|0|time_type|0 - *(default)* Local time;<br>1 - Server time;<br>2 - Host time.| |*Clock type*|0|clock_type|0 - *(default)* Analog;<br>1 - Digital.| The following parameters are supported if *Time type* is set to "Host time". |Parameter|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-----|-|-----|-------------------| |*Item*|4|itemid.0|[Item](/manual/api/reference/item/get) ID.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required*| The following parameters are supported if *Clock type* is set to "Digital". |Parameter|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-----|-|-----|-------------------| |*Show*|0|show.0|1 - Date;<br>2 - *(default)* Time;<br>3 - Time zone.<br><br>Note: To configure multiple values, create a dashboard widget field object for each value with an incremented number in the property name.| ### پارامتر ها The following parameters are supported for the *Clock* widget. |Parameter|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-----|-|-----|-------------------| |*Refresh interval*|0|rf_rate|0 - No refresh;<br>10 - 10 seconds;<br>30 - 30 seconds;<br>60 - 1 minute;<br>120 - 2 minutes;<br>600 - 10 minutes;<br>900 - *(default)* 15 minutes.| |*Time type*|0|time_type|0 - *(default)* Local time;<br>1 - Server time;<br>2 - Host time.| |*Clock type*|0|clock_type|0 - *(default)* Analog;<br>1 - Digital.| The following parameters are supported if *Time type* is set to "Host time". |Parameter|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-----|-|-----|-------------------| |*Item*|4|itemid|[Item](/manual/api/reference/item/get) ID.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required*| The following parameters are supported if *Clock type* is set to "Digital". |Parameter|<|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-|--------|--|--------|-------------------------------| |*Show*|<|0|show|1 - Date;<br>2 - *(default)* Time;<br>3 - Time zone.<br><br>Note: To configure multiple values, create a dashboard widget field object for each value.| |*Advanced configuration*|<|0|adv_conf|0 - *(default)* Disabled;<br>1 - Enabled.<br><br>Parameter *Advanced configuration* must be set to "Enabled" to configure *Background color* and all options for *Date*, *Time* and *Time zone*.| |*Background color*|<|1|bg_color|Hexadecimal color code (e.g. `FF0000`).<br><br>Default: `""` (empty).| |*Date*|<|<|<|<| |<|*Size*|0|date_size|Valid values range from 1-100.<br><br>Default: 20.| |^|*Bold*|0|date_bold|0 - *(default)* Disabled;<br>1 - Enabled.| |^|*Color*|1|date_color|Hexadecimal color code (e.g. `FF0000`).<br><br>Default: `""` (empty).| |*Time*|<|<|<|<| |<|*Size*|0|time_size|Valid values range from 1-100.<br><br>Default: 30.| |^|*Bold*|0|time_bold|0 - *(default)* Disabled;<br>1 - Enabled.| |^|*Color*|1|time_color|Hexadecimal color code (e.g. `FF0000`).<br><br>Default: `""` (empty).| |^|*Seconds*|0|time_sec|0 - Disabled;<br>1 - *(default)* Enabled.| |^|*Format*|0|time_format|0 - *(default)* 24-hour;<br>1 - 12-hour.| |*Time zone*|<|<|<|<| |<|*Size*|0|tzone_size|Valid values range from 1-100.<br><br>Default: 20.| |^|*Bold*|0|tzone_bold|0 - *(default)* Disabled;<br>1 - Enabled.| |^|*Color*|1|tzone_color|Hexadecimal color code (e.g. `FF0000`).<br><br>Default: `""` (empty).| |^|*Time zone*|1|tzone_timezone|Valid timezone string (e.g. `Europe/Riga`, `system`, `UTC`, etc.). For the full list of supported time zones please refer to [PHP documentation](https://www.php.net/manual/en/timezones.php).<br><br>Default: `local`.<br><br>Parameter *Time zone* not available if *Time type* is set to "Host time".| |^|*Format*|0|tzone_format|0 - *(default)* Short;<br>1 - Full.<br><br>Parameter *Format* not available if *Time type* is set to "Host time".| ### Parameters The following parameters are supported for the *Discovery status* widget. |Parameter|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-----|-|-----|-------------------| |*Refresh interval*|0|rf_rate|0 - No refresh;<br>10 - 10 seconds;<br>30 - 30 seconds;<br>60 - *(default)* 1 minute;<br>120 - 2 minutes;<br>600 - 10 minutes;<br>900 - 15 minutes.| ### پارامترها پارامترهای زیر برای ویجت *نمودار دایرهای* پشتیبانی میشوند. |پارامتر|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-----|-|-----|------------------| |*فاصله زمانی تازهسازی*|0|rf_rate|0 - بدون تازهسازی;<br>10 - 10 ثانیه;<br>30 - 30 ثانیه;<br>60 - *(پیشفرض)* 1 دقیقه;<br>120 - 2 دقیقه;<br>600 - 10 دقیقه;<br>900 - 15 دقیقه.| ### Parameters The following parameters are supported for the *Favorite graphs* widget. |Parameter|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-----|-|-----|-------------------| |*Refresh interval*|0|rf_rate|0 - No refresh;<br>10 - 10 seconds;<br>30 - 30 seconds;<br>60 - 1 minute;<br>120 - 2 minutes;<br>600 - 10 minutes;<br>900 - *(default)* 15 minutes.| ### پارامترها پارامترهای زیر برای ویجت *نمودار دایرهای* پشتیبانی میشوند. |پارامتر|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-----|-|-----|------------------| |*فاصله زمانی تازهسازی*|0|rf_rate|0 - بدون تازهسازی;<br>10 - 10 ثانیه;<br>30 - 30 ثانیه;<br>60 - *(پیشفرض)* 1 دقیقه;<br>120 - 2 دقیقه;<br>600 - 10 دقیقه;<br>900 - 15 دقیقه.| ### Parameters The following parameters are supported for the *Favorite maps* widget. |Parameter|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-----|-|-----|-------------------| |*Refresh interval*|0|rf_rate|0 - No refresh;<br>10 - 10 seconds;<br>30 - 30 seconds;<br>60 - 1 minute;<br>120 - 2 minutes;<br>600 - 10 minutes;<br>900 - *(default)* 15 minutes.| ### پارامترها پارامترهای زیر برای ویجت *نمودار دایرهای* پشتیبانی میشوند. |پارامتر|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-----|-|-----|------------------| |*فاصله زمانی تازهسازی*|0|rf_rate|0 - بدون تازهسازی;<br>10 - 10 ثانیه;<br>30 - 30 ثانیه;<br>60 - *(پیشفرض)* 1 دقیقه;<br>120 - 2 دقیقه;<br>600 - 10 دقیقه;<br>900 - 15 دقیقه.| ### Parameters The following parameters are supported for the *Pie chart* widget. |Parameter|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-----|-|-----|-------------------| |*Refresh interval*|0|rf_rate|0 - No refresh;<br>10 - 10 seconds;<br>30 - 30 seconds;<br>60 - *(default)* 1 minute;<br>120 - 2 minutes;<br>600 - 10 minutes;<br>900 - 15 minutes.| ### پارامترها پارامترهای زیر برای ویجت *نمودار دایرهای* پشتیبانی میشوند. |پارامتر|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-----|-|-----|------------------| |*فاصله زمانی تازهسازی*|0|rf_rate|0 - بدون تازهسازی;<br>10 - 10 ثانیه;<br>30 - 30 ثانیه;<br>60 - *(پیشفرض)* 1 دقیقه;<br>120 - 2 دقیقه;<br>600 - 10 دقیقه;<br>900 - 15 دقیقه.| ### Parameters The following parameters are supported for the *Top hosts* widget. |Parameter|<|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-|--------|--|--------|-------------------------------| |*Refresh interval*|<|0|rf_rate|0 - No refresh;<br>10 - 10 seconds;<br>30 - 30 seconds;<br>60 - *(default)* 1 minute;<br>120 - 2 minutes;<br>600 - 10 minutes;<br>900 - 15 minutes.| |*Host groups*|<|2|groupids.0|[Host group](/manual/api/reference/hostgroup/get) ID.<br><br>Note: To configure multiple host groups, create a dashboard widget field object for each host group with an incremented number in the property name.<br><br>This parameter is not supported if configuring the widget on a [template dashboard](/manual/api/reference/templatedashboard/object).| |<|*Host groups (Widget)*|1|groupids.\_reference|Instead of [Host group](/manual/api/reference/hostgroup/get) ID:<br>`ABCDE._hostgroupids` - set a [compatible widget](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (with its *Reference* parameter set to "`ABCDE`") as the data source for host groups.<br><br>This parameter is not supported if configuring the widget on a [template dashboard](/manual/api/reference/templatedashboard/object).| |*Hosts*|<|3|hostids.0|[Host](/manual/api/reference/host/get) ID.<br><br>Note: To configure multiple hosts, create a dashboard widget field object for each host with an incremented number in the property name. For multiple hosts, the parameter *Host groups* must either be not configured at all or configured with at least one host group that the configured hosts belong to.<br><br>This parameter is not supported if configuring the widget on a [template dashboard](/manual/api/reference/templatedashboard/object).| |<|*Hosts (Widget/Dashboard)*|1|hostids.\_reference|Instead of [Host](/manual/api/reference/host/get) ID:<br>`DASHBOARD.hostids` - set the [*Host* selector](/manual/web_interface/frontend_sections/dashboards/widgets#override-host) as the data source for hosts;<br>`ABCDE._hostids` - set a [compatible widget](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (with its *Reference* parameter set to "`ABCDE`") as the data source for hosts.<br><br>This parameter is not supported if configuring the widget on a [template dashboard](/manual/api/reference/templatedashboard/object).| |*Host tags*|<|<|<|<| |<|*Evaluation type*|0|evaltype|0 - *(default)* And/Or;<br>2 - Or.<br><br>This parameter is not supported if configuring the widget on a [template dashboard](/manual/api/reference/templatedashboard/object).| |^|*Tag name*|1|tags.0.tag|Any string value.<br><br>Note: The number in the property name references tag order in the tag evaluation list.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if configuring *Host tags*<br><br>This parameter is not supported if configuring the widget on a [template dashboard](/manual/api/reference/templatedashboard/object).| |^|*Operator*|0|tags.0.operator|0 - Contains;<br>1 - Equals;<br>2 - Does not contain;<br>3 - Does not equal;<br>4 - Exists;<br>5 - Does not exist.<br><br>Note: The number in the property name references tag order in the tag evaluation list.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if configuring *Host tags*<br><br>This parameter is not supported if configuring the widget on a [template dashboard](/manual/api/reference/templatedashboard/object).| |^|*Tag value*|1|tags.0.value|Any string value.<br><br>Note: The number in the property name references tag order in the tag evaluation list.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if configuring *Host tags*<br><br>This parameter is not supported if configuring the widget on a [template dashboard](/manual/api/reference/templatedashboard/object).| |*Show hosts in maintenance*|<|0|maintenance|0 - *(default)* Disabled;<br>1 - Enabled.| |*Columns* (see below)|<|<|<|<| |*Order by*|<|0|column|Column numeric value from the configured columns.| |*Order*|<|0|order|2 - *(default)* Top N;<br>3 - Bottom N.| |*Host limit*|<|0|show_lines|Possible values range from 1-1000.<br><br>Default: 10.<br><br>This parameter is not supported if configuring the widget on a [template dashboard](/manual/api/reference/templatedashboard/object).| ### پارامترها پارامترهای زیر برای ویجت *میزبانهای برتر (Top hosts)* پشتیبانی میشوند. | پارامتر | < | [نوع](/manual/api/reference/dashboard/object#dashboard-widget-field) | نام | مقدار | |---------|--|--------|------|-------| | *فاصله بازخوانی (Refresh interval)* | < | 0 | rf_rate | 0 - بدون بازخوانی؛<br>10 - ۱۰ ثانیه؛<br>30 - ۳۰ ثانیه؛<br>60 - *(پیشفرض)* ۱ دقیقه؛<br>120 - ۲ دقیقه؛<br>600 - ۱۰ دقیقه؛<br>900 - ۱۵ دقیقه. | | *گروههای میزبان (Host groups)* | < | 2 | groupids.0 | شناسه [گروه میزبان](/manual/api/reference/hostgroup/get).<br><br>توجه: برای پیکربندی چندین گروه میزبان، برای هر گروه میزبان یک شیء فیلد ویجت داشبورد با شماره افزایشیافته در نام ویژگی ایجاد کنید.<br><br>این پارامتر در صورت پیکربندی ویجت در [داشبورد تمپلیت](/manual/api/reference/templatedashboard/object) پشتیبانی نمیشود. | | < | *گروههای میزبان (ویجت)* | 1 | groupids.\_reference | به جای شناسه [گروه میزبان](/manual/api/reference/hostgroup/get):<br>`ABCDE._hostgroupids` - تنظیم یک [ویجت سازگار](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (با پارامتر *مرجع* آن روی "`ABCDE`" تنظیم شده) به عنوان منبع داده برای گروههای میزبان.<br><br>این پارامتر در صورت پیکربندی ویجت در [داشبورد تمپلیت](/manual/api/reference/templatedashboard/object) پشتیبانی نمیشود. | | *میزبانها (Hosts)* | < | 3 | hostids.0 | شناسه [میزبان](/manual/api/reference/host/get).<br><br>توجه: برای پیکربندی چندین میزبان، برای هر میزبان یک شیء فیلد ویجت داشبورد با شماره افزایشیافته در نام ویژگی ایجاد کنید. برای چندین میزبان، پارامتر *گروههای میزبان* یا باید اصلاً پیکربندی نشود یا با حداقل یک گروه میزبان که میزبانهای پیکربندی شده به آن تعلق دارند، پیکربندی شود.<br><br>این پارامتر در صورت پیکربندی ویجت در [داشبورد تمپلیت](/manual/api/reference/templatedashboard/object) پشتیبانی نمیشود. | | < | *میزبانها (ویجت/داشبورد)* | 1 | hostids.\_reference | به جای شناسه [میزبان](/manual/api/reference/host/get):<br>`DASHBOARD.hostids` - تنظیم [انتخابگر *میزبان*](/manual/web_interface/frontend_sections/dashboards/widgets#override-host) به عنوان منبع داده برای میزبانها؛<br>`ABCDE._hostids` - تنظیم یک [ویجت سازگار](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (با پارامتر *مرجع* آن روی "`ABCDE`" تنظیم شده) به عنوان منبع داده برای میزبانها.<br><br>این پارامتر در صورت پیکربندی ویجت در [داشبورد تمپلیت](/manual/api/reference/templatedashboard/object) پشتیبانی نمیشود. | | *برچسبهای میزبان (Host tags)* | < | < | < | < | | < | *نوع ارزیابی (Evaluation type)* | 0 | evaltype | 0 - *(پیشفرض)* And/Or؛<br>2 - Or.<br><br>این پارامتر در صورت پیکربندی ویجت در [داشبورد تمپلیت](/manual/api/reference/templatedashboard/object) پشتیبانی نمیشود. | | ^ | *نام برچسب (Tag name)* | 1 | tags.0.tag | هر مقدار رشتهای.<br><br>توجه: عدد در نام ویژگی به ترتیب برچسب در لیست ارزیابی برچسب اشاره دارد.<br><br>[رفتار پارامتر](/manual/api/reference_commentary#parameter-behavior):<br>- *الزامی* در صورت پیکربندی *برچسبهای میزبان*<br><br>این پارامتر در صورت پیکربندی ویجت در [داشبورد تمپلیت](/manual/api/reference/templatedashboard/object) پشتیبانی نمیشود. | | ^ | *عملگر (Operator)* | 0 | tags.0.operator | 0 - شامل میشود (Contains)؛<br>1 - برابر است (Equals)؛<br>2 - شامل نمیشود (Does not contain)؛<br>3 - برابر نیست (Does not equal)؛<br>4 - وجود دارد (Exists)؛<br>5 - وجود ندارد (Does not exist).<br><br>توجه: عدد در نام ویژگی به ترتیب برچسب در لیست ارزیابی برچسب اشاره دارد.<br><br>[رفتار پارامتر](/manual/api/reference_commentary#parameter-behavior):<br>- *الزامی* در صورت پیکربندی *برچسبهای میزبان*<br><br>این پارامتر در صورت پیکربندی ویجت در [داشبورد تمپلیت](/manual/api/reference/templatedashboard/object) پشتیبانی نمیشود. | | ^ | *مقدار برچسب (Tag value)* | 1 | tags.0.value | هر مقدار رشتهای.<br><br>توجه: عدد در نام ویژگی به ترتیب برچسب در لیست ارزیابی برچسب اشاره دارد.<br><br>[رفتار پارامتر](/manual/api/reference_commentary#parameter-behavior):<br>- *الزامی* در صورت پیکربندی *برچسبهای میزبان*<br><br>این پارامتر در صورت پیکربندی ویجت در [داشبورد تمپلیت](/manual/api/reference/templatedashboard/object) پشتیبانی نمیشود. | | *نمایش میزبانهای در حال تعمیر و نگهداری* | < | 0 | maintenance | 0 - *(پیشفرض)* غیرفعال (Disabled)؛<br>1 - فعال (Enabled). | | *ستونها (Columns)* (به زیر مراجعه کنید) | < | < | < | < | | *ترتیب بر اساس* | < | 0 | column | مقدار عددی ستون از ستونهای پیکربندی شده. | | *ترتیب (Order)* | < | 0 | order | 2 - *(پیشفرض)* N تای اول (Top N)؛<br>3 - N تای آخر (Bottom N). | | *محدودیت میزبان* | < | 0 | show_lines | مقادیر ممکن از 1 تا 1000.<br><br>پیشفرض: 10.<br><br>این پارامتر در صورت پیکربندی ویجت در [داشبورد تمپلیت](/manual/api/reference/templatedashboard/object) پشتیبانی نمیشود. | ### Parameters The following parameters are supported for the *Web monitoring* widget. |Parameter|<|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-|--------|--|--------|-------------------------------| |*Refresh interval*|<|0|rf_rate|0 - No refresh;<br>10 - 10 seconds;<br>30 - 30 seconds;<br>60 - *(default)* 1 minute;<br>120 - 2 minutes;<br>600 - 10 minutes;<br>900 - 15 minutes.| |*Host groups*|<|2|groupids.0|[Host group](/manual/api/reference/hostgroup/get) ID.<br><br>Note: To configure multiple host groups, create a dashboard widget field object for each host group with an incremented number in the property name.<br><br>This parameter is not supported if configuring the widget on a [template dashboard](/manual/api/reference/templatedashboard/object).| |<|*Host groups (Widget)*|1|groupids.\_reference|Instead of [Host group](/manual/api/reference/hostgroup/get) ID:<br>`ABCDE._hostgroupids` - set a [compatible widget](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (with its *Reference* parameter set to "`ABCDE`") as the data source for host groups.<br><br>This parameter is not supported if configuring the widget on a [template dashboard](/manual/api/reference/templatedashboard/object).| |*Exclude host groups*|<|2|exclude_groupids.0|[Host group](/manual/api/reference/hostgroup/get) ID.<br><br>Note: To exclude multiple host groups, create a dashboard widget field object for each host group with an incremented number in the property name.<br><br>This parameter is not supported if configuring the widget on a [template dashboard](/manual/api/reference/templatedashboard/object).| |*Hosts*|<|3|hostids.0|[Host](/manual/api/reference/host/get) ID.<br><br>Note: To configure multiple hosts, create a dashboard widget field object for each host with an incremented number in the property name. For multiple hosts, the parameter *Host groups* must either be not configured at all or configured with at least one host group that the configured hosts belong to.<br><br>This parameter is not supported if configuring the widget on a [template dashboard](/manual/api/reference/templatedashboard/object).| |<|*Hosts (Widget/Dashboard)*|1|hostids.\_reference|Instead of [Host](/manual/api/reference/host/get) ID:<br>`DASHBOARD.hostids` - set the [*Host* selector](/manual/web_interface/frontend_sections/dashboards/widgets#override-host) as the data source for hosts;<br>`ABCDE._hostids` - set a [compatible widget](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (with its *Reference* parameter set to "`ABCDE`") as the data source for hosts.<br><br>This parameter is not supported if configuring the widget on a [template dashboard](/manual/api/reference/templatedashboard/object).| |*Scenario tags*|<|<|<|<| |<|*Evaluation type*|0|evaltype|0 - *(default)* And/Or;<br>2 - Or.| |^|*Tag name*|1|tags.0.tag|Any string value.<br><br>Note: The number in the property name references tag order in the tag evaluation list.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if configuring *Scenario tags*| |^|*Operator*|0|tags.0.operator|0 - Contains;<br>1 - Equals;<br>2 - Does not contain;<br>3 - Does not equal;<br>4 - Exists;<br>5 - Does not exist.<br><br>Note: The number in the property name references tag order in the tag evaluation list.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if configuring *Scenario tags*| |^|*Tag value*|1|tags.0.value|Any string value.<br><br>Note: The number in the property name references tag order in the tag evaluation list.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if configuring *Scenario tags*| |*Show hosts in maintenance*|<|0|maintenance|0 - Disabled;<br>1 - *(default)* Enabled.| |*Reference*|<|1|reference|Any string value consisting of 5 characters (e.g., `ABCDE` or `JBPNL`). This value must be unique within the dashboard to which the widget belongs.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required*| ### Parameters The following parameters are supported for the *Web monitoring* widget. |Parameter|<|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-|--------|--|--------|-------------------------------| |*Refresh interval*|<|0|rf_rate|0 - No refresh;<br>10 - 10 seconds;<br>30 - 30 seconds;<br>60 - *(default)* 1 minute;<br>120 - 2 minutes;<br>600 - 10 minutes;<br>900 - 15 minutes.| |*Host groups*|<|2|groupids|[Host group](/manual/api/reference/hostgroup/get) ID.<br><br>Note: To configure multiple host groups, create a dashboard widget field object for each host group.| |*Exclude host groups*|<|2|exclude_groupids|[Host group](/manual/api/reference/hostgroup/get) ID.<br><br>Note: To exclude multiple host groups, create a dashboard widget field object for each host group.| |*Hosts*|<|3|hostids|[Host](/manual/api/reference/host/get) ID.<br><br>Note: To configure multiple hosts, create a dashboard widget field object for each host. For multiple hosts, the parameter *Host groups* must either be not configured at all or configured with at least one host group that the configured hosts belong to.| |*Tags* (the number in the property name (e.g. tags.tag.0) references tag order in the tag evaluation list)|<|<|<|<| |<|*Evaluation type*|0|evaltype|0 - *(default)* And/Or;<br>2 - Or.| |^|*Tag name*|1|tags.tag.0|Any string value.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if configuring *Tags*| |^|*Operator*|0|tags.operator.0|0 - Contains;<br>1 - Equals;<br>2 - Does not contain;<br>3 - Does not equal;<br>4 - Exists;<br>5 - Does not exist.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if configuring *Tags*| |^|*Tag value*|1|tags.value.0|Any string value.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if configuring *Tags*| |*Show hosts in maintenance*|<|0|maintenance|0 - Disabled;<br>1 - *(default)* Enabled.| ## Part I - "Hello, world!" In this section you will learn how to create the minimum required widget elements and add a new widget to Zabbix frontend. ## بخش اول - "سلام دنیا!" در این بخش یاد خواهید گرفت که چگونه حداقل عناصر ویجت مورد نیاز را ایجاد کنید و یک ویجت جدید به فرانتاند زبیکس اضافه کنید. ## Part II - Gauge chart ## بخش دوم - نمودار gauge ### Part I - New menu section ### بخش اول - بخش منوی جدید ### plugin.Configurator *Configurator* interface provides plugin configuration parameters from Zabbix agent 2 configuration files. ### plugin.Configurator رابط *Configurator* پارامترهای پیکربندی افزونه را از فایلهای پیکربندی Zabbix agent 2 ارائه میدهد. ### plugin.Exporter *Exporter* is the simplest interface that performs a poll and returns a value (values), nothing, or error. It accepts a preparsed item key, parameters, and context. Access to all other plugin interfaces is exclusive and no method can be called if a plugin is already performing a task. Also, there is a limit of 100 maximum concurrent *Export()* calls per plugin, which can be reduced according to the requirements for each plugin. ### plugin.Exporter *Exporter* سادهترین رابطی است که یک نظرسنجی انجام میدهد و یک مقدار (مقادیر)، هیچ چیز یا خطا را برمیگرداند. این رابط یک کلید آیتم آماده، پارامترها و زمینه را میپذیرد. دسترسی به تمام رابطهای افزونه دیگر انحصاری است و اگر افزونهای در حال انجام یک کار باشد، هیچ متدی نمیتواند فراخوانی شود. همچنین، محدودیت حداکثر ۱۰۰ فراخوانی همزمان *Export()* برای هر افزونه وجود دارد که میتواند با توجه به الزامات هر افزونه کاهش یابد. # Plugin interfaces This section describes available plugin interfaces. # رابطهای افزونه این بخش رابطهای افزونه موجود را شرح میدهد. ### plugin.Runner *Runner* interface provides the means for performing initialization when a plugin is started (activated) and deinitialization when a plugin is stopped (deactivated). For example, a plugin can start/stop some background *goroutine* by implementing the Runner interface. ### plugin.Runner رابط *Runner* ابزاری برای انجام مقداردهی اولیه هنگام شروع (فعال شدن) یک افزونه و مقداردهی اولیهزدایی هنگام توقف (غیرفعال شدن) آن فراهم میکند. برای مثال، یک افزونه میتواند با پیادهسازی رابط Runner، برخی *goroutine*های پسزمینه را شروع/متوقف کند. # Plugins ## پلاگین ## Pre-requisites Before proceeding make sure, that: - The module is located inside the *modules* directory of your Zabbix frontend installation (for example, *zabbix/ui/modules*). - The module has at least a basic version of [manifest.json](/devel/modules/file_structure/manifest) file. - You have access to the Administration menu section in Zabbix (requires Super admin user role type). :::notetip The frontend will not install or even recognize incompatible modules. ::: ## پیشنیازها قبل از ادامه، مطمئن شوید که: - ماژول در پوشه *modules* از نصب فرانتاند زبیکس شما قرار دارد (برای مثال، *zabbix/ui/modules*). - ماژول حداقل یک نسخه پایه از فایل [manifest.json](/devel/modules/file_structure/manifest) دارد. - شما به بخش منوی مدیریت در زبیکس دسترسی دارید (به نوع نقش کاربری Super admin نیاز دارد). :::notetip فرانتاند ماژولهای ناسازگار را نصب یا حتی تشخیص نمیدهد. ::: ##### Presentation modification methods The widget presentation modification methods are responsible for modifying widget appearance. ##### روشهای اصلاح نمایش روشهای اصلاح نمایش ویجت مسئول اصلاح ظاهر ویجت هستند. # Presentation This page describes the components that can be used to create a widget presentation view. The widget presentation view is the part of the widget that receives the data according to its [configuration](/configuration) and displays it on the dashboard in a container. The presentation view consists of three parts: - [Widget action](#widget-action) - [Widget view](#widget-view) - [JavaScript](#javascript) # ارائه این صفحه اجزایی را که میتوانند برای ایجاد نمای ارائه ویجت استفاده شوند، شرح میدهد. نمای ارائه ویجت بخشی از ویجت است که دادهها را طبق [configuration](/configuration) خود دریافت میکند و آن را در داشبورد در یک کانتینر نمایش میدهد. نمای ارائه از سه بخش تشکیل شده است: - [Widget action](#widget-action) - [Widget view](#widget-view) - [JavaScript](#javascript) #### Problems Retrieve problems according to the given parameters. [Problem API](/manual/api/reference/problem) #### مشکلات بازیابی مشکلات بر اساس پارامترهای داده شده.[رابط برنامهنویسی مشکل](/manual/api/reference/problem) #### Proxies and proxy groups Manage the proxies used in your distributed monitoring setup. [Proxy API](/manual/api/reference/proxy) | [Proxy group API](/manual/api/reference/proxygroup) #### پروکسیها و گروههای پروکسی. پروکسیهای مورد استفاده در تنظیمات نظارت توزیعشده خود را مدیریت کنید.[Proxy API](/manual/api/reference/proxy) | [Proxy group API](/manual/api/reference/proxygroup) # Python library for Zabbix کتابخانه پایتون برای زبیکس ##### Readable summary in maps A hidden "aria-label" property is available allowing map information to be read with a screen reader. Both general map description and individual element description is available, in the following format: - for map description: `<Map name>, <* of * items in problem state>, <* problems in total>.` - for describing one element with one problem: `<Element type>, Status <Element status>, <Element name>, <Problem description>.` - for describing one element with multiple problems: `<Element type>, Status <Element status>, <Element name>, <* problems>.` - for describing one element without problems: `<Element type>, Status <Element status>, <Element name>.` For example, this description is available: 'Local network, 1 of 6 elements in problem state, 1 problem in total. Host, Status problem, My host, Free disk space is less than 20% on volume \/. Host group, Status ok, Virtual servers. Host, Status ok, Server 1. Host, Status ok, Server 2. Host, Status ok, Server 3. Host, Status ok, Server 4. ' for the following map: ![](../../../../../assets/en/manual/web_interface/map_aria_label.png){width="600"} ##### خلاصه قابل خواندن در نقشهها یک ویژگی پنهان "aria-label" در دسترس است که امکان خواندن اطلاعات نقشه را با یک صفحهخوان فراهم میکند. هم توضیحات کلی نقشه و هم توضیحات تک تک عناصر، در قالب زیر موجود است: - برای توضیحات نقشه: `<نام نقشه>، <* از * موارد در وضعیت مشکل>، <* مشکلات در کل>.` - برای توصیف یک عنصر با یک مشکل: `<نوع عنصر>، وضعیت <وضعیت عنصر>، <نام عنصر>، <توضیحات مشکل>.` - برای توصیف یک عنصر با چندین مشکل: `<نوع عنصر>، وضعیت <وضعیت عنصر>، <نام عنصر>، <* مشکلات>.` - برای توصیف یک عنصر بدون مشکل: `<نوع عنصر>، وضعیت <وضعیت عنصر>، <نام عنصر>.` برای مثال، این توضیحات در دسترس است: 'شبکه محلی، ۱ از ۶ عنصر در وضعیت مشکل، ۱ مشکل در مجموع. میزبان، وضعیت مشکل، میزبان من، فضای دیسک آزاد کمتر از ۲۰٪ در حجم است \/. گروه میزبان، وضعیت خوب، سرورهای مجازی. میزبان، وضعیت خوب، سرور ۱. میزبان، وضعیت خوب، سرور ۲. میزبان، وضعیت خوب، سرور ۳. میزبان، وضعیت خوب، سرور ۴. 'برای نقشه زیر:![](../../../../../assets/en/manual/web_interface/map_aria_label.png){width="600"} ##### Referencing a network map Network maps can be referenced by both `sysmapid` and `mapname` GET parameters. For example, http://zabbix/zabbix/zabbix.php?action=map.view&mapname=Local%20network will open the map with that name (Local network). If both `sysmapid` (map ID) and `mapname` (map name) are specified, `mapname` has higher priority. ##### ارجاع به نقشه شبکه نقشه های شبکه را می توان با «sysmapid» و «mapname» GET ارجاع داد مولفه های. مثلا، http://zabbix/zabbix/zabbix.php?action=map.view&mapname=Local%20network نقشه را با آن نام باز می کند (شبکه محلی). اگر هر دو «sysmapid» (شناسه نقشه) و «نام نقشه» (نام نقشه) مشخص شده باشند، «نام نقشه» اولویت بیشتری دارد. # Register a new module This section explains how to add a new module to Zabbix frontend. # ثبت یک ماژول جدید این بخش نحوه اضافه کردن یک ماژول جدید به فرانتاند زبیکس را توضیح میدهد. ##### Regular expression {#regexp} Match the value to the regular expression and replace with the required output. Parameters: - **pattern** - the regular expression;<br> - **output** - the output formatting template. An \\N (where N=1…9) escape sequence is replaced with the Nth matched group. A \\0 escape sequence is replaced with the matched text. Comments: - A failure to match the input value will make the item unsupported;<br> - The regular expression supports extraction of maximum 10 captured groups with the \\N sequence;<br> - If you mark the *Custom on fail* checkbox, it is possible to specify custom error-handling options: either to discard the value, set a specified value, or set a specified error message. In case of a failed preprocessing step, the item will not become unsupported if the option to discard the value or set a specified value is selected.<br> - Please refer to [regular expressions](/manual/regular_expressions#example) section for some existing examples. ##### عبارت منظم {#regexp}مقدار را با عبارت منظم مطابقت داده و با خروجی مورد نیاز جایگزین کنید. پارامترها:-**pattern** - عبارت منظم؛<br>-**output** - الگوی قالببندی خروجی. یک رشته escape به تعداد \\N (که در آن N=1…9) با گروه منطبق Nام جایگزین میشود. یک رشته escape به تعداد \\0 با متن منطبق جایگزین میشود. #### Renaming a host group Rename a host group to "Linux hosts". [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "hostgroup.update", "params": { "groupid": "7", "name": "Linux hosts" }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "groupids": [ "7" ] }, "id": 1 } ``` #### تغییر نام گروه هاستی Rename a host group to "Linux hosts." Request: ```json { "jsonrpc": "2.0", "method": "hostgroup.update", "params": { "groupid": "7", "name": "Linux hosts" }, "auth": "700ca65537074ec963db7efabda78259", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "groupids": [ "7" ] }, "id": 1 } ``` ##### Replace {#replace} Find the search string and replace it with another (or nothing). Parameters: - **search string** - the string to find and replace, case-sensitive (required);<br> - **replacement** - the string to replace the search string with. The replacement string may also be empty effectively allowing to delete the search string when found. Comments: - All occurrences of the search string will be replaced; - It is possible to use escape sequences to search for or replace line breaks, carriage return, tabs and spaces "\\n \\r \\t \\s"; backslash can be escaped as "\\\\" and escape sequences can be escaped as "\\\\n"; - Escaping of line breaks, carriage return, tabs is automatically done during low-level discovery. ##### جایگزینی {#replace}رشته جستجو را پیدا کرده و آن را با رشته دیگری (یا هیچ چیز) جایگزین میکند. پارامترها:-**search string** - رشتهای که باید پیدا و جایگزین شود، حساس به حروف کوچک و بزرگ (الزامی)؛<br>-**replacement** - رشتهای که باید رشته جستجو با آن جایگزین شود. رشته جایگزین همچنین میتواند خالی باشد که به طور مؤثر امکان حذف رشته جستجو را در صورت یافتن فراهم میکند. #### Requesting authenticated user's information Authenticate and return additional information about the user. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "user.login", "params": { "username": "Admin", "password": "zabbix", "userData": true }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "userid": "1", "username": "Admin", "name": "Zabbix", "surname": "Administrator", "url": "", "autologin": "1", "autologout": "0", "lang": "ru_RU", "refresh": "0", "theme": "default", "attempt_failed": "0", "attempt_ip": "127.0.0.1", "attempt_clock": "1355919038", "rows_per_page": "50", "timezone": "Europe/Riga", "roleid": "3", "userdirectoryid": "0", "type": 3, "userip": "127.0.0.1", "debug_mode": 0, "gui_access": "0", "mfaid": "1", "deprovisioned": false, "auth_type": 0, "sessionid": "5b56eee8be445e98f0bd42b435736e42", "secret": "cd0ba923319741c6586f3d866423a8f4" }, "id": 1 } ``` #### درخواست اطلاعات کاربر احراز هویت شده. اطلاعات تکمیلی در مورد کاربر را احراز هویت کرده و برمیگرداند.[Request](/manual/api#performing-requests): ##### Response The response from Zabbix agent is processed by the library and returned as an `AgentResponse` object: ```python print(response) # { # "error": null, # "raw": "Linux zabbix_server 5.15.0-3.60.5.1.el9uek.x86_64", # "value": "Linux zabbix_server 5.15.0-3.60.5.1.el9uek.x86_64" # } print(response.value) # Linux zabbix_server 5.15.0-3.60.5.1.el9uek.x86_64 print(response.error) # None ``` پاسخی که از Zabbix agent دریافت میشود، توسط کتابخانه پردازش شده و به صورت یک شیء AgentResponse برگردانده میشود: python print(response) # { # "error": null, # "raw": "Linux zabbix_server 5.15.0-3.60.5.1.el9uek.x86_64", # "value": "Linux zabbix_server 5.15.0-3.60.5.1.el9uek.x86_64" # } print(response.value) # Linux zabbix_server 5.15.0-3.60.5.1.el9uek.x86_64 print(response.error) # None ##### Retention settings [History, trend, and audit log](/cloud/node_configuration#history-tab) retention periods can be configured only via the web interface in the cloud. These settings cannot be configured through `zabbix_server.conf` or the API. Manual per-item history overrides are not supported (partitioning is controlled globally). Cloud node URLs do not accept the same query parameters as an on-premise installations. ### تنظیمات نگهداری پیکربندی دورههای نگهداری لاگ [history, trends, and audit](/cloud/node_configuration#history-tab) فقط از طریق رابط کاربری ابری زبیکس در دسترس است. این تنظیمات را نمیتوان از طریق `zabbix_server.conf` یا API پیکربندی کرد. لغو دستی تاریخچه برای هر آیتم پشتیبانی نمیشود (پارتیشنبندی به صورت سراسری کنترل میشود). علاوه بر این، URL گره ابری همان پارامترهای پرسوجو را که در نصب در محل پذیرفته میشود، نمیپذیرد. #### Retrieve alerts by action ID Retrieve all alerts generated by action "3". [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "alert.get", "params": { "output": "extend", "actionids": "3" }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "alertid": "1", "actionid": "3", "eventid": "21243", "userid": "1", "clock": "1362128008", "mediatypeid": "1", "sendto": "support@company.com", "subject": "PROBLEM: Zabbix agent on Linux server is unreachable for 5 minutes: ", "message": "Trigger: Zabbix agent on Linux server is unreachable for 5 minutes: \nTrigger status: PROBLEM\nTrigger severity: Not classified", "status": "0", "retries": "3", "error": "", "esc_step": "1", "alerttype": "0", "p_eventid": "0", "acknowledgeid": "0" } ], "id": 1 } ``` #### هشدارها را با شناسه اقدام بازیابی کنید همه هشدارهای ایجاد شده توسط عمل "3" را بازیابی کنید. درخواست: ``json { "jsonrpc": "2.0"، "روش": "alert.get"، "params": { "output": "extend" "actionids": "3" }، "auth": "038e1d7b1735c6a5436ee9eae095879e"، "id": 1 } ``` واکنش: ``json { "jsonrpc": "2.0"، "نتیجه": [ { "هشدار": "1"، "actionid": "3"، "eventid": "21243", "userid": "1"، "ساعت": "1362128008", "mediatypeid": "1"، "sendto": "support@company.com"، "subject": "مشکل: عامل Zabbix در سرور لینوکس به مدت 5 دقیقه غیر قابل دسترس است: "، "پیام": "تریگر: عامل Zabbix در سرور لینوکس به مدت 5 دقیقه غیرقابل دسترسی است: \nوضعیت ماشه: مشکل\nشدت محرک: طبقه بندی نشده است" "وضعیت": "0"، "تکرار مجدد": "3"، "خطا": ""، "esc_step": "1"، "نوع هشدار": "0"، "p_eventid": "0"، "acknowlgeid": "0" } ]، "id": 1 } ``` #### Retrieving all connectors Retrieve all data about all connectors and their properties. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "connector.get", "params": { "output": "extend", "selectTags": ["tag", "operator", "value"], "preservekeys": true }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "connectorid": "1", "name": "Export of item values", "protocol": "0", "data_type": "0", "url": "{$DATA_EXPORT_VALUES_URL}", "item_value_type": "31", "authtype": "4", "username": "{$DATA_EXPORT_VALUES_USERNAME}", "password": "{$DATA_EXPORT_VALUES_PASSWORD}", "token": "", "max_records": "0", "max_senders": "4", "max_attempts": "2", "attempt_interval": "10s", "timeout": "10s", "http_proxy": "{$DATA_EXPORT_VALUES_PROXY}", "verify_peer": "1", "verify_host": "1", "ssl_cert_file": "{$DATA_EXPORT_VALUES_SSL_CERT_FILE}", "ssl_key_file": "{$DATA_EXPORT_VALUES_SSL_KEY_FILE}", "ssl_key_password": "", "description": "", "status": "1", "tags_evaltype": "0", "tags": [ { "tag": "component", "operator": "0", "value": "memory" } ] }, { "connectorid": "2", "name": "Export of events", "protocol": "0", "data_type": "1", "url": "{$DATA_EXPORT_EVENTS_URL}", "item_value_type": "31", "authtype": "5", "username": "", "password": "", "token": "{$DATA_EXPORT_EVENTS_BEARER_TOKEN}", "max_records": "0", "max_senders": "2", "max_attempts": "1", "attempt_interval": "5s", "timeout": "5s", "http_proxy": "", "verify_peer": "1", "verify_host": "1", "ssl_cert_file": "", "ssl_key_file": "", "ssl_key_password": "", "description": "", "status": "1", "tags_evaltype": "0", "tags": [ { "tag": "scope", "operator": "0", "value": "performance" } ] } ], "id": 1 } ``` #### Retrieving all connectors Retrieve all data about all connectors and their properties. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "connector.get", "params": { "output": "extend", "selectTags": ["tag", "operator", "value"], "preservekeys": true }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "connectorid": "1", "name": "Export of item values", "protocol": "0", "data_type": "0", "url": "{$DATA_EXPORT_VALUES_URL}", "max_records": "0", "max_senders": "4", "max_attempts": "2", "timeout": "10s", "http_proxy": "{$DATA_EXPORT_VALUES_PROXY}", "authtype": "4", "username": "{$DATA_EXPORT_VALUES_USERNAME}", "password": "{$DATA_EXPORT_VALUES_PASSWORD}", "token": "", "verify_peer": "1", "verify_host": "1", "ssl_cert_file": "{$DATA_EXPORT_VALUES_SSL_CERT_FILE}", "ssl_key_file": "{$DATA_EXPORT_VALUES_SSL_KEY_FILE}", "ssl_key_password": "", "description": "", "status": "1", "tags_evaltype": "0", "tags": [ { "tag": "component", "operator": "0", "value": "memory" } ] }, { "connectorid": "2", "name": "Export of events", "protocol": "0", "data_type": "1", "url": "{$DATA_EXPORT_EVENTS_URL}", "max_records": "0", "max_senders": "2", "max_attempts": "2", "timeout": "5s", "http_proxy": "", "authtype": "5", "username": "", "password": "", "token": "{$DATA_EXPORT_EVENTS_BEARER_TOKEN}", "verify_peer": "1", "verify_host": "1", "ssl_cert_file": "", "ssl_key_file": "", "ssl_key_password": "", "description": "", "status": "1", "tags_evaltype": "0", "tags": [ { "tag": "scope", "operator": "0", "value": "performance" } ] } ], "id": 1 } ``` #### Retrieving item prototypes from an LLD rule Retrieve all item prototypes for specific LLD rule ID. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "itemprototype.get", "params": { "output": "extend", "discoveryids": "27426" }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "itemid": "23077", "type": "0", "snmp_oid": "", "hostid": "10079", "name": "Incoming network traffic on en0", "key_": "net.if.in[en0]", "delay": "1m", "history": "1w", "trends": "365d", "status": "0", "value_type": "3", "trapper_hosts": "", "units": "bps", "logtimefmt": "", "templateid": "0", "valuemapid": "0", "params": "", "ipmi_sensor": "", "authtype": "0", "username": "", "password": "", "publickey": "", "privatekey": "", "flags": "2", "interfaceid": "0", "description": "", "evaltype": "0", "jmx_endpoint": "", "master_itemid": "0", "timeout": "", "url": "", "query_fields": [], "posts": "", "status_codes": "200", "follow_redirects": "1", "post_type": "0", "http_proxy": "", "headers": [], "retrieve_mode": "0", "request_method": "0", "output_format": "0", "ssl_cert_file": "", "ssl_key_file": "", "ssl_key_password": "", "verify_peer": "0", "verify_host": "0", "allow_traps": "0", "discover": "0", "uuid": "", "parameters": [] }, { "itemid": "10010", "type": "0", "snmp_oid": "", "hostid": "10001", "name": "Processor load (1 min average per core)", "key_": "system.cpu.load[percpu,avg1]", "delay": "1m", "history": "1w", "trends": "365d", "status": "0", "value_type": "0", "trapper_hosts": "", "units": "", "logtimefmt": "", "templateid": "0", "valuemapid": "0", "params": "", "ipmi_sensor": "", "authtype": "0", "username": "", "password": "", "publickey": "", "privatekey": "", "flags": "2", "interfaceid": "0", "description": "The processor load is calculated as system CPU load divided by number of CPU cores.", "evaltype": "0", "jmx_endpoint": "", "master_itemid": "0", "timeout": "", "url": "", "query_fields": [], "posts": "", "status_codes": "200", "follow_redirects": "1", "post_type": "0", "http_proxy": "", "headers": [], "retrieve_mode": "0", "request_method": "0", "output_format": "0", "ssl_cert_file": "", "ssl_key_file": "", "ssl_key_password": "", "verify_peer": "0", "verify_host": "0", "allow_traps": "0", "discover": "0", "uuid": "", "parameters": [] } ], "id": 1 } ``` #### بازیابی نمونههای اولیه آیتم از یک قانون LLD بازیابی تمام نمونههای اولیه آیتم برای شناسه قانون LLD خاص.[Request](/manual/api#performing-requests): ### Return values `(array)` Returns an array with changes in configuration, that will be made. ### مقادیر را برمی گرداند `(آرایه)` یک آرایه را با تغییراتی در پیکربندی ساخته شده است را برمی گرداند ### Return values `(boolean )` Returns boolean true as result on successful update. ### مقادیر را برمی گرداند «(بولین)» در بهروزرسانی موفقیتآمیز، بولین واقعی را برمیگرداند. ### Return values `(boolean)` Returns `true` if importing has been successful. ### مقادیر را برمی گرداند «(بولین)» اگر وارد کردن موفقیت آمیز باشد، «درست» را برمیگرداند. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### بازگشت مقادیر «(عدد صحیح/آرایه)» یکی را برمیگرداند: - آرایه ای از اشیاء؛ - تعداد اشیاء بازیابی شده، اگر پارامتر "countOutput" داشته باشد استفاده شده است. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### بازگشت مقادیر «(عدد صحیح/آرایه)» یکی را برمیگرداند: - آرایه ای از اشیاء؛ - تعداد اشیاء بازیابی شده، اگر پارامتر "countOutput" داشته باشد استفاده شده است. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### بازگشت مقادیر «(عدد صحیح/آرایه)» یکی را برمیگرداند: - آرایه ای از اشیاء؛ - تعداد اشیاء بازیابی شده، اگر پارامتر "countOutput" داشته باشد استفاده شده است. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### بازگشت مقادیر «(عدد صحیح/آرایه)» یکی را برمیگرداند: - آرایه ای از اشیاء؛ - تعداد اشیاء بازیابی شده، اگر پارامتر "countOutput" داشته باشد استفاده شده است. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### بازگشت مقادیر «(عدد صحیح/آرایه)» یکی را برمیگرداند: - آرایه ای از اشیاء؛ - تعداد اشیاء بازیابی شده، اگر پارامتر "countOutput" داشته باشد استفاده شده است. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### بازگشت مقادیر «(عدد صحیح/آرایه)» یکی را برمیگرداند: - آرایه ای از اشیاء؛ - تعداد اشیاء بازیابی شده، اگر پارامتر "countOutput" داشته باشد استفاده شده است. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ###بازگشت مقادیر `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### بازگشت مقادیر «(عدد صحیح/آرایه)» یکی را برمیگرداند: - آرایه ای از اشیاء؛ - تعداد اشیاء بازیابی شده، اگر پارامتر "countOutput" داشته باشد استفاده شده است. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### بازگشت مقادیر «(عدد صحیح/آرایه)» یکی را برمیگرداند: - آرایه ای از اشیاء؛ - تعداد اشیاء بازیابی شده، اگر پارامتر "countOutput" داشته باشد استفاده شده است. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### بازگشت مقادیر «(عدد صحیح/آرایه)» یکی را برمیگرداند: - آرایه ای از اشیاء؛ - تعداد اشیاء بازیابی شده، اگر پارامتر "countOutput" داشته باشد استفاده شده است. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### بازگشت مقادیر «(عدد صحیح/آرایه)» یکی را برمیگرداند: - آرایه ای از اشیاء؛ - تعداد اشیاء بازیابی شده، اگر پارامتر "countOutput" داشته باشد استفاده شده است. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### بازگشت مقادیر «(عدد صحیح/آرایه)» یکی را برمیگرداند: - آرایه ای از اشیاء؛ - تعداد اشیاء بازیابی شده، اگر پارامتر "countOutput" داشته باشد استفاده شده است. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### بازگشت مقادیر «(عدد صحیح/آرایه)» یکی را برمیگرداند: - آرایه ای از اشیاء؛ - تعداد اشیاء بازیابی شده، اگر پارامتر "countOutput" داشته باشد استفاده شده است. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### بازگشت مقادیر «(عدد صحیح/آرایه)» یکی را برمیگرداند: - آرایه ای از اشیاء؛ - تعداد اشیاء بازیابی شده، اگر پارامتر "countOutput" داشته باشد استفاده شده است. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### بازگشت مقادیر «(عدد صحیح/آرایه)» یکی را برمیگرداند: - آرایه ای از اشیاء؛ - تعداد اشیاء بازیابی شده، اگر پارامتر "countOutput" داشته باشد استفاده شده است. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### بازگشت مقادیر «(عدد صحیح/آرایه)» یکی را برمیگرداند: - آرایه ای از اشیاء؛ - تعداد اشیاء بازیابی شده، اگر پارامتر "countOutput" داشته باشد استفاده شده است. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### بازگشت مقادیر «(عدد صحیح/آرایه)» یکی را برمیگرداند: - آرایه ای از اشیاء؛ - تعداد اشیاء بازیابی شده، اگر پارامتر "countOutput" داشته باشد استفاده شده است. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### بازگشت مقادیر «(عدد صحیح/آرایه)» یکی را برمیگرداند: - آرایه ای از اشیاء؛ - تعداد اشیاء بازیابی شده، اگر پارامتر "countOutput" داشته باشد استفاده شده است. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### بازگشت مقادیر «(عدد صحیح/آرایه)» یکی را برمیگرداند: - آرایه ای از اشیاء؛ - تعداد اشیاء بازیابی شده، اگر پارامتر "countOutput" داشته باشد استفاده شده است. ### Return values `(integer/array)` Returns either: - an array of objects; - the count of retrieved objects, if the `countOutput` parameter has been used. ### بازگشت مقادیر «(عدد صحیح/آرایه)» یکی را برمیگرداند: - آرایه ای از اشیاء؛ - تعداد اشیاء بازیابی شده، اگر پارامتر "countOutput" داشته باشد استفاده شده است. ### Return values `(object)` Returns an object containing the IDs of the cleared items under the `itemids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the cleared items under the `itemids` property. ### Return values `(object)` Returns an object containing the IDs of the created actions under the `actionids` property. The order of the returned IDs matches the order of the passed actions. ### برگشت مقادیر `(object)` یک شی حاوی شناسه اقدامات ایجاد شده را تحت خاصیت «شناسه اکشن » برمی گرداند . ترتیب شناسه های برگشتی با ترتیب اقدامات انجام شده مطابقت دارد ### Return values `(object)` Returns an object containing the IDs of the created connectors under the `connectorids` property. The order of the returned IDs matches the order of the passed connectors. ### مقادیر برگشتی `(object)` یک شیء حاوی شناسههای کانکتورهای ایجاد شده تحت ویژگی `connectorids` را برمیگرداند. ترتیب شناسههای برگشتی با ترتیب کانکتورهای ارسالی مطابقت دارد. ### Return values `(object)` Returns an object containing the IDs of the created correlations under the `correlationids` property. The order of the returned IDs matches the order of the passed correlations. ### مقادیر را برمی گرداند `(object)` یک شی حاوی شناسه های اسکریپت های ایجاد شده را تحت ویژگی "scriptids" برمی گرداند. ترتیب شناسه های برگشتی با ترتیب اسکریپت های پاس شده مطابقت دارد ### Return values `(object)` Returns an object containing the IDs of the created dashboards under the `dashboardids` property. The order of the returned IDs matches the order of the passed dashboards. ### برگشت مقادیر `(object)` یک شی حاوی شناسه اقدامات ایجاد شده را تحت خاصیت «شناسه اکشن » برمی گرداند . ترتیب شناسه های برگشتی با ترتیب اقدامات انجام شده مطابقت دارد ### Return values `(object)` Returns an object containing the IDs of the created discovery rules under the `druleids` property. The order of the returned IDs matches the order of the passed discovery rules. ### برگشت مقادیر `(object)` یک شی حاوی شناسه اقدامات ایجاد شده را تحت خاصیت «شناسه اکشن » برمی گرداند . ترتیب شناسه های برگشتی با ترتیب اقدامات انجام شده مطابقت دارد ### Return values `(object)` Returns an object containing the IDs of the created graph prototypes under the `graphids` property. The order of the returned IDs matches the order of the passed graph prototypes. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the created graph prototypes under the `graphids` property. The order of the returned IDs matches the order of the passed graph prototypes. ### Return values `(object)` Returns an object containing the IDs of the created graphs under the `graphids` property. The order of the returned IDs matches the order of the passed graphs. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the created graphs under the `graphids` property. The order of the returned IDs matches the order of the passed graphs. ### Return values `(object)` Returns an object containing the IDs of the created host groups under the `groupids` property. The order of the returned IDs matches the order of the passed host groups. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the created hosts under the `hostids` property. The order of the returned IDs matches the order of the passed hosts. ### Return values `(object)` Returns an object containing the IDs of the created host interfaces under the `interfaceids` property. ###بازگشت مقادیر `(object)` Returns an object containing the IDs of the created host interfaces under the `interfaceids` property. ### Return values `(object)` Returns an object containing the IDs of the created host interfaces under the `interfaceids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the created host interfaces under the `interfaceids` property. ### Return values `(object)` Returns an object containing the IDs of the created host interfaces under the `interfaceids` property. The order of the returned IDs matches the order of the passed host interfaces. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the created host interfaces under the `interfaceids` property. The order of the returned IDs matches the order of the passed host interfaces. ### Return values `(object)` Returns an object containing the IDs of the created host prototypes under the `hostids` property. The order of the returned IDs matches the order of the passed host prototypes. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the created host prototypes under the `hostids` property. The order of the returned IDs matches the order of the passed host prototypes. ### Return values `(object)` Returns an object containing the IDs of the created hosts under the `hostids` property. The order of the returned IDs matches the order of the passed hosts. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the created hosts under the `hostids` property. The order of the returned IDs matches the order of the passed hosts. ### Return values `(object)` Returns an object containing the IDs of the created icon maps under the `iconmapids` property. The order of the returned IDs matches the order of the passed icon maps. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the created icon maps under the `iconmapids` property. The order of the returned IDs matches the order of the passed icon maps. ### Return values `(object)` Returns an object containing the IDs of the created images under the `imageids` property. The order of the returned IDs matches the order of the passed images. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the created images under the `imageids` property. The order of the returned IDs matches the order of the passed images. ### Return values `(object)` Returns an object containing the IDs of the created LLD rules under the `itemids` property. The order of the returned IDs matches the order of the passed LLD rules. ### برگشت مقادیر `(object)` یک شی حاوی شناسه اقدامات ایجاد شده را تحت خاصیت «شناسه اکشن » برمی گرداند . ترتیب شناسه های برگشتی با ترتیب اقدامات انجام شده مطابقت دارد ### Return values `(object)` Returns an object containing the IDs of the created maps under the `sysmapids` property. The order of the returned IDs matches the order of the passed maps. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the created icon maps under the `iconmapids` property. The order of the returned IDs matches the order of the passed icon maps. ### Return values `(object)` Returns an object containing the IDs of the created scripts under the `scriptids` property. The order of the returned IDs matches the order of the passed scripts. ### مقادیر را برمی گرداند `(object)` یک شی حاوی شناسه های اسکریپت های ایجاد شده را تحت ویژگی "scriptids" برمی گرداند. ترتیب شناسه های برگشتی با ترتیب اسکریپت های پاس شده مطابقت دارد ### Return values `(object)` Returns an object containing the IDs of the created templates under the `templateids` property. The order of the returned IDs matches the order of the passed templates. ### برگشت مقادیر `(object)` یک شی حاوی شناسه اقدامات ایجاد شده را تحت خاصیت «شناسه اکشن » برمی گرداند . ترتیب شناسه های برگشتی با ترتیب اقدامات انجام شده مطابقت دارد ### Return values `(object)` Returns an object containing the IDs of the created web scenarios under the `httptestids` property. The order of the returned IDs matches the order of the passed web scenarios. ###بازگشت مقادیر `(object)` Returns an object containing the IDs of the created web scenarios under the `httptestids` property. The order of the returned IDs matches the order of the passed web scenarios. ### Return values `(object)` Returns an object containing the IDs of the deleted actions under the `actionids` property. ### بازگشت مقادیر `(object)` یک شی حاوی شناسه تحت خاصیت «actionids». اقدامات حذف شده را برمی گرداند ### Return values `(object)` Returns an object containing the IDs of the deleted connectors under the `connectorids` property. ### مقادیر برگشتی `(object)` یک شیء حاوی شناسههای کانکتورهای حذف شده را تحت ویژگی `connectorids` برمیگرداند. ### Return values `(object)` Returns an object containing the IDs of the deleted correlations under the `correlationids` property. ### بازگشت مقادیر `(object)` یک شی حاوی شناسه های حذف شده را برمی گرداند همبستگی تحت خاصیت "correlationids". ### Return values `(object)` Returns an object containing the IDs of the deleted dashboards under the `dashboardids` property. ### بازگشت مقادیر `(object)` یک شی حاوی شناسه های به روز شده را تحت خاصیت "dashboardids" برمی گرداند ### Return values `(object)` Returns an object containing the IDs of the deleted discovery rules under the `druleids` property. ### بازگشت مقادیر `(object)` یک شی حاوی شناسه تحت خاصیت «actionids». اقدامات حذف شده را برمی گرداند ### Return values `(object)` Returns an object containing the IDs of the deleted graph prototypes under the `graphids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the deleted graph prototypes under the `graphids` property. ### Return values `(object)` Returns an object containing the IDs of the deleted graphs under the `graphids` property. ###بازگشت مقادیر `(object)` Returns an object containing the IDs of the deleted graphs under the `graphids` property. ### Return values `(object)` Returns an object containing the IDs of the deleted host groups under the `groupids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the deleted host groups under the `groupids` property. ### Return values `(object)` Returns an object containing the IDs of the deleted host interfaces under the `interfaceids` property. ###بازگشت مقادیر `(object)` Returns an object containing the IDs of the deleted host interfaces under the `interfaceids` property. ### Return values `(object)` Returns an object containing the IDs of the deleted host interfaces under the `interfaceids` property. ###بازگشت مقادیر `(object)` Returns an object containing the IDs of the deleted host interfaces under the `interfaceids` property. ### Return values `(object)` Returns an object containing the IDs of the deleted host prototypes under the `hostids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the deleted host prototypes under the `hostids` property. ### Return values `(object)` Returns an object containing the IDs of the deleted hosts under the `hostids` property. ###بازگشت مقادیر `(object)` Returns an object containing the IDs of the deleted hosts under the `hostids` property. ### Return values `(object)` Returns an object containing the IDs of the deleted icon maps under the `iconmapids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the deleted icon maps under the `iconmapids` property. ### Return values `(object)` Returns an object containing the IDs of the deleted web scenarios under the `httptestids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the deleted web scenarios under the `httptestids` property. ### Return values `(object)` Returns an object containing the IDs of the updated actions under the `actionids` property. ### بازگشت مقادیر `(object)` یک شی حاوی شناسه اقدامات به روز شده را برمی گرداند تحت خاصیت «اکشنیدز». ### Return values `(object)` Returns an object containing the IDs of the updated connectors under the `connectorids` property. ### مقادیر برگشتی `(object)` یک شیء حاوی شناسههای کانکتورهای حذف شده را تحت ویژگی `connectorids` برمیگرداند. ### Return values `(object)` Returns an object containing the IDs of the updated correlations under the `correlationids` property. ### بازگشت مقادیر `(object)` یک شی حاوی شناسه های به روز شده را برمی گرداند همبستگی تحت خاصیت "correlationids". ### Return values `(object)` Returns an object containing the IDs of the updated dashboards under the `dashboardids` property. ### بازگشت مقادیر `(object)` یک شی حاوی شناسه های به روز شده را برمی گرداند همبستگی تحت خاصیت "correlationids". ### Return values `(object)` Returns an object containing the IDs of the updated discovery rules under the `druleids` property. ### بازگشت مقادیر `(object)` یک شی حاوی شناسه تحت خاصیت «actionids». اقدامات حذف شده را برمی گرداند ### Return values `(object)` Returns an object containing the IDs of the updated graph prototypes under the `graphids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the updated graph prototypes under the `graphids` property. ### Return values `(object)` Returns an object containing the IDs of the updated graphs under the `graphids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the updated graphs under the `graphids` property. ### Return values `(object)` Returns an object containing the IDs of the updated host groups under the `groupids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the updated host groups under the `groupids` property. ### Return values `(object)` Returns an object containing the IDs of the updated host groups under the `groupids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the updated host groups under the `groupids` property. ### Return values `(object)` Returns an object containing the IDs of the updated host groups under the `groupids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the updated host groups under the `groupids` property. ### Return values `(object)` Returns an object containing the IDs of the updated host groups under the `groupids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the updated host groups under the `groupids` property. ### Return values `(object)` Returns an object containing the IDs of the updated host interfaces under the `interfaceids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the updated host interfaces under the `interfaceids` property. ### Return values `(object)` Returns an object containing the IDs of the updated host prototypes under the `hostids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the updated host prototypes under the `hostids` property. ### Return values `(object)` Returns an object containing the IDs of the updated hosts under the `hostids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the updated hosts under the `hostids` property. ### Return values `(object)` Returns an object containing the IDs of the updated hosts under the `hostids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the updated hosts under the `hostids` property. ### Return values `(object)` Returns an object containing the IDs of the updated hosts under the `hostids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the updated hosts under the `hostids` property. ### Return values `(object)` Returns an object containing the IDs of the updated hosts under the `hostids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the updated hosts under the `hostids` property. ### Return values `(object)` Returns an object containing the IDs of the updated icon maps under the `iconmapids` property. ### مقادیر را برمی گرداند `(object)` یک شی حاوی شناسه آیکون نقشه های به روز شده را برمی گرداند که تحت ویژگی "iconmapids" می باشد . ### Return values `(object)` Returns an object containing the IDs of the updated item prototypes under the `itemids` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the updated host prototypes under the `hostids` property. ### Return values `(object)` Returns an object containing the IDs of the updated LLD rules under the `itemids` property. ### بازگشت مقادیر `(object)` یک شی حاوی شناسه تحت خاصیت «actionids». اقدامات حذف شده را برمی گرداند ### Return values `(object)` Returns an object containing the IDs of the updated web scenarios under the `httptestid` property. ### بازگشت مقادیر `(object)` Returns an object containing the IDs of the updated web scenarios under the `httptestid` property. ### Return values `(object)` Returns authentication object. ### مقادیر را برمی گرداند `(object)` شیء احراز هویت را برمی گرداند. ### Return values `(object)` Returns autoregistration object. ### مقادیر را برمی گرداند `(object)` شیء احراز هویت را برمی گرداند. ### Return values `(object)` Returns housekeeping object. ###بازگشت مقادیر `(object)` Returns housekeeping object. ### Return values `(string)` Returns a serialized string containing the requested configuration data. ### بازگشت مقادیر `(string)` یک رشته سریالی حاوی موارد درخواستی را برمی گرداند داده های پیکربندی ### Return values `(string)` Returns the version of the Zabbix API. ::: notetip Starting from Zabbix 2.0.4 the version of the API matches the version of Zabbix. ::: ### بازگشت مقادیر `(string)` نسخه Zabbix API را برمی گرداند. ::: یادداشت شروع از Zabbix 2.0.4 نسخه API با نسخه Zabbix مطابقت دارد. ::: ##### Right trim {#rtrim} Remove specified characters from the end of the value. تریم از راست #### Running proxy #### پروکسی در حال اجرا ##### SAML certificate upload [SAML authentication](/manual/web_interface/frontend_sections/users/authentication/saml) is not supported because few providers accept unencrypted or unsigned SAML messages. ### آپلود گواهی SAML [احراز هویت SAML](/manual/web_interface/frontend_sections/users/authentication/saml) پشتیبانی میشود، اما آپلود گواهی سفارشی یا فایل فراداده در حال حاضر در دسترس نیست. #### Scenario items As soon as a scenario is created, Zabbix automatically adds the following items for monitoring. |Item|Description| |----|-----------| |*Download speed for scenario <Scenario>*|This item will collect information about the download speed (bytes per second) of the whole scenario, i.e. average for all steps.<br>Item key: web.test.in\[Scenario,,bps\]<br>Type: *Numeric(float)*| |*Failed step of scenario <Scenario>*|This item will display the number of the step that failed on the scenario. If all steps are executed successfully, 0 is returned.<br>Item key: web.test.fail\[Scenario\]<br>Type: *Numeric(unsigned)*| |*Last error message of scenario <Scenario>*|This item returns the last error message text of the scenario. A new value is stored only if the scenario has a failed step. If all steps are ok, no new value is collected.<br>Item key: web.test.error\[Scenario\]<br>Type: *Character*| The actual scenario name will be used instead of "Scenario". ::: noteclassic If the scenario name contains [user macros](/manual/config/macros/user_macros), these macros will be left unresolved in web monitoring item names. <br><br> If the scenario name starts with a doublequote or contains a comma or a square bracket, it will be properly quoted in item keys. In other cases no additional quoting will be performed. ::: ::: noteclassic Web monitoring items are added with a 30 day history and a 90 day trend retention period. ::: These items can be used to create triggers and define notification conditions. #### آیتمهای سناریو به محض ایجاد یک سناریو، زبیکس به طور خودکار آیتمهای زیر را برای نظارت اضافه میکند. |مورد|توضیحات| |----|-----------| |*سرعت دانلود برای سناریو <سناریو>*|این آیتم اطلاعاتی در مورد سرعت دانلود (بایت در ثانیه) کل سناریو، یعنی میانگین همه مراحل، جمعآوری میکند.<br>کلید مورد: web.test.in\[سناریو,,bps\]<br>نوع: *عددی(float)*| |*مرحله ناموفق سناریو <سناریو>*|این آیتم شماره مرحلهای را که در سناریو شکست خورده است نمایش میدهد. اگر همه مراحل با موفقیت اجرا شوند، 0 برگردانده میشود.<br>کلید مورد: web.test.fail\[سناریو\]<br>نوع: *عددی(unsigned)*| |*آخرین پیام خطای سناریو <Scenario>*|این مورد آخرین متن پیام خطای سناریو را برمیگرداند. مقدار جدید فقط در صورتی ذخیره میشود که سناریو یک مرحله ناموفق داشته باشد. اگر همه مراحل درست باشند، هیچ مقدار جدیدی جمعآوری نمیشود.<br>کلید مورد: web.test.error\[Scenario\]<br>نوع: *کاراکتر*| نام واقعی سناریو به جای "Scenario" استفاده خواهد شد. ::: noteclassic اگر نام سناریو شامل [ماکروهای کاربر](/manual/config/macros/user_macros) باشد، این ماکروها در نام آیتمهای مانیتورینگ وب حل نشده باقی میمانند. <br><br> اگر نام سناریو با دابل کوتیشن شروع شود یا حاوی کاما یا براکت باشد، به درستی در کلیدهای آیتم نقل قول میشود. در موارد دیگر، هیچ نقل قول اضافی انجام نخواهد شد. :::: noteclassic آیتمهای مانیتورینگ وب با سابقه 30 روزه و دوره نگهداری روند 90 روزه اضافه میشوند. ::: این موارد میتوانند برای ایجاد محرکها و تعریف شرایط اعلان استفاده شوند. #### Scenario step items As soon as a step is created, Zabbix automatically adds the following items for monitoring. |Item|Description| |----|-----------| |*Download speed for step <Step> of scenario <Scenario>*|This item will collect information about the download speed (bytes per second) of the step.<br>Item key: web.test.in\[Scenario,Step,bps\]<br>Type: *Numeric(float)*| |*Response time for step <Step> of scenario <Scenario>*|This item will collect information about the response time of the step in seconds. Response time is counted from the beginning of the request until all information has been transferred.<br>Item key: web.test.time\[Scenario,Step,resp\]<br>Type: *Numeric(float)*| |*Response code for step <Step> of scenario <Scenario>*|This item will collect response codes of the step.<br>Item key: web.test.rspcode\[Scenario,Step\]<br>Type: *Numeric(unsigned)*| Actual scenario and step names will be used instead of "Scenario" and "Step" respectively. ::: noteclassic Web monitoring items are added with a 30 day history and a 90 day trend retention period. ::: ::: noteclassic If scenario name starts with a doublequote or contains comma or square bracket, it will be properly quoted in item keys. In other cases no additional quoting will be performed. ::: These items can be used to create triggers and define notification conditions. For example, to create a "Zabbix GUI login is too slow" trigger, you can define a trigger expression: last(/zabbix/web.test.time[ZABBIX GUI,Login,resp])>3 #### آیتمهای مرحله سناریو به محض ایجاد یک مرحله، زبیکس به طور خودکار موارد زیر را برای نظارت اضافه میکند. |مورد|توضیحات| |----|-----------| |*سرعت دانلود برای مرحله <مرحله> از سناریو <سناریو>*|این مورد اطلاعاتی در مورد سرعت دانلود (بایت در ثانیه) مرحله جمعآوری میکند.<br>کلید مورد: web.test.in\[سناریو،مرحله،bps\]<br>نوع: *عددی(float)*| |*زمان پاسخ برای مرحله <مرحله> از سناریو <سناریو>*|این مورد اطلاعاتی در مورد زمان پاسخ مرحله بر حسب ثانیه جمعآوری میکند. زمان پاسخ از ابتدای درخواست تا زمانی که تمام اطلاعات منتقل شوند، محاسبه میشود.<br>کلید مورد: web.test.time\[سناریو،مرحله،resp\]<br>نوع: *عددی(float)*| |*کد پاسخ برای مرحله <Step> از سناریو <Scenario>*|این مورد کدهای پاسخ مرحله را جمعآوری میکند.<br>کلید مورد: web.test.rspcode\[Scenario,Step\]<br>نوع: *Numeric(unsigned)*| به جای "Scenario" و "Step" به ترتیب از نامهای واقعی سناریو و مرحله استفاده خواهد شد. ::: noteclassic موارد نظارت بر وب با سابقه 30 روزه و دوره نگهداری روند 90 روزه اضافه میشوند. :: ::: noteclassic اگر نام سناریو با دابل کوتیشن شروع شود یا حاوی کاما یا براکت باشد، به درستی در کلیدهای مورد نقل قول میشود. در موارد دیگر، هیچ نقل قول اضافی انجام نخواهد شد. :: این موارد میتوانند برای ایجاد محرکها و تعریف شرایط اعلان استفاده شوند. برای مثال، برای ایجاد یک تریگر "ورود به رابط کاربری گرافیکی زبیکس خیلی کند است"، میتوانید یک عبارت تریگر تعریف کنید: last(/zabbix/web.test.time[ZABBIX GUI,Login,resp])>3 ##### Scheduled reports The default *Cloud Email* media type uses a script transport and cannot be used for [scheduled reports](/manual/web_interface/frontend_sections/reports/scheduled). To send reports by email: 1. Create a new Email media type. 2. Assign the email media to your user in *User settings > Media*. 3. Select that media type when configuring scheduled reports. ### گزارشهای زمانبندیشده نوع رسانه پیشفرض ایمیل ابری از یک اسکریپت انتقال استفاده میکند و نمیتوان از آن برای [گزارشهای زمانبندیشده](/manual/web_interface/frontend_sections/reports/scheduled) استفاده کرد. برای ارسال گزارشها از طریق ایمیل: ۱. یک نوع رسانه ایمیل جدید ایجاد کنید. ۲. رسانه ایمیل را در *تنظیمات کاربر > رسانه* به کاربر خود اختصاص دهید. ۳. هنگام پیکربندی گزارشهای زمانبندیشده، آن نوع رسانه را انتخاب کنید. # script.create #ساخت اسکریپت #### Scripts Configure and execute scripts to help you with your daily tasks. [Script API](/manual/api/reference/script) #### اسکریپتها اسکریپتها را پیکربندی و اجرا کنید تا در انجام کارهای روزانه به شما کمک کنند.[API اسکریپت](/manual/api/reference/script) **Script** The following additional elements are exported only for the *Script* media type. |Element|<|Type|Description| |-|---|---|-----------------------| |script name|<|string|(required) Script name.| |parameters|<| |Root element for script parameters.| |<|sortorder|string|(required) Order of the script parameters passed to the script as command-line arguments.| |^|value|string|Script parameter value.| ::: noteclassic See also: [Media type object](/manual/api/reference/mediatype/object) (refer to the relevant property with a matching name). ::: **اسکریپت** عناصر اضافی زیر فقط برای نوع رسانه *اسکریپت* صادر میشوند. |عنصر|<|نوع|توضیحات| |-|---|---|---------------------| |نام اسکریپت|<|رشته|(الزامی) نام اسکریپت.| |پارامترها|<| |عنصر ریشه برای پارامترهای اسکریپت.| |<|ترتیب مرتبسازی|رشته|(الزامی) ترتیب پارامترهای اسکریپت که به عنوان آرگومانهای خط فرمان به اسکریپت ارسال میشوند.| |^|مقدار|رشته|مقدار پارامتر اسکریپت.| ::: noteclassic همچنین ببینید: [شیء نوع رسانه](/manual/api/reference/mediatype/object) (به ویژگی مربوطه با نام منطبق مراجعه کنید). ::: ::: search-result-container ::: کانتینر بر اساس جست و جو ### See also - [Action filter](object#action-filter) - [Action operation](object#action-operation) - [Script](/manual/api/reference/script/object) ### همچنین ببینید - [Action filter](object#action_filter) - [عملیات عمل] (شیء#عمل_عملی) ### See also - [Audit log object](/manual/api/reference/auditlog/object) ### همچنین ببینید - [ابژه گزارش حسابرسی](/دستی/api/reference/auditlog/object) ### See also - [Dashboard widget field](/manual/api/reference/dashboard/object#dashboard-widget-field) - [`dashboard.create`](/manual/api/reference/dashboard/create) - [`dashboard.update`](/manual/api/reference/dashboard/update) ### همچنین ببینید - [فیلد ویجت داشبورد](/دستی/آپی/مرجع/داشبورد/شیء#فیلد-ویجت-داشبورد) - [`dashboard.create`](/manual/api/reference/dashboard/create) - [`dashboard.update`](/manual/api/reference/dashboard/update) ### See also - [Dashboard widget field](/manual/api/reference/dashboard/object#dashboard-widget-field) - [`dashboard.create`](/manual/api/reference/dashboard/create) - [`dashboard.update`](/manual/api/reference/dashboard/update) ### همچنین ببینید - [فیلد ویجت داشبورد](/دستی/آپی/مرجع/داشبورد/شیء#فیلد-ویجت-داشبورد) - [`dashboard.create`](/manual/api/reference/dashboard/create) - [`dashboard.update`](/manual/api/reference/dashboard/update) ### See also - [Dashboard widget field](/manual/api/reference/dashboard/object#dashboard-widget-field) - [`dashboard.create`](/manual/api/reference/dashboard/create) - [`dashboard.update`](/manual/api/reference/dashboard/update) ### همچنین ببینید - [فیلد ویجت داشبورد](/دستی/آپی/مرجع/داشبورد/شیء#فیلد-ویجت-داشبورد) - [`dashboard.create`](/manual/api/reference/dashboard/create) - [`dashboard.update`](/manual/api/reference/dashboard/update) ### See also - [Dashboard widget field](/manual/api/reference/dashboard/object#dashboard-widget-field) - [`dashboard.create`](/manual/api/reference/dashboard/create) - [`dashboard.update`](/manual/api/reference/dashboard/update) ### همچنین ببینید - [فیلد ویجت داشبورد](/دستی/آپی/مرجع/داشبورد/شیء#فیلد-ویجت-داشبورد) - [`dashboard.create`](/manual/api/reference/dashboard/create) - [`dashboard.update`](/manual/api/reference/dashboard/update) ### See also - [Dashboard widget field](/manual/api/reference/dashboard/object#dashboard-widget-field) - [`dashboard.create`](/manual/api/reference/dashboard/create) - [`dashboard.update`](/manual/api/reference/dashboard/update) ### همچنین ببینید - [فیلد ویجت داشبورد](/دستی/آپی/مرجع/داشبورد/شیء#فیلد-ویجت-داشبورد) - [`dashboard.create`](/manual/api/reference/dashboard/create) - [`dashboard.update`](/manual/api/reference/dashboard/update) ### See also - [Dashboard widget field](/manual/api/reference/dashboard/object#dashboard-widget-field) - [`dashboard.create`](/manual/api/reference/dashboard/create) - [`dashboard.update`](/manual/api/reference/dashboard/update) ### همچنین ببینید - [فیلد ویجت داشبورد](/دستی/آپی/مرجع/داشبورد/شیء#فیلد-ویجت-داشبورد) - [`dashboard.create`](/manual/api/reference/dashboard/create) - [`dashboard.update`](/manual/api/reference/dashboard/update) ### See also - [Dashboard widget field](/manual/api/reference/dashboard/object#dashboard-widget-field) - [`dashboard.create`](/manual/api/reference/dashboard/create) - [`dashboard.update`](/manual/api/reference/dashboard/update) ### همچنین ببینید - [فیلد ویجت داشبورد](/manual/api/reference/dashboard/object#dashboard-widget-field) - [`dashboard.create`](/manual/api/reference/dashboard/create) - [`dashboard.update`](/manual/api/reference/dashboard/update) ### See also - [Dashboard widget field](/manual/api/reference/dashboard/object#dashboard-widget-field) - [`dashboard.create`](/manual/api/reference/dashboard/create) - [`dashboard.update`](/manual/api/reference/dashboard/update) ### همچنین ببینید - [فیلد ویجت داشبورد](/دستی/آپی/مرجع/داشبورد/شیء#فیلد-ویجت-داشبورد) - [`dashboard.create`](/manual/api/reference/dashboard/create) - [`dashboard.update`](/manual/api/reference/dashboard/update) ### See also - [Graph](/manual/api/reference/graph/object#graph) ### همچنین ببینید - [Graph item](/manual/api/reference/graphitem/object#graph_item) ### See also - [hostinterface.create](create) - [host.massadd](/manual/api/reference/host/massadd) - [Host](/manual/api/reference/host/object#host) ### همچنین ببینید - [hostinterface.create](create) - [host.massadd](/manual/api/reference/host/massadd) - [Host](/manual/api/reference/host/object#host) ### See also - [hostinterface.delete](delete) - [host.massremove](/manual/api/reference/host/massremove) ### همچنین ببینید - [hostinterface.delete](delete) - [host.massremove](/manual/api/reference/host/massremove) ### See also - [hostinterface.massadd](massadd) - [host.massadd](/manual/api/reference/host/massadd) ### همچنین ببینید - [hostinterface.massadd](massadd) - [host.massadd](/manual/api/reference/host/massadd) ### See also - [hostinterface.massremove](massremove) - [host.massremove](/manual/api/reference/host/massremove) ### همچنین ببینید - [hostinterface.massremove](massremove) - [host.massremove](/manual/api/reference/host/massremove) ### See also - [Host](/manual/api/reference/host/object#host) - [Item](/manual/api/reference/item/object#item) ###همچنین ببینید - [Host](/manual/api/reference/host/object#host) - [Item](/manual/api/reference/item/object#item) ### See also - [host.update](/manual/api/reference/host/update) - [host.massupdate](/manual/api/reference/host/massupdate) ### همچنین ببینید - [host.update](/manual/api/reference/host/update) - [host.massupdate](/manual/api/reference/host/massupdate) ### See also - [host.update](update) - [host.massadd](massadd) - [host.massremove](massremove) - [Host group](/manual/api/reference/hostgroup/object#host_group) - [Template](/manual/api/reference/template/object#host_group) - [User macro](/manual/api/reference/usermacro/object#hosttemplate_level_macro) - [Host interface](/manual/api/reference/hostinterface/object#host_interface) ### همچنین ببینید - [host.update](update) - [host.massadd](massadd) - [host.massremove](massremove) - [Host group](/manual/api/reference/hostgroup/object#host_group) - [Template](/manual/api/reference/template/object#host_group) - [User macro](/manual/api/reference/usermacro/object#hosttemplate_level_macro) - [Host interface](/manual/api/reference/hostinterface/object#host_interface) ### See also - [user.logout](logout) همچنین ببنید **See also:** - [Zabbix Cloud FAQ](https://www.zabbix.com/cloud#faq) - additional information and answers to any remaining questions regarding Zabbix Cloud features, deployment, pricing, and support. **همچنین ببینید:** - [سوالات متداول Zabbix Cloud](https://www.zabbix.com/cloud#faq) - اطلاعات تکمیلی و پاسخ به هرگونه سوال باقی مانده در مورد ویژگی‌ها، استقرار، قیمت‌گذاری و پشتیبانی Zabbix Cloud. #### Service Level Agreement Define Service Level Objectives (SLO), retrieve detailed Service Level Indicators (SLI) information about service performance. [SLA API](/manual/api/reference/sla) #### توافقنامه سطح خدماتتعریف اهداف سطح خدمات (SLO)، بازیابی اطلاعات دقیق شاخصهای سطح خدمات (SLI) در مورد عملکرد خدمات.[SLA API](/manual/api/reference/sla) #### Services Manage services for service-level monitoring and retrieve detailed SLA information about any service. [Service API](/manual/api/reference/service) #### خدمات مدیریت خدمات برای نظارت بر سطح خدمات و بازیابی اطلاعات دقیق SLA در مورد هر سرویس.[API سرویس](/manual/api/reference/service) ## Services The Zabbix API allows you to access data gathered during service monitoring. ## سرویسها: رابط برنامهنویسی کاربردی زبیکس به شما امکان میدهد به دادههای جمعآوریشده در طول نظارت بر سرویس دسترسی داشته باشید. ## Set up and manage Zabbix Cloud تنظیم و مدیریت ابر Zabbix (Zabbix Cloud) ##### Simple change {#simplechange} Calculate the difference between the current and previous value. Comments: - This step can be useful to measure a constantly growing value;<br> - Evaluated as **value**-**prev\_value**, where *value* - the current value; *prev\_value* - the previously received value;<br> - Only one change operation per item ("Simple change" or "Change per second") is allowed; - If the current value is smaller than the previous value, Zabbix discards that difference (stores nothing) and waits for another value;<br> - If you mark the *Custom on fail* checkbox, it is possible to specify custom error-handling options: either to discard the value, set a specified value, or set a specified error message. In case of a failed preprocessing step, the item will not become unsupported if the option to discard the value or set a specified value is selected. ##### تغییر ساده {#simplechange}اختلاف بین مقدار فعلی و قبلی را محاسبه کنید. توضیحات:-این مرحله میتواند برای اندازهگیری مقداری که دائماً در حال رشد است مفید باشد؛<br>-به صورت **value**-**prev\_value** ارزیابی میشود، که در آن *value* - مقدار فعلی؛ *prev\_value* - مقدار دریافتی قبلی؛<br>-فقط یک عملیات تغییر برای هر آیتم ("تغییر ساده" یا "تغییر در ثانیه") مجاز است؛-اگر مقدار فعلی کوچکتر از مقدار قبلی باشد، زبیکس آن اختلاف را نادیده میگیرد (چیزی ذخیره نمیکند) و منتظر مقدار دیگری میماند؛<br>-اگر کادر *Custom on fail* را علامت بزنید، میتوانید گزینههای مدیریت خطای سفارشی را تعیین کنید: یا نادیده گرفتن مقدار، تنظیم یک مقدار مشخص یا تنظیم یک پیام خطای مشخص. در صورت شکست یک مرحله پیشپردازش، اگر گزینه نادیده گرفتن مقدار یا تنظیم یک مقدار مشخص انتخاب شود، آیتم پشتیبانی نمیشود. **SMS** The following additional elements are exported only for the *SMS* media type. |Element|<|Type|Description| |-|---|---|-----------------------| |gsm\_modem|<|string|(required) Serial device name of the GSM modem.| ::: noteclassic See also: [Media type object](/manual/api/reference/mediatype/object) (refer to the relevant property with a matching name). ::: **SMS** عناصر اضافی زیر فقط برای نوع رسانه *SMS* صادر میشوند. |عنصر|<|نوع|توضیحات| |-|---|---|----------------------| |gsm\_modem|<|string|(الزامی) نام دستگاه سریال مودم GSM.| ::: noteclassic همچنین ببینید: [Media type object](/manual/api/reference/mediatype/object) (به ویژگی مربوطه با نام منطبق مراجعه کنید). ::: ##### SNMP get value {#snmpget} Apply formatting options to the SNMP get value:<br> - **UTF-8 from Hex-STRING** - convert hex-string to UTF-8 string;<br> - **MAC from Hex-STRING** - validate hex-string as MAC address and return a proper MAC address string (where `' '` are replaced by `':'`);<br> - **Integer from BITS** - convert the first 8 bytes of a bit string expressed as a sequence of hex characters (e.g., "1A 2B 3C 4D") into a 64-bit unsigned integer. In bit strings longer than 8 bytes, consequent bytes will be ignored. If you mark the *Custom on fail* checkbox, it is possible to specify custom error-handling options: either to discard the value, set a specified value, or set a specified error message. In case of a failed preprocessing step, the item will not become unsupported if the option to discard the value or set a specified value is selected. ##### مقدار دریافتی SNMP {#snmpget}اعمال گزینههای قالببندی بر روی مقدار دریافتی SNMP:<br>-**UTF-8 from Hex-STRING** - تبدیل رشته هگز به رشته UTF-8;<br>-**MAC from Hex-STRING** - اعتبارسنجی رشته هگز به عنوان آدرس MAC و بازگرداندن یک رشته آدرس MAC مناسب (که در آن `' '` با `':'` جایگزین میشوند)؛<br>-**عدد صحیح از BITS** - تبدیل ۸ بایت اول یک رشته بیتی که به صورت دنبالهای از کاراکترهای هگز بیان میشود (مثلاً "1A 2B 3C 4D") به یک عدد صحیح بدون علامت ۶۴ بیتی. در رشتههای بیتی طولانیتر از ۸ بایت، بایتهای بعدی نادیده گرفته میشوند. اگر کادر *سفارشی در صورت عدم موفقیت* را علامت بزنید، میتوانید گزینههای سفارشی مدیریت خطا را مشخص کنید: یا مقدار را حذف کنید، یک مقدار مشخص را تنظیم کنید یا یک پیام خطای مشخص را تنظیم کنید. در صورت عدم موفقیت در پیشپردازش در این مرحله، اگر گزینهی کنار گذاشتن مقدار یا تنظیم مقدار مشخصشده انتخاب شود، آن مورد پشتیبانینشده باقی نمیماند. ##### SNMP polling Without proxies, SNMP polling requires each device to be exposed via NAT and custom ports. ### SNMP polling بدون پروکسی، SNMP polling مستلزم آن است که هر دستگاه از طریق NAT و پورتهای سفارشی در معرض دید قرار گیرد، که این امر، polling SNMP در مقیاس بزرگ را دشوار میکند. نظر: https://git.zabbix.com/projects/WEB/repos/documentation/browse/en/cloud/key_differences.md?at=refs%2Fheads%2Frelease%2F7.4 ##### SNMP traps [SNMP traps](/manual/config/items/itemtypes/snmptrap) are only supported through a dedicated Zabbix proxy. If SNMP trap monitoring is required, automated load balancing or high availability for the proxy cannot be used because SNMP traps must be sent to a single IP address. ### تلههای SNMP [تلههای SNMP](/manual/config/items/itemtypes/snmptrap) فقط از طریق یک پروکسی اختصاصی Zabbix پشتیبانی میشوند. اگر نظارت بر تله SNMP مورد نیاز باشد، نمیتوان از تعادل بار خودکار یا دسترسی بالا برای پروکسی استفاده کرد زیرا تلههای SNMP باید به یک آدرس IP واحد ارسال شوند. ##### SNMP walk to JSON {#snmptojson} Convert SNMP values to JSON. Specify a field name in the JSON and the corresponding SNMP OID path. Field values will be populated by values in the specified SNMP OID path. Comments: - Similar value formatting options as in the *SNMP walk value* step are available;<br> - You may use this preprocessing step for [SNMP OID discovery](/manual/discovery/low_level_discovery/examples/snmp_oids_walk);<br> - If you mark the *Custom on fail* checkbox, it is possible to specify custom error-handling options: either to discard the value, set a specified value, or set a specified error message. In case of a failed preprocessing step, the item will not become unsupported if the option to discard the value or set a specified value is selected. ##### تبدیل مقادیر SNMP به JSON {#snmptojson} تبدیل مقادیر SNMP به JSON. نام فیلد را در JSON و مسیر SNMP OID مربوطه مشخص کنید. مقادیر فیلد با مقادیر موجود در مسیر SNMP OID مشخص شده پر میشوند. توضیحات: - گزینههای قالببندی مقادیر مشابه مرحله *SNMP walk value* در دسترس هستند؛<br>- میتوانید از این مرحله پیشپردازش برای [SNMP OID discovery](/manual/discovery/low_level_discovery/examples/snmp_oids_walk) استفاده کنید؛<br>- اگر کادر *Custom on fail* را علامت بزنید، میتوانید گزینههای مدیریت خطای سفارشی را تعیین کنید: یا مقدار را حذف کنید، یک مقدار مشخص شده را تنظیم کنید یا یک پیام خطای مشخص شده را تنظیم کنید. در صورت شکست در مرحله پیشپردازش، اگر گزینه حذف مقدار یا تنظیم یک مقدار مشخص شده انتخاب شود، مورد پشتیبانی نشده باقی میماند. ##### SNMP walk value {#snmpwalk} Extract value by the specified OID/MIB name and apply formatting options:<br> - **Unchanged** - return hex-string as unescaped hex string (*note* that display hints are still applied);<br> - **UTF-8 from hex-STRING** - convert hex-string to UTF-8 string;<br> - **MAC from hex-STRING** - validate hex-string as MAC address and return a proper MAC address string (where `' '` are replaced by `':'`);<br> - **Integer from BITS** - convert the first 8 bytes of a bit string expressed as a sequence of hex characters (e.g., "1A 2B 3C 4D") into a 64-bit unsigned integer. In bit strings longer than 8 bytes, consequent bytes will be ignored. If you mark the *Custom on fail* checkbox, it is possible to specify custom error-handling options: either to discard the value, set a specified value, or set a specified error message. In case of a failed preprocessing step, the item will not become unsupported if the option to discard the value or set a specified value is selected. ##### مقدار SNMP walk {#snmpwalk}مقدار را بر اساس نام OID/MIB مشخص شده استخراج کرده و گزینههای قالببندی را اعمال کنید:<br>-**Unchanged** - رشته هگز را به عنوان رشته هگز بدون اسکیپ برمیگرداند (*توجه* داشته باشید* که نکات نمایش هنوز اعمال میشوند)؛<br>-**UTF-8 from hex-STRING** - رشته هگز را به رشته UTF-8 تبدیل میکند؛<br>-**MAC from hex-STRING** - رشته هگز را به عنوان آدرس MAC اعتبارسنجی کرده و یک رشته آدرس MAC مناسب برمیگرداند (که در آن `' '` با `':'` جایگزین میشوند)؛<br>-**Integer from BITS** - 8 بایت اول یک رشته بیتی که به صورت دنبالهای از کاراکترهای هگز بیان میشود (مثلاً "1A 2B 3C 4D") را به یک عدد صحیح بدون علامت 64 بیتی تبدیل میکند. در رشتههای بیتی طولانیتر از 8 بایت، بایتهای بعدی نادیده گرفته میشوند. اگر *سفارشی در صورت عدم موفقیت* را علامتگذاری کنید با انتخاب این گزینه، میتوان گزینههای سفارشی مدیریت خطا را تعیین کرد: یا مقدار را حذف کنید، یک مقدار مشخص شده را تنظیم کنید، یا یک پیام خطای مشخص شده را تنظیم کنید. در صورت شکست مرحله پیشپردازش، اگر گزینه حذف مقدار یا تنظیم یک مقدار مشخص شده انتخاب شود، آیتم پشتیبانی نشده باقی میماند. ### Source CAction::create() in *ui/include/classes/api/services/CAction.php*. ### منبع CAction::create() در *ui/include/classes/api/services/CAction.php*. ### Source CAction::delete() in *ui/include/classes/api/services/CAction.php*. ### منبع CAction::delete() در *ui/include/classes/api/services/CAction.php*. ### Source CAction::get() in *ui/include/classes/api/services/CAction.php*. ### منبع CAction::get() در *ui/include/classes/api/services/CAction.php*. ### Source CAction::update() in *ui/include/classes/api/services/CAction.php*. ### منبع CAction::update() در *ui/include/classes/api/services/CAction.php*. ### Source CAlert::get() in *ui/include/classes/api/services/CAlert.php*. ### منبع CAlert::get() در *ui/include/classes/api/services/CAlert.php*. ### Source CAPIInfo::version() in *ui/include/classes/api/services/CAPIInfo.php*. ### منبع CAPIInfo::version() در *ui/include/classes/api/services/CAPIInfo.php*. ### Source CAuditLog::get() in *ui/include/classes/api/services/CAuditLog.php*. ### منبع CAuditLog::get() در *ui/include/classes/api/services/CAuditLog.php*. ### Source CAutoregistration::get() in *ui/include/classes/api/services/CAutoregistration.php*. ### منبع CIconMap::update() در *ui/include/classes/api/services/CIconMap.php*. ### Source CAutoregistration::update() in *ui/include/classes/api/services/CAutoregistration.php*. ### منبع CIconMap::update() در *ui/include/classes/api/services/CIconMap.php*. ### Source CConfiguration::export() in *ui/include/classes/api/services/CConfiguration.php*. ### منبع CIconMap::update() در *ui/include/classes/api/services/CIconMap.php*. ### Source CConfiguration::importcompare() in *ui/include/classes/api/services/CConfiguration.php*. ### منبع CIconMap::update() در *ui/include/classes/api/services/CIconMap.php*. ### Source CConfiguration::import() in *ui/include/classes/api/services/CConfiguration.php*. ### منبع CIconMap::update() در *ui/include/classes/api/services/CIconMap.php*. ### Source CConnector::create() in *ui/include/classes/api/services/CConnector.php*. ### منبع CConnector::create() در *ui/include/classes/api/services/CConnector.php*. ### Source CConnector::delete() in *ui/include/classes/api/services/CConnector.php*. ### منبع CConnector::delete() در *ui/include/classes/api/services/CConnector.php*. ### Source CConnector:get() in *ui/include/classes/api/services/CConnector.php*. ### منبع CConnector::create() در *ui/include/classes/api/services/CConnector.php*. ### Source CConnector::update() in *ui/include/classes/api/services/CConnector.php*. ### منبع CConnector::create() در *ui/include/classes/api/services/CConnector.php*. ### Source CCorrelation::create() in *ui/include/classes/api/services/CCorrelation.php*. ### منبع CIconMap::update() در *ui/include/classes/api/services/CIconMap.php*. ### Source CCorrelation::delete() in *ui/include/classes/api/services/CCorrelation.php*. ### منبع CCCorrelation::delete() در *ui/include/classes/api/services/CCorrelation.php*. ### Source CCorrelation::get() in *ui/include/classes/api/services/CCorrelation.php*. ### منبع CCorrelation::get() in *ui/include/classes/api/services/CCorrelation.php*. ### Source CCorrelation::update() in *ui/include/classes/api/services/CCorrelation.php*. ### منبع CCCorrelation::update() در *ui/include/classes/api/services/CCorrelation.php*. ### Source CDashboard::create() in *ui/include/classes/api/services/CDashboard.php*. ### منبع CDashboard::create() in *ui/include/classes/api/services/CDashboard.php*. ### Source CDashboard::delete() in *ui/include/classes/api/services/CDashboard.php*. ### منبع CDashboard::delete() in *ui/include/classes/api/services/CDashboard.php*. ### Source CDashboard::get() in *ui/include/classes/api/services/CDashboard.php*. ### منبع CDashboard::get() in *ui/include/classes/api/services/CDashboard.php*. ### Source CDashboard::update() in *ui/include/classes/api/services/CDashboard.php*. ### منبع CDashboard::update() in *ui/include/classes/api/services/CDashboard.php*. ### Source CDCheck::get() in *ui/include/classes/api/services/CDCheck.php*. ### منبع CDCheck::get() in *ui/include/classes/api/services/CDCheck.php*. ### Source CDHost::get() in *ui/include/classes/api/services/CDHost.php*. ### منبع CDHost::get() in *ui/include/classes/api/services/CDHost.php*. ### Source CDiscoveryRule::create() in *ui/include/classes/api/services/CDiscoveryRule.php*. ### منبع CDiscoveryrule::copy() in *ui/include/classes/api/services/CDiscoveryRule.php*. ### Source CDiscoveryRule::delete() in *ui/include/classes/api/services/CDiscoveryRule.php*. ### منبع CDiscoveryrule::copy() in *ui/include/classes/api/services/CDiscoveryRule.php*. ### Source CDiscoveryRule::get() in *ui/include/classes/api/services/CDiscoveryRule.php*. ### منبع CDiscoveryrule::copy() in *ui/include/classes/api/services/CDiscoveryRule.php*. ### Source CDiscoveryRule::update() in *ui/include/classes/api/services/CDiscoveryRule.php*. ### منبع CDiscoveryrule::copy() in *ui/include/classes/api/services/CDiscoveryRule.php*. ### Source CDRule::create() in *ui/include/classes/api/services/CDRule.php*. ### منابع CDRule::create() in *ui/include/classes/api/services/CDRule.php*. ### Source CDRule::delete() in *ui/include/classes/api/services/CDRule.php*. ### منبع CDRule::delete() in *ui/include/classes/api/services/CDRule.php*. ### Source CDRule::get() in *ui/include/classes/api/services/CDRule.php*. ### منبع CDRule::get() in *ui/include/classes/api/services/CDRule.php*. ### Source CDRule::update() in *ui/include/classes/api/services/CDRule.php*. ### منبع CDRule::update() in *ui/include/classes/api/services/CDRule.php*. ### Source CDService::get() in *ui/include/classes/api/services/CDService.php*. ### منبع CDService::get() in *ui/include/classes/api/services/CDService.php*. ### Source CEvent::acknowledge() in *ui/include/classes/api/services/CEvent.php*. ### منبع CEvent::acknowledge() in *ui/include/classes/api/services/CEvent.php*. ### Source CEvent::get() in *ui/include/classes/api/services/CEvent.php*. ### منبع CEvent::get() in *ui/include/classes/api/services/CEvent.php*. ### Source CGraph::create() in *ui/include/classes/api/services/CGraph.php*. منبع ### Source CGraph::delete() in *ui/include/classes/api/services/CGraph.php*. ### منبع CGraph::delete() in *ui/include/classes/api/services/CGraph.php*. ### Source CGraph::get() in *ui/include/classes/api/services/CGraph.php*. ### منبع CGraph::get() in *ui/include/classes/api/services/CGraph.php*. ### Source CGraphItem::get() in *ui/include/classes/api/services/CGraphItem.php*. ### منبع CGraphItem::get() in *ui/include/classes/api/services/CGraphItem.php*. ### Source CGraphPrototype::create() in *ui/include/classes/api/services/CGraphPrototype.php*. ### منبع CGraphPrototype::create() in *ui/include/classes/api/services/CGraphPrototype.php*. ### Source CGraphPrototype::delete() in *ui/include/classes/api/services/CGraphPrototype.php*. ### منبع CGraphPrototype::delete() in *ui/include/classes/api/services/CGraphPrototype.php*. ### Source CGraphPrototype::get() in *ui/include/classes/api/services/CGraphPrototype.php*. ### منبع CGraphPrototype::get() in *ui/include/classes/api/services/CGraphPrototype.php*. ### Source CGraphPrototype::update() in *ui/include/classes/api/services/CGraphPrototype.php*. ### منبع CGraphPrototype::update() in *ui/include/classes/api/services/CGraphPrototype.php*. ### Source CGraph::update() in *ui/include/classes/api/services/CGraph.php*. ### منبع CGraph::update() in *ui/include/classes/api/services/CGraph.php*. ### Source CHaNode::get() in *ui/include/classes/api/services/CHaNode.php*. ### منبع CHaNode::get() in *ui/include/classes/api/services/CHaNode.php*. ### Source CHistory::clear() in *ui/include/classes/api/services/CHistory.php*. ### منبع CHistory::clear() in *ui/include/classes/api/services/CHistory.php*. ### Source CHistory::get() in *ui/include/classes/api/services/CHistory.php*. ###منبع CHistory::get() in *ui/include/classes/api/services/CHistory.php*. ### Source CHost::create() in *ui/include/classes/api/services/CHost.php*. ### منبع CHost::create() in *ui/include/classes/api/services/CHost.php*. ### Source CHost::delete() in *ui/include/classes/api/services/CHost.php*. ###منبع CHost::delete() in *ui/include/classes/api/services/CHost.php*. ### Source CHost::get() in *ui/include/classes/api/services/CHost.php*. ### منبع CDHost::get() in *ui/include/classes/api/services/CDHost.php*. ### Source CHostGroup::create() in *ui/include/classes/api/services/CHostGroup.php*. ### منبع CHostGroup::create() in *ui/include/classes/api/services/CHostGroup.php*. ### Source CHostGroup::delete() in *ui/include/classes/api/services/CHostGroup.php*. ### منبع CHostGroup::create() in *ui/include/classes/api/services/CHostGroup.php*. ### Source CHostGroup::get() in *ui/include/classes/api/services/CHostGroup.php*. ### منبع CHostGroup::get() in *ui/include/classes/api/services/CHostGroup.php*. ### Source CHostGroup::massAdd() in *ui/include/classes/api/services/CHostGroup.php*. ### منبع CHostGroup::massAdd() in *ui/include/classes/api/services/CHostGroup.php*. ### Source CHostGroup::massRemove() in *ui/include/classes/api/services/CHostGroup.php*. ### منبع CHostGroup::massRemove() in *ui/include/classes/api/services/CHostGroup.php*. ### Source CHostGroup::massUpdate() in *ui/include/classes/api/services/CHostGroup.php*. ### منبع CHostGroup::massUpdate() in *ui/include/classes/api/services/CHostGroup.php*. ### Source CHostGroup::update() in *ui/include/classes/api/services/CHostGroup.php*. ### منبع CHostGroup::update() in *ui/include/classes/api/services/CHostGroup.php*. ### Source CHostInterface::create() in *ui/include/classes/api/services/CHostInterface.php*. ### منبع CHostInterface::create() in *ui/include/classes/api/services/CHostInterface.php*. ### Source CHostInterface::delete() in *ui/include/classes/api/services/CHostInterface.php*. ###منبع CHostInterface::delete() in *ui/include/classes/api/services/CHostInterface.php*. ### Source CHostInterface::get() in *ui/include/classes/api/services/CHostInterface.php*. ### منبع CHostInterface::get() in *ui/include/classes/api/services/CHostInterface.php*. ### Source CHostInterface::massAdd() in *ui/include/classes/api/services/CHostInterface.php*. ### منبع CHostInterface::massAdd() in *ui/include/classes/api/services/CHostInterface.php*. ### Source CHostInterface::massRemove() in *ui/include/classes/api/services/CHostInterface.php*. ### منبع CHostInterface::massRemove() in *ui/include/classes/api/services/CHostInterface.php*. ### Source CHostInterface::replaceHostInterfaces() in *ui/include/classes/api/services/CHostInterface.php*. ### منبع CHostInterface::replaceHostInterfaces() in *ui/include/classes/api/services/CHostInterface.php*. ### Source CHostInterface::update() in *ui/include/classes/api/services/CHostInterface.php*. ### منبع CHostInterface::update() in *ui/include/classes/api/services/CHostInterface.php*. ### Source CHost::massAdd() in *ui/include/classes/api/services/CHost.php*. ### منبع CHost::massAdd() in *ui/include/classes/api/services/CHost.php*. ### Source CHost::massRemove() in *ui/include/classes/api/services/CHost.php*. ### منبع CHost::massRemove() in *ui/include/classes/api/services/CHost.php*. ### Source CHost::massUpdate() in *ui/include/classes/api/services/CHost.php*. ### منبع CHost::massUpdate() in *ui/include/classes/api/services/CHost.php*. ### Source CHostPrototype::create() in *ui/include/classes/api/services/CHostPrototype.php*. ###منبع CHostPrototype::create() in *ui/include/classes/api/services/CHostPrototype.php*. ### Source CHostPrototype::delete() in *ui/include/classes/api/services/CHostPrototype.php*. ### منبع CHostPrototype::delete() in *ui/include/classes/api/services/CHostPrototype.php*. ### Source CHostPrototype::get() in *ui/include/classes/api/services/CHostPrototype.php*. ###منبع CHostPrototype::get() in *ui/include/classes/api/services/CHostPrototype.php*. ### Source CHostPrototype::update() in *ui/include/classes/api/services/CHostPrototype.php*. ### منبع CHostPrototype::update() in *ui/include/classes/api/services/CHostPrototype.php*. ### Source CHost::update() in *ui/include/classes/api/services/CHost.php*. ### منبع CHost::create() in *ui/include/classes/api/services/CHost.php*. ### Source CHousekeeping ::get() in *ui/include/classes/api/services/CHousekeeping.php*. ### منبع CHousekeeping ::get() in *ui/include/classes/api/services/CHousekeeping.php*. ### Source CHousekeeping::update() in *ui/include/classes/api/services/CHousekeeping.php*. ### منبع CHousekeeping::update() in *ui/include/classes/api/services/CHousekeeping.php*. ### Source CHttpTest::create() in *ui/include/classes/api/services/CHttpTest.php*. ### منبع CHttpTest::create() in *ui/include/classes/api/services/CHttpTest.php*. ### Source CHttpTest::delete() in *ui/include/classes/api/services/CHttpTest.php*. ###منبع CHttpTest::delete() in *ui/include/classes/api/services/CHttpTest.php*. ### Source CHttpTest::get() in *ui/include/classes/api/services/CHttpTest.php*. ###منبع CHttpTest::get() in *ui/include/classes/api/services/CHttpTest.php*. ### Source CHttpTest::update() in *ui/include/classes/api/services/CHttpTest.php*. ###منبع CHttpTest::update() in *ui/include/classes/api/services/CHttpTest.php*. ### Source CIconMap::create() in *ui/include/classes/api/services/CIconMap.php*. ### منبع CIconMap::update() در *ui/include/classes/api/services/CIconMap.php*. ### Source CIconMap::delete() in *ui/include/classes/api/services/CIconMap.php*. ###منبع CIconMap::delete() in *ui/include/classes/api/services/CIconMap.php*. ### Source CIconMap::get() in *ui/include/classes/api/services/CIconMap.php*. ### منبع CIconMap::update() در *ui/include/classes/api/services/CIconMap.php*. ### Source CIconMap::update() in *ui/include/classes/api/services/CIconMap.php*. ### منبع CIconMap::update() در *ui/include/classes/api/services/CIconMap.php*. ### Source CImage::create() in *ui/include/classes/api/services/CImage.php*. ### منبع CImage::create() in *ui/include/classes/api/services/CImage.php*. ### Source CItemPrototype::get() in *ui/include/classes/api/services/CItemPrototype.php*. ###منبع CHostPrototype::create() in *ui/include/classes/api/services/CHostPrototype.php*. ### Source CItemPrototype::update() in *ui/include/classes/api/services/CItemPrototype.php*. ###منبع CHostPrototype::create() in *ui/include/classes/api/services/CHostPrototype.php*. ### Source CMap::create() in *ui/include/classes/api/services/CMap.php*. منبع ### Source CScript::create() in *ui/include/classes/api/services/CScript.php*. ### منبع CIconMap::update() در *ui/include/classes/api/services/CIconMap.php*. ### Source CTemplate::create() in *ui/include/classes/api/services/CTemplate.php*. ### منبع CTemplate::create() in *ui/include/classes/api/services/CTemplate.php*. ### Source CUser::login() in *ui/include/classes/api/services/CUser.php*. ### تابع SourceCUser::login() در فایل *ui/include/classes/api/services/CUser.php* قرار دارد. ### Step 1: Setup 1. A plugin is a standard Go module. Start by initializing the `go.mod` file in the plugin directory to track plugin dependencies: ```sh cd path/to/plugins/myip # Switch to your plugin directory go mod init myip ``` 2. Install the mandatory dependency Zabbix Go SDK (`golang.zabbix.com/sdk`): ```sh go get golang.zabbix.com/sdk@$LATEST_COMMIT_HASH ``` Replace `$LATEST_COMMIT_HASH` with the latest `HEAD` commit hash from the `golang.zabbix.com/sdk` [repository](https://git.zabbix.com/projects/AP/repos/plugin-support/commits) in the appropriate release branch. For example: ```sh go get golang.zabbix.com/sdk@af85407 ``` Note that `golang.zabbix.com/sdk` versioning is currently not supported, but this may change in the future. Additional dependencies can be installed as needed using `go get`. 3. Create an empty `main.go` file for the plugin source code: ```sh touch main.go ``` Now the initial setup is complete, and the plugin is ready for development. ### مرحله ۱: راهاندازی ۱. یک افزونه یک ماژول استاندارد Go است. با مقداردهی اولیه فایل `go.mod` در دایرکتوری افزونه برای ردیابی وابستگیهای افزونه شروع کنید: ```sh cd path/to/plugins/myip # به دایرکتوری افزونه خود بروید go mod init myip ``` ۲. وابستگی اجباری Zabbix Go SDK (`golang.zabbix.com/sdk`) را نصب کنید: ```sh go get golang.zabbix.com/sdk@$LATEST_COMMIT_HASH ``` `$LATEST_COMMIT_HASH` را با آخرین هش کامیت `HEAD` از `golang.zabbix.com/sdk` [مخزن](https://git.zabbix.com/projects/AP/repos/plugin-support/commits) در شاخه انتشار مناسب جایگزین کنید. برای مثال: ```sh go get golang.zabbix.com/sdk@af85407 ``` توجه داشته باشید که نسخهبندی `golang.zabbix.com/sdk` در حال حاضر پشتیبانی نمیشود، اما ممکن است در آینده تغییر کند. در صورت نیاز میتوان وابستگیهای اضافی را با استفاده از `go get` نصب کرد. ۳. یک فایل خالی `main.go` برای کد منبع افزونه ایجاد کنید: ```sh touch main.go ``` اکنون راهاندازی اولیه کامل شده است و افزونه آماده توسعه است. ### Step 2: Plugin structure The `golang.zabbix.com/sdk` module, installed in the previous step, provides the necessary framework for plugin development and ensures all plugins have a consistent structure. 1. Set up basic execution flow. Start by defining the main execution flow of the plugin. Add the following code to `main.go`: ```go package main func main() { err := run() if err != nil { panic(err) } } func run() error { return nil } ``` This establishes the basic execution flow for the plugin. The run function will later contain the core logic of the plugin. 2. Explore the plugin interfaces. A Zabbix agent 2 plugin shall be represented by a struct that implements interfaces from the `golang.zabbix.com/sdk/plugin` package: - *Accessor* - defines essential methods all plugins must implement, such as setting the plugin name and handling item key timeouts. - One or more of the following functional plugin interfaces: - *Exporter* - performs a poll and returns a value (or values), nothing, or an error; often used alongside the *Collector* interface. - *Collector* - manages the periodic collection of data. - *Runner* - defines plugin startup and shutdown procedures. - *Watcher* - allows to implement independent metric polling, bypassing the agent's internal scheduler; useful for trap-based or event-driven monitoring. - *Configurator* - defines how the plugin reads and applies its configuration settings. You can either implement these interfaces yourself or use the default ones provided by the Zabbix Go SDK, modifying them as needed. This tutorial uses the default implementations. 3. Create the plugin struct. Now, import the *plugin* package and create a `myIP` struct that embeds the `plugin.Base` struct: ```go import "golang.zabbix.com/sdk/plugin" type myIP struct { plugin.Base } ``` The myIP struct currently satisfies the Accessor interface. A method for implementing one of the functional plugin interfaces, the `Exporter`, will be added later in the tutorial. ### مرحله ۲: ساختار افزونه ماژول `golang.zabbix.com/sdk` که در مرحله قبل نصب شد، چارچوب لازم برای توسعه افزونه را فراهم میکند و تضمین میکند که همه افزونهها ساختار ثابتی دارند. ۱. جریان اجرای اولیه را تنظیم کنید. با تعریف جریان اجرای اصلی افزونه شروع کنید. کد زیر را به `main.go` اضافه کنید: ```go package main func main() { err := run() if err != nil { panic(err) } } func run() error { return nil } ``` این، جریان اجرای اولیه افزونه را ایجاد میکند. تابع run بعداً شامل منطق اصلی افزونه خواهد بود. ۲. رابطهای افزونه را بررسی کنید. یک افزونهی Zabbix agent 2 باید توسط ساختاری نمایش داده شود که رابطهای بستهی `golang.zabbix.com/sdk/plugin` را پیادهسازی میکند: - *Accessor* - متدهای ضروری که همه افزونهها باید پیادهسازی کنند، مانند تنظیم نام افزونه و مدیریت زمانهای انقضای کلید آیتم را تعریف میکند. - یک یا چند رابط افزونهی کاربردی زیر: - *Exporter* - یک نظرسنجی انجام میدهد و یک مقدار (یا مقادیر)، هیچ چیز یا یک خطا را برمیگرداند؛ اغلب در کنار رابط *Collector* استفاده میشود. - *Collector* - جمعآوری دورهای دادهها را مدیریت میکند. - *Runner* - رویههای راهاندازی و خاموش کردن افزونه را تعریف میکند. - *Watcher* - امکان پیادهسازی نظرسنجی معیار مستقل را فراهم میکند و از زمانبندی داخلی agent عبور میکند؛ برای نظارت مبتنی بر trap یا رویداد محور مفید است. - *Configurator* - نحوهی خواندن و اعمال تنظیمات پیکربندی توسط افزونه را تعریف میکند. شما میتوانید این رابطها را خودتان پیادهسازی کنید یا از رابطهای پیشفرض ارائه شده توسط Zabbix Go SDK استفاده کنید و در صورت نیاز آنها را تغییر دهید. این آموزش از پیادهسازیهای پیشفرض استفاده میکند. ۳. ساختار افزونه را ایجاد کنید. حالا، بسته *plugin* را وارد کنید و یک ساختار `myIP` ایجاد کنید که ساختار `plugin.Base` را در خود جای دهد: ```go import "golang.zabbix.com/sdk/plugin" type myIP struct { plugin.Base } ``` ساختار myIP در حال حاضر رابط Accessor را برآورده میکند. روشی برای پیادهسازی یکی از رابطهای کاربردی افزونه، یعنی `Exporter`، بعداً در این آموزش اضافه خواهد شد. ### Step 3: Define item keys Your plugin needs the item keys to collect data and provide it to Zabbix server or proxy. 1. Import *errs* package for error handling: ```go import "golang.zabbix.com/sdk/errs" ``` 2. Register item keys using the `plugin.RegisterMetrics()` function within the `run()` function: ```go func run() error { p := &myIP{} // Register the `myip` item key. err := plugin.RegisterMetrics( p, "MyIP", // Plugin name "myip", // Item key name "Returns the host's IP address.", // Item key description ) if err != nil { return errs.Wrap(err, "failed to register metrics") } return nil } ``` To register several item keys, repeat the parameters *metric name* and *description* for each metric. For example: ```go plugin.RegisterMetrics(&impl, "Myip", "metric.one", "Metric one description.", "metric.two", "Metric two description.") ``` ### مرحله ۳: تعریف کلیدهای آیتم افزونه شما برای جمعآوری دادهها و ارائه آن به سرور یا پروکسی زبیکس به کلیدهای آیتم نیاز دارد. ۱. برای مدیریت خطا، بسته *errs* را وارد کنید: ```go import "golang.zabbix.com/sdk/errs" ``` ۲. کلیدهای آیتم را با استفاده از تابع `plugin.RegisterMetrics()` در تابع `run()` ثبت کنید: ```go func run() error { p := &myIP{} // کلید آیتم `myip` را ثبت کنید. err := plugin.RegisterMetrics( p, "MyIP", // نام افزونه "myip", // نام کلید آیتم "آدرس IP میزبان را برمیگرداند.", // توضیحات کلید آیتم ) if err != nil { return errs.Wrap(err, "ثبت معیارها ناموفق بود") } return nil } ``` برای ثبت چندین کلید آیتم، پارامترهای *نام معیار* و *توضیحات* را برای هر معیار تکرار کنید. به عنوان مثال: ```go plugin.RegisterMetrics(&impl, "Myip", "metric.one", "توضیحات معیار یک.", "metric.two", "توضیحات معیار دو.") ```` ### Step 4: Set up the handler The handler facilitates communication between the agent and the plugin. 1. Import the *container* package: ```go import "golang.zabbix.com/sdk/plugin/container" ``` 2. Indise the `run()` function add code to create and set up a handler: ```go func run() error { p := &myIP{} // Register the `myip` item key. err := plugin.RegisterMetrics( p, "MyIP", // Plugin name "myip", // Item key name "Returns the host's IP address.", // Item key description ) if err != nil { return errs.Wrap(err, "failed to register metrics") } // Create a new handler. h, err := container.NewHandler("MyIP") // Plugin name if err != nil { return errs.Wrap(err, "failed to create new handler") } // Setup logging to forward logs from the plugin to the agent. // Available via p.Logger.Infof, p.Logger.Debugf, etc. p.Logger = h // Start plugin execution. // Blocks until a termination request is received from the agent. err = h.Execute() if err != nil { return errs.Wrap(err, "failed to execute plugin handler") } return nil } ``` ### مرحله ۴: تنظیم هندلر هندلر ارتباط بین عامل و افزونه را تسهیل میکند. ۱. بسته *container* را وارد کنید: ```go import "golang.zabbix.com/sdk/plugin/container" ``` ۲. تابع `run()` را برای ایجاد و تنظیم یک هندلر، اضافه کنید: ```go func run() error { p := &myIP{} // کلید آیتم `myip` را ثبت کنید. err := plugin.RegisterMetrics( p, "MyIP", // نام افزونه "myip", // نام کلید آیتم "آدرس IP میزبان را برمیگرداند.", // توضیحات کلید آیتم ) if err != nil { return errs.Wrap(err, "ثبت معیارها ناموفق بود") } // یک هندلر جدید ایجاد کنید. h, err := container.NewHandler("MyIP") // نام افزونه if err != nil { return errs.Wrap(err, "ایجاد کنترلکننده جدید ناموفق بود") } // راهاندازی گزارشگیری برای ارسال گزارشها از افزونه به عامل. // از طریق p.Logger.Infof، p.Logger.Debugf و غیره در دسترس است. p.Logger = h // اجرای افزونه را شروع کنید. // تا زمانی که درخواست خاتمه از عامل دریافت نشود، مسدود میشود. err = h.Execute() if err != nil { return errs.Wrap(err, "اجرای کنترلکننده افزونه ناموفق بود") } return nil } ``` ### Step 5: Implement data collection Data collection is done via the Exporter interface, which describes the `Export` method: ```go func Export( key string, // The item key to collect. params []string, // Arguments passed to the item key (`myip[arg1, arg2]`). context ContextProvider // Metadata about the item key data collection. ) (any, error) ``` 1. Import the required packages for HTTP requests and response reading: ``` import ( "io" "net/http" ) ``` 2. Implement the `Export` method for the `myIP` struct: ```go func (p *myIP) Export( key string, params []string, context plugin.ContextProvider, ) (any, error) { // The plugin can use different data collection logic based on the `key` parameter. // This implementation only verifies that the provided `key` is supported. if key != "myip" { return nil, errs.Errorf("unknown item key %q", key) } // The log will get forwarded to the agent 2 log. p.Infof( "received request to handle %q key with %d parameters", key, len(params), ) // Collect the data and return it. resp, err := http.Get("https://api.ipify.org") if err != nil { return nil, errs.Wrap(err, "failed to get IP address") } defer resp.Body.Close() body, err := io.ReadAll(resp.Body) if err != nil { return nil, errs.Wrap(err, "failed to read response body") } return string(body), nil } ``` ### مرحله 5: پیادهسازی جمعآوری دادهها جمعآوری دادهها از طریق رابط Exporter انجام میشود که متد `Export` را شرح میدهد: ```go func Export( key string, // کلید آیتم برای جمعآوری. params []string, // آرگومانهای ارسالی به کلید آیتم (`myip[arg1, arg2]`). context ContextProvider // فرادادههای مربوط به جمعآوری دادههای کلید آیتم. ) (any, error) ``` 1. بستههای مورد نیاز برای درخواستهای HTTP و خواندن پاسخ را وارد کنید: ``` import ( "io" "net/http" ) ``` 2. متد `Export` را برای ساختار `myIP` پیادهسازی کنید: ```go func (p *myIP) Export( key string, params []string, context plugin.ContextProvider, ) (any, error) { // این افزونه میتواند از منطق جمعآوری دادههای مختلف بر اساس پارامتر `key` استفاده کند. // این پیادهسازی فقط تأیید میکند که `key` ارائه شده پشتیبانی میشود. if key != "myip" { return nil, errs.Errorf("unknown item key %q", key) } // گزارش به گزارش عامل ۲ ارسال میشود. p.Infof( "درخواستی برای مدیریت کلید %q با پارامترهای %d دریافت شد", key, len(params), ) // دادهها را جمعآوری کرده و برمیگرداند. resp, err := http.Get("https://api.ipify.org") if err != nil { return nil, errs.Wrap(err, "دریافت آدرس IP ناموفق بود") } defer resp.Body.Close() body, err := io.ReadAll(resp.Body) if err != nil { return nil, errs.Wrap(err, "خواندن بدنه پاسخ ناموفق بود") } return string(body), nil } ```` #### Structure The header consists of four fields. All numbers in the header are formatted as little-endian. |Field|Size|Size<br>(large packet)|Description| |--|-|-|------| |`<PROTOCOL>`|4|4|`"ZBXD"` or `5A 42 58 44`| |`<FLAGS>`|1|1|Protocol flags:<br>`0x01` - Zabbix communications protocol<br>`0x02` - compression<br>`0x04` - large packet| |`<DATALEN>`|4|8|Data length.| |`<RESERVED>`|4|8|When compression is used (`0x02` flag) - the length of uncompressed data<br>When compression is not used - `00 00 00 00`| #### Structure The header consists of four fields. All numbers in the header are formatted as little-endian. |Field|Size|Size<br>(large packet)|Description| |--|-|-|------| |`<PROTOCOL>`|4|4|`"ZBXD"` or `5A 42 58 44`| |`<FLAGS>`|1|1|Protocol flags:<br>`0x01` - Zabbix communications protocol<br>`0x02` - compression<br>`0x04` - large packet| |`<DATALEN>`|4|8|Data length.| |`<RESERVED>`|4|8|When compression is used (`0x02` flag) - the length of uncompressed data<br>When compression is not used - `00 00 00 00`| #### Supported platforms For supported platforms, refer to the [Requirements](/manual/installation/requirements#supported-platforms) page. #### پلتفرمهای پشتیبانیشده برای پلتفرمهای پشتیبانیشده، به صفحه [الزامات](/manual/installation/requirements#supported-platforms) مراجعه کنید. #### Tasks Interact with Zabbix server task manager, creating tasks and retrieving response. [Task API](/manual/api/reference/task) #### TasksInteract با مدیر وظیفه سرور Zabbix تعامل داشته باشید، وظایفی ایجاد کنید و پاسخها را بازیابی کنید.[Task API](/manual/api/reference/task) #### task [ZBX-26202](https://support.zabbix.com/browse/ZBX-26202) `task.create`: *Admin* and *User* type users may now create 'Execute now' tasks. کار # template.create # ساخت قالب #### Template dashboards ```yaml zabbix_export: (...) templates: (...) dashboards: - uuid: c689ad3115fd46a4b927d1f70ee2e5a4 name: Filesystems pages: - name: Overview widgets: (see table below) (...) ``` |Element|<|Type|Description| |-|---|---|-----------------------| |uuid|<|string|(required) Unique identifier for this dashboard.| |name|<|string|(required) Template dashboard name.| |display period|<|integer|Display period of dashboard pages.| |auto\_start|<|string|Slideshow auto start.<br>Possible values:^[1](#footnotes)^ NO (0), YES (1, default).| |pages|<| |Root element for template dashboard pages.| |<|name|string|Page name.| |^|display period|integer|Page display period.| |^|sortorder|integer|Page sorting order.| |widgets|<| |Root element for [template dashboard widgets](#template-dashboard-widgets).| ::: noteclassic See also: [Template dashboard object](/manual/api/reference/templatedashboard/object) (refer to the relevant property with a matching name). ::: #### داشبوردهای قالب ```yaml zabbix_export: (...) قالبها: (...) داشبوردها: - uuid: c689ad3115fd46a4b927d1f70ee2e5a4 name: Filesystems pages: - name: Overview widgets: (به جدول زیر مراجعه کنید) (...) ``` |عنصر|<|نوع|توضیحات| |-|---|---|---------------------| |uuid|<|string|(الزامی) شناسه منحصر به فرد برای این داشبورد.| |name|<|string|(الزامی) نام داشبورد قالب.| |دوره نمایش|<|عدد صحیح|دوره نمایش صفحات داشبورد.| |auto\_start|<|string|شروع خودکار نمایش اسلاید.<br>مقادیر ممکن:^[1](#footnotes)^ خیر (0)، بله (1، پیشفرض).| |pages|<| |عنصر ریشه برای صفحات داشبورد قالب.| |<|name|string|نام صفحه.| |^|دوره نمایش|عدد صحیح|دوره نمایش صفحه.| |^|ترتیب مرتبسازی|عدد صحیح|ترتیب مرتبسازی صفحه.| |widgets|<| |عنصر ریشه برای [ابزارکهای داشبورد قالب](#template-dashboard-widgets).| ::: noteclassic همچنین ببینید: [شیء داشبورد قالب](/manual/api/reference/templatedashboard/object) (به ویژگی مربوطه با نام منطبق مراجعه کنید). ::: ##### Template dashboard widgets ```yaml zabbix_export: (...) templates: (...) dashboards: - uuid: c689ad3115fd46a4b927d1f70ee2e5a4 name: Filesystems pages: - name: Overview widgets: - type: graphprototype width: '72' height: '5' fields: - type: INTEGER name: columns value: '3' - type: GRAPH_PROTOTYPE name: graphid.0 value: host: 'Linux by Zabbix agent' name: 'FS [{#FSTYPE}({#FSNAME})]: Space utilization chart (relative to total)' - type: STRING name: reference value: AAAEB - type: graphprototype 'y': '5' width: '72' height: '5' fields: - type: INTEGER name: columns value: '1' - type: GRAPH_PROTOTYPE name: graphid.0 value: host: 'Linux by Zabbix agent' name: 'FS [{#FSTYPE}({#FSNAME})]: Space usage graph, in % (relative to max available)' - type: STRING name: reference value: AAAEC (...) ``` |Element|<|Type|Description| |-|---|---|-----------------------| |type|<|string|(required) Widget type.| |name|<|string|Widget name.| |x|<|integer|Horizontal position from the left side of the template dashboard.<br>Possible values:^[1](#footnotes)^ 0-71.| |y|<|integer|Vertical position from the top of the template dashboard.<br>Possible values:^[1](#footnotes)^ 0-63.| |width|<|integer|Widget width.<br>Possible values:^[1](#footnotes)^ 1-72.| |height|<|integer|Widget height.<br>Possible values:^[1](#footnotes)^ 1-64.| |hide\_header|<|string|Hide widget header.<br>Possible values:^[1](#footnotes)^ NO (0, default), YES (1).| |fields|<| |Root element for the template dashboard widget fields.| |<|type|string|(required) Widget field type.<br>Possible values:^[1](#footnotes)^ INTEGER (0), STRING (1), ITEM (4), ITEM\_PROTOTYPE (5), GRAPH (6), GRAPH\_PROTOTYPE (7), MAP (8), SERVICE (9), SLA (10), USER (11), ACTION (12), MEDIA_TYPE (13).| |^|name|string|(required) Widget field name.| |^|value|mixed|(required) Widget field value, depending on the field type.| ::: noteclassic See also: [Template dashboard widget object](/manual/api/reference/templatedashboard/object#template-dashboard-widget) (refer to the relevant property with a matching name). ::: ##### ابزارکهای داشبورد قالب ```yaml zabbix_export: (...) قالبها: (...) داشبوردها: - uuid: c689ad3115fd46a4b927d1f70ee2e5a4 name: Filesystems pages: - name: Overview ابزارکها: - type: graphprototype width: '72' height: '5' fields: - type: INTEGER name: columns value: '3' - type: GRAPH_PROTOTYPE name: graphid.0 value: host: 'Linux by Zabbix agent' name: 'FS [{#FSTYPE}({#FSNAME})]: نمودار استفاده از فضا (نسبت به کل)' - type: STRING name: reference value: AAAEB - type: graphprototype 'y': '5' width: '72' height: '5' fields: - type: INTEGER name: columns value: '1' - type: GRAPH_PROTOTYPE name: graphid.0 value: host: 'لینوکس توسط عامل Zabbix' name: 'FS [{#FSTYPE}({#FSNAME})]: نمودار استفاده از فضا، به درصد (نسبت به حداکثر موجود)' - type: STRING name: reference value: AAAEC (...) ``` |Element|<|Type|Description| |-|---|---|---------------------| |type|<|string|(required) نوع ابزارک.| |name|<|string|نام ابزارک.| |x|<|عدد صحیح|موقعیت افقی از سمت چپ داشبورد قالب.<br>مقادیر ممکن:^[1](#footnotes)^ 0-71.| |y|<|عدد صحیح|موقعیت عمودی از بالای داشبورد قالب.<br>مقادیر ممکن:^[1](#footnotes)^ 0-63.| |width|<|عدد صحیح|عرض ابزارک.<br>مقادیر ممکن:^[1](#footnotes)^ 1-72.| |height|<|عدد صحیح|ارتفاع ابزارک.<br>مقادیر ممکن:^[1](#footnotes)^ 1-64.| |hide\_header|<|string|پنهان کردن سربرگ ابزارک.<br>مقادیر ممکن:^[1](#footnotes)^ خیر (0، پیشفرض)، بله (1).| |fields|<| |عنصر ریشه برای فیلدهای ویجت داشبورد قالب.| |<|type|string|(الزامی) نوع فیلد ویجت.<br>مقادیر ممکن: ^[1](#footnotes)^ INTEGER (0), STRING (1), ITEM (4), ITEM\_PROTOTYPE (5), GRAPH (6), GRAPH\_PROTOTYPE (7), MAP (8), SERVICE (9), SLA (10), USER (11), ACTION (12), MEDIA_TYPE (13).| |^|name|string|(الزامی) نام فیلد ویجت.| |^|value|mixed|(الزامی) مقدار فیلد ویجت، بسته به نوع فیلد.| ::: noteclassic همچنین ببینید: [شیء ویجت داشبورد قالب](/manual/api/reference/templatedashboard/object#template-dashboard-widget) (به ویژگی مربوطه با نام منطبق مراجعه کنید). ::: #### Template items ```yaml zabbix_export: (...) templates: (...) items: - uuid: f94f9f4699e94c369e6c98b2a2f485ce name: 'Zabbix agent ping' key: agent.ping description: 'The agent always returns "1" for this item. May be used in combination with `nodata()` for the availability check.' valuemap: name: 'Zabbix agent ping status' tags: - tag: component value: system (...) - uuid: 58818005e76d46dda14d6592f601ab00 name: 'Number of installed packages' key: system.sw.packages.get delay: 1h preprocessing: (see table below) tags: - tag: component value: os triggers: (see table below) - uuid: 403cebed115441369e94d35d070ca7b8 name: 'Memory utilization' type: DEPENDENT key: vm.memory.utilization value_type: FLOAT units: '%' description: 'The percentage of used memory is calculated as `100-pavailable`.' preprocessing: (see table below) master_item: key: 'vm.memory.size[pavailable]' tags: - tag: component value: memory triggers: (see table below) (...) ``` |Element|<|Type|Description| |-|---|---|-----------------------| |uuid|<|string|(required) Unique identifier for this item.| |name|<|string|(required) Item name.| |type|<|string|Item type.<br>Possible values:^[1](#footnotes)^ ZABBIX\_PASSIVE (0, default), TRAP (2), SIMPLE (3), INTERNAL (5), ZABBIX\_ACTIVE (7), EXTERNAL (10), ODBC (11), IPMI (12), SSH (13), TELNET (14), CALCULATED (15), JMX (16), SNMP\_TRAP (17), DEPENDENT (18), HTTP\_AGENT (19), SNMP\_AGENT (20), ITEM\_TYPE\_SCRIPT (21), ITEM\_TYPE\_BROWSER (22).| |snmp\_oid|<|string|(required for SNMP\_AGENT items) SNMP object ID.| |key|<|string|(required) Item key.| |delay|<|string|Update interval of the item.<br>Default: 1m. The value will always be 0 for TRAP items.| |history|<|string|Time period (using [time suffix](/manual/appendix/suffixes#time-suffixes), [user macro](/manual/config/macros/user_macros) or [LLD macro](/manual/config/macros/lld_macros)) of how long the history data should be stored.<br>Default: 31d.| |trends|<|string|Time period (using [time suffix](/manual/appendix/suffixes#time-suffixes), [user macro](/manual/config/macros/user_macros) or [LLD macro](/manual/config/macros/lld_macros)) of how long the trends data should be stored.<br>Default: 365d.| |status|<|string|Item status.<br>Possible values:^[1](#footnotes)^ ENABLED (0, default), DISABLED (1).| |value\_type|<|string|Received value type.<br>Possible values:^[1](#footnotes)^ FLOAT (0), CHAR (1), LOG (2), UNSIGNED (3, default), TEXT (4), BINARY (5).| |allowed\_hosts|<|string|List of comma-delimited IP addresses of hosts allowed to send data for the item.<br>Supported for TRAP and HTTP\_AGENT items.| |units|<|string|Received value units (bps, B, etc.).| |params|<|text|Additional parameters depending on the type of the item (executed script for SSH and TELNET items; SQL query for ODBC items; formula for CALCULATED items; the script for ITEM\_TYPE\_SCRIPT and ITEM\_TYPE\_BROWSER items).| |ipmi\_sensor|<|string|IPMI sensor.<br>Supported for IPMI items.| |authtype|<|string|Authentication type.<br>Supported for SSH and HTTP\_AGENT items.<br>Possible values for SSH items:^[1](#footnotes)^ PASSWORD (0, default), PUBLIC\_KEY (1).<br>Possible values for HTTP\_AGENT items:^[1](#footnotes)^ NONE (0, default), BASIC (1), NTLM (2), Kerberos (3), or Digest (4).| |username|<|string|(required for SSH and TELNET items) Username for authentication.<br>Supported for SIMPLE, ODBC, JMX and HTTP\_AGENT items.<br>When used for JMX items, `password` (see below) should also be specified or both elements should be left blank.| |password|<|string|(required for SSH and TELNET items) Password for authentication.<br>Supported for SIMPLE, ODBC, JMX and HTTP\_AGENT items.<br>When used for JMX items, `username` (see above) should also be specified or both elements should be left blank.| |publickey|<|string|(required for SSH items) Name of the public key file.| |privatekey|<|string|(required for SSH items) Name of the private key file.| |description|<|text|Item description.| |inventory\_link|<|string|Host inventory field that is populated by the item.<br>Possible values:^[1](#footnotes)^ NONE (0), ALIAS (4), etc. (see [Host inventory](/manual/api/reference/host/object#host-inventory) for supported fields).| |valuemap|<| |Root element for item value maps.| | |name|string|(required) Name of the value map to use for the item.| |logtimefmt|<|string|Format of the time in log entries.<br>Supported for items of LOG value type.| |preprocessing|<| |Root element for item value preprocessing.| | |step| |Root element for [template item value preprocessing steps](#template-item-value-preprocessing-steps).| |jmx\_endpoint|<|string|JMX endpoint.<br>Supported for JMX items.| |master_item|<| |(required for DEPENDENT items) Root element for dependent item's master item.| | |key|string|(required) Dependent item's master item key.| |timeout|<|string|Item data polling request timeout.<br>Supported for [Timeouts](/manual/web_interface/frontend_sections/administration/general#timeouts) list of item types.| |url|<|string|(required for HTTP\_AGENT items) URL string.| |query_fields|<| |Root element for query parameters.<br>Supported for HTTP\_AGENT items.| |<|name|string|(required for HTTP\_AGENT items) Query parameter name.| |^|value|string|Query parameter value.<br>Supported for HTTP\_AGENT items.| |parameters|<| |Root element for user-defined parameters.<br>Supported for ITEM\_TYPE\_SCRIPT and ITEM\_TYPE\_BROWSER items.| |<|name|string|(required for ITEM\_TYPE\_SCRIPT and ITEM\_TYPE\_BROWSER items) User-defined parameter name.| |^|value|string|User-defined parameter value.<br>Supported for ITEM\_TYPE\_SCRIPT and ITEM\_TYPE\_BROWSER items.| |posts|<|string|HTTP(S) request body data.<br>Supported for HTTP\_AGENT items.| |status\_codes|<|string|Ranges of required HTTP status codes, separated by commas.<br>Supported for HTTP\_AGENT items.| |follow\_redirects|<|string|Follow response redirects while polling data.<br>Supported for HTTP\_AGENT items.<br>Possible values:^[1](#footnotes)^ NO (0), YES (1, default).| |post\_type|<|string|Type of post data body.<br>Supported for HTTP\_AGENT items.<br>Possible values:^[1](#footnotes)^ RAW (0, default), JSON (2), XML (3).| |http\_proxy|<|string|HTTP(S) proxy connection string.<br>Supported for HTTP\_AGENT items.| |headers|<| |Root element for HTTP(S) request headers.<br>Supported for HTTP\_AGENT items.| |<|name|string|(required for HTTP\_AGENT items) Header name.| |^|value|string|(required for HTTP\_AGENT items) Header value.| |retrieve\_mode|<|string|What part of response should be stored.<br>Supported for HTTP\_AGENT items.<br>Possible values:^[1](#footnotes)^ BODY (0, default), HEADERS (1), BOTH (2).| |request\_method|<|string|Request method type.<br>Supported for HTTP\_AGENT items.<br>Possible values:^[1](#footnotes)^ GET (0, default), POST (1), PUT (2), HEAD (3).| |output\_format|<|string|How to process response.<br>Supported for HTTP\_AGENT items.<br>Possible values:^[1](#footnotes)^ RAW (0, default), JSON (1).| |allow\_traps|<|string|Allow to populate value similarly to the trapper item.<br>Supported for HTTP\_AGENT items.<br>Possible values:^[1](#footnotes)^ NO (0, default), YES (1).| |ssl\_cert\_file|<|string|Public SSL Key file path.<br>Supported for HTTP\_AGENT items.| |ssl\_key\_file|<|string|Private SSL Key file path.<br>Supported for HTTP\_AGENT items.| |ssl\_key\_password|<|string|Password for SSL Key file.<br>Supported for HTTP\_AGENT items.| |verify\_peer|<|string|Whether to validate that the host's certificate is authentic.<br>Supported for HTTP\_AGENT items.<br>Possible values:^[1](#footnotes)^ NO (0, default), YES (1).| |verify\_host|<|string|Whether to validate that the host name for the connection matches the one in the host's certificate.<br>Supported for HTTP\_AGENT items.<br>Possible values:^[1](#footnotes)^ NO (0, default), YES (1).| |tags|<| |Root element for item tags.| |<|tag|string|(required) Tag name.| |^|value|string|Tag value.| |triggers|<|<|Root element for [template item triggers](#template-item-triggers).| ::: noteclassic See also: [Item object](/manual/api/reference/item/object) (refer to the relevant property with a matching name). ::: ##### ایتم های قالب |Élément|Propriété de l'élement|Requis|Type|Intervalle^**[1](#Notes de bas de page)**^|Description| |-------|----------------|--------|----|--------------------------|-----------| |items|<|\-|<|<|Élément racine pour les éléments.| |<|uuid|x|`chaîne`|<|Identifiant unique de l'élément.| |<|name|x|`chaîne`|<|Nom de l'élément.| |<|type|\-|`chaîne`|0 - ZABBIX\_PASSIVE (par défaut)<br>2 - TRAP<br>3 - SIMPLE<br>5 - INTERNAL<br>7 - ZABBIX\_ACTIVE<br>10 - EXTERNAL<br>11 - ODBC<br>12 - IPMI<br>13 - SSH<br>14 - TELNET<br>15 - CALCULATED<br>16 - JMX<br>17 - SNMP\_TRAP<br>18 - DEPENDENT<br>19 - HTTP\_AGENT<br>20 - SNMP\_AGENT<br>21 - ITEM\_TYPE\_SCRIPT|Type d'élément.| |<|snmp\_oid|\-|`chaîne`|<| ID d'objet SNMP.<br><br>Obligatoire pour les éléments SNMP.| |<|key|x|`chaîne`|<|Clé de l'élément.| |<|delay|\-|`chaîne`|Par défaut : 1m|Intervalle de mise à jour de l'élément.<br><br>Accepte les secondes ou une unité de temps avec suffixe (30s, 1m, 2h, 1d).<br>Éventuellement un ou plusieurs [intervalles personnalisés](/manual/config/items/item/custom_intervals) peuvent être spécifiés en tant qu'intervalles flexibles ou planifiés.<br>Les intervalles multiples sont séparés par un point-virgule.<br>Des macros utilisateur peuvent être utilisées. Une seule macro doit remplir tout le champ. Les macros multiples dans un champ ou les macros mixées avec du texte ne sont pas prises en charge.<br>Les intervalles flexibles peuvent être écrits sous la forme de deux macros séparées par une slash (par exemple `{$FLEX_INTERVAL}/{$FLEX_PERIOD}`).| |<|history|\-|`chaîne`|Par défaut : 90d|Unité de temps de la durée pendant laquelle les données d’historique doivent être stockées. Unité de temps avec suffixe, macro utilisateur ou macro LLD.| |<|trends|\-|`chaîne`|Par défaut : 365d|Unité de temps de la durée pendant laquelle les données de tendances doivent être stockées. Unité de temps avec suffixe, macro utilisateur ou macro LLD.| |<|status|\-|`chaîne`|0 - ENABLED (par défaut)<br>1 - DISABLED|Statut de l'élément..| |<|value\_type|\-|`chaîne`|0 - FLOAT<br>1 - CHAR<br>2 - LOG<br>3 - UNSIGNED (par défaut)<br>4 - TEXT|Type de valeur reçue.| |<|allowed\_hosts|\-|`chaîne`|<|Liste d'adresses IP (séparées par des virgules) des hôtes autorisés à envoyer des données à l'élément.<br><br>Utilisé pour les éléments de types Trapper et Agent HTTP.| |<|units|\-|`chaîne`|<|Unités de valeurs retournées (bps, B, etc.).| |<|params|\-|`texte`|<|Paramètres supplémentaires selon le type d'élément :<br>- script exécuté pour les éléments de types Script, SSH et Telnet;<br>- requête SQL pour les éléments de surveillance des bases de données;<br>- formule pour les éléments calculés.| |<|ipmi\_sensor|\-|`chaîne`|<|Capteur IPMI.<br><br>Utilisé uniquement par les éléments IPMI.| |<|authtype|\-|`chaîne`|Type d'authentification pour les éléments de type Agent SSH :<br>0 - PASSWORD (par défaut)<br>1 - PUBLIC\_KEY<br><br>Type d'authentification pour les éléments de type Agent HTTP :<br>0 - NONE (par défaut)<br>1 - BASIC<br>2 - NTLM|Type d'authentification.<br><br>Utilisé uniquement par les éléments de type Agent SSH et Agent HTTP.| |<|username|\-|`chaîne`|<|Nom d'utilisateur pour l'authentification.<br>Utilisé par les éléments de type Vérification Simple, SSH, Telnet, surveillance des bases de données, JMX et Agent HTTP.<br><br>Obligatoire pour les éléments SSH et Telnet.<br>Lorsqu'il est utilisé par l'agent JMX, le mot de passe doit également être spécifié avec le nom d'utilisateur ou les deux propriétés doivent être laissées vides.| |<|password|\-|`chaîne`|<|Mot de passe pour l'authentification.<br>Utilisé par les éléments de type Vérification Simple, SSH, Telnet, surveillance des bases de données, JMX et Agent HTTP.<br><br>Lorsqu'il est utilisé par l'agent JMX, le nom d'utilisateur doit également être spécifié avec le mot de passe ou les deux propriétés doivent être laissées vides.| |<|publickey|\-|`chaîne`|<|Nom du fichier de clé publique.<br><br>Obligatoire pour les éléments de type Agent SSH.| |<|privatekey|\-|`chaîne`|<|Nom du fichier de clé privée.<br><br>Obligatoire pour les éléments de type Agent SSH.| |<|port|\-|`chaîne`|<|Port personnalisé surveillé par l'élément.<br>Peut contenir des macros utilisateur.<br><br>Utilisé uniquement par les éléments SNMP.| |<|description|\-|`texte`|<|Description de l'élément.| |<|inventory\_link|\-|`chaîne`|0 - NONE<br><br>Nom du champ d'inventaire de l'hôte en majuscules. Par exemple :<br>4 - ALIAS<br>6 - OS\_FULL<br>14 - HARDWARE<br>etc.|Champ d'inventaire de l'hôte rempli par l'élément.<br><br>Se reporter à la [page d'inventaire de l'hôte](/manual/api/reference/host/object#host_inventory) pour obtenir la liste des champs d'inventaire d'hôte pris en charge et leurs ID.| |<|logtimefmt|\-|`chaîne`|<|Format de l'heure dans les entrées de journal.<br>Utilisé uniquement par les éléments de type Journal.| |<|jmx\_endpoint|\-|`chaîne`|<|Point de terminaison JMX.<br><br>Utilisé uniquement par les éléments de type Agent JMX.| |<|url|\-|`chaîne`|<|Chaîne URL.<br><br>Obligatoire pour les éléments de type Agent HTTP.| |<|allow\_traps|\-|`chaîne`|0 - NO (par défaut)<br>1 - YES|Autorise à remplir la valeur comme dans un élément de type Trapper.<br><br>Utilisé uniquement par les éléments de type Agent HTTP.| |<|follow\_redirects|\-|`chaîne`|0 - NO<br>1 - YES (par défaut)|Suivre les redirections HTTP.<br><br>Utilisé uniquement par les éléments de type Agent HTTP.| |headers|<|\-|<|<|Élément racine pour les en-têtes de requête HTTP(S), où le nom de l'en-tête est utilisé comme clé et la valeur de l'en-tête comme valeur.<br>Utilisé uniquement par les éléments de type Agent HTTP.| |<|name|x|`chaîne`|<|Nom de l'en-tête.| |<|value|x|`chaîne`|<|Valeur de l'en-tête.| |<|http\_proxy|\-|`chaîne`|<|Chaîne de connexion du proxy HTTP(S).<br><br>Utilisé uniquement par les éléments de type Agent HTTP.| |<|output\_format|\-|`chaîne`|0 - RAW (par défaut)<br>1 - JSON|Comment traiter la réponse.<br><br>Utilisé uniquement par les éléments de type Agent HTTP.| |<|post\_type|\-|`chaîne`|0 - RAW (par défaut)<br>2 - JSON<br>3 - XML|Type de corps de données posté.<br><br>Utilisé uniquement par les éléments de type Agent HTTP.| |<|posts|\-|`chaîne`|<|Données du corps de la requête HTTP(S).<br><br>Utilisé uniquement par les éléments de type Agent HTTP.| |query\_fields|<|\-|<|<|Élément racine pour les paramètres de requête.<br><br>Utilisé uniquement par les éléments de type Agent HTTP.| |<|name|x|`chaîne`|<|Nom du paramètre.| |<|value|\-|`chaîne`|<|Valeur du paramètre.| |<|request\_method|\-|`chaîne`|0 - GET (par défaut)<br>1 - POST<br>2 - PUT<br>3 - HEAD|Méthode de requête.<br><br>Utilisé uniquement par les éléments de type Agent HTTP.| |<|retrieve\_mode|\-|`chaîne`|0 - BODY (par défaut)<br>1 - HEADERS<br>2 - BOTH|Quelle partie de la réponse doit être stockée.<br><br>Utilisé uniquement par les éléments de type Agent HTTP.| |<|ssl\_cert\_file|\-|`chaîne`|<|Chemin du fichier de la clé SSL publique.<br><br>Utilisé uniquement par les éléments de type Agent HTTP.| |<|ssl\_key\_file|\-|`chaîne`|<|Chemin du fichier de la clé SSL privée.<br><br>Utilisé uniquement par les éléments de type Agent HTTP.| |<|ssl\_key\_password|\-|`chaîne`|<|Mot de passe pour le fichier de la clé SSL.<br><br>Utilisé uniquement par les éléments de type Agent HTTP.| |<|status\_codes|\-|`chaîne`|<|Plages de codes d'état HTTP requis, séparées par des virgules. Supporte les macros utilisateur.<br>Par exemple : 200,200-{$M},{$M},200-400<br><br>Utilisé uniquement par les éléments de type Agent HTTP.| |<|timeout|\-|`chaîne`|<|Délai d'expiration de la requête d'interrogation de données de l'élément . Supporte les macros utilisateur.<br><br>Utilisé uniquement par les éléments de type Agent HTTP et Script.| |<|verify\_host|\-|`chaîne`|0 - NO (par défaut)<br>1 - YES|Valider le nom de l'hôte dans l'URL dans le champs Nom Commun ou dans le champs Nom alternatif du sujet du certificat de l'hôte.<br><br>Utilisé uniquement par les éléments de type Agent HTTP.| |<|verify\_peer|\-|`chaîne`|0 - NO (par défaut)<br>1 - YES|Valider l'authenticité du certificat<br><br>Utilisé uniquement par les éléments de type Agent HTTP.| |parameters|<|\-|<|<|Élément racine pour les paramètres définis par l'utilisateur.<br><br>Utilisé uniquement par les éléments de type Script.| |<|name|x|`chaîne`|<|Nom du paramètre.<br><br>Utilisé uniquement par les éléments de type Script.| |<|value|\-|`chaîne`|<|Valeur du paramètre.<br><br>Utilisé uniquement par les éléments de type Script.| |value map|<|\-|<|<|Table de correspondances de valeurs.| |<|name|x|`chaîne`|<|Nom de la table de correspondances à utiliser pour l'élément.| |preprocessing|<|\-|<|<|Élément racine pour le prétraitement de la valeur de l'élément.| |step|<|\-|<|<|Étape de prétraitement de la valeur d'un élément individuel.| |<|type|x|`chaîne`|1 - MULTIPLIER<br>2 - RTRIM<br>3 - LTRIM<br>4 - TRIM<br>5 - REGEX<br>6 - BOOL\_TO\_DECIMAL<br>7 - OCTAL\_TO\_DECIMAL<br>8 - HEX\_TO\_DECIMAL<br>9 - SIMPLE\_CHANGE (calculé par (valeur reçue-valeur précédente))<br>10 - CHANGE\_PER\_SECOND (calculé par (valeur reçue-valeur précédente)/(heure actuelle-heure de la dernière vérification))<br>11 - XMLPATH<br>12 - JSONPATH<br>13 - IN\_RANGE<br>14 - MATCHES\_REGEX<br>15 - NOT\_MATCHES\_REGEX<br>16 - CHECK\_JSON\_ERROR<br>17 - CHECK\_XML\_ERROR<br>18 - CHECK\_REGEX\_ERROR<br>19 - DISCARD\_UNCHANGED<br>20 - DISCARD\_UNCHANGED\_HEARTBEAT<br>21 - JAVASCRIPT<br>22 - PROMETHEUS\_PATTERN<br>23 - PROMETHEUS\_TO\_JSON<br>24 - CSV\_TO\_JSON<br>25 - STR\_REPLACE<br>26 - CHECK\_NOT\_SUPPORTED|Type de l'étape de prétraitement de la valeur de l'élément.| |<|parameters|\-|<|<|Élément racine pour les paramètres de l'étape de prétraitement de la valeur de l'élément.| |<|parameter|x|`chaîne`|<|Paramètre individuel de l'étape de prétraitement de la valeur de l'élément.| |<|error\_handler|\-|`chaîne`|0 - ORIGINAL\_ERROR (par défaut)<br>1 - DISCARD\_VALUE<br>2 - CUSTOM\_VALUE<br>3 - CUSTOM\_ERROR|Type d'action utilisé en cas d'échec de l'étape de prétraitement.| |<|error\_handler\_params|\-|`chaîne`|<|Paramètres du gestionnaire d'erreurs utilisés avec 'error\_handler'.| |master\_item|<|\-|<|<|Elément principal de l'élément individuel.<br><br>Obligatoire pour les éléments dépendants.| |<|key|x|`chaîne`|<|Valeur de clé de l'élément principal de l'élément dépendant.<br><br>Une récursivité allant jusqu'à 3 éléments dépendants et un nombre maximal d'éléments dépendants égal à 29999 sont autorisés.| |triggers|<|\-|<|<|Élément racine pour les déclencheurs simples.| |<|*Pour obtenir les valeurs de tags des déclencheurs, voir [Tags de déclencheur](/manual/xml_export_import/templates#template_trigger_tags).*|<|<|<|<| |tags|<|\-|<|<|Elément racine pour les tags d'élément.| |<|tag|x|`chaîne`|<|Nom du tag.| |<|value|\-|`string`|<|Valeur du tag.| ##### Template item triggers ```yaml zabbix_export: (...) templates: (...) items: (...) - uuid: 58818005e76d46dda14d6592f601ab00 (...) triggers: - uuid: b950c306394f4b3c902060a8273cbcde expression: 'change(/Linux by Zabbix agent/system.sw.packages.get)<>0' name: 'Linux: Number of installed packages has been changed' priority: WARNING manual_close: 'YES' tags: - tag: scope value: notice (...) - uuid: 403cebed115441369e94d35d070ca7b8 (...) triggers: - uuid: cfd395b1cde74ef18a5e5f840bd5142a expression: 'min(/Linux by Zabbix agent/vm.memory.utilization,5m)>{$MEMORY.UTIL.MAX}' name: 'Linux: High memory utilization' event_name: 'Linux: High memory utilization (>{$MEMORY.UTIL.MAX}% for 5m)' priority: AVERAGE description: 'The system is running out of free memory.' dependencies: - name: 'Linux: Lack of available memory' expression: 'max(/Linux by Zabbix agent/vm.memory.size[available],5m)<{$MEMORY.AVAILABLE.MIN} and last(/Linux by Zabbix agent/vm.memory.size[total])>0' tags: - tag: scope value: capacity - tag: scope value: performance (...) ``` |Element|<|Type|Description| |-|---|---|-----------------------| |uuid|<|string|(required) Unique identifier for this trigger.| |expression|<|string|(required) Trigger expression.| |recovery\_mode|<|string|Basis for generating OK events.<br>Possible values:^[1](#footnotes)^ EXPRESSION (0, default), RECOVERY\_EXPRESSION (1), NONE (2).| |recovery\_expression|<|string|Trigger recovery expression.| |correlation\_mode|<|string|Correlation mode (no event correlation or event correlation by tag).<br>Possible values:^[1](#footnotes)^ DISABLED (0, default), TAG\_VALUE (1).| |correlation\_tag|<|string|The tag name to be used for event correlation.| |name|<|string|(required) Trigger name.| |event\_name|<|string|Event name.| |opdata|<|string|Operational data.| |url\_name|<|string|Label for the URL associated with the trigger.| |url|<|string|URL associated with the trigger.| |status|<|string|Trigger status.<br>Possible values:^[1](#footnotes)^ ENABLED (0, default), DISABLED (1).| |priority|<|string|Trigger severity.<br>Possible values:^[1](#footnotes)^ NOT\_CLASSIFIED (0, default), INFO (1), WARNING (2), AVERAGE (3), HIGH (4), DISASTER (5).| |description|<|text|Trigger description.| |type|<|string|Event generation type (single problem event or multiple problem events).<br>Possible values:^[1](#footnotes)^ SINGLE (0, default), MULTIPLE (1).| |manual\_close|<|string|Manual closing of problem events.<br>Possible values:^[1](#footnotes)^ NO (0, default), YES (1).| |dependencies|<| |Root element for dependencies.| |<|name|string|(required) Dependency trigger name.| |^|expression|string|(required) Dependency trigger expression.| |^|recovery\_expression|string|Dependency trigger recovery expression.| |tags|<| |Root element for trigger tags.| |<|tag|string|(required) Tag name.| |^|value|string|Tag value.| ::: noteclassic See also: [Trigger object](/manual/api/reference/trigger/object) (refer to the relevant property with a matching name). ::: ##### محرکهای آیتم قالب ```yaml zabbix_export: (...) قالبها: (...) آیتمها: (...) - uuid: 58818005e76d46dda14d6592f601ab00 (...) محرکها: - uuid: b950c306394f4b3c902060a8273cbcde عبارت: 'change(/Linux by Zabbix agent/system.sw.packages.get)<>0' نام: 'لینوکس: تعداد بستههای نصب شده تغییر کرده است' اولویت: هشدار manual_close: 'بله' برچسبها: - برچسب: scope مقدار: notice (...) - uuid: 403cebed115441369e94d35d070ca7b8 (...) تریگرها: - uuid: cfd395b1cde74ef18a5e5f840bd5142a عبارت: 'min(/Linux by Zabbix agent/vm.memory.utilization,5m)>{$MEMORY.UTIL.MAX}' نام: 'لینوکس: استفاده از حافظه بالا' نام_رویداد: 'لینوکس: استفاده از حافظه بالا (>{$MEMORY.UTIL.MAX}% برای 5m)' اولویت: AVERAGE توضیحات: 'حافظه آزاد سیستم در حال اتمام است.' وابستگیها: - نام: 'لینوکس: کمبود حافظه موجود' عبارت: 'max(/Linux by Zabbix agent/vm.memory.size[available],5m)<{$MEMORY.AVAILABLE.MIN} and last(/Linux by Zabbix agent/vm.memory.size[total])>0' برچسبها: - برچسب: scope value: capacity - برچسب: scope value: performance (...) ``` |عنصر|<|نوع|توضیحات| |-|---|---|----------------------| |uuid|<|string|(الزامی) شناسه منحصر به فرد برای این تریگر.| |عبارت|<|string|(الزامی) عبارت تریگر.| |recovery\_mode|<|string|مبنای تولید رویدادهای OK.<br>مقادیر ممکن:^[1](#footnotes)^ EXPRESSION (0، پیشفرض)، RECOVERY\_EXPRESSION (1)، NONE (2).| |recovery\_expression|<|string|عبارت بازیابی فعالکننده.| |correlation\_mode|<|string|حالت همبستگی (بدون همبستگی رویداد یا همبستگی رویداد بر اساس برچسب).<br>مقادیر ممکن:^[1](#footnotes)^ DISABLED (0، پیشفرض)، TAG\_VALUE (1).| |correlation\_tag|<|string|نام برچسبی که برای همبستگی رویداد استفاده میشود.| |name|<|string|(الزامی) نام فعالکننده.| |event\_name|<|string|نام رویداد.| |opdata|<|string|دادههای عملیاتی.| |url\_name|<|string|برچسب برای URL مرتبط با trigger.| |url|<|string|URL مرتبط با trigger.| |status|<|string|وضعیت trigger.<br>مقادیر ممکن:^[1](#footnotes)^ فعال (0، پیشفرض)، غیرفعال (1).| |priority|<|string|شدت trigger.<br>مقادیر ممکن:^[1](#footnotes)^ طبقهبندی نشده (0، پیشفرض)، اطلاعات (1)، هشدار (2)، میانگین (3)، بالا (4)، فاجعه (5).| |توضیحات|<|متن|توضیحات trigger.| |نوع|<|رشته|نوع تولید رویداد (رویداد تک مسئله یا چندین رویداد مسئله).<br>مقادیر ممکن:^[1](#footnotes)^ تک (0، پیشفرض)، چندگانه (1).| |دستی\_بستن|<|رشته|بستن دستی رویدادهای مسئله.<br>مقادیر ممکن:^[1](#footnotes)^ خیر (0، پیشفرض)، بله (1).| |وابستگیها|<| |عنصر ریشه برای وابستگیها.| |<|نام|رشته|(الزامی) نام ماشه وابستگی.| |^|عبارت|رشته|(الزامی) عبارت ماشه وابستگی.| |^|عبارت بازیابی\_عبارت|رشته|عبارت بازیابی ماشه وابستگی.| |برچسبها|<| |عنصر ریشه برای برچسبهای ماشه.| |<|برچسب|رشته|(الزامی) نام برچسب.| |^|مقدار|رشته|مقدار برچسب.| ::: noteclassic همچنین ببینید: [Trigger object](/manual/api/reference/trigger/object) (به ویژگی مربوطه با نام منطبق مراجعه کنید). ::: ##### Template item value preprocessing steps ```yaml zabbix_export: (...) templates: (...) items: (...) - uuid: 58818005e76d46dda14d6592f601ab00 (...) preprocessing: - type: JSONPATH parameters: - $.length() - type: DISCARD_UNCHANGED_HEARTBEAT parameters: - 12h (...) ``` |Element|<|Type|Description| |-|---|---|-----------------------| |type|<|string|(required) The item value preprocessing step type.<br>Possible values:^[1](#footnotes)^ MULTIPLIER (1), RTRIM (2), LTRIM (3), TRIM (4), REGEX (5), BOOL\_TO\_DECIMAL (6), OCTAL\_TO\_DECIMAL (7), HEX\_TO\_DECIMAL (8), SIMPLE\_CHANGE (9, calculated: received value - previous value), CHANGE\_PER\_SECOND (10, calculated: (received value - previous value)/(time now - time of last check)), XMLPATH (11), JSONPATH (12), IN\_RANGE (13), MATCHES\_REGEX (14), NOT\_MATCHES\_REGEX (15), CHECK\_JSON\_ERROR (16), CHECK\_XML\_ERROR (17), CHECK\_REGEX\_ERROR (18), DISCARD\_UNCHANGED (19), DISCARD\_UNCHANGED\_HEARTBEAT (20), JAVASCRIPT (21), PROMETHEUS\_PATTERN (22), PROMETHEUS\_TO\_JSON (23), CSV\_TO\_JSON (24), STR\_REPLACE (25), CHECK\_NOT\_SUPPORTED (26), XML\_TO\_JSON (27), SNMP\_WALK\_VALUE (28), SNMP\_WALK\_TO\_JSON (29), SNMP\_GET\_VALUE (30).| |parameters|<| |(required) Root element for parameters of the item value preprocessing step.| | |parameter|string|Individual parameter of the item value preprocessing step.| |error\_handler|<|string|Action type used in case of preprocessing step failure.<br>Possible values:^[1](#footnotes)^ ORIGINAL\_ERROR (0, default), DISCARD\_VALUE (1), CUSTOM\_VALUE (2), CUSTOM\_ERROR (3).| |error\_handler\_params|<|string|Error handler parameters.| ::: noteclassic See also: [Item preprocessing object](/manual/api/reference/item/object#item-preprocessing) (refer to the relevant property with a matching name). ::: ##### مراحل پیشپردازش مقدار آیتم قالب ```yaml zabbix_export: (...) قالبها: (...) آیتمها: (...) - uuid: 58818005e76d46dda14d6592f601ab00 (...) پیشپردازش: - type: JSONPATH پارامترها: - $.length() - type: DISCARD_UNCHANGED_HEARTBEAT پارامترها: - 12h (...) ``` |Element|<|Type|Description| |-|---|---|----------------------| |type|<|string|(الزامی) نوع مرحله پیشپردازش مقدار آیتم.<br>مقادیر ممکن: ^[1](#footnotes)^ MULTIPLIER (1)، RTRIM (2)، LTRIM (3)، TRIM (4)، REGEX (5)، BOOL\_TO\_DECIMAL (6)، OCTAL\_TO\_DECIMAL (7)، HEX\_TO\_DECIMAL (8)، SIMPLE\_CHANGE (9، محاسبه شده: مقدار دریافتی - مقدار قبلی)، CHANGE\_PER\_SECOND (10، محاسبه شده: (مقدار دریافتی - مقدار قبلی)/(زمان اکنون - زمان آخرین بررسی))، XMLPATH (11)، JSONPATH (12)، IN\_RANGE (13)، MATCHES\_REGEX (14)، NOT\_MATCHES\_REGEX (15)، CHECK\_JSON\_ERROR (16)، بررسی\_XML\_ERROR (17)، بررسی\_REGEX\_ERROR (18)، DISCARD\_UNCHANGED (19)، DISCARD\_UNCHANGED\_HEARTBEAT (20)، JAVASCRIPT (21)، PROMETHEUS\_PATTERN (22)، PROMETHEUS\_TO\_JSON (23)، CSV\_TO\_JSON (24)، STR\_REPLACE (25)، بررسی\_NOT\_SUPPORTED (26)، XML\_TO\_JSON (27)، SNMP\_WALK\_VALUE (28)، SNMP\_WALK\_TO\_JSON (29)، SNMP\_GET\_VALUE (30).| |parameters|<| |(الزامی) عنصر ریشه برای پارامترهای مرحله پیشپردازش مقدار آیتم.| | |parameter|string|پارامتر منحصر به فرد مرحله پیشپردازش مقدار آیتم.| |error\_handler|<|string|نوع عملی که در صورت شکست مرحله پیشپردازش استفاده میشود.<br>مقادیر ممکن:^[1](#footnotes)^ ORIGINAL\_ERROR (0، پیشفرض)، DISCARD\_VALUE (1)، CUSTOM\_VALUE (2)، CUSTOM\_ERROR (3).| |error\_handler\_params|<|string|پارامترهای مدیریت خطا.| ::: noteclassic همچنین ببینید: [شیء پیشپردازش آیتم](/manual/api/reference/item/object#item-preprocessing) (به ویژگی مربوطه با نام منطبق مراجعه کنید). ::: ##### Template low-level discovery rule filters ```yaml zabbix_export: (...) templates: (...) discovery_rules: - uuid: acfdea9c46ef48c68e6636f43b8f96a2 (...) filter: evaltype: AND conditions: - macro: '{#IFNAME}' value: '{$NET.IF.IFNAME.MATCHES}' - macro: '{#IFNAME}' value: '{$NET.IF.IFNAME.NOT_MATCHES}' operator: NOT_MATCHES_REGEX (...) - uuid: 2bbdc79f082d4c618e01bec625e9c90a (...) filter: evaltype: AND conditions: - macro: '{#DEVNAME}' value: '{$VFS.DEV.DEVNAME.MATCHES}' - macro: '{#DEVNAME}' value: '{$VFS.DEV.DEVNAME.NOT_MATCHES}' operator: NOT_MATCHES_REGEX - macro: '{#DEVTYPE}' value: disk (...) ``` |Element|<|Type|Description| |-|---|---|-----------------------| |evaltype|<|string|Override filter condition evaluation method.<br>Possible values:^[1](#footnotes)^ AND\_OR (0, default), AND (1), OR (2), FORMULA (3).| |formula|<|string|Custom calculation formula for filter conditions.| |conditions|<| |Root element for filter conditions.| |<|macro|string|(required) The name of the low-level discovery macro to perform the check on.| |^|value|string|Value to compare with.| |^|operator|string|Condition operator.<br>Possible values:^[1](#footnotes)^ MATCHES\_REGEX (8, default), NOT\_MATCHES\_REGEX (9).| |^|formulaid|string|(required) Arbitrary unique ID that is used to reference a condition from the custom expression. Can only contain capital-case letters. The ID must be defined by the user when modifying filter conditions, but will be generated anew when requesting them afterward.| ::: noteclassic See also: [LLD rule filter object](/manual/api/reference/discoveryrule/object#lld-rule-filter) (refer to the relevant property with a matching name). ::: ##### فیلترهای قانون کشف سطح پایین قالب ``yaml zabbix_export: (...) قالبها: (...) discovery_rules: - uuid: acfdea9c46ef48c68e6636f43b8f96a2 (...) filter: evaltype: AND conditions: - macro: '{#IFNAME}' value: '{$NET.IF.IFNAME.MATCHES}' - macro: '{#IFNAME}' value: '{$NET.IF.IFNAME.NOT_MATCHES}' operator: NOT_MATCHES_REGEX (...) - uuid: 2bbdc79f082d4c618e01bec625e9c90a (...) filter: evaltype: AND conditions: - macro: '{#DEVNAME}' مقدار: '{$VFS.DEV.DEVNAME.MATCHES}' - ماکرو: '{#DEVNAME}' مقدار: '{$VFS.DEV.DEVNAME.NOT_MATCHES}' عملگر: NOT_MATCHES_REGEX - ماکرو: '{#DEVTYPE}' مقدار: دیسک (...) ``` |عنصر|<|نوع|توضیحات| |-|---|---|---------------------| |evaltype|<|string|روش ارزیابی شرط فیلتر را لغو کنید.<br>مقادیر ممکن:^[1](#footnotes)^ AND\_OR (0، پیشفرض)، AND (1)، OR (2)، FORMULA (3).| |formula|<|string|فرمول محاسبه سفارشی برای شرطهای فیلتر.| |شرطها|<| |عنصر ریشه برای شرطهای فیلتر.| |<|macro|string|(الزامی) نام ماکروی کشف سطح پایین برای انجام بررسی.| |^|مقدار|رشته|مقداری که باید با آن مقایسه شود.| |^|عملگر|رشته|عملگر شرط.<br>مقادیر ممکن:^[1](#footnotes)^ MATCHES\_REGEX (8، پیشفرض)، NOT\_MATCHES\_REGEX (9).| |^|formulaid|string|(الزامی) شناسهی دلخواه و منحصر به فردی که برای ارجاع به یک شرط از عبارت سفارشی استفاده میشود. فقط میتواند شامل حروف بزرگ باشد. شناسه باید هنگام تغییر شرایط فیلتر توسط کاربر تعریف شود، اما هنگام درخواست مجدد آنها، دوباره تولید میشود.| ::: noteclassic همچنین ببینید: [LLD rule filter object](/manual/api/reference/discoveryrule/object#lld-rule-filter) (به ویژگی مربوطه با نام منطبق مراجعه کنید). ::: ##### Template low-level discovery rule override operations |Element|<|Type|Description| |-|---|---|-----------------------| |operationobject|<|string|Object to which the operation is applied.<br>Possible values:^[1](#footnotes)^ ITEM_PROTOTYPE (0), TRIGGER_PROTOTYPE (1), GRAPH_PROTOTYPE (2), HOST_PROTOTYPE (3).| |operator|<|string|Override condition operator.<br>Possible values:^[1](#footnotes)^ EQUAL (1), NOT_EQUAL (2), LIKE (3), NOT_LIKE (4), REGEXP (5), NOT_REGEXP (6).| |value|<|string|A regular expression or a string for the override condition operator.| |status|<|string|Status of the object upon the override operation.| |discover|<|string|Whether the object is added as a result of the discovery.| |delay|<|string|Update interval set for the item prototype upon the override operation.| |history|<|string|History storage period set for the item prototype upon the override operation.| |trends|<|string|Trend storage period set for the item prototype upon the override operation.| |severity|<|string|Trigger prototype severity set upon the override operation.| |tags|<| |Root element for the tags set for the object upon the override operation.| |<|tag|string|(required) Tag name.| |^|value|string|Tag value.| |templates|<| |Root element for the templates linked to the host prototype upon the override operation.| | |name|string|(required) Template name.| |inventory_mode|<|string|Host prototype inventory mode set upon the override operation.| ::: noteclassic See also: [LLD rule override operation object](/manual/api/reference/discoveryrule/object#lld-rule-override-operation) (refer to the relevant property with a matching name). ::: ##### عملیات لغو قانون کشف سطح پایین الگو |عنصر|<|نوع|توضیحات| |-|---|---|----------------------| |شیء عملیات|<|رشته|شیئی که عملیات روی آن اعمال میشود.<br>مقادیر ممکن:^[1](#footnotes)^ ITEM_PROTOTYPE (0)، TRIGGER_PROTOTYPE (1)، GRAPH_PROTOTYPE (2)، HOST_PROTOTYPE (3).| |عملگر|<|رشته|عملگر شرط لغو.<br>مقادیر ممکن:^[1](#footnotes)^ EQUAL (1)، NOT_EQUAL (2)، LIKE (3)، NOT_LIKE (4)، REGEXP (5)، NOT_REGEXP (6).| |مقدار|<|رشته|یک عبارت منظم یا یک رشته برای عملگر شرط لغو.| |وضعیت|<|رشته|وضعیت شیء پس از عملیات لغو.| |کشف|<|رشته|آیا شیء در نتیجه کشف اضافه شده است.| |تأخیر|<|رشته|فاصله زمانی بهروزرسانی برای نمونه اولیه آیتم پس از عملیات لغو تنظیم شده است.| |تاریخچه|<|رشته|دوره ذخیرهسازی تاریخچه برای نمونه اولیه آیتم پس از عملیات لغو تنظیم شده است.| |روندها|<|رشته|دوره ذخیرهسازی روند برای نمونه اولیه آیتم پس از عملیات لغو تنظیم شده است.| |شدت|<|رشته|شدت نمونه اولیه را پس از عملیات لغو تنظیم شده است.| |برچسبها|<| |عنصر ریشه برای برچسبهای تنظیم شده برای شیء پس از عملیات لغو.| |<|برچسب|رشته|(الزامی) نام برچسب.| |^|مقدار|رشته|مقدار برچسب.| |قالبها|<| |عنصر ریشه برای قالبهای پیوند داده شده به نمونه اولیه میزبان پس از عملیات لغو.| |نام|رشته|(الزامی) نام الگو.| |inventory_mode|<|string|حالت موجودی نمونه اولیه میزبان که بر اساس عملیات لغو تنظیم میشود.| ::: noteclassic همچنین ببینید: [شیء عملیات لغو قانون LLD](/manual/api/reference/discoveryrule/object#lld-rule-override-operation) (به ویژگی مربوطه با نام منطبق مراجعه کنید). ::: #### Template low-level discovery rules ```yaml zabbix_export: (...) templates: (...) discovery_rules: - uuid: acfdea9c46ef48c68e6636f43b8f96a2 name: 'Network interface discovery' key: net.if.discovery delay: 1h filter: (see table below) description: 'The discovery of network interfaces.' item_prototypes: (see table below) trigger_prototypes: (see table below) graph_prototypes: (see table below) (...) ``` ::: noteimportant Most template low-level discovery rule elements are the same as for [template items](#template-items). The table below describes those elements that differ from template items. ::: |Element|<|Type|Description| |-|---|---|-----------------------| |type|<|string|Item type.<br>Possible values:^[1](#footnotes)^ ZABBIX\_PASSIVE (0, default), TRAP (2), SIMPLE (3), INTERNAL (5), ZABBIX\_ACTIVE (7), EXTERNAL (10), ODBC (11), IPMI (12), SSH (13), TELNET (14), JMX (16), DEPENDENT (18), HTTP\_AGENT (19), SNMP\_AGENT (20), ITEM\_TYPE\_SCRIPT (21), ITEM\_TYPE\_BROWSER (22).| |key|<|string|(required) The low-level discovery rule key.| |filter|<| |Root element for [template low-level discovery rule filters](#template-low-level-discovery-rule-filters).| |lifetime|<|string|Time period (using seconds, [time suffix](/manual/appendix/suffixes#time-suffixes), or [user macro](/manual/config/macros/user_macros)), after which no longer discovered resources will be deleted.<br>Default: 7d.| |lifetime_type|<|string|Scenario for deleting lost LLD resources.<br>Possible values: DELETE\_NEVER, DELETE\_IMMEDIATELY, DELETE\_AFTER.| |enabled_lifetime|<|string|Time period (using seconds, [time suffix](/manual/appendix/suffixes#time-suffixes), or [user macro](/manual/config/macros/user_macros)), after which no longer discovered resources will be disabled.| |enabled_lifetime_type|<|string|Scenario for disabling lost LLD resources.<br>Possible values: DISABLE\_NEVER, DISABLE\_IMMEDIATELY, DISABLE\_AFTER.| |item\_prototypes|<| |Root element for template item prototype elements, which are the same as for [template items](#template-items).| |trigger\_prototypes|<| |Root element for template trigger prototype elements, which are the same as for [template item triggers](#template-item-triggers).| |graph\_prototypes|<| |Root element for template graph prototype elements, which are the same as for [host graphs](/manual/xml_export_import/hosts#host-graphs).| |host\_prototypes|<| |Root element for template host prototype elements, which are the same as for [hosts](/manual/xml_export_import/hosts#hosts).| |parent\_discovery\_rule|<| |Root element for the parent low-level discovery rule (or rule prototype) of the low-level discovery rule prototype. This property denotes that it is an LLD rule prototype, direct child of the referenced rule/rule prototype.| |<|key|string|(required) The parent low-level discovery rule (or rule prototype) key.| |master\_item|<|string|(required for DEPENDENT rules) Root element for the dependent rule's master item.| |lld\_macro\_paths|<| |Root element for low-level discovery rule macro paths.| |<|lld\_macro|string|(required) Low-level discovery rule macro name.| |^|path|string|(required) Selector for value, which will be assigned to the corresponding macro.| |preprocessing|<| |Root element for low-level discovery rule value preprocessing.| | |step| |Root element for low-level discovery rule value preprocessing step elements, which are the same as for [template item value preprocessing steps](#template-item-preprocessing-steps), except with fewer possible values. See also: [LLD rule preprocessing object](/manual/api/reference/discoveryrule/object#lld-rule-preprocessing).| |overrides|<| |Root element for low-level discovery rule override rules.| |<|name|string|(required) Unique override name.| |^|step|string|(required) Unique order number of the override.| |^|stop|string|Stop processing next overrides if matches.| |^|filter| |Root element for template low-level discovery rule override rule filter elements, which are the same as for [template low-level discovery rule filters](#template-low-level-discovery-rule-filters).| |^|operations| |Root element for [template low-level discovery rule override operations](#template-low-level-discovery-rule-override-operations).| ::: noteclassic See also: [LLD rule object](/manual/api/reference/discoveryrule/object) (refer to the relevant property with a matching name). ::: #### قوانین کشف سطح پایین قالب ```yaml zabbix_export: (...) templates: (...) discovery_rules: - uuid: acfdea9c46ef48c68e6636f43b8f96a2 name: 'کشف رابط شبکه' key: net.if.discovery delay: 1h filter: (به جدول زیر مراجعه کنید) description: 'کشف رابطهای شبکه.' item_prototypes: (به جدول زیر مراجعه کنید) trigger_prototypes: (به جدول زیر مراجعه کنید) graph_prototypes: (به جدول زیر مراجعه کنید) (...) ``` ::: noteimportant اکثر عناصر قانون کشف سطح پایین قالب همانند [template items](#template-items) هستند. جدول زیر عناصری را که با عناصر قالب متفاوت هستند، شرح میدهد. ::: |Element|<|Type|Description| |-|---|---|----------------------| |type|<|string|نوع آیتم.<br>مقادیر ممکن:^[1](#footnotes)^ ZABBIX\_PASSIVE (0، پیشفرض)، TRAP (2)، SIMPLE (3)، INTERNAL (5)، ZABBIX\_ACTIVE (7)، EXTERNAL (10)، ODBC (11)، IPMI (12)، SSH (13)، TELNET (14)، JMX (16)، DEPENDENT (18)، HTTP\_AGENT (19)، SNMP\_AGENT (20)، ITEM\_TYPE\_SCRIPT (21)، ITEM\_TYPE\_BROWSER (22).| |key|<|string|(الزامی) کلید قانون کشف سطح پایین.| |filter|<| |عنصر ریشه برای [فیلترهای قانون کشف سطح پایین قالب](#template-low-level-discovery-rule-filters).| |lifetime|<|string|دوره زمانی (با استفاده از ثانیه، [پسوند زمان](/manual/appendix/suffixes#time-suffixes)، یا [ماکرو کاربر](/manual/config/macros/user_macros))، که پس از آن دیگر منابع کشف نشده حذف خواهند شد.<br>پیشفرض: 7d.| |lifetime_type|<|string|سناریو برای حذف منابع LLD از دست رفته.<br>مقادیر ممکن: DELETE\_NEVER، DELETE\_IMMEDIATELY، DELETE\_AFTER.| |enabled_lifetime|<|string|دوره زمانی (با استفاده از ثانیه، [پسوند زمان](/manual/appendix/suffixes#time-suffixes)، یا [ماکرو کاربر](/manual/config/macros/user_macros))، که پس از آن دیگر منابع کشف شده غیرفعال میشوند.| |enabled_lifetime_type|<|string|سناریو برای غیرفعال کردن منابع LLD از دست رفته.<br>مقادیر ممکن: DISABLE\_NEVER، DISABLE\_IMMEDIATELY، DISABLE\_AFTER.| |item\_prototypes|<| |عنصر ریشه برای عناصر نمونه اولیه آیتم قالب، که مشابه [template items](#template-items) هستند.| |trigger\_prototypes|<| |عنصر ریشه برای عناصر نمونه اولیه آیتم قالب، که مشابه [template item triggers](#template-item-triggers) هستند.| |graph\_prototypes|<| |عنصر ریشه برای عناصر نمونه اولیه گراف الگو، که مشابه [hosts graphs](/manual/xml_export_import/hosts#host-graphs) هستند.| |host\_prototypes|<| |عنصر ریشه برای عناصر نمونه اولیه میزبان الگو، که مشابه [hosts](/manual/xml_export_import/hosts#hosts) هستند.| |parent\_discovery\_rule|<| |عنصر ریشه برای قانون کشف سطح پایین والد (یا نمونه اولیه قانون) از نمونه اولیه قانون کشف سطح پایین. این ویژگی نشان میدهد که یک نمونه اولیه قانون LLD، فرزند مستقیم قانون/نمونه اولیه قانون ارجاع شده است.| |<|key|string|(الزامی) کلید قانون کشف سطح پایین والد (یا نمونه اولیه قانون).| |master\_item|<|string|(الزامی برای قوانین وابسته) عنصر ریشه برای آیتم اصلی قانون وابسته.| |lld\_macro\_paths|<| |عنصر ریشه برای مسیرهای ماکروی قانون کشف سطح پایین.| |<|lld\_macro|string|(الزامی) نام ماکروی قانون کشف سطح پایین.| |^|path|string|(الزامی) انتخابگر برای مقداری که به ماکروی مربوطه اختصاص داده میشود.| |پیشپردازش|<| |عنصر ریشه برای پیشپردازش مقدار قانون کشف سطح پایین.| | |مرحله| |عنصر ریشه برای عناصر مرحله پیشپردازش مقدار قانون کشف سطح پایین، که مشابه [مراحل پیشپردازش مقدار آیتم الگو](#template-item-preprocessing-steps) هستند، با این تفاوت که مقادیر ممکن کمتری دارند. همچنین ببینید: [شیء پیشپردازش قانون LLD](/manual/api/reference/discoveryrule/object#lld-rule-preprocessing).| |overrides|<| |عنصر ریشه برای قوانین لغو قانون کشف سطح پایین.| |<|name|string|(الزامی) نام منحصر به فرد لغو.| |^|step|string|(الزامی) شماره ترتیب منحصر به فرد لغو.| |^|stop|string|در صورت تطابق، پردازش لغوهای بعدی را متوقف کنید.| |^|filter| |عنصر ریشه برای عناصر فیلتر لغو قانون کشف سطح پایین قالب، که مشابه [فیلترهای قانون کشف سطح پایین قالب](#template-low-level-discovery-rule-filters) هستند.| |^|operations| |عنصر ریشه برای [عملیات لغو قانون کشف سطح پایین قالب](#template-low-level-discovery-rule-override-operations).| ::: noteclassic همچنین ببینید: [LLD rule object](/manual/api/reference/discoveryrule/object) (به ویژگی مربوطه با نام منطبق مراجعه کنید). ::: #### Template macro configuration ```yaml zabbix_export: (...) templates: - uuid: f8f7908280354f2abeed07dc788c3747 (...) macros: - macro: '{$AGENT.TIMEOUT}' (...) config: type: TEXT priority: '1' label: 'Seconds since the last Zabbix agent seen' description: 'Timeout after which agent is considered unavailable.' - macro: '{$CPU.UTIL.CRIT}' (...) config: type: TEXT priority: '2' section_name: Thresholds label: 'Threshold of CPU utilization expressed' description: 'Critical threshold of CPU utilization expressed in %. In the range from 0 to 100 inclusive.' regex: '^-?([0-9]+|(([0-9]+)\.([0-9]+)))$' (...) - macro: '{$IFCONTROL}' (...) config: type: CHECKBOX priority: '19' label: 'Interfaces control' description: 'Fire a trigger when the interface operational status changes to "Link down".' options: - checked: '1' unchecked: '0' (...) ``` |Element|<|Type|Description| |-|---|---|-----------------------| |type|<|string|(required) Type of macro input field.<br>Possible values:^[1](#footnotes)^ NOCONF (0), TEXT (1), LIST (2), CHECKBOX (3).| |priority|<|string|Macro position in the macro list.| |section_name|<|string|Label of the collapsible section where the macro is grouped.| |label|<|string|(required for TEXT, LIST, CHECKBOX macros) Macro label.| |description|<|text|Macro help text. Supports Markdown formatting.| |required|<|string|Marks the macro as mandatory.<br>Possible values:^[1](#footnotes)^ NO (0), YES (1).<br>Supported for TEXT and LIST macros.| |regex|<|string|Regular expression to validate user input in a textbox field.<br>Supported for TEXT macros.| |options|<| |Root element for LIST items or CHECKBOX values.| |<|value|string|(required for LIST macros) LIST item value.| |^|text|string|(required for LIST macros) LIST item text.| |^|checked|string|(required for CHECKBOX macros) Value representing a checked state.<br>Possible values:^[1](#footnotes)^ 0 (false), 1 (true).<br>Supported for CHECKBOX macros.| |^|unchecked|string|(required for CHECKBOX macros) Value representing an unchecked state.<br>Possible values:^[1](#footnotes)^ 0 (false), 1 (true).<br>Supported for CHECKBOX macros.| ::: noteclassic See also: [Macro configuration object](/manual/api/reference/usermacro/object#macro-configuration) (refer to the relevant property with a matching name). ::: #### پیکربندی ماکروی قالب ```yaml zabbix_export: (...) قالبها: - uuid: f8f7908280354f2abeed07dc788c3747 (...) ماکروها: - ماکرو: '{$AGENT.TIMEOUT}' (...) پیکربندی: نوع: متن اولویت: '1' برچسب: 'ثانیه از آخرین مشاهده عامل زبیکس' توضیح: 'پایان زمانی که پس از آن عامل غیرقابل دسترس تلقی میشود.' - ماکرو: '{$CPU.UTIL.CRIT}' (...) پیکربندی: نوع: متن اولویت: '2' نام_بخش: آستانهها برچسب: 'آستانه استفاده از CPU بیان شده' توضیح: 'آستانه بحرانی استفاده از CPU بیان شده بر حسب %. در محدوده 0 تا 100 شامل.' regex: '^-?([0-9]+|(([0-9]+)\.([0-9]+)))$' (...) - ماکرو: '{$IFCONTROL}' (...) config: type: CHECKBOX priority: '19' label: 'کنترل رابطها' description: 'هنگامی که وضعیت عملیاتی رابط به "Link down" تغییر میکند، یک تریگر اجرا شود.' options: - checked: '1' unchecked: '0' (...) ``` |Element|<|Type|Description| |-|---|---|----------------------| |type|<|string|(required) نوع فیلد ورودی ماکرو.<br>مقادیر ممکن:^[1](#footnotes)^ NOCONF (0), TEXT (1), LIST (2), CHECKBOX (3).| |اولویت|<|رشته|موقعیت ماکرو در لیست ماکرو.| |نام_بخش|<|رشته|برچسب بخش پیشساختهای که ماکرو در آن گروهبندی شده است.| |برچسب|<|رشته|(برای ماکروهای TEXT، LIST، CHECKBOX الزامی است) برچسب ماکرو.| |توضیحات|<|متن|متن راهنمای ماکرو. از قالببندی Markdown پشتیبانی میکند.| |الزامی|<|رشته|ماکرو را به عنوان اجباری علامتگذاری میکند.<br>مقادیر ممکن:^[1](#footnotes)^ خیر (0)، بله (1).<br>برای ماکروهای TEXT و LIST پشتیبانی میشود.| |regex|<|رشته|عبارت منظم برای اعتبارسنجی ورودی کاربر در یک فیلد جعبه متن.<br>برای ماکروهای TEXT پشتیبانی میشود.| |گزینهها|<| |عنصر ریشه برای موارد LIST یا مقادیر CHECKBOX.| |<|مقدار|رشته|(برای ماکروهای LIST الزامی است) مقدار آیتم لیست.| |^|متن|رشته|(برای ماکروهای LIST الزامی است) متن آیتم لیست.| |^|چکشده|رشته|(برای ماکروهای CHECKBOX الزامی است) مقداری که نشاندهندهی یک حالت تیکدار است.<br>مقادیر ممکن:^[1](#footnotes)^ 0 (نادرست)، 1 (درست).<br>برای ماکروهای CHECKBOX پشتیبانی میشود.| |^|چکنشده|رشته|(برای ماکروهای CHECKBOX الزامی است) مقداری که نشاندهندهی یک حالت تیکنخورده است.<br>مقادیر ممکن:^[1](#footnotes)^ 0 (نادرست)، 1 (درست).<br>برای ماکروهای CHECKBOX پشتیبانی میشود.| ::: noteclassic همچنین ببینید: [شیء پیکربندی ماکرو](/manual/api/reference/usermacro/object#macro-configuration) (به ویژگی مربوطه با نام منطبق مراجعه کنید). ::: ## Template metadata ```yaml zabbix_export: version: '7.4' template_groups: - uuid: 846977d1dfed4968bc5f8bdb363285bc name: 'Templates/Operating systems' templates: (see table below) triggers: (see table below) graphs: (see table below) ``` |Element|<|Type|Description| |-|---|---|-----------------------| |version|<|string|(required) Export version.| |template_groups|<| |(required) Root element for template groups.| |<|uuid|string|(required) Unique identifier for this template group.| |^|name|string|(required) Template group name.| |host_groups|<| |Root element for host groups that are used by host prototypes.| |<|uuid|string|(required) Unique identifier for this host group.| |^|name|string|(required) Host group name.| |templates|<| |Root element for [templates](#templates).| |triggers|<| |Root element for template trigger elements, which are the same as for [template item triggers](#template-item-triggers).| |graphs|<| |Root element for template graph elements, which are the same as for [host graphs](/manual/xml_export_import/hosts#host-graphs).| ## فرادادههای قالب ```yaml zabbix_export: نسخه: '7.4' template_groups: - uuid: 846977d1dfed4968bc5f8bdb363285bc نام: 'قالبها/سیستمهای عامل' قالبها: (به جدول زیر مراجعه کنید) محرکها: (به جدول زیر مراجعه کنید) نمودارها: (به جدول زیر مراجعه کنید) ``` |عنصر|<|نوع|توضیحات| |-|---|---|---------------------| |نسخه|<|رشته|(الزامی) نسخه خروجی.| |template_groups|<| |(الزامی) عنصر ریشه برای گروههای قالب.| |<|uuid|رشته|(الزامی) شناسه منحصر به فرد برای این گروه قالب.| |^|نام|رشته|(الزامی) نام گروه قالب.| |host_groups|<| |عنصر ریشه برای گروههای میزبان که توسط نمونههای اولیه میزبان استفاده میشوند.| |<|uuid|string|(الزامی) شناسه منحصر به فرد برای این گروه میزبان.| |^|name|string|(الزامی) نام گروه میزبان.| |templates|<| |عنصر ریشه برای [templates](#templates).| |triggers|<| |عنصر ریشه برای عناصر trigger قالب، که مشابه [template item triggers](#template-item-triggers) هستند.| |graphs|<| |عنصر ریشه برای عناصر گراف قالب، که مشابه [host graphs](/manual/xml_export_import/hosts#host-graphs) هستند.| #### Templates and template groups Manage templates and link them to hosts or other templates. [Template API](/manual/api/reference/template) | [Template group API](/manual/api/reference/templategroup) | [Value map API](/manual/api/reference/valuemap) #### قالبها و گروههای قالبمدیریت قالبها و پیوند دادن آنها به میزبانها یا قالبهای دیگر.[Template API](/manual/api/reference/template) | [Template groupAPI](/manual/api/reference/templategroup) | [Value mapAPI](/manual/api/reference/valuemap) #### Template value maps ```yaml zabbix_export: (...) templates: (...) valuemaps: - uuid: 8c048c6cca8248f2860c208e8db0f59e name: ifOperStatus mappings: - value: '0' newvalue: unknown - value: '1' newvalue: notpresent - value: '2' newvalue: down - value: '3' newvalue: lowerlayerdown - value: '4' newvalue: testing - value: '5' newvalue: dormant - value: '6' newvalue: up (...) ``` |Element|<|Type|Description| |-|---|---|-----------------------| |uuid|<|string|(required) Unique identifier for this value map.| |name|<|string|(required) Value map name.| |mapping|<| |Root element for mappings.| |<|type|string|Mapping match type.<br>Possible values:^[1](#footnotes)^ EQUAL (0, default), GREATER_OR_EQUAL (2), LESS_OR_EQUAL (3), IN_RANGE (4), REGEXP (5), DEFAULT (6).| |^|value|string|Original value.| |^|newvalue|string|(required) Value to which the original value is mapped to.| ::: noteclassic See also: [Value map object](/manual/api/reference/valuemap/object) (refer to the relevant property with a matching name). ::: #### نقشههای مقدار قالب ```yaml zabbix_export: (...) قالبها: (...) نقشههای مقدار: - uuid: 8c048c6cca8248f2860c208e8db0f59e نام: ifOperStatus نقشهها: - مقدار: '0' newvalue: ناشناخته - مقدار: '1' newvalue: موجود نیست - مقدار: '2' newvalue: down - مقدار: '3' newvalue: lowerlayerdown - مقدار: '4' newvalue: در حال آزمایش - مقدار: '5' newvalue: غیرفعال - مقدار: '6' newvalue: up (...) ``` |عنصر|<|نوع|توضیحات| |-|---|---|----------------------| |uuid|<|string|(الزامی) شناسه منحصر به فرد برای این نگاشت مقدار.| |name|<|string|(الزامی) نام نگاشت مقدار.| |mapping|<| |عنصر ریشه برای نگاشتها.| |<|type|string|نوع تطابق نگاشت.<br>مقادیر ممکن:^[1](#footnotes)^ EQUAL (0, default), GREATER_OR_EQUAL (2), LESS_OR_EQUAL (3), IN_RANGE (4), REGEXP (5), DEFAULT (6).| |^|value|string|مقدار اصلی.| |^|newvalue|string|(الزامی) مقداری که مقدار اصلی به آن نگاشت میشود.| ::: noteclassic همچنین ببینید: [شیء نگاشت مقدار](/manual/api/reference/valuemap/object) (به ویژگی مربوطه با نام منطبق مراجعه کنید). ::: #### Template web scenarios |Element|<|Type|Description| |-|---|---|-----------------------| |uuid|<|string|(required) Unique identifier for this web scenario.| |name|<|string|(required) Web scenario name.| |delay|<|string|Frequency (using seconds, [time suffix](/manual/appendix/suffixes#time-suffixes), or [user macro](/manual/config/macros/user_macros)) of executing web scenario.<br>Default: 1m.| |attempts|<|integer|The number of attempts for executing web scenario steps.<br>Possible values:^[1](#footnotes)^ 1-10 (default: 1).| |agent|<|string|Client agent. Zabbix will pretend to be the selected browser.<br>This is useful when a website returns different content for different browsers.<br>Default: Zabbix.| |http\_proxy|<|string|Proxy that will be used by the web scenario given as: `http://[username[:password]@]proxy.example.com[:port]`| |variables|<| |Root element for web scenario variables that may be used in scenario steps.| |<|name|string|(required) Variable name.| |^|value|text|(required) Variable value.| |headers|<| |Root element for HTTP headers to be sent when performing a request.<br>Headers should be listed using the same syntax as they would appear in the HTTP protocol.| |<|name|string|(required) Header name.| |^|value|text|(required) Header value.| |status|<|string|Web scenario status.<br>Possible values:^[1](#footnotes)^ ENABLED (0, default), DISABLED (1).| |authentication|<|string|Authentication method.<br>Possible values:^[1](#footnotes)^ NONE (0, default), BASIC (1), NTLM (2), Kerberos (3), or Digest (4).| |http\_user|<|string|User name used for BASIC (HTTP), NTLM, Kerberos, or Digest authentication.| |http\_password|<|string|Password used for BASIC (HTTP), NTLM, Kerberos, or Digest authentication.| |verify\_peer|<|string|Verify the SSL certificate of the web server.<br>Possible values:^[1](#footnotes)^ NO (0, default), YES (1).| |verify\_host|<|string|Verify that the *Common Name* field or the *Subject Alternate Name* field of the web server certificate matches.<br>Possible values:^[1](#footnotes)^ NO (0, default), YES (1).| |ssl\_cert\_file|<|string|Name of the SSL certificate file used for client authentication (must be in PEM format).| |ssl\_key\_file|<|string|Name of the SSL private key file used for client authentication (must be in PEM format).| |ssl\_key\_password|<|string|SSL private key file password.| |steps|<| |(required) Root element for [template web scenario steps](#template-web-scenario-steps).| |tags|<| |Root element for web scenario tags.| |<|tag|string|(required) Tag name.| |^|value|string|Tag value.| ::: noteclassic See also: [Web scenario object](/manual/api/reference/httptest/object) (refer to the relevant property with a matching name). ::: #### سناریوهای وب الگو |عنصر|<|نوع|توضیحات| |-|---|---|----------------------| |uuid|<|string|(الزامی) شناسه منحصر به فرد برای این سناریوی وب.| |نام|<|string|(الزامی) نام سناریوی وب.| |تأخیر|<|string|تعداد دفعات (با استفاده از ثانیه، [پسوند زمان](/manual/appendix/suffixes#time-suffixes)، یا [ماکرو کاربر](/manual/config/macros/user_macros)) اجرای سناریوی وب.<br>پیشفرض: ۱ دقیقه.| |تلاشها|<|عدد صحیح|تعداد تلاشها برای اجرای مراحل سناریوی وب.<br>مقادیر ممکن:^[1](#footnotes)^ 1-10 (پیشفرض: ۱).| |agent|<|string|عامل کلاینت. زبیکس وانمود میکند که مرورگر انتخاب شده است.<br>این زمانی مفید است که یک وبسایت محتوای متفاوتی را برای مرورگرهای مختلف برمیگرداند.<br>پیشفرض: زبیکس.| |http\_proxy|<|string|Proxy که توسط سناریوی وب استفاده خواهد شد، به صورت زیر داده میشود: `http://[username[:password]@]proxy.example.com[:port]`| |variables|<| |عنصر ریشه برای متغیرهای سناریوی وب که ممکن است در مراحل سناریو استفاده شوند.| |<|name|string|(الزامی) نام متغیر.| |^|value|text|(الزامی) مقدار متغیر.| |headers|<| |عنصر ریشه برای هدرهای HTTP که هنگام انجام درخواست ارسال میشوند.<br>هدرها باید با همان نحوی که در پروتکل HTTP ظاهر میشوند، فهرست شوند.| |<|name|string|(الزامی) نام هدر.| |^|value|text|(الزامی) مقدار هدر.| |وضعیت|<|رشته|وضعیت سناریوی وب.<br>مقادیر ممکن:^[1](#footnotes)^ فعال (0، پیشفرض)، غیرفعال (1).| |احراز هویت|<|رشته|روش احراز هویت.<br>مقادیر ممکن:^[1](#footnotes)^ هیچکدام (0، پیشفرض)، BASIC (1)، NTLM (2).| |http\_user|<|رشته|نام کاربری مورد استفاده برای احراز هویت BASIC (HTTP) یا NTLM.| |http\_password|<|رشته|رمز عبور مورد استفاده برای احراز هویت BASIC (HTTP) یا NTLM.| |تأیید\_peer|<|رشته|گواهی SSL سرور وب را تأیید کنید.<br>مقادیر ممکن:^[1](#footnotes)^ خیر (0، پیشفرض)، بله (1).| |verify\_host|<|string|بررسی کنید که فیلد *Common Name* یا فیلد *Subject Alternative Name* از گواهی وب سرور مطابقت داشته باشد.<br>مقادیر ممکن:^[1](#footnotes)^ خیر (0، پیشفرض)، بله (1).| |ssl\_cert\_file|<|string|نام فایل گواهی SSL مورد استفاده برای احراز هویت کلاینت (باید با فرمت PEM باشد).| |ssl\_key\_file|<|string|نام فایل کلید خصوصی SSL مورد استفاده برای احراز هویت کلاینت (باید با فرمت PEM باشد).| |ssl\_key\_password|<|string|رمز عبور فایل کلید خصوصی SSL.| |steps|<| |(الزامی) عنصر ریشه برای [مراحل سناریوی وب الگو](#template-web-scenario-steps).| |tags|<| |عنصر ریشه برای برچسبهای سناریوی وب.| |<|tag|string|(الزامی) نام برچسب.| |^|مقدار|رشته|مقدار برچسب.| ::: noteclassic همچنین ببینید: [شیء سناریوی وب](/manual/api/reference/httptest/object) (به ویژگی مربوطه با نام منطبق مراجعه کنید). ::: ##### Template web scenario steps |Element|<|Type|Description| |-|---|---|-----------------------| |name|<|string|(required) Web scenario step name.| |url|<|string|(required) URL for monitoring.| |query\_fields|<| |Root element for query parameters (an array of HTTP fields to be added to the URL when performing a request).| |<|name|string|(required) Query parameter name.| |^|value|string|Query parameter value.| |posts|<| |Root element for HTTP POST variables (a string (raw post data) or an array of HTTP fields (form field data)).| |<|name|string|(required) Post field name.| |^|value|string|(required) Post field value.| |variables|<| |Root element of step-level variables (macros) that should be applied after this step.<br>If the variable value has a 'regex:' prefix, then its value is extracted from the data returned by this step according to the regular expression pattern following the 'regex:' prefix| |<|name|string|(required) Variable name.| |^|value|text|(required) Variable value.| |headers|<| |Root element for HTTP headers to be sent when performing a request.| |<|name|string|(required) Header name.| |^|value|text|(required) Header value.| |follow\_redirects|<|string|Follow HTTP redirects.<br>Possible values:^[1](#footnotes)^ NO (0), YES (1, default).| |retrieve\_mode|<|string|HTTP response retrieve mode.<br>Possible values:^[1](#footnotes)^ BODY (0, default), HEADERS (1), BOTH (2).| |timeout|<|string|Timeout (using seconds, [time suffix](/manual/appendix/suffixes#time-suffixes), or [user macro](/manual/config/macros/user_macros)) of step execution.<br>Default: 15s.| |required|<|string|Text that must be present in the response (ignored if empty).| |status\_codes|<|string|A comma-delimited list of accepted HTTP status codes (e.g., `200-201,210-299`; ignored if empty).| ::: noteclassic See also: [Web scenario step object](/manual/api/reference/httptest/object#scenario-step) (refer to the relevant property with a matching name). ::: ##### مراحل سناریوی وب الگو |عنصر|<|نوع|توضیحات| |-|---|---|----------------------| |نام|<|رشته|(الزامی) نام مرحله سناریوی وب.| |آدرس|<|رشته|(الزامی) آدرس اینترنتی برای نظارت.| |پرسش\_فیلدها|<| |عنصر ریشه برای پارامترهای پرس و جو (آرایهای از فیلدهای HTTP که هنگام انجام یک درخواست به URL اضافه میشوند).| |<|نام|رشته|(الزامی) نام پارامتر پرس و جو.| |^|مقدار|رشته|مقدار پارامتر پرس و جو.| |پستها|<| |عنصر ریشه برای متغیرهای HTTP POST (یک رشته (دادههای خام پست) یا آرایهای از فیلدهای HTTP (دادههای فیلد فرم)).| |<|نام|رشته|(الزامی) نام فیلد پست.| |^|مقدار|رشته|(الزامی) مقدار فیلد پست.| |متغیرها|<| |عنصر ریشه متغیرهای سطح مرحله (ماکروها) که باید پس از این مرحله اعمال شوند.<br>اگر مقدار متغیر دارای پیشوند 'regex:' باشد، مقدار آن از دادههای برگردانده شده توسط این مرحله طبق الگوی عبارت منظم پس از پیشوند 'regex:' استخراج میشود.| |<|name|string|(الزامی) نام متغیر.| |^|value|text|(الزامی) مقدار متغیر.| |headers|<| |عنصر ریشه برای هدرهای HTTP که هنگام انجام درخواست ارسال میشوند.| |<|name|string|(الزامی) نام هدر.| |^|value|text|(الزامی) مقدار هدر.| |follow\_redirects|<|string|Follow HTTP redirects.<br>مقادیر ممکن:^[1](#footnotes)^ خیر (0)، بله (1، پیشفرض).| |retrieve\_mode|<|string|HTTP response retrieve mode.<br>مقادیر ممکن:^[1](#footnotes)^ BODY (0، پیشفرض)، HEADERS (1)، هر دو (2).| |timeout|<|string|Timeout (با استفاده از ثانیه، [time suffix](/manual/appendix/suffixes#time-suffixes)، یا [user macro](/manual/config/macros/user_macros)) از اجرای مرحله.<br>پیشفرض: 15 ثانیه.| |required|<|string|متنی که باید در پاسخ وجود داشته باشد (در صورت خالی بودن نادیده گرفته میشود).| |status\_codes|<|string|لیستی از کدهای وضعیت HTTP پذیرفته شده که با کاما از هم جدا شدهاند (مثلاً `200-201,210-299`؛ در صورت خالی بودن نادیده گرفته میشوند).| ::: noteclassic همچنین ببینید: [Web scenario step object](/manual/api/reference/httptest/object#scenario-step) (به ویژگی مربوطه با نام منطبق مراجعه کنید). ::: #### Testing See [preprocessing testing](/manual/config/items/preprocessing/testing). #### در حال آزمایشبه [آزمایش پیشپردازش](/manual/config/items/preprocessing/testing) مراجعه کنید. ##### Text The following parameters are supported if *Data* is set to "Text". |Parameter|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-----|-|-----|-------------------| |*Text*|1|columns.0.text|Any string value, including macros.<br>Supported macros: {HOST.\*}, {INVENTORY.\*}.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if *Data* is set to "Text"| ##### Text The following parameters are supported if *Data* is set to "Text". |Parameter|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-----|-|-----|-------------------| |*Text*|1|columns.text.0|Any string value, including macros.<br>Supported macros: {HOST.\*}, {INVENTORY.\*}.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if *Data* is set to "Text"| The following parameters are supported for all columns. |Parameter|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-----|-|-----|-------------------| |*Name*|1|columns.0.name|Any string value.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required*| |*Data*|0|columns.0.data|1 - Item value;<br>2 - Host name;<br>3 - Text.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required*| |*Base color*|1|columns.0.base_color|Hexadecimal color code (e.g. `FF0000`).<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required*| The following parameters are supported for all columns. |Parameter|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-----|-|-----|-------------------| |*Name*|1|columns.name.0|Any string value.| |*Data*|0|columns.data.0|1 - Item value;<br>2 - Host name;<br>3 - Text.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required*| |*Base color*|1|columns.base_color.0|Hexadecimal color code (e.g. `FF0000`).<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required*| The ***getUpdateRequestData()*** method prepares the server request data for updating the widget by gathering various properties and their corresponding values (widget identifiers, filter settings, time ranges, etc.) from the widget's state and configuration, and constructing a data object that represents the necessary information to be sent to the server in the update request. This method is invoked only as part of the default *promiseUpdate()* method, that is, during the widget update process. Default implementation: ```js getUpdateRequestData() { return { templateid: this._dashboard.templateid ?? undefined, dashboardid: this._dashboard.dashboardid ?? undefined, widgetid: this._widgetid ?? undefined, name: this._name !== '' ? this._name : undefined, fields: Object.keys(this._fields).length > 0 ? this._fields : undefined, view_mode: this._view_mode, edit_mode: this._is_edit_mode ? 1 : 0, dynamic_hostid: this._dashboard.templateid !== null || this.supportsDynamicHosts() ? (this._dynamic_hostid ?? undefined) : undefined, ...this._contents_size }; } ``` متد ***getUpdateRequestData()*** با جمعآوری ویژگیهای مختلف و مقادیر متناظر آنها (شناسههای ویجت، تنظیمات فیلتر، محدودههای زمانی و غیره) از وضعیت و پیکربندی ویجت، دادههای درخواست سرور را برای بهروزرسانی ویجت آماده میکند و یک شیء داده میسازد که اطلاعات لازم برای ارسال به سرور در درخواست بهروزرسانی را نشان میدهد. این متد فقط به عنوان بخشی از متد پیشفرض *promiseUpdate()*، یعنی در طول فرآیند بهروزرسانی ویجت، فراخوانی میشود. پیادهسازی پیشفرض: ```js getUpdateRequestData() { return { templateid: this._dashboard.templateid ?? undefined, dashboardid: this._dashboard.dashboardid ?? undefined, widgetid: this._widgetid ?? undefined, name: this._name !== '' ? this._name : undefined, fields: Object.keys(this._fields).length > 0 ? this._fields : تعریف نشده، view_mode: this._view_mode، edit_mode: this._is_edit_mode ? 1 : 0، dynamic_hostid: this._dashboard.templateid !== null || this.supportsDynamicHosts() ? (this._dynamic_hostid ?? تعریف نشده) : تعریف نشده، ...this._contents_size }; } ```` The ***hasPadding()*** method is responsible for applying an 8px vertical padding at the bottom of the widget when it is configured to [show its header](/manual/web_interface/frontend_sections/dashboards/widgets#common-parameters). This method is invoked when the dashboard page is activated, that is, when it becomes the displayed page in the user interface. Default implementation: ```js hasPadding() { return this.getViewMode() !== ZBX_WIDGET_VIEW_MODE_HIDDEN_HEADER; } ``` For some widgets it is necessary to use all of the available widget space to configure, for example, a custom background color. The following is an example of the implementation of the *hasPadding()* method used in the Zabbix-native [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value) widget. ```js hasPadding() { return false; } ``` متد ***hasPadding()*** مسئول اعمال فاصله عمودی ۸ پیکسلی در پایین ویجت است، زمانی که برای [show its header](/manual/web_interface/frontend_sections/dashboards/widgets#common-parameters) پیکربندی شده باشد. این متد زمانی فراخوانی میشود که صفحه داشبورد فعال میشود، یعنی زمانی که به صفحه نمایش داده شده در رابط کاربری تبدیل میشود. پیادهسازی پیشفرض: ```js hasPadding() { return this.getViewMode() !== ZBX_WIDGET_VIEW_MODE_HIDDEN_HEADER; } ``` برای برخی از ویجتها، لازم است از تمام فضای ویجت موجود برای پیکربندی، به عنوان مثال، یک رنگ پسزمینه سفارشی استفاده شود. در ادامه مثالی از پیادهسازی متد *hasPadding()* که در ویجت بومی Zabbix [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value) استفاده شده است، آمده است. ```js hasPadding() { return false; } ```` The ***onActivate()*** method makes the widget active and interactive by enabling custom event listeners (for responding to user actions) and initiating the widget update cycle (for keeping its content up-to-date). This method is invoked when the dashboard page is activated, that is, when it becomes fully displayed in the user interface. Note that before the *onActivate()* method is invoked, the widget is in the inactive state (`WIDGET_STATE_INACTIVE`). After successful invocation, the widget transitions to the active state (`WIDGET_STATE_ACTIVE`). In the active state, the widget is responsive, listens to events, updates its content periodically, and can interact with other widgets. Example: ```js onActivate() { this._startClock(); this._resize_observer = new ResizeObserver(this._events.resize); this._resize_observer.observe(this._target); } ``` متد ***onActivate()*** با فعال کردن شنوندههای رویداد سفارشی (برای پاسخ به اقدامات کاربر) و شروع چرخه بهروزرسانی ویجت (برای بهروز نگه داشتن محتوای آن)، ویجت را فعال و تعاملی میکند. این متد زمانی فراخوانی میشود که صفحه داشبورد فعال میشود، یعنی زمانی که به طور کامل در رابط کاربری نمایش داده میشود. توجه داشته باشید که قبل از فراخوانی متد *onActivate()*، ویجت در حالت غیرفعال (`WIDGET_STATE_INACTIVE`) قرار دارد. پس از فراخوانی موفقیتآمیز، ویجت به حالت فعال (`WIDGET_STATE_ACTIVE`) منتقل میشود. در حالت فعال، ویجت پاسخگو است، به رویدادها گوش میدهد، محتوای خود را به صورت دورهای بهروزرسانی میکند و میتواند با سایر ویجتها تعامل داشته باشد. مثال: ```js onActivate() { this._startClock(); this._resize_observer = new ResizeObserver(this._events.resize); ‎this._resize_observer.observe(this._target); } ```` The ***onDeactivate()*** method stops any activity and interactivity of the widget by deactivating custom event listeners and stopping the widget update cycle. This method is invoked when the dashboard page is deactivated, that is, switched away or deleted, or when the widget is deleted from the dashboard page. Note that before the *onDeactivate()* method is invoked, the widget is in the active state (`WIDGET_STATE_ACTIVE`). After successful invocation, the widget transitions to the inactive state (`WIDGET_STATE_INACTIVE`). Example: ```js onDeactivate() { this._stopClock(); this._resize_observer.disconnect(); } ``` متد ***onDeactivate()*** با غیرفعال کردن شنوندههای رویداد سفارشی و متوقف کردن چرخه بهروزرسانی ویجت، هرگونه فعالیت و تعامل ویجت را متوقف میکند. این متد زمانی فراخوانی میشود که صفحه داشبورد غیرفعال شود، یعنی تغییر کند یا حذف شود، یا زمانی که ویجت از صفحه داشبورد حذف شود. توجه داشته باشید که قبل از فراخوانی متد *onDeactivate()*، ویجت در حالت فعال (`WIDGET_STATE_ACTIVE`) قرار دارد. پس از فراخوانی موفقیتآمیز، ویجت به حالت غیرفعال (`WIDGET_STATE_INACTIVE`) منتقل میشود. مثال: ```js onDeactivate() { this._stopClock(); this._resize_observer.disconnect(); } ```` The ***onDestroy()*** method performs cleanup tasks before the widget is deleted from the dashboard, which can include closing a database connection that was established during widget initialization, cleaning up temporary data to free up system memory and avoid resource leaks, unregistering event listeners related to resize events or button clicks to prevent unnecessary event handling and memory leaks, etc. This method is invoked when the widget or the dashboard page that contains it is deleted. Note that before the *onDestroy()* method is invoked, a widget in an active state (`WIDGET_STATE_ACTIVE`) is always deactivated with the invocation of the *onDeactivate()* method. Example: ```js onDestroy() { if (this._filter_widget) { this._filter_widget.off(CWidgetMap.WIDGET_NAVTREE_EVENT_MARK, this._events.mark); this._filter_widget.off(CWidgetMap.WIDGET_NAVTREE_EVENT_SELECT, this._events.select); } } ``` متد ***onDestroy()*** قبل از حذف ویجت از داشبورد، وظایف پاکسازی را انجام میدهد، که میتواند شامل بستن اتصال پایگاه دادهای باشد که در طول مقداردهی اولیه ویجت ایجاد شده است، پاکسازی دادههای موقت برای آزاد کردن حافظه سیستم و جلوگیری از نشت منابع، لغو ثبت شنوندههای رویداد مربوط به تغییر اندازه رویدادها یا کلیک دکمهها برای جلوگیری از مدیریت غیرضروری رویدادها و نشت حافظه و غیره. این متد زمانی فراخوانی میشود که ویجت یا صفحه داشبوردی که حاوی آن است حذف شود. توجه داشته باشید که قبل از فراخوانی متد *onDestroy()*، یک ویجت در حالت فعال (`WIDGET_STATE_ACTIVE`) همیشه با فراخوانی متد *onDeactivate()* غیرفعال میشود. مثال: ```js onDestroy() { if (this._filter_widget) { this._filter_widget.off(CWidgetMap.WIDGET_NAVTREE_EVENT_MARK, this._events.mark); ‎ this._filter_widget.off(CWidgetMap.WIDGET_NAVTREE_EVENT_SELECT, this._events.select); } } ``` The ***onEdit()*** method defines the appearance and behavior of the widget when the dashboard transitions into editing mode. This method is invoked when the dashboard transitions into editing mode, typically when a user interacts with the widget's *Edit* button or the dashboard's *Edit dashboard* button. Example: ```js onEdit() { this._deactivateGraph(); } ``` متد ***onEdit()*** ظاهر و رفتار ویجت را هنگام انتقال داشبورد به حالت ویرایش تعریف میکند. این متد هنگام انتقال داشبورد به حالت ویرایش فراخوانی میشود، معمولاً زمانی که کاربر با دکمه *ویرایش* ویجت یا دکمه *ویرایش داشبورد* داشبورد تعامل دارد. مثال: ```js onEdit() { this._deactivateGraph(); } ```` The ***onInitialize()*** method defines the initial state and/or values of the widget, without performing any HTML or data manipulation. This method is invoked when a widget is created (a widget object is instantiated), typically by adding the widget to a dashboard page or loading the dashboard page. Example: ```js onInitialize() { this._time_offset = 0; this._interval_id = null; this._clock_type = CWidgetClock.TYPE_ANALOG; this._time_zone = null; this._show_seconds = true; this._time_format = 0; this._tzone_format = 0; this._show = []; this._has_contents = false; this._is_enabled = true; } ``` The ***\_init()*** method defines the initial state and/or values of the widget, without performing any HTML or data manipulation. This method is invoked when a widget is created (a widget object is instantiated), typically by adding the widget to a dashboard page or loading the dashboard page. Example: ```js _init() { super._init(); this._time_offset = 0; this._interval_id = null; this._clock_type = CWidgetClock.TYPE_ANALOG; this._time_zone = null; this._show_seconds = true; this._time_format = 0; this._tzone_format = 0; this._show = []; this._has_contents = false; this._is_enabled = true; } ``` The ***onResize()*** method is responsible for adjusting widget's visual elements to accommodate the new widget size, which can include rearranging elements, adjusting element dimensions, text truncation, implementing lazy loading to improve responsiveness during resizing, etc. This method is invoked when the widget is resized, for example, when the user manually resizes the widget or when the browser window is resized. Example: ```js onResize() { if (this.getState() === WIDGET_STATE_ACTIVE) { this._startUpdating(); } } ``` متد ***onResize()*** مسئول تنظیم عناصر بصری ویجت برای تطبیق با اندازه جدید ویجت است، که میتواند شامل تنظیم مجدد عناصر، تنظیم ابعاد عنصر، کوتاهسازی متن، پیادهسازی بارگذاری تنبل برای بهبود پاسخگویی در حین تغییر اندازه و غیره باشد. این متد هنگام تغییر اندازه ویجت فراخوانی میشود، به عنوان مثال، زمانی که کاربر به صورت دستی اندازه ویجت را تغییر میدهد یا زمانی که اندازه پنجره مرورگر تغییر میکند. مثال: ```js onResize() { if (this.getState() === WIDGET_STATE_ACTIVE) { this._startUpdating(); } } ```` The ***onStart()*** method defines the HTML structure of the widget, without performing any data manipulation. This method is invoked before the first activation of the dashboard page, that is, before the dashboard and its widgets are fully displayed to the user. Example: ```js onStart() { this._events.resize = () => { const padding = 25; const header_height = this._view_mode === ZBX_WIDGET_VIEW_MODE_HIDDEN_HEADER ? 0 : this._header.offsetHeight; this._target.style.setProperty( '--content-height', `${this._cell_height * this._pos.height - padding * 2 - header_height}px` ); } } ``` متد ***onStart()*** ساختار HTML ویجت را بدون انجام هیچ گونه دستکاری دادهای تعریف میکند. این متد قبل از اولین فعالسازی صفحه داشبورد، یعنی قبل از اینکه داشبورد و ویجتهای آن به طور کامل به کاربر نمایش داده شوند، فراخوانی میشود. مثال: ```js onStart() { this._events.resize = () => { const padding = 25; const header_height = this._view_mode === ZBX_WIDGET_VIEW_MODE_HIDDEN_HEADER ? 0 : this._header.offsetHeight; this._target.style.setProperty( '--content-height', `${this._cell_height * this._pos.height - padding * 2 - header_height}px` ); } } ```` The ***processUpdateErrorResponse(error)*** method handles the response received from the server after the update request if the response is an error, and displays the error message/-s. This method is invoked only as part of the default *promiseUpdate()* method, that is, during the widget update process. Default implementation: ```js processUpdateErrorResponse(error) { this._updateMessages(error.messages, error.title); } ``` متد ***processUpdateErrorResponse(error)*** در صورت خطا بودن پاسخ، پاسخ دریافتی از سرور پس از درخواست بهروزرسانی را مدیریت میکند و پیام/پیامهای خطا را نمایش میدهد. این متد فقط به عنوان بخشی از متد پیشفرض *promiseUpdate()*، یعنی در طول فرآیند بهروزرسانی ویجت، فراخوانی میشود. پیادهسازی پیشفرض: ```js processUpdateErrorResponse(error) { this._updateMessages(error.messages, error.title); } ```` The ***processUpdateResponse(response)*** method handles the response received from the server after the update request, and, if the update process has been successful and without errors, clears widget data and displays new contents with the *setContents()* method. This method is invoked only as part of the default *promiseUpdate()* method, that is, during the widget update process. Default implementation: ```js processUpdateResponse(response) { this._setHeaderName(response.name); this._updateMessages(response.messages); this._updateInfo(response.info); this._updateDebug(response.debug); this.setContents(response); } ``` متد ***processUpdateResponse(response)*** پاسخ دریافتی از سرور پس از درخواست بهروزرسانی را مدیریت میکند، و اگر فرآیند بهروزرسانی موفقیتآمیز و بدون خطا باشد، دادههای ویجت را پاک کرده و محتویات جدید را با متد *setContents()* نمایش میدهد. این متد فقط به عنوان بخشی از متد پیشفرض *promiseUpdate()*، یعنی در طول فرآیند بهروزرسانی ویجت، فراخوانی میشود. پیادهسازی پیشفرض: ```js processUpdateResponse(response) { this._setHeaderName(response.name); this._updateMessages(response.messages); this._updateInfo(response.info); this._updateDebug(response.debug); this.setContents(response); } ```` The ***promiseUpdate()*** method initiates the data update process by retrieving data, typically using web requests or API calls. This method is invoked when a dashboard page is displayed and periodically after, until the dashboard page is switched to another dashboard page. The following is an example of the default implementation of the *promiseUpdate()* method used by most Zabbix-native widgets. In the default implementation, the *promiseUpdate()* method follows a general pattern for retrieving data from the server. It creates a new `Curl` object with the appropriate URL and request parameters, sends a `POST` request using the *fetch()* method with the data object constructed by the *getUpdateRequestData()* method, and processes the response (or an error response) with the *processUpdateResponse(response)* or *processUpdateErrorResponse(error)* accordingly. This implementation is suitable for most widgets as they typically retrieve data in a JSON format and handle it in a consistent manner. ```js promiseUpdate() { const curl = new Curl('zabbix.php'); curl.setArgument('action', `widget.${this._type}.view`); return fetch(curl.getUrl(), { method: 'POST', headers: {'Content-Type': 'application/json'}, body: JSON.stringify(this.getUpdateRequestData()), signal: this._update_abort_controller.signal }) .then((response) => response.json()) .then((response) => { if ('error' in response) { this.processUpdateErrorResponse(response.error); return; } this.processUpdateResponse(response); }); } ``` متد ***promiseUpdate()*** فرآیند بهروزرسانی دادهها را با بازیابی دادهها، معمولاً با استفاده از درخواستهای وب یا فراخوانیهای API، آغاز میکند. این متد هنگام نمایش صفحه داشبورد و به صورت دورهای پس از آن، تا زمانی که صفحه داشبورد به صفحه داشبورد دیگری منتقل شود، فراخوانی میشود. در زیر مثالی از پیادهسازی پیشفرض متد *promiseUpdate()* که توسط اکثر ویجتهای بومی Zabbix استفاده میشود، آمده است. در پیادهسازی پیشفرض، متد *promiseUpdate()* از یک الگوی کلی برای بازیابی دادهها از سرور پیروی میکند. این متد یک شیء `Curl` جدید با URL و پارامترهای درخواست مناسب ایجاد میکند، یک درخواست `POST` را با استفاده از متد *fetch()* با شیء داده ساخته شده توسط متد *getUpdateRequestData()* ارسال میکند، و پاسخ (یا پاسخ خطا) را با *processUpdateResponse(response)* یا *processUpdateErrorResponse(error)* به ترتیب پردازش میکند. این پیادهسازی برای اکثر ویجتها مناسب است زیرا آنها معمولاً دادهها را با فرمت JSON بازیابی کرده و به شیوهای سازگار با آن رفتار میکنند. ```js promiseUpdate() { const curl = new Curl('zabbix.php'); curl.setArgument('action', `widget.${this._type}.view`); return fetch(curl.getUrl(), { method: 'POST', headers: {'Content-Type': 'application/json'}, body: JSON.stringify(this.getUpdateRequestData()), signal: this._update_abort_controller.signal }) .then((response) => response.json()) .then((response) => { if ('error' in response) { this.processUpdateErrorResponse(response.error); return; } this.processUpdateResponse(response); }); } ``` The ***setContents(response)*** method displays widget contents if the widget update process has been successful and without errors, which can include manipulating DOM elements, updating UI components, applying styles or formatting, etc. This method is invoked only as part of the default *processUpdateResponse(response)* method, that is, during the process of handling the response received from the server after the update request. Default implementation: ```js setContents(response) { this._body.innerHTML = response.body ?? ''; } ``` متد ***setContents(response)*** در صورتی که فرآیند بهروزرسانی ویجت موفقیتآمیز و بدون خطا باشد، محتوای ویجت را نمایش میدهد، که میتواند شامل دستکاری عناصر DOM، بهروزرسانی اجزای رابط کاربری، اعمال استایلها یا قالببندی و غیره باشد. این متد فقط به عنوان بخشی از متد پیشفرض *processUpdateResponse(response)* فراخوانی میشود، یعنی در طول فرآیند مدیریت پاسخ دریافتی از سرور پس از درخواست بهروزرسانی. پیادهسازی پیشفرض: ```js setContents(response) { this._body.innerHTML = response.body ?? ''; } ```` This is a step-by-step tutorial that shows how to create a simple dashboard widget. You can download all files of this widget as a ZIP archive: [lesson_gauge_chart.zip](../../../../assets/en/devel/modules/examples/lesson_gauge_chart.zip). این یک آموزش گام به گام است که نحوه ایجاد یک ویجت داشبورد ساده را نشان میدهد. شما میتوانید تمام فایلهای این ویجت را به صورت یک فایل فشرده (ZIP) دانلود کنید: [lesson_gauge_chart.zip](../../../../assets/en/devel/modules/examples/lesson_gauge_chart.zip). This is a step-by-step tutorial that shows how to create a simple Zabbix frontend module. You can download all files of this module as a ZIP archive: [MyAddress.zip](../../../../assets/en/devel/modules/examples/MyAddress.zip). این یک آموزش گام به گام است که نحوه ایجاد یک ماژول ساده frontend زبیکس را نشان میدهد. شما میتوانید تمام فایلهای این ماژول را به صورت یک فایل فشرده (ZIP) دانلود کنید: [MyAddress.zip](../../../../assets/en/devel/modules/examples/MyAddress.zip). # This topic does not exist yet. We are sorry, the page you are looking for cannot be found. Return to the homepage, try searching, or get [help](https://www.zabbix.com/support). # این موضوع هنوز وجود ندارد. متأسفیم، صفحه مورد نظر شما یافت نشد. به صفحه اصلی بازگردید، جستجو کنید یا [راهنما] (https://www.zabbix.com/support) را دریافت کنید. ##### Time The following advanced configuration parameters are supported if *Clock type* is set to "Digital", and *Show* is set to "Time". |Parameter|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-----|-|-----|-------------------| |*Bold*|0|time_bold|0 - *(default)* Disabled;<br>1 - Enabled.| |*Color*|1|time_color|Hexadecimal color code (e.g. `FF0000`).<br><br>Default: `""` (empty).| |*Seconds*|0|time_sec|0 - Disabled;<br>1 - *(default)* Enabled.| |*Format*|0|time_format|0 - *(default)* 24-hour;<br>1 - 12-hour.| ##### تاریخ The following advanced configuration parameters are supported if *Clock type* is set to "Digital", and *Show* is set to "Date". |Parameter|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-----|-|-----|-------------------| |*Bold*|0|date_bold|0 - *(default)* Disabled;<br>1 - Enabled.| |*Color*|1|date_color|Hexadecimal color code (e.g. `FF0000`).<br><br>Default: `""` (empty).| ##### Time zone The following advanced configuration parameters are supported if *Clock type* is set to "Digital", and *Show* is set to "Time zone". |Parameter|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-----|-|-----|-------------------| |*Bold*|0|tzone_bold|0 - *(default)* Disabled;<br>1 - Enabled.| |*Color*|1|tzone_color|Hexadecimal color code (e.g. `FF0000`).<br><br>Default: `""` (empty).| |*Time zone*|1|tzone_timezone|Valid timezone string (e.g. `Europe/Riga`, `system`, `UTC`, etc.). For the full list of supported time zones please refer to [PHP documentation](https://www.php.net/manual/en/timezones.php).<br><br>Default: `local`.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Time type* is set to "Local time" or "Server time"| |*Format*|0|tzone_format|0 - *(default)* Short;<br>1 - Full.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Time type* is set to "Local time" or "Server time"| ##### منطقه زمانی The following advanced configuration parameters are supported if *Clock type* is set to "Digital", and *Show* is set to "Time zone". |Parameter|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-----|-|-----|-------------------| |*Bold*|0|tzone_bold|0 - *(default)* Disabled;<br>1 - Enabled.| |*Color*|1|tzone_color|Hexadecimal color code (e.g. `FF0000`).<br><br>Default: `""` (empty).| |*Time zone*|1|tzone_timezone|Valid timezone string (e.g. `Europe/Riga`, `system`, `UTC`, etc.). For the full list of supported time zones please refer to [PHP documentation](https://www.php.net/manual/en/timezones.php).<br><br>Default: `local`.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Time type* is set to "Local time" or "Server time"| |*Format*|0|tzone_format|0 - *(default)* Short;<br>1 - Full.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Time type* is set to "Local time" or "Server time"| #### Trends Retrieve trend values calculated by Zabbix server for presentation or further processing. [Trend API](/manual/api/reference/trend) #### روندهامقادیر روند محاسبه شده توسط سرور زبیکس را برای ارائه یا پردازش بیشتر بازیابی کنید.[رابط برنامهنویسی روند](/manual/api/reference/trend) #### Triggers Configure triggers to notify you about problems in your system. Manage trigger dependencies. [Trigger API](/manual/api/reference/trigger) تریگرها را پیکربندی کنید تا در مورد مشکلات سیستم به شما اطلاع دهند. وابستگیهای تریگر را مدیریت کنید.[Trigger API](/manual/api/reference/trigger) ##### Trim {#trim} Remove specified characters from the beginning and end of the value. تریم # Tutorials This section contains practical step-by-step tutorials to illustrate how to build a custom [module](/devel/modules/tutorials/module) and a [widget](/devel/modules/tutorials/widget) in Zabbix. # آموزشها این بخش شامل آموزشهای گام به گام کاربردی برای نشان دادن نحوه ساخت یک [module](/devel/modules/tutorials/module) و یک [widget](/devel/modules/tutorials/widget) سفارشی در زبیکس است. ### type Type of the module. Required for widgets and must equal "widget". *Type*: String *Default*: "module" *Example*: ```json "type": "widget" ``` ### نوع نوع ماژول. برای ابزارکها الزامی است و باید برابر با "widget" باشد. *نوع*: رشته *پیشفرض*: "module" *مثال*: ```json "type": "widget" ```` #### Update dependent item prototype Update Dependent item prototype with new Master item prototype ID. Only dependencies on same host (template/discovery rule) are allowed, therefore Master and Dependent item should have same hostid and ruleid. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "itemprototype.update", "params": { "master_itemid": "25570", "itemid": "189030" }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "189030" ] }, "id": 1 } ``` #### بهروزرسانی نمونه اولیه آیتم وابسته بهروزرسانی نمونه اولیه آیتم وابسته با شناسه نمونه اولیه آیتم اصلی جدید. فقط وابستگیها در یک میزبان (قانون الگو/کشف) مجاز هستند، بنابراین آیتم اصلی و وابسته باید شناسه میزبان و شناسه قانون یکسانی داشته باشند.[درخواست](/manual/api#performing-requests):```json{"jsonrpc": "2.0","method": "itemprototype.update","params": {"master_itemid": "25570","itemid": "189030"},"id": 1}```Response:```json{"jsonrpc": "2.0","result": {"itemids": ["189030"]},"id": 1}```` #### Update HTTP agent item prototype Change query fields and remove all custom headers. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "itemprototype.update", "params": { "itemid":"28305", "query_fields": [ { "name": "random", "value": "qwertyuiopasdfghjklzxcvbnm" } ], "headers": [] } "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "28305" ] }, "id": 1 } ``` #### بهروزرسانی نمونه اولیه آیتم عامل HTTP، فیلدهای پرسوجو را تغییر داده و تمام هدرهای سفارشی را حذف کنید.[درخواست](/manual/api#performing-requests):```json{"jsonrpc": "2.0"، "method": "itemprototype.update"، "params": {"itemid": "28305"، "query_fields": [{"name": "random"، "value": "qwertyuiopasdfghjklzxcvbnm"}]، "headers": []}"id": 1}```Response:```json{"jsonrpc": "2.0"، "result": {"itemids": ["28305"]}، "id": 1}```` ##### Update process methods The widget update process methods are responsible for retrieving updated data from Zabbix server or any other data source and displaying it in the widget. ##### متدهای فرآیند بهروزرسانی متدهای فرآیند بهروزرسانی ویجت مسئول بازیابی دادههای بهروزرسانیشده از سرور زبیکس یا هر منبع داده دیگری و نمایش آن در ویجت هستند. #### Updating a script item prototype Update a script item prototype with a different script and remove unnecessary parameters that were used by previous script. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "itemprototype.update", "params": { "itemid": "23865", "parameters": [], "script": "Zabbix.log(3, 'Log test');\nreturn 1;" }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "23865" ] }, "id": 1 } ``` #### بهروزرسانی نمونه اولیه یک آیتم اسکریپت نمونه اولیه یک آیتم اسکریپت را با یک اسکریپت متفاوت بهروزرسانی کنید و پارامترهای غیرضروری که توسط اسکریپت قبلی استفاده شده بودند را حذف کنید.[درخواست](/manual/api#performing-requests):```json{"jsonrpc": "2.0","method": "itemprototype.update","params": {"itemid": "23865","parameters": [],"script": "Zabbix.log(3, 'Log test');\nreturn 1;"},"id": 1}```Response:```json{"jsonrpc": "2.0","result": {"itemids": ["23865"]},"id": 1}```` #### Updating item preprocessing options Update an item prototype with item preprocessing rule “Custom multiplier”. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "itemprototype.update", "params": { "itemid": "44211", "preprocessing": [ { "type": 1, "params": "4", "error_handler": 2, "error_handler_params": "5" } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "44211" ] }, "id": 1 } ``` #### بهروزرسانی گزینههای پیشپردازش آیتمها نمونه اولیه آیتم را با قانون پیشپردازش آیتم "Custommultiplier" بهروزرسانی کنید.[درخواست](/manual/api#performing-requests):```json{"jsonrpc": "2.0","method": "itemprototype.update","params": {"itemid": "44211","preprocessing": [{"type": 1,"params": "4","error_handler": 2,"error_handler_params": "5"}]},"id": 1}```Response:```json{"jsonrpc": "2.0","result": {"itemids": ["44211"]},"id": 1}```` #### Updating tag filter Change tag filter for connector with ID "5". [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "connector.update", "params": [ { "connectorid": 5, "tags_evaltype": 2, "tags": [ { "tag": "service", "operator": 0, "value": "mysqld" }, { "tag": "error", "operator": 12, "value": "" } ] } ], "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "connectorids": [ "5" ] }, "id": 1 } ``` #### ایجاد یک رابط یک رابط برای خروجی گرفتن از رویدادهای تریگر با فیلتر برچسب ایجاد کنید. احراز هویت HTTP با استفاده از توکن Bearer انجام خواهد شد. [درخواست](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "connector.create", "params": [ { "name": "خروجی رویدادها", "data_type": 1, "url": "{$DATA_EXPORT_URL}", "authtype": 5, "token": "{$DATA_EXPORT_BEARER_TOKEN}", "tags": [ { "tag": "service", "operator": 0, "value": "mysqld" } ] } ], "id": 1 } ``` پاسخ: ```json { "jsonrpc": "2.0", "result": { "connectorid": [ "3" ] }, "id": 1 } ``` ## Upgrade tab The *Upgrade* tab lets you to scale your node's resources or manage its subscription. ![](../../assets/en/cloud/quickstart/upgrade_tab.png){width="600"} You may increase the compute tier or disk size—note that disk size can only be increased once every 24 hours and cannot be reduced via the UI (contact Zabbix support for any shrink requests). Free-trial nodes can be converted to paid subscriptions. To increase compute tire: 1\. Click the *Compute* dropdown. ![](../../assets/en/cloud/quickstart/upgrade_compute.png){width="600"} 2\. Select desired configuration tire. 3\. Click *Upgrade* button. To increase disk size: 1\. Click *Increase storage size* radiobutton. 2\. Adjust the *Disk size* slider to the desired value. ![](../../assets/en/cloud/quickstart/increase_storage.png){width="600"} 3\. Click *Upgrade* button. :::noteclassic The updated total monthly price is shown in the *Pricing* table before confirming changes. ::: ## تب ارتقا تب *ارتقا* به شما امکان میدهد منابع گره خود را مقیاسبندی کنید یا اشتراک آن را مدیریت کنید. ![](../../assets/en/cloud/quickstart/upgrade_tab.png){width="600"} شما میتوانید سطح محاسبات یا اندازه دیسک را افزایش دهید - توجه داشته باشید که اندازه دیسک فقط هر 24 ساعت یک بار قابل افزایش است و نمیتوان آن را از طریق رابط کاربری کاهش داد (برای هرگونه درخواست کاهش با پشتیبانی Zabbix تماس بگیرید). گرههای آزمایشی رایگان را میتوان به اشتراکهای پولی تبدیل کرد. برای افزایش اندازه محاسبات: 1\. روی منوی کشویی *محاسبات* کلیک کنید. ![](../../assets/en/cloud/quickstart/upgrade_compute.png){width="600"} 2\. اندازه پیکربندی مورد نظر را انتخاب کنید. 3\. روی دکمه *ارتقا* کلیک کنید. برای افزایش اندازه دیسک: 1\. روی دکمه رادیویی *افزایش اندازه ذخیرهسازی* کلیک کنید. ۲. اسلایدر *اندازه دیسک* را روی مقدار دلخواه تنظیم کنید. ![](../../assets/en/cloud/quickstart/increase_storage.png){width="600"} ۳. روی دکمه *ارتقا* کلیک کنید. :::noteclassic قیمت کل ماهانه بهروزرسانیشده قبل از تأیید تغییرات در جدول *قیمتگذاری* نشان داده میشود. ::: # user.login ورود کاربر #### Users and user groups Add users that will have access to Zabbix, assign them to user groups and grant permissions. Make roles for granular management of user rights. [User API](/manual/api/reference/user) | [User group API](/manual/api/reference/usergroup) | [User directory API](/manual/api/reference/userdirectory) | [User role API](/manual/api/reference/role) #### کاربران و گروههای کاربری کاربرانی را که به زبیکس دسترسی خواهند داشت اضافه کنید، آنها را به گروههای کاربری اختصاص دهید و مجوزها را اعطا کنید. برای مدیریت دقیق حقوق کاربران، نقشهایی ایجاد کنید.[User API](/manual/api/reference/user) | [User groupAPI](/manual/api/reference/usergroup) | [User directoryAPI](/manual/api/reference/userdirectory) | [User roleAPI](/manual/api/reference/role) ## Users The Zabbix API allows you to manage users of your monitoring system. ## کاربران رابط برنامهنویسی کاربردی زبیکس به شما امکان میدهد کاربران سیستم مانیتورینگ خود را مدیریت کنید. # Use Zabbix API [zabbix\_utils](https://github.com/zabbix/python-zabbix-utils/blob/main/README.md) lets you use [Zabbix API](/manual/api) to manage Zabbix objects, including creating hosts, updating items, retrieving events, and more. API requests can be made in synchronous or asynchronous mode: - In synchronous mode, your Python script sends a request and waits for a response before continuing, which is suitable for simple, sequential, and predictable operations. - In asynchronous mode, the script sends requests without waiting for each response, allowing other operations to proceed in parallel; this is more efficient for slow requests or large batches of data. The examples on this page focus on synchronous mode, though [asynchronous mode](#asynchronous-mode) follows similar patterns. Additional examples are available in the [zabbix_utils](https://github.com/zabbix/python-zabbix-utils/tree/main/examples) GitHub repository. ### استفاده از Zabbix API zabbix_utils به شما این امکان را میدهد که از Zabbix API برای مدیریت آبجکتهای Zabbix استفاده کنید؛ از جمله: * ایجاد Hostها * بهروزرسانی Itemها * دریافت Eventها * و موارد دیگر درخواستهای API میتوانند به دو صورت **همزمان (Synchronous)** یا **غیرهمزمان (Asynchronous)** ارسال شوند: * **حالت همزمان (Synchronous):** در این حالت، اسکریپت پایتون شما یک درخواست ارسال میکند و قبل از ادامه اجرای برنامه، منتظر دریافت پاسخ میماند. این روش برای عملیات ساده، ترتیبی و قابل پیشبینی مناسب است. * **حالت غیرهمزمان (Asynchronous):** در این حالت، اسکریپت بدون انتظار برای دریافت پاسخ هر درخواست، درخواستهای بعدی را ارسال میکند. این امکان اجرای موازی سایر عملیات را فراهم کرده و برای درخواستهای کند یا حجم زیاد داده کارآمدتر است. مثالهای ارائهشده در این صفحه بر حالت همزمان تمرکز دارند، اگرچه حالت غیرهمزمان نیز از الگوهای مشابهی پیروی میکند. مثالهای بیشتر در مخزن GitHub مربوط به zabbix_utils GitHub repository در دسترس هستند. #### Using a custom expression filter Create a trigger action that uses a custom expression - "A and (B or C)" - for evaluating action conditions. Once a trigger with a severity higher or equal to "Warning" from host "10084" or host "10106" goes into a PROBLEM state, the action will send a message to all users in user group "7" via media type "1". The formula IDs "A", "B" and "C" have been chosen arbitrarily. [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "action.create", "params": { "name": "Trigger action", "eventsource": 0, "esc_period": "15m", "filter": { "evaltype": 3, "formula": "A and (B or C)", "conditions": [ { "conditiontype": 4, "operator": 5, "value": "2", "formulaid": "A" }, { "conditiontype": 1, "operator": 0, "value": "10084", "formulaid": "B" }, { "conditiontype": 1, "operator": 0, "value": "10106", "formulaid": "C" } ] }, "operations": [ { "operationtype": 0, "esc_step_from": 1, "esc_step_to": 1, "opmessage_grp": [ { "usrgrpid": "7" } ], "opmessage": { "default_msg": 1, "mediatypeid": "1" } } ] }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "actionids": [ "18" ] }, "id": 1 } ``` #### با استفاده از یک فیلتر عبارت سفارشی یک اقدام ماشه ای ایجاد کنید که از یک شرط فیلتر سفارشی استفاده کند. این اقدام باید برای هر محرک با شدت بالاتر یا پیامی ارسال کند برابر با "هشدار" برای میزبان "10084" و "10106". شناسه فرمول "A"، «ب» و «ج» خودسرانه انتخاب شده اند. درخواست: ``json { "jsonrpc": "2.0"، "روش": "اقدام. ایجاد"، "params": { "name": "عمل ماشه"، "منبع رویداد": 0، "وضعیت": 0، "esc_period": "2m"، "فیلتر": { "evaltype": 3، "فرمول": "A و (B یا C)"، "شرایط": [ { "شرایط نوع": 4، "اپراتور": 5، "ارزش": "2"، "formulaid": "A" }، { "شرایط نوع": 1، "اپراتور": 0، "value": "10084"، "formulaid": "B" }، { "شرایط نوع": 1، "اپراتور": 0، "value": "10106"، "formulaid": "C" } ] }، "عملیات": [ { "نوع عملیات": 0، "esc_period": "0s"، "esc_step_from": 1، "esc_step_to": 2، "evaltype": 0، "opmessage_grp": [ { "usrgrpid": "7" } ]، "opmessage": { "default_msg": 1، "mediatypeid": "1" } } ]، "pause_suppressed": "0"، "notify_if_cancelled": "0" }، "auth": "038e1d7b1735c6a5436ee9eae095879e"، "id": 1 } ``` واکنش: ``json { "jsonrpc": "2.0"، "نتیجه": { "actionids": [ "18" ] }، "id": 1 } ``` ##### Using environment variables You can first store your credentials as environment variables, for example, by using a terminal: ```bash # Username and password: export ZABBIX_USER="Admin" export ZABBIX_PASSWORD="zabbix" # Token: export ZABBIX_TOKEN="your_api_token" ``` Then, if you start your script from the same terminal session, the `ZabbixAPI` instance in the script requires only the Zabbix web interface URL: ```python api = ZabbixAPI(url="127.0.0.1/zabbix") ``` You can also store the URL in an environment variable: ```bash # Username and password: export ZABBIX_USER="Admin" export ZABBIX_PASSWORD="zabbix" export ZABBIX_URL="https://127.0.0.1/zabbix" # Token: export ZABBIX_TOKEN="your_api_token" export ZABBIX_URL="https://127.0.0.1/zabbix" ``` When the URL and credentials are all set as environment variables, the `ZabbixAPI` instance in the script does not require any arguments at all: ```python api = ZabbixAPI() ``` سپس اگر اسکریپت خود را از همان **Terminal Session** اجرا کنید، نمونهی `ZabbixAPI` در اسکریپت فقط به آدرس رابط وب Zabbix نیاز خواهد داشت: ```python id="r2k9qd" api = ZabbixAPI(url="127.0.0.1/zabbix") ``` همچنین میتوانید آدرس URL و اطلاعات احراز هویت را در قالب **Environment Variable** ذخیره کنید: ```bash id="q8l1mz" # استفاده از نام کاربری و رمز عبور: export ZABBIX_USER="Admin" export ZABBIX_PASSWORD="zabbix" export ZABBIX_URL="https://127.0.0.1/zabbix" # استفاده از Token: export ZABBIX_TOKEN="your_api_token" export ZABBIX_URL="https://127.0.0.1/zabbix" ``` در صورتی که URL و اطلاعات احراز هویت همگی بهعنوان Environment Variable تنظیم شده باشند، نمونهی `ZabbixAPI` در اسکریپت دیگر به هیچ آرگومانی نیاز نخواهد داشت: ```python id="p1m3tz" api = ZabbixAPI() ``` ##### Using filter You can use the filter to display only the maps you are interested in. For better search performance, data is searched with macros unresolved. ##### استفاده از فیلتر شما می توانید از فیلتر برای نمایش تنها نقشه های مورد علاقه خود استفاده کنید. برای عملکرد بهتر جستجو، داده ها با ماکروهای حل نشده جستجو می شوند. ##### Using `login()` You can first create a `ZabbixAPI` instance with just the Zabbix web interface URL, and later use the `login()` method with your credentials: ```python # Username and password: api = ZabbixAPI(url="127.0.0.1/zabbix") api.login(user="Admin", password="zabbix") # API token: api = ZabbixAPI(url="127.0.0.1/zabbix") api.login(token="your_api_token") ``` ##### استفاده از متد `login()` میتوانید ابتدا یک نمونه از `ZabbixAPI` را فقط با استفاده از آدرس رابط وب Zabbix ایجاد کرده و سپس در مرحله بعد، با استفاده از متد `login()` اطلاعات احراز هویت خود را وارد کنید: ```python # استفاده از نام کاربری و رمز عبور: api = ZabbixAPI(url="127.0.0.1/zabbix") api.login(user="Admin", password="zabbix") # استفاده از API Token: api = ZabbixAPI(url="127.0.0.1/zabbix") api.login(token="your_api_token") ``` ### version Module version. The version will be displayed in the Administration section. *Type*: String *Example*: ```json "version": "1.0" ``` ### نام نام ماژولی که در بخش مدیریت نمایش داده خواهد شد. *نوع*: رشته *مثال*: ```json "name": "ماژول من" ``` # Views View file receives the data from a controller and then prepares the HTML look of it. :::noteclassic Defining view(s) for a frontend module is optional, unless the module is a widget.<br> Dashboard widgets need at least two views: one for the edit mode and one for the view mode (should be stored in the *views* directory). ::: It is possible to use pre-defined Zabbix HTML classes (from the */zabbix/ui/include/classes/html*) in the view as well as add new HTML and CSS classes. New classes should be stored in the module's *assets* folder. Example: ```` ... (new CColHeader(_('Name'))) ```` This will add a new column name *Name* and style the top table row as on other Zabbix pages. # Views فایل View دادهها را از یک کنترلر دریافت میکند و سپس ظاهر HTML آن را آماده میکند. :::noteclassic تعریف view(ها) برای یک ماژول frontend اختیاری است، مگر اینکه ماژول یک ویجت باشد.\ ابزارکهای داشبورد حداقل به دو view نیاز دارند: یکی برای حالت ویرایش و دیگری برای حالت نمایش (باید در دایرکتوری *views* ذخیره شوند). :: استفاده از کلاسهای HTML از پیش تعریف شده Zabbix (از */zabbix/ui/include/classes/html*) در view و همچنین اضافه کردن کلاسهای HTML و CSS جدید امکانپذیر است. کلاسهای جدید باید در پوشه *assets* ماژول ذخیره شوند. مثال: ```` ... (new CColHeader(_('Name'))) ```` این یک نام ستون جدید *Name* اضافه میکند و ردیف بالای جدول را مانند سایر صفحات Zabbix سبکبندی میکند. **Webhook** The following additional elements are exported only for the *Webhook* media type. |Element|<|Type|Description| |-|---|---|-----------------------| |script|<|string|Script.| |timeout|<|string|Javascript script HTTP request timeout interval.<br>Possible values:^[1](#footnotes)^ 1-60s (default: 30s).| |process\_tags|<|string|Whether to process returned tags.<br>Possible values:^[1](#footnotes)^ NO (0, default), YES (1).| |show\_event\_menu|<|string|Indicates the presence of an entry in the event menu if the {EVENT.TAGS.\*} macro was successfully resolved in `event_menu_url` and `event_menu_name` fields.<br>Possible values:^[1](#footnotes)^ NO (0, default), YES (1).| |event\_menu\_url|<|string|URL of the event menu entry. Supports {EVENT.TAGS.\*} macro.| |event\_menu\_name|<|string|Name of the event menu entry. Supports {EVENT.TAGS.\*} macro.| |parameters|<| |Root element for webhook media type parameters.| |<|name|string|(required) Webhook parameter name.| |^|value|string|Webhook parameter value.| ::: noteclassic See also: [Media type object](/manual/api/reference/mediatype/object) (refer to the relevant property with a matching name). ::: **Webhook** عناصر اضافی زیر فقط برای نوع رسانه *Webhook* صادر میشوند. |عنصر|<|نوع|توضیحات| |-|---|---|----------------------| |script|<|string|Script.| |timeout|<|string|Javascript script فاصله زمانی درخواست HTTP.<br>مقادیر ممکن:^[1](#footnotes)^ 1-60 ثانیه (پیشفرض: 30 ثانیه).| |process\_tags|<|string|اینکه آیا برچسبهای برگردانده شده پردازش شوند یا خیر.<br>مقادیر ممکن:^[1](#footnotes)^ خیر (0، پیشفرض)، بله (1).| |show\_event\_menu|<|string|نشانگر وجود یک ورودی در منوی رویداد است اگر ماکروی {EVENT.TAGS.\*} با موفقیت در فیلدهای `event_menu_url` و `event_menu_name` حل شده باشد.<br>مقادیر ممکن:^[1](#footnotes)^ خیر (0، پیشفرض)، بله (1).| |event\_menu\_url|<|string|URL ورودی منوی رویداد. از ماکروی {EVENT.TAGS.\*} پشتیبانی میکند.| |event\_menu\_name|<|string|نام ورودی منوی رویداد. از ماکروی {EVENT.TAGS.\*} پشتیبانی میکند.| |parameters|<| |عنصر ریشه برای پارامترهای نوع رسانه webhook.| |<|name|string|(الزامی) نام پارامتر Webhook.| |^|value|string|مقدار پارامتر Webhook.| ::: noteclassic همچنین ببینید: [شیء نوع رسانه](/manual/api/reference/mediatype/object) (به ویژگی مربوطه با نام منطبق مراجعه کنید). ::: #### Web monitoring Configure web scenarios to monitor your web applications and services. [Web scenario API](/manual/api/reference/httptest) #### نظارت بر وب پیکربندی سناریوهای وب برای نظارت بر برنامهها و سرویسهای وب شما.[Web scenario API](/manual/api/reference/httptest) ### What a module can be used for - Adding new functionality via custom frontend sections; - Creating custom dashboard widget types (see [widget modules](/devel/modules/widgets)); - Overriding or extending the existing functionality. ### یک ماژول برای چه مواردی قابل استفاده است - افزودن قابلیتهای جدید از طریق بخشهای سفارشی فرانتاند؛ - ایجاد انواع ویجت داشبورد سفارشی (به [ماژولهای ویجت](/devel/modules/widgets) مراجعه کنید)؛ - لغو یا گسترش قابلیتهای موجود. ### What a module cannot be used for - Registering a new API method or modifying an existing one. ### چه مواردی را نمیتوان از یک ماژول استفاده کرد - ثبت یک متد API جدید یا تغییر یک متد موجود. ##### What can be exported/imported Objects that can be exported/imported are: - [Host groups](/manual/xml_export_import/hostgroups) (*through Zabbix API only*) - [Template groups](/manual/xml_export_import/templategroups) (*through Zabbix API only*) - [Templates](/manual/xml_export_import/templates) - [Hosts](/manual/xml_export_import/hosts) - [Network maps](/manual/xml_export_import/maps) - [Media types](/manual/xml_export_import/media) - Images ##### چه چیزهایی میتوانند export/import شوند اشیایی که میتوانند export/import شوند عبارتند از: - [Host groups](/manual/xml_export_import/hostgroups) (*فقط از طریق Zabbix API*) - [Template groups](/manual/xml_export_import/templategroups) (*فقط از طریق Zabbix API*) - [Templates](/manual/xml_export_import/templates) - [Hosts](/manual/xml_export_import/hosts) - [Network maps](/manual/xml_export_import/maps) - [Media types](/manual/xml_export_import/media) - تصاویر ### What is a PHP frontend module? - A module is an entity with a unique ID, name, description, author, and other fields defined in it's manifest file, along with PHP, Javascript and other files located in a single directory inside the *modules* directory of your Zabbix frontend installation (for example, *zabbix/ui/modules*). - A module should conform to simple rules to guarantee correct operation. - A module must be installed (unpacked) and enabled in the frontend by the administrator. ### ماژول PHP frontend چیست؟ - یک ماژول، موجودیتی با شناسه، نام، توضیحات، نویسنده و سایر فیلدهای منحصر به فرد است که در فایل manifest آن تعریف شده است، به همراه فایلهای PHP، Javascript و سایر فایلهایی که در یک دایرکتوری واحد در داخل دایرکتوری *modules* از نصب Zabbix frontend شما قرار دارند (به عنوان مثال، *zabbix/ui/modules*). - یک ماژول باید از قوانین سادهای پیروی کند تا عملکرد صحیح آن تضمین شود. - یک ماژول باید توسط مدیر در frontend نصب (از حالت فشرده خارج) و فعال شود. ### What you'll create This tutorial demonstrates how to create a new loadable plugin **MyIP**. The plugin will implement a single item key, **myip**, which returns the external IP address of the host where Zabbix agent 2 is running. ### آنچه ایجاد خواهید کرد این آموزش نحوه ایجاد یک افزونه جدید قابل بارگذاری **MyIP** را نشان میدهد. این افزونه یک کلید آیتم واحد، **myip**، را پیادهسازی میکند که آدرس IP خارجی میزبانی را که Zabbix agent 2 در آن اجرا میشود، برمیگرداند. ### Where to go next Whether you prefer to learn by doing or read the guidelines first, these pages contain the information and steps required to build your own modules: - [Step-by-step tutorials for writing your first module](/devel/modules/tutorials) - [Module file structure](/devel/modules/file_structure) - [Widget module specifics](/devel/modules/widgets) - [Module examples to reuse](/devel/modules/examples) ### مرحله بعدی چه ترجیح دهید با انجام دادن یاد بگیرید و چه ابتدا دستورالعملها را بخوانید، این صفحات شامل اطلاعات و مراحل مورد نیاز برای ساخت ماژولهای خودتان هستند: - [آموزشهای گام به گام برای نوشتن اولین ماژول شما](/devel/modules/tutorials) - [ساختار فایل ماژول](/devel/modules/file_structure) - [مشخصات ماژول ویجت](/devel/modules/widgets) - [مثالهای ماژول برای استفاده مجدد](/devel/modules/examples) ### Widget action The widget action class (*WidgetView*) contains methods for operations with widgets in the presentation view mode. The majority of widget actions use and/or extend the default controller class *CControllerDashboardWidgetView*. The widget action class should be located in the *actions* directory and specified in the [*actions*](/devel/modules/file_structure/manifest#actions) parameter (*actions/widget.{id}.view/class*) in the *manifest.json* file. **actions/WidgetView.php example (implemented in the Zabbix-native [*System information*](/manual/web_interface/frontend_sections/dashboards/widgets/system) widget)** ```php class WidgetView extends CControllerDashboardWidgetView { protected function doAction(): void { $this->setResponse(new CControllerResponseData([ 'name' => $this->getInput('name', $this->widget->getDefaultName()), 'system_info' => CSystemInfoHelper::getData(), 'info_type' => $this->fields_values['info_type'], 'user_type' => CWebUser::getType(), 'user' => [ 'debug_mode' => $this->getDebugMode() ] ])); } } ``` ### اکشن ویجت کلاس اکشن ویجت (*WidgetView*) شامل متدهایی برای عملیات با ویجتها در حالت نمایش ارائه است. اکثر اکشنهای ویجت از کلاس کنترلر پیشفرض *CControllerDashboardWidgetView* استفاده و/یا آن را ارثبری میکنند. کلاس اکشن ویجت باید در دایرکتوری *actions* قرار داشته باشد و در پارامتر [*actions*](/devel/modules/file_structure/manifest#actions) (*actions/widget.{id}.view/class*) در فایل *manifest.json* مشخص شود. **مثال actions/WidgetView.php (پیادهسازی شده در ویجت بومی Zabbix [*System information*](/manual/web_interface/frontend_sections/dashboards/widgets/system)** ```php کلاس WidgetView از CControllerDashboardWidgetView ارثبری میکند { تابع محافظتشده doAction(): void { $this->setResponse(new CControllerResponseData([ 'name' => $this->getInput('name', $this->widget->getDefaultName()), 'system_info' => CSystemInfoHelper::getData(), 'info_type' => $this->fields_values['info_type'], 'user_type' => CWebUser::getType(), 'user' => [ 'debug_mode' => ‎$this->getDebugMode() ] ])); } } ``` ### Widget examples - Minimal widget - [widget_min.zip](/../assets/en/devel/modules/examples/widget_min.zip) - "Hello, world" widget using CSS only - [hello_world_css.zip](/../assets/en/devel/modules/examples/hello_world_css.zip) - "Hello, world" widget using JavaScript only - [hello_world_js.zip](/../assets/en/devel/modules/examples/hello_world_js.zip) - "Hello, world" widget using PHP - [hello_world_php.zip](/../assets/en/devel/modules/examples/hello_world_php.zip) ::: notetip You can also use [Zabbix native widgets](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/ui/widgets?at=refs%2Fheads%2Frelease%2F7.4) as examples. ::: ### مثالهای ویجت - ویجت مینیمال - [widget_min.zip](/../assets/en/devel/modules/examples/widget_min.zip) - ویجت "Hello, world" فقط با استفاده از CSS - [hello_world_css.zip](/../assets/en/devel/modules/examples/hello_world_css.zip) - ویجت "Hello, world" فقط با استفاده از جاوا اسکریپت - [hello_world_js.zip](/../assets/en/devel/modules/examples/hello_world_js.zip) - ویجت "Hello, world" با استفاده از PHP - [hello_world_php.zip](/../assets/en/devel/modules/examples/hello_world_php.zip) ::: نکته همچنین میتوانید از [Zabbix native] استفاده کنید widgets](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/ui/widgets?at=refs%2Fheads%2Frelease%2F7.4) به عنوان مثال. ::: ### WidgetForm The *WidgetForm* class extends the default class *CWidgetForm* and contains a set of [*CWidgetField*](#cwidgetfield) fields that are required for defining widget configuration storage structure in the database and handling input validation. The *WidgetForm* class should be located in the *includes* directory. If the class has a different name, the name should be specified in the [*widget/form_class*](/devel/modules/file_structure/manifest#widget) parameter in the *manifest.json* file. **includes/WidgetForm.php example** ```php <?php namespace Modules\MyCustomWidget\Includes; use Modules\MyCustomWidget\Widget; use Zabbix\Widgets\{ CWidgetField, CWidgetForm }; use Zabbix\Widgets\Fields\{ CWidgetFieldMultiSelectItem, CWidgetFieldTextBox, CWidgetFieldColor }; class WidgetForm extends CWidgetForm { public const DEFAULT_COLOR_PALETTE = [ 'FF465C', 'B0AF07', '0EC9AC', '524BBC', 'ED1248', 'D1E754', '2AB5FF', '385CC7', 'EC1594', 'BAE37D', '6AC8FF', 'EE2B29', '3CA20D', '6F4BBC', '00A1FF', 'F3601B', '1CAE59', '45CFDB', '894BBC', '6D6D6D' ]; public function addFields(): self { return $this ->addField( (new CWidgetFieldMultiSelectItem('itemid', _('Item'))) ->setFlags(CWidgetField::FLAG_NOT_EMPTY | CWidgetField::FLAG_LABEL_ASTERISK) ->setMultiple(false) ) ->addField( new CWidgetFieldTextBox('description', _('Description')) ) ->addField( (new CWidgetFieldColor('chart_color', _('Color')))->setDefault('FF0000') ); } } ``` ### WidgetForm کلاس *WidgetForm* از کلاس پیشفرض *CWidgetForm* ارثبری میکند و شامل مجموعهای از فیلدهای [*CWidgetField*](#cwidgetfield) است که برای تعریف ساختار ذخیرهسازی پیکربندی ویجت در پایگاه داده و مدیریت اعتبارسنجی ورودی مورد نیاز هستند. کلاس *WidgetForm* باید در دایرکتوری *includes* قرار گیرد. اگر کلاس نام دیگری دارد، نام آن باید در پارامتر [*widget/form_class*](/devel/modules/file_structure/manifest#widget) در فایل *manifest.json* مشخص شود. **includes/WidgetForm.php example** ```php <?php namespace Modules\MyCustomWidget\Includes; use Modules\MyCustomWidget\Widget; از Zabbix\Widgets\{ CWidgetField, CWidgetForm }; از Zabbix\Widgets\Fields\{ CWidgetFieldMultiSelectItem, CWidgetFieldTextBox, CWidgetFieldColor }; استفاده کنید کلاس WidgetForm از CWidgetForm ارث بری میکند { public const DEFAULT_COLOR_PALETTE = [ 'FF465C', 'B0AF07', '0EC9AC', '524BBC', 'ED1248', 'D1E754', '2AB5FF', '385CC7', 'EC1594', 'BAE37D', 6AC8FF', 'EE2B29', '3CA20D', '6F4BBC', '00A1FF', 'F3601B', '1CAE59', '45CFDB', '894BBC', '6D6D6D' ]; تابع عمومی addFields(): self { return $this ->addField( (new CWidgetFieldMultiSelectItem('itemid', _('Item'))) ->setFlags(CWidgetField::FLAG_NOT_EMPTY | CWidgetField::FLAG_LABEL_ASTERISK) ->setMultiple(false) ) ->addField( new CWidgetFieldTextBox('description', _('Description')) ) ->addField( (new CWidgetFieldColor('chart_color', _('Color')))->setDefault('FF0000') ); } } ``` ## Widget preview Widget modules, once added, become immediately visible in the dashboard widget list. You can open a dashboard, switch to the edit mode and add the widget to the dashboard as usual. When you make some changes to the widget, refresh the dashboard to view how the widget looks with the most recent updates. ## پیشنمایش ویجت ماژولهای ویجت، پس از اضافه شدن، بلافاصله در لیست ویجتهای داشبورد قابل مشاهده میشوند. شما میتوانید داشبورد را باز کنید، به حالت ویرایش بروید و ویجت را طبق معمول به داشبورد اضافه کنید. هنگامی که تغییراتی در ویجت ایجاد میکنید، داشبورد را رفرش کنید تا ببینید ویجت با جدیدترین بهروزرسانیها چگونه به نظر میرسد. ### Widget Primary widget class, extends the base class of all dashboard widgets - *CWidget*. Required for overriding the default widget behavior. The *Widget* class should be located in the root directory of the widget (for example, *zabbix/ui/modules/my_custom_widget*). **Widget.php example** ```php <?php namespace Modules\MyCustomWidget; use Zabbix\Core\CWidget; class Widget extends CWidget { public const MY_CONSTANT = 0; public function getTranslationStrings(): array { return [ 'class.widget.js' => [ 'No data' => _('No data') ] ]; } } ``` ### ویجت کلاس ویجت اصلی، کلاس پایه همه ویجتهای داشبورد - *CWidget* را ارثبری میکند. برای لغو رفتار پیشفرض ویجت مورد نیاز است. کلاس *Widget* باید در دایرکتوری ریشه ویجت قرار داشته باشد (برای مثال، *zabbix/ui/modules/my_custom_widget*). **مثال Widget.php** ```php <?php namespace Modules\MyCustomWidget; use Zabbix\Core\CWidget; کلاس Widget extends CWidget { public const MY_CONSTANT = 0; public function getTranslationStrings(): array { return [ 'class.widget.js' => [ 'No data' => _('No data') ] ]; } } ```` # Widgets Widgets are Zabbix frontend modules used for the dashboards. Unless otherwise noted, all module guidelines are also applicable to widgets. However, a widget is notably different from a module. To build a widget: - specify the type "widget" in the [manifest.json file](/devel/modules/file_structure/manifest) ("type": "widget"); - include at least two views: one for the [widget presentation mode](/devel/modules/widgets/presentation#widget-view) and one for the [widget configuration mode](/devel/modules/widgets/configuration#widget-configuration-view) (example.widget.view.php and example.widget.edit.php); - and a [controller](/devel/modules/widgets/presentation#widget-actions) for widget presentation (WidgetView.php); - use and extend default [widget classes](/devel/modules/widgets/configuration). # ابزارکها ابزارکها ماژولهای frontend زبیکس هستند که برای داشبوردها استفاده میشوند. مگر اینکه خلاف آن ذکر شده باشد، تمام دستورالعملهای ماژول برای ابزارکها نیز قابل اجرا هستند. با این حال، یک ابزارک به طور قابل توجهی با یک ماژول متفاوت است. برای ساخت یک ابزارک: - نوع "ابزارک" را در [manifest.json file](/devel/modules/file_structure/manifest) مشخص کنید ("type": "widget")؛ - حداقل دو نما را شامل کنید: یکی برای [widget presentation mode](/devel/modules/widgets/presentation#widget-view) و یکی برای [widget configuration mode](/devel/modules/widgets/configuration#widget-configuration-view) (example.widget.view.php و example.widget.edit.php)؛ - و یک [controller](/devel/modules/widgets/presentation#widget-actions) برای نمایش ویجت (WidgetView.php)؛ - استفاده و توسعهی پیشفرض [widget classes](/devel/modules/widgets/configuration). ### Widget view The widget view class (*CWidgetView*) is responsible for building the widget presentation view. The widget view class should be located in the *views* directory. If the file containing the widget view class has a different name than the default (*widget.view.php*), then it must be specified in the *manifest.json* file [*actions*](/devel/modules/file_structure/manifest#actions) parameter (*actions/widget.{id}.view/view*). **views/widget.view.php example** ```php <?php /** * My custom widget view. * * @var CView $this * @var array $data */ (new CWidgetView($data)) ->addItem( new CTag('h1', true, $data['name']) ) ->show(); ``` ### نمای ویجت کلاس نمای ویجت (*CWidgetView*) مسئول ساخت نمای ارائه ویجت است. کلاس نمای ویجت باید در دایرکتوری *views* قرار داشته باشد. اگر فایل حاوی کلاس نمای ویجت نامی متفاوت از نام پیشفرض (*widget.view.php*) داشته باشد، باید در پارامتر فایل *manifest.json* [*actions*](/devel/modules/file_structure/manifest#actions) (*actions/widget.{id}.view/view*) مشخص شود. **views/widget.view.php example** ```php <?php /** * نمای ویجت سفارشی من. * * @var CView $this * @var array $data */ (new CWidgetView($data)) ->addItem( new CTag('h1', true, $data['name']) ) ->show(); ``` ### widget Widget configuration. Used, if *[type](#type)* is set to *widget*. *Type*: Object *Supported object keys:* - **name** (string) - used in the widget list and as default header. If empty, "name" parameter from the module will be used. - **size** (object) - default widget dimensions. Supports keys: - *width* (integer) - default widget width. - *height* (integer) - default widget height. - **form_class** (string) - class with widget fields form. Must be located in the *includes* directory. If the class is *WidgetForm.php*, which is expected by default, this parameter maybe omitted. If using a different name, specify it here. - **js_class** (string) - name of a JavaScript class for widget view mode to extend the default CWidget class. The class will be loaded with the dashboard. The class source file must be located in the assets/js directory. See also: [assets](#assets). - **use_time_selector** (boolean) - determines whether the widget requires dashboard time selector. Supported values: *true*, *false* (default). - **refresh_rate** (integer) - widget refresh rate in seconds (default: 60). *Example*: ```json "widget": { "name": "", "size": { "width": 12, "height": 5 }, "form_class": "WidgetForm", "js_class": "CWidget", "use_time_selector": false, "refresh_rate": 60 } ``` ### ویجت پیکربندی ویجت. اگر *[type](#type)* روی *widget* تنظیم شده باشد، استفاده میشود. *Type*: شیء *کلیدهای شیء پشتیبانی شده:* - **name** (رشته) - در لیست ویجت و به عنوان هدر پیشفرض استفاده میشود. اگر خالی باشد، پارامتر "name" از ماژول استفاده خواهد شد. - **size** (شیء) - ابعاد پیشفرض ویجت. کلیدهای پشتیبانی شده: - *width* (عدد صحیح) - عرض پیشفرض ویجت. - *height* (عدد صحیح) - ارتفاع پیشفرض ویجت. - **form_class** (رشته) - کلاسی با فیلدهای ویجت فرم. باید در دایرکتوری *includes* قرار گیرد. اگر کلاس *WidgetForm.php* باشد، که به طور پیشفرض انتظار میرود، ممکن است این پارامتر حذف شود. اگر از نام دیگری استفاده میکنید، آن را اینجا مشخص کنید. - **js_class** (رشته) - نام یک کلاس جاوا اسکریپت برای حالت نمایش ویجت برای گسترش کلاس پیشفرض CWidget. این کلاس به همراه داشبورد بارگذاری خواهد شد. فایل منبع کلاس باید در دایرکتوری assets/js قرار داشته باشد. همچنین ببینید: [assets](#assets). - **use_time_selector** (boolean) - تعیین میکند که آیا ویجت به انتخابگر زمان داشبورد نیاز دارد یا خیر. مقادیر پشتیبانی شده: *true*، *false* (پیشفرض). - **refresh_rate** (عدد صحیح) - نرخ بهروزرسانی ویجت بر حسب ثانیه (پیشفرض: ۶۰). *مثال*: ```json "widget": { "name": "", "size": { "width": 12, "height": 5 }, "form_class": "WidgetForm", "js_class": "CWidget", "use_time_selector": false, "refresh_rate": 60 } ```` #### XML format The XML export format contains the following tags: - Default header for XML documents - Root tag for Zabbix XML export - Export version ```xml <?xml version="1.0" encoding="UTF-8"?> <zabbix_export> <version>7.4</version> </zabbix_export> ``` Other tags are dependent on exported objects. #### فرمت XML فرمت خروجی XML شامل برچسبهای زیر است: - سربرگ پیشفرض برای اسناد XML - برچسب ریشه برای خروجی XML زبیکس - نسخه خروجی ```xml <?xml version="1.0" encoding="UTF-8"?> <zabbix_export> <version>7.4</version> </zabbix_export> ``` سایر برچسبها به اشیاء خروجی وابسته هستند. ##### XML XPath {#xpath} Extract value or fragment from XML data using XPath functionality. Comments: - For this option to work, Zabbix server (or Zabbix proxy) must be compiled with libxml support;<br> - Namespaces are not supported;<br> - If you mark the *Custom on fail* checkbox, it is possible to specify custom error-handling options: either to discard the value, set a specified value, or set a specified error message. In case of a failed preprocessing step, the item will not become unsupported if the option to discard the value or set a specified value is selected. Examples: ```default number(/document/item/value) #will extract '10' from <document><item><value>10</value></item></document> number(/document/item/@attribute) #will extract '10' from <document><item attribute="10"></item></document> /document/item #will extract '<item><value>10</value></item>' from <document><item><value>10</value></item></document> ``` ###### XML XPath {#xpath}استخراج مقدار یا قطعهای از دادههای XML با استفاده از قابلیت XPath. توضیحات:-برای کار کردن این گزینه، سرور Zabbix (یا پروکسی Zabbix) باید با پشتیبانی libxml کامپایل شود.<br>-فضاهای نام پشتیبانی نمیشوند.<br>-اگر کادر *سفارشی در صورت عدم موفقیت* را علامت بزنید، میتوانید گزینههای سفارشی مدیریت خطا را مشخص کنید: یا مقدار را حذف کنید، یک مقدار مشخص تنظیم کنید یا یک پیام خطای مشخص تنظیم کنید.در صورت شکست مرحله پیشپردازش، اگر گزینه حذف مقدار یا تنظیم یک مقدار مشخص انتخاب شود، آیتم پشتیبانی نشده باقی میماند.مثالها:```defaultnumber(/document/item/value) #'10' را از <document><item><value>10</value></item></document>number(/document/item/@attribute) #'10' را از <document><item>استخراج میکند. attribute="10"></item></document>/document/item #'<item><value>10</value></item>' را از <document><item><value>10</value></item></document> استخراج خواهد کرد. #### YAML base format The YAML export format contains the following nodes: - Root node for Zabbix YAML export - Export version ```yaml zabbix_export: version: '7.4' ``` Other nodes are dependent on exported objects. #### فرمت پایه YAML فرمت خروجی YAML شامل گرههای زیر است: - گره ریشه برای خروجی YAML زبیکس - نسخه خروجی ```yaml zabbix_export: نسخه: '7.4' ``` سایر گرهها به اشیاء خروجی وابسته هستند. ### Zabbix agent 2 Zabbix Cloud nodes do not run Zabbix agent 2, so it is not possible to use checks that require it—for example, HTTPS [certificate monitoring](/manual/guides/monitor_certificate) using the `web.certificate.get` item. ### Zabbix agent 2 گره‌های ابری Zabbix، Zabbix agent 2 را اجرا نمی‌کنند، بنابراین استفاده از بررسی‌هایی که به آن نیاز دارند - برای مثال، HTTPS [certificate monitoring](/manual/guides/monitor_certificate) با استفاده از آیتم `web.certificate.get` - امکان‌پذیر نیست. # Zabbix Cloud زبیکس تحت ابر # Zabbix Cloud [Zabbix Cloud](https://zabbix.com/cloud) is a cloud-based platform allowing its users to run self-contained Zabbix instances in the cloud (cloud nodes). Compared to a regular, on-premise Zabbix deployment: - No installation or maintenance is required - Cloud nodes are fully managed by Zabbix - Cloud nodes can be started within minutes This service is offered on a pay-as-you-go basis (a **free trial** is available). For more information, see: - [Deploy Zabbix in the cloud](/cloud/quickstart) (Quickstart Guide) - [Key differences of Zabbix Cloud](/cloud/key_differences) ::: noteclassic Zabbix Cloud nodes currently run **Zabbix 7.0**. Cloud nodes run the same Zabbix software as on-premise installations. For in-depth information on Zabbix 7.0, see [official documentation](https://www.zabbix.com/documentation/7.0/en/manual). ::: # Zabbix Cloud این بخش شامل هر آنچه که باید در مورد گزینه‌های پیکربندی و کنترل‌های دسترسی موجود برای سازمان‌ها و گره‌ها در Zabbix Cloud بدانید، می‌باشد: - [استقرار Zabbix با Zabbix Cloud](/cloud/quickstart) - [پیکربندی گره](/cloud/node_configuration) - [افزودن کاربران](/cloud/adding_users) به گره‌ها و سازمان‌ها ::: noteclassic Zabbix Cloud در حال حاضر Zabbix 7.0 را اجرا می‌کند. لطفاً برای اطلاعات مربوط به محیط فعلی Zabbix Cloud به [مستندات Zabbix 7.0](https://www.zabbix.com/documentation/7.0/en/manual) مراجعه کنید. :: # Zabbix documentation These pages contain official Zabbix documentation. Use the sidebar navigation to browse documentation pages. To be able to watch pages, log in with your [Zabbix forums](http://www.zabbix.com/forum/) username and password. # مستندات Zabbix 6.0 این صفحات حاوی اسناد رسمی Zabbix هستند. از پیمایش نوار کناری برای مرور صفحات اسناد استفاده کنید. برای اینکه بتوانید صفحات را تماشا کنید، با [Zabbix] خود وارد شوید forums](http://www.zabbix.com/forum/) نام کاربری و رمز عبور. # Zabbix manpages Reference documentation for Zabbix command‑line tools and services, listing available commands, options, and usage examples. # صفحات راهنمای زبیکس صفحات راهنمای جاری مربوط به فرایند های زبیکس می باشند. # Zabbix Manual Welcome to the user manual for Zabbix software. These pages are created to help users successfully manage their monitoring tasks with Zabbix, from the simple to the more complex ones. # دفترچه راهنمای Zabbix به راهنمای کاربر نرم افزار Zabbix خوش آمدید. این صفحات ایجاد شده اند تا به کاربران کمک کند وظایف مانیتورینگ خود را با Zabbix، از ساده تا پیچیده، با موفقیت مدیریت کنند. [zabbix\_utils](https://github.com/zabbix/python-zabbix-utils/blob/main/README.md) is the official Python library for Zabbix. With zabbix\_utils you can: - Use Zabbix API to manage Zabbix objects (create hosts, update items, get events, etc.). - Collect data from Zabbix agent (similarly to Zabbix get). - Send data to Zabbix server or proxy (similarly to Zabbix sender). The library supports both synchronous and asynchronous script execution, allowing it to handle both simple workflows and large-scale parallel operations such as mass data collection, bulk exports, alert processing, and efficient system scaling. The library is compatible with supported Zabbix server versions and modern Python releases. To get started, [install](/devel/python/install) the library and then follow the [quickstart](/devel/python/quickstart) guide. [zabbix_utils](https://github.com/zabbix/python-zabbix-utils/blob/main/README.md) کتابخانه رسمی پایتون برای Zabbix است. با استفاده از zabbix_utils میتوانید: - از Zabbix API برای مدیریت اشیاء Zabbix استفاده کنید (ایجاد هاستها، بهروزرسانی آیتمها، دریافت رویدادها و غیره). - دادهها را از Zabbix agent جمعآوری کنید (مشابه Zabbix get). - دادهها را به سرور یا پروکسی Zabbix ارسال کنید (مشابه Zabbix sender). این کتابچه از اجرای همزمان (synchronous) و ناهمزمان (asynchronous) اسکریپتها پشتیبانی میکند و به شما امکان میدهد هم گردشهای کاری ساده و هم عملیات موازی در مقیاس بزرگ مانند جمعآوری انبوه داده، خروجیگیری حجیم، پردازش هشدارها و مقیاسدهی کارآمد سیستم را مدیریت کنید. این کتابخانه با نسخههای پشتیبانیشده سرور Zabbix و نسخههای مدرن پایتون سازگار است. برای شروع، کتابخانه را [نصب](/devel/python/install) کنید و سپس راهنمای [شروع سریع](/devel/python/quickstart) را دنبال کنید. acknowledge اعلام وصول acknowledged اعلام وصول شده Boolean to decimal عدد بولی به عدد دهگانی Change per second تغییر در ثانیه Custom multiplier ضرب کننده سفارشی dashboard داشبورد item آیتم Octal to decimal عدد هشت هشتی به عدد دهگانی Regular expression عبارت منظم Replace جایگزین کردن template قالب Zabbix زبیکس 0 or 1 0 یا 1 %1$d day %1$d روز%1$d روز %1$s Item %1$s آيتم%1$s آيتم %1$s (year %2$s) %1$s(سال%2$s) 10 seconds 10 ثانیه 1 minute 1 دقیقه 30 seconds 30 ثانیه 3D view نمایش سه بعدی 500 latest values 500 مقدار اخیر 5 minutes 5 دقیقه 5 seconds 5 ثانیه Access denied! غير قابل دسترسي! Ack تأیید Acknowledge تأیید کردن Acknowledged تأیید شده Acknowledged PROBLEM events تأیید رویدادهای مشکل Action فعالیت ها Action added فعالیت اضافه شد Action deleted فعالیت حذف شد Actions فعالیت ها Action updated فعالیت بروز شد Active فعال Active since فعال از Active till فعال تا Add افزودن Added افزوده شد Add host افزودن هاست Add prototype افزودن نمونه اولیه Add to favourites افزودن به مورد علاقه ها Add to host group افزودن به گروه هاست Add to host groups افزودن به گروه هاست ها Admin مدیر Administration مدیریت Advanced labels برچسب های پیشرفته AES AES Age سن Age less than سن کمتر از Age less than %s سن کمتر از %s agent عامل Agent عامل Agent interfaces واسط های عامل Alias نام مستعار all همه All همه All links should have "Name" and "URL" specified همه لینک ها باید "نام" و "آدرس" مشخص داشته باشند Allowed hosts هاست ها مجاز AND و Any هیچ Any character string included فاقد رشته کاراکتری Application برنامه ها Application "%1$s" already exists. برنامه "%s" قبلاً وجود دارد Application added برنامه اضافه شد Application error. خطای برنامه. Applications برنامه‌ها Application updated برنامه بروز شد Application with ID "%1$s" is not available on "%2$s". برنامه با شناسه "%1$s" در "%2$s" در دسترس نیست. Apply اعمال Apr آوریل April آوریل Area size اندازه ناحیه Area type نوع ناحیه Are you sure you want perform this action? آیا مطمئنید که می‌خواهید این فعالیت را اجرا کنید؟ Are you sure you want to delete آیا مطمئنید می‌خواهید حذف کنید as Blue به عنوان آبی as Green به عنوان سبز As is به عنوان As plain text به عنوان متن ساده as Red به عنوان قرمز Asset tag برچسب دارایی At (hour:minute) در (ساعت:دقیقه) Audit ممیزی Aug اوت August اوت Authentication تصدیق هویت Authentication algorithm الگوریتم تصدیق هویت Authentication method متد تصدیق هویت Auto-login ورود خودکار Automatic خودکار Automatic icon mapping نگاشت خودکار آیکن Automatic icon selection انتخاب آیکن خودکار Auto registration تصدیق هویت خودکار Availability دسترسی Availability report گزارش دسترسی Available در دسترس Average متوسط avg میانگین Background پس زمینه Background image تصویر پس زمینه Bind password مقید به کلمه عبور Blinking چشمک زن Blocked مسدود شده Bold line خط‌ توپر Bottom پایین By host توسط هاست By trigger template تو سط قالب هشدار Calculated محاسبه کردن Calculate SLA, acceptable SLA (in %) محاسبه SLA (درصد) Canada (136 characters) فارسی(136 کاراکتر) Cancel لغو Cannot add action فعالیت نمی تواند اضافه شود Cannot add application برنامه نمی تواند اضافه شود Cannot add dependency from a host to a template. وابستگی از یک هاست به یک قالب نمی‌تواند اضافه شود Cannot add discovery rule قانون کشف نمی تواند اضافه شود Cannot add graph نمودار نمی تواند اضافه شود Cannot add group گروه نمی تواند اضافه شود Cannot add host هاست نمی تواند اضافه شود Cannot add image تصویر نمی تواند اضافه شود Cannot add item آیتم نمی تواند اضافه شود Cannot add maintenance دوره نگهداری نمی تواند اضافه شود Cannot add media type نوع رسانه نمی تواند اضافه شود Cannot add network map نقشه شبکه نمی تواند اضافه شود Cannot add proxy پروکسی نمی تواند اضافه شود Cannot add regular expression عبارت منظم نمی تواند اضافه شود Cannot add screen صفحه نمایش نمی تواند اضافه شود Cannot add script اسکریپت نمی تواند اضافه شود Cannot add service سرویس نمی تواند اضافه شود Cannot add slide show نمایش اسلاید نمی تواند اضافه شود Cannot add template قالب نمی تواند اضافه شود Cannot add trigger هشدار نمی تواند اضافه شود Cannot add user کاربر نمی تواند اضافه شود Cannot add user. Both passwords must be equal. کاربر نمی تواند اضافه شود. هردو کلمه عبور باید یکسان باشند. Cannot add value map نگاشت مقدار نمی تواند اضافه شود Cannot clear history تاریخچه نمی‌تواند پاک شود Cannot clone graph prototypes. نمونه اولیه نمودارها نمی‌توانند کپی شوند Cannot clone item prototypes. نمونه اولیه آیتم ها نمی‌توانند کپی شوند Cannot clone trigger prototypes. نمونه اولیه هشدارها نمی‌توانند کپی شوند Cannot copy trigger "%1$s:%2$s", because it has multiple hosts in the expression. هشدار "%1$s:%2$s" نمی‌تواند کپی شود ، زیرا چندین هاست در عبارت خود دارد.هشدار "%1$s:%2$s" نمی‌تواند کپی شود ، زیرا چندین هاست در عبارت خود دارد.هشدار "%1$s:%2$s" نمی‌تواند کپی شود ، زیرا چندین هاست در عبارت خود دارد.هشدار "%1$s:%2$s" نمی‌تواند کپی شود ، زیرا چندین هاست در عبارت خود دارد.هشدار "%1$s:%2$s" نمی‌تواند کپی شود ، زیرا چندین هاست در عبارت خود دارد. Cannot create another database connection. اتصال دیگری به پایگاه داده نمی‌توانند ایجاد شود. Cannot create discovery rule قانون کشف نمی‌توانند ایجاد شود. Cannot create icon map نگاشت آیکن نمی‌توانند ایجاد شود. Cannot delete action فعالیت نمی‌تواند حذف شود Cannot delete discovery rule قانون کشف نمی‌تواند حذف شود Cannot delete graph نمودار نمی‌تواند حذف شود Cannot delete graphs نمودارها نمی‌توانند حذف شوند Cannot delete host هاست نمی‌تواند حذف شود Cannot delete icon map نگاشت آیکن نمی‌توانند حذف شود Cannot delete image تصویر نمی‌تواند حذف شود Cannot delete inventory. فهرست نمی‌تواند حذف شود. Cannot delete item آیتم نمی‌تواند حذف شود Cannot delete items آیتم ها نمی‌توانند حذف شوند Cannot delete maintenance دوره نگهداری نمی‌تواند حذف شود Cannot delete media type نوع رسانه نمی تواند حذف شود Cannot delete network map نقشه شبکه نمی تواند حذف شود Cannot delete proxy پروکسی نمی تواند حذف شود Cannot delete screen صفحه نمایش نمی تواند حذف شود Cannot delete script اسکریپت نمی تواند حذف شود Cannot delete scripts. Script "%1$s" is used in action operation "%2$s". اسکریپت ها نمی توانند حذف شوند.اسکریپت "%1$s" در عملکرد فعالیت "%2$s" استفاده شده است.اسکریپت ها نمی توانند حذف شوند.اسکریپت "%1$s" در عملکرد فعالیت "%2$s" استفاده شده است.اسکریپت ها نمی توانند حذف شوند.اسکریپت "%1$s" در عملکرد فعالیت "%2$s" استفاده شده است.اسکریپت ها نمی توانند حذف شوند.اسکریپت "%1$s" در عملکرد فعالیت "%2$s" استفاده شده است.اسکریپت ها نمی توانند حذف شوند.اسکریپت "%1$s" در عملکرد فعالیت "%2$s" استفاده شده است. Cannot delete selected actions فعالیت های انتخاب شده نمی‌توانند حذف شوند Cannot delete service سرویس نمی‌تواند حذف شود Cannot delete slide show نمایش اسلاید نمی‌تواند حذف شود Cannot delete template قالب نمی تواند حذف شود Cannot delete templated trigger "%1$s:%2$s". هشدارهای قالب شده "%1$s:%2$s" نمی توانند حذف شوند. Cannot delete trigger هشدار نمی‌تواند حذف شود Cannot delete triggers هشدارها نمی‌توانند حذف شوند Cannot delete user کاربر نمی‌تواند حذف شود Cannot delete value map نگاشت آیکن نمی‌تواند حذف شود Cannot find host interface on "%1$s" for item key "%2$s". واسط هاست در "%1$s" برای کلید آیتم "%2$s" پیدا نشد. Cannot include view file "%s". فایل نمایش "%s" نمی‌تواند شامل شود. Cannot link template قالب نمی تواند پیوندزده شود Cannot logout. نمیتوانید خارج شوید Cannot mass update host name. نام هاست را نمیتوانید دسته‌ای بروز کنید. Cannot mass update visible host name. نام قابل مشاهده هاست را نمیتوانید دسته‌ای بروز کنید. Cannot pass duplicate template IDs for the linkage: %s. شناسه قالب تکراری برای پیوند : %s را نمیتوانید پاس کنید. Cannot perform delete statement on table "%1$s" without where condition. دستور حذف برای جدول "%1$s" را نمیتوانید بدون شرط اجرا کنید. Cannot perform update statement on table "%1$s" without values. دستور بروزرسانی برای جدول "%1$s" را نمیتوانید بدون مقدار اجرا کنید. Cannot perform update statement on table "%1$s" without where condition. دستور بروزرسانی برای جدول "%1$s" را نمیتوانید بدون شرط اجرا کنید. Cannot save discovery rule without checks. قانون کشف بدون بررسی را نمیتوانید ذخیره کنید. Cannot unblock users کاربر را نمیتوانید رفع انسداد کنید Cannot unlink and clear discovery rules قوانین کشف را نمیتوانید جدا و پاک کنید Cannot unlink template قالب را نمی‌توانید جدا کنید Cannot update action فعالیت نمی‌تواند بروز شود Cannot update application برنامه نمی‌تواند بروز شود Cannot update configuration پیکر بندی نمی‌تواند بروز شود Cannot update debug mode حالت رفع خطا نمیتواند بروز شود Cannot update discovery rule قانون کشف نمیتواند بروز شود Cannot update frontend access دسترسی به واسط کاربری نمیتواند بروز شود Cannot update graph نمودار نمی‌تواند بروز شود Cannot update group گروه نمی‌تواند بروز شود Cannot update host هاست نمی‌تواند بروز شود Cannot update hosts هاست ها نمی‌تواند بروز شود Cannot update icon map نگاشت آیکن نمی‌توانند بروز شود. Cannot update image تصویر نمیتواند بروز شود Cannot update item آیتم نمی‌تواند بروز شود Cannot update items آیتم ها نمی‌توانند بروز شوند Cannot update macros ماکرو نمی‌تواند بروز شود Cannot update maintenance دوره نگهداری نمی‌تواند بروز شود Cannot update media type نوع رسانه نمی تواند بروز شود Cannot update network map نقشه شبکه نمی تواند بروز شود Cannot update proxy پروکسی نمی‌تواند بروز شود Cannot update regular expression عبارت منظم نمی تواند بروز شود Cannot update screen صفحه نمایش نمی تواند بروز شود Cannot update script اسکریپت نمی تواند بروز شود Cannot update service سرویس نمی‌تواند بروز شود Cannot update slide show نمایش اسلاید نمی‌تواند بروز شود Cannot update template قالب نمی تواند بروز شود Cannot update trigger هشدار نمی‌تواند بروز شود Cannot update user کاربر نمی‌تواند بروز شود Cannot update user. Both passwords must be equal. کاربر نمی‌تواند بروز شود. هردو کلمه عبور باشد یکسان باشند. Cannot update value map نگاشت نقشه نمیتواند بروز شود Case sensitive حساس به متن Change password تغییر رمز عبور Character کاراکتر Character string included در بر داشتن رشته کاراکتری Character string not included در بر نداشتن رشته کاراکتری Chassis اسکلت Check already exists. بررسی از قبل وجود دارد Check expression part starting from "%1$s". بخش عبارت بررسی از "%1$s" شروع می‌شود. Checks تطبیق ها Checks should be unique. تطبیق ها باید منحصر به فرد باشد. Check the key, please. Default example was passed. لطفاً کلید را بررسی کنید، نمونه پیش ‌فرض پاس داده خواهد شد. Check type نوع تطبیق Clear پاک کردن Clear history and trends پاک کردن تاریخچه و روند ها Clear when unlinking پاک کردن وقتی جدا شد Clock ساعت Clone کپی برداری Close بستن Close expression constructor بستن عبارت سازنده Colour رنگ Colour (OK) رنگ (تصویب) Columns ستون ها Column span محدوده ستون Combined result ترکیب کردن نتیجه ها Command فرمان Commands فرمان ها Commercial تجاری Condition شرط Conditions شروط Configuration پیکربندی Configuration of actions پیکربندی فعالیت ها Configuration of graphs پیکربندی نمودار ها Configuration of items پیکربندی آیتم ها Configuration of network maps پیکربندی نقشه های شبکه Configuration of screens پیکربندی صفحات نمایش Configuration of slide shows پیکربندی نمایش اسلایدها Configuration of triggers پیکربندی هشدار ها Configuration of Zabbix پیکر بندی سیستم فانوس Configuration updated پیکربندی بروز شد Confirmation text متن تایید Connect to متصل به Contact تماس Contract number شماره تماس Copy رونوشت Could not save image! نتوانست تصویر را ذخیره کند. Count تعداد Create action ایجاد فعالیت Create application ایجاد برنامه Create graph ایجاد نمودار Create icon map ایجاد نگاشت آیکن Create item ایجاد آیتم Create maintenance period ایجاد بازه نگه داری Create map ایجاد نقشه Create media type ایجاد نوع رسانه Create proxy ایجاد پروکسی Create screen ایجاد صفحه نمایش Create script ایجاد اسکریپت Create slide show ایجاد نمایش اسلاید Create trigger ایجاد هشدار Create user ایجاد کاربر Create value map ایجاد نگاشت مقدار Current host هاست فعلی Current value مقدار فعلی Custom graphs نقشه های سفارشی Custom label برچسب سفارشی Custom multiplier تکثیر کننده سفارشی Custom screens صفحات نمایش سفارشی Custom script اسکریپت سفارشی Custom severity names affect all locales and require manual translation! نام درجه اهمیت هشدار ها بر روی ترجمه سیستم تأثیر می گذارد Custom size اندازه سفارشی Custom slides اسلایدهای سفارشی Daily روزانه Dashboard داشبورد Dashed line خط تیره Data داده Database host هاست پایگاه داده Database monitor مانیتور پایگاه داده Database name نام پایگاه داده Database password کلمه عبور پایگاه داده Database port پرت پایگاه داده Database schema شمای پایگاه داده Database server سرور پایگاه داده Database type نوع پایگاه داده Database user کاربر پایگاه داده Data overview نمای کلی Date تاریخ Date HW decommissioned تاریخ کمیسیون سخت افزار Date HW installed تاریخ نصب سخت افزار Date HW maintenance expires تاریخ منقضی شدن تعمیر سخت افزار Date HW purchased تاریخ خرید سخت افزار Day روز Day of month روز از ماه Day of week روز از هفته days روز Days روز %d device %dدستگاه Debug رفع خطا Debug mode حالت رفع خطا Debug mode updated حالت رفع خطا بروز شد December دسامبر default پیش‌فرض Default پیش فرض Default authentication تصدیق هویت پیش فرض Default message پیام پیش فرض Default subject موضوع پیش فرض Default theme پوسته پیش فرض Delay تاخیر Delayed by تأخیر توسط Delete حذف Delete and clear حذف و پاک کردن Deleted حذف شد Delimiter جداکننده Deny رد کردن Dependencies وابستگی‌ها Dependent وابسته Depends on وابسته به Deployment status وضعیت گسترش Description توصیف Details جزئیات Device uniqueness criteria ضابطه یکتایی دستگاه Dimension (cols x rows) ابعاد(ستون X سطر) Disable غیرفعال Disabled غیرفعال‌شده DISABLED غیرفعال Disable host غیرفعال‌سازی هاست Disable host? غیرفعال‌سازی هاست؟ Disaster حادثه بد Discovered کشف شده Discovered device دستگاه کشف شده Discovery کشف Discovery by proxy کشف با پروکسی Discovery check تطبیق کشف Discovery checks تطبیق کشف Discovery object تطبیق شیء Discovery rule قانون کشف Discovery rules قوانین کشف Discovery status وضعیت کشف Displaying %1$s of %2$s found نمایش %1$s از %2$s پیدا شده Display OK triggers for نمایش هشدار های رفع شده برای Do not calculate محاسبه نشود Dot نقطه Downtime زمان از کار افتادگی Draw style رسم سبک Duration مدت Dynamic item آیتم پویا Each URL should have a unique name. Please make sure there is only one URL named هر آدرس اینترنتی باید یک نام واحد داشته باشد.لطفاً مطمئن شوید که این آدرس فقط یکبار استفاده شده است.هر آدرس اینترنتی باید یک نام واحد داشته باشد.لطفاً مطمئن شوید که این آدرس فقط یکبار استفاده شده است.هر آدرس اینترنتی باید یک نام واحد داشته باشد.لطفاً مطمئن شوید که این آدرس فقط یکبار استفاده شده است.هر آدرس اینترنتی باید یک نام واحد داشته باشد.لطفاً مطمئن شوید که این آدرس فقط یکبار استفاده شده است.هر آدرس اینترنتی باید یک نام واحد داشته باشد.لطفاً مطمئن شوید که این آدرس فقط یکبار استفاده شده است. Edit ویرایش Edit trigger ویرایش هشدار Element عنصر Element name نام عنصر Email پست الکترونیکی Empty خالی Enable فعال‌سازی Enable confirmation فعال‌سازی تصدیق Enabled فعال‌شده Enable host فعال‌سازی هاست English (en_GB) انگلیسی Error خطا Event رویداد Event details جزئیات رویداد Event generation تولید رویداد Event ID شناسه‌ی رویداد Event list [previous 20] لیست رویداد[20 رویداد قبلی] Event source متن رویداد Every day(s) هر روز Every week(s) هر هفته Exclude مانع شدن Execute اجرا Executed script اجرای اسکریپت Execute on اجرا روی Execution confirmation تأیید اجرا Expand single problem بسط دادن یک مشکل Exploded گسترش یافته Export to CSV صدور به CSV Expression عبارت Expression cannot be empty عبارت نمیتواند خالی باشد Expression constructor ساختار عبارت Expressions عبارات Expression type نوع عبارت Expression Variable Elements عبارت عناصر متغییر External check تطبیق خارجی Fail شکست Failed شکست خورد Failure Audit شکست ممیزی FALSE نادرست Favourite graphs نمودارهای مورد علاقه Favourite maps نقشه های مورد علاقه Favourite screens صفحات نمایش مورد علاقه February فوریه Field فیلد Filled region منطقه پرشده Filter فیلتر Finish پایان Fit to map متناسب با نقشه Fixed ثابت For guest, password must be empty برای میهمان ، کلمه عبور باید خالی باشد Friday جمعه From از Frontend access دسترسی به واسط کاربری Full clone کپی کامل Fullscreen تمام‌صفحه Function تابع General عمومی Generated in %s sec در %s ثانیه تولید شده است Global script اسکریپت عمومی Global scripts اسکریپت های عمومی Go to برو به Gradient line خط گراديان Graph نمودار Graph element عنصر گراف Graph prototypes نمونه اولیه گراف Graphs نمودارها Graph sum مجموع گراف Graph type نوع گراف Grid شبکه اى Group گروه Group for discovered hosts گروه برای هاست های کشف شده Grouping by گروه کردن بر اساس Group name نام گروه Groups گروهها GSM modem مودم GSM GUI واسط گرافیکی کاربران GUI access disabled. دسترسی واسط گرافیکی غیرفعال شده است. Hardware سخت افزار Hardware (Full details) سخت افزار (جزییات کامل) Height ارتفاع Help راهنما Hidden پنهان Hide selected مخفی کردن موارد High بالا History تاریخچه History of events تاریخچه رویدادها Horizontal افقی Horizontal align ردیف کردن افقی host هاست Host access دسترسی هاست Host (ascending) هاست (صعودی) Host cannot have more than one default interface of the same type. هاست نمی‌تواند بیشتر از یک واسط پیش فرض داشته باشد. Host count تعداد هاست host group گروه هاست Host group گروه هاست Host group elements عناصر گروه هاست Host group label type نوع برچسب گروه هاست Host groups گروه هاست ها Host info اطلاعات هاست Host interface واسط هاست Host inventory فهرست هاست Host inventory overview نمای کلی فهرست هاست Host IP آدرس هاست Host label type نوع برچسب هاست Host name نام هاست Host networks شبکه‌های هاست Host router مسیریاب هاست Hosts هاست ‌ها Host screens صفحات نمایش هاست Hosts location مکان هاست ها Host subnet mask subnet mask هاست Host time زمان هاست Hours ساعت HTTP authentication احراز هویت HTTP HW architecture ساختار سخت افزار icon نشان Icon نشان Icon (default) نشان (پیش‌فرض) Icon (disabled) نشان(غیرفعال) Icon highlight نشان پررنگ Icon (maintenance) نشان(نگهداری) Icon map نگاشت نشان Icon mapping نگاشت نشان Icon (problem) نشان(مشکل) Icons نشانها ID شناسه image تصویر Image تصویر Images تصاویر Immediately فوری Import وارد کردن Import file واردات پرونده in در Include شامل Info اطلاعات Information اطلاعات In maintenance در نگهداری In progress در حال پیشرفت Insert درج Installation نصب Installer name نام نصاب Interface واسط Interval بازه Inventory فهرست IP address آدرس IP IPMI agent عامل IPMI IPMI authentication algorithm الگوریتم تصدیق هویت IPMI IPMI interfaces واسط های IPMI IPMI password گذر واژه IPMI IPMI privilege level سطح ویژه IPMI IPMI sensor سنسور IPMI IPMI username نام کاربری IPMI IP range محدوده IP Issue مطلب Item آیتم Item count تعداد آیتم Item prototype نمونه اولیه آیتم Item prototypes نمونه اولیه آیتم ها Items آیتم ها Items list لیست آیتم Jabber identifier شناسه Jabber JMX agent عامل JMX JMX interfaces واسط های JMX Key کلید Keyword کلیدواژه Label برچسب Label location محل برچسب Language زبان last آخرین last آخرین Last 24 hours 24 ساعت گذشته Last 30 days 30 روز گذشته Last 365 days 365 روز گذشته Last 7 days 7 روز گذشته Last change آخرین تغییرات Last change (descending) آخرین تغییرات (نزولی) Last check آخرین بررسی Last hour graph نمودار ساعت گذشته Last month graph نمودار ماه گذشته Last of آخرین از Last seen (age) آخرین مشاهده(سن) Last value آخرین مقدار Last week graph نمودار هفته گذشته Latest data آخرین اطلاعات Left چپ Limit for search and filter results محدودسازی مشخصه های جستجو/فیلتر Line سطر Link پیوند Linked templates پیوندزده به قالب ها Linked to پیوند داده شده به Link indicators شاخص پیوند Link to template پیوند به قالب Link to templates پیوند به قالب ها List is empty لیست خالی است Local time زمان محلی Location مکان Location latitude عرض جغرافیایی Location longitude طول جغرافیایی Log ثبت وقایع Login ورود Logout خروج Log time format قالب ثبت زمان Lost از دست‌ رفته‌ Macro ماکرو macro(s) ماکرو(ها) Macros ماکروها Maintenance نگهداری MAINTENANCE نگهداری Maintenance period length طول دوره نگه داری Maintenance periods دوره های نگه داری Maintenance type نوع تعمیر و نگه داری <manual> <دستی> Manual دستی map نقشه Map نقشه Mapped to نگاشت شده به Mappings نگاشت Maps نقشه‌ها Mark others انتخاب دیگران Mark selected انتخاب موارد Mass update بروز رسانی کلی max بیشترین Max count of elements to show inside table cell حداکثر تعداد عناصر در جدول Media رسانه Media type نوع رسانه Media types انوع رسانه Members اعضا Message پیام Messages پیام Messaging پیام‌رسانی Middle وسط min کمترین Minutes دقیقه Mode حالت Model مدل Mon دوشنبه Monday دوشنبه Monitored by proxy مانیتور شده با پروکسی Monitored host هاست مانیتور شده Monitoring مانیتورینگ Month ماه Monthly ماهانه More than 10 minutes بیشتر از 10 دقیقه Multiple PROBLEM events رویدادهای مشکلات چندگانه Mute بی‌صدا Name نام Network maps نقشه های شبکه Never هرگز New جدید New application برنامه جدید New condition شرط جدید New element عنصر جدید New host group گروه هاست جدید New regular expression عبارت منظم جدید New service time زمان سرویس جدید No خیر No conditions defined. هیچ no data بدون داده No data collection هیچ شرطی تعریف نشده است No details بدون جزئیات No image بدون تصویر None هیچکدام (no proxy) (بدون پروکسی) No proxy (بدون پروکسی) Normal عادی Normal view نمای عادی‌ Not Ack بدون تأیید No target selected هدف انتخاب نشده No target selected. هدف انتخاب نشده Not available غیرقابل دسترس Not classified رده بندی نشده Notes یادداشتها Nothing هیچ‌چیز Notification report گزارش آگاه سازی Notifications اخطارها not in نیست در not selected انتخاب نشده Not supported عدم پشتیبانی Not Templated items بدون آیتم های قالب شده November نوامبر Number of status changes تعداد حالت‌های تغییر یافته Number of steps تعداد مراحل Number of users (online) تعداد کاربران (در دسترس) Numeric (float) عددی(شناور) Numeric (unsigned) عددی (بیعلامت) October اکتبر of از Off خاموش Ok صحیح OK صحیح on در On روشن Once یکبار One-time downtime یکبار پایین آمده One time only فقط یکبار Operation details جزئیات عملکرد Operations عملکردها Operation type نوع عملکرد Operator عملگر OR یا Original اصلی OS سیستم عامل OS (Full details) جزییات کامل سیستم عامل OS (Short) سیستم عامل(خلاصه) other دیگر Other دیگر Other parameters پارامترهای دیگر Others دیگران Overview نمای کلی Overview by proxy نمای کلی با پروکسی Parameter پارامتر Parent service سرویس والد Parent triggers هشدارهای والد Passive منفعل Password گذز واژه Password (once again) گذرواژه (دوباره) Password should not be empty گذرواژه نباید خالی باشد Period دوره Periods دوره ها Period type نوع دوره Permissions مجوزها Persian (fa_IR) فارسی Pie دایره ای Placing algorithm محل الگوریتم Plain text متن ساده Play پخش Play sound پخش صدا Please select two elements لطفاً دو عنصر انتخاب کنید Populates host inventory field قرار گرفتن در فیلد هاست Port پرت Port range محدوده پرت Preview پیش‌نمایش Private key file فابل کلید اختصاصی Privilege level سطح ویژه Problem مشکل PROBLEM مشکل Problem display نمایش مشکل Problem, if all children have problems مشکل، اگر همه فرزندان مشکل دارند Problem, if at least one child has a problem مشکل، اگر دست کم یکی از فرزندان مشکل دارند Problem on نمایش مشکل Problems مشکل Proxies پروکسی ها Proxy پروکسی Public key كليد عمومى Public key file فایل کلید عمومی Queue صف Read خواندن Read only فقط خواندنی Read-write خواندن-نوشتن Reason دلیل Received value وقادیر دریافت شده Recipient گیرنده Recovery بازیابی Regular expression عبارت منظم Regular expressions عبارات منظم Remember me for 30 days مرا بخاطر بسپار برای 30 روز remember selected موارد را یادآوری کن Remote command فرمان راه دور Remove حذف Remove from favourites حذف از مورد علاقه ها Remove from host group حذف از گروه هاست Remove from host groups حذف از گروه های هاست Remove host حذف میزبان‌ Replace جایگزینی Replace host groups جایگزینی گروه هاست ها Reports گزارشات Required مورد نیاز Required host permissions مجوز هاست مورد نیاز است Required performance (vps) کارایی مورد نیاز(vps) Required server performance, new values per second کارایی مورد نیاز سرور ، مقادیر جدید بر ثانیه Required status codes کدهای وضعیت مورد نیاز Required string رشته مورد نیاز Reset بازنشانی Reset confirmation بازنشاندن تصدیق Reset defaults بازنشانی پیش‌فرضها Resolved رفع شد Resource منبع Response code کد پاسخ Response time زمان پاسخ Result نتیجه Result is FALSE نتیجه غلط است Result is TRUE نتیجه درست است Result type نوع نتیجه Retry سعی مجدد Right راست root ریشه Rows سطرها Row span پهنای سطر Rows per page سطر در صفحه Rules قوانین Run commands اجرای فرامین Run global script اجرای اسکریپت عمومی Run IPMI command اجرای فرمان IPMI Run remote commands on current host اجرای فرمان راه دور روی هاست فعلی Run remote commands on host groups اجرای فرمان راه دور روی گروههای هاست Run remote commands on hosts اجرای فرمان راه دور روی هاست ها Run SSH commands اجرای فرمان SSH Run TELNET commands اجرای فرمان TELNET Sat شنبه Saturday شنبه Scenario سناریو Schedule زمان‌بندی Screen صفحه‌نمایش Screens صفحات ‌نمایش Script اسکریپت Script name نام اسکریپت Scripts اسکریپت ها Search جستجو Search attribute مشخصه‌ی جستجو Seconds ثانیه Select انتخاب Selected انتخاب شده Selected elements عناصر انتخاب شده Select prototype انتخاب نمونه اولیه Send message ارسال پیام Send message to user groups ارسال پیام به گروه کاربران Send message to users ارسال پیام به کاربران Send only to ارسال فقط به Send to ارسال به Send to User groups ارسال پیام به گروه کاربران Send to Users ارسال به کاربران Sent ارسال‌شده Separated جداشده September سپتامبر Server سرور Server time زمان سرور Service سرویس Service port پرت سرویس Services سرویس ها Service times مدت سرویس Service type نوع سرویس Session terminated, re-login, please. جلسه پایان یافت ، لطفاً دوباره وارد شوید Severity جدیت Severity (descending) جدیت (نزولی) short description شرح کوتاه Show نمایش Show details نمایش جزئیات Show hosts in maintenance نمایش هاست در دست نگهداری show icon mappings نمایش نشان های نگاشت شده Show items without data نمایش آیتم ها بدون داده Show legend نمایش فهرست Show lines نمایش خطوط Shown نمایش Show selected نمایش موارد Show text as HTML نمایش متن به عنوان HTML Show triggers نمایش هشدارها Show value نمایش مقدار show value mappings نمایش مقادیر نگاشت شده Show working time نمایش ساعت کاری Sign in ورود Simple ساده Simple check بررسی ساده Simple graph نمودار ساده Site address A آدرس 1 سایت Site address B آدرس 2 سایت Site address C آدرس 3 سایت Site city شهر سایت Site country کشور سایت Site notes یادداشتهای سایت Site rack location مکان rack سایت Site state / province استان سایت Site ZIP / postal کدپستی سایت SLA سطح سرویس Slide اسلاید Slides اسلایدها Slide show نمایش اسلاید Slide shows نمایش اسلایدها SMS پیام کوتاه "%s" must be between 1970.01.01 and 2038.01.18. "%s" می بايست بين 1970.01.01 و 2038.01.18 باشد. SNMP interfaces واسط های SNMP SNMPv1 agent عامل SNMPv1 SNMPv2 agent عامل SNMPv2 SNMPv3 agent عامل SNMPv3 Snooze بعدا Software نرم‌افزار Software application A نرم‌افزار کاربردی الف Software application B نرم‌افزار کاربردی ب Software application C نرم‌افزار کاربردی ج Software application D نرم‌افزار کاربردی د Software application E نرم‌افزار کاربردی ه Software (Full details) نرم‌افزار (جزییات کامل) Sort order (0->999) مرتب سازی(0->999) Sort triggers by مرتب سازی هشدارها بر اساس Source منبع Speed سرعت SSH agent عامل SSH Stacked پشته‌ای Standard items آیتم های استاندارد State حالت Status وضعیت Status calculation محاسبه وضعیت Status calculation algorithm الگوریتم محاسبه وضعیت Status codes کد وضعیت Status of discovery وضعیت کشف Status only فقط وضعیت Step گام Steps مراحل Stop توقف Straight مستقیم Style سبک Subject موضوع Submap زیر نقشه Success Audit رسیدگی موفق Sun یکشنبه Sunday یکشنبه Support پشتیبانی Surname نام خانوادگی System default پیش‌فرض سیستم System error. خطای سیستم. Target هدف Target list فهرست هدف Target type نوع هدف TELNET agent عامل TELNET Template قالب Templated items قالب آیتم ها Template group گروه قالب Template linkage پیوند قالب Template name نام قالب Templates قالب ها Template trigger هشدار قالب Test آزمایش Test authentication آزمایش احراز هویت Test confirmation آزمایش کردن تأیید Test data آزمایش داده Test string آزمایش رشته Text متن Theme پوسته This month این ماه This week این هفته This year امسال Thu پنجشنبه Thursday پنجشنبه Till تا Time زمان Timeout زمان انقضا Time period دوره زمانی Time shift انتقال زمان Timestamp مهر زمان Time type نوع زمان To به Today امروز Top بالا Total کل TOTAL کل Trends روندها trigger هشدار Trigger هشدار Trigger displaying options نمایش گزبنه های هشدار Trigger info اطلاعات هشدارها Trigger label type نوع برچسب هشدار Trigger name نام هشدار Trigger overview نمای کلی هشدارها Trigger prototype نمونه اولیه هشدار Trigger prototypes نمونه های اولیه هشدار Triggers هشدارها Trigger severities جدیت هشدارها Trigger severity جدیت هشدار Triggers top 100 100 هشدار بالا TRUE درست Tue سه شنبه Tuesday سه شنبه Type نوع Type (Full details) نوع[جزییات کامل] Type of calculation نوع محاسبات Type of information نوع اطلاعات Type (OK) نوع (صحیح) Types انواع Unacknowledged تأیید نشده Unacknowledged only فقط تأیید نشده Unacknowledged PROBLEM events رویدادهای مشکل تأیید نشده Units واحدها unknown ناشناخته Unknown ناشناخته UNKNOWN ناشناخته Unknown action فعالیت ناشناخته Unlink حذف پیوند Unlink and clear حذف پیوند و پاک کردن Unlink from template حذف پیوند از قالب Unlink from templates حذف پیوند از قالب ها Unmute وصل صدا Update به‌روزرسانی Updated بروز شده Updated: %s بروز شده : %s Update existing بروزرسانی در حال حاضر Update interval فاصله به‌روزرسانی Upload بارگذاری Upper level maps نقشه های سطح بالاتر Uptime زمان کار Uptime/Downtime زمان کار/زمان از کارافتادگی URL نشانی اینترنتی URL A نشانی اینترنتی الف URL (after login) نشانی اینترنتی(بعد از ورود) URL B نشانی اینترنتی ب URL C نشانی اینترنتی ج URLs نشانی های اینترنتی USA (160 characters) انگلیسی(160 کاراکتر) Used in actions استفاده شده در فعالیت Use if severity استفاده برای اهمیت User کار‌بر User group گروه کابر User groups گروه های کابران User name نام کاربری Username نام کاربری User password گذرواژه کاربر User profile پروفایل کاربر Users کاربران User type نوع کاربر value مقدار Value مقدار Value map نگاشت مقدار Value mapping نگاشت مقدار Values مقادیر Variables متغیرها Vendor فروشنده Vertical عمودی Vertical align ردیف کردن عمودی Visible name نام قابل رؤیت Warning اخطار Web وب Web monitoring مانیتورینگ وب Wed چهارشنبه Wednesday چهارشنبه Weekly هفتگی When active وقتی فعال شد Width عرض With data collection با جمع آوری داده Without problems بدون مشکلات Without triggers بدون هشدارها With problems با مشکلات With triggers با هشدارها Wizard ویزارد Working time ساعت کاری Write نوشتن Y axis MAX value حداکثر مقدار محور افقی Y axis MIN value حداکثر مقدار محور عمودی Y axis side سمت محور عمودی Year سال Yearly سالانه Yes بله You must login to view this page. شما باید وارد شوید تا این صفحه را ببینید Zabbix سپهر فانوس ZABBIX سپهر فانوس Zabbix Admin مدیر سپهر فانوس Zabbix agent عامل سپهر فانوس Zabbix agent (active) عامل سپهر فانوس (فعال) Zabbix aggregate Sepehr aggregate Zabbix internal Sepehr internal Zabbix internal authentication Sepehr internal authentication Zabbix server سرور سپهر فانوس Zabbix server is running سرور سپهر فانوس در حال اجراست Zabbix server name نام سرور سپهر فانوس Zabbix server port پرت سرور سپهر فانوس Zabbix Super Admin مدیر ارشد سپهر فانوس Zabbix trapper Sepehr trapper Zabbix User کاربر سپهر فانوس 0 or 1 0 یا 1 %1$d day %1$d روز%1$d روز %1$s Item %1$s آيتم%1$s آيتم %1$s (year %2$s) %1$s(سال%2$s) 10 seconds 10 ثانیه 1 minute 1 دقیقه 30 seconds 30 ثانیه 3D view نمایش سه بعدی 500 latest values 500 مقدار اخیر 5 minutes 5 دقیقه 5 seconds 5 ثانیه Access denied! غير قابل دسترسي! Ack تأیید Acknowledge تأیید کردن Acknowledged تأیید شده Acknowledged PROBLEM events تأیید رویدادهای مشکل Action فعالیت ها Action added فعالیت اضافه شد Action deleted فعالیت حذف شد Actions فعالیت ها Action updated فعالیت بروز شد Active فعال Active since فعال از Active till فعال تا Add افزودن Add host افزودن هاست Add prototype افزودن نمونه اولیه Add to favourites افزودن به مورد علاقه ها Add to host group افزودن به گروه هاست Add to host groups افزودن به گروه هاست ها Admin مدیر Administration مدیریت Advanced labels برچسب های پیشرفته AES AES Age سن Age less than سن کمتر از agent عامل Agent عامل Agent interfaces واسط های عامل Alias نام مستعار all همه All همه All links should have "Name" and "URL" specified همه لینک ها باید "نام" و "آدرس" مشخص داشته باشند Allowed hosts هاست ها مجاز AND و Any هیچ Any character string included فاقد رشته کاراکتری Application برنامه ها Application "%1$s" already exists. برنامه "%s" قبلاً وجود دارد Application added برنامه اضافه شد Application error. خطای برنامه. Applications برنامه‌ها Application updated برنامه بروز شد Application with ID "%1$s" is not available on "%2$s". برنامه با شناسه "%1$s" در "%2$s" در دسترس نیست. Apply اعمال Apr آوریل April آوریل Area size اندازه ناحیه Area type نوع ناحیه Are you sure you want perform this action? آیا مطمئنید که می‌خواهید این فعالیت را اجرا کنید؟ Are you sure you want to delete آیا مطمئنید می‌خواهید حذف کنید as Blue به عنوان آبی as Green به عنوان سبز As is به عنوان As plain text به عنوان متن ساده as Red به عنوان قرمز Asset tag برچسب دارایی At (hour:minute) در (ساعت:دقیقه) Audit ممیزی Aug اوت August اوت Authentication تصدیق هویت Authentication algorithm الگوریتم تصدیق هویت Authentication method متد تصدیق هویت Auto-login ورود خودکار Automatic خودکار Automatic icon mapping نگاشت خودکار آیکن Automatic icon selection انتخاب آیکن خودکار Availability دسترسی Availability report گزارش دسترسی Available در دسترس Average متوسط avg میانگین Background پس زمینه Background image تصویر پس زمینه Bind password مقید به کلمه عبور Blocked مسدود شده Bold line خط‌ توپر Bottom پایین By host توسط هاست By trigger template تو سط قالب هشدار Calculated محاسبه کردن Calculate SLA, acceptable SLA (in %) محاسبه SLA (درصد) Cancel لغو Cannot add action فعالیت نمی تواند اضافه شود Cannot add application برنامه نمی تواند اضافه شود Cannot add dependency from a host to a template. وابستگی از یک هاست به یک قالب نمی‌تواند اضافه شود Cannot add discovery rule قانون کشف نمی تواند اضافه شود Cannot add graph نمودار نمی تواند اضافه شود Cannot add group گروه نمی تواند اضافه شود Cannot add host هاست نمی تواند اضافه شود Cannot add image تصویر نمی تواند اضافه شود Cannot add item آیتم نمی تواند اضافه شود Cannot add maintenance دوره نگهداری نمی تواند اضافه شود Cannot add media type نوع رسانه نمی تواند اضافه شود Cannot add network map نقشه شبکه نمی تواند اضافه شود Cannot add proxy پروکسی نمی تواند اضافه شود Cannot add regular expression عبارت منظم نمی تواند اضافه شود Cannot add screen صفحه نمایش نمی تواند اضافه شود Cannot add script اسکریپت نمی تواند اضافه شود Cannot add service سرویس نمی تواند اضافه شود Cannot add slide show نمایش اسلاید نمی تواند اضافه شود Cannot add template قالب نمی تواند اضافه شود Cannot add trigger هشدار نمی تواند اضافه شود Cannot add user کاربر نمی تواند اضافه شود Cannot add value map نگاشت مقدار نمی تواند اضافه شود Cannot clear history تاریخچه نمی‌تواند پاک شود Cannot clone graph prototypes. نمونه اولیه نمودارها نمی‌توانند کپی شوند Cannot clone item prototypes. نمونه اولیه آیتم ها نمی‌توانند کپی شوند Cannot clone trigger prototypes. نمونه اولیه هشدارها نمی‌توانند کپی شوند Cannot copy trigger "%1$s:%2$s", because it has multiple hosts in the expression. هشدار "%1$s:%2$s" نمی‌تواند کپی شود ، زیرا چندین هاست در عبارت خود دارد.هشدار "%1$s:%2$s" نمی‌تواند کپی شود ، زیرا چندین هاست در عبارت خود دارد.هشدار "%1$s:%2$s" نمی‌تواند کپی شود ، زیرا چندین هاست در عبارت خود دارد.هشدار "%1$s:%2$s" نمی‌تواند کپی شود ، زیرا چندین هاست در عبارت خود دارد.هشدار "%1$s:%2$s" نمی‌تواند کپی شود ، زیرا چندین هاست در عبارت خود دارد. Cannot create another database connection. اتصال دیگری به پایگاه داده نمی‌توانند ایجاد شود. Cannot create discovery rule قانون کشف نمی‌توانند ایجاد شود. Cannot create icon map نگاشت آیکن نمی‌توانند ایجاد شود. Cannot delete action فعالیت نمی‌تواند حذف شود Cannot delete discovery rule قانون کشف نمی‌تواند حذف شود Cannot delete graph نمودار نمی‌تواند حذف شود Cannot delete graphs نمودارها نمی‌توانند حذف شوند Cannot delete host هاست نمی‌تواند حذف شود Cannot delete icon map نگاشت آیکن نمی‌توانند حذف شود Cannot delete image تصویر نمی‌تواند حذف شود Cannot delete inventory. فهرست نمی‌تواند حذف شود. Cannot delete item آیتم نمی‌تواند حذف شود Cannot delete items آیتم ها نمی‌توانند حذف شوند Cannot delete maintenance دوره نگهداری نمی‌تواند حذف شود Cannot delete media type نوع رسانه نمی تواند حذف شود Cannot delete network map نقشه شبکه نمی تواند حذف شود Cannot delete proxy پروکسی نمی تواند حذف شود Cannot delete screen صفحه نمایش نمی تواند حذف شود Cannot delete script اسکریپت نمی تواند حذف شود Cannot delete scripts. Script "%1$s" is used in action operation "%2$s". اسکریپت ها نمی توانند حذف شوند.اسکریپت "%1$s" در عملکرد فعالیت "%2$s" استفاده شده است.اسکریپت ها نمی توانند حذف شوند.اسکریپت "%1$s" در عملکرد فعالیت "%2$s" استفاده شده است.اسکریپت ها نمی توانند حذف شوند.اسکریپت "%1$s" در عملکرد فعالیت "%2$s" استفاده شده است.اسکریپت ها نمی توانند حذف شوند.اسکریپت "%1$s" در عملکرد فعالیت "%2$s" استفاده شده است.اسکریپت ها نمی توانند حذف شوند.اسکریپت "%1$s" در عملکرد فعالیت "%2$s" استفاده شده است. Cannot delete selected actions فعالیت های انتخاب شده نمی‌توانند حذف شوند Cannot delete service سرویس نمی‌تواند حذف شود Cannot delete slide show نمایش اسلاید نمی‌تواند حذف شود Cannot delete template قالب نمی تواند حذف شود Cannot delete templated trigger "%1$s:%2$s". هشدارهای قالب شده "%1$s:%2$s" نمی توانند حذف شوند. Cannot delete trigger هشدار نمی‌تواند حذف شود Cannot delete triggers هشدارها نمی‌توانند حذف شوند Cannot delete user کاربر نمی‌تواند حذف شود Cannot delete value map نگاشت آیکن نمی‌تواند حذف شود Cannot find host interface on "%1$s" for item key "%2$s". واسط هاست در "%1$s" برای کلید آیتم "%2$s" پیدا نشد. Cannot link template قالب نمی تواند پیوندزده شود Cannot logout. نمیتوانید خارج شوید Cannot mass update host name. نام هاست را نمیتوانید دسته‌ای بروز کنید. Cannot mass update visible host name. نام قابل مشاهده هاست را نمیتوانید دسته‌ای بروز کنید. Cannot perform delete statement on table "%1$s" without where condition. دستور حذف برای جدول "%1$s" را نمیتوانید بدون شرط اجرا کنید. Cannot perform update statement on table "%1$s" without values. دستور بروزرسانی برای جدول "%1$s" را نمیتوانید بدون مقدار اجرا کنید. Cannot perform update statement on table "%1$s" without where condition. دستور بروزرسانی برای جدول "%1$s" را نمیتوانید بدون شرط اجرا کنید. Cannot save discovery rule without checks. قانون کشف بدون بررسی را نمیتوانید ذخیره کنید. Cannot unlink template قالب را نمی‌توانید جدا کنید Cannot update action فعالیت نمی‌تواند بروز شود Cannot update application برنامه نمی‌تواند بروز شود Cannot update configuration پیکر بندی نمی‌تواند بروز شود Cannot update discovery rule قانون کشف نمیتواند بروز شود Cannot update graph نمودار نمی‌تواند بروز شود Cannot update group گروه نمی‌تواند بروز شود Cannot update host هاست نمی‌تواند بروز شود Cannot update hosts هاست ها نمی‌تواند بروز شود Cannot update icon map نگاشت آیکن نمی‌توانند بروز شود. Cannot update image تصویر نمیتواند بروز شود Cannot update item آیتم نمی‌تواند بروز شود Cannot update items آیتم ها نمی‌توانند بروز شوند Cannot update macros ماکرو نمی‌تواند بروز شود Cannot update maintenance دوره نگهداری نمی‌تواند بروز شود Cannot update media type نوع رسانه نمی تواند بروز شود Cannot update network map نقشه شبکه نمی تواند بروز شود Cannot update proxy پروکسی نمی‌تواند بروز شود Cannot update regular expression عبارت منظم نمی تواند بروز شود Cannot update screen صفحه نمایش نمی تواند بروز شود Cannot update script اسکریپت نمی تواند بروز شود Cannot update service سرویس نمی‌تواند بروز شود Cannot update slide show نمایش اسلاید نمی‌تواند بروز شود Cannot update template قالب نمی تواند بروز شود Cannot update trigger هشدار نمی‌تواند بروز شود Cannot update user کاربر نمی‌تواند بروز شود Cannot update value map نگاشت نقشه نمیتواند بروز شود Case sensitive حساس به متن Change password تغییر رمز عبور Character کاراکتر Character string included در بر داشتن رشته کاراکتری Character string not included در بر نداشتن رشته کاراکتری Chassis اسکلت Check already exists. بررسی از قبل وجود دارد Check expression part starting from "%1$s". بخش عبارت بررسی از "%1$s" شروع می‌شود. Checks تطبیق ها Checks should be unique. تطبیق ها باید منحصر به فرد باشد. Check the key, please. Default example was passed. لطفاً کلید را بررسی کنید، نمونه پیش ‌فرض پاس داده خواهد شد. Check type نوع تطبیق Clear history and trends پاک کردن تاریخچه و روند ها Clear when unlinking پاک کردن وقتی جدا شد Clock ساعت Clone کپی برداری Close بستن Close expression constructor بستن عبارت سازنده Colour رنگ Colour (OK) رنگ (تصویب) Columns ستون ها Column span محدوده ستون Combined result ترکیب کردن نتیجه ها Command فرمان Commands فرمان ها Condition شرط Conditions شروط Configuration پیکربندی Configuration of actions پیکربندی فعالیت ها Configuration of graphs پیکربندی نمودار ها Configuration of items پیکربندی آیتم ها Configuration of network maps پیکربندی نقشه های شبکه Configuration of screens پیکربندی صفحات نمایش Configuration of slide shows پیکربندی نمایش اسلایدها Configuration of triggers پیکربندی هشدار ها Configuration of Zabbix پیکر بندی سیستم فانوس Configuration updated پیکربندی بروز شد Confirmation text متن تایید Connect to متصل به Contact تماس Contract number شماره تماس Copy رونوشت Could not save image! نتوانست تصویر را ذخیره کند. Count تعداد Create action ایجاد فعالیت Create application ایجاد برنامه Create graph ایجاد نمودار Create icon map ایجاد نگاشت آیکن Create item ایجاد آیتم Create maintenance period ایجاد بازه نگه داری Create map ایجاد نقشه Create media type ایجاد نوع رسانه Create proxy ایجاد پروکسی Create screen ایجاد صفحه نمایش Create script ایجاد اسکریپت Create slide show ایجاد نمایش اسلاید Create trigger ایجاد هشدار Create user ایجاد کاربر Create value map ایجاد نگاشت مقدار Current host هاست فعلی Current value مقدار فعلی Custom graphs نقشه های سفارشی Custom label برچسب سفارشی Custom multiplier تکثیر کننده سفارشی Custom screens صفحات نمایش سفارشی Custom script اسکریپت سفارشی Custom severity names affect all locales and require manual translation! نام درجه اهمیت هشدار ها بر روی ترجمه سیستم تأثیر می گذارد Custom size اندازه سفارشی Custom slides اسلایدهای سفارشی Daily روزانه Dashboard داشبورد Dashed line خط تیره Database host هاست پایگاه داده Database monitor مانیتور پایگاه داده Database name نام پایگاه داده Database password کلمه عبور پایگاه داده Database port پرت پایگاه داده Database schema شمای پایگاه داده Database server سرور پایگاه داده Database type نوع پایگاه داده Database user کاربر پایگاه داده Data overview نمای کلی Date تاریخ Date HW decommissioned تاریخ کمیسیون سخت افزار Date HW installed تاریخ نصب سخت افزار Date HW maintenance expires تاریخ منقضی شدن تعمیر سخت افزار Date HW purchased تاریخ خرید سخت افزار Day روز Day of month روز از ماه Day of week روز از هفته days روز Days روز %d device %dدستگاه Debug رفع خطا Debug mode حالت رفع خطا December دسامبر default پیش‌فرض Default پیش فرض Default authentication تصدیق هویت پیش فرض Default theme پوسته پیش فرض Delay تاخیر Delayed by تأخیر توسط Delete حذف Delete and clear حذف و پاک کردن Delimiter جداکننده Deny رد کردن Dependencies وابستگی‌ها Dependent وابسته Depends on وابسته به Deployment status وضعیت گسترش Description توصیف Details جزئیات Device uniqueness criteria ضابطه یکتایی دستگاه Dimension (cols x rows) ابعاد(ستون X سطر) Disable غیرفعال Disabled غیرفعال‌شده Disable host غیرفعال‌سازی هاست Disable host? غیرفعال‌سازی هاست؟ Disaster حادثه بد Discovered کشف شده Discovered device دستگاه کشف شده Discovery کشف Discovery by proxy کشف با پروکسی Discovery check تطبیق کشف Discovery checks تطبیق کشف Discovery object تطبیق شیء Discovery rule قانون کشف Discovery rules قوانین کشف Discovery status وضعیت کشف Displaying %1$s of %2$s found نمایش %1$s از %2$s پیدا شده Display OK triggers for نمایش هشدار های رفع شده برای Do not calculate محاسبه نشود Dot نقطه Downtime زمان از کار افتادگی Draw style رسم سبک Duration مدت Dynamic item آیتم پویا Each URL should have a unique name. Please make sure there is only one URL named هر آدرس اینترنتی باید یک نام واحد داشته باشد.لطفاً مطمئن شوید که این آدرس فقط یکبار استفاده شده است.هر آدرس اینترنتی باید یک نام واحد داشته باشد.لطفاً مطمئن شوید که این آدرس فقط یکبار استفاده شده است.هر آدرس اینترنتی باید یک نام واحد داشته باشد.لطفاً مطمئن شوید که این آدرس فقط یکبار استفاده شده است.هر آدرس اینترنتی باید یک نام واحد داشته باشد.لطفاً مطمئن شوید که این آدرس فقط یکبار استفاده شده است.هر آدرس اینترنتی باید یک نام واحد داشته باشد.لطفاً مطمئن شوید که این آدرس فقط یکبار استفاده شده است. Edit ویرایش Edit trigger ویرایش هشدار Element عنصر Element name نام عنصر Email پست الکترونیکی Empty خالی Enable فعال‌سازی Enable confirmation فعال‌سازی تصدیق Enabled فعال‌شده Enable host فعال‌سازی هاست English (en_GB) انگلیسی Error خطا Event رویداد Event details جزئیات رویداد Event generation تولید رویداد Event ID شناسه‌ی رویداد Event list [previous 20] لیست رویداد[20 رویداد قبلی] Every day(s) هر روز Every week(s) هر هفته Exclude مانع شدن Execute اجرا Executed script اجرای اسکریپت Execute on اجرا روی Execution confirmation تأیید اجرا Expand single problem بسط دادن یک مشکل Exploded گسترش یافته Export to CSV صدور به CSV Expression عبارت Expression cannot be empty عبارت نمیتواند خالی باشد Expression constructor ساختار عبارت Expressions عبارات Expression type نوع عبارت Expression Variable Elements عبارت عناصر متغییر External check تطبیق خارجی Fail شکست Failed شکست خورد Failure Audit شکست ممیزی FALSE نادرست Favourite graphs نمودارهای مورد علاقه Favourite maps نقشه های مورد علاقه Favourite screens صفحات نمایش مورد علاقه February فوریه Field فیلد Filled region منطقه پرشده Filter فیلتر Finish پایان Fit to map متناسب با نقشه Fixed ثابت Friday جمعه From از Frontend access دسترسی به واسط کاربری Full clone کپی کامل Function تابع General عمومی Global script اسکریپت عمومی Global scripts اسکریپت های عمومی Go to برو به Gradient line خط گراديان Graph نمودار Graph element عنصر گراف Graph prototypes نمونه اولیه گراف Graphs نمودارها Graph sum مجموع گراف Graph type نوع گراف Grid شبکه اى Group گروه Group for discovered hosts گروه برای هاست های کشف شده Grouping by گروه کردن بر اساس Group name نام گروه Groups گروهها GSM modem مودم GSM GUI واسط گرافیکی کاربران GUI access disabled. دسترسی واسط گرافیکی غیرفعال شده است. Hardware سخت افزار Hardware (Full details) سخت افزار (جزییات کامل) Height ارتفاع Help راهنما Hidden پنهان Hide selected مخفی کردن موارد High بالا History تاریخچه History of events تاریخچه رویدادها Horizontal افقی Horizontal align ردیف کردن افقی host هاست Host access دسترسی هاست Host (ascending) هاست (صعودی) Host cannot have more than one default interface of the same type. هاست نمی‌تواند بیشتر از یک واسط پیش فرض داشته باشد. Host count تعداد هاست host group گروه هاست Host group گروه هاست Host group elements عناصر گروه هاست Host group label type نوع برچسب گروه هاست Host groups گروه هاست ها Host info اطلاعات هاست Host interface واسط هاست Host inventory فهرست هاست Host inventory overview نمای کلی فهرست هاست Host IP آدرس هاست Host label type نوع برچسب هاست Host name نام هاست Host networks شبکه‌های هاست Host router مسیریاب هاست Hosts هاست ‌ها Host screens صفحات نمایش هاست Hosts location مکان هاست ها Host subnet mask subnet mask هاست Host time زمان هاست Hours ساعت HTTP authentication احراز هویت HTTP HW architecture ساختار سخت افزار icon نشان Icon نشان Icon (default) نشان (پیش‌فرض) Icon (disabled) نشان(غیرفعال) Icon highlight نشان پررنگ Icon (maintenance) نشان(نگهداری) Icon map نگاشت نشان Icon mapping نگاشت نشان Icon (problem) نشان(مشکل) Icons نشانها ID شناسه image تصویر Image تصویر Images تصاویر Immediately فوری Import وارد کردن Import file واردات پرونده in در Include شامل Info اطلاعات Information اطلاعات In maintenance در نگهداری In progress در حال پیشرفت Insert درج Installation نصب Installer name نام نصاب Interface واسط Interval بازه Inventory فهرست IP address آدرس IP IPMI agent عامل IPMI IPMI interfaces واسط های IPMI IPMI sensor سنسور IPMI IP range محدوده IP Issue مطلب Item آیتم Item count تعداد آیتم Item prototype نمونه اولیه آیتم Item prototypes نمونه اولیه آیتم ها Items آیتم ها Items list لیست آیتم JMX agent عامل JMX JMX interfaces واسط های JMX Key کلید Keyword کلیدواژه Label برچسب Label location محل برچسب Language زبان last آخرین last آخرین Last 24 hours 24 ساعت گذشته Last 30 days 30 روز گذشته Last 365 days 365 روز گذشته Last 7 days 7 روز گذشته Last change آخرین تغییرات Last change (descending) آخرین تغییرات (نزولی) Last check آخرین بررسی Last hour graph نمودار ساعت گذشته Last month graph نمودار ماه گذشته Last of آخرین از Last seen (age) آخرین مشاهده(سن) Last value آخرین مقدار Last week graph نمودار هفته گذشته Latest data آخرین اطلاعات Left چپ Limit for search and filter results محدودسازی مشخصه های جستجو/فیلتر Line سطر Link پیوند Linked templates پیوندزده به قالب ها Link indicators شاخص پیوند Link to template پیوند به قالب Link to templates پیوند به قالب ها List is empty لیست خالی است Local time زمان محلی Location مکان Location latitude عرض جغرافیایی Location longitude طول جغرافیایی Log ثبت وقایع Login ورود Logout خروج Log time format قالب ثبت زمان Lost از دست‌ رفته‌ Macro ماکرو macro(s) ماکرو(ها) Macros ماکروها Maintenance نگهداری Maintenance period length طول دوره نگه داری Maintenance periods دوره های نگه داری Maintenance type نوع تعمیر و نگه داری <manual> <دستی> Manual دستی map نقشه Map نقشه Mapped to نگاشت شده به Mappings نگاشت Maps نقشه‌ها Mark others انتخاب دیگران Mark selected انتخاب موارد Mass update بروز رسانی کلی max بیشترین Max count of elements to show inside table cell حداکثر تعداد عناصر در جدول Media رسانه Media type نوع رسانه Media types انوع رسانه Members اعضا Message پیام Messages پیام Messaging پیام‌رسانی Middle وسط min کمترین Minutes دقیقه Mode حالت Model مدل Mon دوشنبه Monday دوشنبه Monitored by proxy مانیتور شده با پروکسی Monitored host هاست مانیتور شده Monitoring مانیتورینگ Month ماه Monthly ماهانه More than 10 minutes بیشتر از 10 دقیقه Multiple PROBLEM events رویدادهای مشکلات چندگانه Mute بی‌صدا Name نام Network maps نقشه های شبکه Never هرگز New application برنامه جدید New condition شرط جدید New element عنصر جدید New regular expression عبارت منظم جدید New service time زمان سرویس جدید No خیر No conditions defined. هیچ no data بدون داده No data collection هیچ شرطی تعریف نشده است No details بدون جزئیات No image بدون تصویر None هیچکدام (no proxy) (بدون پروکسی) No proxy (بدون پروکسی) Normal عادی Normal view نمای عادی‌ Not Ack بدون تأیید No target selected هدف انتخاب نشده No target selected. هدف انتخاب نشده Not available غیرقابل دسترس Not classified رده بندی نشده Notes یادداشتها Nothing هیچ‌چیز Notification report گزارش آگاه سازی Notifications اخطارها not in نیست در not selected انتخاب نشده Not supported عدم پشتیبانی November نوامبر Number of status changes تعداد حالت‌های تغییر یافته Number of steps تعداد مراحل Number of users (online) تعداد کاربران (در دسترس) Numeric (float) عددی(شناور) Numeric (unsigned) عددی (بیعلامت) October اکتبر of از Off خاموش Ok صحیح OK صحیح on در On روشن Once یکبار One-time downtime یکبار پایین آمده One time only فقط یکبار Operation details جزئیات عملکرد Operations عملکردها Operation type نوع عملکرد Operator عملگر OR یا Original اصلی OS سیستم عامل OS (Full details) جزییات کامل سیستم عامل OS (Short) سیستم عامل(خلاصه) other دیگر Other دیگر Other parameters پارامترهای دیگر Others دیگران Overview نمای کلی Parameter پارامتر Parent service سرویس والد Parent triggers هشدارهای والد Passive منفعل Password گذز واژه Password (once again) گذرواژه (دوباره) Period دوره Periods دوره ها Period type نوع دوره Permissions مجوزها Persian (fa_IR) فارسی Pie دایره ای Placing algorithm محل الگوریتم Plain text متن ساده Play پخش Play sound پخش صدا Please select two elements لطفاً دو عنصر انتخاب کنید Populates host inventory field قرار گرفتن در فیلد هاست Port پرت Port range محدوده پرت Preview پیش‌نمایش Private key file فابل کلید اختصاصی Privilege level سطح ویژه Problem مشکل PROBLEM مشکل Problem display نمایش مشکل Problem, if all children have problems مشکل، اگر همه فرزندان مشکل دارند Problem, if at least one child has a problem مشکل، اگر دست کم یکی از فرزندان مشکل دارند Problem on نمایش مشکل Problems مشکل Proxies پروکسی ها Proxy پروکسی Public key كليد عمومى Public key file فایل کلید عمومی Queue صف Read خواندن Read only فقط خواندنی Read-write خواندن-نوشتن Reason دلیل Received value وقادیر دریافت شده Recipient گیرنده Recovery بازیابی Regular expression عبارت منظم Regular expressions عبارات منظم Remember me for 30 days مرا بخاطر بسپار برای 30 روز Remote command فرمان راه دور Remove حذف Remove from favourites حذف از مورد علاقه ها Remove from host group حذف از گروه هاست Remove from host groups حذف از گروه های هاست Remove host حذف میزبان‌ Replace جایگزینی Reports گزارشات Required مورد نیاز Required host permissions مجوز هاست مورد نیاز است Required performance (vps) کارایی مورد نیاز(vps) Required server performance, new values per second کارایی مورد نیاز سرور ، مقادیر جدید بر ثانیه Required status codes کدهای وضعیت مورد نیاز Required string رشته مورد نیاز Reset بازنشانی Reset confirmation بازنشاندن تصدیق Reset defaults بازنشانی پیش‌فرضها Resolved رفع شد Resource منبع Response code کد پاسخ Response time زمان پاسخ Result نتیجه Result is FALSE نتیجه غلط است Result is TRUE نتیجه درست است Result type نوع نتیجه Retry سعی مجدد Right راست root ریشه Rows سطرها Row span پهنای سطر Rows per page سطر در صفحه Rules قوانین Run commands اجرای فرامین Run global script اجرای اسکریپت عمومی Run IPMI command اجرای فرمان IPMI Run remote commands on current host اجرای فرمان راه دور روی هاست فعلی Run remote commands on host groups اجرای فرمان راه دور روی گروههای هاست Run remote commands on hosts اجرای فرمان راه دور روی هاست ها Run SSH commands اجرای فرمان SSH Run TELNET commands اجرای فرمان TELNET Sat شنبه Saturday شنبه Scenario سناریو Schedule زمان‌بندی Screen صفحه‌نمایش Screens صفحات ‌نمایش Script اسکریپت Script name نام اسکریپت Scripts اسکریپت ها Search جستجو Search attribute مشخصه‌ی جستجو Select انتخاب Selected انتخاب شده Selected elements عناصر انتخاب شده Select prototype انتخاب نمونه اولیه Send message ارسال پیام Send message to user groups ارسال پیام به گروه کاربران Send message to users ارسال پیام به کاربران Send only to ارسال فقط به Send to ارسال به Sent ارسال‌شده Separated جداشده September سپتامبر Server سرور Server time زمان سرور Service سرویس Service port پرت سرویس Services سرویس ها Service times مدت سرویس Service type نوع سرویس Session terminated, re-login, please. جلسه پایان یافت ، لطفاً دوباره وارد شوید Severity جدیت Severity (descending) جدیت (نزولی) short description شرح کوتاه Show نمایش Show details نمایش جزئیات Show hosts in maintenance نمایش هاست در دست نگهداری show icon mappings نمایش نشان های نگاشت شده Show items without data نمایش آیتم ها بدون داده Show legend نمایش فهرست Show lines نمایش خطوط Shown نمایش Show selected نمایش موارد Show text as HTML نمایش متن به عنوان HTML Show triggers نمایش هشدارها Show value نمایش مقدار show value mappings نمایش مقادیر نگاشت شده Show working time نمایش ساعت کاری Sign in ورود Simple ساده Simple check بررسی ساده Simple graph نمودار ساده Site address A آدرس 1 سایت Site address B آدرس 2 سایت Site address C آدرس 3 سایت Site city شهر سایت Site country کشور سایت Site notes یادداشتهای سایت Site rack location مکان rack سایت Site state / province استان سایت Site ZIP / postal کدپستی سایت SLA سطح سرویس Slide اسلاید Slides اسلایدها Slide show نمایش اسلاید Slide shows نمایش اسلایدها SMS پیام کوتاه SNMP interfaces واسط های SNMP SNMPv1 agent عامل SNMPv1 SNMPv2 agent عامل SNMPv2 SNMPv3 agent عامل SNMPv3 Snooze بعدا Software نرم‌افزار Software application A نرم‌افزار کاربردی الف Software application B نرم‌افزار کاربردی ب Software application C نرم‌افزار کاربردی ج Software application D نرم‌افزار کاربردی د Software application E نرم‌افزار کاربردی ه Software (Full details) نرم‌افزار (جزییات کامل) Sort order (0->999) مرتب سازی(0->999) Sort triggers by مرتب سازی هشدارها بر اساس Source منبع Speed سرعت SSH agent عامل SSH Stacked پشته‌ای Standard items آیتم های استاندارد State حالت Status وضعیت Status calculation محاسبه وضعیت Status calculation algorithm الگوریتم محاسبه وضعیت Status codes کد وضعیت Status of discovery وضعیت کشف Status only فقط وضعیت Step گام Steps مراحل Stop توقف Straight مستقیم Style سبک Subject موضوع Submap زیر نقشه Success Audit رسیدگی موفق Sun یکشنبه Sunday یکشنبه Support پشتیبانی Surname نام خانوادگی System default پیش‌فرض سیستم System error. خطای سیستم. Target هدف Target list فهرست هدف Target type نوع هدف TELNET agent عامل TELNET Template قالب Template group گروه قالب Template linkage پیوند قالب Template name نام قالب Templates قالب ها Template trigger هشدار قالب Test آزمایش Test authentication آزمایش احراز هویت Test confirmation آزمایش کردن تأیید Test data آزمایش داده Test string آزمایش رشته Text متن Theme پوسته This month این ماه This week این هفته This year امسال Thu پنجشنبه Thursday پنجشنبه Till تا Time زمان Timeout زمان انقضا Time period دوره زمانی Time shift انتقال زمان Timestamp مهر زمان Time type نوع زمان To به Today امروز Top بالا Total کل TOTAL کل Trends روندها trigger هشدار Trigger هشدار Trigger displaying options نمایش گزبنه های هشدار Trigger info اطلاعات هشدارها Trigger label type نوع برچسب هشدار Trigger name نام هشدار Trigger overview نمای کلی هشدارها Trigger prototype نمونه اولیه هشدار Trigger prototypes نمونه های اولیه هشدار Triggers هشدارها Trigger severities جدیت هشدارها Trigger severity جدیت هشدار Triggers top 100 100 هشدار بالا TRUE درست Tue سه شنبه Tuesday سه شنبه Type نوع Type (Full details) نوع[جزییات کامل] Type of calculation نوع محاسبات Type of information نوع اطلاعات Type (OK) نوع (صحیح) Types انواع Unacknowledged only فقط تأیید نشده Unacknowledged PROBLEM events رویدادهای مشکل تأیید نشده Units واحدها unknown ناشناخته Unknown ناشناخته UNKNOWN ناشناخته Unknown action فعالیت ناشناخته Unlink حذف پیوند Unlink and clear حذف پیوند و پاک کردن Unlink from template حذف پیوند از قالب Unlink from templates حذف پیوند از قالب ها Unmute وصل صدا Update به‌روزرسانی Update existing بروزرسانی در حال حاضر Update interval فاصله به‌روزرسانی Upload بارگذاری Upper level maps نقشه های سطح بالاتر Uptime زمان کار Uptime/Downtime زمان کار/زمان از کارافتادگی URL نشانی اینترنتی URL A نشانی اینترنتی الف URL (after login) نشانی اینترنتی(بعد از ورود) URL B نشانی اینترنتی ب URL C نشانی اینترنتی ج URLs نشانی های اینترنتی Used in actions استفاده شده در فعالیت Use if severity استفاده برای اهمیت User کار‌بر User group گروه کابر User groups گروه های کابران User name نام کاربری Username نام کاربری User password گذرواژه کاربر User profile پروفایل کاربر Users کاربران User type نوع کاربر value مقدار Value مقدار Value map نگاشت مقدار Value mapping نگاشت مقدار Values مقادیر Variables متغیرها Vendor فروشنده Vertical عمودی Vertical align ردیف کردن عمودی Visible name نام قابل رؤیت Warning اخطار Web وب Web monitoring مانیتورینگ وب Wed چهارشنبه Wednesday چهارشنبه Weekly هفتگی When active وقتی فعال شد Width عرض With data collection با جمع آوری داده Without problems بدون مشکلات Without triggers بدون هشدارها With problems با مشکلات With triggers با هشدارها Wizard ویزارد Working time ساعت کاری Write نوشتن Y axis MAX value حداکثر مقدار محور افقی Y axis MIN value حداکثر مقدار محور عمودی Y axis side سمت محور عمودی Year سال Yearly سالانه Yes بله You must login to view this page. شما باید وارد شوید تا این صفحه را ببینید Zabbix سپهر فانوس ZABBIX سپهر فانوس Zabbix Admin مدیر سپهر فانوس Zabbix agent عامل سپهر فانوس Zabbix agent (active) عامل سپهر فانوس (فعال) Zabbix aggregate Sepehr aggregate Zabbix internal Sepehr internal Zabbix internal authentication Sepehr internal authentication Zabbix server سرور سپهر فانوس Zabbix server is running سرور سپهر فانوس در حال اجراست Zabbix server name نام سرور سپهر فانوس Zabbix server port پرت سرور سپهر فانوس Zabbix Super Admin مدیر ارشد سپهر فانوس Zabbix trapper Sepehr trapper Zabbix User کاربر سپهر فانوس 0 or 1 0 یا 1 %1$d day %1$d روز%1$d روز %1$s (year %2$s) %1$s(سال%2$s) 10 seconds 10 ثانیه 1 minute 1 دقیقه 30 seconds 30 ثانیه 3D view نمایش سه بعدی 500 latest values 500 مقدار اخیر 5 minutes 5 دقیقه 5 seconds 5 ثانیه Access denied! غير قابل دسترسي! Ack تأیید Acknowledge تأیید کردن Acknowledged تأیید شده Acknowledged PROBLEM events تأیید رویدادهای مشکل Action فعالیت ها Action added فعالیت اضافه شد Action deleted فعالیت حذف شد Actions فعالیت ها Action updated فعالیت بروز شد Active فعال Active since فعال از Active till فعال تا Add افزودن Add host افزودن هاست Add prototype افزودن نمونه اولیه Add to host group افزودن به گروه هاست Add to host groups افزودن به گروه هاست ها Admin مدیر Administration مدیریت Advanced labels برچسب های پیشرفته Age سن Age less than سن کمتر از agent عامل Agent عامل Agent interfaces واسط های عامل Alias نام مستعار all همه All همه All links should have "Name" and "URL" specified همه لینک ها باید "نام" و "آدرس" مشخص داشته باشند Allowed hosts هاست ها مجاز Any هیچ Any character string included فاقد رشته کاراکتری Application error. خطای برنامه. Apply اعمال Apr آوریل April آوریل Area size اندازه ناحیه Area type نوع ناحیه as Blue به عنوان آبی as Green به عنوان سبز As plain text به عنوان متن ساده as Red به عنوان قرمز Asset tag برچسب دارایی At (hour:minute) در (ساعت:دقیقه) Audit ممیزی Aug اوت August اوت Authentication تصدیق هویت Authentication algorithm الگوریتم تصدیق هویت Authentication method متد تصدیق هویت Auto-login ورود خودکار Automatic خودکار Automatic icon mapping نگاشت خودکار آیکن Automatic icon selection انتخاب آیکن خودکار Availability دسترسی Availability report گزارش دسترسی Available در دسترس Average متوسط avg میانگین Background پس زمینه Background image تصویر پس زمینه Bind password مقید به کلمه عبور Blocked مسدود شده Bold line خط‌ توپر Bottom پایین By host توسط هاست By trigger template تو سط قالب هشدار Calculated محاسبه کردن Cancel لغو Cannot add action فعالیت نمی تواند اضافه شود Cannot add dependency from a host to a template. وابستگی از یک هاست به یک قالب نمی‌تواند اضافه شود Cannot add discovery rule قانون کشف نمی تواند اضافه شود Cannot add graph نمودار نمی تواند اضافه شود Cannot add group گروه نمی تواند اضافه شود Cannot add host هاست نمی تواند اضافه شود Cannot add image تصویر نمی تواند اضافه شود Cannot add item آیتم نمی تواند اضافه شود Cannot add maintenance دوره نگهداری نمی تواند اضافه شود Cannot add media type نوع رسانه نمی تواند اضافه شود Cannot add network map نقشه شبکه نمی تواند اضافه شود Cannot add proxy پروکسی نمی تواند اضافه شود Cannot add regular expression عبارت منظم نمی تواند اضافه شود Cannot add script اسکریپت نمی تواند اضافه شود Cannot add template قالب نمی تواند اضافه شود Cannot add trigger هشدار نمی تواند اضافه شود Cannot add user کاربر نمی تواند اضافه شود Cannot clear history تاریخچه نمی‌تواند پاک شود Cannot clone graph prototypes. نمونه اولیه نمودارها نمی‌توانند کپی شوند Cannot clone item prototypes. نمونه اولیه آیتم ها نمی‌توانند کپی شوند Cannot clone trigger prototypes. نمونه اولیه هشدارها نمی‌توانند کپی شوند Cannot copy trigger "%1$s:%2$s", because it has multiple hosts in the expression. هشدار "%1$s:%2$s" نمی‌تواند کپی شود ، زیرا چندین هاست در عبارت خود دارد.هشدار "%1$s:%2$s" نمی‌تواند کپی شود ، زیرا چندین هاست در عبارت خود دارد.هشدار "%1$s:%2$s" نمی‌تواند کپی شود ، زیرا چندین هاست در عبارت خود دارد.هشدار "%1$s:%2$s" نمی‌تواند کپی شود ، زیرا چندین هاست در عبارت خود دارد.هشدار "%1$s:%2$s" نمی‌تواند کپی شود ، زیرا چندین هاست در عبارت خود دارد. Cannot create another database connection. اتصال دیگری به پایگاه داده نمی‌توانند ایجاد شود. Cannot create discovery rule قانون کشف نمی‌توانند ایجاد شود. Cannot create icon map نگاشت آیکن نمی‌توانند ایجاد شود. Cannot delete action فعالیت نمی‌تواند حذف شود Cannot delete graph نمودار نمی‌تواند حذف شود Cannot delete graphs نمودارها نمی‌توانند حذف شوند Cannot delete host هاست نمی‌تواند حذف شود Cannot delete icon map نگاشت آیکن نمی‌توانند حذف شود Cannot delete image تصویر نمی‌تواند حذف شود Cannot delete inventory. فهرست نمی‌تواند حذف شود. Cannot delete item آیتم نمی‌تواند حذف شود Cannot delete items آیتم ها نمی‌توانند حذف شوند Cannot delete maintenance دوره نگهداری نمی‌تواند حذف شود Cannot delete media type نوع رسانه نمی تواند حذف شود Cannot delete network map نقشه شبکه نمی تواند حذف شود Cannot delete proxy پروکسی نمی تواند حذف شود Cannot delete script اسکریپت نمی تواند حذف شود Cannot delete scripts. Script "%1$s" is used in action operation "%2$s". اسکریپت ها نمی توانند حذف شوند.اسکریپت "%1$s" در عملکرد فعالیت "%2$s" استفاده شده است.اسکریپت ها نمی توانند حذف شوند.اسکریپت "%1$s" در عملکرد فعالیت "%2$s" استفاده شده است.اسکریپت ها نمی توانند حذف شوند.اسکریپت "%1$s" در عملکرد فعالیت "%2$s" استفاده شده است.اسکریپت ها نمی توانند حذف شوند.اسکریپت "%1$s" در عملکرد فعالیت "%2$s" استفاده شده است.اسکریپت ها نمی توانند حذف شوند.اسکریپت "%1$s" در عملکرد فعالیت "%2$s" استفاده شده است. Cannot delete selected actions فعالیت های انتخاب شده نمی‌توانند حذف شوند Cannot delete template قالب نمی تواند حذف شود Cannot delete templated trigger "%1$s:%2$s". هشدارهای قالب شده "%1$s:%2$s" نمی توانند حذف شوند. Cannot delete trigger هشدار نمی‌تواند حذف شود Cannot delete triggers هشدارها نمی‌توانند حذف شوند Cannot delete user کاربر نمی‌تواند حذف شود Cannot find host interface on "%1$s" for item key "%2$s". واسط هاست در "%1$s" برای کلید آیتم "%2$s" پیدا نشد. Cannot link template قالب نمی تواند پیوندزده شود Cannot mass update host name. نام هاست را نمیتوانید دسته‌ای بروز کنید. Cannot mass update visible host name. نام قابل مشاهده هاست را نمیتوانید دسته‌ای بروز کنید. Cannot perform delete statement on table "%1$s" without where condition. دستور حذف برای جدول "%1$s" را نمیتوانید بدون شرط اجرا کنید. Cannot perform update statement on table "%1$s" without values. دستور بروزرسانی برای جدول "%1$s" را نمیتوانید بدون مقدار اجرا کنید. Cannot perform update statement on table "%1$s" without where condition. دستور بروزرسانی برای جدول "%1$s" را نمیتوانید بدون شرط اجرا کنید. Cannot save discovery rule without checks. قانون کشف بدون بررسی را نمیتوانید ذخیره کنید. Cannot unlink template قالب را نمی‌توانید جدا کنید Cannot update action فعالیت نمی‌تواند بروز شود Cannot update configuration پیکر بندی نمی‌تواند بروز شود Cannot update discovery rule قانون کشف نمیتواند بروز شود Cannot update graph نمودار نمی‌تواند بروز شود Cannot update group گروه نمی‌تواند بروز شود Cannot update host هاست نمی‌تواند بروز شود Cannot update hosts هاست ها نمی‌تواند بروز شود Cannot update icon map نگاشت آیکن نمی‌توانند بروز شود. Cannot update image تصویر نمیتواند بروز شود Cannot update item آیتم نمی‌تواند بروز شود Cannot update items آیتم ها نمی‌توانند بروز شوند Cannot update macros ماکرو نمی‌تواند بروز شود Cannot update maintenance دوره نگهداری نمی‌تواند بروز شود Cannot update media type نوع رسانه نمی تواند بروز شود Cannot update network map نقشه شبکه نمی تواند بروز شود Cannot update proxy پروکسی نمی‌تواند بروز شود Cannot update regular expression عبارت منظم نمی تواند بروز شود Cannot update script اسکریپت نمی تواند بروز شود Cannot update template قالب نمی تواند بروز شود Cannot update trigger هشدار نمی‌تواند بروز شود Cannot update user کاربر نمی‌تواند بروز شود Case sensitive حساس به متن Change password تغییر رمز عبور Character کاراکتر Character string included در بر داشتن رشته کاراکتری Character string not included در بر نداشتن رشته کاراکتری Chassis اسکلت Check already exists. بررسی از قبل وجود دارد Check expression part starting from "%1$s". بخش عبارت بررسی از "%1$s" شروع می‌شود. Checks تطبیق ها Checks should be unique. تطبیق ها باید منحصر به فرد باشد. Check the key, please. Default example was passed. لطفاً کلید را بررسی کنید، نمونه پیش ‌فرض پاس داده خواهد شد. Check type نوع تطبیق Clear history and trends پاک کردن تاریخچه و روند ها Clear when unlinking پاک کردن وقتی جدا شد Clock ساعت Clone کپی برداری Close بستن Close expression constructor بستن عبارت سازنده Columns ستون ها Combined result ترکیب کردن نتیجه ها Command فرمان Commands فرمان ها Condition شرط Conditions شروط Configuration پیکربندی Configuration of actions پیکربندی فعالیت ها Configuration of graphs پیکربندی نمودار ها Configuration of items پیکربندی آیتم ها Configuration of network maps پیکربندی نقشه های شبکه Configuration of triggers پیکربندی هشدار ها Configuration updated پیکربندی بروز شد Confirmation text متن تایید Connect to متصل به Contact تماس Contract number شماره تماس Copy رونوشت Count تعداد Create action ایجاد فعالیت Create graph ایجاد نمودار Create icon map ایجاد نگاشت آیکن Create item ایجاد آیتم Create maintenance period ایجاد بازه نگه داری Create map ایجاد نقشه Create media type ایجاد نوع رسانه Create proxy ایجاد پروکسی Create script ایجاد اسکریپت Create trigger ایجاد هشدار Create user ایجاد کاربر Current host هاست فعلی Current value مقدار فعلی Custom graphs نقشه های سفارشی Custom label برچسب سفارشی Custom multiplier تکثیر کننده سفارشی Custom severity names affect all locales and require manual translation! نام درجه اهمیت هشدار ها بر روی ترجمه سیستم تأثیر می گذارد Custom size اندازه سفارشی Daily روزانه Dashboard داشبورد Dashed line خط تیره Database host هاست پایگاه داده Database monitor مانیتور پایگاه داده Database name نام پایگاه داده Database password کلمه عبور پایگاه داده Database port پرت پایگاه داده Database schema شمای پایگاه داده Database server سرور پایگاه داده Database type نوع پایگاه داده Database user کاربر پایگاه داده Data overview نمای کلی Date تاریخ Date HW decommissioned تاریخ کمیسیون سخت افزار Date HW installed تاریخ نصب سخت افزار Date HW maintenance expires تاریخ منقضی شدن تعمیر سخت افزار Date HW purchased تاریخ خرید سخت افزار Day روز Day of month روز از ماه Day of week روز از هفته days روز Days روز %d device %dدستگاه Debug رفع خطا Debug mode حالت رفع خطا December دسامبر default پیش‌فرض Default پیش فرض Default authentication تصدیق هویت پیش فرض Default theme پوسته پیش فرض Delay تاخیر Delayed by تأخیر توسط Delete حذف Delete and clear حذف و پاک کردن Delimiter جداکننده Deny رد کردن Dependencies وابستگی‌ها Dependent وابسته Depends on وابسته به Deployment status وضعیت گسترش Description توصیف Details جزئیات Device uniqueness criteria ضابطه یکتایی دستگاه Disable غیرفعال Disabled غیرفعال‌شده Disable host غیرفعال‌سازی هاست Disable host? غیرفعال‌سازی هاست؟ Disaster حادثه بد Discovered کشف شده Discovered device دستگاه کشف شده Discovery کشف Discovery by proxy کشف با پروکسی Discovery check تطبیق کشف Discovery checks تطبیق کشف Discovery object تطبیق شیء Discovery rule قانون کشف Discovery rules قوانین کشف Discovery status وضعیت کشف Displaying %1$s of %2$s found نمایش %1$s از %2$s پیدا شده Display OK triggers for نمایش هشدار های رفع شده برای Dot نقطه Downtime زمان از کار افتادگی Draw style رسم سبک Duration مدت Dynamic item آیتم پویا Each URL should have a unique name. Please make sure there is only one URL named هر آدرس اینترنتی باید یک نام واحد داشته باشد.لطفاً مطمئن شوید که این آدرس فقط یکبار استفاده شده است.هر آدرس اینترنتی باید یک نام واحد داشته باشد.لطفاً مطمئن شوید که این آدرس فقط یکبار استفاده شده است.هر آدرس اینترنتی باید یک نام واحد داشته باشد.لطفاً مطمئن شوید که این آدرس فقط یکبار استفاده شده است.هر آدرس اینترنتی باید یک نام واحد داشته باشد.لطفاً مطمئن شوید که این آدرس فقط یکبار استفاده شده است.هر آدرس اینترنتی باید یک نام واحد داشته باشد.لطفاً مطمئن شوید که این آدرس فقط یکبار استفاده شده است. Edit ویرایش Element عنصر Element name نام عنصر Email پست الکترونیکی Empty خالی Enable فعال‌سازی Enable confirmation فعال‌سازی تصدیق Enabled فعال‌شده Enable host فعال‌سازی هاست Error خطا Event رویداد Event details جزئیات رویداد Event generation تولید رویداد Event ID شناسه‌ی رویداد Event list [previous 20] لیست رویداد[20 رویداد قبلی] Every day(s) هر روز Every week(s) هر هفته Exclude مانع شدن Execute اجرا Executed script اجرای اسکریپت Execute on اجرا روی Execution confirmation تأیید اجرا Expand single problem بسط دادن یک مشکل Exploded گسترش یافته Export to CSV صدور به CSV Expression عبارت Expression cannot be empty عبارت نمیتواند خالی باشد Expression constructor ساختار عبارت Expressions عبارات Expression type نوع عبارت External check تطبیق خارجی Fail شکست Failed شکست خورد Failure Audit شکست ممیزی FALSE نادرست February فوریه Field فیلد Filled region منطقه پرشده Filter فیلتر Finish پایان Fit to map متناسب با نقشه Fixed ثابت Friday جمعه From از Frontend access دسترسی به واسط کاربری Full clone کپی کامل Function تابع General عمومی Go to برو به Gradient line خط گراديان Graph نمودار Graph prototypes نمونه اولیه گراف Graphs نمودارها Graph sum مجموع گراف Graph type نوع گراف Grid شبکه اى Group گروه Group for discovered hosts گروه برای هاست های کشف شده Grouping by گروه کردن بر اساس Group name نام گروه Groups گروهها GSM modem مودم GSM GUI واسط گرافیکی کاربران GUI access disabled. دسترسی واسط گرافیکی غیرفعال شده است. Hardware سخت افزار Hardware (Full details) سخت افزار (جزییات کامل) Height ارتفاع Help راهنما Hidden پنهان Hide selected مخفی کردن موارد High بالا History تاریخچه Horizontal افقی Horizontal align ردیف کردن افقی host هاست Host access دسترسی هاست Host cannot have more than one default interface of the same type. هاست نمی‌تواند بیشتر از یک واسط پیش فرض داشته باشد. Host count تعداد هاست host group گروه هاست Host group گروه هاست Host group elements عناصر گروه هاست Host group label type نوع برچسب گروه هاست Host groups گروه هاست ها Host interface واسط هاست Host inventory فهرست هاست Host inventory overview نمای کلی فهرست هاست Host IP آدرس هاست Host label type نوع برچسب هاست Host name نام هاست Host networks شبکه‌های هاست Host router مسیریاب هاست Hosts هاست ‌ها Hosts location مکان هاست ها Host subnet mask subnet mask هاست Host time زمان هاست Hours ساعت HTTP authentication احراز هویت HTTP HW architecture ساختار سخت افزار icon نشان Icon نشان Icon (default) نشان (پیش‌فرض) Icon (disabled) نشان(غیرفعال) Icon highlight نشان پررنگ Icon (maintenance) نشان(نگهداری) Icon map نگاشت نشان Icon mapping نگاشت نشان Icon (problem) نشان(مشکل) Icons نشانها ID شناسه image تصویر Image تصویر Images تصاویر Immediately فوری Import وارد کردن Import file واردات پرونده in در Include شامل Info اطلاعات Information اطلاعات In maintenance در نگهداری In progress در حال پیشرفت Insert درج Installation نصب Installer name نام نصاب Interface واسط Interval بازه Inventory فهرست IP address آدرس IP IPMI agent عامل IPMI IPMI interfaces واسط های IPMI IPMI sensor سنسور IPMI IP range محدوده IP Item آیتم Item count تعداد آیتم Item prototype نمونه اولیه آیتم Item prototypes نمونه اولیه آیتم ها Items آیتم ها Items list لیست آیتم JMX agent عامل JMX JMX interfaces واسط های JMX Key کلید Label برچسب Label location محل برچسب Language زبان last آخرین last آخرین Last check آخرین بررسی Last hour graph نمودار ساعت گذشته Last month graph نمودار ماه گذشته Last of آخرین از Last seen (age) آخرین مشاهده(سن) Last value آخرین مقدار Last week graph نمودار هفته گذشته Latest data آخرین اطلاعات Left چپ Limit for search and filter results محدودسازی مشخصه های جستجو/فیلتر Line سطر Link پیوند Linked templates پیوندزده به قالب ها Link indicators شاخص پیوند Link to template پیوند به قالب Link to templates پیوند به قالب ها List is empty لیست خالی است Local time زمان محلی Location مکان Location latitude عرض جغرافیایی Location longitude طول جغرافیایی Log ثبت وقایع Login ورود Logout خروج Log time format قالب ثبت زمان Lost از دست‌ رفته‌ Macro ماکرو macro(s) ماکرو(ها) Macros ماکروها Maintenance نگهداری Maintenance period length طول دوره نگه داری Maintenance periods دوره های نگه داری Maintenance type نوع تعمیر و نگه داری <manual> <دستی> Manual دستی map نقشه Map نقشه Mapped to نگاشت شده به Mappings نگاشت Maps نقشه‌ها Mark others انتخاب دیگران Mark selected انتخاب موارد Mass update بروز رسانی کلی max بیشترین Max count of elements to show inside table cell حداکثر تعداد عناصر در جدول Media رسانه Media type نوع رسانه Media types انوع رسانه Members اعضا Message پیام Messages پیام Messaging پیام‌رسانی Middle وسط min کمترین Minutes دقیقه Mode حالت Model مدل Mon دوشنبه Monday دوشنبه Monitored by proxy مانیتور شده با پروکسی Monitored host هاست مانیتور شده Monitoring مانیتورینگ Month ماه Monthly ماهانه More than 10 minutes بیشتر از 10 دقیقه Multiple PROBLEM events رویدادهای مشکلات چندگانه Mute بی‌صدا Name نام Network maps نقشه های شبکه Never هرگز New condition شرط جدید New element عنصر جدید New regular expression عبارت منظم جدید No خیر No conditions defined. هیچ no data بدون داده No data collection هیچ شرطی تعریف نشده است No details بدون جزئیات No image بدون تصویر None هیچکدام (no proxy) (بدون پروکسی) No proxy (بدون پروکسی) Normal عادی Normal view نمای عادی‌ Not Ack بدون تأیید No target selected هدف انتخاب نشده No target selected. هدف انتخاب نشده Not available غیرقابل دسترس Not classified رده بندی نشده Notes یادداشتها Nothing هیچ‌چیز Notification report گزارش آگاه سازی Notifications اخطارها not in نیست در not selected انتخاب نشده Not supported عدم پشتیبانی November نوامبر Number of status changes تعداد حالت‌های تغییر یافته Number of steps تعداد مراحل Number of users (online) تعداد کاربران (در دسترس) Numeric (float) عددی(شناور) Numeric (unsigned) عددی (بیعلامت) October اکتبر of از Off خاموش Ok صحیح OK صحیح on در On روشن Once یکبار One time only فقط یکبار Operation details جزئیات عملکرد Operations عملکردها Operator عملگر Original اصلی OS سیستم عامل OS (Full details) جزییات کامل سیستم عامل OS (Short) سیستم عامل(خلاصه) other دیگر Other دیگر Other parameters پارامترهای دیگر Others دیگران Overview نمای کلی Parameter پارامتر Parent triggers هشدارهای والد Passive منفعل Password گذز واژه Password (once again) گذرواژه (دوباره) Period دوره Periods دوره ها Period type نوع دوره Permissions مجوزها Persian (fa_IR) فارسی Pie دایره ای Placing algorithm محل الگوریتم Plain text متن ساده Play پخش Play sound پخش صدا Please select two elements لطفاً دو عنصر انتخاب کنید Populates host inventory field قرار گرفتن در فیلد هاست Port پرت Port range محدوده پرت Preview پیش‌نمایش Private key file فابل کلید اختصاصی Privilege level سطح ویژه Problem مشکل PROBLEM مشکل Problem display نمایش مشکل Problem on نمایش مشکل Problems مشکل Proxies پروکسی ها Proxy پروکسی Public key كليد عمومى Public key file فایل کلید عمومی Queue صف Read خواندن Read only فقط خواندنی Read-write خواندن-نوشتن Received value وقادیر دریافت شده Recipient گیرنده Recovery بازیابی Regular expression عبارت منظم Regular expressions عبارات منظم Remember me for 30 days مرا بخاطر بسپار برای 30 روز Remote command فرمان راه دور Remove حذف Remove from host group حذف از گروه هاست Remove from host groups حذف از گروه های هاست Remove host حذف میزبان‌ Replace جایگزینی Reports گزارشات Required مورد نیاز Required host permissions مجوز هاست مورد نیاز است Required performance (vps) کارایی مورد نیاز(vps) Required server performance, new values per second کارایی مورد نیاز سرور ، مقادیر جدید بر ثانیه Required status codes کدهای وضعیت مورد نیاز Required string رشته مورد نیاز Reset بازنشانی Reset confirmation بازنشاندن تصدیق Reset defaults بازنشانی پیش‌فرضها Resolved رفع شد Resource منبع Response code کد پاسخ Response time زمان پاسخ Result نتیجه Result is FALSE نتیجه غلط است Result is TRUE نتیجه درست است Result type نوع نتیجه Retry سعی مجدد Right راست Rows سطرها Rows per page سطر در صفحه Rules قوانین Sat شنبه Saturday شنبه Scenario سناریو Schedule زمان‌بندی Script اسکریپت Script name نام اسکریپت Scripts اسکریپت ها Search جستجو Search attribute مشخصه‌ی جستجو Select انتخاب Selected انتخاب شده Selected elements عناصر انتخاب شده Select prototype انتخاب نمونه اولیه Send message ارسال پیام Send message to user groups ارسال پیام به گروه کاربران Send message to users ارسال پیام به کاربران Send only to ارسال فقط به Send to ارسال به Sent ارسال‌شده Separated جداشده September سپتامبر Server سرور Server time زمان سرور Service سرویس Service port پرت سرویس Services سرویس ها Service type نوع سرویس Session terminated, re-login, please. جلسه پایان یافت ، لطفاً دوباره وارد شوید Severity جدیت short description شرح کوتاه Show نمایش Show details نمایش جزئیات Show hosts in maintenance نمایش هاست در دست نگهداری show icon mappings نمایش نشان های نگاشت شده Show legend نمایش فهرست Show lines نمایش خطوط Shown نمایش Show selected نمایش موارد Show text as HTML نمایش متن به عنوان HTML Show triggers نمایش هشدارها Show working time نمایش ساعت کاری Sign in ورود Simple ساده Simple check بررسی ساده Simple graph نمودار ساده Site address A آدرس 1 سایت Site address B آدرس 2 سایت Site address C آدرس 3 سایت Site city شهر سایت Site country کشور سایت Site notes یادداشتهای سایت Site rack location مکان rack سایت Site state / province استان سایت Site ZIP / postal کدپستی سایت SLA سطح سرویس SMS پیام کوتاه SNMP interfaces واسط های SNMP SNMPv1 agent عامل SNMPv1 SNMPv2 agent عامل SNMPv2 SNMPv3 agent عامل SNMPv3 Snooze بعدا Software نرم‌افزار Software application A نرم‌افزار کاربردی الف Software application B نرم‌افزار کاربردی ب Software application C نرم‌افزار کاربردی ج Software application D نرم‌افزار کاربردی د Software application E نرم‌افزار کاربردی ه Software (Full details) نرم‌افزار (جزییات کامل) Sort order (0->999) مرتب سازی(0->999) Source منبع Speed سرعت SSH agent عامل SSH Stacked پشته‌ای Standard items آیتم های استاندارد State حالت Status وضعیت Status codes کد وضعیت Status of discovery وضعیت کشف Status only فقط وضعیت Step گام Steps مراحل Stop توقف Straight مستقیم Subject موضوع Submap زیر نقشه Success Audit رسیدگی موفق Sun یکشنبه Sunday یکشنبه Support پشتیبانی System default پیش‌فرض سیستم System error. خطای سیستم. Target هدف Target list فهرست هدف Target type نوع هدف TELNET agent عامل TELNET Template قالب Template group گروه قالب Template linkage پیوند قالب Template name نام قالب Templates قالب ها Template trigger هشدار قالب Test آزمایش Test authentication آزمایش احراز هویت Test confirmation آزمایش کردن تأیید Test data آزمایش داده Test string آزمایش رشته Text متن Theme پوسته This month این ماه This week این هفته This year امسال Thu پنجشنبه Thursday پنجشنبه Till تا Time زمان Timeout زمان انقضا Time period دوره زمانی Time shift انتقال زمان Timestamp مهر زمان Time type نوع زمان To به Today امروز Top بالا Total کل TOTAL کل Trends روندها trigger هشدار Trigger هشدار Trigger displaying options نمایش گزبنه های هشدار Trigger label type نوع برچسب هشدار Trigger name نام هشدار Trigger overview نمای کلی هشدارها Trigger prototype نمونه اولیه هشدار Trigger prototypes نمونه های اولیه هشدار Triggers هشدارها Trigger severity جدیت هشدار Triggers top 100 100 هشدار بالا TRUE درست Tue سه شنبه Tuesday سه شنبه Type نوع Type (Full details) نوع[جزییات کامل] Type of calculation نوع محاسبات Type of information نوع اطلاعات Type (OK) نوع (صحیح) Types انواع Unacknowledged only فقط تأیید نشده Unacknowledged PROBLEM events رویدادهای مشکل تأیید نشده Units واحدها unknown ناشناخته Unknown ناشناخته UNKNOWN ناشناخته Unknown action فعالیت ناشناخته Unlink حذف پیوند Unlink and clear حذف پیوند و پاک کردن Unlink from template حذف پیوند از قالب Unlink from templates حذف پیوند از قالب ها Unmute وصل صدا Update به‌روزرسانی Update existing بروزرسانی در حال حاضر Update interval فاصله به‌روزرسانی Upload بارگذاری Upper level maps نقشه های سطح بالاتر Uptime زمان کار Uptime/Downtime زمان کار/زمان از کارافتادگی URL نشانی اینترنتی URL A نشانی اینترنتی الف URL (after login) نشانی اینترنتی(بعد از ورود) URL B نشانی اینترنتی ب URL C نشانی اینترنتی ج URLs نشانی های اینترنتی Used in actions استفاده شده در فعالیت Use if severity استفاده برای اهمیت User کار‌بر User group گروه کابر User groups گروه های کابران User name نام کاربری Username نام کاربری User password گذرواژه کاربر User profile پروفایل کاربر Users کاربران User type نوع کاربر value مقدار Value مقدار Value map نگاشت مقدار Value mapping نگاشت مقدار Values مقادیر Variables متغیرها Vendor فروشنده Vertical عمودی Vertical align ردیف کردن عمودی Visible name نام قابل رؤیت Warning اخطار Web وب Web monitoring مانیتورینگ وب Wed چهارشنبه Wednesday چهارشنبه Weekly هفتگی When active وقتی فعال شد Width عرض With data collection با جمع آوری داده Without problems بدون مشکلات Without triggers بدون هشدارها With problems با مشکلات With triggers با هشدارها Working time ساعت کاری Write نوشتن Y axis MAX value حداکثر مقدار محور افقی Y axis MIN value حداکثر مقدار محور عمودی Y axis side سمت محور عمودی Year سال Yearly سالانه Yes بله You must login to view this page. شما باید وارد شوید تا این صفحه را ببینید Zabbix سپهر فانوس ZABBIX سپهر فانوس Zabbix agent عامل سپهر فانوس Zabbix agent (active) عامل سپهر فانوس (فعال) Zabbix internal Sepehr internal Zabbix internal authentication Sepehr internal authentication Zabbix server سرور سپهر فانوس Zabbix server is running سرور سپهر فانوس در حال اجراست Zabbix server name نام سرور سپهر فانوس Zabbix trapper Sepehr trapper 0 or 1 0 یا 1 %1$d day %1$d روز%1$d روز %1$s (year %2$s) %1$s(سال%2$s) 10 seconds 10 ثانیه 1 minute 1 دقیقه 30 seconds 30 ثانیه 3D view نمایش سه بعدی 500 latest values 500 مقدار اخیر 5 minutes 5 دقیقه 5 seconds 5 ثانیه Access denied! غير قابل دسترسي! Ack تأیید Ack تأیید Acknowledge تأیید کردن Acknowledged تأیید شده Acknowledged PROBLEM events تأیید رویدادهای مشکل Action فعالیت ها Action فعالیت ها Action added فعالیت اضافه شد Action deleted فعالیت حذف شد Actions فعالیت ها Actions فعالیت ها Action updated فعالیت بروز شد Active فعال Active since فعال از Active till فعال تا Add افزودن Add host افزودن هاست Add prototype افزودن نمونه اولیه Add to host group افزودن به گروه هاست Add to host groups افزودن به گروه هاست ها Admin مدیر Administration مدیریت Advanced labels برچسب های پیشرفته Age سن Age less than سن کمتر از agent عامل Agent عامل Agent interfaces واسط های عامل Alias نام مستعار all همه All همه All links should have "Name" and "URL" specified همه لینک ها باید "نام" و "آدرس" مشخص داشته باشند Allowed hosts هاست ها مجاز Any هیچ Any character string included فاقد رشته کاراکتری Application error. خطای برنامه. Apply اعمال Apr آوریل April آوریل Area size اندازه ناحیه Area type نوع ناحیه as Blue به عنوان آبی as Green به عنوان سبز As plain text به عنوان متن ساده as Red به عنوان قرمز Asset tag برچسب دارایی At (hour:minute) در (ساعت:دقیقه) Audit ممیزی Aug اوت August اوت Authentication تصدیق هویت Authentication algorithm الگوریتم تصدیق هویت Authentication method متد تصدیق هویت Auto-login ورود خودکار Automatic خودکار Automatic icon mapping نگاشت خودکار آیکن Automatic icon selection انتخاب آیکن خودکار Availability دسترسی Availability report گزارش دسترسی Available در دسترس Available در دسترس Average متوسط avg میانگین Background پس زمینه Background image تصویر پس زمینه Bind password مقید به کلمه عبور Blocked مسدود شده Bold line خط‌ توپر Bottom پایین By host توسط هاست By trigger template تو سط قالب هشدار Calculated محاسبه کردن Cancel لغو Cannot add action فعالیت نمی تواند اضافه شود Cannot add dependency from a host to a template. وابستگی از یک هاست به یک قالب نمی‌تواند اضافه شود Cannot add discovery rule قانون کشف نمی تواند اضافه شود Cannot add graph نمودار نمی تواند اضافه شود Cannot add group گروه نمی تواند اضافه شود Cannot add host هاست نمی تواند اضافه شود Cannot add image تصویر نمی تواند اضافه شود Cannot add item آیتم نمی تواند اضافه شود Cannot add maintenance دوره نگهداری نمی تواند اضافه شود Cannot add media type نوع رسانه نمی تواند اضافه شود Cannot add network map نقشه شبکه نمی تواند اضافه شود Cannot add proxy پروکسی نمی تواند اضافه شود Cannot add regular expression عبارت منظم نمی تواند اضافه شود Cannot add script اسکریپت نمی تواند اضافه شود Cannot add template قالب نمی تواند اضافه شود Cannot add trigger هشدار نمی تواند اضافه شود Cannot add user کاربر نمی تواند اضافه شود Cannot clear history تاریخچه نمی‌تواند پاک شود Cannot clone graph prototypes. نمونه اولیه نمودارها نمی‌توانند کپی شوند Cannot clone item prototypes. نمونه اولیه آیتم ها نمی‌توانند کپی شوند Cannot clone trigger prototypes. نمونه اولیه هشدارها نمی‌توانند کپی شوند Cannot copy trigger "%1$s:%2$s", because it has multiple hosts in the expression. هشدار "%1$s:%2$s" نمی‌تواند کپی شود ، زیرا چندین هاست در عبارت خود دارد.هشدار "%1$s:%2$s" نمی‌تواند کپی شود ، زیرا چندین هاست در عبارت خود دارد.هشدار "%1$s:%2$s" نمی‌تواند کپی شود ، زیرا چندین هاست در عبارت خود دارد.هشدار "%1$s:%2$s" نمی‌تواند کپی شود ، زیرا چندین هاست در عبارت خود دارد.هشدار "%1$s:%2$s" نمی‌تواند کپی شود ، زیرا چندین هاست در عبارت خود دارد. Cannot create another database connection. اتصال دیگری به پایگاه داده نمی‌توانند ایجاد شود. Cannot create discovery rule قانون کشف نمی‌توانند ایجاد شود. Cannot create icon map نگاشت آیکن نمی‌توانند ایجاد شود. Cannot delete action فعالیت نمی‌تواند حذف شود Cannot delete graph نمودار نمی‌تواند حذف شود Cannot delete graphs نمودارها نمی‌توانند حذف شوند Cannot delete host هاست نمی‌تواند حذف شود Cannot delete icon map نگاشت آیکن نمی‌توانند حذف شود Cannot delete image تصویر نمی‌تواند حذف شود Cannot delete inventory. فهرست نمی‌تواند حذف شود. Cannot delete item آیتم نمی‌تواند حذف شود Cannot delete items آیتم ها نمی‌توانند حذف شوند Cannot delete maintenance دوره نگهداری نمی‌تواند حذف شود Cannot delete media type نوع رسانه نمی تواند حذف شود Cannot delete network map نقشه شبکه نمی تواند حذف شود Cannot delete proxy پروکسی نمی تواند حذف شود Cannot delete script اسکریپت نمی تواند حذف شود Cannot delete scripts. Script "%1$s" is used in action operation "%2$s". اسکریپت ها نمی توانند حذف شوند.اسکریپت "%1$s" در عملکرد فعالیت "%2$s" استفاده شده است.اسکریپت ها نمی توانند حذف شوند.اسکریپت "%1$s" در عملکرد فعالیت "%2$s" استفاده شده است.اسکریپت ها نمی توانند حذف شوند.اسکریپت "%1$s" در عملکرد فعالیت "%2$s" استفاده شده است.اسکریپت ها نمی توانند حذف شوند.اسکریپت "%1$s" در عملکرد فعالیت "%2$s" استفاده شده است.اسکریپت ها نمی توانند حذف شوند.اسکریپت "%1$s" در عملکرد فعالیت "%2$s" استفاده شده است. Cannot delete selected actions فعالیت های انتخاب شده نمی‌توانند حذف شوند Cannot delete template قالب نمی تواند حذف شود Cannot delete templated trigger "%1$s:%2$s". هشدارهای قالب شده "%1$s:%2$s" نمی توانند حذف شوند. Cannot delete trigger هشدار نمی‌تواند حذف شود Cannot delete triggers هشدارها نمی‌توانند حذف شوند Cannot delete user کاربر نمی‌تواند حذف شود Cannot find host interface on "%1$s" for item key "%2$s". واسط هاست در "%1$s" برای کلید آیتم "%2$s" پیدا نشد. Cannot link template قالب نمی تواند پیوندزده شود Cannot mass update host name. نام هاست را نمیتوانید دسته‌ای بروز کنید. Cannot mass update visible host name. نام قابل مشاهده هاست را نمیتوانید دسته‌ای بروز کنید. Cannot perform delete statement on table "%1$s" without where condition. دستور حذف برای جدول "%1$s" را نمیتوانید بدون شرط اجرا کنید. Cannot perform update statement on table "%1$s" without values. دستور بروزرسانی برای جدول "%1$s" را نمیتوانید بدون مقدار اجرا کنید. Cannot perform update statement on table "%1$s" without where condition. دستور بروزرسانی برای جدول "%1$s" را نمیتوانید بدون شرط اجرا کنید. Cannot save discovery rule without checks. قانون کشف بدون بررسی را نمیتوانید ذخیره کنید. Cannot unlink template قالب را نمی‌توانید جدا کنید Cannot update action فعالیت نمی‌تواند بروز شود Cannot update configuration پیکر بندی نمی‌تواند بروز شود Cannot update discovery rule قانون کشف نمیتواند بروز شود Cannot update graph نمودار نمی‌تواند بروز شود Cannot update group گروه نمی‌تواند بروز شود Cannot update host هاست نمی‌تواند بروز شود Cannot update hosts هاست ها نمی‌تواند بروز شود Cannot update icon map نگاشت آیکن نمی‌توانند بروز شود. Cannot update image تصویر نمیتواند بروز شود Cannot update item آیتم نمی‌تواند بروز شود Cannot update items آیتم ها نمی‌توانند بروز شوند Cannot update macros ماکرو نمی‌تواند بروز شود Cannot update maintenance دوره نگهداری نمی‌تواند بروز شود Cannot update media type نوع رسانه نمی تواند بروز شود Cannot update network map نقشه شبکه نمی تواند بروز شود Cannot update proxy پروکسی نمی‌تواند بروز شود Cannot update regular expression عبارت منظم نمی تواند بروز شود Cannot update script اسکریپت نمی تواند بروز شود Cannot update template قالب نمی تواند بروز شود Cannot update trigger هشدار نمی‌تواند بروز شود Cannot update user کاربر نمی‌تواند بروز شود Case sensitive حساس به متن Change password تغییر رمز عبور Character کاراکتر Character string included در بر داشتن رشته کاراکتری Character string not included در بر نداشتن رشته کاراکتری Chassis اسکلت Check already exists. بررسی از قبل وجود دارد Check expression part starting from "%1$s". بخش عبارت بررسی از "%1$s" شروع می‌شود. Checks تطبیق ها Checks should be unique. تطبیق ها باید منحصر به فرد باشد. Check the key, please. Default example was passed. لطفاً کلید را بررسی کنید، نمونه پیش ‌فرض پاس داده خواهد شد. Check type نوع تطبیق Clear history and trends پاک کردن تاریخچه و روند ها Clear when unlinking پاک کردن وقتی جدا شد Clock ساعت Clone کپی برداری Close بستن Close expression constructor بستن عبارت سازنده Columns ستون ها Combined result ترکیب کردن نتیجه ها Command فرمان Commands فرمان ها Condition شرط Conditions شروط Configuration پیکربندی Configuration of actions پیکربندی فعالیت ها Configuration of graphs پیکربندی نمودار ها Configuration of items پیکربندی آیتم ها Configuration of network maps پیکربندی نقشه های شبکه Configuration of triggers پیکربندی هشدار ها Configuration updated پیکربندی بروز شد Confirmation text متن تایید Connect to متصل به Contact تماس Contract number شماره تماس Copy رونوشت Count تعداد Create action ایجاد فعالیت Create graph ایجاد نمودار Create icon map ایجاد نگاشت آیکن Create item ایجاد آیتم Create maintenance period ایجاد بازه نگه داری Create map ایجاد نقشه Create media type ایجاد نوع رسانه Create proxy ایجاد پروکسی Create script ایجاد اسکریپت Create trigger ایجاد هشدار Create user ایجاد کاربر Current host هاست فعلی Current value مقدار فعلی Custom graphs نقشه های سفارشی Custom label برچسب سفارشی Custom multiplier تکثیر کننده سفارشی Custom severity names affect all locales and require manual translation! نام درجه اهمیت هشدار ها بر روی ترجمه سیستم تأثیر می گذارد Custom size اندازه سفارشی Daily روزانه Dashboard داشبورد Dashed line خط تیره Database host هاست پایگاه داده Database monitor مانیتور پایگاه داده Database name نام پایگاه داده Database password کلمه عبور پایگاه داده Database port پرت پایگاه داده Database schema شمای پایگاه داده Database server سرور پایگاه داده Database type نوع پایگاه داده Database user کاربر پایگاه داده Data overview نمای کلی Date تاریخ Date HW decommissioned تاریخ کمیسیون سخت افزار Date HW installed تاریخ نصب سخت افزار Date HW maintenance expires تاریخ منقضی شدن تعمیر سخت افزار Date HW purchased تاریخ خرید سخت افزار Day روز Day روز Day of month روز از ماه Day of week روز از هفته days روز Days روز %d device %dدستگاه Debug رفع خطا Debug mode حالت رفع خطا December دسامبر default پیش‌فرض Default پیش فرض Default authentication تصدیق هویت پیش فرض Default theme پوسته پیش فرض Delay تاخیر Delayed by تأخیر توسط Delete حذف Delete and clear حذف و پاک کردن Delimiter جداکننده Deny رد کردن Dependencies وابستگی‌ها Dependent وابسته Depends on وابسته به Deployment status وضعیت گسترش Description توصیف Details جزئیات Device uniqueness criteria ضابطه یکتایی دستگاه Disable غیرفعال Disabled غیرفعال‌شده Disable host غیرفعال‌سازی هاست Disable host? غیرفعال‌سازی هاست؟ Disaster حادثه بد Discovered کشف شده Discovered device دستگاه کشف شده Discovery کشف Discovery by proxy کشف با پروکسی Discovery check تطبیق کشف Discovery checks تطبیق کشف Discovery object تطبیق شیء Discovery rule قانون کشف Discovery rule قانون کشف Discovery rules قوانین کشف Discovery status وضعیت کشف Displaying %1$s of %2$s found نمایش %1$s از %2$s پیدا شده Display OK triggers for نمایش هشدار های رفع شده برای Dot نقطه Downtime زمان از کار افتادگی Downtime زمان از کار افتادگی Draw style رسم سبک Duration مدت Duration مدت Dynamic item آیتم پویا Each URL should have a unique name. Please make sure there is only one URL named هر آدرس اینترنتی باید یک نام واحد داشته باشد.لطفاً مطمئن شوید که این آدرس فقط یکبار استفاده شده است.هر آدرس اینترنتی باید یک نام واحد داشته باشد.لطفاً مطمئن شوید که این آدرس فقط یکبار استفاده شده است.هر آدرس اینترنتی باید یک نام واحد داشته باشد.لطفاً مطمئن شوید که این آدرس فقط یکبار استفاده شده است.هر آدرس اینترنتی باید یک نام واحد داشته باشد.لطفاً مطمئن شوید که این آدرس فقط یکبار استفاده شده است.هر آدرس اینترنتی باید یک نام واحد داشته باشد.لطفاً مطمئن شوید که این آدرس فقط یکبار استفاده شده است. Edit ویرایش Element عنصر Element name نام عنصر Email پست الکترونیکی Empty خالی Enable فعال‌سازی Enable confirmation فعال‌سازی تصدیق Enabled فعال‌شده Enable host فعال‌سازی هاست Error خطا Event رویداد Event acknowledged رویداد اعلام وصل شده Event details جزئیات رویداد Event generation تولید رویداد Event ID شناسه‌ی رویداد Event list [previous 20] لیست رویداد[20 رویداد قبلی] Every day(s) هر روز Every week(s) هر هفته Exclude مانع شدن Execute اجرا Executed script اجرای اسکریپت Execute on اجرا روی Execution confirmation تأیید اجرا Expand single problem بسط دادن یک مشکل Exploded گسترش یافته Export to CSV صدور به CSV Expression عبارت Expression cannot be empty عبارت نمیتواند خالی باشد Expression constructor ساختار عبارت Expressions عبارات Expression type نوع عبارت External check تطبیق خارجی Fail شکست Failed شکست خورد Failed شکست خورد Failure Audit شکست ممیزی FALSE نادرست February فوریه Field فیلد Filled region منطقه پرشده Filter فیلتر Finish پایان Fit to map متناسب با نقشه Fixed ثابت Friday جمعه From از Frontend access دسترسی به واسط کاربری Full clone کپی کامل Function تابع General عمومی Go to برو به Gradient line خط گراديان Graph نمودار Graph prototypes نمونه اولیه گراف Graphs نمودارها Graph sum مجموع گراف Graph type نوع گراف Grid شبکه اى Group گروه Group for discovered hosts گروه برای هاست های کشف شده Grouping by گروه کردن بر اساس Group name نام گروه Groups گروهها GSM modem مودم GSM GUI واسط گرافیکی کاربران GUI access disabled. دسترسی واسط گرافیکی غیرفعال شده است. Hardware سخت افزار Hardware (Full details) سخت افزار (جزییات کامل) Height ارتفاع Help راهنما Hidden پنهان Hide selected مخفی کردن موارد High بالا History تاریخچه Horizontal افقی Horizontal align ردیف کردن افقی host هاست Host هاست Host هاست Host access دسترسی هاست Host cannot have more than one default interface of the same type. هاست نمی‌تواند بیشتر از یک واسط پیش فرض داشته باشد. Host count تعداد هاست host group گروه هاست Host group گروه هاست Host group گروه هاست Host group elements عناصر گروه هاست Host group label type نوع برچسب گروه هاست Host groups گروه هاست ها Host interface واسط هاست Host inventory فهرست هاست Host inventory overview نمای کلی فهرست هاست Host IP آدرس هاست Host label type نوع برچسب هاست Host name نام هاست Host networks شبکه‌های هاست Host router مسیریاب هاست Hosts هاست ‌ها Hosts location مکان هاست ها Host subnet mask subnet mask هاست Host time زمان هاست Hours ساعت HTTP authentication احراز هویت HTTP HW architecture ساختار سخت افزار icon نشان Icon نشان Icon (default) نشان (پیش‌فرض) Icon (disabled) نشان(غیرفعال) Icon highlight نشان پررنگ Icon (maintenance) نشان(نگهداری) Icon map نگاشت نشان Icon mapping نگاشت نشان Icon (problem) نشان(مشکل) Icons نشانها ID شناسه image تصویر Image تصویر Images تصاویر Immediately فوری Import وارد کردن Import file واردات پرونده in در Include شامل Info اطلاعات Info اطلاعات Information اطلاعات In maintenance در نگهداری In progress در حال پیشرفت Insert درج Installation نصب Installer name نام نصاب Interface واسط Interval بازه Inventory فهرست IP address آدرس IP IPMI agent عامل IPMI IPMI interfaces واسط های IPMI IPMI sensor سنسور IPMI IP range محدوده IP Item آیتم Item count تعداد آیتم Item prototype نمونه اولیه آیتم Item prototypes نمونه اولیه آیتم ها Items آیتم ها Items list لیست آیتم JMX agent عامل JMX JMX interfaces واسط های JMX Key کلید Label برچسب Label location محل برچسب Language زبان last آخرین last آخرین Last check آخرین بررسی Last hour graph نمودار ساعت گذشته Last month graph نمودار ماه گذشته Last of آخرین از Last seen (age) آخرین مشاهده(سن) Last value آخرین مقدار Last week graph نمودار هفته گذشته Latest data آخرین اطلاعات Left چپ Limit for search and filter results محدودسازی مشخصه های جستجو/فیلتر Line سطر Link پیوند Linked templates پیوندزده به قالب ها Link indicators شاخص پیوند Link to template پیوند به قالب Link to templates پیوند به قالب ها List is empty لیست خالی است Local time زمان محلی Location مکان Location latitude عرض جغرافیایی Location longitude طول جغرافیایی Log ثبت وقایع Login ورود Logout خروج Log time format قالب ثبت زمان Lost از دست‌ رفته‌ Macro ماکرو macro(s) ماکرو(ها) Macros ماکروها Maintenance نگهداری Maintenance period length طول دوره نگه داری Maintenance periods دوره های نگه داری Maintenance type نوع تعمیر و نگه داری <manual> <دستی> Manual دستی map نقشه Map نقشه Mapped to نگاشت شده به Mappings نگاشت Maps نقشه‌ها Mark others انتخاب دیگران Mark selected انتخاب موارد Mass update بروز رسانی کلی max بیشترین Max count of elements to show inside table cell حداکثر تعداد عناصر در جدول Media رسانه Media type نوع رسانه Media types انوع رسانه Members اعضا Message پیام Message پیام Messages پیام Messaging پیام‌رسانی Middle وسط min کمترین Minutes دقیقه Mode حالت Model مدل Mon دوشنبه Monday دوشنبه Monitored by proxy مانیتور شده با پروکسی Monitored host هاست مانیتور شده Monitoring مانیتورینگ Month ماه Month ماه Monthly ماهانه More than 10 minutes بیشتر از 10 دقیقه Multiple PROBLEM events رویدادهای مشکلات چندگانه Mute بی‌صدا Name نام Name نام Network maps نقشه های شبکه Never هرگز New condition شرط جدید New element عنصر جدید New regular expression عبارت منظم جدید No خیر No conditions defined. هیچ no data بدون داده No data collection هیچ شرطی تعریف نشده است No details بدون جزئیات No image بدون تصویر None هیچکدام (no proxy) (بدون پروکسی) No proxy (بدون پروکسی) Normal عادی Normal view نمای عادی‌ Not Ack بدون تأیید No target selected هدف انتخاب نشده No target selected. هدف انتخاب نشده Not available غیرقابل دسترس Not available غیرقابل دسترس Not classified رده بندی نشده Notes یادداشتها Nothing هیچ‌چیز Notification report گزارش آگاه سازی Notifications اخطارها not in نیست در not selected انتخاب نشده Not supported عدم پشتیبانی November نوامبر Number of status changes تعداد حالت‌های تغییر یافته Number of steps تعداد مراحل Number of users (online) تعداد کاربران (در دسترس) Numeric (float) عددی(شناور) Numeric (unsigned) عددی (بیعلامت) October اکتبر of از Off خاموش Ok صحیح Ok صحیح OK صحیح on در On روشن Once یکبار One time only فقط یکبار Operation details جزئیات عملکرد Operations عملکردها Operator عملگر Original اصلی OS سیستم عامل OS (Full details) جزییات کامل سیستم عامل OS (Short) سیستم عامل(خلاصه) other دیگر Other دیگر Other parameters پارامترهای دیگر Others دیگران Overview نمای کلی Parameter پارامتر Parent triggers هشدارهای والد Passive منفعل Password گذز واژه Password (once again) گذرواژه (دوباره) Period دوره Periods دوره ها Period type نوع دوره Permissions مجوزها Persian (fa_IR) فارسی Pie دایره ای Placing algorithm محل الگوریتم Plain text متن ساده Play پخش Play sound پخش صدا Please select two elements لطفاً دو عنصر انتخاب کنید Populates host inventory field قرار گرفتن در فیلد هاست Port پرت Port range محدوده پرت Preview پیش‌نمایش Private key file فابل کلید اختصاصی Privilege level سطح ویژه Problem مشکل Problem مشکل PROBLEM مشکل Problem display نمایش مشکل Problem on نمایش مشکل Problems مشکل Proxies پروکسی ها Proxy پروکسی Public key كليد عمومى Public key file فایل کلید عمومی Queue صف Read خواندن Read only فقط خواندنی Read-write خواندن-نوشتن Received value وقادیر دریافت شده Recipient گیرنده Recipient گیرنده Recovery بازیابی Regular expression عبارت منظم Regular expressions عبارات منظم Remember me for 30 days مرا بخاطر بسپار برای 30 روز Remote command فرمان راه دور Remove حذف Remove from host group حذف از گروه هاست Remove from host groups حذف از گروه های هاست Remove host حذف میزبان‌ Replace جایگزینی Reports گزارشات Required مورد نیاز Required host permissions مجوز هاست مورد نیاز است Required performance (vps) کارایی مورد نیاز(vps) Required server performance, new values per second کارایی مورد نیاز سرور ، مقادیر جدید بر ثانیه Required status codes کدهای وضعیت مورد نیاز Required string رشته مورد نیاز Reset بازنشانی Reset confirmation بازنشاندن تصدیق Reset defaults بازنشانی پیش‌فرضها Resolved رفع شد Resource منبع Response code کد پاسخ Response time زمان پاسخ Result نتیجه Result is FALSE نتیجه غلط است Result is TRUE نتیجه درست است Result type نوع نتیجه Retry سعی مجدد Right راست Rows سطرها Rows per page سطر در صفحه Rules قوانین Sat شنبه Saturday شنبه Scenario سناریو Schedule زمان‌بندی Script اسکریپت Script name نام اسکریپت Scripts اسکریپت ها Search جستجو Search attribute مشخصه‌ی جستجو Select انتخاب Selected انتخاب شده Selected elements عناصر انتخاب شده Select prototype انتخاب نمونه اولیه Send message ارسال پیام Send message to user groups ارسال پیام به گروه کاربران Send message to users ارسال پیام به کاربران Send only to ارسال فقط به Send to ارسال به Sent ارسال‌شده Separated جداشده September سپتامبر Server سرور Server time زمان سرور Service سرویس Service سرویس Service port پرت سرویس Services سرویس ها Service type نوع سرویس Session terminated, re-login, please. جلسه پایان یافت ، لطفاً دوباره وارد شوید Severity جدیت Severity جدیت short description شرح کوتاه Show نمایش Show details نمایش جزئیات Show hosts in maintenance نمایش هاست در دست نگهداری show icon mappings نمایش نشان های نگاشت شده Show legend نمایش فهرست Show lines نمایش خطوط Shown نمایش Show selected نمایش موارد Show text as HTML نمایش متن به عنوان HTML Show triggers نمایش هشدارها Show working time نمایش ساعت کاری Sign in ورود Simple ساده Simple check بررسی ساده Simple graph نمودار ساده Site address A آدرس 1 سایت Site address B آدرس 2 سایت Site address C آدرس 3 سایت Site city شهر سایت Site country کشور سایت Site notes یادداشتهای سایت Site rack location مکان rack سایت Site state / province استان سایت Site ZIP / postal کدپستی سایت SLA سطح سرویس SMS پیام کوتاه SNMP interfaces واسط های SNMP SNMPv1 agent عامل SNMPv1 SNMPv2 agent عامل SNMPv2 SNMPv3 agent عامل SNMPv3 Snooze بعدا Software نرم‌افزار Software application A نرم‌افزار کاربردی الف Software application B نرم‌افزار کاربردی ب Software application C نرم‌افزار کاربردی ج Software application D نرم‌افزار کاربردی د Software application E نرم‌افزار کاربردی ه Software (Full details) نرم‌افزار (جزییات کامل) Sort order (0->999) مرتب سازی(0->999) Source منبع Speed سرعت SSH agent عامل SSH Stacked پشته‌ای Standard items آیتم های استاندارد State حالت Status وضعیت Status وضعیت Status codes کد وضعیت Status of discovery وضعیت کشف Status only فقط وضعیت Step گام Steps مراحل Stop توقف Straight مستقیم Subject موضوع Submap زیر نقشه Success Audit رسیدگی موفق Sun یکشنبه Sunday یکشنبه Support پشتیبانی System default پیش‌فرض سیستم System error. خطای سیستم. Target هدف Target list فهرست هدف Target type نوع هدف TELNET agent عامل TELNET Template قالب Template group گروه قالب Template linkage پیوند قالب Template name نام قالب Templates قالب ها Template trigger هشدار قالب Test آزمایش Test authentication آزمایش احراز هویت Test confirmation آزمایش کردن تأیید Test data آزمایش داده Test string آزمایش رشته Text متن Theme پوسته This month این ماه This week این هفته This year امسال Thu پنجشنبه Thursday پنجشنبه Till تا Time زمان Time زمان Timeout زمان انقضا Time period دوره زمانی Time shift انتقال زمان Timestamp مهر زمان Timestamp مهر زمان Time type نوع زمان To به Today امروز Top بالا Total کل Total کل TOTAL کل Trends روندها trigger هشدار Trigger هشدار Trigger displaying options نمایش گزبنه های هشدار Trigger label type نوع برچسب هشدار Trigger name نام هشدار Trigger overview نمای کلی هشدارها Trigger prototype نمونه اولیه هشدار Trigger prototypes نمونه های اولیه هشدار Triggers هشدارها Trigger severity جدیت هشدار Triggers top 100 100 هشدار بالا TRUE درست Tue سه شنبه Tuesday سه شنبه Type نوع Type نوع Type (Full details) نوع[جزییات کامل] Type of calculation نوع محاسبات Type of information نوع اطلاعات Type (OK) نوع (صحیح) Types انواع Unacknowledged only فقط تأیید نشده Unacknowledged PROBLEM events رویدادهای مشکل تأیید نشده Units واحدها unknown ناشناخته Unknown ناشناخته Unknown ناشناخته UNKNOWN ناشناخته Unknown action فعالیت ناشناخته Unlink حذف پیوند Unlink and clear حذف پیوند و پاک کردن Unlink from template حذف پیوند از قالب Unlink from templates حذف پیوند از قالب ها Unmute وصل صدا Update به‌روزرسانی Update existing بروزرسانی در حال حاضر Update interval فاصله به‌روزرسانی Upload بارگذاری Upper level maps نقشه های سطح بالاتر Uptime زمان کار Uptime زمان کار Uptime/Downtime زمان کار/زمان از کارافتادگی URL نشانی اینترنتی URL A نشانی اینترنتی الف URL (after login) نشانی اینترنتی(بعد از ورود) URL B نشانی اینترنتی ب URL C نشانی اینترنتی ج URLs نشانی های اینترنتی Used in actions استفاده شده در فعالیت Use if severity استفاده برای اهمیت User کار‌بر User group گروه کابر User groups گروه های کابران User name نام کاربری Username نام کاربری User password گذرواژه کاربر User profile پروفایل کاربر Users کاربران User type نوع کاربر value مقدار Value مقدار Value مقدار Value map نگاشت مقدار Value mapping نگاشت مقدار Values مقادیر Variables متغیرها Vendor فروشنده Vertical عمودی Vertical align ردیف کردن عمودی Visible name نام قابل رؤیت Warning اخطار Web وب Web monitoring مانیتورینگ وب Wed چهارشنبه Wednesday چهارشنبه Weekly هفتگی When active وقتی فعال شد Width عرض With data collection با جمع آوری داده Without problems بدون مشکلات Without problems بدون مشکلات Without triggers بدون هشدارها With problems با مشکلات With problems با مشکلات With triggers با هشدارها Working time ساعت کاری Write نوشتن Y axis MAX value حداکثر مقدار محور افقی Y axis MIN value حداکثر مقدار محور عمودی Y axis side سمت محور عمودی Year سال Year سال Yearly سالانه Yes بله You must login to view this page. شما باید وارد شوید تا این صفحه را ببینید Zabbix سپهر فانوس ZABBIX سپهر فانوس Zabbix agent عامل سپهر فانوس Zabbix agent (active) عامل سپهر فانوس (فعال) Zabbix internal Sepehr internal Zabbix internal authentication Sepehr internal authentication Zabbix server سرور سپهر فانوس Zabbix server is running سرور سپهر فانوس در حال اجراست Zabbix server name نام سرور سپهر فانوس Zabbix trapper Sepehr trapper 0 or 1 0 یا 1 %1$d day %1$d روز%1$d روز "%1$s" date must be less than "%2$s" date. تاریخ "%1$s" باید کمتر از تاریخ "%2$s" باشد. "%1$s" instead "%2$s" "%1$s" به جای "%2$s" "%1$s" is expected "%1$s" منتظر است "%1$s" must be an empty string or greater than "%2$s". "%1$s" باید یک رشته خالی یا بزرگتر از "%2$s" باشد. "%1$s" value must be less than or equal to "%2$s" value مقدار "%1$s" باید کمتر یا مساوی با مقدار "%2$s" باشد %1$s (year %2$s) %1$s(سال%2$s) 10 seconds 10 ثانیه 1 minute 1 دقیقه 30 seconds 30 ثانیه 3D view نمایش سه بعدی 500 latest values 500 مقدار اخیر 5 minutes 5 دقیقه 5 seconds 5 ثانیه Access denied! غير قابل دسترسي! Ack تأیید Acknowledge تأیید کردن Acknowledged تأیید شده Acknowledged PROBLEM events تأیید رویدادهای مشکل Action فعالیت ها Action added فعالیت اضافه شد Actions فعالیت ها Action updated فعالیت بروز شد Active فعال Active since فعال از Active till فعال تا Add افزودن Add host افزودن هاست Add prototype افزودن نمونه اولیه Add to host group افزودن به گروه هاست Add to host groups افزودن به گروه هاست ها Admin مدیر Administration مدیریت Advanced labels برچسب های پیشرفته Age سن Age less than سن کمتر از agent عامل Agent عامل Agent interfaces واسط های عامل Alias نام مستعار all همه All همه All links should have "Name" and "URL" specified همه لینک ها باید "نام" و "آدرس" مشخص داشته باشند Allowed hosts هاست ها مجاز Any هیچ Any character string included فاقد رشته کاراکتری Application error. خطای برنامه. Apply اعمال Apr آوریل April آوریل Area size اندازه ناحیه Area type نوع ناحیه as Blue به عنوان آبی as Green به عنوان سبز As plain text به عنوان متن ساده as Red به عنوان قرمز Asset tag برچسب دارایی At (hour:minute) در (ساعت:دقیقه) Audit ممیزی Aug اوت August اوت Authentication تصدیق هویت Authentication algorithm الگوریتم تصدیق هویت Authentication method متد تصدیق هویت Auto-login ورود خودکار Automatic خودکار Automatic icon mapping نگاشت خودکار آیکن Automatic icon selection انتخاب آیکن خودکار Availability دسترسی Availability report گزارش دسترسی Available در دسترس Average متوسط avg میانگین Background پس زمینه Background image تصویر پس زمینه Bind password مقید به کلمه عبور Blocked مسدود شده Bold line خط‌ توپر Bottom پایین By host توسط هاست By trigger template تو سط قالب هشدار Calculated محاسبه کردن Cancel لغو Cannot add action فعالیت نمی تواند اضافه شود Cannot add dependency from a host to a template. وابستگی از یک هاست به یک قالب نمی‌تواند اضافه شود Cannot add discovery rule قانون کشف نمی تواند اضافه شود Cannot add graph نمودار نمی تواند اضافه شود Cannot add group گروه نمی تواند اضافه شود Cannot add host هاست نمی تواند اضافه شود Cannot add image تصویر نمی تواند اضافه شود Cannot add item آیتم نمی تواند اضافه شود Cannot add maintenance دوره نگهداری نمی تواند اضافه شود Cannot add media type نوع رسانه نمی تواند اضافه شود Cannot add network map نقشه شبکه نمی تواند اضافه شود Cannot add proxy پروکسی نمی تواند اضافه شود Cannot add regular expression عبارت منظم نمی تواند اضافه شود Cannot add script اسکریپت نمی تواند اضافه شود Cannot add template قالب نمی تواند اضافه شود Cannot add trigger هشدار نمی تواند اضافه شود Cannot add user کاربر نمی تواند اضافه شود Cannot clear history تاریخچه نمی‌تواند پاک شود Cannot clone graph prototypes. نمونه اولیه نمودارها نمی‌توانند کپی شوند Cannot clone item prototypes. نمونه اولیه آیتم ها نمی‌توانند کپی شوند Cannot clone trigger prototypes. نمونه اولیه هشدارها نمی‌توانند کپی شوند Cannot copy trigger "%1$s:%2$s", because it has multiple hosts in the expression. هشدار "%1$s:%2$s" نمی‌تواند کپی شود ، زیرا چندین هاست در عبارت خود دارد.هشدار "%1$s:%2$s" نمی‌تواند کپی شود ، زیرا چندین هاست در عبارت خود دارد.هشدار "%1$s:%2$s" نمی‌تواند کپی شود ، زیرا چندین هاست در عبارت خود دارد.هشدار "%1$s:%2$s" نمی‌تواند کپی شود ، زیرا چندین هاست در عبارت خود دارد.هشدار "%1$s:%2$s" نمی‌تواند کپی شود ، زیرا چندین هاست در عبارت خود دارد. Cannot create another database connection. اتصال دیگری به پایگاه داده نمی‌توانند ایجاد شود. Cannot create discovery rule قانون کشف نمی‌توانند ایجاد شود. Cannot create icon map نگاشت آیکن نمی‌توانند ایجاد شود. Cannot delete graph نمودار نمی‌تواند حذف شود Cannot delete graphs نمودارها نمی‌توانند حذف شوند Cannot delete host هاست نمی‌تواند حذف شود Cannot delete icon map نگاشت آیکن نمی‌توانند حذف شود Cannot delete image تصویر نمی‌تواند حذف شود Cannot delete inventory. فهرست نمی‌تواند حذف شود. Cannot delete item آیتم نمی‌تواند حذف شود Cannot delete items آیتم ها نمی‌توانند حذف شوند Cannot delete maintenance دوره نگهداری نمی‌تواند حذف شود Cannot delete media type نوع رسانه نمی تواند حذف شود Cannot delete network map نقشه شبکه نمی تواند حذف شود Cannot delete proxy پروکسی نمی تواند حذف شود Cannot delete script اسکریپت نمی تواند حذف شود Cannot delete scripts. Script "%1$s" is used in action operation "%2$s". اسکریپت ها نمی توانند حذف شوند.اسکریپت "%1$s" در عملکرد فعالیت "%2$s" استفاده شده است.اسکریپت ها نمی توانند حذف شوند.اسکریپت "%1$s" در عملکرد فعالیت "%2$s" استفاده شده است.اسکریپت ها نمی توانند حذف شوند.اسکریپت "%1$s" در عملکرد فعالیت "%2$s" استفاده شده است.اسکریپت ها نمی توانند حذف شوند.اسکریپت "%1$s" در عملکرد فعالیت "%2$s" استفاده شده است.اسکریپت ها نمی توانند حذف شوند.اسکریپت "%1$s" در عملکرد فعالیت "%2$s" استفاده شده است. Cannot delete selected actions فعالیت های انتخاب شده نمی‌توانند حذف شوند Cannot delete template قالب نمی تواند حذف شود Cannot delete templated trigger "%1$s:%2$s". هشدارهای قالب شده "%1$s:%2$s" نمی توانند حذف شوند. Cannot delete trigger هشدار نمی‌تواند حذف شود Cannot delete triggers هشدارها نمی‌توانند حذف شوند Cannot delete user کاربر نمی‌تواند حذف شود Cannot find host interface on "%1$s" for item key "%2$s". واسط هاست در "%1$s" برای کلید آیتم "%2$s" پیدا نشد. Cannot link template قالب نمی تواند پیوندزده شود Cannot mass update host name. نام هاست را نمیتوانید دسته‌ای بروز کنید. Cannot mass update visible host name. نام قابل مشاهده هاست را نمیتوانید دسته‌ای بروز کنید. Cannot perform delete statement on table "%1$s" without where condition. دستور حذف برای جدول "%1$s" را نمیتوانید بدون شرط اجرا کنید. Cannot perform update statement on table "%1$s" without values. دستور بروزرسانی برای جدول "%1$s" را نمیتوانید بدون مقدار اجرا کنید. Cannot perform update statement on table "%1$s" without where condition. دستور بروزرسانی برای جدول "%1$s" را نمیتوانید بدون شرط اجرا کنید. Cannot save discovery rule without checks. قانون کشف بدون بررسی را نمیتوانید ذخیره کنید. Cannot unlink template قالب را نمی‌توانید جدا کنید Cannot update action فعالیت نمی‌تواند بروز شود Cannot update configuration پیکر بندی نمی‌تواند بروز شود Cannot update discovery rule قانون کشف نمیتواند بروز شود Cannot update graph نمودار نمی‌تواند بروز شود Cannot update group گروه نمی‌تواند بروز شود Cannot update host هاست نمی‌تواند بروز شود Cannot update hosts هاست ها نمی‌تواند بروز شود Cannot update icon map نگاشت آیکن نمی‌توانند بروز شود. Cannot update image تصویر نمیتواند بروز شود Cannot update item آیتم نمی‌تواند بروز شود Cannot update items آیتم ها نمی‌توانند بروز شوند Cannot update macros ماکرو نمی‌تواند بروز شود Cannot update maintenance دوره نگهداری نمی‌تواند بروز شود Cannot update media type نوع رسانه نمی تواند بروز شود Cannot update network map نقشه شبکه نمی تواند بروز شود Cannot update proxy پروکسی نمی‌تواند بروز شود Cannot update regular expression عبارت منظم نمی تواند بروز شود Cannot update script اسکریپت نمی تواند بروز شود Cannot update template قالب نمی تواند بروز شود Cannot update trigger هشدار نمی‌تواند بروز شود Cannot update user کاربر نمی‌تواند بروز شود Case sensitive حساس به متن Change password تغییر رمز عبور Character کاراکتر Character string included در بر داشتن رشته کاراکتری Character string not included در بر نداشتن رشته کاراکتری Chassis اسکلت Check already exists. بررسی از قبل وجود دارد Check expression part starting from "%1$s". بخش عبارت بررسی از "%1$s" شروع می‌شود. Checks تطبیق ها Checks should be unique. تطبیق ها باید منحصر به فرد باشد. Check the key, please. Default example was passed. لطفاً کلید را بررسی کنید، نمونه پیش ‌فرض پاس داده خواهد شد. Check type نوع تطبیق Clear history and trends پاک کردن تاریخچه و روند ها Clear when unlinking پاک کردن وقتی جدا شد Clock ساعت Clone کپی برداری Close بستن Close expression constructor بستن عبارت سازنده Columns ستون ها Combined result ترکیب کردن نتیجه ها Command فرمان Commands فرمان ها Condition شرط Conditions شروط Configuration پیکربندی Configuration of actions پیکربندی فعالیت ها Configuration of graphs پیکربندی نمودار ها Configuration of items پیکربندی آیتم ها Configuration of network maps پیکربندی نقشه های شبکه Configuration of triggers پیکربندی هشدار ها Configuration updated پیکربندی بروز شد Confirmation text متن تایید Connect to متصل به Contact تماس Contract number شماره تماس Copy رونوشت Count تعداد Create action ایجاد فعالیت Create graph ایجاد نمودار Create icon map ایجاد نگاشت آیکن Create item ایجاد آیتم Create maintenance period ایجاد بازه نگه داری Create map ایجاد نقشه Create media type ایجاد نوع رسانه Create proxy ایجاد پروکسی Create script ایجاد اسکریپت Create trigger ایجاد هشدار Create user ایجاد کاربر Current host هاست فعلی Current value مقدار فعلی Custom graphs نقشه های سفارشی Custom label برچسب سفارشی Custom multiplier تکثیر کننده سفارشی Custom severity names affect all locales and require manual translation! نام درجه اهمیت هشدار ها بر روی ترجمه سیستم تأثیر می گذارد Custom size اندازه سفارشی Daily روزانه Dashboard داشبورد Dashed line خط تیره Database host هاست پایگاه داده Database monitor مانیتور پایگاه داده Database name نام پایگاه داده Database password کلمه عبور پایگاه داده Database port پرت پایگاه داده Database schema شمای پایگاه داده Database server سرور پایگاه داده Database type نوع پایگاه داده Database user کاربر پایگاه داده Data overview نمای کلی Date تاریخ Date HW decommissioned تاریخ کمیسیون سخت افزار Date HW installed تاریخ نصب سخت افزار Date HW maintenance expires تاریخ منقضی شدن تعمیر سخت افزار Date HW purchased تاریخ خرید سخت افزار Day روز Day of month روز از ماه Day of week روز از هفته days روز Days روز %d device %dدستگاه Debug رفع خطا Debug mode حالت رفع خطا December دسامبر default پیش‌فرض Default پیش فرض Default authentication تصدیق هویت پیش فرض Default theme پوسته پیش فرض Delay تاخیر Delayed by تأخیر توسط Delete حذف Delete and clear حذف و پاک کردن Delimiter جداکننده Deny رد کردن Dependencies وابستگی‌ها Dependent وابسته Depends on وابسته به Deployment status وضعیت گسترش Description توصیف Details جزئیات Device uniqueness criteria ضابطه یکتایی دستگاه Disable غیرفعال Disabled غیرفعال‌شده Disable host غیرفعال‌سازی هاست Disable host? غیرفعال‌سازی هاست؟ Disaster حادثه بد Discovered کشف شده Discovered device دستگاه کشف شده Discovery کشف Discovery by proxy کشف با پروکسی Discovery check تطبیق کشف Discovery checks تطبیق کشف Discovery object تطبیق شیء Discovery rule قانون کشف Discovery rules قوانین کشف Discovery status وضعیت کشف Displaying %1$s of %2$s found نمایش %1$s از %2$s پیدا شده Display OK triggers for نمایش هشدار های رفع شده برای Dot نقطه Downtime زمان از کار افتادگی Draw style رسم سبک Duration مدت Dynamic item آیتم پویا Each URL should have a unique name. Please make sure there is only one URL named هر آدرس اینترنتی باید یک نام واحد داشته باشد.لطفاً مطمئن شوید که این آدرس فقط یکبار استفاده شده است.هر آدرس اینترنتی باید یک نام واحد داشته باشد.لطفاً مطمئن شوید که این آدرس فقط یکبار استفاده شده است.هر آدرس اینترنتی باید یک نام واحد داشته باشد.لطفاً مطمئن شوید که این آدرس فقط یکبار استفاده شده است.هر آدرس اینترنتی باید یک نام واحد داشته باشد.لطفاً مطمئن شوید که این آدرس فقط یکبار استفاده شده است.هر آدرس اینترنتی باید یک نام واحد داشته باشد.لطفاً مطمئن شوید که این آدرس فقط یکبار استفاده شده است. Edit ویرایش Element عنصر Element name نام عنصر Email پست الکترونیکی Empty خالی Enable فعال‌سازی Enable confirmation فعال‌سازی تصدیق Enabled فعال‌شده Enable host فعال‌سازی هاست Error خطا Event رویداد Event details جزئیات رویداد Event generation تولید رویداد Event ID شناسه‌ی رویداد Event list [previous 20] لیست رویداد[20 رویداد قبلی] Every day(s) هر روز Every week(s) هر هفته Exclude مانع شدن Execute اجرا Executed script اجرای اسکریپت Execute on اجرا روی Execution confirmation تأیید اجرا Expand single problem بسط دادن یک مشکل Exploded گسترش یافته Export to CSV صدور به CSV Expression عبارت Expression cannot be empty عبارت نمیتواند خالی باشد Expression constructor ساختار عبارت Expressions عبارات Expression type نوع عبارت External check تطبیق خارجی Fail شکست Failed شکست خورد Failure Audit شکست ممیزی FALSE نادرست February فوریه Field فیلد Filled region منطقه پرشده Filter فیلتر Finish پایان Fit to map متناسب با نقشه Fixed ثابت Friday جمعه From از Frontend access دسترسی به واسط کاربری Full clone کپی کامل Function تابع General عمومی Go to برو به Gradient line خط گراديان Graph نمودار Graph prototypes نمونه اولیه گراف Graphs نمودارها Graph sum مجموع گراف Graph type نوع گراف Grid شبکه اى Group گروه Group for discovered hosts گروه برای هاست های کشف شده Grouping by گروه کردن بر اساس Group name نام گروه Groups گروهها GSM modem مودم GSM GUI واسط گرافیکی کاربران GUI access disabled. دسترسی واسط گرافیکی غیرفعال شده است. Hardware سخت افزار Hardware (Full details) سخت افزار (جزییات کامل) Height ارتفاع Help راهنما Hidden پنهان Hide selected مخفی کردن موارد High بالا History تاریخچه Horizontal افقی Horizontal align ردیف کردن افقی host هاست Host access دسترسی هاست Host cannot have more than one default interface of the same type. هاست نمی‌تواند بیشتر از یک واسط پیش فرض داشته باشد. Host count تعداد هاست host group گروه هاست Host group گروه هاست Host group elements عناصر گروه هاست Host group label type نوع برچسب گروه هاست Host groups گروه هاست ها Host interface واسط هاست Host inventory فهرست هاست Host inventory overview نمای کلی فهرست هاست Host IP آدرس هاست Host label type نوع برچسب هاست Host name نام هاست Host networks شبکه‌های هاست Host router مسیریاب هاست Hosts هاست ‌ها Hosts location مکان هاست ها Host subnet mask subnet mask هاست Host time زمان هاست Hours ساعت HTTP authentication احراز هویت HTTP HW architecture ساختار سخت افزار icon نشان Icon نشان Icon (default) نشان (پیش‌فرض) Icon (disabled) نشان(غیرفعال) Icon highlight نشان پررنگ Icon (maintenance) نشان(نگهداری) Icon map نگاشت نشان Icon mapping نگاشت نشان Icon (problem) نشان(مشکل) Icons نشانها ID شناسه image تصویر Image تصویر Images تصاویر Immediately فوری Import وارد کردن Import file واردات پرونده in در Include شامل Info اطلاعات Information اطلاعات In maintenance در نگهداری In progress در حال پیشرفت Insert درج Installation نصب Installer name نام نصاب Interface واسط Interval بازه Inventory فهرست IP address آدرس IP IPMI agent عامل IPMI IPMI interfaces واسط های IPMI IPMI sensor سنسور IPMI IP range محدوده IP Item آیتم Item count تعداد آیتم Item prototype نمونه اولیه آیتم Item prototypes نمونه اولیه آیتم ها Items آیتم ها Items list لیست آیتم JMX agent عامل JMX JMX interfaces واسط های JMX Key کلید Label برچسب Label location محل برچسب Language زبان last آخرین last آخرین Last check آخرین بررسی Last hour graph نمودار ساعت گذشته Last month graph نمودار ماه گذشته Last of آخرین از Last seen (age) آخرین مشاهده(سن) Last value آخرین مقدار Last week graph نمودار هفته گذشته Latest data آخرین اطلاعات Left چپ Limit for search and filter results محدودسازی مشخصه های جستجو/فیلتر Line سطر Link پیوند Linked templates پیوندزده به قالب ها Link indicators شاخص پیوند Link to template پیوند به قالب Link to templates پیوند به قالب ها List is empty لیست خالی است Local time زمان محلی Location مکان Location latitude عرض جغرافیایی Location longitude طول جغرافیایی Log ثبت وقایع Login ورود Logout خروج Log time format قالب ثبت زمان Lost از دست‌ رفته‌ Macro ماکرو macro(s) ماکرو(ها) Macros ماکروها Maintenance نگهداری Maintenance period length طول دوره نگه داری Maintenance periods دوره های نگه داری Maintenance type نوع تعمیر و نگه داری <manual> <دستی> Manual دستی map نقشه Map نقشه Mapped to نگاشت شده به Mappings نگاشت Maps نقشه‌ها Mark others انتخاب دیگران Mark selected انتخاب موارد Mass update بروز رسانی کلی max بیشترین Max count of elements to show inside table cell حداکثر تعداد عناصر در جدول Media رسانه Media type نوع رسانه Media types انوع رسانه Members اعضا Message پیام Messages پیام Messaging پیام‌رسانی Middle وسط min کمترین Minutes دقیقه Mode حالت Model مدل Mon دوشنبه Monday دوشنبه Monitored by proxy مانیتور شده با پروکسی Monitored host هاست مانیتور شده Monitoring مانیتورینگ Month ماه Monthly ماهانه More than 10 minutes بیشتر از 10 دقیقه Multiple PROBLEM events رویدادهای مشکلات چندگانه Mute بی‌صدا Name نام Network maps نقشه های شبکه Never هرگز New condition شرط جدید New element عنصر جدید New regular expression عبارت منظم جدید No خیر No conditions defined. هیچ no data بدون داده No data collection هیچ شرطی تعریف نشده است No details بدون جزئیات No image بدون تصویر None هیچکدام (no proxy) (بدون پروکسی) No proxy (بدون پروکسی) Normal عادی Normal view نمای عادی‌ Not Ack بدون تأیید No target selected هدف انتخاب نشده No target selected. هدف انتخاب نشده Not available غیرقابل دسترس Not classified رده بندی نشده Notes یادداشتها Nothing هیچ‌چیز Notification report گزارش آگاه سازی Notifications اخطارها not in نیست در not selected انتخاب نشده Not supported عدم پشتیبانی November نوامبر Number of status changes تعداد حالت‌های تغییر یافته Number of steps تعداد مراحل Number of users (online) تعداد کاربران (در دسترس) Numeric (float) عددی(شناور) Numeric (unsigned) عددی (بیعلامت) October اکتبر of از Off خاموش Ok صحیح OK صحیح on در On روشن Once یکبار One time only فقط یکبار Operation details جزئیات عملکرد Operations عملکردها Operator عملگر Original اصلی OS سیستم عامل OS (Full details) جزییات کامل سیستم عامل OS (Short) سیستم عامل(خلاصه) other دیگر Other دیگر Other parameters پارامترهای دیگر Others دیگران Overview نمای کلی Parameter پارامتر Parent triggers هشدارهای والد Passive منفعل Password گذز واژه Password (once again) گذرواژه (دوباره) Period دوره Periods دوره ها Period type نوع دوره Permissions مجوزها Persian (fa_IR) فارسی Pie دایره ای Placing algorithm محل الگوریتم Plain text متن ساده Play پخش Play sound پخش صدا Please select two elements لطفاً دو عنصر انتخاب کنید Populates host inventory field قرار گرفتن در فیلد هاست Port پرت Port range محدوده پرت Preview پیش‌نمایش Private key file فابل کلید اختصاصی Privilege level سطح ویژه Problem مشکل PROBLEM مشکل Problem display نمایش مشکل Problem on نمایش مشکل Problems مشکل Proxies پروکسی ها Proxy پروکسی Public key كليد عمومى Public key file فایل کلید عمومی Queue صف Read خواندن Read only فقط خواندنی Read-write خواندن-نوشتن Received value وقادیر دریافت شده Recipient گیرنده Recovery بازیابی Regular expression عبارت منظم Regular expressions عبارات منظم Remember me for 30 days مرا بخاطر بسپار برای 30 روز Remote command فرمان راه دور Remove حذف Remove from host group حذف از گروه هاست Remove from host groups حذف از گروه های هاست Remove host حذف میزبان‌ Replace جایگزینی Reports گزارشات Required مورد نیاز Required host permissions مجوز هاست مورد نیاز است Required performance (vps) کارایی مورد نیاز(vps) Required server performance, new values per second کارایی مورد نیاز سرور ، مقادیر جدید بر ثانیه Required status codes کدهای وضعیت مورد نیاز Required string رشته مورد نیاز Reset بازنشانی Reset confirmation بازنشاندن تصدیق Reset defaults بازنشانی پیش‌فرضها Resolved رفع شد Resource منبع Response code کد پاسخ Response time زمان پاسخ Result نتیجه Result is FALSE نتیجه غلط است Result is TRUE نتیجه درست است Result type نوع نتیجه Retry سعی مجدد Right راست Rows سطرها Rows per page سطر در صفحه Rules قوانین Sat شنبه Saturday شنبه Scenario سناریو Schedule زمان‌بندی Script اسکریپت Script name نام اسکریپت Scripts اسکریپت ها Search جستجو Search attribute مشخصه‌ی جستجو Select انتخاب Selected انتخاب شده Selected elements عناصر انتخاب شده Select prototype انتخاب نمونه اولیه Send message ارسال پیام Send message to user groups ارسال پیام به گروه کاربران Send message to users ارسال پیام به کاربران Send only to ارسال فقط به Send to ارسال به Sent ارسال‌شده Separated جداشده September سپتامبر Server سرور Server time زمان سرور Service سرویس Service port پرت سرویس Services سرویس ها Service type نوع سرویس Session terminated, re-login, please. جلسه پایان یافت ، لطفاً دوباره وارد شوید Severity جدیت short description شرح کوتاه Show نمایش Show details نمایش جزئیات Show hosts in maintenance نمایش هاست در دست نگهداری show icon mappings نمایش نشان های نگاشت شده Show legend نمایش فهرست Show lines نمایش خطوط Shown نمایش Show selected نمایش موارد Show text as HTML نمایش متن به عنوان HTML Show triggers نمایش هشدارها Show working time نمایش ساعت کاری Sign in ورود Simple ساده Simple check بررسی ساده Simple graph نمودار ساده Site address A آدرس 1 سایت Site address B آدرس 2 سایت Site address C آدرس 3 سایت Site city شهر سایت Site country کشور سایت Site notes یادداشتهای سایت Site rack location مکان rack سایت Site state / province استان سایت Site ZIP / postal کدپستی سایت SLA سطح سرویس SMS پیام کوتاه SNMP interfaces واسط های SNMP SNMPv1 agent عامل SNMPv1 SNMPv2 agent عامل SNMPv2 SNMPv3 agent عامل SNMPv3 Snooze بعدا Software نرم‌افزار Software application A نرم‌افزار کاربردی الف Software application B نرم‌افزار کاربردی ب Software application C نرم‌افزار کاربردی ج Software application D نرم‌افزار کاربردی د Software application E نرم‌افزار کاربردی ه Software (Full details) نرم‌افزار (جزییات کامل) Sort order (0->999) مرتب سازی(0->999) Source منبع Speed سرعت SSH agent عامل SSH Stacked پشته‌ای Standard items آیتم های استاندارد State حالت Status وضعیت Status codes کد وضعیت Status of discovery وضعیت کشف Status only فقط وضعیت Step گام Steps مراحل Stop توقف Straight مستقیم Subject موضوع Submap زیر نقشه Success Audit رسیدگی موفق Sun یکشنبه Sunday یکشنبه Support پشتیبانی System default پیش‌فرض سیستم System error. خطای سیستم. Target هدف Target list فهرست هدف Target type نوع هدف TELNET agent عامل TELNET Template قالب Template group گروه قالب Template linkage پیوند قالب Template name نام قالب Templates قالب ها Template trigger هشدار قالب Test آزمایش Test authentication آزمایش احراز هویت Test confirmation آزمایش کردن تأیید Test data آزمایش داده Test string آزمایش رشته Text متن Theme پوسته This month این ماه This week این هفته This year امسال Thu پنجشنبه Thursday پنجشنبه Till تا Time زمان Timeout زمان انقضا Time period دوره زمانی Time shift انتقال زمان Timestamp مهر زمان Time type نوع زمان To به Today امروز Top بالا Total کل TOTAL کل Trends روندها trigger هشدار Trigger هشدار Trigger displaying options نمایش گزبنه های هشدار Trigger label type نوع برچسب هشدار Trigger name نام هشدار Trigger overview نمای کلی هشدارها Trigger prototype نمونه اولیه هشدار Trigger prototypes نمونه های اولیه هشدار Triggers هشدارها Trigger severity جدیت هشدار Triggers top 100 100 هشدار بالا TRUE درست Tue سه شنبه Tuesday سه شنبه Type نوع Type (Full details) نوع[جزییات کامل] Type of calculation نوع محاسبات Type of information نوع اطلاعات Type (OK) نوع (صحیح) Types انواع Unacknowledged only فقط تأیید نشده Unacknowledged PROBLEM events رویدادهای مشکل تأیید نشده Units واحدها unknown ناشناخته Unknown ناشناخته UNKNOWN ناشناخته Unknown action فعالیت ناشناخته Unlink حذف پیوند Unlink and clear حذف پیوند و پاک کردن Unlink from template حذف پیوند از قالب Unlink from templates حذف پیوند از قالب ها Unmute وصل صدا Update به‌روزرسانی Update existing بروزرسانی در حال حاضر Update interval فاصله به‌روزرسانی Upload بارگذاری Upper level maps نقشه های سطح بالاتر Uptime زمان کار Uptime/Downtime زمان کار/زمان از کارافتادگی URL نشانی اینترنتی URL A نشانی اینترنتی الف URL (after login) نشانی اینترنتی(بعد از ورود) URL B نشانی اینترنتی ب URL C نشانی اینترنتی ج URLs نشانی های اینترنتی Used in actions استفاده شده در فعالیت Use if severity استفاده برای اهمیت User کار‌بر User group گروه کابر User groups گروه های کابران User name نام کاربری Username نام کاربری User password گذرواژه کاربر User profile پروفایل کاربر Users کاربران User type نوع کاربر value مقدار Value مقدار Value map نگاشت مقدار Value mapping نگاشت مقدار Values مقادیر Variables متغیرها Vendor فروشنده Vertical عمودی Vertical align ردیف کردن عمودی Visible name نام قابل رؤیت Warning اخطار Web وب Web monitoring مانیتورینگ وب Wed چهارشنبه Wednesday چهارشنبه Weekly هفتگی When active وقتی فعال شد Width عرض With data collection با جمع آوری داده Without problems بدون مشکلات Without triggers بدون هشدارها With problems با مشکلات With triggers با هشدارها Working time ساعت کاری Write نوشتن Y axis MAX value حداکثر مقدار محور افقی Y axis MIN value حداکثر مقدار محور عمودی Y axis side سمت محور عمودی Year سال Yearly سالانه Yes بله You must login to view this page. شما باید وارد شوید تا این صفحه را ببینید Zabbix زبیکس ZABBIX ZABBIX Zabbix agent عامل زبیکس Zabbix agent (active) عامل زبیکس (فعال) Zabbix internal Sepehr internal Zabbix internal authentication Sepehr internal authentication Zabbix server سرور زبیکس Zabbix server is running سرور زبیکس در حال اجراست Zabbix server name نام سرور زبیکس Zabbix trapper Zabbix trapper 0 or 1 0 یا 1 %1$d day %1$d روز%1$d روز %1$s (year %2$s) %1$s(سال%2$s) 10 seconds 10 ثانیه 1 minute 1 دقیقه 30 seconds 30 ثانیه 3D view نمایش سه بعدی 500 latest values 500 مقدار اخیر 5 minutes 5 دقیقه 5 seconds 5 ثانیه Access denied! غير قابل دسترسي! Ack تأیید Acknowledge تأیید کردن Acknowledged تأیید شده Acknowledged PROBLEM events تأیید رویدادهای مشکل Action فعالیت ها Action added فعالیت اضافه شد Actions فعالیت ها Action updated فعالیت بروز شد Active فعال Active since فعال از Active till فعال تا Add افزودن Add host افزودن هاست Add prototype افزودن نمونه اولیه Add to host group افزودن به گروه هاست Add to host groups افزودن به گروه هاست ها Admin مدیر Administration مدیریت Advanced labels برچسب های پیشرفته Age سن Age less than سن کمتر از agent عامل Agent عامل Agent interfaces واسط های عامل Alias نام مستعار all همه All همه All links should have "Name" and "URL" specified همه لینک ها باید "نام" و "آدرس" مشخص داشته باشند Allowed hosts هاست ها مجاز Any هیچ Any character string included فاقد رشته کاراکتری Application error. خطای برنامه. Apply اعمال Apr آوریل April آوریل Area size اندازه ناحیه Area type نوع ناحیه as Blue به عنوان آبی as Green به عنوان سبز As plain text به عنوان متن ساده as Red به عنوان قرمز Asset tag برچسب دارایی At (hour:minute) در (ساعت:دقیقه) Aug اوت August اوت Authentication تصدیق هویت Authentication algorithm الگوریتم تصدیق هویت Authentication method متد تصدیق هویت Auto-login ورود خودکار Automatic خودکار Automatic icon mapping نگاشت خودکار آیکن Automatic icon selection انتخاب آیکن خودکار Availability دسترسی Availability report گزارش دسترسی Available در دسترس Average متوسط avg میانگین Background پس زمینه Background image تصویر پس زمینه Bind password مقید به کلمه عبور Blocked مسدود شده Bold line خط‌ توپر Bottom پایین By host توسط هاست By trigger template تو سط قالب هشدار Calculated محاسبه کردن Cancel لغو Cannot add action فعالیت نمی تواند اضافه شود Cannot add discovery rule قانون کشف نمی تواند اضافه شود Cannot add graph نمودار نمی تواند اضافه شود Cannot add host هاست نمی تواند اضافه شود Cannot add image تصویر نمی تواند اضافه شود Cannot add item آیتم نمی تواند اضافه شود Cannot add media type نوع رسانه نمی تواند اضافه شود Cannot add network map نقشه شبکه نمی تواند اضافه شود Cannot add proxy پروکسی نمی تواند اضافه شود Cannot add regular expression عبارت منظم نمی تواند اضافه شود Cannot add script اسکریپت نمی تواند اضافه شود Cannot add template قالب نمی تواند اضافه شود Cannot add trigger هشدار نمی تواند اضافه شود Cannot add user کاربر نمی تواند اضافه شود Cannot clone graph prototypes. نمونه اولیه نمودارها نمی‌توانند کپی شوند Cannot clone trigger prototypes. نمونه اولیه هشدارها نمی‌توانند کپی شوند Cannot create another database connection. اتصال دیگری به پایگاه داده نمی‌توانند ایجاد شود. Cannot create discovery rule قانون کشف نمی‌توانند ایجاد شود. Cannot create icon map نگاشت آیکن نمی‌توانند ایجاد شود. Cannot delete icon map نگاشت آیکن نمی‌توانند حذف شود Cannot delete image تصویر نمی‌تواند حذف شود Cannot delete inventory. فهرست نمی‌تواند حذف شود. Cannot delete media type نوع رسانه نمی تواند حذف شود Cannot delete proxy پروکسی نمی تواند حذف شود Cannot delete script اسکریپت نمی تواند حذف شود Cannot delete scripts. Script "%1$s" is used in action operation "%2$s". اسکریپت ها نمی توانند حذف شوند.اسکریپت "%1$s" در عملکرد فعالیت "%2$s" استفاده شده است.اسکریپت ها نمی توانند حذف شوند.اسکریپت "%1$s" در عملکرد فعالیت "%2$s" استفاده شده است.اسکریپت ها نمی توانند حذف شوند.اسکریپت "%1$s" در عملکرد فعالیت "%2$s" استفاده شده است.اسکریپت ها نمی توانند حذف شوند.اسکریپت "%1$s" در عملکرد فعالیت "%2$s" استفاده شده است.اسکریپت ها نمی توانند حذف شوند.اسکریپت "%1$s" در عملکرد فعالیت "%2$s" استفاده شده است. Cannot delete templated trigger "%1$s:%2$s". هشدارهای قالب شده "%1$s:%2$s" نمی توانند حذف شوند. Cannot delete user کاربر نمی‌تواند حذف شود Cannot find host interface on "%1$s" for item key "%2$s". واسط هاست در "%1$s" برای کلید آیتم "%2$s" پیدا نشد. Cannot link template قالب نمی تواند پیوندزده شود Cannot mass update host name. نام هاست را نمیتوانید دسته‌ای بروز کنید. Cannot mass update visible host name. نام قابل مشاهده هاست را نمیتوانید دسته‌ای بروز کنید. Cannot perform delete statement on table "%1$s" without where condition. دستور حذف برای جدول "%1$s" را نمیتوانید بدون شرط اجرا کنید. Cannot perform update statement on table "%1$s" without values. دستور بروزرسانی برای جدول "%1$s" را نمیتوانید بدون مقدار اجرا کنید. Cannot perform update statement on table "%1$s" without where condition. دستور بروزرسانی برای جدول "%1$s" را نمیتوانید بدون شرط اجرا کنید. Cannot save discovery rule without checks. قانون کشف بدون بررسی را نمیتوانید ذخیره کنید. Cannot unlink template قالب را نمی‌توانید جدا کنید Cannot update action فعالیت نمی‌تواند بروز شود Cannot update configuration پیکر بندی نمی‌تواند بروز شود Cannot update discovery rule قانون کشف نمیتواند بروز شود Cannot update graph نمودار نمی‌تواند بروز شود Cannot update icon map نگاشت آیکن نمی‌توانند بروز شود. Cannot update image تصویر نمیتواند بروز شود Cannot update macros ماکرو نمی‌تواند بروز شود Cannot update media type نوع رسانه نمی تواند بروز شود Cannot update network map نقشه شبکه نمی تواند بروز شود Cannot update proxy پروکسی نمی‌تواند بروز شود Cannot update regular expression عبارت منظم نمی تواند بروز شود Cannot update script اسکریپت نمی تواند بروز شود Cannot update user کاربر نمی‌تواند بروز شود Case sensitive حساس به متن Change password تغییر رمز عبور Character کاراکتر Character string included در بر داشتن رشته کاراکتری Character string not included در بر نداشتن رشته کاراکتری Chassis اسکلت Check already exists. بررسی از قبل وجود دارد Check expression part starting from "%1$s". بخش عبارت بررسی از "%1$s" شروع می‌شود. Checks تطبیق ها Checks should be unique. تطبیق ها باید منحصر به فرد باشد. Check the key, please. Default example was passed. لطفاً کلید را بررسی کنید، نمونه پیش ‌فرض پاس داده خواهد شد. Check type نوع تطبیق Clear history and trends پاک کردن تاریخچه و روند ها Clear when unlinking پاک کردن وقتی جدا شد Clock ساعت Clone کپی برداری Close بستن Close expression constructor بستن عبارت سازنده Columns ستون ها Combined result ترکیب کردن نتیجه ها Command فرمان Commands فرمان ها Condition شرط Conditions شروط Configuration پیکربندی Configuration of actions پیکربندی فعالیت ها Configuration of graphs پیکربندی نمودار ها Configuration of items پیکربندی آیتم ها Configuration of network maps پیکربندی نقشه های شبکه Configuration of triggers پیکربندی هشدار ها Configuration updated پیکربندی بروز شد Confirmation text متن تایید Connect to متصل به Contact تماس Contract number شماره تماس Copy رونوشت Count تعداد Create action ایجاد فعالیت Create graph ایجاد نمودار Create icon map ایجاد نگاشت آیکن Create item ایجاد آیتم Create maintenance period ایجاد بازه نگه داری Create map ایجاد نقشه Create media type ایجاد نوع رسانه Create proxy ایجاد پروکسی Create script ایجاد اسکریپت Create trigger ایجاد هشدار Create user ایجاد کاربر Current host هاست فعلی Current value مقدار فعلی Custom graphs نقشه های سفارشی Custom label برچسب سفارشی Custom multiplier تکثیر کننده سفارشی Custom severity names affect all locales and require manual translation! نام درجه اهمیت هشدار ها بر روی ترجمه سیستم تأثیر می گذارد Custom size اندازه سفارشی Daily روزانه Dashboard داشبورد Dashed line خط تیره Database host هاست پایگاه داده Database monitor مانیتور پایگاه داده Database name نام پایگاه داده Database password کلمه عبور پایگاه داده Database port پرت پایگاه داده Database schema شمای پایگاه داده Database server سرور پایگاه داده Database type نوع پایگاه داده Database user کاربر پایگاه داده Data overview نمای کلی Date تاریخ Date HW decommissioned تاریخ کمیسیون سخت افزار Date HW installed تاریخ نصب سخت افزار Date HW maintenance expires تاریخ منقضی شدن تعمیر سخت افزار Date HW purchased تاریخ خرید سخت افزار Day روز Day of month روز از ماه Day of week روز از هفته days روز Days روز %d device %dدستگاه Debug رفع خطا Debug mode حالت رفع خطا December دسامبر default پیش‌فرض Default پیش فرض Default authentication تصدیق هویت پیش فرض Default theme پوسته پیش فرض Delay تاخیر Delayed by تأخیر توسط Delete حذف Delete and clear حذف و پاک کردن Delimiter جداکننده Deny رد کردن Dependencies وابستگی‌ها Dependent وابسته Depends on وابسته به Deployment status وضعیت گسترش Description توصیف Details جزئیات Device uniqueness criteria ضابطه یکتایی دستگاه Disable غیرفعال Disabled غیرفعال‌شده Disable host غیرفعال‌سازی هاست Disable host? غیرفعال‌سازی هاست؟ Disaster حادثه بد Discovered کشف شده Discovered device دستگاه کشف شده Discovery کشف Discovery by proxy کشف با پروکسی Discovery check تطبیق کشف Discovery checks تطبیق کشف Discovery object تطبیق شیء Discovery rule قانون کشف Discovery rules قوانین کشف Discovery status وضعیت کشف Displaying %1$s of %2$s found نمایش %1$s از %2$s پیدا شده Display OK triggers for نمایش هشدار های رفع شده برای Dot نقطه Downtime زمان از کار افتادگی Draw style رسم سبک Duration مدت Each URL should have a unique name. Please make sure there is only one URL named هر آدرس اینترنتی باید یک نام واحد داشته باشد.لطفاً مطمئن شوید که این آدرس فقط یکبار استفاده شده است.هر آدرس اینترنتی باید یک نام واحد داشته باشد.لطفاً مطمئن شوید که این آدرس فقط یکبار استفاده شده است.هر آدرس اینترنتی باید یک نام واحد داشته باشد.لطفاً مطمئن شوید که این آدرس فقط یکبار استفاده شده است.هر آدرس اینترنتی باید یک نام واحد داشته باشد.لطفاً مطمئن شوید که این آدرس فقط یکبار استفاده شده است.هر آدرس اینترنتی باید یک نام واحد داشته باشد.لطفاً مطمئن شوید که این آدرس فقط یکبار استفاده شده است. Edit ویرایش Element عنصر Element name نام عنصر Email پست الکترونیکی Enable فعال‌سازی Enable confirmation فعال‌سازی تصدیق Enabled فعال‌شده Enable host فعال‌سازی هاست Error خطا Event رویداد Event details جزئیات رویداد Event generation تولید رویداد Event ID شناسه‌ی رویداد Event list [previous 20] لیست رویداد[20 رویداد قبلی] Every day(s) هر روز Every week(s) هر هفته Exclude مانع شدن Execute اجرا Executed script اجرای اسکریپت Execute on اجرا روی Execution confirmation تأیید اجرا Expand single problem بسط دادن یک مشکل Exploded گسترش یافته Export to CSV صدور به CSV Expression عبارت Expression cannot be empty عبارت نمیتواند خالی باشد Expression constructor ساختار عبارت Expressions عبارات Expression type نوع عبارت External check تطبیق خارجی Fail شکست Failed شکست خورد Failure Audit شکست ممیزی FALSE نادرست February فوریه Field فیلد Filled region منطقه پرشده Filter فیلتر Finish پایان Fit to map متناسب با نقشه Fixed ثابت Friday جمعه From از Frontend access دسترسی به واسط کاربری Function تابع General عمومی Go to برو به Gradient line خط گراديان Graph نمودار Graph prototypes نمونه اولیه گراف Graphs نمودارها Graph sum مجموع گراف Graph type نوع گراف Grid شبکه اى Group گروه Group for discovered hosts گروه برای هاست های کشف شده Grouping by گروه کردن بر اساس Group name نام گروه Groups گروهها GSM modem مودم GSM GUI واسط گرافیکی کاربران GUI access disabled. دسترسی واسط گرافیکی غیرفعال شده است. Hardware سخت افزار Hardware (Full details) سخت افزار (جزییات کامل) Height ارتفاع Help راهنما h:i A H:i Hidden پنهان Hide selected مخفی کردن موارد High بالا h:i:s A H:i:s History تاریخچه Horizontal افقی Horizontal align ردیف کردن افقی host هاست Host access دسترسی هاست Host cannot have more than one default interface of the same type. هاست نمی‌تواند بیشتر از یک واسط پیش فرض داشته باشد. Host count تعداد هاست host group گروه هاست Host group گروه هاست Host group elements عناصر گروه هاست Host group label type نوع برچسب گروه هاست Host groups گروه هاست ها Host interface واسط هاست Host inventory فهرست هاست Host inventory overview نمای کلی فهرست هاست Host IP آدرس هاست Host label type نوع برچسب هاست Host name نام هاست Host networks شبکه‌های هاست Host router مسیریاب هاست Hosts هاست ‌ها Hosts location مکان هاست ها Host subnet mask subnet mask هاست Host time زمان هاست Hours ساعت HTTP authentication احراز هویت HTTP HW architecture ساختار سخت افزار icon نشان Icon نشان Icon (default) نشان (پیش‌فرض) Icon (disabled) نشان(غیرفعال) Icon highlight نشان پررنگ Icon (maintenance) نشان(نگهداری) Icon map نگاشت نشان Icon mapping نگاشت نشان Icon (problem) نشان(مشکل) Icons نشانها ID شناسه image تصویر Image تصویر Images تصاویر Immediately فوری Import وارد کردن Import file واردات پرونده in در Include شامل Info اطلاعات Information اطلاعات In maintenance در نگهداری In progress در حال پیشرفت Insert درج Installation نصب Installer name نام نصاب Interface واسط Interval بازه Inventory فهرست IP address آدرس IP IPMI agent عامل IPMI IPMI interfaces واسط های IPMI IPMI sensor سنسور IPMI IP range محدوده IP Item آیتم Item count تعداد آیتم Item prototype نمونه اولیه آیتم Item prototypes نمونه اولیه آیتم ها Items آیتم ها Items list لیست آیتم JMX agent عامل JMX JMX interfaces واسط های JMX Key کلید Label برچسب Label location محل برچسب Language زبان last آخرین last آخرین Last check آخرین بررسی Last hour graph نمودار ساعت گذشته Last month graph نمودار ماه گذشته Last of آخرین از Last seen (age) آخرین مشاهده(سن) Last value آخرین مقدار Last week graph نمودار هفته گذشته Latest data آخرین اطلاعات Left چپ Limit for search and filter results محدودسازی مشخصه های جستجو/فیلتر Line سطر Link پیوند Linked templates پیوندزده به قالب ها Link indicators شاخص پیوند List is empty لیست خالی است Local time زمان محلی Location مکان Location latitude عرض جغرافیایی Location longitude طول جغرافیایی Log ثبت وقایع Login ورود Logout خروج Log time format قالب ثبت زمان Lost از دست‌ رفته‌ Macro ماکرو macro(s) ماکرو(ها) Macros ماکروها Maintenance نگهداری Maintenance period length طول دوره نگه داری Maintenance periods دوره های نگه داری Maintenance type نوع تعمیر و نگه داری <manual> <دستی> Manual دستی map نقشه Map نقشه Mapped to نگاشت شده به Mappings نگاشت Maps نقشه‌ها Mark others انتخاب دیگران Mark selected انتخاب موارد Mass update بروز رسانی کلی max بیشترین Max count of elements to show inside table cell حداکثر تعداد عناصر در جدول m-d h:i A m-d H:i Media رسانه Media type نوع رسانه Media types انوع رسانه Members اعضا Message پیام Messages پیام Messaging پیام‌رسانی Middle وسط min کمترین Minutes دقیقه Mode حالت Model مدل Mon دوشنبه Monday دوشنبه Monitored by proxy مانیتور شده با پروکسی Monitored host هاست مانیتور شده Monitoring مانیتورینگ Month ماه Monthly ماهانه More than 10 minutes بیشتر از 10 دقیقه Multiple PROBLEM events رویدادهای مشکلات چندگانه Mute بی‌صدا Name نام n-d h:i A n-d H:i Network maps نقشه های شبکه Never هرگز New condition شرط جدید New element عنصر جدید New regular expression عبارت منظم جدید No خیر no data بدون داده No data collection هیچ شرطی تعریف نشده است No details بدون جزئیات No image بدون تصویر None هیچکدام (no proxy) (بدون پروکسی) No proxy (بدون پروکسی) Normal عادی Normal view نمای عادی‌ Not Ack بدون تأیید Not available غیرقابل دسترس Not classified رده بندی نشده Notes یادداشتها Nothing هیچ‌چیز Notification report گزارش آگاه سازی Notifications اخطارها not in نیست در not selected انتخاب نشده Not supported عدم پشتیبانی November نوامبر Number of steps تعداد مراحل Number of users (online) تعداد کاربران (در دسترس) Numeric (float) عددی(شناور) Numeric (unsigned) عددی (بیعلامت) October اکتبر of از Off خاموش Ok صحیح OK صحیح on در On روشن Once یکبار One time only فقط یکبار Operation details جزئیات عملکرد Operations عملکردها Operator عملگر Original اصلی OS سیستم عامل OS (Full details) جزییات کامل سیستم عامل OS (Short) سیستم عامل(خلاصه) other دیگر Other دیگر Other parameters پارامترهای دیگر Others دیگران Overview نمای کلی Parameter پارامتر Parent triggers هشدارهای والد