에이전트 v6으로 업그레이드

에이전트 v7을 사용할 수 있습니다. 최신 버전으로 업그레이드하고 새로운 기능을 모두 누리세요.

에이전트 6으로 업그레이드

에이전트 버전 5가 이미 설치되어 있는 경우 새 에이전트를 자동으로 설치하거나 업그레이드하는 스크립트를 사용할 수 있습니다. 이 스크립트를 이용하면 패키지 리포지토리를 설정하고 에이전트 패키지를 설치합니다. 업그레이드할 때 가져오기 도구가 이전 버전의 기존 datadog.conf도 검색하고 새 v6 형식에 따라 에이전트와 점검 설정을 변경합니다. 아래의 플랫폼을 선택해 구체적인 지침을 확인하세요. DMG 패키지를 다운로드해 수동으로 설치하거나 한 줄 설치 스크립트를 사용할 수 있습니다.

원스텝 업그레이드

에이전트 v6 설치 관리자는 업그레이드 중에 v5 설정을 자동으로 변환할 수 있습니다

다음 명령은 Amazon Linux, CentOS, Debian, Fedora, Red Hat, Ubuntu, SUSE에서 작동합니다:
DD_UPGRADE=true bash -c "$(curl -L https://s3.amazonaws.com/dd-agent/scripts/install_script_agent6.sh)"

참고: 가져오기 프로세스가 커스텀 에이전트 점검을 자동으로 이동하지 않습니다. 이는 Datadog에서 이전 버전과의 완벽한 호환성을 보장할 수 없기 때문입니다.

Windows 플랫폼에는 원스텝 설치가 없습니다. 수동 업그레이드를 참고하세요.

에이전트 v6 설치 관리자는 업그레이드 중에 v5 설정을 자동으로 변환할 수 있습니다.

DD_UPGRADE=true bash -c "$(curl -L https://s3.amazonaws.com/dd-agent/scripts/install_mac_os.sh)"

참고: 가져오기 프로세스가 커스텀 에이전트 점검을 자동으로 이동하지 않습니다. 이는 Datadog에서 이전 버전과의 완벽한 호환성을 보장할 수 없기 때문에 이와 같이 설계되었습니다.

수동 업그레이드

수동 업그레이드 지침은 아래에서 확인할 수 있습니다.

