Configurar App Hub para proyectos host

En este documento se proporcionan instrucciones para configurar App Hub mediante un proyecto host para compilar, operar y gestionar aplicaciones en Google Cloud. Un proyecto del host es un proyecto que puede alojar proyectos del servicio que incluyen recursos que quieras gestionar con aplicaciones de App Hub. Google Cloud Este documento está dirigido a las personas que configuran y administran App Hub.

Te recomendamos que uses carpetas habilitadas para aplicaciones para configurar el centro de aplicaciones y gestionar tus aplicaciones. Las carpetas habilitadas para aplicaciones proporcionan gestión de aplicaciones en todos los proyectos de la carpeta y acceso a funciones como Application Design Center y Gemini Cloud Assist. Para obtener más información, consulta Configurar el centro de aplicaciones para carpetas habilitadas para aplicaciones.

Servicios y cargas de trabajo

Con App Hub, los recursos de los proyectos de servicio vinculados al proyecto del host están disponibles como servicios y cargas de trabajo. Si registras tus servicios y cargas de trabajo en una aplicación, podrás observar y monitorizar los recursos. App Hub admite recursos globales y regionales. Para obtener más información, consulta los recursos admitidos en App Hub.

Proceso de configuración general

En la siguiente lista se resumen los pasos para configurar App Hub:

1. Determina qué recursos quieres incluir en tu aplicación y a qué proyectos pertenecen.
2. Crea un proyecto host de App Hub o usa un proyecto que ya tengas como proyecto host. Opcionalmente, en función de la estructura organizativa de su empresa, puede crear más de un proyecto host.
   • Si tienes previsto tener más de un proyecto anfitrión, te recomendamos que los crees en la misma carpeta.
   • Un proyecto del host no puede ser un proyecto de servicio, excepto para sí mismo.
3. Habilita la API App Hub en el proyecto host.
4. Designa a los usuarios de App Hub como administradores, editores o lectores de App Hub.
5. Vincula proyectos de servicio. Después de configurar un proyecto host, vincula los proyectos de servicio con los recursos subyacentes que necesiten tus aplicaciones al proyecto host. Ten en cuenta lo siguiente:
   1. Los proyectos de servicio deben estar en la misma organización que el proyecto host. Una vez que hayas vinculado un proyecto de servicio a un proyecto host, no podrás moverlo a otra organización. Para mover el proyecto de servicio a otra organización, debes seguir las instrucciones de este documento para quitar o desvincular el proyecto de servicio del proyecto host. Después, puedes asociar el proyecto de servicio a otra organización.
   2. Un proyecto de servicio no se puede vincular a más de un proyecto del host.
   3. Un proyecto del host puede ser su propio proyecto de servicio, pero no puede ser un proyecto de servicio de ningún otro proyecto del host.
   4. Después de vincular proyectos de servicio a un proyecto host, si consultas el proyecto host para obtener servicios o cargas de trabajo, se devolverán automáticamente todos los servicios y las cargas de trabajo de todos los proyectos de servicio.
6. Crea una aplicación para organizar varias cargas de trabajo y servicios. Ten en cuenta lo siguiente:
   1. Asegúrate de que la aplicación tenga un nombre único en el proyecto host y en la ubicación.
   2. Un proyecto de servicio se puede vincular a un proyecto host con varias aplicaciones, pero sus recursos individuales solo se pueden registrar en una aplicación.
7. Consulta servicios y cargas de trabajo y regístralos en tu aplicación. Una vez que hayas creado una aplicación, consulta el proyecto host para ver los servicios y las cargas de trabajo disponibles. Las consultas se ejecutan en el proyecto del host y en todos los proyectos de servicio vinculados al proyecto del host. También se restaurarán todos los servicios y cargas de trabajo de esos proyectos. Ten en cuenta lo siguiente:
   1. Solo puedes registrar un servicio o una carga de trabajo en una aplicación.
   2. Debes registrar los servicios y las cargas de trabajo de una región específica en una aplicación regional de la misma región o en una aplicación global. En las instrucciones y los comandos que se indican a continuación se presupone que todos los recursos están en la misma región. Para obtener información sobre las regiones que puedes designar, consulta Ubicaciones.
   3. Los servicios y las cargas de trabajo registrados no se ven afectados por las actualizaciones del recurso de infraestructura subyacente. Es decir, si eliminas los recursos subyacentes que actúan como servicios y cargas de trabajo, App Hub no eliminará las cargas de trabajo ni los servicios asociados de tu aplicación. Debes dar de baja la carga de trabajo o el servicio por separado.

