diff --git a/contents/Telemetry.md b/contents/Telemetry.md index d106004..1a2d52b 100644 --- a/contents/Telemetry.md +++ b/contents/Telemetry.md @@ -553,15 +553,19 @@ A `dotnet.thread_pool.queue.length` that keeps growing, together with a `dotnet. ## Outbox Stale Message Metrics -> **Not in a released package yet.** The stale message monitor ships after Brighter 10.8.1, which is the current release. `UseOutboxStaleMessageMonitor`, `Publication.StaleMessageAge` and the three instruments below are on Brighter's development branch and are in no version you can install today, so treat this section as the feature as it will ship. +> **Available from Brighter 10.8.2.** `UseOutboxStaleMessageMonitor`, `Publication.StaleMessageAge` and the three instruments below are not in 10.8.1 or earlier, so upgrade to 10.8.2 or later to use the stale message monitor. A message that stays undispatched in the outbox is invisible until someone queries the store. The stale message monitor counts those messages on a timer and reports the counts as metrics, so you can alert when messages get stuck. It is opt-in. + ```csharp using System; +using Microsoft.Extensions.DependencyInjection; using Paramore.Brighter.Extensions.DependencyInjection; using Paramore.Brighter.Outbox.Hosting; +var services = new ServiceCollection(); + services.AddBrighter() .AddProducers(options => { diff --git a/tools/README.md b/tools/README.md index 07689be..1d28be2 100644 --- a/tools/README.md +++ b/tools/README.md @@ -143,7 +143,7 @@ is `ExternalBusConfiguration`, V9's bus configuration type. | 6 | `optioncheck` | `dotnet run --project tools/optioncheck` | **0 mismatches across 59 tables, 533 rows** — at bugfix 0003, pinned to Brighter 10.8.1; it read **529 rows** against 10.8.0 and **519** against 10.7.0 | | 7 | `--verify` | `python3 tools/urlmap.py --verify` | **161 predicted = 161 published** | | 8 | `symbolcheck` | `python3 tools/symbolcheck.py` | **0 findings — 25 entries, 161 pages, 14 silenced** — at spec 018 phase 7, which listed `ExternalBusConfiguration`; it read **24 entries, 14 silenced** at spec 018 phase 3, which listed `AddServiceActivator` and `UseExternalBus` with opt-outs on `FAQ.md` and `V10MigrationGuide.md`, **22 entries, 3 silenced** at `3be2a78` and **5 entries, 1 silenced** at `412fd34` | -| 9 | `blockcheck` | `python3 tools/blockcheck.py --report` | **994 blocks: 889 BUILT, 76 FAILED, 29 SKIPPED, 0 NOT_COMPILABLE — 0 findings, 29 skipped**, against **579 reference assemblies** on each pin, **28 blocks on the v4 pin, 28 built**, with **97 scaffold units checked, 0 violations, 0 compile errors** and **4 pages on the v4 pin, 0 violations** — at spec 018 phase 7, against Brighter 10.8.1 and Darker 4.1.1; it read **994 blocks, 758 BUILT, 207 FAILED, 29 SKIPPED** against 553 with 80 units at spec 018 phase 6, **994 blocks, 644 BUILT, 323 FAILED, 27 SKIPPED** with 67 units at bugfix 0003, **992 blocks, 642 BUILT** at spec 018 phase 5, against 10.8.0, **994 blocks, 536 BUILT, 441 FAILED, 17 SKIPPED** with 60 units at spec 018 phase 4, **993 blocks, 430 BUILT, 546 FAILED** against 552 with 52 units at spec 018 phase 3, **992 blocks, 304 BUILT, 671 FAILED** against 551 with 45 units at bugfix 0002, **993 blocks, 303 BUILT, 673 FAILED** against 548 at spec 018 phase 2, merged with #199, whose three `Telemetry.md` blocks are FAILED, and **990 blocks, 299 BUILT, 674 FAILED** against 545 with 45 units at `bd95ee0`, **295 BUILT** at `5981b12`, **983 blocks, 234 BUILT** against 542 with 35 units at `ca6a0b2`, **189 BUILT** against 538 with 30 units at `2223fcb`, **982 blocks, 129 BUILT** with 22 units at `5407298`, **989 blocks, 101 BUILT, 872 FAILED** at `b941837`, unmoved at `23aa74f` with 14 units, and **985 blocks, 92 BUILT, 12 SKIPPED** at `1e1944d` | +| 9 | `blockcheck` | `python3 tools/blockcheck.py --report` | **995 blocks: 889 BUILT, 76 FAILED, 30 SKIPPED, 0 NOT_COMPILABLE — 0 findings, 30 skipped**, against **579 reference assemblies** on each pin, **28 blocks on the v4 pin, 28 built**, with **97 scaffold units checked, 0 violations, 0 compile errors** and **4 pages on the v4 pin, 0 violations** — after #207's stale message monitor section, whose one C# block is skipped as available from Brighter 10.8.2, against Brighter 10.8.1 and Darker 4.1.1; it read **994 blocks, 889 BUILT, 29 SKIPPED** at spec 018 phase 7, and **994 blocks, 758 BUILT, 207 FAILED, 29 SKIPPED** against 553 with 80 units at spec 018 phase 6, **994 blocks, 644 BUILT, 323 FAILED, 27 SKIPPED** with 67 units at bugfix 0003, **992 blocks, 642 BUILT** at spec 018 phase 5, against 10.8.0, **994 blocks, 536 BUILT, 441 FAILED, 17 SKIPPED** with 60 units at spec 018 phase 4, **993 blocks, 430 BUILT, 546 FAILED** against 552 with 52 units at spec 018 phase 3, **992 blocks, 304 BUILT, 671 FAILED** against 551 with 45 units at bugfix 0002, **993 blocks, 303 BUILT, 673 FAILED** against 548 at spec 018 phase 2, merged with #199, whose three `Telemetry.md` blocks are FAILED, and **990 blocks, 299 BUILT, 674 FAILED** against 545 with 45 units at `bd95ee0`, **295 BUILT** at `5981b12`, **983 blocks, 234 BUILT** against 542 with 35 units at `ca6a0b2`, **189 BUILT** against 538 with 30 units at `2223fcb`, **982 blocks, 129 BUILT** with 22 units at `5407298`, **989 blocks, 101 BUILT, 872 FAILED** at `b941837`, unmoved at `23aa74f` with 14 units, and **985 blocks, 92 BUILT, 12 SKIPPED** at `1e1944d` | **Four of the nine are not in the `check` job of `.github/workflows/docs.yml`, and each absence is a decision rather than an oversight:** diff --git a/tools/blockcheck/baseline.tsv b/tools/blockcheck/baseline.tsv index 85b2c3b..ecc551c 100644 --- a/tools/blockcheck/baseline.tsv +++ b/tools/blockcheck/baseline.tsv @@ -931,7 +931,7 @@ contents/Telemetry.md 5 TelemetryContext.cs 429635f contents/Telemetry.md 6 TelemetryContext.cs 429635f contents/Telemetry.md 7 TelemetryContext.cs 429635f contents/Telemetry.md 8 TelemetryContext.cs 429635f -contents/Telemetry.md 9 TelemetryContext.cs 429635f +contents/Telemetry.md 10 TelemetryContext.cs 429635f contents/TestDoubleOptions.md 1 TestDoubleOptionsContext.cs 429635f contents/TestDoubleOptions.md 2 TestDoubleOptionsContext.cs 429635f contents/TestDoubleOptions.md 3 TestDoubleOptionsContext.cs 429635f