Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 5 additions & 1 deletion contents/Telemetry.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.

<!-- blockcheck: skip available from Brighter 10.8.2, after the pins' 10.8.1; remove this skip when the pins move to 10.8.2 -->
```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 =>
{
Expand Down
2 changes: 1 addition & 1 deletion tools/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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:**
Expand Down
2 changes: 1 addition & 1 deletion tools/blockcheck/baseline.tsv
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
Loading