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

概要

このページでは、macOS 用 Datadog Agent の基本的な機能について説明します。Agent をまだインストールしていない場合は、Datadog Agent インテグレーションに関するドキュメントで手順を参照してください。

デフォルトでは、Agent は /opt/datadog-agent にあるサンドボックスにインストールされます。このフォルダーは任意の場所に移動できますが、ここでは、デフォルトのインストール場所を前提として説明します。

サポートされている macOS バージョン

macOS バージョンサポートされている Agent バージョン
macOS 10.10 & 10.11Agent v5
macOS 10.12Agent v5、Agent v6 (v6.34.0 まで)、Agent v7 (v7.34.0 まで)
macOS 10.13Agent 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

インテグレーション用コンフィギュレーションファイルの場所

  • ~/.datadog-agent/conf.d/

Agent のアンインストール

Agent をアンインストールするには、次のコマンドを実行します。

シングルユーザーインストール

Agent とすべての Agent 構成ファイルを削除するには

  1. トレイにある骨のアイコンで Datadog Agent を停止して閉じます。
  2. Datadog アプリケーションをアプリケーションフォルダからゴミ箱にドラッグします。
  3. 次のコマンドを実行します。
    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
    
  4. マシンを再起動すると、変更が有効になります。

システム全体の LaunchDaemon のインストール

Agent とすべての Agent 構成ファイルを削除するには

  1. Datadog アプリケーションをアプリケーションフォルダからゴミ箱にドラッグします。
  2. 残りのファイルを削除するには、以下を実行します。
    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
    
  3. マシンを再起動すると、変更が有効になります。

トラブルシューティング

Agent のトラブルシューティングに関するドキュメントを参照してください。

埋め込み Agent の使用

Agent には、埋め込み Python 環境が /opt/datadog-agent/embedded/ に含まれています。pythonpip などの共通バイナリは /opt/datadog-agent/embedded/bin/ に含まれています。

詳細については、埋め込み Agent へのパッケージの追加方法の手順を参照してください。

その他の参考資料