Importante: Los proyectos de host y de servicio de App Hub no son los mismos que los proyectos de host o de servicio de VPC compartida y no tienen los mismos requisitos. Por ejemplo, no necesitas una red de VPC compartida para usar App Hub. En este documento, todas las referencias a proyectos del host y proyectos de servicio se refieren a proyectos del host y proyectos de servicio de App Hub.

Requisitos previos

Antes de configurar App Hub, completa las siguientes tareas.

1. Decide qué proyecto será el host o crea uno. Te recomendamos que crees un proyecto.
2. Decide qué personas tendrán los roles de Gestión de Identidades y Accesos (IAM) de App Hub: administrador, editor y lector.

Ten en cuenta que la persona que asocie un proyecto de servicio a un proyecto host debe tener el rol de gestión de identidades y accesos Administrador de App Hub en ambos proyectos. Para obtener más información, consulta Roles y permisos de App Hub.

Configurar App Hub

En esta sección, crearás una arquitectura de App Hub de ejemplo.

En el ejemplo, una organización tiene tres proyectos de servicio, con sus recursos de infraestructura desplegados en los proyectos de la siguiente manera:

• El proyecto de servicio 1 tiene dos recursos de infraestructura: Servicio 1 y Servicio 2.
• El proyecto de servicio 2 tiene tres recursos de infraestructura: Servicio 3, Carga de trabajo 1 y Carga de trabajo 2.
• El proyecto de servicio 3 tiene tres recursos de infraestructura: Servicio 4, Carga de trabajo 3 y Carga de trabajo 4.

Asegúrate de que los proyectos que elijas para crear el ejemplo contengan los recursos descritos en esta sección o prepárate para ajustar el ejemplo a medida que sigas las instrucciones.

En las siguientes secciones se incluyen las instrucciones para crear un ejemplo de App Hub. Crea un proyecto host y añade proyectos de servicio a él. Después, crea una aplicación y vincula servicios y cargas de trabajo a la aplicación. En el ejemplo se muestran tres proyectos de servicio, pero puedes añadir más o menos.

En el ejemplo se da por supuesto que los proyectos de servicio que añadas ya existen y que contienen servicios y cargas de trabajo que añades a tu aplicación. Antes de crear el ejemplo, determina qué proyectos de servicio contienen los servicios y las cargas de trabajo que quieres incluir en la aplicación.

Habilitar App Hub

En esta sección, debe seleccionar o crear un proyecto host, habilitar la API App Hub y asignar los roles y permisos adecuados a las personas de su organización. También puedes vincular proyectos de servicio al proyecto del host.

Consola

1. En la Google Cloud consola, ve a la página del selector de proyectos.

   Ir al selector de proyectos

2. Seleccione o cree un Google Cloud proyecto para que sea el proyecto host de App Hub.

3. Enable the required API.

   Roles required to enable APIs

   To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

   Enable the API

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. Asegúrate de que esté instalada la versión más reciente de Google Cloud CLI. Ejecuta el siguiente comando desde Cloud Shell:

   gcloud components update

3. Crea o selecciona un proyecto, HOST_PROJECT_ID, que será el proyecto host de App Hub.

   • Crea un Google Cloud proyecto:

     gcloud projects create HOST_PROJECT_ID

   • Selecciona el Google Cloud proyecto que has creado:

     gcloud config set project HOST_PROJECT_ID

4. Habilita la API App Hub en el proyecto host que acabas de crear.

   gcloud services enable apphub.googleapis.com \
       --project=HOST_PROJECT_ID
   

Designar usuarios de App Hub

Si eres el creador del proyecto, se te asignará el rol básico Propietario (roles/owner). De forma predeterminada, este rol de gestión de identidades y accesos incluye los permisos necesarios para tener acceso completo a la mayoría de los recursos Google Cloud .

Si no eres el creador del proyecto, debes conceder los permisos necesarios al principal correspondiente. Por ejemplo, una entidad principal puede ser una cuenta de Google (para usuarios finales) o una cuenta de servicio (para aplicaciones y cargas de trabajo de computación). Para obtener los permisos que necesitas para completar este tutorial, pide a tu administrador que te conceda los siguientes roles de gestión de identidades y accesos en tu proyecto:

