en-us	#### Element tags  Element tag values are explained in the table below.
fa	#### برچسب های عنصر  مقادیر تگ عنصر در جدول زیر توضیح داده شده است.

en-us	#### Element tags  Element tag values are explained in the table below.
fa	#### برچسب های عنصر  مقادیر تگ عنصر در جدول زیر توضیح داده شده است.

en-us	#### 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 } ```
fa	#### فعال سازی هاست  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 } ```

en-us	#### 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 } ```
fa	####اکشن  را غیرفعال کنید  عملکرد را غیرفعال کنید، یعنی وضعیت آن را روی "1" تنظیم کنید.  درخواست:  ``json {     "jsonrpc": "2.0"،     "روش": "action.update"،     "params": {         "actionid": "2"،         "وضعیت": "1"     }،     "auth": "038e1d7b1735c6a5436ee9eae095879e"،     "id": 1 } ```  واکنش:  ``json {     "jsonrpc": "2.0"،     "نتیجه": {         "actionids": [             "2"         ]     }،     "id": 1 } ```

en-us	#### 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 } ```
fa	#### فعال سازی وب سناریو   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 } ```

en-us	#### 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 } ```
fa	####غیرفعال کردن نمونه اولیه هاست   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 } ```

en-us	#### 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 } ```
fa	####غیرفعال کردن نمونه اولیه هاست   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 } ```

en-us	#### 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 } ```
fa	#### فعال سازی وب سناریو   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 } ```

en-us	### Enabling high availability
fa	### فعال کردن در دسترس بودن بالا

en-us	#### 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 } ```
fa	#### فعال سازی چندین هاست   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 } ```

en-us	#### 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.
fa	#### تنظیمات رمزگذاری  برای اطمینان از اینکه داده های به دست آمده خراب نیستند، می توانید آن را مشخص کنید رمزگذاری صحیح برای پردازش چک (به عنوان مثال "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 وجود نداشته باشد - استاندارد     وضوح (به بالا مراجعه کنید) به جای آن اعمال می شود.

en-us	#### Error messages  ODBC error messages are structured into fields to provide detailed information. For example:      Cannot execute ODBC query: [SQL_ERROR]:[42601][7][ERROR: syntax error at or near ";"; Error while executing the query]     └───────────┬───────────┘  └────┬────┘ └──┬──┘└┬┘└─────────────────────────────┬─────────────────────────────────────┘                 │                   │         │    └─ Native error code            └─ Native error message                 │                   │         └─ SQLState                 └─ Zabbix message   └─ ODBC return code  Note that the error message length is limited to 2048 bytes, so the message can be truncated. If there is more than one ODBC diagnostic record Zabbix tries to concatenate them (separated with `|`) as far as the length limit allows.
fa	#### پیغام خطا  پیام های خطای ODBC در فیلدهایی برای ارائه جزئیات ساختار بندی شده اند اطلاعات مثلا:      نمی توان پرس و جوی ODBC را اجرا کرد: [SQL_ERROR]:[42601][7][ERROR: خطای نحوی در یا نزدیک به ";"; خطا در اجرای پرس و جو]     └───────────┬───────- ┬──┘└┬┘└─── ────────────────── ────────── ──────────────┘                 │ │ │ └─ کد خطای بومی └─ پیام خطای بومی                 │ │ └─ SQLState                 └─ پیام Zabbix └─ کد برگشتی ODBC  توجه داشته باشید که طول پیام خطا به 2048 بایت محدود شده است، بنابراین پیام را می توان کوتاه کرد. اگر بیش از یک تشخیص ODBC وجود داشته باشد ضبط Zabbix سعی می کند آنها را تا آنجا که با «|» جدا شده است به هم متصل کند محدودیت طول اجازه می دهد.

en-us	# event.acknowledge
fa	# تایید رویداد 

en-us	##### 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
fa	##### همبستگی رویداد  همبستگی رویداد (همبستگی رویداد جهانی نیز نامیده می شود) راهی برای تنظیم است قوانین بسته شدن رویداد سفارشی (که منجر به تولید رویداد OK می شود).  قوانین نحوه جفت شدن رویدادهای مشکل جدید با موجود را تعریف می کنند رویدادهای مشکل ساز و اجازه می دهد تا رویداد جدید یا رویدادهای منطبق توسط ایجاد رویدادهای OK مربوطه.  با این حال، همبستگی رویداد باید بسیار با دقت پیکربندی شود، همانطور که می تواند بر عملکرد پردازش رویداد تأثیر منفی می گذارد یا در صورت پیکربندی اشتباه، رویدادهای بیشتری از آنچه در نظر گرفته شده را ببندید (در بدترین حالت حتی همه مشکلات رویدادها می توانند بسته شوند). چند نکته برای پیکربندی:  1. همیشه دامنه همبستگی را با تنظیم یک برچسب منحصر به فرد برای آن کاهش دهید     رویداد را کنترل کنید (رویدادی که با رویدادهای قدیمی جفت شده است) و از آن استفاده کنید     شرط همبستگی "برچسب رویداد جدید". 2. فراموش نکنید که هنگام استفاده، یک شرط بر اساس رویداد قدیمی اضافه کنید     عملیات "بستن رویداد قدیمی" یا تمام مشکلات موجود می تواند باشد     بسته 3. از استفاده از نام تگ های رایج که توسط همبستگی های مختلف استفاده می شود خودداری کنید     پیکربندی

en-us	# event.get
fa	دریافت رخداد 

en-us	# > Event object  The following objects are directly related to the `event` API.
fa	# > آبکت رویداد   The following objects are directly related to the `event` API.

en-us	### 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.|
fa	### تگ رویداد  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.|

en-us	# 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
fa	# رویداد  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

en-us	### Example
fa	### مثال

en-us	##### 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).
fa	##### مثال 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).

en-us	##### 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).
fa	##### مثال 11  بررسی کنید که آیا زمان محلی مشتری با زمان سرور Zabbix همگام است یا خیر.  استفاده از تابع fuzzytime():      fuzzytime(/MySQL_DB/system.localtime,10s)=0  در صورت روشن بودن زمان محلی، ماشه به حالت مشکل تغییر می کند سرور MySQL\_DB و سرور Zabbix بیش از 10 ثانیه با هم تفاوت دارند. توجه داشته باشید که "system.localtime" باید به عنوان یک [غیرفعال] پیکربندی شود بررسی کنید](/دستی/ضمیمه/items/activepassive#passive_checks).

en-us	##### 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.
fa	##### مثال 12  مقایسه میانگین بار امروز با میانگین بار در همان زمان دیروز (با استفاده از تغییر زمان به عنوان "اکنون-1d").      avg(/server/system.cpu.load,1h)/avg(/server/system.cpu.load,1h:now-1d)>2  این ماشه در صورتی که میانگین بار ساعت گذشته از آن بالاتر برود فعال می شود میانگین بار در همان ساعت دیروز بیش از دو بار.

en-us	##### 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.
fa	##### مثال 13  استفاده از مقدار یک مورد دیگر برای به دست آوردن آستانه ماشه:      last(/Template PfSense/hrStorageFree[{#SNMPVALUE}])<last(/Template PfSense/hrStorageSize[{#SNMPVALUE}])*0.1  اگر فضای ذخیره‌سازی رایگان به کمتر از 10 درصد برسد، ماشه فعال می‌شود.

en-us	##### 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.
fa	##### مثال 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  اگر حداقل دو ماشه در عبارت بیان شوند، ماشه فعال می شود در وضعیت مشکل قرار دارند

en-us	##### 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])
fa	##### مثال 15  مقایسه مقادیر رشته دو مورد - عملوندها در اینجا توابعی هستند که رشته های برگشتی  مشکل: در صورتی که نسخه اوبونتو متفاوت است، هشدار ایجاد کنید میزبان ها      last(/NY Zabbix server/vfs.file.contents[/etc/os-release])<>last(/LA Zabbix server/vfs.file.contents[/etc/os-release])

en-us	##### 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.
fa	##### مثال 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_}.  به نقل قول های اطراف عملوند دوم توجه کنید.

en-us	##### 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}
fa	##### مثال 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}

en-us	##### 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.
fa	##### مثال 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)})  همچنین امکان بستن دستی در پیکربندی ماشه مفید است این نوع مشکل

en-us	##### 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
fa	##### مثال 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

en-us	##### 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'
fa	##### مثال 1  یه چیز خیلی ساده:      UserParameter=ping[*],echo $1  ما ممکن است تعداد نامحدودی از آیتم ها را برای نظارت بر همه فرمت ها تعریف کنیم پینگ\[چیزی\].  - ping\[0\] - همیشه '0' برمی گردد - ping\[aaa\] - همیشه "aaa" برمی‌گردد

en-us	##### Example 1  Temperature in server room is too high.  Problem expression:      last(/server/temp)>20  Recovery expression:      last(/server/temp)<=15
fa	##### مثال 1  دمای اتاق سرور خیلی بالاست.  بیان مسئله:      last(/server/temp)> 20  عبارت بازیابی:      last(/server/temp)<=15

en-us	##### 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.
fa	##### مثال 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 است.

en-us	##### Example 1  Total disk space of host group 'MySQL Servers'.      sum(last_foreach(/*/vfs.fs.size[/,total]?[group="MySQL Servers"]))
fa	##### مثال 1  فضای دیسک کل گروه میزبان «سرورهای MySQL».      sum(last_foreach(/*/vfs.fs.size[/,total]?[group="MySQL Servers"]))

en-us	##### 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
fa	##### مثال 2  فضای آزاد دیسک خیلی کم است.  بیان مشکل: برای 5 دقیقه آخر کمتر از 10 گیگابایت است      max(/server/vfs.fs.size[/,free],5m)<10G  بیان بازیابی: بیش از 40 گیگابایت برای 10 دقیقه گذشته است      min(/server/vfs.fs.size[/,free],10m)>40G

en-us	##### 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]
fa	##### مثال 2  بیایید حس بیشتری اضافه کنیم!      UserParameter=mysql.ping[*],mysqladmin -u$1 -p$2 پینگ | grep -c زنده  این پارامتر می تواند برای نظارت بر در دسترس بودن MySQL استفاده شود پایگاه داده ما می توانیم نام کاربری و رمز عبور را ارسال کنیم:      mysql.ping[zabbix,our_password]

en-us	##### 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|
fa	##### مثال 2  نظارت بر زمان کار:  |پارامتر|توضیحات| |--|--------| |**OID**|MIB::sysUpTime.0| |**Key**|router.uptime| |**نوع مقدار**|Float| |**واحدها**|آپتایم| |**مرحله پیش پردازش: ضرب کننده سفارشی**|0.01|

en-us	##### Example 2  Sum of latest values of all items matching net.if.in\[\*\] on the host.      sum(last_foreach(/host/net.if.in[*]))
fa	##### مثال 2  مجموع آخرین مقادیر همه موارد مطابق با net.if.in\[\*\] در میزبان.      sum(last_foreach(/host/net.if.in[*]))

en-us	##### 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.
fa	##### مثال 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 بوده است.

en-us	##### Example 3  Average processor load of host group 'MySQL Servers'.      avg(last_foreach(/*/system.cpu.load[,avg1]?[group="MySQL Servers"]))
fa	##### مثال 1  فضای دیسک کل گروه میزبان «سرورهای MySQL».      sum(last_foreach(/*/vfs.fs.size[/,total]?[group="MySQL Servers"]))

