Después de implementar Google Cloud Managed Service para Prometheus, puedes consultar los datos enviados al servicio administrado y mostrar los resultados en gráficos y paneles.
En este documento, se describen los permisos de métricas, que determinan los datos que puedes consultar, y cómo usar Cloud Monitoring para recuperar y usar los datos que recopilaste.
Todas las interfaces de consulta de los servicios administrados para Prometheus están configuradas a fin de recuperar datos de Monarch mediante la API de Cloud Monitoring. Cuando consultas Monarch en lugar de consultar datos desde servidores locales de Prometheus, obtienes supervisión global a gran escala.
Antes de comenzar
Si aún no implementaste el servicio administrado, configura la colección administrada o la colección autoimplementada. Puedes omitirlo si solo te interesa consultar las métricas de Cloud Monitoring mediante PromQL.
Permisos de las consultas y las métricas
Los datos que puedes consultar se determinan por el permiso de las métricas de construcción de Cloud Monitoring, independientemente del método que uses para consultar los datos.
El alcance de las métricas de Monitoring es una construcción de solo lectura que te permite consultar datos de métricas que pertenecen a varios proyectos de Google Cloud. Cada permiso de métricas está alojado en un proyecto de Google Cloud designado, llamado proyecto de permisos.
De forma predeterminada, un proyecto es el proyecto de permisos para su propio permiso de métricas, y el permiso de métricas contiene las métricas y la configuración de ese proyecto. Un proyecto de permisos puede tener más de un proyecto supervisado en su permiso, y las métricas y configuraciones de todos los proyectos supervisados en el alcance de las métricas son visibles para el proyecto de permisos. Un proyecto supervisado también puede pertenecer a más de un permiso de métricas.
Cuando consultas las métricas de un proyecto de permisos y si ese proyecto aloja un permiso de métricas de varios proyectos, puedes recuperar datos de varios proyectos. Si tu permiso de métricas contiene todos tus proyectos, tus consultas y reglas se evalúan a nivel global.
Para obtener más información sobre los proyectos de permisos y los permisos de métricas, consulta Permisos de las métricas. Si deseas obtener información para configurar un permiso de métricas de varios proyectos, consulta Visualiza métricas de varios proyectos.
Datos de Managed Service para Prometheus en Cloud Monitoring
El servicio administrado para Prometheus comparte el backend de almacenamiento de datos, Monarch, con Cloud Monitoring. Puedes usar todas las herramientas que proporciona Cloud Monitoring con los datos que recopila el servicio administrado para Prometheus. Por ejemplo, puedes usar el Explorador de métricas, como se describe en la consola de Google Cloud para Monitoring, y puedes configurar alertas basadas en estas métricas. También puedes importar tus paneles de Grafana a Cloud Monitoring.
Cuando trabajas con datos de métricas, incluidos los datos del servicio administrado para Prometheus, en Cloud Monitoring, puedes usar las herramientas de consulta que proporciona Cloud Monitoring:
Consulta mediante PromQL en Cloud Monitoring
La forma más sencilla de consultar tus datos de Prometheus es usar la página Explorador de métricas de Cloud Monitoring en la consola de Google Cloud. Para verificar que tus datos de Prometheus se recopilen de forma correcta, haz lo siguiente:
-
En el panel de navegación de la consola de Google Cloud, elige Monitoring y, luego, leaderboard Explorador de métricas:
En la barra de herramientas del panel del compilador de consultas, selecciona el botón cuyo nombre sea code MQL o code PromQL.
Verifica que PromQL esté seleccionado en el botón de activación Lenguaje. El botón de activación de lenguaje se encuentra en la misma barra de herramientas que te permite dar formato a tu consulta.
Ingresa la siguiente consulta en el editor y, luego, haz clic en Ejecutar consulta:
up
Si se están transfiriendo tus datos, verás un gráfico como el siguiente:
Para obtener información sobre cómo consultar las métricas del sistema de Cloud Monitoring mediante PromQL, consulta PromQL para las métricas de Cloud Monitoring.
Para obtener más información sobre cómo usar PromQL en los gráficos del Explorador de métricas y Cloud Monitoring, consulta PromQL en Cloud Monitoring.
Otras opciones de consulta en Cloud Monitoring
Para ver los datos de Prometheus como series temporales de Cloud Monitoring y crear gráficos y paneles, también puedes usar las interfaces controladas por menús o MQL. A continuación, se muestra una consulta simple en el Explorador de métricas:
-
En el panel de navegación de la consola de Google Cloud, elige Monitoring y, luego, leaderboard Explorador de métricas:
Especifica los datos que deben aparecer en el gráfico. Además de usar el botón PromQL descrito antes, también puedes usar la interfaz controlada por menús. Para construir una consulta, haz lo siguiente:
En el panel del compilador de consultas, haz clic en “Selecciona una métrica”.
En el campo de búsqueda, escribe “up/” para filtrar la lista y, luego, selecciona Prometheus Target, luego selecciona Up y, luego, selecciona Prometheus/up/gauge.
Haz clic en "Aplicar".
En el gráfico que resulta de esta consulta, se muestran los mismos datos que el gráfico que aparece en el ejemplo de PromQL.
Las consultas creadas con la interfaz controlada por el menú se pueden convertir en PromQL si seleccionas el botón PromQL. Es posible que esta traducción no convierta de forma correcta las funciones de histogramas o cualquier otro operador poco común.
El recurso prometheus_target
En Cloud Monitoring, los datos de series temporales se escriben en un tipo de recurso supervisado. Para las métricas de Prometheus, el tipo de recurso supervisado es prometheus_target. Las consultas de supervisión para las métricas de Prometheus que no están escritas en PromQL deben especificar este tipo de recurso.
El recurso prometheus_target tiene las siguientes etiquetas, que puedes usar para filtrar y manipular datos consultados:
project_id: El identificador del proyecto de Google Cloud asociado a este recurso.location: Es la ubicación física (región de Google Cloud) en la que se almacenan los datos. Este valor suele ser la región de tu clúster de GKE o instancia de Compute Engine. Si se recopilan datos de una implementación local o de AWS, el valor puede ser la región de Google Cloud más cercana.cluster: el clúster de GKE o el concepto relacionado; podría estar vacío.namespace: El espacio de nombres de GKE o el concepto relacionado podría estar vacío.job: La etiqueta de trabajo del destino de Prometheus, si se conoce; puede estar vacía para los resultados de la evaluación de reglas.instance: La etiqueta de la instancia del destino de Prometheus, si se conoce; puede estar vacía para los resultados de la evaluación de la regla.
Los valores de estas etiquetas se establecen durante la recopilación.