Skip to content

v2.4-beta1 - 2018-07-17

Pre-release
Pre-release
Compare
Choose a tag to compare
@jeremystretch jeremystretch released this 17 Jul 15:27

WARNING: This is a pre-release beta version of NetBox intended only for testing. It is not suitable for production use, and will not provide an upgrade path to future releases.

New Features

Webhooks (#81)

Webhooks enable NetBox to send a representation of an object every time one is created, updated, or deleted. Webhooks are sent from NetBox to external services via HTTP, and can be limited by object type. Services which receive a webhook can act on the data provided by NetBox to automate other tasks.

Special thanks to John Anderson for doing the heavy lifting for this feature!

Tagging (#132)

Tags are free-form labels which can be assigned to a variety of objects in NetBox. Tags can be used to categorize and filter objects in addition to built-in and custom fields. Objects to which tags apply now include a tags field in the API.

Contextual Configuration Data (#1349)

Sometimes it is desirable to associate arbitrary data with a group of devices to aid in their configuration. (For example, you might want to associate a set of syslog servers for all devices at a particular site.) Context data enables the association of arbitrary data (expressed in JSON format) to devices and virtual machines grouped by region, site, role, platform, and/or tenancy. Context data is arranged hierarchically, so that data with a higher weight can be entered to override more general lower-weight data. Multiple instances of data are automatically merged by NetBox to present a single dictionary for each object.

Change Logging (#1898)

When an object is created, updated, or deleted, NetBox now automatically records a serialized representation of that object (similar to how it appears in the REST API) as well the event time and user account associated with the change.

Enhancements

  • #238 - Allow racks with the same name within a site (but in different groups)
  • #1673 - Added object/list views for services
  • #1687 - Enabled custom fields for services
  • #1739 - Enabled custom fields for secrets
  • #1794 - Improved POST/PATCH representation of nested objects
  • #2029 - Added optional NAPALM arguments to Platform model
  • #2034 - Include the ID when showing nested interface connections (API change)
  • #2118 - Added latitude and longitude fields to Site for GPS coordinates
  • #2131 - Added created and last_updated fields to DeviceType
  • #2157 - Fixed natural ordering of objects when sorted by name

API Changes

  • Introduced the /extras/config-contexts/, /extras/object-changes/, and /extras/tags/ API endpoints
  • API writes now return a nested representation of related objects (rather than only a numeric ID)
  • The dcim.DeviceType serializer now includes created and last_updated fields
  • The dcim.Site serializer now includes latitude and longitude fields
  • The ipam.Service and secrets.Secret serializers now include custom fields
  • The dcim.Plaform serializer now includes a free-form (JSON) napalm_args field