Introduction
Events in ServerTrack can have different statuses indicating their current state. Understanding these statuses helps you monitor tracking performance and troubleshoot issues. This guide explains all event statuses and what they mean.
Event Status Overview
Events progress through different statuses during their lifecycle:
- Queued: Event received and waiting to be processed
- Pending: Event is being prepared for processing
- Success: Event successfully delivered to all platforms
- Partial Success: Event delivered to some platforms but failed for others
- Failed: Event failed to deliver (will be retried)
- Blocked: Event was rejected before processing
- Permanently Failed: Event failed after all retries (permanent failure)
- Max Retries Failed: Event exceeded maximum retry attempts
Success Status
What it means: Event was successfully delivered to all configured platforms (Facebook, TikTok, GA4).
When you see it: All platforms accepted and processed the event.
What to do: No action needed - event was successfully delivered.
Partial Success Status
What it means: Event was delivered to some platforms but failed for others.
When you see it: Some platforms succeeded while others failed (e.g., Facebook succeeded, TikTok failed).
What to do: Check which platforms failed and investigate platform-specific issues.
Failed Status
What it means: Event failed to deliver to platforms. Event will be automatically retried.
When you see it: Temporary failures (network issues, rate limiting, temporary platform errors).
What to do: Events are automatically retried. Monitor to see if they succeed on retry. If failures persist, check platform credentials or configuration.
Blocked Status
What it means: Event was rejected before being sent to platforms. Events are blocked when validation fails, limits are exceeded, or service is paused.
When you see it: Validation errors, limit exceeded, server paused, or invalid authentication key.
What to do: Fix the underlying issue (validation errors, resume service, upgrade plan, etc.). Blocked events are not retried automatically.
Queued Status
What it means: Event is in the queue waiting to be processed.
When you see it: Event was received but hasn't been processed yet. Usually temporary.
What to do: Wait for processing. Events typically move from queued to pending to success/failed quickly.
Pending Status
What it means: Event is being prepared for delivery to platforms.
When you see it: Event is in the processing pipeline but hasn't been sent to platforms yet.
What to do: Wait for processing. Events typically move from pending to success/failed shortly.
Permanently Failed Status
What it means: Event failed due to a permanent error (e.g., authentication failure) and won't be retried.
When you see it: Permanent errors like invalid credentials, configuration issues, or platform authentication failures.
What to do: Fix the underlying issue (update credentials, fix configuration). Permanently failed events are not retried.
Max Retries Failed Status
What it means: Event failed after all retry attempts (typically 10 retries).
When you see it: Event continued to fail after multiple retry attempts.
What to do: Investigate the failure cause. Check platform status, credentials, and configuration. Events with this status are no longer retried.
Status Transitions
Typical event status flow:
- Queued → Event received
- Pending → Event being prepared
- Success/Partial Success/Failed → Event processed
- Failed → Retrying → (Retry attempt)
- Max Retries Failed → After all retries exhausted
Checking Event Statuses
To check event statuses:
- Go to Event Logs in your dashboard
- View the Status column
- Filter by status to see events with specific statuses
- Click on events to see detailed status information
Troubleshooting by Status
Many Failed Events
- Check platform credentials
- Verify platform connectivity
- Check for platform outages
- Review error messages in event details
Many Blocked Events
- Check validation errors
- Verify server status is active
- Check if usage limit is exceeded
- Review authentication key
Many Pending/Queued Events
- Check system processing capacity
- Monitor for processing delays
- Wait for processing to complete
Summary
Event statuses indicate:
- Success: Event delivered successfully
- Partial Success: Some platforms succeeded
- Failed: Temporary failure (will retry)
- Blocked: Event rejected (won't retry)
- Permanently Failed/Max Retries: Permanent failure (won't retry)
Understanding statuses helps you monitor tracking performance and identify issues quickly.