Logs

QNSI services emit structured logs for debugging and analysis.

Log format

JSON structured logs:

{
	"timestamp": "2024-01-15T10:30:00.000Z",
	"level": "info",
	"service": "kms-service",
	"message": "Key created",
	"traceId": "abc123",
	"spanId": "def456",
	"tenantId": "tenant-uuid",
	"requestId": "request-uuid",
	"attributes": {
		"keyId": "key-uuid",
		"algorithm": "aes-256-gcm"
	}
}

Log levels

Level	Description
error	Errors requiring attention
warn	Warnings, potential issues
info	Normal operations
debug	Detailed debugging
trace	Very detailed tracing

Log categories

Request logs

Every request logged with:

• Method, path, status
• Duration
• Request/response size
• Client info

Security logs

Security-relevant events:

• Authentication attempts
• Authorization decisions
• Policy evaluations

Operational logs

System operations:

• Service startup/shutdown
• Configuration changes
• Health check results

Log access

Log query APIs are not shipped in this repo.

Export

Configure log export to external systems:

• CloudWatch Logs
• Datadog
• Elastic
• Splunk