Datadog CoTerm のインストール

This product is not supported for your selected Datadog site. ().

CoTerm は macOS と Linux でサポートされています。

  1. Homebrew または curl を使用して Datadog CoTerm をインストールします。

    brew (macOS のみ)

    brew install coterm
    

    curl

    curl --tlsv1.2 --proto '=https' -sSf 'https://coterm.datadoghq.com/install-ddcoterm.sh' | bash
    

    このコマンドは、CoTerm の最新バージョンを .ddcoterm/bin/ddcoterm にダウンロードし、.bashrc および .zshrc の PATH を更新します。ターミナルを再起動するか、プロファイルを再読み込みします。Bash および Zsh 以外のシェルを使用している場合は、path/to/.ddcoterm/bin を PATH に手動で追加します。

  2. Datadog サイト がhttps://app.datadoghq.com でない場合は、.ddcoterm/config.yaml の connection_config.host でサイトを設定します。

    ...
    connection_config:
      host: 
    ...
    
  3. Initialize your configuration file by running:

    ddcoterm init
    

    設定を選択します。これらの設定は ~/.ddcoterm/config.yaml ファイルで変更できます。

CoTerm による Datadog への接続の認証

初期化中に、CoTerm が Datadog アカウントにアクセスするための認証方法として、以下のいずれかを選択できます。

  • OAuth: ブラウザが開き、OAuth でログインできます。
  • API Key + App Key (API キー + アプリケーションキー): ~/.ddcoterm/config.yamlで Datadog API キー と アプリケーションキー を設定するよう求められます。
  • API Key Only (API キーのみ): ~/.ddcoterm/config.yaml で Datadog API キーを設定するよう求められます。
[API Key Only] (API キーのみ) オプションを選択した場合、Work Management での承認を必須にすることはできません。

CoTerm 設定の構成

~/.ddcoterm/config.yaml ファイルには CoTerm の構成が含まれています。

process_config
CoTerm がリンターとして機能し、ルールに一致するコマンドをインターセプトしたときに特定のアクションを実行するように構成します。CoTerm 構成ルール を参照してください。
enable_telemetry
Datadog へのテレメトリ送信を有効または無効にします。デフォルトは false です。
enable_ptrace
Linux での実験的な ptrace ベースのプロセス監視を有効または無効にします。デフォルトは false です。
connection_config
host
Datadog への接続用のホストです。デフォルトは https://app.datadoghq.com です。
port
Datadog への接続用のポートです。デフォルトは 443 です。
api_key
OAuth を使用していない場合の Datadog API キー を指定します。OAuth を有効にしている場合、CoTerm はデフォルトで OAuth を使用し、api_key を無視します。
app_key
OAuth を使用していない場合の Datadog アプリケーションキー を指定します。
注: Work Management での承認を必須にする には、OAuth を使用するか、_または_このファイルに API キーとアプリケーションキーの両方を指定する必要があります。

次のステップ

  • 記録されたターミナルセッションを開始するには、ddcoterm を実行します。
  • CoTerm の使用方法 の詳細をご覧ください。

アンインストール

CoTerm をアンインストールするには、.ddcoterm フォルダーを削除します。

参考資料