Skip to content

Commit 6650ffa

Browse files
Upgrade SDKs in Fleet Automation preview (#34809)
* Upgrade SDKs in Fleet Automation preview * Update content/en/agent/fleet_automation/remote_management.md Co-authored-by: Janine Chan <64388808+janine-c@users.noreply.github.com> * Update content/en/agent/fleet_automation/remote_management.md Co-authored-by: Janine Chan <64388808+janine-c@users.noreply.github.com> * Update content/en/agent/fleet_automation/remote_management.md Co-authored-by: Janine Chan <64388808+janine-c@users.noreply.github.com> * Update content/en/agent/fleet_automation/remote_management.md Co-authored-by: Janine Chan <64388808+janine-c@users.noreply.github.com> * Update content/en/agent/fleet_automation/remote_management.md Co-authored-by: Janine Chan <64388808+janine-c@users.noreply.github.com> * Update content/en/agent/fleet_automation/remote_management.md Co-authored-by: Janine Chan <64388808+janine-c@users.noreply.github.com> * Update content/en/agent/fleet_automation/remote_management.md Co-authored-by: Janine Chan <64388808+janine-c@users.noreply.github.com> * Update content/en/agent/fleet_automation/remote_management.md Co-authored-by: Janine Chan <64388808+janine-c@users.noreply.github.com> * Update content/en/agent/fleet_automation/remote_management.md Co-authored-by: Janine Chan <64388808+janine-c@users.noreply.github.com> * Update content/en/agent/fleet_automation/remote_management.md Co-authored-by: Janine Chan <64388808+janine-c@users.noreply.github.com> * Update content/en/agent/fleet_automation/remote_management.md Co-authored-by: Janine Chan <64388808+janine-c@users.noreply.github.com> * Update content/en/agent/fleet_automation/remote_management.md Co-authored-by: Janine Chan <64388808+janine-c@users.noreply.github.com> * Update content/en/agent/fleet_automation/remote_management.md Co-authored-by: Janine Chan <64388808+janine-c@users.noreply.github.com> --------- Co-authored-by: Duncan Hewett <8017759+duncanhewett@users.noreply.github.com> Co-authored-by: Janine Chan <64388808+janine-c@users.noreply.github.com>
1 parent 6ce51bf commit 6650ffa

File tree

4 files changed

+49
-2
lines changed

4 files changed

+49
-2
lines changed

content/en/agent/fleet_automation/remote_management.md

Lines changed: 49 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -12,8 +12,9 @@ further_reading:
1212

1313
## Overview
1414

15-
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:
16-
1. [Upgrade your Agent](#upgrade-agents)
15+
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:
16+
1. [Upgrade your Agent](#upgrade-agents)
17+
1. [Upgrade your SDKs](#upgrade-sdks)
1718
1. [Configure your Agent](#configure-datadog-agents)
1819

1920

@@ -117,6 +118,51 @@ The Agent ensures that the appropriate permissions are set for these files. No c
117118
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.
118119

119120

121+
## Upgrade SDKs
122+
123+
{{< callout url="https://www.datadoghq.com/product-preview/remote-upgrade-of-sdk-versions/" btn_hidden="false" header="Join the Preview!" >}}
124+
Remotely upgrade the SDKs that power APM, Profiler, Dynamic Instrumentation, and more. Request access to join the preview.
125+
{{< /callout >}}
126+
127+
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.
128+
129+
<div class="alert alert-info">
130+
Scheduling SDK upgrades is not supported.
131+
</div>
132+
133+
### Requirements
134+
135+
- **Single Step Instrumentation (SSI)**
136+
137+
You must already be instrumenting services with [Single Step Instrumentation (SSI)][20].
138+
- **Linux or Windows VMs**
139+
140+
Supported only for services running on **Linux or Windows VMs**. Remotely upgrading SDKs in containerized or Kubernetes environments is not supported.
141+
142+
143+
{{% collapse-content title="How to upgrade SDKs remotely" level="h4" expanded=false id="upgrade-sdks-steps" %}}
144+
145+
1. In Fleet Automation, open the [Upgrade Agents][1] tab and click **Upgrade Now**.
146+
147+
{{< img src="/agent/fleet_automation/upgrade-screen2.png" alt="The Upgrade Agents tab with the Upgrade Now button highlighted." style="width:100%;" >}}
148+
149+
1. Select the **SDK language** and **version**. You can update one language SDK at a time.
150+
151+
{{< img src="agent/fleet_automation/sdk-upgrade-language.png" alt="Select the language and version to upgrade to." style="width:100%;" >}}
152+
153+
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.
154+
155+
{{< 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%;" >}}
156+
157+
1. Review the deployment plan and click **Upgrade Hosts** to start the upgrade.
158+
159+
{{< 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%;" >}}
160+
161+
1. Restart the services to start using the upgraded SDKs.
162+
163+
[1]: https://app.datadoghq.com/fleet/agent-upgrades
164+
{{% /collapse-content %}}
165+
120166
## Configure Datadog Agents
121167

122168
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:
@@ -222,3 +268,4 @@ If you don't upgrade an earlier Agent version to 7.66 or higher, there is no imp
222268
[17]: https://docs.datadoghq.com/agent/remote_config/?tab=configurationyamlfile#configuration-order-precedence
223269
[18]: /agent/fleet_automation#view-agent-audit-trail-events
224270
[19]: /api/latest/fleet-automation/
271+
[20]: /tracing/trace_collection/automatic_instrumentation/single-step-apm/
269 KB
Loading
269 KB
Loading
389 KB
Loading

0 commit comments

Comments
 (0)