トップ > Datadog > WindowsにDatadog AgentをSSMで導入

WindowsにDatadog AgentをSSMで導入

Datadog Windows
記事タイトルとURLをコピーする

こんにちは、SWX3人目の熊谷（悠）です。

GUIでのインストール手順はWindowsにDatadog Agent導入をご参照ください。

環境

・AWSで公式のクイックスタートAMIを使用しました。
Microsoft Windows Server 2019 Base - ami-0f3651a900e33262f
Microsoft Windows 2019 Datacenter edition. [English]
※SSM Agentがデフォルトで入っています。

・インスタンスはprivate subnetに作成しました。
※ルートテーブル上0.0.0.0/0への通信はNATゲートウェイ向きのprotectedな環境

・セキュリティグループには最低限必要な以下のルールのみアタッチしてみました。

向き タイプ プロトコル ポート範囲 ソース/送信先 備考
アウトバウンドルール HTTPS TCP 443 0.0.0.0/0 Datadog Agentのモニタリングデータ送信用

・IAMはSSMに必要な権限が付与されている以下AWS管理ポリシーのみアタッチしたロールをEC2にアタッチしました。
AmazonSSMManagedInstanceCore

準備

DatdogのアカウントやOrganizationsの作成については割愛します。

API Key作成

Datadog API Keyが無い場合は、作成してください。

  1. Datadog サイトへログイン
  2. 画面左ナビバーの「Integrations」> 「APIs」をクリック ※ブラウザの種類や拡大率により、ナビバーは画面上部に配置されている場合があります。
  3. 「API Keys」 を展開
  4. 「API key name」に任意のキー名を入力し、「Create API Key」ボタンをクリック

紫色にマスクされているKey欄にマウスオーバーするとAPI Keyが表示できます。 2021-03-19_19h21_06.png

インストールコマンド確認

  1. Datadog サイトへログイン
  2. 画面左ナビバーの「Integrations」> 「Agent」をクリック ※ブラウザの種類や拡大率により、ナビバーは画面上部に配置されている場合があります。
  3. サイドタブから対象プラットフォームを選択※今回はWindows

New command-line installationの項番② Powershell版コマンドブロックを後述のインストール手順で使用します。
コマンド内にはホスト名とタグの指定HOSTNAME="my_hostname" TAGS="mytag1,mytag2"がありますが、任意項目なので不要なら削除しても大丈夫です。 2021-03-18_14h08_14.png

インストール

  1. AWS マネジメントコンソールへサインイン
    1. ※Session Managerが利用できる権限を持ったロールかユーザーへスイッチまたはサインインください
  2. AWS Systems Managerコンソールを開く
  3. ナビゲーションペインで、「ノード管理」を開き、「セッションマネージャー」をクリック

  4. 「セッションの開始」ボタンをクリック 2021-03-18_13h10_45.png

  5. 対象のインスタンスを選択し、「セッションを開始する」ボタンをクリック 2021-03-18_14h34_44.png 別のタブでセッションが開かれます。 2021-03-18_14h37_23.png

  6. Datadog Agent インストーラーをダウンロード

PS C:\Windows\system32> Invoke-WebRequest -Uri "https://s3.amazonaws.com/ddagent-windows-stable/datadog-agent-7-latest.amd64.msi" -OutFile ".\datadog-agent-7-latest.amd64.msi" -UseBasicParsing

2021-03-18_13h12_19.png

  1. ダウンロードしたファイルが存在するか念のため確認
PS C:\Windows\system32> dir -r -Filter "datadog-agent-7-latest.amd64.msi" -Name

2021-03-18_13h25_565.png

  1. 前項で確認したインストールコマンドを実行し、Datadog Agentをインストール
PS C:\Windows\system32> Start-Process -Wait msiexec -ArgumentList '/qn /i datadog-agent-7-latest.amd64.msi APIKEY="abcdefghijklmnopqrstuvwxyz1234567890" SITE="datadoghq.com"'
  1. Datadog Agentが実行されている事を確認
PS C:\Windows\system32> & "$env:ProgramFiles\Datadog\Datadog Agent\bin\agent.exe" status

エラーが出ず、現在のステータスを出力できればOK 2021-03-18_13h25_52.png

  1. Datadog Agent インストーラーを削除
PS C:\Windows\system32> Remove-Item .\datadog-agent-7-latest.amd64.msi
  1. 削除できているか念のため確認
PS C:\Windows\system32> dir -r -Filter "datadog-agent-7-latest.amd64.msi" -Name

確認

Eventsから

  1. Datadog サイトへログイン
  2. 画面左ナビバーの「Events」をクリック
  3. 対象ホストのDatadog Agent has startedイベントがあればOK 2021-03-17_15h54_54.png

Infrastructure Listから

  1. Datadog サイトへログイン
  2. 画面左ナビバーの「Infrastructure」＞「Infrastructure List」をクリック
  3. 対象ホストのStatus列左部にDatadog Agentの骨のようなアイコンが表示されていればOK 2021-03-17_17h59_40.png

Dashboardから

前項のInfrastructure List画面で対象ホストのホスト名リンクをクリック Memory等、標準のCloud Watchでは取得できない項目が表示されていればOK 2021-03-17_11h55_09.png

参考

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

Systems Manager の IAM インスタンスプロファイルを作成する - AWS Systems Manager