# Zabbix Printer Monitoring Templates

## Overview

This project provides comprehensive Zabbix 7.4 templates for monitoring HP and Xerox network printers via SNMP v2. Five specialized templates have been created to handle the different OID index mappings used by various printer models.

## Template Files

All templates are available in both YAML and JSON formats:

1. **HP LaserJet - Monochrome** (`zabbix_template_hp_mono.*`)
   - 10 monitoring items
   - Covers: HP LaserJet Pro 4xxx, M4xx, M6xx (B&W models)
   - Monitors: Black toner, Maintenance kit

2. **HP LaserJet - Color** (`zabbix_template_hp_color.*`)
   - 20 monitoring items
   - Covers: HP Color LaserJet Pro, M4xx, M2xx (Color models)
   - Monitors: Black/Cyan/Magenta/Yellow toners

3. **Xerox VersaLink - Color** (`zabbix_template_xerox_color.*`)
   - 41 monitoring items
   - Covers: Xerox VersaLink C7xxx, C4xxx (Color MFPs)
   - Monitors: 4 toners, 4 drums, waste, transfer components, fuser

4. **Xerox VersaLink - Monochrome** (`zabbix_template_xerox_mono.*`)
   - 14 monitoring items
   - Covers: Xerox VersaLink B7xxx, B4xxx (B&W MFPs)
   - Monitors: Toner, drum, transfer roller, fuser

5. **Xerox Enterprise - Color** (`zabbix_template_xerox_enterprise.*`)
   - 28 monitoring items
   - Covers: Xerox EC8036, AltaLink C8xxx (Enterprise Color MFPs)
   - Monitors: 4 toners, 4 drums, fuser, waste, 2 transfer components (percentage-based)

## Network Coverage

Total printers: 27

- HP Monochrome: 13 printers
- HP Color: 3 printers
- Xerox VersaLink Color: 4 printers
- Xerox VersaLink Mono: 3 printers
- Xerox Enterprise: 4 printers

Full IP-to-template mapping available in `printer_template_mapping.py` output.

## Import Instructions

### Method 1: Zabbix Web UI

1. Login to Zabbix web interface
2. Navigate to: **Configuration → Templates → Import**
3. Select the appropriate YAML or JSON file for each printer type
4. Click **Import**
5. Repeat for each template file

### Method 2: Zabbix API

Use the Zabbix API to import templates programmatically. See Zabbix documentation for details.

## Configuring Printers

For each printer host in Zabbix:

1. **Link Template**: Assign the appropriate template based on model (see IP mapping below)
2. **Configure SNMP Interface**:
   - IP Address: Printer IP
   - Port: 161
   - SNMP version: SNMPv2
   - SNMP community: `WestJeff2025`

## Template to IP Mapping

### HP LaserJet - Monochrome (zabbix_template_hp_mono)
```
10.80.92.23, 10.80.92.24, 10.80.92.26, 10.80.92.28, 10.80.92.46, 10.80.92.53,
10.80.92.54, 10.80.92.55, 10.80.92.56, 10.80.92.57, 10.80.92.61, 10.80.92.65, 10.80.92.71
```

### HP LaserJet - Color (zabbix_template_hp_color)
```
10.80.92.51, 10.80.92.52, 10.80.92.67
```

### Xerox VersaLink - Color (zabbix_template_xerox_color)
```
10.80.92.20, 10.80.92.25, 10.80.92.69, 10.80.92.70
```

### Xerox VersaLink - Monochrome (zabbix_template_xerox_mono)
```
10.80.92.251, 10.80.92.45, 10.80.92.48
```

### Xerox Enterprise - Color (zabbix_template_xerox_enterprise)
```
10.80.92.252, 10.80.92.253, 10.80.92.49, 10.80.92.62
```

## Technical Details

### SNMP OIDs Used

**Standard Printer MIB (RFC 3805):**
- Model: `1.3.6.1.2.1.25.3.2.1.3.1`
- Supply Description: `1.3.6.1.2.1.43.11.1.1.6.1.X`
- Supply Max Capacity: `1.3.6.1.2.1.43.11.1.1.8.1.X`
- Supply Current Level: `1.3.6.1.2.1.43.11.1.1.9.1.X`

**HP Vendor-specific MIB:**
- Maintenance Kit: `1.3.6.1.4.1.11.2.3.9.4.2.1.4.1.2.1.X`

### Alert Thresholds

- **Warning**: 20% remaining
- **High**: 10% remaining

### Features

- JavaScript preprocessing for hex-encoded SNMP strings
- Calculated items for percentage calculations
- Trigger expressions with part number validation
- Support for both capacity-based and percentage-based supply levels
- Supply compatibility notes in trigger messages for ordering alternatives

