ipfixreceiver2: IPFIX/NetflowV9 collector [Документация VAS Experts]

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
en:dpi:dpi_components:utilities:ipfixreceiver2 [2019/04/01 08:54] kvazikraven:dpi:dpi_components:utilities:ipfixreceiver2 [2024/09/26 15:29] (current) – external edit 127.0.0.1
Line 1: Line 1:
 ====== ipfixreceiver2: IPFIX/NetflowV9 collector  ====== ====== ipfixreceiver2: IPFIX/NetflowV9 collector  ======
 +{{indexmenu_n>2}}
  
 ===== Introduction ===== ===== Introduction =====
Line 13: Line 13:
 ==== CentOS ==== ==== CentOS ====
  
-  - Add the VAS Experts repository according to the p.1 of the [[en:dpi:dpi_components:platform:dpi_update:dpi_update_10:dpi_10_update:start|DPI installation instruction]].+  - Add the VAS Experts repository <code>rpm --import http://vasexperts.ru/centos/RPM-GPG-KEY-vasexperts.ru 
 +rpm -Uvh http://vasexperts.ru/centos/6/x86_64/vasexperts-repo-1-0.noarch.rpm</code>
   - Add the [[https://fedoraproject.org/wiki/EPEL|EPEL]] repository   - Add the [[https://fedoraproject.org/wiki/EPEL|EPEL]] repository
   - Install the ipfixreceiver2:\\ <code>yum install -y ipfixreceiver2</code>   - Install the ipfixreceiver2:\\ <code>yum install -y ipfixreceiver2</code>
Line 105: Line 106:
 This section specifies the order and format of the received data to be exported. This section specifies the order and format of the received data to be exported.
   * Elements - comma separated list of data to be stored in the file. You can change the predefined export format (the data will be exported to a file) for each data type using the following format: field_name: output_format [: option]. The following types of data output are possible:   * Elements - comma separated list of data to be stored in the file. You can change the predefined export format (the data will be exported to a file) for each data type using the following format: field_name: output_format [: option]. The following types of data output are possible:
 +
 ^Output_format^Description^ ^Output_format^Description^
 |decode_unsigned|Decode as unsinged| |decode_unsigned|Decode as unsinged|
Line 125: Line 127:
 === Section [export] === === Section [export] ===
  
-  *to - specifies the collector addresses to be used to export received ipfix records.\\ Used format: ip/port/proto[,ip/port/proto]. +  *to - specifies the collector addresses to be used to export received ipfix records.\\ Used format: ip/port/proto[,ip/port/proto]. For example:<code>[export]
-For example:<code>[export]+
 to=10.0.0.2/9921/tcp, 10.0.0.3/3444/udp</code> to=10.0.0.2/9921/tcp, 10.0.0.3/3444/udp</code>
 :!: When using the udp protocol, you should make sure that one ipfix record does not exceed the size of the MTU. :!: When using the udp protocol, you should make sure that one ipfix record does not exceed the size of the MTU.
  
-=== Секция [logging] === +=== Section [logging] === 
-В данной секции задаются параметры логирования программы+The section specifies the logging parameters
-  * loggers.root.level - уровень логирования +  * loggers.root.level - log level 
-  * loggers.root.channel - канал для вывода сообщений +  * loggers.root.channel - channel to display messages 
-  * channels.fileChannel.class - класс канала вывода +  * channels.fileChannel.class - output channel class 
-  * channels.fileChannel.path - путь к лог-файлу +  * channels.fileChannel.path - path to the log file 
-  * channels.fileChannel.rotation - параметр ротации +  * channels.fileChannel.rotation - rotation parameter 
-  * channels.fileChannel.archive параметр имени архивных файлов  +  * channels.fileChannel.archive archive file name parameter  
-  * channels.fileChannel.purgeCount - количество архивных файлов +  * channels.fileChannel.purgeCount - number of archive files 
-  * channels.fileChannel.formatter.class - класс форматировщика +  * channels.fileChannel.formatter.class - formatter class 
-  * channels.fileChannel.formatter.pattern - шаблон для форматировщика +  * channels.fileChannel.formatter.pattern - formatter pattern 
-  * channels.fileChannel.formatter.times - время +  * channels.fileChannel.formatter.times - time 
-:!: Более подробно ознакомиться с параметрами логирования можно по ссылке [[https://pocoproject.org/docs/Poco.FileChannel.html|Class FileChannel]].+:!: For more information about logging parameters please follow the [[https://pocoproject.org/docs/Poco.FileChannel.html|Class FileChannel]] link.
  
-===== Примеры конфигураций =====+===== Configuration examples =====
  
-=== Приём ipfix данных ===+=== Receiving of ipfix data ===
  
-В файлах /etc/rcollector/ipfixreceiver_*.ini приведены примеры настройки для получения различных потоков данных ipfix. Перед запуском программы необходимо изменить конфигурационный файл под ваши требования+The /etc/rcollector/ipfixreceiver_*.ini files provide configuration examples for receiving various ipfix data flowsBefore starting the program, you should to change the configuration file to meet your requirements
-  * При необходимости внести изменения в секцию [connect], указав интерфейспорт и протокол для приема ipfix данных+  * If necessary, make changes to the [connect] sectionspecifying the interfaceport and protocol for receiving ipfix data
-  * В секции [dump] указать+  * Specify within [dump] section the following stuff
-    * dumpfiledir - каталог, где будут создаваться временный файл и файлы с данными+    * dumpfiledir - the directory where the temporary file and data files will be created
-    * rotate_minutes - времячерез которое закрывать временный файл, переименовывать его в файл с постоянным именем и выполнить команду из параметра processcmd для действий над полученным файлом+    * rotate_minutes - the time period upon the exceeding of which to close the temporary filerename it to a file with a permanent name and execute a command from the processcmd parameter to operate on the received file
-    * processcmd - команду, небходимую выполнить над файлом с данными+    * processcmd - this command should be executed on the file with data
-    * delimiter - символ разделитель между полями данных+    * delimiter - delimiter character between data fields
-  * В секции [ExportModel] указать необходимый порядок следования полей в сохраняемом файле.+  * You should specify the required order of the fields in the saved file within the [ExportModel] section
  
-=== Экспорт ipfix данных ===+=== Exporting of ipfix data ===
  
-Для экспорта получаемых ipfix данных необходимо внести изменения в конфигурационный файлпутем добавления секции [export] и указания адресов назначенияНапримердля отправки ipfix данных на ipfix коллектор с адресом 10.0.0.5:1501 по протоколу tcp, элемент конфигурации будет выглядеть следующим образом:+To export the data received by ipfix, you need to make changes to the configuration file by adding the [export] section and specifying the destination addressesFor exampleto send ipfix data to an ipfix collector having the 10.0.0.5:1501 address using the tcp protocolthe configuration item within [export] section will look like this:
 <code>[export] <code>[export]
 to = 10.0.0.5/1501/tcp</code> to = 10.0.0.5/1501/tcp</code>
-Если необходимо задать несколько ipfix коллекторовто их можно указать через запятуюНапример:+If you need to specify multiple ipfix collectorsyou can specify comma-separated list of ipfix collectorsFor example:
 <code>[export] <code>[export]
 to = 10.0.0.5/1501/tcp, 192.168.1.200/1501/tcp</code> to = 10.0.0.5/1501/tcp, 192.168.1.200/1501/tcp</code>