Consola

1. En la consola, ve a la página Gestión de identidades y accesos. Google Cloud

   Ir a IAM

2. Haz clic en Conceder acceso. Se abrirá el panel Dar acceso.

3. En el campo Nuevos principales, introduce la dirección de correo de la persona que administrará App Hub, es decir, el rol Administrador de App Hub en el proyecto host.

4. Haz clic en Seleccionar un rol y, en el campo Filtro, introduce App Hub.

5. Selecciona el rol Administrador del centro de aplicaciones y haz clic en Guardar.

6. En cada uno de los proyectos de servicio de App Hub, concede el rol de administrador de App Hub al mismo usuario.

gcloud

1. Si quieres, puedes conceder el rol de administrador de App Hub en el proyecto host a las personas que vayan a administrar App Hub. Repite el siguiente comando para cada administrador.

   gcloud projects add-iam-policy-binding HOST_PROJECT_ID \
       --member='user:HOST_PROJECT_ADMIN' \
       --role='roles/apphub.admin'
   

   Sustituye HOST_PROJECT_ADMIN por el usuario que tiene el rol de administrador de App Hub en el proyecto host. Este valor tiene el formato username@yourdomain; por ejemplo, [e-mail].

2. Concede el rol de administrador de App Hub en los proyectos de servicio a las personas que administran App Hub. Deben tener el rol de administrador de App Hub para añadir proyectos de servicio al proyecto host. Necesitas al menos una persona con este rol por cada proyecto de servicio. Una misma persona puede tener el rol en varios proyectos de servicio.

   gcloud projects add-iam-policy-binding SERVICE_PROJECT_1 \
       --member='user:HOST_PROJECT_ADMIN' \
       --role='roles/apphub.admin'
   

   gcloud projects add-iam-policy-binding SERVICE_PROJECT_2 \
       --member='user:HOST_PROJECT_ADMIN' \
       --role='roles/apphub.admin'
   

   gcloud projects add-iam-policy-binding SERVICE_PROJECT_3 \
       --member='user:HOST_PROJECT_ADMIN' \
       --role='roles/apphub.admin'
   

   Haz los cambios siguientes:

   • SERVICE_PROJECT_1: el primero de los tres proyectos de servicio de este ejemplo.
   • SERVICE_PROJECT_2: el segundo de los tres proyectos de servicio de este ejemplo.
   • SERVICE_PROJECT_3: el tercero de los tres proyectos de servicio de este ejemplo.

Añadir proyectos de servicio al proyecto del host

Añada los proyectos de servicio con los recursos subyacentes que quiera gestionar al proyecto host de App Hub.

Consola

1. En la Google Cloud consola, ve a la página Configuración de App Hub.

   Ir a Ajustes

2. En la página Configuración, haz clic en Asociar proyectos.

3. Elige una de estas opciones:

   • En la lista de proyectos, marca las casillas de los proyectos que quieras añadir como proyectos de servicio.
   • Busca proyectos y, a continuación, selecciona los que quieras añadir como proyectos de servicio.

4. Haz clic en Seleccionar. En la tabla Attached Service Project(s) (Proyectos de servicio vinculados) se muestran los proyectos de servicio seleccionados.

5. Haz clic en Cerrar.

gcloud

gcloud apphub service-projects add SERVICE_PROJECT_1 \
    --project=HOST_PROJECT_ID

gcloud apphub service-projects add SERVICE_PROJECT_2 \
    --project=HOST_PROJECT_ID

gcloud apphub service-projects add SERVICE_PROJECT_3 \
    --project=HOST_PROJECT_ID

Opcional: Añadir proyectos de servicio al ámbito de las métricas del proyecto del host

Vista previa

Este producto o función está sujeto a los "Términos de las Ofertas de Acceso Previo a la Disponibilidad General" de la sección Términos Generales de los Servicios de los Términos Específicos de los Servicios. Los productos y las funciones previos a la disponibilidad general están disponibles tal cual y pueden tener una compatibilidad y asistencia limitadas. Para obtener más información, consulta las descripciones de las fases de lanzamiento.

