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

# Monitor Your Stream

> Monitor project performance, track items status, and analyze validation statistics

<Info>
  **Quick Access**:

  * View project status in the Project View header
  * Check step statistics in the Scraping Flow tab
  * Monitor extracted items in the Project Items tab
  * Use test panels to validate step functionality
</Info>

This guide covers how to monitor and track your project's performance, including item status, validation statistics, and overall project health indicators.

## Project Status Monitoring

### Project Status Toggle

The **Project Status Toggle** in the header allows you to control project execution:

| Status       | Description                              | Use Case                             |
| ------------ | ---------------------------------------- | ------------------------------------ |
| **Active**   | Project is operational and executing     | Normal production operation          |
| **Inactive** | Project is disabled and will not execute | Temporarily disable without deletion |

<Note>
  Toggle project status to pause execution for maintenance or troubleshooting without losing configuration.
</Note>

### Project Health Indicators

Monitor these key indicators to assess project health:

* **Execution Status** - Active/Inactive state
* **Last Execution Time** - When the project last ran
* **Error Count** - Number of failed executions
* **Success Rate** - Percentage of successful runs

## Step Performance Statistics

Each step displays validation statistics in its header, providing real-time performance metrics:

### Validation Statistics

Steps show three key metrics:

| Metric         | Description                           | What It Indicates             |
| -------------- | ------------------------------------- | ----------------------------- |
| **valid: X**   | Number of valid results processed     | Successful data extraction    |
| **invalid: X** | Number of invalid results encountered | Data quality issues or errors |
| **New: X**     | Number of new items discovered        | Fresh data being collected    |

<Warning>
  High invalid counts may indicate:

  * Configuration errors in commands
  * Changes in source data structure
  * Network or connectivity issues
  * Validation rule mismatches
</Warning>

### Step Header Information

Each step card displays:

* **Step Name** - Descriptive identifier
* **Technology Badge** - Primary technology used (HTTP, Browser, Android)
* **Timeout** - Maximum execution time (e.g., "120000 ms")
* **Validation Statistics** - Performance metrics (valid/invalid/new counts)

### Interpreting Statistics

**Healthy Step Indicators**:

* High valid count relative to invalid
* Consistent new item discovery
* Low timeout occurrences

**Warning Signs**:

* Increasing invalid count over time
* Zero new items for extended periods
* Frequent timeout errors
* Sudden drops in valid count

## Project Items Monitoring

### Project Items Tab

The **Project Items** tab provides comprehensive monitoring of extracted data:

**Features**:

* View all items extracted by the project
* Monitor item status and metadata
* Track item creation and update timestamps
* Filter and search extracted items

**Use Cases**:

* Verify data extraction is working correctly
* Monitor data freshness
* Identify missing or duplicate items
* Export extracted data for analysis

<Steps>
  <Step title="Access Project Items">
    Navigate to the **Project Items** tab in the Project View.
  </Step>

  <Step title="Review Item List">
    Browse the list of extracted items with their status and metadata.
  </Step>

  <Step title="Filter Items">
    Use filters to find specific items by status, date, or other criteria.
  </Step>

  <Step title="Export Data">
    Export items for external analysis or reporting.
  </Step>
</Steps>

### Item Status Tracking

Monitor item status to understand data flow:

* **New Items** - Recently discovered items
* **Updated Items** - Items with refreshed data
* **Processed Items** - Items successfully sent to sinks
* **Failed Items** - Items that encountered errors

## Testing & Validation

For detailed information on testing and validation, see the [Debugging Your Project](/stream/project-debug) guide.

## Performance Monitoring Best Practices

### Regular Monitoring Checklist

* [ ] Check project status (Active/Inactive)
* [ ] Review step validation statistics
* [ ] Monitor invalid count trends
* [ ] Verify new item discovery rate
* [ ] Check Project Items tab for data flow
* [ ] Review timeout occurrences
* [ ] Test steps after configuration changes

### Performance Optimization Tips

**Improve Valid Count**:

* Review and fix command configurations
* Update JSONPath queries for current data structure
* Verify HTTP request parameters
* Check data validation rules

**Reduce Invalid Count**:

* Identify patterns in invalid results
* Update parsing logic for edge cases
* Add error handling for missing data
* Validate data structure before processing

**Increase New Item Discovery**:

* Verify source data is updating
* Check for API or website changes
* Review filtering logic
* Ensure proper data extraction paths

### Troubleshooting Performance Issues

For detailed troubleshooting steps and debugging techniques, see the [Debugging Your Project](/stream/project-debug) guide.

## Exporting Monitoring Data

### Project Configuration Export

Export project configuration for analysis:

<Steps>
  <Step title="Click Download Button">
    Use the cloud-download icon in the header to export project configuration.
  </Step>

  <Step title="Save Configuration">
    Configuration is exported as JSON or configuration file.
  </Step>

  <Step title="Analyze Offline">
    Review configuration and statistics in external tools.
  </Step>
</Steps>

**Export Use Cases**:

* Backup project configuration
* Share with team members
* Version control
* Performance analysis
* Troubleshooting support

## Related Resources

* [Creating Your First Project](/stream/first-project) - Learn project setup
* [Debugging Your Project](/stream/project-debug) - Testing and troubleshooting guide
* [Project View User Guide](/stream/intro) - Complete interface documentation
* [Command Configuration](/stream/intro) - Understand command settings