En este documento, se describe cómo se configura el permiso de métricas de un proyecto de administración. Google Cloud Crea un proyecto de administración cuando habilitas una carpeta para la supervisión de aplicaciones. El proyecto de administración almacena la información de configuración que requieren los servicios de Google Cloud Observability y es el proyecto que usas para ver la telemetría de tu aplicación.
Si no usas una carpeta habilitada para apps, este documento no se aplica. En su lugar, consulta Configura un permiso de métricas.
En esta página, se describe cómo ver el uso de la cuota de tu permiso de métricas, cómo solicitar una actualización de cuota y cómo actualizar manualmente el permiso de métricas de tu proyecto de administración.
Cómo se administra el alcance de las métricas de un proyecto de administración
En el caso de las carpetas habilitadas para apps, Google Cloud Observability intenta sincronizar la lista de proyectos de tu carpeta habilitada para apps con la lista de proyectos del alcance de las métricas. Por ejemplo, si agregas un proyecto a la carpeta habilitada para la app, se emite un comando para agregar ese proyecto al alcance de las métricas.
Cuando la cantidad de proyectos en tu carpeta habilitada para apps no supera la cuota de tu alcance de métricas, que es de 375 proyectos por alcance de métricas de forma predeterminada, la Observabilidad de Google Cloud puede mantener la lista de proyectos del alcance de métricas sincronizada con la lista de proyectos de tu carpeta habilitada para apps. Por ejemplo, supongamos que la cuota es de 375 proyectos por alcance de métricas. Si tu carpeta habilitada para la app contiene 100 proyectos, el alcance de las métricas enumera todos los proyectos de la carpeta habilitada para la app. Si agregas proyectos a la carpeta habilitada para la app, también se agregarán al permiso de las métricas.
Cuando la cantidad de proyectos de tu carpeta habilitada para la app supere la cuota de tu permiso de métricas, la lista de proyectos del permiso de métricas no incluirá todos los proyectos de tu carpeta habilitada para la app. Por ejemplo, supongamos que la cuota es de 375 proyectos por permiso de métricas y que tu carpeta habilitada para la app contiene 380 proyectos. Después de agregar 375 proyectos al alcance de las métricas, se agota la cuota y fallan los intentos de agregar los 5 proyectos restantes. Como resultado, algunos datos de la aplicación no están disponibles para tu proyecto de administración.
Si se agota la cuota del permiso de las métricas, puedes realizar cualquiera de las siguientes acciones:
Cambiar los proyectos que se enumeran en el permiso de las métricas Por ejemplo, puedes quitar algunos proyectos del permiso de métricas para agregar otros.
Solicita un aumento de cuota y, luego, agrega manualmente los proyectos que no se agregaron automáticamente. En el ejemplo anterior, debes agregar manualmente los 5 proyectos que no se pudieron agregar al permiso de las métricas. La Observabilidad de Google Cloud no volverá a intentar agregar un proyecto a un permiso de métricas cuando falle el intento inicial para ese proyecto.
En ambos casos, debes modificar manualmente el permiso de métricas.
Antes de comenzar
- Si no estás familiarizado con el término alcance de las métricas, consulta Descripción general de los alcances de las métricas.
-
Para obtener los permisos que necesitas para configurar un ámbito de métricas, pídele a tu administrador que te otorgue el rol de IAM de Administrador de Monitoring (
roles/monitoring.admin) en el proyecto de administración de tu carpeta habilitada para apps y en cada proyecto que quieras agregar al ámbito de métricas. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.También puedes obtener los permisos necesarios mediante roles personalizados o cualquier otro rol predefinido.
Consulta el uso de tu cuota
Para evitar tener que administrar manualmente el alcance de las métricas de tu proyecto de administración, asegúrate de tener cuota disponible antes de agregar proyectos a tu carpeta habilitada para apps. En esta sección, se describe cómo ver tu uso de cuota actual.
Para ver el uso de la cuota de tu permiso de métricas, haz lo siguiente:
-
En la consola de Google Cloud, ve a la páginasettings Configuración:
Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Monitoring.
- En la consola de Google Cloud, selecciona tu proyecto de administración.
Selecciona Alcance de la métrica.
En el panel Cuota de permisos de métricas, se muestra el uso de la cuota y la cuota. Los íconos de la pestaña Alcance de las métricas tienen el siguiente significado:
El ícono de error, error, indica que se consumió al menos el 90% de tu cuota.
El ícono de advertencia, warning, indica que se consumió entre el 70% y el 90% de tu cuota.
Solicita un aumento de la cuota
Si el uso de tu proyecto de la cuota de alcance de las métricas supera el 70%, aparecerá un ícono de advertencia, warning, o un ícono de error, error, en la pestaña Alcance de las métricas. De forma predeterminada, un permiso de métricas puede incluir 375 proyectos de Google Cloud. Si aumentas tu cuota y agregas más de 375 proyectos de Google Cloud a un permiso de métricas, es posible que experimentes problemas de rendimiento.
Para solicitar un aumento de cuota, haz lo siguiente:
-
En la consola de Google Cloud, ve a la páginasettings Configuración:
Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Monitoring.
- En la consola de Google Cloud, selecciona tu proyecto de administración.
- Selecciona Alcance de la métrica.
En el panel Cuota del alcance de las métricas, selecciona Solicitar aumento de cuota y completa el diálogo.
Asegúrate de solicitar un aumento de la cuota denominada “Proyectos supervisados / alcance de las métricas de supervisión”. Puedes encontrar información detallada sobre esta tarea en el documento Administra la cuota con la consola de Google Cloud.
Después de aumentar tu cuota, puedes agregar proyectos a tu alcance de métricas.
Agrega proyectos a un permiso de métricas
Para agregar proyectos a un permiso de métricas, haz lo siguiente:
-
En la consola de Google Cloud, ve a la páginasettings Configuración:
Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Monitoring.
- En la consola de Google Cloud, selecciona tu proyecto de administración.
Selecciona Alcance de la métrica.
En la pestaña Alcance de métricas, se enumeran los recursos supervisados por el proyecto de Google Cloud actual. También se muestra una lista de los proyectos de Google Cloud cuyos permisos incluyen el proyecto actual de Google Cloud.
Para agregar proyectos de Google Cloud al permiso de las métricas, haz lo siguiente:
- En el panel Google Cloud Projects, haz clic en Add Projects.
En el diálogo Agregar proyectos de Google Cloud, haz clic en Seleccionar proyectos y, luego, realiza tus selecciones. Para guardar los cambios, haz clic en Agregar proyectos.
Volverás a la página Configuración y la tabla de esa página se actualizará para mostrar tus selecciones. Si quieres quitar un proyecto de Google Cloud de la lista, haz clic en cancel Quitar proyecto.
Después de agregar proyectos a un permiso de métricas, los cambios demoran unos 60 segundos en propagarse a través de todos los sistemas de Monitoring. Antes de crear un gráfico o una política de alertas, espera al menos 60 segundos. Es posible que debas actualizar la página de la consola de Google Cloud para que se vean las métricas nuevas.
Se actualizó el permiso de métricas de tu proyecto seleccionado para incluir los proyectos de Google Cloud que seleccionaste.
Quita proyectos de un permiso de métricas
Es posible que quieras quitar proyectos de un permiso de métricas para mejorar el rendimiento o liberar la cuota para poder agregar un proyecto diferente. Por ejemplo, de forma predeterminada, un permiso de métricas puede incluir 375 proyectos de Google Cloud. Si agotaste esta cuota, puedes quitar un proyecto para agregar otro.
Después de quitar un proyecto de un permiso de métricas, el proyecto de alcance no puede graficar ni supervisar los datos de series temporales almacenados en ese proyecto. Quitar un proyecto de un permiso de métricas no cambia la configuración de los gráficos, los paneles, las políticas de alertas, las verificaciones de tiempo de actividad o los grupos que definiste. Sin embargo, la serie temporal que se muestra en los gráficos y la serie temporal supervisada por las políticas de alertas pueden cambiar.
Para quitar proyectos de un permiso de métricas, haz lo siguiente:
-
En la consola de Google Cloud, ve a la páginasettings Configuración:
Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Monitoring.
- En la consola de Google Cloud, selecciona tu proyecto de administración.
- Selecciona Alcance de la métrica.
- En el panel Proyectos de Google Cloud, selecciona los proyectos que deseas quitar, haz clic en Quitar proyecto y, luego, completa el diálogo de confirmación.
Cómo enumerar proyectos en un permiso de métricas
Para enumerar los recursos de un permiso de métricas, haz lo siguiente:
-
En la consola de Google Cloud, ve a la páginasettings Configuración:
Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Monitoring.
- En la consola de Google Cloud, selecciona tu proyecto de administración.
Selecciona Alcance de la métrica.
En la pestaña Alcance de métricas, se enumeran los recursos supervisados por el proyecto de Google Cloud actual. También se muestra una lista de los proyectos de Google Cloud cuyos permisos incluyen el proyecto actual de Google Cloud.