en-us	##### 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.
fa	##### مثال 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 و غیره.

en-us	##### 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]
fa	##### مثال 3  چند خط با یک عبارت منظم در یک فایل مطابقت دارد؟      UserParameter=wc[*],grep -c "$2" $1  از این پارامتر می توان برای محاسبه تعداد خطوط یک فایل استفاده کرد.      wc[/etc/passwd,root]     wc[/etc/services,zabbix]

en-us	##### 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))
fa	##### مثال 4  میانگین 5 دقیقه تعداد پرس و جو در ثانیه برای گروه میزبان "سرورهای MySQL".      avg(avg_foreach(/*/mysql.qps?[group="MySQL Servers"]،5m))

en-us	##### 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.
fa	##### مثال 4  شخصی در حال دانلود یک فایل بزرگ از اینترنت است.  استفاده از تابع min:      min(/www.example.com/net.if.in[eth0,bytes],5m)>100K  این عبارت زمانی درست است که تعداد بایت های دریافتی روی eth0 بیشتر باشد بیش از 100 کیلوبایت در 5 دقیقه گذشته

en-us	##### 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")]))
fa	##### مثال 5  میانگین بار CPU در همه میزبان ها در چندین گروه میزبان که دارای این هستند برچسب های خاص      avg(last_foreach(/*/system.cpu.load?[(group="Servers A" or group="Servers B" or group="Servers C") and (tag="Service:" or tag="اهمیت: بالا")]))

en-us	##### 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.
fa	##### مثال 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.

en-us	##### 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"])) 
fa	##### مثال 6  محاسبه استفاده شده بر روی آخرین مجموع ارزش آیتم کل گروه میزبان.      sum(last_foreach(/*/net.if.out[eth0,bytes]?[group="video"])) / sum(last_foreach(/*/nginx_stat.sh[active]?[group="video"]) )

en-us	##### 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.
fa	##### مثال 6  عامل Zabbix باید ارتقا یابد.  استفاده از تابع find():      find(/example.example.com/agent.version,"like","beta8")=1  اگر عامل Zabbix نسخه beta8 داشته باشد، این عبارت درست است.

en-us	##### 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.
fa	##### مثال 7  سرور غیر قابل دسترسی است      count(/example.example.com/impping,30m,"0")>5  اگر میزبان "example.example.com" بیشتر غیرقابل دسترسی باشد، عبارت درست است بیش از 5 بار در 30 دقیقه گذشته.

en-us	##### Example 7  The total number of unsupported items in host group 'Zabbix servers'.      sum(last_foreach(/*/zabbix[host,,items_unsupported]?[group="Zabbix servers"]))
fa	##### مثال 7  تعداد کل موارد پشتیبانی نشده در گروه میزبان "سرورهای Zabbix".      sum(last_foreach(/*/zabbix[host,,items_unsupported]?[group="servers Zabbix"]))

en-us	##### 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.
fa	##### مثال 8  بدون ضربان قلب در 3 دقیقه گذشته  استفاده از تابع nodata():      nodata(/example.example.com/tick,3m)=1  برای استفاده از این ماشه، 'تیک' باید به عنوان Zabbix تعریف شود [trapper](/manual/config/items/itemtypes/trapper) مورد. میزبان باید به صورت دوره ای داده های این مورد را با استفاده از zabbix\_sender ارسال کنید. اگر داده ای وجود ندارد دریافت شده در عرض 180 ثانیه، مقدار ماشه مشکل می شود.  *توجه داشته باشید* که 'nodata' را می توان برای هر نوع موردی استفاده کرد.

en-us	##### 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).
fa	##### مثال 9  فعالیت CPU در شب  استفاده از تابع زمان():      min(/Zabbix server/system.cpu.load[all,avg1],5m)>2 and time()<060000  ماشه ممکن است فقط در شب (00:00 - 06:00) حالت خود را به مشکل تغییر دهد.

en-us	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
fa	مثالی از استفاده از کنترل زمان اجرا برای بارگذاری مجدد پیکربندی سرور حافظه پنهان:      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

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	### Examples
fa	### مثال ها

en-us	#### Examples
fa	### مثال ها

en-us	 ##### 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.
fa	 ##### نمونه هایی از نحو صحیح/نادرست  عبارات (از جمله فراخوانی تابع) را نمی توان به عنوان تاریخچه، روند، یا پارامترهای 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))  نمی توان تضمین کرد که هر دو بخش معادله همیشه دارای مجموعه ای از مقادیر یکسان باشند. در حالی که یک قسمت از عبارت ارزیابی می شود، مقدار جدیدی برای دوره درخواستی ممکن است وارد شود و سپس قسمت دیگر عبارت دارای مجموعه ای متفاوت از مقادیر خواهد بود.

en-us	##### 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.
fa	##### نمونه هایی از پارامترهای ساده کاربر  یک دستور ساده:      UserParameter=پینگ، اکو 1  نماینده همیشه برای یک آیتم با کلید "پینگ" "1" را برمی گرداند.  مثال پیچیده تر:      UserParameter=mysql.ping,mysqladmin -uroot ping | grep -c زنده  اگر سرور MySQL زنده باشد، نماینده '1' را برمی گرداند - در غیر این صورت.

en-us	#### Examples of triggers
fa	#### نمونه هایی از محرک ها

en-us	### 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 } ```
fa	### مثال ها   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 } ```

en-us	### 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 } ```
fa	### مثال ها   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 } ```

en-us	### 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 } ```
fa	### مثال ها   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 } ```

en-us	### 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 } ```
fa	### مثال ها   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 } ```

en-us	### 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 } ```
fa	###مثال ها   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 } ```

en-us	### 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 } ```
fa	### مثال ها   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 } ```

en-us	### 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 } ```
fa	### مثال ها   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 } ```

en-us	### 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).
fa	### مثال ها  هدف مثال‌های زیر فقط تشریح پیکربندی اشیاء فیلد ویجت داشبورد برای ویجت *نمای کلی داده* است. برای اطلاعات بیشتر در مورد پیکربندی داشبورد، به [`dashboard.create`](/manual/api/reference/dashboard/create) مراجعه کنید.

en-us	### 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).
fa	### مثال ها  هدف مثال‌های زیر فقط تشریح پیکربندی اشیاء فیلد ویجت داشبورد برای ویجت *نمای کلی داده* است. برای اطلاعات بیشتر در مورد پیکربندی داشبورد، به [`dashboard.create`](/manual/api/reference/dashboard/create) مراجعه کنید.

en-us	## 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}
fa	## مثال ها  **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}

en-us	## EXAMPLES  **zabbix\_js -s script-file.js -p example** [ ]{#lbAG}
fa	## مثال ها  **zabbix\_js -s script-file.js -p مثال** [ ]{#lbAG}

en-us	## 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}
fa	## مثال ها  **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}

en-us	#### 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.
fa	#### کد خروج  قبل از نسخه 2.2 عامل Zabbix در صورت خروج موفقیت آمیز 0 را برمی گرداند و 255 در صورت خرابی. شروع از نسخه 2.2 و بالاتر Zabbix عامل در صورت خروج موفقیت آمیز 0 و در صورت شکست 1 برمی گرداند.

en-us	## 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}
fa	## وضعیت خروج  اگر مقادیر ارسال شده باشند و همه آنها ارسال شده باشند، وضعیت خروج 0 است با موفقیت توسط سرور پردازش شد. اگر داده ها ارسال شد، اما پردازش در حداقل یکی از مقادیر ناموفق، وضعیت خروج 2 است. در صورت ارسال داده ها ناموفق، وضعیت خروج 1 است.  [ ]{#lbAH}

en-us	##### 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.
fa	##### فرمت صادرات  داده ها را می توان با استفاده از صفحه وب Zabbix یا [Zabbix صادر کرد API](/دستی/api/reference/configuration). فرمت های صادراتی پشتیبانی شده هستند YAML، XML و JSON.

en-us	#### 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 } ```
fa	#### ساخت هاست    پیکربندی یک میزبان را به عنوان یک رشته 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 } ```

en-us	#### 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
fa	#### خروجی گرفتن   برای خروجی گرفتن از هاست ها مراحل زیر راانجام دهید :  -   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

en-us	#### 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
fa	#### خروجی گرفتن   برای خروجی گرفتن  قالب ها، موارد زیر را انجام دهید:  - به: *پیکربندی* → *قالب*ها بروید - چک باکس های الگوهای صادراتی را علامت بزنید - روی *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

en-us	#### 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
fa	#### خروجی گرفتن   برای خروجی گرفتن  قالب ها، موارد زیر را انجام دهید:  - به: *پیکربندی* → *قالب*ها بروید - چک باکس های الگوهای صادراتی را علامت بزنید - روی *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

en-us	#### 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
fa	#### خروجی گرفتن   برای خروجی گرفتن  قالب ها، موارد زیر را انجام دهید:  - به: *پیکربندی* → *قالب*ها بروید - چک باکس های الگوهای صادراتی را علامت بزنید - روی *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

en-us	 ###### 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"]}
fa	 ###### درخواست صادرات  درخواستی برای اجرای تابع Export رابط صادرکننده.  | | | |---|---| |جهت|عامل → افزونه| |پاسخ|نه|  پارامترهای خاص برای درخواست صادرات:  |نام|نوع|نظر| |---------|--------|----------| |کلید|رشته|کلید افزونه.| |پارامترها|آرایه رشته ها (اختیاری)|پارامترهای تابع Export.|  *مثال:*      {"id":4,"type":6,"key":"test.key","parameters":["foo","bar"]}

en-us	 ###### 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"}
fa	 ###### پاسخ صادرات  پاسخ از تابع صادرات رابط صادرکننده.  | | | |---|---| |جهت|پلاگین → عامل| |پاسخ|عدم|  پارامترهای خاص برای پاسخ های صادراتی:  |نام|نوع|نظر| |---------|--------|----------| | مقدار | رشته (اختیاری) | مقدار پاسخ از تابع Export. وجود ندارد، در صورت بازگشت خطا.| |error|string (اختیاری) |پیام خطا در صورتی که تابع Export با موفقیت اجرا نشده باشد. وجود ندارد، در صورت بازگشت مقدار.|  *مثال ها:*      {"id":5,"type":7,"value":"response"}  یا      {"id":5,"type":7,"error":"پیام خطا"}

en-us	#### 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)
fa	#### معیارهای در معرض  آیتم های آماری آمار را به صورت انبوه جمع آوری می کنند و یک 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")