Para ver las métricas del sistema de las aplicaciones de tu proyecto host, añade los proyectos de servicio como contenedores de recursos al ámbito de las métricas del proyecto host. Un proyecto host de App Hub actúa como proyecto de ámbito que aloja un ámbito de métricas. El ámbito de las métricas de un proyectoGoogle Cloud define el conjunto de contenedores de recursos cuyos datos de serie temporal puede representar y monitorizar el proyecto host. Para obtener más información sobre los contenedores de recursos, el ámbito de las métricas y los proyectos de ámbito, consulta Cloud Monitoring: modelo de datos. Para obtener más información sobre los recursos de infraestructura disponibles con las métricas del sistema de aplicaciones de App Hub y la compatibilidad con etiquetas de metadatos del sistema, consulta los recursos admitidos.

Para ver las métricas del sistema de una aplicación, debe añadir o eliminar manualmente los proyectos de servicio monitorizados de los proyectos host, según sea necesario. Sin embargo, si utilizas el proyecto host como su propio proyecto de servicio, no añadas el proyecto al ámbito de las métricas, ya que las aplicaciones de App Hub están en el mismo proyecto.

Asegúrate de que tienes los siguientes roles de gestión de identidades y accesos:

• Para obtener los permisos que necesitas para ver las métricas de las aplicaciones de App Hub, pide a tu administrador que asigne el rol de gestión de identidades y accesos Lector de Monitoring (roles/monitoring.viewer) a las entidades. Para obtener más información, consulta Conceder acceso a la monitorización.

• Para obtener los permisos que necesitas para configurar un ámbito de métricas, pide a tu administrador que te conceda el rol de gestión de identidades y accesos Administrador de Monitoring (roles/monitoring.admin) en el proyecto de ámbito y en cada contenedor de recursos que quieras añadir al ámbito de métricas. Para obtener más información sobre cómo conceder roles, consulta el artículo Gestionar el acceso a proyectos, carpetas y organizaciones.

  También puedes conseguir los permisos necesarios a través de roles personalizados u otros roles predefinidos.

Consola

1. En la Google Cloud consola, ve a la página  Configuración:

   Ve a Configuración.

   Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuya sección sea Monitorización.

2. Selecciona Ámbito de la métrica.

   En la pestaña Ámbito de métricas se muestran los recursos monitorizados por elGoogle Cloud proyecto actual. También se muestran los proyectos cuyo ámbito de métricas incluye el proyecto actual. Google Cloud Google Cloud

3. Para añadir Google Cloud proyectos al ámbito de las métricas, siga estos pasos:

   1. En el panel Proyectos de Google Cloud, haz clic en Añadir proyectos.
   2. En el cuadro de diálogo Añadir proyectos de Google Cloud, haz clic en Seleccionar proyectos y, a continuación, marca las casillas de los proyectos de servicio que quieras monitorizar.

   3. Para guardar los cambios, haz clic en Añadir proyectos.

      Se mostrará la página Configuración con la tabla actualizada para mostrar tus selecciones.

Después de añadir proyectos a un ámbito de métricas, los cambios tardan unos 60 segundos en propagarse por todos los sistemas de Monitoring.

Para obtener más información sobre cómo configurar los ámbitos de las métricas mediante la consolaGoogle Cloud , consulta el artículo Configurar un ámbito de las métricas.

gcloud

Para añadir tus proyectos de servicio como contenedor de recursos monitorizados al proyecto host de App Hub, sigue estos pasos:

gcloud beta monitoring metrics-scopes create projects/SERVICE_PROJECT_1 \
    --project=HOST_PROJECT_ID

gcloud beta monitoring metrics-scopes create projects/SERVICE_PROJECT_2 \
    --project=HOST_PROJECT_ID

gcloud beta monitoring metrics-scopes create projects/SERVICE_PROJECT_3 \
    --project=HOST_PROJECT_ID

Para obtener más información sobre cómo configurar los ámbitos de métricas mediante la CLI de Google Cloud, consulta el artículo Configurar un ámbito de métricas mediante la API.

Actualizar una aplicación de App Hub

También puedes actualizar los atributos de tu aplicación después de crearla.

Consola

1. En la Google Cloud consola, ve a la página Aplicaciones del centro de aplicaciones.

   Ve a Aplicaciones.

2. En la lista de aplicaciones, haz clic en Editar en la aplicación que quieras actualizar.

3. Edite los campos según sea necesario y haga clic en Guardar.

4. Opcional: En la lista Criticidad, para indicar la importancia de la aplicación, seleccione una de las siguientes opciones:

   • Crítico
   • Alta
   • Mediano
   • Baja

