Libros de Azure MonitorAzure Monitor Workbooks

Los libros proporcionan un lienzo flexible para el análisis de datos y la creación de informes visuales completos en el Azure Portal.Workbooks provide a flexible canvas for data analysis and the creation of rich visual reports within the Azure portal. Permiten acceder a varios orígenes de datos desde Azure y combinarlos en experiencias interactivas unificadas.They allow you to tap into multiple data sources from across Azure, and combine them into unified interactive experiences.

Este es un tutorial en vídeo sobre la creación de libros.Here is a video walkthrough on creating workbooks.

Orígenes de datosData sources

Los libros pueden consultar datos de varios orígenes dentro de Azure.Workbooks can query data from multiple sources within Azure. Los autores de los libros pueden transformar estos datos para proporcionar información sobre la disponibilidad, el rendimiento, el uso y el estado general de los componentes subyacentes.Authors of workbooks can transform this data to provide insights into the availability, performance, usage, and overall health of the underlying components. Por ejemplo, el análisis de los registros de rendimiento de las máquinas virtuales para identificar grandes instancias de CPU o de memoria insuficiente y mostrar los resultados como una cuadrícula en un informe interactivo.For instance, analyzing performance logs from virtual machines to identify high CPU or low memory instances and displaying the results as a grid in an interactive report.

Pero la eficacia real de los libros es la capacidad de combinar datos de orígenes dispares dentro de un único informe.But the real power of workbooks is the ability to combine data from disparate sources within a single report. Esto permite la creación de vistas de recursos compuestas o combinaciones en los recursos, lo que permite obtener datos e información más completos que, de lo contrario, serían imposibles.This allows for the creation of composite resource views or joins across resources enabling richer data and insights that would otherwise be impossible.

Los libros son compatibles actualmente con los siguientes orígenes de datos:Workbooks are currently compatible with the following data sources:

VisualizacionesVisualizations

Los libros proporcionan un amplio conjunto de funciones para visualizar los datos.Workbooks provide a rich set of capabilities for visualizing your data. Para obtener ejemplos detallados de cada tipo de visualización, puede consultar los siguientes vínculos de ejemplo:For detailed examples of each visualization type you can consult the example links below:

Ejemplo de visualizaciones de libros

IntroducciónGetting started

Para explorar la experiencia de los libros, navegue primero hasta el servicio Azure Monitor.To explore the workbooks experience, first navigate to the Azure Monitor service. Para ello, escriba monitor en el cuadro de búsqueda de Azure Portal.This can be done by typing Monitor into the search box in the Azure portal.

A continuación, seleccione Libros.Then select Workbooks.

Captura de pantalla con el botón de Workbooks resaltado en un cuadro rojo

Esto le llevará a la galería de libros:This takes you to the workbooks gallery:

Captura de pantalla de la galería de libros de Azure Monitor

Libros frente a plantillas de libroWorkbooks versus workbook templates

Puede ver un libro en verde y varias plantillas de libro en color púrpura.You can see a workbook in green and a number of workbook templates in purple. Las plantillas sirven como informes seleccionados que están diseñados para que varios usuarios y equipos puedan reutilizarlos de forma flexible.Templates serve as curated reports that are designed for flexible reuse by multiple users and teams. Al abrir una plantilla se crea un libro transitorio que se rellena con el contenido de la plantilla.Opening a template creates a transient workbook populated with the content of the template.

Puede ajustar los parámetros del libro basado en la plantilla y realizar el análisis sin miedo a interrumpir la futura experiencia de informes para colegas.You can adjust the template-based workbook's parameters and perform analysis without fear of breaking the future reporting experience for colleagues. Si abre una plantilla, realice algunos ajustes y luego seleccione el icono guardar para guardar la plantilla como un libro que se mostrará en verde y la plantilla original quedará intacta.If you open a template, make some adjustments, and then select the save icon you will be saving the template as a workbook which would then show in green leaving the original template untouched.

