Skip to main content
GET
/
projects
/
{projectId}
/
environments
/
{environmentId}
/
observability
/
server
/
transactions-break-down
Error
A valid request URL is required to generate request examples
{
  "_grain": 60,
  "_from": 1771435023,
  "_to": 1771440423,
  "_agent": "a38f69ca-3b56-4ea6-beac-272b2568164a",
  "_contexts": [
    "web"
  ],
  "_contexts_mode": "additive",
  "_distribution_cost": "wt",
  "_project_id": "abc123def456",
  "_environment_id": "main",
  "_branch_machine_name": "main-bvxea6i",
  "_breakdown_dimension": "wt",
  "_sort": "impact",
  "_breakdown_limit": 200,
  "_breakdown_top_hits": {
    "max_quantity": 15,
    "max_percentage": 98
  },
  "transactions": {
    "data": [
      {
        "transaction": "App\\Controller\\ProductController::list",
        "wt_96th_percentile": 245123.5,
        "avg_wt": 89234.12,
        "avg_pmu": 4521234,
        "avg_stdout": 0,
        "total_requests": 45231,
        "total_requests_unnamed": 0,
        "total_errors": 12,
        "impact": 35.67,
        "top_hit": true,
        "_links": {
          "top_spans": {
            "href": "https://api.upsun.com/api/projects/abc123def456/environments/main/observability/server/top-spans?transactions%5B0%5D=App%5CController%5CProductController%3A%3Alist&from=1771348620&to=1771435020"
          },
          "recommendations": {
            "href": "https://api.upsun.com/api/projects/abc123def456/environments/main/observability/profiles/recommendations?transaction=App%5CController%5CProductController%3A%3Alist"
          },
          "automatic_profiles": {
            "href": "https://api.upsun.com/api/projects/abc123def456/environments/main/observability/profiles/automatic?transaction=App%5CController%5CProductController%3A%3Alist"
          }
        }
      },
      {
        "transaction": "App\\Controller\\CartController::checkout",
        "wt_96th_percentile": 523456.2,
        "avg_wt": 245678.34,
        "avg_pmu": 8912345,
        "avg_stdout": 0,
        "total_requests": 12543,
        "total_requests_unnamed": 0,
        "total_errors": 45,
        "impact": 22.45,
        "top_hit": true,
        "_links": {
          "top_spans": {
            "href": "https://api.upsun.com/api/projects/abc123def456/environments/main/observability/server/top-spans?transactions%5B0%5D=App%5CController%5CCartController%3A%3Acheckout&from=1771348620&to=1771435020"
          },
          "recommendations": {
            "href": "https://api.upsun.com/api/projects/abc123def456/environments/main/observability/profiles/recommendations?transaction=App%5CController%5CCartController%3A%3Acheckout"
          },
          "automatic_profiles": {
            "href": "https://api.upsun.com/api/projects/abc123def456/environments/main/observability/profiles/automatic?transaction=App%5CController%5CCartController%3A%3Acheckout"
          }
        }
      },
      {
        "transaction": "App\\Controller\\UserController::profile",
        "wt_96th_percentile": 89234.1,
        "avg_wt": 34567.89,
        "avg_pmu": 2345678,
        "avg_stdout": 0,
        "total_requests": 8932,
        "total_requests_unnamed": 123,
        "total_errors": 2,
        "impact": 3.21,
        "top_hit": false,
        "_links": {
          "top_spans": {
            "href": "https://api.upsun.com/api/projects/abc123def456/environments/main/observability/server/top-spans?transactions%5B0%5D=App%5CController%5CUserController%3A%3Aprofile&from=1771348620&to=1771435020"
          },
          "recommendations": {
            "href": "https://api.upsun.com/api/projects/abc123def456/environments/main/observability/profiles/recommendations?transaction=App%5CController%5CUserController%3A%3Aprofile"
          },
          "automatic_profiles": {
            "href": "https://api.upsun.com/api/projects/abc123def456/environments/main/observability/profiles/automatic?transaction=App%5CController%5CUserController%3A%3Aprofile"
          }
        }
      }
    ]
  },
  "top_hits_timeline": {
    "data": [
      {
        "timestamp": 1771435020,
        "_total_consumed": 1234567890.5,
        "_total_count": 45231,
        "_transactions": {
          "App\\Controller\\ProductController::list": {
            "average": 89234.12,
            "count": 1523
          },
          "App\\Controller\\CartController::checkout": {
            "average": 245678.34,
            "count": 423
          }
        }
      },
      {
        "timestamp": 1771435080,
        "_total_consumed": 1345678901.2,
        "_total_count": 48532,
        "_transactions": {
          "App\\Controller\\ProductController::list": {
            "average": 92345.67,
            "count": 1678
          },
          "App\\Controller\\CartController::checkout": {
            "average": 234567.89,
            "count": 456
          }
        }
      }
    ]
  }
}

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

