Getting Started with NetBox Assurance
This guide will help you set up, configure, and start using NetBox Assurance to maintain accurate network documentation and proactive drift detection. Follow these steps to go from installation to your first operational workflow.
Prerequisites
Before enabling NetBox Assurance, ensure you have:
Technical Requirements
- NetBox Enterprise 1.10+ or NetBox Cloud (coming soon) with Assurance add-on
- Active NetBox Assurance license
- Network connectivity for data ingestion sources
Data Sources
To maximize value from NetBox Assurance, you'll need at least one data source:
- NetBox Discovery - Recommended for automated network discovery
- Controller integrations - For centralized network management platforms
- Custom integrations - Using the Diode SDK
Team Preparation
- Identify team members who will manage deviations
- Define your drift tolerance and remediation policies
- Plan your initial network segment for testing
Installation and Setup
NetBox Enterprise
NetBox Assurance is available as an optional component of NetBox Enterprise. During installation, your license file determines whether Assurance is enabled.
Installation Steps:
- Verify your license includes NetBox Assurance entitlement
- During NetBox Enterprise installation, Assurance services are automatically deployed if licensed
- The NetBox Assurance UI and Diode data plugins are installed automatically
- Access the Assurance menu in your NetBox interface to confirm installation
NetBox Cloud
NetBox Assurance will be available as an optional add-on for NetBox Cloud in a future release.
Coming Soon: NetBox Assurance for NetBox Cloud is currently in development. When available, it will feature:
- Seamless integration as an optional add-on
- Automatic provisioning and setup
- Built-in UI and Diode data plugins
- No additional configuration required
Stay tuned for availability updates.
Verification
After installation, verify NetBox Assurance is working:
- Log into your NetBox instance
- Look for the Assurance menu in the sidebar
- Navigate to Assurance > Deviations to access the main interface
- Confirm you can see the deviation management interface
Initial Configuration
Data Source Setup
Choose and configure your primary data source:
Option 1: NetBox Discovery (Recommended)
- Follow the NetBox Discovery setup guide
- Configure discovery agents for your network segments
- Set up automated discovery schedules
- Verify data is flowing into NetBox
Option 2: Controller Integrations
- Configure your network controllers (VMware vCenter, Juniper Mist, etc.)
- Set up API access and credentials
- Configure data collection schedules
- Test connectivity and data flow
Option 3: Custom Diode Integration
- Review the Diode integration documentation
- Develop custom integrations using Python or Go SDKs
- Configure data ingestion pipelines
- Test data flow and validation
Your First Workflow
Phase 1: Initial Data Ingestion
Start with a small, well-understood network segment:
- Select a test segment: Choose 10-20 devices you know well
- Configure data source: Set up discovery or integration for this segment
- Initial ingestion: Run your first data collection
- Review results: Check that devices appear correctly in NetBox
Phase 2: Understanding Deviations
Learn how NetBox Assurance detects and presents drift:
- Access deviations: Navigate to Assurance > Active Deviations
- Review first deviations: Examine what Assurance detected
- Understand the interface: Familiarize yourself with the interface documentation
- Analyze changes: Click on individual deviations to see detailed change analysis
Phase 3: Processing Your First Deviations
Practice the remediation workflow:
- Triage deviations: Determine which require action
- Apply safe changes: Start with obvious corrections (e.g., missing devices)
- Ignore acceptable drift: Mark intentional differences as ignored
- Document decisions: Use NetBox's change logging for audit trails
Phase 4: Operational Integration
Establish ongoing processes:
- Daily review schedule: Set up regular deviation review sessions
- Team workflows: Define roles and responsibilities for deviation management
- Escalation procedures: Create processes for complex or critical deviations
- Expand coverage: Gradually add more network segments
Common Implementation Patterns
Day 1: Initial NetBox Population
Use NetBox Assurance to control the initial population of your NetBox instance:
Workflow:
- Configure data sources for comprehensive network discovery
- Review all discovered devices before accepting into NetBox
- Use deviations to validate data quality and completeness
- Establish baseline documentation with confidence
Benefits:
- Controlled onboarding with review and approval workflows
- Data quality validation before information becomes your source of truth
- Faster time to value with confidence in documentation accuracy
Day 1.5: Improving Network Management Maturity
Gradually improve your network documentation while maintaining operations:
Workflow:
- Focus on high-priority network segments first
- Use drift patterns to identify process improvement opportunities
- Implement automation based on consistent deviation types
- Build foundation for advanced network automation
Benefits:
- Gradual documentation improvement without disrupting daily operations
- Process improvement insights based on drift detection patterns
- Foundation building for network automation initiatives
Day 2: Operational Excellence
Maintain high-quality network documentation for mature operations:
Workflow:
- Monitor for unauthorized or unexpected configuration changes
- Validate network automation results automatically
- Integrate with change management processes
- Use for compliance reporting and auditing
Benefits:
- Proactive drift detection for mature network operations teams
- Immediate response to unauthorized or unexpected configuration changes
- Continuous validation of network automation results and change management processes
Integration with Existing Workflows
Change Management Integration
- Pre-change validation: Verify current state before making changes
- Post-change verification: Confirm changes were applied correctly
- Rollback detection: Identify when changes need to be reverted
Incident Response Enhancement
- Faster troubleshooting: Access to accurate, real-time network state
- Root cause analysis: Historical tracking of configuration changes
- Documentation trust: Confidence in network documentation during incidents
Compliance and Auditing
- Automated compliance checking: Continuous validation against standards
- Audit trail maintenance: Historical record of all network changes
- Reporting capabilities: Generate compliance reports and metrics
Troubleshooting Common Issues
No Deviations Appearing
- Verify data sources are configured and running
- Check network connectivity between sources and NetBox
- Confirm permissions are set correctly
- Review logs for ingestion errors
Too Many False Positives
- Review your tolerance settings for acceptable drift
- Use the ignore function for known acceptable differences
- Refine your data source configurations
- Consider adjusting detection sensitivity
Performance Issues
- Use date range filters to limit large datasets
- Process deviations in smaller batches
- Schedule data ingestion during off-peak hours
- Contact support for optimization guidance
Next Steps
Once you've completed your initial setup and first workflow:
- Master the Interface - Learn advanced features and workflows
- Expand NetBox Discovery - Add more network segments and device types
- Explore Diode Integration - Build custom integrations for specialized needs
- Scale Operations - Expand to full network coverage and integrate with enterprise workflows
Support and Resources
- Interface Documentation: Detailed guide to using the NetBox Assurance interface
- NetBox Discovery: Complete setup and configuration guide
- Diode Integration: Advanced API and SDK documentation
- Community Support: Connect with the community on Slack in the
#netbox
channel
NetBox Assurance transforms network operations by ensuring your documentation stays current and accurate. Follow this guide to establish a solid foundation for maintaining network documentation integrity and enabling confident network automation.