Saltar al contenido

Monitorea tu sitio de Astro con Sentry

Sentry ofrece un servicio integral de monitoreo de aplicaciones y seguimiento de errores diseñado para ayudar a los desarrolladores a identificar, diagnosticar y resolver problemas en tiempo real.

Lee más en nuestro blog sobre la colaboración de Astro con Sentry y la aplicación Spotlight para la barra de herramientas de desarrollo de Sentry, que aporta una rica capa de depuración a tu entorno de desarrollo de Astro. Spotlight muestra errores, trazas y contexto importante directamente en tu navegador durante el desarrollo local.

El SDK de Astro de Sentry permite el reporte automático de errores y datos de trazas en tu aplicación de Astro.

Configuración del proyecto

Sección titulada “Configuración del proyecto”

Puedes encontrar una lista completa de prerrequisitos en la guía de Sentry para Astro.

Instalar

Sección titulada “Instalar”

Sentry captura datos utilizando un SDK dentro del entorno de ejecución (runtime) de tu aplicación.

Instala el SDK ejecutando el siguiente comando para el gestor de paquetes de tu elección en el CLI de Astro:

Ventana de la terminal
npx astro add @sentry/astro

El CLI de Astro instala el paquete del SDK y añade la integración de Sentry a tu archivo astro.config.mjs.

Configurar

Sección titulada “Configurar”

Para configurar la integración de Sentry, debes proporcionar las siguientes credenciales en tu archivo astro.config.mjs.

  1. Clave de cliente (DSN) - Puedes encontrar el DSN en la configuración de tu proyecto de Sentry en Claves de cliente (DSN).
  2. Nombre del proyecto - Puedes encontrar el nombre del proyecto en la configuración de tu proyecto de Sentry en Configuración general.
  3. Token de autenticación - Puedes crear un token de autenticación en la configuración de tu organización de Sentry en Tokens de autenticación.
astro.config.mjs
import { defineConfig } from 'astro/config';
import sentry from '@sentry/astro';


export default defineConfig({
  integrations: [
    sentry({
      dsn: 'https://examplePublicKey@o0.ingest.sentry.io/0',
      sourceMapsUploadOptions: {
        project: 'example-project',
        authToken: process.env.SENTRY_AUTH_TOKEN,
      },
    }),
  ],
});

Una vez que hayas configurado tu sourceMapsUploadOptions y añadido tu dsn, el SDK capturará y enviará automáticamente errores y eventos de rendimiento a Sentry.

Probar tu configuración

Sección titulada “Probar tu configuración”

Añade el siguiente elemento <button> a una de tus páginas .astro. Esto te permitirá provocar manualmente un error para que puedas probar el proceso de reporte de errores.

src/pages/index.astro
<button onclick="throw new Error('This is a test error')">Throw test error</button>

Para ver y resolver el error registrado, inicia sesión en sentry.io y abre tu proyecto.

Más guías de servicios de backend

Contribuir Comunidad Patrocinar