5. Opcional: En la lista Entorno, para indicar la fase del ciclo de vida del software, selecciona una de las siguientes opciones:

   • Producción
   • Fase de preparación
   • Desarrollo
   • Prueba

6. Opcional: Añade los siguientes detalles según sea necesario para Propietarios desarrolladores, Propietarios operadores y Propietarios de la empresa. Ten en cuenta que debes introducir la dirección de correo del propietario si añades un nombre visible.

   1. Introduce el nombre visible del propietario.
   2. Introduce la dirección de correo del propietario. Este valor debe tener el formato username@yourdomain; por ejemplo, [e-mail].

7. Repite estos pasos con cada desarrollador, operador y propietario de la empresa.

8. Haz clic en Guardar.

gcloud

1. Actualiza tu aplicación con los atributos criticality-type, environment-type y owner type:

   gcloud apphub applications update APPLICATION_NAME \
     --display-name='APPLICATION_DISPLAY_NAME' \
     --criticality-type='CRITICALITY_LEVEL' \
     --environment-type='ENVIRONMENT' \
     --developer-owners=display-name=DISPLAY-NAME-DEVELOPER,email=EMAIL-DEVELOPER \
     --operator-owners=display-name=DISPLAY-NAME-OPERATOR,email=EMAIL-OPERATOR \
     --business-owners=display-name=DISPLAY-NAME-BUSINESS,email=EMAIL-BUSINESS \
     --project=HOST_PROJECT_ID \
     --location=REGION
   

   Haz los cambios siguientes:

   • APPLICATION_DISPLAY_NAME: el nombre visible de tu aplicación.
   • CRITICALITY_LEVEL: indica la importancia de una aplicación, un servicio o una carga de trabajo para las operaciones de tu empresa. Proporciona uno de los siguientes valores:
     • MISSION_CRITICAL
     • HIGH
     • MEDIUM
     • LOW
   • ENVIRONMENT: indica las fases del ciclo de vida del software. Proporciona uno de los siguientes valores:
     • PRODUCTION
     • STAGING
     • DEVELOPMENT
     • TEST
   • DISPLAY-NAME-DEVELOPER, DISPLAY-NAME-OPERATOR y DISPLAY-NAME-BUSINESS: nombres visibles del desarrollador, el operador y los propietarios de la empresa, respectivamente.
   • EMAIL-NAME-DEVELOPER, EMAIL-NAME-OPERATOR y EMAIL-NAME-BUSINESS: direcciones de correo del desarrollador, el operador y los propietarios de la empresa, respectivamente. Estos valores deben tener el formato username@yourdomain, por ejemplo, [e-mail].

2. Lista las aplicaciones en las que el atributo environment-type tiene el valor PRODUCTION.

   gcloud apphub applications list \
       --filter='attributes.environment.type=PRODUCTION' \
       --project=HOST_PROJECT_ID \
       --location=REGION
   

   El resultado debería ser similar al siguiente:

   ID                DISPLAY_NAME              CREATE_TIME
   APPLICATION_NAME  APPLICATION_DISPLAY_NAME  2023-10-31T18:33:48
   

Añadir o quitar proyectos de servicio

Puede modificar las vinculaciones de proyectos de servicio para que haya diferentes recursos de infraestructura disponibles para agruparlos en una aplicación.

Para ver las métricas del sistema de las aplicaciones de tu proyecto host, después de añadir un proyecto de servicio a un proyecto host, añade los proyectos de servicio como contenedores de recursos al ámbito de las métricas del proyecto host. Para obtener más información, consulta la sección Añadir proyectos de servicio al ámbito de las métricas del proyecto host de este documento. Cuando elimines un proyecto de servicio de un proyecto del host, considera la posibilidad de eliminar los proyectos de servicio como contenedores de recursos del ámbito de las métricas del proyecto del host (si habías decidido ver las métricas del sistema de las aplicaciones de tu proyecto del host). Para obtener más información, consulta los pasos para quitar los proyectos de servicio del ámbito de las métricas del proyecto host en este documento.

Consola

Para añadir un proyecto del servicio a un proyecto del host, sigue estos pasos:

1. En la Google Cloud consola, ve a la página Configuración de App Hub.

   Ir a Ajustes

2. En la página Configuración, haz clic en Asociar proyectos.

3. En el panel que se abre, busca proyectos en la lista que se muestra y marca las casillas de los proyectos que quieras añadir como proyectos de servicio.

