Audit Logs
Overview
Audit logs provide a complete, immutable record of all activity within Peridot.
They are critical for governance, compliance, and incident investigation.
What Is Logged
Peridot captures:
User actions
Policy evaluations and enforcement
Data access and movement
Model usage and routing decisions
API interactions
Why Audit Logs Matter
Audit logs enable organizations to:
Reconstruct events during incidents
Demonstrate compliance with regulations
Verify policy enforcement
Analyze system behavior
How Logging Works
Every AI interaction generates a trace:
Request metadata is captured
Policies and decisions are recorded
Actions and outcomes are logged
Logs are stored and indexed
Example
For a single request, logs may include:
User identity
Input data classification
Model selected
Policy decisions
Enforcement actions
Final outcome
In Production
Logs are generated in real time
Data is stored securely and immutably
Logs can be queried and exported
Integration with SIEM systems is supported
Security and Compliance
Audit logs support:
SOC 2
ISO 27001
Internal compliance frameworks
Best Practices
Integrate logs with SIEM tools
Retain logs based on compliance requirements
Regularly review audit trails
Next Steps
Connect logs to your observability stack
Use logs in incident investigations