En el fondo, las plantillas también difieren de los libros guardados.Under the hood, templates also differ from saved workbooks. Al guardar un libro, se crea un recurso de Azure Resource Manager asociado, mientras que el libro transitorio que se crea al abrir una plantilla no tiene asociado un recurso único.Saving a workbook creates an associated Azure Resource Manager resource, whereas the transient workbook created when just opening a template has no unique resource associated with it. Para obtener más información sobre cómo se administra el control de acceso en los libros, consulte el artículo control de acceso de los libros.To learn more about how access control is managed in workbooks consult the workbooks access control article.

Exploración de una plantilla de libroExploring a workbook template

Seleccione Análisis de los errores de la aplicación para ver una de las plantillas de libro de la aplicación predeterminadas.Select Application Failure Analysis to see one of the default application workbook templates.

Captura de pantalla de la plantilla de análisis de los errores de la aplicación

Como se indicó anteriormente, al abrir la plantilla se crea un libro temporal para poder interactuar con él.As stated previously, opening the template creates a temporary workbook for you to be able to interact with. De forma predeterminada, el libro se abre en modo de lectura, lo que muestra solo la información de la experiencia de análisis previsto creada por el autor original de la plantilla.By default, the workbook opens in reading mode which displays only the information for the intended analysis experience that was created by the original template author.

En el caso de este libro concreto, la experiencia es interactiva.In the case of this particular workbook, the experience is interactive. Puede ajustar la suscripción, las aplicaciones de destino y el intervalo de tiempo de los datos que desea mostrar.You can adjust the subscription, targeted apps, and the time range of the data you want to display. Una vez realizadas esas selecciones, la cuadrícula de solicitudes HTTP también es interactiva, por lo que seleccionar una fila individual cambiará los datos que se representan en los dos gráficos en la parte inferior del informe.Once you have made those selections the grid of HTTP Requests is also interactive whereby selecting an individual row will change what data is rendered in the two charts at the bottom of the report.

Modo de ediciónEditing mode

Para comprender cómo se agrupa esta plantilla de libro, debe cambiar al modo de edición seleccionando Editar.To understand how this workbook template is put together you need to swap to editing mode by selecting Edit.

Captura de pantalla del botón en libros.

Una vez que haya cambiado al modo de edición, observará que aparece un número de cuadros de Editar a la derecha correspondiente con cada aspecto individual del libro.Once you have switched to editing mode you will notice a number of Edit boxes appear to the right corresponding with each individual aspect of your workbook.

Captura de pantalla del botón de edición

Si seleccionamos el botón Editar inmediatamente debajo de la cuadrícula de los datos de la solicitud, podemos ver que esta parte del libro consta de una consulta Kusto en los datos de un recurso de Application Insights.If we select the edit button immediately under the grid of request data we can see that this part of our workbook consists of a Kusto query against data from an Application Insights resource.

Captura de pantalla de la consulta Kusto subyacente

Al hacer clic en los botones otros Editar de la derecha, se mostrarán varios componentes principales que conforman los libros, como los cuadros de texto basados en marcado, los elementos de la interfaz de usuario de la selección de parámetros y otros tipos de gráficos y visualizaciones.Clicking the other Edit buttons on the right will reveal a number of the core components that make up workbooks like markdown-based text boxes, parameter selection UI elements, and other chart/visualization types.

Explorar las plantillas predefinidas en modo de edición y después modificarlas para adaptarlas a sus necesidades y guardar su propio libro personalizado es una excelente manera de empezar a obtener información sobre lo que es posible con los libros de Azure Monitor.Exploring the pre-built templates in edit-mode and then modifying them to fit your needs and save your own custom workbook is an excellent way to start to learn about what is possible with Azure Monitor workbooks.

Anclado de visualizacionesPinning Visualizations

Los pasos de texto, consulta y métricas de un libro se pueden anclar mediante el botón de anclaje en esos elementos, mientras el libro está en modo de anclaje, o bien, si el autor del libro tiene habilitada la configuración para ese elemento con el fin de que el icono para anclar esté visible.Text, query, and metrics steps in a workbook can be pinned by using the pin button on those items while the workbook is in pin mode, or if the workbook author has enabled settings for that element to make the pin icon visible.

