Error Codes Reference
This page provides a complete reference of error codes produced by the Data Focus – Discovery Service. It is intended to support troubleshooting and operational diagnostics.
For step-by-step issue resolution, refer to the Troubleshooting.
Error Code Groups
| Range |
Category |
| -30xx |
Sampler |
| -31xx |
Metadata |
| -32xx |
Kafka (Sampler context) |
| -33xx |
Kafka (Metadata context) |
| -34xx |
Pipeline Lifecycle |
| -35xx |
API / Connection Test |
| -36xx |
Data View |
| -39xx |
General / Unexpected |
Sampler Errors (-30xx)
| Error Code |
Error Type |
Title |
Description |
HTTP Status |
| -3001 |
SAMPLER_QUERY_FAILED |
Sampler query failed |
Sampler query execution failed due to an internal error or invalid query. |
500 |
| -3002 |
SAMPLER_QUERY_TIMEOUT |
Sampler query timed out |
Sampler query exceeded the configured execution timeout. |
504 |
| -3003 |
SAMPLER_INITIALIZATION_FAILED |
Sampler initialization failed |
Sampler could not be initialized due to configuration or runtime errors. |
500 |
| Error Code |
Error Type |
Title |
Description |
Status Type |
HTTP Status |
| -3101 |
METADATA_EXTRACTION_FAILED |
Metadata extraction failed |
Metadata extraction failed for the specified entity. |
failed |
500 |
Kafka Errors – Sampler Context (-32xx)
| Error Code |
Error Type |
Title |
Description |
HTTP Status |
| -3201 |
KAFKA_SAMPLER_SEND_FAILED |
Sampler data could not be sent to Kafka |
Failed to publish sampler data to the Kafka topic. |
503 |
Kafka Errors – Metadata Context (-33xx)
| Error Code |
Error Type |
Title |
Description |
HTTP Status |
| -3301 |
KAFKA_METADATA_SEND_FAILED |
Metadata could not be sent to Kafka |
Failed to publish metadata to the Kafka topic. |
503 |
Pipeline Lifecycle Errors (-34xx)
| Error Code |
Error Type |
Title |
Description |
Status Type |
HTTP Status |
| -3401 |
PIPELINE_START_FAILED |
Pipeline start failed |
Pipeline could not be started due to initialization errors. |
failed |
500 |
| -3402 |
PIPELINE_CREATE_FAILED |
Pipeline create failed |
Failed to create required pipeline resources. |
failed |
500 |
| -3410 |
PIPELINE_ABORTED |
Pipeline aborted |
Pipeline execution was aborted successfully. |
aborted |
409 |
| -3411 |
PIPELINE_ABORT_FAILED |
Pipeline abort failed |
Abort request failed for the specified pipeline run. |
abort_failed |
500 |
| -3420 |
PIPELINE_PAUSE_FAILED |
Pipeline pause failed |
Pipeline pause operation failed. |
pause_failed |
500 |
| -3421 |
PIPELINE_NO_ACTIVE_JOB |
No active job found |
No active pipeline job exists for the given run ID. |
pause_failed |
500 |
| -3430 |
PIPELINE_RUN_ID_MISMATCH |
Pause request ignored: run ID mismatch |
Pause request rejected due to run ID mismatch. |
pause_failed |
400 |
| -3431 |
PIPELINE_PAUSE_UPDATES_FAILED |
Pipeline pause updates failed |
Failed to apply pause updates for the pipeline run. |
pause_failed |
500 |
| -3440 |
PIPELINE_NO_PAUSED_TASKS |
No paused tasks found to resume |
Resume request failed because no paused tasks exist. |
pause_resume_failed |
400 |
| -3450 |
PIPELINE_SERVICE_CONFIG_FAILED |
Pipeline service configuration failed |
Failed to apply service configuration for the pipeline. |
failed |
500 |
| -3460 |
KAFKA_PIPELINE_STATUS_SEND_FAILED |
Pipeline status message could not be sent to Kafka |
Failed to publish pipeline status message to Kafka. |
failed |
503 |
API & Connection Errors (-35xx)
| Error Code |
Error Type |
Title |
Description |
HTTP Status |
| -3501 |
INVALID_CONNECTION_TYPE |
Invalid connection type |
Unsupported connection type provided. |
400 |
| -3502 |
CONFIG_VALIDATION_FAILED |
Configuration validation failed |
Connection or pipeline configuration validation failed. |
400 |
| -3503 |
URL_GENERATION_FAILED |
Connection URL generation failed |
Failed to generate the required connection URL. |
400 |
| -3504 |
CONNECTION_TEST_FAILED |
Database connection test failed |
Connection test to the database failed. |
400 |
| -3505 |
DATASOURCE_NOT_FOUND |
Datasource not found |
Requested datasource does not exist. |
404 |
Data View Errors (-36xx)
| Error Code |
Error Type |
Title |
Description |
HTTP Status |
| -3601 |
INVALID_PIPELINE_ENTITY |
Invalid pipeline configuration |
Pipeline entity or configuration is invalid. |
400 |
| -3602 |
CONNECTION_CREATION_FAILED |
Connection handler could not be created |
Failed to create a connection handler instance. |
400 |
| -3603 |
DATA_FETCH_VALIDATION |
Data fetch validation failed |
Input validation failed during data fetch operation. |
400 |
| -3604 |
DATA_FETCH |
Data fetch failed |
Data fetch operation failed. |
400 |
General & Unexpected Errors (-39xx)
| Error Code |
Error Type |
Title |
Description |
HTTP Status |
| -3901 |
INTERNAL_SERVER_ERROR |
Internal server error |
An internal server error occurred. |
500 |
| -3902 |
UNEXPECTED_ERROR |
An unexpected error occurred |
An unhandled or unexpected error occurred. |
500 |
| -3903 |
DECRYPTION_FAILED |
Encryption/decryption failed |
Encryption or decryption operation failed. |
500 |
| -3904 |
HEALTH_CHECK_FAILED |
System health check failed |
One or more system health checks failed. |
503 |
Pipeline Status Types
| Status Type |
Description |
| failed |
General pipeline, sampler, or metadata failure |
| aborted |
Pipeline aborted successfully |
| abort_failed |
Abort operation itself failed |
| paused |
Pipeline paused successfully |
| pause_failed |
Pause operation failed |
| pause_resume_failed |
Resume-from-pause operation failed |
| success |
Pipeline completed successfully |