Dead-letter queue in Cloud Functions
The Dead Letter Queue (DLQ) is a queue for messages that could not be processed by a triggered Cloud Functions function. A message is considered processed if the function that received it ended successfully. Messages moved to the DLQ are stored there for further analysis.
If the function failed to process a message within the specified number of attempts, the message is moved to the DLQ. The number of function invocation attempts and the DLQ are specified in the redrive policy. The DLQ in Cloud Functions can only be a standard queue.
If no redrive policy is configured, the messages that the function failed to process are deleted.
The redrive policy
The redrive policy defines the conditions for moving messages to the DLQ.
To configure the redrive policy for all triggers except a trigger for Yandex Message Queue, specify the following when creating a trigger:
- The queue to move messages to.
- Service account with rights to write messages to the queue.
- The time after which the function will be invoked again if the current attempt fails.
- The number of invocation retries before the trigger moves a message to the queue.
The redrive policy for the Yandex Message Queue trigger is configured when creating a source queue for messages that are processed by the triggered function.
The message keeps its ID after moving to the DLQ.