/Methods/GetTaskStatistics

<< Click to Display Table of Contents >>

Navigation:  API MasterSCADA 4D > Подключение к исполнительной системе по JSON > HTTP API MasterPLC > Отладка и диагностика >

/Methods/GetTaskStatistics

Метод позволяет получить детальную статистику по загрузке памяти и времени выполнения для одной или нескольких Lua-задач.

HTTP: POST /Methods/GetTaskStatistics

Запрос

{
  "sessionId": 464037086,
  "getAll": false,
  "tasks": [
    {
      "taskId": 72100
    }
  ]
}

Поля запроса

Поле

Тип

Обязат.

По умолчанию

Описание

sessionId

int

Нет

 

Нужен, если сессия не передана заголовком.

getAll

bool

Нет

false

Если true, возвращает статистику по всем доступным Lua-задачам (при этом массив tasks не читается).

tasks

array

Если getAll=false

 

Массив запрашиваемых задач.

tasks[].taskId

int64

Да

0

Уникальный идентификатор задачи в VM. (Ранее в старой справке упоминалось `taskIndex`, но C++ код ожидает только `taskId`).

Ответ

{
  "tasks": [
    {
      "taskId": 72100,
      "code": 0,
      "period": 100.0,
      "avgPeriod": 108.42,
      "minPeriod": 105.0,
      "maxPeriod": 109.0,
      "lastCycle": 1.0,
      "avgWorkTime": 0.31,
      "minWorkTime": 0.0,
      "maxWorkTime": 1.0,
      "memory": 414720.0,
      "errors": 0.0,
      "allTime": 407.0,
      "count": 1296.0
    },
    {
      "taskId": 72101,
      "code": 2151546880
    }
  ],
  "serverTime": 1657301389524,
  "code": 0
}

Поля ответа

Поле

Тип

Условие

Описание

tasks

array

Всегда

Массив ответов для каждой задачи.

tasks[].taskId

int64

Всегда

Идентификатор задачи.

tasks[].code

uint

Всегда

Статус задачи (0 — найдена, 2151546880 (0x803E0000, OpcUa_BadNotFound) — не найдена).

tasks[].period

double

Найдена

Заданный период задачи в мс.

tasks[].avgPeriod

double

Найдена

Средний фактический период между вызовами.

tasks[].minPeriod

double

Найдена

Минимальный период.

tasks[].maxPeriod

double

Найдена

Максимальный период.

tasks[].lastCycle

double

Найдена

Рабочее время последнего выполненного цикла в мс.

tasks[].avgWorkTime

double

Найдена

Среднее время выполнения цикла в мс.

tasks[].minWorkTime

double

Найдена

Минимальное рабочее время в мс.

tasks[].maxWorkTime

double

Найдена

Максимальное рабочее время в мс.

tasks[].memory

double

Найдена

Занятая задачами Lua-память (в байтах).

tasks[].errors

double

Найдена

Количество произошедших ошибок.

tasks[].allTime

double

Найдена

Суммарное время полезной работы задачи (в мс).

tasks[].count

double

Найдена

Общее количество отработанных циклов задачи.