PI Web API

Архив AVEVA PI и FactoryTalk Historian прямо в чате

Какие точки AVEVA PI или FactoryTalk Historian отдают No Data и с какого часа дыра в архиве. Снимок значений и архив агент берёт через PI Web API, только чтение.

Примеры: PI Web API

PI Web API
Реальные чаты: выберите вопрос
Есть ли дыры в архиве за неделю?

4 точки отдают No Data, самая старая дыра с понедельника 02:00.

  • Три точки одного интерфейса, данных нет с 02:00 до 06:30
  • Расходомер F-12 молчит со вторника

Системные состояния PI показываю как пропуск, а не как ноль.

Открыть в чате

Как агент работает с PI Web API

Данные с объекта забирает программа сбора данных: она работает службой на сервере в сети объекта и обращается к PI Web API по адресу вида https://pi.local/piwebapi. Он читает точки одного PI Data Archive, если вы назовёте сервер, или всех архивов за этим PI Web API, с фильтром по маскам имён. FactoryTalk Historian SE устроен как PI Data Archive и читается так же.

Программа сбора читает архив каждой точки вперёд от места, где остановился, через streamsets/recorded: по 50 точек за запрос и до 1000 значений на точку за страницу, с запасом в минуту, чтобы не потерять событие, которое PI Buffer Subsystem дописал позже. В чтение входит снимок, самое новое событие точки, поэтому значение не пропадает до сжатия архива. После простоя пропущенное дочитывается, но не дальше недели назад.

Все запросы программы сбора идут методом GET: пакетный контроллер, каналы и подписки на обновления не используются, потому что требуют POST или WebSocket. Программа не ходит через прокси и не следует переадресациям, чтобы не унести учётку на другой хост. Элементы и атрибуты PI AF программа не читает: агент находит точку по её имени и описанию.

Вход двумя способами: Basic с логином и паролем, если он включён в AuthenticationMethods, или Windows, то есть Kerberos от служебной учётки программы сбора в домене с SPN HTTP/хост. Откат на NTLM программа отклоняет. Точки типа Blob не объявляются, значение с флагом Questionable приходит как uncertain, а цифровое состояние читается своим именем.

Сценарии интеграции

Текущие значения точек

Агент найдёт точки PI по имени или описанию и покажет снимок значений с единицами, временем и качеством.

Тренд за период

Агент прочитает архив точки за смену, сутки или неделю и назовёт минимум, максимум, среднее и выходы за диапазон.

Пропуски в архиве

Агент найдёт точки, которые отдают системные состояния вроде No Data, и покажет, с какого момента данных нет.

Сравнение линий

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

Сообщение о пороге

В задаче «По событию» агент сообщит, когда значение точки выйдет за порог и продержится заданное время, и когда вернётся в норму.

Связь с объектом

Агент скажет, когда сервер сбора пропал со связи и когда вернулся. Пропущенное за перерыв программа дочитает из архива PI.

Как подключить

Перед подключением

  • PI Web API перед PI Data Archive или FactoryTalk Historian SE
  • Сервер сбора в сети объекта: Windows или Linux с Docker
  • Доступ с сервера сбора к адресу PI Web API
  • Учётка с правом чтения точек и их данных
  • Для входа Windows: сервер сбора на Windows в домене и SPN HTTP/хост
  • Сервер пускает только известные адреса? Разрешите подключения с 158.160.205.91 и 87.228.27.163.
  1. 1

    Откройте доступ к PI Web API

    Серверу сбора нужен доступ к адресу PI Web API вида https://хост/piwebapi. Прокси программа сбора не использует, укажите адрес, по которому сервер отвечает напрямую.

  2. 2

    Выберите способ входа

    Для Basic включите его в AuthenticationMethods PI Web API. Для Windows сервер сбора в домене, а для адреса сервера зарегистрирован SPN HTTP/хост.

  3. 3

    Дайте учётке право чтения

    Учётке подключения нужен доступ на чтение точек PI Data Archive и их данных. Права записи не нужны.

  4. 4

    Доверьте сертификат сервера

    Самоподписанный сертификат PI Web API положите файлом .pem или .crt в pki/pi_web_api/trusted/ в папке данных программы сбора на сервере сбора.

Частые вопросы

В разделе Интеграции → «Оборудование» нажмите «Подключить оборудование». Если сервера сбора ещё нет, установите программу сбора данных одной командой из окна. Затем выберите PI Web API и укажите адрес вида https://pi.local/piwebapi и логин с паролем учётки с правом чтения; сервер сбора назначится сам, а если серверов несколько, выберите нужный в форме. Если нужен только один PI Data Archive, назовите его; маски имён сузят набор точек.

Точки PI Data Archive с путём \\СЕРВЕР\ТЕГ, единицами и диапазоном, их текущий снимок и архив значений. Плохое значение приходит с кодом системного состояния, например No Data, а значение цифровой точки читается именем состояния.

Нет. Программа сбора отправляет в PI Web API только запросы GET, а пакетный контроллер и прочие пути, через которые доступна запись, не использует. Учётке подключения права записи не нужны.

Программа сбора должна работать службой на сервере сбора с Windows в домене, а для адреса PI Web API должен быть зарегистрирован SPN HTTP/хост. Указывайте адрес по имени хоста, которое знает контроллер домена: иначе Kerberos не выдаст билет, а откат на NTLM программа отклоняет.

Категория
Оборудование
Подключение
По API-ключу

Подключите PI Web API

Подключение занимает пару минут, данные остаются в ваших системах.

Подключить