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.

Name		Name	Last commit message	Last commit date
Latest commit History 399 Commits
DataFlash		DataFlash
analyzer		analyzer
debian		debian
docs		docs
doxygen		doxygen
ini		ini
issues		issues
jsoncpp		jsoncpp
modules		modules
test		test
util		util
.gitignore		.gitignore
.gitmodules		.gitmodules
.submodules		.submodules
.travis.yml		.travis.yml
ExifTool_config		ExifTool_config
LA_MsgHandler.cpp		LA_MsgHandler.cpp
LA_MsgHandler.h		LA_MsgHandler.h
LICENSE		LICENSE
Location.h		Location.h
Makefile		Makefile
MsgHandler.cpp		MsgHandler.cpp
MsgHandler.h		MsgHandler.h
README.md		README.md
Vagrantfile		Vagrantfile
Vector3f.h		Vector3f.h
analyze.cpp		analyze.cpp
analyze.h		analyze.h
analyzer.cpp		analyzer.cpp
analyzer.h		analyzer.h
analyzer_util.cpp		analyzer_util.cpp
analyzer_util.h		analyzer_util.h
analyzervehicle.cpp		analyzervehicle.cpp
analyzervehicle.h		analyzervehicle.h
analyzervehicle_copter.cpp		analyzervehicle_copter.cpp
analyzervehicle_copter.h		analyzervehicle_copter.h
analyzervehicle_plane.cpp		analyzervehicle_plane.cpp
analyzervehicle_plane.h		analyzervehicle_plane.h
analyzervehicle_rover.cpp		analyzervehicle_rover.cpp
analyzervehicle_rover.h		analyzervehicle_rover.h
analyzing_dataflash_message_handler.cpp		analyzing_dataflash_message_handler.cpp
analyzing_dataflash_message_handler.h		analyzing_dataflash_message_handler.h
analyzing_mavlink_message_handler.cpp		analyzing_mavlink_message_handler.cpp
analyzing_mavlink_message_handler.h		analyzing_mavlink_message_handler.h
circle.yml		circle.yml
common_tool.cpp		common_tool.cpp
common_tool.h		common_tool.h
data_sources.h		data_sources.h
dataflash_logger.cpp		dataflash_logger.cpp
dataflash_logger.h		dataflash_logger.h
dataflash_logger_program.cpp		dataflash_logger_program.cpp
dataflash_logger_program.h		dataflash_logger_program.h
dataflash_message_handler.cpp		dataflash_message_handler.cpp
dataflash_message_handler.h		dataflash_message_handler.h
dataflash_reader.cpp		dataflash_reader.cpp
dataflash_reader.h		dataflash_reader.h
dataflash_textdump_reader.cpp		dataflash_textdump_reader.cpp
dataflash_textdump_reader.h		dataflash_textdump_reader.h
format_reader.cpp		format_reader.cpp
format_reader.h		format_reader.h
heart.cpp		heart.cpp
heart.h		heart.h
imagetagger.cpp		imagetagger.cpp
imagetagger.h		imagetagger.h
la-log.cpp		la-log.cpp
la-log.h		la-log.h
log_download.cpp		log_download.cpp
log_download.h		log_download.h
log_download_program.cpp		log_download_program.cpp
log_download_program.h		log_download_program.h
log_list.cpp		log_list.cpp
log_list.h		log_list.h
loganalyzer.cpp		loganalyzer.cpp
loganalyzer.h		loganalyzer.h
mavlink_message_handler.cpp		mavlink_message_handler.cpp
mavlink_message_handler.h		mavlink_message_handler.h
mavlink_reader.cpp		mavlink_reader.cpp
mavlink_reader.h		mavlink_reader.h
mavlink_writer.cpp		mavlink_writer.cpp
mavlink_writer.h		mavlink_writer.h
message_handler.cpp		message_handler.cpp
message_handler.h		message_handler.h
mh_imagetagger.cpp		mh_imagetagger.cpp
mh_imagetagger.h		mh_imagetagger.h
requirements.txt		requirements.txt
sample.config		sample.config
sample.config-dataflash_logger		sample.config-dataflash_logger
telem_client.cpp		telem_client.cpp
telem_client.h		telem_client.h
telem_forwarder_client.cpp		telem_forwarder_client.cpp
telem_forwarder_client.h		telem_forwarder_client.h
telem_serial.cpp		telem_serial.cpp
telem_serial.h		telem_serial.h
telem_udp.cpp		telem_udp.cpp
telem_udp.h		telem_udp.h
tools.h		tools.h

License

dronekit/dronekit-la

Folders and files

Latest commit

History