Windows 用 Agent の基本的な使用方法

1. Datadog Agent インストーラーをダウンロードし、最新バージョンの Agent をインストールします。

   特定のバージョンの Agent をインストールする必要がある場合は、インストーラーリストを参照してください。

2. datadog-agent-7-latest.amd64.msi を開き、インストーラーを (管理者として) 実行します。

3. プロンプトに従ってライセンス契約に同意し、Datadog API キーを入力します。

4. インストールが終了したら、オプションから Datadog Agent Manager を起動できます。

コマンドラインを使用して Agent をインストールするには

1. Datadog Agent インストーラーをダウンロードします。
2. インストーラをダウンロードしたディレクトリで、以下のコマンドのいずれかを実行します。

コマンドプロンプト

start /wait msiexec /qn /i datadog-agent-7-latest.amd64.msi APIKEY="<YOUR_DATADOG_API_KEY>"

PowerShell

Start-Process -Wait msiexec -ArgumentList '/qn /i datadog-agent-7-latest.amd64.msi APIKEY="<DATADOG_API_キー>"'

注

• /qn オプションはバックグラウンドインストールを実行します。GUI プロンプトを表示する場合は、削除してください。
• Agent のバージョンによっては、強制的に再起動する場合があります。これを防ぐには、パラメーター REBOOT=ReallySuppress を追加します。

コンフィギュレーション

各構成項目は、コマンドラインにプロパティとして追加します。Agent を Windows にインストールする場合は、以下の構成コマンドラインオプションを使用できます。

注: 有効な datadog.yaml が見つかり、API キーが設定されている場合は、そのファイルが、指定されているすべてのコマンドラインオプションより優先されます。

Agent 7 は Python 3 のみをサポートします。アップグレードする前に、カスタムチェックが Python 3 と互換性があることを確認します。詳細については、Python 3 カスタムチェックの移行ガイドを参照してください。カスタムチェックを使用していないか、既に互換性を確認している場合は、GUI またはコマンドラインの手順を使用してアップグレードします。

< 5.12.0 の Datadog Agent バージョンからアップグレードする場合は、最初に EXE インストーラーを使用して Agent 5 のより新しいバージョン（>= 5.12.0 だが < 6.0.0）にアップグレードしてから、 Datadog Agent バージョン >= 6 にアップグレードします。

• メインの実行可能ファイルは agent.exe です。場所は以下の通り、Agent のバージョンにより異なります。
  • Agent バージョン 6.11 以前: "C:\Program Files\Datadog\Datadog Agent\embedded\agent.exe"
  • Agent バージョン 6.12 以降: "C:\Program Files\Datadog\Datadog Agent\bin\agent.exe"
• 構成 GUI は、ブラウザベースの構成アプリケーションです (Windows 64 ビット版のみ)。
• コマンドは**管理者特権 (管理者として実行)**のコマンドライン (PowerShell またはコマンドプロンプト) から、構文 <PATH_TO_AGENT.EXE> <COMMAND> を使用して実行できます。
• コマンドラインのオプションは次の通りです。

• 例:

  • PowerShell (powershell.exe)

    & "$env:ProgramFiles\Datadog\Datadog Agent\bin\agent.exe" status
    & "$env:ProgramFiles\Datadog\Datadog Agent\bin\agent.exe" launch-gui
    & "$env:ProgramFiles\Datadog\Datadog Agent\bin\agent.exe" flare
    

  • コマンドプロンプト (cmd.exe)

    "%ProgramFiles%\Datadog\Datadog Agent\bin\agent.exe" status
    "%ProgramFiles%\Datadog\Datadog Agent\bin\agent.exe" launch-gui
    "%ProgramFiles%\Datadog\Datadog Agent\bin\agent.exe" flare
    

(スタートメニューにある) Datadog Agent Manager を使用します。

Datadog Agent Manager で start、stop、および restart コマンドを使用します。

Windows PowerShell で、次のコマンドを使用することもできます。 [start|stop|restart]-service datadogagent

メインの Agent 構成ファイルの場所: C:\ProgramData\Datadog\datadog.yaml

メインの Agent 構成ファイルの場所: C:\ProgramData\Datadog\datadog.conf

Agent が実行されていることを確認するには、サービスパネルで DatadogAgent サービスが “Started” になっているかどうかをチェックします。また、Datadog Metrics Agent (agent.exe) というプロセスがタスクマネージャーに存在している必要があります。

Agent の状態に関する詳細な情報が必要な場合は、次のようにして Datadog Agent Manager を起動します。

