As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Como usar o gráfico de AWS IoT TwinMaker conhecimento com a Grafana
<a name="tm-knowledge-Grafana-panel"></a>

Esta seção mostra como adicionar um painel do editor de consultas ao painel do AWS IoT TwinMaker Grafana para executar e exibir consultas.

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

Antes de usar o gráfico de AWS IoT TwinMaker conhecimento na Grafana, preencha os seguintes pré-requisitos:
+ Crie um AWS IoT TwinMaker espaço de trabalho. É possível criar um espaço de trabalho no [console do AWS IoT TwinMaker](https://console.aws.amazon.com/iottwinmaker/).
+ Configure AWS IoT TwinMaker para uso com o Grafana. Para instruções, consulte [AWS IoT TwinMaker Integração do painel Grafana](grafana-integration.md).

**nota**  
Para usar o gráfico de AWS IoT TwinMaker conhecimento, você precisa estar nos modos de preços de **pacote **padrão** ou em camadas**. Para obter mais informações, consulte [Alterne AWS IoT TwinMaker os modos de preços](tm-pricing-mode.md).

## AWS IoT TwinMaker permissões do editor de consultas
<a name="tm-knowledge-graph-Grafana-config"></a>

Para usar o editor de AWS IoT TwinMaker consultas no Grafana, você precisa ter uma função do IAM com permissão para a ação. `iottwinmaker:ExecuteQuery` Adicione essa permissão à sua função no painel do espaço de trabalho, conforme mostrado neste exemplo:

------
#### [ 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**  
Ao configurar sua fonte de dados do AWS IoT TwinMaker Grafana, certifique-se de usar a função com essa permissão para o campo **ARN de assumir** função. Depois de adicioná-lo, você pode selecionar seu espaço de trabalho no menu suspenso ao lado de **Espaço de trabalho.**

Para obter mais informações, consulte [Como criar um perfil do IAM para o painel](dashboard-IAM-role.md#dashboard-IAM-role.title).

### Configurar o painel do editor de AWS IoT TwinMaker consultas
<a name="tm-knowledge-graph-Grafana-panel"></a>

**Para configurar um novo painel de controle da Grafana para o gráfico de conhecimento**

1. Abra seu painel da AWS IoT TwinMaker Grafana.

1. Crie um novo **painel de controle**. Para obter etapas detalhadas sobre como criar um painel, consulte [Criar um painel na documentação](https://grafana.com/docs/grafana/latest/dashboards/build-dashboards/create-dashboard/) da Grafana.

1. Na lista de visualizações, selecione **Editor de AWS IoT TwinMaker consultas**.  
![\[A lista suspensa no AWS IoT TwinMaker painel contém a opção para o Editor de AWS IoT TwinMaker consultas.\]](http://docs.aws.amazon.com/pt_br/iot-twinmaker/latest/guide/images/tw-query-editor-dropdown.png)

1. Selecione a fonte de dados na qual executará consultas.

1. **(Opcional)** Adicione um nome para o novo painel no campo fornecido.

1. Selecione **Aplicar** para salvar e confirmar seu novo painel.

O painel do gráfico de conhecimento funciona de forma semelhante ao editor de consultas fornecido no AWS IoT TwinMaker console. Você pode executar, escrever e limpar as consultas feitas no painel. Para obter mais informações sobre como escrever consultas, consulte[AWS IoT TwinMaker recursos adicionais do gráfico de conhecimento](tm-knowledge-graph-resources.md).

#### Como usar o editor AWS IoT TwinMaker de consultas
<a name="tm-knowledge-graph-Grafana-use"></a>

Os resultados de suas consultas são exibidos de três maneiras, conforme mostrado nas imagens a seguir: visualizados em um gráfico, listados em uma tabela ou apresentados como um resumo da execução.
+ **Visualização gráfica:**  
![\[AWS IoT TwinMaker resultados do editor de consultas exibidos como um gráfico visual.\]](http://docs.aws.amazon.com/pt_br/iot-twinmaker/latest/guide/images/kg-vis-graph.png)

  O gráfico visual exibe somente dados para consultas que tenham pelo menos uma relação no resultado. O gráfico exibe entidades como nós e relacionamentos como bordas direcionadas no gráfico.
+ **Dados tabulares:**  
![\[AWS IoT TwinMaker resultados do editor de consultas exibidos como dados tabulares.\]](http://docs.aws.amazon.com/pt_br/iot-twinmaker/latest/guide/images/kg-table-data.png)

  O formato de dados tabulares exibe os dados de todas as consultas. Você pode pesquisar na tabela resultados específicos ou subconjuntos dos resultados. Os dados podem ser exportados no formato JSON ou CSV.
+ **Resumo da execução**  
![\[AWS IoT TwinMaker resultados do editor de consultas exibidos como um resumo da execução.\]](http://docs.aws.amazon.com/pt_br/iot-twinmaker/latest/guide/images/kg-run-sum.png)

  O resumo da execução exibe a consulta e os metadados sobre o status da consulta.