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 Managed Service para Prometheus están configuradas para 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 alcance de las métricas de Cloud Monitoring, independientemente del método que uses para consultar los datos.
Un 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 Google Cloud proyectos. Cada alcance de las métricas está alojado en un proyecto designado Google Cloud , llamado el proyecto de alcance de las métricas.
De forma predeterminada, un proyecto es el proyecto de alcance para su propio alcance de las métricas, y el alcance de las 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 alcance de las métricas.
Cuando consultas las métricas en un proyecto de permisos y, si ese proyecto de permisos aloja un permiso de métricas de varios proyectos, puedes recuperar datos de varios proyectos. Si tu alcance de las métricas contiene todos tus proyectos, tus consultas y reglas se evalúan de forma global.
Para obtener más información sobre los proyectos de alcance y el alcance de las métricas, consulta Alcance de las métricas. Para obtener información sobre cómo configurar el alcance de las métricas de varios proyectos, consulta Cómo ver métricas de varios proyectos.
Datos de Managed Service para Prometheus en Cloud Monitoring
Managed Service 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 Managed Service para Prometheus. Por ejemplo, puedes usar el Explorador de métricas, como se describe en Google Cloud la consola 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 Google Cloud consola de Google Cloud. Para verificar que tus datos de Prometheus se recopilen de forma correcta, haz lo siguiente:
-
En la Google Cloud consola de Google Cloud, accede a la leaderboard Explorador de métricas página:
Acceder al Explorador de métricas
Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Monitoring.
En la barra de herramientas del panel del compilador de consultas, selecciona el botón cuyo nombre sea code PromQL.
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 la Google Cloud consola de Google Cloud, accede a la leaderboard Explorador de métricas página:
Acceder al Explorador de métricas
Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Monitoring.
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. Luego, selecciona Prometheus Target, Up y, por último, 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: Es el identificador del Google Cloud proyecto asociado con este recurso.location: Es la ubicación física (Google Cloud región) 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 los datos se recopilan de una implementación local o de AWS, el valor podría ser la región más cercana Google Cloud .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.