e11y 0.2.0 → 1.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (288) hide show
  1. checksums.yaml +4 -4
  2. data/.rubocop.yml +130 -10
  3. data/CHANGELOG.md +80 -1
  4. data/CLAUDE.md +168 -0
  5. data/CONTRIBUTING.md +640 -0
  6. data/README.md +165 -701
  7. data/RELEASE.md +41 -12
  8. data/Rakefile +249 -57
  9. data/config/README.md +1 -1
  10. data/config/loki-local-config.yaml +12 -0
  11. data/config/otel-collector-config.yaml +44 -0
  12. data/cucumber.yml +1 -0
  13. data/docker-compose.yml +18 -2
  14. data/docs/ADAPTERS.md +76 -0
  15. data/docs/ADAPTIVE_SAMPLING.md +59 -0
  16. data/docs/COMPARISON.md +104 -0
  17. data/docs/CONFIGURATION.md +52 -0
  18. data/docs/DISTRIBUTED_TRACING.md +44 -0
  19. data/docs/LIMITATIONS.md +13 -0
  20. data/docs/METRICS_DSL.md +84 -0
  21. data/docs/PERFORMANCE.md +60 -0
  22. data/docs/PII_FILTERING.md +40 -0
  23. data/docs/PRESETS.md +65 -0
  24. data/docs/QUICK-START.md +546 -587
  25. data/docs/RAILS_INTEGRATION.md +79 -0
  26. data/docs/SCHEMA_VALIDATION.md +63 -0
  27. data/docs/SLO-PROMQL-ALERTS.md +161 -0
  28. data/docs/TESTING.md +69 -0
  29. data/docs/{ADR-001-architecture.md → architecture/ADR-001-architecture.md} +36 -65
  30. data/docs/{ADR-002-metrics-yabeda.md → architecture/ADR-002-metrics-yabeda.md} +62 -236
  31. data/docs/architecture/ADR-003-slo-observability.md +1402 -0
  32. data/docs/{ADR-004-adapter-architecture.md → architecture/ADR-004-adapter-architecture.md} +163 -146
  33. data/docs/{ADR-005-tracing-context.md → architecture/ADR-005-tracing-context.md} +10 -9
  34. data/docs/{ADR-006-security-compliance.md → architecture/ADR-006-security-compliance.md} +184 -191
  35. data/docs/{ADR-007-opentelemetry-integration.md → architecture/ADR-007-opentelemetry-integration.md} +3 -21
  36. data/docs/{ADR-008-rails-integration.md → architecture/ADR-008-rails-integration.md} +182 -743
  37. data/docs/{ADR-009-cost-optimization.md → architecture/ADR-009-cost-optimization.md} +45 -54
  38. data/docs/architecture/ADR-010-developer-experience.md +522 -0
  39. data/docs/{ADR-011-testing-strategy.md → architecture/ADR-011-testing-strategy.md} +44 -86
  40. data/docs/{ADR-012-event-evolution.md → architecture/ADR-012-event-evolution.md} +11 -11
  41. data/docs/{ADR-013-reliability-error-handling.md → architecture/ADR-013-reliability-error-handling.md} +37 -12
  42. data/docs/{ADR-014-event-driven-slo.md → architecture/ADR-014-event-driven-slo.md} +12 -24
  43. data/docs/{ADR-015-middleware-order.md → architecture/ADR-015-middleware-order.md} +43 -59
  44. data/docs/{ADR-016-self-monitoring-slo.md → architecture/ADR-016-self-monitoring-slo.md} +58 -355
  45. data/docs/{ADR-017-multi-rails-compatibility.md → architecture/ADR-017-multi-rails-compatibility.md} +4 -11
  46. data/docs/architecture/ADR-018-memory-optimization.md +366 -0
  47. data/docs/{ADR-INDEX.md → architecture/ADR-INDEX.md} +11 -6
  48. data/docs/plans/2026-03-20-browser-overlay-svelte.md +281 -0
  49. data/docs/{00-ICP-AND-TIMELINE.md → prd/00-ICP-AND-TIMELINE.md} +6 -6
  50. data/docs/{01-SCALE-REQUIREMENTS.md → prd/01-SCALE-REQUIREMENTS.md} +6 -6
  51. data/docs/prd/01-overview-vision.md +19 -14
  52. data/docs/use_cases/README.md +22 -23
  53. data/docs/use_cases/UC-001-request-scoped-debug-buffering.md +50 -44
  54. data/docs/use_cases/UC-002-business-event-tracking.md +26 -95
  55. data/docs/use_cases/UC-003-event-metrics.md +66 -0
  56. data/docs/use_cases/UC-004-zero-config-slo-tracking.md +33 -684
  57. data/docs/use_cases/UC-005-sentry-integration.md +13 -15
  58. data/docs/use_cases/UC-006-trace-context-management.md +30 -28
  59. data/docs/use_cases/UC-007-pii-filtering.md +35 -87
  60. data/docs/use_cases/UC-008-opentelemetry-integration.md +51 -89
  61. data/docs/use_cases/UC-009-multi-service-tracing.md +30 -178
  62. data/docs/use_cases/UC-010-background-job-tracking.md +24 -91
  63. data/docs/use_cases/UC-011-rate-limiting.md +95 -168
  64. data/docs/use_cases/UC-012-audit-trail.md +21 -46
  65. data/docs/use_cases/UC-013-high-cardinality-protection.md +29 -167
  66. data/docs/use_cases/UC-014-adaptive-sampling.md +2 -2
  67. data/docs/use_cases/UC-015-cost-optimization.md +46 -99
  68. data/docs/use_cases/UC-016-rails-logger-migration.md +39 -213
  69. data/docs/use_cases/UC-017-local-development.md +203 -777
  70. data/docs/use_cases/UC-018-testing-events.md +3 -3
  71. data/docs/use_cases/UC-019-retention-based-routing.md +53 -106
  72. data/docs/use_cases/UC-020-event-versioning.md +8 -9
  73. data/docs/use_cases/UC-021-error-handling-retry-dlq.md +18 -22
  74. data/docs/use_cases/UC-022-event-registry.md +15 -21
  75. data/docs/use_cases/backlog.md +119 -87
  76. data/e11y.gemspec +2 -2
  77. data/gems/e11y-devtools/README.md +158 -0
  78. data/gems/e11y-devtools/config/routes.rb +15 -0
  79. data/gems/e11y-devtools/e11y-devtools.gemspec +25 -0
  80. data/gems/e11y-devtools/exe/e11y +34 -0
  81. data/gems/e11y-devtools/frontend/.gitignore +24 -0
  82. data/gems/e11y-devtools/frontend/README.md +51 -0
  83. data/gems/e11y-devtools/frontend/index.html +14 -0
  84. data/gems/e11y-devtools/frontend/package-lock.json +3707 -0
  85. data/gems/e11y-devtools/frontend/package.json +28 -0
  86. data/gems/e11y-devtools/frontend/public/mocks/v1/events/recent.json +4205 -0
  87. data/gems/e11y-devtools/frontend/public/mocks/v1/interactions.json +194 -0
  88. data/gems/e11y-devtools/frontend/public/mocks/v1/traces/0a2e04027cfa22d014bc22e8b27cd913/events.json +86 -0
  89. data/gems/e11y-devtools/frontend/public/mocks/v1/traces/0e1543af6a630fb3af6b52283154b3e0/events.json +169 -0
  90. data/gems/e11y-devtools/frontend/public/mocks/v1/traces/1838b691faa49564f97db8592ff3978d/events.json +78 -0
  91. data/gems/e11y-devtools/frontend/public/mocks/v1/traces/29f198f6588dacffb687777eb5f8f118/events.json +197 -0
  92. data/gems/e11y-devtools/frontend/public/mocks/v1/traces/34bc3c9c0097de28a7a6f99b90a8e7bc/events.json +194 -0
  93. data/gems/e11y-devtools/frontend/public/mocks/v1/traces/3ba6c20d068ab9cee00e51b180e66444/events.json +184 -0
  94. data/gems/e11y-devtools/frontend/public/mocks/v1/traces/435bfd8f17b9009146a79812d7c3726d/events.json +144 -0
  95. data/gems/e11y-devtools/frontend/public/mocks/v1/traces/4c7676e3fe668e99edb2b94d7d5678a9/events.json +222 -0
  96. data/gems/e11y-devtools/frontend/public/mocks/v1/traces/6daf0d47974bedfc55d5de7004a3ea9f/events.json +194 -0
  97. data/gems/e11y-devtools/frontend/public/mocks/v1/traces/8a81ada42834d15f287bb40010043605/events.json +194 -0
  98. data/gems/e11y-devtools/frontend/public/mocks/v1/traces/8c0a98900edaae105469df8daedccf02/events.json +198 -0
  99. data/gems/e11y-devtools/frontend/public/mocks/v1/traces/8e4f645180f8a7d1dce426b07380466b/events.json +222 -0
  100. data/gems/e11y-devtools/frontend/public/mocks/v1/traces/93db346fa5d44a032605a13b627f4b80/events.json +128 -0
  101. data/gems/e11y-devtools/frontend/public/mocks/v1/traces/98ff6146faf7bd9be8bd03a8275817ba/events.json +223 -0
  102. data/gems/e11y-devtools/frontend/public/mocks/v1/traces/9997ddd0247bc7e25f2ca7a5c415c93d/events.json +197 -0
  103. data/gems/e11y-devtools/frontend/public/mocks/v1/traces/99e35f8ef3baedd798cc4fd085980ad9/events.json +194 -0
  104. data/gems/e11y-devtools/frontend/public/mocks/v1/traces/b4f3095c1909924cbc98889a86c83d6d/events.json +131 -0
  105. data/gems/e11y-devtools/frontend/public/mocks/v1/traces/b54b7fc32b7575a7110de809d11ccda0/events.json +128 -0
  106. data/gems/e11y-devtools/frontend/public/mocks/v1/traces/c0b48033fa06746bcc5886745e053cff/events.json +169 -0
  107. data/gems/e11y-devtools/frontend/public/mocks/v1/traces/c44649ac76701b4558927cd2305ab535/events.json +169 -0
  108. data/gems/e11y-devtools/frontend/public/mocks/v1/traces/d601ae3320057580a39dbdac2edfdf4a/events.json +248 -0
  109. data/gems/e11y-devtools/frontend/public/mocks/v1/traces/e67e724bab422d2b52eeb49635e512e1/events.json +194 -0
  110. data/gems/e11y-devtools/frontend/public/mocks/v1/traces/e6c72765a28f158a8485b35fa63f73da/events.json +194 -0
  111. data/gems/e11y-devtools/frontend/public/mocks/v1/traces/f541b87405c9a54819b18ebe529f6419/events.json +194 -0
  112. data/gems/e11y-devtools/frontend/scripts/generate_mocks.rb +397 -0
  113. data/gems/e11y-devtools/frontend/src/App.svelte +827 -0
  114. data/gems/e11y-devtools/frontend/src/components/Fab.svelte +19 -0
  115. data/gems/e11y-devtools/frontend/src/components/FilterBar.svelte +38 -0
  116. data/gems/e11y-devtools/frontend/src/components/FullscreenPanel.svelte +82 -0
  117. data/gems/e11y-devtools/frontend/src/components/InteractionsTimeline.svelte +264 -0
  118. data/gems/e11y-devtools/frontend/src/components/RecentHistogram.svelte +354 -0
  119. data/gems/e11y-devtools/frontend/src/lib/api.ts +37 -0
  120. data/gems/e11y-devtools/frontend/src/lib/eventIdentity.ts +12 -0
  121. data/gems/e11y-devtools/frontend/src/lib/format.ts +37 -0
  122. data/gems/e11y-devtools/frontend/src/lib/listFilter.ts +43 -0
  123. data/gems/e11y-devtools/frontend/src/lib/recentVolume.ts +80 -0
  124. data/gems/e11y-devtools/frontend/src/lib/router.ts +12 -0
  125. data/gems/e11y-devtools/frontend/src/lib/transitions.ts +34 -0
  126. data/gems/e11y-devtools/frontend/src/lib/viewportOrigin.ts +25 -0
  127. data/gems/e11y-devtools/frontend/src/main.ts +8 -0
  128. data/gems/e11y-devtools/frontend/src/overlay-entry.ts +24 -0
  129. data/gems/e11y-devtools/frontend/src/overlay.css +1080 -0
  130. data/gems/e11y-devtools/frontend/svelte.config.js +2 -0
  131. data/gems/e11y-devtools/frontend/test_puppeteer.js +41 -0
  132. data/gems/e11y-devtools/frontend/test_scale.js +3 -0
  133. data/gems/e11y-devtools/frontend/tsconfig.app.json +21 -0
  134. data/gems/e11y-devtools/frontend/tsconfig.json +7 -0
  135. data/gems/e11y-devtools/frontend/tsconfig.node.json +26 -0
  136. data/gems/e11y-devtools/frontend/vite.config.ts +36 -0
  137. data/gems/e11y-devtools/lib/e11y/devtools/mcp/server.rb +96 -0
  138. data/gems/e11y-devtools/lib/e11y/devtools/mcp/tool_base.rb +25 -0
  139. data/gems/e11y-devtools/lib/e11y/devtools/mcp/tools/clear.rb +31 -0
  140. data/gems/e11y-devtools/lib/e11y/devtools/mcp/tools/errors.rb +35 -0
  141. data/gems/e11y-devtools/lib/e11y/devtools/mcp/tools/event_detail.rb +33 -0
  142. data/gems/e11y-devtools/lib/e11y/devtools/mcp/tools/events_by_trace.rb +33 -0
  143. data/gems/e11y-devtools/lib/e11y/devtools/mcp/tools/interactions.rb +40 -0
  144. data/gems/e11y-devtools/lib/e11y/devtools/mcp/tools/recent_events.rb +34 -0
  145. data/gems/e11y-devtools/lib/e11y/devtools/mcp/tools/search.rb +34 -0
  146. data/gems/e11y-devtools/lib/e11y/devtools/mcp/tools/stats.rb +30 -0
  147. data/gems/e11y-devtools/lib/e11y/devtools/overlay/assets/overlay.js +20 -0
  148. data/gems/e11y-devtools/lib/e11y/devtools/overlay/controller.rb +94 -0
  149. data/gems/e11y-devtools/lib/e11y/devtools/overlay/engine.rb +26 -0
  150. data/gems/e11y-devtools/lib/e11y/devtools/overlay/middleware.rb +80 -0
  151. data/gems/e11y-devtools/lib/e11y/devtools/overlay/rails_controller.rb +67 -0
  152. data/gems/e11y-devtools/lib/e11y/devtools/tui/app.rb +262 -0
  153. data/gems/e11y-devtools/lib/e11y/devtools/tui/grouping.rb +66 -0
  154. data/gems/e11y-devtools/lib/e11y/devtools/tui/widgets/event_detail.rb +62 -0
  155. data/gems/e11y-devtools/lib/e11y/devtools/tui/widgets/event_list.rb +70 -0
  156. data/gems/e11y-devtools/lib/e11y/devtools/tui/widgets/interaction_list.rb +47 -0
  157. data/gems/e11y-devtools/lib/e11y/devtools/version.rb +8 -0
  158. data/gems/e11y-devtools/lib/e11y/devtools.rb +13 -0
  159. data/gems/e11y-devtools/spec/e11y/devtools/mcp/tools_spec.rb +107 -0
  160. data/gems/e11y-devtools/spec/e11y/devtools/overlay/controller_spec.rb +91 -0
  161. data/gems/e11y-devtools/spec/e11y/devtools/overlay/middleware_spec.rb +46 -0
  162. data/gems/e11y-devtools/spec/e11y/devtools/tui/app_spec.rb +85 -0
  163. data/gems/e11y-devtools/spec/e11y/devtools/tui/grouping_spec.rb +64 -0
  164. data/gems/e11y-devtools/spec/spec_helper.rb +5 -0
  165. data/gems/e11y-devtools/spec/tui/widgets/event_list_spec.rb +44 -0
  166. data/gems/e11y-devtools/spec/tui/widgets/interaction_list_spec.rb +62 -0
  167. data/lib/e11y/adapters/audit_encrypted.rb +53 -11
  168. data/lib/e11y/adapters/base.rb +33 -34
  169. data/lib/e11y/adapters/dev_log/file_store.rb +143 -0
  170. data/lib/e11y/adapters/dev_log/query.rb +219 -0
  171. data/lib/e11y/adapters/dev_log.rb +118 -0
  172. data/lib/e11y/adapters/file.rb +3 -6
  173. data/lib/e11y/adapters/in_memory.rb +52 -5
  174. data/lib/e11y/adapters/in_memory_test.rb +29 -0
  175. data/lib/e11y/adapters/loki.rb +58 -23
  176. data/lib/e11y/adapters/null.rb +82 -0
  177. data/lib/e11y/adapters/opentelemetry_collector.rb +183 -0
  178. data/lib/e11y/adapters/otel_logs.rb +136 -23
  179. data/lib/e11y/adapters/sentry.rb +4 -7
  180. data/lib/e11y/adapters/stdout.rb +73 -7
  181. data/lib/e11y/adapters/yabeda.rb +153 -29
  182. data/lib/e11y/buffers/adaptive_buffer.rb +3 -17
  183. data/lib/e11y/buffers/{request_scoped_buffer.rb → ephemeral_buffer.rb} +72 -58
  184. data/lib/e11y/buffers/ring_buffer.rb +3 -16
  185. data/lib/e11y/configuration.rb +272 -0
  186. data/lib/e11y/console.rb +10 -17
  187. data/lib/e11y/current.rb +53 -1
  188. data/lib/e11y/debug/pipeline_inspector.rb +96 -0
  189. data/lib/e11y/documentation/generator.rb +48 -0
  190. data/lib/e11y/event/base.rb +176 -82
  191. data/lib/e11y/event/value_sampling_config.rb +1 -5
  192. data/lib/e11y/events/rails/database/query.rb +1 -4
  193. data/lib/e11y/events/rails/job/failed.rb +2 -0
  194. data/lib/e11y/instruments/active_job.rb +44 -12
  195. data/lib/e11y/instruments/rails_instrumentation.rb +49 -24
  196. data/lib/e11y/instruments/sidekiq.rb +135 -31
  197. data/lib/e11y/linters/base.rb +11 -0
  198. data/lib/e11y/linters/pii/pii_declaration_linter.rb +120 -0
  199. data/lib/e11y/linters/slo/config_consistency_linter.rb +76 -0
  200. data/lib/e11y/linters/slo/explicit_declaration_linter.rb +36 -0
  201. data/lib/e11y/linters/slo/slo_status_from_linter.rb +41 -0
  202. data/lib/e11y/logger/bridge.rb +26 -7
  203. data/lib/e11y/metrics/cardinality_protection.rb +10 -15
  204. data/lib/e11y/metrics/cardinality_tracker.rb +16 -6
  205. data/lib/e11y/metrics/registry.rb +3 -5
  206. data/lib/e11y/metrics/test_backend.rb +62 -0
  207. data/lib/e11y/metrics.rb +56 -10
  208. data/lib/e11y/middleware/adapter_resolver.rb +40 -0
  209. data/lib/e11y/middleware/audit_signing.rb +43 -6
  210. data/lib/e11y/middleware/baggage_protection.rb +75 -0
  211. data/lib/e11y/middleware/dev_log_source.rb +24 -0
  212. data/lib/e11y/middleware/event_slo.rb +23 -9
  213. data/lib/e11y/middleware/otel_span.rb +23 -0
  214. data/lib/e11y/middleware/pii_filter.rb +104 -75
  215. data/lib/e11y/middleware/rate_limiting.rb +54 -27
  216. data/lib/e11y/middleware/request.rb +70 -23
  217. data/lib/e11y/middleware/routing.rb +78 -21
  218. data/lib/e11y/middleware/sampling.rb +66 -17
  219. data/lib/e11y/middleware/self_monitoring_emit.rb +39 -0
  220. data/lib/e11y/middleware/trace_context.rb +45 -10
  221. data/lib/e11y/middleware/track_latency.rb +34 -0
  222. data/lib/e11y/middleware/validation.rb +7 -16
  223. data/lib/e11y/middleware/versioning.rb +26 -22
  224. data/lib/e11y/opentelemetry/semantic_conventions.rb +109 -0
  225. data/lib/e11y/opentelemetry/span_creator.rb +142 -0
  226. data/lib/e11y/pii/patterns.rb +12 -1
  227. data/lib/e11y/pipeline/builder.rb +4 -4
  228. data/lib/e11y/presets/audit_event.rb +13 -2
  229. data/lib/e11y/railtie.rb +52 -14
  230. data/lib/e11y/registry.rb +306 -0
  231. data/lib/e11y/reliability/circuit_breaker.rb +19 -21
  232. data/lib/e11y/reliability/dlq/base.rb +71 -0
  233. data/lib/e11y/reliability/dlq/file_adapter.rb +301 -0
  234. data/lib/e11y/reliability/dlq/file_storage.rb +63 -34
  235. data/lib/e11y/reliability/dlq/filter.rb +37 -54
  236. data/lib/e11y/reliability/retry_handler.rb +26 -29
  237. data/lib/e11y/reliability/retry_rate_limiter.rb +3 -11
  238. data/lib/e11y/sampling/error_spike_detector.rb +0 -2
  239. data/lib/e11y/sampling/load_monitor.rb +5 -9
  240. data/lib/e11y/sampling/stratified_tracker.rb +18 -0
  241. data/lib/e11y/self_monitoring/buffer_monitor.rb +2 -0
  242. data/lib/e11y/self_monitoring/performance_monitor.rb +19 -61
  243. data/lib/e11y/self_monitoring/reliability_monitor.rb +4 -74
  244. data/lib/e11y/slo/config_loader.rb +40 -0
  245. data/lib/e11y/slo/config_validator.rb +58 -0
  246. data/lib/e11y/slo/dashboard_generator.rb +122 -0
  247. data/lib/e11y/slo/event_driven.rb +8 -0
  248. data/lib/e11y/slo/tracker.rb +31 -4
  249. data/lib/e11y/testing/have_tracked_event_matcher.rb +190 -0
  250. data/lib/e11y/testing/rspec_matchers.rb +21 -0
  251. data/lib/e11y/testing/snapshot_matcher.rb +86 -0
  252. data/lib/e11y/trace_context/sampler.rb +35 -0
  253. data/lib/e11y/tracing/faraday_middleware.rb +31 -0
  254. data/lib/e11y/tracing/net_http_patch.rb +33 -0
  255. data/lib/e11y/tracing/propagator.rb +144 -0
  256. data/lib/e11y/tracing.rb +47 -0
  257. data/lib/e11y/version.rb +1 -1
  258. data/lib/e11y/versioning/version_extractor.rb +32 -0
  259. data/lib/e11y.rb +123 -266
  260. data/lib/generators/e11y/event/event_generator.rb +22 -0
  261. data/lib/generators/e11y/event/templates/event.rb.tt +16 -0
  262. data/lib/generators/e11y/grafana_dashboard/grafana_dashboard_generator.rb +30 -0
  263. data/lib/generators/e11y/grafana_dashboard/templates/e11y_dashboard.json +81 -0
  264. data/lib/generators/e11y/install/install_generator.rb +34 -0
  265. data/lib/generators/e11y/install/templates/e11y.rb +239 -0
  266. data/lib/generators/e11y/prometheus_alerts/prometheus_alerts_generator.rb +29 -0
  267. data/lib/generators/e11y/prometheus_alerts/templates/e11y_alerts.yml +28 -0
  268. data/lib/tasks/e11y_docs.rake +30 -0
  269. data/lib/tasks/e11y_events.rake +71 -0
  270. data/lib/tasks/e11y_lint.rake +91 -0
  271. data/lib/tasks/e11y_slo.rake +29 -0
  272. metadata +186 -39
  273. data/docs/ADR-003-slo-observability.md +0 -3337
  274. data/docs/ADR-010-developer-experience.md +0 -2166
  275. data/docs/API-REFERENCE-L28.md +0 -914
  276. data/docs/COMPREHENSIVE-CONFIGURATION.md +0 -2366
  277. data/docs/CONTRIBUTING.md +0 -312
  278. data/docs/IMPLEMENTATION_NOTES.md +0 -2804
  279. data/docs/IMPLEMENTATION_PLAN.md +0 -1971
  280. data/docs/IMPLEMENTATION_PLAN_ARCHITECTURE.md +0 -586
  281. data/docs/PLAN.md +0 -148
  282. data/docs/README.md +0 -296
  283. data/docs/design/00-memory-optimization.md +0 -593
  284. data/docs/guides/MIGRATION-L27-L28.md +0 -692
  285. data/docs/guides/PERFORMANCE-BENCHMARKS.md +0 -434
  286. data/docs/guides/README.md +0 -44
  287. data/docs/use_cases/UC-003-pattern-based-metrics.md +0 -1627
  288. data/lib/e11y/adapters/registry.rb +0 -141
