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 の再起動run stop then start または 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 start
    サービスとして実行中の Agent の停止datadog-agent stop
    サービスとして実行中の Agent の再起動datadog-agent restart
    Agent サービスのステータスdatadog-agent status
    実行中の Agent のステータスページdatadog-agent info
    フレアの送信datadog-agent flare
    コマンドの使用方法の表示not implemented
    チェックの実行datadog-agent check <チェック名>

    コンフィギュレーション

      Agent の構成ファイルおよびフォルダーの場所:

      • ~/.datadog-agent/datadog.yaml

      インテグレーション用構成ファイルの場所

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

      Agent の構成ファイルおよびフォルダーの場所

      • ~/.datadog-agent/datadog.conf

      インテグレーション用構成ファイルの場所

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

      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 rm /Library/LaunchDaemons/com.datadoghq.agent.plist
sudo rm -rf /var/log/datadog
        3. マシンを再起動すると、変更が有効になります。
        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/** # 壊れたシンボリックリンクを削除するため

        オプションのインストールコマンドを実行して、Agent を起動時に実行させた場合は、以下を実行してアンインストールを終了してください。

        sudo launchctl unload -w /Library/LaunchDaemons/com.datadoghq.agent.plist
sudo rm /Library/LaunchDaemons/com.datadoghq.agent.plist

        この方法では、Agent とすべての Agent コンフィグレーションファイルが削除されます。

        ヘルプ

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

        埋め込み Agent の使用

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

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

        その他の参考資料

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

        ログの収集DOCUMENTATION more more プロセスの収集DOCUMENTATION more more トレースの収集DOCUMENTATION more more Agent のアーキテクチャを詳しく見るDOCUMENTATION more more インバウンドポートの構成DOCUMENTATION more more