Windows

Docs > Agent > Supported Platforms > Windows

概要

このページでは、Datadog Agent for Windows の基本的な機能について概説します。まだ Agent をインストールしていない場合は、下記のインストール手順を参照するか、アプリ内の指示に従ってください。

サポートされている Windows バージョンの全一覧は、サポートされているプラットフォームを参照してください。

インストール

Windows ホストに Datadog Agent をインストールするには、Fleet Automation 内のガイド付きアプリ内フローに従い、インストールコマンドをコピーして実行してください。Datadog Agent は ddagentuser の下で実行されます。詳細については、Datadog Windows Agent ユーザーのドキュメントを参照してください。

代替インストール方法

Agent Manager GUI を使用するインストール

Agent のデフォルトのインストール先は %ProgramFiles%\Datadog\Datadog Agentです。カスタムインストール場所を使用する場合は、Datadog ファイルを収容する Datadog サブディレクトリを指定してください。

Datadog Agent インストーラーをダウンロードし、最新バージョンの Agent をインストールします。
datadog-agent-7-latest.amd64.msiを開いてインストーラーを実行します。プロンプトが表示されたら、管理者の資格情報を入力します。
プロンプトに従ってライセンス契約に同意し、Datadog API キーを入力します。

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

インストール構成オプション

Windows に Agent をインストールする際、下記の各構成オプションをコマンドラインのプロパティとして追加することができます。他の Agent 構成オプションについては、Agent 構成オプションの詳細を参照してください。

変数	型	説明
`APIKEY`	文字列	Datadog API キーを構成ファイルに追加します。
`SITE`	文字列	Datadog の取り込みサイトを設定します。例: `SITE=datadoghq.com`
`TAGS`	文字列	構成ファイルで割り当てるタグのカンマ区切りリスト。例: `TAGS="key_1:val_1,key_2:val_2"`
`HOSTNAME`	文字列	Agent から Datadog に報告されるホスト名を設定します (実行時に計算されたホスト名をオーバーライド)。
`DDAGENTUSER_NAME`	文字列	Agent インストール時に使用されるデフォルトの `ddagentuser` ユーザー名をオーバーライドします (v6.11.0 以上)。Datadog Windows Agent ユーザーについての詳細。
`DDAGENTUSER_PASSWORD`	文字列	`ddagentuser` ユーザーのために生成された暗号的に安全なパスワードをオーバーライドします (v6.11.0 以上)。ドメインサーバーへのインストールには必ず指定する必要があります。Datadog Windows Agent ユーザーについての詳細。
`APPLICATIONDATADIRECTORY`	パス	構成ファイルのディレクトリツリーに使用するディレクトリを上書きします。初回インストール時のみ指定可能; アップグレードでは無効です。デフォルト: `C:\ProgramData\Datadog`。(v6.11.0 以上)
`PROJECTLOCATION`	パス	バイナリファイルのディレクトリツリーに使用するディレクトリを上書きします。初回インストール時のみ指定可能; アップグレードでは無効です。デフォルト: `%ProgramFiles%\Datadog\Datadog Agent`。(v6.11.0 以上) デフォルトのディレクトリを上書きすることを選択した場合は、Datadog ファイルを格納する `Datadog` サブディレクトリを指定してください。

注

/qn オプションは、サイレントインストールを実行します。GUI プロンプトを表示するには、これを削除してください。
一部の Agent バージョンでは、強制的に再起動が発生する可能性があります。これを防ぐには、パラメーター REBOOT=ReallySuppress を追加してください。
一部の Agent コンポーネントはデータを収集するためにカーネルドライバーを必要とします。お使いのコンポーネントにカーネルドライバーが必要かどうかを知るには、そのドキュメントページを参照するか、関連する Agent 構成ファイルで kernel driver を検索してください。
有効な datadog.yaml が見つかった場合、そのファイルが、指定されているすべてのコマンドラインオプションより優先されます。

