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 9 de Grafana
` al final. Para ver los periodos fiscales, utilice `fQ (fiscal quarter)` y las unidades de tiempo `fy (fiscal year)`.
El operador más le permite avanzar en el tiempo en relación con el momento actual. Por ejemplo, puede usar esta característica para ver los datos pronosticados en el futuro.
La siguiente tabla muestra ejemplos de intervalos relativos.
| 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` |
| Esta semana hasta ahora | `now/w` | `now` |
| Este mes | `now/M` | `now/M` |
| Este mes hasta ahora | `now/M` | `now` |
| Mes anterior | `now-1M/M` | `now-1M/M` |
| Este año hasta ahora | `now/Y` | `now` |
| Este año | `now/Y` | `now/Y` |
| Año fiscal anterior | `now-1y/fy` | `now-1y/fy` |
**nota**
Grafana Alerting no admite `now+n` para marcas de tiempo futuras ni `now-1n/n` para las marcas de tiempo *inicio de n hasta el final de n*.
**Controles de intervalo de tiempo comunes**
El panel de control y los controles de tiempo del panel tienen una interfaz de usuario común. A continuación se describen los controles de intervalo de tiempo comunes.
+ El intervalo de tiempo actual, también denominado *selector de tiempo*, muestra el intervalo de tiempo que se muestra actualmente en el panel de control o panel que está viendo. Pase el cursor sobre el campo para ver las marcas de tiempo exactas del intervalo y su origen (por ejemplo, la hora del navegador local). Haga clic en el *intervalo de tiempo actual* para cambiarlo. Para cambiar la hora actual, utilice un *intervalo de tiempo relativo*, como los últimos 15 minutos, o un intervalo de tiempo absoluto, como de `2020-05-14 00:00:00` a `2020-05-15 23:59:59`.
+ El **intervalo de tiempo relativo** se puede seleccionar en la lista **Intervalos de tiempo relativos**. Puede filtrar la lista mediante el campo de entrada de la parte superior. Algunos ejemplos de intervalos de tiempo son: *Últimos 30 minutos*, *Últimas 12 horas*, *Últimos 7 días*, *Últimos 2 años*, *Ayer*, *Anteayer*, *Este día la semana pasada*, *Hoy hasta ahora*, *Esta semana hasta ahora* y *Este mes hasta ahora*.
+ El **intervalo de tiempo absoluto** se puede configurar de dos maneras: escribiendo valores de tiempo exactos o valores de tiempo relativos en los campos **Desde** y **Hasta** y haciendo clic en **Aplicar intervalo de tiempo**, o haciendo clic en una fecha o intervalo de fechas del calendario que se muestra al hacer clic en el campo **Desde** o **Hasta**. Para aplicar las selecciones, haga clic en **Aplicar intervalo de tiempo**.
*Otras características del intervalo de tiempo*
1. Para reducirlo, haga clic en **Cmd \$1 Z** o **Ctrl \$1 Z**. Haga clic en el icono para ver un intervalo de tiempo más amplio en el panel o en la visualización del panel.
1. Para utilizar la característica de zoom, haga clic y arrastre para seleccionar el intervalo de tiempo de la visualización que desee ver.
**nota**
La ampliación solo se aplica a las visualizaciones de gráficos.
*Actualizar paneles de control*
Haga clic en el icono **Actualizar panel de control** para ejecutar inmediatamente todas las consultas del panel de control y actualizar las visualizaciones. Grafana cancela cualquier solicitud pendiente cuando activa una actualización.
De forma predeterminada, Grafana no actualiza automáticamente el panel de control. Las consultas se ejecutan según su propio horario de acuerdo con la configuración del panel. Sin embargo, si desea actualizar el panel de control con regularidad, haga clic en la flecha hacia abajo situada junto al icono **Actualizar panel de control** y, a continuación, seleccione un intervalo de actualización.
**Control del intervalo de tiempo mediante una URL**
Para controlar el intervalo de tiempo de un panel de control, proporcione los siguientes parámetros de consulta en la URL del panel de control.
+ `from` define el límite inferior del intervalo de tiempo, especificado en ms epoch, o el [tiempo relativo](#v9-dash-setting-dashboard-time-range).
+ `to` define el límite superior del intervalo de tiempo, especificado en ms epoch, o el tiempo relativo.
+ `time` y `time.window` definen un intervalo de tiempo de `time-time.window/2` a `time+time.window/2`. Ambos parámetros deben especificarse en ms. Por ejemplo, `?time=1500000000000&time.window=10000` dará como resultado un intervalo de tiempo de 10 segundos entre 1499999995000 y 1500000005000.
# Creación de paneles de control
** en la parte superior derecha.
**Restauración a una versión del panel de control guardada anteriormente**
Si necesita restaurar una versión del panel de control guardada anteriormente, puede hacer clic en el botón **Restaurar** situado a la derecha de una fila de la lista de versiones del panel de control o hacer clic en el botón **Restaurar a la versión ** en la vista de diferencias. Al hacer clic en el botón, aparecerá la siguiente ventana emergente en la 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, solo que con un número de versión diferente. Esto se indica en la **columna Notas** de la fila de la nueva versión del panel de control. Esto se hace simplemente para garantizar que las versiones anteriores del panel de control no se vean afectadas por el cambio.
# Administración de los enlaces de panel de control
=value.
**Ejemplos**
Las variables se muestran en listas desplegables en la parte superior de la pantalla. Seleccione diferentes variables para ver cómo cambian las visualizaciones.
Para ver la configuración de las variables, vaya a **Configuración del panel > Variables**. Haga clic en una variable de la lista para ver su configuración.
Las variables se pueden usar en los títulos, descripciones, paneles de texto y consultas. Las consultas cuyo texto comienza por `$` son plantillas. No todos los paneles tendrán consultas de plantilla.
**Prácticas recomendadas de variables**
+ 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 de control).
# Adición y administración de variables
[ ^ " ] + ) |chip=" (?[ ^ " ] + )/g
```
Produciría 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
```
Solo se admiten los nombres de los grupos de captura `text` y `value`.
##
}`: este formato le da más control sobre cómo Grafana interpreta los valores. Para obtener más información, consulte *Opciones avanzadas de formato de variables*.
+ `[[varname]]`: no la utilice. Esta sintaxis es antigua y no está disponible. Se habilitará en una versión futura.
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 InfluxDB o Prometheus tendrá un escape de expresiones regulares.
**Opciones avanzadas de formato de variables**
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`. Puede hacer que eso suceda con las opciones avanzadas de formato de variables que se enumeran a continuación.
**Sintaxis general**
Sintaxis: `${var_name:option}`
Si se especifica alguna opción de formato no válida, entonces `glob` es la default/fallback opción.
**CSV**
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**
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**
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:doublequote}'
Interpolation result: '"test1","test2"'
```
**Glob: Graphite**
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**
Formatea las variables con varios valores como una cadena separada por comas.
```
servers = [ 'test1', 'test2' ]
String to interpolate: '${servers:json}'
Interpolation result: '["test1", "test2"]'
```
**Lucene: Elasticsearch**
Formatea variables con varios valores en formato Lucene para Elasticsearch.
```
servers = [ 'test1', 'test2' ]
String to interpolate: '${servers:lucene}'
Interpolation result: '("test1" OR "test2")'
```
**Percentencode**
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**
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**
Desactiva el formato específico del origen de datos, como las comillas simples en una consulta SQL.
```
servers = [ 'test.1', 'test2' ]
String to interpolate: '${var_name:raw}'
Interpolation result: 'test.1,test2'
```
**Regex**
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**
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**
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'"
```
**Text**
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"
```
**Parámetros de consulta**
Formatea las variables de un solo valor y de varios valores para incluirlas en su representación de parámetro de consulta. Ejemplo: `var-foo=value1&var-foo=value2`
```
servers = [ "test1", "test2" ]
String to interpolate: '${servers:queryparam}'
Interpolation result: "var-servers=test1&var-servers=test2"
```
# Evaluación del uso del panel de control
** para la unidad personalizada que debe ir después del valor.
+ **prefijo: ** para la unidad personalizada que debe ir antes del valor.
+ **hora: ** para formatos de fecha y hora personalizados, escriba, por ejemplo, **time:AAAA-MM-DD**. Consulte los [formatos](https://momentjs.com/docs/#/displaying/) para ver la sintaxis y las opciones del formato.
+ **si: ** para unidades SI personalizadas. Por ejemplo: **si: mF**. Esta es un poco más avanzada porque puede especificar tanto una unidad como la escala de datos de origen. Por lo que, si los datos de origen se representan como unidades de milésimas (miles), agregue a la unidad el carácter de la escala SI como prefijo.
+ **recuento: ** para una unidad de recuento personalizada.
+ **divisa: ** 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
[${__range_s}s]) != )
```
**Orígenes de datos especiales**
Grafana también incluye tres orígenes de datos especiales: **Grafana**, **Mixto** y **Panel de control**. Para obtener más detalles, consulte Orígenes de datos
## Navegación por la pestaña de consultas
**: el valor de la etiqueta de la URL. Si la etiqueta contiene puntos, utilice la sintaxis **\$1\$1field.labels[""]**.
## Variables de valor
/public/emails/ng_alert_notification.html`. Puede editar este archivo para cambiar la apariencia de todos los correos electrónicos de alerta.
# Alertas sobre datos numéricos
auth =
}
```
## Aprovisionamiento de puntos de contacto y plantillas
*Sustitúyelo por la URL del webhook de Slack (u otro contacto)
En este ejemplo, se crea un punto de contacto que envía notificaciones de alerta a Slack.
```
resource "grafana_contact_point" "my_slack_contact_point" {
name = "Send to My Slack Channel"
slack {
url =
text = <
Las políticas de notificación le indican a Grafana cómo enrutar las instancias de alerta, en lugar de hacia dónde. Conectan las alertas de activación con los puntos de contacto previamente definidos mediante un sistema de etiquetas y criterios de coincidencia.
**Aprovisionamiento de políticas de notificación y enrutamiento**
1. Copie este bloque de código en un archivo .tf en su máquina local.
En este ejemplo, las alertas se agrupan por `alertname`, lo que significa que cualquier notificación procedente de alertas que compartan el mismo nombre se agrupa en el mismo mensaje de Slack.
Si quiere redirigir notificaciones específicas de forma diferente, puede agregar subpolíticas. Las subpolíticas le permiten aplicar el enrutamiento a diferentes alertas en función de la coincidencia de etiquetas. En este ejemplo, aplicamos un temporizador de silencio a todas las alertas con la etiqueta a=b.
```
resource "grafana_notification_policy" "my_policy" {
group_by = ["alertname"]
contact_point = grafana_contact_point.my_slack_contact_point.name
group_wait = "45s"
group_interval = "6m"
repeat_interval = "3h"
policy {
matcher {
label = "a"
match = "="
value = "b"
}
group_by = ["..."]
contact_point = grafana_contact_point.a_different_contact_point.name
mute_timings = [grafana_mute_timing.my_mute_timing.name]
policy {
matcher {
label = "sublabel"
match = "="
value = "subvalue"
}
contact_point = grafana_contact_point.a_third_contact_point.name
group_by = ["..."]
}
}
}
```
1. En el campo mute\$1timings, vincule un temporizador de silencio con su política de notificaciones.
1. Ejecute el comando `terraform apply`.
1. Vaya a la interfaz de usuario de Grafana y compruebe los detalles de su política de notificaciones.
**nota**
No puede editar los recursos aprovisionados mediante Terraform desde la interfaz de usuario. Esto garantiza que su pila de alertas esté siempre sincronizada con su código.
1. Haga clic en **Probar** para verificar que el punto de notificación funciona correctamente.
## Aprovisionamiento de temporizadores de silencio
****
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 9.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 8.x de Grafana, consulte [Uso de la versión 8 de Grafana](using-grafana-v8.md).
Puede verificar que sus recursos de alertas se crearon en Grafana.
**Visualización de los recursos aprovisionados en Grafana**
1. Abra su instancia de Grafana.
1. Vaya a Alertas.
1. Haga clic en una carpeta de recursos de alertas, por ejemplo, Reglas de alertas.
Los recursos aprovisionados se etiquetan como **Aprovisionados**, de modo que queda claro que no se crearon manualmente.
**nota**
No puede editar los recursos aprovisionados desde Grafana. Solo puede cambiar las propiedades del recurso si cambia el archivo de aprovisionamiento y reinicia Grafana o hace una recarga en caliente. Esto evita que se hagan cambios en el recurso que se sobrescribirían si se volviera a aprovisionar un archivo o si se hiciera una recarga en caliente.
# Migración de las alertas clásicas del panel de control a Grafana Alerting