Troubleshooting
If you recently added the bucket or upgraded the stack, if search volume is high, or if read/write volume is high, wait a few minutes and try again.
- 1.Open the bucket overview in the Quilt catalog and click the gear icon (upper right), or navigate to Admin settings > Buckets and inspect the settings of the bucket in question.
- 2.Under "Indexing and notifications", click "Re-index and Repair".
Optionally: if and only if bucket notifications are not working and you are certain that there are no other subscribers to the S3 Events of the bucket in question, check "Repair S3 notifications".
Bucket packages, stats, and the search index will repopulate in the next few minutes. Buckets with more than one million objects will take longer.
- 1.Determine your Quilt instance's ElasticSearch domain from Amazon Console > OpenSearch or
aws opensearch list-domain-names
. Note the domain name (hereafterQUILT_DOMAIN
). - 2.Run the following command and save the output file:aws es describe-elasticsearch-domain --domain-name "$QUILT_DOMAIN" > quilt-es-domain.json
- 3.Visit Amazon Console > OpenSearch >
QUILT_DOMAIN
> Cluster health. - 4.Set the time range as long as possible to fully overlap with your observed issues.
- 5.Screenshot the Summary, Overall Health, and Key Performance Indicator sections
- 6.
As a rule you should not reconfigure your Elasticsearch domain directly as this will result in stack drift that will be lost the next time you update your Quilt instance.
Package.set_dir()
on the package root (".") overrides package-level metadata. If you do not provideset_dir(".", foo, meta=baz)
with a value formeta=
,set_dir
will set package-level metadata toNone
.
A common pattern is to
Package.browse()
to get the most recent version of a package, and then Package.push()
updates. You can preserve package-level metadata when calling set_dir(".", ...)
as follows:import quilt3
p = quilt3.Package.browse(
"user-packages/geodata",
registry="s3://bucket_1"
)
p.set_dir(
".",
"s3://bucket_2/path/to/new/geofiles",
meta=p.meta
)
# Push changes to the S3 registry
p.push(
"user-packages/geodata",
registry="s3://bucket_1",
message="Updating package geodata source data"
)
There are two reasons for encountering the "Session expired" notice after clicking the
RELOAD
button in the Quilt Catalog.- 1.Your browser cache is out of date, in which case you need to:
- 1.Delete session storage
- 2.Delete local storage
- 3.Delete cookies
- 2.Your Quilt user Role has been corrupted. You will need a Quilt Admin user to reset your Quilt user Role to a default (and valid) Role.
Users can either be invited directly or are just-in-time provisioned (JIP) when they sign in via SSO and receive the "default role."
- If an admin (or any user) is created by JIP, or created through CloudFormation with an SSO Provider set to anything other than Disabled, then setting the password for that user has no effect and password login will never succeed for that user. Said another way, users created through SSO can only log in through SSO.
- You must disable SSO and enable
PasswordAuth
if you wish to log in as an admin using a password (as opposed to SSO).
If you need to change the admin (e.g. you have accidentally broken your admin user) try the following:
- 1.Change the value of the
AdminEmail
CloudFormation parameter. - 2.Apply the change as a stack Update.
- 3.Once the update is successful, the new admin can log in, set roles, and nominate other admins as needed.
On rare occasions, Quilt stack deployment updates might fail. This can happen for several reasons. To expedite resolution of stack deployment issues, it's helpful to have the following data and output from the following AWS CLI commands when contacting [email protected].
- 1.Quilt stack outputs:STACK_NAME="YOUR_QUILT_STACK"aws cloudformation describe-stacks \--stack-name "$STACK_NAME" \--query 'Stacks[].Outputs'
- 2.Initiate drift detection:aws cloudformation detect-stack-drift \--stack-name "$STACK_NAME"
- 3.After drift detection is complete:aws cloudformation describe-stack-resource-drifts \--stack-name "$STACK_NAME"
- 4.Quilt stack events:aws cloudformation describe-stack-events \--stack-name "$STACK_NAME"
To expedite the resolution of any errors encountered while using Quilt, please capture the following logs and share them with Quilt support:
- 1.Go to the affected page in your Quilt Catalog.
- 2.Open the browser Developer tools:
- Google Chrome: Press F12, Ctrl+Shift+I or from the Chrome menu select More tools > Developer tools.
- 3.Select the Network tab.
- 1.Ensure the session is recorded:
- Google Chrome: Check the red button in the upper left corner is set to Record.
- 2.Ensure Preserve Log is enabled.
- 3.Perform the action that triggers the error (e.g. clicking the
Download package
button). - 4.Export the logs as HAR format.
- Google Chrome: Ctrl + Click anywhere on the grid of network requests and select Save all as HAR with content.
- 5.Save the HAR-formatted file to your localhost.Save browser Network error logs as HAR content
- 4.Select the Console tab.
- 1.Perform the action that triggers the error (e.g. clicking the
Download package
button). - 2.Export the logs.
- Google Chrome: Ctrl + Click anywhere on the grid of network requests and select Save as....
- 3.Save the log file to your localhost.
- 1.Find the name of your Quilt stack:aws cloudformation list-stacks
- 2.Capture Quilt log events for the last 30 minutes as follows:STACK_NAME="YOUR_QUILT_STACK"aws logs filter-log-events \--log-group-name "$STACK_NAME" \--start-time "$(( ($(date +%s) - 1800) * 1000 ))" \--end-time "$(( $(date +%s) * 1000 ))" > log-quilt-ecs-events.json
Determine which principal you're using as follows:
aws sts get-caller-identity
Inspect problematic objects with the following commands:
BUCKET="YOUR_BUCKET"
PREFIX="YOUR_PREFIX"
aws s3api list-object-versions --bucket "$BUCKET" --prefix "$PREFIX"
aws s3api get-object-tagging --bucket "$BUCKET" --key "$PREFIX"
Sometimes you may wish to find an ID or other information from a logical resource in a Quilt stack. The following example is for security groups. Modify the commands as needed for other resource types.
STACK_NAME="YOUR_QUILT_STACK"
RESOURCE_ID="YOUR_LOGICAL_ID"
SG_ID=$(
aws cloudformation describe-stack-resource \
--stack-name "$STACK_NAME" \
--logical-resource-id "$RESOURCE_ID" \
--query 'StackResourceDetail.PhysicalResourceId' \
--output text
)
aws ec2 describe-security-groups --group-ids "${SG_ID}"
The event source mapping is a Lambda resource that reads from SQS.
STACK_NAME="YOUR_QUILT_STACK"
aws lambda get-event-source-mapping --uuid \
$(aws cloudformation describe-stack-resource \
--stack-name "$STACK_NAME" \
--logical-resource-id LambdaFunctionEventSourceMapping \
--query StackResourceDetail.PhysicalResourceId --output text)
If for some reason the event source mapping is disabled, it can be enabled as follows.
STACK_NAME="YOUR_QUILT_STACK"
aws lambda update-event-source-mapping --uuid \
$(aws cloudformation describe-stack-resource \
--stack-name "$STACK_NAME" \
--logical-resource-id LambdaFunctionEventSourceMapping \
--query StackResourceDetail.PhysicalResourceId \
--output text) \
--enabled
Last modified 2mo ago