Review license utilization

Go to Administer, select License Management, and open the Utilization tab.

Utilization sits beside the license rather than on a page of its own, because the figure only means something next to the capacity it is measured against.

The tab reports the trailing 30 days. That window is fixed on this screen.

The DB Target Capacity card is the figure the screen exists to answer: how many distinct database targets were seen, against how many the license grants.

Your licensed capacity can come from more than one license file, so the card splits the total into two parts:

• Included: the database targets that come with your base license, which is the license for your Liquibase Secure subscription.

• Add-on: extra database targets you bought separately. They arrive in their own add-on license file and add to the capacity of your base license.

For example, a base license for 750 targets plus an add-on for 250 targets shows as Included 750 and Add-on 250, for a total of 1,000. If no add-on license is in effect, the card shows only the Included segment.

A consolidated license file works differently. Instead of giving you your base license and your add-ons as separate files, Liquibase can combine them into one consolidated file. Liquibase adds up the capacity before it signs the file, so the file holds a single total. The card shows that whole total as Included, even if part of it originally came from an add-on. For example, a consolidated file built from a 750-target base license and a 250-target add-on shows Included 1,000 and no Add-on segment.

If you later import a separate add-on file on top of a consolidated file, that add-on does appear as its own Add-on segment. To see which files make up your license, see Review the effective license.

If usage exceeds the licensed capacity, the installation is in an explicit out of contract state. Nothing stops working. It is a contract term to resolve with your Liquibase account team, not an outage.

Two cards break the same figure down in different ways:

• Targets by DB Type counts targets against the database types your license covers. A type in use that the license does not grant is reported rather than blocked.

• By Environment & Team groups targets by the environment of the registered connection each one matched.

Environment comes from your registered connections. A reported target only shows a name and an environment if a Connection matching its host, port, and database exists. Targets that matched no registered connection are counted under Unmatched.

Registering your connections is therefore a setup step with a visible consequence here: unregistered targets still count toward capacity, but they stay unattributed.

The Reporting Nodes table lists each node that reported, with its tracking ID, the number of targets it accounted for, and when it last reported.

The SOURCE and CLI VERSION columns are present but not yet populated.

Below the table, a line states how many nodes are inside the configured reporting window. A node that has been silent for longer than the stale window is called out, and the days it already reported still count toward the figures above.

The stale window is configurable and defaults to 7 days. See Configure license alerts and thresholds.

The Utilization tab always covers the last 30 days. If no Change Automation node has reported to this installation yet, the tab shows two things instead of the usual figures:

• The DB Target Capacity card says no usage was being recorded, so there is no figure to compare.

• A card below it reads This window is not recorded.

This is not the same as zero usage. Not recorded means nothing reported during the period, so Liquibase has no data about it. Zero would mean nodes reported and nothing ran. The difference matters if you use these figures in an audit. The breakdown cards and the Reporting Nodes table appear once the first node reports.

Select Export and choose CSV or JSON. The export covers the same window the screen resolved, so the file and the figures beside the button agree.