> ## 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 Customer Dashboard issues and how to resolve them

## Troubleshooting flow

```mermaid theme={null}
graph TD
    A[Issue Detected] --> B{Where?}
    B -->|Access| C[Auth and Permissions Checks]
    B -->|Model Calls| D[Model + API Key Checks]
    B -->|Telemetry| E[Logs and Usage Checks]
    C --> F[Retest]
    D --> F
    E --> F
    F --> G{Resolved?}
    G -->|No| H[Review Audit and Escalate]
    G -->|Yes| I[Close Incident]
```

## Access and login issues

### Problem: Unable to access app pages

**Checks**:

* Verify account is active and has customer dashboard access.
* Confirm session has not expired.
* Retry in an incognito session to isolate browser cache issues.

## Model invocation issues

### Problem: 401 or authentication failures

**Checks**:

* Ensure bearer token uses a valid API key.
* Confirm key is not expired or revoked.
* Verify key belongs to the intended project.

### Problem: model not found or unavailable

**Checks**:

* Confirm model appears in Models catalog.
* Validate the model identifier used in request body.
* Re-copy snippet from **Use Model** to avoid stale payload formats.

## Observability issues

### Problem: request succeeds but logs seem delayed

**Checks**:

* Refresh Metrics and Requests tabs.
* Verify time filter is wide enough to include recent calls.
* Confirm current project and model filters are correct.

### Problem: usage appears inaccurate

**Checks**:

* Match project and time range selection with your test window.
* Verify whether alerts are based on token or cost thresholds.
* Export usage and compare against known request batch size.

## API key management issues

### Problem: key creation or edit fails

**Checks**:

* Ensure required fields are provided (name, project, expiry where required).
* Verify project exists and is selectable.
* Retry after clearing stale form data.

## Escalation data to collect

Before escalating, capture:

1. Project ID or name.
2. Inference/request ID where applicable.
3. Timestamp (UTC), model name, endpoint path.
4. Error message and HTTP status code.
5. Related audit events around the same window.