en-us	#### Expressions with unknown operands  Generally an unknown operand (such as an unsupported item) in the expression will immediately render the trigger value to `Unknown`.  However, in some cases unknown operands (unsupported items, function errors) are admitted into expression evaluation:  -   The `nodata()` function is evaluated regardless of whether the referenced item is supported or not. -   Logical expressions with OR and AND can be evaluated to known values     in two cases regardless of unknown operands:     -   **Case 1**: "`1 or some_function(unsupported_item1) or some_function(unsupported_item2) or ...`" can be evaluated to known result ('1' or "Problem"),     -   **Case 2**: "`0 and some_function(unsupported_item1) and some_function(unsupported_item2) and ...`" can be evaluated to known result ('0' or "OK").\         Zabbix tries to evaluate such logical expressions by taking unsupported         items as unknown operands. In the two cases above a known value will be produced ("Problem" or "OK", respectively); in **all other** cases the trigger will evaluate to `Unknown`. -   If the function evaluation for a supported item results in error, the     function value becomes `Unknown` and it takes part as unknown operand      in further expression evaluation.  Note that unknown operands may "disappear" only in logical expressions as described above. In arithmetic expressions unknown operands always lead to the result `Unknown` (except division by 0).  ::: noteimportant An expression that results in `Unknown` does not change the trigger state ("Problem/OK").  So, if it was "Problem" (see Case 1), it stays in the same problem state even if the known  part is resolved ('1' becomes '0'), because the expression is now evaluated to `Unknown`  and that does not change the trigger state. :::  If a trigger expression with several unsupported items evaluates to `Unknown` the error message in the frontend refers to the last unsupported item evaluated.
fa	#### عبارات با عملوندهای ناشناخته  به طور کلی یک عملوند ناشناخته (مانند یک آیتم پشتیبانی نشده) در عبارت بلافاصله مقدار ماشه را به «ناشناس» تبدیل می کند.  با این حال، در برخی موارد، عملوندهای ناشناخته (موارد پشتیبانی نشده، خطاهای تابع) در ارزیابی عبارت پذیرفته می شوند:  - تابع 'nodata()' بدون توجه به اینکه آیا مورد ارجاع شده پشتیبانی می شود یا خیر ارزیابی می شود. - عبارات منطقی با OR و AND را می توان به مقادیر شناخته شده ارزیابی کرد     در دو مورد بدون توجه به عملوندهای ناشناخته:     - **مورد 1**: "'1 or some_function(unsupported_item1) or some_function(unsupported_item2) یا ..." را می توان به نتیجه شناخته شده ('1' یا "Problem") ارزیابی کرد.     - **مورد 2**: "0 and some_function(unsupported_item1) and some_function(unsupported_item2) and..." را می توان تا نتیجه شناخته شده ('0' یا "OK") ارزیابی کرد.\         Zabbix سعی می کند چنین عبارات منطقی را با گرفتن پشتیبانی نشده ارزیابی کند         موارد به عنوان عملوندهای ناشناخته در دو مورد بالا یک مقدار شناخته شده تولید خواهد شد (به ترتیب "مشکل" یا "OK"). در **همه موارد دیگر**، ماشه به "ناشناخته" ارزیابی می شود. - اگر ارزیابی عملکرد برای یک مورد پشتیبانی شده منجر به خطا شود،     مقدار تابع به "ناشناخته" تبدیل می شود و به عنوان عملوند ناشناخته شرکت می کند     در ارزیابی بیان بیشتر  توجه داشته باشید که عملوندهای ناشناخته ممکن است فقط در عبارات منطقی به عنوان "ناپدید" شوند در بالا توضیح داده شد. در عبارات حسابی عملوندهای ناشناخته همیشه منجر به نتیجه «ناشناخته» (به جز تقسیم بر 0).  ::: نکته مهم عبارتی که منجر به "ناشناخته" می شود، وضعیت ماشه را تغییر نمی دهد ("مشکل/OK"). بنابراین، اگر "مشکل" بود (به مورد 1 مراجعه کنید)، در همان حالت مشکل باقی می ماند حتی اگر معلوم باشد بخش حل می شود ('1' تبدیل به '0' می شود)، زیرا عبارت اکنون به 'Unknown' ارزیابی می شود و این حالت ماشه را تغییر نمی دهد. :::  اگر عبارت ماشه ای با چندین مورد پشتیبانی نشده ارزیابی شود پیام خطای «ناشناخته» در قسمت جلویی به آخرین مورد اشاره دارد مورد پشتیبانی نشده ارزیابی شد.

en-us	#### 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.
fa	#### استخراج بخش منطبق از عبارت منظم  گاهی اوقات ممکن است بخواهیم فقط مقدار جالب را از 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\]+)**.  و با قابلیت استخراج و برگرداندن عدد، مقدار می تواند باشد برای تعریف محرک ها استفاده می شود.

en-us	### 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 ```
fa	### Failover به گره آماده به کار  اگر گره فعال متوقف شود، Zabbix به طور خودکار به گره دیگری با شکست مواجه می شود. آنجا باید حداقل یک گره در وضعیت آماده به کار باشد تا failover اتفاق بیفتد.  سرعت شکست چقدر خواهد بود؟ همه گره ها آخرین زمان دسترسی خود را به روز می کنند (و وضعیت، اگر هر 5 ثانیه تغییر می کند. بنابراین:  - اگر گره فعال خاموش شود و بتواند وضعیت خود را گزارش دهد به عنوان "توقف"، یک گره دیگر در عرض **5 ثانیه **.  - اگر گره فعال بدون امکان به روز رسانی خاموش شود/در دسترس نباشد وضعیت آن، گره‌های آماده به کار منتظر خواهند ماند تا **تأخیر شکست** + 5 ثانیه آن را کنترل کند  تأخیر شکست قابل تنظیم است و محدوده پشتیبانی شده بین 10 تا 15 ثانیه است دقیقه (به طور پیش فرض یک دقیقه). برای تغییر تاخیر شکست، می توانید اجرا کنید:  ``` zabbix_server -R ha_set_failover_delay=5m ```

en-us	##### - File locations  -   Configuration files are located in **/etc/zabbix**. -   Zabbix server, proxy and agent logfiles are located in     **/var/log/zabbix**. -   Zabbix frontend is located in **/usr/share/zabbix**. -   Home directory for the user **zabbix** is **/var/lib/zabbix**.
fa	##### - مکان های فایل  - فایل های پیکربندی در **/etc/zabbix** قرار دارند. - فایل های لاگ سرور، پروکسی و عامل Zabbix در آن قرار دارند     ***/var/log/zabbix**. - ظاهر Zabbix در **/usr/share/zabbix** واقع شده است. - فهرست اصلی برای کاربر **zabbix** **/var/lib/zabbix** است.

en-us	## FILES  */usr/local/etc/zabbix\_agent2.conf*   Default location of Zabbix agent 2 configuration file (if not modified during compile time).  [ ]{#lbAH}
fa	## فایل ها  */usr/local/etc/zabbix\_agent2.conf* محل پیش‌فرض فایل پیکربندی عامل Zabbix 2 (در صورت عدم تغییر در طول زمان کامپایل).  [ ]{#lbAH}

en-us	## FILES  */usr/local/etc/zabbix\_agentd.conf*   Default location of Zabbix agent configuration file (if not modified during compile time).  [ ]{#lbAI}
fa	## فایل ها  */usr/local/etc/zabbix\_agent2.conf* محل پیش‌فرض فایل پیکربندی عامل Zabbix 2 (در صورت عدم تغییر در طول زمان کامپایل).  [ ]{#lbAH}

en-us	## FILES  */usr/local/etc/zabbix\_proxy.conf*   Default location of Zabbix proxy configuration file (if not modified during compile time).  [ ]{#lbAI}
fa	## فایل ها  */usr/local/etc/zabbix\_agent2.conf* محل پیش‌فرض فایل پیکربندی عامل Zabbix 2 (در صورت عدم تغییر در طول زمان کامپایل).  [ ]{#lbAH}

en-us	## FILES  */usr/local/etc/zabbix\_server.conf*   Default location of Zabbix server configuration file (if not modified during compile time).  [ ]{#lbAI}
fa	## فایل ها  */usr/local/etc/zabbix\_server.conf* محل پیش‌فرض فایل پیکربندی سرور Zabbix (در صورت عدم تغییر در طول زمان کامپایل).  [ ]{#lbAI}

en-us	## FILES  */usr/local/etc/zabbix\_web\_service.conf*   Default location of Zabbix web service configuration file (if not modified during compile time).  [ ]{#lbAG}
fa	## فایل ها  */usr/local/etc/zabbix\_web\_service.conf* محل پیش‌فرض فایل پیکربندی وب سرویس Zabbix (اگر نه در طول زمان کامپایل اصلاح شد).  [ ]{#lbAG}

