Skip to content

About

A powerful Windows and Intune troubleshooting tool that unifies Event Logs and log files into a single interactive timeline report. Supports real-time filtering, GUID-to-name resolution, and community-contributed event detection rules.

Resources

Stars

34 stars

Watchers

2 watching

Forks

Latest commit

Β 

History

91 Commits

Folders and files

Repository files navigation

🧠 Get-WindowsTroubleshootingReportCommunity v1.1

Version PowerShell License: MIT


Important

πŸš€ You will want the latest and greatest – use the Dev version (v3.0)!
The Dev version includes new features and fixes before they reach the official release (v1.1).
πŸ‘‰ Download Dev version 3.0 here


πŸ”₯ The First Tool That Combines Windows Event Logs + .log Files into a Single Unified Timeline Report

Forget siloed logs. This tool redefines Windows and Intune troubleshooting by doing what no other tool can:

βœ… Merge Event Logs (.evtx) and traditional .log files
βœ… Present everything in a single, chronological timeline
βœ… Detect known issues using community-driven rules
βœ… Generate clean, interactive HTML reports with filtering
βœ… Works with live systems or offline Intune diagnostic packages

Built by IT Pros, for IT Pros β€” this is your all-in-one troubleshooting lens.
It’s not just a script. It’s a community-powered log intelligence engine.


πŸ‘¨β€πŸ’» About the Author

This groundbreaking tool was created by Petri Paavola,
πŸŽ–οΈ Microsoft MVP (Windows and Intune) and creator of the widely used
πŸ”§ Get-IntuneManagementExtensionDiagnostics tool.

Petri has helped thousands of IT pros automate and simplify log analysis β€” this tool takes it to the next level.


πŸ“¦ Download the Tool v1.1 and start seeing the full story in your logs.


Table of Contents πŸ“š


πŸ†• What's New (v1.1)

πŸŽ‰ First Public Release! (Finally πŸ˜€) - This time for real

Please report bugs or suggestions via GitHub Issues.

Changelog Highlights

  • Bug Fixes
  • More KnownEventRules created

πŸ†• What's New (v1.0)

πŸŽ‰ First Public Release! (Finally πŸ˜€)

Please report bugs or suggestions via GitHub Issues.

Changelog Highlights

  • LOTS of new features throughout the script
  • New console UI look
  • Improved HTML report
  • Expanded out-of-box KnownEvent rules

πŸ–ΌοΈ Screenshots

πŸ“ Real examples from the generated timeline report


🧭 Known Events Timeline + Windows Update Trends

Known Events Timeline View
Known Events Timeline
365-Day Windows Update Trend
365 Day Windows Update Trend

πŸ” Intune App & Script GUIDs Translated

App GUIDs β†’ Real App Names
App GUIDs
Script GUIDs β†’ Real Script Names
Script GUIDs

πŸŽ₯ Video Demo

πŸ“ Video demo coming soon...


πŸ› οΈ Features

  • Event Log Support: Read Windows Event logs from live Windows systems or Intune DiagLogs packages (.zip). Extract .zip file first.
  • Log File Support: Analyze structured log files containing dateTime and message fields.
  • Unified Timeline: Merge event and log file data chronologically.
  • Rich HTML Reports: Real-time filtering and searchable HTML output.
  • Scenario-Based Troubleshooting: Focused support for updates, installs, Intune, etc.
  • Full logs reporting: Include all logs to report to understand what is happening in all logs.
  • Custom Event Detection: Detect specific events using customizable EventRules.json.
  • GUIDs to real names: Tool translates known GUIDs to real names, for example Intune Apps and Scripts names
  • Community-Driven: Share your rules and help others troubleshoot.

▢️ Usage Examples

# Get only KNOWN Events. KnownEvents categories and time range is selected from graphical UI
./Get-WindowsTroubleshootingReportCommunity_v1.1.ps1

# Get ALL Events. KnownEvents categories, Event logs and log files and time range is selected from graphical UI
./Get-WindowsTroubleshootingReportCommunity_v1.1.ps1 -AllEvents

# From folder with known events only
./Get-WindowsTroubleshootingReportCommunity_v1.1.ps1 -LogFilesFolder "C:\Logs\DiagLogs-COMPUTERNAME"

# From folder with ALL events
./Get-WindowsTroubleshootingReportCommunity_v1.1.ps1 -LogFilesFolder "C:\Logs\DiagLogs-COMPUTERNAME" -AllEvents

# Known events between two times
./Get-WindowsTroubleshootingReportCommunity_v1.1.ps1 -LogFilesFolder "C:\Logs\DiagLogs-COMPUTERNAME" -StartTime "2024-12-02 08:00:00" -EndTime "2024-12-02 18:00:00"

