{"docs":[{"id":164,"title":"Logging and Diagnostics: Making Field Problems Solvable","heading":"Logging and Diagnostics: Making Field Problems Solvable","subheading":null,"category":"Software","body":{"root":{"type":"root","children":[{"type":"heading","tag":"h3","version":1,"children":[{"type":"text","text":"What a useful log line contains","version":1}]},{"type":"paragraph","version":1,"children":[{"type":"text","text":"Record a timestamp, a severity, the component and the event with its key values: the device serial number, the request identifier, the error code and the state the code was in. Structured formats such as JSON key-value pairs make logs searchable by tools rather than only by eye.","version":1}]},{"type":"paragraph","version":1,"children":[{"type":"text","text":"Keep secrets and personal data out. Passwords, tokens and keys must never be logged, and personal data should be minimised or masked, both for security and to meet privacy law such as GDPR.","version":1}]}],"direction":"ltr","format":"","indent":0,"version":1}},"tags":"Software, Diagnostics, Logging, Support","cardCta":{"label":null,"link":null},"pageCta":{"label":"Talk to AAVICO engineering","link":"/contact"},"excerpt":"When software fails at a customer site, the logs are often the only witness. Designing them deliberately turns vague fault reports into problems engineers can reproduce and fix.","featuredImage":null,"type":"Blog","readTime":"3 min read","publishedAt":"2026-11-15T17:59:00.000Z","heroImage":null,"introText":"A fault that happens once a week on a customer machine, a factory floor or inside a connected device cannot be debugged with a breakpoint. What the team has is whatever the software recorded at the time. Good diagnostics are designed, not accumulated: consistent levels, useful context, bounded storage, crash capture and a simple way for a customer or a device to hand the evidence over. This article covers how to build that in.","metrics":[{"id":"logging-and-diagnostics-making-field-problems-so-metric-1","value":"8 levels","label":"Syslog defines eight severities, from emergency down to debug, a useful reference scale.","icon":null},{"id":"logging-and-diagnostics-making-field-problems-so-metric-2","value":"UTC","label":"Timestamps in UTC with stated precision make logs from different machines comparable.","icon":null},{"id":"logging-and-diagnostics-making-field-problems-so-metric-3","value":"Rotation","label":"Log files are capped and rotated so diagnostics never fill the disk.","icon":null},{"id":"logging-and-diagnostics-making-field-problems-so-metric-4","value":"Symbols","label":"Debug symbols archived for each release turn crash dumps into readable stack traces.","icon":null}],"gallery":[],"challenge":{"root":{"type":"root","children":[{"type":"paragraph","version":1,"children":[{"type":"text","text":"Logs written ad hoc fail in two directions. Some code logs nothing useful, so the record stops just before the interesting moment. Other code logs everything on every loop, which buries the one relevant line and wears out flash storage on embedded devices.","version":1}]},{"type":"paragraph","version":1,"children":[{"type":"text","text":"Even good logs are useless if they cannot be retrieved. Asking a customer to find a hidden folder, or a field technician to attach a debugger, means most problems are never properly reported.","version":1}]}],"direction":"ltr","format":"","indent":0,"version":1}},"blockquote":{"quote":"Write each log line for the engineer who will read it months from now with no other information. That is usually who reads it.","author":"","role":"AAVICO Engineering"},"supportImage1":null,"deliverables":{"root":{"type":"root","children":[{"type":"paragraph","version":1,"children":[{"type":"text","text":"Agree severity levels and their meaning across the codebase, and decide what is logged by default and what only when verbose logging is switched on.","version":1}]},{"type":"paragraph","version":1,"children":[{"type":"text","text":"Add crash capture, such as minidumps on Windows and core dumps or a crash handler on Linux and macOS, and archive the matching symbols for every released build.","version":1}]},{"type":"paragraph","version":1,"children":[{"type":"text","text":"Provide a one-click diagnostics export, or an opt-in upload, that bundles logs, version information and configuration into a single file.","version":1}]}],"direction":"ltr","format":"","indent":0,"version":1}},"results":[{"id":"logging-and-diagnostics-making-field-problems-so-result-1","title":"Faster Diagnosis","description":"Engineers start from evidence instead of a description of what the user thinks happened."},{"id":"logging-and-diagnostics-making-field-problems-so-result-2","title":"Fewer Repeat Visits","description":"Intermittent faults are captured the first time they occur rather than reproduced at length."},{"id":"logging-and-diagnostics-making-field-problems-so-result-3","title":"Bounded Storage","description":"Rotation and levels keep logs useful without filling disks or wearing out flash."},{"id":"logging-and-diagnostics-making-field-problems-so-result-4","title":"Privacy","description":"Masked and minimised logs can be shared with support without exposing customer data."}],"lookingAhead":{"root":{"type":"root","children":[{"type":"paragraph","version":1,"children":[{"type":"text","text":"For connected products, correlate device, cloud and app logs by carrying a shared identifier through each request. A fault often spans all three.","version":1}]},{"type":"paragraph","version":1,"children":[{"type":"text","text":"Allow verbose logging to be switched on by configuration or remotely for a limited time, so detail is available when needed without running at full volume permanently.","version":1}]}],"direction":"ltr","format":"","indent":0,"version":1}},"supportImage2":null,"testimonial":{"quote":null,"author":null,"role":null,"photo":null},"challengesSolved":[{"id":"logging-and-diagnostics-making-field-problems-so-challenge-1","title":"Logs that stop before the fault","description":null,"icon":null},{"id":"logging-and-diagnostics-making-field-problems-so-challenge-2","title":"Disks or flash filled by diagnostics","description":null,"icon":null},{"id":"logging-and-diagnostics-making-field-problems-so-challenge-3","title":"Crash dumps without matching symbols","description":null,"icon":null},{"id":"logging-and-diagnostics-making-field-problems-so-challenge-4","title":"Passwords or personal data in log files","description":null,"icon":null}],"relatedPosts":[],"contactUs":{"show":true},"updatedAt":"2026-11-15T17:32:32.682Z","createdAt":"2026-11-15T17:32:32.682Z"}],"hasNextPage":false,"hasPrevPage":false,"limit":10,"nextPage":null,"page":1,"pagingCounter":1,"prevPage":null,"totalDocs":1,"totalPages":1}