en-us	#### Filter  A filter can be used to generate real items, triggers, and graphs only for entities that match the criteria. The **Filters** tab contains discovery rule filter definitions allowing to filter discovery values:  ![](../../../assets/en/manual/discovery/low_level_discovery/lld_fs_d.png)  |Parameter|Description| |--|--------| |*Type of calculation*|The following options for calculating filters are available:<br>**And** - all filters must be passed;<br>**Or** - enough if one filter is passed;<br>**And/Or** - uses *And* with different macro names and *Or* with the same macro name;<br>**Custom expression** - offers the possibility to define a custom calculation of filters. The formula must include all filters in the list. Limited to 255 symbols.| |*Filters*|The following filter condition operators are available: *matches*, *does not match*, *exists*, *does not exist*.<br>*Matches* and *does not match* operators expect a [Perl Compatible Regular Expression](https://en.wikipedia.org/wiki/Perl_Compatible_Regular_Expressions) (PCRE). For instance, if you are only interested in C:, D:, and E: file systems, you could put {\#FSNAME} into "Macro" and "\^C\|\^D\|\^E" regular expression into "Regular expression" text fields. Filtering is also possible by file system types using {\#FSTYPE} macro (e.g. "\^ext\|\^reiserfs") and by drive types (supported only by Windows agent) using {\#FSDRIVETYPE} macro (e.g., "fixed").<br>You can enter a regular expression or reference a global [regular expression](/manual/regular_expressions) in "Regular expression" field.<br>In order to test a regular expression you can use "grep -E", for example: ````for f in ext2 nfs reiserfs smbfs; do echo $f | grep -E '^ext|^reiserfs' || echo "SKIP: $f"; done```` <br><br> {\#FSDRIVETYPE} macro on Windows is supported since Zabbix **3.0.0**.<br><br>*Exists* and *does not exist* operators allow to filter entities based on the presence or absence of the specified LLD macro in the response (supported since version 5.4.0).<br>Defining several filters is supported since Zabbix **2.4.0**.<br>Note that if a macro from the filter is missing in the response, the found entity will be ignored, unless a "does not exist" condition is specified for this macro.<br><br>A warning will be displayed, if the absence of a macro affects the expression result. For example, if {#B} is missing in:<br>{#A} matches 1 and {#B} matches 2 - will give a warning<br>{#A} matches 1 or {#B} matches 2 - no warning.<br>This flexible warning logic is supported since Zabbix 6.0.11.|  ::: notewarning A mistake or a typo in the regular expression used in the LLD rule (for example, an incorrect "File systems for discovery" regular expression) may cause deletion of thousands of configuration elements, historical values, and events for many hosts.  :::  ::: noteimportant Zabbix database in MySQL must be created as case-sensitive if file system names that differ only by case are to be discovered correctly. :::
fa	#### فیلتر  از یک فیلتر می توان فقط برای تولید آیتم های واقعی، محرک ها و نمودارها استفاده کرد برای نهادهایی که با معیارها مطابقت دارند. برگه **فیلترها** شامل تعریف فیلتر قانون کشف که امکان فیلتر کردن مقادیر کشف را فراهم می کند:  ![](../../../assets/en/manual/discovery/low_level_discovery/lld_fs_d.png)  |پارامتر|توضیحات| |--|--------| |*نوع محاسبه*|گزینه های زیر برای محاسبه فیلترها موجود است:<br>**و** - همه فیلترها باید عبور داده شوند؛<br>**یا** - اگر یک فیلتر رد شود کافی است؛<br> **And/Or** - از *And* با نام‌های ماکرو مختلف و *Or* با همان نام ماکرو استفاده می‌کند؛<br>**عبارت سفارشی** - امکان تعریف یک محاسبه سفارشی از فیلترها را ارائه می‌دهد. فرمول باید شامل تمام فیلترهای موجود در لیست باشد. محدود به 255 نماد.| |*فیلترها*|عملگرهای شرایط فیلتر زیر در دسترس هستند: *تطابق*، *تطابق ندارد*، *وجود*، *وجود ندارد*.<br>*تطابق* و *تطابق ندارد* عملگرها انتظار دارند [Perl Compatible Regular Expression](https://en.wikipedia.org/wiki/Perl_Compatible_Regular_Expressions) (PCRE). به عنوان مثال، اگر شما فقط به سیستم های فایل C:، D:، و E: علاقه دارید، می توانید {\#FSNAME} را در "Macro" و "\^C\|\^D\|\^E" به طور منظم قرار دهید. عبارت در فیلدهای متنی "عبارت منظم". فیلتر کردن بر اساس انواع سیستم فایل با استفاده از {\#FSTYPE} ماکرو (مثلاً "\^ext\|\^reiserfs") و انواع درایو (فقط توسط عامل Windows پشتیبانی می‌شود) با استفاده از ماکرو {\#FSDRIVETYPE (به عنوان مثال،" امکان‌پذیر است. ثابت است").<br>شما می توانید یک عبارت منظم وارد کنید یا به یک [عبارت منظم](/manual/regular_expressions) در فیلد "Regular expression" ارجاع دهید.<br>برای آزمایش یک عبارت منظم می توانید از "grep - استفاده کنید. E، به عنوان مثال: ``` برای f در ext2 nfs reiserfs smbfs; انجام echo $f | grep -E '^ext|^reiserfs' || echo "SKIP: $f"; done```` <br><br> ماکرو {\#FSDRIVETYPE} در ویندوز از Zabbix **3.0.0** پشتیبانی می شود.<br><br>*وجود دارد* و *وجود ندارد* اپراتورها اجازه فیلتر کردن را می دهند موجودیت ها بر اساس وجود یا عدم وجود ماکرو LLD مشخص شده در پاسخ (از نسخه 5.4.0 پشتیبانی می شود).<br>تعریف چندین فیلتر از Zabbix **2.4.0** پشتیبانی می شود.<br>توجه داشته باشید که اگر یک ماکرو از آنجایی که فیلتر در پاسخ وجود ندارد، موجودیت یافت شده نادیده گرفته می شود، مگر اینکه یک شرط "وجود وجود ندارد" برای این ماکرو مشخص شده باشد.<br><br>اگر نبود ماکرو بر روی آن تاثیر بگذارد، یک هشدار نمایش داده می شود. نتیجه بیان برای مثال، اگر {#B} در موارد زیر وجود نداشته باشد:<br>{#A} منطبق‌های 1 و {#B} منطبق‌های 2 - اخطار می‌دهد<br>{#A} منطبق‌های 1 یا {#B} منطبق‌های 2 - بدون هشدار.<br>این منطق هشدار انعطاف پذیر از Zabbix 6.0.11 پشتیبانی می شود.|  ::: هشدار یک اشتباه یا یک اشتباه تایپی در عبارت منظم استفاده شده در قانون LLD (به عنوان مثال، "سیستم های فایل برای کشف" نادرست بیان منظم) ممکن است باعث حذف هزاران پیکربندی شود عناصر، ارزش های تاریخی، و رویدادها برای بسیاری از میزبانان. :::  ::: نکته مهم پایگاه داده Zabbix در MySQL باید به عنوان ایجاد شود در صورتی که نام های سیستم فایلی که فقط بر اساس حروف کوچک و بزرگ متفاوت هستند، حساس به حروف بزرگ و کوچک باشد به درستی کشف کرد :::

en-us	##### 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.|
fa	##### دکمه های فیلتر  | | | |--|--------| |![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)|پارامترهای برگه را با پارامترهای مشخص شده فعلی جایگزین کنید. در برگه اصلی موجود نیست.|

en-us	#### Filter expression  The filter expression is an arithmetical expression in infix notation.  Supported operands:  |Operand|Description|Example| |--|------|------| |`"<text>"`<br>`'<text>'`|Text constant.|'value: \\'1\\''<br>"value: '1'"| |`<number>`|Numeric constant supporting scientific notation.|123| |`<jsonpath starting with $>`|Value referred to by the JSONPath from the input document root node; only definite paths are supported.|$.object.name| |`<jsonpath starting with @>`|Value referred to by the JSONPath from the current object/element; only definite paths are supported.|@.name|  Supported operators:  |Operator|Type|Description|Result| |--|--------|----|----| |`-`|binary|Subtraction.|Number.| |`+`|binary|Addition.|Number.| |`/`|binary|Division.|Number.| |`*`|binary|Multiplication.|Number.| |`==`|binary|Is equal to.|Boolean (1 or 0).| |`!=`|binary|Is not equal to.|Boolean (1 or 0).| |`<`|binary|Is less than.|Boolean (1 or 0).| |`<=`|binary|Is less than or equal to.|Boolean (1 or 0).| |`>`|binary|Is greater than.|Boolean (1 or 0).| |`>=`|binary|Is greater than or equal to.|Boolean (1 or 0).| |`=~`|binary|Matches regular expression.|Boolean (1 or 0).| |`!`|unary|Boolean not.|Boolean (1 or 0).| |`||`|binary|Boolean or.|Boolean (1 or 0).| |`&&`|binary|Boolean and.|Boolean (1 or 0).|
fa	#### عبارت فیلتر  عبارت فیلتر یک عبارت حسابی در نماد infix است.  عملوندهای پشتیبانی شده:  |عملکرد|توضیح|مثال| |--|------|------| |`"<text>"`<br>`'<text>'`|متن ثابت.|'مقدار: \\'1\\''<br>"مقدار: '1'"| |`<تعداد>`|ثابت عددی پشتیبان نماد علمی.|123| |`<jsonpath با $>`|مقدار ارجاع شده توسط JSONPath از گره اصلی سند ورودی. فقط مسیرهای معین پشتیبانی می شوند.|$.object.name| |`<jsonpath با @>`|مقدار ارجاع شده توسط JSONPath از شی/عنصر فعلی. فقط مسیرهای معین پشتیبانی می شوند.|@.name|  اپراتورهای پشتیبانی شده:  |اپراتور|نوع|توضیح|نتیجه| |--|--------|----|----| |`-`|دودویی|تفریق.|عدد.| |`+`|دودویی|افزودن.|تعداد.| |`/`|دودویی|تقسیم.|تعداد.| |`*`|دودویی|ضرب.|تعداد.| |`==`|دودویی|برابر است با.|بولی (1 یا 0).| |`!=`|دودویی|برابر نیست.|بولی (1 یا 0).| |`<`|دودویی|کمتر از.|بولی (1 یا 0).| |`<=`|دودویی|کمتر یا مساوی با.|بولی (1 یا 0).| |`>`|دودویی|بزرگتر از.|بولی (1 یا 0).| |`>=`|دودویی|بزرگتر یا مساوی است با.|بولی (1 یا 0).| |`=~`|دودویی|با عبارت منظم مطابقت دارد.|بولی (1 یا 0).| |`!`|یوناری|بولی نه.|بولی (1 یا 0).| |`||`|دودویی|بولی یا.|بولی (1 یا 0).| |`&&`|دودویی|بولی و.|بولی (1 یا 0).|

en-us	#### 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 } ```
fa	#### مورد عامل 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 } ```

en-us	#### 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 } ```
fa	#### نمونه اولیه آیتم عامل 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 } ```

en-us	#### 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 } ```
fa	#### پیدا کردن آیتم وابسته  یک مورد وابسته برای مورد با شناسه "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 } ```

en-us	#### 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 } ```
fa	#### پیدا کردن آیتم های وابسته با کلید  همه موارد وابسته را از میزبان با شناسه "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 } ```

en-us	#### 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 } ```
fa	#### 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 } ```

en-us	#### - Firewall  By default, only the ports listed in the [configuration changes](#firewall_configuration) above are open. To open additional ports, modify "*/etc/sysconfig/iptables*" file and reload firewall rules:      systemctl reload iptables
fa	#### - دیواره آتش  به طور پیش فرض، فقط پورت های فهرست شده در [پیکربندی تغییرات](#firewall_configuration) در بالا باز هستند. برای باز کردن اضافی پورت ها، فایل "*/etc/sysconfig/iptables*" را تغییر دهید و فایروال را دوباره بارگیری کنید قوانین:      systemctl بارگذاری مجدد iptables

en-us	##### - Firewall configuration  The appliance uses iptables firewall with predefined rules:  -   Opened SSH port (22 TCP); -   Opened Zabbix agent (10050 TCP) and Zabbix trapper (10051 TCP)     ports; -   Opened HTTP (80 TCP) and HTTPS (443 TCP) ports; -   Opened SNMP trap port (162 UDP); -   Opened outgoing connections to NTP port (53 UDP); -   ICMP packets limited to 5 packets per second; -   All other incoming connections are dropped.
fa	##### - پیکربندی فایروال  این دستگاه از فایروال iptables با قوانین از پیش تعریف شده استفاده می کند:  - پورت SSH باز (22 TCP)؛ - عامل Zabbix باز (10050 TCP) و Zabbix Trapper (10051 TCP)     پورت ها؛ - پورت های HTTP (80 TCP) و HTTPS (443 TCP) را باز کرد. - پورت تله SNMP باز (162 UDP)؛ - اتصالات خروجی به پورت NTP (53 UDP) باز شد. - بسته های ICMP محدود به 5 بسته در ثانیه. - تمام اتصالات ورودی دیگر قطع می شوند.

en-us	#### 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. :::
fa	#### پارامترهای کاربر انعطاف پذیر  پارامترهای کاربر انعطاف پذیر پارامترها را با کلید می پذیرند. به این ترتیب الف پارامتر کاربر انعطاف پذیر می تواند مبنایی برای ایجاد چندین آیتم باشد.  پارامترهای کاربر انعطاف پذیر دارای نحو زیر هستند:      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) اسناد برای یک لیست کامل :::

en-us	### 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.|
fa	### تاریخچه 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.|

en-us	##### 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.
fa	##### پانویسها و منابع  ^**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 کامپایل شده باشد حمایت کردن. در غیر این صورت مورد پشتیبانی نمی شود.

en-us	##### Footnotes  ^**1**^ Default value.
fa	##### پانویسها و منابع  ^**1**^ مقدار پیش فرض.

en-us	##### 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.
fa	##### پانویسها و منابع  ^**1**^ برای مقادیر رشته، فقط رشته صادر خواهد شد (به عنوان مثال. "ZABBIX\_ACTIVE") بدون شماره گذاری استفاده شده در این جدول. شماره برای مقادیر محدوده (مرتبط با مقادیر API) در این جدول استفاده شده است فقط برای سفارش

