Mettre à niveau les agents
Ce produit n'est pas pris en charge pour le
site Datadog que vous avez sélectionné. (
).
Fleet Automation vous permet de mettre à niveau à distance les Agents Datadog sur l’ensemble de votre parc sans accès direct aux hosts individuels. Vous pouvez déclencher les mises à niveau immédiatement, les planifier pendant les fenêtres de maintenance ou les automatiser via l’API.
Prérequis
- Remote Configuration activée pour votre organisation et la clé d’API de l’Agent
- Remote updates activées sur chaque Agent de VM cible (
remote_updates: true) - Agent version 7.71.1 ou ultérieure pour Windows et 7.69.0 ou ultérieure pour Linux
- Des VM Linux ou des VM Windows
- Au moins 2 GB d’espace disque pour l’installation initiale de l’Agent, plus 2 GB supplémentaires pour les mises à niveau. (La mise à niveau nécessite 1.3 GB dans
/opt/datadog-packages sur Linux ou C:\ProgramData\Datadog\Installer\packages sur Windows. L’espace supplémentaire permet de conserver temporairement deux installations de l’Agent pendant la mise à niveau au cas où un retour à la version précédente serait nécessaire.)
La mise à niveau à distance des Agents dans les charges de travail conteneurisées n'est pas prise en charge.
Depuis l’onglet Upgrades, cliquez sur Upgrade Now.
Sélectionnez les Agents à mettre à niveau. Filtrez par informations du host ou par tags pour cibler un groupe spécifique.
Examinez le plan de déploiement et cliquez sur Upgrade Agents pour lancer la mise à niveau.
Suivez la progression sur le dashboard Deployments. Cliquez sur un Agent dans le tableau des déploiements pour afficher la durée, la progression et l’utilisateur qui a lancé la mise à niveau.
Planifier les mises à niveau des Agents
Depuis l’onglet Upgrades, cliquez sur + Create Schedule.
Sur la page Upgrade Schedule, ajoutez un Schedule name.
Sélectionnez la version de l’Agent. Vous pouvez effectuer une mise à niveau vers la dernière version, la version précédente ou celle d’avant.
Spécifiez les Agents à mettre à niveau. Filtrez par informations du host ou par tags pour cibler un groupe spécifique.
Définissez la fenêtre de déploiement pour ces mises à niveau. Vous pouvez sélectionner les jours, la plage horaire et le fuseau horaire pour la mise à niveau.
Configurez les notifications pour les mises à jour du statut de déploiement. Informez votre équipe via des services connectés à Datadog, tels que Slack, Teams ou PagerDuty.
Cliquez sur Create Schedule pour enregistrer le planning.
Consultez la liste de vos mises à niveau planifiées dans l’onglet Upgrades, dans la section Upgrade Schedules.
Mettre à niveau les Agents avec l’API
Fleet Automation fournit une API pour déclencher les mises à niveau des Agents par programmation ou selon un planning récurrent. Lancez les mises à niveau pour tout ensemble de hosts avec des requêtes de filtrage, ou créez des plannings qui s’exécutent pendant des fenêtres de maintenance définies avec une version d’Agent spécifiée. Pour plus de détails, consultez l’API Fleet Automation.
Processus de mise à niveau
Comme lors d’une mise à niveau manuelle, attendez-vous à un downtime de 5-30 secondes pendant le redémarrage de l’Agent. Le processus complet de mise à niveau prend environ 5 minutes : environ 2 minutes pour la mise à niveau elle-même, le temps restant étant consacré à la surveillance de la stabilité. Si la mise à niveau échoue, l’Agent revient automatiquement à la version précédente.
Le processus de mise à niveau ajoute principalement des fichiers aux répertoires suivants :
Linux :
/opt/datadog-packages/etc/datadog-agent/etc/systemd/system
Windows :
C:\ProgramData\Datadog\Installer\packagesC:\Program Files\Datadog\Datadog Agent
L’Agent définit les autorisations appropriées pour ces fichiers. Aucun fichier de configuration n’est modifié pendant la mise à niveau.
Priorité de mise à niveau
Datadog recommande de gérer les mises à niveau à partir d’une seule source à la fois. Utilisez soit Fleet Automation, soit un outil de gestion de configuration, mais pas les deux. Si vous exécutez un outil de gestion de configuration sur un Agent qui a été mis à niveau via Fleet Automation, l’outil rétablit l’Agent à la version DD_AGENT_MINOR_VERSION définie dans votre configuration. Si DD_AGENT_MINOR_VERSION n’est pas défini, l’Agent est mis à niveau vers la dernière version disponible.
Dépannage
Remote Agent Management n’est pas activé
Si le panneau latéral de l’Agent indique Remote Agent Management: NOT ENABLED, suivez Activer Remote Agent Management pour activer remote_updates sur le host et redémarrer l’Agent. Remote Configuration peut être connectée alors que Remote updates est désactivée.
Si l’Agent est toujours indisponible pour les mises à niveau, vérifiez les prérequis, la connectivité de Remote Configuration et si Datadog Installer est en cours d’exécution.
La version de l’Agent nouvellement publiée n’est pas encore disponible pour la mise à niveau
Après la publication d’une nouvelle version de l’Agent, il peut s’écouler jusqu’à 24 heures avant qu’elle n’apparaisse comme cible de mise à niveau dans Fleet Automation. Si une version récemment publiée est absente du sélecteur de mise à niveau, attendez jusqu’à 24 heures et réessayez.
Datadog Installer incompatible avec l’Agent (antérieur à 7.66)
Si vous étiez client pendant la phase Preview et que vous avez configuré Remote Agent Management avant la version 7.66 de l’Agent, votre Datadog Installer pourrait être incompatible avec l’Agent.
À partir de la version 7.66, le composant d’installation est fourni avec l’Agent. Cela permet de maintenir les deux composants synchronisés et d’éviter les incompatibilités de version qui peuvent bloquer la gestion à distance. Les versions précédentes de l’Agent n’incluaient pas Datadog Installer, ce qui peut entraîner des problèmes de compatibilité.
Pour diagnostiquer et résoudre le problème :
- Utilisez la requête suivante dans Fleet Automation pour identifier les hosts concernés :
support_remote_upgrade:datadog-installer
- Si votre configuration est impactée, réexécutez le script d’installation sur chaque Agent concerné pour effectuer la mise à niveau vers une version de l’Agent qui répond aux prérequis.
Après la mise à jour, activez Remote Agent Management pour utiliser Fleet Automation lors des futures mises à niveau. Si vous n’effectuez pas la mise à niveau, l’Agent existant continue de fonctionner, mais les mises à niveau à distance restent indisponibles.
Pour aller plus loin
Documentation, liens et articles supplémentaires utiles: