This endpoint provides information about errors that occur during Fetch, Transformation, or Import. You can respond to an error with:
- ACK_URL, which makes it disappear from Adverity's UI, or;
- RETRY_URL, to repeat the most recent operation.
Note: After an API or Destination was temporarily unavailable, or a Transformation was adapted, retrying will acknowledge the error automatically and execute all consecutive tasks as originally scheduled. This endpoint also supports an additional parameter: ?show_issue_tags=true. Append it to the URL in order to display the additional fields extraction_stage_label, error_cause_label & error_resolution_label.
To see a list of errors, perform a GET request:
curl -X GET \
'https://YOUR_STACK.datatap.adverity.com/api/errors/' \
-H 'Authorization: Token TOKEN_VALUE' \
Result (cropped to show only one issue):
{
"count": XX,
"next": null,
"previous": null,
"results": [
{
"id": ERROR_ID,
"start": "YYYY-MM-DDTHH:MM:SSZ",
"end": "YYYY-MM-DDTHH:MM:SSZ",
"duration": "0s",
"message": "This error occurred.",
"type_label": "General",
"datastream": {
"id": DATASTREAM_ID,
"stack_id": STACK_ID,
"stack": {
"add_connection_url": "/core/authorization/add/",
"add_datastream_url": "/core/apidatastream/add/",
"change_url": "/core/stack/STACK_ID/change/",
"datalake": "https://YOUR_STACK.adverity.com/api/storage/STORAGE_ID/",
"destination": DESTINATION_ID,
"extracts_url": "/core/datastreamextract/?stack_id=STACK_ID",
"issues_url": "/core/datastreamextractionlog/?ack__exact=0&stack_id=STACK_ID",
"id": STACK_ID,
"name": "STACK_NAME",
"overview_url": "/STACK_SLUG/",
"parent": "https://YOUR_STACK.datatap.adverity.com/api/stacks/PARENT/",
"parent_id": PARENT_ID,
"slug": "STACK_SLUG",
"url": "https://YOUR_STACK.datatap.adverity.com/api/stacks/STACK_SLUG/",
"counts": {
"connections": XX,
"datastreams": ZZ
},
"permissions": {
"isDatastreamManager": true
},
"default_manage_extract_names": true
},
"name": "DATASTREAM_NAME",
"slug": "DATASTREAM_SLUG",
"app_label": "APP_LABEL",
"absolute_url": "https://YOUR_STACK.datatap.adverity.com/APP_LABEL/DATASTREAM_ID/DATASTREAM_SLUG/",
"change_url": "/APP_LABEL/APP_LABELdatastream/DATASTREAM_ID/change/",
"extracts_url": "/datastream/DATASTREAM_ID/extracts/all",
"fetch_url": "https://YOUR_STACK.datatap.adverity.com/APP_LABEL/DATASTREAM_ID/DATASTREAM_SLUG/?action=fetch",
"overview_url": "/STACK_SLUG/DATASTREAM_SLUG-DATASTREAM_ID/",
"enabled": false,
"next_run": "Disabled",
"url": "https://YOUR_STACK.datatap.adverity.com/api/datastreams/DATASTREAM_ID/",
"datastream_type_id": DATASTREAM_TYPE_ID,
"logo_url": "/static/images/api/APP_LABEL.svg",
"extracts_stream_url": "/api/datastreams/DATASTREAM_ID/extracts/streaming/download/",
"supports_extended_intervals": false,
"updated": "YYYY-MM-DDTHH:MM:SSZ",
"creator": "CREATOR_USERNAME"
},
"extract": null,
"ack": false,
"ack_url": "/api/errors/ERROR_ID/confirm/",
"retry_url": "/api/errors/ERROR_ID/retry/",
"mapping_table_change_url": null,
"mapping_entries_change_url": null,
"target_column_change_url": null,
"transformation_config_url": null,
"url": "https://YOUR_STACK.datatap.adverity.com/api/errors/ERROR_ID/",
"datastream_insights_url": null
}
]
}
Comments
0 comments
Article is closed for comments.