Diferencias entre las versiones de Grafana

Al crear un espacio de trabajo de Grafana, debe elegir una versión de Grafana para crearlo. Puede elegir entre versiones compatibles con las versiones 8, 9 y 10 de Grafana. Cada una de ellas ha agregado las funcionalidades de la versión anterior. En los temas siguientes se describen los cambios en las versiones 9 y 10, incluidos los cambios en la versión 10 que podrían interrumpir las funcionalidades que se utilizan en la versión 9.

nota

Puede leer la documentación específica de cada versión con respecto al uso del espacio de trabajo de Grafana en los temas Uso de la versión 8 de Grafana, Uso de la versión 9 de Grafana y Uso de la versión 10 de Grafana.

Para obtener notas detalladas por versión y más información de Grafana Labs, consulte What's new in Grafana en la documentación de Grafana Labs.

Versión 10 de Grafana

En la versión 10 de Grafana se agregaron las siguientes características.

• Correlaciones: las correlaciones definen cómo se utilizan los datos de un origen de datos para consultar los datos de otro origen de datos y permiten que la visualización de Explore ejecute fácilmente consultas relacionadas con los datos mostrados. Para obtener más información, consulta Correlaciones en la versión 10 de Grafana.

• Subcarpetas: al organizar los paneles de control, ahora puede usar subcarpetas para crear una jerarquía anidada. Para obtener más información, consulta Creación de carpetas de panel de control.

• Alertas: Grafana Alerting permite ahora silenciar las alertas. Además, Grafana Alerting ya no envía notificaciones 3 veces.

• Vista previa de la actualización de alertas: antes de cambiar de las alertas clásicas del panel de control a las alertas de Grafana, puede ver el aspecto que tendrán sus alertas e incluso hacer cambios que se aplicarán al migrar. Para obtener más información, consulta Migración de las alertas clásicas del panel de control a Grafana Alerting. Grafana Labs ha anunciado que la versión 11 y posteriores de Grafana ya no admitirán las alertas de panel de control clásicas.

• Conjuntos de soporte técnico: los conjuntos de soporte técnico proporcionan una forma sencilla de recopilar información sobre su espacio de trabajo de Grafana para compartirla con el soporte técnico del producto. Puede crear rápidamente un paquete de soporte técnico que contenga datos sobre migraciones, complementos, configuraciones, etc. Para obtener más información, consulta Recopilación de información para soporte.

• Nuevas visualizaciones: hay tres visualizaciones nuevas disponibles. Gráfico XY, la cuadrícula de datos y el panel de tendencias están disponibles para los espacios de trabajo compatibles con la versión 10. Los espacios de trabajo de la versión 9 también pueden usar gráficos XY.

• PagerDuty— Los complementos empresariales ahora incluyen un complemento para PagerDuty.

• Rediseño de las transformaciones: la pestaña de transformaciones cuenta con una experiencia de usuario y un diseño visual mejorados. Las transformaciones se clasifican y cada tipo de transformación tiene una ilustración que le ayudará a elegir la más adecuada.

• Enciclopedia métrica de Prometheus: el menú desplegable de métricas de Prometheus en el generador de consultas de Prometheus se ha sustituido por una enciclopedia métrica paginada y con capacidad de búsqueda.

• Se suspendió la interfaz de usuario de la clave API: las cuentas de servicio son la forma recomendada de autenticar las llamadas al HTTP de APIs Grafana. Como parte del trabajo de Grafana Lab para descontinuar las claves de API, ya no se pueden crear claves de API a través de la interfaz de usuario del espacio de trabajo. Solo puede crear claves de API a través de. AWS APIs

  Para obtener más información sobre la suspensión de las claves de API por parte de Grafana Labs, APIKeysconsulte: Anulación de las claves de API en la lista de problemas de GitHub Grafana.

Cambios importantes

La versión 10.4 de Grafana incluye cambios de las versiones 9.5 a 10.4 de Grafana. Las versiones 10.0 y 10.3 de Grafana incluían ciertos cambios que, en algunos casos, podrían interrumpir la funcionalidad. Al actualizar a una nueva versión, se recomienda probarla en un entorno que no sea de producción antes de actualizar los espacios de trabajo de producción.

