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

# Troubleshooting

> Common observability issues and practical fixes

<Note>
  Use this guide when dashboards, request details, or rules behave unexpectedly.
</Note>

## 1) Metrics Look Empty

**Possible causes**

* Time range excludes traffic.
* Filters are too restrictive.
* No requests in selected scope.

**Fix**

1. Reset filters.
2. Expand to **Last 24 hours**.
3. Pivot view to **Project** to confirm baseline traffic.

## 2) Cannot Find a Specific Request

**Possible causes**

* Wrong time window.
* Request belongs to another project/deployment.
* Search text too narrow.

**Fix**

1. Start with only time range.
2. Add project/deployment filters incrementally.
3. Sort by timestamp and scan nearby rows.

## 3) Rule Not Blocking Expected Traffic

**Possible causes**

* Rule status is inactive.
* Match criteria are too narrow.
* Traffic does not meet rule type conditions.

**Fix**

1. Confirm rule is active.
2. Re-check matching fields from request metadata.
3. Edit scope/criteria and monitor block counts.

## 4) Sudden Increase in Latency

```mermaid theme={null}
flowchart LR
    A[Latency Spike] --> B[Check p95/p99 by Deployment]
    B --> C[Inspect Slow Requests]
    C --> D[Review Errors and Metadata]
    D --> E[Validate Rules and Traffic Pattern]
    E --> F[Mitigate and Monitor]
```

**Fix checklist**

* Confirm affected deployment/model.
* Compare success rate before and after spike.
* Capture sample request IDs for incident follow-up.