その他の Agent 構成オプション

Windows に Agent をインストールする際、下記の各構成オプションをコマンドラインのプロパティとして追加することができます。

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

変数	型	説明
`LOGS_ENABLED`	文字列	構成ファイルでログ収集機能を有効 (`"true"`) または無効 (`"false"`) にします。デフォルトでは、ログは無効です。
`APM_ENABLED`	文字列	構成ファイルで APM Agent を有効 (`"true"`) または無効 (`"false"`) にします。デフォルトでは、APM は有効です。
`PROCESS_ENABLED`	文字列	構成ファイルで Process Agent を有効 (`"true"`) または無効 (`"false"`) にします。デフォルトでは、Process Agent は無効です。
`HOSTNAME_FQDN_ENABLED`	文字列	Agent ホスト名に FQDN を使用することを有効 (`"true"`) または無効 (`"false"`) にします。これは、Agent 構成ファイルで `hostname_fqdn` を設定することに相当します。ホスト名に FQDN を使用することはデフォルトでは無効です。(v6.20.0 以上)
`CMD_PORT`	数値	0 ～ 65534 の有効なポート番号。Datadog Agent はコマンド API をポート 5001 で公開します。このポートが既に別のプログラムで使用されている場合は、この変数でデフォルトを上書きできます。
`PROXY_HOST`	文字列	(プロキシを使用する場合) プロキシホストを設定します。Datadog Agent でプロキシを使用する方法の詳細。
`PROXY_PORT`	数値	(プロキシを使用する場合) プロキシポートを設定します。Datadog Agent でプロキシを使用する方法の詳細。
`PROXY_USER`	文字列	(プロキシを使用する場合) プロキシユーザーを設定します。Datadog Agent でプロキシを使用する方法の詳細。
`PROXY_PASSWORD`	文字列	(プロキシを使用する場合) プロキシユーザーを設定します。プロセス/コンテナ Agent の場合、この変数は認証パスワードを渡すために必須であり、名前を変更することはできません。Datadog Agent でプロキシを使用する方法の詳細。
`EC2_USE_WINDOWS_PREFIX_DETECTION`	ブール値	EC2 上の Windows ホストの EC2 インスタンス ID を使用します。(v7.28.0 以上)

インストールログファイル

/log <FILENAME> msiexec オプションを設定してインストールログファイルを構成します。このオプションが設定されていない場合、msiexec はデフォルトで %TEMP%\MSI*.LOG にログを書き込みます。

構成

メイン Agent 構成ファイルは C:\ProgramData\Datadog\datadog.yaml にあります。このファイルは、API キー、選択した Datadog サイト、プロキシパラメーター、ホストタグ、ログレベルなどのホスト全体の設定に使用されます。

同じディレクトリに datadog.yaml.example ファイルもあります。このファイルには、使用可能なすべての構成オプションを示すリファレンスがコメントとしてフルで付けられており、特定の構成を参照したりコピーしたりするのに便利です。

インテグレーション用の構成ファイルは C:\ProgramData\Datadog\conf.d\ にあります。代替のレガシー場所がある場合もあります: C:\Documents and Settings\All Users\Application Data\Datadog\conf.d\。

各インテグレーションには、下記のものを格納するサブディレクトリ <INTEGRATION>.d\ があります。

conf.yaml: インテグレーションのアクティブな設定

conf.yaml.example: サポートされている構成キーを示すサンプルファイル

構成変更を行う際は、変更が反映されるように Agent を再起動してください。

Datadog Agent Manager GUI を使用して、チェックを有効化、無効化、構成できます。変更を反映させるためには、Agent を再起動する必要があります。

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

Agent のコマンド

Agent の実行は、Windows サービスコントロールマネージャーによって制御されています。

