Zabbix SNMP Mibs

Read this in other languages:

Zabbix SNMP Mibs is a modern and intuitive module for the Zabbix Web Interface that simplifies and centralizes the visualization and exploration of SNMP MIB (Management Information Base) files. It allows you to navigate through MIB directories, list SNMP objects, and view the original source code of MIB files directly from your browser.

Developed by George Filho.

🎯 Main Features

MIB Browsing: Easily navigate through MIB files stored in the default directories of your Zabbix server.
Object Exploration: View a structured list of all SNMP objects (OID, Syntax, Access, Description) contained within a selected MIB file.
Source Code Viewer: Click the view button or a shortcut to open the original source code of the MIB file in a high-resolution modal window.
Optimized Smart Reading: Optimized processing (with no slow database queries) strictly focused on fast reading, rendering, and listing of MIB files.
Native Zabbix Integration: Natively developed using Zabbix UI classes (CHtmlPage, CController, CDiv), making it fully compliant with the Zabbix 7.0+ Content Security Policy (CSP).

📋 Prerequisites

Before installing and using this module, ensure that:

You are running Zabbix Frontend 7.0 LTS or higher. (This module is specifically optimized for the Zabbix 7.0+ architecture).
The web server user (e.g., www-data or apache) has read permissions for the module directory and the directories where the MIBs are installed (usually /usr/share/snmp/mibs/).
The snmp package (and utilities like snmptranslate) is correctly installed and configured on the Zabbix server for native MIB parsing.

🚀 Installation

Installing modules in the Zabbix frontend is simple and fast.

Download or clone this repository: Download the module files to your server.
Copy to the Zabbix modules directory: Move the module folder to the modules directory of your Zabbix web interface. CRITICAL: The folder name must be exactly ZabbixSnmp to match the module namespace.

The default path is usually:
```
/usr/share/zabbix/ui/modules/ZabbixSnmp
# or
/usr/share/zabbix/modules/ZabbixSnmp
```
Register the Module in the Frontend:
- Log into the Zabbix web interface as a Super Admin.
- Navigate to Administration → Modules (or General → Modules depending on your interface).
- Click the "Scan directory" button in the top right corner.
- The "SNMP Mibs" (or Zabbix SNMP) module should appear in the list.
- Click Enable to activate it.

💻 How to Use

After activation, a new menu will be available to facilitate your daily operations.

Navigate to SuporTI → SNMP Mibs in the main menu.
In the top bar, select the directory where your MIBs are located.
In the second dropdown menu, select the MIB file you wish to explore.
The table will automatically populate with all extracted SNMP objects, showing their Name, Kind, OID, Attributes, and Description.
If desired, click the View Source button at the top of the screen to open the original MIB file code in text mode.

🛠️ Technical Details & Development References

This module is built strictly following the official Zabbix Module Development Guidelines for version 7.0+:

MVC Architecture:
- Controllers: Located in actions/. Handles routing, file processing, and system utility parsing.
- Views: Located in views/. Renders the UI structure using Zabbix's internal UI classes (no outdated templates or database hacks).
UI Components: Utilizes Zabbix 7.0 native CHtmlPage and CTag components for DOM manipulation.
Performance: Scripts have been refactored to ensure maximum speed by completely removing Zabbix API calls (host/hostgroup logic) from views that are exclusively meant for file reading.

📂 Directory Structure

This is the standard file structure of the Zabbix SNMP Mibs module:

ZabbixSnmp/
├── manifest.json                  # Module configuration
├── Module.php                     # Core module class and menu registration
├── README.md                      # English documentation
├── README_pt.md                   # Portuguese documentation
├── actions/
│   ├── Snmp.php                   # MIB viewer page controller
│   ├── SnmpItemCreate.php         # Item creation controller
│   ├── SnmpSource.php             # MIB Source viewer endpoint
│   ├── SnmpTemplateCreate.php     # Template creation controller
│   └── SnmpWalk.php               # SNMP Walk controller
├── assets/
│   ├── css/
│   │   └── snmp.css               # Main module styles
│   └── images/
│       ├── image-01.png           # Screenshots
│       ├── image-02.png
│       ├── image-03.png
│       ├── image-04.png
│       ├── image-05.png
│       └── image-06.png
├── lib/
│   ├── MibRepository.php          # MIB file parsing and discovery logic
│   ├── SnmpConnectionMapper.php   # SNMP connection mapping logic
│   └── ViewRenderer.php           # UI view renderer
└── views/
    ├── snmp.php                   # MIB viewer page layout
    └── snmp.walk.php              # SNMP Walk layout

🖼️ Screenshots

This section demonstrates the visual capabilities of the module.

1. Main MIB Explorer View

The primary interface showing the selected MIB file, the source code view button, and the structured table containing all parsed SNMP objects.

2. Source Code Viewer Modal

The built-in text viewer allows you to instantly read the raw MIB definitions without leaving the Zabbix interface.

3. SNMP Walk Execution

Real-time testing layout showing an ongoing SNMP Walk query directed at a host.

4. SNMP Item Creation

Directly create Zabbix items from SNMP objects found in the MIBs with automatically filled OIDs and parameters.

5. SNMP Template Creation

Quickly bootstrap full Zabbix templates by importing multiple SNMP objects directly from the MIB explorer.

6. Advanced Interface Settings

View and manage advanced configuration and interface settings to optimize your MIB analysis workflow.

Navigation Menu