A configuration item graph with a database selected and the services that depend on it highlighted, next to the change impact answer those relationships produce

Configuration Management Database (CMDB)

Back to Data Center Management · Asset Tagging · Rack Elevation Diagrams · Cable and Port Documentation · Service Offerings

A CMDB is a single source of truth that other tools and processes can reference — a record of your configuration items and, critically, of how they relate to one another. The term comes from ITIL, but you do not need to adopt ITIL to get the benefit, and the pages either side of this one are where most of its content comes from.

1. The Relationships Are the Point

This is the distinction that decides whether the exercise is worth anything. An inventory lists things. A CMDB says what depends on what.

An inventory answers "what do we have", which is useful and which asset tagging largely covers on its own. A CMDB answers the questions that have a therefore in them:

Every one of those is a graph traversal, not a lookup. A CMDB built as a flat list of servers with no relationships is an inventory with a more impressive name, and it will not answer any of them.

2. Scope It to the Questions You Actually Ask

The classic failure is the opposite of neglect: an attempt to model the entire estate in exhaustive detail, which produces a schema nobody can populate and a dataset that is stale before it is finished. The projects that fail are almost always the ambitious ones.

Each configuration item type should earn its place by answering a question somebody actually asks. A practical starting set:

Layer Typical items Where it comes from
PhysicalServers, switches, PDUs, racks, sitesAsset register and rack elevations
ConnectivityPorts, links, circuits, addressesCable and port records, discovery
LogicalVirtual machines, containers, clusters, databasesHypervisor, orchestrator and cloud APIs
ApplicationDeployed applications and their instancesDeployment pipeline
ServiceWhat the business actually consumes, and who owns itPeople — this layer cannot be discovered

Start with two layers and the relationships between them, in one domain where somebody has a real question. Extend when the next question demands it. A small CMDB that is right is useful immediately; a comprehensive one that is half right is actively dangerous, because people act on it.

3. Name a System of Record for Every Attribute

A CMDB is usually not the place where facts are born. For each attribute, decide which system owns the truth and have the CMDB take its value from there.

4. Accuracy Decays, So Measure It

A CMDB does not fail loudly. It drifts, quietly, and the damage is done precisely because people still rely on it: a change approved against stale dependencies takes down something nobody expected. An inaccurate CMDB is worse than no CMDB, because an absent one makes people go and check.

So treat accuracy as a measured property, not an aspiration:

5. What It Is Used For

6. Where It Sits Among the Others

The three preceding items each contribute a layer, and the CMDB is where they meet:

Which is also the order to build them in. A CMDB attempted before the physical inventory is trustworthy inherits every error underneath it.

How We Approach It

  1. Start from the questions. Collect the ones people actually ask and cannot currently answer. These determine the scope; nothing else should.
  2. Model only what those questions need — the item types, the attributes, and above all the relationship types.
  3. Name the system of record per attribute, and mark clearly which are discovered and which are human-owned.
  4. Connect discovery for everything a machine can report, and import the physical layers from the asset and cabling records.
  5. Populate one domain end to end, answer a real question with it, and let that earn the next phase.
  6. Set up reconciliation and the accuracy metrics, with the update step inside your change and provisioning processes.

What You Get

The measure of a CMDB is not how much it contains. It is whether someone about to make a change consults it, and whether they were right to.