Ingestion errors reference

AI summary

Lists common Imply Lumi event ingestion error codes including authentication failures, missing fields, and invalid data formats, with guidance on identifying and resolving these issues.

About AI summaries.

If your events aren't reaching Imply Lumi, look for error messages in your client-side application or in the unparsable events view. The errors can pinpoint issues in authentication or data formatting that prevent Lumi from receiving or ingesting your events.

When you have errors with ingestion, also review the following:

• Confirm that you have the correct permissions on your account and that you enabled the integration on your IAM key.
• If you're using S3 pull, verify that you've correctly configured your AWS permissions policy, trust policy, and IAM role.
• Revisit your forwarding configuration to check that you're using the correct URL and any additional required settings.
• For batch ingestion methods, ensure your events are in a compatible format.

This topic describes possible ingestion errors that Lumi returns and how to resolve them.

For more information, see Troubleshoot data ingestion.

Authentication

Authentication errors signify that you don't have the correct credentials to send events to Lumi.

Error message	What it means	What to do
Token is required	The IAM key token is missing from the request.	Verify that you supplied the IAM key token.
Invalid token	The IAM key token is invalid.	Verify that your IAM key token is correct.
Missing \"[integration]\" key from IAM key attributes	The IAM key isn't enabled for the integration.	Edit the key to add the integration.

Missing or empty fields

If your data forwarding request doesn't include event information, Lumi returns one of the following errors.

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 isn't 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

Lumi returns one of the following errors when it can't parse the structure of your raw data.

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.
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.