Dirigir eventos de alertas de Firebase a Cloud Run

Consola

1. En la Google Cloud consola, en la página del selector de proyectos, selecciona o crea un Google Cloud proyecto.

   Ir al selector de proyectos

2. Habilita las APIs Cloud Logging, Eventarc y Eventarc Publishing.

   Habilita las APIs

3. Si procede, habilita la API relacionada con los eventos directos. Por ejemplo, para los eventos de Firebase Alerts , habilita la APIFirebase Alerts .

4. Si aún no tienes una, crea una cuenta de servicio gestionada por el usuario y, a continuación, concédele los roles y permisos necesarios para que Eventarc pueda gestionar eventos de tu servicio de destino.

   1. En la Google Cloud consola, ve a la página Crear cuenta de servicio.

      Ir a Crear cuenta de servicio

   2. Selecciona el proyecto.

   3. En el campo Nombre de cuenta de servicio, escribe un nombre. La Google Cloud consola rellena el campo ID de cuenta de servicio con este nombre.

      En el campo Descripción de la cuenta de servicio, escribe una descripción. Por ejemplo, Service account for event trigger.

   4. Haz clic en Crear y continuar.

   5. Para proporcionar el acceso adecuado, en la lista Selecciona un rol, elige los roles de gestión de identidades y accesos (IAM) que quieras asignar a tu cuenta de servicio para las invocaciones autenticadas o no autenticadas. Para obtener más información, consulta Roles y permisos para destinos de Cloud Run.

      Para añadir más roles, haz clic en add Añadir otro rol y añade cada rol adicional.

   6. Haz clic en Continuar.

   7. Para terminar de crear la cuenta, haga clic en Hecho.

gcloud

1. In the Google Cloud console, activate Cloud Shell.

   Activate Cloud Shell

   At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

2. Habilita las APIs Cloud Logging, Eventarc y Eventarc Publishing.

   gcloud services enable logging.googleapis.com \
     eventarc.googleapis.com \
     eventarcpublishing.googleapis.com

3. Si procede, habilita la API relacionada con los eventos directos. Por ejemplo, para los eventos, habilita Firebase Alerts .firestore.googleapis.com

4. Si aún no tienes una, crea una cuenta de servicio gestionada por el usuario y, a continuación, concédele los roles y permisos necesarios para que Eventarc pueda gestionar eventos de tu servicio de destino.

   1. Crea la cuenta de servicio:

      gcloud iam service-accounts create SERVICE_ACCOUNT_NAME

      Sustituye SERVICE_ACCOUNT_NAME por el nombre de la cuenta de servicio. Debe tener entre 6 y 30 caracteres, y puede contener caracteres alfanuméricos en minúscula y guiones. Una vez que hayas creado una cuenta de servicio, no podrás cambiar su nombre.

   2. Concede los roles o permisos de gestión de identidades y accesos necesarios para las invocaciones autenticadas o no autenticadas. Para obtener más información, consulta Roles y permisos para destinos de Cloud Run.

Consola

1. En la Google Cloud consola, ve a la página Triggers (Activadores) de Eventarc.

   Ir a Activadores

2. Haz clic en add_box Crear activador.
3. Escribe un Nombre del activador.

   Es el ID del activador y debe empezar por una letra. Puede contener hasta 63 letras minúsculas, números o guiones.

4. En Tipo de activador, selecciona Fuentes de Google.
5. En la lista Event provider (Proveedor de eventos), seleccione Firebase Alerts.

   Tenga en cuenta que el nombre del proveedor de eventos que se usa en la documentaciónGoogle Cloud asociada puede no tener el prefijo Cloud o Google Cloud. Por ejemplo, en la consola, Memorystore para Redis se denomina Google Cloud Memorystore para Redis.

6. En la lista Tipo de evento, en los eventos Direct (Directos), selecciona un tipo de evento.
7. Para especificar la codificación de la carga útil del evento, en la lista Tipo de contenido de los datos del evento, seleccione application/json o application/protobuf.

   Ten en cuenta que una carga útil de evento con formato JSON es más grande que una con formato Protobuf. Esto puede afectar a la fiabilidad en función del destino de los eventos y sus límites de tamaño. Para obtener más información, consulta Problemas conocidos.

8. En la lista Región, selecciona global (Global).

   Para obtener más información, consulta Ubicaciones de Eventarc.

9. En el campo Atributo 1, el alerttype ID de recurso actúa como filtro de eventos. Selecciona un operador para este filtro:
   • Igual
   • Patrón de ruta

     Para obtener más información, consulta Información sobre los patrones de ruta.

