概要
このページでは、macOS 用 Datadog Agent の基本的な機能について説明します。Agent をまだインストールしていない場合は、Datadog Agent インテグレーションに関するドキュメントで手順を参照してください。
デフォルトでは、Agent は /opt/datadog-agent
にあるサンドボックスにインストールされます。このフォルダーは任意の場所に移動できますが、ここでは、デフォルトのインストール場所を前提として説明します。
サポートされている macOS バージョン
macOS バージョン | サポートされている Agent バージョン |
---|
macOS 10.10 & 10.11 | Agent v5 |
macOS 10.12 | Agent v5、Agent v6 (v6.34.0 まで)、Agent v7 (v7.34.0 まで) |
macOS 10.13 | Agent v5、Agent v6 (v6.38.2 まで)、Agent v7 (v7.38.2 まで) |
macOS 10.14+ | Agent v5、Agent v6、Agent v7 |
コマンド
Agent v6 および v7 では、オペレーティングシステムから提供される launchctl
サービスマネージャーが Agent のライフサイクルを担う一方で、他のコマンドは Agent バイナリから直接実行する必要があります。別の方法として、ライフサイクルコマンドを systray アプリで管理し、他のコマンドは Web GUI から実行することもできます。
説明 | コマンド |
---|
Agent をサービスとして起動 | launchctl start com.datadoghq.agent または systray アプリ |
サービスとして実行中の Agent の停止 | launchctl stop com.datadoghq.agent または systray アプリ |
サービスとして実行中の Agent の再起動 | 以下で Agent を停止し、起動します。
launchctl stop com.datadoghq.agent
launchctl start com.datadoghq.agent または systray アプリを使用します |
Agent サービスのステータス | launchctl list com.datadoghq.agent または systray アプリ |
実行中の Agent のステータスページ | datadog-agent status または Web GUI |
フレアの送信 | datadog-agent flare または Web GUI |
コマンドの使用方法の表示 | datadog-agent --help |
チェックの実行 | datadog-agent check <チェック名> |
構成
Agent の構成ファイルおよびフォルダーの場所
~/.datadog-agent/datadog.yaml
インテグレーション用コンフィギュレーションファイルの場所
Agent のアンインストール
Agent をアンインストールするには、次のコマンドを実行します。
シングルユーザーインストール
Agent とすべての Agent 構成ファイルを削除するには
- トレイにある骨のアイコンで Datadog Agent を停止して閉じます。
- Datadog アプリケーションをアプリケーションフォルダからゴミ箱にドラッグします。
- 次のコマンドを実行します。
sudo rm -rf /opt/datadog-agent
sudo rm -rf /usr/local/bin/datadog-agent
sudo rm -rf ~/.datadog-agent/** # to remove broken symlinks
launchctl remove com.datadoghq.agent
sudo rm -rf /var/log/datadog
- マシンを再起動すると、変更が有効になります。
システム全体の LaunchDaemon のインストール
Agent とすべての Agent 構成ファイルを削除するには
- Datadog アプリケーションをアプリケーションフォルダからゴミ箱にドラッグします。
- 残りのファイルを削除するには、以下を実行します。
sudo rm -rf /opt/datadog-agent
sudo rm -rf /usr/local/bin/datadog-agent
sudo rm -rf ~/.datadog-agent/** # to remove broken symlinks
sudo launchctl disable system/com.datadoghq.agent && sudo launchctl bootout system/com.datadoghq.agent
sudo launchctl unload /Library/LaunchDaemons/com.datadoghq.agent.plist
sudo rm /Library/LaunchDaemons/com.datadoghq.agent.plist
sudo rm -rf /var/log/datadog
- マシンを再起動すると、変更が有効になります。
トラブルシューティング
Agent のトラブルシューティングに関するドキュメントを参照してください。
埋め込み Agent の使用
Agent には、埋め込み Python 環境が /opt/datadog-agent/embedded/
に含まれています。python
、pip
などの共通バイナリは /opt/datadog-agent/embedded/bin/
に含まれています。
詳細については、埋め込み Agent へのパッケージの追加方法の手順を参照してください。
その他の参考資料