Workflows

Diagnostics

Find recent errors and look up an exact request or event reference.

Review recent errors

Use an authenticated wholesale session. Summary counts stored error rows over 1–168 hours. List returns the newest matching rows, groups repeated event IDs in the result, and accepts a 1–720 hour window and up to 100 rows.

finoctl wholesale diagnostics summary --hours 24
finoctl wholesale diagnostics list --hours 24 --limit 25 --severity error
finoctl wholesale diagnostics list --source ios-admin --limit 25

A response with limit_reached: true is bounded. Use a narrower time window or an exact reference to focus the result.

Find an exact reference

Use the request ID or event ID from a reported error. A transport failure without a server response may provide no searchable reference.

finoctl wholesale diagnostics find "$DIAGNOSTIC_ID" --hours 168

Read error status

DIAGNOSTICS_UNAVAILABLE means the server could not provide results. INVALID_RESPONSE means the result could not be validated. A successful response with a zero count confirms zero stored rows within the selected scope.

Include the command, error code, and exact diagnostic ID when contacting support. Keep order details and credentials in their approved channels.