Annotate (Tag) Assets

Use Mondoo annotations to add metadata to an asset. Annotations are key-value pairs that let you tag or categorize your assets. Add whatever metadata you need. Some examples are:

Example key	Example value
owner	cosmo@lunalectric.com
build	terraform
asset-tag	luna000262
team	01research

You can reuse key-value pairs or you can reuse only the key and give each asset a unique value.

For example, suppose you want to create annotations that match the physical asset tags on your company's workstations. You'd give every workstation in your inventory an asset-tag key, but give each workstation a unique value to match the unique physical tags.

As another example, you might assign the key build and the value terraform to every asset in your inventory that is built using Terraform.

Annotations display in the Mondoo Console when you view an asset. When you export data from Mondoo, annotations are included. You can search for assets based on their annotations. To learn how, read Search Your Inventory

Annotate an asset

You can annotate an asset in the Mondoo Console.

tip

You can also add an annotation from the command line or using automation. To learn how, read Annotate (tag) an asset during registration.

1. In the Mondoo Console, navigate to the asset you want to annotate.

2. In the bottom-right corner of the asset page, locate MONDOO ANNOTATIONS.

   

3. Select the + icon.

   

4. Enter a key and a value, then select the ✔️ icon to add the annotation.

   

Change or remove an annotation

1. In the Mondoo Console, navigate to the asset containing the annotation you want to change or remove.

2. In the bottom-right corner of the asset page, locate MONDOO ANNOTATIONS.

   

3. Select the pencil icon.

   

4. Change the key and/or the value, then select the ✔️ icon to save the changes.

   

   To remove the annotation, select the trash can icon.

---