quilt
dev
Search…
⌃K
Links

Troubleshooting

Catalog Overview stats (objects, packages) seem incorrect or aren't updating

Catalog Packages tab doesn't work

Catalog packages or stats are missing or are not updating

If you recently added the bucket or upgraded the stack, if search volume is high, or if the bucket is under rapid modification, wait a few minutes and try again.

Re-index the bucket

  1. 1.
    Open the bucket in the Quilt catalog
  2. 2.
    Click the gear icon (upper right), or navigate to Users and buckets > Buckets and open the bucket in question
  3. 3.
    Under "Indexing and notifications", click "Re-index and Repair". Optional: if and only if bucket notifications were deleted or are not working, check "Repair S3 notifications".
  4. 4.
    Wait a few minutes while bucket statistics and packages repopulate

Diagnose issues with ElasticSearch

  1. 1.
    Go to CloudFormation > Stacks > YourQuiltStack > Resources
  2. 2.
    Search for "domain"
  3. 3.
    Click on the link for "Search" under "Physical ID"
  4. 4.
    You are now under ElasticSearch > Dashboards
  5. 5.
    Set the time range to include the period before and after when you noticed any issues
  6. 6.
    Screenshot the dashboard stats for your domain
  7. 7.
    Click into your domain and then navigate to "Cluster health"
  8. 8.
    Screenshot Summary, Overall Health, and Key Performance Indicator sections
  9. 9.
    Send screenshots to Quilt support.
  10. 10.
    It is not recommended that you adjust ElasticSearch via Edit domain, as these changes will be lost the next time that you update Quilt

Missing metadata when working with Quilt packages via the API

Package.set_dir() on the package root (".") overrides package-level metadata. If you do not provide set_dir(".", foo, meta=baz) with a value for meta=, set_dir will set package-level metadata to None.
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"
)