Skip to main content
Governe provides audit logging for compliance tracking and subscription management for controlling usage limits.

​
Audit Logs

Audit logs record all administrative actions in your organization, providing an immutable trail for security and compliance.

​
Accessing Audit Logs

Go to Audit in the Governe sidebar.

​
Event Categories

CategoryEvents Tracked
memberMember added, updated, removed, suspended
roleRole created, updated, deleted, assigned
orgOrganization settings changed
ssoSSO provider added, updated, deleted
quotaQuota limits changed
apikeyAPI key created, rotated, revoked
authLogin attempts, SSO events
subscriptionSubscription changed
inviteInvite created, used, revoked
groupGroup created, updated, members changed

​
Event Structure

Each audit event contains:
FieldDescription
timestampWhen the event occurred
categoryEvent category (member, role, etc.)
actionSpecific action (create, update, delete)
targetWhat was affected (user, role, etc.)
changesBefore/after values
metadataAdditional context

​
Example Event

{
  "timestamp": "2024-03-15T10:30:00Z",
  "category": "member",
  "action": "role_changed",
  "target": {
    "type": "user",
    "id": "user_123",
    "email": "jane@acme.com"
  },
  "changes": {
    "before": { "roleSlug": "viewer" },
    "after": { "roleSlug": "admin" }
  },
  "metadata": {
    "changedBy": "admin@acme.com"
  }
}

​
Filtering Logs

  • Filter by date range
  • Filter by category
  • Search by user email or target ID

​
Retention

Audit logs are retained according to your subscription tier:
TierRetention
Free7 days
Starter30 days
Pro90 days
EnterpriseCustom (up to unlimited)

​
Quotas

Quotas limit resource consumption to prevent unexpected costs and ensure fair usage.

​
Viewing Quotas

Go to Quotas in the Governe sidebar.

​
Quota Types

TypeDescription
RateResets after time window (per minute, hour, day)
CumulativeAccumulates until billing period resets

​
Common Metrics

MetricTypeDescription
llm.requests.rpmRateRequests per minute
llm.requests.dailyRateRequests per day
llm.tokens.monthlyCumulativeTokens per month
llm.cost.monthlyCumulativeCost per month (USD)
usersCumulativeTotal organization members

​
Quota Display

Each quota shows:
  • Current usage: Amount consumed
  • Limit: Maximum allowed
  • Percentage: Visual progress bar
  • Window: Reset period (for rate limits)

​
Warning Thresholds

ThresholdVisual
0-79%Normal
80-94%Yellow warning
95%+Red critical

​
Subscriptions

Subscriptions define your organization’s tier, limits, and feature access.

​
Viewing Subscription

Go to Subscription in the Governe sidebar.

​
Subscription Tiers

TierDescription
FreeBasic access with limited quotas
StarterSmall teams with moderate usage
ProGrowing organizations with advanced features
EnterpriseCustom limits and dedicated support
CustomTailored for specific needs

​
Subscription Status

StatusDescription
ActiveFull access
TrialingTrial period
Past DuePayment overdue
CanceledSubscription ended
InactiveSubscription disabled

​
Feature Access

Subscriptions control access to features:
FeatureFreeStarterProEnterprise
SSONoNoYesYes
Custom BrandingNoNoYesYes
API AccessLimitedYesYesYes
Audit Logs7 days30 days90 daysCustom
Priority SupportNoNoYesYes

​
Quota Limits by Tier

Example limits (actual limits vary):
MetricFreeStarterProEnterprise
Users525100Unlimited
RPM1060300Custom
Tokens/month100K1M10MCustom

​
Managing Subscriptions (Platform Admin)

Platform administrators can manage subscriptions:

​
Creating Subscription Templates

  1. Go to Platform > Subscriptions
  2. Click Create Subscription
  3. Configure:
    • Name and slug
    • Tier
    • Quota limits
    • Feature flags
  4. Optionally set as default for new organizations

​
Assigning Subscriptions

  1. Go to Platform > Organizations
  2. Select an organization
  3. Change the subscription

​
Modifying Quotas

Quota limits can be adjusted:
  1. Edit the subscription template
  2. Or override for a specific organization

​
Quota Exceeded Behavior

When quotas are exceeded:
PolicyBehavior
Hard BlockRequest fails with QUOTA_EXCEEDED error
Soft DowngradeFalls back to cheaper model
Rate LimitedRequest fails with RATE_LIMITED, includes retry-after
See Model Governance for configuration.

​
Best Practices

Regular Audits

Review audit logs monthly for security

Monitor Quotas

Set alerts before hitting limits

Right-Size Tiers

Choose subscription tier matching actual usage

Plan Upgrades

Upgrade before hitting limits, not after

​
Compliance Scenarios

For SOC 2 compliance:
  1. Enable audit logging (Pro tier minimum)
  2. Review access changes monthly
  3. Document role assignment justifications
  4. Export audit logs for external review

​
Next Steps

Identity & Access

Manage members and permissions

Observability

Monitor usage and performance