Salesforce 데이터 소스에 연결

참고

이 데이터 소스는 Grafana Enterprise 전용입니다. 자세한 정보는 엔터프라이즈 플러그인 액세스 관리을 참조하세요.

또한 버전 9 이상을 지원하는 작업 공간에서는 이 데이터 소스를 사용하려면 적절한 플러그인을 설치해야 할 수 있습니다. 자세한 정보는 플러그인으로 작업 영역 확장을 참조하세요.

Salesforce 데이터 소스를 사용하면 Amazon Managed Grafana 내에서 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	이 기능을 활성화하거나 비활성화할 수 있습니다.

데이터 소스 추가

1. 아마존 매니지드 Grafana 워크스페이스에서 Grafana 콘솔을 열고 로그인했는지 확인합니다.

2. 구성 아래의 사이드 메뉴 (톱니바퀴 아이콘) 에서 데이터 소스를 선택합니다.

3. 데이터 소스 추가를 선택합니다.

   참고

   사이드 메뉴에 데이터 소스 링크가 보이지 않으면 현재 사용자에게 해당 Admin 역할이 없는 것입니다.

4. 데이터 소스 목록에서 Salesforce를 선택합니다.

5. 다음 정보를 입력합니다.

   • 사용자 이름에 Salesforce에 연결하고 쿼리하는 데 사용할 Salesforce 계정의 사용자 이름을 입력합니다.

   • 비밀번호에는 해당 사용자의 비밀번호를 입력합니다.

   • 보안 토큰에 해당 사용자의 보안 토큰을 입력합니다.

   • 소비자 키에는 Salesforce에 연결하기 위한 소비자 키를 입력합니다. 이 정보는 Salesforce 커넥티드 앱에서 구할 수 있습니다.

   • 소비자 비밀에 소비자 비밀번호를 입력하여 Salesforce에 연결합니다. 이 정보는 Salesforce 커넥티드 앱에서 구할 수 있습니다.

   • Salesforce 샌드박스를 사용하려면 샌드박스 사용의 경우 이 옵션을 선택합니다.

Salesforce 데이터 소스를 쿼리하세요.

쿼리 편집기는 쿼리 작성기 및 SOQL 편집기 모드를 지원합니다. SOQL은 세일즈포스 개체 쿼리 언어의 약자입니다.

쿼리 빌더 (SOQL 빌더)

쿼리 빌더는 SOQL 쿼리를 작성하기 위한 사용자 친화적인 인터페이스입니다. SOQL 쿼리 작성에 익숙하지 않은 경우 이 모드를 사용하여 Salesforce 객체를 쿼리하는 SOQL을 작성할 수 있습니다. 쿼리 빌더의 FROM 필드는 Salesforce의 여러 엔티티를 참조합니다. 쿼리 빌더에서 다른 작업을 수행하기 전에 FROM 필드를 선택해야 합니다. FROM 필드를 선택한 후에는 빌더 모드를 선택해야 합니다. SOQL Builder는 현재 다음 모드를 지원합니다.

• List— 선택한 테이블/세일즈포스의 항목을 해당 필드와 함께 나열합니다. 이 모드를 사용하면 “이번 회계 분기에 창출된 기회 목록을 해당 기회 이름, 가치, 단계와 함께 보여주세요”와 같은 결과를 얻을 수 있습니다.

• Aggregate— 엔티티의 항목을 집계합니다. 이 모드를 사용하면 “지난 달에 창출된 기회 집계하기”와 같은 결과를 얻을 수 있습니다. 또는 “스테이지 이름을 기준으로 그룹화한 기회의 총 가치는 얼마입니까?”

• Trend— 시간 경과에 따른 집계된 결과를 표시합니다. 이 모드를 사용하면 “기회 수 계산 기준”과 같은 결과를 얻을 수 CreatedDate 있습니다. 또는 “기회 마감일을 기준으로 그룹화한 총 가치의 합계는 얼마입니까?”

쿼리 편집기에서 Entity/FROM 및 모드를 선택한 후 다음 옵션을 사용하여 쿼리를 작성하십시오.

필드	적용 대상:	설명
SELECT	ALL	보려는 필드 목록을 선택합니다. 집계 또는 트렌드 뷰의 경우 값을 집계할 방법도 선택합니다.
WHERE	ALL	(선택 사항) 필터 조건을 지정합니다. 결과는 선택한 조건에 따라 필터링됩니다.
ORDER BY	목록, 집계	(선택 사항) 결과에 적용할 필드 이름과 정렬 순서를 선택합니다.
LIMIT	목록, 집계	(선택 사항) 반환되는 결과 수를 제한합니다. 기본값은 100입니다.
GROUP BY	AGGREGATE	(선택 사항) 집계된 값을 특정 필드로 분할하려면 필드를 선택합니다.
시간 필드	경향	결과를 그룹화할 기준으로 사용할 날짜 필드를 지정합니다. 결과는 Grafana의 시간 선택 범위를 기준으로 필터링됩니다.

쿼리 편집기에서 이전 필드를 구성하면 쿼리 편집기 아래에 생성된 SOQL의 미리보기도 표시됩니다. 쿼리 작성기의 제한으로 인해 차단된 경우 생성된 SOQL 쿼리를 사용자 정의할 수 있는 SOQL 편집기로 안전하게 전환할 수 있습니다.

SOQL 편집기

원시 SOQL 편집기는 원시 SOQL 쿼리를 통해 Salesforce 객체를 쿼리할 수 있는 옵션을 제공합니다. SOQL 편집기는 테이블당 사용 가능한 항목 및 해당 필드와 같은 자동 완성 제안을 제공합니다. 셀렉트 또는 WHERE 다음에 Ctrl+Space를 사용하면 테이블당 사용 가능한 엔티티를 확인할 수 있습니다. 엔티티 이름 뒤에 점을 입력하면 사용 가능한 필드를 볼 수 있습니다.

단축키

CTRL+SPACE를 사용하여 코드 완성을 표시하면 사용 가능한 컨텍스트 옵션이 표시됩니다.

CMD + S는 쿼리를 실행합니다.

시계열 형식의 쿼리

날짜 필드를 시간으로, 지표 필드를 지표로 별칭을 지정한 다음 측정항목 및 날짜별로 그룹화하여 시계열 쿼리를 수행합니다. 다음은 그 예제입니다.

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 쿼리에서 변수를 사용하십시오. 자세한 내용은 변수 구문을(를) 참조하세요.