# Using the Signal Explorer

> Source: https://docs.trailspark.ai/docs/signal-explorer

## Accessing Signal Explorer

Navigate to **Signal Explorer** from the main navigation. Requires Owner, Admin, or Editor role.

<img src="/api/images/d886338d-c0e6-4ec9-bc53-80f3ae2270e7/file" alt="Trailspark Signal Explorer" width="600" />

## Statistics Cards

Four metrics display at the top:

| Metric | Description |
|--------|-------------|
| **Total Signals** | All signals received |
| **Pending** | Awaiting processing |
| **Processed** | Successfully processed |
| **Failed** | Encountered processing errors |

## Processing Signals

Signals are processed automatically when mapping rules match. To trigger manual processing:

1. Click **Process Signals**
2. Processing runs immediately against all current mapping rules
3. Results display when complete, showing processed/successful/failed counts and duration

Use manual processing when:
- Testing new or updated mapping rules
- Clearing a backlog of pending signals
- Reprocessing after rule changes

## Processed Signals Table

The table displays processed signals in two tabs:

### Processed Tab

| Column | Description |
|--------|-------------|
| **Signal Name** | Rule name or event type |
| **Source** | Signal source system badge |
| **Lead** | Link to the associated lead record (if created) |
| **Processed At** | When processing occurred |
| **Rule** | The mapping rule that processed the signal |

### Failed Tab

| Column | Description |
|--------|-------------|
| **Event Type** | Technical event type |
| **Source** | Signal source system badge |
| **Status** | Processing outcome badge (Failed, Skipped, Permanently Failed) |
| **Error** | Error message (hover for full text) |
| **Failed At** | When processing failed |

## Usage Limits

Alerts display when approaching your plan's Raw Signal or Mapped Signal limits. These appear above the statistics cards.

> [!WARNING]
> When the raw signal limit is reached, webhook endpoints return `429` status codes and new signals are rejected unless usage overages are enabled on paid plans.

## Common Error Messages

| Error | Resolution |
|-------|------------|
| "No identifying field" | Map email or a user ID in the matching rule |
| "Invalid path" | Check field mapping source paths in the rule |
| "Rule not found" | Create a mapping rule for this signal type |

## Next Steps

- [Creating Signal Mapping Rules](/docs/creating-signal-mapping)
- [Editing Signal Mapping Rules](/docs/editing-signal-mapping)
- [Signal Archiving](/docs/signal-archiving)