Skip to content

Return persisted operational metrics, slow mutation samples, and current PostgreSQL blockers.

GET
/api/workspace/admin/metrics/overview
curl --request GET \
--url https://example.com/api/workspace/admin/metrics/overview \
--header 'Authorization: Bearer <token>'
RangeMinutes
integer format: int32
BucketSeconds
integer format: int32
access_token
string

Optional access token for clients that cannot set Authorization headers. Prefer Authorization: Bearer <token> when possible.

OK

Media typeapplication/json
object
Data

Operational metrics dashboard payload.

object
FromUtc
string format: date-time
ToUtc
string format: date-time
Entities
Array<object>
nullable

Entity definition label used by operational metrics dashboards.

object
Id
string
nullable
Name
string
nullable
DisplayNameSingular
string
nullable
DisplayNamePlural
string
nullable
Kpis
Array<object>
nullable

Current operational metric headline value.

object
Key
string
nullable
Label
string
nullable
Value
number format: double
Unit
string
nullable
Severity
string
nullable
Series
Array<object>
nullable

One labeled operational metric series.

object
Metric
string
nullable
Operation
string
nullable
Stage
string
nullable
EntityDefinitionId
string
nullable
Status
string
nullable
Points
Array<object>
nullable

Aggregated operational metric bucket for charts and diagnostics.

object
BucketStartUtc
string format: date-time
Average
number format: double
Min
number format: double
Max
number format: double
Last
number format: double
Count
integer format: int64
SlowSamples
Array<object>
nullable

Persisted slow operational sample with per-stage timings.

object
Id
string
nullable
CreatedAt
string format: date-time
Operation
string
nullable
EntityDefinitionId
string
nullable
EntityInstanceId
string
nullable
Method
string
nullable
Path
string
nullable
CorrelationId
string
nullable
StatusCode
integer format: int32
DurationMs
number format: double
StageDurationsMs
object
key
additional properties
number format: double
Blockers
Array<object>
nullable

Current PostgreSQL blocking relationship.

object
BlockedPid
integer format: int32
BlockedWaitType
string
nullable
BlockedWaitEvent
string
nullable
BlockedAgeSeconds
number format: double
BlockedQuery
string
nullable
BlockerPid
integer format: int32
BlockerState
string
nullable
BlockerAgeSeconds
number format: double
BlockerQuery
string
nullable
WorkspaceUi

Read-only Workspace UI health projection shown by Monitoring.

object
Status
integer format: int32
Allowed values: 1 2 3
ReasonCode
string
nullable
IsConfigured
boolean
IsBuildToolchainReady
boolean
RuntimeStatus
integer format: int32
Allowed values: 0 1 2 3 4
CurrentRevisionNumber
integer format: int32
nullable
WorkingRevisionNumber
integer format: int32
nullable
NeedsValidation
boolean
LatestBuild

Latest Workspace UI check or build summary for Monitoring.

object
Id
string
nullable
BuildNumber
integer format: int32
Kind
integer format: int32
Allowed values: 0 1
Status
integer format: int32
Allowed values: 0 1 2 3 4
Stage
integer format: int32
Allowed values: 0 1 2 3 4 5 6 7 8 9 10 11 12
RequestedAt
string format: date-time
CompletedAt
string format: date-time
nullable
DurationMilliseconds
integer format: int64
nullable
QueuedBuildCount
integer format: int64
RunningBuildCount
integer format: int64
ActiveArtifact

Active Workspace UI artifact summary for Monitoring.

object
Id
string
nullable
ArtifactHash
string
nullable
Status
integer format: int32
Allowed values: 0 1 2 3 4
PublishedAt
string format: date-time
nullable
IsCompatible
boolean
RuntimeFailures
Array<object>
nullable

Count of one fixed Workspace UI runtime failure kind.

object
Kind
string
nullable
Count
integer format: int64
ExternalRequests
Array<object>
nullable

Managed external-request aggregate for one status family.

object
StatusFamily
string
nullable
Count
integer format: int64
AverageDurationMilliseconds
number format: double
MaximumDurationMilliseconds
number format: double
RecentDiagnostics
Array<object>
nullable

Reference to one bounded Workspace UI browser diagnostic DevLog entry.

object
Id
string
nullable
CreatedAt
string format: date-time
Level
integer format: int32
Allowed values: 0 1 2 3 4 5
Message
string
nullable
NextActionCode
string
nullable
RuntimeUnloadIncidents
Array<object>
nullable

Safe client-facing details for a collectible runtime unload incident.

object
Id

Incident identifier.

string
nullable
Status
integer format: int32
Allowed values: 0 1 2
RuntimeKind

Runtime kind: net_package or net_operation_project.

string
nullable
ProcessRole

Host process role: api or worker.

string
nullable
ProcessInstanceId

Opaque process-instance identifier.

string
nullable
EpochId

Runtime epoch identifier.

string
nullable
ArtifactId

Artifact identifier.

string
nullable
ArtifactHash

Artifact content hash.

string
nullable
SourceName

Package or project display name, when available.

string
nullable
SourceVersion

