Tag Your Allocators

You tag allocators to indicate what kind of hardware you have available. These tags matter, because they enable instance configurations to filter on allocators where components of the Elastic Stack should get deployed. Without tags, instance configurations will allow Elastic Stack components to get deployed wherever there is space on allocators. With tags, instance configurations can filter out those allocators that are best suited to deploy specific components of the Elastic Stack and make sure they get deployed there.

Allocator tags are a simple way of characterizing the hardware resources that you have in your ECE installation, such as:

  • CPU (compute)
  • Memory
  • Storage
  • I/O

You should tag your allocators under the following circumstances:

  • After you upgrade to or install Elastic Cloud Enterprise 2.0 or later, to characterize what kind of hardware you have available in your installation.
  • Before you create your own instance configurations and your own deployment templates, to indicate what hardware resources you can work with.
  • After you add new allocators to your installation, to indicate what kind of hardware resources they provide.
Tip

You can also delete tags, if you have no more use for them. Keep in mind that removing tags from allocators can in turn affect what allocators get matched. Removing a tag might prompt ECE to move instances of the Elastic Stack to other allocators.

Before You Begin

Your tags should characterize what kind of hardware you have available. As you start developing your own tags, keep in mind that simpler is often better and that the tags you use will likely evolve over time. The main purpose of tagging is to go from this is an allocator, which doesn’t tell you anything about the allocator’s hardware resources, to this is an allocator with better CPU resources or this allocator provides a large amount of spindle-based storage.

Tags are simple key-value pairs. A small sampling of tags that you could use include:

SSD: true, SSD: false, highstorage: true
Indicates if you have fast SSD storage for incoming data (SSD: true) or spindle-based storage that can store larger volumes of less frequently queried data (SSD: false or highstorage: true).
highCPU: true
Indicates allocators that can run CPU-intensive workloads faster than others.
instanceFamily: i3, instanceFamily: m5
Indicates the host type, used extensively on our hosted Elasticsearch Service to identify hosts with specific hardware characteristics. If you run your own hardware on-premise and have standardized on several specific host configurations, you could use similar tags. If you are deploying ECE on another cloud platform, you could use the instance type or machine type names from your provider.

Avoid tags that describe a particular use case or an Elastic Stack component you plan to run on these allocators. Examples of tags to avoid include elasticsearch: false or kibana: true. You should define the intended use at the level of instance configurations instead and tag your allocators only to describe hardware characteristics.

Tip

If you have an allocator that meets several criteria, such as an allocator with multi-purpose hardware, consider assigning it a single tag that identifies its multipurpose view, such as the instanceFamily: i3 example mentioned earlier. While it is not wrong to assign multiple tags to an allocator, filtering on the allocator when you create or edit instance configurations will be simpler with a single tag.

Steps

To tag allocators in the Cloud UI:

  1. Log into the Cloud UI.
  2. From the Platform menu, select Allocators.
  3. Select one of the allocators and locate the Tags section.
  4. Enter values into the Key and Value fields, and then click Add tag. For example: You could add SSD: true and highCPU: true tags from our example tags if your allocator meets these criteria.

    Adding key-value pairs as an allocator tags
  5. Repeat the previous step until you have added all of the tags that you want to use to characterize the hardware of this allocator.