Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
51 changes: 49 additions & 2 deletions content/en/agent/fleet_automation/remote_management.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,8 +12,9 @@

## Overview

Remote Agent management with Fleet Automation simplifies how you deploy and upgrade your Datadog Agents. Instead of relying on external deployment or configuration tools, you can perform these actions directly from the Datadog platform. With Fleet Automation, you can:
1. [Upgrade your Agent](#upgrade-agents)
Remote Agent management with Fleet Automation simplifies how you deploy and upgrade your Datadog Agents and SDKs. Instead of relying on external deployment or configuration tools, you can perform these actions directly from the Datadog platform. With Fleet Automation, you can:
1. [Upgrade your Agent](#upgrade-agents)
1. [Upgrade your SDKs](#upgrade-sdks)
1. [Configure your Agent](#configure-datadog-agents)


Expand Down Expand Up @@ -117,6 +118,51 @@
For the most consistent upgrade experience, Datadog recommends managing upgrades from one source at a time. Use either Fleet Automation or a configuration management tool. If you run a configuration management tool on an Agent that has already been upgraded using Fleet Automation, the upgrade reverts the Agent to the [`DD_AGENT_MINOR_VERSION`][9] specified in your configuration. If no `DD_AGENT_MINOR_VERSION` is set, the Agent is upgraded to the latest available version.


## Upgrade SDKs

Check warning on line 121 in content/en/agent/fleet_automation/remote_management.md

View workflow job for this annotation

GitHub Actions / vale

Datadog.headings

'Upgrade SDKs' should use sentence-style capitalization.

{{< callout url="https://www.datadoghq.com/product-preview/remote-upgrade-of-sdk-versions/" btn_hidden="false" header="Join the Preview!" >}}
Remotely upgrade the SDKs that power APM, Profiler, Dynamic Instrumentation, and more. Request access to join the preview.
{{< /callout >}}

Fleet Automation can centrally manage remote upgrades to the SDKs that power APM, Continuous Profiler, Dynamic Instrumentation, and more. Keeping your services' SDK versions up to date lets you benefit from the latest features, performance improvements, bug fixes, and security updates.

<div class="alert alert-info">
Scheduling SDK upgrades is not supported.
</div>

### Requirements

- **Single Step Instrumentation (SSI)**

You must already be instrumenting services with [Single Step Instrumentation (SSI)][20].
- **Linux or Windows VMs**

Supported only for services running on **Linux or Windows VMs**. Remotely upgrading SDKs in containerized or Kubernetes environments is not supported.


{{% collapse-content title="How to upgrade SDKs remotely" level="h4" expanded=false id="upgrade-sdks-steps" %}}

1. In Fleet Automation, open the [Upgrade Agents][1] tab and click **Upgrade Now**.

Check warning on line 145 in content/en/agent/fleet_automation/remote_management.md

View workflow job for this annotation

GitHub Actions / vale

Datadog.tense

Avoid temporal words like 'Now'.

{{< img src="/agent/fleet_automation/upgrade-screen2.png" alt="The Upgrade Agents tab with the Upgrade Now button highlighted." style="width:100%;" >}}

1. Select the **SDK language** and **version**. You can update one language SDK at a time.

{{< img src="agent/fleet_automation/sdk-upgrade-language.png" alt="Select the language and version to upgrade to." style="width:100%;" >}}

1. Select the hosts on which you want to upgrade the selected SDK. You can target a group by filtering on host information or tags.

{{< img src="agent/fleet_automation/sdk-upgrade-hosts.png" alt="Service selection screen with filtering options to narrow the list of services to upgrade." style="width:100%;" >}}

1. Review the deployment plan and click **Upgrade Hosts** to start the upgrade.

{{< img src="agent/fleet_automation/sdk-upgrade-plan.png" alt="Deployment plan view showing the list of services staged for SDK upgrade." style="width:100%;" >}}

1. Restart the services to start using the upgraded SDKs.

[1]: https://app.datadoghq.com/fleet/agent-upgrades
{{% /collapse-content %}}

## Configure Datadog Agents

Fleet Automation allows you to roll out and manage Datadog Agent configuration at scale. Configuration changes can be applied using guided workflows in the UI or by providing custom YAML files. Fleet Automation allows you to standardize Agent configuration across environments. With Fleet Automation, you can:
Expand Down Expand Up @@ -220,3 +266,4 @@
[17]: https://docs.datadoghq.com/agent/remote_config/?tab=configurationyamlfile#configuration-order-precedence
[18]: /agent/fleet_automation#view-agent-audit-trail-events
[19]: /api/latest/fleet-automation/
[20]: /tracing/trace_collection/automatic_instrumentation/single-step-apm/
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.