4. Haz clic en Seleccionar. En la tabla Proyectos de servicio vinculados se muestran los proyectos seleccionados como proyectos de servicio del proyecto del host.

5. Haz clic en Cerrar.

Para quitar un proyecto de servicio de un proyecto del host, sigue estos pasos:

1. En la Google Cloud consola, ve a la página Configuración de App Hub.

   Ir a Ajustes

2. En la página Configuración, marque las casillas de los proyectos que quiera quitar como proyectos de servicio.

3. Haz clic en Desasociar proyectos. La tabla Proyectos de servicio vinculados se actualiza para mostrar solo los proyectos que siguen vinculados al proyecto del host.

gcloud

Para añadir un proyecto del servicio a un proyecto del host, sigue estos pasos:

gcloud apphub service-projects add SERVICE_PROJECT_ID \
   --project=HOST_PROJECT_ID

Sustituye SERVICE_PROJECT_ID por el nombre del proyecto de servicio que quieras añadir al proyecto host.
Para quitar un proyecto de servicio del proyecto del host, sigue estos pasos:

gcloud apphub service-projects remove SERVICE_PROJECT_ID \
   --project=HOST_PROJECT_ID

Ver aplicaciones, servicios y cargas de trabajo

Puedes ver las aplicaciones de un proyecto y enumerar los servicios y las cargas de trabajo de una aplicación.

Consola

• Para ver las aplicaciones de un proyecto, sigue estos pasos:

  1. En la Google Cloud consola, ve a la página Centro de aplicaciones Aplicaciones.

     Ve a Aplicaciones.

  2. Opcional: Para filtrar la aplicación, sigue estos pasos:

     1. En el campo Filtro, selecciona un filtro, como Criticidad.
     2. Selecciona Alto como valor.
        Se muestra una lista de aplicaciones de alta criticidad creadas en el proyecto host.

• Para enumerar los servicios y las cargas de trabajo, sigue estos pasos:

  Aplicaciones

  1. En la Google Cloud consola, ve a la página Aplicaciones del centro de aplicaciones.

     Ve a Aplicaciones.

  2. Haz clic en el nombre de una aplicación. Aparecerá una página con una lista de los servicios y las cargas de trabajo registrados en tu aplicación.

  3. Opcional: Para filtrar los servicios o las cargas de trabajo, haz lo siguiente:

     1. En el campo Filtro, selecciona un filtro, como Criticidad.
     2. Selecciona Alto como valor.
        Aparecerá una lista de servicios y cargas de trabajo de alta criticidad que estén registrados en la aplicación.

  Servicios y cargas de trabajo

  1. En la Google Cloud consola, ve a la página App Hub Servicios y cargas de trabajo.

     Ir a Servicios y cargas de trabajo

  2. En la lista Región, selecciona las regiones desde las que quieras ver los servicios y las cargas de trabajo. Por ejemplo, selecciona us-east1.
     En la página Servicios y cargas de trabajo se muestran todos los servicios y las cargas de trabajo de los proyectos de servicio asociados a us-east1.

  3. Opcional: Para filtrar los servicios o las cargas de trabajo, haz lo siguiente:

     1. En el campo Filtro, selecciona un filtro, como Entorno.
     2. Selecciona Producción como valor.
        Se muestra una lista de servicios y cargas de trabajo del entorno de producción que están registrados en una aplicación.

gcloud

• Para ver las aplicaciones de un proyecto, sigue estos pasos:

  gcloud apphub applications list \
    --project=HOST_PROJECT_ID \
    --location=REGION
  

• Para enumerar los servicios registrados en una aplicación, sigue estos pasos:

  gcloud apphub applications services list \
    --application=APPLICATION_NAME \
    --project=HOST_PROJECT_ID \
    --location=REGION
  

• Para mostrar las cargas de trabajo registradas en una aplicación, sigue estos pasos:

  gcloud apphub applications workloads list \
    --application=APPLICATION_NAME \
    --project=HOST_PROJECT_ID \
    --location=REGION
  

• Opcional: Para filtrar los recursos en función de los atributos de las variables, añade una marca de comando filter a los comandos anteriores. Por ejemplo, para enumerar todas las cargas de trabajo registradas en las que el atributo criticality-type esté definido como HIGH,

  gcloud apphub applications workloads list \
    --application=APPLICATION_NAME \
    --filter='attributes.criticality.type=HIGH' \
    --project=HOST_PROJECT_ID \
    --location=REGION
  

  Para obtener más información sobre los atributos por los que puedes filtrar, consulta la sección Actualizar una aplicación de App Hub de esta página.