en-us	##### 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.
fa	##### پانویسها و منابع  ^**1**^ برای مقادیر رشته، فقط رشته صادر خواهد شد (به عنوان مثال. "ZABBIX\_ACTIVE") بدون شماره گذاری استفاده شده در این جدول. شماره برای مقادیر محدوده (مرتبط با مقادیر API) در این جدول استفاده شده است فقط برای سفارش

en-us	##### 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.
fa	##### پانویسها و منابع  ^**1**^ برای مقادیر رشته، فقط رشته صادر خواهد شد (به عنوان مثال. "ZABBIX\_ACTIVE") بدون شماره گذاری استفاده شده در این جدول. شماره برای مقادیر محدوده (مرتبط با مقادیر API) در این جدول استفاده شده است فقط برای سفارش

en-us	##### 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 "\*\*\*\*\*\*".
fa	##### پانویسها و منابع  ^**1**^ اگر چند ماکرو در یک فیلد یا ماکروهای مخلوط شده با متن نباشند برای مکان پشتیبانی می شود، یک ماکرو واحد باید کل فیلد را پر کند.  ^**2**^ ماکروهای استفاده شده در نام ها و مقادیر برچسب ها فقط در طول فرآیند تولید رویداد حل می شوند.  ^**3**^ URLهایی که حاوی [مخفی است macro](/manual/config/macros/user_macros#configuration) کار نخواهد کرد، زیرا ماکرو موجود در آنها به صورت "\*\*\*\*\*\*" حل می شود.

en-us	#### - Format-specific notes
fa	#### - یادداشت های فرمت خاص

en-us	#### Form buttons  Buttons at the bottom of the form allow to perform several operations.  |   |   | |--|--------| |![](../../../assets/en/manual/config/button_add.png)|Add a discovery rule. This button is only available for new discovery rules.| |![](../../../assets/en/manual/config/button_update.png)|Update the properties of a discovery rule. This button is only available for existing discovery rules.| |![](../../../assets/en/manual/config/button_clone.png)|Create another discovery rule based on the properties of the current discovery rule.| |![](../../../assets/en/manual/config/button_check_now.png)|Perform discovery based on the discovery rule immediately. The discovery rule must already exist. See [more details](/manual/config/items/check_now).<br>*Note* that when performing discovery immediately, configuration cache is not updated, thus the result will not reflect very recent changes to discovery rule configuration.| |![](../../../assets/en/manual/config/button_delete.png)|Delete the discovery rule.| |![](../../../assets/en/manual/config/button_cancel.png)|Cancel the editing of discovery rule properties.|
fa	#### دکمه های فرم  دکمه های پایین فرم امکان انجام چندین عملیات را فراهم می کند.  | | | |--|--------| |![](../../../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_check_now.png)| کشف را بر اساس قانون کشف فوراً انجام دهید. قانون کشف باید از قبل وجود داشته باشد. به [جزئیات بیشتر](/manual/config/items/check_now) مراجعه کنید.<br>*توجه داشته باشید* که هنگام انجام سریع کشف، حافظه پنهان پیکربندی به‌روزرسانی نمی‌شود، بنابراین نتیجه تغییرات بسیار اخیر در پیکربندی قانون کشف را نشان نمی‌دهد.| |![](../../../assets/en/manual/config/button_delete.png)|قانون کشف را حذف کنید.| |![](../../../assets/en/manual/config/button_cancel.png)|ویرایش ویژگی های قانون کشف را لغو کنید.|

en-us	##### 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.|
fa	##### دکمه های فرم  دکمه های پایین فرم امکان انجام چندین عملیات را فراهم می کند.  | | | |--|--------| |![](../../../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)|ویرایش ویژگی های گزارش را لغو کنید.|

en-us	#### 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|
fa	#### 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|

en-us	## Frontend
fa	## Frontend

en-us	#### - Frontend access  By default, access to the frontend is allowed from anywhere.  The frontend can be accessed at *http://<host>*.  This can be customized in **/etc/nginx/conf.d/zabbix.conf**. Nginx has to be restarted after modifying this file. To do so, log in using SSH as **root** user and execute:      systemctl restart nginx
fa	#### - دسترسی Frontend  به‌طور پیش‌فرض، دسترسی به فرانت‌اند از هر جایی مجاز است.  بخش ظاهری در *http://<host>* قابل دسترسی است.  این را می توان در **/etc/nginx/conf.d/zabbix.conf** سفارشی کرد. Nginx دارد پس از اصلاح این فایل دوباره راه اندازی می شود. برای انجام این کار، با استفاده از SSH as وارد شوید **روت** کاربر و اجرا:      systemctl nginx را ریستارت کنید

en-us	#### 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'] = '';     ...
fa	#### 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

en-us	#### 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
fa	#### 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

en-us	#### Frontend  To enable encryption with full 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  Note that *Database host verification* is checked and grayed out - this step cannot be skipped for MySQL.   ::: notewarning  Cipher list should be empty, so that frontend and server can negotiate required one from the supported by both ends. :::  ![](../../../../../assets/en/manual/appendix/install/encrypt_db_verify_full1.png){width="600"}  Alternatively, this can be set in */etc/zabbix/web/zabbix.conf.php*:      ...     // Used for TLS connection with strictly defined Cipher list.     $DB['ENCRYPTION'] = true;     $DB['KEY_FILE'] = '/etc/ssl/mysql/client-key.pem';     $DB['CERT_FILE'] = '/etc/ssl/mysql/client-cert.pem';     $DB['CA_FILE'] = '/etc/ssl/mysql/ca.pem';     $DB['VERIFY_HOST'] = true;     $DB['CIPHER_LIST'] = 'TLS_AES_256_GCM_SHA384:TLS_CHACHA20_POLY1305_SHA256:TLS_AES_128_GCM_SHA256:TLS_AES_128_CCM_SHA256:ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES128-SHA256:ECDHE-RSA-AES128-SHA256:ECDHE-RSA-AES256-GC';     ...     // or     ...     // Used for TLS connection without Cipher list defined - selected by MySQL server     $DB['ENCRYPTION'] = true;     $DB['KEY_FILE'] = '/etc/ssl/mysql/client-key.pem';     $DB['CERT_FILE'] = '/etc/ssl/mysql/client-cert.pem';     $DB['CA_FILE'] = '/etc/ssl/mysql/ca.pem';     $DB['VERIFY_HOST'] = true;     $DB['CIPHER_LIST'] = '';     ...
fa	#### Frontend  برای فعال کردن رمزگذاری با تأیید کامل برای اتصالات بین پیشانی Zabbix و پایگاه داده:  - رمزگذاری TLS پایگاه داده را بررسی کنید و گواهی پایگاه داده را تأیید کنید - مسیر فایل کلید TLS پایگاه داده را مشخص کنید - مسیر فایل TLS CA پایگاه داده را مشخص کنید - مسیر فایل گواهی پایگاه داده TLS را مشخص کنید  توجه داشته باشید که *تأیید میزبانی پایگاه داده* بررسی شده و خاکستری شده است - این مرحله را نمی توان برای MySQL رد کرد.  ::: هشدار  لیست رمز باید خالی باشد، به طوری که فرانت اند و سرور بتوانند مورد مورد نیاز را مذاکره کنند از پشتیبانی شده توسط هر دو به پایان می رسد. :::  ![](../../../../../assets/en/manual/appendix/install/encrypt_db_verify_full1.png){width="600"}  از طرف دیگر، این را می توان در */etc/zabbix/web/zabbix.conf.php* تنظیم کرد:      ...     // برای اتصال TLS با لیست رمزهای کاملاً تعریف شده استفاده می شود.     $DB['ENCRYPTION'] = درست;     $DB['KEY_FILE'] = '/etc/ssl/mysql/client-key.pem';     $DB['CERT_FILE'] = '/etc/ssl/mysql/client-cert.pem';     $DB['CA_FILE'] = '/etc/ssl/mysql/ca.pem';     $DB['VERIFY_HOST'] = درست است.     $DB['CIPHER_LIST'] = 'TLS_AES_256_GCM_SHA384:TLS_CHACHA20_POLY1305_SHA256:TLS_AES_128_GCM_SHA256:TLS_AES_128_CCM_SHAHE256DECD:TLS_AES_128_CCM_SHAHE256DEC:TLS_SHA256DEC: HE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA -AES128-SHA256:ECDHE-RSA-AES128-SHA256:ECDHE-RSA-AES256-GC'؛     ...     // یا     ...     // برای اتصال TLS بدون لیست رمز تعریف شده استفاده می شود - توسط سرور MySQL انتخاب شده است     $DB['ENCRYPTION'] = درست;     $DB['KEY_FILE'] = '/etc/ssl/mysql/client-key.pem';     $DB['CERT_FILE'] = '/etc/ssl/mysql/client-cert.pem';     $DB['CA_FILE'] = '/etc/ssl/mysql/ca.pem';     $DB['VERIFY_HOST'] = درست است.     $DB['CIPHER_LIST'] = '';     ...

en-us	#### 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"}
fa	#### Frontend  برای فعال کردن رمزگذاری فقط حمل و نقل برای اتصالات بین Zabbix frontend و پایگاه داده:  - بررسی *رمزگذاری TLS پایگاه داده* - علامت *تأیید گواهی پایگاه داده* را بدون علامت بگذارید  ![](../../../../../assets/en/manual/appendix/install/encrypt_db_transport.png){width="600"}

en-us	#### 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"}
fa	#### Frontend  برای فعال کردن رمزگذاری فقط حمل و نقل برای اتصالات بین Zabbix frontend و پایگاه داده:  - بررسی *رمزگذاری TLS پایگاه داده* - علامت *تأیید گواهی پایگاه داده* را بدون علامت بگذارید  ![](../../../../../assets/en/manual/appendix/install/encrypt_db_transport.png){width="600"}