​
grain
integer

Granularity of data points in seconds. Auto-calculated if omitted.

Example:

10

​
breakdown_dimension
enum<string>

Dimension for transaction breakdown calculations.

Available options:
wt,
pmu,
stdout
​
sort
enum<string>

Sort order for the transaction breakdown.

Available options:
impact,
total_requests,
avg_wt,
avg_pmu,
avg_stdout,
total_errors,
wt_96th_percentile
​
breakdown_limit
integer

Maximum number of transactions to return in the breakdown.

Required range: 1 <= x <= 300
​
contexts[]
enum<string>[]

Filter by execution contexts. Defaults to ["web"] with additive mode when neither contexts nor contexts_mode is specified.

Available options:
web,
cli
​
contexts_mode
enum<string>

Filter mode for contexts parameter. "1" (additive, default) includes only specified contexts. "-1" (subtractive) excludes specified contexts and includes all others. When neither contexts nor contexts_mode is specified, defaults to "1" (additive) with contexts=["web"].

Available options:
1,
-1
Example:

"1"

​
transactions[]
string[]

Filter by transaction names

​
transactions_mode
enum<string>

Filter mode for transactions parameter. "1" (additive) includes only specified transactions. "-1" (subtractive, default) excludes specified transactions and includes all others.

Available options:
1,
-1
Example:

"1"

​
wt_slots[]
string[]

Filter by wall-time distribution slots

​
wt_slots_mode
enum<string>

Filter mode for wt_slots parameter. "1" (additive) includes only specified wt_slots. "-1" (subtractive, default) excludes specified wt_slots and includes all others.

Available options:
1,
-1
Example:

"1"

​
pmu_slots[]
string[]

Filter by peak memory usage distribution slots

​
pmu_slots_mode
enum<string>

Filter mode for pmu_slots parameter. "1" (additive) includes only specified pmu_slots. "-1" (subtractive, default) excludes specified pmu_slots and includes all others.

Available options:
1,
-1
Example:

"1"

​
http_status_codes[]
string[]

Filter by HTTP status codes or ranges (e.g., 200, 5xx)

​
http_status_codes_mode
enum<string>

Filter mode for http_status_codes parameter. "1" (additive) includes only specified http_status_codes. "-1" (subtractive, default) excludes specified http_status_codes and includes all others.

Available options:
1,
-1
Example:

"1"

​
http_hosts[]
string[]

Filter by HTTP hosts

​
http_hosts_mode
enum<string>

Filter mode for http_hosts parameter. "1" (additive) includes only specified http_hosts. "-1" (subtractive, default) excludes specified http_hosts and includes all others.

Available options:
1,
-1
Example:

"1"

​
hosts[]
string[]

Filter by server hosts

​
hosts_mode
enum<string>

Filter mode for hosts parameter. "1" (additive) includes only specified hosts. "-1" (subtractive, default) excludes specified hosts and includes all others.

Available options:
1,
-1
Example:

"1"

​
frameworks[]
string[]

Filter by frameworks. Can be specified multiple times for multiple values (e.g., ?frameworks[]=symfony&frameworks[]=laravel). Use frameworks_mode to control inclusion/exclusion behavior.

​
frameworks_mode
enum<string>

Filter mode for frameworks parameter. "1" (additive) includes only specified frameworks. "-1" (subtractive, default) excludes specified frameworks and includes all others.

Available options:
1,
-1
Example:

"1"

​
languages[]
string[]

Filter by programming languages. Can be specified multiple times for multiple values (e.g., ?languages[]=php&languages[]=python). Use languages_mode to control inclusion/exclusion behavior.

​
languages_mode
enum<string>

Filter mode for languages parameter. "1" (additive) includes only specified languages. "-1" (subtractive, default) excludes specified languages and includes all others.

Available options:
1,
-1
Example:

"1"

​
methods[]
string[]

Filter by HTTP methods. Can be specified multiple times for multiple values (e.g., ?methods[]=get&methods[]=post). Use methods_mode to control inclusion/exclusion behavior.

​
methods_mode
enum<string>

Filter mode for methods parameter. "1" (additive) includes only specified methods. "-1" (subtractive, default) excludes specified methods and includes all others.

Available options:
1,
-1
Example:

"1"

​
runtimes[]
string[]

