استفاده حرفه‌ای از Zabbix API

استفاده حرفه‌ای از Zabbix API
از صفر تا Zabbix Enterprise · درس 27 · آرشیو کانال · 2026-11-16

تا زمانی که زیرساخت کوچک است، ساخت چند Host و اتصال Template به‌صورت دستی قابل مدیریت است.

اما با افزایش سرورها، تجهیزات و شعب، مدیریت دستی باعث مشکلات زیر می‌شود:

• اشتباه در Naming

• فراموش‌شدن Tag

• اتصال Template نادرست

• ثبت تکراری Host

• اختلاف با CMDB

• گزارش‌گیری زمان‌بر

• وابستگی به یک Administrator

Zabbix API امکان می‌دهد عملیات تکراری را استاندارد و خودکار کنیم.

API زبیکس چیست؟

Zabbix یک API مبتنی بر HTTP و JSON-RPC ارائه می‌دهد که امکان خواندن و تغییر Configuration و دسترسی به بخشی از داده‌ها را فراهم می‌کند.

کاربردهای رایج:

• ایجاد و ویرایش Host

• مدیریت Host Group

• اتصال Template

• تعریف Tag و Macro

• ساخت Maintenance

• دریافت Problem و Event

• استخراج Inventory

• تهیه گزارش

• اتصال به CMDB

• مدیریت Proxy

• Automation فرایند Onboarding

📚 مستندات رسمی Zabbix API

نمونه درخواست

Endpoint رایج:

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

نمونه مفهومی برای دریافت Hostها:

{

"jsonrpc": "2.0",

"method": "host.get",

"params": {

"output": ["hostid", "host", "name"]

},

"id": 1

}

در Automationهای جدید بهتر است از API Token مدیریت‌شده استفاده شود و Token در Header احراز هویت قرار گیرد.

Token نباید داخل Script، Git Repository یا فایل عمومی Hardcode شود.

حساب API باید چگونه باشد؟

✅ حساب اختصاصی

✅ Role اختصاصی

✅ دسترسی فقط به Host Groupهای لازم

✅ مجوز فقط برای Methodهای موردنیاز

✅ API Token مستقل

✅ تاریخ انقضا

✅ Rotation دوره‌ای

✅ مالک مشخص

✅ ثبت در Secret Vault

✅ Audit منظم

استفاده از Super Admin برای Script ساده Inventory، نقض اصل Least Privilege است.

در نسخه‌های جدید Zabbix می‌توان دسترسی به بخش‌های رابط و Methodهای API را با User Role محدود کرد.

سناریو اول: Onboarding خودکار Host

فرایند استاندارد:

دریافت Host از CMDB یا فایل ورودی

اعتبارسنجی نام و IP

بررسی تکراری‌نبودن Host

انتخاب Host Group

تعیین Proxy

اتصال Template

افزودن Tag

تعریف Macro

ایجاد Host

بررسی دریافت اولین داده

این Workflow باعث می‌شود تمام Hostها با یک استاندارد وارد سامانه شوند.

سناریو دوم: گزارش Problemها

API می‌تواند Problemهای باز را استخراج و براساس این موارد دسته‌بندی کند:

• Severity

• Site

• Service

• Team

• مدت Problem

• Acknowledge

• Suppression

• Tag

سپس گزارش می‌تواند به:

• Email

• Ticketing System

• Dashboard خارجی

• Power BI

• فایل CSV

• سامانه مدیریتی

منتقل شود.

سناریو سوم: Maintenance خودکار

در Change Management می‌توان پس از تأیید Change:

Maintenance ایجاد کرد.

Hostهای مرتبط را اضافه کرد.

زمان شروع و پایان را تعیین کرد.

شماره Change را ثبت کرد.

پس از پایان، Maintenance را بست.

نتیجه تغییر را گزارش کرد.

Automation باید از بازماندن Maintenance پس از پایان Change جلوگیری کند.

Idempotency

Script حرفه‌ای باید چند بار قابل اجرا باشد بدون اینکه Object تکراری بسازد.

به‌جای اینکه همیشه host.create اجرا شود:

• ابتدا Host جست‌وجو شود.

• اگر وجود ندارد، ایجاد شود.

• اگر وجود دارد، اختلاف‌ها بررسی شوند.

• فقط تغییر لازم اعمال شود.

این مفهوم Idempotency نام دارد و برای Automation پایدار ضروری است.

کنترل خطا

Script باید این موارد را مدیریت کند:

• HTTP Error

• JSON-RPC Error

• Token نامعتبر

• Permission ناکافی

• Host تکراری

• Group یا Template ناموجود

• Timeout

• Partial Failure

• Rate و حجم درخواست

• تغییر Schema یا Version

فقط دریافت HTTP 200 به معنای موفقیت عملیات نیست؛ ممکن است پاسخ JSON شامل Error باشد.

امنیت API

🔐 HTTPS

🔐 Certificate Validation

🔐 Token با Expiration

🔐 Secret Vault

🔐 Source IP Restriction

🔐 Least Privilege

🔐 عدم ثبت Token در Log

🔐 Rotation و Revocation

🔐 Audit Log

🔐 جداسازی Test و Production

اگر Token افشا شد، باید قابل ابطال باشد بدون اینکه سایر Integrationها متوقف شوند؛ بنابراین برای هر Integration یک Token جداگانه بسازید.

چه چیزهایی را خودکار نکنیم؟

Automation بدون Governance می‌تواند اشتباه را با سرعت بیشتری گسترش دهد.

اقدامات حساس مانند این‌ها باید Approval یا کنترل اضافه داشته باشند:

• حذف انبوه Host

• تغییر Template اصلی

• غیرفعال‌کردن Trigger

• حذف History

• تغییر Authentication

• مدیریت User و Role

• تغییر Actionهای Critical

پیش از تغییر انبوه:

• Dry Run

• Backup

• Change Log

• محدوده مشخص

• Rollback Plan

ضروری است.

🎯 جمع‌بندی

Zabbix API ابزار تبدیل مانیتورینگ دستی به یک پلتفرم استاندارد و یکپارچه است.

API زمانی ارزش واقعی ایجاد می‌کند که همراه با RBAC، Token Management، Validation، Idempotency و Audit استفاده شود.

در قسمت بعد:

🔜 Automated Remediation؛ آیا Zabbix باید پس از تشخیص مشکل، خودش آن را برطرف کند؟

🛡 NEACASPACE