Skip to content

feat(kb): Add Change Tracker KB articles — batch 2a#1190

Open
hilram7 wants to merge 3 commits into
devfrom
kb/changetracker-easy-batch-2a
Open

feat(kb): Add Change Tracker KB articles — batch 2a#1190
hilram7 wants to merge 3 commits into
devfrom
kb/changetracker-easy-batch-2a

Conversation

@hilram7

@hilram7 hilram7 commented Jul 2, 2026

Copy link
Copy Markdown
Collaborator

Summary

  • Adds 8 new Change Tracker KB articles
  • Retires 1 article (mongo-service-not-starting-windows) — VC++ Redistributable issue no longer occurs on supported OS versions

Changes

  • Migrated 8 rolling-log and agent troubleshooting articles from staging repo
  • Applied SME feedback:
    • hubdetails-crypto-error: agent path corrected (gen7agent.servicegen7agent.app.netcore), Windows service name updated to Netwrix ChangeTracker Gen7 Agent NetCore, Linux service name updated to nntgen7agentcore, doc link updated to correct 8_2 Docusaurus route
    • duplicate-events-in-syslogs: replaced deprecated count() with countDocuments() for MongoDB 8.x compatibility
  • Retired mongo-service-not-starting-windows.md — Ben and Denis confirmed the VC++ Redistributable issue no longer applies
  • Removed all kb.netwrix.com/#### Related links and dropped broken CDN attachments
  • Fixed truncated frontmatter, typos, mojibake encoding
  • Terminology alignment: "configuration template" → "policy template" across 5 articles (Ben confirmed 8.2 UI uses "Policy Templates")
  • Structural improvements:
    • Rewrote question-style steps as imperatives in the 3 near-identical "file/key not found" articles
    • Changed ## Explanation## Cause in the 3 similar articles for style guide compliance
    • Deduplicated redundant sentences in deviceconfigtask-wildcards-pathmatch-error
    • Converted numbered → bulleted causes list in hub-offline-connection-retries-exhausted (grouped WAN/LAN causes into nested list; used FQDN acronym only)
    • Expanded hub-offline Resolution with common troubleshooting steps and links to related KB / product doc
    • Removed redundant quotes from bolded UI elements
    • Softened "the agent is NOT reporting" (all caps) and "potentially NOT reporting" wording

Articles (8 total)

All in docs/kb/changetracker/troubleshooting-and-errors/:

  1. AgentTaskRunner ProcessTracker Error (agenttaskrunner-processtracker-error.md)
  2. DeviceConfigTask Wildcards PathMatch Error (deviceconfigtask-wildcards-pathmatch-error.md)
  3. Duplicate Events in Syslogs (duplicate-events-in-syslogs.md)
  4. File Entry Not Found Error (file-entry-not-found-error.md)
  5. FileHash SHA256 File Not Found Error (filehash-sha256-file-not-found-error.md)
  6. Hub Offline Connection Retries Exhausted (hub-offline-connection-retries-exhausted.md)
  7. HubDetails Crypto Error (hubdetails-crypto-error.md)
  8. Registry Key Permissions Error (registry-key-permissions-error.md)

Known Gaps — SME Review Needed

  • hub-offline-connection-retries-exhausted.md — The Resolution section was expanded from a placeholder into common troubleshooting steps with links to the Network Ports KB and 8.2 Agent and Device Ports product doc. Please confirm the steps and expand with any product-specific commands, additional guidance, or missing scenarios (e.g., WAN/LAN-specific steps).

Note on Missing Screenshots

The original screenshots for these articles are no longer accessible (broken CDN links). During migration, inline image references were replaced with HTML comment placeholders like:

<!-- Image removed: [description of what the screenshot showed] -->

Choose one of the following options:

  1. Add fresh 8.2 screenshots — grab current UI screenshots to replace the placeholders (best long-term)
  2. Confirm no image needed — the procedure is followable without a visual; placeholder can be removed

Articles with placeholders in this PR:

  • agenttaskrunner-processtracker-error.md
  • deviceconfigtask-wildcards-pathmatch-error.md
  • hubdetails-crypto-error.md

Testing

  • Vale: 0 errors, 0 warnings on all modified files
  • Local build: successful, no broken links or anchor errors

Closes #1191

hilram7 added 3 commits June 30, 2026 18:49
Migrates 9 rolling-log and agent troubleshooting articles from staging
repo. Fixes applied: truncated frontmatter restored, kb.netwrix.com
links removed, Salesforce CDN images replaced with placeholders,
typos fixed, mojibake encoding corrected, structure aligned to KB
standards.
- hubdetails-crypto-error: correct agent path (gen7agent.service to
  gen7agent.app.netcore), Windows service name (Netwrix ChangeTracker
  Gen7 Agent NetCore), Linux service name (nntgen7agentcore)
- duplicate-events-in-syslogs: replace deprecated count() with
  countDocuments() for MongoDB 8.x compatibility
- Retire mongo-service-not-starting-windows (both SMEs confirmed the
  VC++ Redistributable issue no longer occurs on supported OS)
- Add knowledge_article_id to 5 articles
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

KB review: feat(kb): Add Change Tracker KB articles — batch 2a (PR #1190)

2 participants