Datadog Agent v6 へのアップグレード

Datadog Agent v6 へのアップグレード

Agent v7 が利用可能です。 最新バージョンにアップグレードすると新しい機能を利用できます。

Agent 6 へのアップグレード

Agent v5 が既にインストールされている場合は、新しい Agent を自動インストールまたはアップグレードするためのスクリプトがあります。このスクリプトは、パッケージリポジトリをセットアップし、Agent パッケージをインストールします。アップグレードの際に、インポートツールが以前のバージョンから既存の datadog.conf を検索し、新しい v6 の形式に従って Agent 構成とチェック構成を変換します。以下からご使用のプラットフォームを選択して、具体的な手順を参照してください。DMG パッケージをダウンロードして手動でインストールするか、1 行のインストールスクリプトを使用してインストールできます。

ワンステップアップグレード

Agent v6 インストーラは、アップグレード時に v5 の構成を自動的に変換できます。

プラットフォームコマンド
Amazon LinuxDD_UPGRADE=true bash -c "$(curl -L https://s3.amazonaws.com/dd-agent/scripts/install_script.sh)"
CentOSDD_UPGRADE=true bash -c "$(curl -L https://s3.amazonaws.com/dd-agent/scripts/install_script.sh)"
DebianDD_UPGRADE=true bash -c "$(curl -L https://s3.amazonaws.com/dd-agent/scripts/install_script.sh)"
FedoraDD_UPGRADE=true bash -c "$(curl -L https://s3.amazonaws.com/dd-agent/scripts/install_script.sh)"
Red HatDD_UPGRADE=true bash -c "$(curl -L https://s3.amazonaws.com/dd-agent/scripts/install_script.sh)"
UbuntuDD_UPGRADE=true bash -c "$(curl -L https://s3.amazonaws.com/dd-agent/scripts/install_script.sh)"
SUSEDD_UPGRADE=true bash -c "$(curl -L https://s3.amazonaws.com/dd-agent/scripts/install_script.sh)"

注: インポート処理では、カスタム Agent チェックは自動的に移動されません。これは、Datadog がそのままの状態での完全な下位互換性は保証できないためです。

Windows プラットフォーム用のワンステップインストールはありません。手動アップグレードを参照してください。

Agent v6 インストーラは、アップグレード時に v5 の構成を自動的に変換できます。

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

注: インポート処理では、カスタム Agent チェックは自動的に移動されません。これは、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
    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
    
  2. ローカルの Yum リポジトリを更新し、Agent をインストールします。

    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 コマンドを使用して、Agent の構成パスおよび形式を Agent v5 から Agent v6 に移行します。このコマンドは、既存の v5 の datadog.conf をパースし、構成オプションを新しい v6 の datadog.yaml 形式に変換します。また、現在有効になっているチェックの構成ファイルをコピーします。

    sudo -u dd-agent -- datadog-agent import /etc/dd-agent/ /etc/datadog-agent/
    
  5. Agent を (再) 起動します。

    • 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
    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
    
  2. ローカルの Yum リポジトリを更新し、Agent をインストールします。

    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 コマンドを使用して、Agent の構成パスおよび形式を Agent v5 から Agent v6 に移行します。このコマンドは、既存の v5 の datadog.conf をパースし、構成オプションを新しい v6 の datadog.yaml 形式に変換します。また、現在有効になっているチェックの構成ファイルをコピーします。

    sudo -u dd-agent -- datadog-agent import /etc/dd-agent/ /etc/datadog-agent/
    
  5. Agent を再起動します。

    • Centos 7 以降:
    sudo systemctl restart datadog-agent.service
    
    • Centos 6:
    sudo initctl restart datadog-agent
    

Debian

  1. APT の HTTPS サポートを有効にします。

    sudo apt-get update
    sudo apt-get install apt-transport-https
    
  2. システム上に Datadog API リポジトリをセットアップし、Datadog の APT キーをインポートします。

    sudo sh -c "echo 'deb https://apt.datadoghq.com/ stable 6' > /etc/apt/sources.list.d/datadog.list"
    sudo apt-key adv --recv-keys --keyserver hkp://keyserver.ubuntu.com:80 A2923DFF56EDA6E76E55E492D3A80E30382E94DE
    sudo apt-key adv --recv-keys --keyserver hkp://keyserver.ubuntu.com:80 D75CEA17048B9ACBF186794B32637D44F14F620E
    

    注: Datadog の APT キーをインポートするために、dirmngr をインストールしなければならない場合があります。

  3. ローカルの APT キャッシュを更新し、Agent をインストールします。

    sudo apt-get update
    sudo apt-get install datadog-agent
    
  4. 構成サンプルを所定の位置にコピーし、適切な API キーを指定します。

    sudo sh -c "sed 's/api_key:.*/api_key: <YOUR_API_KEY>/' /etc/datadog-agent/datadog.yaml.example > /etc/datadog-agent/datadog.yaml"
    
  5. 以下の import コマンドを使用して、Agent の構成パスおよび形式を Agent v5 から Agent v6 に移行します。このコマンドは、既存の v5 の datadog.conf をパースし、構成オプションを新しい v6 の datadog.yaml 形式に変換します。また、現在有効になっているチェックの構成ファイルをコピーします。

    sudo -u dd-agent -- datadog-agent import /etc/dd-agent/ /etc/datadog-agent/
    
  6. Agent を起動します。

    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
    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
    
  2. ローカルの Yum リポジトリを更新し、Agent をインストールします。

    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 コマンドを使用して、Agent の構成パスおよび形式を Agent v5 から Agent v6 に移行します。このコマンドは、既存の v5 の datadog.conf をパースし、構成オプションを新しい v6 の datadog.yaml 形式に変換します。また、現在有効になっているチェックの構成ファイルをコピーします。

    sudo -u dd-agent -- datadog-agent import /etc/dd-agent/ /etc/datadog-agent/
    
  5. Agent を再起動します。

    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
    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
    
  2. ローカルの Yum リポジトリを更新し、Agent をインストールします。

    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 コマンドを使用して、Agent の構成パスおよび形式を Agent v5 から Agent v6 に移行します。このコマンドは、既存の v5 の datadog.conf をパースし、構成オプションを新しい v6 の datadog.yaml 形式に変換します。また、現在有効になっているチェックの構成ファイルをコピーします。

    sudo -u dd-agent -- datadog-agent import /etc/dd-agent/ /etc/datadog-agent/
    
  5. Agent を再起動します。

    • Red Hat 7 以降:
    sudo systemctl restart datadog-agent.service
    
    • Red Hat 6:
    sudo initctl restart datadog-agent
    

