Управление подписками

1

В данном разделе приведены сведения по управлению входящими подписками на получение событий от ONVIF-медиаисточников (камер/кодеров), также исходящими подписками на передачу событий по протоколу ONVIF во «внешние» системы.

2

3

Функционал управления подписками доступен с версии 20.42 Платформы НЕЙРОСС.

4

5

6

**Переход к функционалу**: [[doc:ui.Рабочий стол НЕЙРОСС.WebHome]] > Сеть > [[image:attach:ui.Параметры узла.WebHome@fa-info2.png||thumbnail="true" height="20"]] Дополнительно…

7

8

9

== {{id name="Управлениеподписками-Общиесведения"/}}Общие сведения ==

10

11

Узлы НЕЙРОСС (в том числе контроллеры БОРЕЙ) реализуют ONVIF® Profile C и могут интегрироваться со смежными системами по ONVIF.

12

13

Для получения событий от ONVIF-узлов (IP-камер или кодеров), в том числе событий видеоаналитики, Платформа НЕЙРОСС/ДеВизор оформляет исходящую подписку на получение событий. Эта подписка создается на ограниченное время и периодически продлевается.

14

15

Текущий статус медиаисточника отображается в разделе [[doc:ui.Сеть.WebHome]]. При ошибках оформления или продления подписки, отображается иконка [[image:attach:subscription_error.png||thumbnail="true" height="16"]].

16

17

Ошибка обновления или продления подписки может формироваться в случае:

18

19

* если камера не поддерживает сервис подписок и обмен событиями — в этом случае событий от камеры нет, и подписка не требуется;

20

* если на камере уже зарегистрировано слишком большое количество подписок и новые не оформляются — в этом рекомендуется перезагрузить камеру и переоформить подписку.

21

22

Подписка на ONVIF-медиаисточник оформляется автоматически. При необходимости переоформления вы можете:

23

24

* Удалить подписку и оформить новую;

25

* Переоформить существующую подписку.

26

27

Также, если на узле Платформа НЕЙРОСС/ДеВизор настроено несколько сетевых интерфейсов или один интерфейс настроен на работу в нескольких подсетях, а медиаисточник находится за роутером (во внешнем контуре относительно узла Платформа НЕЙРОСС / ДеВизор), возможна ситуация, когда по каким-то причинам был неверно рассчитан требуемый IP-адрес, и подписка оформилась на неверный. В этом случае события не будут поступать, но ошибок оформления подписок не будет. Интерфейс управления подписками позволяет отслеживать поступление событий от ONVIF-узла в режиме реального времени, удалить «неправильную» подписку и оформить подписку с указанием IP-адреса из одной подсети с медиаисточником.

28

29

Также узлы НЕЙРОСС выступают в качестве ONVIF-узлов и обеспечивают возможность оформления входящей подписки от «внешнего» потребителя ONVIF-событий — «внешней системы», оформляющей подписку на события узла НЕЙРОСС и обеспечивающий приём таких событий.

30

31

|=Термин|=Комментарий

32

|Исходящая подписка|Узел НЕЙРОСС сам подписывается на ONVIF-события «внешней» системе – IP-камере / «внешнему регистратору» / серверу видеоаналитики.

33

|Входящая подписка|«Внешняя» система отправляет SOAP-запрос Subscribe на узел НЕЙРОСС и получает события на свой ConsumerReference.

34

35

== {{id name="Управлениеподписками-Окнораздела"/}}Окно раздела ==

36

37

Управление подписками осуществляется на вкладке **Подписки** окна дополнительной информации об узле. Вы можете просмотреть наличие и статус входящих и исходящих подписок на события.

38

39

[[image:attach:cam_subscribe_wnd.png]]

40

41

== Исходящие подписки ==

42

43

Исходящие подписки — это подписки, оформляемые узлами НЕЙРОСС на события «внешних» систем, чаще всего — ONVIF IP-камер и регистраторов, рассылающих события видеоаналитики.

44

45

=== Оформление подписки ===

46

47

48

Оформление подписки возможно, если в текущий момент нет уже оформленной подписки, в противном случае воспользуйтесь сервисом переоформления подписки, или удалите «старую» подписку и оформите новую.

Нажмите на кнопку **Оформить подписку**.

53

54

[[image:attach:cam_subscribtion_add.png||height="250"]]