## Scripts

### analyze_all_printers.py
Analyzes all printer CSV files to identify OID patterns and categorize printer models.

### generate_printer_templates.py
Generates all Zabbix templates in YAML and JSON formats. Run this script to regenerate templates if modifications are needed.

### printer_template_mapping.py
Maps each printer IP to its correct template based on model detection. Provides detailed output for manual configuration.

### check_unknown_printers.py
Utility script to analyze printers that don't match existing template patterns.

## Maintenance

To update templates:

1. Modify template configurations in `generate_printer_templates.py`
2. Run: `python3 generate_printer_templates.py`
3. Re-import updated templates to Zabbix

## Troubleshooting

### No data from printer

1. Verify SNMP is enabled on printer
2. Check SNMP community string matches `WestJeff2025`
3. Verify network connectivity and firewall rules (UDP 161)
4. Test with snmpwalk: `snmpwalk -v2c -c WestJeff2025 <printer-ip> 1.3.6.1.2.1.43`

### Wrong supply levels

1. Verify correct template is assigned for printer model
2. Check OID indices match your printer model
3. Export SNMP data: `python3 snmp_export.py <printer-ip>`
4. Analyze with: `python3 analyze_all_printers.py`

### Missing supplies

Some printer models may have additional supplies not covered by templates. Add custom items based on SNMP export analysis.

## Supply Compatibility Reference

When Zabbix triggers alert for low supplies, the trigger message includes a note to check compatibility alternatives. The following consolidations have been verified:

### HP LaserJet Toner Compatibility

**CF258A/CF258X (58A/58X)** - HP LaserJet Pro M404n/M406
- Both standard (CF258A) and high-yield (CF258X) versions are compatible
- Models share identical toner and fuser components

**CF500A/CF501A/CF502A/CF503A (202A Series)** - HP Color LaserJet M254dw
- Black: CF500A (202A Black) - NOT W2020A (414A)
- Cyan: CF501A (202A Cyan) - NOT W2021A
- Yellow: CF502A (202A Yellow) - NOT W2022A
- Magenta: CF503A (202A Magenta) - NOT W2023A

**CE390A/CE390X (90A/90X)** - HP LaserJet M4555/M602/M603
- Standard and high-yield versions compatible across all three models
- High consolidation value for fleet management

**Q5942A/Q5942X (42A/42X)** - HP LaserJet 4250/4350
- Both capacities work across model range
- Legacy models still in service

**CE255X (55X)** - HP LaserJet P3015/P3010
- Single part number for both models

### Xerox Toner Compatibility

**106R03536-39 Series** - Xerox VersaLink C405/C400
- Black: 106R03536 (10.5K pages)
- Cyan: 106R03537 (10.5K pages)
- Magenta: 106R03538 (10.5K pages)
- Yellow: 106R03539 (10.5K pages)

**106R03580-82 Series** - Xerox VersaLink B405/B400
- Standard: 106R03580 (5.9K pages)
- High-yield: 106R03582 (13.9K pages)
- Extra high-yield: 106R03581 (24.6K pages)

For complete compatibility details and part-specific notes, refer to the `SUPPLY_COMPATIBILITY` dictionary in `generate_printer_templates.py`.

## Files Structure

```
/home/camp/snmp-scanner/
├── README.md                           # This file
├── generate_printer_templates.py       # Template generator
├── printer_template_mapping.py         # IP to template mapper
├── analyze_all_printers.py             # OID pattern analyzer
├── check_unknown_printers.py           # Unknown printer analyzer
├── zabbix_template_hp_mono.yaml        # HP mono template (YAML)
├── zabbix_template_hp_mono.json        # HP mono template (JSON)
├── zabbix_template_hp_color.yaml       # HP color template (YAML)
├── zabbix_template_hp_color.json       # HP color template (JSON)
├── zabbix_template_xerox_color.yaml    # Xerox VersaLink color (YAML)
├── zabbix_template_xerox_color.json    # Xerox VersaLink color (JSON)
├── zabbix_template_xerox_mono.yaml     # Xerox VersaLink mono (YAML)
├── zabbix_template_xerox_mono.json     # Xerox VersaLink mono (JSON)
├── zabbix_template_xerox_enterprise.yaml  # Xerox Enterprise (YAML)
└── zabbix_template_xerox_enterprise.json  # Xerox Enterprise (JSON)

/home/camp/output/
└── printer-*.csv                       # SNMP exports from printers
```

## Support

For issues or questions, review the SNMP exports in `/home/camp/output/` and analyze with the provided Python scripts.