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