Skip to content

CMDB / Assets

The Configuration Management Database (CMDB) is the heart of OpsWeave. Assets (Configuration Items) are the central entity — everything else references them.

CMDB Table View

Asset Types

OpsWeave supports 24 asset types in 7 categories:

CategoryTypes
ComputeServer, Virtual Machine, Container, Cloud Instance
NetworkRouter, Switch, Firewall, Load Balancer, Access Point
StorageNAS, SAN, Backup System
SoftwareOperating System, Application, Database, Web Service, API
SecurityCertificate, VPN, Identity Provider
FacilityUPS, PDU, Rack
ServiceBusiness Service, IT Service

Asset Attributes

Each asset has the following standard fields:

FieldDescription
nameTechnical name (e.g. "web-server-01")
display_nameDisplay name
asset_typeType from the list above
statusactive, inactive, maintenance, decommissioned
ip_addressIPv4/IPv6 (max. 45 characters)
locationPhysical location
sla_tiergold, silver, bronze (for SLA inheritance)
environmentproduction, staging, development, test
customer_idAssociated customer
attributesArbitrary JSON attributes (extensible)

Relations (DAG)

Assets can have arbitrary relationships with each other. The relationship model is a Directed Acyclic Graph (DAG) — cycles are prevented.

Relation Types:

TypeMeaning
depends_onA depends on B
runs_onSoftware A runs on Server B
connects_toA is connected to B
managed_byA is managed by B
part_ofA is part of B
hostsA hosts B
backs_upA backs up B
monitorsA monitors B
providesA provides Service B

SLA Inheritance

SLA tiers are inherited through the dependency graph: When Asset A depends on Asset B, A inherits the SLA tier from B (if A does not have its own SLA tier).

The inheritance depth is unlimited — a recursive CTE traverses the DAG.

Asset Detail

The asset detail view has three tabs:

Details: All attributes, inline editing, SLA chain

Relations: Visual graph representation (React Flow) of all dependent/linked assets

CMDB Topology Graph

Tickets: All tickets referencing this asset

REST API

GET    /api/v1/assets                    # List (filter, search, paginate)
POST   /api/v1/assets                    # Create
GET    /api/v1/assets/:id                # Detail
PUT    /api/v1/assets/:id                # Update
DELETE /api/v1/assets/:id                # Delete
GET    /api/v1/assets/:id/relations      # Relations
POST   /api/v1/assets/:id/relations      # Add relation
DELETE /api/v1/assets/:id/relations/:rid # Remove relation
GET    /api/v1/assets/:id/sla-chain      # SLA inheritance chain
GET    /api/v1/assets/:id/tickets        # Linked tickets
GET    /api/v1/assets/:id/graph          # Graph data (React Flow format)
GET    /api/v1/assets/stats              # Statistics (total, by_type, by_status)
GET    /api/v1/assets/types              # Available asset types

Community Limit

The Community Edition allows up to 50 assets per tenant. A warning is displayed when the limit is reached. All existing assets remain fully usable.

Released under the AGPL-3.0 License.