FTDC, originally short for full time diagnostic data capture, is MongoDB's internal diagnostic data collection facility. It encodes data in a space-efficient format, which allows MongoDB to record diagnostic information every second, and store weeks of data with only a few hundred megabytes of storage.

This library provides a fully-featured and easy to use toolkit for interacting data stored in this format in Go programs. The library itself originated as a project by 2016 Summer interns at MongoDB but has diverged substantially since then.

Currently the library provides parsing of the FTDC data format and several ways of iterating these results. Additionally, it provides the ability to create FTDC payloads, and is the only extant (?) tool for generating FTDC data outside of the MongoDB code base.

The library includes tools for generating FTDC payloads and document streams as well as iterators and tools for accessing data from FTDC files. All functionality is part of the ftdc package, and the API is fully documented.

• (pending requests and use-cases) mode to read FTDC data without flattening the document structure.
• command line tools for parsing and generating FTDC payloads.
• helpers for generating default collector configurations.
• combined check
• improved collector performance.

... and more

All documentation is in the godoc.

File tickets in the MAKE project on the MongoDB jira. The repository will shortly move back to an offical MongoDB GitHub organization.

Pull requests are welcome.