Тип: Число. Содержит количество данных в байтах, прочитанных с диска сеансом за последние 5 минут.
Полное описание, параметры и ограничения
Сеанс.InBytesLast5Min (ISessionInfo.InBytesLast5Min)
Сеанс (ISessionInfo)
InBytesLast5Min (InBytesLast5Min)
Доступен, начиная с версии 8.3.1.
Использование:
Только чтение.
Описание:
Тип: Число.
Содержит количество данных в байтах, прочитанных с диска сеансом за последние 5 минут.
Доступность:
Интеграция.
Использование в версии:
Доступен, начиная с версии 8.3.1.
Методическая информация
Практические примеры
Отличить дисковый ввод-вывод от сети и памяти процесса
Показываем девять счётчиков в байтах и явно подписываем чтение диска, запись диска и память сеанса.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Только собственный изолированный тестовый кластер на Windows. Зарегистрированная в нём база называется guide-owned-session-lab, имя конфигурации этой базы УчебнаяБазаСеансов. Запустите в ней отдельный учебный клиент.
Создайте собственную обработку с управляемой формой. Вставьте весь код одного урока в модуль этой формы и свяжите команду Прочитать с обработчиком Прочитать. Серверная часть должна исполняться на Windows. Уроки заменяют весь модуль, а не добавляют шесть одинаковых функций.
V85.COMConnector должен быть уже зарегистрирован администратором на Windows-сервере 1С с подходящей разрядностью. Пример ничего не устанавливает и не регистрирует. Если COM недоступен, остановитесь и обратитесь к администратору тестового стенда.
В форме собственной обработки создайте строковые реквизиты КлючКластера, ИмяАгента, ПарольАгента, ИмяАдминистратора, ПарольАдминистратора и числовой НомерСеанса. Для полей паролей включите режим пароля, не сохраняйте значения в настройках формы.
КлючКластера вручную возьмите из собственной консоли администрирования: имя кластера|имя сервера|основной порт, например Учебный|localhost|1541. Это порт кластера, не порт агента 1540 и не порт RAS 1545.
Серверный код связывается только с агентом 127.0.0.1:1540 на том Windows-сервере, где исполняется модуль. Вводятся существующие учебные учётные данные агента и кластера; права и пароли не изменяются.
Клиентский обработчик приведён полностью: он очищает поля паролей до вызова сервера и не печатает аргументы или технический текст ошибок. Это не гарантирует безопасное стирание строк из памяти; учебные учётные данные не должны сохраняться в настройках формы.
Сначала НомерСеанса = 0: получите только ID и AppID сеансов этой учебной базы. Затем введите один ID из этого списка. ID уникален внутри информационной базы, а не во всём кластере.
Ниже дан законченный серверный пример получения настоящего объекта Сеанс, а не функция, требующая неизвестный ИсходныйОбъект. COM и кластер при подготовке руководства не запускались; требуется ручной запуск на собственном стенде.
&НаКлиенте
Процедура Прочитать(Команда)
ЛокальныйПарольАгента = ПарольАгента;
ЛокальныйПарольАдминистратора = ПарольАдминистратора;
ПарольАгента = "";
ПарольАдминистратора = "";
Попытка
Отчет = ПрочитатьУчебныйСеанс(КлючКластера, ИмяАгента, ЛокальныйПарольАгента, ИмяАдминистратора, ЛокальныйПарольАдминистратора, НомерСеанса);
Исключение
ЛокальныйПарольАгента = "";
ЛокальныйПарольАдминистратора = "";
Сообщить("Чтение не выполнено. Проверьте собственный стенд, COM, ключ кластера, права и наличие выбранного сеанса. Технические сведения проверяет администратор стенда.");
Возврат;
КонецПопытки;
ЛокальныйПарольАгента = "";
ЛокальныйПарольАдминистратора = "";
Сообщить(Отчет);
КонецПроцедуры
&НаСервереБезКонтекста
Функция ПрочитатьУчебныйСеанс(КлючКластера, ИмяАгента, ПарольАгента, ИмяАдминистратора, ПарольАдминистратора, НомерСеанса)
Если ПустаяСтрока(КлючКластера) Тогда
ВызватьИсключение "Укажите точный ключ собственного тестового кластера";
КонецЕсли;
Если НомерСеанса < 0 Или Цел(НомерСеанса) <> НомерСеанса Тогда
ВызватьИсключение "Номер сеанса должен быть целым неотрицательным числом";
КонецЕсли;
Соединитель = Новый COMОбъект("V85.COMConnector");
Агент = Соединитель.ConnectAgent("127.0.0.1:1540");
Агент.AuthenticateAgent(ИмяАгента, ПарольАгента);
ПодходящиеКластеры = Новый Массив;
Для Каждого Кандидат Из Агент.GetClusters() Цикл
КлючКандидата = СтрШаблон("%1|%2|%3", Кандидат.ClusterName, Кандидат.HostName, Кандидат.MainPort);
Если НРег(КлючКандидата) = НРег(КлючКластера) Тогда
ПодходящиеКластеры.Добавить(Кандидат);
КонецЕсли;
КонецЦикла;
Если ПодходящиеКластеры.Количество() <> 1 Тогда
ВызватьИсключение "Собственный тестовый кластер не выбран однозначно";
КонецЕсли;
Кластер = ПодходящиеКластеры.Получить(0);
Агент.Authenticate(Кластер, ИмяАдминистратора, ПарольАдминистратора);
УчебныеБазы = Новый Массив;
Для Каждого ОписаниеБазы Из Агент.GetInfoBases(Кластер) Цикл
Если ОписаниеБазы.Name = "guide-owned-session-lab" Тогда
УчебныеБазы.Добавить(ОписаниеБазы);
КонецЕсли;
КонецЦикла;
Если УчебныеБазы.Количество() <> 1 Тогда
ВызватьИсключение "Зарегистрированная учебная база не выбрана однозначно";
КонецЕсли;
УчебнаяБаза = УчебныеБазы.Получить(0);
УчебныеСеансы = Агент.GetInfoBaseSessions(Кластер, УчебнаяБаза);
СтрокиОтчета = Новый Массив;
НайденныеСеансы = Новый Массив;
Для Каждого КандидатСеанс Из УчебныеСеансы Цикл
Если НомерСеанса = 0 Тогда
СтрокиОтчета.Добавить(СтрШаблон("Сеанс %1; приложение %2", КандидатСеанс.SessionID, КандидатСеанс.AppID));
ИначеЕсли КандидатСеанс.SessionID = НомерСеанса Тогда
НайденныеСеансы.Добавить(КандидатСеанс);
КонецЕсли;
КонецЦикла;
Если НомерСеанса = 0 Тогда
Если СтрокиОтчета.Количество() = 0 Тогда
Возврат "В учебной базе сейчас нет сеансов";
КонецЕсли;
Возврат СтрСоединить(СтрокиОтчета, Символы.ПС);
КонецЕсли;
Если НайденныеСеансы.Количество() <> 1 Тогда
ВызватьИсключение "Учебный сеанс исчез или не выбран однозначно; обновите список";
КонецЕсли;
Сеанс = НайденныеСеансы.Получить(0);
Если Сеанс.InfoBase.Name <> "guide-owned-session-lab" Тогда
ВызватьИсключение "Сеанс не принадлежит выбранной учебной базе";
КонецЕсли;
СтрокиОтчета.Добавить(СтрШаблон("Прочитано с диска, байт: всего=%1; текущий вызов=%2; последние 5 минут=%3", Сеанс.InBytesAll, Сеанс.InBytesCurrent, Сеанс.InBytesLast5Min));
СтрокиОтчета.Добавить(СтрШаблон("Записано на диск, байт: всего=%1; текущий вызов=%2; последние 5 минут=%3", Сеанс.OutBytesAll, Сеанс.OutBytesCurrent, Сеанс.OutBytesLast5Min));
СтрокиОтчета.Добавить(СтрШаблон("Занято памяти в ходе вызовов, байт: с начала=%1; с начала текущего вызова=%2; последние 5 минут=%3", Сеанс.MemoryAll, Сеанс.MemoryCurrent, Сеанс.MemoryLast5Min));
СтрокиОтчета.Добавить(СтрШаблон("MemoryCurrent в МиБ=%1", Сеанс.MemoryCurrent / 1024 / 1024));
Возврат СтрСоединить(СтрокиОтчета, Символы.ПС);
КонецФункцииРазбор по шагам
InBytes — байты, прочитанные с диска; OutBytes — записанные на диск. Это не приём и отправка сетевого пакета.
Для сети есть bytes/dbmsBytes из отдельного урока. Одинаковое слово Bytes не делает назначения одинаковыми.
MemoryAll/MemoryCurrent/MemoryLast5Min описывают занятую память в ходе вызовов за соответствующий интервал. Это не обещание RSS, максимума или текущей виртуальной памяти всего rphost.
Все исходные значения в байтах; МиБ = байты /1024/1024. Название МиБ используется явно, не подменяет десятичные МБ.
Если текущего серверного вызова нет, MemoryCurrent может быть ноль. По одному снимку нельзя объявить утечку.
Как проверить результат
Ни один InBytes/OutBytes не подписан как сеть. Ноль дисковой активности на простом учебном клиенте допустим.
Сравнивайте снимки собственного сеанса до и после учебной команды; не обещайте размер её файла по одному счётчику.
Ожидаемый результат
Новичок получает настоящие дисковые и memory-показатели, не смешивая их с сетью и памятью процесса.
На что обратить внимание
Не сравнивать MemoryAll с лимитом оперативной памяти сервера как с текущим потреблением процесса.
Процесс MemorySize имеет другую единицу — килобайты; он разобран в следующем уроке.
Нет необходимости записывать файлы или создавать нагрузку в рабочей базе ради демонстрации счётчиков.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.