title: NetBox: Data sources
agents: netbox
catalog: app/netbox
license: GPLv2
distribution: check_mk
description:
 One service per NetBox data source (git, S3 or local) from
 {/api/core/data-sources/}. Reports the sync status, the age of the last sync
 and the number of synced files. Status {failed} is {CRIT} and a disabled data
 source is {WARN} by default.

 Two failure modes get dedicated handling:

 A source that reports {completed} but last synced days ago is broken regardless
 of its status field. When no explicit levels are set, the levels on the sync age
 are derived from the source's own sync interval ({WARN} at twice the interval,
 {CRIT} at four times).

 A source whose worker died during the sync stays in the {syncing} state
 indefinitely and can no longer be synced from the UI - a well-known NetBox
 failure mode. A source that has been "syncing" for more than an hour is {CRIT}
 by default.

 All states and levels are configurable via the rule "NetBox data sources".

item:
 The data source name.

discovery:
 One service per data source. Service labels carry the backend type
 ({netbox/datasource_type}).
