Монитор FTP

Монитор FTP проверяет службы FTP, либо закачивая файлы на FTP-серверы, либо скачивая файлы с FTP-серверов. Он выполняет мониторинг производительности службы, записывая время ответа и скорость передачи данных, а также отслеживает целостность дискового пространства и файлов.

Табл. 1. Сводка по монитору FTP
Файл монитора	Имя или положение
Выполняемый файл монитора	`nco_m_ftp`
Файл свойств	$ISHOME/etc/props/ftp.props
Файл правил	$ISHOME/etc/rules/ftp.rules
Файл журнала	$ISHOME/log/ftp.log

Рекомендации по конфигурированию монитора FTP: Монитор FTP проверяет доступность FTP-сервера, закачивая файл на сервер командой FTP STOR или скачивая файл с сервера командой FTP RETR.

Конфигурирование проверок службы монитора FTP

В следующей таблице описаны параметры конфигурации для монитора FTP.

Табл. 2. Конфигурация монитора FTP
Поле	Описание
сервер	IP-адрес FTP-сервера назначения, или компьютера, с которым вы хотите связаться по протоколу FTP. Пример: `ftp.mycompany.com`
localfile	Для операций FTP `GET` это поле задает имя и путь, куда скачивается файл. Для операций FTP `PUT` это поле задает имя и путь файла, который закачивается на FTP-сервер. Значение по умолчанию - FULL PATHNAME. Пример: $ISMHOOME/etc/ism/downloads/ftp-test.tar.Z
remotefile	Для операций FTP `GET` это поле задает имя и путь на FTP-сервере, откуда скачивается файл. Для операций FTP `PUT` это поле задает имя и путь на FTP-сервере, куда закачивается файл. Значение по умолчанию - FULL PATHNAME. Пример: /sales/prodlist.tar.Z
описание	Тестовое поле для описательной информации об этом элементе.
порт	Порт по умолчанию, используемый сервером FTP. По умолчанию: `21`
имя пользователя	Имя пользователя для регистрации на FTP-сервере назначения.
пароль	Пароль для регистрации на FTP-сервере назначения. Если учетная запись FTP не требует пароля, оставьте это поле пустым.
команда	Команда FTP, используемая монитором. `GET` или `RECV` - Скачать файл с FTP-сервера назначения `SEND` или `PUT` - Закачать файл на FTP-сервер назначения По умолчанию: `GET`.
тип соединения	Задает тип соединения, которое монитор устанавливает с сервером для передачи файла: `Активно` `Пассивный` По умолчанию: `Активно`
тайм-аут	Срок ожидания ответа сервера в секундах. По умолчанию: `30`.
poll	Время (в секундах) между двумя опросами. По умолчанию - `300`
failureretests	Сколько раз надо повторить тест, прежде чем сообщать о сбое. Значение по умолчанию: `0*`.
retestinterval	Время в секундах ожидания повторной попытки в случае неудачи. По умолчанию: `10`.

Поиск совпадений с регулярным выражением

Можно выполнить поиск регулярного выражения для скачиваемых данных, введя до 50 различных регулярных выражений. Монитор FTP пытается найти соответствие полученного содержимого с каждым из заданных регулярных выражений.

Если найдено совпадение с указанным регулярным выражением, то в соответствующем элементе $regexpMatchn будут возвращены совпавшие строки (или столько, сколько поместится во внутреннем буфере монитора). Если регулярное выражение будет найдено несколько раз в скачанной информации, то будет возвращено только первое совпадение. Состояние каждого теста регулярного выражения указывается с помощью элементов $regexpStatusn. Можно использовать совпадения регулярного выражения и их информацию о состоянии в качестве критериев для классификаций уровней обслуживания.

Регулярные выражения используются для поиска соответствий строк содержимого, загруженного в ходе проверок служб. Эти выражения могут содержать одну или несколько операций регулярных выражений, определяющих, с каким содержимым сравнивается регулярное выражение.

Прим.: Синтаксис регулярных выражений можно использовать для сопоставления строковых значений, составляющих одну строку. Internet Service Monitoring не может сопоставлять строковые значения, содержащие символы новой строки или возврата каретки. Для сопоставления строковых значений, охватывающих несколько строк, используйте несколько регулярных выражений. Для инициации оповещений на основе результата нескольких регулярных выражений можно также использовать правила SLC.