Opcional: Ver métricas de aplicaciones

Vista previa

Este producto o función está sujeto a los "Términos de las Ofertas de Acceso Previo a la Disponibilidad General" de la sección Términos Generales de los Servicios de los Términos Específicos de los Servicios. Los productos y las funciones previos a la disponibilidad general están disponibles tal cual y pueden tener una compatibilidad y asistencia limitadas. Para obtener más información, consulta las descripciones de las fases de lanzamiento.

Puedes ver las métricas del sistema de las aplicaciones creadas en tu proyecto host de App Hub. Estas métricas se corresponden con las señales de oro (tráfico, errores, latencia y saturación) que ayudan a monitorizar el rendimiento y el estado de la aplicación.

1. En la Google Cloud consola, ve a la página Aplicaciones del centro de aplicaciones.

   Ve a Aplicaciones.

2. Haz clic en el nombre de una aplicación.

   En la pestaña Servicios y cargas de trabajo se muestran los metadatos de los servicios y las cargas de trabajo registrados en tu aplicación.

3. Opcional: Para cambiar el periodo durante el que se muestran las métricas, utilice el selector de periodo. El intervalo de tiempo predeterminado es de 1 hora.

4. Para ver las métricas del sistema de los servicios y las cargas de trabajo registrados, haz clic en bar_chart Métricas.

   Se muestra una tabla con las siguientes señales de oro:

   • Tráfico: tasas de solicitudes entrantes en el recurso durante el periodo seleccionado.
   • Tasa de errores del servidor: porcentaje medio de solicitudes entrantes que generan códigos de error HTTP de la serie 5xx durante el periodo seleccionado.
   • Latencia del percentil 95: el percentil 95 de la latencia de una solicitud de servicio agregada durante el periodo seleccionado, en milisegundos.
   • Uso de CPU: porcentaje medio de uso de CPU de una carga de trabajo, agregado durante el periodo especificado. Los valores suelen ser números entre 0,0 y 100,0, pero pueden superar 100,0.
   • Uso de memoria: porcentaje medio de uso de memoria de una carga de trabajo, agregado durante el periodo especificado.

Opcional: Explorar las métricas con gráficos

Para representar métricas de tus proyectos de App Hub, usa el explorador de métricas. Puede restringir los datos que se representan en el gráfico aplicando filtros basados en etiquetas. Para obtener más información, consulta Crear gráficos con el explorador de métricas.

Puede filtrar por las siguientes etiquetas de metadatos del sistema de App Hub (versión preliminar):

• apphub_application_host_project_id
• apphub_application_id
• apphub_application_location
• apphub_workload_criticality_type
• apphub_workload_environment_type
• apphub_workload_id

Para visualizar las etiquetas de metadatos de App Hub en un gráfico, sigue estas instrucciones. Puedes seguir el mismo procedimiento con las demás etiquetas de metadatos del sistema y las métricas de App Hub.

1. En la Google Cloud consola, ve a la página  Explorador de métricas:

   Ve al explorador de métricas.

   Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuya sección sea Monitorización.

2. En la barra de herramientas de la Google Cloud consola, selecciona tu Google Cloud proyecto. En las configuraciones de App Hub, selecciona el proyecto host de App Hub o el proyecto de gestión de la carpeta habilitada para aplicaciones.
3. En el elemento Métrica, despliega el menú Seleccionar una métrica, introduce VM Instance en la barra de filtros y, a continuación, usa los submenús para seleccionar un tipo de recurso y una métrica específicos:
   1. En el menú Recursos activos, selecciona Instancia de VM.
   2. En el menú Categorías de métricas activas, seleccione Métricas populares.
   3. En el menú Métricas activas, selecciona Utilización de CPU.
   4. Haz clic en Aplicar.
   El nombre completo de esta métrica es compute.googleapis.com/instance/cpu/utilization.

4. Para añadir filtros que eliminen series temporales de los resultados de la consulta, usa el elemento Filter.

5. Configura cómo se ven los datos. Para mostrar solo las métricas de una etiqueta específica, siga estos pasos:
   1. En el elemento Filtro, haga clic en Añadir filtro y, a continuación, seleccione apphub_application_id. En el campo de valor, introduce un nombre de App Hub específico.
   2. En la entrada Agregación, selecciona Sin agregar en el primer menú.

   Para obtener más información sobre cómo configurar un gráfico, consulta el artículo Seleccionar métricas al utilizar el explorador de métricas.

