Provisioning Audit Trail
The ProvisioningAuditController at /api/v1/audit/provisioning provides comprehensive audit logging for all provisioning operations, supporting compliance reporting, troubleshooting, and forensic analysis.
Endpoints
| Method | Path | Description |
|---|---|---|
GET | /audit/provisioning/tenant/{tenantId} | Get audit logs for a tenant (paginated) |
GET | /audit/provisioning/correlation/{id} | Get logs by correlation ID |
GET | /audit/provisioning/failures | Get recent failures |
GET | /audit/provisioning/security | Get security audit logs |
GET | /audit/provisioning/action/{action} | Filter by action type |
GET | /audit/provisioning/category/{category} | Filter by category |
GET | /audit/provisioning/actor/{actorId} | Filter by actor |
GET | /audit/provisioning/search | Full-text search |
GET | /audit/provisioning/statistics | Aggregated statistics |
GET | /audit/provisioning/{id} | Get specific log entry |
Example: Get Tenant Audit Logs
curl "http://localhost:8082/api/v1/audit/provisioning/tenant/{tenantId}?page=0&size=50&sortBy=timestamp&sortDir=desc" \
-H "Authorization: Bearer $TOKEN"Audit Statistics
The /statistics endpoint returns aggregated metrics for a configurable time window:
curl "http://localhost:8082/api/v1/audit/provisioning/statistics?hours=24" \
-H "Authorization: Bearer $TOKEN"{
"periodHours": 24,
"startTime": "2026-02-11T10:30:00Z",
"endTime": "2026-02-12T10:30:00Z",
"totalEvents": 1250,
"totalFailures": 3,
"actionCounts": {
"PROVISIONING_STARTED": 5,
"STEP_COMPLETED": 280,
"STEP_FAILED": 3,
"PROVISIONING_COMPLETED": 4
},
"topErrorCodes": {
"HELM_TIMEOUT": 2,
"DNS_ZONE_CREATE_FAILED": 1
}
}Source Files
| File | Path |
|---|---|
| Controller | control-plane/tenant-service/src/main/java/com/matih/tenant/controller/ProvisioningAuditController.java |
| Service | control-plane/tenant-service/src/main/java/com/matih/tenant/audit/ProvisioningAuditService.java |
| Entity | control-plane/tenant-service/src/main/java/com/matih/tenant/audit/ProvisioningAuditLog.java |