ados support-bundle collects that into one archive.
Collect a bundle
ados-support-<device>-<timestamp>.tar.gz to the current directory, or wherever --output (-o) points:
It sends nothing anywhere
The command makes no outbound connection except to the agent on the box itself. It writes a file and stops. You decide who sees it.What is in it
The Black Box store is off by default (
logging.store.enabled: false), so on most nodes the Black Box section is empty and the journal section is the log of record. See Black Box to turn the store on.MANIFEST.json first. It separates three things that look alike from the outside: files collected, files absent because that node does not have them, and files that failed to collect.
Redaction
Every file is redacted on the way in. Values under keys named like secrets are replaced while the key is kept, so the archive still shows that a key was configured without carrying it, and long base64 or hex runs are replaced wholesale to catch key material that is not behind a named key.Redaction removes what can be named. It is not a promise that nothing sensitive remains. Before attaching a bundle to a public issue, look through it. GPS traces are your flight locations, and network output shows your addressing.
Report it
- Collect the bundle on the affected node, before rebooting.
- Open an issue on the relevant repository:
- ADOSDroneAgent for the Drone Agent or Ground Agent, the installer, the CLI, the radio link, or video
- ADOSMissionControlGCS for the browser or desktop GCS, mission planning, or FC panels
- ADOSExtensions for a first-party Extension
- ADOSAndroidGCS for the Android app
- Attach the bundle, or the relevant parts of it if you would rather not attach the whole thing.
- Say what you expected and what happened. For anything involving the radio or video, include the reading you were looking at when you decided something was wrong. A signal figure or a packet count is worth more than a description.
- For real-time help, the Discord community is faster than an issue, though an issue is what gets a fix into a release.
What makes a report diagnosable
Say which version. It is in the bundle, but stating it up front saves a round trip.ados version prints it even when the service is down.
Say whether it is reproducible, and what reproduces it. A fault that happens once per flight and a fault that happens on every boot are different problems.
Distinguish what you observed from what you concluded. “Video is dark and bytesReceived is not advancing” can be acted on. “The video pipeline is dead” cannot, and it is often wrong, because most of the ways to check a live pipeline by hand report a false zero.
Include the counters, not a snapshot. Sample a growing counter two or three times a few seconds apart and say whether it moved. A single reading of a cumulative counter says nothing, and a queue-depth reading of zero on a healthy flow looks identical to a dead one.
For a radio problem, run ados diag link first and paste it. Signal strength, decoded packets, decrypt errors, and FEC counts only come from real radio traffic, so they distinguish a dead link from a measurement error.
For a flight incident, include the flight controller’s log too. The .bin or .ulg from the FC records what the aircraft did. The support bundle records what the companion computer saw, which is a different question.
Security reports
Do not open a public issue for a vulnerability. Email it privately to team@altnautica.com so it can be fixed before it is described in public. Include the affected repository, the version, and the steps to reproduce.Next steps
Troubleshooting by area
Symptom guides for each product.
Recovery
Reach and rebuild a node.
Agent CLI reference
The full command surface.
Community
Discord and other places to ask.