Skip to main content

Documentation Index

Fetch the complete documentation index at: https://hypha-docs.plinqx.app/llms.txt

Use this file to discover all available pages before exploring further.

Audit logs provide a complete record of all actions in Plinqx. Track tool executions, configuration changes, approvals, and more.

What’s Logged

Plinqx logs:
  • Tool Executions: Every tool call with parameters and results
  • Configuration Changes: Who created, updated, or deleted resources
  • Approval Decisions: Who approved or rejected requests
  • Authentication Events: API key usage, login attempts
  • Policy Evaluations: Policy decisions and rule matches
  • Principal Actions: All actions attributed to principals

Viewing Audit Logs

1

Navigate to Audit Logs

Click Audit Logs in the sidebar (under Governance).
2

View Activity

See a chronological list of all activities.

Filtering Logs

Filter audit logs by:
  • Date Range: Filter by time period
  • Principal: See actions by specific user or integration
  • Action Type: Filter by type of action
  • Resource: Filter by specific tool, collection, etc.
  • Status: Filter by success/failure

Log Details

Click on any log entry to see details:
  • Timestamp: When the action occurred
  • Principal: Who or what performed the action
  • Action: What action was taken
  • Resource: What resource was affected
  • Parameters: Input parameters (if applicable)
  • Result: Outcome of the action
  • Metadata: Additional context

Exporting Logs

Export audit logs for compliance:
1

Apply Filters

Set your desired filters.
2

Export

Click Export to download logs as CSV or JSON.
Exported logs include all details and can be used for compliance reporting or analysis.

Log Retention

Audit logs are retained according to your plan:
  • Standard Plans: 30 days retention
  • Enterprise Plans: Custom retention periods available
Export important logs before they expire if you need long-term retention.

Compliance

Audit logs support compliance requirements:
  • SOC 2: Complete audit trail of all actions
  • GDPR: Track data access and modifications
  • HIPAA: Monitor access to sensitive data
  • Custom: Export logs for your compliance needs
Search audit logs:
  • Text Search: Search across all log fields
  • Advanced: Use filters for complex queries
  • Saved Searches: Save common filter combinations

Best Practices

Regular Reviews

Regularly review audit logs for anomalies

Export Important Events

Export critical events for long-term storage

Set Alerts

Configure alerts for suspicious activity

Use Filters

Use filters to focus on relevant activities

Next Steps

Configure Policies

Set up policies that generate audit events

Manage Approvals

Track approval decisions in audit logs