Printago API
GET /v1/reports/reliability

Reliability report

Attempt outcomes, retry yield, failure pareto and per-machine MTBF.

Requires: analytics.view

Query Parameters

start required
string
end required
string
printerIds optional
string
Comma-separated printer ids; omitted = all printers.

Response Schema

ReliabilityReport
attemptsByDayrequired
object[]
cancelledrequired
number
completedrequired
number
daterequired
string
failedrequired
number
coveragerequired
object
Denominators for the coverage indicator every report panel shows. print_history material/estimate fields are snapshots that can be absent; charts must state what fraction of attempts they actually cover.
attemptsrequired
number
withGramsrequired
number
withLayersrequired
number
withQueueTimesrequired
number
withTimeEstimaterequired
number
withWeightEstimaterequired
number
failureParetorequired
object[]
health-error / print-error event codes, descending count.
coderequired
string
countrequired
number
layerHistogramrequired
object[]
Failed attempts bucketed by completedLayers/totalLayers. bucketStart is the inclusive lower bound in percent (0, 5, … 95).
bucketStartrequired
number
countrequired
number
mtbfrequired
object[]
failuresrequired
number
mtbfHoursrequired
number
printerDeviceIdrequired
string
printerNamerequired
string
printingHoursrequired
number
rangerequired
object
daysrequired
number
endrequired
string
startrequired
string
timezonerequired
string
totalsrequired
object
attemptsrequired
number
cancelledrequired
number
completedrequired
number
failedrequired
number
wastedGramsrequired
number
wastedHoursrequired
number
wasteByDayrequired
object[]
Grams + machine-hours on failed/cancelled attempts, per day.
daterequired
string
gramsrequired
number
hoursrequired
number
yieldrequired
object
jobsFinishedrequired
number
Distinct jobs in range whose final attempt completed.
jobsFirstTryrequired
number
Jobs that completed on attempt 1 with no retries.
retriedJobsrequired
number
retryGramsrequired
number
Grams burned on non-final attempts of eventually-completed jobs.

Example Response

200 OK — application/json 
{
  "range": {
    "start": "string",
    "end": "string",
    "timezone": "string",
    "days": 1
  },
  "coverage": {
    "attempts": 1,
    "withGrams": 1,
    "withLayers": 1,
    "withTimeEstimate": 1,
    "withWeightEstimate": 1,
    "withQueueTimes": 1
  },
  "attemptsByDay": [
    {
      "date": "string",
      "completed": 1,
      "failed": 1,
      "cancelled": 1
    }
  ],
  "wasteByDay": [
    {
      "date": "string",
      "grams": 1,
      "hours": 1
    }
  ],
  "yield": {
    "jobsFinished": 1,
    "jobsFirstTry": 1,
    "retriedJobs": 1,
    "retryGrams": 1
  },
  "failurePareto": [
    {
      "code": "string",
      "count": 1
    }
  ],
  "layerHistogram": [
    {
      "bucketStart": 1,
      "count": 1
    }
  ],
  "mtbf": [
    {
      "printerDeviceId": "string",
      "printingHours": 1,
      "failures": 1
    }
  ],
  "totals": {
    "attempts": 1,
    "completed": 1,
    "failed": 1,
    "cancelled": 1,
    "wastedGrams": 1,
    "wastedHours": 1
  }
}