dpdkstat plugin¶

See this section in the full configuration reference

The dpdkstat plugin collects information about DPDK interfaces using the extended NIC stats API in DPDK.

Synopsis:

<Plugin "dpdkstat">
  <EAL>
    Coremask "0x4"
    MemoryChannels "4"
    FilePrefix "rte"
    SocketMemory "1024"
    LogLevel "7"
    RteDriverLibPath "/usr/lib/dpdk-pmd"
  </EAL>
  SharedMemObj "dpdk_collectd_stats_0"
  EnabledPortMask 0xffff
  PortName "interface1"
  PortName "interface2"
</Plugin>

Options:

The EAL block¶

Coremask Mask

A string containing an hexadecimal bit mask of the cores to run on. Note that core numbering can change between platforms and should be determined beforehand.

Memorychannels Channels

A string containing a number of memory channels per processor socket.

FilePrefix File

The prefix text used for hugepage filenames. The filename will be set to /var/run/.<prefix>_config where prefix is what is passed in by the user.

SocketMemory MB

A string containing amount of Memory to allocate from hugepages on specific sockets in MB. This is an optional value.

LogLevel LogLevel_number

A string containing log level number. This parameter is optional. If parameter is not present then default value "7" - (INFO) is used. Value "8" - (DEBUG) can be set to enable debug traces.

RteDriverLibPath Path

A string containing path to shared pmd driver lib or path to directory, where shared pmd driver libs are available. This parameter is optional. This parameter enable loading of shared pmd driver libs from defined path. E.g.: "/usr/lib/dpdk-pmd/librte_pmd_i40e.so" or "/usr/lib/dpdk-pmd"

SharedMemObj Mask

A string containing the name of the shared memory object that should be used to share stats from the DPDK secondary process to the collectd dpdkstat plugin. Defaults to dpdk_collectd_stats if no other value is configured.

EnabledPortMask Mask

A hexidecimal bit mask of the DPDK ports which should be enabled. A mask of 0x0 means that all ports will be disabled. A bitmask of all Fs means that all ports will be enabled. This is an optional argument - default is all ports enabled.

PortName Name

A string containing an optional name for the enabled DPDK ports. Each PortName option should contain only one port name; specify as many PortName options as desired. Default naming convention will be used if PortName is blank. If there are less PortName options than there are enabled ports, the default naming convention will be used for the additional ports.