Los siguientes cambios pueden afectar a algunos usuarios que se actualicen a la versión 10 de Grafana.

• Angular descontinuado: los complementos que usan Angular ya no serán compatibles en futuras versiones de Grafana. En la versión 10, los paneles que utilizan angular mostrarán un cartel que indica que utilizan una función descontinuada, para indicar que no funcionarán en futuras versiones.

• CloudWatch Se ha eliminado el alias: los patrones de alias del editor de CloudWatch consultas se han sustituido por Label (etiquetas dinámicas).

  Abra cualquier panel de control que use el campo Alias y guárdelo. El alias se migra a etiqueta automáticamente.

• Hay que actualizar los complementos más antiguos: los complementos del origen de datos de Athena y Amazon Redshift deben actualizarse en los espacios de trabajo de Grafana v10. El complemento de origen de datos de Athena debe ser versión 2.9.3 o posterior; el complemento de origen de datos de Amazon Redshift debe ser versión 1.8.3 o posterior.

  Para obtener más información acerca de la instalación o la actualización de complementos, consulte Búsqueda de complementos con el catálogo de complementos.

• El BigQuery complemento DoIt ya no es compatible: el complemento de fuente de BigQuery datos DoIt ya no es compatible. En su lugar, utilice el complemento de fuente de BigQuery datos oficial de Grafana Labs.

• Cambios en las transformaciones: se han hecho algunos cambios en la versión 10 de Grafana para corregir errores en los nombres y claves de los campos. Para obtener más información, consulte Transformation breaking changes en la documentación de Grafana Labs.

• Permisos de la fuente de datos APIs: los puntos finales para acceder a los permisos de la fuente de datos han cambiado. Para obtener más información, consulte Data source permissions changes en la documentación de Grafana Labs.

Para obtener más información sobre los cambios importantes y los que afectan a los desarrolladores de complementos, consulte los siguientes temas de la documentación de Grafana Labs:

• Cambios importantes en Grafana v10.0

• Cambios importantes en Grafana v10.3

Versión 9 de Grafana

En Grafana v9 se agregaron las siguientes características.

• Alertas: las reglas de alerta administradas por Grafana ahora admiten nombres de grupos.

• Explore: cree un panel de control desde la vista de Explore.

• Consultas de Prometheus: el nuevo generador de consultas de Prometheus (con PromQL) facilita la redacción de consultas.

• Consultas de Loki: el nuevo generador de consultas de Loki (con LogQL) facilita la redacción de consultas.

• Tokens de API/cuentas de servicio: las cuentas de servicio simplifican el acceso a las máquinas en Grafana y le ayudan a administrar los tokens de API.

• Administración de complementos: puede habilitar la administración de complementos para instalar, eliminar o actualizar los complementos comunitarios en su espacio de trabajo. Esto le da acceso a más orígenes de datos y visualizaciones, y le permite controlar la versión de cada complemento que utilice.

• Seguimiento a métricas: configure un origen de datos de seguimiento para agregar enlaces a las métricas con consultas y etiquetas.

• Panel de lienzo: nueva visualización de panel con elementos estáticos y dinámicos para crear paneles personalizados basados en datos con imágenes y texto superpuesto.

• Reorganización de la interfaz: interfaz de usuario actualizada con una navegación más sencilla en la consola de Grafana.

• CloudWatch: La fuente de CloudWatch datos de Amazon ahora puede monitorear las métricas en Cuentas de AWS todas partes Regiones de AWS.

• Registros: se ha mejorado la interfaz para mostrar los detalles de los registros.

• General: se han corregido errores y se han hecho pequeñas mejoras en general.

Cambios importantes

La versión 9.4 de Grafana incluye una serie de nuevas funciones y mejoras, basadas en versiones anteriores. Esta versión tenía algunos cambios que podrían interrumpir la funcionalidad en algunos casos. Al actualizar a una nueva versión, le recomendamos que realice una prueba en un entorno que no sea de producción antes de actualizar sus espacios de trabajo de producción.

