Payroll Observability
Summary
Payroll has JSON structured logging, correlation middleware, OpenTelemetry request tracing, lifecycle audit/timeline records, consumer logs, and persisted outbox status.
Audience
Backend and frontend developers, QA and DevOps engineers, support and security engineers, and solution architects.
Overview
Payroll has JSON structured logging, correlation middleware, OpenTelemetry request tracing, lifecycle audit/timeline records, consumer logs, and persisted outbox status.
Technical Detail
Runtime telemetry
Shared Kernel startup replaces default logging with structured JSON, scopes logs with service and correlation context, and instruments ASP.NET Core and outbound HTTP activity for OpenTelemetry tracing. Export is environment-configurable.
Business-technical evidence
Calculation and lifecycle operations create Payroll audit/timeline records. Output access and generation are audited. The read-model consumer records synchronization outcomes and logs connection/processing failures. Outbox records expose pending, failed, and processed state conceptually.
Gaps
No Payroll-specific metrics or meters are confirmed. Calculation duration, employee throughput, input lag, PDF/export failure counts, and notification outcome metrics are not implemented here. Automatic outbox-drain telemetry and dependency dashboards Require confirmation.
Source References
microservices/src/payroll-service/Program.csmicroservices/src/shared-kernel/Extensions/ObservabilityExtensions.csmicroservices/src/shared-kernel/Middleware/CorrelationIdMiddleware.csmicroservices/src/payroll-service/Messaging/PayrollReadModelConsumer.csmicroservices/src/payroll-service/Application/PayrollCalculationService.csmicroservices/src/payroll-service/Application/PayrollOutputsService.csmicroservices/src/payroll-service/Infrastructure/Persistence.cs
Related Articles
See Also
Keywords
- Payroll Service
- Payroll Observability
- Technical architecture
Revision Information
- Status: Draft
- Last reviewed: 2026-07-15
- Review cycle: Quarterly