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

# Observability Overview

> Monitor and debug AI Gateway requests.

Monitor AI Gateway usage from [app.ngrok.ai](https://app.ngrok.ai) and the AI Gateway API.

<CardGroup cols={2}>
  <Card title="Usage" icon="chart-line" href="/ai-gateway/observability/index#usage-api">
    Query usage events and aggregated overview via the AI Gateway API
  </Card>

  <Card title="Debugging" icon="bug" href="/ai-gateway/guides/debugging">
    Troubleshoot failed requests and error codes
  </Card>

  <Card title="Error Codes" icon="triangle-exclamation" href="/ai-gateway/reference/error-codes">
    Reference for gateway error responses
  </Card>
</CardGroup>

## Usage API

Query usage with the AI Gateway API:

```bash theme={null}
curl https://api.ngrok.ai/usage/overview \
  -H "Authorization: Bearer $AI_GATEWAY_API_KEY"
```

List individual usage events with the [Usage API](/ai-gateway/observability#usage-api). View usage summaries in [app.ngrok.ai](https://app.ngrok.ai) when available.

## Roadmap

* Provider and retry tracking in usage events
* Token usage visualization in app.ngrok.ai
* Cost analytics per access key

**Have feedback?** Email [niji@ngrok.ai](mailto:niji@ngrok.ai) with observability requests.