Troubleshooting Oxygen deployments
When a merchant has connected a Git repository to a Hydrogen storefront through the Hydrogen channel, any commit that's pushed to the connected Git repository is deployed to Oxygen automatically.
You can download worker bundles or review the deployment's runtime logs when experiencing errors to debug issues with the deployment.
Requirements
Anchor link to section titled "Requirements"Download worker bundles
Anchor link to section titled "Download worker bundles"When you push a commit to the connected Git repository, the Hydrogen storefront code is built and deployed to Oxygen. Each deployment has a worker bundle, which is the result of building this code. It can be useful to download the worker bundle for a deployment when troubleshooting certain issues with the deployment.
- From your Shopify admin, under Sales channels, click Hydrogen.
- From the Hydrogen storefront page, click the storefront that you're working with.
- Click All deployments.
- Click the deployment that you want to download the worker bundles for.
- Click Actions > Download worker file.
Review runtime logs
Anchor link to section titled "Review runtime logs"Runtime logs are a trace of the events and requests that happen in a deployment. You can monitor the logs for your deployments in real-time, or filter the events to isolate certain areas that might be experiencing issues when debugging your deployments.
- From your Shopify admin, under Sales channels, click Hydrogen.
- From the Hydrogen storefront page, click the storefront that you're working with.
- Click All deployments.
- Click the deployment that you want to review the runtime logs for.
- Review and filter the logs in the Runtime logs section.