HIhify
Admin Diagnostics

Diagnose late or missing footage for a game or arena window

Admin-only diagnostic that classifies when footage for a window arrived (on_time, late, missing) and names the most likely cause, using arena video metadata, previews, sibling arenas and recorder telemetry from Grafana Cloud Prometheus. Returns the same fields as one row of the diagnostics:content_gaps rake task CSV.

Provide a scope in one of two mutually exclusive modes:

  • Game mode: pass game_id. The arena and time window are derived from the game.
  • Arena window mode: pass arena_id, start_time and end_time (all three required). start_time and end_time must be ISO8601 timestamps, end_time must be after start_time, and the window may span at most 7 days.
get/v1/admin/diagnostics/content_gap

Request

  • Base URL
    https://api.hify.club
  • Auth
    API key in header X-User-Token

Query parameters

game_idinteger

Game to diagnose. When present, the request is treated as game mode and arena_id/start_time/end_time are ignored.

arena_idinteger

Arena to diagnose. Required in arena window mode.

start_timestring date-time

ISO8601 start of the window. Required in arena window mode.

end_timestring date-time

ISO8601 end of the window; must be after start_time and within 7 days of it. Required in arena window mode.

Response

Content gap diagnosis

game_idinteger nullable

Null in arena window mode.

game_created_atstring date-time nullable
facility_idinteger
facility_namestring
arena_idinteger
arena_namestring
arena_enabledboolean
start_timestring date-time
end_timestring date-time
finalboolean

False only for missing windows that ended less than 12 hours ago, whose footage may still arrive.

bucket'on_time' | 'late' | 'missing'
cause'no_telemetry' | 'wrong_arena' | 'analyzer_missed' | 'detected_not_ingested' | 'upload_outage' | 'slow_upload' | 'upload_failures' | 'unexplained' | 'null' nullable
delay_minutesinteger nullable

First footage arrival minus end_time.

avm_countinteger
preview_countinteger
preview_first_arrival_minutesinteger nullable
own_gameplay_decisionsinteger
own_non_gameplay_decisionsinteger
top_decision_reasonsstring

Space-separated reason:count pairs, most frequent first.

sibling_arena_idinteger nullable
sibling_avm_countinteger nullable
sibling_gameplay_detectedboolean nullable
booked_siblings_with_avmstring

Space-separated ids of sibling arenas with footage and their own game.

later_footage_ingestedboolean
facility_avg_upload_s_per_segmentnumber nullable
facility_baseline_upload_s_per_segmentnumber nullable
facility_upload_failuresinteger
longest_upload_gap_minutesinteger
longest_telemetry_gap_minutesinteger
same_slot_game_idsstring

Space-separated ids of other games overlapping this window on the arena.

Changes

No recorded changes to this operation across all 1 revision of this API.