Skip to main content

Health Checks

Health checks emit 2 events

  1. check.passed
  2. check.failed

Environment variables

FieldDescriptionSchemaOptional
canaryThe parent canary objectCanary
checkThe checkCheck
agentAgent details (if applicable)Agenttrue
statusCheck status detailsCheckStatus
permalinkA link to the health checkstring

Canary

FieldDescriptionSchemaOptional
idThe id of the canaryuuid
nameThe name of the canarystring
namespaceThe namespace of the canarystring
agent_idThe agent id of the canarystring
labelsThe labels of the canarymap[string]stringtrue
sourceThe source of the canarystring
created_atThe created at of the canarystring
updated_atThe updated at of the canarystring
deleted_atThe deleted at of the canarystringtrue

Check

FieldDescriptionSchemaOptional
idThe id of the checkuuid
typeThe type of the checkstring
nameThe name of the checkstring
labelsThe labels of the checkmap[string]stringtrue
descriptionThe description of the checkstring
statusCheck status detailsstring
severityThe severity of the checkstringtrue
uptimeThe past 1 hour uptime summaryUptimetrue
latencyThe past 1 hour latency summaryLatencytrue
transformedWhether the check has been transformedbool
last_runtimeThe last runtime of the checktime.Timetrue
next_runtimeThe next runtime of the checktime.Timetrue
last_transition_timeThe last transition time of the checktime.Timetrue
created_atThe created at of the checktime.Time
updated_atThe updated at of the checktime.Time
deleted_atThe deleted at of the checktime.Timetrue

Uptime

FieldDescriptionSchemaOptional
passedThe number of checks that passedint
failedThe number of checks that failedint
p100The percentage of checks that passedfloat64
last_passThe last time a check passedtime.Timetrue
last_failThe last time a check failedtime.Timetrue

Latency

FieldDescriptionSchemaOptional
p99The latency of the checkfloat64true
p97The latency of the checkfloat64true
p95The latency of the checkfloat64true
rolling1hThe latency of the checkfloat64

Agent

FieldDescriptionSchemaOptional
idThe id of the agentuuid
nameThe name of the agentstring
descriptionShort description of the agentstring

Check Status

FieldDescriptionSchemaOptional
check_idThe id of the check associated with this statusuuid
statusThe status of the checkbool
invalidWhether the check errored outbool
timeThe time of the checkstring
durationThe duration of the checkint
messageThe success message of the checkstring
errorThe error of the check in case of failurestring
created_atThe created at of the checktime.Time