ipfixcol2-fds-input(7)

✨ ipfixcol2-fds-input(7) ✨

so bestie, this is part of the IPFIXcol collector manual (section 7, the good section) and it's literally all about the FDS File input plugin 🎀

---

👑 NAME

ipfixcol2-fds-input — FDS File (input plugin) 💅

---

🌸 DESCRIPTION

okay so real talk: this plugin reads flow data from one or more files in FDS File format, periodt. and the cutest part? you can use it to load up flow records that you already saved earlier using the FDS output plugin. recycling era ♻️✨

now here's the tea that makes it different from its siblings 🫖: the UDP and TCP input plugins will infinitely wait for data from NetFlow/IPFIX exporters, like, forever, no thoughts head empty 😌. but this one? the plugin will terminate the collector after all files are processed. it finishes its little job and leaves the group chat. iconic behavior honestly 💀

---

🌈 EXAMPLE CONFIGURATION

here's the config, copy it, it's giving flawless:

<input>
    <name>FDS File</name>
    <plugin>fds</plugin>
    <params>
        <path>/tmp/flow/file.ipfix</path>
    </params>
</input>

---

🦋 PARAMETERS

• path — the path to your file(s) in IPFIX File format 🗂️. and bestie, you have options on options:
  • you can use an asterisk instead of a filename/directory 🌟
  • you can use the tilde character (i.e. "~") instead of the home directory of the user 🏠
  • and you can use brace expressions (i.e. "/tmp/{source1,source2}/file.ipfix") 🎀
  • heads up tho: Directories and non-IPFIX Files that match the file pattern are skipped/ignored. they get ghosted 👻
• msgSize — the maximum size of the internally generated IPFIX Messages that the content of the file gets inserted into. [default: 32768, min: 512] 📏
• asyncIO — allows you to use asynchronous I/O for reading the file ⚡. usually when parts of the file are being read, the process is blocked on synchronous I/O and just sits there waiting for the operation to complete 😴. but asynchronous I/O lets the plugin simultaneously read the file and process flow records, which significantly improves overall performance 🔥. (Note: a pool of service threads shared among instances of FDS plugin might be created 🧚). [values: true/false, default: true]

no cap, if you want speed, asyncIO is your girl 💅

---

💖 AUTHOR

Lukas Hutak (lukas.hutak@cesnet.cz) 🫶

💜 COPYRIGHT

Copyright © 2020 CESNET, z.s.p.o. 🎀

---

and that's the whole page bestie, slay 🌸✨ this was version 2.0, dated 2020-05-04 — go read some other manuals, ily, bye 👑💅