概要

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

Datadog Agent をインストールする

要件

• Windows バージョン: Windows Server 2016 以降、または Windows 10 以降。サポートされている OS バージョンについては、Agent のサポートプラットフォームドキュメントを参照してください。
• Datadog アカウント: Datadog アカウントにアクセスでき、Datadog API キーを持っていることを確認してください。
• 管理者権限: Windows マシンで管理者権限が必要です。

Start-Process -Wait msiexec -ArgumentList '/qn /i datadog-agent-7-latest.amd64.msi APIKEY="<YOUR_DATADOG_API_KEY>" DDAGENTUSER_NAME="<YOUR_DOMAIN_NAME>\DatadogGMSA$"'

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

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

注

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

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

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

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

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

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

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

Agent のインストールログファイルは %TEMP%\MSI*.LOG にあります。

検証

インストールを確認するには、Agent のステータスと情報 セクションの手順に従ってください。

Agent のコマンド

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

• メインの実行可能ファイルは 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 を使ってチェックを有効化、無効化、および構成します。Agent を再起動して変更内容を適用します。

メインの Agent コンフィギュレーションファイルの場所: C:\ProgramData\Datadog\datadog.yaml

インテグレーション用構成ファイルの場所: C:\ProgramData\Datadog\conf.d\ または C:\Documents and Settings\All Users\Application Data\Datadog\conf.d\

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

Agent のアンインストール

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

プログラムの追加と削除

1. CTRL キーと Esc キーを押すか、Windows キーで Windows Search を実行します。
2. add を検索し、Add or remove programs をクリックします。
3. 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 が実行されていることを確認するには、サービスパネルで 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 のログは C:\ProgramData\Datadog\logs\agent.log にあります。

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

フレアの送信

• 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>

ユースケース

Windows サービスの監視

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

サービスの名前を確認するために、services.msc を開き、目的のサービスを見つけます。ターゲットとして DHCP を選択すると、次のように、サービスのプロパティウィンドウの上部にサービス名が表示されます。

独自のサービスを追加する場合は、次に示す書式に厳密に従ってください。書式が正しくないと、インテグレーションが失敗します。注: サービス名の特殊文字はエスケープする必要があります。たとえば、MSSQL$BILLING という名前の場合、MSSQL\$BILLING のように特殊文字を追加します。

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

サービスの場合、Datadog が追跡するのはアベイラビリティのみで、メトリクスは追跡されません (メトリクスについては、プロセスまたは WMI インテグレーションを使います)。モニターをセットアップするには、インテグレーションモニタータイプを選択し、続いて Windows Service を検索します。Integration Status -> Pick Monitor Scope から、モニターしたいサービスを選びます。

Windows のシステム負荷の監視

Datadog Agent は、デフォルトで多数のシステムメトリクスを収集します。最も一般的に使用されるシステムメトリクスは system.load.* ですが、これらのメトリクスは Unix 固有です。

Windows は system.load.* メトリクスを提供していませんが、デフォルトで使用できる同等のオプションは system.proc.queue.length です。このメトリクスは、実行を待機しているプロセッサーレディキューで遅延として観察されたスレッドの数を示します。

Windows プロセスの監視

ライブプロセスモニタリングで Windows プロセスをモニターすることができます。これを Windows で有効にするには、次のパラメーターを真に設定することで Agent のメイン構成ファイルを編集します:

datadog.yaml:

process_config:
  enabled: "true"

構成が完了したら、Agent を再起動します。

参考資料

お役に立つドキュメント、リンクや記事:

ログの収集DOCUMENTATION プロセスの収集DOCUMENTATION トレースの収集DOCUMENTATION Agent のアーキテクチャを詳しく見るDOCUMENTATION インバウンドポートの構成DOCUMENTATION Datadog Windows Agent ユーザーについてDOCUMENTATION