55

56

В отобразившемся окне выберите из раскрывающегося списка требуемый IP-адрес.

57

58

[[image:attach:cam_subscribe_reg_new.png]]

59

60

Нажмите на кнопку **Подписаться**.

61

62

[[image:attach:cam_subscribe_reg_new1.png]]

63

64

=== Удаление подписки ===

65

66

Чтобы удалить подписку нажмите на кнопку [[image:attach:ui.Параметры узла.WebHome@btn_delete.png||thumbnail="true" height="16"]] **Удалить**.

67

68

В окне подтверждения нажмите на кнопку **Да**.

69

70

=== Подписка не оформляется ===

71

72

Ошибка обновления или продления подписки может формироваться в случае:

73

74

* если камера не поддерживает сервис подписок и обмен событиями — в этом случае событий от камеры нет, и подписка не требуется;

75

* если на камере уже зарегистрировано слишком большое количество подписок, и новые не оформляются — в этом случае рекомендуется перезагрузить камеру, список подписок автоматически очистится, и можно будет оформить требуемую подписку.

76

77

В первую очередь попробуйте перезапустить камеру и оформить подписку вручную. Если это не помогает, проверьте работу сервиса подписок в приложении «Менеджер устройств ONVIF» (ONVIF Device Manager, ODM).

78

79

Также вы можете провести диагностику сетевого трафика через приложение [[doc:neyross.НЕЙРОСС Техобслуживание.WebHome]] в момент оформления подписки: запустить захват сетевого трафика в момент оформления подписки с фильтром:

tcp

и увидеть детальный ответ от ONVIF-узла.

86

87

=== Переоформление подписки ===

88

89

90

Переоформление подписки требуется, если камера находится за роутером (во внешнем контуре относительно узла Платформа НЕЙРОСС / ДеВизор). При этом возможна ситуация, когда по каким-то причинам был неверно рассчитан требуемый IP-адрес, и подписка оформилась на неверный. В этом случае события не будут поступать, но ошибок оформления подписок не будет.

Нажмите на кнопку **Переоформить подписку**. Выберите требуемый IP-адрес и нажмите на кнопку **Переподписаться**.

95

96

[[image:attach:cam_subscribe_rereg.png]]

97

98

=== Проверка получения событий ===

99

100

Если подписка успешно оформлена, Платформа НЕЙРОСС/ДеВизор начнут получать события от ONVIF-медиаисточника.

101

102

Чтобы проверить получение событий нажмите на кнопк**у Показать события от узла**.

103

104

Отобразится окно событий. По умолчанию окно пустое, события от камеры поступают в режиме реального времени.

105

106

[[image:attach:cam_subscribtion_liveJournal.png||width="900"]]

**ПОДСКАЗКА**

На основе темы события вы можете настроить преобразование событий в удобочитаемый вид для получения осмысленных извещений в ленте событий АРМ НЕЙРОСС Центр.

112

113

~[[[neyross.Обслуживание Платформы НЕЙРОСС.faq.Система получает неизвестные события\. Как их интерпретировать?.WebHome]]]

Вы также можете просмотреть логи взаимодействия с медиаисточником в «живом» журнале аудита.

118

119

Нажмите открыть в поле **Журнал аудита**, согласитесь с добавлением фильтров журнала. Дождитесь появления записей журнала.

120

121

[[image:attach:cam_subscribtion_audit.png||width="800"]]

122

123

124

== Входящие подписки ==

125

126

Узлы Платформа НЕЙРОСС / ДеВизор, контроллеры БОРЕЙ обеспечивают возможность оформления входящей подписки «внешним» потребителя ONVIF-событий — «внешней» системы, оформляющей подписку на события и обеспечивающий приём таких событий.

127

128

В этом случае для узла НЕЙРОСС в разделе **Подписки **будет отображаться входящая подписка.

129

130

131

На текущий момент входящие подписки отображаются только для узлов БОРЕЙ. Отображение подписок для узлов Платформа НЕЙРОСС / ДеВизор будет реализовано в будущих версиях.

132

133

134

[[image:attach:node_subscribtion_incoming.png]]

**Endpoint Платформы НЕЙРОСС**:

139

140

141

http://<IP-адрес Платформы>/soap/onvif/events

**Endpoint БОРЕЙ**:

