Si l’Agent v5 est déjà installé, un script est disponible pour installer ou passer à l’Agent v6. Ce script configure les référentiels du package et installe le package de l’Agent automatiquement. Lors de l’upgrade, l’outil d’importation recherche également un fichier datadog.conf existant issu d’une version antérieure et convertit les configurations de l’Agent et des checks au nouveau format v6. Sélectionnez votre plateforme ci-dessous pour connaître la marche à suivre détaillée. Vous pouvez télécharger le package DMG et l’installer manuellement, ou utiliser le script d’installation en une étape.
Le programme d’installation de l’Agent v6 peut automatiquement convertir les configurations v5 lors de l’upgrade :
DD_UPGRADE=true bash -c "$(curl -L https://s3.amazonaws.com/dd-agent/scripts/install_script.sh)"DD_UPGRADE=true bash -c "$(curl -L https://s3.amazonaws.com/dd-agent/scripts/install_script.sh)"DD_UPGRADE=true bash -c "$(curl -L https://s3.amazonaws.com/dd-agent/scripts/install_script.sh)"DD_UPGRADE=true bash -c "$(curl -L https://s3.amazonaws.com/dd-agent/scripts/install_script.sh)"DD_UPGRADE=true bash -c "$(curl -L https://s3.amazonaws.com/dd-agent/scripts/install_script.sh)"DD_UPGRADE=true bash -c "$(curl -L https://s3.amazonaws.com/dd-agent/scripts/install_script.sh)"DD_UPGRADE=true bash -c "$(curl -L https://s3.amazonaws.com/dd-agent/scripts/install_script.sh)"Remarque : le processus d’importation n’importe pas automatiquement les checks custom de l’Agent. Ce comportement est délibéré : nous ne pouvons par garantir la compatibilité totale et immédiate de ces checks.
L’installation en une étape n’est pas disponible pour Windows. Référez-vous à la section Upgrade manuel.
Le programme d’installation de l’Agent v6 peut automatiquement convertir les configurations v5 lors de l’upgrade :
DD_UPGRADE=true bash -c "$(curl -L https://s3.amazonaws.com/dd-agent/scripts/install_mac_os.sh)"
Remarque : le processus d’importation n’importe pas automatiquement les checks custom de l’Agent. Ce comportement est délibéré : nous ne pouvons par garantir la compatibilité totale et immédiate de ces checks.
Vous trouverez ci-dessous les instructions d’installation manuelle pour :
Configurez le référentiel Yum de Datadog sur votre système en créant un fichier /etc/yum.repos.d/datadog.repo avec le contenu suivant :
[datadog]
name=Datadog, Inc.
baseurl=https://yum.datadoghq.com/stable/6/x86_64/
enabled=1
gpgcheck=1
repo_gpgcheck=1
gpgkey=https://keys.datadoghq.com/DATADOG_RPM_KEY_CURRENT.public
https://keys.datadoghq.com/DATADOG_RPM_KEY_FD4BF915.public
https://keys.datadoghq.com/DATADOG_RPM_KEY_E09422B3.public
https://keys.datadoghq.com/DATADOG_RPM_KEY.public
Mettez à jour votre référentiel Yum local et installez l’Agent :
sudo yum makecache
sudo yum install datadog-agent
Copiez l’exemple de configuration à l’emplacement adéquat et spécifiez votre clé d’API :
sudo sh -c "sed 's/api_key:.*/api_key: <YOUR_API_KEY>/' /etc/datadog-agent/datadog.yaml.example > /etc/datadog-agent/datadog.yaml"
Procédez à la conversion des formats et des chemins de configuration de votre Agent au format v6 avec la commande import. La commande analyse le fichier datadog.conf v5 existant et convertit les options de configuration vers le nouveau format datadog.yaml v6. Celle-ci copie également les fichiers de configuration des checks actuellement activés :
sudo -u dd-agent -- datadog-agent import /etc/dd-agent/ /etc/datadog-agent/
(Re)démarrez l’Agent :
sudo systemctl restart datadog-agent.service
sudo initctl start datadog-agent
Configurez le référentiel Yum de Datadog sur votre système en créant un fichier /etc/yum.repos.d/datadog.repo avec le contenu suivant :
[datadog]
name=Datadog, Inc.
baseurl=https://yum.datadoghq.com/stable/6/x86_64/
enabled=1
gpgcheck=1
repo_gpgcheck=1
gpgkey=https://keys.datadoghq.com/DATADOG_RPM_KEY_CURRENT.public
https://keys.datadoghq.com/DATADOG_RPM_KEY_FD4BF915.public
https://keys.datadoghq.com/DATADOG_RPM_KEY_E09422B3.public
https://keys.datadoghq.com/DATADOG_RPM_KEY.public
Remarque : en raison d’un bug dans dnf, utilisez repo_gpgcheck=0 au lieu de repo_gpgcheck=1 pour CentOS 8.1.
Mettez à jour votre référentiel Yum local et installez l’Agent :
sudo yum makecache
sudo yum remove datadog-agent-base
sudo yum install datadog-agent
Copiez l’exemple de configuration à l’emplacement adéquat et spécifiez votre clé d’API :
sudo sh -c "sed 's/api_key:.*/api_key: <YOUR_API_KEY>/' /etc/datadog-agent/datadog.yaml.example > /etc/datadog-agent/datadog.yaml"
Procédez à la conversion des formats et des chemins de configuration de votre Agent au format v6 avec la commande import. La commande analyse le fichier datadog.conf v5 existant et convertit les options de configuration vers le nouveau format datadog.yaml v6. Celle-ci copie également les fichiers de configuration des checks actuellement activés :
sudo -u dd-agent -- datadog-agent import /etc/dd-agent/ /etc/datadog-agent/
Redémarrez l’Agent :
sudo systemctl restart datadog-agent.service
sudo initctl restart datadog-agent
Activez la prise en charge du HTTPS pour APT, installez curl et gnupg :
sudo apt-get update
sudo apt-get install apt-transport-https curl gnupg
Configurez le référentiel de l’API Datadog sur votre système et importez les clés APT de Datadog :
sudo sh -c "echo 'deb [signed-by=/usr/share/keyrings/datadog-archive-keyring.gpg] https://apt.datadoghq.com/ stable 6' > /etc/apt/sources.list.d/datadog.list"
sudo touch /usr/share/keyrings/datadog-archive-keyring.gpg
curl https://keys.datadoghq.com/DATADOG_APT_KEY_CURRENT.public | sudo gpg --no-default-keyring --keyring /usr/share/keyrings/datadog-archive-keyring.gpg --import --batch
curl https://keys.datadoghq.com/DATADOG_APT_KEY_382E94DE.public | sudo gpg --no-default-keyring --keyring /usr/share/keyrings/datadog-archive-keyring.gpg --import --batch
curl https://keys.datadoghq.com/DATADOG_APT_KEY_F14F620E.public | sudo gpg --no-default-keyring --keyring /usr/share/keyrings/datadog-archive-keyring.gpg --import --batch
Si vous utilisez Debian 8 ou une version antérieure, copiez le keyring vers /etc/apt/trusted.gpg.d :
sudo cp /usr/share/keyrings/datadog-archive-keyring.gpg /etc/apt/trusted.gpg.d
Mettez à jour votre cache APT local et installez l’Agent :
sudo apt-get update
sudo apt-get install datadog-agent datadog-signing-keys
Copiez l’exemple de configuration à l’emplacement adéquat et spécifiez votre clé d’API :
sudo sh -c "sed 's/api_key:.*/api_key: <YOUR_API_KEY>/' /etc/datadog-agent/datadog.yaml.example > /etc/datadog-agent/datadog.yaml"
Procédez à la conversion des formats et des chemins de configuration de votre Agent au format v6 avec la commande import. La commande analyse le fichier datadog.conf v5 existant et convertit les options de configuration vers le nouveau format datadog.yaml v6. Celle-ci copie également les fichiers de configuration des checks actuellement activés :
sudo -u dd-agent -- datadog-agent import /etc/dd-agent/ /etc/datadog-agent/
Démarrez l’Agent :
sudo service datadog-agent start
Configurez le référentiel Yum de Datadog sur votre système en créant un fichier /etc/yum.repos.d/datadog.repo avec le contenu suivant :
[datadog]
name=Datadog, Inc.
baseurl=https://yum.datadoghq.com/stable/6/x86_64/
enabled=1
gpgcheck=1
repo_gpgcheck=1
gpgkey=https://keys.datadoghq.com/DATADOG_RPM_KEY_CURRENT.public
https://keys.datadoghq.com/DATADOG_RPM_KEY_FD4BF915.public
https://keys.datadoghq.com/DATADOG_RPM_KEY_E09422B3.public
https://keys.datadoghq.com/DATADOG_RPM_KEY.public
Mettez à jour votre référentiel Yum local et installez l’Agent :
sudo yum makecache
sudo yum remove datadog-agent-base
sudo yum install datadog-agent
Copiez l’exemple de configuration à l’emplacement adéquat et spécifiez votre clé d’API :
sudo sh -c "sed 's/api_key:.*/api_key: <YOUR_API_KEY>/' /etc/datadog-agent/datadog.yaml.example > /etc/datadog-agent/datadog.yaml"
Procédez à la conversion des formats et des chemins de configuration de votre Agent au format v6 avec la commande import. La commande analyse le fichier datadog.conf v5 existant et convertit les options de configuration vers le nouveau format datadog.yaml v6. Celle-ci copie également les fichiers de configuration des checks actuellement activés :
sudo -u dd-agent -- datadog-agent import /etc/dd-agent/ /etc/datadog-agent/
Redémarrez l’Agent
sudo systemctl restart datadog-agent.service
Configurez le référentiel Yum de Datadog sur votre système en créant un fichier /etc/yum.repos.d/datadog.repo avec le contenu suivant :
[datadog]
name=Datadog, Inc.
baseurl=https://yum.datadoghq.com/stable/6/x86_64/
enabled=1
gpgcheck=1
repo_gpgcheck=1
gpgkey=https://keys.datadoghq.com/DATADOG_RPM_KEY_CURRENT.public
https://keys.datadoghq.com/DATADOG_RPM_KEY_FD4BF915.public
https://keys.datadoghq.com/DATADOG_RPM_KEY_E09422B3.public
https://keys.datadoghq.com/DATADOG_RPM_KEY.public
Remarque : en raison d’un bug dans dnf, utilisez repo_gpgcheck=0 au lieu de repo_gpgcheck=1 pour RHEL 8.1.
Mettez à jour votre référentiel Yum local et installez l’Agent :
sudo yum makecache
sudo yum remove datadog-agent-base
sudo yum install datadog-agent
Copiez l’exemple de configuration à l’emplacement adéquat et spécifiez votre clé d’API :
sudo sh -c "sed 's/api_key:.*/api_key: <YOUR_API_KEY>/' /etc/datadog-agent/datadog.yaml.example > /etc/datadog-agent/datadog.yaml"
Procédez à la conversion des formats et des chemins de configuration de votre Agent au format v6 avec la commande import. La commande analyse le fichier datadog.conf v5 existant et convertit les options de configuration vers le nouveau format datadog.yaml v6. Celle-ci copie également les fichiers de configuration des checks actuellement activés :
sudo -u dd-agent -- datadog-agent import /etc/dd-agent/ /etc/datadog-agent/
Redémarrez l’Agent :
sudo systemctl restart datadog-agent.service
sudo initctl restart datadog-agent
Activez la prise en charge du HTTPS pour APT, installez curl et gnupg :
sudo apt-get update
sudo apt-get install apt-transport-https curl gnupg
Configurez le référentiel de l’API Datadog sur votre système et importez les clés APT de Datadog :
sudo sh -c "echo 'deb [signed-by=/usr/share/keyrings/datadog-archive-keyring.gpg] https://apt.datadoghq.com/ stable 6' > /etc/apt/sources.list.d/datadog.list"
sudo touch /usr/share/keyrings/datadog-archive-keyring.gpg
curl https://keys.datadoghq.com/DATADOG_APT_KEY_CURRENT.public | sudo gpg --no-default-keyring --keyring /usr/share/keyrings/datadog-archive-keyring.gpg --import --batch
curl https://keys.datadoghq.com/DATADOG_APT_KEY_382E94DE.public | sudo gpg --no-default-keyring --keyring /usr/share/keyrings/datadog-archive-keyring.gpg --import --batch
curl https://keys.datadoghq.com/DATADOG_APT_KEY_F14F620E.public | sudo gpg --no-default-keyring --keyring /usr/share/keyrings/datadog-archive-keyring.gpg --import --batch
Si vous utilisez Ubuntu 14 ou une version antérieure, copiez le keyring vers /etc/apt/trusted.gpg.d :
sudo cp /usr/share/keyrings/datadog-archive-keyring.gpg /etc/apt/trusted.gpg.d
Mettez à jour votre cache APT local et installez l’Agent :
sudo apt-get update
sudo apt-get install datadog-agent datadog-signing-keys
Copiez l’exemple de configuration à l’emplacement adéquat et spécifiez votre clé d’API :
sudo sh -c "sed 's/api_key:.*/api_key: <YOUR_API_KEY>/' /etc/datadog-agent/datadog.yaml.example > /etc/datadog-agent/datadog.yaml"
Procédez à la conversion des formats et des chemins de configuration de votre Agent au format v6 avec la commande import. La commande analyse le fichier datadog.conf v5 existant et convertit les options de configuration vers le nouveau format datadog.yaml v6. Celle-ci copie également les fichiers de configuration des checks actuellement activés :
sudo -u dd-agent -- datadog-agent import /etc/dd-agent/ /etc/datadog-agent/
Démarrez l’Agent :
sudo systemctl start datadog-agent
sudo initctl start datadog-agent
/etc/zypp/repos.d/datadog.repo avec le contenu suivant :[datadog]
name=Datadog, Inc.
enabled=1
baseurl=https://yum.datadoghq.com/suse/stable/6/x86_64
type=rpm-md
gpgcheck=1
repo_gpgcheck=1
gpgkey=https://keys.datadoghq.com/DATADOG_RPM_KEY_CURRENT.public
https://keys.datadoghq.com/DATADOG_RPM_KEY_FD4BF915.public
https://keys.datadoghq.com/DATADOG_RPM_KEY_E09422B3.public
https://keys.datadoghq.com/DATADOG_RPM_KEY.public
sudo zypper refresh
sudo rpm --import https://keys.datadoghq.com/DATADOG_RPM_KEY_CURRENT.public
sudo rpm --import https://keys.datadoghq.com/DATADOG_RPM_KEY_FD4BF915.public
sudo rpm --import https://keys.datadoghq.com/DATADOG_RPM_KEY_E09422B3.public
sudo rpm --import https://keys.datadoghq.com/DATADOG_RPM_KEY.public
sudo zypper install datadog-agent
sudo sh -c "sed 's/api_key:.*/api_key: <YOUR_API_KEY>/' /etc/datadog-agent/datadog.yaml.example > /etc/datadog-agent/datadog.yaml"
Procédez à la conversion des formats et des chemins de configuration de votre Agent au format v6 avec la commande import. La commande analyse le fichier datadog.conf v5 existant et convertit les options de configuration vers le nouveau format datadog.yaml v6. Celle-ci copie également les fichiers de configuration des checks actuellement activés :
sudo -u dd-agent -- datadog-agent import /etc/dd-agent/ /etc/datadog-agent/
Redémarrez l’Agent :
sudo systemctl restart datadog-agent.service
Téléchargez la dernière version disponible et exécutez le paquet d’installation.
Procédez à la conversion des formats et des chemins de configuration de votre Agent au format v6 avec la commande import. La commande analyse le fichier datadog.conf v5 existant et convertit les options de configuration vers le nouveau format datadog.yaml v6. Celle-ci copie également les fichiers de configuration des checks actuellement activés :
datadog-agent import <ANCIEN_RÉPERTOIRE_CONFIGURATION> <RÉPERTOIRE_DESTINATION>
Où :
<ANCIEN_RÉPERTOIRE_CONFIGURATION> est le répertoire contenant le fichier datadog.conf<RÉPERTOIRE_DESTINATION> est le répertoire dans lequel le fichier datadog.yaml importé sera écrit (vous pouvez utiliser le même répertoire que <ANCIEN_RÉPERTOIRE_CONFIGURATION>).Remarque : datadog.conf est automatiquement converti en datadog.yaml lors de l’upgrade.
/opt/datadog-agent/etc/datadog.yaml.import. La commande analyse le fichier datadog.conf v5 existant et convertit les options de configuration vers le nouveau format datadog.yaml v6. Celle-ci copie également les fichiers de configuration des checks actuellement activés :
datadog-agent import /opt/datadog-agent/etc/ /opt/datadog-agent/etc/Démarrez ensuite l’application Agent Datadog (une fois celle-ci démarrée, elle doit s’afficher dans la barre d’état système) et gérez l’Agent à partir de cet emplacement. L’Agent v6 intègre une interface graphique Web qui vous permet de modifier les fichiers de configuration de l’Agent, et bien plus encore.