> For the complete documentation index, see [llms.txt](https://docs.saanvi.ai/spendguard/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.saanvi.ai/spendguard/activity-feed.md).

# activity feed

The Activity Feed shows a history of all actions taken by your guards, including when ads were paused, resumed, or when actions failed.

## Understanding Activity Feed

The Activity Feed displays:

* **Guard Name** - Which guard performed the action
* **Platforms** - Which ad platforms were affected (Meta, Google Ads, or both)
* **Action** - What happened (e.g., "Paused 5 ads", "Resumed 3 campaigns")
* **Reason** - Why the action was taken (e.g., "Out of stock", "Days of cover: 2")
* **Time** - When the action occurred
* **Status** - Whether the action succeeded or failed

## Activity Batches

Actions are grouped into batches:

* **Batch** - A collection of related actions that happened together
* **Action Count** - Number of entities successfully acted upon
* **Failed Count** - Number of entities that failed to update

### Viewing Batch Details

Click **View** on any activity entry to see:

* **Batch Information** - Overall batch details (guard, platforms, reason, etc.)
* **Individual Actions** - A table showing each entity that was acted upon
* **Results** - Success or failure status for each action
* **Failure Reasons** - Why specific actions failed (if any)

## Action Types

### Successful Actions

* **Paused** - Ads were successfully paused
* **Resumed** - Ads were successfully resumed
* **Takeover** - Ads were taken over by SpendGuard (marked with a badge)

### Failed Actions

Failed actions show why they couldn't be completed:

* **Not paused by SpendGuard** - Entity was paused outside of SpendGuard and takeover is not enabled
* **Status update failed** - The ad platform API returned an error
* **Connection error** - Could not connect to the ad platform
* **Permission error** - Insufficient permissions to modify the entity

## Filtering and Sorting

The Activity Feed:

* **Prioritizes Failures** - Batches with failures appear at the top
* **Hides Empty Actions** - Batches with 0 successful and 0 failed actions are hidden
* **Sorts by Time** - Most recent activity appears first

## Understanding Failure Reasons

<details>

<summary>"Not paused by SpendGuard"</summary>

This means:

* The entity was paused manually or by another system.
* SpendGuard cannot resume entities it didn't pause (unless takeover is enabled).
* To fix: Enable takeover when creating/editing the guard.

</details>

<details>

<summary>"Status update failed"</summary>

This means:

* The ad platform API returned an error.
* The entity may have been deleted or archived.
* Platform-specific restrictions may apply.

</details>

<details>

<summary>"Connection error"</summary>

This means:

* Could not connect to the ad platform API.
* The connection may be disconnected.
* Check your connection status in Settings.

</details>

<details>

<summary>"Permission error"</summary>

This means:

* Insufficient permissions to modify the entity on the ad platform.
* Verify account permissions and reauthorize if necessary.

</details>

## Recent Activity on Dashboard

* The dashboard shows the 5 most recent activities for a quick overview of recent guard actions.
* Click **View All** to see the full activity feed.
* The dashboard entries use the same format as the main Activity page.

{% hint style="info" %}
Best Practices

* Review the activity feed regularly to ensure guards are working correctly.
* Investigate failures by checking batch details to understand root causes.
* Monitor takeover actions to ensure they're working as expected.
* Check timing to verify actions occur when expected.
  {% endhint %}

## Related Topics

* [Creating Guards](broken://pages/cea5ba8292bd5dd1d03f7439464d73820b6a8bd2) - How guards work
* [Takeover Behavior](broken://pages/ba43e7b5ed3b144e53e31888a10bcc0af9e4c774) - Understanding takeover
* [Troubleshooting](broken://pages/3fa127d58f106072a2cbb43dfef648f3a6c89f72) - Fixing common issues