Skip to content

AdversaryGraph v2.2.0

Choose a tag to compare

View all tags
@anpa1200 anpa1200 released this 18 Jun 05:43
· 10 commits to main since this release
v2.2.0
4fb413d

AdversaryGraph v2.2.0 Release Notes

Release date: 2026-06-18

AdversaryGraph v2.2.0 is the operational troubleshooting and startup validation
release. It focuses on making Docker deployment failures visible, actionable,
and easy to recheck from inside the UI.

Major Changes

  • Added an internal troubleshooting page at /troubleshooting.
  • Added contextual troubleshooting links to API error and startup self-test
    popups.
  • Added a Recheck button to API error popups.
  • When recheck passes, the error popup turns green and shows All correct..
  • Added /api/system/selftest for runtime validation of:
    • database connectivity
    • ATT&CK/ATLAS ingested versions and data counts
    • Redis connectivity
  • Added a Docker selftest service that can be run after docker compose up.
  • Improved matrix startup resilience with longer query retries.
  • Refreshed matrix, discover, and sync queries after self-test passes.

Troubleshooting Page

The new /troubleshooting page is served by the Docker frontend and includes:

  • self-test command
  • direct API health check
  • frontend proxy health check
  • ATT&CK tactic and technique count probes
  • service log commands
  • restart-without-data-loss command
  • common failure explanations
  • recovery order for startup and data-ingestion issues

Error popups link to this page with context parameters such as HTTP status,
request path, and message.

Recheck Workflow

When an API request fails, the global error popup now shows:

  • clear status and URL context
  • Recheck
  • Open troubleshooting

The Recheck action runs /api/system/selftest.

If all checks pass, the popup changes to a green success state:

All correct.

If checks fail, the popup remains red and displays the failed self-test details.

Verification

Validation performed for this release:

  • Frontend production build: npm run build passed.
  • Docker self-test: docker compose run --rm selftest passed.
  • /api/system/selftest returned ok.
  • /troubleshooting route was served by the Docker frontend.
  • Live Vite module served the updated Recheck and All correct. logic.

Upgrade Notes

Pull the latest code and rebuild/restart:

git pull
docker compose up -d --build
docker compose run --rm selftest

Open:

http://localhost:3000/troubleshooting

Use this page when an API popup reports HTTP 500, connection reset, empty
matrix data, or startup validation failure.

Assets 2
Loading