en-us	##### Frontend to the database  A secure connection to the database can be configured during frontend installation:  -   Mark the *Database TLS encryption* checkbox in the [Configure DB     connection](/manual/installation/frontend#configure_db_connection)     step to enable transport encryption. -   Mark the *Verify database certificate* checkbox that appears when     *TLS encryption* field is checked to enable encryption with     certificates.  ::: noteclassic  For MySQL, the *Database TLS encryption* checkbox is disabled, if *Database host* is set to localhost, because connection that uses a socket file (on Unix) or shared memory (on Windows) cannot be encrypted.\ For PostgreSQL, the *TLS encryption* checkbox is disabled, if the value of the *Database host* field begins with a slash or the field is empty.  :::  The following parameters become available in the TLS encryption in certificates mode (if both checkboxes are marked):  |Parameter|Description| |--|--------| |*Database TLS CA file*|Specify the full path to a valid TLS certificate authority (CA) file.| |*Database TLS key file*|Specify the full path to a valid TLS key file.| |*Database TLS certificate file*|Specify the full path to a valid TLS certificate file.| |*Database host verification*|Mark this checkbox to activate host verification.<br>Disabled for MYSQL, because PHP MySQL library does not allow to skip the peer certificate validation step.| |*Database TLS cipher list*|Specify a custom list of valid ciphers. The format of the cipher list must conform to the OpenSSL standard.<br>Available for MySQL only.|  ::: noteimportant TLS parameters must point to valid files. If they point to non-existent or invalid files, it will lead to the authorization error.\ If certificate files are writable, the frontend generates a warning in the [System information](/manual/web_interface/frontend_sections/reports/status_of_zabbix) report that "TLS certificate files must be read-only." (displayed only if the PHP user is the owner of the certificate).\ \ Certificates protected by passwords are not supported.  :::
fa	##### Frontend به پایگاه داده  یک اتصال امن به پایگاه داده را می توان در طول فرانت اند پیکربندی کرد نصب و راه اندازی:  - کادر انتخاب *رمزگذاری TLS پایگاه داده* را در [پیکربندی DB     اتصال](/دستی/نصب/نمایش#configure_db_connection)     مرحله برای فعال کردن رمزگذاری حمل و نقل - کادر بررسی *تأیید گواهی پایگاه داده* را علامت بزنید که وقتی ظاهر می شود     فیلد *رمزگذاری TLS* برای فعال کردن رمزگذاری با علامت زده شده است     گواهینامه ها.  ::: نوتکلاسیک  برای MySQL، چک باکس *رمزگذاری TLS پایگاه داده* است غیرفعال است، اگر *میزبان پایگاه داده* روی localhost تنظیم شده باشد، زیرا اتصال که از یک فایل سوکت (در یونیکس) یا حافظه مشترک (در ویندوز) استفاده می کند، نمی تواند رمزگذاری شود.\ برای PostgreSQL، چک باکس *رمزگذاری TLS* غیرفعال است، در صورت وجود مقدار فیلد *میزبان پایگاه داده* با اسلش شروع می شود یا فیلد خالی است.  :::  پارامترهای زیر در رمزگذاری TLS در دسترس هستند حالت گواهینامه ها (اگر هر دو کادر علامت گذاری شده باشند):  |پارامتر|توضیحات| |--|--------| |*پایگاه داده فایل TLS CA*|مسیر کامل یک فایل مرجع گواهی معتبر TLS (CA) را مشخص کنید.| |*فایل کلید TLS پایگاه داده*|مسیر کامل یک فایل کلیدی معتبر TLS را مشخص کنید.| |*فایل گواهی TLS پایگاه داده*|مسیر کامل یک فایل گواهی معتبر TLS را مشخص کنید.| |*تأیید میزبانی پایگاه داده*|این کادر را برای فعال کردن تأیید میزبان علامت گذاری کنید.<br>برای MYSQL غیرفعال است، زیرا کتابخانه PHP MySQL اجازه رد شدن از مرحله تأیید اعتبار گواهی همتا را نمی دهد.| |*لیست رمز TLS پایگاه داده*|یک لیست سفارشی از رمزهای معتبر مشخص کنید. قالب لیست رمز باید با استاندارد OpenSSL مطابقت داشته باشد.<br>فقط برای MySQL موجود است.|  ::: نکته مهم پارامترهای TLS باید به فایل های معتبر اشاره کنند. اگر آنها با اشاره به فایل های موجود یا نامعتبر، منجر به این می شود خطای مجوز.\ اگر فایل‌های گواهی قابل نوشتن باشند، بخش جلویی یک هشدار ایجاد می‌کند سیستم اطلاعات](/دستی/web_interface/frontend_sections/reports/status_of_zabbix) گزارش دهید که "فایل های گواهی TLS باید فقط خواندنی باشند." (فقط نمایش داده می شود اگر کاربر PHP صاحب گواهی باشد).\ \ گواهینامه های محافظت شده با رمز عبور پشتیبانی نمی شوند. :::

en-us	#### 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).
fa	#### پارامترهای تابع  پارامترهای تابع اجازه می دهد تا مشخص شود:  - کلید میزبان و آیتم (توابع فقط به تاریخچه آیتم میزبان ارجاع می دهند) - پارامترهای تابع خاص - عبارات دیگر (برای توابع ارجاع دهنده میزبان موجود نیست     تاریخچه آیتم، برای مشاهده [دیگر عبارات] (#other_expressions) مراجعه کنید     مثال ها)  کلید میزبان و آیتم را می توان به عنوان "/host/key" مشخص کرد. ارجاع شده است مورد باید در حالت پشتیبانی باشد (به جز تابع **nodata()**، که برای موارد پشتیبانی نشده نیز محاسبه می شود).  در حالی که سایر عبارات ماشه به عنوان پارامترهای تابع محدود به توابع غیر تاریخی در تریگرها، این محدودیت در آنها اعمال نمی شود [موارد محاسبه شده](/دستی/پیکربندی/ایتم/مجموعه/محاسبه).

en-us	#### 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)).
fa	#### کارکرد  توابع امکان محاسبه مقادیر جمع آوری شده (متوسط، حداقل، حداکثر، مجموع)، رشته ها، زمان جاری مرجع و سایر عوامل را پیدا کنید.  فهرست کاملی از [توابع پشتیبانی شده](/manual/appendix/functions) است در دسترس.  توابع معمولاً مقادیر عددی را برای مقایسه برمی‌گردانند. هنگام بازگشت رشته ها، مقایسه با **=** و **<>** امکان پذیر است عملگرها (به [مثال](#example_14) مراجعه کنید).

en-us	#### 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.
fa	#### کارکرد  توابع را می توان در انتهای JSONPath استفاده کرد. چندین تابع می تواند باشد اگر تابع قبلی مقداری را که توسط تابع پذیرفته شده است برگرداند، زنجیره می شود تابع زیر  توابع پشتیبانی شده:  |عملکرد|توضیح|ورودی|خروجی| |--|--------|----|----| |`avg`|میانگین مقدار اعداد در آرایه ورودی.|آرایه اعداد.|تعداد.| |`min`|حداقل مقدار اعداد در آرایه ورودی.|آرایه اعداد.|تعداد.| |`max`|حداکثر مقدار اعداد در آرایه ورودی.|آرایه اعداد.|تعداد.| |`sum`|مجموع اعداد در آرایه ورودی.|آرایه اعداد.|تعداد.| |`طول`|تعداد عناصر در آرایه ورودی.|آرایه.|تعداد.| |`first`|اولین عنصر آرایه.|آرایه.|یک ساختار JSON (شیء، آرایه، مقدار) بسته به محتوای آرایه ورودی.|  مقادیر عددی نقل‌شده توسط توابع جمع‌آوری JSONPath پذیرفته می‌شوند. به این معنی که مقادیر از نوع رشته ای به عددی if تبدیل می شوند تجمیع مورد نیاز است.  ورودی ناسازگار باعث ایجاد خطا در تابع می شود.

en-us	##### Function-specific parameters  Function-specific parameters are placed after the item key and are separated from the item key by a comma. See the [supported functions](/manual/appendix/functions) for a complete list of these parameters.  Most of numeric functions accept time as a parameter. You may use seconds or [time suffixes](/manual/appendix/suffixes) to indicate time. Preceded by a hash mark, the parameter has a different meaning:  |Expression|Description| |----------|-----------| |**sum**(/host/key,**10m)**|Sum of values in the last 10 minutes.| |**sum**(/host/key,**\#10)**|Sum of the last ten values.|  Parameters with a hash mark have a different meaning with the function **last** - they denote the Nth previous value, so given the values 3, 7, 2, 6, 5 (from the most recent to the least recent):  -   `last(/host/key,#2)` would return '7' -   `last(/host/key,#5)` would return '5'
fa	##### پارامترهای تابع خاص  پارامترهای تابع خاص بعد از کلید آیتم قرار می گیرند و هستند با کاما از کلید آیتم جدا می شود. [پشتیبانی می شود توابع](/دستی/ضمیمه/توابع) برای فهرست کاملی از اینها مولفه های.  اکثر توابع عددی زمان را به عنوان پارامتر می پذیرند. شما ممکن است استفاده کنید ثانیه یا [پسوندهای زمانی](/دستی/ضمیمه/پسوندها) برای نشان دادن زمان. قبل از علامت هش، پارامتر معنای متفاوتی دارد:  |بیان|توضیح| |----------|-----------| |**sum**(/host/key,**10m)**|مجموع مقادیر در 10 دقیقه گذشته.| |**sum**(/host/key,**\#10)**|مجموع ده مقدار آخر.|  پارامترهای دارای علامت هش با تابع معنای متفاوتی دارند **آخرین** - آنها Nامین مقدار قبلی را نشان می دهند، بنابراین با توجه به مقادیر 3، 7، 2، 6، 5 (از جدیدترین به جدیدترین):  - "last(/host/key,#2)" '7' را برمی گرداند - "last(/host/key,#5)" '5' را برمی گرداند

en-us	#### 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).
fa	#### نحو تابع  توابع Foreach از دو پارامتر رایج پشتیبانی می‌کنند: «فیلتر مورد» (به جزئیات زیر مراجعه کنید) و «دوره زمانی»:      foreach_function (فیلتر مورد، دوره زمانی)  مثلا:  `avg_foreach(/*/mysql.qps?[group="MySQL Servers"],5m)`  میانگین پنج دقیقه هر آیتم "mysql.qps" در گروه سرور MySQL را برمی گرداند.  توجه داشته باشید که برخی از توابع از [پارامترهای] اضافی (#additional_parameters) پشتیبانی می کنند.

en-us	#### 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 } ```
fa	#### حذف چندین گروه هاستی   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 } ```

en-us	#### 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 } ```
fa	#### دریافت تعداد نودهای 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 } ```

en-us	#### 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 } ```
fa	#### دریافت لیست نود ها به ترتیب وضعیت   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 } ```

en-us	#### 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 } ```
fa	####دریافت لیستی از نودهای خاص بر اساس 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 } ```

en-us	#### 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 } ```
fa	#### دریافت لیست نودهای متوقف شده   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 } ```

en-us	 ### Google Cloud Platform Monitoring  A new [template](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/gcp) *Google Cloud Platform by HTTP (GCP by HTTP)* is available.  See setup instructions for [HTTP templates](/manual/config/templates_out_of_the_box/http).  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) 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.
fa	 ### نظارت بر پلتفرم ابری گوگل  یک [الگوی] جدید (https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/gcp) *Google Cloud Platform توسط HTTP (GCP توسط HTTP)* موجود است.  به دستورالعمل‌های راه‌اندازی [الگوهای HTTP] (/manual/config/templates_out_of_the_box/http) مراجعه کنید.  شما می توانید این قالب را دریافت کنید:  - در *پیکربندی → الگوها* در نصب های جدید. - اگر از نسخه های قبلی ارتقا می دهید، می توانید این الگو را از Zabbix [مخزن Git] (https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates) دانلود کنید یا آن را در *zabbix بیابید. دایرکتوری /templates* آخرین نسخه دانلود شده Zabbix. سپس، در حالی که در *پیکربندی → الگوها* هستید، می توانید آن را به صورت دستی در Zabbix وارد کنید.

en-us	#### graph  Changes:\ [ZBX-7706](https://support.zabbix.com/browse/ZBX-7706) `graph.get`: Graph availability doesn't depend on permissions to items specified in graph "ymin_itemid" and "ymax_itemid" fields.\ Graph having MIN or MAX Y axis linked to inaccessible items will still be accessible but MIN/MAX Y axis works the same way as if specified calculation method is "Calculated".\
fa	نمودار ####  تغییرات:\ [ZBX-7706](https://support.zabbix.com/browse/ZBX-7706) «graph.get»: در دسترس بودن نمودار به مجوزهای موارد مشخص شده در نمودار «ymin_itemid» و فیلدهای «ymax_itemid» بستگی ندارد. \ نمودار دارای محور MIN یا MAX Y مرتبط با موارد غیرقابل دسترسی همچنان قابل دسترسی خواهد بود اما محور MIN/MAX Y به همان روشی عمل می کند که اگر روش محاسبه مشخص شده "محاسبه شده" باشد.\

