astro/packages/integrations/web-vitals

@astrojs/web-vitals (experimental) ⏱️

This Astro integration enables tracking real-world website performance and storing the data in Astro DB.

Pre-requisites

• Astro DB — @astrojs/web-vitals will store performance data in Astro DB in production
• An SSR adapter — @astrojs/web-vitals injects a server endpoint to manage saving data to Astro DB

Installation

1. Install and configure the Web Vitals integration using astro add:

   npx astro add web-vitals
   

2. Push the tables added by the Web Vitals integration to Astro Studio:

   npx astro db push
   

3. Redeploy your site.

4. Visit your project dashboard at https://studio.astro.build to see the data collected.

Learn more about Astro DB and deploying with Astro Studio in the Astro docs.

Uninstalling

To remove the Web Vitals integration, follow the Astro DB deprecation process:

1. Mark the integration as deprecated in astro.config.mjs, by setting the deprecated option to true:

   import db from '@astrojs/db';
   import webVitals from '@astrojs/web-vitals';
   import { defineConfig } from 'astro/config';
   
   export default defineConfig({
     integrations: [
       db(),
       // Mark the web vitals integration as deprecated:
       webVitals({ deprecated: true }),
     ],
     // ...
   });
   

2. Push the deprecation to Astro Studio:

   npx astro db push
   

3. Remove the web vitals integration in astro.config.mjs:

   import db from '@astrojs/db';
   - import webVitals from '@astrojs/web-vitals';
   import { defineConfig } from 'astro/config';
   
   export default defineConfig({
     integrations: [
       db(),
   -   webVitals({ deprecated: true }),
     ],
     // ...
   });
   

4. Push the table deletion to Astro Studio:

   npx astro db push
   

Support

• Get help in the Astro Discord. Post questions in our #support forum, or visit our dedicated #dev channel to discuss current development and more!

• Check our Astro Integration Documentation for more on integrations.

• Submit bug reports and feature requests as GitHub issues.

Contributing

This package is maintained by Astro's Core team. You're welcome to submit an issue or PR! These links will help you get started:

• Contributor Manual
• Code of Conduct
• Community Guide

License

MIT

Copyright (c) 2023–present Astro