> ## Documentation Index
> Fetch the complete documentation index at: https://runcrate.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Audit Logs

> Track all actions taken within your workspace for security and accountability.

export const RuncrateStyles = () => {
  if (typeof document !== 'undefined' && !document.getElementById('runcrate-overrides')) {
    const s = document.createElement('style');
    s.id = 'runcrate-overrides';
    s.textContent = `
      /* Match Runcrate's rounding scale (--radius: 0.75rem) */
      .rounded-sm { border-radius: 0.5rem !important; }   /* 8px */
      .rounded-md { border-radius: 0.625rem !important; } /* 10px */
      .rounded-lg { border-radius: 0.75rem !important; }  /* 12px */
      .rounded-l-sm { border-top-left-radius: 0.5rem !important; border-bottom-left-radius: 0.5rem !important; }
      .rounded-r-sm { border-top-right-radius: 0.5rem !important; border-bottom-right-radius: 0.5rem !important; }
      .rounded-l-md { border-top-left-radius: 0.625rem !important; border-bottom-left-radius: 0.625rem !important; }
      .rounded-r-md { border-top-right-radius: 0.625rem !important; border-bottom-right-radius: 0.625rem !important; }
      .rounded-l-lg { border-top-left-radius: 0.75rem !important; border-bottom-left-radius: 0.75rem !important; }
      .rounded-r-lg { border-top-right-radius: 0.75rem !important; border-bottom-right-radius: 0.75rem !important; }

      /* Cards: never pure white in light mode */
      .card { background-color: #fcfcfc !important; border-radius: 0.75rem !important; }
      html.dark .card { background-color: #141414 !important; }

      /* Docs hero box */
      .rc-hero { background-color: #fcfcfc; border: 1px solid #e0e0e0; }
      html.dark .rc-hero { background-color: #141414; border-color: #242424; }
      html.dark .rc-hero h1 { color: #f5f5f5; }

      /* Runcrate scrollbar — thin, transparent track, hide-until-hover thumb */
      ::-webkit-scrollbar { width: 6px; height: 6px; background-color: transparent; }
      ::-webkit-scrollbar-track { background-color: transparent; }
      ::-webkit-scrollbar-thumb { background-color: rgba(155, 155, 155, 0.5); border-radius: 10px; transition: opacity 0.3s ease; opacity: 0; }
      ::-webkit-scrollbar-thumb:hover { background-color: rgba(155, 155, 155, 0.7); }
      *:hover::-webkit-scrollbar-thumb,
      *:focus::-webkit-scrollbar-thumb,
      *:active::-webkit-scrollbar-thumb { opacity: 1; }
      * { scrollbar-width: thin; scrollbar-color: rgba(155, 155, 155, 0.5) transparent; }
    `;
    document.head.appendChild(s);
  }
  return null;
};

<RuncrateStyles />

Audit logs record every significant action taken within your workspace. Use them for security monitoring, cost tracking, and debugging.

## Accessing Audit Logs

Navigate to **Dashboard → Audit Log**. Audit logs are available to **Owners** and **Managers** only.

## Filters

Use the filter bar to narrow down log entries:

| Filter             | Options                                               |
| ------------------ | ----------------------------------------------------- |
| **Date Range**     | Pick a start and end date using the date range picker |
| **Action Type**    | Create, Update, Delete, Invite                        |
| **Resource Type**  | Instance, Storage, Team, Billing, SSH Key, Workspace  |
| **Items Per Page** | 25, 50, or 100                                        |

## Log Entry Fields

Each log entry includes:

| Field             | Description                                                                         |
| ----------------- | ----------------------------------------------------------------------------------- |
| **User Email**    | Who performed the action                                                            |
| **IP Address**    | The IP address the action originated from                                           |
| **Action**        | What was done — displayed as a colored badge (e.g., Create, Update, Delete, Invite) |
| **Resource Type** | What type of resource was affected — displayed as a colored badge                   |
| **Resource Name** | The specific resource name (e.g., instance name, volume name)                       |
| **Details**       | Additional context about the action                                                 |
| **Timestamp**     | When the action occurred, shown as relative time (e.g., "2 hours ago")              |

## Use Cases

<CardGroup cols={2}>
  <Card title="Security Monitoring" icon="shield">
    Track who is deploying instances, modifying team roles, or accessing billing. Identify unusual activity from unexpected IP addresses.
  </Card>

  <Card title="Cost Tracking" icon="chart-line">
    See when instances were created and terminated to understand spending patterns.
  </Card>

  <Card title="Debugging" icon="bug">
    Review recent actions to understand what changed if something stops working as expected.
  </Card>

  <Card title="Team Accountability" icon="users">
    See which team members performed which actions, especially useful for shared workspaces.
  </Card>
</CardGroup>

<Note>
  Audit logs are retained for the lifetime of the workspace. They cannot be edited or deleted.
</Note>