en-us	#### graph  Changes:\ [ZBXNEXT-7951](https://support.zabbix.com/browse/ZBXNEXT-7951) `graph.update`: the parameter `uuid` can now be updated.\
fa	#### گراف  Changes:\ [ZBXNEXT-7951](https://support.zabbix.com/browse/ZBXNEXT-7951) `graph.update`: the parameter `uuid` can now be updated.\

en-us	# graph.create
fa	ساخت گراف

en-us	# graph.delete
fa	# حذف گراف

en-us	# graph.get
fa	#دریافت گراف 

en-us	# graphitem.get
fa	# دریافت آیتم های گراف

en-us	### 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.|
fa	### آیتم گراف   ::: 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.|

en-us	# > Graph item object  The following objects are directly related to the `graphitem` API.
fa	# > آبجکت های آیتم گراف  The following objects are directly related to the `graphitem` API.

en-us	# 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
fa	# آیتم گراف  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

en-us	# > Graph object  The following objects are directly related to the `graph` API.
fa	# > آبجکت گراف  The following objects are directly related to the `graph` API.

en-us	#### graphprototype  Changes:\ [ZBX-7706](https://support.zabbix.com/browse/ZBX-7706) `graphprototype.get`: Graph prototype availability doesn't depend on permissions to items specified in graph prototype "ymin_itemid" and "ymax_itemid" fields.\
fa	#### نمونه اولیه گراف   تغییرات:\ [ZBX-7706](https://support.zabbix.com/browse/ZBX-7706) «graphprototype.get»: در دسترس بودن نمونه اولیه نمودار به مجوزهای موارد مشخص شده در نمونه اولیه نمودار «ymin_itemid» و «ymax_itemid» بستگی ندارد. زمینه های.\

en-us	#### graphprototype  Changes:\ [ZBXNEXT-7951](https://support.zabbix.com/browse/ZBXNEXT-7951) `graphprototype.update`: the parameter `uuid` can now be updated.\
fa	#### نمونه اولیه گراف   Changes:\ [ZBXNEXT-7951](https://support.zabbix.com/browse/ZBXNEXT-7951) `graphprototype.update`: the parameter `uuid` can now be updated.\

en-us	# graphprototype.create
fa	# ساخت نمونه گراف 

en-us	# graphprototype.delete
fa	# حذف نمونه اولیه گراف 

en-us	# graphprototype.get
fa	# دریافت نمونه اولیه گراف 

en-us	# > Graph prototype object  The following objects are directly related to the `graphprototype` API.
fa	# > آبجکت نمونه اولیه گراف   The following objects are directly related to the `graphprototype` API.

en-us	### 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.
fa	### نمونه اولیه گراف   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.

en-us	# 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
fa	# نمونه اولیه گراف   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

en-us	# graphprototype.update
fa	# آپدیت نمونه اولیه گراف 

en-us	### 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.
fa	### گراف   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.

en-us	# 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
fa	# نمونه اولیه گراف   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

en-us	# graph.update
fa	# آپدیت گراف

en-us	### 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.|
fa	###لینک گروهی   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.|

en-us	### Group prototype  The group prototype object defines a group that will be created for a discovered host and has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**name**<br>(required)|string|Name of the group prototype.|
fa	### گروه اولیه   The group prototype object defines a group that will be created for a discovered host and has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**name**<br>(required)|string|Name of the group prototype.|

en-us	#### groups/group  |Parameter|Type|Description|Details| |---------|----|-----------|-------| |name|*string*|Group name.| |
fa	#### گروه ها / گروه   |Parameter|Type|Description|Details| |---------|----|-----------|-------| |name|*string*|Group name.| |

en-us	 #### 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.
fa	 #### مدیریت خطاهای کامپایل عبارات منظم و زمان اجرا  اگر عبارت منظمی که در آیتم «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 شناسه مورد را ثبت می‌کند تا تشخیص دهد کدام آیتم گزارش دارای خطاهای زمان اجرا است. توصیه می شود در صورت بروز خطا در زمان اجرا، عبارت منظم را دوباره طراحی کنید.

en-us	# hanode.get
fa	# دریافت نود HA

en-us	##### - HDD/flash image (raw)      dd if=./zabbix_appliance_5.2.0.raw of=/dev/sdc bs=4k conv=fdatasync  Replace */dev/sdc* with your Flash/HDD disk device.
fa	##### - تصویر HDD/فلش (خام)      dd if=./zabbix_appliance_5.2.0.raw of=/dev/sdc bs=4k conv=fdatasync  دستگاه دیسک Flash/HDD خود را جایگزین */dev/sdc* کنید.

en-us	### 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.|
fa	### نود 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.|

en-us	# > High availability node object  The following object is related to operating a High availability cluster of Zabbix servers.
fa	# > آبجکت نود HA  The following object is related to operating a High availability cluster of Zabbix servers.

en-us	# 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
fa	# نود 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

en-us	#### history  Changes:\ [ZBXNEXT-6714](https://support.zabbix.com/browse/ZBXNEXT-6714) added new API method `history.clear`.\
fa	#### تاریخچه  تغییرات:\ [ZBXNEXT-6714](https://support.zabbix.com/browse/ZBXNEXT-6714) روش جدید API «history.clear» را اضافه کرد.\

en-us	# history.clear
fa	#پاک کردن تاریخچه 

en-us	# history.get
fa	# گرفتن تاریخچه 

en-us	# > 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. :::
fa	# > آبجکت تاریخچه   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. :::

en-us	# 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.
fa	#تاریخچه  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.

en-us	# host.create
fa	# ساخت هاست 

en-us	# host.delete
fa	#حذف هاست 

en-us	# host.get
fa	# دریافت هاست 

en-us	##### 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.|
fa	##### تگ های گراف هاست ها   |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.|

en-us	#### host group  Changes:\ [ZBXNEXT-6868](https://support.zabbix.com/browse/ZBXNEXT-6868) `hostgroup.massupdate`: `hosts` and `templates` fields are now required.\ [ZBXNEXT-6868](https://support.zabbix.com/browse/ZBXNEXT-6868) `hostgroup.massadd`, `hostgroup.massupdate`, `hostgroup.massremove`: added strict validation of the method parameters.\
fa	#### گروه هاست ها  تغییرات:\ [ZBXNEXT-6868](https://support.zabbix.com/browse/ZBXNEXT-6868) «hostgroup.massupdate»: اکنون فیلدهای «hosts» و «templates» لازم است.\ [ZBXNEXT-6868](https://support.zabbix.com/browse/ZBXNEXT-6868) «hostgroup.massadd»، «hostgroup.massupdate»، «hostgroup.massremove»: اعتبارسنجی دقیق پارامترهای روش اضافه شده است.\

en-us	#### hostgroup  Changes:\ [ZBXNEXT-7951](https://support.zabbix.com/browse/ZBXNEXT-7951) `hostgroup.update`: the parameter `uuid` can now be updated.\
fa	#### گروه هاستی  Changes:\ [ZBXNEXT-7951](https://support.zabbix.com/browse/ZBXNEXT-7951) `hostgroup.update`: the parameter `uuid` can now be updated.\

en-us	# hostgroup.create
fa	# ساخت گروه هاست

en-us	# hostgroup.delete
fa	# حذف گروه هاست 

en-us	# hostgroup.get
fa	# دریافت گروه هاستی 

en-us	# hostgroup.massadd
fa	# اضافه کردن گروهی هاست ها 

en-us	# hostgroup.massremove
fa	# حذف گروهی هاست ها 

en-us	# hostgroup.massupdate
fa	# به روز رسانی گروهی هاست ها 

en-us	# > Host group object  The following objects are directly related to the `hostgroup` API.
fa	# > آیجکت گروه هاستی   The following objects are directly related to the `hostgroup` API.

en-us	### 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.
fa	### گروه هاستی  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.

en-us	# Host group  This class is designed to work with host groups.  Object references:\  -   [Host group](/manual/api/reference/hostgroup/object#host_group)  Available methods:\  -   [hostgroup.create](/manual/api/reference/hostgroup/create) -     creating new host groups -   [hostgroup.delete](/manual/api/reference/hostgroup/delete) -     deleting host groups -   [hostgroup.get](/manual/api/reference/hostgroup/get) - retrieving     host groups -   [hostgroup.massadd](/manual/api/reference/hostgroup/massadd) -     adding related objects to host groups -   [hostgroup.massremove](/manual/api/reference/hostgroup/massremove) -     removing related objects from host groups -   [hostgroup.massupdate](/manual/api/reference/hostgroup/massupdate) -     replacing or removing related objects from host groups -   [hostgroup.update](/manual/api/reference/hostgroup/update) -     updating host groups
fa	# گروه هاستی   This class is designed to work with host groups.  Object references:\  -   [Host group](/manual/api/reference/hostgroup/object#host_group)  Available methods:\  -   [hostgroup.create](/manual/api/reference/hostgroup/create) -     creating new host groups -   [hostgroup.delete](/manual/api/reference/hostgroup/delete) -     deleting host groups -   [hostgroup.get](/manual/api/reference/hostgroup/get) - retrieving     host groups -   [hostgroup.massadd](/manual/api/reference/hostgroup/massadd) -     adding related objects to host groups -   [hostgroup.massremove](/manual/api/reference/hostgroup/massremove) -     removing related objects from host groups -   [hostgroup.massupdate](/manual/api/reference/hostgroup/massupdate) -     replacing or removing related objects from host groups -   [hostgroup.update](/manual/api/reference/hostgroup/update) -     updating host groups

en-us	# hostgroup.update
fa	# به روز رسانی گروه هاستی 

en-us	# hostinterface.create
fa	# ساخت اینترفیس هاست 

en-us	# hostinterface.delete
fa	# حذف اینترفیس هاست 

en-us	# hostinterface.get
fa	# دریافت اینترفیس هاست 

en-us	# hostinterface.massadd
fa	# اضافه کردن گروهی اینترفیس های هاست 

en-us	# hostinterface.massremove
fa	# حذف گروهی اینترفیس های هاست 

en-us	# > Host interface object  The following objects are directly related to the `hostinterface` API.
fa	# >آبجکت های اینترفیس هاست   The following objects are directly related to the `hostinterface` API.

en-us	# hostinterface.replacehostinterfaces
fa	# جایگزینی اینترفیس های هاست 

