Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
Conéctate a una fuente de datos de Google Cloud Monitoring
nota
En versiones anteriores de Grafana, esta fuente de datos se denominaba Google Stackdriver.
Agrega la fuente de datos de Google Cloud Monitoring para poder crear paneles para tus métricas de Google Cloud Monitoring.
Añadir la fuente de datos
-
Abre el menú lateral seleccionando el icono de Grafana en el encabezado superior.
-
En el menú lateral, debajo del enlace de los paneles, encontrarás el enlace de las fuentes de datos.
-
Pulse el botón + Añadir fuente de datos en el encabezado superior.
-
Selecciona Google Cloud Monitoring en la lista desplegable Tipo.
-
Carga o pega el archivo de clave de la cuenta de servicio. Consulte más adelante en este documento los pasos para crear un archivo de clave de cuenta de servicio.
nota
Si no ve el enlace Fuentes de datos en el menú lateral, significa que su usuario actual no tiene el Admin rol.
| Nombre | Descripción |
|---|---|
Name
|
El nombre de la fuente de datos. Así es como se hace referencia a la fuente de datos en los paneles y las consultas. |
Default
|
La fuente de datos predeterminada significa que se preseleccionará para los nuevos paneles. |
Service Account Key
|
Archivo de clave de cuenta de servicio para un proyecto de GCP. Consulta las instrucciones que aparecen más adelante en este documento sobre cómo crearlo. |
Autenticación
Hay dos formas de autenticar el complemento Google Cloud Monitoring
-
Sube un archivo JWT de Google
-
Recupera automáticamente las credenciales del servidor de metadatos de Google
La última opción solo está disponible cuando se ejecuta Grafana en una máquina virtual GCE.
Uso de un archivo de clave de cuenta de servicio de Google
Para autenticarte con la API de Google Cloud Monitoring, debes crear una cuenta de servicio de Google Cloud Platform (GCP) para el proyecto del que quieres mostrar los datos. Una fuente de datos de Grafana se integra con un proyecto de GCP. Para visualizar los datos de varios proyectos de GCP, debes crear una fuente de datos por proyecto de GCP.
Habilitar las API
Primero se deben habilitar las siguientes API:
Selecciona los enlaces de la lista y, a continuación, selecciona el botón Activar.
Crear una cuenta de servicio de GCP para un proyecto
-
Seleccione el botón o menú desplegable Crear credenciales y elija la opción de clave de cuenta de servicio.
{{< docs-imagebox img=» /img/docs/v71/cloudmonitoring_create_service_account_button.png "class="docs-image—no-shadow» caption="Botón para crear una cuenta de servicio» >}}
-
En la página de creación de la clave de la cuenta de
JSONservicio, selecciona el tipo de clave. Luego, en la lista desplegable Cuenta de servicio, elige la opción Nueva cuenta de servicio.{{< docs-imagebox img=» /img/docs/v71/cloudmonitoring_create_service_account_key.png "class="docs-image—no-shadow» caption="Crear clave de cuenta de servicio» >}}
-
Aparecerán algunos campos nuevos. Introduzca un nombre para la cuenta de servicio en el campo Nombre de la cuenta de servicio y, a continuación, elija la función Monitoring Viewer en la lista desplegable Función.
{{< docs-imagebox img=» /img/docs/v71/cloudmonitoring_service_account_choose_role.png "class="docs-image—no-shadow» caption="Elegir rol» >}}
-
Elija el botón Crear. Se creará un archivo de clave JSON y se descargará en tu ordenador. Guarde este archivo en un lugar seguro, ya que permite el acceso a sus datos de Google Cloud Monitoring.
-
Cárguelo en Grafana en la página de configuración de la fuente de datos. Puede cargar el archivo o pegar el contenido del archivo.
{{< docs-imagebox img=» /img/docs/v71/cloudmonitoring_grafana_upload_key.png "class="docs-image—no-shadow» caption="Sube el archivo clave de servicio a Grafana» >}}
-
El contenido del archivo se cifrará y guardará en la base de datos de Grafana. ¡No olvides guardarlo después de cargar el archivo!
{{< docs-imagebox img=» /img/docs/v71/cloudmonitoring_grafana_key_uploaded.png "class="docs-image—no-shadow» caption="El archivo clave de servicio se ha subido a Grafana» >}}
Uso del editor de consultas de
El editor de consultas de Google Cloud Monitoring te permite crear dos tipos de consultas: métricas y de objetivo de nivel de servicio (SLO). Ambos tipos devuelven datos de series temporales.
Consultas métricas
El editor de consultas de métricas le permite seleccionar métricas, agruparlas o agregarlas por etiquetas y por tiempo, y usar filtros para especificar qué series temporales desea incluir en los resultados.
Para crear una consulta de métricas, sigue estos pasos:
-
Elija la opción Métricas en la lista desplegable Tipo de consulta.
-
Elija un proyecto de la lista desplegable de proyectos.
-
Elige un servicio de Google Cloud Platform de la lista desplegable de servicios.
-
Elige una métrica de la lista desplegable de métricas.
-
Para añadir o eliminar filtros o agrupar por cláusulas, utilice los iconos de signo más y menos del filtro y agrupe por secciones. Este paso es opcional.
Las métricas de Google Cloud Monitoring pueden ser de distintos tipos (GAUGE, DELTA o CUMULATIVE) y admiten diferentes opciones de agregación (reductores y alineadores). El editor de consultas de Grafana muestra la lista de métodos de agregación disponibles para una métrica seleccionada y establece un reductor y un alineador predeterminados al seleccionar la métrica. El editor de consultas también selecciona automáticamente las unidades del eje Y.
Filtros
Para añadir un filtro, pulse el icono del signo más, elija un campo por el que filtrar e introduzca un valor de filtro. Por ejemplo, escriba instance_name =
grafana-1. Para eliminar el filtro, elija el nombre del filtro y seleccione--remove filter--.
Caracteres comodín simples
Si el operador está establecido en o, = != es posible añadir caracteres comodín al campo de valor del filtro. Por ejemplo, us-* captura todos los valores que comienzan por «us-» y *central-a captura todos los valores que terminan por «central-a». *-central-*captura todos los valores que tienen la subcadena de. central- Los caracteres comodín simples son menos costosos que las expresiones regulares.
Expresiones regulares
Si el operador está establecido en o, =~ !=~ es posible añadir expresiones regulares al campo del valor del filtro. Por ejemplo, us-central[1-3]-[af] coincide con todos los valores que comiencen por «us-central», seguidos de un número comprendido entre 1 y 3, un guión y, a continuación, una «a» o una «f». No se necesitan barras diagonales iniciales y finales al crear expresiones regulares.
Agregación
El campo de agregación permite combinar series temporales en función de estadísticas comunes. Para obtener más información sobre la agregación, consulte las opciones de agregación
El Aligner campo le permite alinear varias series temporales después del mismo grupo por intervalo de tiempo. Para obtener más información sobre el alineador, consulte el selector de métricas de alineación
Período de alineación y agrupación por tiempo
Alignment PeriodAgrupa una métrica por tiempo si se elige una agregación. De forma predeterminada, se utilizan las agrupaciones predeterminadas de Google Cloud Monitoring de GCP (que te permiten comparar los gráficos de Grafana con los gráficos de la interfaz de usuario de Google Cloud Monitoring). Se llama a la opción cloud monitoring auto y los valores predeterminados son:
-
1 m para intervalos de tiempo inferiores a 23 horas
-
1 m para intervalos de tiempo = 23 horas y < 6 días
-
5 m para intervalos de tiempo >= 23 horas y = 6 días
La otra opción automática es. grafana auto Esto configurará automáticamente el grupo por tiempo en función del rango de tiempo elegido y del ancho del panel gráfico. Para obtener más información, consulte Añadir una variable de intervalo.
También es posible elegir intervalos de tiempo fijos para agruparlos, como 1h o1d.
Agrupar por
Agrupe por etiquetas de recursos o métricas para reducir el número de series temporales y agregar los resultados agrupados por. Por ejemplo, agrupe por instance_name para ver una métrica agregada de una instancia de cómputo.
Etiquetas de metadatos
Las etiquetas de metadatos de los recursos contienen información para identificar de forma exclusiva un recurso en Google Cloud. Las etiquetas de metadatos solo se muestran en la respuesta de serie temporal si forman parte del segmento Agrupar por de la solicitud de serie temporal. No hay una API para recuperar las etiquetas de metadatos, por lo que no es posible rellenar la lista desplegable del grupo con las etiquetas de metadatos que están disponibles para el servicio y la métrica seleccionados. Sin embargo, la lista desplegable Agrupar por campos incluye una lista predefinida de etiquetas comunes del sistema.
Las etiquetas de usuario no se pueden predefinir, pero se pueden introducir manualmente en el campo Agrupar por. Si se incluye una etiqueta de metadatos, una etiqueta de usuario o una etiqueta de sistema en el segmento Agrupar por, puede crear filtros basados en ella y ampliar su valor en el campo Alias.
Patrones de alias
El campo Alias By permite controlar el formato de las claves de la leyenda. El valor predeterminado es mostrar el nombre y las etiquetas de la métrica. Esto puede ser largo y difícil de leer. Si utiliza los siguientes patrones en el campo de alias, puede formatear la clave de la leyenda del modo que desee.
Patrones de tipo métrico
| Patrón de alias | Descripción | Ejemplo de resultado |
|---|---|---|
{{metric.type}}
|
Devuelve el tipo de métrica completo. |
compute.googleapis.com/instance/cpu/utilization
|
{{metric.name}}
|
Devuelve la parte del nombre de la métrica. |
instance/cpu/utilization
|
{{metric.service}}
|
Devuelve la parte de servicio. |
compute
|
Patrones de etiquetas
En la lista desplegable Agrupar por, puedes ver una lista de etiquetas de métricas y recursos de una métrica. Se pueden incluir en la clave de la leyenda mediante patrones de alias.
| Formato de patrón de alias | Descripción | Ejemplo de patrón de alias | Ejemplo de resultado |
|---|---|---|---|
{{metric.label.xxx}}
|
Devuelve el valor de la etiqueta métrica. |
{{metric.label.instance_name}}
|
grafana-1-prod
|
{{resource.label.xxx}}
|
Devuelve el valor de la etiqueta del recurso. |
{{resource.label.zone}}
|
us-east1-b
|
{{metadata.system_labels.xxx}}
|
Devuelve el valor de la etiqueta del sistema de metadatos. |
{{metadata.system_labels.name}}
|
grafana
|
{{metadata.user_labels.xxx}}
|
Devuelve el valor de la etiqueta de usuario de los metadatos. |
{{metadata.user_labels.tag}}
|
production
|
Ejemplo de alias de: {{metric.type}} -
{{metric.label.instance_name}}
Ejemplo de resultado: compute.googleapis.com/instance/cpu/usage_time
- server1-prod
También es posible resolver el nombre del tipo de recurso monitoreado.
| Formato de patrón de alias | Descripción | Ejemplo de resultado |
|---|---|---|
{{resource.type}}
|
Devuelve el nombre del tipo de recurso supervisado. |
gce_instance
|
Ejemplo de alias de: {{resource.type}} - {{metric.type}}
Ejemplo de resultado: gce_instance -
compute.googleapis.com/instance/cpu/usage_time
Consultas de SLO
nota
Las consultas SLO solo están disponibles en Grafana v7.0+
El generador de consultas de SLO de la fuente de datos de Google Cloud Monitoring te permite mostrar los datos de SLO en formato de series temporales. Para comprender los conceptos básicos de la supervisión de servicios, consulta la documentación oficial
Cómo crear una consulta de SLO
Para crear una consulta de SLO, sigue estos pasos:
-
Elija la opción Objetivos de nivel de servicio (SLO) en la lista desplegable de tipos de consulta.
-
Elija un proyecto de la lista desplegable de proyectos.
-
Elija un servicio de SLO
de la lista desplegable de servicios. -
Elija un SLO de la lista
desplegable de SLO. -
Elija un selector de series temporales
de la lista desplegable del selector.
Los nombres descriptivos de los selectores de series temporales se muestran en Grafana. En la siguiente tabla se muestra la asignación del nombre descriptivo al nombre del sistema que se utiliza en la documentación de supervisión del servicio.
| Seleccione el valor de la lista desplegable | Se utilizó el selector de series temporales correspondiente |
|---|---|
| Valor SLI | select_slo_health |
| Cumplimiento de SLO | select_slo_compliance |
| Error de SLO: queda el presupuesto | select_slo_budget_fraction |
Patrones de alias para consultas de SLO
Puede usar el campo Alias By para controlar el formato de las claves de leyenda de las consultas de SLO.
| Patrón de alias | Descripción | Ejemplo de resultado |
|---|---|---|
{{project}}
|
Devuelve el nombre del proyecto de GCP. |
myProject
|
{{service}}
|
Devuelve el nombre del servicio. |
myService
|
{{slo}}
|
Devuelve el SLO. |
latency-slo
|
{{selector}}
|
Devuelve el selector. |
select_slo_health
|
Período de alineación y agrupación por tiempo para las consultas de SLO
Las consultas de SLO utilizan la misma funcionalidad de período de alineación que las consultas métricas. Para obtener más información, consulte Consultas métricas.
Creación de plantillas
En lugar de codificar elementos como el nombre del servidor, la aplicación y el sensor en las consultas de métricas, puede utilizar variables en su lugar. Las variables se muestran como cuadros de selección desplegables en la parte superior del panel de control. Puedes usar estos cuadros desplegables para cambiar los datos que se muestran en tu panel de control.
Para obtener más información sobre las plantillas y las variables de plantilla, consulte. Plantillas y variables
Variable de consulta
La variable del tipo Query te permite consultar varios tipos de datos en Google Cloud Monitoring. El complemento de fuente de datos de Google Cloud Monitoring proporciona lo siguienteQuery
Types.
| Nombre | Descripción |
|---|---|
Metric Types
|
Devuelve una lista de los nombres de los tipos de métricas que están disponibles para el servicio especificado. |
Labels Keys
|
Devuelve una lista de claves para metric label y dentro resource label de la métrica especificada. |
Labels Values
|
Devuelve una lista de valores para la etiqueta de la métrica especificada. |
Resource Types
|
Devuelve una lista de tipos de recursos para la métrica especificada. |
Aggregations
|
Devuelve una lista de agregaciones (reductores de series cruzadas) para la métrica especificada. |
Aligners
|
Devuelve una lista de alineadores (alineadores por serie) para la métrica especificada. |
Alignment periods
|
Devuelve una lista de todos los períodos de alineación que están disponibles en el editor de consultas de Google Cloud Monitoring en Grafana. |
Selectors
|
Devuelve una lista de selectores que se pueden usar en las consultas de SLO (objetivos de nivel de servicio). |
SLO Services
|
Devuelve una lista de los servicios de supervisión de servicios que se pueden utilizar en las consultas de SLO. |
Service Level Objectives (SLO)
|
Devuelve una lista de los SLO para el servicio de SLO especificado. |
Uso de variables en las consultas
Hay dos sintaxis:
-
$<varname>Ejemplo:metric.label.$metric_label -
[[varname]]Ejemplo:metric.label.[[metric_label]]
¿Por qué de dos maneras? La primera sintaxis es más fácil de leer y escribir, pero no permite utilizar una variable en mitad de una palabra. Cuando las opciones de varios valores o Incluir todos los valores están habilitadas, Grafana convierte las etiquetas de texto sin formato a una cadena compatible con expresiones regulares, lo que significa que debe utilizarlas en lugar de. =~ =
Annotations
Puede utilizar las anotaciones para superponer información detallada sobre los eventos sobre los gráficos. Las consultas de anotación se añaden a través del menú del panel de control o la vista de anotaciones. La representación de anotaciones es cara, por lo que es importante limitar el número de filas devueltas. Todavía no se puede mostrar las anotaciones y los eventos de Google Cloud Monitoring, pero funciona bien con métricas personalizadas
Para obtener más información sobre las anotaciones, consulta. Annotations
Con el editor de consultas para anotaciones, puede seleccionar una métrica y filtrar. Los campos Título y Texto admiten la creación de plantillas y pueden utilizar los datos devueltos por la consulta. Por ejemplo, el campo Título podría tener el siguiente texto:
{{metric.type}} has value: {{metric.value}}
Ejemplo de resultado: monitoring.googleapis.com/uptime_check/http_status has
this value: 502
Patrones para el editor de consultas de anotaciones
| Formato de patrón de alias | Descripción | Ejemplo de patrón de alias | Ejemplo de resultado |
|---|---|---|---|
{{metric.value}}
|
Valor de la métrica/punto. |
{{metric.value}}
|
555
|
{{metric.type}}
|
Devuelve el tipo de métrica completo. |
{{metric.type}}
|
compute.googleapis.com/instance/cpu/utilization
|
{{metric.name}}
|
Devuelve la parte del nombre de la métrica. |
{{metric.name}}
|
instance/cpu/utilization
|
{{metric.service}}
|
Devuelve la parte de servicio. |
{{metric.service}}
|
compute
|
{{metric.label.xxx}}
|
Devuelve el valor de la etiqueta métrica. |
{{metric.label.instance_name}}
|
grafana-1-prod
|
{{resource.label.xxx}}
|
Devuelve el valor de la etiqueta del recurso. |
{{resource.label.zone}}
|
us-east1-b
|
Enlaces profundos desde los paneles de Grafana al Explorador de métricas de Google Cloud Console
nota
Esta función solo está disponible para las consultas de métricas.
Selecciona una serie temporal en el panel para ver un menú contextual con un enlace a Ver en Metrics Explorer en Google Cloud Console. Al elegir ese enlace, se abre el Explorador de métricas en Google Cloud Console y se ejecuta la consulta desde el panel de Grafana. El enlace lleva al usuario primero al selector de cuentas de Google. Tras seleccionar correctamente una cuenta, se redirige al usuario al explorador de métricas. El enlace proporcionado es válido para cualquier cuenta, pero solo muestra la consulta si tu cuenta tiene acceso al proyecto de GCP especificado en la consulta.