Package version, when available.

string
nullable
BuildId

Net Operation Project build identifier, when available.

string
nullable
BuildNumber

Net Operation Project build number, when available.

integer format: int32
nullable
RevisionId

Net Operation Project revision identifier, when available.

string
nullable
RevisionNumber

Net Operation Project revision number, when available.

integer format: int32
nullable
LoadedAtUtc

Timestamp when the epoch loaded.

string format: date-time
DisposedAtUtc

Timestamp when unload was requested.

string format: date-time
nullable
UnloadGcRequestedAtUtc

Timestamp when forced GC confirmation was requested.

string format: date-time
nullable
FirstObservedStuckAtUtc

First confirmed stuck observation.

string format: date-time
LastObservedAtUtc

Most recent observation by that process.

string format: date-time
ResolvedAtUtc

Timestamp when collection was later confirmed.

string format: date-time
nullable
UsageCount

Total usage observations recorded by the epoch.

integer format: int64
RecentUsages

Bounded non-sensitive correlation evidence.

Array<object>
nullable

Bounded, non-sensitive correlation evidence for one collectible runtime epoch.

object
Kind

Stable operation kind.

string
nullable
Key

Stable function, provider, strategy, or automation key.

string
nullable
ObservedAtUtc

Timestamp when the operation was observed.

string format: date-time
BusinessFunctionRunId

Business Function Run identifier, when the operation owns one.

string
nullable
Errors
Array<object>
nullable
object
Code
required
string
nullable
Message
required
string
nullable
Target
string
nullable
Field
string
nullable
Metadata
object
key
additional properties
string
nullable
Type
integer format: int32
Allowed values: 0 1 2
Severity
integer format: int32
Allowed values: 0 1 2
Warnings
Array<object>
nullable
object
Code
required
string
nullable
Message
required
string
nullable
Target
string
nullable
Field
string
nullable
Metadata
object
key
additional properties
string
nullable
Type
integer format: int32
Allowed values: 0 1 2
Severity
integer format: int32
Allowed values: 0 1 2
Success
boolean
Example
{
"Data": {
"WorkspaceUi": {
"Status": 1,
"RuntimeStatus": 0,
"LatestBuild": {
"Kind": 0,
"Status": 0,
"Stage": 0
},
"ActiveArtifact": {
"Status": 0
},
"RecentDiagnostics": [
{
"Level": 0
}
]
},
"RuntimeUnloadIncidents": [
{
"Status": 0
}
]
},
"Errors": [
{
"Type": 0,
"Severity": 0
}
],
"Warnings": [
{
"Type": 0,
"Severity": 0
}
]
}

Bad Request

Media typeapplication/json
object
Data

Operational metrics dashboard payload.

object
FromUtc
string format: date-time
ToUtc
string format: date-time
Entities
Array<object>
nullable

Entity definition label used by operational metrics dashboards.

object
Id
string
nullable
Name
string
nullable
DisplayNameSingular
string
nullable
DisplayNamePlural
string
nullable
Kpis
Array<object>
nullable

Current operational metric headline value.

object
Key
string
nullable
Label
string
nullable
Value
number format: double
Unit
string
nullable
Severity
string
nullable
Series
Array<object>
nullable

One labeled operational metric series.

object
Metric
string
nullable
Operation
string
nullable
Stage
string
nullable
EntityDefinitionId
string
nullable
Status
string
nullable
Points
Array<object>
nullable

Aggregated operational metric bucket for charts and diagnostics.

object
BucketStartUtc
string format: date-time
Average
number format: double
Min
number format: double
Max
number format: double
Last
number format: double
Count
integer format: int64
SlowSamples
Array<object>
nullable

Persisted slow operational sample with per-stage timings.

object
Id
string
nullable
CreatedAt
string format: date-time
Operation
string
nullable
EntityDefinitionId
string
nullable
EntityInstanceId
string
nullable
Method
string
nullable
Path
string
nullable
CorrelationId
string
nullable
StatusCode
integer format: int32
DurationMs
number format: double
StageDurationsMs
object
key
additional properties
number format: double
Blockers
Array<object>
nullable

Current PostgreSQL blocking relationship.

object
BlockedPid
integer format: int32
BlockedWaitType
string
nullable
BlockedWaitEvent
string
nullable
BlockedAgeSeconds
number format: double
BlockedQuery
string
nullable
BlockerPid
integer format: int32
BlockerState
string
nullable
BlockerAgeSeconds
number format: double
BlockerQuery
string
nullable
WorkspaceUi

Read-only Workspace UI health projection shown by Monitoring.

object
Status
integer format: int32
Allowed values: 1 2 3
ReasonCode
string
nullable
IsConfigured
boolean
IsBuildToolchainReady
boolean
RuntimeStatus
integer format: int32
Allowed values: 0 1 2 3 4
CurrentRevisionNumber
integer format: int32
nullable
WorkingRevisionNumber
integer format: int32
nullable
NeedsValidation
boolean
LatestBuild

Latest Workspace UI check or build summary for Monitoring.