en-us	### Host interface  The host interface object has the following properties.  ::: noteimportant Note that both IP and DNS are required. If you do not want to use DNS, set it to an empty string. :::  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |available|integer|*(readonly)* Availability of host interface.<br><br>Possible values are:<br>0 - *(default)* unknown;<br>1 - available;<br>2 - unavailable.| |details|array|Additional object for interface. **Required** if interface 'type' is SNMP.| |disable\_until|timestamp|*(readonly)* The next polling time of an unavailable host interface.| |**dns**<br>(required)|string|DNS name used by the interface.<br><br>Can be empty if the connection is made via IP.| |error|string|*(readonly)* Error text if host interface is unavailable.| |errors\_from|timestamp|*(readonly)* Time when host interface became unavailable.| |**hostid**<br>(required)|string|ID of the host the interface belongs to.| |interfaceid|string|*(readonly)* ID of the interface.| |**ip**<br>(required)|string|IP address used by the interface.<br><br>Can be empty if the connection is made via DNS.| |**main**<br>(required)|integer|Whether the interface is used as default on the host. Only one interface of some type can be set as default on a host.<br><br>Possible values are:<br>0 - not default;<br>1 - default.| |**port**<br>(required)|string|Port number used by the interface. Can contain user macros.| |**type**<br>(required)|integer|Interface type.<br><br>Possible values are:<br>1 - agent;<br>2 - SNMP;<br>3 - IPMI;<br>4 - JMX.<br>| |**useip**<br>(required)|integer|Whether the connection should be made via IP.<br><br>Possible values are:<br>0 - connect using host DNS name;<br>1 - connect using host IP address for this host interface.|  Note that for some methods (update, delete) the required/optional parameter combination is different.
fa	### اینترفیس هاست   The host interface object has the following properties.  ::: noteimportant Note that both IP and DNS are required. If you do not want to use DNS, set it to an empty string. :::  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |available|integer|*(readonly)* Availability of host interface.<br><br>Possible values are:<br>0 - *(default)* unknown;<br>1 - available;<br>2 - unavailable.| |details|array|Additional object for interface. **Required** if interface 'type' is SNMP.| |disable\_until|timestamp|*(readonly)* The next polling time of an unavailable host interface.| |**dns**<br>(required)|string|DNS name used by the interface.<br><br>Can be empty if the connection is made via IP.| |error|string|*(readonly)* Error text if host interface is unavailable.| |errors\_from|timestamp|*(readonly)* Time when host interface became unavailable.| |**hostid**<br>(required)|string|ID of the host the interface belongs to.| |interfaceid|string|*(readonly)* ID of the interface.| |**ip**<br>(required)|string|IP address used by the interface.<br><br>Can be empty if the connection is made via DNS.| |**main**<br>(required)|integer|Whether the interface is used as default on the host. Only one interface of some type can be set as default on a host.<br><br>Possible values are:<br>0 - not default;<br>1 - default.| |**port**<br>(required)|string|Port number used by the interface. Can contain user macros.| |**type**<br>(required)|integer|Interface type.<br><br>Possible values are:<br>1 - agent;<br>2 - SNMP;<br>3 - IPMI;<br>4 - JMX.<br>| |**useip**<br>(required)|integer|Whether the connection should be made via IP.<br><br>Possible values are:<br>0 - connect using host DNS name;<br>1 - connect using host IP address for this host interface.|  Note that for some methods (update, delete) the required/optional parameter combination is different.

en-us	# 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
fa	# اینترفیس هاست   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

en-us	# hostinterface.update
fa	# به روز رسانی اینترفیس هاست ها 

en-us	### 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|
fa	### جست و جو هاست   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|

en-us	##### 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.|
fa	##### تگ های قوانین 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.|

en-us	# host.massadd
fa	# اضافه کردن گروهی هاست ها 

en-us	# host.massremove
fa	# حذف گروهی هاست ها 

en-us	# host.massupdate
fa	# آپدیت گروهی هاست ها 

en-us	##### Hostname parameter  To perform [active checks](/manual/appendix/items/activepassive#active_checks) on a host Zabbix agent needs to have the hostname defined. Moreover, the hostname value set on the agent side should exactly match the "[Host name](/manual/config/hosts/host)" configured for the host in the frontend.  The hostname value on the agent side can be defined by either the **Hostname** or **HostnameItem** parameter in the agent [configuration file](/manual/appendix/config/zabbix_agentd_win) - or the default values are used if any of these parameters are not specified.  The default value for **HostnameItem** parameter is the value returned by the "system.hostname" agent key. For Windows, it returns result of the gethostname() function, which queries namespace providers to determine the local host name. If no namespace provider responds, the NetBIOS name is returned.  The default value for **Hostname** is the value returned by the **HostnameItem** parameter. So, in effect, if both these parameters are unspecified, the actual hostname will be the host NetBIOS name; Zabbix agent will use NetBIOS host name to retrieve the list of active checks from Zabbix server and send results to it.  The "system.hostname" key supports two optional parameters - *type* and *transform*.  *Type* parameter determines the type of the name the item should return. Supported values:  -   *netbios* (default) - returns the NetBIOS host name which is limited     to 15 symbols and is in the UPPERCASE only; -   *host* - case-sensitive, returns the full, real Windows host name (without a domain); -   *shorthost* (supported since Zabbix 5.4.7) - returns part of the     hostname before the first dot. It will return a full string if the     name does not contain a dot.  *Transform* parameter is supported since Zabbix 5.4.7 and allows to specify additional transformation rule for the hostname. Supported values:  -   *none* (default) - use the original letter case; -   *lower* - convert the text into lowercase.  So, to simplify the configuration of zabbix\_agentd.conf file and make it unified, two different approaches could be used.  1.  leave **Hostname** or **HostnameItem** parameters undefined and     Zabbix agent will use NetBIOS host name as the hostname; 2.  leave **Hostname** parameter undefined and define **HostnameItem**     like this:\     **HostnameItem=system.hostname\[host\]** - for Zabbix agent to use     the full, real (case sensitive) Windows host name as the hostname\     **HostnameItem=system.hostname\[shorthost,lower\]** - for Zabbix     agent to use only part of the hostname before the first dot,     converted into lowercase.  Host name is also used as part of Windows service name which is used for installing, starting, stopping and uninstalling the Windows service. For example, if Zabbix agent configuration file specifies `Hostname=Windows_db_server`, then the agent will be installed as a Windows service "`Zabbix Agent [Windows_db_server]`". Therefore, to have a different Windows service name for each Zabbix agent instance, each instance must use a different host name.
fa	##### پارامتر نام میزبان  برای انجام [فعال چک می کند](/دستی/ضمیمه/item/activepassive#active_checks) روی یک میزبان عامل Zabbix باید نام میزبان را تعریف کند. علاوه بر این، نام میزبان مقدار تنظیم شده در سمت نماینده باید دقیقاً با "[Host name](/manual/config/hosts/host)" برای میزبان در قسمت پیکربندی شده است پیشانی  مقدار نام میزبان در سمت عامل را می توان با هر دو تعریف کرد پارامتر **Hostname** یا **HostnameItem** در عامل [پیکربندی file](/manual/appendix/config/zabbix_agentd_win) - یا مقادیر پیش‌فرض اگر هر یک از این پارامترها مشخص نشده باشد استفاده می شود.  مقدار پیش‌فرض برای پارامتر **HostnameItem** مقدار بازگشتی است توسط کلید عامل "system.hostname". برای ویندوز، نتیجه تابع gethostname() را برمی گرداند که از ارائه دهندگان فضای نام برای تعیین نام میزبان محلی درخواست می کند. اگر هیچ ارائه دهنده فضای نامی پاسخ ندهد، نام NetBIOS برگردانده می شود.  مقدار پیش‌فرض برای **نام میزبان** مقداری است که توسط پارامتر **HostnameItem**. بنابراین، در واقع، اگر هر دو این پارامترها باشند نامشخص، نام میزبان واقعی، نام میزبان NetBIOS خواهد بود. زبیکس agent از نام میزبان NetBIOS برای بازیابی لیست چک های فعال استفاده می کند از سرور Zabbix و ارسال نتایج به آن.  کلید "system.hostname" از دو پارامتر اختیاری - *type* و *تبدیل*.  پارامتر *Type* نوع نامی را که مورد باید برگرداند را تعیین می کند. مقادیر پشتیبانی شده:  - *netbios* (پیش‌فرض) - نام میزبان NetBIOS را که محدود است برمی‌گرداند     تا 15 نماد و فقط با حروف بزرگ است. - *میزبان* - حساس به حروف بزرگ، نام هاست کامل و واقعی ویندوز (بدون دامنه) را برمی گرداند. - *shorthost* (از Zabbix 5.4.7 پشتیبانی می شود) - بخشی از را برمی گرداند     نام میزبان قبل از اولین نقطه اگر یک رشته کامل باشد     نام حاوی نقطه نیست  پارامتر *Transform* از Zabbix 5.4.7 پشتیبانی می شود و اجازه می دهد تا قانون تبدیل اضافی را برای نام میزبان مشخص کنید. پشتیبانی ارزش های:  - *هیچ* (پیش فرض) - از حروف اصلی استفاده کنید. - *کوچک* - متن را به حروف کوچک تبدیل کنید.  بنابراین، برای ساده کردن پیکربندی فایل zabbix\_agentd.conf و make این یکپارچه شد، دو رویکرد متفاوت می تواند مورد استفاده قرار گیرد.  1. پارامترهای **Hostname** یا **HostnameItem** را تعریف نشده رها کنید و     عامل Zabbix از نام میزبان NetBIOS به عنوان نام میزبان استفاده خواهد کرد. 2. پارامتر **Hostname** را تعریف نشده رها کنید و **HostnameItem** را تعریف کنید.     مثل این:\     **HostnameItem=system.hostname\[host\]** - برای استفاده از عامل Zabbix     نام میزبان ویندوز کامل و واقعی (حساس به حروف بزرگ) به عنوان نام میزبان\     **HostnameItem=system.hostname\[shorthost,lower\]** - برای Zabbix     عاملی که فقط از بخشی از نام میزبان قبل از اولین نقطه استفاده کند،     به حروف کوچک تبدیل می شود  نام میزبان نیز به عنوان بخشی از نام سرویس ویندوز استفاده می شود نصب، راه اندازی، توقف و حذف سرویس ویندوز. برای به عنوان مثال، اگر فایل پیکربندی عامل Zabbix مشخص شود "Hostname=Windows_db_server"، سپس عامل به عنوان یک نصب خواهد شد سرویس ویندوز "` Zabbix Agent [Windows_db_server]". بنابراین، داشتن نام سرویس ویندوز متفاوت برای هر نمونه عامل Zabbix، هر کدام نمونه باید از نام میزبان متفاوتی استفاده کند.

en-us	# > Host object  The following objects are directly related to the host API.
fa	# > آبجکت هاست  The following objects are directly related to the host API.

en-us	#### hostprototype  Changes:\ [ZBXNEXT-7951](https://support.zabbix.com/browse/ZBXNEXT-7951) `hostprototype.update`: the parameter `uuid` can now be updated.\
fa	#### نمونه اولیه هاست   Changes:\ [ZBXNEXT-7951](https://support.zabbix.com/browse/ZBXNEXT-7951) `hostprototype.update`: the parameter `uuid` can now be updated.\

en-us	# hostprototype.create
fa	# ساخت هاست نمونه

en-us	# hostprototype.delete
fa	#حذف نمونه اولیه هاست 

en-us	# hostprototype.get
fa	# دریافت نمونه اولیه هاست 

en-us	# > Host prototype object  The following objects are directly related to the `hostprototype` API.
fa	# > آبجکت نمونه اولیه هاست   The following objects are directly related to the `hostprototype` API.

en-us	### 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.|
fa	### تگ اولیه هاست   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.|

en-us	### 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.
fa	### هاست نمونه  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.

en-us	# 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
fa	# نمونه اولیه هاست   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

en-us	# hostprototype.update
fa	# به روز رسانی نمونه اولیه هاست 