http://<IP-адрес БОРЕЙ>/event/NotificationProducer/

=== Фильтрация событий ===

152

153

Узлы НЕЙРОСС при оформлении входящей подписки рассылают все события системы. При необходимости, вы можете ограничить пул событий по топику (теме события) события и содержимому xPath ~[[[Отправка событий по входящим подпискам>>doc:ui.Параметры узла.Дополнительные настройки.Отправка событий по входящим подпискам.WebHome]]].

154

155

=== «Включение» отправки событий ===

156

157

158

(% class="wikigeneratedid" id="H41244543E43444F44943843543F43E43443F43844143A43841141E420415419" %)

159

**БОРЕЙ**

160

161

(% class="wikigeneratedid" %)

162

Контроллер БОРЕЙ при оформлении входящей подписки сразу начинает отправлять все события или конкретные в соответствии с фильтром. Дополнительных действий со стороны контроллера БОРЕЙ не требуется.

163

164

165

(% class="wikigeneratedid" %)

166

**Платформа НЕЙРОСС / ДеВизор**

167

168

Узлы НЕЙРОСС серверного типа оформляют подписку по запросу, но рассылка событий начинается только после включения функции на самом узле Платформа НЕЙРОСС / ДеВизор.

169

170

До версии 20.55 подключение функции осуществляется в файле конфигурирования. При работе в данных версиях обратитесь к специалистам компании ИТРИУМ за консультацией.

171

172

С версии 20.55 параметр «вынесен» в интерфейс НЕЙРОСС ~[[[Отправка событий по входящим подпискам>>doc:ui.Параметры узла.Дополнительные настройки.Отправка событий по входящим подпискам.WebHome]]].

