Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Come usare AWS IoT TwinMaker Knowledge Graph con Grafana
<a name="tm-knowledge-Grafana-panel"></a>

Questa sezione mostra come aggiungere un pannello di editor di query alla dashboard di AWS IoT TwinMaker Grafana per eseguire e visualizzare le query.

## AWS IoT TwinMaker prerequisiti dell'editor di query
<a name="tm-knowledge-graph-Grafana-prereqs"></a>

Prima di utilizzare il AWS IoT TwinMaker knowledge graph in Grafana, completa i seguenti prerequisiti:
+ Crea uno spazio di lavoro AWS IoT TwinMaker . [È possibile creare un'area di lavoro nella AWS IoT TwinMaker console.](https://console.aws.amazon.com/iottwinmaker/)
+ Configura AWS IoT TwinMaker per l'uso con Grafana. Per istruzioni, consulta [AWS IoT TwinMaker Integrazione della dashboard Grafana](grafana-integration.md).

**Nota**  
Per utilizzare il AWS IoT TwinMaker Knowledge Graph, è necessario utilizzare la modalità di prezzo in **bundle **standard** o a più livelli**. Per ulteriori informazioni, consulta [Cambia modalità di AWS IoT TwinMaker prezzo](tm-pricing-mode.md).

## AWS IoT TwinMaker autorizzazioni dell'editor di query
<a name="tm-knowledge-graph-Grafana-config"></a>

Per utilizzare l'editor di AWS IoT TwinMaker query in Grafana, devi disporre di un ruolo IAM con autorizzazione per l'azione. `iottwinmaker:ExecuteQuery` Aggiungi tale autorizzazione al ruolo del pannello di controllo del tuo spazio di lavoro, come mostrato in questo esempio:

------
#### [ 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**  
Quando configuri la tua origine dati AWS IoT TwinMaker Grafana, assicurati di utilizzare il ruolo con questa autorizzazione per il campo **ARN Assumi** ruolo. **Dopo averlo aggiunto, puoi selezionare il tuo spazio di lavoro dal menu a discesa accanto a Workspace.**

Per ulteriori informazioni, consulta [Creazione di un ruolo IAM nella dashboard](dashboard-IAM-role.md#dashboard-IAM-role.title).

### Configura il pannello dell'editor delle AWS IoT TwinMaker interrogazioni
<a name="tm-knowledge-graph-Grafana-panel"></a>

**Per configurare un nuovo pannello dashboard Grafana per Knowledge Graph**

1. Apri la dashboard AWS IoT TwinMaker Grafana.

1. Crea un nuovo **pannello** di controllo. Per i passaggi dettagliati su come creare un pannello, consulta [Creare un pannello di controllo](https://grafana.com/docs/grafana/latest/dashboards/build-dashboards/create-dashboard/) nella documentazione di Grafana.

1. **Dall'elenco delle visualizzazioni, seleziona AWS IoT TwinMaker Query Editor.**  
![\[L'elenco a discesa nella AWS IoT TwinMaker dashboard contiene l'opzione per il Query Editor. AWS IoT TwinMaker\]](http://docs.aws.amazon.com/it_it/iot-twinmaker/latest/guide/images/tw-query-editor-dropdown.png)

1. Seleziona la fonte di dati su cui eseguire le query.

1. **(Facoltativo)** Aggiungi un nome per il nuovo pannello nel campo fornito.

1. Seleziona **Applica** per salvare e confermare il nuovo pannello.

Il pannello Knowledge Graph funziona in modo simile all'editor di query fornito nella AWS IoT TwinMaker console. Puoi eseguire, scrivere e cancellare le interrogazioni che fai nel pannello. Per ulteriori informazioni su come scrivere interrogazioni, consulta. [AWS IoT TwinMaker knowledge graph: risorse aggiuntive](tm-knowledge-graph-resources.md)

#### Come usare l'editor di AWS IoT TwinMaker query
<a name="tm-knowledge-graph-Grafana-use"></a>

I risultati delle interrogazioni vengono visualizzati in tre modi, come illustrato nelle immagini seguenti: visualizzati in un grafico, elencati in una tabella o presentati come riepilogo dell'esecuzione.
+ **Visualizzazione del grafico:**  
![\[AWS IoT TwinMaker i risultati dell'editor di query vengono visualizzati come grafico visivo.\]](http://docs.aws.amazon.com/it_it/iot-twinmaker/latest/guide/images/kg-vis-graph.png)

  Il grafico visivo mostra solo i dati per le interrogazioni che hanno almeno una relazione nel risultato. Il grafico mostra le entità come nodi e le relazioni come bordi diretti nel grafico.
+ **Dati tabulari:**  
![\[AWS IoT TwinMaker i risultati dell'editor di query vengono visualizzati come dati tabulari.\]](http://docs.aws.amazon.com/it_it/iot-twinmaker/latest/guide/images/kg-table-data.png)

  Il formato di dati tabulari visualizza i dati per tutte le interrogazioni. È possibile cercare nella tabella risultati specifici o sottoinsiemi di risultati. I dati possono essere esportati in formato JSON o CSV.
+ **Riepilogo dell'esecuzione**  
![\[AWS IoT TwinMaker i risultati dell'editor di query vengono visualizzati come riepilogo dell'esecuzione.\]](http://docs.aws.amazon.com/it_it/iot-twinmaker/latest/guide/images/kg-run-sum.png)

  Il riepilogo dell'esecuzione visualizza l'interrogazione e i metadati relativi allo stato dell'interrogazione.