# Monitoring a feed

## Accessing the feed

1. **Go to the Segment:** Navigate to the segment where your feed is configured.
2. **Open Feed Options:** Click the menu button and choose either **Stats** or **Edit**.

## Feed details overview

The feed details are divided into three sections to enhance understanding:

1. [**Stats**](#stats-high-level-overview-of-the-feed)**:**
   * Provides a high-level summary of the feed.
   * Shows the status of the feed instance.
   * Displays the identifiers sent to the partner for addition or deletion.
2. [**Configuration**](#configuration-plugin-properties-setup)**:**
   * Lists all plugin properties configured for the current instance.
3. [**Troubleshooting**](#troubleshooting-technical-details)**:**
   * Offers an in-depth view of processing steps, aiding in the investigation of anomalies.

## Stats: high-level overview of the feed

The **Stats** tab is tailored for non-technical users to easily assess feed activity. It shows whether the feed is successfully transmitting identifiers to the destination platform.

### **Server-side feeds**

#### **Feed lifecycle**

1. **Creation:**
   * **Waiting for Activation:** The feed card is created on the segment but remains inactive.
   * **Feed Activated:** The feed creates the segment on the destination platform (triggers the `onExternalSegmentCreation` function).
2. **Connection:**
   * The feed tests the connection with the destination platform (triggers the `onExternalSegmentConnection` function).
3. **Starting:**
   * The feed begins transmitting identifiers to the destination platform.
4. **Initial Loading:**
   * Processes all users in the segment and sends their identifiers to the destination.
5. **Live:**
   * Continues to send new identifiers and requests deletion of those no longer present in the segment.

#### **Sending metrics**

* **Successful Identifier Transactions:** number of upserts or deletions of identifiers successfully sent during the selected period.
* **Identifier Coverage:** percentage of UserPoint without any identifiers sent to the destination platform.
* **Daily Graph:** visual representation of upserts or deletions sent daily.

### **Client-side feed**

Client-side feeds have simpler functionality but use a similar interface.

#### **Feed lifecycle**

* **PAUSED:** the feed card is created but not activated.
* **ACTIVE:** the feed is activated on the segment and the feed is downloaded by the browser.

#### **Sending metrics**

* **Daily Downloads:** number of times the feed was downloaded by the browser during the selected period.

## Configuration: plugin properties setup

The **Configuration** tab displays the plugin properties for the feed instance:

* Plugin properties layout is determined during the creation of the plugin version.
* These values can only be modified when the feed is not activated. Once activated, the configuration becomes read-only.

## Troubleshooting: technical details

The **Troubleshooting** tab is designed for technical users, providing detailed insights into:

* Successful and failed operations (e.g., upserts and deletions).
* Errors and processing steps for investigating anomalies.

### **General information**

* **Server-Side and Client-Side feeds:**
  * Resource details, plugin information, and plugin version information.
* **Server-Side Feeds only:**
  * Instance details and initial loading logs.

### **Metrics for server-side feeds**

#### **Standard Metrics:**

1. **API Calls to the Audience Feed Plugin:**
   * Displays response status for `/user_segment_update` calls.
2. **Identifiers Sent to the Destination Platform:**
   * Shows processed identifiers and their statuses for non-batching cases.

#### **Actions and Statuses:**

* **Push:** Adding a UserPoint to the segment or an identifier to a UserPoint.
* **Remove:** Removing a UserPoint from the segment or an identifier from a UserPoint.
* **Statuses:**
  * **PROCESSED:** Successful with no destination platform response (e.g., batch/file delivery).
  * **SUCCEEDED:** Successful with a positive response from the destination platform.
  * **FAILED:** Error occurred within the plugin or at the destination platform.
  * **NO\_ELIGIBLE\_IDENTIFIERS:** No eligible identifiers to send.

#### **Batching Metrics:**

* **API Calls to the Audience Feed Plugin (/batch\_update route):**
  * Number and status of batches created.
* **Records Sent to the Destination Platform:**
  * Rows sent per batch (may contain multiple identifiers).

#### **File Delivery Metrics:**

* **Files Sent by File Delivery Service:**
  * Number of files sent and response statuses.
* **Records Sent to the Destination Platform:**
  * Rows sent per file (may represent multiple identifiers).

### **Metrics for Client-Side Feeds**

* Displays a daily graph of browser downloads, as shown in the **Stats** tab.
