docs: add JetStream perf investigation notes and test status tracking

Add detailed analysis of the 1,200x JetStream file publish gap identifying
the bottleneck in the outbound write path (not FileStore). Add tests.md
tracking skipped/failing test status across Core and JetStream suites.
This commit is contained in:
Joseph Doherty
2026-03-13 03:20:43 -04:00
parent 4de691c9c5
commit 9e0df9b3d7
2 changed files with 84 additions and 1 deletions

32
tests.md Normal file
View File

@@ -0,0 +1,32 @@
# Test Status
## Failing Tests
No known failing tests.
## Skipped Tests
### NATS.Server.Core.Tests (6 skipped)
| Test | Reason |
|------|--------|
| `ClientProtocolGoParityTests.Client_rejects_NRG_subjects_for_non_system_users` | Not yet implemented |
| `ClientProtocolGoParityTests.Header_stripped_for_non_header_subscriber` | Not yet implemented |
| `ClientProtocolGoParityTests.Header_stripped_for_non_header_queue_subscriber` | Not yet implemented |
| `SubjectTreeTests.TestSubjectTreeMatchAllPerf` | Performance-only |
| `SubjectTreeTests.TestSubjectTreeIterPerf` | Performance-only |
| `SubjectTreeTests.TestSubjectTreeGSLIntersection` | Not yet implemented |
### NATS.Server.JetStream.Tests (9 skipped)
| Test | Reason |
|------|--------|
| `MirrorSourceGoParityTests.Mirror_consumer_fails_after_restart_and_recovers` | Requires real server restart with FileStore persistence |
| `MirrorSourceGoParityTests.Remove_external_source_stops_forwarding` | Requires multi-server leaf node topology |
| `MirrorSourceGoParityTests.Work_queue_source_recovers_after_restart` | Requires real server restart |
| `MirrorSourceGoParityTests.Work_queue_source_naming_recovers_after_restart` | Requires real server restart |
| `MirrorSourceGoParityTests.Stream_update_with_external_source_works` | Requires multi-server leaf node topology |
| `FileStoreRecovery2Tests.WriteFailures_FullDisk_SkipEnvironmentSpecific` | Environment-specific (requires Docker tmpfs) |
| `FileStoreRecovery2Tests.PartialIndexes_StoreAndLoadAfterCacheExpiry` | Obsolete in Go upstream |
| `FileStoreRecovery2Tests.WriteFullState_HighSubjectCardinality` | Performance benchmark only |
| `FileStoreRecovery2Tests.Corruption_HbitSanityCheck` | Go-internal wire format (hbit/cbit) |