Add error descriptions and error code for general UID2 setup errors #792
There are no files selected for viewing
| Original file line number | Diff line number | Diff line change |
|---|---|---|
|
|
@@ -350,6 +350,23 @@ The following table includes some additional commands that might help you manage | |
| | Runs one iteration of `logrotate` manually, without changing the scheduled interval. | `sudo logrotate -f /etc/logrotate.conf --force` | | ||
| | Reloads `syslog-ng`. | `sudo /usr/sbin/syslog-ng-ctl reload` | | ||
|
|
||
| ## UID2 Operator Error Codes | ||
|
|
||
| The following table lists possible errors while setting up a Private Operator. | ||
|
|
||
| :::note | ||
| This applies only to Private Operators starting from Q2 2024. | ||
|
Contributor
There was a problem hiding this comment. This is not very clear - it somewhat sounds like existing private operator will magically show these error code from Q2 2024. Should be more like: Only Private Operators versions released on and after Q2 2024 will present these error codes if private operator startup issues are encountered
Contributor
Author
There was a problem hiding this comment. change to "Error codes for private operator startup issues will only appear in versions released from Q2 2024 onward." ?
Collaborator
There was a problem hiding this comment. Yes that's better. Though, best not to use future tense. My suggestion: |
||
| ::: | ||
|
|
||
| | Error Code | Issue | Steps to Resolve | | ||
| | :--- | :--- | :--- | | ||
| | AW01 | MissingInstanceProfile | Attach an IAM instance profile to the EC2 instance with the required permissions. The UID2 Operator needs these permissions to access configurations from AWS Secrets Manager. | | ||
abuabraham-ttd marked this conversation as resolved.
Show resolved
Hide resolved
|
||
| | AW02 | ConfigNotFound | Make sure that the secret referenced by the Private Operator exists in AWS Secrets Manager in the same region as the operator, and that the IAM instance profile has permission to access the secret. If needed, you can check the logs for the specific secret name and region. | | ||
| | AW03 | MissingConfig | Required attributes are missing in the configuration. Refer to the logs for details and update the missing attributes in Secrets Manager. | | ||
| | AW04 | InvalidConfigValue | A configuration value is invalid. Verify that the configuration values in the AWS Secrets Manager align with the required format and environment. Note `debug = true` is allowed only in the `integ` environment. Check the logs for mode details. | | ||
|
||
| | AW05 | InvalidOperatorKey | Ensure the operator key is correct for the environment and matches the one provided to you. | | ||
| | AW06 | UID2ServicesUnreachable | Allow UID2 core and opt-out service IP addresses in the egress firewall. Refer to logs for IPs and DNS details. | | ||
abuabraham-ttd marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
|
||
|
|
||
| ## Technical Support | ||
|
|
||
| If you have trouble subscribing to the product, or deploying, [contact us](mailto:[email protected]). | ||
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
The following table lists possible errors presented in the startup sequence of a Private Operator.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I will also change error codes to be just E01, E02 etc and not AW, AZ, GC. Since it is generic errors pointing to provider specific web page. (Also it minimizes conditions in generic exception handler)
See: https://github.com/IABTechLab/uid2-operator/pull/1232/files