Inicio rápido: Ejecución de la primera consulta de Resource Graph mediante Azure Resource Graph Explorer

El poder de Azure Resource Graph está disponible directamente en Azure Portal mediante Azure Resource Graph Explorer. Resource Graph Explorer proporciona información de exploración sobre los tipos de recursos Azure Resource Manager y las propiedades que puede consultar. Resource Graph Explorer también proporciona una interfaz limpia para trabajar con varias consultas, evaluar los resultados e incluso convertir los de algunas consultas en un gráfico que se puede anclar a un panel de Azure.

Al final de este inicio rápido, habrá usado Azure Portal y Resource Graph Explorer para ejecutar la primera consulta de Resource Graph y anclar los resultados a un panel.

Requisitos previos

Si no tiene una suscripción a Azure, cree una cuenta gratuita antes de empezar.

Ejecutar la primera consulta de Resource Graph

Abra Azure Portal para buscar y usar Azure Resource Graph Explorer y siga estos pasos para ejecutar la primera consulta de Resource Graph:

  1. Seleccione Todos los servicios en el panel izquierdo. Busque y seleccione Resource Graph Explorer.

  2. En la parte Consulta 1 de la ventana, escriba la consulta Resources | project name, type | limit 5 y seleccione Ejecutar consulta.

    Nota

    Como esta consulta de ejemplo no proporciona un modificador de ordenación como order by, es probable que al ejecutar esta consulta varias veces se produzca un conjunto diferente de recursos por solicitud.

  3. Revise la respuesta de la consulta en la pestaña Resultados. Seleccione la pestaña Mensajes para ver los detalles de la consulta, incluido el número de resultados y la duración. Los errores, si los hay, se muestran en esta pestaña.

  4. Actualice la consulta para que se aplique order by a la propiedad Nombre: Resources | project name, type | limit 5 | order by name asc. Luego, seleccione Ejecutar consulta.

    Nota

    Al igual que con la primera consulta, es probable que al ejecutar esta consulta varias veces se produzca un conjunto diferente de recursos por solicitud. El orden de los comandos de consulta es importante. En este ejemplo, el order by viene después del limit. Este orden de comandos limita primero los resultados de la consulta y, luego, los ordena.

  5. Actualice la consulta para que primero se aplique order by a la propiedad Nombre y, después, limit a los cinco primeros resultados: Resources | project name, type | order by name asc | limit 5. Luego, seleccione Ejecutar consulta.

Cuando la consulta final se ejecuta varias veces, suponiendo que nada cambie en su entorno, los resultados devueltos serán coherentes y estarán ordenados por la propiedad Nombre, pero todavía limitados a los cinco primeros resultados.

Explorador de esquema

El explorador de esquema se encuentra en el panel izquierdo de Resource Graph Explorer. En esta lista de recursos se muestran todos los tipos de recursos de Azure que son compatibles con Azure Resource Graph y que existen en un inquilino al que tiene acceso. Al expandir un tipo de recurso o las subpropiedades, se muestran las propiedades secundarias que se pueden usar para crear una consulta de Resource Graph.

La selección del tipo de recurso coloca where type =="<resource type>" en el cuadro de consulta. La selección de una de las propiedades secundarias agrega where <propertyName> == "INSERT_VALUE_HERE" al cuadro de consulta. El explorador de esquema es una excelente manera de detectar las propiedades que se usan en las consultas. Asegúrese de reemplazar INSERTAR_VALOR_AQUÍ por su propio valor y ajuste la consulta con condiciones, operadores y funciones para conseguir los resultados esperados.

Creación de un gráfico a partir de la consulta de Resource Graph

Después de ejecutar la consulta anterior, si selecciona la pestaña Gráficos, recibirá un mensaje que indica que el conjunto de resultados no es compatible con una visualización de gráfico circular. Las consultas que muestran resultados no se pueden convertir en un gráfico, pero las consultas que proporcionan recuentos de recursos sí. Mediante la consulta de ejemplo Recuento de máquinas virtuales por tipo de sistema operativo, vamos a crear una visualización a partir de la consulta de Resource Graph.

  1. En la parte Consulta 1 de la ventana, escriba la siguiente consulta y seleccione Ejecutar consulta.

    Resources
    | where type =~ 'Microsoft.Compute/virtualMachines'
    | summarize count() by tostring(properties.storageProfile.osDisk.osType)
    
  2. Seleccione la pestaña Resultados y observe que en la respuesta de esta consulta se proporcionan recuentos.

  3. Seleccione la pestaña Gráficos. Ahora, la consulta genera visualizaciones. En Seleccione el tipo de gráfico... , cambie el tipo a Gráfico de barras o Gráfico de anillos para experimentar con las opciones de visualización disponibles.

Anclar la visualización de la consulta a un panel

Si tiene resultados de una consulta que se pueden visualizar, esa visualización de datos se puede anclar a uno de los paneles. Después de ejecutar la consulta anterior, siga estos pasos:

  1. Seleccione Guardar y proporcione el nombre "Máquinas virtuales por tipo de SO". Luego, seleccione Guardar en la parte inferior del panel derecho.

  2. Seleccione Ejecutar consulta para volver a ejecutar la consulta ahora que se ha guardado.

  3. En la pestaña Gráficos, seleccione una visualización de datos. Seleccione Anclar al panel.

  4. Seleccione la notificación del portal que aparece o seleccione Panel en el panel izquierdo.

La consulta ahora está disponible en el panel con el título del icono que coincide con el nombre de la consulta. Si la consulta no se guardó cuando se ancló, se denomina entonces "Consulta 1".

La consulta y la visualización de datos resultante se ejecutan y actualizan cada vez que se carga el panel, de forma que se proporcionan conclusiones dinámicas y en tiempo real al entorno de Azure directamente en el flujo de trabajo.

Nota

Las consultas que dan como resultado una lista también se pueden anclar al panel. La característica no está limitada a las visualizaciones de datos de las consultas.

Importación de paneles de Resource Graph Explorer de ejemplo

Para proporcionar ejemplos de consultas de Resource Graph y cómo se puede usar Resource Graph Explorer para mejorar el flujo de trabajo de Azure Portal, pruebe estos paneles de ejemplo.

Nota

Los recuentos y gráficos de las capturas de pantallas anteriores del panel de ejemplo varían en función del entorno de Azure.

  1. Seleccione y descargue el panel de ejemplo que quiere evaluar.

  2. En Azure Portal, seleccione Panel en el panel izquierdo.

  3. Seleccione Cargar y, luego, busque y seleccione el archivo del panel de ejemplo descargado. A continuación, seleccione Abrir.

El panel importado se muestra automáticamente. Dado que ahora existe en Azure Portal, puede explorar y realizar cambios según sea necesario o crear paneles a partir del ejemplo para compartirlos con los equipos. Para más información sobre cómo trabajar con paneles, consulte Creación y uso compartido de paneles en Azure Portal.

Limpieza de recursos

Si quiere quitar los paneles de ejemplo de Resource Graph del entorno de Azure Portal, puede hacerlo con los pasos siguientes:

  1. Seleccione Panel en el panel izquierdo.

  2. En la lista desplegable de paneles, seleccione el panel de ejemplo de Resource Graph que quiere eliminar.

  3. En el menú de la parte superior del panel, seleccione Eliminar y, luego, Aceptar.

Pasos siguientes

En esta guía de inicio rápido, ha usado Azure Resource Graph Explorer para ejecutar la primera consulta y ha examinado los ejemplos de paneles con tecnología de Resource Graph. Para más información sobre el lenguaje de Resource Graph, vaya a la página de detalles del lenguaje de consulta.