Konfigurācijas parametri: Zabbix MCP serveris

Pārskats

Zabbix MCP serveris ir process, kas ļauj AI aģentiem strādāt ar Zabbix, izmantojot Model Context Protocol (MCP).

Šajā sadaļā ir uzskaitīti Zabbix MCP servera konfigurācijas faila (zabbix_mcp_server.conf) atbalstītie parametri.

Parametri ir uzskaitīti bez papildu informācijas. Noklikšķiniet uz parametra, lai skatītu pilnu informāciju.

Visi parametri nav obligāti, ja vien nav skaidri norādīts, ka parametrs ir obligāts.

Ņemiet vērā:

• Noklusējuma vērtības atspoguļo procesa noklusējuma iestatījumus, nevis vērtības piegādātajos konfigurācijas failos;
• Vērtības atbalsta vides mainīgos formātā ${NAME};
• Zabbix atbalsta konfigurācijas failus tikai UTF-8 kodējumā bez BOM;
• Komentāri, kas sākas ar #, tiek atbalstīti tikai rindas sākumā.

Parametru informācija

AllowedIP

Ar komatiem atdalīts IP adrešu saraksts, pēc izvēles CIDR notācijā, vai MCP klientu DNS nosaukumi. Ienākošie savienojumi tiks pieņemti tikai no šeit norādītajiem hostiem.

Piemērs:

AllowedIP=127.0.0.1,192.168.1.0/24,::1,2001:db8::/32,mcp-client.example.com

Obligāts: jā

AllowTool

Aizstājējzīmes noteikums, kas atļauj rīku. Parametru var norādīt vairākas reizes.
Aizstājējzīmju raksti izmanto vienuma atslēgas sintaksi, kur * atbilst jebkādām rakstzīmēm. Noteikums tiek piemērots vienkāršajam rīka nosaukumam un ignorē ToolPrefix.
Visi AllowTool, DenyTool, AllowToolRegexp un DenyToolRegexp noteikumi veido vienu sarakstu to norādīšanas secībā; lēmumu pieņem pirmais atbilstošais noteikums. Rīks, kuram neatbilst neviens noteikums, ir atļauts.

Piemērs:

AllowTool=host_get

AllowToolRegexp

Regulārās izteiksmes noteikums, kas atļauj rīkus. Parametru var norādīt vairākas reizes.
Regulārās izteiksmes izmanto RE2 sintaksi un atbilst jebkurai vienkāršā rīka nosaukuma daļai, ja vien izteiksme nav piesaistīta virknes sākumam vai beigām.

Piemērs:

AllowToolRegexp=^(host|hostgroup|trigger|problem)_get$

DebugLevel

Norādiet atkļūdošanas līmeni:

• 0 - pamatinformācija par Zabbix procesu palaišanu un apturēšanu;
• 1 - kritiska informācija;
• 2 - informācija par kļūdām;
• 3 - brīdinājumi;
• 4 - atkļūdošanai (ģenerē daudz informācijas);
• 5 - paplašinātā atkļūdošana (ģenerē vēl vairāk informācijas).

Noklusējums: 3
Diapazons: 0-5

DenyTool

Aizstājējzīmes noteikums, kas liedz izmantot rīku. Parametru var norādīt vairākas reizes.
Liegtie rīki netiek iekļauti rīku sarakstā, un tos nevar izsaukt. Detalizētu informāciju skatiet sadaļā AllowTool.

Piemērs:

DenyTool=maintenance_delete

DenyToolRegexp

Regulāras izteiksmes noteikums, kas liedz rīku izmantošanu. Parametru var norādīt vairākas reizes.
Detalizētu informāciju skatiet sadaļā AllowToolRegexp.

Piemērs:

DenyToolRegexp=^problem_(close|suppress)$

FrontendURL

Zabbix API galapunkts: Zabbix lietotāja saskarnes URL, kas beidzas ar api_jsonrpc.php.

Piemērs:

FrontendURL=https://zabbix.example.com/api_jsonrpc.php

Obligāts: jā

IgnoreURLCertErrors

Norāda TLS sertifikāta validācijas kļūdu apstrādi, piekļūstot Zabbix API:
false - neignorēt sertifikāta kļūdas;
true - ignorēt sertifikāta kļūdas (izmantot tikai izstrādes vidē).

Noklusējuma vērtība: false

ListenIP

IP adrese, kurā klausīties.

Noklusējums: 0.0.0.0

ListenPort

Ports, kurā klausīties. MCP galapunkta ceļš ir /mcp.

Noklusējums: 8443
Diapazons: 1024-32767

LogFile

Žurnālfaila nosaukums.

Noklusējums: /tmp/zabbix_mcp_server.log

Obligāts: Nē

LogFileSize

Maksimālais žurnālfaila lielums MB.
0 - atspējot automātisku žurnālfaila rotāciju.

Noklusējums: 1
Diapazons: 0-1024

LogType

Žurnāla izvades veids:

• file - rakstīt žurnālu failā, kas norādīts ar parametru LogFile;
• system - rakstīt žurnālu sistēmas žurnālā;
• console - rakstīt žurnālu standarta izvadē.

Noklusējums: file

MaxResponseSize

Maksimālais atbildes lielums, ko atgriež lasīšanas rīks. Atbildes izveide tiek pārtraukta, tiklīdz tiek sasniegts šis ierobežojums vai rīka argumenta limit vērtība — atkarībā no tā, kurš nosacījums tiek sasniegts pirmais.
Atbalsta mērvienību sufiksus.

Noklusējums: 64K
Diapazons: 16K-256K

PidFile

PID faila nosaukums.

Noklusējums: /tmp/zabbix_mcp_server.pid

Taimauts

Maksimālais laiks (sekundēs), cik ilgi gaidīt atbildi no Zabbix API.

Noklusējums: 10
Diapazons: 3-30

TLSAccept

Kādus ienākošos savienojumus pieņemt:

• unencrypted - pieņemt savienojumus bez šifrēšanas (noklusējums);
• cert - pieņemt savienojumus ar TLS un sertifikātu.

Noklusējums: unencrypted

TLSCertFile

Pilns ceļš uz failu, kurā atrodas servera sertifikāts vai sertifikātu ķēde.

Obligāts: Jā, ja TLSAccept ir iestatīts uz cert; pretējā gadījumā — nē

TLSKeyFile

Pilns faila ceļš, kurā atrodas servera privātā atslēga.

Obligāts: Jā, ja TLSAccept ir iestatīts uz cert; pretējā gadījumā — nē

ToolPrefix

Prefikss, kas tiek pievienots visu rīku nosaukumiem, piemēram, lai izvairītos no nosaukumu konfliktiem ar citu MCP serveru rīkiem. Piemēram, ja ToolPrefix=zbx_, rīks host_get tiek eksponēts kā zbx_host_get.
Atļautās rakstzīmes: burti, cipari, pasvītrojums (_), defise (-) un punkts (.).
Rīku piekļuves noteikumi atbilst rīku nosaukumiem bez prefiksa.

Piemērs:

ToolPrefix=zbx_