diff --git a/docs/guides/operator-guide-aws-marketplace.md b/docs/guides/operator-guide-aws-marketplace.md index 9cc92a4c0..9a4f87955 100644 --- a/docs/guides/operator-guide-aws-marketplace.md +++ b/docs/guides/operator-guide-aws-marketplace.md @@ -13,6 +13,7 @@ import SnptUpgradePolicy from '../snippets/_snpt-private-operator-upgrade-policy import SnptPreparingEmailsAndPhoneNumbers from '../snippets/_snpt-preparing-emails-and-phone-numbers.mdx'; import SnptAttestFailure from '../snippets/_snpt-private-operator-attest-failure.mdx'; import SnptRotatingTheKeys from '../snippets/_snpt-private-operator-rotating-the-keys.mdx'; +import SnptRuntimeErrors from '../snippets/_snpt-private-operator-runtime-errors.mdx'; # UID2 Private Operator for AWS Integration Guide @@ -379,7 +380,7 @@ Error codes for Private Operator issues are applicable only to release v5.49.7 a ### Startup Errors -The following errors occur during operator startup: +The following errors might occur during operator startup: | Error Code | Issue | Steps to Resolve | | :--- | :--- | :--- | @@ -392,11 +393,9 @@ The following errors occur during operator startup: ### Runtime Errors -The following errors occur during operator runtime: +The following errors might occur during operator runtime: -| Error Code | Issue | How to Identify in Logs | Steps to Resolve | -| :--- | :--- | :--- | :--- | -| E12 | Data Download Failure | Look for log messages containing `"E12: Data Download Failure"` along with `"Failed to load"` errors from `RotatingStoreVerticle`. These will include HTTP status codes (e.g., `"HTTP response code 403"`) or exception types (e.g., `"exception: IOException"`). | Check the HTTP status code or exception in the error message:
**404 errors** - Verify operator key is valid for the environment.
**403 errors** - Verify operator key and credentials are correct.
**Timeout errors** - Verify network connectivity, check firewall/security group settings allow outbound HTTPS (port 443), and ensure UID2 service endpoints are accessible.
**500/503 errors** - Temporary UID2 service issue, retry or contact UID2 support if persistent. | + ## Technical Support diff --git a/docs/guides/operator-guide-azure-enclave.md b/docs/guides/operator-guide-azure-enclave.md index d6a8faacc..38c198f31 100644 --- a/docs/guides/operator-guide-azure-enclave.md +++ b/docs/guides/operator-guide-azure-enclave.md @@ -13,6 +13,7 @@ import SnptUpgradePolicy from '../snippets/_snpt-private-operator-upgrade-policy import SnptPreparingEmailsAndPhoneNumbers from '../snippets/_snpt-preparing-emails-and-phone-numbers.mdx'; import SnptAttestFailure from '../snippets/_snpt-private-operator-attest-failure.mdx'; import SnptRotatingTheKeys from '../snippets/_snpt-private-operator-rotating-the-keys.mdx'; +import SnptRuntimeErrors from '../snippets/_snpt-private-operator-runtime-errors.mdx'; # UID2 Private Operator for Azure Integration Guide @@ -357,7 +358,7 @@ Error codes for Private Operator issues are applicable only to release v5.49.7 a ### Startup Errors -The following errors occur during operator startup: +The following errors might occur during operator startup: | Error Code | Issue | Steps to Resolve | | :--- | :--- | :--- | @@ -370,8 +371,6 @@ The following errors occur during operator startup: ### Runtime Errors -The following errors occur during operator runtime: +The following errors might occur during operator runtime: -| Error Code | Issue | How to Identify in Logs | Steps to Resolve | -| :--- | :--- | :--- | :--- | -| E12 | Data Download Failure | Look for log messages containing `"E12: Data Download Failure"` along with `"Failed to load"` errors from `RotatingStoreVerticle`. These will include HTTP status codes (e.g., `"HTTP response code 403"`) or exception types (e.g., `"exception: IOException"`). | Check the HTTP status code or exception in the error message:
**404 errors** - Verify operator key is valid for the environment.
**403 errors** - Verify operator key and credentials are correct.
**Timeout errors** - Verify network connectivity, check NSG/firewall rules allow outbound HTTPS (port 443), and ensure UID2 service endpoints are accessible.
**500/503 errors** - Temporary UID2 service issue, retry or contact UID2 support if persistent. | \ No newline at end of file + \ No newline at end of file diff --git a/docs/guides/operator-private-gcp-confidential-space.md b/docs/guides/operator-private-gcp-confidential-space.md index 95221c485..259dd3746 100644 --- a/docs/guides/operator-private-gcp-confidential-space.md +++ b/docs/guides/operator-private-gcp-confidential-space.md @@ -13,6 +13,7 @@ import SnptUpgradePolicy from '../snippets/_snpt-private-operator-upgrade-policy import SnptPreparingEmailsAndPhoneNumbers from '../snippets/_snpt-preparing-emails-and-phone-numbers.mdx'; import SnptAttestFailure from '../snippets/_snpt-private-operator-attest-failure.mdx'; import SnptRotatingTheKeys from '../snippets/_snpt-private-operator-rotating-the-keys.mdx'; +import SnptRuntimeErrors from '../snippets/_snpt-private-operator-runtime-errors.mdx'; # UID2 Private Operator for GCP Integration Guide @@ -553,7 +554,7 @@ Error codes for Private Operator issues are applicable only to release v5.49.7 a ### Startup Errors -The following errors occur during operator startup: +The following errors might occur during operator startup: | Error Code | Issue | Steps to Resolve | | :--- | :--- | :--- | @@ -566,8 +567,6 @@ The following errors occur during operator startup: ### Runtime Errors -The following errors occur during operator runtime: +The following errors might occur during operator runtime: -| Error Code | Issue | How to Identify in Logs | Steps to Resolve | -| :--- | :--- | :--- | :--- | -| E12 | Data Download Failure | Look for log messages containing `"E12: Data Download Failure"` along with `"Failed to load"` errors from `RotatingStoreVerticle`. These will include HTTP status codes (e.g., `"HTTP response code 403"`) or exception types (e.g., `"exception: IOException"`). | Check the HTTP status code or exception in the error message:
**404 errors** - Verify operator key is valid for the environment.
**403 errors** - Verify operator key and credentials are correct.
**Timeout errors** - Verify network connectivity, check VPC firewall rules allow outbound HTTPS (port 443), and ensure UID2 service endpoints are accessible.
**500/503 errors** - Temporary UID2 service issue, retry or contact UID2 support if persistent. | + diff --git a/docs/snippets/_snpt-private-operator-runtime-errors.mdx b/docs/snippets/_snpt-private-operator-runtime-errors.mdx new file mode 100644 index 000000000..3dbcf69ec --- /dev/null +++ b/docs/snippets/_snpt-private-operator-runtime-errors.mdx @@ -0,0 +1,4 @@ +| Error Code | Issue | How to Identify in Logs | Steps to Resolve | +| :--- | :--- | :--- | :--- | +| E12 | Data Download Failure | Look for log messages containing `E12: Data Download Failure` or `Failed to load` errors from `RotatingStoreVerticle`. These messages include HTTP status codes (for example, `HTTP response code 403`) or exception types (for example, `exception: IOException`). | Check the HTTP status code or exception in the error message and resolve accordingly:
**404 errors**: Verify that the operator key is valid for the environment.
**403 errors**: Verify that the operator key and credentials are correct.
**Timeout errors**: Verify network connectivity, check that firewall/security group settings allow outbound HTTPS (port 443), and ensure that the UID2 service endpoints are accessible.
**500/503 errors**: This code indicates a temporary UID2 service issue. Retry, and if the error persists contact UID2 support. | +