Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Discussion thread: here

JIRA: here

The proposal discussed in this KIP is implemented in this pull request.

Please keep the discussion on the mailing list rather than commenting on the wiki (wiki discussions get unwieldy fast).

...

TypeNameDescription
RecordrecordThe record which caused the exception (if available).
Stage[] stagesAn ordered array of stages.
intindexThe index into the above array to the stage A pointer to a stage in the array where the failure occurred.
stringexceptionThe exception, and stacktrace for the failure (if available).
int32attemptNumber of attempts made to correct the failure.
stringtask_idThe id of the task which where the failure occurred.
int64time_of_errorThe epoch time of failure.

where Record contains the following fields

key key
TypeNameDescription
stringtopicthe topic which this message was read from or will be written to.
int64  timestampthe timestamp of the Kafka message.
stringtimestamp_typethe type of the timestamp. One of: NO_TIMESTAMP_TYPE, CREATE_TIME or LOG_APPEND_TIME.
int32partitionthe partition which this message was read from or will be written to.SchemaAndValue
int64 timestampthe timestamp of the Kafka message.
SchemaAndValuekeythe key of the message.
SchemaAndValuevaluethe value of the message.
SchemaAndValueheadersthe headers of the message.
map<string, string>source_partitioninformation about the source partition from where this message was created from (usually, specific to a source connector implementation).
map<string, string>source_offsetinformation about the source offset from where this message was created from (usually, specific to a source connector implementation).

and SchemaAndValue is:

int64offsetthe offset of the message in the Kafka topic (available only in sink connectors).
stringtimestamp_typethe type of the timestamp. One of: NO_TIMESTAMP_TYPE, CREATE_TIME or LOG_APPEND_TIME (available only in sink connectors).
map<string, string>source_partitioninformation about the source partition from where this message was created from (available only in source connectors and contents are specific to the implementation).
map<string, string>source_offsetinformation about the source offset from where this message was created from (available only in source connectors and contents are specific to the implementation).

and SchemaAndValue is:

TypeNameTypeNameDescription
stringschemathe data type of the value. For example, "BYTES", or "STRUCT"
string valuea string encoding of the value. If the type is "BYTES", then this value must be base64 decoded to obtain the original byte[]. If not, it is a JSON representation of the Connect record.

Finally, the Stage object describes the different operations performed in a Connector pipeline:

TypeNameDescription
stringtypethe operation type. For example, TRANSFORMATION, KEY_CONVERTER or TASK_PULL.
map<string, string> configthe properties used to configure this object.
stringclassthe classname of the object performing this operation.

Metrics

The following new metrics will monitor the number of failures, and the behavior of the response handler. Specifically, the following set of counters:

...