기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
Salesforce 데이터 소스에 연결
참고
이 데이터 소스는 Grafana Enterprise 전용입니다. 자세한 내용은 Enterprise 플러그인에 대한 액세스 관리 단원을 참조하십시오.
또한 버전 9 이상을 지원하는 워크스페이스에서 이 데이터 소스를 사용하려면 적절한 플러그인을 설치해야 할 수 있습니다. 자세한 내용은 플러그인을 사용하여 워크스페이스 확장 단원을 참조하십시오.
Salesforce 데이터 소스를 사용하면 Amazon Managed Grafana 내에서 Salesforce의 데이터를 시각화할 수 있습니다.
이 데이터 소스를 사용하려면 Salesforce
알려진 제한 사항
-
임시 필터는 아직 지원되지 않습니다.
-
SOQL 쿼리와 SOQL을 통해 액세스할 수 있는 데이터만 현재 지원됩니다. SOSL 및 SAQL 쿼리 형식은 아직 지원되지 않습니다.
필수 설정
다음 설정이 필요합니다.
참고
플러그인은 현재 OAuth 2.0 사용자 이름-암호 흐름을 사용합니다. 연결된 앱에서 필요한 콜백 URL은 사용되지 않습니다. 따라서 유효한 URL로 설정할 수 있습니다.
| 명칭 | 설명 |
|---|---|
Enable OAuth settings
|
OAuth를 활성화하려면 이를 선택해야 합니다. |
Callback URL
|
이 플러그인에서는 사용되지 않으므로 유효한 URL을 지정할 수 있습니다. |
Selected OAuth Scopes (minimum requirements)
|
데이터(api)에 액세스하고 데이터를 관리합니다. |
Require Secret for Refresh Token Flow
|
이를 활성화하거나 비활성화할 수 잇습니다. |
데이터 소스 추가
-
Amazon Managed Grafana 워크스페이스에서 Grafana 콘솔을 열고 로그인되었는지 확인합니다.
-
사이드 메뉴의 구성(톱니 아이콘) 아래에서 데이터 소스를 선택하세요.
-
데이터 소스 추가를 선택합니다.
참고
사이드 메뉴에 데이터 소스 링크가 표시되지 않으면 현재 사용자에게
Admin역할이 없다는 의미입니다. -
데이터 소스 목록에서 Salesforce를 선택하세요.
-
다음 정보를 입력합니다.
-
사용자 이름에 Salesforce를 연결하고 쿼리하는 데 사용할 Salesforce 계정의 사용자 이름을 입력하세요.
-
암호에 해당 사용자 암호를 입력합니다.
-
보안 토큰 에 해당 사용자의 보안 토큰을 입력합니다.
-
소비자 키에 소비자 키를 입력하여 Salesforce에 연결하세요. Salesforce 연결된 앱에서 이 정보를 얻을 수 있습니다.
-
소비자 보안 암호에 Salesforce에 연결하는 데 사용할 소비자 보안 암호를 입력하세요. Salesforce 연결된 앱에서 이 정보를 얻을 수 있습니다.
-
샌드박스 사용에서 Salesforce 샌드박스를 사용하려면 이 옵션을 선택하세요.
-
Salesforce 데이터 소스 쿼리
쿼리 편집기는 쿼리 빌더 및 SOQL 편집기 모드를 지원합니다. SOQL은 Salesforce Object Query Language
쿼리 빌더(SOQL 빌더)
쿼리 빌더는 SOQL 쿼리를 빌드하기 위한 사용자 친화적 인터페이스입니다. SOQL 쿼리 작성에 익숙하지 않은 경우 이 모드를 사용하여 SOQL을 빌드해 Salesforce 객체를 쿼리할 수 있습니다. 쿼리 빌더의 FROM 필드는 Salesforce에 있는 하나 이상의 엔터티를 나타냅니다. 쿼리 빌더의 다른 작업을 수행하기 전에 FROM 필드를 선택해야 합니다. FROM 필드를 선택한 후 빌더 모드를 선택해야 합니다. SOQL 빌더는 현재 다음 모드를 지원합니다.
-
List- 선택한 테이블/Salesforce의 필드를 포함하는 항목을 나열합니다. 이 모드를 사용하여 '이 회계 분기에 생성된 기회 목록과 함께 해당 이름, 값 및 단계 표시'와 같은 결과를 확인합니다. -
Aggregate- 엔터티의 항목을 집계합니다. 이 모드를 사용하여 '지난 달에 생성된 기회 계산' 또는 '스테이지 이름별로 그룹화된 기회의 총 가치'와 같은 결과를 확인합니다. -
Trend- 시간 경과에 따른 집계된 결과를 표시합니다. 이 모드를 사용하여 'CreatedDate별 기회 수 계산' 또는 '기회의 마감 날짜별로 그룹화된 총 가치 합계'와 같은 결과를 확인합니다.
쿼리 편집기에서 Entity/FROM 및 모드를 선택한 후 다음 옵션을 사용하여 쿼리를 빌드합니다.
| 필드 | 적용 대상 | 설명 |
|---|---|---|
| SELECT | ALL | 보려는 필드 목록을 선택하세요. 집계 또는 추세 보기에서 값을 집계할 방법도 선택합니다. |
| WHERE | ALL | (선택 사항) 필터 조건을 지정합니다. 결과는 선택한 조건에 따라 필터링됩니다. |
| ORDER BY | LIST, AGGREGATE | (선택 사항) 결과에 사용할 필드 이름과 정렬 순서를 선택합니다. |
| LIMIT | LIST, AGGREGATE | (선택 사항) 반환된 결과 수를 제한합니다. 기본값은 100입니다. |
| GROUP BY | AGGREGATE | (선택 사항) 집계된 값을 특정 필드로 분할하려면 필드를 선택합니다. |
| TIME FIELD | TREND | 결과를 그룹화할 날짜 필드를 지정합니다. 결과는 Grafana의 시간 선택기 범위에 따라 필터링됩니다. |
쿼리 편집기에서 이전 필드를 구성하면 쿼리 편집기 아래에 생성된 SOQL의 미리 보기도 표시됩니다. 쿼리 빌더의 제한 사항으로 인해 차단된 경우 생성된 SOQL 쿼리를 사용자 지정할 수 있는 SOQL 편집기로 안전하게 전환할 수 있습니다.
SOQL 편집기
원시 SOQL 편집기에서는 원시 SOQL 쿼리를 통해 Salesforce 객체를 쿼리하는 옵션을 제공합니다. SOQL 편집기에서는 테이블 및 해당 필드당 사용 가능한 엔터티와 같은 자동 완성 제안을 제공합니다. SELECT 또는 WHERE 다음에 Ctrl+Space를 사용하여 테이블당 사용 가능한 엔터티를 확인합니다. 엔터티 이름 뒤에 점을 입력하면 사용 가능한 필드를 볼 수 있습니다.
단축키
CTRL + SPACE를 사용하여 사용 가능한 컨텍스트 옵션을 보여주는 코드 완료를 표시합니다.
CMD + S는 쿼리를 실행합니다.
시계열로 쿼리
날짜 필드를 time으로, 지표 필드를 metric으로 각각 별칭을 지정하여 시계열 쿼리를 수행한 다음, 지표 및 날짜별로 그룹화합니다. 다음은 예제입니다.
SELECT sum(Amount) amount, CloseDate time, Type metric from Opportunity group by Type, CloseDate
매크로
대시보드 시간 범위별로 필터링하기 위해 SOQL 쿼리에서 매크로를 사용할 수 있습니다.
-
$__timeFrom-time데이터 유형으로 변환된 현재 활성 시간 선택의 시작으로 대체됩니다. -
$__timeTo-time데이터 유형으로 변환된 현재 활성 시간 선택의 끝으로 대체됩니다. -
$__quarterStart- 회계 분기의 시작(SalesForce 회계 연도 설정에서 파생됨). -
$__quarterEnd- 회계 분기의 끝(SalesForce 회계 연도 설정에서 파생됨).
SELECT UserId, LoginTime from LoginHistory where LoginTime > $__timeFrom
템플릿 및 변수
새 Salesforce 쿼리 변수를 추가하려면 쿼리 변수 추가 섹션을 참조하세요. Salesforce 데이터 소스를 데이터 소스로 사용합니다. 여기에서 모든 SOQL 쿼리를 사용할 수 있습니다.
사용자 ID 및 사용자 이름과 같은 이름/값 페어를 사용하려면 SOQL 쿼리에서 두 필드를 반환합니다. 첫 번째 필드가 ID로 사용됩니다. 쿼리 편집기 SOQL에서 키(ID 등)를 기준으로 필터링하려는 경우 이 작업을 수행합니다.
변수 구문을 사용하여 SOQL 쿼리에서 변수를 사용합니다. 자세한 내용은 변수 구문 단원을 참조하십시오.
