Troubleshoot data ingestion
When you send events to Imply Lumi, ingestion errors such as unparseable events can occur. These are raw events that Lumi can't convert into a valid format.
This topic describes common ingestion error codes related to unparsable events and provides troubleshooting strategies.
For information about event ingestion, see Send events. To understand the current scope of Lumi, review the known limitations.
View ingestion errors
Lumi shows the number of unparsable events for the past 24 hours for each IAM key on the Keys page. If a key has unparsable events, its details page shows the total count along with the associated error codes.
Click a key in the IAM keys list to access its details.
Troubleshoot ingestion issues
Lumi displays error codes to help you troubleshoot issues related to ingesting events.
This section lists common ingestion error codes and ways to resolve them.
Missing or empty fields
| Error code | What it means | What to do |
|---|---|---|
EventFieldCannotBeBlank | The event field is empty. | Verify that your event field contains valid data. Make sure that the event field is not an empty string, null, or whitespace. |
EventFieldRequired | The event field is missing. | Verify that your payload includes an event field. The event field is required and must contain valid data. |
Invalid data format
| Error code | What it means | What to do |
|---|---|---|
InvalidDataFormat | Event structure or field types don't match the expected schema. | Make sure that your event fields use the correct data types. For details on the Lumi event structure, see Event model. |
InvalidJsonPayload | The JSON payload is invalid. | Make sure that your JSON is correctly formatted. Address any formatting issues, such as missing brackets, trailing commas, or other syntax, before resending the event. |
System errors
| Error code | What it means | What to do |
|---|---|---|
ErrorInHandlingIndexedFields | Lumi encountered a problem processing the fields object in the submitted event. | Make sure that the fields value is a flat JSON object. Nested objects and arrays are unsupported. |
Contact Lumi support
For additional assistance, contact Lumi customer support.