에이전트 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 지원을 활성화하고 curl 및 gnupg를 설치합니다.

        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 지원을 활성화하고 curl 및 gnupg를 설치합니다.

        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