DroneKit LA (Log Analyzer)

Log analyzer for ArduPilot DataFlash logs and MAVLink telemetry logs.

Overview

DroneKit Log Analyzer (DroneKit-LA) is a powerful open source static analyzer for ArduPilot DataFlash logs and MAVLink telemetry logs.

The tool can read and analyze several log formats, including telemetry logs (tlogs), dataflash binary logs (.BIN) and dataflash text dumps (.log), and output detailed error and warning information in several formats (json, text, summary). The output includes detailed information about the tests, including what tests were run, the results (pass, fail, warn), severity, and supporting evidence.

DroneKit-LA is also fast, memory efficient and extensible. It supports numerous analyzers and can quickly analyzing even very large logs.

The tool is written in C++ and can compile on a Linux, Mac OSX or Windows computer or within a Vagrant-based Linux VM.

The project documentation (including tool download links) is available at la.dronekit.io logs for testing the tool can be found in the dronekit-la-testdata repository.

Getting Started

The Getting Started guide explains how to install DroneKit-LA, how to run the tool, and how to interpret the results.

After installing, the tool, running an analysis can be as simple as entering the following command on a terminal:

# You only need to specify the target file for a dataflash log
./dronekit-la log_file.bin

# Additionally specify frame and model type for a Solo TLOG
./dronekit-la a_log_file.tlog -f copter -m QUAD

The guide also lists all the other command line arguments, provides information about the current set of analyzers, and explains how you can extend DroneKit-LA to get more information out of logs and add new analyzers.

The DroneKit Forums are the best place to ask for technical support on how to use the tool. You can also check out our Gitter channel though we prefer posts on the forums where possible.

Developer Setup

You can build dronekit-la natively on Linux, Mac OS X or Windows using the Makefile in the dronekit-la root directory:

make

The dependencies for building each platform are different, as documented in the guide: Contributing to DroneKit-LA.

Both the tool and documentation can also be built and run from within a Vagrant VM.

Users and contributors wanted!

We'd love your feedback and suggestions about this tool and are eager to evolve it to meet your needs. Please feel free to create an issue to report bugs or feature requests.

If you want to help more directly, see our Contributing guidelines. We welcome all types of contributions but mostly contributions that would help us shrink our issues list.

Licence

DroneKit-LA is made available under the permissive open source Apache 2.0 License.

Resources

• Documentation: http://la.dronekit.io/
• Test Logs: /dronekit/dronekit-la-testdata
• Open Issues: /dronkeit-la/issues
• Forums: https://discuss.dronekit.io
• Gitter: https://gitter.im/dronekit/dronekit-la though we prefer posts on the forums where possible.

Copyright 2016 3D Robotics, Inc.