NAME

HealthCheck::Diagnostic::SSH - Verify SSH connectivity to specified host.

VERSION

version v0.1.0

SYNOPSIS

Checks and verifies connection to SSH. Can optionally run commands through the connection.

my $health_check = HealthCheck->new( checks => [
    HealthCheck::Diagnostic::SSH->new(
        host => 'somehost.com',
        user => 'some_user,
    )
]);

my $health_check = HealthCheck->new( checks => [
    HealthCheck::Diagnostic::SSH->new(
        host     => 'somehost.com',
        user     => 'some_user,
        ssh_args => {
            identity_files => [ '~/user/somepath/privatefile' ]
        },
        command       => 'echo "Hello World!"',
        return_output => 1,
    )
]);

DESCRIPTION

Determines if a SSH connection to a host is achievable. Sets the status to "OK" if the connection is successful and we can run the optional command parameter. The status is set to "UNKNOWN" if required parameters are missing. Otherwise, the status is set to "CRITICAL".

host

The server name to connect to for the test. This is required.

name

A descriptive name for the connection test. This gets populated in the resulting info tag.

user

Optional argument that can get passed into login method of Net::SSH::Perl. Represents the authentication user credential for the host.

For more information, see "login" in Net::SSH::Perl.

password

Optional argument that can get passed into login method of Net::SSH::Perl. identity_files in ssh_args can be used to authenticate by default. Represents the authentication password credential for the host.

ssh_args

Optional argument that can get passed into the Net::SSH::Perl constructor. Additional SSH connection parameters. Only default parameter is the protocol set as 2. identity_files can be set in here to authenticate using the files by default.

For more information on the possible arguments, refer to Net::SSH::Perl.

command

Optional argument that can get passed into cmd method of Net::SSH::Perl. If provided, runs command and prints output into data depending on the value of "display" input. An error output from running the command would result in a non-zero value of data-exit_code> which is always provided. If display is enabled, output of the command is shown in data-stdout> and an error message, if any, is stored in data-stderr>.

stdin

Optional argument that can get passed into cmd method of Net::SSH::Perl. If provided, it's supplied to the command on standard input.

return_output

Optional argument that determines whether output of Net::SSH::Perl->cmd should be displayed. If provided a truthy value, (preferrably 1 for clarity) the data field of the output will be populated with stdout and stderr. If ommitted, only the exit_code will show by default as noted in "command".

INTERNALS

run_command

Used internally to run an ssh cmd and assemble the result into a data structure to be used as as part of the Result.

ssh_connect

Used internally to instantiate a Net::SSH::Perl instance

DEPENDENCIES

• HealthCheck::Diagnostic
• Net::SSH::Perl

AUTHOR

Grant Street Group developers@grantstreet.com

COPYRIGHT AND LICENSE

This software is Copyright (c) 2021 - 2023 by Grant Street Group.

This is free software, licensed under:

The Artistic License 2.0 (GPL Compatible)