data/gems/e11y-devtools/frontend/public/mocks/v1/traces/c44649ac76701b4558927cd2305ab535/events.json ADDED
@@ -0,0 +1,169 @@
1
+ [
2
+ {
3
+ "id": "b34aa692-4b2f-88cf-0482db381193",
4
+ "timestamp": "2026-03-20T09:47:17.058Z",
5
+ "event_name": "Events::LogInfo",
6
+ "severity": "info",
7
+ "version": 1,
8
+ "trace_id": "c44649ac76701b4558927cd2305ab535",
9
+ "span_id": "e3181897678dd835",
10
+ "service_name": "dummy",
11
+ "environment": "development",
12
+ "retention_until": "2027-03-20T09:47:17Z",
13
+ "payload": {
14
+ "message": "Started GET \"/sidekiq/busy\" for ::1 at 2026-03-20 09:47:17 +0000",
15
+ "level": "info"
16
+ },
17
+ "metadata": {
18
+ "source": "web",
19
+ "started_at": "2026-03-20T09:47:17.046Z",
20
+ "request_id": "req-c44649ac-4",
21
+ "path": "/sidekiq/busy",
22
+ "method": "GET",
23
+ "controller": "Webhooks::StripeController",
24
+ "action": "create",
25
+ "duration_ms": 3
26
+ }
27
+ },
28
+ {
29
+ "id": "29607fc7-45a3-a5a5-d0679b3eef53",
30
+ "timestamp": "2026-03-20T09:47:17.072Z",
31
+ "event_name": "Events::ApiRequest",
32
+ "severity": "info",
33
+ "version": 1,
34
+ "trace_id": "c44649ac76701b4558927cd2305ab535",
35
+ "span_id": "94a7e0fd025abce2",
36
+ "service_name": "dummy",
37
+ "environment": "development",
38
+ "retention_until": "2027-03-20T09:47:17Z",
39
+ "payload": {
40
+ "endpoint": "GET /sidekiq/busy",
41
+ "status": "ok",
42
+ "http_status": 200
43
+ },
44
+ "metadata": {
45
+ "source": "web",
46
+ "started_at": "2026-03-20T09:47:17.046Z",
47
+ "request_id": "req-c44649ac-4",
48
+ "path": "/sidekiq/busy",
49
+ "method": "GET",
50
+ "controller": "Webhooks::StripeController",
51
+ "action": "create",
52
+ "duration_ms": 112
53
+ }
54
+ },
55
+ {
56
+ "id": "014bb75c-4b91-b77f-536d8c79d151",
57
+ "timestamp": "2026-03-20T09:47:17.086Z",
58
+ "event_name": "Events::PostDebug",
59
+ "severity": "debug",
60
+ "version": 1,
61
+ "trace_id": "c44649ac76701b4558927cd2305ab535",
62
+ "span_id": "7c512ec1b1200b35",
63
+ "service_name": "dummy",
64
+ "environment": "development",
65
+ "retention_until": "2027-03-20T09:47:17Z",
66
+ "payload": {
67
+ "message": " → Render /sidekiq/busy — 16.8ms"
68
+ },
69
+ "metadata": {
70
+ "source": "web",
71
+ "started_at": "2026-03-20T09:47:17.046Z",
72
+ "request_id": "req-c44649ac-4",
73
+ "path": "/sidekiq/busy",
74
+ "method": "GET",
75
+ "controller": "Webhooks::StripeController",
76
+ "action": "create",
77
+ "duration_ms": 4
78
+ }
79
+ },
80
+ {
81
+ "id": "2dc7532f-4f93-a5f7-577fbe81f587",
82
+ "timestamp": "2026-03-20T09:47:17.099Z",
83
+ "event_name": "Events::PostDebug",
84
+ "severity": "debug",
85
+ "version": 1,
86
+ "trace_id": "c44649ac76701b4558927cd2305ab535",
87
+ "span_id": "d966b486b88f84c2",
88
+ "service_name": "dummy",
89
+ "environment": "development",
90
+ "retention_until": "2027-03-20T09:47:17Z",
91
+ "payload": {
92
+ "message": " → CACHE — /sidekiq/busy id=4736"
93
+ },
94
+ "metadata": {
95
+ "source": "web",
96
+ "started_at": "2026-03-20T09:47:17.046Z",
97
+ "request_id": "req-c44649ac-4",
98
+ "path": "/sidekiq/busy",
99
+ "method": "GET",
100
+ "controller": "Webhooks::StripeController",
101
+ "action": "create",
102
+ "duration_ms": 1
103
+ }
104
+ },
105
+ {
106
+ "id": "5e229f72-41d5-8d76-44153e761aed",
107
+ "timestamp": "2026-03-20T09:47:17.110Z",
108
+ "event_name": "Events::OrderCreated",
109
+ "severity": "success",
110
+ "version": 1,
111
+ "trace_id": "c44649ac76701b4558927cd2305ab535",
112
+ "span_id": "9701c69df9173825",
113
+ "service_name": "dummy",
114
+ "environment": "development",
115
+ "retention_until": "2027-03-20T09:47:17Z",
116
+ "payload": {
117
+ "order_id": "ord_698377",
118
+ "status": "completed",
119
+ "customer": {
120
+ "id": 3437,
121
+ "email": "[FILTERED]",
122
+ "locale": "en"
123
+ },
124
+ "items": [
125
+ {
126
+ "sku": "SKU-662",
127
+ "qty": 1,
128
+ "unit_price": 445.67
129
+ }
130
+ ]
131
+ },
132
+ "metadata": {
133
+ "source": "web",
134
+ "started_at": "2026-03-20T09:47:17.046Z",
135
+ "request_id": "req-c44649ac-4",
136
+ "path": "/sidekiq/busy",
137
+ "method": "GET",
138
+ "controller": "Webhooks::StripeController",
139
+ "action": "create",
140
+ "duration_ms": 27
141
+ }
142
+ },
143
+ {
144
+ "id": "ab3e9b6e-43bf-95e0-71c43aed6bfb",
145
+ "timestamp": "2026-03-20T09:47:17.123Z",
146
+ "event_name": "Events::LogInfo",
147
+ "severity": "info",
148
+ "version": 1,
149
+ "trace_id": "c44649ac76701b4558927cd2305ab535",
150
+ "span_id": "b8f29f3c7fcb232f",
151
+ "service_name": "dummy",
152
+ "environment": "development",
153
+ "retention_until": "2027-03-20T09:47:17Z",
154
+ "payload": {
155
+ "message": "Completed GET /sidekiq/busy in 670ms",
156
+ "level": "info"
157
+ },
158
+ "metadata": {
159
+ "source": "web",
160
+ "started_at": "2026-03-20T09:47:17.046Z",
161
+ "request_id": "req-c44649ac-4",
162
+ "path": "/sidekiq/busy",
163
+ "method": "GET",
164
+ "controller": "Webhooks::StripeController",
165
+ "action": "create",
166
+ "duration_ms": 11
167
+ }
168
+ }
169
+ ]
data/gems/e11y-devtools/frontend/public/mocks/v1/traces/d601ae3320057580a39dbdac2edfdf4a/events.json ADDED
@@ -0,0 +1,248 @@
1
+ [
2
+ {
3
+ "id": "098fa6b3-42a9-b345-cf0e5c357435",
4
+ "timestamp": "2026-03-20T09:47:20.120Z",
5
+ "event_name": "Events::LogInfo",
6
+ "severity": "info",
7
+ "version": 1,
8
+ "trace_id": "d601ae3320057580a39dbdac2edfdf4a",
9
+ "span_id": "897e3bea208709bb",
10
+ "service_name": "dummy",
11
+ "environment": "development",
12
+ "retention_until": "2027-03-20T09:47:20Z",
13
+ "payload": {
14
+ "message": "Started GET \"/api/v1/orders\" for ::1 at 2026-03-20 09:47:20 +0000",
15
+ "level": "info"
16
+ },
17
+ "metadata": {
18
+ "source": "web",
19
+ "started_at": "2026-03-20T09:47:20.109Z",
20
+ "request_id": "req-d601ae33-6",
21
+ "path": "/api/v1/orders",
22
+ "method": "GET",
23
+ "controller": "OrdersController",
24
+ "action": "index",
25
+ "duration_ms": 0
26
+ }
27
+ },
28
+ {
29
+ "id": "f71abe6b-4004-9466-54c3d78ed305",
30
+ "timestamp": "2026-03-20T09:47:20.135Z",
31
+ "event_name": "Events::ApiRequest",
32
+ "severity": "info",
33
+ "version": 1,
34
+ "trace_id": "d601ae3320057580a39dbdac2edfdf4a",
35
+ "span_id": "0d3b036c31c2e3df",
36
+ "service_name": "dummy",
37
+ "environment": "development",
38
+ "retention_until": "2027-03-20T09:47:20Z",
39
+ "payload": {
40
+ "endpoint": "GET /api/v1/orders",
41
+ "status": "ok",
42
+ "http_status": 200
43
+ },
44
+ "metadata": {
45
+ "source": "web",
46
+ "started_at": "2026-03-20T09:47:20.109Z",
47
+ "request_id": "req-d601ae33-6",
48
+ "path": "/api/v1/orders",
49
+ "method": "GET",
50
+ "controller": "OrdersController",
51
+ "action": "index",
52
+ "duration_ms": 116
53
+ }
54
+ },
55
+ {
56
+ "id": "236b1ba7-4f33-9a8f-710cf8339171",
57
+ "timestamp": "2026-03-20T09:47:20.149Z",
58
+ "event_name": "Events::PostDebug",
59
+ "severity": "debug",
60
+ "version": 1,
61
+ "trace_id": "d601ae3320057580a39dbdac2edfdf4a",
62
+ "span_id": "842c427bb6efb469",
63
+ "service_name": "dummy",
64
+ "environment": "development",
65
+ "retention_until": "2027-03-20T09:47:20Z",
66
+ "payload": {
67
+ "message": " → SQL /api/v1/orders — 19.0ms"
68
+ },
69
+ "metadata": {
70
+ "source": "web",
71
+ "started_at": "2026-03-20T09:47:20.109Z",
72
+ "request_id": "req-d601ae33-6",
73
+ "path": "/api/v1/orders",
74
+ "method": "GET",
75
+ "controller": "OrdersController",
76
+ "action": "index",
77
+ "duration_ms": 8
78
+ }
79
+ },
80
+ {
81
+ "id": "1415b7b6-4559-a2e4-7dd9f6702074",
82
+ "timestamp": "2026-03-20T09:47:20.161Z",
83
+ "event_name": "Events::PostDebug",
84
+ "severity": "debug",
85
+ "version": 1,
86
+ "trace_id": "d601ae3320057580a39dbdac2edfdf4a",
87
+ "span_id": "14b4173dd602cb16",
88
+ "service_name": "dummy",
89
+ "environment": "development",
90
+ "retention_until": "2027-03-20T09:47:20Z",
91
+ "payload": {
92
+ "message": " → Render — /api/v1/orders id=23945"
93
+ },
94
+ "metadata": {
95
+ "source": "web",
96
+ "started_at": "2026-03-20T09:47:20.109Z",
97
+ "request_id": "req-d601ae33-6",
98
+ "path": "/api/v1/orders",
99
+ "method": "GET",
100
+ "controller": "OrdersController",
101
+ "action": "index",
102
+ "duration_ms": 12
103
+ }
104
+ },
105
+ {
106
+ "id": "ea4b7279-4200-beee-eb213d62b45f",
107
+ "timestamp": "2026-03-20T09:47:20.172Z",
108
+ "event_name": "Events::PostDebug",
109
+ "severity": "debug",
110
+ "version": 1,
111
+ "trace_id": "d601ae3320057580a39dbdac2edfdf4a",
112
+ "span_id": "8c9a1e7d18081475",
113
+ "service_name": "dummy",
114
+ "environment": "development",
115
+ "retention_until": "2027-03-20T09:47:20Z",
116
+ "payload": {
117
+ "message": " → N+1 — /api/v1/orders id=20057"
118
+ },
119
+ "metadata": {
120
+ "source": "web",
121
+ "started_at": "2026-03-20T09:47:20.109Z",
122
+ "request_id": "req-d601ae33-6",
123
+ "path": "/api/v1/orders",
124
+ "method": "GET",
125
+ "controller": "OrdersController",
126
+ "action": "index",
127
+ "duration_ms": 8
128
+ }
129
+ },
130
+ {
131
+ "id": "f4720d0f-44bc-8fe6-72bf8dea25be",
132
+ "timestamp": "2026-03-20T09:47:20.184Z",
133
+ "event_name": "Events::PostDebug",
134
+ "severity": "debug",
135
+ "version": 1,
136
+ "trace_id": "d601ae3320057580a39dbdac2edfdf4a",
137
+ "span_id": "6f8842449c99bb15",
138
+ "service_name": "dummy",
139
+ "environment": "development",
140
+ "retention_until": "2027-03-20T09:47:20Z",
141
+ "payload": {
142
+ "message": " → CACHE — /api/v1/orders id=8131"
143
+ },
144
+ "metadata": {
145
+ "source": "web",
146
+ "started_at": "2026-03-20T09:47:20.109Z",
147
+ "request_id": "req-d601ae33-6",
148
+ "path": "/api/v1/orders",
149
+ "method": "GET",
150
+ "controller": "OrdersController",
151
+ "action": "index",
152
+ "duration_ms": 12
153
+ }
154
+ },
155
+ {
156
+ "id": "c20233e4-4c55-8ab8-6d1c1db6efcd",
157
+ "timestamp": "2026-03-20T09:47:20.196Z",
158
+ "event_name": "Events::OrderCreated",
159
+ "severity": "success",
160
+ "version": 1,
161
+ "trace_id": "d601ae3320057580a39dbdac2edfdf4a",
162
+ "span_id": "178024db0bc6d444",
163
+ "service_name": "dummy",
164
+ "environment": "development",
165
+ "retention_until": "2027-03-20T09:47:20Z",
166
+ "payload": {
167
+ "order_id": "ord_227898",
168
+ "status": "cancelled",
169
+ "customer": {
170
+ "id": 2142,
171
+ "email": "[FILTERED]",
172
+ "locale": "en"
173
+ },
174
+ "items": [
175
+ {
176
+ "sku": "SKU-849",
177
+ "qty": 1,
178
+ "unit_price": 488.88
179
+ }
180
+ ]
181
+ },
182
+ "metadata": {
183
+ "source": "web",
184
+ "started_at": "2026-03-20T09:47:20.109Z",
185
+ "request_id": "req-d601ae33-6",
186
+ "path": "/api/v1/orders",
187
+ "method": "GET",
188
+ "controller": "OrdersController",
189
+ "action": "index",
190
+ "duration_ms": 69
191
+ }
192
+ },
193
+ {
194
+ "id": "79357226-4663-b520-dcfd6f10e6dd",
195
+ "timestamp": "2026-03-20T09:47:20.209Z",
196
+ "event_name": "Events::UserAction",
197
+ "severity": "warn",
198
+ "version": 1,
199
+ "trace_id": "d601ae3320057580a39dbdac2edfdf4a",
200
+ "span_id": "a657916466046816",
201
+ "service_name": "dummy",
202
+ "environment": "development",
203
+ "retention_until": "2027-03-20T09:47:20Z",
204
+ "payload": {
205
+ "action": "checkout_step",
206
+ "step": "review",
207
+ "flags": [
208
+ "rate_limit_near"
209
+ ]
210
+ },
211
+ "metadata": {
212
+ "source": "web",
213
+ "started_at": "2026-03-20T09:47:20.109Z",
214
+ "request_id": "req-d601ae33-6",
215
+ "path": "/api/v1/orders",
216
+ "method": "GET",
217
+ "controller": "OrdersController",
218
+ "action": "index",
219
+ "duration_ms": 10
220
+ }
221
+ },
222
+ {
223
+ "id": "e2fd7c63-4b21-acb3-9cde03eaff89",
224
+ "timestamp": "2026-03-20T09:47:20.224Z",
225
+ "event_name": "Events::LogInfo",
226
+ "severity": "info",
227
+ "version": 1,
228
+ "trace_id": "d601ae3320057580a39dbdac2edfdf4a",
229
+ "span_id": "a0385af9eef5ae92",
230
+ "service_name": "dummy",
231
+ "environment": "development",
232
+ "retention_until": "2027-03-20T09:47:20Z",
233
+ "payload": {
234
+ "message": "Completed GET /api/v1/orders in 453ms",
235
+ "level": "info"
236
+ },
237
+ "metadata": {
238
+ "source": "web",
239
+ "started_at": "2026-03-20T09:47:20.109Z",
240
+ "request_id": "req-d601ae33-6",
241
+ "path": "/api/v1/orders",
242
+ "method": "GET",
243
+ "controller": "OrdersController",
244
+ "action": "index",
245
+ "duration_ms": 103
246
+ }
247
+ }
248
+ ]
data/gems/e11y-devtools/frontend/public/mocks/v1/traces/e67e724bab422d2b52eeb49635e512e1/events.json ADDED
@@ -0,0 +1,194 @@
1
+ [
2
+ {
3
+ "id": "0e04dbc8-4534-bc88-e0c9cd87cdb3",
4
+ "timestamp": "2026-03-20T09:47:34.820Z",
5
+ "event_name": "Events::LogInfo",
6
+ "severity": "info",
7
+ "version": 1,
8
+ "trace_id": "e67e724bab422d2b52eeb49635e512e1",
9
+ "span_id": "c9ac9938012f9074",
10
+ "service_name": "dummy",
11
+ "environment": "development",
12
+ "retention_until": "2027-03-20T09:47:34Z",
13
+ "payload": {
14
+ "message": "Started GET \"/orders\" for ::1 at 2026-03-20 09:47:34 +0000",
15
+ "level": "info"
16
+ },
17
+ "metadata": {
18
+ "source": "web",
19
+ "started_at": "2026-03-20T09:47:34.807Z",
20
+ "request_id": "req-e67e724b-17",
21
+ "path": "/orders",
22
+ "method": "GET",
23
+ "controller": "GraphqlController",
24
+ "action": "execute",
25
+ "duration_ms": 1
26
+ }
27
+ },
28
+ {
29
+ "id": "dd0f8659-484a-9f25-218177381f86",
30
+ "timestamp": "2026-03-20T09:47:34.831Z",
31
+ "event_name": "Events::ApiRequest",
32
+ "severity": "info",
33
+ "version": 1,
34
+ "trace_id": "e67e724bab422d2b52eeb49635e512e1",
35
+ "span_id": "58d1ecd17b1821da",
36
+ "service_name": "dummy",
37
+ "environment": "development",
38
+ "retention_until": "2027-03-20T09:47:34Z",
39
+ "payload": {
40
+ "endpoint": "GET /orders",
41
+ "status": "ok",
42
+ "http_status": 200
43
+ },
44
+ "metadata": {
45
+ "source": "web",
46
+ "started_at": "2026-03-20T09:47:34.807Z",
47
+ "request_id": "req-e67e724b-17",
48
+ "path": "/orders",
49
+ "method": "GET",
50
+ "controller": "GraphqlController",
51
+ "action": "execute",
52
+ "duration_ms": 34
53
+ }
54
+ },
55
+ {
56
+ "id": "e9a9f2fa-44b2-84b5-b29793dfb018",
57
+ "timestamp": "2026-03-20T09:47:34.841Z",
58
+ "event_name": "Events::PostDebug",
59
+ "severity": "debug",
60
+ "version": 1,
61
+ "trace_id": "e67e724bab422d2b52eeb49635e512e1",
62
+ "span_id": "7f9507c62a5f14b3",
63
+ "service_name": "dummy",
64
+ "environment": "development",
65
+ "retention_until": "2027-03-20T09:47:34Z",
66
+ "payload": {
67
+ "message": " → SQL — /orders id=19957"
68
+ },
69
+ "metadata": {
70
+ "source": "web",
71
+ "started_at": "2026-03-20T09:47:34.807Z",
72
+ "request_id": "req-e67e724b-17",
73
+ "path": "/orders",
74
+ "method": "GET",
75
+ "controller": "GraphqlController",
76
+ "action": "execute",
77
+ "duration_ms": 24
78
+ }
79
+ },
80
+ {
81
+ "id": "94a1703e-43ea-9295-4a99035a289b",
82
+ "timestamp": "2026-03-20T09:47:34.853Z",
83
+ "event_name": "Events::PostDebug",
84
+ "severity": "debug",
85
+ "version": 1,
86
+ "trace_id": "e67e724bab422d2b52eeb49635e512e1",
87
+ "span_id": "36723f71a9dd95d4",
88
+ "service_name": "dummy",
89
+ "environment": "development",
90
+ "retention_until": "2027-03-20T09:47:34Z",
91
+ "payload": {
92
+ "message": " → CACHE — /orders id=4945"
93
+ },
94
+ "metadata": {
95
+ "source": "web",
96
+ "started_at": "2026-03-20T09:47:34.807Z",
97
+ "request_id": "req-e67e724b-17",
98
+ "path": "/orders",
99
+ "method": "GET",
100
+ "controller": "GraphqlController",
101
+ "action": "execute",
102
+ "duration_ms": 20
103
+ }
104
+ },
105
+ {
106
+ "id": "6a24ce75-4155-b9db-543eff3326bc",
107
+ "timestamp": "2026-03-20T09:47:34.864Z",
108
+ "event_name": "Events::PostDebug",
109
+ "severity": "debug",
110
+ "version": 1,
111
+ "trace_id": "e67e724bab422d2b52eeb49635e512e1",
112
+ "span_id": "2f38f567808fda30",
113
+ "service_name": "dummy",
114
+ "environment": "development",
115
+ "retention_until": "2027-03-20T09:47:34Z",
116
+ "payload": {
117
+ "message": " → Render — /orders id=9985"
118
+ },
119
+ "metadata": {
120
+ "source": "web",
121
+ "started_at": "2026-03-20T09:47:34.807Z",
122
+ "request_id": "req-e67e724b-17",
123
+ "path": "/orders",
124
+ "method": "GET",
125
+ "controller": "GraphqlController",
126
+ "action": "execute",
127
+ "duration_ms": 13
128
+ }
129
+ },
130
+ {
131
+ "id": "35bc5f7a-43b7-a2d2-6d3d3484081f",
132
+ "timestamp": "2026-03-20T09:47:34.878Z",
133
+ "event_name": "Events::OrderCreated",
134
+ "severity": "success",
135
+ "version": 1,
136
+ "trace_id": "e67e724bab422d2b52eeb49635e512e1",
137
+ "span_id": "77de0a9d30d0e91c",
138
+ "service_name": "dummy",
139
+ "environment": "development",
140
+ "retention_until": "2027-03-20T09:47:34Z",
141
+ "payload": {
142
+ "order_id": "ord_980879",
143
+ "status": "pending_payment",
144
+ "customer": {
145
+ "id": 4525,
146
+ "email": "[FILTERED]",
147
+ "locale": "en"
148
+ },
149
+ "items": [
150
+ {
151
+ "sku": "SKU-576",
152
+ "qty": 1,
153
+ "unit_price": 238.2
154
+ }
155
+ ]
156
+ },
157
+ "metadata": {
158
+ "source": "web",
159
+ "started_at": "2026-03-20T09:47:34.807Z",
160
+ "request_id": "req-e67e724b-17",
161
+ "path": "/orders",
162
+ "method": "GET",
163
+ "controller": "GraphqlController",
164
+ "action": "execute",
165
+ "duration_ms": 40
166
+ }
167
+ },
168
+ {
169
+ "id": "8713ebf1-40c1-99f5-d3db7b289470",
170
+ "timestamp": "2026-03-20T09:47:34.893Z",
171
+ "event_name": "Events::LogInfo",
172
+ "severity": "info",
173
+ "version": 1,
174
+ "trace_id": "e67e724bab422d2b52eeb49635e512e1",
175
+ "span_id": "669868717f3c2cdd",
176
+ "service_name": "dummy",
177
+ "environment": "development",
178
+ "retention_until": "2027-03-20T09:47:34Z",
179
+ "payload": {
180
+ "message": "Completed GET /orders in 689ms",
181
+ "level": "info"
182
+ },
183
+ "metadata": {
184
+ "source": "web",
185
+ "started_at": "2026-03-20T09:47:34.807Z",
186
+ "request_id": "req-e67e724b-17",
187
+ "path": "/orders",
188
+ "method": "GET",
189
+ "controller": "GraphqlController",
190
+ "action": "execute",
191
+ "duration_ms": 186
192
+ }
193
+ }
194
+ ]