Creating a Custom Environment

The first time you import your account into Hava you'll notice that it uses either your VPC's (AWS) or Virtual Networks (Azure) to separate the different resources into individual environments. While this can give a good overview of your account it's not always the view you want. You may want to show only those resources with a certain tag - regardless of the region, or you may want to see what everything in a particular region could cost you.


Search allows you create environment diagrams tailored to your requirements. By specifying a combination of attributes you can determine how your environment is drawn. Custom environments are linked to your imports too - as you add or remove resources in your account, Hava updates your custom environment.

If your search matches a resource we'll also do our best to draw anything important to give it context. If you search for an instance it will draw the containing subnet and VPC, as well as any related security groups. If you search for a load balancer it will draw the connected instances. This means that whatever you find in your search it will still draw a clear network diagram.

Using the Search Bar

The custom search input is at the top left of the screen. You'll need to use one (or more) of the following search modifiers:


Add all resources in a particular region.

region:us-west-1 will add everything in us-west-1 to your environment

region:us-west-1 region:us-west-2 will add both regions to your environment



Returns all resources within a VPC.

vpc:vpc-1234 will return the VPC with the ID 'vpc-1234' and all resources connected to it.

vpc:vpc-1234 vpc:vpc-5678 will return both of the VPCs and all their connected resources.


Will return the subnet and all resources within it.

subnet:subnet-1234 will add the subnet 'subnet-1234' and all resources within it.


Will return the resource group and all resources within it. (Azure)

resource_group:/subscriptions/1/resourcegroups/rg will add the resource group 'rg' and all resources within it.


Any other value followed by a colon is considered a tag name. Anything with that tag name and value will be added to the environment. If the tag value has spaces you will need to surround it by quotes.

environment:production will add everything that has a tag 'environment' with the value 'production'

name:"production instance" will add everything that has a tag 'name' with the value 'production instance'

Creating an Environment

By entering one or more search parameters into the custom search input you will begin the creation or your custom environment. Once the query is complete you will be redirected to a view of the environment that matches your search terms. Add or remove search terms and the diagram will automatically update with the current result.

Once you are happy with what you see click the save button, enter a name for your new environment, and submit. You will be redirected to your new environment and it will also show in the environments list. As you import more resources from your account, Hava will run your custom search again and update the environment to match.