On this page

Use task instances to follow long-running Golden work. Use product events to follow records waiting for or failing delivery through configured destinations.

Before you begin

Task administration and every product-event operation require ADMIN. You need the entity, task, or destination identifier associated with the operation you are diagnosing.

Follow a task

  1. Open Tasks and select the Executions view.
  2. Locate the task created by the operation, using its identifier and start time rather than its name alone.
  3. Follow it until it reaches a terminal state.
  4. Read the task’s progress and messages before deciding on recovery.

Use the canonical task status reference to distinguish active and terminal states. Do not start another copy while work is active; duplicate runs can repeat data-changing operations.

Review schedules

  1. Open the Schedulings view.
  2. Confirm that the intended scheduling is enabled.
  3. Review its schedule before changing it or choosing Run now.
  4. After a scheduled start, locate the new task instance and follow its result.

Changing a schedule affects future runs. Running it immediately creates a separate execution and does not replace the schedule.

Review destination events

  1. Open Events.
  2. Select the destination whose delivery outcome you need to inspect.
  3. Filter the view to valid or invalid events as appropriate, or search for one event by its identifier.
  4. Review the event’s record and operation, its failed deliveries and its error.
  5. Resolve the destination or data issue.
  6. Select Activate and confirm in Mark event as valid to queue the event again. It is queued behind newer events; an event that is already valid cannot be revalidated.

Deleting or clearing events can remove pending delivery work. Use those actions only under an approved recovery procedure.

Inspect events through the API

List one destination’s events:

curl --fail-with-body --silent --show-error \
  --header "Authorization: Bearer ${GOLDEN_ADMIN_TOKEN}" \
  "${GOLDEN_URL}/api/events/sink/${SINK_ID}?filter=INVALID&pageNumber=0&pageSize=10"

filter accepts ALL, VALID, or INVALID. Narrow the list with entityId, tableId, recordId, operation or operationId; the members an event reports and the list’s order are in the product event reference. Treat payload as customer data and exclude it from ordinary support requests.

Use GET /api/events/id/{id} for one event. Retry an invalid event with PUT /api/events/valid/{id}, delete one with DELETE /api/events/id/{id}, or clear one destination’s events with DELETE /api/events/sink/{id}. What a revalidation answers, and why it can leave a JDBC or Golden-table row unchanged, is in Revalidate an event.

Read destination statistics

GET /api/events/stats reports, per destination:

  • stalled, whether delivery is currently waiting;
  • nextCheck, the next reported retry time when stalled; and
  • eventsCount, the number of events pending delivery.

Use these fields to distinguish an empty queue from a destination that is waiting to retry. Do not infer infrastructure health from them.

Verify the result

  • The task reaches SUCCEEDED, or the event no longer appears as invalid.
  • The affected entity returns to its expected state.
  • A read or destination-side verification confirms the intended records are available.

If the problem continues

Collect the product version, time range, entity or destination identifier, task or event identifier, terminal status, X-Trace-Id, and displayed error messages. Do not include tokens, customer record contents, or internal diagnostic data in a support request unless an approved secure channel requests them.

Golden 3.4.0 · Published 2026-10-29