Analyze AutoDoctor Artifacts
Categories:
Who This Page Is For
- AutoDoctor users who want a readable summary of report or telemetry output
- Indexly users inspecting
AutoDoctor_Report.json,Telemetry_*.json, orautodoctor.db - Developers validating how Indexly interprets AutoDoctor artifacts
What Indexly Supports
Indexly can analyze these AutoDoctor outputs directly:
| Artifact | Typical source | Best command |
|---|---|---|
AutoDoctor_Report.json |
reports/ |
indexly analyze-autodoctor <path> |
Telemetry_*.json |
telemetry/ |
indexly analyze-autodoctor <path> |
autodoctor.db |
db/ |
indexly analyze-autodoctor <path> |
You can also use generic commands:
indexly analyze-file <path>for auto-detection through the orchestratorindexly analyze-json <path>for JSON-first analysisindexly analyze-db <path>for SQLite-first analysis
Why Use analyze-autodoctor
AutoDoctor outputs are operational documents, not just generic tables.
The dedicated command:
- recognizes AutoDoctor report JSON and telemetry JSON
- summarizes root cause, health, identity, and runtime context
- summarizes AutoDoctor SQLite persistence using operational sections
- avoids flattening report-style structures into one synthetic DataFrame when that would remove meaning
Recommended Workflows
1. Analyze the report JSON
indexly analyze-autodoctor .\AutoDoctor_Report.json --show-summary
Use this when you want:
- health score
- root-cause summary
- findings and inventory highlights
- trend indicators and remediation status
2. Analyze a telemetry snapshot
indexly analyze-autodoctor .\Telemetry_20260416-081258-BTNB05.json --summary-only
Use this when you want:
- run identity and generated time
- module success/failure state
- database sync state
- system snapshot details such as CPU, memory, disk, and network context
3. Analyze the SQLite database
indexly analyze-autodoctor .\autodoctor.db --show-summary
Use this when you want:
- latest system snapshot
- alert severity summary
- module success/failure counts
- recent baselines and remediation state
Generic Route Equivalents
These commands can also trigger the AutoDoctor-aware path:
indexly analyze-file .\AutoDoctor_Report.json --show-summary
indexly analyze-file .\Telemetry_20260416-081258-BTNB05.json --show-summary
indexly analyze-file .\autodoctor.db --show-summary
indexly analyze-db .\autodoctor.db --show-summary
Use the generic routes when:
- you are exploring mixed file types with one command style
- you want Indexly to decide the routing automatically
Use analyze-autodoctor when:
- the artifact is definitely AutoDoctor output
- you want the clearest operator-facing summary
- you want
--summary-only,--full,--sections, or--history-limit
JSON Variants Indexly Understands
AutoDoctor_Report.json
This report-oriented JSON usually contains sections such as:
SystemInfoCPUMemoryDiskNetworkRootCauseDetailsHealthScoreAutomaticRemediation
Important note:
- some report files do not contain a hostname field
- Indexly falls back to another useful identity, such as
WindowsProductName, when a real host value is missing
Telemetry_*.json
Telemetry snapshots usually contain:
RunIDGeneratedAtHostnameExecutionStatsDatabaseSyncSystemModules
These files are especially useful when you want host identity, run metadata, and module execution context.
Time And Identity Handling
Indexly formats timestamps into friendlier display values when the source is parseable.
That includes:
- ISO timestamps such as
2026-04-16T08:32:47.8857104+02:00 - .NET-style timestamps such as
/Date(1776321167385)/
The goal is:
- human-friendly output in the terminal
- without losing the operational meaning of the original artifact
Troubleshooting
Report JSON shows summary but generic JSON views look odd
That usually means the file is better treated as an operational report than a generic dataset. Prefer:
indexly analyze-autodoctor .\AutoDoctor_Report.json --show-summary
Telemetry JSON has richer identity fields than the report
That is expected. Telemetry typically carries Hostname, RunID, GeneratedAt, and database-sync metadata that may not be present in the report JSON.
You need historical meaning, not just a summary
Use the companion AutoDoctor docs to understand what the artifacts represent:
Analysis output does not appear in persisted results
Indexly stores cleaned analysis persistence separately from the search index. Check the analysis database with:
indexly doctor --analysis-db
For a slower read-only SQLite corruption check:
indexly doctor --analysis-db --full-integrity
Doctor reports the ~/.indexly/indexly.db path, whether the cleaned_data table exists, row count, and invalid JSON payload counts.