Amazon Linux

  1. 다음 내용으로 /etc/yum.repos.d/datadog.repo를 생성해 시스템에 Datadog의 Yum 레포를 구성합니다.

    [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_B01082D3.public
           https://keys.datadoghq.com/DATADOG_RPM_KEY_FD4BF915.public
           https://keys.datadoghq.com/DATADOG_RPM_KEY_E09422B3.public
    
  2. 로컬 Yum 레포를 업데이트하고 에이전트를 설치합니다.

    sudo yum makecache
    sudo yum install datadog-agent
    
  3. 예제 구성을 복사하여 제자리에 붙여넣은 후 API 키를 플러그합니다.

    sudo sh -c "sed 's/api_key:.*/api_key: <YOUR_API_KEY>/' /etc/datadog-agent/datadog.yaml.example > /etc/datadog-agent/datadog.yaml"
    
  4. import 명령을 사용해 에이전트 설정 경로 및 형식을 기존 에이전트 v5 datadog.conf에서 새로운 에이전트 v6datadog.yaml로 전환합니다. 이 명령은 기존 v5를 구문 분석하고 설정 옵션을 새 v6 형식으로 변환합니다. 또한 현재 사용하도록 설정된 점검용 구성 파일을 복사합니다.

    sudo -u dd-agent -- datadog-agent import /etc/dd-agent/ /etc/datadog-agent/
    
  5. 에이전트를 (재)시작합니다.

    • Amazon Linux 2.0:
    sudo systemctl restart datadog-agent.service
    
    • Amazon Linux 1.0:
    sudo initctl start datadog-agent
    

CentOS

  1. 다음의 콘텐츠로 /etc/yum.repos.d/datadog.repo를 생성해 시스템에 Datadog의 Yum 저장소를 구성합니다.

    [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_B01082D3.public
           https://keys.datadoghq.com/DATADOG_RPM_KEY_FD4BF915.public
           https://keys.datadoghq.com/DATADOG_RPM_KEY_E09422B3.public
    

    참고: dnf 버그 때문에 CentOS 8.1에서 repo_gpgcheck=1 대신 repo_gpgcheck=0를 사용해야 합니다.

  2. 로컬 Yum 레포를 업데이트하고 에이전트를 설치합니다.

    sudo yum makecache
    sudo yum remove datadog-agent-base
    sudo yum install datadog-agent
    
  3. 예제 설정을 제자리에 복사하고 API 키를 플러그합니다.

    sudo sh -c "sed 's/api_key:.*/api_key: <YOUR_API_KEY>/' /etc/datadog-agent/datadog.yaml.example > /etc/datadog-agent/datadog.yaml"
    
  4. import 명령을 사용해 에이전트 설정 경로 및 형식을 기존 에이전트 v5 datadog.conf에서 새로운 에이전트 v6datadog.yaml로 전환합니다. 이 명령은 기존 v5를 구문 분석하고 설정 옵션을 새 v6 형식으로 변환합니다. 또한 현재 사용하도록 설정된 점검용 구성 파일을 복사합니다.

    sudo -u dd-agent -- datadog-agent import /etc/dd-agent/ /etc/datadog-agent/
    
  5. 에이전트를 시작합니다.

    • CentOS 7 이상:
    sudo systemctl restart datadog-agent.service
    
    • CentOS 6:
    sudo initctl restart datadog-agent
    

Debian

  1. APT에 HTTPS 지원을 활성화하고 curlgnupg를 설치합니다.

    sudo apt-get update
    sudo apt-get install apt-transport-https curl gnupg
    
  2. 시스템에서 Datadog API 레포를 설정하고 Datadog의 APT 키를 가져옵니다.

    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_C0962C7D.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
    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
    
  3. Debian 8 이전 버전을 실행하는 경우 키링을 /etc/apt/trusted.gpg.d에 복사합니다.

    sudo cp /usr/share/keyrings/datadog-archive-keyring.gpg /etc/apt/trusted.gpg.d
    
  4. 로컬 APT 캐시를 업데이트하고 에이전트를 설치합니다.

    sudo apt-get update
    sudo apt-get install datadog-agent datadog-signing-keys
    
  5. 예제 설정을 제자리에 복사하고 API 키를 플러그합니다.

    sudo sh -c "sed 's/api_key:.*/api_key: <YOUR_API_KEY>/' /etc/datadog-agent/datadog.yaml.example > /etc/datadog-agent/datadog.yaml"
    
  6. import명령을 사용해 에이전트 설정 경로 및 형식을 기존 에이전트 v5 datadog.conf에서 새로운 에이전트 v6datadog.yaml로 전환합니다. 이 명령은 기존 v5를 구문 분석하고 설정 옵션을 새 v6 형식으로 변환합니다. 또한 현재 사용하도록 설정된 점검용 구성 파일을 복사합니다.

    sudo -u dd-agent -- datadog-agent import /etc/dd-agent/ /etc/datadog-agent/
    
  7. 에이전트를 시작합니다.

    sudo service datadog-agent start
    

Fedora

  1. 다음 내용으로 /etc/yum.repos.d/datadog.repo를 생성해 시스템에 Datadog의 Yum 레포를 구성합니다.

    [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_B01082D3.public
           https://keys.datadoghq.com/DATADOG_RPM_KEY_FD4BF915.public
           https://keys.datadoghq.com/DATADOG_RPM_KEY_E09422B3.public
    
  2. 로컬 Yum 레포를 업데이트하고 에이전트를 설치합니다.

    sudo yum makecache
    sudo yum remove datadog-agent-base
    sudo yum install datadog-agent
    
  3. 예제 설정을 제자리에 복사하고 API 키를 플러그합니다.

    sudo sh -c "sed 's/api_key:.*/api_key: <YOUR_API_KEY>/' /etc/datadog-agent/datadog.yaml.example > /etc/datadog-agent/datadog.yaml"
    
  4. import 명령을 사용해 에이전트 설정 경로 및 형식을 기존 에이전트 v5 datadog.conf에서 새로운 에이전트 v6datadog.yaml로 전환합니다. 이 명령은 기존 v5를 구문 분석하고 설정 옵션을 새 v6 형식으로 변환합니다. 또한 현재 사용하도록 설정된 점검용 구성 파일을 복사합니다.

    sudo -u dd-agent -- datadog-agent import /etc/dd-agent/ /etc/datadog-agent/
    
  5. 에이전트 재시작

    sudo systemctl restart datadog-agent.service
    

Red Hat

  1. 다음 내용으로 /etc/yum.repos.d/datadog.repo를 생성해 시스템에 Datadog의 Yum 레포를 구성합니다.

    [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_B01082D3.public
           https://keys.datadoghq.com/DATADOG_RPM_KEY_FD4BF915.public
           https://keys.datadoghq.com/DATADOG_RPM_KEY_E09422B3.public
    

    참고: dnf 버그 때문에 CentOS 8.1에서 repo_gpgcheck=1 대신 repo_gpgcheck=0를 사용해야 합니다.

  2. 로컬 Yum 레포를 업데이트하고 에이전트를 설치합니다.

    sudo yum makecache
    sudo yum remove datadog-agent-base
    sudo yum install datadog-agent
    
  3. 예제 설정을 제자리에 복사하고 API 키를 플러그합니다.

    sudo sh -c "sed 's/api_key:.*/api_key: <YOUR_API_KEY>/' /etc/datadog-agent/datadog.yaml.example > /etc/datadog-agent/datadog.yaml"
    
  4. import명령을 사용해 에이전트 설정 경로 및 형식을 기존 에이전트 v5 datadog.conf에서 새로운 에이전트 v6datadog.yaml로 전환합니다. 이 명령은 기존 v5를 구문 분석하고 설정 옵션을 새 v6 형식으로 변환합니다. 또한 현재 사용하도록 설정된 점검용 구성 파일을 복사합니다.

    sudo -u dd-agent -- datadog-agent import /etc/dd-agent/ /etc/datadog-agent/
    
  5. 에이전트를 시작합니다.

    • Red Hat 7 이상:
    sudo systemctl restart datadog-agent.service
    
    • Red Hat 6:
    sudo initctl restart datadog-agent
    

Ubuntu

  1. APT에 HTTPS 지원을 활성화하고 curlgnupg를 설치합니다.

    sudo apt-get update
    sudo apt-get install apt-transport-https curl gnupg
    
  2. 시스템에서 Datadog API 레포를 설정하고 Datadog의 APT 키를 가져옵니다.

    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_C0962C7D.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
    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
    
  3. Ubuntu 14 이전 버전을 실행하는 경우 키링을 /etc/apt/trusted.gpg.d에 복사합니다.

    sudo cp /usr/share/keyrings/datadog-archive-keyring.gpg /etc/apt/trusted.gpg.d
    
  4. 로컬 APT 캐시를 업데이트하고 에이전트를 설치합니다.

    sudo apt-get update
    sudo apt-get install datadog-agent datadog-signing-keys
    
  5. 예제 설정을 제자리에 복사하고 API 키를 플러그합니다.

    sudo sh -c "sed 's/api_key:.*/api_key: <YOUR_API_KEY>/' /etc/datadog-agent/datadog.yaml.example > /etc/datadog-agent/datadog.yaml"
    
  6. import 명령을 사용해 에이전트 설정 경로 및 형식을 기존 에이전트 v5 datadog.conf에서 새로운 에이전트 v6datadog.yaml로 전환합니다. 이 명령은 기존 v5를 구문 분석하고 설정 옵션을 새 v6 형식으로 변환합니다. 또한 현재 사용하도록 설정된 점검용 구성 파일을 복사합니다.

    sudo -u dd-agent -- datadog-agent import /etc/dd-agent/ /etc/datadog-agent/
    
  7. 에이전트를 시작합니다.

    • Ubuntu 16.04 이상:
    sudo systemctl start datadog-agent
    
    • Ubuntu 14.04 이하:
    sudo initctl start datadog-agent
    

SUSE

  1. 다음 내용으로 /etc/zypp/repos.d/datadog.repo를 생성해 시스템에 Datadog의 Yum 레포를 구성합니다.
[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_B01082D3.public
       https://keys.datadoghq.com/DATADOG_RPM_KEY_FD4BF915.public
       https://keys.datadoghq.com/DATADOG_RPM_KEY_E09422B3.public
  1. 로컬 Zyper 레포를 업데이트하고 에이전트를 설치합니다.
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_B01082D3.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 zypper install datadog-agent
  1. 예제 설정을 제자리에 복사하고 API 키를 플러그합니다.
sudo sh -c "sed 's/api_key:.*/api_key: <YOUR_API_KEY>/' /etc/datadog-agent/datadog.yaml.example > /etc/datadog-agent/datadog.yaml"
  1. import 명령을 사용해 에이전트 설정 경로 및 형식을 기존 에이전트 v5 datadog.conf에서 새로운 에이전트 v6datadog.yaml로 전환합니다. 이 명령은 기존 v5를 구문 분석하고 설정 옵션을 새 v6 형식으로 변환합니다. 또한 현재 사용하도록 설정된 점검용 구성 파일을 복사합니다.

    sudo -u dd-agent -- datadog-agent import /etc/dd-agent/ /etc/datadog-agent/
    
  2. 에이전트를 재시작합니다.

sudo systemctl restart datadog-agent.service

사용 가능한 최신 버전을 다운로드하고 설치 패키지를 실행합니다.

import 명령을 사용해 에이전트 설정 경로 및 형식을 기존 에이전트 v5 datadog.conf에서 새로운 에이전트 v6datadog.yaml로 전환합니다. 이 명령은 기존 v5를 구문 분석하고 설정 옵션을 새 v6 형식으로 변환합니다. 또한 현재 사용하도록 설정된 점검용 구성 파일을 복사합니다.

datadog-agent import <OLD_CONFIGURATION_DIRECTORY> <DESTINATION_DIRECTORY>

다음과 함께:

  • <OLD_CONFIGURATION_DIRECTORY>datadog.conf파일을 포함하는 디렉터리입니다.
  • <DESTINATION_DIRECTORY>datadog.yaml를 가져와 쓴 디렉터리입니다(<OLD_CONFIGURATION_DIRECTORY>와 같은 디렉터리로 사용할 수 있음).

참고: datadog.conf는 업그레이드에서 datadog.yaml로 자동 업그레이드됩니다.

  1. 최신 에이전트 버전의 DMG 패키지를 다운로드하여 리포지토리의 [릴리스 페이지][9] 목록에 있는 최신 macOS 릴리즈를 사용합니다.
  2. DMG 패키지를 설치합니다.
  3. API키에 /opt/datadog-agent/etc/datadog.yaml를 추가합니다.
  4. import 명령을 사용해 에이전트 설정 경로 및 형식을 기존 에이전트 v5 datadog.conf에서 새로운 에이전트 v6datadog.yaml로 전환합니다. 이 명령은 기존 v5를 구문 분석하고 설정 옵션을 새 v6 형식으로 변환합니다. 또한 현재 사용하도록 설정된 점검용 구성 파일을 복사합니다. datadog-agent import /opt/datadog-agent/etc/ /opt/datadog-agent/etc/

그런 다음 Datadog 에이전트 애플리케이션을 시작하고(일단 시작되면 시스템 트레이에 표시되어야 함), 여기서 에이전트를 관리합니다. 에이전트 v6에는 에이전트 설정 파일 등을 편집할 수 있는 웹 기반 GUI가 포함되어 있습니다.

https://github.com/DataDog/datadog-agent/releases