3.1 KiB
@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
-
Install and configure the Web Vitals integration using
astro add
:npx astro add web-vitals
-
Push the tables added by the Web Vitals integration to Astro Studio:
npx astro db push
-
Redeploy your site.
-
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:
-
Mark the integration as deprecated in
astro.config.mjs
, by setting thedeprecated
option totrue
: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 }), ], // ... });
-
Push the deprecation to Astro Studio:
npx astro db push
-
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 }), ], // ... });
-
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:
License
MIT
Copyright (c) 2023–present Astro