Cómo enumerar y graficar métricas basadas en registros
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
En este documento, se describe cómo enumerar y graficar métricas basadas en registros con la consola deGoogle Cloud . Para obtener información sobre cómo crear métricas basadas en registros, consulta Configura métricas de contador y Configura métricas de distribución.
Antes de comenzar
Asegúrate de que tu rol de Identity and Access Management incluya los permisos necesarios para crear y ver métricas basadas en registros, y para crear políticas de alertas.
Para obtener más información, consulta Permisos para las métricas basadas en registros.
Enumera las métricas basadas en registros
Para ver una lista de las métricas basadas en registros de tu Google Cloud proyecto, haz lo siguiente:
En la consola de Google Cloud , ve a la página Métricas basadas en registros:
Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es
Logging.
Selecciona un Google Cloud proyecto existente.
La interfaz de métricas basadas en registros muestra dos listas de tipos de métricas: Métricas del sistema y Métricas definidas por el usuario.
El panel Métricas definidas por el usuario de la interfaz de métricas basadas en registros tiene varias funciones para ayudarte a administrar las métricas definidas por el usuario en tu proyecto deGoogle Cloud :
En la tabla de métricas definidas por el usuario, se incluyen columnas de Nombre, Descripción, Tipo y Filtro. Estos campos se especifican cuando creas la métrica.
El panel Filtrar métricas definidas por el usuario te permite filtrar tu lista de métricas por búsqueda de texto o métrica Nombre, Descripción y Filtro.
En la tabla de métricas definidas por el usuario se incluyen columnas de Uso del mes anterior y Uso en lo que va del mes (MTD). Estos datos de uso son útiles, por ejemplo, si deseas determinar qué métricas transfieren la mayor cantidad de datos o quieres estimar tus facturas.
El menú more_vertMás de cada métrica del panel de métricas definidas por el usuario contiene funciones adicionales para administrar las métricas:
Ver los detalles de la métrica: Muestra el Nombre, Tipo, Descripción, Filtro, Unidades y Etiquetas, si están definidas.
Editar métrica: Te permite editar ciertos campos para la métrica.
Inhabilitar métrica: Te permite detener el cálculo de la métrica.
Puedes volver a habilitar una métrica inhabilitada desde el mismo menú.
Borrar métrica: Te permite borrar la métrica.
Ver registros de la métrica: Te lleva al Explorador de registros y propaga el filtro de la métrica en el Compilador de consultas y ejecuta la consulta.
Ver en el Explorador de métricas: Te permite crear un gráfico de la métrica.
Crear alerta a partir de métricas: Te permite configurar notificaciones cuando una métrica basada en registros coincide con los criterios que especificas. Para obtener más información, consulta Cómo generar alertas sobre métricas basadas en registros.
Grafica métricas basadas en registros
Para crear un gráfico de una métrica basada en registros, haz lo siguiente:
En la consola de Google Cloud , ve a la página Métricas basadas en registros:
Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es
Logging.
Busca la métrica que deseas ver y, luego, selecciona Ver en el Explorador de métricas en el menú more_vertMás de la métrica.
Se abrirá el Explorador de métricas, que ya estará configurado para ti. Sin embargo, es posible que desees cambiar algunos parámetros de configuración del gráfico.
Por ejemplo, en la siguiente captura de pantalla, se muestra un gráfico de la métrica del sistema con el nombre byte_count para un proyecto Google Cloud en particular:
La entrada Agregación muestra que cada serie temporal del gráfico es una suma de los bytes escritos en un registro específico. En el ejemplo anterior, el proyecto contiene varios registros, por lo que el gráfico muestra varias series temporales.
Para ver los datos de un registro específico, agrega un filtro. Por ejemplo, para ver la métrica byte_count de las entradas de registro escritas por BigQuery, haz clic en Agregar filtro, selecciona log y, luego, selecciona la entrada de BigQuery. Ahora, en el gráfico, se muestra una sola serie temporal, que indica el total de bytes de registro escritos por BigQuery.
Si deseas ver la métrica byte_count según la gravedad de la entrada de registro, cambia el segundo menú de la entrada Agregación de Ninguna a Gravedad. En el siguiente gráfico, se muestra la métrica byte_count que se muestra por nivel de gravedad para los registros escritos por BigQuery:
Para las métricas basadas en registros con valor de distribución, expande Gráfico de líneas y selecciona Gráfico de mapa de calor.
Opcional: Para guardar el gráfico como referencia futura, haz clic en Guardar gráfico en la barra de herramientas y, luego, completa el cuadro de diálogo. Puedes guardar el gráfico en un panel existente o crear uno nuevo.
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Información o código de muestra incorrectos","incorrectInformationOrSampleCode","thumb-down"],["Faltan la información o los ejemplos que necesito","missingTheInformationSamplesINeed","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-09-10 (UTC)"],[],[],null,["# List and chart log-based metrics\n\nThis document describes how to list and chart log-based metrics by using the\nGoogle Cloud console. For information about creating log-based metrics, see\n[Configure counter metrics](/logging/docs/logs-based-metrics/counter-metrics)\nand [Configure distribution metrics](/logging/docs/logs-based-metrics/distribution-metrics).\n\nBefore you begin\n----------------\n\nEnsure that your Identity and Access Management role includes the permissions required to\ncreate and view log-based metrics, and to create alerting policies.\nFor details, see\n[Permissions for log-based metrics](/logging/docs/access-control#metrics-permissions).\n\nList log-based metrics\n----------------------\n\nTo view a list of log-based metrics for your Google Cloud project, do the\nfollowing:\n\n1. In the Google Cloud console, go to the **Log-based Metrics** page:\n\n [Go to **Log-based Metrics**](https://console.cloud.google.com/logs/metrics)\n\n \u003cbr /\u003e\n\n If you use the search bar to find this page, then select the result whose subheading is\n **Logging**.\n2. Select an existing Google Cloud project.\n The log-based metrics interface displays two lists of metric-types:\n **System metrics** and **User-defined metrics**.\n\n The **User-defined metrics** pane of the log-based metrics interface has\n several features to help you manage the user-defined metrics in your\n Google Cloud project:\n - The user-defined metrics table includes **Name** , **Description** ,\n **Type** , and **Filter** columns. These fields are specified when you\n create the metric.\n\n - The **Filter user-defined metrics** pane lets you filter your metric list\n by text search or metric **Name** , **Description** , and **Filter**.\n\n - The user-defined metrics table includes columns for\n **Previous month usage** and **Month-to-date usage (MTD)** . This usage\n data is useful, for example, if\n you want to determine which metrics ingest the most data or to\n [estimate your bills](/stackdriver/estimating-bills).\n\n The *more_vert* **More** menu for each metric in your user-defined\n metrics pane contains additional features for managing your metrics:\n\n - **View metric details** : Shows you the metric's **Name** , **Type** , **Description** , **Filter** , **Units** , and **Labels**, if defined.\n - **Edit metric**: Lets you edit certain fields for the metric.\n - **Disable metric**: Lets you stops the metric from being calculated. You can re-enable a disabled metric from the same menu.\n - **Delete metric**: Lets you delete the metric.\n - **View logs for metric** : Takes you to the Logs Explorer and populates the metric's filter in the **Query builder** and runs the query.\n - **View in Metrics Explorer**: Lets you chart the metric.\n - **Create alert from metric** : Lets you configure notifications when a log-based metric matches criteria that you specify. For more information, see [Alert on log-based metrics](/logging/docs/logs-based-metrics/charts-and-alerts).\n\nChart log-based metrics\n-----------------------\n\nTo create a chart of a log-based metric, do the following:\n\n1. In the Google Cloud console, go to the **Log-based Metrics** page:\n\n [Go to **Log-based Metrics**](https://console.cloud.google.com/logs/metrics)\n\n \u003cbr /\u003e\n\n If you use the search bar to find this page, then select the result whose subheading is\n **Logging**.\n2. Find the metric you want to view, and then select\n **View in Metrics Explorer** from the metric's *more_vert* **More**\n menu.\n\n [Metrics Explorer](/monitoring/charts/metrics-explorer) opens and\n is preconfigured for you. However, you might want to change some chart\n settings.\n\n For example, the following screenshot shows a chart of the system metric\n with the name `byte_count` for a particular Google Cloud project:\n\n The **Aggregation** entry shows that each time series on the chart is\n a sum of the bytes written to a specific log. In the previous example, the\n project contains multiple logs, so the chart displays multiple time series.\n\n To view the data for a specific log, add a filter. For example, to view the\n `byte_count` metric for log entries written by BigQuery,\n click **Add filter** , select **log** , and then select the BigQuery\n entry. The chart now displays a single time series, which shows the total of\n the log bytes written by BigQuery.\n If you want to view the `byte_count` metric by the severity of the\n log entry, then change the second menu in the **Aggregation** entry from\n **None** to **Severity** . The following chart shows the `byte_count` metric\n displayed by severity level for logs written by BigQuery:\n\n3. For distribution-valued log-based metrics, expand **Line chart** and\n select **Heatmap chart**.\n\n For more information about distribution-valued metrics, see\n [Distribution metrics](/monitoring/charts/charting-distribution-metrics) and\n [Percentiles and distribution-valued metrics](/monitoring/api/v3/distribution-metrics).\n4. Optional: To save the chart for future reference, click **Save chart**\n in the toolbar, and then complete the dialog. You can save the\n chart to an existing dashboard or create a new dashboard.\n\n| **Tip:** If you don't see any data in the graph, try increasing the time interval, which defaults to one hour, or changing the default settings.\n\nWhat's next\n-----------\n\n- To create an alerting policy for a log-based metric, see [Alert on log-based metrics](/logging/docs/logs-based-metrics/charts-and-alerts).\n- For more information about charting metric data, see these\n Monitoring resources:\n\n - [Metrics Explorer](/monitoring/charts/metrics-explorer)\n - [Creating charts](/monitoring/charts)"]]