object
Id
string
nullable
BuildNumber
integer format: int32
Kind
integer format: int32
Allowed values: 0 1
Status
integer format: int32
Allowed values: 0 1 2 3 4
Stage
integer format: int32
Allowed values: 0 1 2 3 4 5 6 7 8 9 10 11 12
RequestedAt
string format: date-time
CompletedAt
string format: date-time
nullable
DurationMilliseconds
integer format: int64
nullable
QueuedBuildCount
integer format: int64
RunningBuildCount
integer format: int64
ActiveArtifact

Active Workspace UI artifact summary for Monitoring.

object
Id
string
nullable
ArtifactHash
string
nullable
Status
integer format: int32
Allowed values: 0 1 2 3 4
PublishedAt
string format: date-time
nullable
IsCompatible
boolean
RuntimeFailures
Array<object>
nullable

Count of one fixed Workspace UI runtime failure kind.

object
Kind
string
nullable
Count
integer format: int64
ExternalRequests
Array<object>
nullable

Managed external-request aggregate for one status family.

object
StatusFamily
string
nullable
Count
integer format: int64
AverageDurationMilliseconds
number format: double
MaximumDurationMilliseconds
number format: double
RecentDiagnostics
Array<object>
nullable

Reference to one bounded Workspace UI browser diagnostic DevLog entry.

object
Id
string
nullable
CreatedAt
string format: date-time
Level
integer format: int32
Allowed values: 0 1 2 3 4 5
Message
string
nullable
NextActionCode
string
nullable
RuntimeUnloadIncidents
Array<object>
nullable

Safe client-facing details for a collectible runtime unload incident.

object
Id

Incident identifier.

string
nullable
Status
integer format: int32
Allowed values: 0 1 2
RuntimeKind

Runtime kind: net_package or net_operation_project.

string
nullable
ProcessRole

Host process role: api or worker.

string
nullable
ProcessInstanceId

Opaque process-instance identifier.

string
nullable
EpochId

Runtime epoch identifier.

string
nullable
ArtifactId

Artifact identifier.

string
nullable
ArtifactHash

Artifact content hash.

string
nullable
SourceName

Package or project display name, when available.

string
nullable
SourceVersion

Package version, when available.

string
nullable
BuildId

Net Operation Project build identifier, when available.

string
nullable
BuildNumber

Net Operation Project build number, when available.

integer format: int32
nullable
RevisionId

Net Operation Project revision identifier, when available.

string
nullable
RevisionNumber

Net Operation Project revision number, when available.

integer format: int32
nullable
LoadedAtUtc

Timestamp when the epoch loaded.

string format: date-time
DisposedAtUtc

Timestamp when unload was requested.

string format: date-time
nullable
UnloadGcRequestedAtUtc

Timestamp when forced GC confirmation was requested.

string format: date-time
nullable
FirstObservedStuckAtUtc

First confirmed stuck observation.

string format: date-time
LastObservedAtUtc

Most recent observation by that process.

string format: date-time
ResolvedAtUtc

Timestamp when collection was later confirmed.

string format: date-time
nullable
UsageCount

Total usage observations recorded by the epoch.

integer format: int64
RecentUsages

Bounded non-sensitive correlation evidence.

Array<object>
nullable

Bounded, non-sensitive correlation evidence for one collectible runtime epoch.

object
Kind

Stable operation kind.

string
nullable
Key

Stable function, provider, strategy, or automation key.

string
nullable
ObservedAtUtc

Timestamp when the operation was observed.

string format: date-time
BusinessFunctionRunId

Business Function Run identifier, when the operation owns one.

string
nullable
Errors
Array<object>
nullable
object
Code
required
string
nullable
Message
required
string
nullable
Target
string
nullable
Field
string
nullable
Metadata
object
key
additional properties
string
nullable
Type
integer format: int32
Allowed values: 0 1 2
Severity
integer format: int32
Allowed values: 0 1 2
Warnings
Array<object>
nullable
object
Code
required
string
nullable
Message
required
string
nullable
Target
string
nullable
Field
string
nullable
Metadata
object
key
additional properties
string
nullable
Type
integer format: int32
Allowed values: 0 1 2
Severity
integer format: int32
Allowed values: 0 1 2
Success
boolean
Example
{
"Data": {
"WorkspaceUi": {
"Status": 1,
"RuntimeStatus": 0,
"LatestBuild": {
"Kind": 0,
"Status": 0,
"Stage": 0
},
"ActiveArtifact": {
"Status": 0
},
"RecentDiagnostics": [
{
"Level": 0
}
]
},
"RuntimeUnloadIncidents": [
{
"Status": 0
}
]
},
"Errors": [
{
"Type": 0,
"Severity": 0
}
],
"Warnings": [
{
"Type": 0,
"Severity": 0
}
]
}

Forbidden

Media typeapplication/json
object
type
string
nullable
title
string
nullable
status
integer format: int32
nullable
detail
string
nullable
instance
string
nullable
key
additional properties
Examplegenerated
{
"type": "example",
"title": "example",
"status": 1,
"detail": "example",
"instance": "example"
}