기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# Grafana에서 AWS IoT TwinMaker 지식 그래프를 사용하는 방법
이 섹션에서는 AWS IoT TwinMaker Grafana 대시보드에 쿼리 편집기 패널을 추가하여 쿼리를 실행하고 표시하는 방법을 보여줍니다.
## AWS IoT TwinMaker 쿼리 편집기 사전 조건
Grafana에서 AWS IoT TwinMaker 지식 그래프를 사용하기 전에 다음 사전 조건을 완료하세요.
+ AWS IoT TwinMaker 워크스페이스를 생성합니다. [AWS IoT TwinMaker 콘솔](https://console.aws.amazon.com/iottwinmaker/)에서 작업 영역을 생성할 수 있습니다.
+ Grafana와 함께 사용하도록 AWS IoT TwinMaker 를 구성합니다. 지침은 [AWS IoT TwinMaker Grafana 대시보드 통합](grafana-integration.md) 섹션을 참조하세요.
**참고**
AWS IoT TwinMaker 지식 그래프를 사용하려면 **표준** 또는 **계층형 번들** 요금 모드에 있어야 합니다. 자세한 내용은 [AWS IoT TwinMaker 가격 책정 모드 전환](tm-pricing-mode.md) 단원을 참조하십시오.
## AWS IoT TwinMaker 쿼리 편집기 권한
Grafana에서 AWS IoT TwinMaker 쿼리 편집기를 사용하려면 작업에 대한 권한이 있는 IAM 역할이 있어야 합니다`iottwinmaker:ExecuteQuery`. 이 예제와 같이 워크스페이스 대시보드 역할에 해당 권한을 추가합니다.
------
#### [ 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": "*"
}
]
}
```
------
**참고**
AWS IoT TwinMaker Grafana 데이터 소스를 구성할 때 역할 **ARN 수임 필드에이 권한이 있는 역할을** 사용해야 합니다. 추가한 후에는 **작업 영역** 옆의 드롭다운에서 작업 영역을 선택할 수 있습니다.
자세한 내용은 [대시보드 IAM 역할 생성](dashboard-IAM-role.md#dashboard-IAM-role.title) 단원을 참조하십시오.
### AWS IoT TwinMaker 쿼리 편집기 패널 설정
**지식 그래프에 대한 새 Grafana 대시보드 패널을 설정하려면**
1. AWS IoT TwinMaker Grafana 대시보드를 엽니다.
1. 새 **대시보드 패널**을 만드십시오. 패널을 생성하는 방법에 대한 자세한 단계는 Grafana 설명서의 [ 대시보드 생성을](https://grafana.com/docs/grafana/latest/dashboards/build-dashboards/create-dashboard/) 참조하세요.
1. 시각화 목록에서 **AWS IoT TwinMaker 쿼리 편집기**를 선택합니다.
![\[AWS IoT TwinMaker 대시보드의 드롭다운 목록에는 AWS IoT TwinMaker 쿼리 편집기에 대한 옵션이 포함되어 있습니다.\]](http://docs.aws.amazon.com/ko_kr/iot-twinmaker/latest/guide/images/tw-query-editor-dropdown.png)
1. 데이터 소스를 선택하여 쿼리를 실행합니다.
1. **(선택 사항)** 제공된 필드에 새 패널의 이름을 추가합니다.
1. **적용을** 선택하여 새 패널을 저장하고 확인합니다.
지식 그래프 패널은 AWS IoT TwinMaker 콘솔에 제공된 쿼리 편집기와 유사한 방식으로 작동합니다. 패널에서 작성한 쿼리를 실행하고, 작성하고, 지울 수 있습니다. 쿼리를 작성하는 방법에 대한 자세한 내용은 섹션을 참조하세요[AWS IoT TwinMaker 지식 그래프 추가 리소스](tm-knowledge-graph-resources.md).
#### AWS IoT TwinMaker 쿼리 편집기 사용 방법
쿼리 결과는 다음 이미지와 같이 세 가지 방식으로 표시됩니다. 그래프로 시각화하거나, 표로 나열하거나, 실행 요약으로 표시됩니다.
+ **그래프 시각화:**
![\[AWS IoT TwinMaker 쿼리 편집기 결과가 시각적 그래프로 표시됩니다.\]](http://docs.aws.amazon.com/ko_kr/iot-twinmaker/latest/guide/images/kg-vis-graph.png)
시각적 그래프에는 결과에 적어도 하나 이상의 관계가 있는 쿼리에 대한 데이터만 표시됩니다. 그래프에는 개체가 노드로 표시되고 관계는 그래프의 방향 엣지로 표시됩니다.
+ **테이블 형식 데이터:**
![\[AWS IoT TwinMaker 쿼리 편집기 결과가 테이블 형식으로 표시됩니다.\]](http://docs.aws.amazon.com/ko_kr/iot-twinmaker/latest/guide/images/kg-table-data.png)
표 형식 데이터 형식은 모든 쿼리의 데이터를 표시합니다. 테이블에서 특정 결과 또는 결과의 하위 집합을 검색할 수 있습니다. 데이터는 JSON 또는 CSV 형식으로 내보낼 수 있습니다.
+ **규칙 요약**
![\[AWS IoT TwinMaker 쿼리 편집기 결과가 실행 요약으로 표시됩니다.\]](http://docs.aws.amazon.com/ko_kr/iot-twinmaker/latest/guide/images/kg-run-sum.png)
실행 요약에는 쿼리 상태에 대한 쿼리와 메타데이터가 표시됩니다.