Zabbix Documentation 2.2

2.23.04.04.2 (current)In development:4.4 (devel)Unsupported:1.82.02.43.23.4

User Tools

Site Tools


manual:config:items:itemtypes:ssh_checks

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
manual:config:items:itemtypes:ssh_checks [2014/09/26 11:31]
sasha Links adapted because of a move operation
manual:config:items:itemtypes:ssh_checks [2016/07/18 11:35] (current)
martins-v key types other than "rsa" may not be supported by libssh2/zabbix
Line 12: Line 12:
  
 == - Passphrase authentication == == - Passphrase authentication ==
-SSH checks provide two authentication methods, a user/​password pair and key-file based respectively.+SSH checks provide two authentication methods, a user/​password pair and key-file based.
  
 If you do not intend to use keys, no additional configuration is required, besides linking libssh2 to Zabbix, if you're building from source. If you do not intend to use keys, no additional configuration is required, besides linking libssh2 to Zabbix, if you're building from source.
Line 81: Line 81:
 Note: public and private keys (//​id_rsa.pub//​ and //id_rsa// respectively) have been generated by default in the ///​home/​zabbix/​.ssh//​ directory which corresponds to the Zabbix server //​SSHKeyLocation//​ configuration parameter. Note: public and private keys (//​id_rsa.pub//​ and //id_rsa// respectively) have been generated by default in the ///​home/​zabbix/​.ssh//​ directory which corresponds to the Zabbix server //​SSHKeyLocation//​ configuration parameter.
  
 +<note important>​Key types other than "​rsa"​ may be supported by the ssh-keygen tool and SSH servers but they may not be supported by libssh2, used by Zabbix.</​note>​
 == - Shell configuration form == == - Shell configuration form ==
  
Line 112: Line 113:
 |**Public key file** ​ |File name of public key if //​Authentication method// is "​Public key". Required ​ |Example: //​id_rsa.pub//​ - default public key file name generated by a command [[http://​en.wikipedia.org/​wiki/​Ssh-keygen|ssh-keygen]] | |**Public key file** ​ |File name of public key if //​Authentication method// is "​Public key". Required ​ |Example: //​id_rsa.pub//​ - default public key file name generated by a command [[http://​en.wikipedia.org/​wiki/​Ssh-keygen|ssh-keygen]] |
 |**Private key file** ​ |File name of private key if //​Authentication method// is "​Public key". Required ​ |Example: //id_rsa// - default private key file name  | |**Private key file** ​ |File name of private key if //​Authentication method// is "​Public key". Required ​ |Example: //id_rsa// - default private key file name  |
-|**Password** or\\ **Key passphrase** |Password to authenticate or\\ Passphrase **if** it was used for the private key  |Leave the //Key passphrase//​ field empty if passphrase was not used  | +|**Password** or\\ **Key passphrase** |Password to authenticate or\\ Passphrase **if** it was used for the private key  |Leave the //Key passphrase//​ field empty if passphrase was not used\\ See also [[manual/​installation/​known_issues#​ssh_checks|known issues]] regarding passphrase usage  | 
-|**Executed script** ​ |Executed shell command(s) using SSH remote session ​ |Examples:​\\ //date +%s//\\ //service mysql-server status//\\ //ps aux | grep httpd | wc -l//  | +|**Executed script** ​ |Executed shell command(s) using SSH remote session ​ |Examples:​\\ //date +%s//\\ //service mysql-server status//\\ //ps auxww | grep httpd | wc -l//  |
  
 The resulting item configuration should look like this: The resulting item configuration should look like this:
Line 120: Line 120:
 {{ssh_item_config_example.png|}} {{ssh_item_config_example.png|}}
  
-<note important>​Some Linux distributions like Debian, Ubuntu do not support encrypted private keys (with passphrase) if a libssh2 library ​installed from packages.\\ For more details see a report [[https://​support.zabbix.com/​browse/​ZBX-4850|ZBX-4850]]</​note>​ +<note important>​libssh2 library ​may truncate executable scripts to ~32kB.</​note>​
- +
-=== - Executable scripts === +
- +
-Although the '​Executed script'​ field is limited to 64kB in length, the ssh library actually limits this data to 32kB. Also, processing time intense scripts should be used with caution as response time limits apply and this should be accounted for. Increasing the Timeout parameter in the server and/or agent configuration might mitigate instability in the data being returned.+