Measure logo
REST API ReferenceDashboard APITraces

Fetch a span's metrics plot

GET/apps/{id}/spans/plots/metrics

Fetch a span's metrics plot, optionally narrowed by a filter expression.

Authorization

bearerAuth
AuthorizationBearer <token>

User access token issued at sign-in. Sent as Authorization: Bearer <access-token> unless cookies are used to send tokens. The /auth/refresh and /auth/signout endpoints expect the session's refresh token in the same header format instead.

In: header

Path Parameters

id*string

App's UUID.

Formatuuid

Query Parameters

span_name*string

Name of the span for which metrics plot is being fetched.

from?string

ISO 8601 UTC string in milliseconds precision. Example: 2023-11-01T18:30:00.000Z. Omitting both from and to returns the last seven days.

to?string

ISO 8601 UTC string in milliseconds precision. Example: 2023-11-01T18:30:00.000Z. Omitting both from and to returns the last seven days.

filter_expr?string

Conditions joined by AND or OR and grouped with parentheses, each reading key:operator:values with the names /apps/{id}/filters/keys publishes. AND binds tighter than OR.

version_name:in:[1.2.0,1.1.9] AND mapping_type:not_in:jsbundle(version_name:contains:SNAPSHOT AND mapping_type:in:proguard) OR patch_id:is_set

An operator taking no values ends its condition, as patch_id:is_set does. Double-quote a value holding a space, comma, bracket, colon or quote, with \" and \\ inside.

At most 4096 bytes, 32 conditions, 4 levels of nesting and 200 values in one condition.

timezone*string

IANA timezone used to bucket and format datetime values in the response. Example: Asia/Kolkata.

plot_time_group?string

Time bucket used for plot aggregation. Defaults to days.

Value in

  • "minutes"
  • "hours"
  • "days"
  • "months"

Response Body

application/json

curl -X GET "https://example.com/apps/497f6eca-6276-4993-bfeb-53cbbbba6f08/spans/plots/metrics?span_name=string&timezone=string"
[  {    "id": "0.9.0-SNAPSHOT.debug (900)",    "data": [      {        "datetime": "2024-11-18",        "p50": 82,        "p90": 85,        "p95": 85,        "p99": 85      }    ]  }]

Think this page can be better?

Open an issue