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.
# Conexión a un origen de datos de Graphite
Grafana tiene un editor de consultas avanzado de Graphite que le permite navegar rápidamente por el espacio métrico, agregar funciones, cambiar los parámetros de las funciones, etc. El editor puede gestionar todo tipo de consultas de Graphite. Incluso puede gestionar consultas anidadas complejas mediante el uso de referencias de consulta.
## Configuración de Graphite
Para acceder a la configuración de Graphite, haga una pausa en el icono **Configuración** (engranaje), elija **Orígenes de datos** y, luego, elija el origen de datos de Graphite.
| Name | Description (Descripción) |
| --- | --- |
| Name | El nombre del origen de datos. Así es como se ve el origen de datos en los paneles y las consultas. |
| Default | El origen de datos predeterminado significa que se preseleccionará para los nuevos paneles. |
| URL | El protocolo HTTP, la IP y el puerto de la instalación de graphite-web o graphite-api. |
| Access | Servidor (predeterminado) = La URL debe ser accesible desde el backend o el servidor de Grafana. |
| Auth | |
| Basic Auth | Habilite la autenticación básica en el origen de datos. |
| User | Nombre de usuario de autenticación básica. |
| Password | Contraseña de autenticación básica. |
| Custom HTTP Headers | Elija Agregar encabezado para agregar un encabezado HTTP personalizado. |
| Header | Ingrese el nombre de encabezado personalizado. |
| Value | Ingrese el valor de encabezado personalizado. |
| Graphite details | |
| Version | Seleccione la versión de Graphite. |
| Type | Seleccione el tipo de Graphite. |
El modo de acceso controla cómo se gestionarán las solicitudes al origen de datos. El servidor debería ser la forma preferida si no se indica nada más.
### Modo de acceso al servidor (predeterminado)
Todas las solicitudes se hacen desde el navegador a Amazon Managed Grafana, que las reenvía al origen de datos, lo que elude los posibles requisitos del uso compartido de recursos entre orígenes (CORS). Si selecciona este modo de acceso, la URL debe ser accesible desde Amazon Managed Grafana.
### Modo de acceso del navegador
Amazon Managed Grafana no admite el acceso directo del navegador al origen de datos de Graphite.
## Editor de consultas de Graphite
Grafana incluye un editor de consultas específico para Graphite para crear consultas.
Para ver el texto sin procesar de la consulta que se envía a Graphite, elija el icono **Alternar modo de edición de texto** (lápiz).
### Elección de métricas para consultar
Elija **Seleccionar métrica** para navegar por el espacio de la métrica. Después de empezar, puede seguir utilizando el puntero o las teclas de flecha del teclado. Puede seleccionar un carácter comodín y continuar.
### Funciones
Para agregar una función, elija el icono más que se encuentra junto a **Función**. Puede buscar la función o seleccionarla en el menú. Una vez seleccionada una función, se agregará y el foco estará en el cuadro de texto del primer parámetro. Para editar o cambiar un parámetro, elíjalo y se convertirá en un cuadro de texto. - Para eliminar una función, elija el nombre de la función seguido del icono x.
Algunas funciones, como `aliasByNode`, admiten un segundo argumento opcional. Para agregar un argumento, haga una pausa en el primer argumento y, a continuación, elija el símbolo `+` que aparece. Para quitar el segundo parámetro opcional, elíjalo y manténgalo en blanco. El editor lo quitará.
### Ordenación de etiquetas
Si quiere un orden coherente, utilice `sortByName`. Esto puede resultar molesto si tiene las mismas etiquetas en varios gráficos y ambas están ordenadas de forma diferente y con colores diferentes. Para corregir esto, utilice `sortByName()`.
### Consultas anidadas
Puede hacer referencia a las consultas por la *letra* de fila en la que se encuentran (similar a Microsoft Excel). Si agrega una segunda consulta a un gráfico, puede hacer referencia a la primera y escribir \$1A. Esto permite crear consultas compuestas de manera práctica.
### Cómo evitar muchas consultas mediante el uso de caracteres comodín
En ocasiones, es posible que quiera ver varias series temporales trazadas en el mismo gráfico. Por ejemplo, es posible que desee ver cómo se usa la CPU en una máquina. Inicialmente, podría crear el gráfico al agregar una consulta para cada serie temporal, por ejemplo, `cpu.percent.user.g`, `cpu.percent.system.g` y así sucesivamente. Esto da como resultado que se efectúen *n* consultas al origen de datos, lo que resulta ineficiente.
Para mayor eficiencia, se pueden utilizar caracteres comodín en la búsqueda, lo que devuelve todas las series temporales de una consulta. Por ejemplo, `cpu.percent.*.g`.
### Modificación del nombre de la métrica en tablas o gráficos
Utilice las funciones `alias` para cambiar los nombres de las métricas en las tablas o gráficos de Grafana; por ejemplo, `aliasByNode()` o `aliasSub()`.
## Consolidación de puntos
Todas las métricas de Graphite se consolidan para que Graphite no devuelva más puntos de datos que píxeles en el gráfico. De forma predeterminada, esta consolidación se lleva a cabo mediante la función `avg`. Para poder controlar la forma en que Graphite consolida las métricas, agregue la función consolidateBy de Graphite.
**nota**
Esto significa que los valores resumidos de la leyenda (máximo, mínimo, total) no pueden ser correctos todos al mismo tiempo. Grafana los calcula desde el lado del cliente. Y según la función de consolidación, solo uno o dos pueden ser correctos al mismo tiempo.
## Combinación de series temporales
Para combinar series temporales, elija **Combinar** en la lista **Funciones**.
## Exploración de datos y etiquetas
En Graphite, todo es una etiqueta.
Al explorar los datos, las etiquetas previamente seleccionadas se utilizan para filtrar el conjunto de resultados restante. Para seleccionar los datos, se utiliza la función `seriesByTag`, que admite expresiones de etiquetas (`=`, `!=`, `=~`, `!=~`) para filtrar las series temporales.
El generador de consultas de Grafana lo hace automáticamente cuando se selecciona una etiqueta.
**nota**
**Consejo:** La búsqueda de expresiones regulares puede ser lenta en las etiquetas de alta cardinalidad, así que intente utilizar primero otras etiquetas para reducir el alcance. Empezar con un nombre o un espacio de nombres en concreto ayuda a reducir los resultados.
## Variables de plantilla
En lugar de codificar elementos como el nombre del servidor, la aplicación y el sensor en las consultas de métricas, puede utilizar variables en su lugar. Las variables se muestran como cuadros de selección desplegables en la parte superior del panel de control. Puede usar estos cuadros desplegables para cambiar los datos que se muestran en su panel de control.
Para obtener más información acerca de las plantillas y sus variables, consulte [Plantillas y variables](templates-and-variables.md).
Para crear una variable con valores de etiqueta, utilice las funciones de Grafana `tags` y `tag_values`.
| Consultar | Description (Descripción) |
| --- | --- |
| tags() | Devuelve todas las etiquetas. |
| tags(server=\$1backend\$1\$1) | Devuelve solo las etiquetas que aparecen en series que coinciden con la expresión del filtro. |
| tag\$1values(server) | Devuelve los valores de etiquetas para la etiqueta especificada. |
| tag\$1values(server, server=\$1backend\$1\$1) | Devuelve los valores de etiquetas filtrados que aparecen para la etiqueta especificada en series que coinciden con esas expresiones. |
| tag\$1values(server, server=\$1backend\$1\$1, app=\$1\$1\$1apps:regex\$1) | Varias expresiones y expresiones de filtro pueden contener otras variables. |
Para obtener más información, consulte los [documentos de Graphite sobre la API de autocompletado para etiquetas](https://graphite.readthedocs.io/en/latest/tags.html#auto-complete-support).
### Variable de consulta
La consulta que se especifique en el campo de consulta debe ser de tipo búsqueda de métrica. Por ejemplo, una consulta como `prod.servers.*` rellenará la variable con todos los valores posibles que estén en la posición del comodín.
También puede crear variables anidadas que utilicen otras variables en su definición. Por ejemplo, `apps.$app.servers.*` utiliza la variable `$app` en su definición de consulta.
#### Uso de `__searchFilter` para filtrar los resultados de las variables de consulta
Si se utiliza `__searchFilter` en el campo de consulta, se filtrará el resultado de la consulta en función de lo que ingrese en el cuadro de selección desplegable. Si no se ingresa nada, el valor predeterminado para `__searchFilter` es `*` y `` cuando se utiliza como parte de una expresión regular.
El siguiente ejemplo muestra cómo utilizar `__searchFilter` como parte del campo de consulta para permitir la búsqueda de `server` mientras el usuario ingresa texto en el cuadro de selección desplegable.
Consultar
```
apps.$app.servers.$__searchFilter
```
TagValues
```
tag_values(server, server=~${__searchFilter:regex})
```
### Uso de variables
Puede usar una variable en la ruta de un nodo de métricas o como parámetro de una función.
Existen dos sintaxis:
+ Ejemplo de `$`: apps.frontend.\$1server.requests.count
+ Ejemplo de `${varname}`: apps.frontend.\$1\$1server\$1.requests.count
¿Por qué de dos maneras? La primera sintaxis es más fácil de leer y escribir, pero no permite utilizar una variable en medio de una palabra. Use la segunda sintaxis en expresiones como `my.server${serverNumber}.count`.
### Uso de variables en las consultas de etiquetas
Las variables de varios valores en las consultas de etiquetas utilizan la sintaxis de formato avanzada que se presentó en Grafana 5.0 para las variables: `{var:regex}`. Las consultas sin etiquetas utilizarán el formato de expresión global predeterminado para las variables con varios valores.
El siguiente ejemplo de código muestra una expresión de etiqueta con formato de expresiones regulares y que utiliza el operador de igual y tilde de la ñ, `=~`.
```
server=~${servers:regex}
```
Para obtener más información, consulte [Opciones avanzadas de formato de variables](templates-and-variables.md#advanced-variable-format-options).
## Anotaciones
Las anotaciones le permiten superponer información detallada sobre los eventos en la parte superior de los gráficos. Las consultas de anotación se agregan a través del menú Panel o la vista Anotaciones. Para obtener más información, consulte [Anotaciones](dashboard-annotations.md).
Graphite admite dos formas de consultar las anotaciones:
+ Una consulta de métricas normal. Para ello, se utiliza el cuadro de texto **Consulta de Graphite**.
+ Una consulta de eventos de Graphite. Para ello, utilice el cuadro de texto `Graphite event tags` y especifique una etiqueta o un carácter comodín (mantenerlo vacío también debe funcionar).