author	version	line-number	content
		1	В данном разделе приведены сведения по управлению входящими подписками на получение событий от ONVIF-медиаисточников (камер/кодеров), также исходящими подписками на передачу событий по протоколу ONVIF во «внешние» системы.
		2
		3	Функционал управления подписками доступен с версии 20.42 Платформы НЕЙРОСС.
		4
		5	{{info}}
		6	Переход к функционалу: [[doc:ui.Рабочий стол НЕЙРОСС.WebHome]] > Сеть > [[image:attach:ui.Параметры узла.WebHome@fa-info2.png\|\|thumbnail="true" height="20"]] Дополнительно…
		7	{{/info}}
		8
		9	== {{id name="Управлениеподписками-Общиесведения"/}}Общие сведения ==
		10
		11	Узлы НЕЙРОСС (в том числе контроллеры БОРЕЙ) реализуют ONVIF® Profile C и могут интегрироваться со смежными системами по ONVIF.
		12
		13	Для получения событий от ONVIF-узлов (IP-камер или кодеров), в том числе событий видеоаналитики, Платформа НЕЙРОСС/ДеВизор оформляет исходящую подписку на получение событий. Эта подписка создается на ограниченное время и периодически продлевается.
		14
		15	Текущий статус медиаисточника отображается в разделе [[doc:ui.Сеть.WebHome]]. При ошибках оформления или продления подписки, отображается иконка [[image:attach:subscription_error.png\|\|thumbnail="true" height="16"]].
		16
		17	Ошибка обновления или продления подписки может формироваться в случае:
		18
		19	* если камера не поддерживает сервис подписок и обмен событиями — в этом случае событий от камеры нет, и подписка не требуется;
		20	* если на камере уже зарегистрировано слишком большое количество подписок и новые не оформляются — в этом рекомендуется перезагрузить камеру и переоформить подписку.
		21
		22	Подписка на ONVIF-медиаисточник оформляется автоматически. При необходимости переоформления вы можете:
		23
		24	* Удалить подписку и оформить новую;
		25	* Переоформить существующую подписку.
		26
		27	Также, если на узле Платформа НЕЙРОСС/ДеВизор настроено несколько сетевых интерфейсов или один интерфейс настроен на работу в нескольких подсетях, а медиаисточник находится за роутером (во внешнем контуре относительно узла Платформа НЕЙРОСС / ДеВизор), возможна ситуация, когда по каким-то причинам был неверно рассчитан требуемый IP-адрес, и подписка оформилась на неверный. В этом случае события не будут поступать, но ошибок оформления подписок не будет. Интерфейс управления подписками позволяет отслеживать поступление событий от ONVIF-узла в режиме реального времени, удалить «неправильную» подписку и оформить подписку с указанием IP-адреса из одной подсети с медиаисточником.
		28
		29	Также узлы НЕЙРОСС выступают в качестве ONVIF-узлов и обеспечивают возможность оформления входящей подписки от «внешнего» потребителя ONVIF-событий — «внешней системы», оформляющей подписку на события узла НЕЙРОСС и обеспечивающий приём таких событий.
		30
		31	\|=Термин\|=Комментарий
		32	\|Исходящая подписка\|Узел НЕЙРОСС сам подписывается на ONVIF-события «внешней» системе – IP-камере / «внешнему регистратору» / серверу видеоаналитики.
		33	\|Входящая подписка\|«Внешняя» система отправляет SOAP-запрос Subscribe на узел НЕЙРОСС и получает события на свой ConsumerReference.
		34
		35	== {{id name="Управлениеподписками-Окнораздела"/}}Окно раздела ==
		36
		37	Управление подписками осуществляется на вкладке Подписки окна дополнительной информации об узле. Вы можете просмотреть наличие и статус входящих и исходящих подписок на события.
		38
		39	[[image:attach:cam_subscribe_wnd.png]]
		40
		41	== Исходящие подписки ==
		42
		43	Исходящие подписки — это подписки, оформляемые узлами НЕЙРОСС на события «внешних» систем, чаще всего — ONVIF IP-камер и регистраторов, рассылающих события видеоаналитики.
		44
		45	=== Оформление подписки ===
		46
		47	{{info}}
		48	Оформление подписки возможно, если в текущий момент нет уже оформленной подписки, в противном случае воспользуйтесь сервисом переоформления подписки, или удалите «старую» подписку и оформите новую.
		49	{{/info}}
		50
		51
		52	Нажмите на кнопку Оформить подписку.
		53
		54	[[image:attach:cam_subscribtion_add.png\|\|height="250"]]
		55
		56	В отобразившемся окне выберите из раскрывающегося списка требуемый IP-адрес.
		57
		58	[[image:attach:cam_subscribe_reg_new.png]]
		59
		60	Нажмите на кнопку Подписаться.
		61
		62	[[image:attach:cam_subscribe_reg_new1.png]]
		63
		64	=== Удаление подписки ===
		65
		66	Чтобы удалить подписку нажмите на кнопку [[image:attach:ui.Параметры узла.WebHome@btn_delete.png\|\|thumbnail="true" height="16"]] Удалить.
		67
		68	В окне подтверждения нажмите на кнопку Да.
		69
		70	=== Подписка не оформляется ===
		71
		72	Ошибка обновления или продления подписки может формироваться в случае:
		73
		74	* если камера не поддерживает сервис подписок и обмен событиями — в этом случае событий от камеры нет, и подписка не требуется;
		75	* если на камере уже зарегистрировано слишком большое количество подписок, и новые не оформляются — в этом случае рекомендуется перезагрузить камеру, список подписок автоматически очистится, и можно будет оформить требуемую подписку.
		76
		77	В первую очередь попробуйте перезапустить камеру и оформить подписку вручную. Если это не помогает, проверьте работу сервиса подписок в приложении «Менеджер устройств ONVIF» (ONVIF Device Manager, ODM).
		78
		79	Также вы можете провести диагностику сетевого трафика через приложение [[doc:neyross.НЕЙРОСС Техобслуживание.WebHome]] в момент оформления подписки: запустить захват сетевого трафика в момент оформления подписки с фильтром:
		80
		81	{{code language="java"}}
		82	tcp
		83	{{/code}}
		84
		85	и увидеть детальный ответ от ONVIF-узла.
		86
		87	=== Переоформление подписки ===
		88
		89	{{info}}
		90	Переоформление подписки требуется, если камера находится за роутером (во внешнем контуре относительно узла Платформа НЕЙРОСС / ДеВизор). При этом возможна ситуация, когда по каким-то причинам был неверно рассчитан требуемый IP-адрес, и подписка оформилась на неверный. В этом случае события не будут поступать, но ошибок оформления подписок не будет.
		91	{{/info}}
		92
		93
		94	Нажмите на кнопку Переоформить подписку. Выберите требуемый IP-адрес и нажмите на кнопку Переподписаться.
		95
		96	[[image:attach:cam_subscribe_rereg.png]]
		97
		98	=== Проверка получения событий ===
		99
		100	Если подписка успешно оформлена, Платформа НЕЙРОСС/ДеВизор начнут получать события от ONVIF-медиаисточника.
		101
		102	Чтобы проверить получение событий нажмите на кнопку Показать события от узла.
		103
		104	Отобразится окно событий. По умолчанию окно пустое, события от камеры поступают в режиме реального времени.
		105
		106	[[image:attach:cam_subscribtion_liveJournal.png\|\|width="900"]]
		107
		108	{{info}}
		109	ПОДСКАЗКА
		110
		111	На основе темы события вы можете настроить преобразование событий в удобочитаемый вид для получения осмысленных извещений в ленте событий АРМ НЕЙРОСС Центр.
		112
		113	~[[[neyross.Обслуживание Платформы НЕЙРОСС.faq.Система получает неизвестные события\. Как их интерпретировать?.WebHome]]]
		114	{{/info}}
		115
		116
		117	Вы также можете просмотреть логи взаимодействия с медиаисточником в «живом» журнале аудита.
		118
		119	Нажмите открыть в поле Журнал аудита, согласитесь с добавлением фильтров журнала. Дождитесь появления записей журнала.
		120
		121	[[image:attach:cam_subscribtion_audit.png\|\|width="800"]]
		122
		123
		124	== Входящие подписки ==
		125
		126	Узлы Платформа НЕЙРОСС / ДеВизор, контроллеры БОРЕЙ обеспечивают возможность оформления входящей подписки «внешним» потребителя ONVIF-событий — «внешней» системы, оформляющей подписку на события и обеспечивающий приём таких событий.
		127
		128	В этом случае для узла НЕЙРОСС в разделе Подписки будет отображаться входящая подписка.
		129
		130	{{error}}
		131	На текущий момент входящие подписки отображаются только для узлов БОРЕЙ. Отображение подписок для узлов Платформа НЕЙРОСС / ДеВизор будет реализовано в будущих версиях.
		132	{{/error}}
		133
		134	[[image:attach:node_subscribtion_incoming.png]]
		135
		136
		137
		138	Endpoint Платформы НЕЙРОСС:
		139
		140	{{code language="none"}}
		141	http://<IP-адрес Платформы>/soap/onvif/events
		142	{{/code}}
		143
		144	Endpoint БОРЕЙ:
		145
		146	{{code language="none"}}
		147	http://<IP-адрес БОРЕЙ>/event/NotificationProducer/
		148	{{/code}}
		149
		150
		151	=== Фильтрация событий ===
		152
		153	Узлы НЕЙРОСС при оформлении входящей подписки рассылают все события системы. При необходимости, вы можете ограничить пул событий по топику (теме события) события и содержимому xPath ~[[[Отправка событий по входящим подпискам>>doc:ui.Параметры узла.Дополнительные настройки.Отправка событий по входящим подпискам.WebHome]]].
		154
		155	=== «Включение» отправки событий ===
		156
		157
		158	(% class="wikigeneratedid" id="H41244543E43444F44943843543F43E43443F43844143A43841141E420415419" %)
		159	БОРЕЙ
		160
		161	(% class="wikigeneratedid" %)
		162	Контроллер БОРЕЙ при оформлении входящей подписки сразу начинает отправлять все события или конкретные в соответствии с фильтром. Дополнительных действий со стороны контроллера БОРЕЙ не требуется.
		163
		164
		165	(% class="wikigeneratedid" %)
		166	Платформа НЕЙРОСС / ДеВизор
		167
		168	Узлы НЕЙРОСС серверного типа оформляют подписку по запросу, но рассылка событий начинается только после включения функции на самом узле Платформа НЕЙРОСС / ДеВизор.
		169
		170	До версии 20.55 подключение функции осуществляется в файле конфигурирования. При работе в данных версиях обратитесь к специалистам компании ИТРИУМ за консультацией.
		171
		172	С версии 20.55 параметр «вынесен» в интерфейс НЕЙРОСС ~[[[Отправка событий по входящим подпискам>>doc:ui.Параметры узла.Дополнительные настройки.Отправка событий по входящим подпискам.WebHome]]].

Исходный код вики Управление подписками