at.happyproto.server.getScriptMetrics

How one of the caller's own instances' scripts ran in a window: every script that ran, or with trigger, one script's series. Customers only.

Repository @happyproto.at did:plc:mo7vq4jbioxwafy5zkcc3eux namespace authority

Details · query

Kind	query
Authority	server.happyproto.at
Indexed	3d ago · 2026-11-07

Compare Edit in builder → Fork →

Query

query · GET

Parameters

query string

id

requiredstring

The instance's UUID.

step

string

With trigger: how wide each point is. 1m and 30m suit 1h and 24h; 1h and 1d suit 7d and 30d. Defaults to the window's own.

knownValues: 1m | 30m | 1h | 1d

trigger

string

One script's trigger, such as xrpc.query:com.example.getThing, at most 400 characters. With it, the reply is that script's series; without it, every script that ran.

window

string

How far back to read. 1h and 24h come from the instance's memory; 7d and 30d from what it stored, as far back as it keeps.

default: "1h"
knownValues: 1h | 24h | 7d | 30d

Output

application/json

enabled

requiredboolean

Whether the instance is recording metrics at all.

points

array

With trigger: the window in steps, oldest first.

itemsref

Reference

#point

retentionDays

integer

On 7d and 30d: how many days the instance keeps, so a longer window covers only that.

script

ref

With trigger: the script, over the whole window.

Reference

#seriesScript

scripts

array

Without trigger: every script that ran in the window.

itemsref

Reference

#script

step

string

With trigger: how wide each point is.

knownValues: 1m | 30m | 1h | 1d

window

requiredstring

knownValues: 1h | 24h | 7d | 30d

Errors

InvalidRequest

The id is not a UUID, or the window, step or trigger is not one this method takes.

NotFound

No such instance, or it is not the caller's. These are indistinguishable.

ScriptNotRun

With trigger: that script has not run in the window.

MetricsUnavailable

The instance is not running, or its host cannot be reached.

MetricsBusy

Too many metrics reads are running for this instance or its host. Try again shortly.

MetricsTimeout

The instance's HappyView did not answer in time. Try again shortly.

NotSupported

The instance runs a HappyView too old to report its metrics. Upgrading it fixes this.

AuthRequired

This endpoint requires an authenticated caller.