preview
We're still working on this feature, but we'd love for you to try it out!
This feature is currently provided as part of a preview program pursuant to our pre-release policies.
Agent Control simplifies the management of your infrastructure agents. This guide will walk you through the process of installing Agent Control on your Kubernetes cluster using the guided install.
Dica
Agent Control currently supports Kubernetes, with a public preview for on-host Linux systems in progress.
tip
For automating Agent Control setup across large-scale infrastructure, see Set up Agent Control with Terraform.
Guided install
Log in to New Relic.
Ensure the correct account is selected.
In Integrations & Agents, click Install Agent Control or search for Agent Control.
Select Kubernetes as the instrumentation method.
On the Select your fleet page, choose the fleet to join for the Kubernetes cluster where you're installing Agent Control, then click Continue.
TIP
You must choose a fleet before continuing. If you haven't yet created a fleet for this managed entity, complete the fleet creation process in New Relic Control, and then return to this guided installation step.
- Provide your license key. If you create a new key, make sure you copy it to your clipboard or save it somewhere safe. You'll need it shortly.
- Select either New Relic or OpenTelemetry as your instrumentation source, and then click Continue.
- Enter your cluster name, namespace, and then click Continue.
- Download the generated configuration file to your computer and run the provided command in your terminal to install Agent Control. After installation, click Continue.
- Test the connection to confirm the installation was successful. This step may take 5-10 minutes to complete.
Verify installation
Run the following commands to check the status of your pods:
Agent Control installs sub-agents in a different namespace for security reasons. To verify that everything is working, check that the Agent Control pods are running in the
newrelic-agent-controlnamespace and the sub-agent pods are running in a different one (e.g.,newrelic).
$kubectl get pods -n newrelic-agent-control # Check Agent Control pods$kubectl get pods -n newrelic # Check sub-agents pods- Log in to New Relic, and go to Fleet Control.
- Go to the Fleets page and select the fleet you chose during installation.
- In the Entities table, confirm that your Kubernetes cluster appears in the list.
- Verify that the instrumentation status for your cluster is healthy.
Next steps
Now that Agent Control is installed and running, you're ready to configure and manage your agents or deploy changes to your agents using Fleet Control](/docs/new-relic-control/fleet-control/overview).
Uninstall Agent Control
To uninstall Agent Control from your Kubernetes cluster, run the following commands:
View installed releases
Run the following command to list all installed releases and identify the one for Agent Control:
$helm list --all-namespacesUninstall Agent Control
Replace
<RELEASE>and<NAMESPACE>with the appropriate values for your installation and environment:bash$helm uninstall <RELEASE> -n <NAMESPACE>For example:
bash$helm uninstall agent-control -n newrelic