- 重要な情報
- はじめに
- 用語集
- エージェント
- インテグレーション
- OpenTelemetry
- 開発者
- API
- CoScreen
- アプリ内
- インフラストラクチャー
- アプリケーションパフォーマンス
- 継続的インテグレーション
- ログ管理
- セキュリティ
- UX モニタリング
- 管理
Agent v5 が既にインストールされている場合は、新しい Agent を自動インストールまたはアップグレードするためのスクリプトがあります。このスクリプトは、パッケージリポジトリをセットアップし、Agent パッケージをインストールします。アップグレードの際に、インポートツールが以前のバージョンから既存の datadog.conf
を検索し、新しい v6 の形式に従って Agent 構成とチェック構成を変換します。以下からご使用のプラットフォームを選択して、具体的な手順を参照してください。DMG パッケージをダウンロードして手動でインストールするか、1 行のインストールスクリプトを使用してインストールできます。
Agent v6 インストーラは、アップグレード時に v5 の構成を自動的に変換できます。
DD_UPGRADE=true bash -c "$(curl -L https://s3.amazonaws.com/dd-agent/scripts/install_script_agent6.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 がそのままの状態での完全な下位互換性は保証できないためです。
以下の手動アップグレード手順をご覧ください。
以下の内容で /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_FD4BF915.public
https://keys.datadoghq.com/DATADOG_RPM_KEY_E09422B3.public
ローカルの Yum リポジトリを更新し、Agent をインストールします。
sudo yum makecache
sudo yum install datadog-agent
構成サンプルを所定の位置にコピーし、適切な API キーを指定します。
sudo sh -c "sed 's/api_key:.*/api_key: <YOUR_API_KEY>/' /etc/datadog-agent/datadog.yaml.example > /etc/datadog-agent/datadog.yaml"
以下の 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/
Agent を (再) 起動します。
sudo systemctl restart datadog-agent.service
sudo initctl start datadog-agent
以下の内容で /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_FD4BF915.public
https://keys.datadoghq.com/DATADOG_RPM_KEY_E09422B3.public
注: dnf にバグが発生しているため、CentOS 8.1 では repo_gpgcheck=1
の代わりに repo_gpgcheck=0
を使用してください。
ローカルの Yum リポジトリを更新し、Agent をインストールします。
sudo yum makecache
sudo yum remove datadog-agent-base
sudo yum install datadog-agent
構成サンプルを所定の位置にコピーし、適切な API キーを指定します。
sudo sh -c "sed 's/api_key:.*/api_key: <YOUR_API_KEY>/' /etc/datadog-agent/datadog.yaml.example > /etc/datadog-agent/datadog.yaml"
以下の 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/
Agent を再起動します。
sudo systemctl restart datadog-agent.service
sudo initctl restart datadog-agent
APT の HTTPS サポートを有効にし、curl
と gnupg
をインストールします。
sudo apt-get update
sudo apt-get install apt-transport-https curl gnupg
システム上に 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_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
Debian 8 またはそれ以前で実行する場合は、鍵束を /etc/apt/trusted.gpg.d
にコピーします。
sudo cp /usr/share/keyrings/datadog-archive-keyring.gpg /etc/apt/trusted.gpg.d
ローカルの APT キャッシュを更新し、Agent をインストールします。
sudo apt-get update
sudo apt-get install datadog-agent datadog-signing-keys
構成サンプルを所定の位置にコピーし、適切な API キーを指定します。
sudo sh -c "sed 's/api_key:.*/api_key: <YOUR_API_KEY>/' /etc/datadog-agent/datadog.yaml.example > /etc/datadog-agent/datadog.yaml"
以下の 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/
Agent を起動します。
sudo service datadog-agent start
以下の内容で /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_FD4BF915.public
https://keys.datadoghq.com/DATADOG_RPM_KEY_E09422B3.public
ローカルの Yum リポジトリを更新し、Agent をインストールします。
sudo yum makecache
sudo yum remove datadog-agent-base
sudo yum install datadog-agent
構成サンプルを所定の位置にコピーし、適切な API キーを指定します。
sudo sh -c "sed 's/api_key:.*/api_key: <YOUR_API_KEY>/' /etc/datadog-agent/datadog.yaml.example > /etc/datadog-agent/datadog.yaml"
以下の 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/
Agent を再起動します。
sudo systemctl restart datadog-agent.service
以下の内容で /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_FD4BF915.public
https://keys.datadoghq.com/DATADOG_RPM_KEY_E09422B3.public
注: dnf にバグが発生しているため、RHEL 8.1 では repo_gpgcheck=1
の代わりに repo_gpgcheck=0
を使用してください。
ローカルの Yum リポジトリを更新し、Agent をインストールします。
sudo yum makecache
sudo yum remove datadog-agent-base
sudo yum install datadog-agent
構成サンプルを所定の位置にコピーし、適切な API キーを指定します。
sudo sh -c "sed 's/api_key:.*/api_key: <YOUR_API_KEY>/' /etc/datadog-agent/datadog.yaml.example > /etc/datadog-agent/datadog.yaml"
以下の 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/
Agent を再起動します。
sudo systemctl restart datadog-agent.service
sudo initctl restart datadog-agent
APT の HTTPS サポートを有効にし、curl
と gnupg
をインストールします。
sudo apt-get update
sudo apt-get install apt-transport-https curl gnupg
システム上に 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_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
Ubuntu 14 またはそれ以前で実行する場合は、鍵束を /etc/apt/trusted.gpg.d
にコピーします。
sudo cp /usr/share/keyrings/datadog-archive-keyring.gpg /etc/apt/trusted.gpg.d
ローカルの APT キャッシュを更新し、Agent をインストールします。
sudo apt-get update
sudo apt-get install datadog-agent datadog-signing-keys
構成サンプルを所定の位置にコピーし、適切な API キーを指定します。
sudo sh -c "sed 's/api_key:.*/api_key: <YOUR_API_KEY>/' /etc/datadog-agent/datadog.yaml.example > /etc/datadog-agent/datadog.yaml"
以下の 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/
Agent を起動します。
sudo systemctl start datadog-agent
sudo initctl start datadog-agent
/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_FD4BF915.public
https://keys.datadoghq.com/DATADOG_RPM_KEY_E09422B3.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 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"
以下の 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/
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
にアップグレードされます。
/opt/datadog-agent/etc/datadog.yaml
に API キーを追加します。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 構成ファイルの編集などのさまざまな処理を行うことができます。