Los siguientes cambios pueden afectar a algunos usuarios que se actualicen a la versión 9.4 de Grafana. Para obtener una lista detallada de estos cambios, consulta el registro de cambios de Grafana 9.4 en. GitHub

• API descontinuada: la /api/tsdb/query API se ha eliminado.

  Acción requerida: utilícela /api/ds/query en su lugar. Consulte Consultar una fuente de datos en la documentación pública de Grafana y en el número #49916 en adelante. GitHub

• Cambios en los puntos finales de la API: varios puntos finales de la API de alertas ahora requieren un UID de la fuente de datos en lugar de un ID numérico.

  Puntos finales afectados:,,, api/v1/rule/test api/prometheus/ api/ruler/ api/alertmanager/

  Acción requerida: actualice las llamadas a la API para usar el UID de la fuente de datos como parámetro de ruta. Consulte los números #48070, #48052, #48046 y #47978 en adelante GitHub.

• Se han eliminado las consultas de Azure Monitor: ya no se admiten las consultas de Application Insights e Insight Analytics.

  Obsoleto en Grafana 8.0, eliminado en 9.0. Las consultas obsoletas no se ejecutarán.

  Acción requerida: consulte la fuente de datos de Azure Monitor en la documentación pública de Grafana para obtener orientación sobre la migración.

• Modo de acceso al navegador eliminado: el modo de acceso al navegador ya no está disponible para las fuentes de datos de InfluxDB y Prometheus.

  Acción requerida: cambie al modo de acceso al servidor en la configuración de su fuente de datos. InfluxDB: obsoleto en la versión 8.0.0, eliminado en la versión 9.2.0. Consulte el número #53529 en. GitHub Prometheus: Obsoleto en 7.4.0, eliminado en 9.2.0. Consulte el número #50162 en. GitHub

• Acceso restringido a la configuración del panel: ya no puede abrir la configuración del panel mientras edita los paneles.

  La configuración del panel se bloquea cuando el modo de edición del panel está activo. Cierre el modo de edición del panel antes de acceder a la configuración del panel. Consulte el número #54746 en GitHub.

• Cifrado de contraseñas de fuentes de datos: ya no se admiten contraseñas no cifradas.

  Acción requerida: utilizar secureJsonData.password y. secureJsonData.basicAuthPassword Discontinuado anteriormente en la versión 8.1.0. Consulte el número #49987 en. GitHub

• Comportamiento predeterminado de la fuente de datos: la selección de la fuente de datos predeterminada ya no afecta a los paneles existentes.

  La fuente de datos predeterminada solo se aplica a los paneles nuevos. Si se cambia la configuración predeterminada, no se actualizarán los paneles existentes. Los paneles guardados anteriormente conservan la configuración de su fuente de datos. Consulte el número #45132 en GitHub.

• Se modificó la propiedad del intervalo de Elasticsearch: se actualizó la especificación del intervalo de consulta para Elasticsearch 7.x.

  Cambiada de a propiedad. interval fixed_interval Proporciona coherencia con Elasticsearch 8.x. La mayoría de las consultas no mostrarán los cambios visibles. Consulte el número #50297 en GitHub.

• Se suspendió el modo de documento sin procesar de Elasticsearch: el modo de visualización cambia en la fuente de datos de Elasticsearch.

  Acción requerida: utilice el modo de datos sin procesar en su lugar. Consulte el número #62236 en GitHub.

• Soporte de versiones de Elasticsearch: las versiones anteriores de Elasticsearch ya no son compatibles.

  Acción requerida: actualice Elasticsearch a la versión 7.10.0 o posterior. Las versiones anteriores a la 7.10.0 son anteriores. end-of-life Consulte el número #48715 en. GitHub

• Se ha dejado de utilizar el formato URL de Explore: Compact Explore se URLs eliminará en una versión futura.

  Acción necesaria: actualice los enlaces codificados para que utilicen el formato de URL estándar. Compacto URLs:&left=["now-1h","now"...]. Estándar URLs:&left={"datasource":"test"...}. Consulte el número #50873 en GitHub.

