Operations

1. Overview

This module documents system-health operations for the Event and Membership Administration System in production environments — keeping the system itself running. It covers API-based management access, cache eviction, observability, and outbound email configuration, none of which require application restarts.

This module focuses on keeping the system healthy. For producing business outcomes through the system (running imports, processing the number/tag lifecycle, generating reports) see the Operational Procedures module. For exceptional one-off recovery see Runbooks. For deployment and infrastructure see Deployment.

2. Management API

  • Management API Access - Authenticate and access Spring Boot Actuator endpoints using API keys for log level management, health checks, and configuration inspection.

3. Cache Management

  • Cache Management - Understand the caching architecture (Spring + Hibernate L2 + Hazelcast) and evict caches cluster-wide without restarting pods.

4. Email

  • SMTP Configuration - Outbound email setup for EMS services: production Exchange Online connector, dev GreenMail, shared spring.mail.* config surface, multi-tenant From-address considerations.

5. Observability

  • OpenTelemetry Configuration - OTel javaagent + SDK configuration for admin-service, collector topology, trace/metric/log correlation, sampling strategy, and the known gap of OTel not yet enabled on registration-portal.

Operator guides for running imports, the number/tag lifecycle, and reporting moved to the Operational Procedures module — they produce business outcomes rather than keeping the system healthy.