Filter by runtimes. Can be specified multiple times for multiple values (e.g., ?runtimes[]=PHP 8.4.17 (fpm-fcgi)). Use runtimes_mode to control inclusion/exclusion behavior.

​
runtimes_mode
enum<string>

Filter mode for runtimes parameter. "1" (additive) includes only specified runtimes. "-1" (subtractive, default) excludes specified runtimes and includes all others.

Available options:
1,
-1
Example:

"1"

​
oss[]
string[]

Filter by operating systems. Can be specified multiple times for multiple values (e.g., ?oss[]=Linux&oss[]=Darwin). Use oss_mode to control inclusion/exclusion behavior.

​
oss_mode
enum<string>

Filter mode for oss parameter. "1" (additive) includes only specified operating systems. "-1" (subtractive, default) excludes specified operating systems and includes all others.

Available options:
1,
-1
Example:

"1"

​
distribution_cost
enum<string>

Cost distribution dimension for server load distribution.

Available options:
wt,
pmu

Response

Transaction breakdown 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

​
_agent
string<uuid>
required

Blackfire Agent UUID

Example:

"a38f69ca-3b56-4ea6-beac-272b2568164a"

​
_project_id
string
required

Project identifier

Example:

"abc123def456"

​
_environment_id
string
required

Environment identifier

Example:

"main"

​
_branch_machine_name
string
required

Branch machine name

Example:

"main-bvxea6i"

​
_breakdown_dimension
enum<string>
required

Applied dimension for transaction breakdown calculations

Available options:
wt,
pmu,
stdout
​
_sort
enum<string> | null
required

Applied sort order for the transaction breakdown

Available options:
impact,
total_requests,
avg_wt,
avg_pmu,
avg_stdout,
total_errors,
wt_96th_percentile
​
_breakdown_limit
integer
required

Maximum number of transactions returned

Example:

200

​
_breakdown_top_hits
object
required

Configuration for top hits selection

​
transactions
object
required

Transaction breakdown data

​
top_hits_timeline
object
required

Time-series data for top hit transactions

​
_contexts
string[] | null

Applied context filter values

​
_contexts_mode
enum<string> | null

Context filter mode (additive=include only, subtractive=exclude)

Available options:
additive,
subtractive
​
_transactions
string[] | null

Applied transaction filter values

​
_transactions_mode
enum<string> | null

Transaction filter mode (additive=include only, subtractive=exclude)

Available options:
additive,
subtractive
​
_wt_slot
string[] | null

Applied wall-time slot filter values

​
_wt_slot_mode
enum<string> | null

Wall-time slot filter mode (additive=include only, subtractive=exclude)

Available options:
additive,
subtractive
​
_pmu_slot
string[] | null

Applied peak memory slot filter values

​
_pmu_slot_mode
enum<string> | null

Peak memory slot filter mode (additive=include only, subtractive=exclude)

Available options:
additive,
subtractive
​
_http_status_codes
string[] | null

Applied HTTP status code filter values

​
_http_status_codes_mode
enum<string> | null

HTTP status code filter mode (additive=include only, subtractive=exclude)

Available options:
additive,
subtractive
​
_http_hosts
string[] | null

Applied HTTP host filter values

​
_http_hosts_mode
enum<string> | null

HTTP host filter mode (additive=include only, subtractive=exclude)

Available options:
additive,
subtractive
​
_hosts
string[] | null

Applied host filter values

​
_hosts_mode
enum<string> | null

Host filter mode (additive=include only, subtractive=exclude)

Available options:
additive,
subtractive
​
_frameworks
string[] | null

Applied framework filter values

​
_frameworks_mode
enum<string> | null

Framework filter mode (additive=include only, subtractive=exclude)

Available options:
additive,
subtractive
​
_languages
string[] | null

Applied language filter values

​
_languages_mode
enum<string> | null

Language filter mode (additive=include only, subtractive=exclude)

Available options:
additive,
subtractive
​
_methods
string[] | null

Applied method filter values

​
_methods_mode
enum<string> | null

Method filter mode (additive=include only, subtractive=exclude)

Available options:
additive,
subtractive
​
_runtimes
string[] | null

Applied runtime filter values

​
_runtimes_mode
enum<string> | null

Runtime filter mode (additive=include only, subtractive=exclude)

Available options:
additive,
subtractive
​
_oss
string[] | null

Applied OS filter values

​
_oss_mode
enum<string> | null

OS filter mode (additive=include only, subtractive=exclude)

Available options:
additive,
subtractive
​
_distribution_cost
enum<string>

Applied distribution cost dimension (wt=wall time, pmu=peak memory usage)

Available options:
wt,
pmu
Last modified on March 25, 2026