Skip to content

Latest commit

 

History

History
52 lines (39 loc) · 3.5 KB

README.md

File metadata and controls

52 lines (39 loc) · 3.5 KB
Raw

Templated Grafana Dashboard for HP LaserJet Printers

Detailed dashboard for monitoring of HP LaserJet printers via SNMP.

The Telegraf collector configuration is MIB-based so all of the required MIBs will need to be available for the collector to perform the needed translations. Most SNMP distributions available on most platforms already provide these, except for one (see below). This configuration uses the "new" SNMP plugin for Telegraf, so SNMP monitoring must be enabled in the printer configuration. The 'agents' list in the configuration is of the actual printers themselves.

The included collector configuration uses a few HP-printer-specific OIDs defined in various HP MIBs. These may be difficult to find currently as the HP developer portal seems to have been taken offline. One example is included in the mibs directory that should be suitable for use here. Add this to one of the search directories for the native SNMP implementation where Telegraf is installed, if needed.

Important Dependency Note

The included Telegraf:SNMP plugin configuration depends upon a feature that is not yet part of the released Telegraf 1.2. Object IP-MIB::ipSystemStatsTable leverages a non-accessible index to identify the IP Version for the statistics in each row. The actual index is the sub-id for each table element, of which the Telegraf:SNMP plugin does not currently make available as a field or tag. However there is a pull-request to add this capability using a new flag 'index_as_tag'

There are two options:

  1. Wait for a formal release of Telegraf with the needed support. The noted PR is tagged for the Telegraf v1.3 milestone.
  2. Build custom version of Telegraf with the required PR applied. The changes needed are entirely contained within the single plugins/inputs/snmp/snmp.go source file so this is a relatively simple change.

Dependencies

  1. InfluxDB as the time-series database
  2. Telegraf as the collector. See above note about specific details.

Quick Start

  1. Enable SNMP monitoring on your HP LaserJet printers via BUI or printer panel.
  2. Merge the included telegraf-inputs.conf with your local Telegraf instance configuration (or create a new instance)
  3. Edit the SNMP 'community' string as appropriate
  4. Edit the 'agents' list to include all of your monitored printers
  5. If you do not already have an InfluxDB output configured in your Telegraf instance: 1. Merge the included telegraf-outputs.conf with your local Telegraf instance configuration: 2. Edit the URL to your new InfluxDB instance 3. Edit the username and password for this InfluxDB instance as appropriate
  6. Restart Telegraf
  7. Import the included hp-laserjet-dashboard.json as a new dashboard into your local Grafana instance

Files

  • hp-laserjet-dashboard.json:
  • Actual Grafana dashboard (no edits required)
  • telegraf-inputs.conf:
  • Telegraf input configuration for use with this dashboard (edits required)
  • telegraf-outputs.conf:
  • Optional Telegraf output configuration for use with this dashboard (edits required)
  • mibs/HP-LASERJET-COMMON-MIB
  • MIB file for HP printer-specific objects (no edits required)

References

This dashboard is not yet available at https://grafana.net/dashboards/, pending a formal release version of Telegraf with the noted 'index_as_tag' support (or similar)