# All events between two times
./Get-WindowsTroubleshootingReportCommunity_v1.1.ps1 -LogFilesFolder "C:\Logs\DiagLogs-COMPUTERNAME" -StartTime "2024-12-02 08:00:00" -EndTime "2024-12-02 18:00:00" -AllEvents

βš™οΈ Parameters

  • -AllEvents: Include all events (not just known).
  • -LogFilesFolder: Folder with multiple .evtx/log files.
  • -StartTime, -EndTime: Specify exact range.
  • -LogViewerUI: Launch log review UI.
  • -RealtimeLogViewerUI: Real-time Event logs monitoring UI.
  • -IncludeSelectedKnownRulesCategoriesOnly: Filter by known rules.
  • -ExcludeSelectedKnownRulesCategories: Exclude rule categories.
  • -SortDescending: Sort newest-first.
  • -ProcmonFilePath: Include Procmon CSV file.

🧠 How It Works

  1. Log Processing: Parses event logs and .log files, combines them into timeline.
  2. Report Generation: Builds interactive HTML report with filters and search.
  3. Known Event Detection: Uses rules from EventRules.json.
  4. Customization: Build your own rules with Create-EventRules-GUI-HelperTool.ps1.

🀝 Contributing

  • Use Create-EventRules-GUI-HelperTool.ps1 to create EventRules.json.
  • Add green (success) and red (fail) markers.
  • Submit via GitHub to help others.

πŸ§ͺ Scenarios

  • Windows Update: Status, success/fail, reboots.
  • Intune: Enrollment, sync, script/app information and errors.
  • Defender for Endpoint: AV definitions and scans.
  • Software Installs: MSI/Store installs and issues.
  • System Events: Restarts, sleep, driver changes.

πŸ“Š Example Reports (Coming soon)

  • Timeline View
  • Filtered Report: Only known events or categories

πŸ”Ž GUID to Name Resolution

Reading Intune logs full of random GUIDs? This tool fixes that.

The report can automatically convert known GUIDs to real, human-readable names β€” especially helpful when analyzing Intune .log files and Event Logs.

πŸ’‘ Built-in Translation Features

  • App installation logs: Converts Intune App GUIDs to their real names. (Built-in)
  • Attack Surface Reduction (ASR) rules: Recognized and labeled. (Built-in)
  • PowerShell and Remediation Scripts: Shows actual script names. (Run included tool to download Intune names)

πŸ“¦ How It Works

  1. The tool checks for known GUIDs using .json files in the KnownGUIDs folder.
  2. You can enrich this mapping using a built-in helper script:
    .\KnownGUIDs\Get-Intune-Apps-and-Scripts-GUIDs-and-Names.ps1
  3. Run the script once to generate a full list of:
    • Intune Apps
    • PowerShell Scripts
    • Remediation Scripts

βœ… Result

Once mapped, your report will display:

Instead of:
  ApplicationId: d8a3bc0d-2342-48b9-a0a1-7bc409b153f3

You’ll see:
  Application: Microsoft Edge (Win32) – Install

No more digging through Intune manually. Just clear, meaningful names in the report.

🧠 This functionality alone can save hours of troubleshooting and is completely automated after a quick setup.


πŸ“˜ PowerShell Script Parameters

Full parameter list is in the script comments or use Get-Help.


πŸ—‚οΈ Supported Log Files and Event Logs

  • Full support for .evtx logs (online/offline)
  • Support for Intune and ConfigMgr CMTrace-style .log files
  • Experimental support for Procmon CSV
  • Future: CBS.log, DISM.log, .etl, etc.
  • If you have a need or use case for additional .log support, contact Petri

πŸ” Do I Need Admin Rights

  • Not required, but highly recommended for full access to Windows Event logs
  • Admin = better coverage
  • Offline logs don’t require admin

🧩 PowerShell Support

  • βœ… PowerShell Core (7.x) - This is preferred and faster!
  • βœ… Windows PowerShell 5.1

πŸ“„ License

MIT License β€” see LICENSE.md


πŸ‘¨β€πŸ’» Contributors


πŸ€– Acknowledgments

Special thanks to GPT-4 from OpenAI for helping with documentation generation, text refactoring, and markdown polishing. AI helped us work faster, so we can troubleshoot better. πŸ’‘

About

A powerful Windows and Intune troubleshooting tool that unifies Event Logs and log files into a single interactive timeline report. Supports real-time filtering, GUID-to-name resolution, and community-contributed event detection rules.

Resources

Stars

34 stars

Watchers

2 watching

Forks

Releases

Packages

Contributors

Languages