Installer Datadog CoTerm

Ce produit n'est pas pris en charge par le site Datadog que vous avez sélectionné. ().

CoTerm est pris en charge sur macOS et Linux.

  1. Installer Datadog CoTerm avec Homebrew ou curl :

    brew (macOS uniquement)

    brew install coterm
    

    curl

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

    Cette commande télécharge la dernière version de CoTerm dans .ddcoterm/bin/ddcoterm et met à jour votre PATH dans .bashrc et .zshrc. Redémarrez votre terminal ou sourcez votre profil. Si vous utilisez un shell autre que Bash ou Zsh, ajoutez path/to/.ddcoterm/bin à votre PATH manuellement.

  2. Si votre site Datadog n’est pas https://app.datadoghq.com, définissez votre site dans .ddcoterm/config.yaml sous connection_config.host :

    ...
    connection_config:
      host: 
    ...
    
  3. Initialisez votre fichier de configuration en exécutant :

    ddcoterm init
    

    Sélectionnez vos paramètres. Vous pouvez modifier ces paramètres dans le fichier ~/.ddcoterm/config.yaml](#configurer-vos-paramètres-coterm).

Autoriser CoTerm à se connecter à Datadog

Lors de l’initialisation, vous pouvez choisir l’une des méthodes suivantes pour autoriser CoTerm à accéder à votre compte Datadog :

  • OAuth : ouvre un navigateur pour que vous puissiez vous connecter avec OAuth.
  • Clé d’API + clé d’application : vous invite à définir votre clé d’API Datadog et votre clé d’application dans ~/.ddcoterm/config.yaml.
  • Clé d’API uniquement : vous invite à définir votre clé d’API Datadog dans ~/.ddcoterm/config.yaml.
Si vous sélectionnez l'option Clé d'API uniquement, vous ne pouvez pas exiger d'approbations avec la gestion des cas.

Configurer vos paramètres CoTerm

Le fichier ~/.ddcoterm/config.yaml contient vos configurations CoTerm :

process_config
Configurer CoTerm pour qu’il agisse comme un linter et prenne certaines actions lorsqu’il intercepte une commande qui correspond à une règle. Consultez la section Règles de configuration CoTerm.
enable_telemetry
Activer ou désactiver l’envoi de données de télémétrie à Datadog. La valeur par défaut est false.
enable_ptrace
Activer ou désactiver la surveillance expérimentale des processus basée sur ptrace sous Linux. La valeur par défaut est false.
connection_config
host
Hôte pour la connexion à Datadog. La valeur par défaut est https://app.datadoghq.com.
port
Port pour la connexion à Datadog. La valeur par défaut est 443.
api_key
Si vous n’utilisez pas OAuth, votre clé d’API Datadog. Si vous avez activé OAuth, CoTerm utilise OAuth par défaut et ignore api_key.
app_key
Si vous n’utilisez pas OAuth, votre clé d’application Datadog.
Remarque : pour exiger des approbations avec la gestion des cas, vous devez utiliser OAuth ou spécifier à la fois votre clé d’API et votre clé d’application dans ce fichier.

Étapes suivantes

  • Exécutez ddcoterm pour démarrer une session de terminal enregistrée.
  • En savoir plus sur l’utilisation de CoTerm.

Désinstallation

Pour désinstaller CoTerm, supprimez le dossier .ddcoterm.

Pour aller plus loin