メインの実行可能ファイル名は agent.exe です。
構成 GUI は、ブラウザベースの構成アプリケーションです (Windows 64 ビット版のみ)。
コマンドは管理者特権 (管理者として実行) のコマンドライン (PowerShell またはコマンドプロンプト) から、構文 <PATH_TO_AGENT.EXE> <COMMAND> を使用して実行できます。
コマンドラインのオプションは次の通りです。

コマンド	説明
check	指定されたチェックを実行します。
diagnose	システムに対して接続診断を実行します。
flare	フレアを収集して Datadog に送信します。
help	コマンドのヘルプを表示します。
hostname	Agent が使用するホスト名を出力します。
import	以前のバージョンの Agent から構成ファイルをインポートして変換します。
launch-gui	Datadog Agent Manager を起動します。
restart-service	サービスコントロールマネージャー内で Agent を再起動します。
run	Agent を起動します。
start	Agent を起動します。(非推奨ですが、使用はできます。代わりに `run` を使用してください。)
start-service	サービスコントロールマネージャー内で Agent を起動します。
status	現在のステータスを出力します。
stopservice	サービスコントロールマネージャー内で Agent を停止します。
バージョン	バージョン情報を出力します。

例:

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

Agent のアンインストール

Windows で Agent をアンインストールする方法は 2 つあります。どちらの方法も Agent を削除しますが、ホスト上の C:\ProgramData\Datadog 構成フォルダーは削除しません。

プログラムの追加と削除

CTRLキーとEscキーを押すか、Windowsキーで Windows Search を実行します。
addを検索し、Add or remove programsをクリックします。
Datadog Agentを検索し、Uninstallをクリックします。

PowerShell

注: 下記のコマンドを使用する場合は、WinRM を有効にしてください。

下記の PowerShell コマンドを使用して、再起動せずに Agent をアンインストールします。

$productCode = (@(Get-ChildItem -Path "HKLM:SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall" -Recurse) | Where {$_.GetValue("DisplayName") -like "Datadog Agent" }).PSChildName
start-process msiexec -Wait -ArgumentList ('/log', 'C:\uninst.log', '/q', '/x', "$productCode", 'REBOOT=ReallySuppress')

トラブルシューティング

トラブルシューティング手順については、Agent トラブルシューティングのドキュメントを参照してください。

Agent のステータスと情報

Agent が実行中であることを確認するには、サービスパネルで DatadogAgent サービスが Started と表示されているかチェックしてください。Datadog Metrics Agent (agent.exe) というプロセスもタスクマネージャーに存在するはずです。

Agent の状態に関する情報をさらに受け取るには、次のようにして Datadog Agent Manager を起動します。

Datadog Agentのシステムトレイアイコンを右クリックし、Configure を選択します。または
管理者特権 (管理者として実行) コマンドラインから 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

ログの場所

エージェントのログは C:\ProgramData\Datadog\logs\agent.log にあります。

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

ユースケース

Windows サービスの監視

ターゲットホストで Datadog Agent Manager を起動し、リストから Windows Service インテグレーションを選択します。すぐに使える例がありますが、この例では DHCP を使用します。

サービスの名前を取得するには、services.msc を開き、ターゲットサービスを見つけます。DHCP をターゲットとして使用すると、サービスプロパティウィンドウの上部にサービス名が表示されます。

独自のサービスを追加する際は、表示されているフォーマットに正確に従ってください。フォーマットが正しくない場合、インテグレーションは失敗します。注: サービス名に特殊文字が含まれている場合はエスケープする必要があります。たとえば、MSSQL$BILLING という名前は MSSQL\$BILLING で追加できます。

また、インテグレーションを変更するたびに、Datadog サービスを再起動する必要があります。これは services.msc または UI サイドバーから行うことができます。

サービスについて、Datadog はメトリクスを追跡せず、可用性のみを追跡します。(メトリクスの場合は、Process または WMI 統合を使用してください)。モニターを設定するには、インテグレーションモニタータイプを選択し、Windows Service を検索します。Integration Status > Pick Monitor Scope から、監視するサービスを選択します。