ActiveGate group
You can use ActiveGate groups to perform bulk actions on your ActiveGates, such as managing Extensions 2.0 running on ActiveGates or connecting your Cloud Foundry foundations.
Requirements
- 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
Dynatrace-ActiveGate-Windows-x86-<version>.exe --set-group=my-group
Assign to a group after installation
To assign ActiveGates to a group
-
In the Dynatrace menu, go to Deployment status and select ActiveGates.
-
In the ActiveGates table, select one or more ActiveGates.
When you select ActiveGates, a command panel is displayed at the bottom of the page.
-
In the command panel, select modify ActiveGate group > Run action.
-
Choose whether to add or remove the ActiveGate group assignment for the selected ActiveGates.
- Specify ActiveGate group to be assigned—In the list/edit box, start typing an ActiveGate group name to show matching groups or create a new group.
- Remove current ActiveGate group assignment
-
Select Next and review your changes before applying them.
- Affected entities—does this preview number match the number of ActiveGates whose group assignment you expected to update?
- Settings change—does this action match what you intended to do to the selected ActiveGates?
- Number of ActiveGates assigned to "[group name]" ActiveGate group—do the preview numbers match what you expected to change?
-
Based on the preview, select your next action.
- If the preview looks good, select Apply changes
- If you need to adjust something, select Back
- If you no longer want to run this command, select Cancel
Alternatively, you can use the group
ActiveGate configuration property. For example:
[collector]
group = mygroup
For more information, see Basic rules for working with ActiveGate configuration
Extensions
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