10. En el campo Valor del atributo 1, introduce una de las siguientes opciones:
    • appDistribution.inAppFeedback: evento que se envía cuando un tester envía comentarios en la aplicación de una aplicación determinada
    • appDistribution.newTesterIosDevice: el evento se envía cuando se registra un dispositivo de prueba de iOS nuevo para una aplicación determinada.
    • billing.planAutomatedUpdate: evento que se envía cuando se actualiza automáticamente el plan de facturación de un proyecto de Firebase. Por ejemplo, cuando se cambia a un plan inferior debido a problemas con el pago.
    • billing.planUpdate: el evento se envía cuando un usuario modifica el plan de facturación de un proyecto de Firebase. Por ejemplo, cuando se asocia o se desasocia una cuenta de facturación a un proyecto.
    • crashlytics.missingSymbolFile: el evento se envía cuando Firebase Crashlytics determina que no tiene los símbolos de depuración adecuados para simbolizar un informe de fallos entrante.
    • crashlytics.newAnrIssue: el evento se envía cuando una aplicación experimenta un error nuevo ANR (la aplicación no responde) (no para eventos idénticos posteriores).
    • crashlytics.newFatalIssue: el evento se envía cuando una aplicación experimenta un nuevo error fatal (no para eventos idénticos posteriores).
    • crashlytics.newNonfatalIssue: el evento se envía cuando una aplicación experimenta un error no crítico nuevo (no para ningún evento idéntico posterior)
    • crashlytics.regression: el evento se envía cuando una aplicación falla debido a un problema que se ha marcado como cerrado en una versión anterior de la aplicación.
    • El evento crashlytics.stabilityDigest: se envía cuando hay una notificación de los problemas más populares en Crashlytics.
    • crashlytics.velocity: evento que se envía cuando un solo problema provoca que se bloquee un número significativo de sesiones de la aplicación.
    • performance.threshold: el evento se envía cuando el rendimiento de una métrica supera el umbral definido.
11. También puede filtrar los eventos de un ID de aplicación de Firebase específico. Haga clic en add Añadir filtro y especifique el appid.
12. Selecciona la cuenta de servicio que invocará tu servicio o flujo de trabajo.

    También puedes crear una cuenta de servicio.

    Especifica la dirección de correo de la cuenta de servicio de Gestión de Identidades y Accesos (IAM) asociada al activador y a la que has concedido roles específicos necesarios para Eventarc.

13. En la lista Destino del evento, selecciona Cloud Run.
14. Selecciona un servicio.
    

    Es el nombre del servicio que recibe los eventos del activador. El servicio debe estar en el mismo proyecto que el activador y recibirá eventos como solicitudes HTTP POST enviadas a la ruta de la URL raíz (/) cada vez que se genere el evento.

15. También puede especificar la ruta de URL del servicio a la que se enviará la solicitud entrante.

    Es la ruta relativa del servicio de destino al que se deben enviar los eventos del activador. Por ejemplo: /, /route, route, route/subroute.

16. Si quieres añadir una etiqueta, puedes hacer clic en add Añadir etiqueta. Las etiquetas son pares clave-valor que te ayudan a organizar tus recursosGoogle Cloud . Para obtener más información, consulta ¿Qué son las etiquetas?
17. Haz clic en Crear.

Una vez creado un activador, no se pueden modificar los filtros de origen de eventos. En su lugar, cree un nuevo activador y elimine el antiguo. Para obtener más información, consulta Gestionar activadores.

gcloud

Para crear un activador, ejecuta un comando gcloud eventarc triggers create junto con las marcas obligatorias y opcionales.

gcloud eventarc triggers create TRIGGER \
    --location=global \
    --destination-run-service=DESTINATION_RUN_SERVICE \
    --destination-run-region=DESTINATION_RUN_REGION \
    --event-filters="type=google.firebase.firebasealerts.alerts.v1.published" \
    --event-filters="alerttype=ALERT_TYPE" \
    --event-data-content-type="EVENT_DATA_CONTENT_TYPE" \
    --service-account=SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com"

Haz los cambios siguientes:

• TRIGGER: el ID del activador o un identificador completo.
• DESTINATION_RUN_SERVICE: el nombre del servicio de Cloud Run que recibe los eventos del activador. El servicio puede estar en cualquiera de las ubicaciones admitidas de Cloud Run y no tiene por qué estar en la misma ubicación que el activador. Sin embargo, el servicio debe estar en el mismo proyecto que el activador y recibirá eventos como solicitudes HTTP POST enviadas a la ruta de URL raíz (/) cada vez que se genere el evento.
• DESTINATION_RUN_REGION: (opcional) la región en la que se puede encontrar el servicio de Cloud Run de destino. Si no se especifica, se presupone que el servicio está en la misma región que el activador.