Ubuntu

  1. APT の HTTPS サポートを有効にします。

    sudo apt-get update
    sudo apt-get install apt-transport-https
    
  2. システム上に Datadog API リポジトリをセットアップし、Datadog の APT キーをインポートします。

    sudo sh -c "echo 'deb https://apt.datadoghq.com/ stable 6' > /etc/apt/sources.list.d/datadog.list"
    sudo apt-key adv --recv-keys --keyserver hkp://keyserver.ubuntu.com:80 A2923DFF56EDA6E76E55E492D3A80E30382E94DE
    sudo apt-key adv --recv-keys --keyserver hkp://keyserver.ubuntu.com:80 D75CEA17048B9ACBF186794B32637D44F14F620E
    

    注: Datadog の APT キーをインポートするために、dirmngr をインストールしなければならない場合があります。

  3. ローカルの APT キャッシュを更新し、Agent をインストールします。

    sudo apt-get update
    sudo apt-get install datadog-agent
    
  4. 構成サンプルを所定の位置にコピーし、適切な API キーを指定します。

    sudo sh -c "sed 's/api_key:.*/api_key: <YOUR_API_KEY>/' /etc/datadog-agent/datadog.yaml.example > /etc/datadog-agent/datadog.yaml"
    
  5. 以下の import コマンドを使用して、Agent の構成パスおよび形式を Agent v5 から Agent v6 に移行します。このコマンドは、既存の v5 の datadog.conf をパースし、構成オプションを新しい v6 の datadog.yaml 形式に変換します。また、現在有効になっているチェックの構成ファイルをコピーします。

    sudo -u dd-agent -- datadog-agent import /etc/dd-agent/ /etc/datadog-agent/
    
  6. Agent を起動します。

    • 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=0
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
  1. ローカルの Zypper リポジトリを更新し、Agent をインストールします。
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
  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 コマンドを使用して、Agent の構成パスおよび形式を Agent v5 から Agent v6 に移行します。このコマンドは、既存の v5 の datadog.conf をパースし、構成オプションを新しい v6 の datadog.yaml 形式に変換します。また、現在有効になっているチェックの構成ファイルをコピーします。

    sudo -u dd-agent -- datadog-agent import /etc/dd-agent/ /etc/datadog-agent/
    
  2. Agent を再起動します。

sudo systemctl restart datadog-agent.service

最新バージョンをダウンロードし、インストールパッケージを実行します。

以下の import コマンドを使用して、Agent の構成パスおよび形式を Agent v5 から Agent v6 に移行します。このコマンドは、既存の v5 の datadog.conf をパースし、構成オプションを新しい v6 の datadog.yaml 形式に変換します。また、現在有効になっているチェックの構成ファイルをコピーします。

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. Agent の最新バージョンの DMG パッケージをダウンロードします。リポジトリの[リリースページ][9]にリストされている最新の macOS 版リリースを使用してください。
  2. DMG パッケージをインストールします。
  3. /opt/datadog-agent/etc/datadog.yaml に API キーを追加します。
  4. 以下の import コマンドを使用して、Agent の構成パスおよび形式を Agent v5 から Agent v6 に移行します。このコマンドは、既存の v5 の datadog.conf をパースし、構成オプションを新しい v6 の datadog.yaml 形式に変換します。また、現在有効になっているチェックの構成ファイルをコピーします。 datadog-agent import /opt/datadog-agent/etc/ /opt/datadog-agent/etc/

次に、Datadog Agent アプリケーションを起動します。起動すると、システムトレイにアプリケーションが表示され、そこから Agent を管理できます。Agent v6 には Web ベースの GUI が含まれており、これを使用して Agent 構成ファイルの編集などのさまざまな処理を行うことができます。

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