Para acceder al modo de anclaje, haga clic en editar para entrar en el modo de edición, luego seleccione el icono para anclar azul en la barra superior.To access pin mode, click Edit to enter editing mode, and select the blue pin icon in the top bar. Luego aparecerá un icono de anclaje individual por encima de cada cuadro de Editar de la parte correspondiente del libro en el lado derecho de la pantalla.An individual pin icon will then appear above each corresponding workbook part's Edit box on the right-hand side of your screen.

Experiencia de anclaje

Nota

El estado del libro se guarda en el momento del anclaje, y los libros anclados en un panel no se actualizarán si se modifica el libro subyacente.The state of the workbook is saved at the time of the pin, and pinned workbooks on a dashboard will not update if the underlying workbook is modified. Para actualizar una parte del libro anclada, deberá eliminarla y volver a anclarla.In order to update a pinned workbook part, you will need to delete and re-pin that part.

Intervalos de tiempo del panelDashboard time ranges

Los elementos de consulta del libro anclado respetarán el intervalo de tiempo del panel si el elemento anclado está configurado para usar un parámetro de Intervalo de tiempo.Pinned workbook query parts will respect the dashboard's time range if the pinned item is configured to use a Time Range parameter. El valor del intervalo de tiempo del panel se usará como el valor del parámetro de intervalo de tiempo y cualquier cambio del intervalo de tiempo del panel hará que el elemento anclado se actualice.The dashboard's time range value will be used as the time range parameter's value, and any change of the dashboard time range will cause the pinned item to update. Si una parte anclada usa el intervalo de tiempo del panel, verá el subtítulo de la actualización de la parte anclada para mostrar el intervalo de tiempo del panel cada vez que cambie el intervalo de tiempo.If a pinned part is using the dashboard's time range, you will see the subtitle of the pinned part update to show the dashboard's time range whenever the time range changes.

Además, los elementos del libro anclados con un parámetro de intervalo de tiempo se actualizarán automáticamente a una velocidad determinada por el intervalo de tiempo del panel.Additionally, pinned workbook parts using a time range parameter will auto refresh at a rate determined by the dashboard's time range. La última vez que se ejecutó la consulta aparecerá en el subtítulo de la parte anclada.The last time the query ran will appear in the subtitle of the pinned part.

Si un paso anclado tiene un intervalo de tiempo establecido explícitamente (no usa un parámetro de intervalo de tiempo), ese intervalo de tiempo se usará siempre para el panel, independientemente de la configuración del panel.If a pinned step has an explicitly set time range (does not use a time range parameter), that time range will always be used for the dashboard, regardless of the dashboard's settings. El subtítulo de la parte anclada no mostrará el intervalo de tiempo del panel y la consulta no se actualizará automáticamente en el panel.The subtitle of the pinned part will not show the dashboard's time range, and the query will not auto-refresh on the dashboard. El subtítulo mostrará la última vez que se ejecutó la consulta.The subtitle will show the last time the query executed.

Nota

Actualmente no se admiten consultas con el origen de datos de combinación al anclar a los paneles.Queries using the merge data source are not currently supported when pinning to dashboards.

Compartir plantillas de libroSharing workbook templates

Una vez que empiece a crear sus propias plantillas de libro, es posible que quiera compartirla con la comunidad.Once you start creating your own workbook templates you might want to share it with the wider community. Para obtener más información y explorar otras plantillas que no forman parte de la vista predeterminada de la galería de Azure Monitor, visite nuestro repositorio GitHub.To learn more, and to explore other templates that aren't part of the default Azure Monitor gallery view visit our GitHub repository. Para examinar los libros existentes, visite la biblioteca de libros en GitHub.To browse existing workbooks, visit the Workbook library on GitHub.

Paso siguienteNext step

  • Comience a aprender más sobre las muchas opciones de visualizaciones enriquecidas de los libros.Get started learning more about workbooks many rich visualizations options.
  • Controle y comparta el acceso a los recursos del libro.Control and share access to your workbook resources.