New announcements for Serverless, Network, RUM, and more from Dash! New announcements from Dash!

SSH Check

Agent Check Agent Check

Supported OS: Linux Mac OS Windows


This check lets you monitor SSH connectivity to remote hosts and SFTP response times.


Follow the instructions below to install and configure this check for an Agent running on a host. For containerized environments, see the Autodiscovery Integration Templates for guidance on applying these instructions.


The SSH/SFTP check is included in the Datadog Agent package, so you don’t need to install anything else on your server from which you’d like to test SSH connectivity.


  1. Edit the ssh_check.d/conf.yaml file in the conf.d/ folder at the root of your Agent’s configuration directory. See the sample ssh_check.d/conf.yaml for all available configuration options:

          - host: <SOME_REMOTE_HOST>  # required
            username: <SOME_USERNAME> # required
            password: <SOME_PASSWORD> # or use private_key_file
        #   private_key_file: <PATH_TO_PRIVATE_KEY>
        #   private_key_type:         # rsa or ecdsa; default is rsa
        #   port: 22                  # default is port 22
        #   sftp_check: False         # set False to disable SFTP check; default is True
        #   add_missing_keys: True    # default is False
  2. Restart the Agent to start sending SSH/SFTP metrics and service checks to Datadog.


Run the Agent’s status subcommand and look for ssh_check under the Checks section.

Data Collected


The response time of SFTP
Shown as second


The SSH Check does not include any events.

Service Checks


Returns CRITICAL if the Agent cannot open an SSH session, otherwise OK.


Returns CRITICAL if the Agent cannot open an SFTP session, otherwise OK.


Need help? Contact Datadog support.

Mistake in the docs? Feel free to contribute!