Limpieza

Limpiar una aplicación y quitar la vinculación de un proyecto de servicio del proyecto host para eliminar los recursos asociados al proyecto. De esta forma, se detiene el descubrimiento automático de recursos en el proyecto de servicio.

Para ello, primero debes eliminar las cargas de trabajo y los servicios registrados en la aplicación.

Consola

1. En la Google Cloud consola, ve a la página Centro de aplicaciones Aplicaciones.

   Ve a Aplicaciones.

2. Haz clic en el nombre de una aplicación. Aparecerá una lista de los servicios y las cargas de trabajo registrados en la aplicación.

3. Anula el registro de un servicio o una carga de trabajo.

   1. En la pestaña Servicios y cargas de trabajo, vaya a la sección Servicios y cargas de trabajo registrados y haga clic en el nombre del servicio o la carga de trabajo que quiera anular.
   2. En la pestaña Detalles, haga clic en Anular registro para actualizar el servicio o la carga de trabajo como recurso Descubierto.
      En la pestaña Servicios y cargas de trabajo, una alerta indica que la carga de trabajo no está registrada.
   3. Repite estos pasos con cada servicio y carga de trabajo.

4. Ve a la página Aplicaciones del centro de aplicaciones.

   Ve a Aplicaciones.

5. Haz clic en el nombre de una aplicación.

6. En la página con los detalles de la aplicación, haz clic en Eliminar.

7. Para quitar los proyectos de servicio de tu proyecto host, consulta la sección Añadir o quitar proyectos de servicio de este documento.

8. Para quitar los proyectos de servicio del ámbito de las métricas del proyecto host, sigue estos pasos:

   1. En la Google Cloud consola, ve a la página  Configuración:

      Ve a Configuración.

      Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuya sección sea Monitorización.

   2. Selecciona Ámbito de la métrica.
   3. En el panel Proyectos de Google Cloud, haga clic en Quitar proyecto y, a continuación, complete el cuadro de diálogo de confirmación.

gcloud

1. Lista las cargas de trabajo registradas en la aplicación:

   gcloud apphub applications workloads list \
     --application=APPLICATION_NAME --project=HOST_PROJECT_ID \
     --location=REGION
   

2. Da de baja la carga de trabajo de la aplicación:

   gcloud apphub applications workloads delete WORKLOAD_NAME \
     --application=APPLICATION_NAME \
     --project=HOST_PROJECT_ID \
     --location=REGION
   

   La carga de trabajo ahora es una carga de trabajo descubierta que se puede registrar en la aplicación.

3. Repite el comando anterior para eliminar las cargas de trabajo registradas restantes de la aplicación.

4. Muestra los servicios registrados en la aplicación:

   gcloud apphub applications services list \
     --application=APPLICATION_NAME \
     --project=HOST_PROJECT_ID \
     --location=REGION
   

5. Da de baja el servicio de la aplicación:

   gcloud apphub applications services delete SERVICE_NAME \
     --application=APPLICATION_NAME \
     --project=HOST_PROJECT_ID \
     --location=REGION
   

   El servicio ahora es un servicio detectado que se puede registrar en la aplicación.

6. Repite el comando anterior para anular el registro de los servicios registrados restantes de la aplicación.

7. Elimina la aplicación:

   gcloud apphub applications delete APPLICATION_NAME \
     --project=HOST_PROJECT_ID \
     --location=REGION
   

8. Para quitar un proyecto de servicio del proyecto del host, sigue estos pasos:

   gcloud apphub service-projects remove SERVICE_PROJECT_ID \
     --project=HOST_PROJECT_ID
   

9. Repite el comando anterior para quitar todos los proyectos de servicio del proyecto host.

10. Quita los proyectos de servicio del ámbito de las métricas del proyecto host (Vista previa):

    gcloud beta monitoring metrics-scopes delete projects/SERVICE_PROJECT_ID \
      --project=HOST_PROJECT_ID
    

11. Repite el comando anterior para quitar todos los proyectos de servicio del proyecto host del ámbito de las métricas.

Siguientes pasos

• Configurar la monitorización de aplicaciones
• Roles y permisos de gestión de identidades y accesos de App Hub
• Descripción general de App Hub
• Solucionar problemas