Skip to main content
GET
/
projects
/
{projectId}
/
environments
/
{environmentId}
/
observability
/
http-metrics
/
overview
Get HTTP traffic overview
curl --request GET \
  --url {schemes}://api.upsun.com/projects/{projectId}/environments/{environmentId}/observability/http-metrics/overview \
  --header 'Authorization: Bearer <token>'
{
  "_grain": 5,
  "_from": 1704067200,
  "_to": 1704153600,
  "_project_id": "abc123def456",
  "_environment_id": "main",
  "_environment_type": "production",
  "_branch_machine_name": "main-bvxea6i",
  "_top_urls_count": 10,
  "data": {
    "urls": {
      "GET-https://example.com/api/products": {
        "url": "https://example.com/api/products",
        "method": "GET",
        "impact": 15234.67,
        "average": 245.3,
        "p_50": 198.5,
        "p_96": 512.8,
        "count": 62143
      },
      "GET-https://example.com/api/users/{id}": {
        "url": "https://example.com/api/users/{id}",
        "method": "GET",
        "impact": 8921.44,
        "average": 178.2,
        "p_50": 142.1,
        "p_96": 389.3,
        "count": 50073
      },
      "POST-https://example.com/api/orders": {
        "url": "https://example.com/api/orders",
        "method": "POST",
        "impact": 6543.21,
        "average": 312.5,
        "p_50": 267.8,
        "p_96": 678.4,
        "count": 20945
      }
    },
    "timelines": [
      {
        "timestamp": 1704067200,
        "request_size": 524288,
        "response_size": 2097152,
        "urls": {
          "GET-https://example.com/api/products": {
            "count": 1543,
            "impact": 378.45
          }
        },
        "codes": {
          "UNKNOWN": 0,
          "1XX": 0,
          "2XX": 1543,
          "3XX": 0,
          "4XX": 0,
          "5XX": 0
        }
      },
      {
        "timestamp": 1704070800
      },
      {
        "timestamp": 1704074400,
        "request_size": 612345,
        "response_size": 1847293,
        "urls": {
          "GET-https://example.com/api/products": {
            "count": 1247,
            "impact": 298.12
          }
        },
        "codes": {
          "UNKNOWN": 0,
          "1XX": 0,
          "2XX": 1247,
          "3XX": 0,
          "4XX": 0,
          "5XX": 0
        }
      }
    ]
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
projectId
string
required

The unique identifier of the Upsun project

Pattern: [a-z0-9]+
Example:

"abc123def456"

​
environmentId
string
required

The environment identifier

Pattern: .+
Example:

"main"

Query Parameters

​
from
integer<int64>
required

Start timestamp for the time range (Unix timestamp in seconds)

Example:

1704067200

​
to
integer<int64>
required

End timestamp for the time range (Unix timestamp in seconds)

Example:

1704153600

​
top_urls_count
integer

Number of top URLs to return (default: 10, max: 100)

Required range: 1 <= x <= 100
Example:

20

Response

HTTP traffic overview retrieved successfully

​
_grain
integer
required

Data granularity in seconds

Example:

5

​
_from
integer
required

Query start timestamp

Example:

1704067200

​
_to
integer
required

Query end timestamp

Example:

1704153600

​
_project_id
string
required

Project identifier

Example:

"abc123def456"

​
_environment_id
string
required

Environment identifier

Example:

"main"

​
_environment_type
enum<string>
required

Environment type

Available options:
production,
staging,
development
Example:

"production"

​
_branch_machine_name
string
required

Branch machine name

Example:

"main-bvxea6i"

​
_top_urls_count
integer
required

Number of top URLs included in response

Example:

10

​
data
object
required

HTTP traffic data containing URL statistics and time-series information

Last modified on March 25, 2026