• ALERT_TYPE: el tipo de alerta de Firebase. Puede tener uno de los siguientes valores:
  • appDistribution.inAppFeedback: evento que se envía cuando un tester envía comentarios en la aplicación de una aplicación determinada
  • appDistribution.newTesterIosDevice: el evento se envía cuando se registra un dispositivo de prueba de iOS nuevo para una aplicación determinada.
  • billing.planAutomatedUpdate: evento que se envía cuando se actualiza automáticamente el plan de facturación de un proyecto de Firebase. Por ejemplo, cuando se cambia a un plan inferior debido a problemas con el pago.
  • billing.planUpdate: el evento se envía cuando un usuario modifica el plan de facturación de un proyecto de Firebase. Por ejemplo, cuando se asocia o se desasocia una cuenta de facturación a un proyecto.
  • crashlytics.missingSymbolFile: el evento se envía cuando Firebase Crashlytics determina que no tiene los símbolos de depuración adecuados para simbolizar un informe de fallos entrante.
  • crashlytics.newAnrIssue: el evento se envía cuando una aplicación experimenta un error nuevo ANR (la aplicación no responde) (no para eventos idénticos posteriores).
  • crashlytics.newFatalIssue: el evento se envía cuando una aplicación experimenta un nuevo error fatal (no para eventos idénticos posteriores).
  • crashlytics.newNonfatalIssue: el evento se envía cuando una aplicación experimenta un error no crítico nuevo (no para ningún evento idéntico posterior)
  • crashlytics.regression: el evento se envía cuando una aplicación falla debido a un problema que se ha marcado como cerrado en una versión anterior de la aplicación.
  • El evento crashlytics.stabilityDigest: se envía cuando hay una notificación de los problemas más populares en Crashlytics.
  • crashlytics.velocity: evento que se envía cuando un solo problema provoca que se bloquee un número significativo de sesiones de la aplicación.
  • performance.threshold: el evento se envía cuando el rendimiento de una métrica supera el umbral definido.
  El operador de ALERT_TYPE debe ser uno de los siguientes:
  • Igual; por ejemplo, --event-filters="alerttype=appDistribution.inAppFeedback"
  • Patrón de ruta; por ejemplo, --event-filters-path-pattern="alerttype=appDistribution.*" o --event-filters-path-pattern="alerttype=crashlytics.new*".

    Para obtener más información, consulta Información sobre los patrones de ruta.

• EVENT_DATA_CONTENT_TYPE: (opcional) la codificación de la carga útil del evento. Puede ser application/json o application/protobuf. La codificación predeterminada es application/json.

  Ten en cuenta que una carga útil de eventos con formato JSON es más grande que una con formato Protobuf. Esto puede afectar a la fiabilidad en función del destino de los eventos y de sus límites de tamaño. Para obtener más información, consulta Problemas conocidos.

• SERVICE_ACCOUNT_NAME: el nombre de tu cuenta de servicio gestionada por el usuario.
• PROJECT_ID: tu ID de proyecto Google Cloud .

Notas:

• La marca --location debe ser global. Para obtener más información, consulta Ubicaciones de Eventarc.

• Estas marcas son obligatorias:

  • --event-filters="type=google.firebase.firebasealerts.alerts.v1.published"
  • --event-filters="alerttype=ALERT_TYPE" o --event-filters-path-pattern="alerttype=ALERT_TYPE"

• También puede filtrar eventos de un ID de aplicación de Firebase específico mediante la marca --event-filters="appid=APP_ID" y especificando una coincidencia exacta.

• Una vez creado un activador, no se puede cambiar el tipo de filtro de eventos. Si quieres usar otro tipo de evento, debes crear un nuevo activador.
• La marca --service-account se usa para especificar la dirección de correo de la cuenta de servicio de gestión de identidades y accesos (IAM) asociada al activador.
• También puede especificar una ruta relativa en el servicio Cloud Run de destino al que se deben enviar los eventos del activador mediante la marca --destination-run-path.

Ejemplo:

gcloud eventarc triggers create helloworld-trigger \
    --location=global \
    --destination-run-service=helloworld-events \
    --destination-run-region=us-central1 \
    --event-filters="type=google.firebase.firebasealerts.alerts.v1.published" \
    --event-filters="alerttype=crashlytics.velocity" \
    --service-account=${SERVICE_ACCOUNT_NAME}@${PROJECT_ID}.iam.gserviceaccount.com

Este comando crea un activador llamado helloworld-trigger para el evento identificado como google.firebase.firebasealerts.alerts.v1.published y para un tipo de alerta crashlytics.velocity.

Terraform

Puedes crear un activador para un destino de Cloud Run con Terraform. Para obtener más información, consulta el artículo sobre cómo crear un activador con Terraform.

Consola

1. En la Google Cloud consola, ve a la página Triggers (Activadores) de Eventarc.

   Ir a Activadores

   En esta página se muestran todos tus activadores de todas las ubicaciones, así como detalles como nombres, regiones, proveedores de eventos, destinos y más.

2. Para filtrar tus activadores, sigue estos pasos:

   1. Haz clic en filter_list Filtrar o en el campo Activar filtros.
   2. En la lista Propiedades, seleccione una opción para filtrar los activadores.

   Puede seleccionar una sola propiedad o usar el operador lógico OR para añadir más propiedades.

3. Para ordenar los activadores, junto al encabezado de cualquier columna admitida, haz clic en arrow_upward Ordenar.

gcloud

Ejecuta el siguiente comando para ver una lista de tus activadores:

gcloud eventarc triggers list --location=-

Este comando muestra los activadores de todas las ubicaciones e incluye detalles como nombres, tipos, destinos y estados.