

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.

# Uso de la versión 8 de Grafana
<a name="using-grafana-v8"></a>

****  
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 8.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.md).  
Para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).

Al crear el espacio de trabajo de Grafana, tiene la opción de elegir qué versión de Grafana quiere utilizar. En los siguientes temas se describe el uso de un espacio de trabajo de Grafana que utilice la versión 8 de Grafana.

**Topics**
+ [Paneles](Grafana-panels.md)
+ [Paneles](dashboard-overview.md)
+ [Explore](explore.md)
+ [Vinculación](linking-in-Amazon-Managed-Service-for-Grafana.md)
+ [Plantillas y variables](templates-and-variables.md)
+ [Alertas de Grafana](alerts-overview.md)

# Paneles
<a name="Grafana-panels"></a>

****  
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 8.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.md).  
Para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).

El panel es el componente básico de visualización en un servidor de Grafana. Un panel es una representación visual de una o más consultas, excepto algunos paneles de uso especial. Las consultas muestran datos a lo largo del tiempo. Esto puede variar desde fluctuaciones de temperatura hasta el estado actual del servidor y una lista de registros o alertas.

Cada panel tiene un editor de consultas específico para el origen de datos seleccionado en el panel. El editor de consultas permite extraer una visualización para mostrarla en el panel.



Para mostrar datos, debe tener al menos un origen de datos agregado a su espacio de trabajo. Para obtener más información sobre orígenes de datos, consulte [Conexión con orígenes de datos](AMG-data-sources.md).

Hay una amplia variedad de opciones de estilo y formato para cada panel. Los paneles se pueden arrastrar, reorganizar y cambiar de tamaño.

**Topics**
+ [Cómo agregar un panel](add-a-panel-to-a-dashboard.md)
+ [Eliminación de un panel](Deleting-a-panel.md)
+ [Consultas](panel-queries.md)
+ [Consultas registradas](recorded-queries.md)
+ [Transformaciones](panel-transformations.md)
+ [Opciones de campo y anulaciones](field-options-overrides.md)
+ [Editor de paneles](AMG-panel-editor.md)
+ [Paneles de biblioteca](AMG-library-panel.md)
+ [Visualizaciones](AMG-visualizations.md)

# Cómo agregar un panel
<a name="add-a-panel-to-a-dashboard"></a>

****  
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 8.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.md).  
Para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).

 Puede usar paneles para mostrar sus datos de forma visual. En este tema se explican los pasos básicos para crear un panel. 

**Cómo agregar un panel a un panel**

1.  Elija el panel al que desea agregar un panel. 

1.  Seleccione el icono **Agregar panel**. 

1.  Elija **Agregar nuevo panel**. 

    El espacio de trabajo de Grafana crea un panel gráfico vacío con el origen de datos predeterminado seleccionado. 

1.  Si bien no es obligatorio, le recomendamos que agregue un título y una descripción útiles al panel. Si lo desea, puede utilizar variables que haya definido en cualquiera de los campos, pero no variables globales. Para obtener más información, consulte [Plantillas y variables](templates-and-variables.md).
   + **Título del panel**: el texto ingresado en este campo se muestra en la parte superior del panel, en el editor de paneles y en el panel.
   + **Descripción**: el texto ingresado en este campo se muestra en la información sobre herramientas en la esquina superior izquierda del panel. Escriba una descripción del panel y de los datos que va a mostrar.

1. Escriba una consulta para el panel. Para mostrar una visualización, cada panel necesita al menos una consulta. Las consultas se escriben en la pestaña **Consulta** del editor de paneles. Para obtener más información, consulte [Consultas](panel-queries.md).

   1. Elija un origen de datos. En la primera línea de la pestaña **Consulta**, seleccione la lista desplegable para ver todos los orígenes de datos disponibles. Esta lista incluye todos los orígenes de datos que ha agregado. Para obtener más información sobre orígenes de datos, consulte [Conexión con orígenes de datos](AMG-data-sources.md). 

   1. Escriba o cree una consulta en el lenguaje de consulta del origen de datos. Las opciones variarán. Consulte la documentación de su origen de datos específico para obtener pautas concretas. 

1.  En la sección **Visualización** de la pestaña **Panel**, elija un tipo de visualización. En el espacio de trabajo de Grafana se muestra una vista previa de los resultados de la consulta con esa visualización aplicada. 

1. Le recomendamos que agregue una nota para describir los cambios antes de elegir **Guardar**. Las notas son útiles si necesita revertir el panel de control a una versión anterior. 

1.  Para guardar el panel, elija **Guardar** en la esquina superior derecha de la pantalla. 

# Eliminación de un panel
<a name="Deleting-a-panel"></a>

****  
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 8.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.md).  
Para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).

Para eliminar un panel en Grafana, complete los siguientes pasos:
+  Elija el menú desplegable situado junto al título del panel y seleccione **Eliminar panel**. 

o
+ Coloque el puntero sobre el panel y use la secuencia de método abreviado de teclado “p r”.

# Consultas
<a name="panel-queries"></a>

****  
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 8.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.md).  
Para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).

 Los paneles de los espacios de trabajo de Grafana usan *consultas* para comunicarse con los orígenes de datos a fin de obtener datos para la visualización. Una consulta es una pregunta escrita en el lenguaje de consulta que utiliza el origen de datos. Si la consulta tiene el formato correcto, el origen de datos responde. En las opciones del origen de datos del panel, puede ajustar la frecuencia con la que se envía la consulta al origen de datos y el número de puntos de datos que se recopilan. 

 Los espacios de trabajo de Grafana admiten hasta 26 consultas por panel. 

## Editores de consultas
<a name="query-editors"></a>

 Los editores de consultas son formularios que lo ayudan a escribir consultas. Según el origen de datos, el editor de consultas puede proporcionar finalización automática, nombres de métricas o sugerencias de variables. 

 Debido a las diferencias entre los lenguajes de consulta, los orígenes de datos pueden tener editores de consultas con aspectos diferentes.

## Sintaxis de la consulta
<a name="query-syntax"></a>

 Los orígenes de datos utilizan diferentes lenguajes de consulta y sintaxis para solicitar los datos. A continuación se muestran dos ejemplos de consultas.

 **PostgreSQL** 

```
SELECT hostname FROM host WHERE region IN($region)
```

 **PromQL** 

```
query_result(max_over_time(<metric>[${__range_s}s]) != <state>)
```

 Para obtener más información sobre cómo escribir una consulta para el origen de datos, consulte la documentación de ese origen de datos. Los orígenes de datos se enumeran en [Conexión con orígenes de datos](AMG-data-sources.md).

## Interfaz de usuario de la pestaña Consulta
<a name="query-tab-ui"></a>

 La pestaña **Consulta** consta de los siguientes elementos: 
+  Selector de orígenes de datos 
+  Opciones de consulta 
+  Botón del inspector de consultas 
+  Lista de editores de consultas 

### Selector de orígenes de datos
<a name="data-source-selector"></a>

 El selector de orígenes de datos es una lista desplegable. Elíjalo para seleccionar un origen de datos que haya agregado. Al crear un panel, Amazon Managed Grafana selecciona automáticamente el origen de datos predeterminado. Para obtener más información sobre orígenes de datos, consulte [Conexión con orígenes de datos](AMG-data-sources.md). 

 Además de los orígenes de datos que ha configurado en su espacio de trabajo de Grafana, hay disponibles tres orígenes de datos especiales. 
+ **TestDataDB**: una fuente de datos integrada que genera datos de recorridos aleatorios. El origen de datos de Grafana resulta útil para probar visualizaciones y hacer experimentos.
+  **Mixto**: un origen de datos para consultar varios orígenes de datos en el mismo panel. Cuando se selecciona este origen de datos, puede elegir un origen de datos para cada nueva consulta que agregue.
  +  La primera consulta utilizará el origen de datos que se seleccionó antes de seleccionar **Mixto**. 
  +  No puede cambiar una consulta existente para usar un origen de datos mixto. 
+ **Panel**: origen de datos para usar un conjunto de resultados de otro panel del mismo panel. 

### Opciones de consulta
<a name="query-options"></a>

 Para ver la configuración del origen de datos seleccionado, elija **Opciones de consulta** junto al selector de orígenes de datos. Los cambios que haga aquí solo afectarán a las consultas ejecutadas en este panel. 

 Amazon Managed Grafana establece valores predeterminados que se muestran en texto gris oscuro. Los cambios se muestran en texto blanco. Para devolver un campo a la configuración predeterminada, elimine el texto blanco del campo. 

 Puede utilizar las siguientes opciones de consulta de orígenes de datos del panel: 
+  **Máximo de puntos de datos**: si el origen de datos lo admite, establece el número máximo de puntos de datos para cada serie devuelta. Si la consulta devuelve más puntos de datos que la configuración de máximo de puntos de datos, el origen de datos los consolida (reduce el número de puntos devueltos al agregarlos por promedio, por máximo o por otra función). 

   Existen dos motivos principales para limitar el número de puntos: el rendimiento y la suavización de la línea. El valor predeterminado es el ancho (o el número de píxeles) del gráfico, lo que evita tener más puntos de datos de los que puede mostrar el panel del gráfico. 

   Con los datos de transmisión, se utiliza el valor de máximo de puntos de datos para el búfer móvil. (La transmisión es un flujo continuo de datos y el almacenamiento en búfer es una forma de dividir la transmisión en partes). 
+  **Intervalo mínimo**: establece un límite mínimo para el intervalo que se calcula automáticamente, que suele ser el intervalo mínimo de extracción. Si se guarda un punto de datos cada 15 segundos, no será necesario tener un intervalo inferior a ese. Otro caso de uso implica establecerlo en un intervalo mínimo superior al intervalo de extracción para recuperar consultas más imprecisas y que funcionen bien. 
+  **Intervalo**: intervalo de tiempo que puede utilizar para agregar o agrupar puntos de datos por tiempo. 

   Amazon Managed Grafana calcula automáticamente un intervalo apropiado que puede usar como variable en las consultas con plantillas. La variable se mide en segundos (`$__interval`) o milisegundos (`$__interval_ms`). Por lo general, se usa en funciones de agregación como `sum` o `average`. Por ejemplo, esta es una consulta de Prometheus que usa la variable de intervalo: `rate(http_requests_total[$__interval])`. 

   Este intervalo automático se calcula en función del ancho del gráfico. Si el usuario se aleja mucho, el intervalo se vuelve mayor, lo que da como resultado una agregación más imprecisa. Si el usuario se acerca, el intervalo disminuye, lo que da como resultado una agregación más detallada. 

   Para obtener más información, consulte [Variables globales](variables-types.md#global-variables). 
+  **Tiempo relativo**: anule el intervalo de tiempo relativo de los paneles individuales, lo que hace que sean diferentes de lo que está seleccionado en el selector de tiempo del panel, en la esquina superior derecha. Le permite mostrar métricas de diferentes periodos de tiempo o días en el mismo panel. 
+  **Cambio de tiempo**: proporciona otra forma de anular el intervalo de tiempo de los paneles individuales. Esta función solo sirve para intervalos de tiempo relativos; puede ajustar el intervalo de tiempo. 

   Por ejemplo, puede cambiar el intervalo de tiempo del panel para que sea 2 horas antes que el selector de tiempo del panel. Para obtener más información, consulte [Controles de intervalo de tiempo](dashboard-time-range-controls.md). 
+  **Tiempo de espera de la caché**: (este campo solo está visible si está disponible en el origen de datos). Anula el tiempo de espera predeterminado de la caché si el almacén de series temporales tiene una caché de consultas. Se especifica como un valor numérico en segundos. 

### Botón del inspector de consultas
<a name="query-inspector-button"></a>

 Puede elegir **Inspector de consultas** para abrir la pestaña **Consultas** del inspector del panel. En la pestaña **Consulta**, puede ver la solicitud de consulta que envió el panel y la respuesta correspondiente. 

 Seleccione **Actualizar** para ver el texto completo de la solicitud que envió este panel al servidor. 

**nota**  
 Debe agregar al menos una consulta para que el inspector de consultas pueda devolver los resultados. 

 Para obtener más información acerca del inspector del panel, consulte [Inspección de un panel](inspect-a-panel.md). 

### Lista de editores de consultas
<a name="query-editor-list"></a>

 En la interfaz de usuario, las consultas se organizan en filas de consultas plegables. Cada fila de consulta contiene un editor de consultas y se identifica con una letra (A, B, C, etc.). 

## Uso compartido de los resultados de las consultas entre paneles
<a name="share-query-results-between-panels"></a>

 Con Amazon Managed Grafana, puede usar el resultado de la consulta de un panel para cualquier otro panel del panel. Al compartir los resultados de las consultas en todos los paneles, se reduce la cantidad de consultas que se hacen al origen de datos, lo que puede mejorar el rendimiento del panel. 

 El origen de datos del panel le permite seleccionar un panel que contenga las consultas con las que desea compartir los resultados. En lugar de enviar una consulta independiente para cada panel, Amazon Managed Grafana envía una consulta y los demás paneles utilizan los resultados de la consulta para crear visualizaciones. 

 Esta estrategia puede reducir drásticamente la cantidad de consultas que se hacen cuando, por ejemplo, hay varios paneles para visualizar los mismos datos. 

**Uso compartido de las consultas del origen de datos con otro panel**

1.  Crear un panel de control. Para obtener más información, consulte [Creación de un panel](getting-started-grafanaui.md#create-a-dashboard). 

1.  Agregue un panel. Para obtener más información, consulte [Cómo agregar un panel](add-a-panel-to-a-dashboard.md). 

1.  Cambie el título a **Source panel**. Utilizará este panel como origen para los demás paneles. Defina la consulta o consultas que se compartirán. Si por el momento no tiene un origen de datos disponible, puede usar el origen de datos de **Grafana**, que devuelve una serie temporal aleatoria que puede utilizar para hacer pruebas. 

1.  Agregue un segundo panel y a continuación seleccione el origen de datos del **panel** en el editor de consultas. 

1.  En **Usar los resultados de la lista de paneles**, seleccione el primer panel que haya creado. 

 Todas las consultas definidas en el panel de origen están ahora disponibles en el nuevo panel. Las consultas hechas en el panel de origen se pueden compartir en varios paneles. 

 Para ir a un panel en el que se define una consulta, selecciónela. 

# Consultas registradas
<a name="recorded-queries"></a>

****  
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 8.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.md).  
Para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).

Puede ver las tendencias a lo largo del tiempo tomando una instantánea de un punto de datos en un intervalo establecido mediante consultas registradas. Esto puede darle una idea de las tendencias históricas.

Para los complementos que no devuelven series temporales, puede ser útil trazar datos históricos. Por ejemplo, es posible que desees consultar **ServiceNow**un historial de los tiempos de respuesta de las solicitudes, pero que solo devuelva point-in-time las métricas actuales.

## Cómo funcionan las consultas registradas
<a name="how-recorded-queries-work"></a>

Las consultas registradas solo funcionan con los complementos de orígenes de datos de backend. Para obtener más información, consulte [Backend data source plugin](https://grafana.com/tutorials/build-a-data-source-backend-plugin/). Puede registrar tres tipos de consultas:
+ Fila y columna únicas: consulta que devuelve una sola fila y columna.
+ Recuento de filas: consulta que devuelve filas significativas para ser contadas.
+ Expresión: cualquier expresión. Para obtener más información sobre la creación y uso de expresiones, consulte [Expressions](https://grafana.com/docs/grafana/next/panels-visualizations/query-transform-data/expression-queries/).

Una vez creada o habilitada una consulta registrada, crea inmediatamente una instantánea y continúa creando instantáneas en el intervalo establecido. La consulta registrada deja de tomar instantáneas cuando se deshabilita, se elimina o cuando Grafana no se está ejecutando. Los puntos de datos se recopilan en el backend ejecutando la consulta registrada y reenviando cada resultado a una instancia de Prometheus con capacidad de escritura remota.

**nota**  
Debe configurar un origen de datos de Prometheus y asociarlo a un destino de escritura remota antes de poder utilizar las consultas registradas.

## Creación de una consulta registrada
<a name="create-a-recorded-query"></a>

Para crear una consulta registrada, siga estos pasos:

1. Busque o cree una consulta que desee registrar en un panel de control en un panel de edición. La consulta solo debe devolver una fila y una columna. Si devuelve más, puede seguir registrando el número de resultados devueltos mediante la opción de *recuento*. El origen de datos de la consulta debe ser un origen de datos de backend. Las expresiones se pueden usar para agregar datos de una consulta de series temporales. Para obtener más información sobre la creación y uso de expresiones, consulte [Expressions](https://grafana.com/docs/grafana/next/panels-visualizations/query-transform-data/expression-queries/).

1. Elija el menú de **consulta de registros** ubicado en el editor de consultas.

1. Ingrese la información de la consulta registrada. Todos los campos son obligatorios a menos que se indique lo contrario. 
   + Nombre: nombre de la consulta registrada.
   + Descripción: (opcional) describa la consulta registrada tal como desea que aparezca en la lista de consultas registradas.
   + Intervalo: intervalo en el que se tomará la instantánea. El intervalo comienza cuando se crea la consulta registrada y se detiene si se detiene o se elimina la consulta registrada. Para obtener más información sobre cómo pausar y eliminar las consultas registradas, consulte [Managing recorded queries](https://grafana.com/docs/grafana/latest/enterprise/recorded-queries/#manage-recorded-queries).
   + Rango: rango de tiempo relativo de la consulta. Si selecciona un rango de 30 minutos y un intervalo de 1 hora, la consulta tomará una instantánea cada hora de los últimos 30 minutos.
   + Contar los resultados de la consulta: si quiere contar las filas devueltas por la consulta, active esta opción. Si esta opción está desactivada, la consulta debe devolver una fila con un valor.

1. Pruebe la consulta registrada pulsando el botón Probar consulta registrada.

1. Seleccione **Iniciar consulta registrada**.

## Cómo agregar una consulta registrada
<a name="Adding-a-recorded-query"></a>

Puede agregar las consultas registradas existentes a los paneles de un panel. Para cada consulta registrada que agregue, se crea una consulta de Prometheus: `generated_recorded_query_name{id="generated_id", name="recorded query name"}`. La consulta creada por Prometheus devuelve todas las instantáneas recopiladas de la consulta registrada.

1. Navegue hasta el panel en el que desee agregar una consulta registrada.

1. Seleccione el menú **\$1 Consulta registrada**.

1. Si desea filtrar las consultas registradas por origen de datos, seleccione un origen de datos en el menú desplegable Filtrar por origen de datos.

1. Seleccione el menú **Agregar** en la consulta registrada para agregarla al panel.

Tras agregar la consulta registrada al panel, el origen de datos del panel se convertirá en `-- Mixed --`. La consulta registrada se representa mediante una consulta `Prometheus` con una etiqueta de nombre que coincide con el nombre de la consulta registrada. Consulte [Prometheus](https://grafana.com/docs/grafana/latest/datasources/prometheus/) para obtener más información sobre el origen de datos de Prometheus.

Si después de agregar una consulta registrada, aparece una consulta con un origen de datos `-- Mixed --` en lugar de un origen de datos de Prometheus, esto podría significar que no se configuró un destino de escritura remoto de `Prometheus ` para las consultas registradas. Consulte [Remote write target](https://grafana.com/docs/grafana/latest/enterprise/recorded-queries/#remote-write-target) para configurar un punto de escritura remoto.

## Uso de una consulta registrada
<a name="using-a-recorded-query"></a>

Para usar una consulta registrada, cree una y agréguela a un panel. Después de eso, se puede administrar en **Preferencias** desde la pestaña **Consultas registradas**.

## Administración de consultas registradas
<a name="managing-recorded-queries"></a>

Las consultas registradas se pueden pausar o activar y eliminar desde la pestaña Consultas registradas de Preferencias. Al eliminar una consulta registrada, se eliminará de Grafana, pero la información recopilada en Prometheus seguirá ahí. Al pausar una consulta registrada, ya no se recopilarán nuevos puntos de datos hasta que se reanude.

## Objetivo de escritura remota
<a name="remote_write_target"></a>

El objetivo de escritura remota es el origen de datos de **Prometheus** en el que se escriben los puntos de datos de consulta registrados. Necesitará una instancia de Prometheus con la escritura remota habilitada y tendrá que crear un origen de datos para esta instancia de Prometheus.

Para editar el objetivo de escritura remota, seleccione **Editar destino de escritura remota** en el menú de la consola, en la pestaña **Consultas registradas** de **Preferencias**. Seleccione el origen de datos de **Prometheus** que tenga habilitada la escritura remota e ingrese la ruta de escritura remota.

# Transformaciones
<a name="panel-transformations"></a>

****  
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 8.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.md).  
Para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).

Las transformaciones procesan el conjunto de resultados antes de pasarlo a la fase de visualización. Puede acceder a las transformaciones en la pestaña **Transformar** del editor de paneles de Amazon Managed Grafana.

Puede utilizar las transformaciones para cambiar el nombre de los campos, unir series temporales independientes, hacer operaciones matemáticas en todas las consultas y mucho más. Si tiene paneles grandes o consultas pesadas, poder reutilizar el resultado de la consulta de un panel en otro puede suponer un gran aumento de rendimiento.

**nota**  
A veces, las transformaciones dan como resultado datos que no se pueden representar gráficamente. Cuando eso ocurre, Amazon Managed Grafana muestra una sugerencia en la visualización. Elija la sugerencia para cambiar a la visualización de tablas. A menudo, esto lo ayuda a comprender mejor lo que la transformación está haciendo con sus datos. 

Amazon Managed Grafana aplica las transformaciones en el orden en que aparecen en la pantalla. Cada transformación crea un conjunto de resultados que pasa a la siguiente transformación de la canalización. 

El orden puede marcar una gran diferencia en el aspecto de los resultados. Por ejemplo, si usa una transformación Reducir para condensar todos los resultados de una columna en un único valor, después solo podrá aplicar las transformaciones a ese único valor. 

**Requisitos previos**

Antes de aplicar las transformaciones, se deben cumplir todos los criterios:
+ Se ingresó una consulta y devolvió datos de un origen de datos. Para obtener más información acerca de las consultas, consulte [Queries](panel-queries.md).
+ Se aplicó una visualización que admite consultas, como una de las siguientes visualizaciones:
  + Indicador de barras
  + Calibre
  + Gráfico
  + Mapa de calor
  + Registros
  + Estadística
  + Tabla

## Aplicación de una transformación
<a name="apply-a-transformation"></a>

 Las transformaciones están disponibles en la pestaña **Transformar** del panel inferior del editor de paneles, junto a la pestaña **Consultas**. 

**Aplicación de una transformación**

1.  En el panel donde desea agregar transformaciones, elija el título del panel y, a continuación, seleccione **Editar**. 

1.  Elija la pestaña **Transform (Transformación)**. 

1.  Seleccione una transformación. 

    En la fila de transformación que aparece, puede configurar las opciones de transformación. 

1.  Para aplicar otra transformación, elija **Agregar transformación**. Tenga en cuenta que la siguiente transformación actúa sobre el conjunto de resultados devuelto por la transformación anterior. 

 Si tiene problemas, seleccione el icono de error para [depurar las transformaciones](#debug-transformations). 

 Para eliminar una transformación, elija el icono de la papelera. 

## Tipos y opciones de transformación
<a name="transformation-types-and-options"></a>

 Los espacios de trabajo de Grafana incluyen las siguientes transformaciones. 

**Topics**
+ [Reducción](#reduce)
+ [Merge](#merge)
+ [Filtrado por nombre](#filter-by-name)
+ [Filtrado de datos por consulta](#filter-data-by-query)
+ [Organización de campos](#organize-fields)
+ [Unión por campo (unión externa)](#join-by-field-outer-join)
+ [Adición de un campo a partir de un cálculo](#add-field-from-calculation)
+ [Etiquetas para campos](#labels-to-fields)
+ [Agrupación por](#sort-by)
+ [Agrupación por](#group-by)
+ [De series a filas](#series-to-rows)
+ [Filtrado de datos por valor](#filter-data-by-value)
+ [Depuración de transformaciones](#debug-transformations)

### Reducción
<a name="reduce"></a>

 Aplique la **transformación Reducir** cuando desee simplificar sus resultados hasta reducirlos a un solo valor. Reducir básicamente elimina el componente de tiempo. Si se visualiza como una tabla, reduce una columna a una fila (valor). 

 En el campo **Cálculos**, ingrese uno o más tipos de cálculo. Elija esta opción para ver una lista de opciones de cálculo. Para obtener más información acerca de los cálculos disponibles, consulte [Lista de cálculos](list-of-calculations.md).

Tras seleccionar al menos un cálculo, Amazon Managed Grafana mostrará un valor utilizando el cálculo que haya seleccionado. Si selecciona más de un cálculo, se mostrará más de un valor. 

### Merge
<a name="merge"></a>

 Use esta transformación para combinar los resultados de varias consultas en un único resultado. Resulta útil cuando se usa la visualización del panel de tablas. Los valores que se pueden unir se combinan en la misma fila. Los valores se pueden unir si los campos compartidos contienen los mismos datos. 

 En el ejemplo siguiente, dos consultas devuelven datos de la tabla. Los datos se visualizan como dos tablas independientes antes de aplicar la transformación. 

Consulta A


|  Time  |  Trabajo  |  Tiempo de actividad  | 
| --- | --- | --- | 
|  2020-07-07 11:34:20  |  nodo  |  25260122  | 
|  2020-07-07 11:24:20  |  postgre  |  123001233  | 

Consulta B


|  Time  |  Trabajo  |  Errores  | 
| --- | --- | --- | 
|  2020-07-07 11:34:20  |  nodo  |  15  | 
|  2020-07-07 11:24:20  |  postgre  |  5  | 

 Este es el resultado después de aplicar la transformación **Unir**. 


|  Time  |  Trabajo  |  Errores  |  Tiempo de actividad  | 
| --- | --- | --- | --- | 
|  2020-07-07 11:34:20  |  nodo  |  15  |  25260122  | 
|  2020-07-07 11:24:20  |  postgre  |  5  |  123001233  | 

### Filtrado por nombre
<a name="filter-by-name"></a>

 Use esta transformación para eliminar partes de los resultados de la consulta. 

 Amazon Managed Grafana muestra el campo **Identificador**, seguido de los campos devueltos por la consulta. 

 Puede aplicar filtros de dos maneras: 
+  Ingrese una expresión regular. 
+  Elija un campo para activar o desactivar el filtrado en él. Los campos filtrados se muestran con texto gris oscuro y los campos sin filtrar tienen texto blanco. 

### Filtrado de datos por consulta
<a name="filter-data-by-query"></a>

 Utilice esta transformación en los paneles que tienen varias consultas si quiere ocultar una o varias de las consultas. 

 Amazon Managed Grafana muestra las letras de identificación de la consulta en texto gris oscuro. Para activar o desactivar el filtrado, elija un identificador de consulta. Si la letra de la consulta es blanca, se muestran los resultados. Si la letra de la consulta es oscura, se ocultan los resultados. 

### Organización de campos
<a name="organize-fields"></a>

 Use esta transformación para cambiar el nombre, reordenar u ocultar los campos devueltos por la consulta. 

**nota**  
 Esta transformación solo funciona en paneles que tienen una única consulta. Si su panel tiene varias consultas, debe aplicar una transformación **Unir por campo (unión externa)** o eliminar las consultas adicionales. 

 Amazon Managed Grafana muestra una lista de los campos devueltos por la consulta. Puede hacer cualquiera de los siguientes cambios: 
+  Cambie el orden de los campos haciendo una pausa sobre un campo. El cursor se convertirá en una mano y podrá arrastrar el campo a su nueva ubicación. 
+  Para ocultar o mostrar un campo, elija en el icono de ojo situado al lado del nombre del campo. 
+  Para cambiar el nombre de los campos, escriba un nombre nuevo en el cuadro **Cambiar nombre**. 

### Unión por campo (unión externa)
<a name="join-by-field-outer-join"></a>

 Utilice esta transformación para unir varias series temporales a partir de un conjunto de resultados por campo. 

 Esta transformación resulta útil si desea combinar consultas para poder calcular los resultados de los campos. 

### Adición de un campo a partir de un cálculo
<a name="add-field-from-calculation"></a>

 Use esta transformación para agregar un campo nuevo calculado a partir de otros dos campos. Cada transformación le permite agregar un campo nuevo. 
+  **Modo**: seleccione un modo. 
  +  **Reducir fila**: aplique el cálculo seleccionado en cada fila de campos seleccionados de forma independiente. 
  +  **Operación binaria**: aplique operaciones matemáticas básicas (`sum`, `multiply`, etc.) a los valores de una sola fila de dos campos seleccionados. 
+  **Nombre del campo**: seleccione los nombres de los campos que quiera utilizar en el cálculo del nuevo campo. 
+  **Cálculo**: seleccione un cálculo para usarlo cuando Amazon Managed Grafana cree el nuevo campo. Seleccione el campo para ver una lista de opciones de cálculo. Para obtener más información acerca de los cálculos disponibles, consulte [Lista de cálculos](list-of-calculations.md). 
+  **Alias**: (opcional) ingrese el nombre del nuevo campo. Si deja este campo en blanco, se le asignará un nombre que corresponda con el cálculo. 
+  **Reemplazar todos los campos**: (opcional) seleccione esta opción si quiere ocultar los demás campos y mostrar solo el campo calculado en la visualización. 

### Etiquetas para campos
<a name="labels-to-fields"></a>

**nota**  
 Para aplicar esta transformación, la consulta debe devolver campos etiquetados. 

 Al seleccionar esta transformación, Amazon Managed Grafana transforma automáticamente todos los datos etiquetados en campos. 

 Por ejemplo, plantéese el resultado de consulta de dos series temporales. 

 1: etiquetas Servidor = Servidor A, Centro de datos = UE 2: etiquetas Servidor = Servidor B, Centro de datos = UE 

 Esta transformación daría como resultado la siguiente tabla. 


|  Time  |  Server  |  Centro de datos  |  Valor  | 
| --- | --- | --- | --- | 
|  2020-07-07 11:34:20  |  Servidor A  |  UE  |  1  | 
|  2020-07-07 11:34:20  |  Servidor B  |  UE  |  2  | 

 **Nombre del campo de valor**: si selecciona `Server` como **Nombre del campo de valor**, obtendrá un campo por cada valor de la etiqueta `Server`. 


|  Time  |  Centro de datos  |  Servidor A  |  Servidor B  | 
| --- | --- | --- | --- | 
|  2020-07-07 11:34:20  |  UE  |  1  |  2  | 

### Agrupación por
<a name="sort-by"></a>

Esta transformación ordena cada fotograma por el campo configurado. Cuando `reverse` está marcado, los valores se devuelven en el orden opuesto.

### Agrupación por
<a name="group-by"></a>

 Esta transformación agrupa los datos por un valor de campo (columna) específico y procesa los cálculos de cada grupo. Los cálculos disponibles son los mismos que para la transformación Reducir. 

 A continuación se muestra un ejemplo de datos originales. 


|  Time  |  ID del servidor  |  Temperatura de la CPU  |  Estado del servidor  | 
| --- | --- | --- | --- | 
|  2020-07-07 11:34:20  |  servidor 1  |  80  |  Apagado  | 
|  2020-07-07 11:34:20  |  servidor 3  |  62  |  OK  | 
|  2020-07-07 10:32:20  |  servidor 2  |  90  |  Sobrecarga  | 
|  2020-07-07 10:31:22  |  servidor 3  |  55  |  OK  | 
|  2020-07-07 09:30:57  |  servidor 3  |  62  |  Rebooting  | 
|  2020-07-07 09:30:05  |  servidor 2  |  88  |  OK  | 
|  2020-07-07 09:28:06  |  servidor 1  |  80  |  OK  | 
|  2020-07-07 09:25:05  |  servidor 2  |  88  |  OK  | 
|  2020-07-07 09:23:07  |  servidor 1  |  86  |  OK  | 

 Esta transformación consta de dos pasos. En primer lugar, especifique uno o varios campos por los que agrupar los datos. Esto agrupará los mismos valores de esos campos, como si los hubiera ordenado. Por ejemplo, si aplica **Agrupar por** según el campo `Server ID`, agrupará los datos de esta manera: 


|  Time  |  ID del servidor  |  Temperatura de la CPU  |  Estado del servidor  | 
| --- | --- | --- | --- | 
|  2020-07-07 11:34:20  |  servidor 1  |  80  |  Apagado  | 
|  2020-07-07 09:28:06  |  servidor 1  |  80  |  OK  | 
|  2020-07-07 09:23:07  |  servidor 1  |  86  |  OK  | 

```
2020-07-07 10:32:20 | server 2 | 90 | Overload
2020-07-07 09:30:05 | server 2 | 88 | OK
2020-07-07 09:25:05 | server 2 | 88 | OK

2020-07-07 11:34:20 | server 3 | 62 | OK
2020-07-07 10:31:22 | server 3 | 55 | OK
2020-07-07 09:30:57 | server 3 | 62 | Rebooting
```

Todas las filas con el mismo valor de `Server ID` se agrupan. 

Tras elegir el campo por el que quiere agrupar los datos, puede agregar varios cálculos en los demás campos y el cálculo se aplicará a cada grupo de filas. Por ejemplo, podría querer calcular el promedio del valor de `CPU temperature` para cada uno de esos servidores. Así que podemos agregar el cálculo de la *media* aplicado al campo `CPU Temperature` para obtener lo siguiente.


|  ID del servidor  |  Temperatura de la CPU (media)  | 
| --- | --- | 
|  Servidor 1  |  82  | 
|  Servidor 2  |  8.6  | 
|  Servidor 3  |  59,6  | 

Puede agregar más de uno de esos cálculos. Por ejemplo, puede utilizar los siguientes cálculos. 
+  Para el campo `Time`, puede calcular el valor *Último* para saber cuándo se recibió el último punto de datos de cada servidor. 
+  Para el campo `Server Status`, puede calcular el valor *Último* para saber cuál es el último valor de estado de cada servidor. 
+  Para el campo `Temperature`, también puede calcular el valor *Último* para saber cuál es la última temperatura supervisada de cada servidor. 

 La transformación Agrupar por produce los siguientes resultados. 


|  ID del servidor  |  Temperatura de la CPU (media)  |  Temperatura de la CPU (última)  |  Hora (última)  |  Estado del servidor (último)  | 
| --- | --- | --- | --- | --- | 
|  Servidor 1  |  82  |  80  |  2020-07-07 11:34:20  |  Apagado  | 
|  Servidor 2  |  8.6  |  90  |  2020-07-07 10:32:20  |  Sobrecarga  | 
|  Servidor 3  |  59,6  |  62  |  2020-07-07 11:34:20  |  OK  | 

Con esta transformación, puede extraer cierta información clave de su serie temporal y mostrarla de forma cómoda. 

### De series a filas
<a name="series-to-rows"></a>

Use esta transformación para combinar el resultado de varias consultas de datos de serie temporal en un único resultado. Resulta útil cuando se usa la visualización del panel de tablas. 

El resultado de esta transformación contendrá tres columnas: `Time`, `Metric` y `Value`. La columna `Metric` se agrega para que pueda ver fácilmente desde qué consulta se origina la métrica. Personalice este valor definiendo `Label` en la consulta de origen. 

En el siguiente ejemplo, se muestran dos consultas que devuelven datos de serie temporal. Se visualiza como dos tablas independientes antes de aplicar la transformación. 

 Consulta A 


|  Time  |  Temperatura  | 
| --- | --- | 
|  2020-07-07 11:34:20  |  25  | 
|  2020-07-07 10:31:22  |  22  | 
|  2020-07-07 09:30:05  |  19  | 

 Consulta B 


|  Time  |  Humedad  | 
| --- | --- | 
|  2020-07-07 11:34:20  |  24  | 
|  2020-07-07 10:32:20  |  29  | 
|  2020-07-07 09:30:57  |  33  | 

 La aplicación de la transformación `Series to rows` produce los siguientes resultados. 


|  Time  |  Métrica  |  Valor  | 
| --- | --- | --- | 
|  2020-07-07 11:34:20  |  Temperatura  |  25  | 
|  2020-07-07 11:34:20  |  Humedad  |  22  | 
|  2020-07-07 10:32:20  |  Humedad  |  29  | 
|  2020-07-07 10:31:22  |  Temperatura  |  22  | 
|  2020-07-07 09:30:57  |  Humedad  |  33  | 
|  2020-07-07 09:30:05  |  Temperatura  |  19  | 

### Filtrado de datos por valor
<a name="filter-data-by-value"></a>

Esta transformación le permite filtrar sus datos directamente en el espacio de trabajo de Grafana y eliminar algunos puntos de datos del resultado de la consulta. Tiene la opción de incluir o excluir los datos que coincidan con una o varias condiciones que defina. Las condiciones se aplican a un campo seleccionado.

Esta transformación es útil si el origen de datos no filtra por valores de forma nativa. También puede usar esta opción para restringir los valores que se muestran si utiliza una consulta compartida.

 Las condiciones disponibles para todos los campos son los siguientes:
+  **Expresión regular**: busque coincidencias con una expresión regular. 
+  **Es nulo**: aplique coincidencias si el valor es nulo.
+  **No es nulo**: aplique coincidencias si el valor no es nulo.
+  **Igual**: aplique coincidencias si el valor es igual al valor especificado. 
+  **Diferente**: aplique coincidencias si el valor es diferente al valor especificado. 

Las condiciones disponibles para los campos de número son las siguientes:
+  **Mayor**: aplique coincidencias si el valor es mayor que el valor especificado. 
+  **Menor**: aplique coincidencias si el valor es menor que el valor especificado. 
+  **Mayor o igual**: busque coincidencias si el valor es mayor o igual que el valor especificado. 
+  **Menor o igual**: busque coincidencias si el valor es menor o igual que el valor especificado. 
+  **Intervalo**: busque coincidencias con un intervalo entre un mínimo y un máximo especificados. El mínimo y el máximo se incluyen en el intervalo.

Puede agregar más de una condición al filtro. Cuando tiene más de una condición, puede elegir si quiere incluir o excluir acciones que se apliquen en filas que coincidan con todas o cualquiera de las condiciones que agregue.

Se ignoran las condiciones que no sean válidas o que estén configuradas de forma incompleta.

### Depuración de transformaciones
<a name="debug-transformations"></a>

Para ver los conjuntos de resultados de entrada y salida de la transformación, elija el icono de depuración situado en la parte derecha de la fila de la transformación. 

 Amazon Managed Grafana muestra la vista de depuración de transformaciones debajo de la fila de transformaciones. 

# Opciones de campo y anulaciones
<a name="field-options-overrides"></a>

****  
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 8.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.md).  
Para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).

 En esta sección se explica qué son las opciones de campo y las anulaciones de campo en Amazon Managed Grafana y cómo utilizarlas. 

 El modelo de datos utilizado en los espacios de trabajo de Grafana, el marco de datos, es una estructura de tabla orientada a columnas que unifica las series temporales y los resultados de las consultas de tablas. Cada columna de esta estructura se denomina *campo*. Un campo puede representar una sola columna de serie temporal o tabla. 

 Las opciones de campo le permiten cambiar la forma en que se muestran los datos en las visualizaciones. Las opciones y anulaciones que aplique no cambian los datos, sino que cambian la forma en que Amazon Managed Grafana muestra los datos. 

## Opciones de campo
<a name="field-options-overview"></a>

 Las *opciones de campo*, tanto estándar como personalizadas, se encuentran en la pestaña **Campo** del editor de paneles. Los cambios que se hacen en esta pestaña se aplican a todos los campos (es decir, series y columnas). Por ejemplo, si cambia la unidad a porcentaje, todos los campos con valores numéricos se mostrarán en porcentajes. Obtenga información sobre cómo aplicar una opción de campo en [Configuración de todos los campos](#configure-all-fields). 

## Anulaciones de campo
<a name="field-overrides-overview"></a>

 Las *anulaciones de campo* se pueden agregar en la pestaña **Anulaciones** del editor de paneles. Allí puede agregar las mismas opciones que se encuentran en la pestaña **Campo**, pero solo se aplican a campos específicos. Obtenga información sobre cómo aplicar una anulación en [Configuración de campos específicos](#configure-specific-fields).

## Opciones de campo y anulaciones disponibles
<a name="available-field-options-and-overrides"></a>

 Los tipos de opciones de campo son comunes tanto a las opciones de campo como a las anulaciones de campo. La única diferencia es si el cambio se aplicará a todos los campos (aplicado en la pestaña **Campo**) o a un subconjunto de campos (aplicado en la pestaña **Anulaciones**). 
+  [Opciones de campo estándar](#standard-field-options) se aplican a todas las visualizaciones del panel que permiten transformaciones. 
+  [Opciones de campos de la tabla](table-panel.md#table-field-options) se aplican únicamente a las visualizaciones de paneles de tablas. 

### Configuración de todos los campos
<a name="configure-all-fields"></a>

 Para cambiar la forma en que todos los campos muestran los datos, puede cambiar una opción en la pestaña **Campo**. En la pestaña **Anulaciones**, puede anular las opciones de campo para campos específicos. Para obtener más información, consulte [Configuración de campos específicos](#configure-specific-fields). 

 Por ejemplo, puede cambiar el número de decimales que se muestran en todos los campos cambiando la opción **Decimales**. Para obtener más información sobre las opciones, consulte [Opciones de campo estándar](#standard-field-options) y [Opciones de campos de la tabla](table-panel.md#table-field-options). 

#### Cambio de una opción de campo
<a name="change-a-field-option"></a>

 Puede cambiar tantas opciones como desee. 

**Cambio de una opción de campo**

1.  Seleccione el panel que desee editar, elija el título del panel y, a continuación, seleccione **Editar**. 

1.  Elija la pestaña **Campo**. 

1.  Busque la opción que desea cambiar. Puede definir lo siguiente: 
   +  [Opciones de campo estándar](#standard-field-options), que se aplican a todas las visualizaciones de paneles que permiten transformaciones. 
   +  [Opciones de campos de la tabla](table-panel.md#table-field-options), que solo se aplican a las visualizaciones de paneles de tablas. 

1.  Para agregar opciones, agregue valores en los campos. Para devolver las opciones a sus valores predeterminados, elimine el texto blanco de los campos. 

1.  Cuando haya terminado de editar el panel, seleccione **Guardar**. 

#### Ejemplo de opción de campo
<a name="field-option-example"></a>

 Supongamos que el conjunto de resultados es un marco de datos que consta de dos campos: tiempo y temperatura. 


|  hora  |  temperature  | 
| --- | --- | 
|  2020-01-02 03:04:00  |  45.0  | 
|  2020-01-02 03:05:00  |  47,0  | 
|  2020-01-02 03:06:00  |  48,0  | 

 A cada campo (columna) de esta estructura se le pueden aplicar opciones de campo que modifiquen la forma en que se muestran sus valores. Por ejemplo, puede definir la unidad en Temperatura > Celsius, lo que da como resultado la siguiente tabla. 


|  hora  |  temperature  | 
| --- | --- | 
|  2020-01-02 03:04:00  |  45,0 °C  | 
|  2020-01-02 03:05:00  |  47,0 °C  | 
|  2020-01-02 03:06:00  |  48,0 °C  | 

 La cifra decimal no significa nada en este caso. Puede cambiar los decimales de `auto` a cero (`0`), lo que da como resultado la siguiente tabla. 


|  hora  |  temperature  | 
| --- | --- | 
|  2020-01-02 03:04:00  |  45 °C  | 
|  2020-01-02 03:05:00  |  47 °C  | 
|  2020-01-02 03:06:00  |  48 °C  | 

### Configuración de campos específicos
<a name="configure-specific-fields"></a>

 Puede utilizar las anulaciones para cambiar la configuración de uno o más campos. Las opciones de campo para las anulaciones son exactamente las mismas que las opciones de campo que están disponibles en una visualización concreta. La única diferencia es que elige a qué campos aplicarlos. 

 Por ejemplo, puede cambiar el número de decimales que se muestran en todos los campos o columnas numéricos cambiando la opción **Decimales** para los **campos cuyo tipo** coincida con el valor **Numérico**. Para obtener más información sobre las opciones, consulte [Opciones de campo estándar](#standard-field-options), que se aplican a todas las visualizaciones de paneles que permiten transformaciones, y [Opciones de campos de la tabla](table-panel.md#table-field-options), que se aplican únicamente a las visualizaciones de paneles de tablas. 

#### Adición de una anulación de campo
<a name="add-a-field-override"></a>

 Puede anular tantas opciones de campo como desee. 

**Adición de una anulación de campo**

1.  Seleccione el panel que desee editar, elija el título del panel y, a continuación, seleccione **Editar**. 

1.  Seleccione la pestaña **Anulaciones**. 

1.  Seleccione **Agregar una anulación para**. 

1.  Seleccione los campos a los que desee aplicar una regla de anulación. 
   +  **Campos con nombre**: utilice esta opción para seleccionar un campo de la lista de todos los campos disponibles. Las propiedades que agregue a una regla con este selector se aplican solo a este único campo. 
   +  **Campos cuyo nombre coincida con la expresión regular**: utilice esta opción para especificar los campos que se van a anular con una expresión regular. Las propiedades que agregue a una regla mediante este selector se aplican a todos los campos en los que los nombres de los campos coincidan con la expresión regular. 
   +  **Campos con tipo**: utilice esta opción para seleccionar campos por tipo, como cadenas, valores numéricos, etc. Las propiedades que agregue a una regla con este selector se aplican a todos los campos que coincidan con el tipo seleccionado. 

1.  Elija **Agregar propiedad de anulación**. 

1.  Seleccione la opción de campo que desee aplicar. 

1.  Para ingresar opciones, agregue valores en los campos. Para devolver las opciones a sus valores predeterminados, elimine el texto blanco de los campos. 

1. Para seguir agregando anulaciones a este campo, seleccione **Agregar propiedad de anulación**, o bien puede elegir **Agregar anulación** y seleccionar un campo diferente al que agregar anulaciones.

1.  Cuando termine, elija **Guardar**. 

#### Eliminación de una anulación de campo
<a name="delete-a-field-override"></a>

1.  Seleccione la pestaña Anulaciones que contiene la anulación que desee eliminar. 

1.  Seleccione el icono de la papelera que está junto a la anulación. 

#### Ejemplo de anulación de campo
<a name="field-override-example"></a>

Supongamos que nuestro conjunto de resultados es un marco de datos que consta de cuatro campos: tiempo, temp. alta, temp. baja y humedad. 


|  hora  |  temp. alta  |  temp. baja  |  humedad  | 
| --- | --- | --- | --- | 
|  2020-01-02 03:04:00  |  45.0  |  30.0  |  67  | 
|  2020-01-02 03:05:00  |  47,0  |  34,0  |  68  | 
|  2020-01-02 03:06:00  |  48,0  |  31,0  |  68  | 

 Vamos a aplicar las opciones de campo de [Ejemplo de opción de campo](#field-option-example) para aplicar la unidad Celsius y eliminar el decimal. Esto da como resultado la siguiente tabla. 


|  hora  |  temp. alta  |  temp. baja  |  humedad  | 
| --- | --- | --- | --- | 
|  2020-01-02 03:04:00  |  45 °C  |  30 °C  |  67 °C  | 
|  2020-01-02 03:05:00  |  47 °C  |  34 °C  |  68 °C  | 
|  2020-01-02 03:06:00  |  48 °C  |  31 °C  |  68 °C  | 

 Los campos de temperatura están bien, pero los valores de humedad no tienen sentido. Para solucionar este problema, aplique una anulación de opción de campo al campo de humedad y cambie la unidad a Misc. > porcentaje (0-100). Esto da como resultado una tabla que tiene mucho más sentido. 


|  hora  |  temp. alta  |  temp. baja  |  humedad  | 
| --- | --- | --- | --- | 
|  2020-01-02 03:04:00  |  45 °C  |  30 °C  |  67%  | 
|  2020-01-02 03:05:00  |  47 °C  |  34 °C  |  68%  | 
|  2020-01-02 03:06:00  |  48 °C  |  31 °C  |  68%  | 

### Opciones de campo estándar
<a name="standard-field-options"></a>

 En esta sección se explican las opciones de campo disponibles. Se muestran en orden alfabético. 

 Puede aplicar opciones de campo estándar a la mayoría de los paneles integrados del espacio de trabajo de Grafana. A algunos paneles antiguos y paneles comunitarios que no se hayan actualizado al nuevo panel y modelo de datos les faltarán todas o algunas de estas opciones de campo. 

 La mayoría de las opciones de campo no afectarán a la visualización hasta que haga clic fuera del cuadro de opciones de campo que está editando o pulse Entrar. 

 Para obtener más información sobre la aplicación de estas opciones, consulte las siguientes secciones: 
+  [Configuración de todos los campos](#configure-all-fields) 
+  [Configuración de campos específicos](#configure-specific-fields) 

#### Decimales
<a name="decimals"></a>

 Esta opción establece el número de decimales que se van a incluir al renderizar un valor. Déjela en blanco para que Amazon Managed Grafana utilice el número de decimales proporcionado por el origen de datos. 

 Para cambiar esta configuración, ingrese un número en el campo. 

#### Enlaces de datos
<a name="data-links-overview"></a>

 Esta opción controla la URL a la que se vincula un valor o una visualización. Para obtener más información e instrucciones, consulte [Enlaces de datos](data-links.md). 

#### Display name (Nombre de visualización)
<a name="display-name"></a>

 Esta opción establece el título para mostrar de todos los campos. Puede utilizar variables en el título del campo. Para obtener más información acerca de las plantillas y sus variables, consulte [Plantillas y variables](templates-and-variables.md). 

 Cuando se muestran varias estadísticas, campos o series, este campo controla el título de cada estadística. Puede usar expresiones como `${__field.name}` para usar solo el nombre de la serie o el nombre del campo en el título. 

 Dado un campo con el nombre Temp y las etiquetas \$1"Loc"="PBI", "Sensor"="3"\$1 


|  Sintaxis de expresiones  |  Ejemplo  |  Se renderiza en  |  Explicación  | 
| --- | --- | --- | --- | 
|  \$1\$1\$1\$1field.displayName\$1  |  Igual que la sintaxis  |  Temp \$1Loc="PBI", Sensor="3"\$1  |  Muestra el nombre del campo y las etiquetas en \$1\$1 en caso de que estén presentes. Si solo hay una clave de etiqueta en la respuesta, para la parte de la etiqueta, Amazon Managed Grafana muestra el valor de la etiqueta sin los corchetes.  | 
|  \$1\$1\$1\$1field.name\$1  |  Igual que la sintaxis  |  Temp  |  Muestra el nombre del campo (sin etiquetas).  | 
|  \$1\$1\$1\$1field.labels\$1  |  Igual que la sintaxis  |  Loc="PBI", Sensor="3"  |  Muestra las etiquetas sin el nombre.  | 
|  \$1\$1\$1\$1field.labels.X\$1  |  \$1\$1\$1\$1field.labels.Loc\$1  |  PBI  |  Muestra el valor de la clave de etiqueta especificada.  | 
|  \$1\$1\$1\$1field.labels.\$1\$1values\$1  |  Igual que la sintaxis  |  PBI, 3  |  Muestra los valores de las etiquetas separados por una coma (sin claves de etiqueta).  | 

 Si el valor es una cadena vacía después de renderizar la expresión de un campo concreto, se utiliza el método de visualización predeterminado. 

#### Máximo
<a name="max"></a>

 Esta opción establece el valor máximo utilizado en los cálculos del umbral porcentual. Para el cálculo automático basado en todas las series y campos, deje este ajuste en blanco. 

#### Mínimo
<a name="min"></a>

 Esta opción establece el valor mínimo utilizado en los cálculos del umbral porcentual. Para el cálculo automático basado en todas las series y campos, deje este ajuste en blanco. 

#### Sin valores
<a name="no-value"></a>

 Ingrese lo que Amazon Managed Grafana debe mostrar si el valor del campo está vacío o es nulo. 

#### Unidad
<a name="unit"></a>

 Esta opción especifica la unidad que debe utilizar un campo. Elija el campo **Unidad** y, a continuación, busque hasta encontrar la unidad que desee. La unidad que seleccione se aplicará a todos los campos excepto al de tiempo. 

##### Unidades personalizadas
<a name="custom-units"></a>

 También puede utilizar la lista desplegable de unidades para especificar unidades personalizadas, prefijos o sufijos personalizados y formatos. date/time 

 Para seleccionar una unidad personalizada, ingrésela y seleccione la última opción `Custom: xxx` de la lista desplegable. 
+  `suffix:<suffix>` para una unidad personalizada que debe ir después del valor. 
+  `time:<format>`para date/time formatos personalizados; por ejemplo,. `time:YYYY-MM-DD` Para ver la sintaxis y las opciones del formato, consulte [Display](https://momentjs.com/docs/#/displaying/). 
+  `si:<base scale><unit characters>` para unidades del SI personalizadas; por ejemplo, `si: mF`. Esta opción es un poco más avanzada porque puede especificar tanto una unidad como la escala de datos de origen. Por ejemplo, si los datos de origen se representan como unidades de milésimas (miles), agregue a la unidad el carácter de la escala del SI como prefijo. 
+  `count:<unit>` para una unidad de recuento personalizada. 
+  `currency:<unit>` para personalizar una unidad monetaria. 

 También puede pegar un emoji nativo en el selector de unidades y seleccionarlo como unidad personalizada. 

##### Unidades de cadena
<a name="string-units"></a>

 A veces, Amazon Managed Grafana puede analizar cadenas y mostrarlas como números. Para que Amazon Managed Grafana muestre la cadena original, cree una anulación de campo y agregue una propiedad de unidad con la unidad `string`. 

#### Combinación de colores
<a name="color-scheme"></a>

 La opción de color de campo define cómo Amazon Managed Grafana colorea series o campos. Aquí hay varios modos que funcionan de forma diferente y su utilidad depende en gran medida de la visualización actualmente seleccionada. 

 Los modos de color continuo utilizan el porcentaje de un valor en relación con el mínimo y el máximo para interpolar un color. 
+  **Color único**: se establece un color específico mediante el selector de color. Esto resulta muy útil si se trata de una regla de anulación. 
+  **A partir de los umbrales**: color derivado del umbral coincidente. Esto resulta útil para las visualizaciones de indicadores, estadísticas y tablas. 

##### Color por serie
<a name="color-by-series"></a>

 Amazon Managed Grafana incluye combinaciones de colores que definen el color por series. Esto resulta útil, por ejemplo, para gráficos y gráficos circulares. 

##### Color por valor
<a name="color-by-value"></a>

 Amazon Managed Grafana también incluye esquemas de color continuos (degradados). Esto resulta útil para las visualizaciones que colorean valores individuales; por ejemplo, los paneles de estadísticas y el panel de tablas. 

#### Umbrales
<a name="thresholds-overview"></a>

 Puede usar umbrales para cambiar el color de un campo en función del valor. Para obtener más información e instrucciones, consulte [Umbrales](thresholds.md). 

#### Asignación de valores
<a name="value-mapping"></a>

 Puede usar esta opción para establecer reglas que conviertan un valor de campo o un rango de valores en texto explícito. Puede agregar más de una asignación de valores. 
+  **Tipo de asignación**: elija una opción. 
  +  **Valor**: ingrese un valor. Si el valor del campo es mayor o igual que el valor, se muestra el **texto**. 
  +  **Desde** y **Hasta**: ingrese un intervalo. Si el valor del campo se encuentra entre los valores del rango o es igual, se muestra el **texto**. 
+  **Texto**: texto que se muestra si se cumplen las condiciones en un campo. Este campo acepta variables. 

# Editor de paneles
<a name="AMG-panel-editor"></a>

****  
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 8.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.md).  
Para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).

 En este tema se describen las partes del editor de paneles de Amazon Managed Grafana y se incluyen enlaces en los que puede encontrar más información. 

## Apertura del editor de paneles
<a name="open-the-panel-editor"></a>

 Hay varias formas de acceder al editor de paneles, pantalla también denominada **Panel de edición**, *modo de edición* o *modo de edición de paneles*. 
+  Seleccione el icono **Agregar panel** en la parte superior de la pantalla y, a continuación, seleccione **Agregar panel nuevo**. El nuevo panel se abre en el editor de paneles. Para obtener información sobre cómo agregar un panel, consulte [Cómo agregar un panel](add-a-panel-to-a-dashboard.md). 
+  Elija el título de un panel existente y, a continuación, elija **Editar**. El panel se abre en modo de edición. 
+  Elija cualquier lugar de un panel existente y, a continuación, pulse **e** en el teclado. El panel se abre en modo de edición. 

## Cambio de tamaño de las secciones del editor de paneles
<a name="resize-panel-editor-sections"></a>

 Arrastre para cambiar el tamaño de las secciones del editor de paneles. Si el panel lateral se estrecha demasiado, las pestañas **Panel**, **Campo** y **Anulaciones** se convierten en una lista desplegable. 

## Partes del editor de paneles
<a name="parts-of-the-panel-editor"></a>

 En esta sección se describen las partes de la pantalla del editor de paneles, con información sobre los campos, las opciones o las tareas asociadas a cada parte. 

### Encabezado
<a name="header"></a>

 En la sección del encabezado se muestran el nombre del panel en el que se encuentra el panel y algunos comandos del panel. También puede seleccionar la flecha **Volver** para volver al panel. 

 En la parte derecha del encabezado se encuentran las siguientes opciones: 
+  **Icono de configuración (engranaje) del panel**: elija acceder a la configuración del panel. 
+  **Descartar**: elija descartar todos los cambios que haya hecho en el panel desde la última vez que lo guardó. 
+  **Guardar**: elija guardar el panel, incluidos todos los cambios que haya hecho en el editor de paneles. 
+  **Aplicar**: elija aplicar los cambios que haya hecho y, a continuación, cierre el editor de paneles y vuelva al panel. Guarde también el panel para conservar los cambios aplicados. 

### Vista previa de la visualización
<a name="visualization-preview"></a>

 La sección de vista previa de la visualización contiene las opciones de visualización, los controles de intervalo de tiempo, la vista previa de la visualización y (si corresponde) el título, los ejes y la leyenda del panel. 
+  **Rellenar**: la vista previa de la visualización rellena el espacio disponible en la parte de vista previa. Si cambia el ancho del panel lateral o la altura del panel inferior, la visualización se adapta para rellenar cualquier espacio disponible. 
+  **Ajustar**: la vista previa de la visualización rellena el espacio disponible, pero conserva la relación de aspecto del panel. 
+  **Exacto**: la vista previa de la visualización tiene el tamaño exacto del panel. Si no hay suficiente espacio disponible, la visualización se reduce verticalmente y se conserva la relación de aspecto. 
+  **Controles de intervalo de tiempo**: para obtener más información, consulte [Controles de intervalo de tiempo](dashboard-time-range-controls.md).

### Sección de datos (panel inferior)
<a name="data-section-bottom-pane"></a>

 La sección de datos contiene pestañas en las que puede ingresar consultas, transformar los datos y crear reglas de alerta (si procede). 
+  **Pestaña Consulta**: seleccione su origen de datos e ingrese las consultas aquí. Para obtener más información, consulte [Consultas](panel-queries.md). 
+  **Pestaña Transformar**: aplique transformaciones de datos. Para obtener más información, consulte [Transformaciones](panel-transformations.md). 
+  **Pestaña Alerta**: escriba reglas de alerta. Para obtener más información, consulte [Alertas de Grafana](alerts-overview.md). 

### Opciones de panel y campo (panel lateral)
<a name="panel-and-field-options-side-pane"></a>

 Esta sección contiene pestañas en las que puede controlar casi todos los aspectos de la visualización de los datos. No todas las pestañas están disponibles para cada visualización. 

 Las características de estas pestañas se describen en los siguientes temas: 
+  [Cómo agregar un panel](add-a-panel-to-a-dashboard.md) 
+  [Visualizaciones](AMG-visualizations.md) 
+  [Opciones de campo y anulaciones](field-options-overrides.md) 
+  [Enlaces de panel](panel-links.md) y [Enlaces de datos](data-links.md), que lo ayudan a conectar su visualización con otros recursos 

# Paneles de biblioteca
<a name="AMG-library-panel"></a>

****  
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 8.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.md).  
Para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).

 Los paneles de biblioteca permiten a los usuarios crear paneles reutilizables en los que cualquier cambio aplicado en una instancia del panel de biblioteca se refleja en todos los paneles y afectará a todas las demás instancias en las que se utilice el panel. Estos paneles se pueden guardar en carpetas junto con los demás paneles y agilizar la reutilización de los paneles en varios paneles. 

## Creación de un panel de biblioteca
<a name="library-panel-create"></a>

**nota**  
Al crear paneles de biblioteca, el panel del panel de origen también se convierte en un panel de biblioteca. Deberá guardar el panel original una vez que se haya convertido el panel.

**Creación de un panel de biblioteca**

1. Cree un panel como lo haría normalmente. También puede utilizar un panel que ya exista.

1. Elija el título del panel y seleccione **Editar**.

1. En el panel lateral de opciones de visualización del panel, elija la opción de flecha hacia abajo para aplicar cambios en la visualización.

1. Seleccione **Paneles de biblioteca** y, a continuación, **Crear nuevo panel de biblioteca**. 

1. Ingrese un nombre para el panel de biblioteca y seleccione la carpeta en la que desea guardarlo.

1. Seleccione **Crear panel de biblioteca** y, a continuación, guarde el panel.

También puede crear paneles de biblioteca mediante la opción **Compartir** para cualquier panel.

Una vez creado, puede modificar el panel de biblioteca desde cualquier panel en el que aparezca. Una vez guardados los cambios en el panel de biblioteca, todas las instancias del panel de biblioteca reflejarán estas modificaciones.

## Cómo agregar un panel de biblioteca
<a name="library-panel-add"></a>

**Adición de un panel de biblioteca a un panel de control**

1. Haga una pausa en la opción \$1 del menú de la izquierda y, a continuación, seleccione **Crear**.

1. Seleccione **Agregar un panel de la biblioteca de paneles**.

1. Filtre la lista de paneles de biblioteca para encontrar el panel que desee.

1. Elija ese panel y agréguelo al panel. 

## Desvinculación de un panel de biblioteca
<a name="library-panel-unlink"></a>

Si tiene un panel de biblioteca en el panel que desea modificar sin que ello afecte a las demás instancias del panel de biblioteca, puede desvincular el panel de biblioteca.

**Desvinculación de un panel de biblioteca de un panel**

1. Haga una pausa en **Panel** en el menú de la izquierda y, a continuación, seleccione **Paneles de biblioteca**.

1. Seleccione un panel de biblioteca. Verá una lista de todos los paneles en los que se utiliza el panel de biblioteca.

1. Seleccione el panel que desea desvincular y actualizar.

1. Elija el título del panel y seleccione **Editar**. 

1. Elija **Desvincular**. 

## Eliminación de un panel de biblioteca
<a name="library-panel-delete"></a>

Antes de eliminar un panel de biblioteca, compruebe que ya no esté en uso en ningún panel.

**Eliminación de un panel de biblioteca**

1. Haga una pausa en **Panel** en el menú de la izquierda y, a continuación, seleccione **Paneles de biblioteca**.

1. Seleccione un panel de biblioteca. Verá una lista de todos los paneles en los que se utiliza el panel de biblioteca.

1. Seleccione el panel que desea eliminar.

1. Elija el icono de eliminación junto al nombre del panel. 

## Partes del editor de paneles
<a name="parts-of-the-panel-editor"></a>

 En esta sección se describen las partes de la pantalla del editor de paneles, con información sobre los campos, las opciones o las tareas asociadas a cada parte. 

### Encabezado
<a name="header"></a>

 En la sección del encabezado se muestran el nombre del panel en el que se encuentra el panel y algunos comandos del panel. También puede seleccionar la flecha **Volver** para volver al panel. 

 En la parte derecha del encabezado se encuentran las siguientes opciones: 
+  **Icono de configuración (engranaje) del panel**: elija acceder a la configuración del panel. 
+  **Descartar**: elija descartar todos los cambios que haya hecho en el panel desde la última vez que lo guardó. 
+  **Guardar**: elija guardar el panel, incluidos todos los cambios que haya hecho en el editor de paneles. 
+  **Aplicar**: elija aplicar los cambios que haya hecho y, a continuación, cierre el editor de paneles y vuelva al panel. Guarde también el panel para conservar los cambios aplicados. 

### Vista previa de la visualización
<a name="visualization-preview"></a>

 La sección de vista previa de la visualización contiene las opciones de visualización, los controles de intervalo de tiempo, la vista previa de la visualización y (si corresponde) el título, los ejes y la leyenda del panel. 
+  **Rellenar**: la vista previa de la visualización rellena el espacio disponible en la parte de vista previa. Si cambia el ancho del panel lateral o la altura del panel inferior, la visualización se adapta para rellenar cualquier espacio disponible. 
+  **Ajustar**: la vista previa de la visualización rellena el espacio disponible, pero conserva la relación de aspecto del panel. 
+  **Exacto**: la vista previa de la visualización tiene el tamaño exacto del panel. Si no hay suficiente espacio disponible, la visualización se reduce verticalmente y se conserva la relación de aspecto. 
+  **Controles de intervalo de tiempo**: para obtener más información, consulte [Controles de intervalo de tiempo](dashboard-time-range-controls.md).

### Sección de datos (panel inferior)
<a name="data-section-bottom-pane"></a>

 La sección de datos contiene pestañas en las que puede ingresar consultas, transformar los datos y crear reglas de alerta (si procede). 
+  **Pestaña Consulta**: seleccione su origen de datos e ingrese las consultas aquí. Para obtener más información, consulte [Consultas](panel-queries.md). 
+  **Pestaña Transformar**: aplique transformaciones de datos. Para obtener más información, consulte [Transformaciones](panel-transformations.md). 
+  **Pestaña Alerta**: escriba reglas de alerta. Para obtener más información, consulte [Alertas de Grafana](alerts-overview.md). 

### Opciones de panel y campo (panel lateral)
<a name="panel-and-field-options-side-pane"></a>

 Esta sección contiene pestañas en las que puede controlar casi todos los aspectos de la visualización de los datos. No todas las pestañas están disponibles para cada visualización. 

 Las características de estas pestañas se describen en los siguientes temas: 
+  [Cómo agregar un panel](add-a-panel-to-a-dashboard.md) 
+  [Visualizaciones](AMG-visualizations.md) 
+  [Opciones de campo y anulaciones](field-options-overrides.md) 
+  [Enlaces de panel](panel-links.md) y [Enlaces de datos](data-links.md), que lo ayudan a conectar su visualización con otros recursos 

# Visualizaciones
<a name="AMG-visualizations"></a>

****  
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 8.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.md).  
Para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).

Amazon Managed Grafana ofrece una variedad de visualizaciones que se adaptan a diferentes casos de uso. En las siguientes secciones se enumeran las visualizaciones que están disponibles en Amazon Managed Grafana y sus ajustes de visualización.

**Topics**
+ [Panel de lista de alertas](alert-list-panel.md)
+ [Panel de gráfico de barras](bar-chart-panel.md)
+ [Panel de medidores de barras](alert-panel-bar-gauge-panel.md)
+ [Panel Reloj](clock-panel.md)
+ [Panel de lista de paneles](dashboard-list-panel.md)
+ [Panel de medidores](gauge-panel.md)
+ [Panel Geomapa](AMG-Geomap.md)
+ [Panel de gráfico](graph-panel.md)
+ [Mapa de calor](visualization-heatmap.md)
+ [Panel de histogramas](histogram-panel.md)
+ [Panel de registros](logs-panel.md)
+ [Panel de noticias](news-panel.md)
+ [Panel de gráficos de nodos (beta)](node-graph-panel.md)
+ [Panel de gráfico circular](pie-chart-panel.md)
+ [Panel de Plotly](plotly-panel.md)
+ [Panel de Sankey](sankey-panel.md)
+ [Panel Dispersión](scatter-panel.md)
+ [Panel de estadísticas](stat-panel.md)
+ [Panel de escala de tiempo de estado](state-timeline-panel.md)
+ [Panel Historial de estado](status-history-panel.md)
+ [Panel de tablas](table-panel.md)
+ [Panel de texto](text-panel.md)
+ [Panel de serie temporal](time-series-panel.md)
+ [Umbrales](thresholds.md)
+ [WindRose](windrose.md)
+ [Inspección de un panel](inspect-a-panel.md)
+ [Lista de cálculos](list-of-calculations.md)

# Panel de lista de alertas
<a name="alert-list-panel"></a>

****  
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 8.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.md).  
Para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).

En el panel de lista de alertas se muestran las alertas del panel. Puede configurar la lista para mostrar el estado actual o los cambios de estado recientes. Para obtener más información sobre las alertas, consulte [Alertas de Grafana](alerts-overview.md).

Use estos ajustes para ajustar la visualización.

## Opciones
<a name="alert-list-panel-options"></a>
+  **Mostrar**: elija si el panel debe mostrar el estado actual de la alerta o los cambios recientes de estado de la alerta.
+  **Número máximo de elementos**: establezca el número máximo de alertas que se van a mostrar.
+  **Orden de clasificación**: seleccione cómo ordenar las alertas que se muestran.
  +  **Alfabético (asc)**: orden alfabético
  +  **Alfabético (desc)**: orden alfabético inverso
  +  **Importancia**: por importancia según los siguientes valores, en el que 1 el más alto:
    + alerting: 1
    + no\$1data: 2
    + pending: 3
    + ok: 4
    + paused: 5
+  **Alertas de este panel de control**: muestre las alertas solo desde el panel de control en el que se encuentra la lista de alertas.

## Filtro
<a name="alerts-panel-filter"></a>

Utilice las siguientes opciones para filtrar las alertas para que coincidan con la consulta, la carpeta o las etiquetas que elija:
+  **Nombre de la alerta**: ingrese una consulta de nombre de alerta. 
+  **Título del panel**: ingrese una consulta de título del panel.
+  **Carpeta**: seleccione una carpeta. Solo se mostrarán las alertas de los paneles de control de la carpeta seleccionada.
+  **Etiquetas del panel**: seleccione una o más etiquetas. Solo se mostrarán las alertas de los paneles con una o más de las etiquetas. 

## Filtro de estado
<a name="alert-panel-state-filter"></a>

Elija los estados de alerta que desea mostrar en este panel.
+ Correcto
+ Paused
+ Sin datos
+ Error de ejecución
+ Alertas
+ Pending (Pendiente)

# Panel de gráfico de barras
<a name="bar-chart-panel"></a>

****  
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 8.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.md).  
Para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).

Esta visualización de panel le permite crear un gráfico de datos categóricos.

## Formatos de datos admitidos
<a name="bar-chart-formats"></a>

Solo se admite un marco de datos y debe tener al menos un campo de cadena que se utilizará como categoría para un eje X o Y y uno o más campos numéricos. A continuación se muestra un ejemplo de formatos de datos:


|  Navegador  |  Cuota de mercado  | 
| --- | --- | 
|  Chrome  |  50  | 
|  Internet Explorer  |  17,5  | 

Si tiene más de un campo numérico, el panel muestra las barras agrupadas.

### Visualización de series temporales o conjuntos de resultados múltiples
<a name="bar-chart-visualization"></a>

Si tiene varias series temporales o tablas, primero debe unirlas mediante una unión o reducir la transformación. Por ejemplo, si tiene varias series temporales y desea comparar sus valores máximo y último, agregue la transformación Reducir y especifique Máximo y Último como opciones en Cálculos.

## Opciones de gráficos de barras
<a name="bar-chart-options"></a>

Utilice estas opciones para refinar las visualizaciones:

**Orientation (Orientación)**
+  **Automático**: Grafana decide la orientación de la barra en función de las dimensiones del panel.
+  **Horizontal**: convierte el eje X en el eje de categorías.
+  **Vertical**: convierte el eje Y en el eje de categorías.

**Mostrar valores**

Controla si los valores se muestran encima o a la izquierda de las barras.
+  **Automático**: los valores se muestran si hay espacio.
+  **Siempre**: siempre se muestran los valores.
+  **Nunca**: nunca se muestran los valores.

**Ancho de grupo** controla el ancho de los grupos. 0 = ancho mínimo y 1 = ancho máximo.

**Ancho de barra** controla el ancho de las barras. 0 = ancho mínimo y 1 = ancho máximo.

**Ancho de línea** controla el ancho de línea de las barras.

**Opacidad de relleno**: controla la opacidad de relleno de las barras.

**Modo de degradado** establece el modo del relleno de degradado. El degradado de relleno se basa en el color de la línea. Para cambiar el color, utilice la opción de campo de combinación de colores estándar. El aspecto del degradado depende de la configuración Opacidad de relleno.
+  **Ninguno**: sin relleno de degradado; esta es la configuración predeterminada.
+  **Opacidad**: la transparencia del degradado se calcula en función de los valores del eje Y. La opacidad del relleno aumenta con los valores del eje Y.
+  **Tonalidad**: el color del degradado se genera en función de la tonalidad del color de la línea.

**Modo de información sobre herramientas**: al pasar el cursor sobre la visualización, Grafana puede mostrar información sobre herramientas. Elija cómo se comporta la información sobre herramientas.
+  **Único**: la información sobre herramientas que aparece al pasar el ratón solo muestra una serie, aquella sobre la que se pasa el ratón en la visualización.
+  **Todo**: la información sobre herramientas situada al pasar el ratón muestra todas las series de la visualización. Grafana resalta las series sobre las que pasa el ratón en negrita en la lista de series de la información sobre herramientas.
+  **Oculto**: no muestre la información sobre herramientas cuando interactúa con la visualización.

**nota**  
Use una anulación para ocultar series individuales de la información sobre herramientas.

**Modo de leyenda**: utilice esta configuración para refinar la forma en que aparece la leyenda en la visualización.
+  **Lista**: muestra la leyenda como una lista. Este es el modo de visualización predeterminado de la leyenda.
+  **Tabla**: muestra la leyenda como una tabla.
+  **Oculta**: oculta la leyenda.

**Ubicación de la leyenda**: elija dónde colocar la leyenda.
+  **Parte inferior**: debajo del gráfico.
+  **Derecha**: a la derecha del gráfico.

**Cálculos de la leyenda**: elija qué cálculos estándar se muestran en la leyenda. Puede tener más de uno.

**Tamaño del texto:** ingrese un valor para cambiar el tamaño del texto del gráfico de barras.

**Eje**: utilice la siguiente configuración de campo para refinar la visualización de los ejes. Algunas opciones de campo no afectarán a la visualización hasta que haga clic fuera del cuadro de opciones de campo que esté editando o pulse Intro.
+  **Ubicación**: establece la ubicación del eje Y.
+  **Automático**: Grafana asigna automáticamente el eje Y a la serie. Cuando hay dos o más series con unidades diferentes, Grafana asigna el eje izquierdo a la primera unidad y el derecho a las siguientes unidades.
+  **Izquierda**: muestre todos los ejes Y en el lado izquierdo.
+  **Derecha**: muestre todos los ejes Y en el lado derecho.
+  **Oculto**: oculta todos los ejes Y.
+  **Etiqueta**: establezca una etiqueta de texto en el eje Y. Si tiene más de un eje Y, puede asignar diferentes etiquetas con una anulación.
+  **Ancho**: establezca un ancho fijo del eje. De forma predeterminada, Grafana calcula dinámicamente el ancho de un eje.

  Al establecer el ancho del eje, los datos con diferentes tipos de ejes pueden compartir las mismas proporciones de visualización. Esto facilita la comparación de los datos de más de un gráfico, ya que los ejes no se desplazan ni se estiran dentro de una proximidad visual entre sí.
+  **Mínimo flexible y máximo flexible**: establezca una opción de mínimo flexible y máximo flexible para controlar mejor los límites del eje Y. De forma predeterminada, Grafana establece el intervalo del eje Y automáticamente en función del conjunto de datos.

  Los valores mínimos y máximos flexibles pueden evitar que los puntos se conviertan en montañas cuando los datos son en su mayoría sin formato, mientras que los valores mínimos o máximos fijos derivados de las opciones de campo mínimo y máximo estándar permiten evitar que los picos intermitentes dejen sin formato detalles útiles al recortar los picos más allá de un punto definido.

  Puede configurar min/max opciones estándar para definir los límites estrictos del eje Y.

# Panel de medidores de barras
<a name="alert-panel-bar-gauge-panel"></a>

****  
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 8.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.md).  
Para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).

El medidor de barras simplifica los datos al reducir todos los campos a un único valor. El usuario elige cómo Amazon Managed Grafana calcula la reducción.

En este panel se pueden mostrar uno o más indicadores de barras en función del número de series, filas o columnas que devuelva la consulta.

## Opciones de datos y campos
<a name="bar-gauge-data-and-field-options"></a>

Con las visualizaciones de los indicadores de barras, puede aplicar las siguientes opciones:
+  [Transformaciones](panel-transformations.md) 
+  [Opciones de campo y anulaciones](field-options-overrides.md) 
+  [Umbrales](thresholds.md) 

## Opciones de visualización
<a name="bar-gauge-display-options"></a>

Utilice las siguientes opciones para refinar la visualización:
+  **Mostrar**: elija cómo muestra Amazon Managed Grafana los datos.
  +  **Calcular**: muestre un valor calculado en función de todas las filas. Para ver una lista de los cálculos disponibles, consulte [Lista de cálculos](list-of-calculations.md).
  +  **Todos los valores**: muestre una estadística independiente para cada fila. Si selecciona esta opción, también puede seleccionar un **límite** o el número máximo de filas que se van a mostrar.
+  **Valor**: seleccione una función reductora que Amazon Managed Grafana utilizará para reducir muchos campos a un único valor. Seleccione la lista **Valores** para ver las funciones y las descripciones breves. 
+  **Orientación**: elija una dirección de apilamiento.
  +  **Automática**: Amazon Managed Grafana selecciona la orientación que cree que se ajusta mejor.
  +  **Horizontal**: las barras se estiran horizontalmente, de izquierda a derecha.
  +  **Vertical**: las barras se ajustan verticalmente, de arriba a abajo.
+  **Modo de visualización**: elija un modo de visualización.
  +  **Gradiente**: elija un nivel de umbral para definir un gradiente.
  +  **LCD retro**: muestre el indicador dividido en pequeñas celdas iluminadas o apagadas.
  +  **Básico**: utilice un solo color en función del umbral de coincidencia.
+  **Mostrar área vacía**: seleccione esta opción si desea renderizar la región vacía de las barras en gris oscuro. Esta opción no está disponible para el modo de visualización LCD retro.

# Panel Reloj
<a name="clock-panel"></a>

****  
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 8.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.md).  
Para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).

En el panel Reloj se muestra la hora actual o una cuenta atrás. Se actualiza cada segundo.
+ **Modo**: el valor predeterminado es **tiempo**. Si elige **cuenta atrás**, establezca la **fecha límite de la cuenta atrás** para iniciar la cuenta atrás.
+ **12 o 24 horas**: las opciones para mostrar la hora son el formato de 12 horas y el formato de 24 horas.
+ **Zona horaria**: las zonas horarias las proporciona la biblioteca de zonas horarias del momento. El valor predeterminado es la zona horaria del equipo.
+ **Fecha límite de la cuenta atrás**: especifique la hora y la fecha hasta las que desea hacer la cuenta atrás, si ha configurado el **modo** en **cuenta atrás**.
+ **Texto final de la cuenta atrás**: especifique el texto que se mostrará cuando finalice la cuenta atrás.
+ **Opciones de formato de fecha y hora**: personalice el tamaño, el peso y date/time el formato de la fuente. Si está mostrando una cuenta atrás y no quiere ver cómo se van reduciendo los segundos, cambie el formato de hora a `hh:mm` para el reloj de 24 horas o a `h:mm A` para el reloj de 12 horas. Para obtener una lista completa de opciones, consulte [Mostrar](https://momentjs.com/docs/#/displaying/).
+ **Color de fondo**: elija un color de fondo para el reloj.

# Panel de lista de paneles
<a name="dashboard-list-panel"></a>

****  
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 8.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.md).  
Para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).

En el panel de lista de paneles se muestran enlaces dinámicos a otros paneles. La lista se puede configurar para usar paneles de control destacados, paneles de control vistos recientemente, una consulta de búsqueda y etiquetas de panel de control.

Cada vez que se carga el panel, este panel consulta la lista de paneles y siempre proporciona la mayor cantidad de up-to-date resultados.

## Opciones
<a name="options-1"></a>

Utilice las siguientes opciones para refinar la visualización:
+  **Agregado a favoritos**: muestre los paneles de control destacados en orden alfabético.
+  **Vistos recientemente**: muestre los paneles de control vistos recientemente en orden alfabético.
+  **Buscar**: muestre los paneles de control por consulta o etiquetas. Esta opción requiere que ingrese al menos un valor en **Consulta** o **Etiquetas**.
+  **Mostrar encabezados**: muestre la selección de la lista elegida (Destacados, Vistos recientemente, Búsqueda) como un encabezado.
+  **Número máximo de elementos**: establezca el número máximo de elementos que se van a enumerar por sección. Por ejemplo, con el valor predeterminado de 10, si elige mostrar los paneles destacados y los vistos recientemente, el panel mostrará hasta 20 paneles en total, 10 en cada sección.

### Search
<a name="panel-dashboard-list-search"></a>

Las siguientes opciones solo se aplican si se selecciona la opción **Búsqueda**.
+  **Consulta**: ingrese la consulta que desee buscar. Las consultas no distinguen entre mayúsculas y minúsculas y se aceptan valores parciales.
+  **Carpeta**: seleccione las carpetas del panel de control que quiera mostrar.
+  **Etiquetas**: escriba las etiquetas que desee usar. Tenga en cuenta que las etiquetas existentes no aparecerán a medida que escriba y que las etiquetas *distinguen* entre mayúsculas y minúsculas.

**nota**  
Cuando aparecen varias etiquetas y cadenas, la lista del panel de control muestra las que cumplen *todas* las condiciones.

# Panel de medidores
<a name="gauge-panel"></a>

****  
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 8.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.md).  
Para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).

 El **indicador** es un panel de un solo valor que puede repetir un indicador para cada serie, columna o fila.

## Opciones de datos y campos
<a name="gauge-panel-data-and-field-options"></a>

Las visualizaciones de indicadores le permiten aplicar las siguientes opciones:
+  [Transformaciones](panel-transformations.md) 
+  [Opciones de campo y anulaciones](field-options-overrides.md) 
+  [Umbrales](thresholds.md) 

## Opciones de visualización
<a name="gauge-panel-display-options-2"></a>

Para refinar la visualización, utilice las siguientes opciones:
+  **Mostrar**: elija cómo muestra Amazon Managed Grafana los datos.
  +  **Calcular**: muestre un **valor** calculado en función de todas las filas. Para ver una lista de los cálculos disponibles, consulte [Lista de cálculos](list-of-calculations.md).
  +  **Todos los valores**: muestre una estadística independiente para cada fila. Si selecciona esta opción, también puede seleccionar un **límite** o el número máximo de filas que se van a mostrar.
+  **Orientación**: elija una dirección de apilamiento.
  +  **Automático**: Amazon Managed Grafana selecciona la que cree que es la mejor orientación.
  +  **Horizontal**: las barras se estiran horizontalmente, de izquierda a derecha.
  +  **Vertical**: las barras se ajustan verticalmente, de arriba a abajo.
+  **Mostrar etiquetas de umbral**: elija si desea mostrar los valores de umbral.
+  **Mostrar marcadores de umbral**: elija si desea mostrar una banda de umbral fuera de la banda de valores del indicador interior.

# Panel Geomapa
<a name="AMG-Geomap"></a>

****  
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 8.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.md).  
Para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).

La visualización del panel **Geomapa** le permite ver y personalizar el mapamundi con datos geoespaciales. Para centrarse fácilmente en las características importantes de los datos basadas en la ubicación, puede configurar varios estilos de superposición y ajustes de visualización del mapa.

## Capa de datos
<a name="Data-Layer"></a>

La capa de datos del complemento de geomapas determina cómo se visualizan los datos geoespaciales sobre el mapa base.

### Ubicación
<a name="Location"></a>

El panel **Geomapa** necesita un origen de datos geográficos. Estos datos provienen de una consulta a una base de datos y hay cuatro opciones de asignaciones para los datos.
+ **Automático** busca los datos de ubicación automáticamente. Utilice esta opción cuando la consulta se base en uno de los siguientes nombres para los campos de datos.
  + geohash: “geohash”
  + latitud: “latitude”, “lat”
  + longitud: “longitude”, “lng”, “lon”
  + búsqueda: “lookup”
+  **Coordenadas** especifica que la consulta contiene datos de coordenadas. Se le solicitará que seleccione campos de datos numéricos para la latitud y la longitud de la consulta de la base de datos.
+  La opción **Geohash** especifica que la consulta contiene datos de geohash. Se le pedirá que seleccione un campo de datos de cadena para el geohash de la consulta de la base de datos.
+  La opción **Búsqueda** especifica que la consulta contiene los datos del nombre de la ubicación que deben asignarse a un valor. Se le pedirá que seleccione el campo de búsqueda de la consulta de la base de datos y ` gazetteer`. ` gazetteer ` es el directorio que se utiliza para asignar los datos consultados a un punto geográfico.

## Capa de marcadores
<a name="Markers-Layer"></a>

La capa de **marcadores** le permite mostrar los puntos de datos en diferentes formas de marcadores, como círculos, cuadrados, triángulos o estrellas, entre otros.
+ La opción **Color del marcador** configura el color del marcador. El tamaño fijo predeterminado mantiene todos los puntos en un solo color. Hay una opción alternativa para tener varios colores en función de los valores de los puntos de datos y del umbral establecido en la sección **Umbrales**.
+  La opción **Tamaño del marcador** configura el tamaño del marcador. El valor predeterminado es ` Fixed size` y hace que todos los marcadores tengan el mismo tamaño independientemente de los puntos de datos. Sin embargo, también hay una opción para escalar los círculos a los puntos de datos correspondientes. El tamaño del marcador ` Min` y `Max ` debe configurarse de manera que la capa de marcadores pueda escalarse dentro de estos rangos.
+  La opción **Forma del marcador** le proporciona la flexibilidad de visualizar los puntos de datos de forma diferente.
  + Círculo
  + Square (Cuadrado)
  + Triángulo
  + Cruz
  + X
+  **Opacidad de relleno** configura la transparencia de cada marcador.

## Capa de mapa de calor
<a name="Heatmap-layer"></a>

La capa de **mapa de calor** agrupa varios puntos de datos para visualizar ubicaciones con diferentes densidades. Para agregar una capa de mapa de calor, en **Capa de datos**, seleccione **Mapa de calor**.



Al igual que con los **marcadores**, se le muestran opciones para determinar qué puntos de datos desea visualizar y cómo.
+ La opción **Valores de ponderación** configura la intensidad de los clústeres del mapa de calor. El valor fijo mantiene un valor de peso constante en todos los puntos de datos. Este valor debe estar en el intervalo comprendido entre 0 y 1. Al igual que con los **marcadores**, hay una opción alternativa en el menú desplegable para escalar automáticamente los valores de ponderación en función de los valores de los datos. 
+  **Radio** configura el tamaño de los clústeres del mapa de calor.
+  **Desenfoque** configura la cantidad de desenfoque en cada clúster.

# Panel de gráfico
<a name="graph-panel"></a>

****  
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 8.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.md).  
Para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).

Un panel de gráfico se puede representar como una línea, una trayectoria de puntos o una serie de barras. Este tipo de gráfico es lo bastante versátil como para mostrar casi cualquier dato de serie temporal.

## Opciones de datos y campos
<a name="graph-panel-data-and-field-options"></a>

Cuando usa las visualizaciones de gráficos, puede aplicar las siguientes opciones:
+  [Transformaciones](panel-transformations.md) 
+ Alertas. Este es el único tipo de visualización que permite configurar alertas. Para obtener más información, consulte [Alertas de Grafana](alerts-overview.md).
+  [Umbrales](thresholds.md) 

## Opciones de visualización
<a name="graph-panel-display-options"></a>

Para refinar la visualización, use estos ajustes:
+  **Barras**: muestre los valores como un gráfico de barras. 
+  **Líneas**: muestre los valores como un gráfico de líneas. 
+  **Ancho de línea**: especifique el ancho de la línea de una serie. El valor predeterminado de es 1.
+  **Escalera**: dibuje puntos adyacentes como escalera.
+  **Relleno de área**: especifique la cantidad de relleno de color para una serie. El valor predeterminado es 1; 0 es ninguno.
+  **Degradado de relleno**: especifique el grado de degradado del área de relleno. El valor predeterminado es 0, que no es degradado; 10 es un degradado pronunciado.
+  **Puntos**: muestre los puntos correspondientes a los valores. 
+  **Radio del punto**: controle el tamaño de los puntos.
+  **Umbrales de alerta**: muestre los umbrales de alerta y las regiones en el panel.

### Apilamiento y valor nulo
<a name="stacking-and-null-value"></a>
+  **Pila**: cada serie se apila sobre otra.
+  **Porcentaje**: cada serie se extrae como un porcentaje del total de todas las series. Esta opción está disponible cuando se selecciona **Pila**.
+  **Valor nulo**: especifique cómo se muestran los valores nulos. *Se trata de un ajuste importante.* Consulte la nota que se muestra a continuación.
  +  **conectado**: si hay un espacio en la serie, es decir, uno o más valores nulos, la línea omitirá el espacio y se conectará con el siguiente valor no nulo. 
  +  **nulo**: si hay un espacio en la serie, es decir, un valor nulo, la línea del gráfico se interrumpirá y mostrará el espacio. Esta es la configuración predeterminada.
  +  **nulo como cero**: si hay un espacio en la serie, es decir, un valor nulo, se mostrará como un valor cero en el panel del gráfico.

**importante**  
Si está supervisando la carga de la CPU de un servidor y la carga alcanza el 100 %, el servidor se bloqueará y el agente que envía las estadísticas no podrá recopilarlas. Esto provoca una brecha en las métricas y, si se utiliza la configuración *nulo* predeterminada, Amazon Managed Grafana mostrará las brechas e indicará que algo anda mal. Si está configurado como *conectado*, será fácil perder esta señal. 

### Información sobre herramientas emergente
<a name="graph-panel-hover-tooltip"></a>

Utilice estos ajustes para cambiar el aspecto de la información sobre herramientas que aparece cuando hace una pausa sobre la visualización de gráfico.
+  **Modo**: determina cuántas series se muestran en la información sobre herramientas situada al pasar el ratón.
  +  **Todas las series**: la información sobre herramientas muestra todas las series del gráfico. El espacio de trabajo de Grafana resalta las series sobre las que pasa el ratón en negrita en la lista de series de la información sobre herramientas.
  +  **Única**: la información sobre herramientas situada al pasar el ratón solo muestra una serie, aquella sobre la que se pausa en el gráfico.
+  **Orden de clasificación**: clasifica el orden de las series en la información sobre herramientas emergente si ha seleccionado el modo **Todas las series**. Cuando coloca el ratón en un gráfico, Amazon Managed Grafana muestra los valores asociados a las líneas. Por lo general, los usuarios están más interesados en los valores más altos o más bajos. Clasificar estos valores puede facilitar mucho la búsqueda de los datos que busca.
  +  **Ninguno**: el orden de las series de la información sobre herramientas emergente viene determinado por el orden de clasificación de la consulta. Por ejemplo, puede clasificar las series alfabéticamente por nombre de serie.
  +  **Creciente**: las series que aparecen en la información sobre herramientas emergente se ordenan por valor y en orden creciente, con el valor más bajo en la parte superior de la lista.
  +  **Decreciente**: las series que aparecen en la información sobre herramientas emergente se ordenan por valor y en orden decreciente, con el valor más alto en la parte superior de la lista.

## Anulaciones de series
<a name="graph-panel-series-overrides"></a>

Las anulaciones de series permiten renderizar una serie de un panel de gráficos de forma diferente a las demás. Puede personalizar las opciones de visualización por serie o mediante reglas de expresiones regulares. Por ejemplo, una serie puede tener un ancho de línea más grueso para que destaque o moverse hacia el eje Y derecho.

Puede agregar varias anulaciones de serie.

**Adición de una anulación de serie**

1. Elija **Agregar anulación de serie**.

1. En **Alias o expresiones regulares**, escriba o seleccione una serie. Seleccione el campo para ver una lista de las series disponibles.

   Por ejemplo, `/Network.*/` coincidiría con dos series denominadas `Network out` y `Network in`.

1. Seleccione **\$1** y, a continuación, seleccione un estilo para aplicarlo a la serie. Puede agregar varios estilos a cada entrada.
+  **Barras**: muestre la serie como un gráfico de barras. 
+  **Líneas**: muestre la serie como un gráfico de líneas. 
+  **Relleno de líneas**: muestre un gráfico de líneas con relleno de área. 
+  **Degradado de relleno**: especifique la cantidad de degradado del área de relleno.
+  **Ancho de línea**: establezca el ancho de línea.
+  **Modo de punto nulo**: utilice esta opción para ignorar los valores nulos o sustituirlos por cero. Esto es importante si quiere omitir las brechas en los datos.
+  **Rellenar abajo hasta**: rellene el área entre dos series.
+  **Línea de escalera**: muestre la serie como una línea de escalera.
+  **Rayas**: muestre una línea con rayas. 
+  **Serie oculta**: oculte la serie. 
+  **Longitud de raya**: establezca la longitud de las rayas de la línea.
+  **Espacio entre rayas**: establezca la longitud de los espacios entre las rayas de la línea.
+  **Puntos**: muestre las series como puntos separados.
+  **Radio del punto**: establezca el radio para la representación de puntos.
+  **Pila**: establezca el grupo de pilas para la serie.
+  **Color**: establezca el color de la serie.
+  **Eje Y**: defina el eje Y de la serie.
+  **Índice Z**: establezca el índice Z de la serie (orden de representación). Esta opción es importante cuando se superponen estilos diferentes, como gráficos de barras y gráficos de áreas.
+  Transformar: transforme el valor en negativo para representarlo por debajo del eje Y.
+  **Leyenda**: controle si una serie se muestra en la leyenda.
+  **Ocultar en la información sobre herramientas emergente**: controle si una serie se muestra en la información sobre herramientas emergente de un gráfico.

## Axes (Ejes)
<a name="graph-panel-axes"></a>

Utilice estas opciones para controlar la presentación de los ejes en la visualización.

### Y/Right Y izquierda
<a name="left-yright-y"></a>

Las opciones son idénticas para ambos ejes Y.
+  **Mostrar**: elija mostrar u ocultar el eje.
+  **Unidad**: seleccione la unidad de visualización para el valor Y.
+  **Escala**: elija la escala que desee utilizar para el valor Y: **lineal** o **logarítmica**. El valor predeterminado es **lineal**.
+  **Y-Min**: valor mínimo de Y. El valor predeterminado es **Automático**.
+  **Y-Max**: valor máximo de Y. El valor predeterminado es **Automático**.
+  **Decimales**: defina cuántos decimales se muestran para el valor Y. El valor predeterminado es **Automático**. 
+  **Etiqueta**: especifique la etiqueta del eje Y. El valor predeterminado es “",

### Ejes Y
<a name="y-axes"></a>
+  **Alinear**: alinee los ejes Y izquierdo y derecho por valor. El valor predeterminado es sin marcar o falso.
+  **Nivel**: ingrese el valor que se utilizará para alinear los ejes Y izquierdo y derecho, empezando por Y=0. El valor predeterminado es 0. Esta opción está disponible cuando se selecciona la opción **Alinear**. 

### Eje X
<a name="x-axis"></a>
+  **Mostrar**: elija mostrar u ocultar el eje.
+  **Modo**: el modo de visualización cambia por completo la visualización del panel de gráficos. Es como tres paneles en uno. El modo principal es el modo de series temporales con el tiempo en el eje X. Los otros dos modos son un modo de gráfico de barras básico con series en el eje X en lugar del tiempo y un modo de histograma.
  +  **Tiempo** (predeterminado): el eje X representa el tiempo y los datos se agrupan por tiempo (por ejemplo, por hora o por minuto).
  +  **Serie**: los datos se agrupan por series y no por tiempo. El eje Y sigue representando el valor.
    +  **Valor**: este es el tipo de agregación que se utilizará para los valores. El valor predeterminado es **total** (suma los valores).
  +  **Histograma**: esta opción convierte el gráfico en un histograma. Un histograma es un tipo de gráfico de barras que agrupa los números en rangos, que suelen denominarse buckets o contenedores. Las barras más altas muestran que hay más datos dentro de ese rango.

    Para obtener más información acerca de los histogramas, consulte [Introducción a los histogramas y los mapas térmicos](getting-started-grafanaui.md#introduction-to-histograms-and-heatmaps).
    +  **Buckets**: establece el número de buckets en los que se agruparán los valores. Si el valor se deja en blanco, Amazon Managed Grafana intentará calcular un número adecuado de buckets.
    +  **X-Min**: filtra los valores del histograma que están por debajo de este límite mínimo.
    +  **X-Max**: filtra los valores que superan este límite máximo.

## Leyenda
<a name="graph-panel-legend"></a>

Use esta configuración para refinar la forma en que aparece la leyenda en la visualización.

### Opciones
<a name="graph-panel-legends-options"></a>
+  **Mostrar**: desactive esta opción para ocultar la leyenda. El valor predeterminado está seleccionado (verdadero).
+  **Como tabla**: seleccione esta opción para mostrar la leyenda en la tabla. El valor predeterminado está marcado (verdadero).
+  **A la derecha**: seleccione esta opción para mostrar la leyenda a la derecha.
+  Ancho: ingrese el ancho mínimo de la leyenda en píxeles. Esta opción está disponible cuando se selecciona la opción **A la derecha**.

### Valores
<a name="graph-panel-values"></a>

Se pueden mostrar valores adicionales junto a los nombres de las leyendas.
+  **Mín.**: valor mínimo que devuelve la consulta de métricas.
+  **Máx.**: valor máximo que devuelve la consulta de métricas.
+  **Promedio**: valor promedio que devuelve la consulta de métricas.
+  **Actual**: último valor que devuelve la consulta de métricas.
+  **Total**: suma de todos los valores que devuelve la consulta de métricas.
+  **Decimales**: cuántos decimales se muestran para los valores de las leyendas y la información sobre herramientas al pasar el ratón sobre el gráfico.

Amazon Managed Grafana calcula los valores de las leyendas del cliente. Estos valores de leyenda dependen del tipo de agregación o consolidación de puntos que use la consulta de métricas. Todos los valores de la leyenda anterior no pueden ser correctos simultáneamente.

Por ejemplo, si crea una gráfica de una tasa de solicitudes por segundo, que probablemente use el promedio como agregador, el total de la leyenda no representará el número total de solicitudes. Es solo la suma de todos los puntos de datos que recibe Amazon Managed Grafana. 

### Ocultación de series
<a name="graph-panel-hide-series"></a>

Oculte las series cuando todos los valores de una serie de una consulta de métricas tengan un valor específico.
+  **Solo con valores nulos**: valor=nulo (sin marcar de forma predeterminada)
+  **Solo con ceros**: valor=cero (sin marcar de forma predeterminada)

### Regiones horarias
<a name="graph-panel-time-regions"></a>

Puede resaltar regiones horarias específicas en el gráfico para facilitar su visualización, por ejemplo, los fines de semana, el horario laboral y el horario no laboral. Todas las regiones horarias configuradas hacen referencia a la hora UTC.

# Mapa de calor
<a name="visualization-heatmap"></a>

****  
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 8.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.md).  
Para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).

La visualización del panel de mapa de calor le permite ver los histogramas a lo largo del tiempo. Para obtener más información acerca de los histogramas, consulte [Introducción a los histogramas y los mapas térmicos](getting-started-grafanaui.md#introduction-to-histograms-and-heatmaps).

## Opciones de los ejes
<a name="heatmap-axes-options"></a>

Use esta configuración para ajustar cómo se muestran los ejes en la visualización.

### Eje Y
<a name="heatmap-y-axis"></a>
+  **Unidad**: unidad de visualización del valor del eje Y
+  **Escala**: escala que se usará para el valor del eje Y
  +  **Lineal**: escala lineal 
  +  **log (base 2)**: escala logarítmica con base 2
  +  **log (base 10)**: escala logarítmica con base 10
  +  **log (base 32)**: escala logarítmica con base 32
  +  **log (base 1024)**: escala logarítmica con base 1024
+  **Y-Min**: valor mínimo de Y (el valor predeterminado es Automático)
+  **Y-Max**: valor máximo de Y (el valor predeterminado es Automático)
+  **Decimales**: número de decimales con los que se renderizarán los valores del eje Y (el valor predeterminado es auto)

### Buckets
<a name="heatmap-buckets"></a>

**nota**  
Si el formato de datos es **Buckets de series temporales**, esta sección no estará disponible.
+  **Buckets del eje Y**: número de buckets en los que se dividirá el eje Y.
+  **Tamaño**: tamaño de cada bucket del eje Y (visible solo si la **escala** es *lineal*). Esta opción tiene prioridad sobre los **buckets del eje Y**.
+  **Factor de división**: (solo visible si la **escala** es *log (base 2)* o superior). De forma predeterminada, Amazon Managed Grafana divide los valores de Y por base logarítmica. Con esta opción, puede dividir cada bucket predeterminado en el número especificado de buckets.
+  **Buckets del eje X**: número de buckets en los que se dividirá el eje X.
+  **Tamaño**: tamaño de cada bucket del eje X. Número o intervalo de tiempo (10 s, 5 min, 1 h, etc.). Intervalos admitidos: ms, s, min, h, d, s, m, a. Esta opción tiene prioridad sobre los **buckets del eje X**.

#### Límite del bucket
<a name="heatmap-bucket-bound"></a>

Cuando el formato de datos son buckets de series temporales, el origen de datos devuelve series con nombres que representan el límite de los buckets. Sin embargo, en función del origen de datos, el límite puede ser superior o inferior. Puede usar esta opción para ajustar un tipo de límite. Si se establece **Automático**, se elige una opción de límite en función del tipo de origen de datos de los paneles.

#### Tamaño del bucket
<a name="heatmap-bucket-size"></a>

Amazon Managed Grafana usa las opciones de número y tamaño de los buckets para calcular el tamaño de cada celda del mapa de calor. Puede definir el tamaño del bucket mediante el recuento (primer cuadro de entrada) o si especifica un intervalo de tamaño. Para el eje Y, el intervalo de tamaño es solo un valor. Para el bucket de X, puede especificar un intervalo de tiempo en la entrada **Tamaño**. Por ejemplo, puede establecer el intervalo de tiempo en `1h`. Esto hará que las celdas tengan 1 h de ancho en el eje X.

#### Formato de los datos
<a name="heatmap-data-format"></a>

Elija una opción de la lista **Formato**.
+ **Series temporales**: Amazon Managed Grafana lleva a cabo la asignación de buckets mediante el análisis de todos los valores de las series temporales. Los tamaños e intervalos de los buckets se establecen en las opciones de los **buckets**.
+ **Buckets de series temporales**: cada serie temporal ya representa un bucket en el eje Y. El nombre de la serie temporal (alias) debe ser un valor numérico que represente el intervalo superior o inferior del bucket. El espacio de trabajo de Grafana no asigna buckets, por lo que las opciones de tamaño de los buckets están ocultas.

## Opciones de visualización
<a name="heatmap-display-options"></a>

Use estos ajustes para ajustar la visualización.

### Colores
<a name="heatmap-colors"></a>

El espectro de colores controla la asignación entre el recuento de valores (en cada bucket) y el color asignado a cada bucket. El color más a la izquierda del espectro representa el recuento mínimo y el color del lado más a la derecha representa el recuento máximo. Algunas combinaciones de colores se invierten automáticamente cuando se utiliza el tema de la luz.

También puede cambiar el modo de color a **Opacidad**. En este caso, el color no cambiará, pero la cantidad de opacidad cambiará con el número de buckets.
+  **Mode (Modo)** 
  +  **Opacidad**: valor del bucket representado por la opacidad de la celda. La celda opaca corresponde al valor máximo.
    +  **Color**: color base de la celda.
    +  **Escala**: escala para asignar los valores del bucket a la opacidad.
      +  **Lineal**: escala lineal. El valor del bucket se asigna linealmente a la opacidad.
      +  **sqrt**: escala de potencia. La opacidad de la celda se calcula como `value ^ k`, donde `k` es un valor **exponencial** configurado. Si el exponente es menor que `1`, obtendrá una escala logarítmica. Si el exponente es mayor que `1`, obtendrá una escala exponencial. En caso de que sea `1`, la escala será la misma que la lineal.
    +  **Exponente**: valor del exponente, mayor que `0`.
  +  **espectro**: el valor del bucket se representa mediante el color de la celda.
    +  **Esquema**: si el modo es **Espectro**, seleccione un esquema de color.

### Escala de color
<a name="heatmap-color-scale"></a>

De forma predeterminada, Amazon Managed Grafana calcula los colores de las celdas en función de los valores mínimos y máximos de los buckets. Con **Mín.** y **Máx.** puede sobrescribir esos valores. Considere el valor de un bucket como el eje Z y el mínimo y el máximo como Z-Min y Z-Max, respectivamente.
+  **Mín.**: valor mínimo que se usa para calcular el color de las celdas. Si el valor del bucket es inferior al mínimo, se asigna al color mínimo. El valor predeterminado es `series min value`.
+  **Máx.**: valor máximo que se usa para calcular el color de las celdas. Si el valor del bucket es superior al máximo, se asigna al color máximo. El valor predeterminado es `series max value`. 

### Leyenda
<a name="heatmap-legend"></a>

Elija si desea mostrar la leyenda del mapa de calor en la visualización o no. 

### Buckets
<a name="heatmap-legend-buckets"></a>
+  **Ocultar cero**: no se dibujan celdas con valores cero.
+  **Espacio**: defina el espacio entre las celdas en píxeles. El valor predeterminado es 1 píxel.
+  **Redondear**: establece el redondeo de la celda en píxeles. El valor predeterminado es 0.

### Ayuda contextual
<a name="heatmap-tooltip"></a>
+  **Mostrar ayuda contextual**: muestra información sobre herramientas del mapa de calor.
+  **Histograma**: muestra el histograma del eje Y en la ayuda contextual. Un histograma representa la distribución de los valores del bucket para una marca de tiempo específica.
+  **Decimales**: permite definir el número de decimales con los que se renderizarán los valores del bucket (el valor predeterminado es auto).

# Panel de histogramas
<a name="histogram-panel"></a>

****  
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 8.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.md).  
Para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).

La visualización del histograma calcula la distribución de los valores y los presenta como un gráfico de barras. El eje Y y la altura de cada barra representan el recuento de valores que se incluyen en cada paréntesis, mientras que el eje X representa el intervalo de valores.

La visualización de histogramas admite series temporales y cualquier resultado de tabla con uno o más campos numéricos.

## Opciones de visualización
<a name="histogram-options"></a>

Utilice estas opciones para refinar las visualizaciones:

**Tamaño del bucket**

El tamaño de los buckets. Déjelo vacío para ajustar automáticamente el tamaño de los buckets (aproximadamente el 10 % del intervalo completo).

**Desplazamiento del bucket**

Si el primer bucket no debe empezar en cero. Un desplazamiento distinto de cero desplaza el plazo de agregación. Por ejemplo, los buckets de tamaño 5 que son 0–5, 5–10, 10–15 con un desplazamiento predeterminado de 0 pasarían a ser 2–7, 7–12, 12–17 con un desplazamiento de 2; los desplazamientos de 0, 5 o 10, en este caso, no servirían de nada. Por lo general, esta opción se utilizaría con un tamaño de bucket definido de forma explícita y no de forma automática. Para que esta configuración se aplique, la cantidad de compensación debe ser superior a 0 e inferior al tamaño del bucket; los valores fuera de este intervalo tendrán el mismo efecto que los valores dentro de este intervalo.

**Combinación de series**

Esto combinará todas las series y campos en un histograma combinado.

**Ancho de línea**: controla el ancho de línea de las barras.

**Opacidad de relleno**: controla la opacidad de relleno de las barras.

**Modo de degradado** establece el modo del relleno de degradado. El degradado de relleno se basa en el color de la línea. Para cambiar el color, utilice la opción de campo de combinación de colores estándar. El aspecto del degradado depende de la configuración Opacidad de relleno.
+  **Ninguno**: sin relleno de degradado; esta es la configuración predeterminada.
+  **Opacidad**: la transparencia del degradado se calcula en función de los valores del eje Y. La opacidad del relleno aumenta con los valores del eje Y.
+  **Tonalidad**: el color del degradado se genera en función de la tonalidad del color de la línea.

**Modo de información sobre herramientas**: al pasar el cursor sobre el gráfico, Grafana puede mostrar información sobre herramientas. Elija cómo se comporta la información sobre herramientas:
+  **Única**: la información sobre herramientas situada al pasar el ratón solo muestra las series sobre las que está pasando el ratón.
+  **Todo**: la información sobre herramientas que aparece al pasar el ratón muestra todas las series de la visualización. Grafana resalta las series sobre las que pasa el ratón en negrita en la lista de series de la información sobre herramientas.
+  **Oculta**: no muestra la información sobre herramientas. 

**nota**  
Use una anulación para ocultar series individuales de la información sobre herramientas.

## Opciones de leyenda
<a name="histogram-legend"></a>

Cuando la opción de leyenda está habilitada, puede mostrar las asignaciones de valores o los corchetes de umbral. Para mostrar las asignaciones de valores en la leyenda, es importante que la opción Combinación de colores de Opciones estándar esté establecida en Color único o Paleta clásica. Para ver los corchetes de los umbrales en la leyenda, establezca Combinación de colores en A partir de umbrales.

**Modo de leyenda**: utilice esta configuración para refinar la forma en que aparece la leyenda en la visualización.
+  **Lista**: muestra la leyenda como una lista. Este es el modo de visualización predeterminado de la leyenda.
+  **Tabla**: muestra la leyenda como una tabla.
+  **Oculta**: oculta la leyenda.

**Ubicación de la leyenda**: elija dónde colocar la leyenda.
+  **Parte inferior**: debajo del gráfico.
+  **Derecha**: a la derecha del gráfico.

**Cálculos de la leyenda**

Elija los cálculos que desee mostrar en la leyenda. Para obtener más información, consulte [Lista de cálculos](list-of-calculations.md).

# Panel de registros
<a name="logs-panel"></a>

****  
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 8.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.md).  
Para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).

En la visualización del panel de registros se muestran líneas de registro de orígenes de datos que admiten registros, como Elastic, Influx y Loki. Por lo general, usaría este panel junto a un panel de gráficos para mostrar la salida del registro de un proceso relacionado.

El panel de registros muestra el resultado de las consultas que se ingresaron en la pestaña **Consulta**. Los resultados de varias consultas se combinan y se ordenan por tiempo. Puede desplazarse por el panel si el origen de datos devuelve más líneas de las que se pueden mostrar.

Para limitar el número de líneas renderizadas, puede utilizar la configuración **Máximo de puntos de datos** en **Opciones de consulta**. Si no está establecido, el origen de datos normalmente aplicará un límite predeterminado.

## Opciones de visualización
<a name="logs-panel-display-options"></a>

Use estos ajustes para refinar la visualización:
+  **Tiempo**: muestre u oculte la columna de tiempo. Esta es la marca de tiempo asociada a la línea de registro tal como se indica en el origen de datos.
+  **Etiquetas únicas**: muestre u oculte la columna de etiquetas únicas, que muestra solo las etiquetas no comunes.
+  **Ajustar líneas**: active o desactive el ajuste de líneas. 
+  **Orden**: muestre los resultados en orden temporal descendente o ascendente. El valor predeterminado es **Descendente**, que muestra primero los registros más recientes. Establézcalo en **Ascendente** para mostrar primero las líneas de registro más antiguas.

# Panel de noticias
<a name="news-panel"></a>

****  
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 8.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.md).  
Para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).

En este panel se muestra una fuente RSS. De forma predeterminada, se muestran artículos del blog de Grafana Labs.

En la sección **Mostrar**, en el campo **URL**, ingrese la URL de una fuente RSS. Este tipo de panel no acepta ninguna otra consulta.

# Panel de gráficos de nodos (beta)
<a name="node-graph-panel"></a>

****  
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 8.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.md).  
Para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).

En el panel de gráficos de nodos puede visualizar gráficos o redes dirigidos. Utiliza un diseño de fuerza dirigida para posicionar los nodos de manera eficaz, de modo que puedan ayudar a mostrar mapas de infraestructura complejos, jerarquías o diagramas de ejecución.

## Requisitos de datos
<a name="node-graph-panel-requirements"></a>

Un panel de gráficos de nodos requiere una forma específica de los datos para poder mostrar sus nodos y bordes. No todos los orígenes de datos o consultas se pueden visualizar en este panel.

La visualización de los gráficos de nodos consta de *nodos* y *bordes*.
+ Un *nodo* se muestra como un círculo. Un nodo puede representar una aplicación, un servicio o cualquier otra cosa que sea pertinente desde la perspectiva de la aplicación.
+ Un *borde* se muestra como una línea que conecta dos nodos. La conexión puede ser una solicitud, una ejecución o alguna otra relación entre los dos nodos.

## Nodos
<a name="node-graph-panel-nodes"></a>

Por lo general, los nodos muestran dos valores estadísticos dentro del nodo y dos identificadores justo debajo del nodo, normalmente el nombre y el tipo. Los nodos también pueden mostrar otro conjunto de valores como un círculo de color alrededor del nodo, con secciones de diferentes colores que representan valores diferentes que deben sumar 1. Por ejemplo, puede hacer que el porcentaje de errores se represente mediante una parte roja del círculo.

Se pueden mostrar detalles adicionales en un menú contextual, que se muestra al seleccionar el nodo. También puede haber enlaces adicionales en el menú contextual que pueden dirigirse a otras partes del espacio de trabajo de Grafana o a cualquier enlace externo.

## Periferias
<a name="node-graph-panel-edges"></a>

Los bordes también pueden mostrar estadísticas al pasar el ratón por encima del borde. Al igual que en los nodos, puede abrir un menú contextual con detalles y enlaces adicionales si selecciona el borde.

La primera fuente de datos que admite esta visualización es la fuente de AWS X-Ray datos de su función de mapa de servicio. Para obtener más información, consulte [Conectarse a una fuente AWS X-Ray de datos](x-ray-data-source.md).

Se pueden mostrar detalles adicionales en un menú contextual, que se muestra al seleccionar el nodo. También puede haber enlaces adicionales en el menú contextual que pueden dirigirse a otras partes del espacio de trabajo de Grafana o a cualquier enlace externo.

## Navegación por el gráfico de nodos
<a name="node-graph-panel-navigation"></a>

Para desplazarse por el gráfico de nodos, seleccione la parte exterior de cualquier nodo o borde y arrastre el ratón.

Para hacer zoom, utilice los botones de la esquina superior izquierda del gráfico de nodos.

# Panel de gráfico circular
<a name="pie-chart-panel"></a>

****  
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 8.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.md).  
Para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).

El gráfico circular muestra series reducidas, o valores de una serie, de una o más consultas, en la medida en que se relacionan entre sí, como porciones de un círculo. La longitud del arco, el área y el ángulo central de una porción son proporcionales al valor del segmento, ya que se relacionan con la suma de todos los valores. Este tipo de gráfico se utiliza mejor cuando se desea hacer una comparación rápida de un conjunto pequeño de valores en un formato atractivo desde el punto de vista estético.

Las visualizaciones de gráfico circular le permiten aplicar las siguientes opciones:
+  [Transformaciones](panel-transformations.md). 
+  [Opciones de campo y anulaciones](field-options-overrides.md). 
+  [Umbrales](thresholds.md).

## Opciones
<a name="pie-chart-panel-options"></a>

Puede usar las siguientes opciones para ajustar la visualización.
+  **Mostrar**: elija la cantidad de información que desea mostrar. **Calcular**: reduce cada valor a un único valor por serie. **Todos los valores**: muestra todos los valores de una sola serie.
+  **Cálculo**: seleccione un cálculo para reducir cada serie cuando haya seleccionado **Calcular**. Para obtener más información acerca de los cálculos disponibles, consulte [Lista de cálculos](list-of-calculations.md).
+  **Límite**: al mostrar todos los valores de una sola serie, esto limita el número de valores mostrados.
+  **Campos**: seleccione los campos que se mostrarán en la visualización.
  + **Campos numéricos**: todos los campos con valores numéricos.
  + **Todos los campos**: todos los campos que no se eliminan mediante transformaciones.
  + **Tiempo**: todos los campos con valores de tiempo.

## Etiquetas
<a name="pie-charts-panel-labels"></a>

Seleccione las etiquetas para mostrarlas en el gráfico circular. Puede seleccionar más de uno.
+  **Nombre**: el nombre de la serie o del campo. 
+  **Porcentaje**: el porcentaje del total. 
+  **Valor**: el valor numérico sin procesar. 

Las etiquetas se muestran en blanco sobre el cuerpo del gráfico. Es posible que deba seleccionar colores de gráficos más oscuros para hacerlos más visibles. Es posible que los nombres o números largos estén recortados.

## Ubicación y valores de las leyendas
<a name="pie-charts-panel-legend"></a>

Elija dónde mostrar la leyenda.
+  **Abajo**: debajo del gráfico.
+  **Derecha**: a la derecha del gráfico. 

Puede seleccionar más de un valor para mostrarlos en la leyenda. **Porcentaje** es el porcentaje del total y **Valor** es el valor numérico sin procesar.

# Panel de Plotly
<a name="plotly-panel"></a>

****  
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 8.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.md).  
Para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).

El panel de Plotly renderiza los gráficos con [Plotly](https://plotly.com/javascript/), una biblioteca de gráficos de código abierto en JavaScript.

Los campos **Datos**, **Diseño** y **Configuración** coinciden con los parámetros comunes descritos en la [documentación de Plotly](https://plotly.com/javascript/plotlyjs-function-reference/). Deben estar en formato JSON.

Los datos proporcionados por el origen de datos se pueden transformar mediante un script definido por el usuario antes de insertarlos en el gráfico de Plotly. El script incluye 2 argumentos.
+ `data`: datos devueltos por el origen de datos.
+ `variables`: un objeto que contiene [variables de Grafana](templates-and-variables.md) en el panel de control actual (variables de usuario y estas pocas variables globales: `__from`, `__to`, `__interval` y`__interval_ms`).

El script debe devolver un objeto con una o más de las siguientes propiedades: `data`, `layout`, `config` y `frames`. A continuación se muestra un ejemplo.

```
let x = data.series[0].fields[0].values;
let y = data.series[0].fields[1].values;
let series = {
    x: x,
    y: y,
    name: variables.name, // where ‘name’ is the name of a Grafana dashboard variable
};

return {
    data: [series],
    config: {
        displayModeBar: false,
    },
};
```

El objeto devuelto por el script y el JSON proporcionado en los campos *Datos*, *Diseño* y *Configuración* se fusionarán (fusión profunda).

Si no se proporciona ningún script, el panel utilizará únicamente los campos *Datos*, *Diseño* y *Configuración*.

# Panel de Sankey
<a name="sankey-panel"></a>

****  
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 8.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.md).  
Para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).

En el panel de Sankey se muestran los diagramas de Sankey, que son buenos para visualizar los datos de flujo, siendo el ancho del flujo proporcional a la métrica seleccionada. En la siguiente imagen se muestra un diagrama de Sankey con dos grupos de origen y destino.

![\[Sankey diagram showing flow between source organizations, science disciplines, and projects.\]](http://docs.aws.amazon.com/es_es/grafana/latest/userguide/images/sankey-panel.png)


**Cómo funciona**

El panel de Sankey requiere al menos 2 columnas de datos, un origen y un destino para los flujos. La consulta debe agrupar los datos en al menos dos grupos. El panel dibujará enlaces desde la primera columna de puntos de datos hasta la última según el orden de la consulta. El grosor de los enlaces será proporcional al valor asignado por la métrica de la consulta.

**Personalización**
+ **Enlaces**: actualmente hay dos opciones para el color de los enlaces: múltiples o único. De forma predeterminada, es multicolor. Para elegir un solo color para los enlaces, active la opción **Solo color de enlace único** y elija su color en el selector de colores de Grafana.
+ **Nodos**: para cambiar el color de los nodos rectangulares, puede cambiar la opción **Color de los nodos**
+ **Ancho de nodo**: el ancho de los nodos se puede ajustar con el control deslizante **Ancho de nodo** o si se ingresa un número en el cuadro de entrada. Este número debe ser un número entero.
+ **Relleno de nodos**: el relleno vertical entre los nodos se puede ajustar con el control deslizante **Relleno de nodos** o si se ingresa un número en el cuadro de entrada. Este número debe ser un número entero. Si sus enlaces son demasiado delgados, intente ajustar este número
+ **Encabezados**: los encabezados de las columnas se pueden cambiar si se sustituye el **Nombre de visualización** en el panel del editor. Serán del mismo color que elija para **Color del texto**.
+ **Diseño de Sankey**: el diseño de los enlaces de Sankey se puede ajustar ligeramente con el control deslizante **Iteración de diseño**. Este número debe ser un número entero y es el número de iteraciones de relajación utilizadas para generar el diseño.

# Panel Dispersión
<a name="scatter-panel"></a>

****  
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 8.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.md).  
Para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).

El panel de dispersión muestra un X/Y diagrama de dispersión para datos de tablas con una interfaz más sencilla que otros paneles gráficos. A diferencia del panel gráfico, el panel de dispersión no requiere que los datos estén en una serie temporal. El panel de dispersión requiere un conjunto de datos con formato de tabla con dos o más columnas numéricas de datos.

Una de ellas se puede asignar al eje X. Se pueden asignar uno o más valores a una serie de valores del eje Y y los datos resultantes se pueden trazar como una serie de puntos. Opcionalmente, cada serie también puede mostrar una línea de regresión con uno de varios ajustes estadísticos óptimos.

**Creación de un panel de dispersión**

En el siguiente procedimiento se describe cómo crear un trazado de dispersión mediante un panel de dispersión. Para este ejemplo, asumiremos que hay datos, como en la siguiente tabla, denominada `HEIGHT` con tres columnas de valores numéricos (`Age`, `Boys` y `Girls`), que muestran la estatura media de niños y niñas por edad.


| Antigüedad | Altura de un niño | Altura de una niña | 
| --- | --- | --- | 
|  5  |  109.7  |  109,5  | 
|  6  |  115,6  |  115,4  | 
|  7  |  121.1  |  120,8  | 
|  8  |  126.3  |  126  | 
|  9  |  131.3  |  131.3  | 
|  10  |  136.2  |  137,1  | 
|  11  |  141.2  |  143.2  | 
|  12  |  147  |  148,7  | 
|  13  |  153.6  |  152.6  | 
|  14  |  159,9  |  155,1  | 
|  15  |  164,4  |  156,7  | 
|  16  |  167,3  |  157,6  | 
|  17  |  169  |  158  | 
|  18  |  170  |  158,3  | 
|  19  |  170,8  |  158,6  | 

**Creación de un trazado de dispersión con el panel de dispersión**

1. En el panel de control de Grafana, seleccione **Agregar panel**. Para obtener más información acerca de cómo agregar paneles, consulte [Cómo agregar un panel](add-a-panel-to-a-dashboard.md).

1. Para la consulta, escriba una consulta que devuelva los datos necesarios. En tal caso, tendría que utilizar una consulta como `SELECT * FROM HEIGHT`.

1. Seleccione la visualización **Dispersión**.

Esto creará un trazado de dispersión con la primera columna como eje X y las demás columnas numéricas como ejes Y.

**Opciones de configuración**

El panel de dispersión ofrece las siguientes cuatro opciones de configuración personalizadas.
+ **Eje X**: puede elegir qué campo usar como eje X, así como la extensión y el título, y mostrar la información del eje.
+ **Eje Y**: puede elegir qué campos mostrar en el eje Y, incluidas las opciones de visualización de cada campo y la información de extensión y título del eje. También puede optar por mostrar una línea de regresión para cada campo. Consulte la siguiente información para obtener más detalles sobre la configuración de la línea de regresión.
+ **Leyenda**: puede activar o desactivar una leyenda para el panel, así como elegir el tamaño del texto de la leyenda.
+ **Visualización**: puede configurar otras opciones para el gráfico, como el color de la cuadrícula y el estilo del borde.

**Configuración de la línea de regresión**

Cada conjunto de datos del eje Y puede mostrar una línea, además de los puntos individuales. Hay cinco opciones para el tipo de línea.
+ **Ninguna**: no muestra una línea de regresión.
+ **Sencilla**: muestra una línea de regresión que conecta los puntos del conjunto de datos.
+ **Lineal**: muestra una línea recta mediante el método de mínimos cuadrados y mejor ajuste.
+ **Exponencial**: muestra una línea de regresión exponencial de mejor ajuste.
+ **Potencia**: muestra una línea de regresión de potencia de mejor ajuste.

# Panel de estadísticas
<a name="stat-panel"></a>

****  
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 8.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.md).  
Para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).

El panel de estadísticas muestra un valor estadístico grande con un minigráfico opcional. Puede controlar el color del fondo o del valor mediante umbrales.

De forma predeterminada, el panel de estadísticas muestra una de las siguientes pantallas:
+ Solo el valor de una sola serie o campo.
+ El valor y el nombre de varias series o campos.

Puede utilizar la opción **Modo de texto** para controlar si el texto se muestra o no.

## Opciones de datos y campos
<a name="stat-panel-data-and-field-options"></a>

Las visualizaciones de estadísticas le permiten aplicar las siguientes opciones:
+  [Transformaciones](panel-transformations.md).
+  [Opciones de campo y anulaciones](field-options-overrides.md).
+  [Umbrales](thresholds.md).

## Ajuste de diseño automático
<a name="stat-panel-automatic-layout-adjustment"></a>

El panel ajusta automáticamente el diseño en función de la anchura y la altura disponibles en el panel. Oculta automáticamente el gráfico (minigráfico) si el panel se vuelve demasiado pequeño.

## Opciones de visualización
<a name="stat-panel-display-options"></a>

Utilice las siguientes opciones para refinar la visualización:
+  **Mostrar**: elija cómo muestra Amazon Managed Grafana los datos.
  +  **Calcular**: muestre un valor calculado en función de todas las filas.
    +  **Cálculo**: seleccione un cálculo que desea aplicar. Para obtener más información acerca de los cálculos disponibles, consulte [Lista de cálculos](list-of-calculations.md).
  +  **Todos los valores**: muestra una estadística independiente para cada fila.
    +  **Límite**: especifique el número máximo de filas que se van a mostrar.
+  **Campos**: seleccione un nombre de campo o un tipo de campo (como **Todos los campos** o **Campos numéricos**) para incluirlos en este panel.
+  **Valor**: seleccione una función reductora que Amazon Managed Grafana utilizará para reducir muchos campos a un único valor. Seleccione la lista **Valores** para ver las funciones y las descripciones breves. 
+  **Orientación**: elija una dirección de apilamiento.
  +  **Automático**: Amazon Managed Grafana selecciona la que cree que es la mejor orientación.
  +  **Horizontal**: las barras se estiran horizontalmente, de izquierda a derecha.
  +  **Vertical**: las barras se ajustan verticalmente, de arriba a abajo.
+  **Modo de texto**: puede utilizar la opción **Modo de texto** para controlar el texto que muestra el panel. Si solo el nombre y el color son importantes y el valor no, cambie la opción **Modo de texto** a **Nombre**. El valor se sigue utilizando para determinar el color y se muestra en la información sobre herramientas.
  +  **Automático**: si los datos contienen varias series o campos, muestre el nombre y el valor.
  +  **Valor**: muestra solo el valor, nunca el nombre. El nombre se muestra en la información sobre herramientas.
  +  **Valor y nombre**: muestra siempre el valor y el nombre.
  +  **Nombre**: muestre el nombre en lugar del valor. El valor se muestra en la información sobre herramientas.
  +  **Ninguno**: no muestre nada (vacío). El nombre y el valor se muestran en la información sobre herramientas.
+  **Modo de color**: elija un modo de color.
  +  **Valor**: colorea solo el valor y el área del gráfico.
  +  **Fondo**: también colorea el fondo.
+  **Modo de gráfico**: elija un modo de gráfico.
  +  **Ninguno**: oculta el gráfico y muestra solo el valor.
  +  **Área**: muestra el gráfico de área por debajo del valor. Esta opción requiere que la consulta devuelva una columna de tiempo.
+  **Modo de alineación**: elija un modo de alineación.
  +  **Automático**: si solo se muestra un valor (sin repetición), el valor se centra. Si se muestran varias series o filas, el valor se alinea a la izquierda.
  +  **Centro**: el valor estadístico está centrado.

# Panel de escala de tiempo de estado
<a name="state-timeline-panel"></a>

****  
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 8.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.md).  
Para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).

La visualización del panel de escala de tiempo de estados muestra cambios de estado discretos a lo largo del tiempo. Cada campo o serie se representa como una banda horizontal única. Las regiones de estado se pueden representar con o sin valores. Este panel funciona bien con estados booleanos o de cadena, pero también se puede utilizar con series temporales. Cuando se utilizan con series temporales, los umbrales se utilizan para convertir los valores numéricos en regiones de estado discretas.

## Opciones de escala de tiempo de estado
<a name="state-timeline-options"></a>

Utilice estas opciones para refinar las visualizaciones:

**Combinación de valores consecutivos iguales**

Controla si Grafana combina valores idénticos si están uno al lado del otro.

**Mostrar valores**

Controla si los valores se representan dentro de las regiones del estado. Representará automáticamente los valores si hay suficiente espacio.

**Alineación de valores**

Controla la alineación de los valores dentro de las regiones del estado.

**Altura de fila**

Controla el espacio entre las filas. 1 = sin espacio = 0,5 = 50 % de espacio.

**Ancho de línea**

Controla el ancho de línea de las regiones del estado.

**Opacidad de relleno**

Controla la opacidad de las regiones del estado.

## Asignaciones de valores
<a name="state-timeline-valuemap"></a>

Para asignar colores a los valores booleanos o de cadena, utilice [Asignación de valores](field-options-overrides.md#value-mapping).

## Datos de serie temporal con umbrales
<a name="state-timeline-threshold"></a>

El panel también se puede utilizar con datos de serie temporal. En este caso, los umbrales se utilizan para convertir las series temporales en discretas regiones de estado coloreadas.

## Opciones de leyenda
<a name="state-timeline-legend"></a>

Cuando la opción de leyenda está habilitada, puede mostrar las asignaciones de valores o los corchetes de umbral. Para mostrar las asignaciones de valores en la leyenda, es importante que la opción Combinación de colores de Opciones estándar esté establecida en Color único o Paleta clásica. Para ver los corchetes de los umbrales en la leyenda, establezca Combinación de colores en A partir de umbrales.

**Modo de leyenda**: utilice esta configuración para refinar la forma en que aparece la leyenda en la visualización.
+  **Lista**: muestra la leyenda como una lista. Este es el modo de visualización predeterminado de la leyenda.
+  **Tabla**: muestra la leyenda como una tabla.
+  **Oculta**: oculta la leyenda.

**Ubicación de la leyenda**: elija dónde colocar la leyenda.
+  **Parte inferior**: debajo del gráfico.
+  **Derecha**: a la derecha del gráfico.

# Panel Historial de estado
<a name="status-history-panel"></a>

****  
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 8.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.md).  
Para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).

La visualización del historial de estados muestra los estados periódicos a lo largo del tiempo. Cada campo o serie se representa como una fila horizontal. Los cuadros se representan y se centran alrededor de cada valor.

La visualización del Historial de estado funciona con series temporales o campos de cadenas, booleanos y numéricos. Un campo de tiempo es obligatorio. Puede utilizar las asignaciones de valores para colorear cadenas o asignar los valores de texto a los rangos numéricos.

## Opciones de visualización
<a name="status-timeline-options"></a>

Utilice estas opciones para refinar las visualizaciones:

**Mostrar valores**

Controla si los valores se representan dentro de los cuadros de valores. Representará automáticamente los valores si hay suficiente espacio.

**Ancho de columnas** controla el ancho de los cuadros. 1 = ancho máximo y 0 = ancho mínimo.

**Ancho de línea** controla el ancho de línea de las regiones del estado.

**Opacidad de relleno** controla la opacidad de relleno de las regiones de estado.

## Asignaciones de valores
<a name="status-history-valuemap"></a>

Para asignar colores a los valores booleanos o de cadena, utilice [Asignación de valores](field-options-overrides.md#value-mapping).

## Datos de serie temporal con umbrales
<a name="status-history-threshold"></a>

El panel también se puede utilizar con datos de serie temporal. En este caso, los umbrales se utilizan para colorear las casillas. También puede utilizar combinaciones de colores degradados para colorear los valores.

## Opciones de leyenda
<a name="status-history-legend"></a>

Cuando la opción de leyenda está habilitada, puede mostrar las asignaciones de valores o los corchetes de umbral. Para mostrar las asignaciones de valores en la leyenda, es importante que la opción Combinación de colores de Opciones estándar esté establecida en Color único o Paleta clásica. Para ver los corchetes de los umbrales en la leyenda, establezca Combinación de colores en A partir de umbrales.

**Modo de leyenda**: utilice esta configuración para refinar la forma en que aparece la leyenda en la visualización.
+  **Lista**: muestra la leyenda como una lista. Este es el modo de visualización predeterminado de la leyenda.
+  **Tabla**: muestra la leyenda como una tabla.
+  **Oculta**: oculta la leyenda.

**Ubicación de la leyenda**: elija dónde colocar la leyenda.
+  **Parte inferior**: debajo del gráfico.
+  **Derecha**: a la derecha del gráfico.

# Panel de tablas
<a name="table-panel"></a>

****  
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 8.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.md).  
Para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).

El panel de tablas admite varios modos para las series temporales y para las tablas, las anotaciones y los datos JSON sin procesar. Este panel también proporciona opciones de formato de fecha, formato de valores y color.

## Opciones de datos y campos
<a name="data-and-field-options"></a>

Con las visualizaciones de las tablas, puede aplicar las siguientes opciones:
+  [Transformaciones](panel-transformations.md).
+  [Opciones de campo y anulaciones](field-options-overrides.md).
+  [Umbrales](thresholds.md).

## Opciones de visualización
<a name="display-options"></a>
+  **Mostrar encabezado**: muestra u oculta los nombres de las columnas que se importaron del origen de datos.
+  **Ordenar de forma ascendente o descendente**: elija un título de columna para cambiar el criterio de ordenación predeterminado de descendente a ascendente. Cada vez que elija, el criterio de ordenación cambiará a la siguiente opción del ciclo. Puede ordenar solo por una columna cada vez.
+  [Opciones de campos de la tabla](#table-field-options): cambie las opciones de los campos, como el ancho de las columnas, la alineación y el modo de visualización de las celdas.
+  [Filtro de columnas de tabla](#filter-table-columns): cambie temporalmente la manera en que se muestran los datos de las columnas. Por ejemplo, puede ordenar los valores del más alto al más bajo u ocultar valores específicos.

## Compatibilidad de las anotaciones
<a name="annotation-support"></a>

Actualmente, el nuevo panel de tablas no admite anotaciones.

## Opciones de campos de la tabla
<a name="table-field-options"></a>

En esta sección se explican todas las opciones disponibles de campos de tabla. Las opciones se muestran en el mismo orden que en Amazon Managed Grafana. Las opciones que se muestran en este tema se aplican solo a las visualizaciones del panel de tablas.

La mayoría de las opciones de campo no afectarán a la visualización hasta que elija una opción fuera del cuadro de opciones de campo que está editando o pulse Intro.

Para obtener más información sobre cómo aplicar estas opciones, consulte [Configuración de todos los campos](field-options-overrides.md#configure-all-fields) y [Configuración de campos específicos](field-options-overrides.md#configure-specific-fields).

### Alineación de columnas
<a name="column-alignment"></a>

Elija cómo Amazon Managed Grafana debe alinear el contenido de las celdas:
+ Auto (valor predeterminado)
+ Izquierda
+ Center
+ Right

### Ancho de columnas
<a name="column-width"></a>

De forma predeterminada, Amazon Managed Grafana calcula automáticamente el ancho de la columna en función del contenido de la celda. En esta opción de campos, puede anular la configuración y definir el ancho de todas las columnas en píxeles.

Por ejemplo, si ingresa `100` en el campo, todas las columnas se establecerán en 100 píxeles de ancho cuando elija fuera del campo.

### Modo de visualización de celdas
<a name="cell-display-mode"></a>

De forma predeterminada, Amazon Managed Grafana elige automáticamente la configuración de visualización. Para anular la configuración, elija una de las siguientes opciones para cambiar todos los campos.

**nota**  
Si las establece en la pestaña **Campo**, los modos de visualización se aplican a todos los campos, lo que incluye el campo de tiempo. Muchas opciones funcionan mejor si las establece en la pestaña **Anular**.

#### Texto de color
<a name="color-text"></a>

Si se establecen umbrales, el texto del campo se muestra en el color de umbral adecuado.

#### Fondo de color
<a name="color-background"></a>

Si se establecen umbrales, el fondo del campo se muestra en el color de umbral adecuado.

#### Medidor de gradiente
<a name="gradient-gauge"></a>

Los niveles de umbral definen un gradiente.

#### Medidor de LCD
<a name="lcd-gauge"></a>

El medidor está dividido en celdas pequeñas que están iluminadas o apagadas.

#### Vista JSON
<a name="json-view"></a>

El valor se muestra formateado como código. Si un valor es un objeto, la vista JSON que le permite explorar el objeto JSON aparece cuando hace una pausa en el valor.

### Filtro de columnas
<a name="column-filter"></a>

## Filtro de columnas de tabla
<a name="filter-table-columns"></a>

Si activa **Filtro de columnas** en las opciones de la tabla, puede filtrar las opciones de la tabla. Para obtener más información, consulte [Opciones de campos de la tabla](#table-field-options).

### Activación del filtrado de columnas
<a name="turn-on-column-filtering"></a>

1. En Amazon Managed Grafana, elija el panel que muestra la tabla con las columnas que quiere filtrar.

1. En el panel de tabla que quiere filtrar, [Apertura del editor de paneles](AMG-panel-editor.md#open-the-panel-editor).

1. Elija la pestaña **Campo**.

1. En las opciones de **Tabla**, active la opción **Filtro de columnas**.

Aparece un icono de filtro junto al título de cada columna.

### Filtrado de valores de columnas
<a name="filter-column-values"></a>

Para filtrar los valores de las columnas, elija el icono de filtro (embudo) situado junto al título de la columna. El espacio de trabajo de Grafana muestra las opciones de filtro de esa columna.

Seleccione las casillas de verificación situadas junto a los valores que quiere mostrar. Ingrese texto en el campo de búsqueda de la parte superior para mostrar esos valores en la pantalla y poder seleccionarlos en lugar de desplazarse para encontrarlos.

### Borrado de filtros de columnas
<a name="clear-column-filters"></a>

Las columnas que tienen filtros aplicados muestran un embudo azul junto al título.

Para quitar el filtro, elija el icono del embudo azul y, a continuación, elija **Borrar filtro**.

# Panel de texto
<a name="text-panel"></a>

****  
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 8.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.md).  
Para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).

Puede utilizar el panel de texto para crear paneles de información y descripción para los paneles.

En **Modo**, seleccione si quiere utilizar Markdown o HTML para aplicar estilo al texto y, luego, ingrese el contenido en el cuadro a continuación. El espacio de trabajo de Grafana incluye un título y un párrafo para empezar, o puede pegar contenido de otro editor.

# Panel de serie temporal
<a name="time-series-panel"></a>

****  
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 8.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.md).  
Para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).

El panel de serie temporal puede representar una serie temporal como una línea, una trayectoria de puntos o una serie de barras. Este tipo de gráfico es lo bastante versátil como para mostrar casi cualquier dato de serie temporal.

**nota**  
Puede migrar las visualizaciones del panel de gráficos a visualizaciones de series temporales. Para migrar, en la pestaña **Panel**, elija **Visualización de series temporales**. Grafana transfiere todas las configuraciones aplicables.

Las visualizaciones de series temporales le permiten aplicar las siguientes opciones:
+  [Transformaciones](panel-transformations.md) 
+  [Opciones de campo y anulaciones](field-options-overrides.md) 
+  [Umbrales](thresholds.md) 

También puede utilizar las opciones de campos para crear diferentes tipos de gráficos o ajustar los ejes.

Use estos ajustes para ajustar la visualización.

## Modo de información sobre herramientas
<a name="time-series-panel-tooltip"></a>

Al pasar el cursor sobre el gráfico, Grafana puede mostrar información sobre herramientas. Elija cómo se comporta la información sobre herramientas:
+  **Única**: la información sobre herramientas situada al pasar el ratón solo muestra las series sobre las que está pasando el ratón.
+  **Todo**: la información sobre herramientas muestra todas las series del gráfico al pasar el ratón. Grafana resalta las series sobre las que pasa el ratón en negrita en la lista de series de la información sobre herramientas.
+  **Oculta**: no muestra la información sobre herramientas. 

## Modo y ubicación de leyenda
<a name="time-series-panel-legend"></a>

Elige cómo aparecerá la leyenda.
+  **Lista**: muestra la leyenda como una lista. Es el valor por defecto.
+  **Tabla**: muestra la leyenda como una tabla. 
+  **Oculta**: oculta la leyenda.

Elija dónde mostrar la leyenda.
+  **Parte inferior**: debajo del gráfico.
+  **Derecha**: a la derecha del gráfico. 

## Cálculos de la leyenda
<a name="time-series-panel-legend-calculations"></a>

Elija los cálculos que desee mostrar en la leyenda. Para obtener más información, consulte [Lista de cálculos](list-of-calculations.md).

# Series temporales de gráficos en forma de líneas
<a name="time-series-graph-lines"></a>

****  
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 8.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.md).  
Para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).

En esta sección se explica cómo utilizar las opciones de campo de series temporales para visualizar los datos de serie temporal en forma de líneas y se ilustra la función de las opciones.

**Creación del panel**

1. Para crear un panel, seleccione la visualización **Series temporales**. Para obtener más información, consulte [Cómo agregar un panel](add-a-panel-to-a-dashboard.md).

1. En el **Editor de paneles**, elija **Campo**.

1. En **Estilo**, elija **Líneas**.

## Diseño de las líneas
<a name="time-series-graph-lines-style"></a>

Hay una variedad de opciones para diseñar las líneas.
+ **Interpolación de líneas**: elija cómo Grafana interpola la línea de la serie. Las opciones son **Lineal**, **Liso**, **Paso antes** y **Paso después**.
+ **Ancho de línea**: permite establecer el grosor de la línea entre 0 y 10 píxeles.
+ **Opacidad de relleno**: permite establecer la opacidad del relleno de la serie, del 0 al 100 %.
+ **Modo de degradado**: permite establecer el modo del relleno degradado. El degradado de relleno se basa en el color de la línea. Para cambiar el color, utilice la opción de campo de combinación de colores estándar.

  El aspecto del degradado depende de la configuración de **Opacidad de relleno**.

  Las opciones para el relleno del degradado son **Ninguno**, **Opacidad** y **Matiz**. Con la opción **Opacidad**, la transparencia del degradado se calcula en función de los valores del eje Y. La opacidad del relleno aumenta con los valores del eje Y. Con la opción **Tonalidad**, el color del degradado se genera en función de la tonalidad del color de la línea.
+ **Estilo de línea**: establezca el estilo de la línea. Para cambiar el color, utilice la opción de campo de combinación de colores estándar.

  La apariencia del estilo de línea depende de la configuración de **Ancho de línea** y **Opacidad de relleno**.

  Las opciones de estilo de línea son **Sólido**, **Discontinuo** y **Puntos**.
+ **Valores nulos**: elija cómo se muestran las discontinuidades de los datos. Los valores nulos se pueden conectar para formar una línea continua o, como opción, establecer un umbral por encima del cual las discontinuidades de los datos ya no deberían conectarse. Puede elegir **Nunca** conectar los puntos de datos con discontinuidades, **Siempre** conectar los puntos de datos con discontinuidades o establecer un **Umbral** en el que las discontinuidades de los datos dejen de estar conectadas.
+ **Mostrar puntos**: elija cuándo deben mostrarse los puntos en el gráfico. Las opciones son **Automático**, **Siempre** y **Nunca**.

## Relleno debajo hasta
<a name="time-series-panel-legend-fillbelow"></a>

Esta opción está disponible solo en la pestaña de anulaciones.

**Relleno del área entre dos series**

1. Seleccione los campos que quiere rellenar a continuación.

1. En **Agregar propiedad de anulación**, elija **Rellenar debajo hasta**.

1. Seleccione la serie en la que desee que termine el relleno.

# Series temporales de gráficos en forma de barras
<a name="time-series-graph-bars"></a>

****  
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 8.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.md).  
Para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).

En esta sección se explica cómo utilizar las opciones de campo de series temporales para visualizar los datos de serie temporal en forma de barras y se ilustra la función de las opciones.

**Creación del panel**

1. Para crear un panel, seleccione la visualización **Series temporales**. Para obtener más información, consulte [Cómo agregar un panel](add-a-panel-to-a-dashboard.md).

1. En el **Editor de paneles**, elija **Campo**.

1. En **Estilo**, elija **Barras**.

## Diseño de las barras
<a name="time-series-graph-bars-style"></a>

Hay una variedad de opciones para diseñar las barras.
+ **Alineación de barra**: permite establecer la posición de la barra en relación con un punto de datos. Las opciones son **Anterior**, **Centro** y **Posterior**.
+ **Ancho de línea**: permite establecer el grosor de los contornos de la barra entre 0 y 10 píxeles.
+ **Opacidad de relleno**: permite establecer la opacidad del relleno de la barra, del 0 al 100 %.
+ **Modo de degradado**: permite establecer el modo del relleno degradado. El degradado de relleno se basa en el color de la línea. Para cambiar el color, utilice la opción de campo de combinación de colores estándar.

  El aspecto del degradado depende de la configuración de **Opacidad de relleno**.

  Las opciones para el relleno del degradado son **Ninguno**, **Opacidad** y **Matiz**. Con la opción **Opacidad**, la transparencia del degradado se calcula en función de los valores del eje Y. La opacidad del relleno aumenta con los valores del eje Y. Con la opción **Tonalidad**, el color del degradado se genera en función de la tonalidad del color de la línea.
+ **Mostrar puntos**: elija cuándo deben mostrarse los puntos en el gráfico. Las opciones son **Automático**, **Siempre** y **Nunca**.

# Series temporales de gráficos en forma de puntos
<a name="time-series-graph-points"></a>

****  
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 8.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.md).  
Para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).

En esta sección se explica cómo utilizar las opciones de campo de series temporales para visualizar los datos de serie temporal en forma de puntos y se ilustra la función de las opciones.

**Creación del panel**

1. Para crear un panel, seleccione la visualización **Series temporales**. Para obtener más información, consulte [Cómo agregar un panel](add-a-panel-to-a-dashboard.md).

1. En el **Editor de paneles**, elija **Campo**.

1. En **Estilo**, elija **Puntos**.

## Diseño de los puntos
<a name="time-series-graph-points-style"></a>

Al graficar como puntos, puede elegir el tamaño de los puntos.
+ **Tamaño de puntos**: elija el tamaño de los puntos, entre 1 y 40 píxeles de diámetro.

# Cambio de visualización de eje
<a name="time-series-change-axis"></a>

****  
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 8.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.md).  
Para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).

En esta sección se explica cómo utilizar las opciones de campo de las series temporales para controlar la visualización de los ejes y se ilustra la función de las opciones de los ejes.

Existen diversas opciones para los ejes.
+ **Ubicación del eje Y**: establece la ubicación del eje Y. Las opciones son **Izquierda**, **Derecha** y **Oculta**.
+ **Etiqueta del eje Y**: establece una etiqueta de texto para el eje Y. Si tiene más de un eje Y, puede utilizar la pestaña **Anular** para asignarles distintas etiquetas.
+ **Ancho**: establece el ancho fijo del eje. De manera predeterminada, el espacio de trabajo de Grafana calcula dinámicamente el ancho del eje. Al establecer el ancho del eje, los datos cuyos tipos de ejes son distintos pueden compartir las mismas proporciones de visualización. Esto facilita la comparación de los datos de más de un gráfico, ya que los ejes no se desplazan ni se estiran dentro de una proximidad visual entre sí.
+ **Mínimo flexible y máximo flexible**: establezca un valor **mínimo flexible** o un valor **máximo flexible** para controlar mejor los límites del eje Y. De forma predeterminada, el espacio de trabajo de Grafana establece el rango del eje Y automáticamente en función de los datos.

  La configuración de los valores **mínimo flexible** o **máximo flexible** puede evitar que las fluctuaciones aparezcan como montañas cuando los datos son en su mayoría planos, mientras que los valores mínimos o máximos estrictos derivados de las opciones de campo mínimo y máximo estándar pueden evitar que los picos intermitentes aplanen detalles útiles al recortar los picos más allá de un punto definido.
+ **Escala**: establezca la escala que se utilizará para los valores del eje Y. Las opciones son **lineal** y **logarítmica**.

# Series temporales apiladas del gráfico
<a name="time-series-stacked"></a>

****  
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 8.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.md).  
Para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).

En esta sección se explica cómo utilizar las opciones de los campos del panel de series temporales para controlar el apilamiento de las series y se ilustra la función de las opciones de apilamiento. Apilamiento permite a Grafana mostrar unas series sobre otras. Tenga cuidado al utilizar el apilamiento en la visualización, ya que puede crear fácilmente gráficos engañosos. Puede obtener más información sobre por qué el apilamiento podría no ser el mejor enfoque aquí: [The Issue with Stacking](https://www.data-to-viz.com/caveat/stacking.html).

# Apilamiento de series en grupos
<a name="time-series-stacked-groups"></a>

****  
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 8.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.md).  
Para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).

La opción de grupo de apilamiento solo está disponible en la modalidad de anulación.

**Apilamiento de series en el mismo grupo**

1. En la sección Anulaciones, cree una anulación de campo para la opción **Apilar series**.

1. Elija el modo de apilamiento **Normal**.

1. Asigne un nombre al grupo de apilamiento en el que quiere que aparezca la serie. La opción de nombre del grupo de apilamiento solo está disponible cuando se crea una anulación.

# Umbrales
<a name="thresholds"></a>

****  
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 8.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.md).  
Para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).

Los umbrales establecen el color del texto del valor o del fondo en función de las condiciones que se definan.

Puede definir umbrales de dos maneras:
+ Los umbrales **absolutos** se definen en función de un número, por ejemplo, 80 en una escala del 1 al 150.
+ Los umbrales **porcentuales** se definen en relación con el mínimo o el máximo, por ejemplo, el 80 por ciento.

Puede aplicar umbrales a las siguientes visualizaciones:
+ [Panel de medidores de barras](alert-panel-bar-gauge-panel.md) 
+  [Panel de medidores](gauge-panel.md) 
+  [Panel de gráfico](graph-panel.md)
+  [Panel de estadísticas](stat-panel.md)
+  [Panel de tablas](table-panel.md)

## Umbrales predeterminados
<a name="default-thresholds"></a>

En las visualizaciones que lo admiten, Amazon Managed Grafana establece el siguiente valor de umbral predeterminado: 80 = rojo; Base = verde; Modo = Absoluto.

El valor **Base** representa menos el infinito. Por lo general, es el color *correcto*.

## Adición de un umbral
<a name="add-a-threshold"></a>

Puede agregar tantos umbrales a un panel como desee. El espacio de trabajo de Grafana ordena automáticamente los umbrales del valor más alto al más bajo.

**nota**  
Estas instrucciones se aplican únicamente a las visualizaciones de estadísticas, medidores, medidores de barras y tablas.

1. Elija el panel al que quiere agregar un umbral.

1. Elija la pestaña **Campo**.

1. Elija **Agregar umbral**.

   Amazon Managed Grafana agrega un umbral con valores numéricos y de color sugeridos. 

1. Acepte las recomendaciones o edite el nuevo umbral.
   +  **Editar color**: elija el punto de color que quiere cambiar y, luego, seleccione un color nuevo.
   +  **Editar número**: elija el número que quiere cambiar y, a continuación, ingrese un número nuevo.
   +  **Modo de umbrales**: elija el modo para cambiarlo para todos los umbrales de este panel.

1. Elija **Guardar** para guardar los cambios en el panel.

## Adición de un umbral a un panel de gráficos
<a name="add-a-threshold-to-a-graph-panel"></a>

En la visualización del panel de gráficos, puede utilizar umbrales para agregar líneas o secciones arbitrarias al gráfico para que sea más fácil ver cuándo el gráfico cruza un umbral determinado.

1. Elija el panel de gráficos para agregar un umbral.

1. En la pestaña **Panel**, elija **Umbrales**.

1. Elija **Agregar umbral**.

1. Rellene todos los campos que quiera. Solo los campos **T1** son obligatorios.
   +  **T1**: ambos valores son obligatorios para mostrar un umbral.
     +  **lt** o **gt**: seleccione **lt** si es inferior a o **gt** si es superior a para indicar a qué se aplica el umbral.
     +  **Valor**: ingrese un valor de umbral. El espacio de trabajo de Grafana dibuja una línea de umbral a lo largo del eje Y en ese valor.
   +  **Color**: elija una condición que corresponda a un color o defina su propio color.
     +  **personalizado**: define el color de relleno y el color de la línea.
     +  **crítico**: el color del relleno y de la línea es rojo.
     +  **advertencia**: el color del relleno y de la línea es amarillo.
     +  **ok**: el color del relleno y de la línea es verde.
   +  **Rellenar**: elija si desea que se muestre el umbral de relleno.
   +  **Línea**: elija si desea que se muestre la línea de umbral.
   +  **Eje Y**: elija **Izquierda** o **Derecha**.

1. Elija **Guardar** para guardar los cambios en el panel. 

## Eliminación de un umbral
<a name="delete-a-threshold"></a>

1. Elija el panel del que quiere quitar un umbral.

1. Elija la pestaña **Campo**. (O bien, en el caso de un panel de gráficos, elija la pestaña **Panel**).

1. Elija el icono de la papelera al lado del umbral que quiere eliminar. 

1. Elija **Guardar** para guardar los cambios en el panel. 

# WindRose
<a name="windrose"></a>

****  
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 8.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.md).  
Para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).

El WindRose panel recibe datos de series temporales sin procesar, convierte los datos y los mapea en un WindRose gráfico.

![\[WindRose panel with two circular charts showing wind direction and speed data distribution.\]](http://docs.aws.amazon.com/es_es/grafana/latest/userguide/images/windrose.png)


## Opciones
<a name="windrose-options"></a>

El WindRose panel admite las siguientes opciones:
+ Frecuencia de los ejes
+ Estilo de los ejes (grados o brújula)
+ Escala (lineal, cuadrada, logarítmica)

# Inspección de un panel
<a name="inspect-a-panel"></a>

****  
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 8.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.md).  
Para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).

El inspector de paneles lo ayuda a entender los paneles y a solucionar sus problemas. Puede inspeccionar los datos sin procesar de cualquier panel de un espacio de trabajo de Grafana, exportarlos a un archivo de valores separados por comas (CSV), ver las solicitudes de consulta y exportar los paneles y los datos a JSON. 

## Interfaz de usuario del inspector de paneles
<a name="panel-inspector-ui"></a>

El inspector de paneles muestra **Inspeccionar: < NameOfPanelBeingInspected >** en la parte superior del panel. Elija la flecha de la esquina superior derecha para ampliar o reducir el panel.

El inspector de paneles consta de cuatro pestañas:
+  **Pestaña Datos**: muestra los datos sin procesar devueltos por la consulta con las transformaciones aplicadas. Las opciones de campo, como las anulaciones y las asignaciones de valores, no se aplican de forma predeterminada.
+  **Pestaña Estadísticas**: muestra cuánto tiempo tarda la consulta y cuánto devuelve.
+  **Pestaña JSON**: permite ver y copiar el JSON del panel, el JSON de los datos del panel y el JSON de la estructura del marco de datos. Esto es útil si está aprovisionando o administrando Amazon Managed Grafana.
+  **Pestaña Consulta**: muestra las solicitudes al servidor que se envían cuando Amazon Managed Grafana consulta el origen de datos.

**nota**  
No todos los tipos de paneles incluyen las cuatro pestañas. Por ejemplo, los paneles de listas de paneles no tienen datos sin procesar para inspeccionar, por lo que no muestran las pestañas Estadísticas, Datos ni Consulta.

## Tareas del inspector de paneles
<a name="panel-inspector-tasks"></a>

En el inspector de paneles, puede examinar paneles, inspeccionar y descargar los resultados de las consultas sin procesar, revisar el rendimiento de las consultas, ver los modelos JSON de los paneles y consultar la solicitud sin procesar y la respuesta al origen de datos.

### Apertura del inspector de paneles
<a name="open-the-panel-inspector"></a>

Puede inspeccionar cualquier panel que pueda ver.

1. En la consola del espacio de trabajo de Grafana, elija el panel que contiene el panel que desea inspeccionar.

1. Elija el título del panel que desea inspeccionar y, a continuación, elija **Inspeccionar**. También puede hacer una pausa sobre el título del panel y, a continuación, pulsar **i**.

El inspector de paneles se abre en el lado derecho de la pantalla.

### Inspección de los resultados de consultas sin procesar
<a name="inspect-raw-query-results"></a>

Vea los resultados de las consultas sin procesar en una tabla. Estos son los datos que devuelve la consulta con las transformaciones aplicadas y antes de que el panel aplique las opciones de campo o las anulaciones de opción de campo.

1. Abra el inspector de paneles y, a continuación, seleccione la pestaña **Datos**. También puede, en el menú del panel, seleccionar **Inspeccionar**, **Datos**.

1. Si su panel contiene varias consultas o consulta varios nodos, tiene opciones adicionales.
+  **Seleccionar resultado**: elija los datos del conjunto de resultados que desea ver.
+  **Transformación de datos** 
  +  **Unir por tiempo**: vea los datos sin procesar de todas sus consultas a la vez, con un conjunto de resultados por columna. Elija un encabezado de columna para reordenar los datos.

  Vea los resultados de las consultas sin procesar en una tabla con las opciones de campo y las anulaciones de opciones aplicadas.

  1. Abra la pestaña **Datos** en el inspector de paneles.

  1. En la parte superior de la tabla, seleccione una de las **opciones de visualización de datos**.

  1. Pulse el botón de alternancia **Aplicar la configuración de campos**.

### Descarga de resultados de las consultas sin procesar en formato CSV
<a name="download-raw-query-results-as-csv"></a>

Amazon Managed Grafana genera un archivo CSV en la ubicación de descarga predeterminada del navegador. Puede abrirlo en el visor que prefiera.

1. Abra el inspector de paneles.

1. Inspeccione los resultados de la consulta sin procesar tal y como se ha descrito anteriormente. Ajuste la configuración hasta que pueda ver los datos sin procesar que desea exportar.

1. Seleccione **Descargar CSV**.

Para descargar un archivo CSV con un formato para Excel, expanda el panel **Opciones de datos** y, a continuación, active la opción **Descargar para Excel** antes de seleccionar **Descargar CSV**. 

### Inspección del rendimiento de consultas
<a name="inspect-query-performance"></a>

En la pestaña **Estadísticas** se muestran estadísticas que indican cuánto tiempo tarda la consulta, cuántas consultas envía y el número de filas devueltas. Esta información puede ayudarlo a solucionar los problemas de las consultas, especialmente si alguno de los números es inesperadamente alto o bajo.

1. Abra el inspector de paneles.

1. Elija la pestaña **Estadísticas**.

Las estadísticas se muestran en formato de solo lectura.

### Visualización de modelos JSON de paneles
<a name="view-panel-json-model"></a>

Explore y exporte modelos JSON de paneles, datos de paneles y marcos de datos.

1. Abra el inspector de paneles y, a continuación, seleccione la pestaña **JSON**. También puede, en el menú del panel, seleccionar **Inspeccionar**, **JSON del panel**. 

1. En **Seleccionar origen**, elija una de las siguientes opciones:
   +  **JSON del panel**: muestra un objeto JSON que representa el panel.
   +  **Datos del panel**: muestra un objeto JSON que representa los datos que se pasaron al panel. 
   +  **DataFrame estructura**: muestra el conjunto de resultados sin procesar con las transformaciones, la configuración de los campos y las anulaciones aplicadas.

1. Puede expandir o contraer partes del JSON para explorarlo o puede elegir **Copiar al portapapeles** y pegar el JSON en otra aplicación.

### Visualización de la solicitud sin procesar y respuesta al origen de datos
<a name="view-raw-request-and-response-to-data-source"></a>

1. Abra el inspector de paneles y, a continuación, seleccione la pestaña **Consulta**. También puede, en el menú del panel, seleccionar **Inspeccionar**, **Consulta**.

1. Elija **Actualizar**.

Amazon Managed Grafana envía una consulta al servidor para recopilar información y, a continuación, muestra el resultado. Puede profundizar en partes específicas de la consulta, expandirla o contraerla toda, o copiar los datos al portapapeles para usarlos en otras aplicaciones.

# Lista de cálculos
<a name="list-of-calculations"></a>

****  
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 8.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.md).  
Para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).

En este tema se enumeran y definen los cálculos que se utilizan en Amazon Managed Grafana.

Puede encontrar estos cálculos, entre otros lugares, en la pestaña **Transformar** y en los indicadores de barras, los indicadores y las visualizaciones de las estadísticas.


|  Cálculo  |  Description (Descripción)  | 
| --- | --- | 
|  Todos nulos  |  Verdadero cuando todos los valores son nulos  | 
|  Todos ceros  |  Verdadero cuando todos los valores son 0  | 
|  Recuento de cambios  |  Número de veces que cambia el valor del campo  | 
|  Recuento  |  Número de valores de un campo  | 
|  Delta  |  Cambio acumulativo en el valor  | 
|  Diferencia  |  Diferencia entre el primer y el último valor de un campo  | 
|  Recuento de valores distintos  |  Número de valores únicos de un campo  | 
|  Primero (no nulo)  |  Primer valor no nulo de un campo  | 
|  Máximo  |  Valor máximo de un campo  | 
|  Media  |  Valor medio de todos los valores de un campo  | 
|  Mínimo  |  Valor mínimo de un campo  | 
|  Mín. (por encima de cero)  |  Valor mínimo positivo de un campo  | 
|  Range  |  Diferencia entre los valores máximo y mínimo de un campo  | 
|  Paso  |  Intervalo mínimo entre los valores de un campo  | 
|  Total  |  Suma de todos los valores de un campo  | 

# Paneles
<a name="dashboard-overview"></a>

****  
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 8.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.md).  
Para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).

 Un *panel de control* es un conjunto de uno o más paneles organizados y dispuestos en una o más filas. Amazon Managed Grafana se ofrece con una variedad de paneles. Amazon Managed Grafana facilita la creación de las consultas correctas y la personalización de las propiedades de visualización para que pueda crear el panel que necesita. Cada panel puede interactuar con los datos de cualquier origen de datos configurado. 

## Administración de paneles
<a name="manage-dashboards"></a>

 Para controlar el periodo de tiempo del panel, puede utilizar [Controles de intervalo de tiempo](dashboard-time-range-controls.md) en la parte superior derecha del panel. 

 Los paneles pueden usar plantillas y variables para hacerlos más dinámicos e interactivos. Para obtener más información, consulte [Plantillas y variables](templates-and-variables.md). 

 Los paneles pueden utilizar [Anotaciones](dashboard-annotations.md) para mostrar los datos de los eventos en todos los paneles. Esto puede ayudar a correlacionar los datos de serie temporal del panel con otros eventos. 

 Puede compartir fácilmente los paneles de diversas formas. Para obtener más información, consulte [Uso compartido de un panel de control](share-a-dashboard.md). 

 Los paneles se pueden etiquetar y el selector de paneles proporciona un acceso rápido y con capacidad de búsqueda a todos los paneles de una organización en particular. 

## Filas
<a name="dashboard-rows"></a>

 Una *fila* es un separador lógico dentro de un panel. Se utiliza para agrupar paneles. 

 Las filas siempre tienen 12 *unidades* de ancho. Estas unidades se escalan automáticamente en función de la resolución horizontal del navegador. Puede controlar el ancho relativo de los paneles dentro de una fila configurando su ancho específico. 

 Amazon Managed Grafana utiliza una abstracción de unidades para optimizar la apariencia en todos los tamaños de pantalla. 

**nota**  
 Con esta MaxDataPoint funcionalidad, Amazon Managed Grafana puede mostrar la cantidad requerida de puntos de datos, independientemente de la resolución o el intervalo de tiempo. 

 Para contraer una fila, elija el título de la fila. Si guarda un panel con una fila contraída, el panel se guardará en ese estado y los gráficos no se cargarán hasta que se amplíe la fila. 

 Utilice la funcionalidad de repetición de filas para crear o eliminar filas enteras de paneles de forma dinámica, en función de las variables de plantilla seleccionadas. 

# Anotaciones
<a name="dashboard-annotations"></a>

****  
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 8.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.md).  
Para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).

 Las anotaciones proporcionan una forma de marcar los puntos del gráfico con eventos detallados. Cuando hace una pausa en una anotación, puede ver la descripción y las etiquetas de un evento. El campo de texto puede incluir enlaces a otros sistemas para obtener más detalles. 

## Anotaciones nativas
<a name="native-annotations"></a>

 Amazon Managed Grafana incluye un almacén de anotaciones nativo y la posibilidad de agregar eventos de anotación directamente desde el panel de gráficos. 

## Adición de anotaciones
<a name="adding-annotations"></a>

 Para agregar una anotación, pulse **Ctrl** o **Cmd** y elija dónde quiere agregar la anotación. Para que la anotación se pueda buscar en otros paneles, agréguele etiquetas. 

### Cómo agregar anotaciones de región
<a name="adding-regions-events"></a>

 Para crear una anotación para una región, pulse **Ctrl** o **Cmd** mientras selecciona la región. 

### Consulta integrada
<a name="annotation-built-in-query"></a>

 Después de agregar una anotación, esta permanece visible. Esto se debe a que existe una consulta de anotación integrada en todos los paneles. Esta consulta de anotación busca todos los eventos de anotación que se originan en el panel actual y los muestra en el panel en el que se crearon. Esto incluye las anotaciones del historial del estado de las alertas. Para evitar que las anotaciones se busquen y se muestren, seleccione el icono de **Configuración del panel** (engranaje), elija **Anotaciones** y, a continuación, modifique la consulta llamada `Annotations & Alerts (Built-in)`. 

 Al copiar un panel mediante la característica **Guardar como**, el nuevo panel tiene un nuevo ID de panel, por lo que las anotaciones creadas en el panel de origen no se ven en la copia. Si las anotaciones del panel de origen tienen etiquetas por las que filtrar, puede mostrar las anotaciones en la copia agregando una nueva **consulta de anotación** y filtrando por las etiquetas. 

### Consulta por etiqueta
<a name="annotation-query-by-tag"></a>

 Puede crear nuevas consultas de anotación que obtengan anotaciones del almacén de anotaciones nativo utilizando el origen de datos `-- Grafana --` y configurando **Filtrar por** en **Etiquetas**. Especifique al menos una etiqueta. Por ejemplo, cree una consulta de anotación con el nombre `outages` y especifique una etiqueta llamada `outage`. Esta consulta mostrará todas las anotaciones que cree (desde cualquier panel o mediante una API) que tengan la etiqueta `outage`.

De forma predeterminada, si agrega varias etiquetas en la consulta de anotaciones, Amazon Managed Grafana mostrará solo las anotaciones que contengan todas las etiquetas que haya proporcionado. Para mostrar las anotaciones que contienen al menos una de las etiquetas que ha proporcionado, active la opción **Coincidir con cualquiera**. 

 En Amazon Managed Grafana, es posible utilizar variables de plantilla en la consulta de etiquetas. Por ejemplo, si tiene un panel que muestra las estadísticas de distintos servicios y una variable de plantilla que controla qué servicios mostrar, puede usar la misma variable de plantilla en la consulta de anotaciones para mostrar solo las anotaciones de esos servicios. 

## Consultas a otros orígenes de datos
<a name="querying-other-data-sources"></a>

 Los eventos de anotación se obtienen mediante consultas de anotación. Para agregar una nueva consulta de anotación a un panel, elija el icono de **Configuración del panel** (engranaje), elija `Annotations` y, a continuación, elija **Nueva**. 

 Especifique un nombre para la consulta de anotaciones. Este nombre se muestra junto a la casilla de verificación para mostrar u ocultar los eventos de anotación de esta consulta. Por ejemplo, es posible que tenga dos consultas de anotación denominadas `Deploys` y `Outages`. Puede activar o desactivar las casillas de verificación para especificar qué anotaciones mostrar. 

### Detalles de consulta de anotaciones
<a name="annotation-query-details"></a>

 Las opciones de consulta de anotaciones son diferentes para cada origen de datos. 
+ [Anotaciones con el editor de consultas de Graphite](https://docs.aws.amazon.com/en_us/grafana/latest/userguide/using-graphite-in-AMG.html#graphite-annotations)
+ [Anotaciones mediante fuente OpenSearch de datos](https://docs.aws.amazon.com/en_us/grafana/latest/userguide/ES-use-datasource.html#ES-annotations)
+ [Anotaciones con Prometheus](https://docs.aws.amazon.com/en_us/grafana/latest/userguide/using-prometheus-datasource.html#p-annotations)
+ [Anotaciones con MySQL](https://docs.aws.amazon.com/en_us/grafana/latest/userguide/using-mysql-in-AMG.html#mysql-annotations)
+ [Anotaciones con PostgreSQL](https://docs.aws.amazon.com/en_us/grafana/latest/userguide/using-postgresql-in-AMG.html#postgresql-annotations)

# Carpetas de paneles
<a name="dashboard-folders"></a>

****  
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 8.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.md).  
Para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).

 Las carpetas son una forma de organizar y agrupar los paneles. Esto es útil si tiene muchos paneles o si varios equipos utilizan el mismo espacio de trabajo de Grafana. 

## Creación de una carpeta
<a name="how-to-create-a-folder"></a>

Para crear una carpeta, lleve a cabo alguna de las siguientes operaciones:
+  En el menú lateral, debajo del icono \$1, seleccione el enlace **Crear carpeta**. 
+  En la página **Administrar paneles**, pulse el botón **Crear carpeta**. 

 En la página **Crear carpeta**, ingrese un nombre exclusivo para la carpeta y, a continuación, seleccione **Crear**. 

Cuando guarda un panel, puede elegir una carpeta existente o crear una nueva.

## Administración de paneles
<a name="folders-manage-dashboards"></a>

 En la página **Administrar paneles**, puede efectuar diversas tareas: 
+  Crear una carpeta. 
+  Crear un panel de control. 
+  Mover los paneles a carpetas. 
+  Eliminar varios paneles. 
+  Navegar a la página de una carpeta (donde puede establecer los permisos para una carpeta o sus paneles). 

## Página Carpeta de panel de control
<a name="dashboard-folder-page"></a>

 Para abrir una página Carpeta de panel, seleccione el icono de engranaje que aparece cuando hace una pausa en una carpeta de la lista de paneles, en los resultados de búsqueda o en la página Administrar paneles. 

 La página Carpeta de panel es similar a la página Administrar paneles. En la página Carpeta de panel, puede llevar a cabo las siguientes tareas: 
+  Mover o eliminar los paneles de una carpeta. 
+  Cambiar el nombre de una carpeta (en la pestaña **Configuración**). 
+  Definir los permisos de la carpeta (heredados por los paneles de la carpeta). 

## Permisos
<a name="folder-permissions"></a>

 Los permisos se pueden asignar a una carpeta y heredarse en los paneles que contiene. Se utiliza una lista de control de acceso (ACL) donde se pueden asignar permisos al **rol de la organización**, al **equipo** y al **usuario** individual. Para obtener más información, consulte [Permisos de paneles y carpetas](dashboard-and-folder-permissions.md). 

# Lista de reproducción
<a name="dashboard-playlist"></a>

****  
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 8.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.md).  
Para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).

 Una lista de reproducción es una lista de paneles de control que se muestran en secuencia. Puede usar una lista de reproducción para crear conciencia situacional o para presentar sus métricas a su equipo o a los visitantes. 

 Amazon Managed Grafana escala automáticamente los paneles a cualquier resolución, incluidas las pantallas grandes. 

 Puede acceder a la característica **Lista de reproducción** desde el menú lateral, en el submenú **Paneles**. 

## Creación de una lista de reproducción
<a name="create-a-playlist"></a>

 Una lista de reproducción presenta los paneles en una secuencia, con un orden establecido y un intervalo de tiempo entre los paneles. 

1.  Para acceder a la característica **Lista de reproducción**, haga una pausa en el menú lateral. 

1.  Elija **Listas de reproducción**. 

1.  Elija **Nueva lista de reproducción**. 

1.  En el cuadro de texto **Nombre**, escriba un nombre para la lista de reproducción. 

1.  En el cuadro de texto **Intervalo**, ingrese un intervalo de tiempo. 

   El intervalo de tiempo es el tiempo que Amazon Managed Grafana permanece en un panel concreto antes de pasar al siguiente de la lista de reproducción. 

1.  Junto a cada panel que desea agregar a la lista de reproducción, elija **Agregar a lista de reproducción**. 

1.  Seleccione **Crear**. 

## Edición de una lista de reproducción
<a name="edit-a-playlist"></a>

 Puede editar las listas de reproducción mientras las crea o después de guardarlas. 

1.  Para acceder a la característica Lista de reproducción, haga una pausa en el menú lateral. 

1.  Elija **Listas de reproducción**. 

1.  Elija la lista de reproducción que desee editar. 

### Edición del nombre de una lista de reproducción
<a name="edit-the-name-of-a-playlist"></a>

1. Seleccione el cuadro de texto **Nombre**.

1.  Edite el nombre. 

1.  Elija **Guardar** para guardar los cambios. 

### Edición del intervalo de una lista de reproducción
<a name="edit-the-interval-of-a-playlist"></a>

1.  Seleccione el cuadro de texto **Intervalo**. 

1.  Edite el intervalo. 

1.  Elija **Guardar** para guardar los cambios. 

### Cómo agregar un panel a una lista de reproducción
<a name="add-a-dashboard-to-a-playlist"></a>

1.  Junto a cada panel que desea agregar, elija **Agregar a lista de reproducción**. 

1.  Elija **Guardar** para guardar los cambios. 

### Búsqueda de un panel para agregarlo
<a name="search-for-a-dashboard-to-add"></a>

1. En **Agregar paneles**, seleccione el cuadro de texto **Buscar paneles por nombre**. 

1.  Ingrese un nombre o una expresión regular. 

1. Si es necesario, filtre los resultados por estado destacado o por etiquetas. De forma predeterminada, los paneles destacados aparecen como opciones para agregarlos a la lista de reproducción.

1.  Elija **Guardar** para guardar los cambios. 

### Reorganización del orden del panel de control
<a name="rearrange-dashboard-order"></a>

1.  Junto al panel que desea mover, elija la flecha hacia arriba o hacia abajo. 

1.  Elija **Guardar** para guardar los cambios. 

### Eliminación de un panel de control
<a name="remove-a-dashboard"></a>

1.  Seleccione el icono x para eliminar un panel de la lista de reproducción. 

1.  Elija **Guardar** para guardar los cambios. 

### Eliminación de una lista de reproducción
<a name="delete-a-playlist"></a>

1.  Elija **Listas de reproducción**. 

1.  Al lado de la lista de reproducción que desea eliminar, elija el icono X. 

## Guardado de una lista de reproducción
<a name="save-a-playlist"></a>

 Puede guardar una lista de reproducción para agregarla a su página **Listas de reproducción**, donde podrá iniciarla. Asegúrese de agregar todos los paneles que desee que aparezcan en la lista de reproducción antes de guardarla. 

1.  Para acceder a la característica **Lista de reproducción**, haga una pausa en el menú lateral. 

1.  Elija **Listas de reproducción**. 

1.  Elija la lista de reproducción. 

1.  Edite la lista de reproducción. 

   Asegúrese de que la lista de reproducción tenga un **nombre**, un **intervalo** y al menos un **panel** agregado. 

1.  Seleccione **Save**. 

## Inicio de una lista de reproducción
<a name="start-a-playlist"></a>

 Puede iniciar una lista de reproducción en cinco modos de visualización diferentes. El modo determina cómo se muestran los menús y la barra de navegación en los paneles. 

 De forma predeterminada, cada panel se muestra durante el tiempo ingresado en el campo **Intervalo**, que se puede configurar al crear o editar una lista de reproducción. Tras iniciar una lista de reproducción, puede controlarla mediante la barra de navegación situada en la parte superior de la pantalla. 

1.  En el menú **Paneles**, seleccione **Listas de reproducción**. 

1.  Junto a la lista de reproducción que desee iniciar, seleccione **Iniciar lista de reproducción**. 

1.  En la lista desplegable, elija uno de los siguientes modos de visualización: 
   +  **Modo normal** 
     +  El menú lateral permanece visible. 
     +  Los controles de barra de navegación, fila y panel aparecen en la parte superior de la pantalla. 
   +  **Modo TV** 
     +  El menú lateral está oculto o eliminado. 
     +  Los controles de barra de navegación, fila y panel aparecen en la parte superior de la pantalla. 
     +  El modo TV se activa automáticamente tras 1 minuto de inactividad del usuario. 
     +  Puede activar el modo TV manualmente mediante el método abreviado de secuencia **d v** o agregando el parámetro `?inactive` a la URL del panel. 
     +  Puede desactivar el modo TV con cualquier movimiento del ratón o con cualquier acción del teclado. 
   +  **Modo TV (con paneles de ajuste automático)** 
     +  El menú lateral está oculto o eliminado. 
     +  Los controles de barra de navegación, fila y panel aparecen en la parte superior de la pantalla. 
     +  Los paneles del panel de control se ajustan automáticamente para optimizar el espacio en la pantalla. 
   +  **Modo quiosco** 
     +  Los controles del menú lateral, la barra de navegación, la fila y el panel están completamente ocultos o se han eliminado de la vista. 
     +  Puede activar el modo quiosco manualmente utilizando el método abreviado de secuencia **d v** una vez que se haya iniciado la lista de reproducción. 
     +  Puede desactivar el modo quiosco manualmente utilizando el mismo método abreviado. 
   +  **Modo quiosco (con paneles de ajuste automático):** 
     +  Los controles del menú lateral, la barra de navegación, la fila y el panel están completamente ocultos o se han eliminado de la vista. 
     +  Los paneles del panel de control se ajustan automáticamente para optimizar el espacio en la pantalla. 

## Control de una lista de reproducción
<a name="control-a-playlist"></a>

 Puede controlar una lista de reproducción en modo **Normal** o **TV** después de que se haya iniciado mediante la barra de navegación situada en la parte superior de la pantalla. 


|  Button  |  Resultado  | 
| --- | --- | 
|  Siguiente (doble flecha hacia la derecha)  |  Avanza al siguiente panel de control.  | 
|  Atrás (flecha izquierda)  |  Vuelve al panel anterior.  | 
|  Parar (cuadrado)  |  Finaliza la lista de reproducción y sale al panel de control actual.  | 
|  Modo de visualización cíclica (icono del monitor)  |  Cambia la visualización de los paneles a distintos modos de visualización.  | 
|  Intervalo de tiempo  | Muestra los datos dentro de un intervalo de tiempo. Se puede definir para que muestre desde los últimos 5 minutos hasta hace 5 años, o un intervalo de tiempo personalizado, mediante la flecha desplegable.  | 
|  Actualizar (flecha circular)  |  Recarga el panel para mostrar los datos actuales. Se puede definir para que se recargue automáticamente, desde cada 5 segundos hasta 1 día, mediante la flecha desplegable.  | 

 Para detener la lista de reproducción desde el teclado, presione **Esc**.

## Uso compartido de una lista de reproducción en un modo de visualización
<a name="share-a-playlist-in-a-view-mode"></a>

Puede compartir una lista de reproducción copiando la URL en el modo de visualización que desee y pegándola en su destino.

1.  Desde el menú **Paneles**, seleccione **Listas de reproducción**. 

1.  Junto a la lista de reproducción que desee compartir, seleccione **Iniciar lista de reproducción** y, a continuación, elija el modo de visualización que desee. 

1.  Para copiar la URL en el portapapeles, elija **Copiar dirección del enlace**. 

    Por ejemplo, la URL de una lista de reproducción en el sitio de Grafana Play en modo quiosco podría ser `https://play.grafana.org/d/000000010/annotations?orgId=1&kiosk`. 

1.  Pegue la URL en el destino. 

# Búsqueda de paneles de control
<a name="dashboard-search"></a>

****  
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 8.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.md).  
Para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).

 Los paneles se pueden buscar por el nombre del panel, filtrar por una (o varias) etiquetas o filtrar por su estado destacado. Para acceder a la búsqueda de paneles, se utiliza el selector de paneles, que está disponible en la barra de navegación superior del panel. La búsqueda de paneles también se puede abrir con el método abreviado **F**. 

Si utiliza únicamente un teclado, puede utilizar las teclas de flecha del teclado para navegar por los resultados y pulsar **Entrar** para abrir el panel que desee. 

## Búsqueda por nombre de panel
<a name="find-by-dashboard-name"></a>

Escriba cualquier parte del nombre del panel en la barra de búsqueda. A medida que escribe, la búsqueda devuelve los resultados de cualquier coincidencia parcial de las cadenas en tiempo real. 

La búsqueda de paneles cumple los siguientes requisitos:
+ Ocurre en tiempo real.
+ No distingue entre mayúsculas y minúsculas.
+  Funciona en todos los paneles almacenados y basados en archivos.

## Filtrado por etiquetas
<a name="filter-by-tags"></a>

 Las etiquetas son una forma útil de organizar los paneles, especialmente a medida que aumenta el número de paneles. Puede agregar y administrar las etiquetas en la **configuración** del panel. 

 Para filtrar la lista de paneles por etiqueta, seleccione cualquier etiqueta que aparezca en la columna derecha. Puede filtrar aún más la lista eligiendo etiquetas adicionales. 

Para ver una lista de todas las etiquetas disponibles, haga clic en el menú desplegable **Filtrar por etiquetas**. Al seleccionar una etiqueta, la búsqueda de paneles se filtra al instante. 

Cuando utilice solo un teclado, pulse la tecla **Tab** para centrarse en el enlace de la etiqueta, pulse la tecla de flecha hacia abajo para buscar una etiqueta y pulse **Entrar** para seleccionarla. 

**nota**  
 Al seleccionar varias etiquetas, Amazon Managed Grafana muestra paneles que incluyen todas las etiquetas. 

# Uso compartido de un panel de control
<a name="share-a-dashboard"></a>

****  
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 8.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.md).  
Para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).

 Para compartir un panel, seleccione **Compartir panel** (icono de compartir) en la barra de navegación superior. Esto abre el cuadro de diálogo **Compartir**, en el que puede obtener un enlace al panel actual con el intervalo de tiempo seleccionado y las variables de la plantilla. Si ha hecho cambios en el panel, asegúrese de guardarlos antes de copiar el enlace. 

## Instantánea de panel
<a name="dashboard-snapshot"></a>

 Una instantánea del panel es una manera inmediata de compartir un panel interactivo de forma pública. Cuando crea la instantánea, Amazon Managed Grafana elimina los datos confidenciales, como las consultas (métricas, plantillas y anotaciones) y los enlaces de los paneles, dejando solo los datos métricos visibles y los nombres de las series incrustados en el panel. Cualquier persona que tenga el enlace y pueda acceder a la URL puede acceder a las instantáneas del panel. 

## Publicación de instantáneas
<a name="publish-snapshots"></a>

 Puede publicar instantáneas en su instancia local. 

# Uso compartido de un panel
<a name="dashboard-share-a-panel"></a>

****  
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 8.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.md).  
Para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).

 Elija un título de panel para abrir el menú del panel y, a continuación, seleccione **Compartir** en el menú del panel para abrir el cuadro de diálogo **Compartir panel**. Puede copiar el enlace, que lo llevará exactamente a este panel con el intervalo de tiempo actual y las variables de plantilla seleccionadas. 

# Controles de intervalo de tiempo
<a name="dashboard-time-range-controls"></a>

****  
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 8.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.md).  
Para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).

 Amazon Managed Grafana ofrece varias formas de administrar los intervalos de tiempo de los datos que se visualizan en el nivel de panel. 

 En este tema, se describen las unidades de tiempo y los intervalos relativos compatibles, los controles de tiempo habituales, los ajustes de tiempo de todos los paneles y los ajustes de tiempo específicos de un panel. 

**nota**  
Para tener controles de tiempo, los datos deben incluir una columna de tiempo. Consulte la documentación de su [origen de datos](AMG-data-sources.md) específico para obtener más información sobre cómo incluir una columna de tiempo.

## Unidades de tiempo e intervalos relativos
<a name="time-units-and-relative-ranges"></a>

 Se admiten las siguientes unidades de tiempo: 
+ `s` (segundos)
+ `m` (minutos)
+ `h` (horas)
+ `d` (días)
+ `w` (semanas)
+ `M` (meses)
+ `y` (años)

 Utilice el operador menos para ir atrás en el tiempo en relación con el momento actual. Para mostrar el periodo completo de la unidad (como día, semana o mes), agregue `/<time unit>`. 

 Utilice el operador más para avanzar en el tiempo en relación con el momento actual. Puede usar esta característica para ver los datos pronosticados para el futuro. 

 Estos son algunos ejemplos: 


|  Ejemplo de intervalo relativo  |  De  |  Para  | 
| --- | --- | --- | 
|  Últimos 5 minutos  |  now-5m  |  now  | 
|  El día hasta ahora  |  now/d  |  now  | 
|  Esta semana  |  now/w  |  now/w  | 
|  Semana hasta la fecha  |  now/w  |  now  | 
|  Mes anterior  |  now-1M/M  |  now-1M/M  | 

## Controles de intervalo de tiempo comunes
<a name="common-time-range-controls"></a>

 El panel y los controles de tiempo del panel tienen una interfaz de usuario común con las opciones siguientes. 

### Intervalo de tiempo actual
<a name="current-time-range"></a>

 El intervalo de tiempo actual, también denominado *selector de tiempo*, muestra el intervalo de tiempo que se muestra actualmente en el panel que está viendo. 

 Haga una pausa sobre el campo para ver las marcas de tiempo exactas del intervalo y su origen (por ejemplo, la hora del navegador local). 

 Para cambiar el intervalo de tiempo, elija el intervalo de tiempo actual. Para cambiar la hora actual, utilice un *intervalo de tiempo relativo*, como los últimos 15 minutos, o un *intervalo de tiempo absoluto*, como `2020-05-14 00:00:00 to 2020-05-15 23:59:59`. 

### Intervalo de tiempo relativo
<a name="relative-time-range"></a>

 Seleccione el intervalo de tiempo relativo en la lista **Intervalos de tiempo relativos**. A continuación, se muestran algunos ejemplos de intervalos de tiempo relativos: 
+  Últimos 30 minutos 
+  Últimas 12 horas 
+  Últimos 7 días 
+  Últimos 2 años 
+  Ayer 
+  Anteayer 
+  Este día de la semana pasada 
+  Hoy hasta ahora 
+  Esta semana hasta ahora 
+  Este mes hasta ahora 

### Intervalo de tiempo absoluto
<a name="absolute-time-range"></a>

 Establezca un intervalo de tiempo absoluto de una de las dos formas siguientes: 
+  Ingrese valores en los campos **Desde** y **Hasta**. Puede ingresar valores de tiempo exactos o valores relativos, por ejemplo `now-24h` y, a continuación, elija **Aplicar intervalo de tiempo**. 
+  Elija el campo **Desde** o **Hasta**. Amazon Managed Grafana muestra un calendario. Elija el día o los días que desee utilizar como intervalo de tiempo actual y, a continuación, seleccione **Aplicar intervalo de tiempo**. 

 Amazon Managed Grafana también muestra los intervalos absolutos utilizados recientemente. 

### Reducción (Cmd \$1 Z o Ctrl \$1 Z)
<a name="zoom-out-cmdz-or-ctrlz"></a>

 Para ver un intervalo de tiempo mayor en el panel o en la visualización del panel, seleccione el icono **Reducir el intervalo de tiempo**. 

### Ampliación (solo para visualizaciones de gráficos)
<a name="zoom-in-only-applicable-to-graph-visualizations"></a>

 En la visualización de gráficos, arrastre para seleccionar el intervalo de tiempo que desea ver. 

### Actualización del panel de control
<a name="refresh-dashboard"></a>

 Elija el icono **Actualizar panel de control** para ejecutar inmediatamente todas las consultas del panel y actualizar las visualizaciones. Amazon Managed Grafana cancela todas las solicitudes pendientes cuando se inicia una nueva actualización. 

 De forma predeterminada, Amazon Managed Grafana no actualiza automáticamente el panel. Las consultas se ejecutan según su propio horario de acuerdo con la configuración del panel. Sin embargo, si desea actualizar el panel con regularidad, elija la flecha hacia abajo situada junto al icono **Actualizar panel de control** y, a continuación, seleccione un intervalo de actualización. 

## Configuración de hora del panel
<a name="dashboard-time-settings"></a>

 La configuración de hora se guarda en cada panel de control. 

 Para acceder a la configuración de hora del panel, seleccione el icono **Configuración del panel** (engranaje) en la parte superior de la pantalla. La configuración se encuentra en la sección **Opciones de tiempo** de la pestaña **General**. 
+  **Zona horaria**: zona horaria local del servicio o sistema que está supervisando. Esto puede resultar útil cuando supervisa un sistema o servicio que funciona en varias zonas horarias. 
  +  **Valor predeterminado**: zona horaria seleccionada de forma predeterminada para el perfil del usuario, el equipo o la organización. Si no se especifica una zona horaria para el perfil del usuario, el equipo del que es miembro el usuario o la organización, Amazon Managed Grafana utiliza la hora local del navegador. 
  +  **Hora del navegador**: zona horaria que está configurada para el navegador que se está utilizando. Suele ser la zona horaria configurada en el equipo. 
  +  **Hora universal coordinada**: zonas horarias según la norma ISO 8601, incluida la UTC. Para obtener más información, consulte una [lista de zonas horarias](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones). 
+  **Actualización automática**: opciones personalizables, el tiempo relativo y la configuración de actualización automática. Las entradas se separan con comas y aceptan cualquier unidad de tiempo válida. 
+  **Retraso ahora now-**: valor de retraso temporal que anula el valor `now`. Por lo general, esta característica se utiliza para evitar valores nulos al adaptarse a los retrasos conocidos en la agregación de datos. 
+  **Ocultar el selector de tiempo**: opción para no mostrar el selector de tiempo. 

## Anulación y cambio de hora del panel
<a name="panel-time-overrides-and-timeshift"></a>

 En [Opciones de consulta](panel-queries.md#query-options), puede anular el intervalo de tiempo relativo de los paneles individuales y hacer que sean diferentes del seleccionado en el selector de tiempo del panel, situado en la barra de navegación superior. Puede mostrar métricas de diferentes periodos de tiempo o días al mismo tiempo. 

## Control del intervalo de tiempo mediante una URL
<a name="control-the-time-range-using-a-url"></a>

 Para controlar el intervalo de tiempo de un panel, proporcione los siguientes parámetros de consulta en la URL del panel: 
+  `from`: define el límite inferior del intervalo de tiempo, especificado en ms epoch o tiempo relativo. Para obtener más información, consulte [Intervalo de tiempo relativo](#relative-time-range). 
+  `to` define el límite superior del intervalo de tiempo, especificado en ms epoch o tiempo relativo. Para obtener más información, consulte [Intervalo de tiempo relativo](#relative-time-range). 
+  `time` y `time.window`: definen un intervalo de tiempo de `time-time.window/2` hasta `time+time.window/2`. Ambos parámetros deben especificarse en milisegundos. Por ejemplo, `?time=1500000000000&time.window=10000` da como resultado un intervalo de tiempo de 10 segundos comprendido entre 1499999995000 y 1500000005000. 

# Importación y exportación de paneles
<a name="dashboard-export-and-import"></a>

****  
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 8.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.md).  
Para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).

 Los paneles de Amazon Managed Grafana se pueden exportar e importar fácilmente, ya sea desde la interfaz de usuario o desde la [API HTTP] 

## Exportación de un panel de control
<a name="exporting-a-dashboard"></a>

 Los paneles se exportan en formato JSON de Amazon Managed Grafana y contienen todo lo que necesita, incluidos el diseño, las variables, los estilos, los orígenes de datos y las consultas, para importar el panel más adelante. 

 Se accede a la característica de exportación desde la ventana para compartir, que se abre pulsando el botón para compartir en el menú del panel.

### Cómo hacer que un panel de control sea portátil
<a name="making-a-dashboard-portable"></a>

 Al exportar un panel para que lo usen otros usuarios, es recomendable agregar variables de plantilla para valores como un prefijo de métrica (utilice una variable constante) y un nombre de servidor. 

 Una variable de plantilla de tipo `Constant` se oculta automáticamente en el panel. También se agrega como entrada obligatoria cuando se importa el panel. Para obtener más información acerca de las plantillas y sus variables, consulte [Plantillas y variables](templates-and-variables.md). 

## Importación de un panel
<a name="importing-a-dashboard"></a>

 Para importar un panel, seleccione el icono \$1 en el menú lateral y, a continuación, seleccione **Importar**. 

 Puede cargar un archivo JSON de un panel, pegar la URL de un panel o pegar el texto JSON de un panel directamente en el área de texto. 

 En el paso 2 del proceso de importación, puede cambiar el nombre del panel, especificar el origen de datos que desea que utilice el panel y especificar cualquier prefijo de métrica (en el caso de que el panel lo use). 

## Descubrimiento de paneles en Grafana.com
<a name="discover-dashboards-on-grafana.com"></a>

 Encuentre paneles para aplicaciones de servidor comunes en [Grafana.com/dashboards](https://grafana.com/dashboards). 

# Historial de versiones del panel
<a name="dashboard-version-history"></a>

****  
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 8.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.md).  
Para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).

 Siempre que guarde una versión del panel de control, se guardará una copia de esa versión para que no se pierdan las versiones anteriores. Se puede obtener una lista de estas versiones al seleccionar **Configuración del panel** y, a continuación, seleccionar **Versiones** en el menú de la izquierda. 

 La característica de historial de versiones del panel de control le permite comparar y restaurar versiones del panel de control guardadas anteriormente. 

## Comparación de dos versiones del panel de control
<a name="comparing-two-dashboard-versions"></a>

 Para comparar dos versiones del panel, seleccione las dos versiones de la lista que quiere comparar. Tras seleccionar dos versiones, elija **Comparar versiones** para abrir la vista de diferencias. De forma predeterminada, verá un resumen textual de los cambios, como en la imagen disponible a continuación.

 Para ver la diferencia del JSON sin procesar que representa su panel, seleccione **Ver diferencias de JSON**. 

 Para restaurar la versión anterior con la que está comparando, seleccione **Restaurar a la versión <x>**.

## Restauración a una versión del panel de control guardada anteriormente
<a name="restoring-to-a-previously-saved-dashboard-version"></a>

 Si necesita restaurar una versión del panel guardada anteriormente, puede hacerlo con el botón “Restaurar” situado a la derecha de una fila de la lista de versiones del panel o eligiendo **Restaurar a la versión <x>** en la vista de diferencias. Cuando decida restaurar, aparecerá un cuadro emergente en el que se le pedirá que confirme la restauración. 

 Tras la restauración a una versión anterior, se creará una nueva versión con los mismos datos exactos que la versión anterior, pero con un número de versión diferente. Esto se indica en la columna **Notas**. Esto ayuda a garantizar que las versiones anteriores del panel no se vean afectadas por el cambio. 

# Métodos abreviados de teclado
<a name="keyboard-shortcuts"></a>

****  
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 8.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.md).  
Para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).

 Amazon Managed Grafana tiene varios atajos de teclado disponibles. Para ver todos los atajos de teclado disponibles en su versión de Amazon Managed Grafana, pulse **Shift \$1 ?** en el teclado. 

 **Amazon Managed Grafana incluye los siguientes atajos populares:** 
+  **Ctrl \$1 S**: guarda el panel actual. 
+  **Ctrl \$1 F**: abre el buscador o la búsqueda del panel. 
+  **Ctrl \$1 H**: oculta todos los controles (ocultar los controles funciona bien en las pantallas de TV). 
+  **Escape**: sale de un gráfico cuando está en pantalla completa o en modo de edición. 

# Modelo JSON del panel de control
<a name="dashboard-json-model"></a>

****  
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 8.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.md).  
Para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).

 Un panel en Amazon Managed Grafana está representado por un objeto JSON, que almacena los metadatos de su panel. Los metadatos del panel incluyen las propiedades del panel de control, los metadatos de los paneles, las variables de plantilla y las consultas del panel.

**Visualización del JSON de un panel de control**

1.  Abra un panel de control. 

1.  En la barra de navegación superior, elija **Administrar panel**. 

1.  Seleccione **Ver JSON** en el menú desplegable. 

## Campos JSON
<a name="dashboard-json-fields"></a>

 Cuando un usuario crea un panel de control nuevo, se inicializa un nuevo objeto JSON del panel de control con los siguientes campos. 

**nota**  
 En el siguiente JSON, `id` se muestra como `null`, que es el valor predeterminado que se le asigna hasta que se guarde un panel. Tras guardar un panel, se asigna un valor entero al campo `id`. 

```
{
  "id": null,
  "uid": "cLV5GDCkz",
  "title": "New dashboard",
  "tags": [],
  "style": "dark",
  "timezone": "browser",
  "editable": true,
  "hideControls": false,
  "graphTooltip": 1,
  "panels": [],
  "time": {
    "from": "now-6h",
    "to": "now"
  },
  "timepicker": {
    "time_options": [],
    "refresh_intervals": []
  },
  "templating": {
    "list": []
  },
  "annotations": {
    "list": []
  },
  "refresh": "5s",
  "schemaVersion": 17,
  "version": 0,
  "links": []
}
```

 En la siguiente tabla, se proporcionan detalles de uso de cada campo del JSON del panel. 


|  Name  |  De uso  | 
| --- | --- | 
|  id  |  Identificador numérico único del panel (generado por la base de datos).  | 
|  uid  |  Identificador único del panel que cualquier persona puede generar. uid es una cadena de entre 8 y 40 caracteres.  | 
|  title  |  Título actual del panel.  | 
|  etiquetas  |  Etiquetas que están asociadas al panel. En el JSON, las etiquetas son una matriz de cadenas.  | 
|  style  |  Tema del panel (por ejemplo, dark o light).  | 
|  timezone  |  Zona horaria del panel (utc o browser).  | 
|  editable  |  Si se puede editar un panel.  | 
|  graphTooltip  |  Estilo de la información sobre herramientas. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/grafana/latest/userguide/dashboard-json-model.html)  | 
|  time  |  Intervalo de tiempo del panel (por ejemplo, últimas 6 horas, últimos 7 días).  | 
|  timepicker  |  Metadatos del selector de tiempo. Para obtener más información, consulte [Selector de tiempo](#dashboard-json-timepicker).  | 
|  templating  |  Metadatos de la plantilla. Para obtener más información, consulte [Plantillas y variables](templates-and-variables.md).  | 
|  annotations  |  Metadatos de las anotaciones. Para obtener más información, consulte [Anotaciones](dashboard-annotations.md).  | 
|  refresh  |  Intervalo de actualización automática.  | 
|  schemaVersion  |  Versión del esquema JSON (entero), que se incrementa cada vez que una actualización de Amazon Managed Grafana cambia el esquema.  | 
|  version  |  Versión del panel (entero), que se incrementa cada vez que se actualiza el panel.  | 
|  panels  |  Matriz de paneles. Para obtener más información, consulte [Paneles](#dashboard-JSON-panels).  | 

## Paneles
<a name="dashboard-JSON-panels"></a>

 Los paneles son los componentes básicos de un panel de control. Consiste en consultas de orígenes de datos, tipos de gráficos, alias y otros datos. El JSON del panel consta de una matriz de objetos JSON, cada uno de los cuales representa un panel diferente. La mayoría de los campos son comunes a todos los paneles, pero algunos campos dependen del tipo de panel. En el siguiente ejemplo se muestra el JSON de un panel de texto.

```
"panels": [
  {
    "type": "text",
    "title": "Panel Title",
    "gridPos": {
      "x": 0,
      "y": 0,
      "w": 12,
      "h": 9
    },
    "id": 4,
    "mode": "markdown",
    "content": "# title"
  }
```

### Tamaño y posición del panel
<a name="panel-size-and-position"></a>

 La propiedad `gridPos` describe el tamaño y la posición del panel en las coordenadas de la cuadrícula: 
+  `w`: 1-24. El ancho del panel se divide en 24 columnas. 
+  `h`: en unidades de altura de la cuadrícula. Cada unidad de altura de la cuadrícula representa 30 píxeles. 
+  `x`: posición x. La posición x utiliza la misma unidad de columna que `w`. 
+  `y`: posición y. La posición y utiliza la misma unidad de altura de la cuadrícula que `h`. 

 La cuadrícula tiene una gravedad negativa que mueve los paneles hacia arriba si hay espacio vacío por encima de un panel. 

### Selector de tiempo
<a name="dashboard-json-timepicker"></a>

En el siguiente ejemplo, se muestran las opciones `timepicker`.

```
"timepicker": {
    "collapse": false,
    "enable": true,
    "notice": false,
    "now": true,
    "refresh_intervals": [
      "5s",
      "10s",
      "30s",
      "1m",
      "5m",
      "15m",
      "30m",
      "1h",
      "2h",
      "1d"
    ],
    "status": "Stable",
    "type": "timepicker"
  }
```

 En la tabla siguiente se proporcionan los detalles de uso para `timepicker`. 


|  Name  |  De uso  | 
| --- | --- | 
|  collapse  |  Si timepicker está contraído  | 
|  enable  |  Si timepicker está activado  | 
|  notice  |  TODO  | 
|  now  |  TODO  | 
|  refresh\$1intervals  |  TODO  | 
|  status  |  TODO  | 
|  type  |  TODO  | 

### Plantillas
<a name="json-templating"></a>

 El campo `templating` contiene un conjunto de variables de plantilla con los valores guardados y otros metadatos. En el siguiente ejemplo, se muestra metadatos de `templating`. 

```
 "templating": {
    "enable": true,
    "list": [
      {
        "allFormat": "wildcard",
        "current": {
          "tags": [],
          "text": "prod",
          "value": "prod"
        },
        "datasource": null,
        "includeAll": true,
        "name": "env",
        "options": [
          {
            "selected": false,
            "text": "All",
            "value": "*"
          },
          {
            "selected": false,
            "text": "stage",
            "value": "stage"
          },
          {
            "selected": false,
            "text": "test",
            "value": "test"
          }
        ],
        "query": "tag_values(cpu.utilization.average,env)",
        "refresh": false,
        "type": "query"
      },
      {
        "allFormat": "wildcard",
        "current": {
          "text": "apache",
          "value": "apache"
        },
        "datasource": null,
        "includeAll": false,
        "multi": false,
        "multiFormat": "glob",
        "name": "app",
        "options": [
          {
            "selected": true,
            "text": "tomcat",
            "value": "tomcat"
          },
          {
            "selected": false,
            "text": "cassandra",
            "value": "cassandra"
          }
        ],
        "query": "tag_values(cpu.utilization.average,app)",
        "refresh": false,
        "regex": "",
        "type": "query"
      }
    ]
  }
```

 En la tabla siguiente se proporcionan los detalles de uso para la sección de plantillas. 


|  Name  |  De uso  | 
| --- | --- | 
|  enable  |  Si las plantillas están activadas.  | 
|  list  |  Matriz de objetos, cada uno de los cuales representa una variable de plantilla.  | 
|  allFormat  |  Formato que se utilizará al obtener todos los valores del origen de datos (por ejemplo, wildcard, glob, regex y pipe).  | 
|  current  |  Muestra el texto o el valor de la variable seleccionada actualmente en el panel.  | 
|  origen de datos  |  Muestra el origen de datos de las variables.  | 
|  includeAll  |  Si la opción de todos los valores está disponible.  | 
|  multi  |  Si se pueden seleccionar varios valores de la lista de valores de variables.  | 
|  multiFormat  |  El formato que se utilizará al obtener series temporales del origen de datos.  | 
|  name  |  Nombre de una variable.  | 
|  options  |  El conjunto de text/value pares de variables disponibles para su selección en el tablero  | 
|  consulta  |  La consulta del origen de datos que se utiliza para obtener los valores de una variable.  | 
|  refresh  |  TODO  | 
|  regex  |  TODO  | 
|  type  |  Tipo de variable (custom, query o interval).  | 

# Paneles con scripts
<a name="scripted-dashboards"></a>

****  
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 8.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.md).  
Para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).

**aviso**  
 Esta característica está en desuso y se eliminará en la próxima versión. 

 Si tiene muchos nombres de métricas que cambian (por ejemplo, nuevos servidores) siguiendo un patrón definido, crear nuevos paneles constantemente puede llevar mucho tiempo. 

 Con los paneles con scripts, puede crear sus paneles de forma dinámica utilizando. JavaScript En la carpeta de instalación de Grafana, en `public/dashboards/`, hay un archivo llamado `scripted.js`. Este archivo contiene un ejemplo de un panel con scripts. Puede acceder a él mediante la URL `http://grafana_url/dashboard/script/scripted.js?rows=3&name=myName`. 

 Al abrir `scripted.js`, puede ver cómo lee los parámetros de URL de la variable `ARGS` y, a continuación, agrega filas y paneles. 

## Ejemplo: scripted.js
<a name="example"></a>

```
var seriesName = 'argName';

if (!_.isUndefined(ARGS.name)) {
  seriesName = ARGS.name;
}

dashboard.panels.push({
  title: 'Events',
  type: 'graph',
  fill: 1,
  linewidth: 2,
  gridPos: {
    h: 10,
    w: 24,
    x: 0,
    y: 10,
  },
  targets: [
    {
      target: "randomWalk('" + seriesName + "')",
    },
    {
      target: "randomWalk('random walk2')",
    },
  ],
});

return dashboard;
```

## Más ejemplos
<a name="more-examples"></a>

 Puede encontrar más ejemplos en el directorio `public/dashboards/` de su instalación de Grafana. 

# Explore
<a name="explore"></a>

****  
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 8.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.md).  
Para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).

 En un espacio de trabajo de Grafana, en la interfaz de usuario del panel se proporcionan herramientas para crear paneles de visualización. *Explore* elimina todas las opciones de paneles para que pueda centrarse en la consulta. Itere hasta que tenga una consulta funcional y, a continuación, planifique y cree un panel. 

 Para la supervisión de la infraestructura y la respuesta a incidentes, ya no es necesario cambiar a otras herramientas para depurar lo que ha fallado. Puede usar Explore para profundizar en sus métricas y registros y encontrar la causa.

 Explore facilita la visualización de los datos sin necesidad de crear un panel. Si el origen de datos admite datos de gráficos y tablas, en Explore se muestran los resultados tanto en forma de gráfico como de tabla. Esto lo ayuda a ver las tendencias de los datos y más detalles al mismo tiempo. 

## Inicio de la exploración
<a name="start-exploring"></a>

**nota**  
 De forma predeterminada, los usuarios con el rol de espectador no pueden editar Explore ni tienen acceso. 

 El icono de **Explore** del menú de la izquierda abre una pestaña Explore vacía. 

 Para empezar con una consulta existente en un panel, elija la opción **Explore** en el menú **Panel**. Se abrirá una pestaña Explore que contiene la consulta del panel. A continuación, puede modificar o iterar la consulta fuera de su panel. 

 Elija su origen de datos en la lista desplegable de la parte superior izquierda. Prometheus tiene una implementación de Explore personalizada. Los demás orígenes de datos utilizan su editor de consultas estándar. 

 En el campo de consulta, puede escribir la consulta y explorar los datos. Hay tres botones al lado del campo de consulta: un botón para borrar (X), un botón para agregar consulta (\$1) y el botón para eliminar una consulta (-). Al igual que en el editor de consultas del panel, puede agregar y eliminar varias consultas. 

## División y comparación
<a name="split-and-compare"></a>

 La función de vista dividida es una forma de comparar gráficos y tablas side-by-side o de ver datos relacionados juntos en una página. Seleccione **Dividir** para duplicar la consulta actual y dividir la página en dos side-by-side consultas. Tiene la opción de seleccionar un origen de datos diferente para la nueva consulta. Esto le da la oportunidad de comparar la misma consulta para dos servidores diferentes o de comparar el entorno de ensayo con el entorno de producción. 

 En la vista dividida, los selectores de tiempo de ambos paneles se pueden vincular (si cambia uno, también se cambiará el otro) seleccionando uno de los botones de sincronización horaria adjuntos a los selectores de tiempo. Al vincular los selectores de tiempo, se mantienen sincronizadas las horas de inicio y finalización de las consultas de la vista dividida, de modo que se puede ver el mismo intervalo de tiempo en ambos paneles divididos. 

 Para cerrar la consulta recién creada, seleccione **Cerrar división**.

## Uso compartido de un enlace abreviado
<a name="share-shortened-link"></a>

 Utilice la función **Compartir enlaces abreviados** para crear formatos más pequeños y sencillos URLs `/goto/:uid` en lugar de compartirlos más largos URLs que contengan parámetros de consulta complejos. Para crear un enlace abreviado, seleccione la opción **Compartir** en la barra de herramientas de Explore. Los enlaces abreviados que nunca se utilizan se eliminan automáticamente después de 7 días. 

## Historial de consultas
<a name="query-history"></a>

 El historial de consultas es una lista de consultas que ha utilizado en Explore. El historial es local en el navegador y no se comparte. Para abrir su historial e interactuar con él, seleccione **Historial de consultas** en Explore. 

### Visualización del historial de consultas
<a name="view-query-history"></a>

 FIn en el historial de consultas, puede hacer lo siguiente: 
+  Ejecute una consulta. 
+  Crear o editar un comentario. 
+  Copiar una consulta al portapapeles. 
+  Copiar un enlace abreviado con la consulta en el portapapeles. 
+  Destacar una consulta. 

### Administración de las consultas favoritas
<a name="manage-favorite-queries"></a>

 Todas las consultas que se han destacado en la pestaña Historial de consultas se muestran en la pestaña Destacadas. Puede acceder a sus consultas favoritas más rápido y reutilizarlas sin tener que volver a escribirlas desde allí. 

### Ordenación del historial de consultas
<a name="sort-query-history"></a>

 De forma predeterminada, en el historial de consultas se muestran las consultas más recientes. Puede ordenar el historial por fecha o por nombre de origen de datos en orden ascendente o descendente. 

En el lado derecho del historial de consultas, en la lista desplegable, seleccione una de las siguientes opciones: campo.
+  Lo más reciente primero 
+  Lo más antiguo primero 
+  Origen de datos (A-Z) 
+  Origen de datos (Z-A) 

**nota**  
 Si está en una vista dividida, el modo de ordenación solo se aplica al panel activo. 

### Filtración del historial de consultas
<a name="filter-query-history"></a>

 En las pestañas **Historial de consultas** y **Destacadas**, puede filtrar el historial de consultas por nombre de origen de datos. 

1. Seleccione **Filtrar consultas para orígenes de datos específicos**.

1. Seleccione el origen de datos que desee usar para filtrar el historial. Puede seleccionar varios orígenes de datos.

En la pestaña **Historial de consultas**, puede usar el deslizador vertical para filtrar las consultas por fecha:
+ Arrastre el controlador inferior para ajustar la fecha de inicio.
+ Arrastre el controlador superior para ajustar la fecha de finalización. 

**nota**  
Si está en una vista dividida, los filtros se aplican solo al panel activo. 

### Búsqueda en el historial de consultas
<a name="search-in-query-history"></a>

 Puede buscar en su historial todas las consultas y comentarios. Es posible buscar consultas en las pestañas **Historial de consultas** y **Destacadas**. 

1.  Seleccione el campo **Buscar consultas**. 

1.  En el campo de búsqueda, escriba el término de búsqueda. 

### Configuración del historial de consultas
<a name="query-history-settings"></a>

 Puede personalizar el historial de consultas en la pestaña **Configuración**. En la siguiente tabla se muestran las opciones disponibles. 


|  Opción  |  Predeterminado  | 
| --- | --- | 
|  Especificar durante cuánto tiempo Grafana guardará el historial de consultas.  |  1 semana  | 
|  Cambiar la pestaña activa predeterminada. |  Pestaña Historial de consultas  | 
|  Mostrar las consultas solo para el origen de datos que está activo actualmente en Explore.  |  True  | 
|  Borrar el historial de consultas.  |  (Seleccione Borrar el historial de consultas para eliminar permanentemente todas las consultas almacenadas).  | 

**nota**  
La configuración del historial de consultas es global y se aplica a ambos paneles en modo dividido.

## Características específicas de Prometheus
<a name="prometheus-specific-features"></a>

 La primera versión de Explore incluye una experiencia de consulta personalizada para Prometheus. Cuando ejecuta una consulta, Grafana en realidad ejecuta dos consultas: una consulta de Prometheus normal para el gráfico y una consulta instantánea para la tabla. Una consulta instantánea devuelve el último valor de cada serie temporal, lo que muestra un buen resumen de los datos que se muestran en el gráfico. 

### Explorador de métricas
<a name="metrics-explorer"></a>

 En el lado izquierdo del campo de consulta, seleccione **Métricas** para abrir el Explorador de métricas. Se muestra un menú jerárquico con métricas agrupadas por su prefijo. Por ejemplo, todas las métricas de Alertmanager se agrupan bajo el prefijo `alertmanager`. Este es un buen punto de partida para explorar qué métricas están disponibles. 

### Campo Consulta
<a name="query-field"></a>

 El campo Consulta permite completar automáticamente los nombres y funciones de las métricas y funciona prácticamente de la misma manera que el editor de consultas estándar de Prometheus. Pulse **Entrar** para ejecutar una consulta. 

 Se puede acceder al menú Autocompletar si se pulsa **Ctrl \$1 Espacio**. El menú Autocompletar contiene una nueva sección Historial con una lista de las consultas ejecutadas recientemente. 

 Las sugerencias pueden aparecer en el campo Consulta. Elija una sugerencia para actualizar su consulta con el cambio sugerido. 
+  En el caso de los contadores (métricas que aumentan monótonamente), se sugiere una función de tasa. 
+  En el caso de los buckets, se sugiere una función de histograma. 
+  En el caso de las reglas de registro, es posible ampliarlas.

### Filtros de tablas
<a name="table-filters"></a>

 Pulse el botón **Filtrar** en la columna de **etiquetas** de un panel de tabla para agregar filtros a la expresión de consulta. También puede agregar filtros para varias consultas. El filtro se agrega para todas las consultas. 

## Integración de registros
<a name="logs-integration"></a>

 También puede usar Explore para investigar sus registros con los siguientes orígenes de datos: 
+  InfluxDB 
+  Elasticsearch 

### Visualización de registros
<a name="logs-visualization"></a>

 Los resultados de las consultas de registro se muestran como histogramas en el gráfico y los registros individuales se muestran a continuación. Si el origen de datos no envía los datos del histograma para el intervalo de tiempo solicitado, el modelo de registros calcula una serie temporal en función de los recuentos de filas del registro agrupados en buckets por un intervalo de tiempo calculado automáticamente. A continuación, el inicio del histograma se ancla mediante la marca de tiempo de la primera fila del registro a partir del resultado. El final de la serie temporal está anclado al intervalo **Hasta** del selector de tiempo. 

#### Nivel de registro
<a name="log-level"></a>

 En el caso de los registros en los que se especifica una etiqueta de **nivel**, Grafana utiliza el valor de la etiqueta para determinar el nivel del registro y, en consecuencia, actualizar su color. Si el registro no tiene una etiqueta de nivel especificada, Grafana analiza el registro para averiguar si su contenido coincide con alguna de las expresiones admitidas. El nivel de registro siempre viene determinado por la primera coincidencia. Si Grafana no puede determinar un nivel de registro, se visualizará con el nivel de registro **desconocido**. En la siguiente tabla se muestran los niveles de registro y la asignación de las abreviaturas y expresiones de nivel de registro. 


|  Expresiones admitidas  |  Nivel de registro  |  Color  | 
| --- | --- | --- | 
|  emerg  |  crítico  |  morado  | 
|  fatal  |  crítico  |  morado  | 
|  alerta  |  crítico  |  morado  | 
|  crit  |  crítico  |  morado  | 
|  crítico  |  crítico  |  morado  | 
|  err  |  error  |  red  | 
|  eror  |  error  |  red  | 
|  error  |  error  |  red  | 
|  aviso  |  Advertencia  |  amarillo  | 
|  Advertencia  |  Advertencia  |  amarillo  | 
|  info  |  info  |  green  | 
|  información  |  info  |  green  | 
|  aviso  |  info  |  green  | 
|  dbug  |  debug  |  azul  | 
|  debug  |  debug  |  azul  | 
|  rastro  |  rastro  |  azul claro  | 
|  \$1  |  unknown  |  gris  | 

### Opciones de visualización
<a name="visualization-options"></a>

 Puede personalizar la forma en que se muestran los registros y seleccionar las columnas que se muestran. 

#### Time
<a name="visualization-options-time"></a>

 Esta opción muestra u oculta la columna de tiempo. Esta es la marca de tiempo asociada a la línea de registro tal como se indica en el origen de datos. 

#### Etiquetas únicas
<a name="visualization-options-unique-labels"></a>

 Esta opción muestra u oculta la columna de etiquetas únicas, que incluye solo las etiquetas que no son comunes. Todas las etiquetas comunes se muestran arriba.

#### Ajuste de líneas
<a name="visualization-options-wrap-lines"></a>

 Para usar el ajuste de líneas en la pantalla, establézcalo en **True**. Si se establece esta opción en **False**, se produce un desplazamiento horizontal. 

#### Eliminación de duplicados
<a name="visualization-options-deduping"></a>

 Los datos de registro pueden ser muy repetitivos. Explore puede ayudar, ya que oculta las líneas de registro duplicadas. Puede elegir entre diferentes algoritmos de eliminación de duplicados: 
+  **Exacto**: las coincidencias exactas se establecen en toda la línea, excepto en los campos de fecha. 
+  **Números**: las coincidencias se establecen en la línea después de eliminar números como la duración, las direcciones IP, etc. 
+  **Firma**: la forma más agresiva de eliminación de duplicados, ya que elimina todas las letras y números. Las coincidencias se establecen con los espacios en blanco y los signos de puntuación restantes. 

#### Inversión del orden de los resultados
<a name="visualization-options-flip-results-order"></a>

 Puede cambiar el orden de los registros recibidos del orden descendente predeterminado (Lo más reciente primero) a un orden ascendente (Lo más antiguo primero). 

### Etiquetas y campos detectados
<a name="labels-and-detected-fields"></a>

 Cada fila de registro tiene un área ampliable con sus etiquetas y campos detectados para una interacción más sólida. Para todas las etiquetas, puede filtrar por inclusión (filtro positivo) y filtrar por exclusión (filtro negativo) las etiquetas seleccionadas. Cada campo o etiqueta también tiene un icono de estadísticas para mostrar estadísticas únicas en relación con todos los registros mostrados. 

### Cómo alternar los campos detectados
<a name="toggle-detected-fields"></a>

 Si sus registros están estructurados en JSON o logfmt, puede mostrar u ocultar los campos detectados. Expanda una línea de registro y, a continuación, elija el icono en forma de ojo para mostrar u ocultar los campos. 

 \$1\$1< docs-imagebox img=»/img/docs/explore/parsed-fields-7-2.gif "max-width="800px» caption="Alternar los campos detectados en Explore» >\$1\$1 

## Integración de rastreo
<a name="tracing-integration"></a>

 Puede visualizar los rastros de los orígenes de datos de rastreo en Explore. Orígenes de datos admitidos actualmente: 
+ [Conexión a un origen de datos de Jaeger](jaeger-data-source.md) 
+ [Conexión a un origen de datos de Tempo](tempo-data-source.md) 
+ [Conectarse a una fuente AWS X-Ray de datos](x-ray-data-source.md) 
+ [Conexión a un origen de datos de Zipkin](zipkin-data-source.md) 

 Para obtener información sobre el uso del editor de consultas, consulte la documentación del origen de datos específico. 

### Encabezado
<a name="explore-header"></a>

El encabezado incluye los elementos siguientes:
+  Título del encabezado, que muestra el nombre del intervalo raíz y el ID de rastro 
+  Búsqueda, que resalta los intervalos que contienen el texto buscado 
+  Metadatos sobre el rastro 

### Minimapa
<a name="explore-minimap"></a>

 En el minimapa se muestra una vista condensada de la línea temporal del rastro. Arrastre el ratón sobre el minimapa para ampliar un intervalo de tiempo más pequeño. Al hacer zoom, también se actualizará la línea temporal principal, por lo que será más fácil ver los intervalos más cortos. Si hace una pausa en el minimapa, al ampliarlo, verá el botón **Restablecer selección**, que restablece el zoom. 

### Plazo
<a name="explore-timeline"></a>

 En la línea temporal se muestra una lista de los intervalos del rastro. Cada fila de intervalos consta de los siguientes componentes: 
+ Botón **Expandir elementos secundarios**: expande o contrae todos los intervalos secundarios del intervalo seleccionado. 
+ Nombre del servicio: nombre del servicio que registró el intervalo.
+ Nombre de la operación: nombre de la operación que representa este intervalo.
+ Barra de duración del intervalo: representación visual de la duración de la operación dentro del rastro.

Al seleccionar cualquier lugar de la fila de intervalos, se muestran los detalles del intervalo. 

### Detalles del intervalo
<a name="explore-span-details"></a>

Los detalles del intervalo incluyen los siguientes elementos:
+  Nombre de operación 
+  Metadatos del intervalo 
+  Etiquetas (cualquier etiqueta asociada a este intervalo) 
+  Metadatos de proceso (metadatos sobre el proceso que registró este intervalo) 
+  Registros: lista de registros que documentó este intervalo y valores de clave asociados. En el caso de los registros de Zipkin, en la sección se muestran las anotaciones de Zipkin. 

## Navegación entre Explore y un panel
<a name="navigating-between-explore-and-a-dashboard"></a>

 Para acelerar los flujos de trabajo que implican cambiar periódicamente de Explore a un panel y viceversa, hemos agregado la posibilidad de volver al panel de origen después de acceder a Explore desde el menú desplegable del panel. 

 Cuando haya accedido a Explore, verá el botón “Atrás” en la barra de herramientas correspondiente. 

 Con solo pulsar el botón, volverá al panel de origen o, si quiere que los cambios que haga en Explore vuelvan al panel, solo tiene que pulsar la flecha situada junto al botón para que aparezca el elemento de menú “Volver al panel con los cambios”. 

## Inspector de consultas
<a name="query-inspector"></a>

 Para ayudar a depurar las consultas, Explore le permite investigar las solicitudes y respuestas de las consultas, así como las estadísticas de estas, mediante el inspector de consultas. Esta funcionalidad es similar a las pestañas **Estadísticas** y **Consulta** del inspector de paneles. Para obtener más información, consulte [Inspección del rendimiento de consultas](inspect-a-panel.md#inspect-query-performance) y [Visualización de la solicitud sin procesar y respuesta al origen de datos](inspect-a-panel.md#view-raw-request-and-response-to-data-source). 

# Vinculación
<a name="linking-in-Amazon-Managed-Service-for-Grafana"></a>

****  
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 8.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.md).  
Para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).

 Puede usar los enlaces para navegar entre los paneles de control más utilizados o para conectar otros con sus visualizaciones. Los enlaces le permiten crear accesos directos a otros paneles de control e incluso a sitios web externos. 

 Amazon Managed Grafana admite enlaces de panel y enlaces de datos. Los enlaces de panel de control se muestran en la parte superior del panel de control. Para acceder a enlaces de paneles, seleccione un icono situado en la esquina superior izquierda del panel. 

## ¿Qué enlace debe utilizar?
<a name="which-link-should-you-use"></a>

 Comience por examinar cómo se puede navegar actualmente entre los paneles. Si suele pasar de un conjunto de paneles de control a otro y tiene dificultades para encontrar el mismo contexto en cada uno de ellos, los enlaces pueden ayudarle a optimizar el flujo de trabajo. 

 El siguiente paso es determinar qué tipo de enlace es el adecuado para el flujo de trabajo. Aunque todos los tipos de enlaces de Grafana se utilizan para crear atajos a otros paneles o sitios web externos, funcionan en diferentes contextos. 
+  Para agregar enlaces que se relacionen con la mayoría o todos los paneles del panel, utilice [Enlaces de panel de control](dashboard-links.md). 
+  Para profundizar en paneles específicos, utilice [Enlaces de panel](panel-links.md).
+  Si desea vincular a sitios externos, puede usar un enlace de panel. 
+  Si desea profundizar en una serie específica, o incluso en una sola medición, utilice [Enlaces de datos](data-links.md). 

## Control del intervalo de tiempo mediante una URL
<a name="controlling-time-range-using-the-url"></a>

 Puede controlar el intervalo de tiempo de un panel proporcionando los siguientes parámetros de consulta en la URL del panel: 
+  `from` define el límite inferior del intervalo de tiempo, especificado en ms epoch. 
+  `to` define el límite superior del intervalo de tiempo, especificado en ms epoch. 
+  `time` y `time.window` definen un intervalo de tiempo de `time-time.window/2` hasta `time+time.window/2`. Ambos parámetros deben especificarse en milisegundos. Por ejemplo, `?time=1500000000000&time.window=10000` dará como resultado un intervalo de tiempo de 10 segundos comprendido entre 1499999995000 y 1500000005000. 

# Enlaces de panel de control
<a name="dashboard-links"></a>

****  
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 8.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.md).  
Para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).

 Al crear un enlace de panel de control, puede incluir el intervalo de tiempo y las variables de la plantilla actual para pasar directamente al mismo contexto en otro panel de control. Esto ayuda a garantizar que la persona a la que le envíe el enlace esté consultando los datos correctos. Para otros tipos de enlaces, consulte [Variables de enlace de datos](linking-in-Amazon-Managed-Service-for-Grafana.md#data-link-variables). 

 Después de agregar un enlace de panel, aparece en la esquina superior derecha del panel. 

## Adición de enlaces a paneles de control
<a name="add-links-to-dashboards"></a>

 Agregue enlaces a otros paneles de control en la parte superior del panel de control actual. 

1.  Mientras ve el panel al que desea agregar un enlace, elija el icono de engranaje ubicado en la parte superior de la pantalla para abrir **Configuración del panel**. 

1.  Seleccione **Enlaces** y, a continuación, seleccione **Agregar enlace de panel** o **Nuevo**. 

1.  En **Tipo**, seleccione **paneles de control**. 

1.  Seleccione las opciones de enlace: 
   +  **Con etiquetas**: ingrese etiquetas para limitar los paneles de control enlazados a solo aquellos con las etiquetas que haya ingresado. De lo contrario, el espacio de trabajo de Grafana incluye enlaces a todos los demás paneles. 
   +  **Como menú desplegable**: seleccione esta opción si va a vincular varios paneles y agregue un título opcional a la lista desplegable. Si esta opción no está seleccionada, el espacio de trabajo de Grafana muestra los enlaces de panel uno al lado del otro en la parte superior del panel. 
   +  **Intervalo de tiempo**: seleccione esta opción para incluir el intervalo de tiempo del panel de control en el enlace. Cuando el usuario elige el enlace, el panel vinculado se abre con el intervalo de tiempo indicado ya establecido.
   +  **Valores de variables**: seleccione esta opción para incluir en el enlace las variables de plantilla que se utilizan actualmente como parámetros de consulta en el enlace. Cuando el usuario elige el enlace, todas las plantillas coincidentes del panel vinculado se establecen con los valores del enlace.
   +  **Abrir en una pestaña nueva**: seleccione esta opción para abrir el enlace de panel en una nueva pestaña o ventana. 

1.  Elija **Añadir**. 

## Adición de un enlace URL a un panel de control
<a name="add-a-url-link-to-a-dashboard"></a>

 Agregue un enlace a una URL en la parte superior del panel de control actual. Puede vincularlo a cualquier URL disponible, incluidos los paneles de control, los paneles o los sitios externos. Incluso puede controlar el intervalo de tiempo para asegurarse de que el usuario vea los datos específicos en el espacio de trabajo de Grafana. 

1.  Mientras ve el panel para el que desea crear un enlace, elija el icono de engranaje ubicado en la parte superior de la pantalla para abrir **Configuración del panel**. 

1.  Seleccione **Enlaces** y, a continuación, seleccione **Agregar enlace de panel** o **Nuevo**. 

1.  En **Tipo**, seleccione **enlace**. 

1.  Seleccione las opciones de enlace: 
   +  **URL**: ingrese la URL a la que quiere vincular. Según el destino, es posible que desee incluir valores de campo.
   +  **Título**: ingrese el título que desee que muestre el enlace. 
   +  **Información sobre herramientas**: ingrese la información sobre herramientas que desea que muestre el enlace cuando el usuario pase sobre él. 
   +  **Icono**: elija el icono que desee que aparezca junto con el enlace. 
   +  **Intervalo de tiempo**: seleccione esta opción para incluir el intervalo de tiempo del panel de control en el enlace. Cuando el usuario elige el enlace, el panel vinculado se abre con el intervalo de tiempo indicado ya establecido. 
     +  `from` define el límite inferior del intervalo de tiempo, especificado en ms epoch. 
     +  `to` define el límite superior del intervalo de tiempo, especificado en ms epoch. 
     +  `time` y `time.window` definen un intervalo de tiempo de `time-time.window/2` hasta `time+time.window/2`. Ambos parámetros deben especificarse en milisegundos. Por ejemplo, `?time=1500000000000&time.window=10000` da como resultado un intervalo de tiempo de 10 segundos comprendido entre 1499999995000 y 1500000005000. 
   +  **Valores de variables**: seleccione esta opción para incluir en el enlace las variables de plantilla que se utilizan actualmente como parámetros de consulta en el enlace. Cuando el usuario elige el enlace, cualquier plantilla coincidente del panel vinculado se establece con los valores del enlace; por ejemplo, https://play.grafana. org/d/000000074/alerting? var-app=backend&var-server=backend\$101&var-server=backend\$103&var-interval = 1 h 
   +  **Abrir en una pestaña nueva**: seleccione esta opción para abrir el enlace de panel en una nueva pestaña o ventana. 

1.  Elija **Añadir**. 

## Actualización de un enlace de panel de control
<a name="update-a-dashboard-link"></a>

 Para cambiar o actualizar un enlace de panel existente, use el siguiente procedimiento. 

1.  En **Configuración del panel**, en la pestaña **Enlaces**, elija el enlace existente que desee editar. 

1.  Cambie la configuración y, a continuación, elija **Actualizar**. 

## Duplicación de un enlace de panel de control
<a name="duplicate-a-dashboard-link"></a>

 Para duplicar un enlace de panel existente, elija el icono de duplicado situado junto al enlace existente que desee duplicar. 

## Eliminación de un enlace de panel de control
<a name="delete-a-dashboard-link"></a>

 Para eliminar un enlace de panel existente, elija el icono de papelera del enlace que desea eliminar. 

# Enlaces de panel
<a name="panel-links"></a>

****  
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 8.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.md).  
Para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).

 Cada panel puede tener su propio conjunto de enlaces que se muestran en la esquina superior izquierda del panel. Puede vincular a cualquiera de los disponibles URLs, incluidos cuadros de mando, paneles o sitios externos. Incluso puede controlar el intervalo de tiempo para asegurarse de que el usuario vea los datos específicos en el espacio de trabajo de Grafana. 

Seleccione el icono de la esquina superior izquierda de un panel para ver los enlaces del panel disponibles. 

## Cómo agregar un enlace del panel
<a name="add-a-panel-link"></a>

1.  Haga una pausa en el panel en el que desee agregar un enlace y, a continuación, pulse **e**. También puede seleccionar la flecha desplegable situada junto al título del panel y, a continuación, seleccione **Editar**. 

1.  En la pestaña **Panel**, desplácese hacia abajo hasta la sección **Enlaces**. 

1.  Expanda **Enlaces** y, a continuación, elija **Agregar enlace**. 

1.  Ingrese un **título** para el enlace. El título se mostrará en la interfaz de usuario. 

1.  Ingrese la **URL** a la que quiere vincular. Puede incluir una de las variables de plantilla que se definen en el panel. Pulse **Ctrl \$1 Espacio** o **Cmd \$1 Espacio** y, a continuación, elija el campo **URL** para ver las variables disponibles. Al agregar variables de plantilla al enlace del panel, el enlace envía al usuario al contexto correcto, con las variables pertinentes ya establecidas. También puede utilizar variables de tiempo. 
   +  `from` define el límite inferior del intervalo de tiempo, especificado en ms epoch. 
   +  `to` define el límite superior del intervalo de tiempo, especificado en ms epoch. 
   +  `time` y `time.window` definen un intervalo de tiempo de `time-time.window/2` hasta `time+time.window/2`. Ambos parámetros deben especificarse en milisegundos. Por ejemplo, `?time=1500000000000&time.window=10000` da como resultado un intervalo de tiempo de 10 segundos comprendido entre 1499999995000 y 1500000005000. 

1.  Para abrirlo en una pestaña nueva, seleccione **Abrir en una pestaña nueva**. 

1.  Elija **Guardar** para guardar los cambios y cerrar la ventana. 

1.  Seleccione **Guardar** en la esquina superior derecha para guardar los cambios aplicados en el panel. 

## Actualización de un enlace de panel
<a name="update-a-panel-link"></a>

1.  En la pestaña **Panel**, busque el enlace en el que desea hacer cambios. 

1.  Seleccione el icono de **Editar** (lápiz) para abrir la ventana **Editar enlace**. 

1.  Realice los cambios necesarios. 

1.  Elija **Guardar** para guardar los cambios y cerrar la ventana. 

1.  Seleccione **Guardar** en la esquina superior derecha para guardar los cambios aplicados en el panel. 

## Eliminación de un enlace de panel
<a name="delete-a-panel-link"></a>

1.  En la pestaña **Panel**, busque el enlace que desea eliminar. 

1.  Elija el icono **X** situado al lado del enlace que desea eliminar. 

1.  Seleccione **Guardar** en la esquina superior derecha para guardar los cambios aplicados en el panel. 

# Enlaces de datos
<a name="data-links"></a>

****  
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 8.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.md).  
Para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).

 Los enlaces de datos proporcionan un contexto más detallado a sus enlaces. Puede crear enlaces que incluyan el nombre de la serie o incluso el valor. Por ejemplo, si en la visualización se muestran cuatro servidores, puede agregar un enlace de datos a uno o dos de ellos. 

 El enlace en sí es accesible de diferentes formas en función de la visualización. Para el panel de gráficos, debe elegir un punto o una línea de datos. Para un panel como estadísticas, indicadores o indicadores de barras, puede elegir cualquier parte de la visualización para abrir el menú contextual. 

 Puede usar las variables de los enlaces de datos para enviar personas a un panel de control detallado con los filtros de datos conservados. Por ejemplo, puede usar las variables para especificar un intervalo de tiempo, una serie y una selección de variables. Para obtener más información, consulte [Variables de enlace de datos](linking-in-Amazon-Managed-Service-for-Grafana.md#data-link-variables). 

## Sugerencias de escritura anticipada
<a name="typeahead-suggestions"></a>

 Al crear o actualizar un enlace de datos, pulse **Ctrl \$1 Espacio** o **Cmd \$1 Espacio** en el teclado para abrir las sugerencias de escritura anticipada y agregar variables a la URL con mayor facilidad. 

## Adición de un enlace de datos
<a name="add-a-data-link"></a>

1.  Haga una pausa en el panel en el que desee agregar un enlace y, a continuación, pulse **e**. También puede seleccionar la flecha desplegable situada junto al título del panel y, a continuación, seleccione **Editar**. 

1.  En la pestaña **Campo**, desplácese hacia abajo hasta la sección **Enlaces de datos**. 

1.  Expanda **Enlaces de datos** y, a continuación, seleccione **Agregar enlace**. 

1.  Ingrese un **Título** para el enlace. El título se mostrará en la interfaz de usuario. 

1.  Ingrese la **URL** a la que quiere vincular. 

    Puede agregar una de las variables de plantilla que se definen en el panel. Elija el campo **URL** y, a continuación, escriba **\$1** o pulse ****Ctrl \$1 Espacio o **Cmd \$1 Espacio** para ver una lista de las variables disponibles. Al agregar variables de plantilla al enlace del panel, el enlace envía al usuario al contexto correcto, con las variables pertinentes ya establecidas. Para obtener más información, consulte [Variables de enlace de datos](linking-in-Amazon-Managed-Service-for-Grafana.md#data-link-variables). 

1.  Para abrirlo en una pestaña nueva, seleccione **Abrir en una pestaña nueva**. 

1.  Elija **Guardar** para guardar los cambios y cerrar la ventana. 

1.  Seleccione **Guardar** en la esquina superior derecha para guardar los cambios aplicados en el panel. 

## Actualización de un enlace de datos
<a name="update-a-data-link"></a>

1.  En la pestaña **Campo**, busque el enlace en el que desea hacer cambios. 

1.  Seleccione el icono de **Editar** (lápiz) para abrir la ventana **Editar enlace**. 

1.  Realice los cambios necesarios. 

1.  Elija **Guardar** para guardar los cambios y cerrar la ventana. 

1.  Seleccione **Guardar** en la esquina superior derecha para guardar los cambios aplicados en el panel. 

## Eliminación de un enlace de datos
<a name="delete-a-data-link"></a>

1.  En la pestaña **Campo**, busque el enlace que quiere eliminar. 

1.  Elija el icono **X** situado al lado del enlace que desea eliminar. 

1.  Seleccione **Guardar** en la esquina superior derecha para guardar los cambios aplicados en el panel. 

## Variables de enlace de datos
<a name="data-link-variables"></a>

 Puede usar variables en los enlaces de datos para ver los campos, las etiquetas y los valores de las series. Para obtener más información sobre los enlaces de datos, consulte [Enlaces de datos](data-links.md). 

 Para ver una lista de las variables disponibles, escriba **\$1** en el campo **URL** del enlace de datos. 

 También puede usar variables de plantilla en sus enlaces de datos URLs. Para obtener más información, consulte [Plantillas y variables](templates-and-variables.md). 

### Variables de panel de intervalo de tiempo
<a name="time-range-panel-variables"></a>

 Puede usar las siguientes variables para incluir el intervalo de tiempo actual en la URL del enlace de datos: 
+  `__url_time_range`: el intervalo de tiempo del panel actual; por ejemplo, `?from=now-6h&to=now`. 
+  `$__from and $__to`— Para obtener más información, consulte [Variables globales] (\$1\$1< relref «.. /variables/variable-types/global-variables.md \$1\$1\$1from -and-\$1\$1to» >\$1\$1). 

### Variables de serie
<a name="series-variables"></a>

 Las variables específicas de la serie están disponibles en el espacio de nombres `__series`: 
+  `__series.name`: agrega el nombre de la serie a la URL. 
+  `__series.labels.<LABEL>`: agrega el valor de la etiqueta a la URL. Si la etiqueta contiene puntos, use la sintaxis `__series.labels["<LABEL>"]`. 

### Variables de campo
<a name="field-variables"></a>

 Las variables específicas del campo están disponibles en el espacio de nombres `__field`: 
+  `__field.name`: nombre del campo. 

### Variables de valor
<a name="value-variables"></a>

 Las variables específicas del valor están disponibles en el espacio de nombres `__value`: 
+  `__value.time`: marca de tiempo del valor (Unix ms epoch) en la URL; por ejemplo, `?time=1560268814105`. 
+  `__value.raw`: valor sin formato. 
+  `__value.numeric`: representación numérica de un valor. 
+  `__value.text`: representación de texto de un valor. 
+  `__value.calc`: nombre del cálculo si el valor es el resultado del cálculo. 

### Variables de plantilla
<a name="template-variables"></a>

 Al vincular a otro panel que utilice variables de plantilla, seleccione valores de variables para quien seleccione el enlace. 

 Use `var-myvar=${myvar}`, donde `myvar` es el nombre de la variable de plantilla que coincide con una variable del panel actual que desea usar. 

 Para agregar todas las variables del panel actual a la URL, utilice `__all_variables`. 

# Plantillas y variables
<a name="templates-and-variables"></a>

****  
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 8.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.md).  
Para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).

Una variable es un marcador de posición para un valor. Puede utilizar variables en las consultas de métricas y en los títulos de los paneles. Las variables le permiten crear paneles de control más interactivos y dinámicos. En lugar de codificar de forma rígida elementos como los nombres de servidores, aplicaciones y sensores en las consultas de métricas, puede utilizar variables en su lugar. 

Las variables se muestran como listas desplegables en la parte superior del panel de control. Al cambiar el valor mediante la lista desplegable situada en la parte superior del panel, las consultas de métricas del panel reflejan el nuevo valor. 

Pueden resultar especialmente útiles para los administradores que quieren permitir a los visualizadores ajustar las visualizaciones rápidamente, pero no quieren concederles permisos de edición completos. Los visualizadores de Grafana pueden utilizar variables. 

Al utilizar variables y plantillas, puede gestionar paneles de un único origen. Si tiene varios orígenes de datos o servidores idénticos, puede crear un panel de control y utilizar variables para cambiar lo que está viendo. Esto simplifica el mantenimiento y la conservación. 

Para obtener una lista de los tipos de variables admitidos y las instrucciones para agregar cada tipo de variable, consulte [Tipos de variables](variables-types.md).

## Plantillas
<a name="templates"></a>

 Una *plantilla* es cualquier consulta que contiene una variable. 

Por ejemplo, si administrara un panel para supervisar varios servidores, podría crear un panel para cada servidor. O puede crear un panel y utilizar paneles con consultas de plantilla, como se muestra en el siguiente ejemplo. 

```
wmi_system_threads{instance=~"$server"}
```

Los valores de las variables siempre se sincronizan con la URL mediante la sintaxis `var-<varname>=value`. 

## Prácticas recomendadas de variables
<a name="variable-best-practices"></a>

Las listas desplegables de variables se muestran en el orden en que aparecen en la lista de variables de **Configuración del panel**.

Coloque las variables que cambiará con frecuencia en la parte superior, de modo que se muestren primero, en el extremo izquierdo del panel.

## Sintaxis de variable
<a name="variable-syntax"></a>

 Los títulos de los paneles y las consultas de las métricas pueden ver las variables mediante dos sintaxis distintas: 
+  `$varname` Esta sintaxis es más fácil de leer, como en el siguiente ejemplo: `apps.frontend.$server.requests.count`. Sin embargo, no puede utilizar una variable en medio de una palabra. 
+  `${var_name}` Utilice esta sintaxis cuando desee interpolar una variable en medio de una expresión. 
+  `${var_name:<format>}` Este formato le da más control sobre cómo Grafana interpola los valores. Para obtener más información, consulte [Opciones avanzadas de formato de variables](#advanced-variable-format-options). 

 Antes de enviar las consultas al origen de datos, la consulta se *interpola*, lo que significa que la variable se reemplaza por su valor actual. Durante la interpolación, es posible que el valor de la variable se *escape* para ajustarlo a la sintaxis del lenguaje de consulta y al lugar en el que se utiliza. Por ejemplo, una variable que se utilice en una expresión regular en una consulta de Prometheus tendrá un escape de expresiones regulares. Consulte el tema de la documentación específico del origen de datos para obtener más información sobre el escape de valores durante la interpolación. 

 Para obtener información sobre la sintaxis avanzada para anular el formato predeterminado del origen de datos, consulte [Opciones avanzadas de formato de variables](#advanced-variable-format-options). 

# Tipos de variables
<a name="variables-types"></a>

****  
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 8.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.md).  
Para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).

 Grafana utiliza varios tipos de variables. 


|  Tipo de variable  |  Description (Descripción)  | 
| --- | --- | 
|  Consultar  |  Lista de valores generada por consultas, como nombres de métricas, nombres de servidores, sensores IDs, centros de datos, etc. Para obtener más información, consulte [Adición de una variable de consulta](#add-a-query-variable).  | 
|  Personalizada  |  Define las opciones de la variable de forma manual mediante una lista separada por comas. Para obtener más información, consulte [Adición de una variable personalizada](#add-a-custom-variable).  | 
|  Text box (Cuadro de texto)  |  Muestra un campo de entrada de texto con un valor predeterminado opcional. Para obtener más información, consulte [Adición de una variable de cuadro de texto](#add-a-text-box-variable).  | 
|  Constant  |  Define una constante oculta. Para obtener más información, consulte [Adición de una variable constante](#add-a-constant-variable).  | 
|  Origen de datos  |  Cambie rápidamente el origen de datos de un panel de control completo. Para obtener más información, consulte [Adición de una variable de origen de datos](#add-a-data-source-variable).  | 
|  Interval  |  Las variables de intervalo representan intervalos de tiempo. Para obtener más información, consulte [Adición de una variable de intervalo](#add-an-interval-variable).  | 
|  Filtros ad hoc  |  Key/value filtros que se agregan automáticamente a todas las consultas de métricas de una fuente de datos (InfluxDB, Prometheus y solo). OpenSearch Para obtener más información, consulte [Adición de filtros ad hoc](#add-ad-hoc-filters).  | 
|  Variables globales  |  Variables integradas que se pueden utilizar en expresiones del editor de consultas. Para obtener más información, consulte [Variables globales](#global-variables).  | 
|  Variables encadenadas  |  Las consultas de variables pueden contener otras variables. Para obtener más información, consulte [Variables encadenadas](#chained-variables).  | 

## Adición de una variable de consulta
<a name="add-a-query-variable"></a>

 Al usar variables de consulta, puede escribir una consulta de origen de datos que devuelve una lista de nombres de métricas, valores de etiquetas o claves. Por ejemplo, una variable de consulta puede devolver una lista de nombres de servidores IDs, sensores o centros de datos. Los valores de las variables cambian a medida que buscan opciones de forma dinámica con una consulta a un origen de datos. 

 Las expresiones de consulta pueden contener referencias a otras variables y, de hecho, crear variables vinculadas. Grafana lo detecta y actualiza automáticamente una variable cuando cambia una de sus variables vinculadas. 

### Expresiones de consulta
<a name="query-expressions"></a>

Las expresiones de consulta son diferentes para cada origen de datos. Para obtener más información, consulte la documentación del origen de datos en [Conexión con orígenes de datos](AMG-data-sources.md).

### Introducción de opciones generales
<a name="enter-general-options"></a>

**Introducción de opciones generales para una variable de consulta**

1. Vaya al panel de control para el que desee crear una variable y, a continuación, seleccione el icono de **Configuración del panel** (engranaje) situado en la parte superior de la página. 

1.  En la pestaña **Variables**, elija **Nuevo**. 

1.  Ingrese un **nombre** para su variable. 

1.  En la lista **Tipo**, seleccione **Consulta**. 

1. (Opcional) En **Etiqueta**, ingrese el nombre de visualización de la lista desplegable de variables. Si no ingresa ningún nombre de visualización, la etiqueta desplegable será el nombre de la variable. 

1.  Elija una opción de **Ocultar**: 
   +  **Sin selección (en blanco)**: la lista desplegable de variables muestra el valor de **Nombre** o **Etiqueta** de la variable. Es el valor predeterminado. 
   +  **Etiqueta**: la lista desplegable de variables solo muestra el valor de la variable seleccionada y una flecha hacia abajo. 
   +  **Variable**: no se muestra ninguna lista desplegable de variables en el panel de control. 

### Introducción de opciones de consulta
<a name="enter-query-options"></a>

**Introducción de opciones de consulta para una variable de consulta**

1. En la lista **Origen de datos**, seleccione el origen de datos de destino para la consulta. Para obtener más información sobre orígenes de datos, consulte [Conexión con orígenes de datos](AMG-data-sources.md).

1.  En la lista **Actualizar**, seleccione cuándo debe actualizar las opciones la variable. 
   +  **Nunca**: guarda en caché las consultas de variables y los valores no se actualizan. No pasa nada si los valores nunca cambian, pero es problemático si son dinámicos y cambian mucho. 
   +  **Al cargar el panel de control**: consulta el origen de datos cada vez que se carga el panel de control. Esto ralentiza la carga del panel de control, ya que la consulta de variables debe completarse antes de inicializar el panel de control. 
   +  **Al cambiar el intervalo de tiempo**: consulta el origen de datos cuando cambia el intervalo de tiempo del panel de control. Utilice esta opción únicamente si la consulta de opciones de variables contiene un filtro de intervalo de tiempo o depende del intervalo de tiempo del panel de control. 

1.  En el campo **Consulta**, ingrese una consulta. 
   +  El campo de consulta varía en función del origen de datos. Algunos orígenes de datos tienen editores de consultas personalizados. 
   + Si necesita más espacio en un editor de consultas de un solo campo de entrada, coloque el cursor sobre las líneas de la esquina inferior derecha del campo y arrástrelo hacia abajo para ampliarlo. 

1. (Opcional) En el campo **Expresión regular**, escriba una expresión regular para filtrar o capturar partes específicas de los nombres devueltos por la consulta del origen de datos. Para ver ejemplos, consulte [Filtrado de variables con expresiones regulares](templates-and-variables.md#filter-variables-with-regex). 

1. En la lista **Ordenar**, seleccione el orden de clasificación de los valores que se mostrarán en la lista desplegable. La opción predeterminada, **Deshabilitado**, significa que se utilizará el orden de las opciones devuelto por la consulta del origen de datos. 

1. (Opcional) Ingrese **Opciones de selección**. Para obtener más información, consulte [Introducción de opciones de selección de variables](templates-and-variables.md#enter-variable-selection-options). 

1.  En **Vista previa de valores**, el espacio de trabajo de Grafana muestra una lista de los valores de las variables actuales. Revíselos para asegurarse de que coincidan con lo que espera. 

1.  Elija **Agregar** para agregar la variable al panel de control. 

## Adición de una variable personalizada
<a name="add-a-custom-variable"></a>

 Use una variable *personalizada* para los valores que no cambien. Pueden ser números, cadenas o incluso otras variables. 

Por ejemplo, si tiene nombres de servidores o nombres de regiones que nunca cambian, puede crearlos como variables personalizadas en lugar de como variables de consulta. Como no cambian, puede utilizarlos en variables encadenadas en lugar de en otras variables de consulta. Eso reduciría la cantidad de consultas que Grafana debe enviar cuando se actualizan las variables encadenadas. Para obtener más información acerca de las variables encadenadas, consulte [Variables encadenadas](#chained-variables). 

### Introducción de opciones generales
<a name="variables-enter-general-options"></a>

**Introducción de opciones de consulta para una variable personalizada**

1.  Vaya al panel de control para el que desee crear una variable y, a continuación, seleccione el icono de **Configuración del panel** (engranaje) situado en la parte superior de la página. 

1.  En la pestaña **Variables**, elija **Nuevo**. 

1.  Ingrese un **nombre** para su variable. 

1.  En la lista **Tipo**, elija **Personalizada**. 

1. (Opcional) En **Etiqueta**, ingrese el nombre de visualización de la lista desplegable de variables. Si no ingresa ningún nombre de visualización, la etiqueta desplegable será el nombre de la variable. 

1.  Elija una opción de **Ocultar**: 
   +  **Sin selección (en blanco)**: la lista desplegable de variables muestra el valor de **Nombre** o **Etiqueta** de la variable. Es el valor predeterminado. 
   +  **Etiqueta**: la lista desplegable de variables solo muestra el valor de la variable seleccionada y una flecha hacia abajo. 
   +  **Variable**: no se muestra ninguna lista desplegable de variables en el panel de control. 

### Introducción de opciones personalizadas
<a name="enter-custom-options"></a>

**Introducción de opciones personalizadas para una variable personalizada**

1. En la lista **Valores separados por comas**, ingrese los valores de esta variable en una lista separada por comas. Puede incluir números, cadenas, otras variables o pares clave-valor separados por dos puntos. 

1.  (Opcional) Ingrese **Opciones de selección**. Para obtener más información, consulte [Introducción de opciones de selección de variables](templates-and-variables.md#enter-variable-selection-options). 

1.  En **Vista previa de valores**, el espacio de trabajo de Grafana muestra una lista de los valores de las variables actuales. Revíselos para asegurarse de que coincidan con lo que espera. 

1. Elija **Agregar** para agregar la variable al panel de control. 

## Adición de una variable de cuadro de texto
<a name="add-a-text-box-variable"></a>

 Las variables de *cuadro de texto* muestran un campo de entrada de texto con un valor predeterminado opcional. Es la variable más flexible, ya que puede ingresar cualquier valor. Utilice este tipo de variable si tiene métricas con una cardinalidad alta o si desea actualizar varios paneles de un panel de control al mismo tiempo. 

### Introducción de opciones generales
<a name="text-box-enter-general-options"></a>

**Introducción de opciones generales para una variable de cuadro de texto**

1.  Vaya al panel de control para el que desee crear una variable y, a continuación, seleccione el icono de **Configuración del panel** (engranaje) situado en la parte superior de la página. 

1.  En la pestaña **Variables**, elija **Nuevo**. 

1.  Ingrese un **nombre** para su variable. 

1.  En la lista **Tipo**, seleccione **Cuadro de texto**. 

1. (Opcional) En **Etiqueta**, ingrese el nombre de visualización de la lista desplegable de variables. Si no ingresa ningún nombre de visualización, la etiqueta desplegable será el nombre de la variable. 

1.  Elija una opción de **Ocultar**: 
   +  **Sin selección (en blanco)**: la lista desplegable de variables muestra el valor de **Nombre** o **Etiqueta** de la variable. Es el valor predeterminado. 
   +  **Etiqueta**: la lista desplegable de variables solo muestra el valor de la variable seleccionada y una flecha hacia abajo. 
   +  **Variable**: no se muestra ninguna lista desplegable de variables en el panel de control. 

### Introducción de opciones de texto
<a name="enter-text-options"></a>

**Introducción de opciones de texto para una variable de cuadro de texto**

1. (Opcional) En el campo **Valor predeterminado**, seleccione el valor predeterminado de la variable. Si no ingresa nada en este campo, Grafana mostrará un cuadro de texto vacío en el que puede escribir texto. 

1.  En **Vista previa de valores**, Grafana muestra una lista de los valores de las variables actuales. Revíselos para asegurarse de que coincidan con lo que espera. 

1. Elija **Agregar** para agregar la variable al panel de control. 

## Adición de una variable constante
<a name="add-a-constant-variable"></a>

Para definir una constante oculta, utilice variables de *constante*. Las variables de constante son útiles para los prefijos de las rutas métricas de los paneles de control que desee compartir. Al exportar un panel de control, las variables constantes se convierten en opciones de importación. 

Las variables constantes no son flexibles. Cada variable de constante contiene solo un valor. Para actualizarlo, debe actualizar la configuración de las variables. 

Las variables de constante son útiles cuando tiene valores complejos que debe incluir en las consultas, pero no quiere volver a escribirlos en cada una de las consultas. Por ejemplo, si tuviera una ruta de servidor llamada `i-0b6a61efe2ab843gg`, podría reemplazarla por una variable llamada `$path_gg`. 

### Introducción de opciones generales
<a name="constant-variable-enter-general-options"></a>

**Introducción de opciones generales para una variable de constante**

1.  Vaya al panel de control para el que desee crear una variable y, a continuación, seleccione el icono de **Configuración del panel** (engranaje) situado en la parte superior de la página. 

1.  En la pestaña **Variables**, elija **Nuevo**. 

1.  Ingrese un **nombre** para su variable. 

1.  En la lista **Tipo**, seleccione **Constante**. 

1. (Opcional) En **Etiqueta**, ingrese el nombre de visualización de la lista desplegable de variables. Si no ingresa ningún nombre de visualización, la etiqueta desplegable será el nombre de la variable. 

1.  Elija una opción de **Ocultar**: 
   +  **Variable**: no se muestra ninguna lista desplegable de variables en el panel de control. Es el valor predeterminado. 
   +  **Sin selección (en blanco)**: la lista desplegable de variables muestra el valor de **Nombre** o **Etiqueta** de la variable. 
   +  **Etiqueta**: la lista desplegable de variables solo muestra el valor de la variable seleccionada y una flecha hacia abajo. 

### Introducción de opciones de constante
<a name="enter-constant-options"></a>

**Introducción de opciones de constante para una variable de constante**

1. En el campo **Valor**, escriba el valor de la variable. Puede ingresar letras, números y símbolos. Si usa opciones avanzadas de formato de variables, puede usar incluso comodines. Para obtener más información, consulte [Opciones avanzadas de formato de variables](templates-and-variables.md#advanced-variable-format-options). 

1. En **Vista previa de valores**, el espacio de trabajo de Grafana muestra el valor de la variable actual. Revíselo para asegurarse de que coincida con lo que espera. 

1. Elija **Agregar** para agregar la variable al panel de control. 

## Adición de una variable de origen de datos
<a name="add-a-data-source-variable"></a>

Para cambiar el origen de datos de un panel de control completo, puede usar las variables de *origen de datos*. Son útiles si tiene varias instancias de un origen de datos, quizás en entornos diferentes. 

### Introducción de opciones generales
<a name="data-source-enter-general-options"></a>

**Introducción de opciones generales para una variable de origen de datos**

1. Vaya al panel de control para el que desee crear una variable y, a continuación, seleccione el icono de **Configuración del panel** (engranaje) situado en la parte superior de la página. 

1.  En la pestaña **Variables**, elija **Nuevo**. 

1.  Ingrese un **nombre** para su variable. 

1.  En la lista **Tipo**, seleccione **Origen de datos**. 

1. (Opcional) En **Etiqueta**, ingrese el nombre de visualización de la lista desplegable de variables. Si no ingresa ningún nombre de visualización, la etiqueta desplegable será el nombre de la variable. 

1.  Elija una opción de **Ocultar**: 
   +  **Sin selección (en blanco)**: la lista desplegable de variables muestra el valor de **Nombre** o **Etiqueta** de la variable. Es el valor predeterminado. 
   +  **Etiqueta**: la lista desplegable de variables solo muestra el valor de la variable seleccionada y una flecha hacia abajo. 
   +  **Variable**: no se muestra ninguna lista desplegable de variables en el panel de control. 

### Introducción de opciones de origen de datos
<a name="enter-data-source-options"></a>

**Introducción de opciones de origen de datos para una variable de origen de datos**

1.  En la lista **Tipo**, seleccione el origen de datos de destino para la variable. Para obtener más información sobre orígenes de datos, consulte [Conexión con orígenes de datos](AMG-data-sources.md). 

1. (Opcional) En **Filtro de nombres de instancias**, ingrese un filtro de expresiones regulares para seleccionar las instancias del origen de datos en la lista desplegable de valores de variables. Deje este campo vacío para mostrar todas las instancias. 

1.  (Opcional) Ingrese **Opciones de selección**. Para obtener más información, consulte [Introducción de opciones de selección de variables](templates-and-variables.md#enter-variable-selection-options). 

1.  En **Vista previa de valores**, Grafana muestra una lista de los valores de las variables actuales. Revíselos para asegurarse de que coincidan con lo que espera. 

1. Elija **Agregar** para agregar la variable al panel de control. 

## Adición de una variable de intervalo
<a name="add-an-interval-variable"></a>

Utilice una variable de *intervalo* para representar intervalos de tiempo, como `1m`, `1h` o `1d`. Puede considerarlos como un comando que abarca todo el panel de control group-by-time. Las variables de intervalo cambian la forma en que se agrupan los datos en la visualización. También puede utilizar la opción automática para devolver un número determinado de puntos de datos por intervalo de tiempo. 

Puede usar una variable de intervalo como parámetro para agruparla por hora (para InfluxDB), intervalo de histograma de fecha (para) o como parámetro de función de resumen (para Graphite OpenSearch). 

### Introducción de opciones generales
<a name="interval-variable-enter-general-options"></a>

**Introducción de opciones generales para una variable de intervalo**

1.  Vaya al panel de control para el que desee crear una variable y, a continuación, seleccione el icono de **Configuración del panel** (engranaje) situado en la parte superior de la página. 

1.  En la pestaña **Variables**, elija **Nuevo**. 

1.  Ingrese un **nombre** para su variable. 

1.  En la lista **Tipo**, seleccione **Intervalo**. 

1. (Opcional) En **Etiqueta**, ingrese el nombre de visualización del desplegable de variables. Si no ingresa ningún nombre de visualización, la etiqueta desplegable será el nombre de la variable. 

1.  Elija una opción de **Ocultar**: 
   +  **Sin selección (en blanco)**: la lista desplegable de variables muestra el valor de **Nombre** o **Etiqueta** de la variable. Es el valor predeterminado. 
   +  **Etiqueta**: la lista desplegable de variables solo muestra el valor de la variable seleccionada y una flecha hacia abajo. 
   +  **Variable**: no se muestra ninguna lista desplegable de variables en el panel de control. 

### Introducción de opciones de intervalo
<a name="enter-interval-options"></a>

**Introducción de opciones de intervalo para una variable de intervalo**

1.  En el campo **Valores**, ingrese los intervalos de periodo de tiempo que desee que aparezcan en la lista desplegable de variables. Se admiten las siguientes unidades de tiempo: `s (seconds)`, `m (minutes)`, `h (hours)`, `d (days)`, `w (weeks)`, `M (months)` y `y (years)`. También puede aceptar o editar los valores predeterminados: `1m,10m,30m,1h,6h,12h,1d,7d,14d,30d`. 

1. (Opcional) Active la **opción automática** si desea agregar la opción `auto` a la lista. Use esta opción para especificar cuántas veces debe dividirse el intervalo de tiempo actual para calcular el intervalo de tiempo `auto` actual. Si la activa, aparecerán dos opciones más: 
   +  **Recuento de pasos**: seleccione el número de veces que se dividirá el intervalo de tiempo actual para calcular el valor, de forma similar a la opción de consulta **Máximo de puntos de datos**. Por ejemplo, si el intervalo de tiempo visible actual es de 30 minutos, el intervalo `auto` agrupa los datos en 30 incrementos de un minuto. El valor predeterminado es 30 pasos. 
   +  **Intervalo mínimo**: el umbral mínimo por debajo del cual los intervalos del recuento de pasos no dividirán el tiempo. Para continuar con el ejemplo de 30 minutos, si el intervalo mínimo se establece en `2m`, Grafana agruparía los datos en 15 incrementos de 2 minutos. 

1.  En **Vista previa de valores**, Grafana muestra una lista de los valores de las variables actuales. Revíselos para asegurarse de que coincidan con lo que espera. 

1. Elija **Agregar** para agregar la variable al panel de control. 

### Ejemplos de variables de intervalo
<a name="interval-variable-examples"></a>

 Ejemplo con la variable de plantilla `myinterval` en una función de Graphite: 

```
summarize($myinterval, sum, false)
```

 Un ejemplo de Graphite más complejo: 

```
groupByNode(summarize(movingAverage(apps.$app.$server.counters.requests.count, 5), '$interval', 'sum', false), 2, 'sum')
```

## Adición de filtros ad hoc
<a name="add-ad-hoc-filters"></a>

Puede utilizar filtros de un solo uso o *ad hoc* para agregar filtros clave-valor que se agregan automáticamente a todas las consultas de métricas que utilizan el origen de datos especificado. A diferencia de otras variables, en las consultas no se utilizan filtros de un solo uso. En su lugar, se utilizan para escribir filtros para las consultas existentes. 

**nota**  
**Nota:** Las variables de filtro únicas o ad hoc solo funcionan con InfluxDB, Prometheus y fuentes de datos. OpenSearch 

### Introducción de opciones generales
<a name="ad-hoc-filters-enter-general-options"></a>

**Introducción de opciones generales de un filtro ad hoc**

1. Vaya al panel de control para el que desee crear una variable y, a continuación, seleccione el icono de **Configuración del panel** (engranaje) situado en la parte superior de la página. 

1.  En la pestaña **Variables**, elija **Nuevo**. 

1.  Ingrese un **nombre** para su variable. 

1.  En la lista **Tipo**, seleccione **Filtros ad hoc**. 

1. (Opcional) En **Etiqueta**, ingrese el nombre de visualización de la lista desplegable de variables. Si no ingresa ningún nombre de visualización, la etiqueta desplegable será el nombre de la variable. 

1.  Elija una opción de **Ocultar**: 
   +  **Sin selección (en blanco)**: la lista desplegable de variables muestra el valor de **Nombre** o **Etiqueta** de la variable. Es el valor predeterminado. 
   +  **Etiqueta**: la lista desplegable de variables solo muestra el valor de la variable seleccionada y una flecha hacia abajo. 
   +  **Variable**: no se muestra ninguna lista desplegable de variables en el panel de control. 

### Introducción de opciones
<a name="ad-hoc-enter-options"></a>

**Introducción de las opciones de un filtro ad hoc**

1.  En la lista **Origen de datos**, seleccione el origen de datos de destino. Para obtener más información sobre orígenes de datos, consulte [Conexión con orígenes de datos](AMG-data-sources.md). 

1. Elija **Agregar** para agregar la variable al panel de control. 

### Creación de filtros ad hoc
<a name="create-ad-hoc-filters"></a>

Los filtros ad hoc son una de las opciones de variables más complejas y flexibles disponibles. En lugar de una lista normal de opciones de variables, esta variable le permite compilar una consulta ad hoc que abarque todo el panel de control. Los filtros que aplique de esta manera se aplican a todos los paneles del panel de control. 

## Variables encadenadas
<a name="chained-variables"></a>

Las *variables encadenadas*, también denominadas *variables enlazadas* o *variables anidadas*, son variables de consulta con una o más variables adicionales en su consulta de variables. En esta sección se explica cómo funcionan las variables encadenadas y se proporcionan enlaces a ejemplos de paneles de control que las utilizan. 

Las consultas de variables encadenadas son diferentes para cada origen de datos, pero la premisa es la misma para todas. Puede utilizar consultas de variables encadenadas en cualquier origen de datos que las permita. 

Puede compilar paneles de control complejos vinculados y con plantillas, de 5 o 10 niveles de profundidad. Técnicamente, no hay límite en cuanto a la profundidad o complejidad que pueda tener, pero cuantos más enlaces tenga, mayor será la carga de consultas. 

### Prácticas recomendadas y consejos
<a name="variables-best-practices-and-tips"></a>

Las siguientes prácticas harán que los paneles de control y las variables sean más fáciles de usar. 

#### Creación de nuevas variables encadenadas
<a name="creating-new-linked-variables"></a>
+  El encadenamiento de variables crea dependencias entre elementos principales y secundarios. Puede imaginarlos como una escalera o un árbol. 
+ La forma más rápida de crear una nueva variable encadenada consiste en copiar la variable en la que desea basar la nueva. En la lista de variables, seleccione el icono **Duplicar variable** situado a la derecha de la entrada de la variable para crear una copia. A continuación, puede agregar a la consulta la variable principal.
+ Las nuevas variables encadenadas creadas de esta forma aparecen al final de la lista. Para dar a la lista un orden lógico, arrastre la variable a una posición diferente. 

#### Orden de las variables
<a name="variable-order"></a>

Para cambiar el orden de las variables en la lista de variables del panel de control, seleccione las flechas arriba y abajo situadas a la derecha de cada entrada. El espacio de trabajo de Grafana muestra las listas desplegables de variables de izquierda a derecha según esta lista, con la variable de la parte superior de la lista en el extremo izquierdo. 
+  Enumere las variables que no tienen dependencias en la parte superior, antes de sus variables secundarias. 
+  Cada variable debe seguir a la variable de la que depende. 
+ La interfaz de usuario no indica qué variables tienen relaciones de dependencia. Enumere las variables en un orden lógico para que sea más claro para otros usuarios (y para usted). 

#### Consideraciones sobre la complejidad
<a name="complexity-consideration"></a>

Cuantos más niveles de dependencia haya en las variables, más tiempo tarda en actualizar los paneles de control después de cambiar las variables. 

Por ejemplo, si tiene una serie de cuatro variables vinculadas (país, región, servidor y métrica) y cambia el valor de una variable raíz (país), el espacio de trabajo de Grafana debe ejecutar consultas para todas las variables dependientes antes de actualizar las visualizaciones en el panel de control. 

## Variables globales
<a name="global-variables"></a>

 Grafana tiene variables integradas que se pueden utilizar en expresiones del editor de consultas. En este tema se enumeran en orden alfabético y se definen. Estas variables son útiles en consultas, enlaces de panel de control y enlaces de datos. 

### \$1\$1\$1dashboard
<a name="global-variable-dashboard"></a>

Esta variable es el nombre del panel de control actual. 

### \$1\$1\$1from y \$1\$1\$1to
<a name="global-variable-from-and-__to"></a>

Grafana tiene dos variables de intervalo de tiempo integradas: `$__from` y `$__to`. Actualmente, siempre se interpolan como milisegundos de Epoch de forma predeterminada, pero puede controlar el formato de la fecha. 


|  Sintaxis  |  Ejemplo de resultado  |  Description (Descripción)  | 
| --- | --- | --- | 
|  \$1\$1\$1\$1from\$1  |  1594671549254  |  Epoch en milisegundos de Unix  | 
|  \$1\$1\$1\$1from:date\$1  |  2020-07-13T20:19:09.254Z  |  Sin argumentos, el valor predeterminado es ISO 8601/RFC 3339  | 
|  \$1\$1\$1\$1from:date:iso\$1  |  2020-07-13T20:19:09.254Z  |  ISO 8601/RFC 3339  | 
|  \$1\$1\$1\$1from:date:seconds\$1  |  1594671549  |  Epoch en segundos de Unix  | 
|  \$1\$1\$1\$1from:date:YYYY-MM\$1  |  2020-07  |  Cualquier formato de los datos personalizado. Para obtener más información, consulte [Visualización](https://momentjs.com/docs/#/displaying/).  | 

La sintaxis anterior también funciona con `${__to}`. 

También puede utilizar esta variable en URLs . Por ejemplo, para enviar a un usuario final a un panel que muestre un intervalo de tiempo desde hace seis horas hasta ahora, utilice la siguiente URL: https://play.grafana. org/d/000000012/grafana-jugar en casa? ¿ViewPanel=2&Orgid=1? desde=ahora-6h&a=ahora 

### \$1\$1\$1interval
<a name="global-variable-interval"></a>

*Puede utilizar la `$__interval` variable como parámetro para agruparla por hora (para InfluxDB, Myself, Postgres, MSSQL), intervalo de histograma de fecha (para) o como parámetro de función de resumen (para Graphite). OpenSearch* 

El espacio de trabajo de Grafana calcula automáticamente un intervalo que se puede utilizar para agrupar por tiempo en las consultas. Cuando hay más puntos de datos de los que se pueden mostrar en un gráfico, las consultas se pueden hacer más eficientes al agruparlas por un intervalo mayor. Por ejemplo, es más eficiente agrupar por 1 día que por 10 segundos cuando se analizan datos de 3 meses. El gráfico tendrá el mismo aspecto y la consulta será más rápida. `$__interval` se calcula con el intervalo de tiempo y el ancho del gráfico (el número de píxeles). 

 Cálculo aproximado: `(from - to) / resolution` 

Por ejemplo, si el intervalo de tiempo es de 1 hora y el gráfico está en pantalla completa, el intervalo podría calcularse en `2m`: los puntos se agrupan en intervalos de 2 minutos. Si el intervalo de tiempo es de 6 meses y el gráfico es de pantalla completa, el intervalo puede ser `1d` (1 día): los puntos se agrupan por día. 

 En el origen de datos de InfluxDB, la variable heredada `$interval` es la misma variable. En su lugar, use `$__interval`. 

 InfluxDB y las fuentes de OpenSearch datos tienen `Group by time interval` campos que se utilizan para codificar el intervalo o para establecer el límite mínimo de la variable mediante la sintaxis ->. `$__interval` `>` `>10m` 

### \$1\$1\$1interval\$1ms
<a name="global-variable-interval_ms"></a>

 Esta variable es la variable `$__interval` en milisegundos, no una cadena con formato de intervalo de tiempo. Por ejemplo, si `$__interval` es `20m`, `$__interval_ms` es `1200000`. 

### \$1\$1\$1name
<a name="global-variable-name"></a>

 Esta variable solo está disponible en el panel de una sola estadística y se puede utilizar en los campos de prefijo o sufijo de la pestaña **Opciones**. La variable se sustituirá por el nombre o el alias de la serie. 

### \$1\$1\$1org
<a name="global-variable-org"></a>

 Esta variable es el identificador de la organización actual. La variable `${__org.name}` es el nombre de la organización actual. 

### \$1\$1\$1user
<a name="global-variable-user"></a>

La variable `${__user.id}` es el identificador del usuario actual. La variable `${__user.login}` es el identificador de inicio de sesión del usuario actual. La variable `${__user.email}` es el correo electrónico del usuario actual. 

### \$1\$1\$1range
<a name="global-variable-range"></a>

Actualmente esta variable solo es compatible con los orígenes de datos de Prometheus. Esta variable representa el intervalo del panel de control actual. Se calcula mediante `to - from`. Tiene representaciones de segundos y milisegundos llamadas `$__range_ms` y `$__range_s`. 

### \$1timeFilter o \$1\$1\$1timeFilter
<a name="global-variable-timefilter-or-__timefilter"></a>

La variable `$timeFilter` devuelve el intervalo de tiempo seleccionado actualmente como una expresión. Por ejemplo, la expresión `Last 7 days` del intervalo de tiempo es `time > now() - 7d`. 

 Esta variable se usa en varios lugares, entre ellos: 
+ La cláusula WHERE para el origen de datos de InfluxDB. Grafana la agrega automáticamente a las consultas de InfluxDB cuando está en el modo **Editor de consultas**. Puede agregarla manualmente en el modo **Editor de texto**: `WHERE $timeFilter`. 
+  Registre las consultas de análisis en el origen de datos de Azure Monitor. 
+  Consultas SQL en MySQL, Postgres y MSSQL. 
+  La variable `$__timeFilter` se utiliza en el origen de datos de MySQL. 

## Otras opciones de variables
<a name="other-variable-options"></a>

En esta sección se explican las otras opciones de variables disponibles.

### Introducción de opciones de selección de variables
<a name="enter-variable-selection-options"></a>

Puede utilizar **Opciones de selección** para gestionar las selecciones de opciones variables. Todas las opciones de selección son opcionales y están desactivadas de forma predeterminada. 

#### Varios valores
<a name="multi-value"></a>

Si activa esta opción, la lista desplegable de variables permite seleccionar varias opciones al mismo tiempo. Para obtener más información, consulte [Formateo de variables de varios valores](#formatting-multi-value-variables). 

#### Opción Incluir todo
<a name="include-all-option"></a>

El espacio de trabajo de Grafana agrega una opción `All` a la lista desplegable de variables. Si un usuario final selecciona esta opción, se seleccionan todas las opciones variables. 

#### Valor Personalizar todo
<a name="custom-all-value"></a>

Esta opción solo está visible si se selecciona **Opción Incluir todo**. 

Para definir el valor de la opción `All`, ingrese una de sintaxis de expresión regular, global o Lucene en el campo **Valor Personalizar todo**. 

De forma predeterminada, el valor `All` incluye todas las opciones de la expresión combinada. Puede llegar a ser muy largo y provocar problemas de rendimiento. A veces, puede ser mejor especificar un valor Personalizar todo, como una expresión regular comodín. 

Al utilizar la sintaxis de expresión regular, global o Lucene en la opción **Valor Personalizar todo**, nunca se aplica escape, por lo que debe tener en cuenta qué valor es válido para el origen de datos. 

### Opciones avanzadas de formato de variables
<a name="advanced-variable-format-options"></a>

 El formato de la interpolación de variables depende del origen de datos, pero hay algunas situaciones en las que es posible que quiera cambiar el formato predeterminado. 

 Por ejemplo, el valor predeterminado del origen de datos de MySQL es unir varios valores separados por comas entre comillas: `'server01','server02'`. En algunos casos, es posible que quiera que haya una cadena separada por comas sin comillas: `server01,server02`. Para ello, utilice las siguientes opciones avanzadas para el formato de variables. 

#### Sintaxis general
<a name="general-syntax"></a>

 Sintaxis: `${var_name:option}` 

Si se especifica alguna opción de formato no válida, `glob` es la opción predeterminada o alternativa. 

#### CSV
<a name="variables-csv"></a>

 Formatea las variables con varios valores como una cadena separada por comas. 

```
servers = ['test1', 'test2']
String to interpolate: '${servers:csv}'
Interpolation result: 'test1,test2'
```

#### Distribuida: OpenTSDB
<a name="distributed---opentsdb"></a>

 Formatea las variables con varios valores en un formato personalizado para OpenTSDB. 

```
servers = ['test1', 'test2']
String to interpolate: '${servers:distributed}'
Interpolation result: 'test1,servers=test2'
```

#### Doublequote
<a name="doublequote"></a>

 Formatea las variables de un solo valor y de varios valores en una cadena separada por comas, aplica escape a `"` en cada valor por `\"` y cita cada valor con `"`. 

```
servers = ['test1', 'test2']
String to interpolate: '${servers:doublequote}'
Interpolation result: '"test1","test2"'
```

#### Glob: Graphite
<a name="glob---graphite"></a>

 Formatea las variables con varios valores en un patrón glob (para consultas de Graphite). 

```
servers = ['test1', 'test2']
String to interpolate: '${servers:glob}'
Interpolation result: '{test1,test2}'
```

#### JSON
<a name="json"></a>

 Formatea las variables con varios valores como una cadena separada por comas. 

```
servers = ['test1', 'test2']
String to interpolate: '${servers:json}'
Interpolation result: '["test1", "test2"]'
```

#### Lucena - OpenSearch
<a name="lucene---opensearch"></a>

 Formatea variables con varios valores en formato Lucene para. OpenSearch 

```
servers = ['test1', 'test2']
String to interpolate: '${servers:lucene}'
Interpolation result: '("test1" OR "test2")'
```

#### Percentencode
<a name="percentencode"></a>

 Formatea las variables de un solo valor y de varios valores para utilizarlas en los parámetros de URL. 

```
servers = ['foo()bar BAZ', 'test2']
String to interpolate: '${servers:percentencode}'
Interpolation result: 'foo%28%29bar%20BAZ%2Ctest2'
```

#### Pipe
<a name="pipe"></a>

 Formatea las variables con varios valores en una cadena separada por canalizaciones. 

```
servers = ['test1.', 'test2']
String to interpolate: '${servers:pipe}'
Interpolation result: 'test1.|test2'
```

#### Raw
<a name="raw"></a>

 Desactiva el formato específico del origen de datos, como las comillas simples en una consulta SQL. 

```
servers = ['test1.', 'test2']
String to interpolate: '${var_name:raw}'
Interpolation result: '{test.1,test2}'
```

#### Expresión regex
<a name="regex"></a>

 Formatea las variables con varios valores en una cadena de expresiones regulares. 

```
servers = ['test1.', 'test2']
String to interpolate: '${servers:regex}'
Interpolation result: '(test1\.|test2)'
```

#### Singlequote
<a name="singlequote"></a>

 Formatea las variables de uno o varios valores en una cadena separada por comas, escapa `'` en cada valor por `\'` y cita cada valor con`'`. 

```
servers = ['test1', 'test2']
String to interpolate: '${servers:singlequote}'
Interpolation result: "'test1','test2'"
```

#### Sqlstring
<a name="sqlstring"></a>

 Formatea las variables de uno o varios valores en una cadena separada por comas, escapa `'` en cada valor por `''` y cita cada valor con`'`. 

```
servers = ["test'1", "test2"]
String to interpolate: '${servers:sqlstring}'
Interpolation result: "'test''1','test2'"
```

#### Texto
<a name="text"></a>

 Formatea las variables de un solo valor y de varios valores para incluirlas en su representación textual. Para una sola variable, simplemente devolverá la representación de texto. Para las variables con varios valores, devolverá la representación de texto combinada con `+`. 

```
servers = ["test1", "test2"]
String to interpolate: '${servers:text}'
Interpolation result: "test1 + test2"
```

### Formateo de variables de varios valores
<a name="formatting-multi-value-variables"></a>

Interpolar una variable con varios valores seleccionados es complicado, ya que no es fácil formatear los múltiples valores en una cadena que sea válida en el contexto dado en el que se usa la variable. Grafana intenta resolver esto al permitir que cada complemento de origen de datos informe al motor de interpolación de plantillas qué formato usar para varios valores. 

**nota**  
 La opción **Valor Personalizar todo** de la variable debe estar en blanco para que Grafana formatee todos los valores en una sola cadena. Si lo deja en blanco, Grafana concatena (suma) todos los valores de la consulta. Algo así como `value1,value2,value3`. Si se usa un valor personalizado `all`, el valor será algo así como `*` o `all`. 

#### Variables de valores múltiples con un origen de datos de Graphite
<a name="multi-value-variables-with-a-graphite-data-source"></a>

 Graphite usa expresiones globales. En este caso, una variable con varios valores se interpolaría como `{host1,host2,host3}` si el valor de la variable actual fuera *host1*, *host2* y *host3*. 

#### Variables de varios valores con un origen de datos de Prometheus o InfluxDB
<a name="multi-value-variables-with-a-prometheus-or-influxdb-data-source"></a>

 InfluxDB y Prometheus utilizan expresiones regulares, por lo que se interpolaría la misma variable que `(host1|host2|host3)`. También se aplicaría escape de expresiones regulares a cada valor. De lo contrario, un valor con un carácter de control de expresión regular rompería la expresión regular. 

#### Variables de varios valores con un origen de datos elástico
<a name="multi-value-variables-with-an-elastic-data-source"></a>

Amazon OpenSearch usa la sintaxis de consulta de Lucene, por lo que se formatearía la misma variable como. `("host1" OR "host2" OR "host3")` En este caso, se debe aplicar escape a todos los valores, para que el valor solo contenga comillas y palabras de control de Lucene. 

#### Solución de problemas de formateo
<a name="formatting-troubles"></a>

 La aplicación de escape y el formateo automáticos pueden provocar problemas. Puede resultar complicado comprender la lógica detrás de un problema, especialmente en el caso de InfluxDB y Prometheus, donde el uso de la sintaxis de expresiones regulares requiere que la variable se utilice en el contexto de un operador de expresiones regulares. 

 Si no desea que Grafana escape y formatee expresiones regulares de forma automática, debe llevar a cabo una de estas acciones:
+ Desactive las opciones **Varios valores** e **Incluir todo**.
+ Utilice el [formato de variable sin procesar] (\$1\$1< relref "advanced-variable-format-options.md \$1raw" >\$1\$1).

### Filtrado de variables con expresiones regulares
<a name="filter-variables-with-regex"></a>

 Con la opción Consulta de expresiones regulares, se puede filtrar la lista de opciones que devuelve la consulta de variables o modificar las opciones devueltas. 

En esta sección, se muestra cómo utilizar las expresiones regulares para filtrar y modificar los valores de la lista desplegable de variables. 

 Con la opción Consulta de expresiones regulares, se filtra la lista de opciones devuelta por la consulta de variables o se modifican las opciones devueltas. Para más información, consulte [Regular expressions](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Regular_Expressions). 

 A continuación, se muestran algunos ejemplos de filtrado en la lista de opciones: 

```
backend_01
backend_02
backend_03
backend_04
```

#### Filtrado para que se devuelvan solo las opciones que terminan en `01` o `02`
<a name="filter-so-that-only-the-options-that-end-with-01-or-02-are-returned"></a>

 Expresión regular: 

```
/.*[01|02]/
```

 Resultado: 

```
backend_01
backend_02
```

#### Filtrado y modificación de las opciones mediante un grupo de captura de expresiones regulares para devolver parte del texto
<a name="filter-and-modify-the-options-using-a-regex-capture-group-to-return-part-of-the-text"></a>

 Expresión regular: 

```
/.*(01|02)/
```

 Resultado: 

```
01
02
```

#### Filtrado y modificación: ejemplo de Prometheus
<a name="filter-and-modify---prometheus-example"></a>

 Lista de opciones: 

```
up{instance="demo.robustperception.io:9090",job="prometheus"} 1 1521630638000
up{instance="demo.robustperception.io:9093",job="alertmanager"} 1 1521630638000
up{instance="demo.robustperception.io:9100",job="node"} 1 1521630638000
```

 Expresión regular: 

```
/.*instance="([^"]*).*/
```

 Resultado: 

```
demo.robustperception.io:9090
demo.robustperception.io:9093
demo.robustperception.io:9100
```

#### Filtrado y modificación mediante grupos de captura de valores y texto con nombre asignado
<a name="filter-and-modify-using-named-text-and-value-capture-groups"></a>

Al utilizar grupos de captura con nombre asignado, puede capturar partes independientes de “texto” y “valor” de las opciones que devuelve la consulta de variables. La lista desplegable de variables puede contener un nombre descriptivo para cada valor que se pueda seleccionar. 

 Por ejemplo, al consultar la métrica `node_hwmon_chip_names` de Prometheus, `chip_name` es más simple que el valor de `chip`. Comience con el siguiente resultado de consulta variables. 

```
node_hwmon_chip_names{chip="0000:d7:00_0_0000:d8:00_0",chip_name="enp216s0f0np0"} 1
node_hwmon_chip_names{chip="0000:d7:00_0_0000:d8:00_1",chip_name="enp216s0f0np1"} 1
node_hwmon_chip_names{chip="0000:d7:00_0_0000:d8:00_2",chip_name="enp216s0f0np2"} 1
node_hwmon_chip_names{chip="0000:d7:00_0_0000:d8:00_3",chip_name="enp216s0f0np3"} 1
```

 Pásela por la siguiente expresión regular. 

```
/chip_name="(?<text>[^"]+)|chip="(?<value>[^"]+)/g
```

 Se produce la siguiente lista desplegable. 

```
Display Name          Value
------------          -------------------------
enp216s0f0np0         0000:d7:00_0_0000:d8:00_0
enp216s0f0np1         0000:d7:00_0_0000:d8:00_1
enp216s0f0np2         0000:d7:00_0_0000:d8:00_2
enp216s0f0np3         0000:d7:00_0_0000:d8:00_3
```

 **Nota:** Solo se admiten los nombres de los grupos de captura `text` y `value`. 

### Paneles o filas que se repiten
<a name="repeat-panels-or-rows"></a>

 Puede crear paneles dinámicos mediante *variables de plantillas*. Todas las variables de las consultas se amplían hasta el valor actual de la variable antes de que la consulta se envíe a la base de datos. Con las variables, puede reutilizar un único panel para todos los servicios. 

 Las variables de plantillas pueden resultar muy útiles para cambiar dinámicamente las consultas en todo un panel. Si quiere que Grafana cree dinámicamente nuevos paneles o filas en función de los valores que seleccionó, puede utilizar la característica *Repetir*. 

#### Paneles que se repiten
<a name="repeating-panels"></a>

 Si tiene una variable con las opciones `Multi-value` o `Include all value` activadas, puede elegir un panel y hacer que Grafana repita ese panel para cada valor seleccionado. Puede encontrar la característica *Repetir* en la *pestaña General* en el modo de edición de paneles. 

 `direction` controla la disposición de los paneles. 

Si lo desea`horizontal`, los paneles están dispuestos side-by-side. Grafana ajusta automáticamente el ancho de cada panel repetido para que se llene toda la fila. Actualmente, no se pueden combinar otros paneles de una fila con un panel repetido. 

 Establezca `Max per row` para indicarle a Grafana cuántos paneles por fila quiere como máximo. El valor predeterminado es *4*. 

Si elige `vertical`, los paneles se disponen de arriba a abajo en una columna. El ancho de los paneles repetidos es el mismo que el del primer panel (la plantilla original) que se repite. 

Haga cambios únicamente en el primer panel (la plantilla original). Para que los cambios surtan efecto en todos los paneles, debe iniciar una recreación dinámica del panel. Para ello, puede cambiar el valor de la variable (es decir, la base de la repetición) o volver a cargar el panel. 

**nota**  
Los paneles que se repiten requieren variables para tener uno o más elementos seleccionados. No puede repetir un panel cero veces para ocultarlo.

#### Filas que se repiten
<a name="repeating-rows"></a>

 Como se ha visto anteriormente, con los paneles, también puede repetir filas si tiene variables establecidas con la opción de selección `Multi-value` o `Include all value`. 

 Para activar esta característica, debe agregar antes una nueva *Fila* mediante el menú *Agregar panel*. A continuación, haga una pausa en el título de la fila y pulse el botón de engranaje para acceder al panel de configuración `Row Options`. A continuación, puede seleccionar la variable para repetir la fila. 

 Se recomienda utilizar también una variable en el título de la fila. 

# Alertas de Grafana
<a name="alerts-overview"></a>

****  
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 8.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.md).  
Para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).

Grafana Alerting le proporciona alertas sólidas y procesables que lo ayudan a conocer los problemas de los sistemas momentos después de que se produzcan, lo que minimiza la interrupción de sus servicios.

Amazon Managed Grafana incluye acceso a un sistema de alertas actualizado, *Grafana Alerting*, que centraliza la información de las alertas en una única vista en la que se pueden hacer búsquedas. Incluye las siguientes características:
+ Cree y administre las alertas de Grafana en una vista centralizada.
+ Cree y administre las alertas administradas por Cortex y Loki a través de una única interfaz. Para obtener más información, consulte [Administración de reglas de alerta](v9-alerting-managerules.md).
+ Consulte la información de alertas de Prometheus, Amazon Managed Service para Prometheus y otros orígenes de datos compatibles con Alertmanager.
+ Crear varias instancias de alerta a partir de una única regla de alerta. Para obtener más información, consulte [Reglas unidimensionales y multidimensionales](v9-alerting-managerules-grafana.md#v9-alerting-single-multi-rule).
+ Administre sus recursos de alertas con terraform o aprovisionamiento. APIs Para obtener más información, consulte [Aprovisionamiento de recursos de Grafana Alerting](v9-alerting-setup-provision.md).

En el caso del espacio de trabajo de Amazon Managed Grafana existente, las [Alertas clásicas del panel](old-alerts-overview.md) son las predeterminadas. Para migrar a las alertas de Grafana, debe [migrar a las alertas de Grafana](alert-opt-in.md).

Para obtener más información sobre las alertas de Grafana, consulte [Novedades de las alertas de Grafana](alerts-whats-new.md).

Las alertas de Grafana tienen cuatro componentes clave:
+ [Regla de alerta](alert-rules.md): criterios de evaluación que determinan si se inicia una alerta. Consta de una o más consultas y expresiones, una condición, la frecuencia de la evaluación y, opcionalmente, el tiempo durante el cual se cumple la condición.
+ [Punto de contacto](alert-contact-points.md): canal para enviar notificaciones cuando se cumplen las condiciones de una regla de alerta. 
+ [Política de notificaciones](alert-notifications.md): conjunto de criterios de coincidencia y agrupación que se utilizan para determinar la frecuencia de las notificaciones.
+ [Silencios](alert-silences.md): fecha y criterios de coincidencia utilizados para silenciar las notificaciones.

Cuando las alertas de Grafana están habilitadas, puede hacer lo siguiente:
+ [Crear reglas de alerta administradas por Grafana](alert-rules.md#create-grafana-alert-rule)
+ [Crear reglas de alerta administradas por Cortex o Loki](alert-rules.md#create-alert-rule)
+ [Consultar las reglas de alerta existentes y administrar su estado actual](alert-rules.md#manage-alert-rules)
+ [Consultar el estado de las reglas de alerta](alert-fundamentals.md#alerts-state)
+ [Agregar o editar un punto de contacto de alerta](alert-contact-points.md#alert-working-contact-points)
+ [Agregar o editar políticas de notificaciones](alert-notifications.md#alert-notifications-working)
+ [Agregar o editar silencios](alert-silences.md)

## Limitaciones
<a name="alert-limitations"></a>
+ El sistema de Grafana Alerting puede recuperar reglas de todos los orígenes de datos disponibles de Amazon Managed Service para Prometheus, Prometheus, Loki y Alertmanager. Es posible que no pueda obtener las reglas de otros orígenes de datos compatibles.
+ Las reglas de alerta definidas en Grafana, en lugar de en Prometheus, envían múltiples notificaciones a su punto de contacto. Si utiliza alertas nativas de Grafana, le recomendamos que siga usando las alertas clásicas del panel y no habilite la nueva característica Grafana Alerting. Si desea ver las alertas definidas en su origen de datos de Prometheus, le recomendamos que habilite Grafana Alerting, que envían solo una notificación para las alertas creadas en la instancia de Alertmanager de Prometheus.
**nota**  
Esta limitación ya no existe en los espacios de trabajo de Amazon Managed Grafana que admiten la versión 10.4 y posteriores de Grafana.

**Topics**
+ [Limitaciones](#alert-limitations)
+ [Novedades de las alertas de Grafana](alerts-whats-new.md)
+ [Migración de las alertas clásicas del panel de control a Grafana Alerting](alert-opt-in.md)
+ [Conceptos básicos de alertas](alert-fundamentals.md)
+ [Creación y administración de reglas de alerta de Grafana](alert-rules.md)
+ [Grupos de alertas](alert-groups.md)
+ [Silenciamiento de las notificaciones de alertas para los orígenes de datos de Prometheus](alert-silences.md)
+ [Uso de puntos de contacto](alert-contact-points.md)
+ [Uso de plantillas de mensajes](alert-message-templates.md)
+ [Uso de políticas de notificaciones](alert-notifications.md)

# Novedades de las alertas de Grafana
<a name="alerts-whats-new"></a>

****  
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 8.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.md).  
Para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).

Las alertas de Grafana presentan varias mejoras con respecto a las alertas clásicas del panel.

## Creación de alertas multidimensionales
<a name="alerts-new-dimensional"></a>

Ahora puede crear una única regla de alerta que le brinde visibilidad en todo el sistema y generar múltiples instancias de alerta a partir de una sola regla de alerta. Por ejemplo, puede crear una regla para supervisar el uso del disco de varios puntos de montaje de un único host. El motor de evaluación devuelve varias series temporales a partir de una sola consulta y cada serie temporal se identifica mediante su conjunto de etiquetas.

**nota**  
Cada instancia de alerta se tiene en cuenta para la cuota de alertas. Las reglas multidimensionales que crean más instancias de las que se pueden incluir en la cuota de alertas no se evalúan y devuelven un error de cuota. Para obtener más información, consulte [Errores de cuota alcanzada](alert-rules.md#rule-quota-reached).

## Creación de alertas fuera de los paneles de control
<a name="alerts-new-not-dashboard"></a>

A diferencia de las alertas clásicas del panel, con las alertas de Grafana puede crear consultas y expresiones que combinen datos de múltiples orígenes de formas únicas. Puede seguir vinculando los paneles a las reglas de alerta mediante su ID y solucionar rápidamente los problemas del sistema que se encuentre en observación.

Como las alertas unificadas ya no están directamente vinculadas a las consultas de los paneles, no incluyen imágenes ni valores de consulta en el correo electrónico de notificación. Puede utilizar plantillas de notificación personalizadas para ver los valores de las consultas.

## Creación de reglas de alerta de Cortex y Loki
<a name="alerts-new-loki-cortex"></a>

En las alertas de Grafana, puede administrar las reglas de alerta de Loki y Cortex utilizando la misma interfaz de usuario y API que las alertas administradas por Grafana.

## Consulta y búsqueda de alertas de Amazon Managed Service para Prometheus y otros orígenes de datos compatibles con Prometheus
<a name="alerts-new-prometheus"></a>

Las alertas de Amazon Managed Service para Prometheus y los orígenes de datos compatibles con Prometheus ahora se indican en la interfaz de alertas. Puede buscar etiquetas en varios orígenes de datos para encontrar rápidamente las alertas pertinentes.

## Alertas especiales de estado de alerta NoData y error
<a name="alerts-new-error"></a>

Las alertas de Grafana generan alertas especiales que tienen las siguientes etiquetas cuando la evaluación de una regla de alerta produce un estado `NoData` o `Error`:
+ `alertname` con el valor `DatasourceNoData` o `DatasourceError` en función del estado.
+ `rulename` con el nombre de la regla de alerta a la que pertenece la alerta especial.
+ `datasource_uid` tiene el UID del origen de datos que provocó el estado.
+ Todas las etiquetas y anotaciones de la regla original.

Puede gestionar estas alertas de la misma manera que las alertas normales, por ejemplo, agregando un silencio o dirigiéndolas a un punto de contacto.

**nota**  
Si la regla usa varios orígenes de datos y uno o más no devuelve ningún dato, la alerta especial se crea para cada origen de datos que provocó el estado de alerta.

# Migración de las alertas clásicas del panel de control a Grafana Alerting
<a name="alert-opt-in"></a>

****  
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 8.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.md).  
Para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).

Los espacios de trabajo existentes, o los espacios de trabajo que eligen no usar las alertas de Grafana, utilizan las alertas clásicas del panel. Para migrar a la nueva característica de alertas de Grafana, primero debe registrarse en ella.

Puedes configurar tu instancia de Grafana gestionada por Amazon para que utilice las alertas de Grafana mediante la Consola de administración de AWS, la AWS CLI o la API de Grafana gestionada por Amazon. Para obtener más información sobre cómo configurar Amazon Managed Grafana, incluida la activación o desactivación de Grafana Alerting, consulte [Configuración de un espacio de trabajo de Amazon Managed Grafana](AMG-configure-workspace.md).

**nota**  
Al utilizar Grafana Alerting, las reglas de alerta definidas en Grafana, en lugar de en Prometheus, envían múltiples notificaciones a su punto de contacto. Si utiliza alertas nativas de Grafana, le recomendamos que siga usando las alertas clásicas del panel y no habilite la nueva característica Grafana Alerting. Si desea ver las alertas definidas en su origen de datos de Prometheus, le recomendamos que habilite Grafana Alerting, que envían solo una notificación para las alertas creadas en la instancia de Alertmanager de Prometheus.  
Esta limitación se elimina en los espacios de trabajo de Amazon Managed Grafana que admiten la versión 10.4 y posteriores de Grafana.

## Migración al sistema de Grafana Alerting
<a name="alert-opt-in-migrating"></a>

Cuando Grafana Alerting está activado, las alertas clásicas existentes del panel se migran en un formato compatible con Grafana Alerting. En la página Alertas de su instancia de Grafana, puede ver las alertas migradas junto con las alertas nuevas. Con Grafana Alerting, las reglas de alerta administradas por Grafana envían varias notificaciones en lugar de una sola alerta cuando coinciden.

El acceso de lectura y escritura a las alertas clásicas del panel y a las alertas de Grafana se rige por los permisos de las carpetas que las almacenan. Durante la migración, los permisos de las alertas clásicas del panel se comparan con los permisos de las nuevas reglas de la siguiente manera:
+ Si el panel de la alerta original tiene permisos, la migración crea una carpeta cuyo nombre sigue el formato `Migrated {"dashboardUid": "UID", "panelId": 1, "alertId": 1}` para que coincida con los permisos del panel original (incluidos los permisos heredados de la carpeta).
+ Si no hay permisos del panel y el panel está en una carpeta, la regla se vincula a esta carpeta y hereda sus permisos.
+ Si no hay permisos del panel y el panel está en la carpeta General, la regla se vincula a la carpeta General Alerting y hereda los permisos predeterminados.

**nota**  
Como en Grafana Alerting no hay ninguna opción `Keep Last State` para `NoData`, esta opción se convierte en `NoData` durante la migración de reglas clásicas. La opción `Keep Last State` para la gestión de `Error` se migra a una nueva opción `Error`. Para establecer coincidencias con el comportamiento de `Keep Last State`, en ambos casos, durante la migración, Amazon Managed Grafana crea automáticamente un silencio para cada regla de alerta con una duración de un año.

Los canales de notificación se migran a una configuración de Alertmanager con las rutas y los receptores adecuados. Los canales de notificación predeterminados se agregan como puntos de contacto a la ruta predeterminada. Los canales de notificación que no están asociados a ninguna alerta del panel van a la ruta `autogen-unlinked-channel-recv`.

### Limitaciones
<a name="alert-migration-limitations"></a>
+ El sistema de Grafana Alerting puede recuperar reglas de todos los orígenes de datos disponibles de Prometheus, Loki y Alertmanager. Es posible que no pueda obtener las reglas de alerta de otros orígenes de datos compatibles.
+ La migración entre las alertas de Grafana y las alertas clásicas del panel puede provocar la pérdida de datos para las características compatibles con un sistema, pero no el otro.
**nota**  
Si vuelve a migrar a las alertas clásicas del panel de control, perderá todos los cambios aplicados en la configuración de alertas mientras tenía habilitado Grafana Alerting, incluidas las reglas de alerta nuevas que se hayan creado.

# Conceptos básicos de alertas
<a name="alert-fundamentals"></a>

****  
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 8.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.md).  
Para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).

En esta sección, se proporciona información sobre los conceptos fundamentales de las alertas de Grafana.

## Conceptos relacionados con las alertas
<a name="alert-fundamentals-terms"></a>

En la siguiente tabla se describen los conceptos clave de las alertas de Grafana.


| Característica o concepto clave | Definición | 
| --- | --- | 
|  Orígenes de datos de alertas  |  Seleccione los orígenes de datos desde los que desee consultar y visualizar las métricas, los registros y los rastros.  | 
|  Programador  |  Evalúa las reglas de alerta; es el componente que ejecuta consultas periódicas en los orígenes de datos. Solo se aplica a las reglas administradas por Grafana.  | 
|  Alertmanager  |  Administra el enrutamiento y la agrupación de las instancias de alerta.  | 
|  Regla de alerta  |  Un conjunto de criterios de evaluación para determinar cuándo debe activarse una regla de alerta. Una regla de alerta consta de una o más consultas y expresiones, una condición, la frecuencia de la evaluación y el tiempo durante el cual se cumple la condición. Una regla de alerta puede generar varias instancias de alerta.  | 
|  Instancia de alerta  |  Una instancia de alerta es una instancia de una regla de alerta. Una regla de alerta unidimensional tiene una instancia de alerta. Una regla de alerta multidimensional tiene una o más instancias de alerta. Una sola regla de alerta que coincide con varios resultados, como un valor de CPU frente a 10 VMs, se cuenta como varias instancias de alerta (en este caso 10). Este número puede variar con el tiempo. Por ejemplo, una regla de alerta que monitorea el uso de la CPU para todos los VMs componentes de un sistema tiene más instancias de alerta a medida que VMs se van añadiendo. Para obtener más información acerca de las cuotas de las instancias de alerta, consulte [Errores de cuota alcanzada](alert-rules.md#rule-quota-reached).  | 
|  Grupo de alertas  |  Alertmanager agrupa las instancias de alerta de forma predeterminada mediante las etiquetas de la política de notificaciones raíz. Esto controla la eliminación de duplicados y los grupos de instancias de alerta que se envían a los puntos de contacto.  | 
|  Punto de contacto  |  Defina cómo se notifica a sus contactos cuando se activa una regla de alerta.  | 
|  Plantillas de mensajes  |  Cree plantillas personalizadas reutilizables y utilícelas en los puntos de contacto.  | 
|  Política de notificaciones  |  Conjunto de reglas sobre dónde, cuándo y cómo se agrupan las alertas y se dirigen a los puntos de contacto.  | 
|  Etiquetas y comparadores de etiquetas  |  Las etiquetas identifican de forma unívoca a reglas de alerta. Vinculan las reglas de alerta con las políticas de notificaciones y los silencios, determinando qué política debe gestionarlos y qué reglas de alerta deben silenciarse.  | 
|  Silencios  |  Detienen las notificaciones de una o más instancias de alerta. La diferencia entre un silencio y un temporizador de silencio es que el silencio dura un periodo de tiempo especificado, mientras que un temporizador de silencio se produce de forma periódica. Utiliza comparadores de etiquetas para silenciar las instancias de alerta.  | 
|  Temporizadores de silencio  |  Especifique un intervalo de tiempo en el que no quiere que se generen o envíen nuevas notificaciones. Puede congelar las notificaciones de alerta durante periodos de tiempo recurrentes, por ejemplo, durante un periodo de mantenimiento. Deben estar vinculados a una política de notificaciones existente.  | 

## Orígenes de datos de alertas
<a name="alert-sources"></a>

Las alertas administradas por Grafana consultan los siguientes orígenes de datos de backend que tienen las alertas habilitadas.
+ Orígenes de datos integrados o desarrollados y mantenidos por Grafana: `Alertmanager`, `Graphite`, `Prometheus` (incluido Amazon Managed Service para Prometheus), `Loki`, `InfluxDB`, `Amazon OpenSearch Service`, `Google Cloud Monitoring`, `Amazon CloudWatch`, `Azure Monitor`, `MySQL`, `PostgreSQL`, `MSSQL`, `OpenTSDB`, `Oracle` y `Azure Monitor`.

## Alertas sobre datos numéricos
<a name="alert-numeric"></a>

Los datos numéricos que no están en un formato de serie temporal pueden generar una alerta directamente o convertirse en expresiones del servidor. Esto permite un mayor procesamiento y, por lo tanto, una mayor eficiencia en el origen de datos, y también puede simplificar las reglas de alerta. Al alertar sobre datos numéricos en lugar de datos de serie temporal, no es necesario reducir cada serie temporal etiquetada a un solo número. En su lugar, los números etiquetados se devuelven a Grafana.

### Datos tabulares
<a name="alert-tabular-data"></a>

Esta característica es compatible con los orígenes de datos de backend que consultan datos tabulares, incluidos los orígenes de datos de SQL, como MySQL, Postgres, MSSQL y Oracle.

Una consulta con alertas administradas por Grafana o expresiones del servidor se considera numérica con los siguientes orígenes de datos:
+ Si la opción `Format AS` está establecida en `Table` en la consulta del origen de datos.
+ Si la respuesta de la tabla devuelta a Grafana desde la consulta incluye solo una columna numérica (por ejemplo, int, double o float) y, opcionalmente, columnas de cadenas adicionales.

Si hay columnas de cadenas, esas columnas se convierten en etiquetas. El nombre de la columna pasa a ser el nombre de la etiqueta y el valor de cada fila pasa a ser el valor de la etiqueta correspondiente. Si se devuelven varias filas, cada fila debe identificarse de forma única por sus etiquetas.

### Ejemplo
<a name="alert-tabular-example"></a>

Si tiene una tabla MySQL llamada Diskspace, como la siguiente.


| Time | Host | Disk | PercentFree | 
| --- | --- | --- | --- | 
|  2021-June-7  |  web1  |  /etc  |  3  | 
|  2021-June-7  |  web2  |  /var  |  4  | 
|  2021-June-7  |  web3  |  /var  |  8  | 
|  …  |  …  |  …  |  …  | 

Para poder consultar los datos, filtre por tiempo, pero sin devolver la serie temporal a Grafana. Por ejemplo, una alerta que se iniciaría por host, disco cuando haya menos del 5 % de espacio libre podría tener el siguiente aspecto.

```
SELECT Host, Disk, CASE WHEN PercentFree < 5.0 THEN PercentFree ELSE 0 END FROM (
  SELECT
      Host,
      Disk,
      Avg(PercentFree)
  FROM DiskSpace
  Group By
    Host,
    Disk
  Where __timeFilter(Time)
```

Esta consulta devuelve la siguiente respuesta de tabla a Grafana.


| Host | Disk | PercentFree | 
| --- | --- | --- | 
|  web1  |  /etc  |  3  | 
|  web2  |  /var  |  4  | 
|  web3  |  /var  |  0  | 

Cuando esta consulta se utiliza como **condición** en una regla de alerta, se genera una alerta en los casos en los que el valor es distinto de cero. Como resultado, se producen tres instancias de alerta, como se muestra en la siguiente tabla.


| Etiquetas | Status | 
| --- | --- | 
|  \$1Host=web1,disk=/etc\$1  |  Alertas  | 
|  \$1Host=web2,disk=/var\$1  |  Alertas  | 
|  \$1Host=web3,disk=/var\$1  |  Normal  | 

## Alertmanager
<a name="alert-alertmanager"></a>

Grafana incluye compatibilidad integrada con la instancia de Alertmanager de Prometheus. Alertmanager ayuda a agrupar y administrar las reglas de alerta y agrega una capa de orquestación sobre los motores de alertas. De forma predeterminada, las notificaciones de las alertas administradas por Grafana las gestiona la instancia de Alertmanager incrustado que forma parte del núcleo de Grafana. Puede configurar los puntos de contacto, las políticas de notificaciones y las plantillas de la instancia de Alertmanager desde la interfaz de usuario de alertas de Grafana; para ello, seleccione la opción Grafana en el menú desplegable Alertmanager.

Las alertas de Grafana admiten la configuración de la instancia externa de Alertmanager (para obtener más información sobre Alertmanager como origen de datos externo, consulte [Conexión a un origen de datos de Alertmanager](data-source-alertmanager.md)). Al agregar una instancia externa de Alertmanager, en el menú desplegable Alertmanager se muestra una lista de los orígenes de datos de Alertmanager externos disponibles. Seleccione un origen de datos para crear y administrar las alertas para los orígenes de datos independientes de Cortex o Loki.

## Estado de las reglas de alerta
<a name="alerts-state"></a>

El estado de las reglas de alerta ayuda a comprender varios indicadores clave del estado de las alertas. Hay tres componentes clave: estado de alerta, estado de regla de alerta e integridad de regla de alerta. Aunque están relacionados, cada componente transmite información ligeramente diferente.

**Estado de regla de alerta**
+ **Normal**: ninguna de las series temporales devueltas por el motor de evaluación está en estado `Pending` o `Firing`.
+ **Pendiente**: al menos el estado de una de las series temporales devueltas por el motor de evaluación es `Pending`.
+ **Activándose**: al menos el estado de una de las series temporales devueltas por el motor de evaluación es `Firing`.

**Estado de alerta**
+ **Normal**: la condición de la regla de alerta **no se cumple** para cada serie temporal devuelta por el motor de evaluación.
+ **En alerta**: la condición de la regla de alerta **se cumple** durante al menos una serie temporal devuelta por el motor de evaluación. El periodo durante el cual la condición debe cumplirse antes de que se inicie una alerta, si se ha establecido, se cumple o se supera.
+ **Pendiente**: la condición de la regla de alerta **se cumple** durante al menos una serie temporal devuelta por el motor de evaluación. No se ha cumplido el periodo durante el cual la condición debe cumplirse antes de que se inicie una alerta, si se ha establecido.
+ **NoData**— La regla de alerta no ha devuelto una serie temporal, todos los valores de la serie temporal son nulos o todos los valores de la serie temporal son cero.
+ **Error**: se produce un error al intentar evaluar una regla de alerta.

**Integridad de regla de alerta**
+ **Correcto**: no hay ningún error al evaluar una regla de alerta.
+ **Error**: error al evaluar una regla de alerta.
+ **NoData**— La ausencia de datos en al menos una serie temporal devuelta durante la evaluación de una regla.

# Creación y administración de reglas de alerta de Grafana
<a name="alert-rules"></a>

****  
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 8.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.md).  
Para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).

Una regla de alerta es un conjunto de criterios de evaluación que determinan si se inicia una alerta. La regla consta de una o más consultas y expresiones, una condición, la frecuencia de la evaluación y, opcionalmente, el tiempo durante el cual se cumple la condición.

Si bien las consultas y las expresiones seleccionan el conjunto de datos que se va a evaluar, una condición establece el umbral que una alerta debe alcanzar o superar para crear dicha alerta. Un intervalo especifica la frecuencia con la que se evalúa una regla de alertas. La duración, cuando se configura, indica durante cuánto tiempo debe cumplirse una condición. Las reglas también pueden definir el comportamiento de las alertas en ausencia de datos.

En las siguientes secciones se describen la creación y administración de diferentes tipos de reglas de alerta de Grafana.

**Topics**
+ [Creación de reglas de alerta administradas por Cortex o Loki](#create-alert-rule)
+ [Creación de reglas de registro administradas por Cortex o Loki](#create-alert-recording-rule)
+ [Creación de reglas de alerta administradas por Grafana](#create-grafana-alert-rule)
+ [Anotaciones y etiquetas para las reglas de alerta](#alert-rule-labels)
+ [Administración de reglas de alerta](#manage-alert-rules)
+ [Espacios de nombres y grupos de reglas de Cortex o Loki](#alert-rule-groups)

## Creación de reglas de alerta administradas por Cortex o Loki
<a name="create-alert-rule"></a>

Con Grafana, puede crear reglas de alerta para una instancia externa de Cortex o Loki.

**nota**  
Cortex es la base de datos de serie temporal que utilizan Amazon Managed Service para Prometheus y los orígenes de datos de Prometheus.

**Requisitos previos**
+ Compruebe que tenga permisos de escritura en el origen de datos de Prometheus. De lo contrario, no podrá crear ni actualizar las reglas de alerta administradas por Cortex.
+ En el caso de los orígenes de datos de Cortex y Loki, habilite la API de regla configurando sus respectivos servicios.
  + **Loki**: el tipo de almacenamiento de reglas `local`, predeterminado para el origen de datos de Loki, solo admite la visualización de reglas. Para editar las reglas, configure uno de los otros tipos de almacenamiento.
  + **Cortex**: utilice el prefijo heredado `/api/prom`, no `/prometheus`. El origen de datos de Prometheus es compatible con Cortex y Prometheus, y Grafana espera que tanto la API de consulta como la API de regla estén en la misma URL. No puede proporcionar una URL diferente para la API de regla.

**nota**  
Si no desea administrar las reglas de alerta para un origen de datos de Loki o Prometheus en particular, vaya a su configuración y desactive la casilla **Administrar alertas mediante la interfaz de usuario de alertas**.

**Cómo agregar una regla de alerta administrada por Cortex o Loki**

1. En la consola de Grafana, en el menú de Grafana, seleccione el icono **Alertas** (campana) para abrir la página **Alertas**, en la que se muestran las alertas existentes.

1. Elija **Nueva regla de alerta**.

1. En el **Paso 1**, agregue el nombre, el tipo y la ubicación de almacenamiento de la regla, de la siguiente manera:
   + En **Nombre de la regla**, escriba un nombre descriptivo. Este nombre aparece en la lista de las reglas de alertas. También es la etiqueta `alertname` de cada instancia de alerta que se crea a partir de esta regla.
   + En el menú desplegable **Tipo de regla**, seleccione **Alerta administrada por Cortex o Loki**.
   + En el menú desplegable **Seleccionar origen de datos**, seleccione un origen de datos de Prometheus o Loki.
   + En el menú desplegable **Espacio de nombres**, seleccione un espacio de nombres de reglas existente. En caso contrario, elija **Agregar nuevo** y escriba un nombre para crear uno. Los espacios de nombres pueden contener uno o más grupos de reglas y solo tienen un propósito organizativo. Para obtener más información, consulte [Espacios de nombres y grupos de reglas de Cortex o Loki](#alert-rule-groups).
   + En el menú desplegable **Grupo**, seleccione un grupo existente dentro del espacio de nombres seleccionado. En caso contrario, elija **Agregar nuevo** y escriba un nombre para crear uno. Las reglas recién creadas se agregan al final del grupo. Las reglas de un grupo se ejecutan secuencialmente a intervalos regulares, con el mismo tiempo de evaluación.

1. En el **Paso 2**, agregue la consulta que desee evaluar.

   El valor puede ser una expresión de PromQL o LogQL. La regla inicia una alerta si el resultado de la evaluación tiene al menos una serie con un valor superior a 0. Se crea una alerta para cada serie.

1. En el **Paso 3**, agregue condiciones.

   En el cuadro de texto Durante de la condición, especifique el tiempo durante el cual la condición debe cumplirse antes de que se inicie la alerta. Si especifica `5m`, las condiciones deben cumplirse durante cinco minutos antes de que se inicie la alerta.
**nota**  
Cuando se cumple una condición, la alerta pasa al estado `Pending`. Si la condición permanece activa durante el tiempo especificado, la alerta pasa al estado `Firing`. Si ya no se cumple, vuelve al estado `Normal`.

1. En el **Paso 4**, agregue metadatos adicionales asociados a la regla.
   + Agregue una descripción y un resumen para personalizar los mensajes de alerta. Utilice las directrices de [Anotaciones y etiquetas para las reglas de alerta](#alert-rule-labels).
   + Agrega la URL, el panel, el panel y la alerta IDs de Runbook.
   + Agregue etiquetas personalizadas.

1. Elija **Vista previa de alertas** para evaluar la regla y ver qué alertas generaría. Muestra una lista de alertas con el estado y el valor de cada una.

1. Seleccione **Guardar** para guardar la regla o **Guardar y salir** para guardar la regla y volver a la página **Alertas**.

## Creación de reglas de registro administradas por Cortex o Loki
<a name="create-alert-recording-rule"></a>

Puede crear y administrar reglas de registro para una instancia externa de Cortex o Loki. Las reglas de registro calculan por anticipado expresiones que se necesitan con frecuencia o que son costosas desde el punto de vista de la computación y guardan el resultado como un nuevo conjunto de series temporales. La consulta de esta nueva serie temporal es más rápida, especialmente en el caso de los paneles, ya que consultan la misma expresión cada vez que se actualizan.

**Requisitos previos**

En el caso de los orígenes de datos de Cortex y Loki, habilite la API de regla configurando sus respectivos servicios.
+ **Loki**: el tipo de almacenamiento de reglas `local`, predeterminado para el origen de datos de Loki, solo admite la visualización de reglas. Para editar las reglas, configure uno de los otros tipos de almacenamiento.
+ **Cortex**: al configurar un origen de datos de Prometheus de Grafana para que se dirija a Cortex, utilice el prefijo heredado `/api/prom`, no `/prometheus`. El origen de datos de Prometheus es compatible con Cortex y Prometheus, y Grafana espera que tanto la API de consulta como la API de regla estén en la misma URL. No puede proporcionar una URL diferente para la API de regla.

**nota**  
Si no desea administrar las reglas de alerta para un origen de datos de Loki o Prometheus en particular, vaya a su configuración y desactive la casilla **Administrar alertas mediante la interfaz de usuario de alertas**.

**Cómo agregar una regla de registro administrada por Cortex o Loki**

1. En la consola de Grafana, en el menú de Grafana, seleccione el icono **Alertas** (campana) para abrir la página **Alertas**, en la que se muestran las alertas existentes.

1. Elija **Nueva regla de alerta**.

1. En el **Paso 1**, agregue el nombre, el tipo y la ubicación de almacenamiento de la regla de la siguiente manera.
   + En **Nombre de la regla**, escriba un nombre descriptivo. Este nombre aparece en la lista de las reglas de alertas. También es la etiqueta `alertname` de cada instancia de alerta que se crea a partir de esta regla.
   + En el menú desplegable **Tipo de regla**, seleccione **Alerta administrada por Cortex o Loki**.
   + En el menú desplegable **Seleccionar origen de datos**, seleccione un origen de datos de Prometheus o Loki.
   + En el menú desplegable **Espacio de nombres**, seleccione un espacio de nombres de reglas existente. En caso contrario, elija **Agregar nuevo** y escriba un nombre para crear uno. Los espacios de nombres pueden contener uno o más grupos de reglas y solo tienen un propósito organizativo. Para obtener más información, consulte [Espacios de nombres y grupos de reglas de Cortex o Loki](#alert-rule-groups).
   + En el menú desplegable **Grupo**, seleccione un grupo existente dentro del espacio de nombres seleccionado. En caso contrario, elija **Agregar nuevo** y escriba un nombre para crear uno. Las reglas recién creadas se agregan al final del grupo. Las reglas de un grupo se ejecutan secuencialmente a intervalos regulares, con el mismo tiempo de evaluación.

1. En el **Paso 2**, agregue la consulta que desee evaluar.

   El valor puede ser una expresión de PromQL o LogQL. La regla inicia una alerta si el resultado de la evaluación tiene al menos una serie con un valor superior a 0. Se crea una alerta para cada serie.

1. En el **Paso 3**, agregue metadatos adicionales asociados a la regla.
   + Agregue una descripción y un resumen para personalizar los mensajes de alerta. Utilice las directrices de [Anotaciones y etiquetas para las reglas de alerta](#alert-rule-labels).
   + Agrega la URL, el panel, el panel y la alerta de Runbook. IDs
   + Agregue etiquetas personalizadas.

1. Seleccione **Guardar** para guardar la regla o **Guardar y salir** para guardar la regla y volver a la página **Alertas**.

## Creación de reglas de alerta administradas por Grafana
<a name="create-grafana-alert-rule"></a>

Grafana le permite crear reglas de alerta que consultan uno o más orígenes de datos, reducen o transforman los resultados y los comparan entre sí o para fijar umbrales. Cuando se procesan, Grafana envía notificaciones al punto de contacto.

**nota**  
La creación de reglas de alerta administradas por Grafana mientras se utilizan las alertas de Grafana hace que se envíen varias notificaciones cuando la regla coincide. Es posible que algunos proveedores de puntos de contacto tengan opciones configurables para eliminar las notificaciones duplicadas.

**Adición de una regla administrada por Grafana**

1. En la consola de Grafana, en el menú de Grafana, seleccione el icono **Alertas** (campana) para abrir la página **Alertas**, en la que se muestran las alertas existentes.

1. Elija **Nueva regla de alerta**.

1. En el **Paso 1**, agregue el nombre, el tipo y la ubicación de almacenamiento de la regla, de la siguiente manera:
   + En **Nombre de la regla**, escriba un nombre descriptivo. Este nombre aparece en la lista de las reglas de alertas. También es la etiqueta `alertname` de cada instancia de alerta que se crea a partir de esta regla.
   + En el menú desplegable **Tipo de regla**, seleccione **Alerta administrada por Grafana**.
   + En el menú desplegable **Carpeta**, seleccione la carpeta en la que quiere almacenar la regla. Si no selecciona ninguna carpeta, la regla se almacena en la carpeta `General`. Para crear una carpeta, seleccione el menú desplegable y escriba un nuevo nombre de carpeta.

1. En el **Paso 2**, agregue las consultas y expresiones que desee evaluar.
   + Mantenga el nombre predeterminado o coloque el cursor del ratón sobre el icono de edición y selecciónelo para cambiar el nombre.
   + En el caso de las consultas, seleccione un origen de datos del menú desplegable.
   + Agregue una o más [consultas](panel-queries.md) o expresiones (para obtener más información sobre las expresiones, consulte [Expressions](https://grafana.com/docs/grafana/next/panels/query-a-data-source/) en la *documentación de Grafana*).
   + Para cada expresión, seleccione **Condición clásica** para crear una regla de alerta única o elija entre las opciones **Matemáticas**, **Reducir** y **Remuestrear** para generar alertas independientes para cada serie. Para obtener más información sobre estas opciones, consulte [Reglas unidimensionales y multidimensionales](#single-multi-rule).
   + Elija **Ejecutar consultas** para comprobar que la consulta se completa correctamente.

1. En el **Paso 3**, agregue condiciones.
   + En el menú desplegable **Condición**, seleccione la consulta o expresión para iniciar la regla de alerta.
   + En **Evaluar cada**, especifique la frecuencia de la evaluación. Debe ser un múltiplo de 10 segundos. Por ejemplo, `1m`, `30s`.
   + En **Evaluar durante**, especifique el tiempo durante el cual la condición debe cumplirse antes de que se inicie una alerta.
**nota**  
Cuando se infringe una condición, la alerta pasa al estado `Pending`. Si la condición permanece infringida durante el tiempo especificado, la alerta pasa al estado `Firing`. Si ya no se cumple, vuelve al estado `Normal`.
   + En **Configurar la gestión de errores y ausencia de datos**, configure el comportamiento de las alertas en ausencia de datos. Siga las directrices de [Gestión de casos de error o ausencia de datos](#rule-no-data-error).
   + Elija **Vista previa de alertas** para comprobar el resultado de la ejecución de la consulta en este momento. La vista previa excluye las condiciones de gestión de errores y ausencia de datos.

1. En el **Paso 4**, agregue metadatos adicionales asociados a la regla.
   + Agregue una descripción y un resumen para personalizar los mensajes de alerta. Utilice las directrices de [Anotaciones y etiquetas para las reglas de alerta](#alert-rule-labels).
   + Agrega la URL, el panel, el panel y la alerta de Runbook. IDs
   + Agregue etiquetas personalizadas.

1. Seleccione **Guardar** para guardar la regla o **Guardar y salir** para guardar la regla y volver a la página **Alertas**.

### Reglas unidimensionales y multidimensionales
<a name="single-multi-rule"></a>

En el caso de las reglas de alerta administradas por Grafana, puede crear una regla con una condición clásica o puede crear una regla multidimensional.

**Regla unidimensional única (condición clásica)**

Utilice una expresión de condición clásica para crear una regla que inicie una alerta única cuando se cumpla su condición. En el caso de una consulta que devuelve varias series, Grafana no hace un seguimiento del estado de alerta de cada serie. Como resultado, Grafana envía una sola alerta incluso cuando se cumplen las condiciones de alerta para varias series.

Para obtener más información sobre cómo dar formato a las expresiones, consulte [Expressions](https://grafana.com/docs/grafana/next/panels/query-a-data-source/) en la *documentación de Grafana*.

**Regla multidimensional**

Para generar una instancia de alerta independiente para cada serie devuelta en la consulta, cree una regla multidimensional.

**nota**  
Cada instancia de alerta generada por una regla multidimensional se tiene en cuenta para la cuota total de alertas. Las reglas no se evalúan cuando alcanza su cuota de alertas. Para obtener más información sobre las cuotas de reglas multidimensionales, consulte [Errores de cuota alcanzada](#rule-quota-reached).

Para crear varias instancias a partir de una sola regla, utilice las expresiones `Math`, `Reduce` o `Resample` para crear una regla multidimensional. Por ejemplo, puede hacer lo siguiente:
+ Agregue una expresión `Reduce` para cada consulta a fin de agregar los valores del intervalo de tiempo seleccionado en un solo valor. (No es necesario para las [reglas que utilizan datos numéricos](alert-fundamentals.md#alert-numeric)).
+ Agregue una expresión `Math` con la condición de la regla. Esto no es necesario si una consulta o una expresión de reducción ya devuelven 0 si la regla no debe iniciar una alerta o un número positivo si debe iniciar una alerta. 

  Presentamos algunos ejemplos: 
  + `$B > 70`si debe iniciar una alerta en caso de que el valor de B query/expression sea superior a 70. 
  + `$B < $C * 100` en caso de que deba iniciar una alerta si el valor de B es menor que el valor de C multiplicado por 100. Si las consultas que se comparan tienen varias series en sus resultados, las series de consultas diferentes coinciden si tienen las mismas etiquetas o si una es un subconjunto de la otra.

**nota**  
Grafana no admite consultas de alertas con variables de plantilla. Hay más información disponible en la página de la comunidad [Template variables are not supported in alert queries while setting up Alert](https://community.grafana.com/t/template-variables-are-not-supported-in-alert-queries-while-setting-up-alert/2514).



**Consideraciones sobre el rendimiento de las reglas multidimensionales**

Cada instancia de alerta se tiene en cuenta para la cuota de alertas. Las reglas multidimensionales que crean más instancias de las que se pueden incluir en la cuota de alertas no se evalúan y devuelven un error de cuota. Para obtener más información, consulte [Errores de cuota alcanzada](#rule-quota-reached).

Las alertas multidimensionales pueden tener un gran impacto en el rendimiento de su espacio de trabajo de Grafana, así como en el rendimiento de sus orígenes de datos, ya que Grafana las consulta para evaluar sus reglas de alerta. Las siguientes consideraciones pueden resultarle útiles a la hora de optimizar el rendimiento de su sistema de supervisión.
+ **Frecuencia de evaluación de las reglas**: la propiedad **Evaluar cada** de una regla de alerta controla la frecuencia de la evaluación de las reglas. Le recomendamos que utilice la frecuencia de evaluación más baja aceptable. 
+ **Cardinalidad del conjunto de resultados**: el número de instancias de alerta que se crean con una regla afecta a su rendimiento. Supongamos que está supervisando los errores de respuesta de la API en todas las rutas de la API y en todas las máquinas virtuales de su flota. Este conjunto tiene una cardinalidad del número de rutas multiplicado por el número de VMs. Para reducir la cardinalidad del conjunto de resultados, por ejemplo, puede supervisar el total de errores por máquina virtual en lugar de por ruta por máquina virtual.
+ **Complejidad de la consulta**: las consultas que los orígenes de datos pueden procesar y responder rápidamente consumen menos recursos. Si bien esta consideración es menos importante que las demás consideraciones enumeradas anteriormente, si las ha reducido en la medida de lo posible, analizar el rendimiento de las consultas individuales podría marcar la diferencia. Debe ser consciente del impacto sobre el rendimiento que la evaluación de estas reglas tiene en sus orígenes de datos. La gran mayoría de las consultas gestionadas por las bases de datos de supervisión suelen ser consultas de alertas, por lo que se ven afectadas por los mismos factores de carga que afectan a la instancia de Grafana.

### Errores de cuota alcanzada
<a name="rule-quota-reached"></a>

Hay una cuota del número de instancias de alerta que puede tener en un único espacio de trabajo. Cuando alcance ese número, ya no podrá crear nuevas reglas de alerta en ese espacio de trabajo. Con las alertas multidimensionales, el número de instancias de alerta puede variar con el tiempo.

Es importante recordar lo siguiente al trabajar con instancias de alerta.
+ Si solo crea reglas unidimensionales, cada regla es una instancia de alerta única. Puede crear el mismo número de reglas en un único espacio de trabajo que su cuota de instancias de alerta, no más.
+ Las reglas multidimensionales crean varias instancias de alerta; sin embargo, el número no se conoce hasta que se evalúan. Por ejemplo, si crea una regla de alerta que hace un seguimiento del uso de la CPU de sus instancias de Amazon EC2, puede que haya 50 instancias de EC2 cuando la cree (y, por lo tanto, 50 instancias de alerta), pero si agrega 10 instancias de EC2 más una semana después, la siguiente evaluación tendrá 60 instancias de alerta.

  El número de instancias de alerta se evalúa al crear una alerta multidimensional y no se puede crear una que le haga superar inmediatamente la cuota de instancias de alerta. Como el número de instancias de alerta puede cambiar, la cuota se comprueba cada vez que se evalúan las reglas.
+ En el momento de la evaluación de las reglas, si una regla hace que supere su cuota de instancias de alerta, esa regla no se evaluará hasta que se actualice la regla de alerta para situar el recuento total de instancias de alerta por debajo de la cuota de servicio. Cuando esto ocurre, recibe una notificación de alerta en la que se le informa de que se ha alcanzado su cuota (la notificación utiliza la política de notificaciones de la regla que se está evaluando). La notificación incluye una anotación `Error` con el valor `QuotaReachedError`.
+ Una regla que provoca un error `QuotaReachedError` deja de evaluarse. La evaluación solo se reanuda cuando se efectúa una actualización y la evaluación posterior a la actualización no provoca por sí sola un error `QuotaReachedError`. Una regla que no se está evaluando muestra el error **Cuota alcanzada** en la consola de Grafana.
+ Para reducir el número de instancias de alerta, puede eliminar las reglas de alerta o editar las alertas multidimensionales para tener menos instancias de alerta (por ejemplo, tener una alerta de errores por máquina virtual, en lugar de una alerta de error por API en una máquina virtual).
+ Para reanudar las evaluaciones, actualice la alerta y guárdela. Puede actualizarla para reducir el número de instancias de alerta o, si ha aplicado otros cambios para reducir el número de instancias de alerta, puede guardarla sin cambios. Si es posible, se reanudará. Si provoca otro error `QuotaReachedError`, no podrá guardarla.
+ Cuando se guarda una alerta y se reanuda la evaluación sin superar la cuota de alertas, el error **Cuota alcanzada** puede seguir apareciendo en la consola de Grafana durante algún tiempo (hasta su intervalo de evaluación). Sin embargo, la evaluación de la regla de alerta comienza y las alertas se envían si se alcanza el umbral de la regla.
+ Para obtener más información sobre la cuota de alertas, así como sobre otras cuotas, consulte [Cuotas de servicio de Amazon Managed Grafana](AMG_quotas.md).

### Gestión de casos de error o ausencia de datos
<a name="rule-no-data-error"></a>

Elija opciones para gestionar el comportamiento de las alertas en ausencia de datos o cuando haya errores.

En la siguiente tabla, se muestran las opciones para gestionar la ausencia de datos.


| Opción Sin datos | Comportamiento | 
| --- | --- | 
|  Sin datos  |  Cree una alerta `DatasourceNoData` con el nombre y el UID de la regla de alerta y el UID del origen de datos que no devolvió ningún dato como etiquetas.  | 
|  Alertas  |  Defina el estado de la regla de alerta en `Alerting`.  | 
|  OK  |  Defina el estado de la regla de alerta en `Normal`.  | 

En la siguiente tabla, se muestran las opciones para gestionar los casos de error.


| Opción de error o tiempo de espera | Comportamiento | 
| --- | --- | 
|  Alertas  |  Defina el estado de la regla de alerta en `Alerting`.  | 
|  OK  |  Defina el estado de la regla de alerta en `Normal`.  | 
|  Error  |  Cree una alerta `DatasourceError` con el nombre y el UID de la regla de alerta y el UID del origen de datos que no devolvió ningún dato como etiquetas.  | 

## Anotaciones y etiquetas para las reglas de alerta
<a name="alert-rule-labels"></a>

Las anotaciones y las etiquetas son pares de clave-valor asociados a las alertas que se originan a partir de la regla de alerta, la respuesta del origen de datos y como resultado de la evaluación de la regla de alerta. Se pueden usar directamente en las notificaciones de alertas o en [plantillas](alert-message-templates.md) y [funciones de plantillas](alert-message-templates.md#alert-template-functions) para crear contactos de notificación de forma dinámica.

**Annotations**

Las anotaciones son pares de clave-valor que proporcionan información adicional sobre una alerta. Puede utilizar las siguientes anotaciones: `description`, `summary`, `runbook_url`, `alertId`, `dashboardUid` y `panelId`. Se muestran en los detalles de las reglas y alertas en la interfaz de usuario y se pueden usar en las plantillas de mensajes de puntos de contacto.

**Etiquetas**

Las etiquetas son pares de clave-valor que contienen información sobre una alerta. El conjunto de etiquetas para una alerta se genera y se agrega a lo largo del proceso de evaluación y notificación de la alerta. Se usan de las siguientes maneras.
+ El conjunto completo de etiquetas para una alerta identifica de forma única a esa alerta dentro de las alertas de Grafana.
+ El Alertmanager utiliza etiquetas para hacer coincidir las alertas con los [silencios](alert-silences.md) y los [grupos de alertas](alert-groups.md) en las [políticas de notificaciones](alert-notifications.md).
+ En la interfaz de usuario de alertas se muestran etiquetas para cada instancia de alerta generada por la evaluación de esa regla.
+ Los puntos de contacto pueden acceder a las etiquetas para generar dinámicamente notificaciones que contienen información específica de la alerta que está dando lugar a una notificación.
+ Se pueden agregar etiquetas a una [regla de alerta](#alert-rules). Estas etiquetas configuradas manualmente pueden utilizar funciones de plantilla y hacer referencia a otras etiquetas. Las etiquetas agregadas a una regla de alerta aquí tienen prioridad en caso de colisión entre etiquetas.

Las siguientes variables de plantilla están disponibles al expandir anotaciones y etiquetas.


| Name | Description (Descripción) | 
| --- | --- | 
|  `$labels`  |  Etiquetas de la consulta o condición. Por ejemplo, `{{ $labels.instance }}` y `{{ $labels.job }}`. No está disponible cuando la regla usa una condición clásica.  | 
|  `$values`  |  Valores de todas las expresiones de reducción y matemáticas que se evaluaron para esta regla de alerta. Por ejemplo `{{ $values.A }}`, `{{ $values.A.Labels }}` y `{{ $values.A.Value }}` donde `A` es el valor de `refID` de la expresión. No está disponible cuando la regla usa una condición clásica.  | 
|  `$value`  |  Cadena de valores de la instancia de alerta. Por ejemplo, `[ var='A' labels={instance=foo} value=10 ]`.  | 

## Administración de reglas de alerta
<a name="manage-alert-rules"></a>



En la página **Alertas** se muestran las reglas de alerta. De forma predeterminada, las reglas se agrupan por tipos de orígenes de datos. En la sección **Grafana** se indican las reglas administradas por Grafana y en la sección **Cortex o Loki**, las reglas para los orígenes de datos compatibles con Prometheus. Puede ver las reglas de alertas de los orígenes de datos compatibles con Prometheus, pero no puede editarlas.

### Visualización de reglas de alertas
<a name="manage-alerts-view"></a>

Con las alertas de Grafana, puede ver todas sus alertas en una página.

**Visualización de detalles de las alertas**

1. En la consola de Grafana, en el menú de Grafana, seleccione el icono **Alertas** (campana) para abrir la página **Alertas**. De forma predeterminada, las reglas se muestran en grupos por tipo de origen de datos. También puede consultarlas según el estado actual de cada alerta (se describen con más detalle en el texto siguiente).

1. En **Ver como**, puede alternar entre las vistas de grupo y de estado mediante la elección de la opción que prefiera.

1. Seleccione la flecha situada junto a una fila para ver más detalles de esa fila. Los detalles de una regla incluyen las etiquetas de la regla, las anotaciones, los orígenes de datos y las consultas, así como una lista de las instancias de alerta resultantes de la regla.

**Vista de grupo**

En la vista de grupo se muestran las reglas de alerta de Grafana agrupadas por carpeta y las reglas de alerta de Loki o Prometheus agrupadas por `namespace` y `group`. Esta es la vista de lista de reglas predeterminada, destinada a administrar las reglas. Puede expandir cada grupo para ver una lista de las reglas de este grupo. Expanda una regla para ver sus detalles. También puede expandir los botones de acción y las alertas resultantes de la regla para ver sus detalles.

**Vista de estado**

En la vista de estado se muestran las reglas de alerta agrupadas por estado. Utilice esta vista para obtener información general de qué reglas se encuentran en qué estado. Se puede expandir cada regla para ver sus detalles. Los botones de acción, las alertas generadas por esta regla y las alertas se pueden expandir aún más para ver sus detalles.

**Filtrado de las reglas de alerta**

Puede filtrar las reglas de alerta que aparecen en la página **Alertas** de varias maneras.
+ Puede filtrarlas para mostrar las reglas que consultan un origen de datos específica; para ello, elija **Seleccionar orígenes de datos** y, a continuación, seleccione un origen de datos por el que filtrar.
+ Puede filtrarlas por etiquetas; para ello, seleccione los criterios de búsqueda en **Buscar por etiqueta**. Algunos criterios de ejemplo incluyen `environment=production`, `region=~US|EU` o `severity!=warning`.
+ Puede filtrarlas para mostrar las reglas en un estado específico; para ello, seleccione **Filtrar alertas por estado** y, a continuación, seleccione el estado que desee ver.

### Edición o eliminación de reglas de alerta
<a name="manage-alerts-edit"></a>

Las reglas de alerta administradas por Grafana solo las pueden editar o eliminar los usuarios con permisos de edición para la carpeta en la que se almacenan las reglas. Los usuarios con roles de editor o administrador pueden editar o eliminar las reglas de alerta de una instancia externa de Cortex o Loki.

**Edición o eliminación de una regla**

1. Expanda una regla hasta que pueda ver los controles de reglas **Ver**, **Editar** y **Eliminar**.

1. Elija **Editar** para abrir la página de creación de reglas. Efectúe las actualizaciones de la misma manera que crea una regla. Para obtener información más detallada, consulte las instrucciones que se describen en [Creación de reglas de alerta administradas por Grafana](#create-grafana-alert-rule) o [Creación de reglas de alerta administradas por Cortex o Loki](#create-alert-rule).

1. Si lo desea, elija **Eliminar** para eliminar una regla.

## Espacios de nombres y grupos de reglas de Cortex o Loki
<a name="alert-rule-groups"></a>

Puede organizar sus reglas. Las reglas se crean dentro de grupos de reglas y los grupos de reglas se organizan en espacios de nombres. Las reglas de un grupo de reglas se ejecutan secuencialmente a intervalos regulares. El intervalo predeterminado es de un minuto. Puede cambiar los espacios de nombres y grupos de reglas de Cortex o Loki y editar los intervalos de evaluación de los grupos de reglas.

**Edición de un espacio de nombres o grupo de reglas**

1. En la consola de Grafana, en el menú de Grafana, seleccione el icono **Alertas** (campana) para abrir la página **Alertas**.

1. Vaya a una regla del grupo de reglas o del espacio de nombres que desea editar.

1. Elija el icono **Editar** (lápiz).

1. Haga cambios en el grupo de reglas o en el espacio de nombres.
**nota**  
En el caso de los espacios de nombres, solo se puede editar el nombre. En el caso de los grupos de reglas, cambia el nombre o el intervalo de evaluación de las reglas del grupo. Por ejemplo, puede elegir `1m` para que las reglas se evalúen una vez por minuto o `30s` para que se evalúen una vez cada 30 segundos.

1. Seleccione **Save changes (Guardar cambios)**.

# Grupos de alertas
<a name="alert-groups"></a>

****  
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 8.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.md).  
Para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).

Los grupos de alertas muestran alertas agrupadas de una instancia de Alertmanager. De forma predeterminada, las alertas se agrupan según las claves de etiqueta de la política raíz en [Uso de políticas de notificaciones](alert-notifications.md). Al agrupar las alertas comunes en un solo grupo de alertas, se evita que se inicien alertas duplicadas.

**Visualización de las agrupaciones de alertas**

1. En la consola de Grafana, en el menú de Grafana, seleccione el icono **Alertas** (campana) y, a continuación, haga clic en el elemento **Agrupación de alertas** para abrir la página en la que se muestran las alertas existentes.

1. En el menú desplegable **Alertmanager**, seleccione una instancia externa de Alertmanager como origen de datos. De forma predeterminada, está seleccionado la instancia de Alertmanager de `Grafana`.

1. En el menú desplegable **Grupo personalizado por**, seleccione una combinación de etiquetas para ver una agrupación distinta de la predeterminada. Puede utilizar esta vista para depurar o verificar la agrupación de políticas de notificaciones.

Las alertas sin etiquetas especificadas en la agrupación de la política raíz o en la agrupación personalizada se agregan a un grupo con un encabezado de `No grouping`.

**Filtración de alertas**

Puede usar los siguientes filtros para ver las alertas que coincidan con criterios específicos:
+ **Buscar por etiqueta**: en **Búsqueda**, ingrese una etiqueta existente para ver las alertas que coincidan con la etiqueta. Por ejemplo, `environment=production`, `region=~US|EU`, `severity!=warning`.
+ **Filtrar las alertas por estado**: en **Estados**, seleccione uno de los estados (`Active`, `Suppressed` o `Unprocessed`) para ver las alertas que correspondan a ese estado.

# Silenciamiento de las notificaciones de alertas para los orígenes de datos de Prometheus
<a name="alert-silences"></a>

****  
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 8.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.md).  
Para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).

En el caso de los orígenes de datos externos de Alertmanager (incluido Amazon Managed Service para Prometheus), puede suprimir las notificaciones de alertas con un *silencio*. Un silencio solo impide que se creen notificaciones; los silencios no impiden que se evalúen las reglas de alerta ni impiden que las instancias de alerta se muestren en la interfaz de usuario. Al silenciar una alerta, se especifica un periodo de tiempo para que se suprima.

Puede configurar los silencios del origen de datos de un Alertmanager externo.

**nota**  
Para suprimir las notificaciones de alertas a intervalos de tiempo regulares (por ejemplo, durante los periodos de mantenimiento habituales), utilice [Temporizadores de silencio](alert-notifications.md#alert-notification-muting) en lugar de silencios.

**Adición de un silencio**

1. En la consola de Grafana, en el menú de Grafana, seleccione el icono **Alertas** (campana) para abrir la página **Alertas**.

1. Seleccione **Silencios** para abrir una página con una lista de los [puntos de contacto](alert-contact-points.md) existentes.

1. Elija el Alertmanager externo en el menú desplegable **Alertmanager**.

1. Seleccione **Nuevo silencio**.

1. Seleccione la fecha de inicio y finalización en **Inicio y finalización del silencio** para indicar cuándo debe entrar en vigor el silencio y cuándo debe terminar.

   Como alternativa a establecer una hora de finalización, en **Duración**, especifique durante cuánto tiempo se aplicará el silencio. Esto actualiza automáticamente la hora de finalización en el campo **Inicio y finalización del silencio**.

1. En los campos **Nombre** y **Valor**, ingrese una o más *etiquetas coincidentes*. Los comparadores determinan a qué reglas se aplica el silencio. A continuación, se analiza con más detalle la coincidencia de etiquetas siguiendo este procedimiento.

1. Si lo desea, agregue un **comentario** o modifique el **creador** para establecer el propietario del silencio.

**Coincidencia de etiquetas para suprimir alertas**

Al crear un silencio, crea un conjunto de *etiquetas coincidentes* como parte del silencio. Se trata de un conjunto de reglas sobre las etiquetas que deben coincidir para que se suprima la alerta. Las etiquetas coincidentes constan de tres partes:
+ **Etiqueta**: nombre de la etiqueta que debe coincidir. Debe coincidir exactamente con el nombre de la etiqueta de la alerta.
+ **Operador**: operador utilizado para comparar el valor de la etiqueta con el valor de la etiqueta coincidente. Los operadores disponibles son:
  + `=` Seleccione etiquetas cuyo valor coincida exactamente con la cadena proporcionada.
  + `!=` Seleccione etiquetas cuyo valor no coincida con la cadena proporcionada.
  + `=~` Seleccione etiquetas cuyo valor coincida con el valor interpretado por expresiones regulares de la cadena proporcionada (la cadena proporcionada se interpreta como una expresión regular).
  + `!=` Seleccione etiquetas que no coincidan con la expresión regular proporcionada.
+ **Valor**: el valor con el que debe coincidir el valor de la etiqueta. Puede coincidir como una cadena o como una expresión regular, según el operador elegido.

Un silencio finaliza en la fecha de finalización indicada, pero puede finalizar la supresión manualmente en cualquier momento.

**Finalización manual de un silencio**

1. En la página **Alertas**, seleccione **Silencios** para ver la lista de los silencios existentes.

1. Seleccione el silencio que quiere finalizar y elija **Desactivar silencio**. Esto pone fin a la supresión de alertas.
**nota**  
La desactivación del silencio finaliza la supresión de alertas, como si la hora de finalización estuviera configurada para la hora actual. Los silencios que han finalizado (automática o manualmente) se conservan y se enumeran durante cinco días. No puede eliminar un silencio de la lista manualmente.

**Creación de un enlace al formulario de creación de silencios**

Puede crear una URL para el formulario de creación de silencios con los detalles ya rellenados. Los operadores pueden usarlo para suprimir rápidamente una alarma durante un evento operativo.

Al crear un enlace a un formulario de silencio, utilice un parámetro de consulta `matchers` para especificar las etiquetas coincidentes y un parámetro de consulta `comment` para especificar un comentario. El parámetro `matchers` requiere uno o más valores en formato `[label][operator][value]`, separados por comas.

**URL de ejemplo**

Para enlazar a un formulario de silencios, con etiquetas coincidentes `severity=critical` y `cluster!~europe-.*` con un comentario que ponga `Silencing critical EU alerts`, utilice una URL como la siguiente. *mygrafana*Sustitúyalo por el nombre de host de tu instancia de Grafana.

```
https://mygrafana/alerting/silence/new?matchers=severity%3Dcritical%2Ccluster!~europe-*&comment=Silence%20critical%20EU%20alert
```

Para enlazar a una nueva página de silencios de un Alertmanager externo, agregue un parámetro de consulta `alertmanager` con el nombre del origen de datos del Alertmanager, como `alertmanager=myAlertmanagerdatasource`.

# Uso de puntos de contacto
<a name="alert-contact-points"></a>

****  
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 8.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.md).  
Para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).

Utilice los puntos de contacto para definir cómo se notifica a sus contactos cuando se inicia una alerta. Un punto de contacto puede tener uno o más tipos de puntos de contacto, por ejemplo, Amazon Simple Notification Service o Slack. Cuando se inicia una alerta, se envía una notificación a todos los tipos de puntos de contacto listados para un punto de contacto. Si lo desea, puede usar [Uso de plantillas de mensajes](alert-message-templates.md) para personalizar los mensajes de notificación para los tipos de puntos de contacto.

**nota**  
Puede crear y editar puntos de contacto para las alertas administradas por Grafana. Los puntos de contacto para las alertas de Alertmanager son de solo lectura.

## Uso de puntos de contacto
<a name="alert-working-contact-points"></a>

Los procedimientos que aparecen a continuación le muestran cómo agregar, editar, probar y eliminar puntos de contacto.

**Cómo agregar un punto de contacto**

1. En la consola de Grafana, en el menú de Grafana, seleccione el icono **Alertas** (campana) para abrir la página **Alertas**.

1. Seleccione **Puntos de contacto** y, a continuación, **Nuevo punto de contacto**.

1. En el menú desplegable **Alertmanager**, seleccione un Alertmanager. De forma predeterminada, está seleccionado Grafana Alertmanager.

1. Ingrese un **nombre** para el punto de contacto.

1. En **Tipo de punto de contacto**, elija un tipo y los campos obligatorios en función de ese tipo. Por ejemplo, si elige Slack, ingrese los canales y usuarios de Slack con los que debe contactar.

1. Si está disponible para el punto de contacto que seleccionó, si lo desea, elija **Configuración opcional** para especificar configuraciones adicionales.

1. En **Configuración de notificaciones**, si lo desea, seleccione **Deshabilitar el mensaje resuelto** si no desea recibir una notificación cuando se resuelva una alerta.

1. Si su punto de contacto necesita más tipos de puntos de contacto, puede elegir **Nuevo tipo de punto de contacto** y repetir los pasos para cada tipo de punto de contacto que necesite.

1. Elija **Guardar punto de contacto** para guardar los cambios.

**Edición de un punto de contacto**

1. Elija **Puntos de contacto** para ver una lista de los puntos de contacto existentes.

1. Seleccione el punto de contacto que desee editar y, a continuación, seleccione el icono **Editar** (lápiz).

1. Haga los cambios necesarios y, a continuación, seleccione **Guardar punto de contacto** para guardar los cambios.

Una vez creado el punto de contacto, puede enviar una notificación de prueba para comprobar que está configurado correctamente.

**Envío de una notificación de prueba**

1. Elija **Puntos de contacto** para abrir la lista de los puntos de contacto existentes.

1. Seleccione el punto de contacto que desee probar y, a continuación, seleccione el icono **Editar** (lápiz).

1. Seleccione el icono **Probar** (avión de papel).

1. Elija si desea enviar una notificación de prueba predefinida o seleccione **Personalizar** para agregar sus propias anotaciones y etiquetas personalizadas a la notificación de prueba.

1. Elija **Enviar notificación de prueba** para probar la alerta con los puntos de contacto indicados.

Puede eliminar los puntos de contacto que la política de notificaciones no esté utilizando.

**Eliminación de un punto de contacto**

1. Elija **Puntos de contacto** para abrir la lista de los puntos de contacto existentes.

1. Seleccione el punto de contacto que desee eliminar y, a continuación, seleccione el icono **Eliminar** (papelera).

1. En el cuadro de diálogo de confirmación, elija **Sí, eliminar**.

**nota**  
Si una política de notificaciones está utilizando el punto de contacto, debe eliminarla o editarla para usar un punto de contacto diferente antes de eliminar el punto de contacto.

## Lista de los notificadores admitidos
<a name="alert-supported-notifiers"></a>


|  Name  |  Tipo  | 
| --- | --- | 
| Amazon SNS  |  sns  | 
|  OpsGenie  |  opsgenie  | 
| PagerDuty  |  pagerduty  | 
| Slack  |  slack  | 
|  VictorOps  |  victorops  | 

# Uso de plantillas de mensajes
<a name="alert-message-templates"></a>

****  
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 8.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.md).  
Para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).

Las notificaciones que se envían a través de [Uso de puntos de contacto](alert-contact-points.md) se crean mediante *plantillas de mensajes*. Las plantillas predeterminadas de Grafana se basan en el [sistema de plantillas de Go](https://golang.org/pkg/text/template), en el que algunos campos se evalúan como texto, mientras que otros se evalúan como HTML (lo que puede afectar al escape).

Como la mayoría de los campos de puntos de contacto pueden tener plantillas, puede crear plantillas personalizadas reutilizables y utilizarlas en varios puntos de contacto. En el tema [Datos de plantilla](#alert-template-data) se enumeran las variables que están disponibles para la creación de plantillas.

**Uso de plantillas**

Las plantillas se utilizan para crear un mensaje. Por ejemplo, con un mensaje de alerta de Slack, puede establecer el título y el cuerpo del punto de contacto. En el siguiente ejemplo se muestra cómo usar las plantillas predeterminadas para crear un título que contenga un recuento de las alertas que se están activando y que están resueltas, y un cuerpo que muestre las alertas y sus estados.
+ **Título**:

  ```
  {{ len .Alerts.Firing }} firing, {{ len .Alerts.Resolved }} resolved
  ```
+ **Cuerpo del texto**: 

  ```
  {{ range .Alerts }}{{ .Status }}: {{ .Labels.alertname }}
  {{end }}
  ```

Puede crear sus propias plantillas personalizadas, como en el ejemplo siguiente.
+ **Título**:

  ```
  {{ template "slack.default.title" .}}
  ```
+ **Cuerpo del texto**: 

  ```
  {{ template "mymessage" .}}
  ```

A continuación se muestra una plantilla de ejemplo.

```
{{ define "myalert" }}
  [{{.Status}}] {{ .Labels.alertname }}

  Labels:
  {{ range .Labels.SortedPairs }}
    {{ .Name }}: {{ .Value }}
  {{ end }}

  {{ if gt (len .Annotations) 0 }}
  Annotations:
  {{ range .Annotations.SortedPairs }}
    {{ .Name }}: {{ .Value }}
  {{ end }}
  {{ end }}

  {{ if gt (len .SilenceURL ) 0 }}
    Silence alert: {{ .SilenceURL }}
  {{ end }}
  {{ if gt (len .DashboardURL ) 0 }}
    Go to dashboard: {{ .DashboardURL }}
  {{ end }}
{{ end }}
```

Los procedimientos que aparecen a continuación le muestran cómo crear, editar y eliminar plantillas de mensajes personalizadas.

**Creación de una plantilla de mensaje**

1. En la consola de Grafana, en el menú de Grafana, seleccione el icono **Alertas** (campana) para abrir la página **Alertas**.

1. Seleccione **Puntos de contacto**.

1. En el menú desplegable **Alertmanager**, seleccione la instancia de Alertmanager para la que quiere crear una plantilla de mensaje. La predeterminada es la instancia de Alertmanager de Grafana.

1. Elija **Agregar plantilla**.

1. Indique un **nombre** descriptivo.

1. Agregue el **contenido** de la plantilla, por ejemplo:

   ```
   {{ define "mymessage" }}
     {{ range .Alerts }}
       [{{ .Status }}] {{ range .Labels }} {{ .Name }}={{.Value }}{{end}}
     {{ end }}
   {{ end }}
   ```

   La etiqueta `define` de la sección de contenido asigna el nombre de la plantilla. Esta etiqueta es opcional y, si se omite, el nombre de la plantilla se deriva del campo **Nombre**. Cuando se especifican ambas, se recomienda mantenerlas iguales.

1. Elija **Guardar plantilla**.

**nota**  
El HTML de las plantillas de mensajes de alerta se representa como texto, con los caracteres de control escapados. Grafana no admite la representación de HTML en la notificación resultante.

**Edición de una plantilla de mensaje**

1. En la página **Alertas**, elija **Puntos de contacto** para abrir la lista de puntos de contacto.

1. En la **tabla de plantillas**, busque la plantilla que desee editar y, a continuación, seleccione el icono **Editar** (lápiz).

1. Haga sus cambios y, a continuación, elija **Guardar**.

**Eliminación de una plantilla de mensaje**

1. En la página **Alertas**, elija **Puntos de contacto** para abrir la lista de puntos de contacto.

1. En la **tabla de plantillas**, busque la plantilla que desea eliminar y, a continuación, seleccione el icono **Eliminar** (papelera).

1. Elija **Sí, eliminar** para eliminar la plantilla.

**Plantillas anidadas**

Puede incrustar plantillas dentro de otras plantillas.

Por ejemplo, puede definir un fragmento de plantilla mediante la palabra clave `define`:

```
{{ define "mytemplate" }}
  {{ len .Alerts.Firing }} firing. {{ len .Alerts.Resolved }} resolved.
{{ end }}
```

A continuación, puede incrustar plantillas personalizadas en este fragmento mediante la palabra clave `template`. Por ejemplo:

```
Alert summary:
{{ template "mytemplate" . }}
```

Puede utilizar las siguientes opciones de plantilla integradas para incrustar plantillas personalizadas.


| Name | Notas | 
| --- | --- | 
|  `default.title`  |  Muestra información general de estado.  | 
|  `default.message`  |  Proporciona un resumen con formato de las alertas que se están activando y que están resueltas.  | 

**Ejemplos de plantillas personalizadas**

Estos son algunos ejemplos de cómo usar plantillas personalizadas.

Plantilla para representar una sola alerta:

```
{{ define "myalert" }}
  [{{.Status}}] {{ .Labels.alertname }}

  Labels:
  {{ range .Labels.SortedPairs }}
    {{ .Name }}: {{ .Value }}
  {{ end }}

  {{ if gt (len .Annotations) 0 }}
  Annotations:
  {{ range .Annotations.SortedPairs }}
    {{ .Name }}: {{ .Value }}
  {{ end }}
  {{ end }}

  {{ if gt (len .SilenceURL ) 0 }}
    Silence alert: {{ .SilenceURL }}
  {{ end }}
  {{ if gt (len .DashboardURL ) 0 }}
    Go to dashboard: {{ .DashboardURL }}
  {{ end }}
{{ end }}
```

Plantilla para representar el mensaje de notificación completo:

```
{{ define "mymessage" }}
  {{ if gt (len .Alerts.Firing) 0 }}
    {{ len .Alerts.Firing }} firing:
    {{ range .Alerts.Firing }} {{ template "myalert" .}} {{ end }}
  {{ end }}
  {{ if gt (len .Alerts.Resolved) 0 }}
    {{ len .Alerts.Resolved }} resolved:
    {{ range .Alerts.Resolved }} {{ template "myalert" .}} {{ end }}
  {{ end }}
{{ end }}
```

## Datos de plantilla
<a name="alert-template-data"></a>

Los siguientes datos se transfieren a las plantillas de mensajes.


| Name | Tipo | Notas | 
| --- | --- | --- | 
|  `Receiver`  |  cadena  |  Nombre del punto de contacto al que se envía la notificación.  | 
|  `Status`  |  cadena  |  firing si se está activando al menos una alerta; de lo contrario, resolved.  | 
|  `Alerts`  |  Alerta  |  Lista de los objetos de alerta que se incluyen en esta notificación (véase más abajo).  | 
|  `GroupLabels`  |  KeyValue  |  Etiquetas por las que se agruparon estas alertas.  | 
|  `CommonLabels`  |  KeyValue  |  Etiquetas comunes a todas las alertas incluidas en esta notificación.  | 
|  `CommonAnnotations`  |  KeyValue  |  Anotaciones comunes a todas las alertas incluidas en esta notificación.  | 
|  `ExternalURL`  |  cadena  |  Enlace para volver a la instancia de Grafana que envió la notificación. Si utiliza un Alertmanager externo, enlace para volver a este Alertmanager.  | 

El tipo `Alerts` presenta dos funciones para filtrar las alertas devueltas.
+ `Alerts.Firing`: devuelve una lista de alertas en activación.
+ `Alerts.Resolved`: devuelve una lista de alertas resueltas.

**Alerta (tipo)**

El tipo de alerta contiene los datos siguientes.


| Name | Tipo | Notas | 
| --- | --- | --- | 
|  Status  |  cadena  |  `firing` o bien `resolved`.  | 
|  Etiquetas  |  KeyValue  |  Un conjunto de etiquetas adjunto a la alerta.  | 
|  Anotaciones  |  KeyValue  |  Un conjunto de anotaciones adjunto a la alerta.  | 
|  StartsAt  |  time.Time  |  Hora en que la alerta empezó a activarse.  | 
|  EndsAt  |  time.Time  |  Se establece solo si se conoce la hora de finalización de una alerta. De lo contrario, se establece en un periodo de tiempo de espera configurable a partir del momento en que se recibió la última alerta.  | 
|  GeneratorURL  |  cadena  |  Enlace para volver a Grafana o a una instancia externa de Alertmanager.  | 
|  SilenceURL  |  cadena  |  Enlace a un silencio de Grafana con las etiquetas para esta alerta rellenadas previamente. Solo para alertas administradas por Grafana.  | 
|  DashboardURL  |  cadena  |  Enlace al panel de control de Grafana, si la regla de alerta pertenece a uno. Solo para alertas administradas por Grafana.  | 
|  PanelURL  |  cadena  |  Enlace al panel de paneles de control de Grafana, si la regla de alerta pertenece a uno. Solo para alertas administradas por Grafana.  | 
|  Huella digital  |  cadena  |  Huella digital que se puede utilizar para identificar la alerta.  | 
|  ValueString  |  cadena  |  Una cadena que contiene las etiquetas y el valor de cada expresión reducida de la alerta.  | 

**KeyValue type**

El `KeyValue` tipo es un conjunto de pares de key/value cadenas que representan etiquetas y anotaciones.

Además del acceso directo a los datos almacenados como `KeyValue`, también hay métodos para ordenar, eliminar y transformar los datos.


| Name | Argumentos | Devuelve | Notas | 
| --- | --- | --- | --- | 
|  SortedPairs  |    |  Lista ordenada de pares de cadenas de claves y valores  |    | 
|  Quitar  |  []string  |  KeyValue  |  Devuelve una copia del Key/Value mapa sin las claves indicadas.  | 
|  Nombres  |    |  []string  |  Lista de nombres de etiquetas  | 
|  Valores  |    |  []string  |  Lista de valores de etiquetas  | 



## Funciones de plantilla
<a name="alert-template-functions"></a>

Con las funciones de plantilla, puede procesar etiquetas y anotaciones para generar notificaciones dinámicas. Están disponibles las siguientes funciones.


| Name | Tipo de argumento | Tipo de devolución | Description (Descripción) | 
| --- | --- | --- | --- | 
|  `humanize`  |  número o cadena  |  cadena  |  Convierte un número a un formato más legible mediante prefijos métricos.  | 
|  `humanize1024`  |  número o cadena  |  cadena  |  Como humanize, pero usa 1024 como base en lugar de 1000.  | 
|  `humanizeDuration`  |  número o cadena  |  cadena  |  Convierte una duración en segundos a un formato más legible.  | 
|  `humanizePercentage`  |  número o cadena  |  cadena  |  Convierte un valor de relación en una fracción de 100.  | 
|  `humanizeTimestamp`  |  número o cadena  |  cadena  |  Convierte una marca de tiempo de Unix en segundos a un formato más legible.  | 
|  `title`  |  cadena  |  cadena  |  strings.Title, pone en mayúscula el primer carácter de cada palabra.  | 
|  `toUpper`  |  cadena  |  cadena  |  cadenas. ToUpper, convierte todos los caracteres a mayúsculas.  | 
|  `toLower`  |  cadena  |  cadena  |  cadenas. ToLower, convierte todos los caracteres a minúsculas.  | 
|  `match`  |  patrón, texto  |  booleano  |  expresiones regulares. MatchString Pruebas para detectar una coincidencia de expresiones regulares no anclada.  | 
|  `reReplaceAll`  |  patrón, reemplazo, texto  |  cadena  |  Expresión regular. ReplaceAllString Sustitución de expresiones regulares, sin anclaje.  | 
|  `graphLink`  |  cadena: objeto JSON con campos `expr` y `datasource`  |  cadena  |  Devuelve la ruta a la vista gráfica en Explore para la expresión y el origen de datos determinados.  | 
|  `tableLink`  |  cadena: objeto JSON con campos `expr` y `datasource`  |  cadena  |  Devuelve la ruta a la vista tabular en Explore para la expresión y el origen de datos determinados.  | 
|  `args`  |  []interface\$1\$1  |  map[string]interface\$1\$1  |  Convierte una lista de objetos en una asignación con claves, por ejemplo, arg0, arg1. Utilice esta función para pasar varios argumentos a las plantillas.  | 
|  `externalURL`  |  ninguno  |  cadena  |  Devuelve una cadena que representa la URL externa.  | 
|  `pathPrefix`  |  ninguno  |  cadena  |  Devuelve la ruta de la URL externa.  | 

En la siguiente tabla se muestran ejemplos de uso de cada función.


| Función | TemplateString | Input | Expected | 
| --- | --- | --- | --- | 
|  humanize  |  \$1 humanize \$1value \$1  |  1234567.0  |  1,235 M  | 
|  humanize1024  |  \$1 humanize1024 \$1value \$1  |  1048576.0  |  1 Mi  | 
|  humanizeDuration  |  \$1 humanizeDuration \$1value \$1  |  899,99  |  14 min 59 s  | 
|  humanizePercentage  |  \$1 humanizePercentage \$1value \$1  |  0,134567  |  12,35%  | 
|  humanizeTimestamp  |  \$1 humanizeTimestamp \$1value \$1  |  1435065584,128  |  2015-06-23 13:19:44.128 \$10000 UTC  | 
|  título  |  \$1 \$1value \$1 title \$1  |  aa bB CC  |  Aa Bb Cc  | 
|  toUpper  |  \$1 \$1value \$1 toUpper \$1  |  aa bB CC  |  AA BB CC  | 
|  toLower  |  \$1 \$1value \$1 toLower \$1  |  aa bB CC  |  aa bb cc  | 
|  emparejar  |  \$1 match "a\$1" \$1labels.instance \$1  |  aa  |  true  | 
|  reReplaceAll  |  \$1\$1 reReplaceAll «localhost :( .\$1)» «mi.dominio: \$11» \$1labels.instance\$1\$1  |  localhost:3000  |  my.domain:3000  | 
|  graphLink  |  \$1\$1 graphLink "\$1\$1"expr\$1": \$1"up\$1", \$1"datasource\$1": \$1"gdev-prometheus\$1"\$1" \$1\$1  |    |  /explore?left=["now-1h","now","gdev-prometheus",\$1"datasource":"gdev-prometheus","expr":"up","instant":false,"range":true\$1]  | 
|  tableLink  |  \$1\$1 tableLink "\$1\$1"expr\$1":\$1"up\$1", \$1"datasource\$1":\$1"gdev-prometheus\$1"\$1" \$1\$1  |    |  /explore?left=["now-1h","now","gdev-prometheus",\$1"datasource":"gdev-prometheus","expr":"up","instant":true,"range":false\$1]  | 
|  args  |  \$1\$1define "x"\$1\$1\$1\$1.arg0\$1\$1 \$1\$1.arg1\$1\$1\$1\$1end\$1\$1\$1\$1template "x" (args 1 "2")\$1\$1  |    |  1 2  | 
|  externalURL  |  \$1 externalURL \$1  |    |  http://localhost/path/prefix  | 
|  pathPrefix  |  \$1 pathPrefix \$1  |    |  /path/prefix  | 

# Uso de políticas de notificaciones
<a name="alert-notifications"></a>

****  
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 8.x de Grafana**.  
Para los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.md).  
Para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md).

Las políticas de notificaciones determinan cómo se dirigen las alertas a los puntos de contacto. Las políticas tienen una estructura de árbol, en la que cada política puede incluir una o varias políticas secundarias. Cada política, excepto la política raíz, también puede coincidir con etiquetas de alerta específicas. La política raíz evalúa cada alerta y, posteriormente, las evalúa cada política secundaria. Si habilita la opción `Continue matching subsequent sibling nodes` para una política específica, la evaluación continúa incluso después de una o más coincidencias. Los ajustes de configuración y la información del punto de contacto de una política principal rigen el comportamiento de una alerta que no coincide con ninguna de las políticas secundarias. Una política raíz rige cualquier alerta que no coincida con una política específica.

**nota**  
Puede crear y editar políticas de notificaciones para las alertas administradas por Grafana. Las políticas de notificaciones de las alertas de Alertmanager son de solo lectura.

**Agrupación de notificaciones**

La agrupación clasifica las notificaciones de alerta de naturaleza similar en un único embudo. Esto le permite controlar las notificaciones de alerta durante las interrupciones más graves, cuando muchas partes de un sistema fallan al mismo tiempo, lo que provoca que se inicie un gran número de alertas simultáneamente.

**Ejemplo de agrupación**

Supongamos que tiene 100 servicios conectados a una base de datos en diferentes entornos. Estos servicios se diferencian por la etiqueta `env=environmentname`. Hay una regla de alerta para controlar si sus servicios pueden llegar a la base de datos. La regla de alerta crea alertas llamadas `alertname=DatabaseUnreachable`.

Si se produce una partición de red en la que la mitad de los servicios ya no pueden acceder a la base de datos, se inician 50 alertas diferentes. En este caso, querrá recibir una notificación de una sola página (en lugar de 50) con una lista de los entornos afectados.

Puede configurar la agrupación para que sea `group_by: [alertname]` (sin utilizar la etiqueta `env`, que es diferente para cada servicio). Con esta configuración, Grafana envía una única notificación compacta que incluye todos los entornos afectados por esta regla de alerta.

**Grupos especiales**

Grafana tiene dos grupos especiales. El grupo predeterminado `group_by: null` agrupa *todas* las alertas en un solo grupo. También puede utilizar una etiqueta especial denominada `...` para agrupar las alertas por todas las etiquetas, lo que deshabilita la agrupación y envía cada alerta a su propio grupo.

## Uso de notificaciones
<a name="alert-notifications-working"></a>

Los procedimientos que aparecen a continuación le muestran cómo crear y administrar políticas de notificaciones.

**Edición de la política de notificaciones raíz**

1. En la consola de Grafana, en el menú de Grafana, seleccione el icono **Alertas** (campana) para abrir la página **Alertas**.

1. Elija **Políticas de notificación**.

1. En el menú desplegable **Alertmanager**, seleccione el Alertmanager que desea editar.

1. En la sección **Política raíz**, seleccione el icono **Editar** (lápiz).

1. En **Punto de contacto predeterminado**, actualice el punto de contacto al que se deben enviar las notificaciones de las reglas cuando las reglas de alerta no coincidan con ninguna política específica.

1. En **Agrupar por**, elija las etiquetas (o grupos especiales) por las que agrupar las alertas.

1. En **Opciones de temporización**, seleccione una de las siguientes opciones.
   + **Espera de grupo**: tiempo de espera para almacenar en búfer las alertas del mismo grupo antes de enviar una notificación inicial. El valor predeterminado es de 30 segundos.
   + **Intervalo de grupo**: intervalo de tiempo mínimo entre dos notificaciones de un grupo. El valor predeterminado es 5 minutos.
   + **Intervalo de repetición**: intervalo de tiempo mínimo antes de volver a enviar una notificación si no se han agregado alertas nuevas al grupo. El valor predeterminado es 4 horas.

1. Elija **Guardar** para guardar los cambios.

**Adición de una nueva política específica de nivel superior**

1. En la consola de Grafana, en el menú de Grafana, seleccione el icono **Alertas** (campana) para abrir la página **Alertas**.

1. Elija **Políticas de notificación**.

1. En el menú desplegable **Alertmanager**, seleccione el Alertmanager que desea editar.

1. En la sección **Enrutamiento específico**, seleccione **Nueva política específica**.

1. En la sección **Etiquetas coincidentes**, agregue una o más etiquetas de alerta coincidentes. Más adelante en este tema se ofrece más información sobre la coincidencia de etiquetas.

1. En **Punto de contacto**, agregue el punto de contacto al que se van a enviar las notificaciones si la alerta coincide con esta política específica. Las políticas anidadas anulan este punto de contacto.

1. Si lo desea, seleccione **Anular agrupación** para especificar una agrupación diferente de la política raíz.

1. Si lo desea, seleccione **Anular temporizadores generales** para anular las opciones de temporización de la política de notificaciones de grupo.

1. Elija **Guardar política** para guardar los cambios.

**Adición de una política anidada**

1. Amplíe la política específica en la que desee crear una política anidada.

1. Elija **Agregar política anidada** y, a continuación, agregue los detalles (como cuando se agrega una política específica de nivel superior).

1. Elija **Guardar política** para guardar los cambios.

**Edición de una política específica**

1. En la página **Alertas**, seleccione **Políticas de notificación** para abrir la página en la que se muestran las políticas existentes.

1. Seleccione la política que desea editar y, a continuación, elija el icono **Editar** (lápiz).

1. Efectúe los cambios oportunos (como cuando agrega una política específica de nivel superior).

1. Elija **Guardar política**.

**Cómo funciona la búsqueda de coincidencias de etiquetas**

Una política coincide con una alerta si las etiquetas de la alerta coinciden con todas las *etiquetas coincidentes* especificadas en la política.
+ **Etiqueta**: nombre de la etiqueta que debe coincidir. Debe coincidir exactamente con el nombre de la etiqueta de la alerta.
+ **Operador**: operador utilizado para comparar el valor de la etiqueta con el valor de la etiqueta coincidente. Los operadores disponibles son:
  + `=` Seleccione etiquetas cuyo valor coincida exactamente con la cadena proporcionada.
  + `!=` Seleccione etiquetas cuyo valor no coincida con la cadena proporcionada.
  + `=~` Seleccione etiquetas cuyo valor coincida con el valor interpretado por expresiones regulares de la cadena proporcionada (la cadena proporcionada se interpreta como una expresión regular).
  + `!=` Seleccione etiquetas que no coincidan con la expresión regular proporcionada.
+ **Valor**: el valor con el que debe coincidir el valor de la etiqueta. Puede coincidir como una cadena o como una expresión regular, según el operador elegido.

## Temporizadores de silencio
<a name="alert-notification-muting"></a>

Un temporizador de silencio es un intervalo de tiempo recurrente en el que no se generan ni envían nuevas notificaciones para una política. Úselos para evitar que las alertas se activen durante un periodo específico y recurrente, por ejemplo, un periodo de mantenimiento habitual.

Al igual que los silencios, los temporizadores de silencio no impiden que se evalúen las reglas de alerta ni impiden que las instancias de alerta se muestren en la interfaz de usuario. Solo impiden la creación de notificaciones.

Puede configurar los temporizadores de silencio administrados por Grafana, así como los temporizadores de silencio para un origen de datos de Alertmanager externo.

**Comparación de los temporizadores de silencio y los silencios**

En la siguiente tabla se muestran las diferencias entre los temporizadores de silencio y los silencios.


| Temporizador de silencio | Silencio | 
| --- | --- | 
|  Utiliza definiciones de intervalos de tiempo que pueden repetirse.  |  Tiene unas horas de inicio y finalización fijas.  | 
|  Se crea y luego se agrega a las políticas de notificaciones.  |  Utiliza etiquetas para compararlas con una alerta y determinar si se debe silenciar o no.  | 

**Creación de un temporizador de silencio**

1. En la consola de Grafana, en el menú de Grafana, seleccione el icono **Alertas** (campana) para abrir la página **Alertas**.

1. Elija **Políticas de notificación**.

1. En el menú desplegable **Alertmanager**, seleccione el Alertmanager que desea editar.

1. En la sección **Temporizadores de silencio**, seleccione el botón **Agregar temporizador de silencio**.

1. Elija el intervalo de tiempo al que quiere que se aplique el temporizador de silencio.

1. Elija **Enviar** para crear el temporizador de silencio.

**Adición de un temporizador de silencio a una política de notificaciones**

1. Seleccione la política de notificaciones a la que desee agregar el temporizador de silencio y seleccione el botón **Editar**.

1. En el menú desplegable **Temporizadores de silencio**, seleccione los temporizadores de silencio que quiere agregar a la política.

   Elija el botón **Guardar política**.

**Intervalos de tiempo**

Un intervalo de tiempo es una definición de un intervalo de tiempo. Si se inicia una alerta durante este intervalo, se suprime. Se admiten intervalos con `:` (por ejemplo, `monday:thursday`). Un temporizador de silencio puede contener varios intervalos de tiempo. Un intervalo de tiempo consta de varios campos (los detalles se muestran en la siguiente lista) y todos deben coincidir para poder suprimir las alertas. Por ejemplo, si especifica los días de la semana `monday:friday` y el intervalo de tiempo comprendido entre las 8:00 y las 9:00, las alertas se suprimirán de las 8 a las 9, de lunes a viernes, pero no, por ejemplo, de las 8 a las 9 del sábado.
+ **Intervalo de tiempo**: hora del día a la que se suprimen las notificaciones. Consta de dos subcampos: **Hora de inicio** y **Hora de finalización**. Un ejemplo de hora es `14:30`. La hora está en notación de 24 horas, en UTC.
+ **Días de la semana**: días de la semana. Puede ser un solo día (por ejemplo, `monday`), un intervalo (como `monday:friday`) o una lista de días separados por comas (por ejemplo, `monday, tuesday, wednesday`).
+ **Meses**: meses que se deben seleccionar. Puede especificar los meses con designaciones numéricas o con el nombre completo del mes, por ejemplo, `1` o `january` (ambos especifican enero). Puede especificar un solo mes, un intervalo de meses o una lista de meses separados por comas.
+ **Días del mes**: fechas de un mes. Los valores pueden oscilar entre `1` y `31`. Los valores negativos especifican los días del mes en orden inverso, por lo que `-1` representa el último día del mes. Los días del mes se pueden especificar como un solo día, un intervalo de días o una lista de días separados por comas.