• Datadog Agent のシステムトレイアイコンを右クリックし、“構成” を選択します。
• **管理者特権 (管理者として実行)**のコマンドラインから launch-gui コマンドを実行
  • PowerShell: & "<PATH_TO_AGENT.EXE>" launch-gui
  • cmd: "<PATH_TO_AGENT.EXE>" launch-gui

次に、Status -> General と移動して、ステータスページを開きます。 Status -> Collector および Checks -> Summary で、チェックの実行に関する詳細な情報を取得します。

PowerShell では、次の status コマンドを使用できます。

& "$env:ProgramFiles\Datadog\Datadog Agent\bin\agent.exe" status

cmd.exe では、次のようにします。

"%ProgramFiles%\Datadog\Datadog Agent\bin\agent.exe" status

Agent が実行されていることを確認するには、サービスパネルでサービスのステータスが “Started” になっているかどうかをチェックします。また、ddagent.exe というプロセスがタスクマネージャーに存在している必要があります。

Agent v5.2+ では、Agent の状態に関する情報は、 Datadog Agent Manager -> Settings -> Agent Status で確認できます。

Agent v3.9.1 ～ v5.1 のステータスを確認する場合は、http://localhost:17125/status に移動します。

PowerShell では、次の info コマンドを使用できます。

& "$env:ProgramFiles\Datadog\Datadog Agent\embedded<PYTHON_MAJOR_VERSION>\python.exe" "$env:ProgramFiles\Datadog\Datadog Agent\agent\agent.py" info

cmd.exe では、次のようにします。

"%ProgramFiles%\Datadog\Datadog Agent\embedded<PYTHON_MAJOR_VERSION>\python.exe" "%ProgramFiles%\Datadog\Datadog Agent\agent\agent.py" info

注: Agent バージョンが <= 6.11 の場合、パスは上記ではなく %ProgramFiles%\Datadog\Datadog Agent\embedded\python.exe にする必要があります。

Agent のログは C:\ProgramData\Datadog\logs\agent.log にあります。

注: ProgramData は隠しフォルダーです。

ご不明な点は、Datadog のサポートチームまでお問合せください。

Windows Server 2008/Vista 以降のシステムでは、Agent のログは C:\ProgramData\Datadog\logs にあります。

注: ProgramData は隠しフォルダーです。

ご不明な点は、Datadog のサポートチームまでお問合せください。

• http://127.0.0.1:5002 に移動して Datadog Agent Manager を表示します。

• Flare タブを選択します。

• チケット番号を入力します (お持ちの場合)。

• Datadog へのログインに使用するメールアドレスを入力します。

• Submit を押します。

PowerShell では、次の flare コマンドを使用できます。

& "$env:ProgramFiles\Datadog\Datadog Agent\bin\agent.exe" flare <CASE_ID>

cmd.exe では、次のようにします。

"%ProgramFiles%\Datadog\Datadog Agent\bin\agent.exe" flare <CASE_ID>

Datadog のサポートチームに Windows のログと構成のコピーを送信するには、次の手順に従います。

• Datadog Agent Manager を開きます。

• Actions を選択します。

• Flare を選択します。

• チケット番号を入力します (お持ちでない場合は、値をゼロのままにしてください)。

• Datadog へのログインに使用するメールアドレスを入力します。

PowerShell では、次の flare コマンドを使用できます。

& "$env:ProgramFiles\Datadog\Datadog Agent\embedded\python.exe" "$env:ProgramFiles\Datadog\Datadog Agent\agent\agent.py" flare <CASE_ID>

cmd.exe では、次のようにします。

"%ProgramFiles%\Datadog\Datadog Agent\embedded\python.exe" "%ProgramFiles%\Datadog\Datadog Agent\agent\agent.py" flare <CASE_ID>

フレアのアップロードの失敗

flare コマンドの出力で、圧縮されたフレアアーカイブが保存されているディレクトリがわかります。Datadog へのファイルアップロードに失敗した場合は、このディレクトリからファイルを取得して、メールの添付ファイルとして手動で追加することができます。フレアファイルの保存場所 (共通) :

• Linux: \tmp\
• MacOS: $TMPDIR
• Windows: C:\Users\<DDAGENTUSER>\AppData\Local\Temp\

Windows で古いバージョンの Agent を使用している場合、このファイルの場所を見つけるには、Agent の Python コマンドプロンプトから以下を実行します。

ステップ 1:

• Agent v5.12+ の場合: "%ProgramFiles%\Datadog\Datadog Agent\dist\shell.exe" since

• 古いバージョンの Agent の場合: "%ProgramFiles%\Datadog\Datadog Agent\files\shell.exe"

ステップ 2:

import tempfile
print tempfile.gettempdir()

例: