تا زمانی که زیرساخت کوچک است، ساخت چند 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
سپس گزارش میتواند به:
• 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
