errors.profiles.flamegraph

Merge a project’s continuous profiles in a window into one flame graph, with its slowest functions by self time (optionally only in-app frames, or compared with the previous window)

GET /errors/api/projects/{id}/profiles/flamegraphIAM errors:GetEventsRead

Request syntax

GET /errors/api/projects/{id}/profiles/flamegraph

Path parameters

  • idRequired

    string

    Constraints: uuid

Query parameters

  • windowOptional

    enum

    Last 15 minutes, hour or day, or custom with from/to

    One of: 15m, 1h, 24h, custom

    Default: "1h"

  • fromOptional

    string

    Custom window start (ISO 8601)

    Constraints: datetime

  • toOptional

    string

    Custom window end (ISO 8601)

    Constraints: datetime

  • environmentOptional

    string

    Only chunks of this environment

    Constraints: max 200 chars

  • releaseOptional

    string

    Only chunks of this release

    Constraints: max 200 chars

  • runtimeOptional

    enum

    node, browser or python

    One of: node, browser, python

  • profilerOptional

    string

    Only this profiler (one per process or page)

    Constraints: /^[0-9a-fA-F-]{32,36}$/

  • threadOptional

    string

    Thread id (default: the busiest)

    Constraints: max 100 chars

  • myCodeOptional

    enum

    Only in-app frames ("only my code")

    One of: 0, 1, true, false

  • compareOptional

    enum

    Also the previous window of the same length, per function

    One of: 0, 1, true, false

Response

200 with { from, to, chunksInWindow, chunksMerged, scale, samples, intervalMs, thread, threads, functions, tree, timingsMs }: at most 120 chunks are merged, an even sample of a longer window, and `scale` is how many samples each merged one stands for; `functions` the 100 slowest by self time (key, name, file, line, inApp, selfMs, totalMs, share of the window’s samples, and previousShare with compare); `tree` the merged call tree. 400 and 404/403 as `list`.

A JSON response is wrapped as { "success": true, "data": … }; the CLI prints the whole body with --json.

Errors

  • 400The request does not pass the schema above. The body is { "error": …, "issues": […] }, one issue per field.
  • 401No credentials, or an access key that is unknown, revoked or expired.
  • 403The caller's policies do not allow errors:GetEvents on this resource. The body names the action and the resource, and the refusal is recorded in the audit log.
  • 404The resource does not exist in your organization.

Examples

The required parameters only, with example values. Replace id and the other placeholders with your own.

dcloud errors profiles flamegraph id

Generated from the API description, the same one the API checks requests against and the CLI is built from. MCP tool: dcloud_errors_profiles_flamegraph.