Diferencias entre las versiones de Grafana - Amazon Managed Grafana

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 de métricas de Prometheus: el menú desplegable de métricas de Prometheus del generador de consultas de Prometheus se ha sustituido por una enciclopedia de métricas paginada y con capacidad de búsqueda.

  • Interfaz de usuario de la clave de API suspendida: las cuentas de servicio son el método recomendado para autenticar las llamadas a las API HTTP de Grafana. Como parte del trabajo de Grafana Labs para discontinuar el uso de 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 las API de AWS.

    Para obtener más información sobre la discontinuación de las claves de API en Grafana Labs, consulte APIKeys: Sunsetting of API keys en la lista de problemas de Grafana en GitHub.

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 suspendido: los complementos que usen Angular dejarán de ser compatibles en futuras versiones de Grafana. En la versión 10, los paneles que usen Angular mostrarán un banner para indicar que usan una característica suspendida y que no funcionarán en futuras versiones.

  • Alias de CloudWatch eliminado: los patrones de alias del editor de consultas de CloudWatch se han sustituido por 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 complemento BigQuery de DoiT ya no es compatible: el complemento de origen de datos BigQuery de DoiT ya no es compatible. En su lugar, use el complemento oficial de origen de datos BigQuery 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.

  • API de permisos de orígenes de datos: se han modificado los puntos de conexión para acceder a los permisos de los orígenes de datos. 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:

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: el origen de datos de Amazon CloudWatch ahora puede supervisar las métricas en las Cuentas de AWS y en las 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 características y mejoras, basadas en versiones anteriores. Esta versión incluía ciertos cambios que, en algunos casos, podrían interrumpir la funcionalidad. Al actualizar a una nueva versión, recomendamos que la pruebe 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 9.4 de Grafana. Para obtener una lista detallada de estos cambios, consulte el registro de cambios de la versión 9.4 de Grafana en GitHub.

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

    Acción requerida: Utilice /api/ds/query en su lugar. Consulte Consulte un origen de datos en la documentación pública de Grafana y en el problema #49916 en GitHub.

  • Cambios en los puntos de conexión de la API: varios puntos de conexión de la API de alertas ahora requieren un UID de origen de datos en lugar de un ID numérico.

    Puntos de conexión 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 origen de datos como parámetro de ruta. Consulte los problemas #48070, #48052, #48046 y #47978 en GitHub.

  • Se eliminaron las consultas de Azure Monitor: las consultas sobre información de aplicaciones y análisis de información ya no se admiten.

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

    Acción requerida: consulte el origen 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 los orígenes de datos de InfluxDB y Prometheus.

    Acción requerida: cambie al modo de acceso al servidor en la configuración de origen de datos. InfluxDB: obsoleto en la versión 8.0.0, eliminado en la versión 9.2.0. Consulte el problema #53529 en GitHub. Prometheus: obsoleto en la versión 7.4.0, eliminado en la versión 9.2.0. Consulte el problema #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 problema #54746 en GitHub.

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

    Acción requerida: utilice secureJsonData.password y secureJsonData.basicAuthPassword. Suspendido anteriormente en la versión 8.1.0. Consulte el problema #49987 en GitHub.

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

    El origen de datos predeterminado solo se aplica a los paneles nuevos. Si se cambia la configuración predeterminada, no se actualizarán los paneles existentes. Los paneles guardados con anterioridad retienen la configuración del origen de datos. Consulte el problema #45132 en GitHub.

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

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

  • Modo de documento sin procesar de Elasticsearch suspendido: el modo de visualización cambia en el origen de datos de Elasticsearch.

    Acción requerida: utilice el modo de datos sin procesar en su lugar. Consulte el problema #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 versión 7.10.0 han quedado obsoletas. Consulte el problema #48715 en GitHub.

  • Formato de URL de Explore suspendido: las URL de Compact Explore se eliminarán en una versión futura.

    Acción requerida: actualice los enlaces con codificación rígida para que utilicen el formato de URL estándar. URL compactas: &left=["now-1h","now"...]. URL estándar: &left={"datasource":"test"...}. Consulte el problema #50873 en GitHub.

  • Cambios en la visualización de OAuth de GitHub: se actualizaron el nombre y la pantalla de inicio de sesión de GitHub.

    El nombre de GitHub aparece como nombre de Grafana. El inicio de sesión de GitHub aparece como inicio de sesión de Grafana. Mejora la claridad de la identificación del usuario. Consulte el problema #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.

    Se mejoró de manera significativa el rendimiento de representación. Los buckets se colocan en bordes razonables (1 m, 5 m, 30 s). Las celdas redondas ya no son compatibles.

    Acción requerida: pruebe los paneles de su mapa de calor tras la actualización. Deshabilite la nueva implementación al configurar la marca de característica useLegacyHeatmapPanel en verdadero si es necesario. Agregue ?__feature.useLegacyHeatmapPanel=true a las URL del panel de control para realizar pruebas. Consulte el problema #50229 en GitHub.

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

    El conmutador de características de migración del backend de InfluxDB (influxdbBackendMigration) se ha vuelto a introducir debido a problemas de procesamiento del backend. De forma predeterminada, los datos de InfluxDB se analizan en el frontend. Si actualizó a la versión 9.4.4 y agregó transformaciones en los datos de InfluxDB, esos paneles no se representarán.

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

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

    lvl es ahora level. eror y dbug son ahora error ydebug. Mayor precisión de timestamp. La opción de exclusión está disponible con el conmutador de características oldlog (temporal). Consulte el problema #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: sustituya la transformación de etiquetas para campos por la transformación de campos de extracción. Consulte el problema #47153 en GitHub.

  • Administración de valores de NaN: representación NaN coherente en todos los orígenes de datos de Prometheus y Loki.

    Los valores NaN 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 problemas #49475 y #45389 en GitHub.

  • Enlaces para restablecer la contraseña 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 problema #42334 en GitHub.

  • Prefijo de etiqueta reservada: las etiquetas que comienzan con grafana_ están reservadas.

    Es posible que se sobrescriban las etiquetas configuradas manualmente que comiencen con grafana_. Etiquetas reservadas actuales: grafana_folder (Título de la carpeta que contiene la alerta). Consulte el problema #50262 en GitHub.

  • Mejoras en la transformación: la transformación Cambiar nombre por expresión regular ahora admite patrones globales.

    Los patrones globales utilizan el formato /<stringToReplace>/g. Es posible que algunas transformaciones se comporten de forma diferente. Coloque las cadenas coincidentes en barras inclinadas para el comportamiento anterior: (.*) se convierte en /(.*)/. Consulte el problema #48179 en GitHub.