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 Amazon Athena **nota** En los espacios de trabajo compatibles con la versión 9 o posterior, es posible que se deba instalar el complemento adecuado para este origen de datos. Para obtener más información, consulte [Ampliación de su espacio de trabajo con complementos](grafana-plugins.md). **nota** En esta guía se presupone que está familiarizado con el servicio Amazon Athena antes de utilizar el origen de datos de Athena. Con Amazon Managed Grafana, puede añadir Athena como fuente de datos mediante la opción de configuración de fuentes de datos de la consola del AWS espacio de trabajo de Grafana. Esta característica simplifica la adición de Athena como origen de datos al detectar las cuentas de Athena existentes y administra la configuración de las credenciales de autenticación necesarias para acceder a Athena. Puede utilizar este método para configurar la autenticación y agregar Athena como origen de datos, o puede configurar manualmente el origen de datos y las credenciales de autenticación necesarias con el mismo método que utilizaría en un servidor de Grafana autoadministrado. Existen requisitos previos para que Amazon Managed Grafana pueda acceder a Athena. Para conocer los requisitos previos relacionados con el uso del origen de datos de Athena, consulte [Requisitos previos](Athena-prereq.md). # Requisitos previos Para usar las políticas administradas de Amazon Managed Grafana para Athena, complete las siguientes tareas antes de configurar el origen de datos de Athena: + Etiquete sus grupos de trabajo de Athena con `GrafanaDataSource: true`. + Cree un bucket de S3 con un nombre que comience por `grafana-athena-query-results-`. Esta política proporciona permisos para escribir los resultados de las consultas en un bucket de S3 con esa convención de nomenclatura. Los permisos de Amazon S3 para acceder al origen de datos subyacente de una consulta de Athena no se incluyen en esta política administrada. Debe añadir los permisos necesarios para los buckets de Amazon S3 de forma manual y case-by-case puntual. Para obtener más información, consulte [Identity-based policy examples in Amazon Managed Grafana](https://docs.aws.amazon.com/grafana/latest/userguide/security_iam_id-based-policy-examples.html) en esta guía. # Utilice la configuración de la fuente de AWS datos para añadir Amazon Athena como fuente de datos ## Requisitos previos + La [CLI de AWS](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html) está instalada y configurada en el entorno. + Tiene acceso a Athena desde su cuenta. Para usar la configuración de la fuente de AWS datos, primero ve a la consola de Amazon Managed Grafana para habilitar las funciones de IAM administradas por el servicio que otorgan al espacio de trabajo las políticas de IAM necesarias para leer los recursos de Athena en tu cuenta o en todas tus unidades organizativas. A continuación, utilice la consola del espacio de trabajo de Amazon Managed Grafana para agregar Athena como origen de datos. # Para usar la configuración de la fuente de AWS datos para agregar Athena como fuente de datos 1. Asegúrese de que su rol de usuario sea de administrador o editor. 1. Seleccione el espacio de trabajo en el que desee trabajar en la consola de Grafana gestionada por Amazon en. [https://console.aws.amazon.com/grafana/](https://console.aws.amazon.com/grafana/home/) 1. Si no eligió usar permisos administrados por el servicio para este espacio de trabajo cuando lo creó, pase de usar permisos administrados por el cliente a usar permisos administrados por el servicio para asegurarse de que las funciones y políticas de IAM adecuadas estén habilitadas para usar la opción de configuración de AWS fuentes de datos en la consola del espacio de trabajo de Grafana. Para ello, elija el icono de edición junto a **Rol de IAM** y, luego, seleccione **Servicio administrado**, **Guardar cambios**. Para obtener más información, consulte [Amazon gestionó los permisos y las políticas de Grafana para las fuentes de datos AWS](AMG-manage-permissions.md). 1. Elija la pestaña **Orígenes de datos**. Seleccione la casilla **Amazon Athena** y, a continuación, elija **Acciones**, **Habilitar la política administrada por el servicio**. 1. Vuelva a elegir la pestaña **Orígenes de datos** y, a continuación, elija **Configurar en Grafana** en la fila **Amazon Athena**. 1. Inicie sesión en la consola del espacio de trabajo de Grafana mediante IAM Identity Center, si es necesario. El usuario debe tener una política de acceso de Athena adjunta al usuario o rol para poder acceder al origen de datos de Athena. Consulte [AWS política gestionada: AmazonGrafanaAthenaAccess](security-iam-awsmanpol.md#security-iam-awsmanpol-AmazonGrafanaAthenaAccess) para obtener más información. 1. **En la barra de navegación izquierda de la consola del espacio de trabajo de Grafana, selecciona el AWS icono inferior (hay dos) y, a continuación, selecciona **Athena en el menú Fuentes de datos**.** 1. Seleccione la región predeterminada desde la que quiere que consulte el origen de datos de Athena, seleccione las cuentas que desea y, luego, elija **Agregar origen de datos**. 1. Siga los pasos para configurar **Detalles de Athena** en [Configuración de **Detalles de Athena**](#Athena-settings). ## Configuración de **Detalles de Athena** **Configurar los ajustes de **Athena Details**** 1. En el menú **Detalles de la conexión**, seleccione el proveedor de autenticación (recomendado: **rol de IAM del espacio de trabajo**). 1. Seleccione el origen de datos de Athena de destino en el que tiene su cuenta de Athena. Si no selecciona ningún origen de datos, hay un origen de datos predeterminado en el menú desplegable. Para crear una nueva cuenta de Athena, siga las instrucciones de [Introducción a Athena](https://docs.aws.amazon.com/athena/latest/ug/getting-started.html). 1. Seleccione su base de datos de Athena de destino en el origen de datos seleccionado anteriormente. 1. Seleccione el grupo de trabajo. **Principal** es la opción predeterminada. 1. Si su grupo de trabajo aún no tiene configurada una ubicación de salida, especifique un bucket de S3 y una carpeta para usarlos en los resultados de la consulta. Por ejemplo, `s3://grafana-athena-plugin-test-data/query-result-output/ ` 1. Seleccione **Guardar y probar**. # Cómo agregar manualmente el origen de datos de Athena ## Requisitos previos + La [CLI de AWS](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html) está instalada y configurada en el entorno. + Tiene acceso a **Amazon Athena** desde su cuenta. **Cómo agregar manualmente el origen de datos de Athena:** 1. En el menú lateral de la consola de Grafana, haga una pausa en el icono **Configuración** (engranaje) y, a continuación, elija **Orígenes de datos**. 1. Elija **Agregar origen de datos**. 1. Elija el origen de datos de **AWS Athena**. Si es necesario, puede empezar a escribir **Athena** en el cuadro de búsqueda para ayudarlo a encontrarlo. 1. En el menú **Detalles de la conexión**, configure el proveedor de autenticación (recomendado: **rol de IAM del espacio de trabajo**). 1. Seleccione el origen de datos, la base de datos y el grupo de trabajo de Athena de destino. Para crear una nueva cuenta de Athena, siga las instrucciones de [Introducción a Athena](https://docs.aws.amazon.com/athena/latest/ug/getting-started.html). 1. Si su grupo de trabajo aún no tiene configurada una ubicación de salida, especifique un bucket de S3 y una carpeta para usarlos en los resultados de la consulta. Por ejemplo, `s3://grafana-athena-plugin-test-data/query-result-output/ `. 1. Seleccione **Guardar y probar**. Lo que se muestra a continuación es un ejemplo de la configuración de **Detalles de Athena**. ![\[Ejemplo de Detalles de Athena\]](http://docs.aws.amazon.com/es_es/grafana/latest/userguide/images/athena.png) # Uso del origen de datos de Athena ## Políticas de IAM Grafana necesita permisos otorgados a través de IAM para poder leer las métricas de Athena. Puede adjuntar estos permisos a los roles de IAM y usar la compatibilidad integrada de Grafana para asumir roles. Tenga en cuenta que deberá [configurar la política requerida](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create.html) para su rol antes de agregar el origen de datos a Grafana. Necesitará un rol de administrador o editor para agregar un origen de datos. La política de acceso integrada de Athena de Amazon Grafana se define en la sección [AWS política gestionada: AmazonGrafanaAthenaAccess](security-iam-awsmanpol.md#security-iam-awsmanpol-AmazonGrafanaAthenaAccess). ## Consulta de datos de Athena El origen de datos de Athena proporciona un editor de consultas SQL estándar. Amazon Managed Grafana incluye algunas macros para ayudar a escribir consultas de series temporales más complejas. Macros | Macro | Description (Descripción) | Ejemplo | Ejemplo de salida | | --- | --- | --- | --- | | \$1\$1\$1dateFilter(column) | \$1\$1\$1dateFilter crea un filtro condicional que selecciona los datos (utilizando column) en función del intervalo de fechas del panel. | \$1\$1\$1date(my\$1date) | my\$1date BETWEEN date '2017-07-18' AND date '2017-07-18' | | \$1\$1\$1parseTime(column,format) | \$1\$1\$1parseTime convierte un varchar en una marca de tiempo con el formato especificado. | \$1\$1\$1parseTime(eventtime, 'yyyy-MM-dd''T''HH:mm:ss''Z') | parse\$1datetime(time,'yyyy-MM-dd''T''HH:mm:ss''Z') | | \$1\$1\$1timeFilter(column,format) | \$1\$1\$1timeFilter crea un condicional que filtra los datos (utilizando column) en función del intervalo de tiempo del panel. El segundo argumento se usa para analizar opcionalmente la columna de un varchar a una marca de tiempo con un formato específico. | \$1\$1\$1timeFilter(time, 'yyyy-MM-dd HH:mm:ss') | TIMESTAMP time BETWEEN TIMESTAMP '2017-07-18T11:15:52Z' AND TIMESTAMP '2017-07-18T11:15:52Z' | | \$1\$1\$1timeFrom() | \$1\$1\$1timeFrom muestra la hora de inicio actual del intervalo del panel con comillas. | \$1\$1\$1timeFrom() | TIMESTAMP '2017-07-18 11:15:52' | | \$1\$1\$1timeTo() | \$1\$1\$1timeTo muestra la hora de finalización actual del intervalo del panel con comillas. | \$1\$1\$1timeTo() | TIMESTAMP '2017-07-18 11:15:52' | | \$1\$1\$1timeGroup(column, '1m', format) | \$1\$1\$1timeGroup agrupa las marcas de tiempo de modo que solo haya 1 punto por cada periodo del gráfico. El tercer argumento se usa para analizar opcionalmente la columna de un varchar a una marca de tiempo con un formato específico. | \$1\$1\$1timeGroup(time,'5m','yyyy-MM-dd''T''HH:mm:ss.SSSSSS''Z') | FROM\$1UNIXTIME(FLOOR(TO\$1UNIXTIME(parse\$1datetime(time,'yyyy-MM-dd''T''HH:mm:ss.SSSSSS''Z'))/300)\$1300) | | \$1\$1\$1table | \$1\$1\$1table devuelve la tabla seleccionada en el selector Tablas. | \$1\$1\$1table | my\$1table | | \$1\$1\$1column | \$1\$1\$1column devuelve la columna seleccionada en el selector Columnas (requiere una tabla). | \$1\$1\$1column | col1 | **Visualización** La mayoría de las consultas en Athena se representarán mejor mediante una visualización de tabla. Una consulta muestra los datos devueltos en una tabla. Si se puede consultar, se puede mostrar como una tabla. Este ejemplo devuelve los resultados de una visualización de tabla: ``` SELECT {column_1}, {column_2} FROM {table}; ``` **Visualizaciones de series temporales o gráficos** Para las visualizaciones de series temporales y gráficos, debe: + Seleccionar una columna con un tipo `date` o `datetime`. La columna `date` debe estar en orden ascendente (utilizando `ORDER BY column ASC`). + Seleccione también una columna numérica. **Inspección de la consulta** Amazon Managed Grafana admite macros que Athena no, lo que significa que una consulta podría no funcionar si se copia y pega directamente en Athena. Para ver la consulta interpolada completa, que funciona directamente en Athena, haga clic en el botón **Inspector de consultas**. La consulta completa se muestra en la pestaña **Consulta**. ## Plantillas y variables Para obtener más información acerca de cómo agregar una variable de consulta de Athena, consulte [Adición de una variable de consulta](variables-types.md#add-a-query-variable). Utilice su origen de datos de Athena como origen de datos para las consultas disponibles. Cualquier valor consultado en una tabla de Athena se puede utilizar como variable. Evite seleccionar demasiados valores, ya que esto puede provocar problemas de rendimiento. Después de crear una variable, puede usarla en sus consultas de Athena mediante [Sintaxis de variable](templates-and-variables.md#variable-syntax). Para obtener más información acerca de las variables, consulte [Plantillas y variables](templates-and-variables.md). ## Anotaciones Las [Anotaciones](dashboard-annotations.md) permiten superponer información detallada sobre los eventos encima de los gráficos. Puede agregar anotaciones seleccionando el panel o agregando consultas de anotación mediante la vista **Anotaciones** del menú **Panel**. Un ejemplo de consulta para agregar anotaciones automáticamente: ``` SELECT time as time, environment as tags, humidity as text FROM tableName WHERE $__dateFilter(time) and humidity > 95 ``` En la siguiente tabla se representan las descripciones de las columnas que se pueden utilizar para representar las anotaciones: | Name | Description (Descripción) | | --- | --- | | Time | El nombre del date/time campo. Puede ser una columna con un tipo de date/time datos SQL nativo o un valor de época. | | Timeend | Nombre opcional del date/time campo final. Podría ser una columna con un tipo de date/time datos SQL nativo o un valor de época. (Versión 6.6 y posteriores de Grafana) | | Text | Campo de descripción del evento. | | Tags | Nombre de campo opcional para utilizar en las etiquetas de eventos como una cadena separada por comas. | ## Compatibilidad de datos de consulta asíncrona Las consultas de Athena en Amazon Managed Grafana se gestionan de forma asíncrona para evitar tiempos de espera. Las consultas asíncronas utilizan solicitudes independientes para iniciar la consulta, comprobar su progreso y, por último, obtener los resultados. Esto evita los tiempos de espera de las consultas que se ejecutan durante mucho tiempo. ## Reutilización de resultados de las consultas Puede reutilizar los resultados de las consultas anteriores para mejorar el rendimiento de las consultas. Para habilitar la reutilización de las consultas, habilítela en la sección **Reutilización de los resultados de las consultas** del editor de consultas. Esto debe hacerse para cada consulta que desee reutilizar. **nota** Esta característica requiere que la instancia de Athena esté en la versión 3 del motor. Para obtener más información, consulte [Cambio de las versiones del motor Athena](https://docs.aws.amazon.com/athena/latest/ug/engine-versions-changing.html) en la *Guía del usuario de Amazon Athena*.