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

# Observability API

> Query logs, metrics, traces, and alerts to investigate application behavior.

Query logs, metrics, traces, and alerts to investigate application behavior.

Use project queries for individual applications. Use [account analytics](/docs/cloud/rest/apis/observability-api#account-conversation-analytics) to inspect conversation activity across the account, and [Runs](/docs/cloud/rest/apis/execution-api#runs) for account run analytics.

[Project logs](#project-logs) · [Project metrics](#project-metrics) · [Project traces](#project-traces) · [Project alerts](#project-alerts) · [Account conversation analytics](#account-conversation-analytics)

## Project logs

Query project logs to investigate activity and failures. Each endpoint reference lists the supported filters.

| Endpoint | Methods | Description |
| - | - | - |
| `/projects/{project_reference}/logs` | [GET](/docs/cloud/rest/api-reference/project-logs/query-project-logs) | Query project logs |

## Project metrics

Query project metrics to inspect measurements over time.

| Endpoint | Methods | Description |
| - | - | - |
| `/projects/{project_reference}/metrics/query` | [POST](/docs/cloud/rest/api-reference/project-metrics/query-project-metrics) | Query project metrics |

## Project traces

Find project traces and inspect individual traces by ID. Trace spans connect related execution activity. For a run’s event history, use the [run endpoints](/docs/cloud/rest/apis/execution-api#runs).

| Endpoint | Methods | Description |
| - | - | - |
| `/projects/{project_reference}/traces` | [GET](/docs/cloud/rest/api-reference/project-traces/query-project-traces) | Query project traces |
| `/projects/{project_reference}/traces/{trace_id}` | [GET](/docs/cloud/rest/api-reference/project-traces/get-project-trace) | Get project trace |
| `/projects/{project_reference}/traces/{trace_id}/spans` | [GET](/docs/cloud/rest/api-reference/project-traces/list-project-trace-spans) | List project trace spans |

## Project alerts

List the alerts that fired for a project, firing and recently resolved, with links to the logs and traces they cover.

| Endpoint | Methods | Description |
| - | - | - |
| `/projects/{project_reference}/alerts` | [GET](/docs/cloud/rest/api-reference/project-alerts/list-project-alerts) | List project alerts |

## Account conversation analytics

Read account-level conversation analytics. Find account run analytics under [Runs](/docs/cloud/rest/apis/execution-api#runs). Use the [Billing and Usage API](/docs/cloud/rest/apis/billing-and-usage-api) for consumption and spending data.

| Endpoint | Methods | Description |
| - | - | - |
| `/account/analytics/conversations` | [GET](/docs/cloud/rest/api-reference/account-conversation-analytics/get-account-conversation-analytics) | Get account conversation analytics |

[Back to REST API reference](/docs/cloud/rest)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.