Skip to main content

Audit logs Enterprise

Track and review all user activity in your workspaces with comprehensive audit logging.

What's logged​

CategoryEvents
AuthenticationLogin, logout, failed attempts
DocumentsUpload, edit, delete
SearchQueries, results viewed
TeamInvitations, role changes
SettingsConfiguration changes
APIKey creation, usage

Viewing audit logs​

  1. Go to Settings > Security > Audit Logs
  2. Use filters to narrow results:
    • Date range
    • User
    • Action type
    • Resource

Log entry format​

Each entry includes:

FieldDescription
TimestampWhen the action occurred (UTC)
ActorUser who performed action
ActionWhat was done
ResourceAffected resource
IP AddressOrigin IP address
DetailsAdditional context

Example entries​

Document uploaded​

{
  "timestamp": "2025-01-01T12:00:00Z",
  "actor": "user@example.com",
  "action": "document.upload",
  "resource": "doc_abc123",
  "ip": "192.168.1.100",
  "details": {
    "title": "Annual Report",
    "size": 1234567,
    "format": "pdf"
  }
}

Role changed​

{
  "timestamp": "2025-01-01T12:00:00Z",
  "actor": "admin@example.com",
  "action": "member.role_changed",
  "resource": "user_xyz789",
  "ip": "192.168.1.100",
  "details": {
    "previousRole": "member",
    "newRole": "admin"
  }
}

Exporting logs​

Via UI​

  1. Click Export in Audit Logs view
  2. Choose format (CSV, JSON)
  3. Select date range
  4. Download file

Via API​

curl -X GET "https://api.synjar.com/v1/audit-logs" \
  -H "Authorization: Bearer $API_KEY" \
  -d "startDate=2025-01-01&endDate=2025-01-31"

Retention​

PlanRetention period
Enterprise1 year
Enterprise+3 years
CustomConfigurable

Logs are automatically deleted after the retention period.

Compliance​

Audit logs help with:

  • SOC 2 - Access control evidence
  • HIPAA - PHI access tracking
  • GDPR - Data access auditing
  • ISO 27001 - Security monitoring

Best practices​

  • Review logs weekly for anomalies
  • Set up alerts for sensitive actions
  • Export logs for long-term storage
  • Include in security incident response

See also​