FTP probe

This probe allows to connect to an FTP directory and get information about its files and folders.

Settings example

Field	Description
Hostname	Server IP address or DNS name.
Port	Port number (default 21).
SSL/TLS	Secure FTP connection over SSL/TLS.
Login	FTP username.
Password	FTP password.
Base directory	Path to the directory where located folders and files are accessible for the user.
File mask	File mask to filter directory content.
Display file names	Displaying file names, stored in the directory, in the Data table.
Calculate directory sizes	Displaying the total size of the subfolders in the directory in the Data table.
Timeout	Maximum time to perform the check in milliseconds (30 seconds by default).
Period	How often to perform the check (60 seconds by default).

Field

Description

Hostname

Server IP address or DNS name.

Port

Port number (default 21).

SSL/TLS

Secure FTP connection over SSL/TLS.

FTP username.

Password

FTP password.

Base directory

Path to the directory where located folders and files are accessible for the user.

File mask

File mask to filter directory content.

Display file names

Displaying file names, stored in the directory, in the Data table.

Calculate directory sizes

Displaying the total size of the subfolders in the directory in the Data table.

Timeout

Maximum time to perform the check in milliseconds (30 seconds by default).

Period

How often to perform the check (60 seconds by default).

Results

After the check has been done result is displayed in the Data table:

Field	Description
count	Amount of files in the specified directory.
totalSize	Size of the specified directory or the total size of all subdirectories with files if the mode Calculate directory sizes is on.
maxSize	Maximum file size in the directory.
minSize	Minimum file size in the directory.
firstModified	Date of the first directory change.
lastModified	Date of the last directory change.
content.names.X	Names of files nested in directories if the mode Display file names is on.

Field

Description

count

Amount of files in the specified directory.

totalSize

Size of the specified directory or the total size of all subdirectories with files if the mode Calculate directory sizes is on.

maxSize

Maximum file size in the directory.

minSize

Minimum file size in the directory.

firstModified

Date of the first directory change.

lastModified

Date of the last directory change.

content.names.X

Names of files nested in directories if the mode Display file names is on.

Command-line utility

Execution of the same check in the terminal:

ftp
ftp> open
(to) 192.168.1.101 21
Connected to 192.168.1.101.
220 (vsFTPd 3.0.2)
Name (192.168.1.101:user1): mbox
331 Please specify the password.
Password:
230 Login successful.
Remore system type is UNIX.
Using Binary mode to transfer files.
ftp> ls 2V422-ZWEQ4-SJMFZ-ZR849-U8461/2017_03_21_17_10_02
200 PORT command successful. Consider using PASV.
150 Here comes the directory listing.
-rwxrwxrwx   1 1006    33     2299570 Mar 21 2017 1_149011621125.mp4
-rwxrwxrwx   1 1006    33     2327385 Mar 21 2017 1_14901162199.mp4
-rwxrwxrwx   1 1006    33     2258241 Mar 21 2017 2_149011621123.mp4
-rwxrwxrwx   1 1006    33     2203334 Mar 21 2017 2_149011621988.mp4
226 Directory send OK.

Known problems and errors

Sensor error! Authentication failed.

Authentication error.

Check the correctness of the data specified in the fields Login and Password.

Sensor error! No route to host.

Host unreachable.

Probable reasons:

the specified hostname is incorrect;
the specified hostname is not available from the network, where the check was performed;
the specified host (server) is down.

Check the correctness of the specified host address.

Sensor error! Connection refused (Connection refused).

Probable reasons:

the specified port number is incorrect;
firewall blocks the specified port.

Check the correctness of the specified port number (21 by default).

Check the firewall rules and make sure that the specified port is not among the blocked ports.