• GitHub OAuth cambios de visualización: se actualizaron la pantalla de GitHub nombre e inicio de sesión.

  GitHub el nombre aparece como nombre de Grafana. GitHub el inicio de sesión aparece como inicio de sesión de Grafana. Mejora la claridad de la identificación del usuario. Consulte el número #45438 en GitHub.

• Implementación del panel Heatmap actualizada: los paneles Heatmap utilizan una nueva implementación a partir de la versión 9.1.0.

  Rendimiento de renderizado significativamente mejorado. Los cubos se colocan en bordes razonables (1 m, 5 m, 30 s). Ya no se admiten celdas redondas.

  Acción requerida: prueba los paneles de tu mapa de calor tras la actualización. Deshabilita la nueva implementación configurando el indicador de useLegacyHeatmapPanel función en verdadero si es necesario. ?__feature.useLegacyHeatmapPanel=trueAñádalo al panel URLs de control para realizar pruebas. Consulte el número #50229 en GitHub.

• Migración del backend de InfluxDB: el comportamiento de análisis de datos de InfluxDB ha cambiado.

  La función de migración del backend de InfluxDB, toggle (), se ha vuelto a introducir debido a problemas de procesamiento del backend. influxdbBackendMigration De forma predeterminada, los datos de InfluxDB se analizan en la interfaz. Si actualizó a la versión 9.4.4 y agregó transformaciones en los datos de InfluxDB, esos paneles no se renderizarán.

  Acción requerida: Elimine los paneles afectados y vuelva a crearlos, o edite el time campo como aparece en o. Time panel.json dashboard.json Consulte el número #64842 en. GitHub

• Formato de mensaje de registro actualizado: la estructura de los mensajes de registro ha cambiado.

  lvles ahoralevel. erory dbug son ahora error ydebug. Mayor precisión de la marca de tiempo. La opción de exclusión está disponible con el oldlog cambio de funciones (temporal). Consulte el número #47584 en. GitHub

• Optimización del formato de datos de Loki: los datos de registro de Loki utilizan un formato de marco de datos más eficiente.

  Marco de datos único con columna de etiquetas en lugar de marcos de datos separados. Los paneles de exploración y registro funcionan sin cambios. Es posible que sea necesario ajustar otros paneles o transformaciones.

  Acción requerida: sustituir las etiquetas por la transformación de campos por la transformación de campos de extracción. Consulte el número #47153 en GitHub.

• Gestión de valores de NaN: NaN representación coherente en todas las fuentes de datos de Prometheus y Loki.

  NaNlos valores permanecen como NaN en lugar de convertirse en. null El cambio debería ser prácticamente invisible para los usuarios. Afecta tanto al panel como a las rutas de alerta. Consulte los números #49475 y #45389 en adelante GitHub.

• Los enlaces para restablecer la contraseña están invalidados: los enlaces para restablecer la contraseña existentes no funcionarán después de la actualización.

  Los enlaces para restablecer la contraseña enviados antes de la actualización no son válidos. Los usuarios deben solicitar nuevos enlaces para restablecer la contraseña. Los enlaces caducan después de 2 horas. Consulte el número #42334 en GitHub.

• Prefijo de etiqueta reservado: las etiquetas que comiencen por grafana_ están reservadas.

  grafana_Es posible que las etiquetas configuradas manualmente que comiencen por se sobrescriban. Etiquetas reservadas actuales: grafana_folder (Título de la carpeta que contiene la alerta). Consulte el número #50262 en GitHub.

• Mejoras en la transformación: el cambio de nombre mediante la transformación de expresiones regulares ahora admite patrones globales.

  Los patrones globales utilizan este formato. /<stringToReplace>/g Algunas transformaciones pueden comportarse de forma diferente. Coloque las cadenas coincidentes en barras diagonales para el comportamiento anterior: (.*) se convierte en/(.*)/. Consulte el número #48179 en. GitHub