How pdf/zfs_exporter works
ZFS Exporter exposes ZFS pool and dataset state as Prometheus metrics. A scrape enters the HTTP metrics handler, which invokes the registered exporter; its collection coordinator selects pools and enabled collector types, queries ZFS, transforms selected properties, and emits metrics. The coordinator also enforces deadlines and serves cached values while a slow collection continues. The README documents pool, filesystem, snapshot, volume, property, exclusion, and host-root controls; the excerpts show the collection and CLI layers, but not all configuration or host-root wiring.
Main entry points: collector/zfs.go Scrape Coordinator · zfs/zfs.go ZFS Client · collector.go Property Mapping · pool.go Pool Metrics
Components 18
Exporter Runtime
- Exporter Main
zfs_exporter.go - Metrics HTTP
zfs_exporter.go
Metric Collection
- Scrape Coordinator
collector/zfs.go - Metric Cache
collector/cache.go - Pool Metrics
collector/pool.go - Filesystem Metrics
collector/dataset.go - Snapshot Metrics
collector/dataset.go - Volume Metrics
collector/dataset.go - Property Mapping
collector/collector.go - Value Transforms
collector/transform.go
ZFS Access
- ZFS Client
zfs/zfs.go - Pool Queries
zfs/pool.go - Dataset Queries
zfs/dataset.go - CLI Runner
zfs/zfs.go - Host-Root Runner
zfs/hostroot_linux.go
Metric Output
- Prometheus Metrics
zfs_exporter.go
Other components
- Prometheus Scraper
- ZFS CLI
Connections 24
- Prometheus Scraper → Metrics HTTP: scrapes
README.md - Exporter Main → Scrape Coordinator: constructs
zfs_exporter.go - Metrics HTTP → Prometheus Metrics: serves
zfs_exporter.go - Scrape Coordinator → Metric Cache: reads and updates
collector/zfs.go - Scrape Coordinator → Pool Metrics: dispatches
collector/zfs.go - Scrape Coordinator → Filesystem Metrics: dispatches
collector/zfs.go - Scrape Coordinator → Snapshot Metrics: dispatches
collector/zfs.go - Scrape Coordinator → Volume Metrics: dispatches
collector/zfs.go - Pool Metrics → ZFS Client: queries
collector/pool.go - Filesystem Metrics → ZFS Client: queries
collector/dataset.go - Snapshot Metrics → ZFS Client: queries
collector/dataset.go - Volume Metrics → ZFS Client: queries
collector/dataset.go - Pool Metrics → Property Mapping: maps properties
collector/pool.go - Filesystem Metrics → Property Mapping: maps properties
collector/dataset.go - Snapshot Metrics → Property Mapping: maps properties
collector/dataset.go - Volume Metrics → Property Mapping: maps properties
collector/dataset.go - Property Mapping → Value Transforms: converts values
collector/collector.go - ZFS Client → Pool Queries: creates
zfs/zfs.go - ZFS Client → Dataset Queries: creates
zfs/zfs.go - Pool Queries → CLI Runner: executes commands
zfs/pool.go - Dataset Queries → CLI Runner: executes commands
zfs/dataset.go - CLI Runner → ZFS CLI: runs
zfs/zfs.go - Host-Root Runner → ZFS CLI: runs chrooted
zfs/hostroot_linux.go - Scrape Coordinator → Prometheus Metrics: emits
collector/zfs.go