Табл. 3. Операторы регулярных выражений
Символ	Описание
`.`	Соответствует любому одному символу. Например, регулярное выражение `r.t` соответствует строкам `rat`, `rut`, `r t`, но не соответствует строке `root`.
`$`	Соответствует концу строки. Например, регулярное выражение `dog$` (собака$) соответствует концу строки `it's a dog` (это собака), но не соответствует строке `There are a lot of dogs` (Есть много собак).
`^`	Соответствует началу строки. Например, регулярное выражение `^When in` (^Когда в) соответствует началу строки `When in the course of human events` (Когда в ходе людских событий), но не соответствует строке `What and When in the` (Что и когда в).
`*`	Соответствует любому числу непосредственно предшествующих вхождений символов (включая нулевое число вхождений). Например, регулярное выражение `.*` соответствует любому числу любых символов.
`\`	Обрабатывает последующий символ как обычный символ Например, `\$` соответствует знаку доллара (`$`), а не символу конца строки. Аналогично, выражение `\.` соответствует точке, а не любому одному символу.
`[]`	Соответствует любому одному символу из заключенных в квадратные скобки. Например, регулярное выражение `r[aou]t` соответствует `rat`, `rot` и `rut`, но не соответствует `rit`. Для указания диапазонов символов используется дефис. Например, регулярное выражение `[0-9]` соответствует любой цифре. Можно также указать несколько диапазонов. Например, регулярное выражение `[A-Za-z]` соответствует любой латинской букве верхнего или нижнего регистра.
`\|`	Соответствует словосочетаниям, содержащим любое из заданных условий. Например, `him\|her` (ему\|ей) соответствует строке `it belongs to him` (это принадлежит ему) и строке `it belongs to her` (это принадлежит ей), но не соответствует строке `it belongs to them` (это принадлежит им).

Прим.: Если вы предпочитаете использовать строки выходных данных с фигурными скобками {} или двойными кавычками "", то необходимо добавить escape-символ обратная косая черта \ перед каждой фигурной скобкой и двойными кавычками в регулярном выражении.

Например, если строка данных выглядит так: {"templates":true,"mongodb":true,"ldap":true,"ucd":true,"github":true}, то регулярное выражение должно выглядеть так: \{\"templates\":true,\"mongodb\":true,\"ldap\":true,\"ucd\":true,\"github\":true\}

Элементы монитора

В дополнение к результатам проверки, общим для всех элементов, монитор FTP генерирует набор результатов проверок, содержащий данные проверки службы FTP.

Табл. 4. Элементы монитора FTP
Элемент	Описание
`$bytesPerSec*`(`BytesPerSec`)	Среднее число байт, переданных за секунду.
`$bytesTransfered*` (`BytesTransferred`)	Число скачанных или закачанных байтов.
`$checksum`	Обычно элемент Checksum не предоставляет осмысленные значения для классификаций уровней обслуживания, поскольку значения контрольной суммы при создании элемента профиля неизвестны (монитор вычисляет значения контрольной суммы во время выполнения проверок). Элементы монитора $checksum и $previousChecksum предназначены для дополнения оповещений информацией с помощью файла правил монитора.
`$command*`(`FtpCommand`)	Команда FTP, переданная монитором.
`$connectionType*`(`FtpConnection`)	Тип используемого соединения данных. Либо `ACTIVE`, либо `PASSIVE`.
`$connectTime*`(`ConnectTime`)	Время затраченное на соединение с сервером FTP.
`$downloadTime`	Время, затраченное на скачивание файла.
`$localFile*`(`FtpLocalFile`)	Полный путь файла, сохраняемого на локальном хосте. Этот элемент берется из файла конфигурации.
`$lookupTime*`(`LookupTime`)	Время, затраченное на поиск IP-адреса сервера FTP.
`$previousChecksum`	Элемент PreviousChecksum обычно не предоставляет осмысленные значения для классификаций уровней обслуживания, поскольку значения контрольной суммы при создании элемента профиля неизвестны (монитор вычисляет значения контрольной суммы во время выполнения проверок). Элементы монитора $previousChecksum и $checksum предназначены для дополнения оповещений информацией с помощью файла правил монитора.
`$regexpn`	Регулярное выражение.
`$regexpMatchn`	Содержимое строки, соответствующей регулярному выражению.
`$regexpStatusn`	Состояние соответствия регулярного выражения: `NONE` - Проверка регулярного выражения не сконфигурирована `MATCHED` - Для регулярного выражения было найдено соответствие `FAILED` - Для регулярного выражения не было найдено соответствие
`$remoteFile*`(`FtpRemoteFile`)	Полный путь файла, сохраняемого на удаленном хосте (FTP-сервере). Этот элемент берется из файла конфигурации.
`$responseTime*`(`ResponseTime`)	Время от момента создания соединения до получения первого байта файла назначения.
`$status`	Код состояния, возвращенный FTP-сервером.
`$transferTime*`(`TransferTime`)	Задает значение `$uploadTime` или `$downloadTime`.
`$uploadTime`	Время, потраченное, чтобы закачать файл.
`$username`	Имя пользователя (имя учетной записи), используемое монитором для входа на хост назначения. Этот элемент берется из файла конфигурации, если `$message` содержит `OK`.

Сообщения о состоянии

Монитор FTP предоставляет сообщения о состоянии в атрибуте ResultMessage при использовании IBM® Application Performance Management. В этих сообщениях указывается результат тестирования.

Табл. 5. Сообщения о состоянии монитора FTP
Сообщение	Описание
`OK`	Требование FTP успешно выполнено.
`Не удается открыть локальный файл для чтения/записи`	Дополнительную информацию смотрите в файле журнала монитора FTP.
`Не удается прочитать локальный файл/записать в него`
`Не удается прочитать из подключения к данным`	Соединение данных с сервером FTP было установлено, но возникла неполадка.
`Не удается закачать на сервер ftp`
`Тайм-аут при ожидании чтения/записи`
`Соединение закрыто внешним хостом`	Соединение с сервером FTP прервано.
`Соединение неожиданно закрыто`	Соединение с сервером FTP прервано.
`Не удалось установить соединение`	Монитор не смог соединиться с FTP-сервером. Дополнительную информацию смотрите в файле журнала монитора FTP.