En esta página se describe cómo usar el editor de código para PromQL. El editor está disponible en la consola y ofrece sugerencias y otras herramientas para crear consultas PromQL válidas. Google Cloud
En esta página no se explica el lenguaje PromQL. Para obtener información sobre PromQL, te recomendamos que consultes la documentación de código abierto. Los siguientes recursos pueden ayudarte a empezar:
Acceder al editor de código
Puedes acceder a PromQL desde las siguientes páginas de la consola de Google Cloud :
- Explorador de métricas
- Añadir widget al crear paneles de control
Para abrir el editor de código al usar el explorador de métricas, haz lo siguiente:
-
En la Google Cloud consola, ve a la página leaderboard 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.
- En la barra de herramientas del panel de creación de consultas, selecciona el botón cuyo nombre sea code MQL o code PromQL.
- Verifica que PromQL esté seleccionado en el interruptor Idioma. El interruptor de idioma se encuentra en la misma barra de herramientas que te permite dar formato a tu consulta.
Una vez que hayas completado la consulta, podrás configurar la leyenda o cambiar la forma en que se muestran los datos. Para obtener más información, consulta las siguientes páginas:
Usar el editor de código
Para usar el editor de código, escribe tu consulta en el campo de texto y haz clic en Ejecutar consulta.
Autocompletado
Mientras escribes tu consulta, el editor muestra una lista de finalizaciones sintácticamente válidas. Puedes abrir manualmente el menú de autocompletado pulsando Control+Space y cerrarlo pulsando Escape.
Para desplazarte por la lista de opciones, usa las teclas de flecha.
Si pulsas Enter, se insertará la opción seleccionada.
Para insertar el prefijo común a todas las opciones disponibles, pulsa Tab.
Buscar y reemplazar
El editor incluye una función de buscar y reemplazar. Para buscar y, opcionalmente, sustituir términos en tu consulta, pulsa Control+F (o Command+F en Mac). En la siguiente captura de pantalla se muestra la función:
Controles de editor
El editor tiene dos controles que determinan cómo interactúa con tu consulta.
De forma predeterminada, la consulta solo se ejecuta cuando haces clic en Ejecutar consulta. Puedes configurar el editor para que ejecute automáticamente tu consulta mientras escribes, pero esta opción está inhabilitada de forma predeterminada.
Para habilitar la opción de ejecución automática, usa el interruptor Ejecución automática. Cuando esta opción está habilitada, el editor funciona de la siguiente manera:
- No se muestra el botón Ejecutar consulta.
- Los mensajes de error aparecen continuamente mientras escribes.
Si el cursor está al final de una consulta incompleta, pero no tiene errores, el editor muestra un triángulo amarillo en la barra de control. Si hay espacio, también se muestra el texto Consulta incompleta.
El editor no intenta evaluar las consultas incompletas.
También hay una barra de agarre entre el editor de código y la zona del gráfico. Usa esta barra para cambiar el tamaño relativo de las dos regiones.
Guardar gráficos
La forma de guardar un gráfico depende del contexto en el que lo hayas creado:
- En Explorador de métricas.
- Como parte del proceso de creación o edición de un panel de control personalizado.
Guardar gráficos del explorador de métricas
En el editor de código del Explorador de métricas, puedes guardar el gráfico en un panel de control personalizado. Para guardar el gráfico, siga estos pasos:
-
En la Google Cloud consola, ve a la página leaderboard 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.
- En la barra de herramientas del panel de creación de consultas, selecciona el botón cuyo nombre sea code MQL o code PromQL.
- Verifica que PromQL esté seleccionado en el interruptor Idioma. El interruptor de idioma se encuentra en la misma barra de herramientas que te permite dar formato a tu consulta.
- Escribe tu consulta en el editor.
Si no tienes habilitada la opción de ejecución automática del editor de código, ejecuta la consulta haciendo clic en Ejecutar consulta antes de guardar el gráfico. De forma predeterminada, los paneles de control personalizados guardan periódicamente los cambios que realices. Si no ejecutas tu consulta primero, el editor de código guardará la última consulta que hayas ejecutado.
Haz clic en Guardar gráfico.
Para seguir guardando el gráfico, haz lo siguiente:
- Asigna un título descriptivo al gráfico.
- Selecciona el panel de control del nuevo gráfico.
- En el cuadro de diálogo, haz clic en Guardar.
Guardar gráficos en un panel de control personalizado
Para guardar un gráfico nuevo en tu panel de control, sigue estos pasos:
Asigna un título descriptivo al gráfico.
Si no tienes habilitada la opción de ejecución automática del editor de código, ejecuta la consulta haciendo clic en Ejecutar consulta antes de guardar el gráfico. De forma predeterminada, los paneles de control personalizados guardan periódicamente los cambios que realices. Si no ejecutas tu consulta primero, el editor de código guardará la última consulta que hayas ejecutado.
Si no tienes habilitado el guardado automático en tu panel de control, haz clic en Guardar.
La Google Cloud consola admite filtros a nivel de página para los paneles de control personalizados. Estos filtros se admiten en los gráficos de PromQL de tus paneles de control personalizados.
Salir del editor de código
Para salir del editor de código sin guardar la consulta, haz clic en otra de las pestañas del selector. Se descarta cualquier texto de consulta del editor, pero tienes la opción de guardarlo en el portapapeles.