- The name of an ActiveGate group is a string of alphanumeric characters, hyphens (
-), underscores (
_), and dots (
- Dots are used as separators, so you must not use a dot as the first character of a group name.
- The length of the string is limited to 256 characters.
Assign ActiveGate to a group
An ActiveGate can belong to only one group. By default, an ActiveGate is assigned to the
default group. You can assign an ActiveGate to a group during or after installation.
Assign to a group during installation
To assign an ActiveGate to a group, you can use the
--set-group installation parameter during installation. Note that you can't use this parameter during an ActiveGate update. For example:
/bin/bash Dynatrace-ActiveGate-Linux-x86-<version>.sh --set-group=my-group
Assign to a group after installation
group ActiveGate configuration property. For example:
[collector] group = mygroup
For more information, see Basic rules for working with ActiveGate configuration
An ActiveGate running a remote extension needs to belong to an ActiveGate group because Dynatrace uses a group to instruct the extension where it should run. If you plan to use a single ActiveGate to run a remote extension, assign it to a dedicated group containing only that ActiveGate.
When activating the extension, you need to specify an ActiveGate group that will run your extension. You can select an ActiveGate group either during the Dynatrace Hub-based activation workflow, or specify an ActiveGate group name in the JSON payload used to activate the extension using the Dynatrace API.
Cloud Foundry foundations
When connecting Dynatrace to Cloud Foundry foundations, you specify an ActiveGate group responsible for querying Cloud Foundry for data. For more information, see Connect your Cloud Foundry foundations with Dynatrace