

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.

# Cómo usar el gráfico de AWS IoT TwinMaker conocimiento con Grafana
<a name="tm-knowledge-Grafana-panel"></a>

En esta sección, se muestra cómo añadir un panel de edición de consultas a su panel de AWS IoT TwinMaker Grafana para ejecutar y mostrar consultas.

## AWS IoT TwinMaker requisitos previos del editor de consultas
<a name="tm-knowledge-graph-Grafana-prereqs"></a>

Antes de usar el gráfico de AWS IoT TwinMaker conocimiento en Grafana, complete los siguientes requisitos previos:
+ Crea un espacio de trabajo AWS IoT TwinMaker . Puede crear un bucket utilizando la [consola de AWS IoT TwinMaker](https://console.aws.amazon.com/iottwinmaker/).
+ Configure AWS IoT TwinMaker para su uso con Grafana. Para obtener instrucciones, consulte [AWS IoT TwinMaker Integración del panel de control de Grafana](grafana-integration.md).

**nota**  
Para usar el gráfico de AWS IoT TwinMaker conocimiento, debes usar el modo de precios **estándar** o **por paquetes escalonados**. Para obtener más información, consulte [Cambiar AWS IoT TwinMaker los modos de precios](tm-pricing-mode.md).

## AWS IoT TwinMaker permisos del editor de consultas
<a name="tm-knowledge-graph-Grafana-config"></a>

Para usar el editor de AWS IoT TwinMaker consultas en Grafana, debes tener un rol de IAM con permiso para la acción. `iottwinmaker:ExecuteQuery` Añade ese permiso a tu rol en el panel de control de tu espacio de trabajo, como se muestra en este ejemplo:

------
#### [ JSON ]

****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "s3:GetObject"
            ],
            "Resource": [
                "arn:aws:s3:::amzn-s3-demo-bucket",
                "arn:aws:s3:::amzn-s3-demo-bucket/*"
            ]
        },
        {
            "Effect": "Allow",
            "Action": [
                "iottwinmaker:GetEntity",
                "iottwinmaker:ListEntities",
                "iottwinmaker:ExecuteQuery"
            ],
            "Resource": [
                "arn:aws:iottwinmaker:us-east-2:111122223333:workspace/workspaceId",
                "arn:aws:iottwinmaker:us-east-2:111122223333:workspace/workspaceId/*"
            ]
        },
        {
            "Effect": "Allow",
            "Action": "iottwinmaker:ListWorkspaces",
            "Resource": "*"
        }
    ]
}
```

------

**nota**  
Cuando configure la fuente de datos de AWS IoT TwinMaker Grafana, asegúrese de usar el rol con este permiso para el campo ARN de **asumir rol.** Después de añadirlo, puede seleccionar su espacio de trabajo en el menú desplegable situado junto a **Espacio de trabajo.**

Para obtener más información, consulte [Creación de un rol de IAM en el panel](dashboard-IAM-role.md#dashboard-IAM-role.title).

### Configura el panel del editor de AWS IoT TwinMaker consultas
<a name="tm-knowledge-graph-Grafana-panel"></a>

**Para configurar un nuevo panel de control de Grafana para Knowledge Graph**

1. Abre el panel de control de AWS IoT TwinMaker Grafana.

1. Crea un nuevo **panel de control**. Para ver los pasos detallados sobre cómo crear un panel, consulte [Crear un panel](https://grafana.com/docs/grafana/latest/dashboards/build-dashboards/create-dashboard/) en la documentación de Grafana.

1. En la lista de visualizaciones, selecciona Editor de **AWS IoT TwinMaker consultas**.  
![\[La lista desplegable del AWS IoT TwinMaker panel contiene la opción del editor de AWS IoT TwinMaker consultas.\]](http://docs.aws.amazon.com/es_es/iot-twinmaker/latest/guide/images/tw-query-editor-dropdown.png)

1. Seleccione el origen de datos con la que se van a ejecutar las consultas.

1. **(Opcional)** Añada un nombre para el nuevo panel en el campo proporcionado.

1. Selecciona **Aplicar** para guardar y confirmar tu nuevo panel.

El panel del gráfico de conocimiento funciona de forma similar al editor de consultas incluido en la AWS IoT TwinMaker consola. Puede ejecutar, escribir y borrar las consultas que realice en el panel. Para obtener más información sobre cómo escribir consultas, consulte[AWS IoT TwinMaker gráfico de conocimiento, recursos adicionales](tm-knowledge-graph-resources.md).

#### Cómo utilizar el editor AWS IoT TwinMaker de consultas
<a name="tm-knowledge-graph-Grafana-use"></a>

Los resultados de las consultas se muestran de tres formas, como se muestra en las siguientes imágenes: se visualizan en un gráfico, se muestran en una tabla o se presentan como un resumen de la ejecución.
+ **Visualización de gráficos:**  
![\[AWS IoT TwinMaker Los resultados del editor de consultas se muestran como un gráfico visual.\]](http://docs.aws.amazon.com/es_es/iot-twinmaker/latest/guide/images/kg-vis-graph.png)

  El gráfico visual solo muestra los datos de las consultas que tienen al menos una relación en el resultado. El gráfico muestra las entidades como nodos y las relaciones como bordes dirigidos en el gráfico.
+ **Datos tabulares:**  
![\[AWS IoT TwinMaker los resultados del editor de consultas se muestran como datos tabulares.\]](http://docs.aws.amazon.com/es_es/iot-twinmaker/latest/guide/images/kg-table-data.png)

  El formato de datos tabulares muestra los datos de todas las consultas. Puede buscar en la tabla resultados específicos o subconjuntos de los resultados. Los datos se pueden exportar en formato JSON o CSV.
+ **Resumen de ejecución**  
![\[AWS IoT TwinMaker los resultados del editor de consultas se muestran como un resumen de la ejecución.\]](http://docs.aws.amazon.com/es_es/iot-twinmaker/latest/guide/images/kg-run-sum.png)

  El resumen de la ejecución muestra la consulta y los metadatos sobre el estado de la consulta.