These are logged but don’t provide much detail, ideally the error message would include a title, description, and a recovery suggestion.
The title should cover what the Lambda was attempting to do that failed e.g. "Couldn’t retrieve Buildkite metrics for the queue queue"
The description should provide more detail on what went wrong when trying to "do" the title e.g. "The Buildkite Agent token retrieved from (ENV VAR / SSM Parameter) was rejected" replacing where the token was retrieved from with the actual place the token was retrieved from based on runtime configuration.
The recovery suggestion should describe what action the user can take to fix the error e.g. "Retrieve or generate a new Buildkite Agent token from https://buildkite.com/organizations/-/agents and update the (ENV VAR / SSM Parameter) with the value".
These are logged but don’t provide much detail, ideally the error message would include a title, description, and a recovery suggestion.
The title should cover what the Lambda was attempting to do that failed e.g. "Couldn’t retrieve Buildkite metrics for the
queuequeue"The description should provide more detail on what went wrong when trying to "do" the title e.g. "The Buildkite Agent token retrieved from (ENV VAR / SSM Parameter) was rejected" replacing where the token was retrieved from with the actual place the token was retrieved from based on runtime configuration.
The recovery suggestion should describe what action the user can take to fix the error e.g. "Retrieve or generate a new Buildkite Agent token from https://buildkite.com/organizations/-/agents and update the (ENV VAR / SSM Parameter) with the value".