웹 커넥터 사용

웹 서비스에 대한 커넥터 구성

웹 서비스 커넥터 기능을 사용하면 모바일 응용 프로그램 대시보드에 표시할 데이터를 원격 웹 서비스에서 액세스할 수 있습니다. 기본, 다이제스트, OAuth 1.0a, NLTM 인증을 사용하거나 인증을 사용하지 않으며 XML, JSON 또는 ATOM 형식으로 응답하는 모든 RESTful 웹 서비스가 지원됩니다(예: CA APM Cloud Monitor, Yahoo Services, General Sentiment, Markit On Demand 및 Klout).

웹 커넥터 기능은 다음을 지원합니다.

인증 유형: 기본, 다이제스트, OAuth 1.0a, NLTM 또는 없음
응답 형식: XML, JSON, ATOM
메트릭 및 메타데이터 요청 유형
웹 서비스 데이터의 필터링을 위한 매개 변수
GET 및 POST HTTP 실행 메서드
하나의 요청에서 다른 요청으로 데이터를 전달하기 위한 변수

참고: https://support.ca.com/irj/portal/anonymous/redirArticles?reqPage=search&searchID=TEC604364의 기술 자료 문서는 실제 웹 서비스 예제를 사용하여 웹 서비스 커넥터를 만드는 방법에 대한 자세한 설명이 제공됩니다.

메트릭 및 메타데이터 요청 정보

요청 유형	알아 두어야 할 사항
메트릭	사용 가능한 메트릭을 표시하며 "메트릭" 탭에서 볼 수 있습니다. 매개 변수를 사용하여 웹 서비스에서 수집할 데이터를 지정하십시오. 예를 들어 매개 변수를 사용하여 시간 간격(시작과 끝)을 정의할 수 있습니다. 이 요청의 실행으로 인한 출력 변수는 다른 요청을 구성할 때 입력으로 사용할 수 있습니다.
메타데이터	기본적으로 커넥터 시작 시 그리고 12시간마다 실행됩니다. 기본 새로 고침 간격은 다음을 업데이트하여 수정할 수 있습니다. install_dir/config/execConfig.properties 파일의 http.connector.incrementalSync.reschedule FullSync.minutes 속성 파일 "메트릭" 탭에 표시되지 않습니다. 이 요청의 실행으로 인한 출력 변수는 다른 요청을 구성할 때 입력으로 사용할 수 있습니다.

요청 유형

알아 두어야 할 사항

메트릭

사용 가능한 메트릭을 표시하며 "메트릭" 탭에서 볼 수 있습니다.
매개 변수를 사용하여 웹 서비스에서 수집할 데이터를 지정하십시오. 예를 들어 매개 변수를 사용하여 시간 간격(시작과 끝)을 정의할 수 있습니다.
이 요청의 실행으로 인한 출력 변수는 다른 요청을 구성할 때 입력으로 사용할 수 있습니다.

메타데이터

기본적으로 커넥터 시작 시 그리고 12시간마다 실행됩니다. 기본 새로 고침 간격은 다음을 업데이트하여 수정할 수 있습니다.
install_dir/config/execConfig.properties 파일의 http.connector.incrementalSync.reschedule FullSync.minutes 속성 파일
"메트릭" 탭에 표시되지 않습니다.
이 요청의 실행으로 인한 출력 변수는 다른 요청을 구성할 때 입력으로 사용할 수 있습니다.

변수 정보

변수를 사용하는 일반적인 예는, 한 웹 서비스 호출은 "sessionId"를 반환하는 인증 요청이고 두 번째 웹 서비스 호출은 메트릭 데이터를 가져오기 위한 입력의 하나로 이 "sessionId"를 사용하는 경우입니다. 이 경우에는 첫 번째 요청을 "메타데이터" 유형(변수 sessionId 생성)으로 구성하고 두 번째 요청은 메트릭 데이터를 가져오기 위해 이 변수를 ${sessionId}로 사용하는 "메트릭" 요청으로 구성해야 합니다.

기타 참고 사항:

변수는 ${} 안에 변수 이름을 지정하는 방법으로 요청에서 사용됩니다(예: ${sessionId}).
요청에 시간 간격이 필요한 경우에는 $startTime{time format} 및 $endTime{time format}과 같은 명명된 변수를 사용하십시오. 여기서 time format은 Java Simple Date Format 문자열(예: $startTime{yyyyMMdd})로 지정됩니다.
변수 값을 상수로 지정하려면 중괄호 {}를 사용하십시오. 예를 들어, ${stockName}와 같이 요청에 사용될 수 있는 값 {CA}를 사용하여 변수 stockName을 만드십시오.

다음 그림은 관리자가 웹 서비스에 대한 커넥터를 구성하는 방법을 설명합니다.

CA Executive Insight와 웹 서비스 커넥터 통합

다음 단계를 따라 웹 서비스에 대한 커넥터를 구성하십시오.

커넥터에 대한 웹 서비스 요청 구성

CA Executive Insight에서는 사용자가 RESTful 웹 서비스를 통해 메트릭을 획득할 수 있습니다. 이렇게 하려면 먼저 모든 인증 정보를 포함한 웹 서비스 관련 정보를 지정해야 합니다.

참고: 커넥터에는 둘 이상의 요청이 포함될 수 있지만 여러 개의 요청을 동일한 커넥터에 추가할 때는 요청 간에 상호 종속성이 있어야 합니다. 단일 요청의 실행이 실패한 경우 커넥터는 '실패' 상태가 되며 모든 요청을 성공적으로 실행할 수 있기 전까지는 다른 요청을 실행하지 않습니다.

관리 UI에 로그인합니다.
"관리" 탭에서 "메트릭 커넥터"를 클릭합니다.
"메트릭 커넥터" 페이지가 열립니다.
"새로 추가"를 클릭하고 드롭다운 목록에서 웹 커넥터를 선택합니다.
"Universal Web Service Connector 새로 만들기" 페이지가 열립니다.
정보 섹션에서 필요한 커넥터 정보를 입력합니다.

이름

커넥터의 이름을 정의합니다.

제한: 최대 225자

참고: 커넥터 이름은 내부적으로 사용되므로 웹 서비스의 값과 일치할 필요가 없습니다.

설명

(선택 사항) 커넥터에 대한 설명을 정의합니다.

제한: 최대 512자
"속성" 탭에서 메트릭을 수집할 웹 서비스 요청에 대한 필요한 정보를 입력합니다.

요청 이름

요청의 이름을 정의합니다. 이 이름은 요청이 저장된 후 "활성 요청" 드롭다운 목록에 표시됩니다.

메서드

요청에 사용할 HTTP 메서드를 지정합니다. GET 또는 POST 메서드를 사용할 수 있습니다.

URL

요청을 하는 대상 웹 서비스에 사용될 URL을 지정합니다.

매개 변수

(선택 사항) 요청에 필요하며 URL에 추가될 HTTP 매개 변수를 정의합니다. 속성이 키 및 값 쌍에 추가되었습니다.

POST 메서드가 선택된 경우:

본문

(선택 사항) POST 요청 및 응용 프로그램/x-www-form-urlencoded 미디어 유형 콘텐츠에 필요한 요청 메시지 본문 매개 변수를 정의합니다.

페이로드

(선택 사항) 키 및 값 쌍으로서 추가될 수 있는 POST 요청에 대한 본문 매개 변수를 정의합니다. 본문 매개 변수는 페이로드보다 우선 순위가 높습니다.

인증

요청에 사용될 인증 방법의 유형을 정의합니다.

기본값: 'None'으로 설정됨

콘텐츠

(선택 사항) 요청에 대해 허용되는 콘텐츠 유형입니다.

헤더

(선택 사항) 요청에 사용될 HTTP 헤더를 정의합니다. 헤더가 키 및 값 쌍에 추가되었습니다.

HTTP 프록시

요청에 HTTP 프록시를 사용할지 여부를 지정합니다.

기본값: HTTP 프록시를 사용하지 않도록 설정됨
"테스트" 단추를 클릭합니다.
웹 서비스 연결이 테스트되고 요청 상태와 함께 응답이 표시됩니다.
응답 텍스트 섹션에서 요청의 결과를 확인합니다. 다음 방법 중 하나로 응답을 볼 수 있습니다.
- 상태 - 입력한 요청 정보가 올바른지 파악하기 위해 HTTP 응답 상태 줄 및 코드를 표시합니다.
- 헤더 - 요청에 대한 HTTP 응답 헤더를 표시합니다.
- 본문 - HTTP 응답의 본문을 표시합니다. 이 섹션을 사용하여 응답 처리를 구성할 때 무엇을 입력할지 결정할 수 있습니다.
- 결과 - 요청의 처리 결과를 표시합니다. 이 정보는 응답 처리를 구성한 후에 사용할 수 있습니다.
- 요청 - 생성된 HTTP 요청을 표시합니다.

웹 서비스 출력의 응답 처리 구성

요청 구성이 완료되고 성공적으로 테스트된 후 응답 처리 구성을 만듭니다. 웹 서비스 커넥터는 응답 처리 구성을 사용하여 웹 서비스 응답 본문에서 메트릭 및 해당 값을 가져옵니다. 처리할 대상을 결정하기 위해 응답에 대한 "본문 옵션" 단추와 함께 "테스트" 단추를 사용할 수 있습니다.

응답 처리 필드는 웹 서비스 커넥터가 응답의 모델을 만들기 위해 사용하는 XPath 또는 JSON Path 구문 분석 명령을 포함하고 있어야 합니다.

다음 단계를 수행하십시오.

"처리" 탭에서 웹 서비스 출력을 메트릭으로 처리하기 위해 필요한 정보를 입력합니다.

유형

응답 유형을 정의합니다.

선택 사항: 메트릭 또는 메타데이터

파서

응답 본문에 사용할 파서를 정의합니다.

기본값: Auto

메트릭 이름

각 호출에서 메트릭을 식별하기 위한 고유 이름을 지정합니다.

예: XPath 식: //field[@[name='name']

예: 상수 값: {CAStock}

예: 세 개의 메트릭 이름이 선택되는 여러 표현식 및 상수 값: //resource{2}/field{@name='name'];{CAStock};//resource[25}/field[@name='name']

메트릭 값

메트릭의 값을 지정합니다.

예: //field[@name='price'] //LastPrice

메트릭 타임스탬프

메트릭 값의 타임스탬프를 지정합니다.

예: //field[@name='ts'] //Timestamp

날짜/시간 형식

메트릭 타임스탬프를 구문 분석하는 데 사용된 형식 문자열을 지정합니다..

옵션: milliseconds, seconds, minutes, hours, days 또는 Java Simple Date Format의 문자열

예: //field[@name='ts'] //Timestamp

예: yyyy-MM-dd'T'HH:mm:ss'Z'
Save(저장)를 클릭합니다.
새로운 웹 서비스 메트릭 커넥터가 생성되고 커넥터 메트릭 양식이 표시됩니다.
비즈니스 표시기에 대한 메트릭을 선택합니다.

응답 모델 1

이 응답 모델은 메트릭 이름, 메트릭 값, 메트릭 타임스탬프로 사용될 수 있는 필드를 포함하고 있습니다. 메트릭 이름은 고유해야 하며, 지정된 커넥터에 대해 생성된 모든 요청에서 이 메트릭을 고유하게 식별할 수 있도록 데이터베이스의 기본 키와 유사하게 사용됩니다.

응답:

<StockQuote>
  <Symbol>CA</Symbol>
  <LastPrice>31.98</LastPrice>
  <Timestamp>Wed Dec 18 12:47:46 GMT-05:00 2013</Timestamp>
</StockQuote>

이 응답에 대한 XPath 처리 명령:

메트릭 이름: //Symbol

메트릭 값: //LastPrice

메트릭 타임스탬프: //Timestamp

날짜/시간 형식 문자열은 다음과 같습니다.

EEE MMM d HH:mm:s z yyy

이 구성은 하나의 메트릭을 생성합니다.

응답 모델 변형

서브케이스는 사용 가능한 정보에 따라 웹 서비스 응답의 다른 모델 변형을 보여 줍니다.

응답 변형 유형 A - 타임스탬프 없음: 응답이 메트릭 타임스탬프를 포함하지 않거나, 메트릭 타임스탬프가 Simple Date Format 표현식을 사용하여 구분 분석될 수 없거나, 미리 정의된 상수 중 하나와 일치하지 않으며 공백으로 비워 두어야 합니다. 타임스탬프 식이나 형식을 지정하지 않으면 폴링 요청 시간이 해당 비즈니스 표시기 데이터의 타임스탬프로 사용됩니다.

응답:

 <StockQuote>
   <Symbol>CA</Symbol>
   <LastPrice>31.98</LastPrice>
</StockQuote>

위 응답 예제에서 해당 모델에 대한 XPath 처리 명령:

메트릭 이름: //Symbol

메트릭 값: //LastPrice

응답 변형 유형 B - 메트릭 이름 없음: 응답에 메트릭 이름으로 사용할 수 있는 필드가 없습니다. 이 경우 구문 분석 식 대신 {} 괄호로 둘러싸인 텍스트 값으로 메트릭 이름을 입력하십시오.

응답:

<StockQuote>
   <LastPrice>31.98</LastPrice>
   <Timestamp>Wed Dec 18 12:47:46 GMT-05:00 2013</Timestamp>
</StockQuote>

위 응답 예제에서 해당 모델에 대한 XPath 처리 명령:

메트릭 이름: {내 메트릭 이름}

메트릭 값: //LastPrice

메트릭 타임스탬프: //Timestamp

날짜/시간 형식 문자열은 다음과 같습니다.

EEE MMM d HH:mm:ss z yyy

응답 변형 유형 C - 메트릭 이름 및 타임스탬프 없음: 응답에 메트릭 이름 및 메트릭 타임스탬프로 사용할 수 있는 필드가 없습니다.

응답:

<StockQuote>
   <LastPrice>31.98</LastPrice>
</StockQuote>

위 응답 예제에서 해당 모델에 대한 XPath 처리 명령:

메트릭 이름: {내 메트릭 이름}

메트릭 값: //LastPrice

응답 모델 2

이 응답 모델에는 메트릭 이름, 메트릭 값, 메트릭 타임스탬프로 사용할 수 있는 여러 자식 요소가 루트 요소 아래에 포함되어 있습니다. 메트릭 이름은 고유해야 하며, 이 메트릭을 고유하게 식별하기 위해 데이터베이스에서 기본 키와 유사하게 사용됩니다.

응답:

<weather>
  <humidity>50</humidity>
  <temperature>98</temperature>
  <date>Wed, 18 Dec 2013 1:52 PM EST</date>
</weather>

위 응답 예제에서 해당 모델에 대한 XPath 처리 명령:

메트릭 이름: //{Temperature}; {Humidity}

메트릭 값: //temperature; //humidity

메트릭 타임스탬프: //date; //date

날짜/시간 형식 문자열은 다음과 같습니다.

EEE, d MMM yyy HH:mm a z

이 구성은 습도 및 기온에 대한 두 개의 메트릭을 생성합니다. 두 메트릭에는 단일 날짜 값이 또한 사용됩니다.

응답 모델 3

이 응답 모델에는 여러 레코드를 포함하고 있으며, 각 레코드의 필드는 메트릭 이름, 메트릭 값, 메트릭 타임스탬프로 사용될 수 있습니다. 메트릭 이름은 고유해야 하며, 이 메트릭을 고유하게 식별하기 위해 데이터베이스에서 기본 키와 유사하게 사용됩니다.

응답:

<resource classname="Quote">
        <field name="name">USD/ARS</field>
        <field name="price">6.375500</field>
        <field name="ts">1387395903</field>
</resource>
<resource classname="Quote">
        <field name="name">USD/KRW</field>
        <field name="price">1052.199951</field>
        <field name="ts">1387395903</field>
</resource>

위 응답 예제에서 해당 모델에 대한 XPath 처리 명령:

메트릭 이름: //field[@name='name']

메트릭 값: //field[@name='price']

메트릭 타임스탬프: //field[@name=’ts’]

날짜/시간 형식 문자열은 다음과 같습니다.

초

이 구성은 각 거래 가격(quote)에 대한 메트릭 목록을 생성합니다.

응답 모델 4

이 응답 모델은 하나의 메트릭 이름과 타임스탬프가 있는 여러 메트릭 값을 포함하고 있습니다. 이 경우 CA Executive Insight는 단일 폴링 요청에서 특정 메트릭에 대한 여러 메트릭 값을 가져옵니다.

응답:

<collection>
   <name>Brand Name</name>
   <record>
        <sentiment>0.4567</sentiment>
        <timestamp>20131218</timestamp>
   </record>
   <record>
        <sentiment>0.4893</sentiment> 
       <timestamp>20131219</timstamp>
   </record>
</collection>

위 응답 예제에서 해당 모델에 대한 XPath 처리 명령:

메트릭 이름: //name

메트릭 값: //sentiment

메트릭 타임스탬프: //timestamp

날짜/시간 형식 문자열은 다음과 같습니다.

yyyMMdd

이 구성은 값 목록이 있는 단일 메트릭을 생성합니다. 메트릭 이름이 없는 경우 {} 괄호로 둘러싼 메트릭 이름을 사용할 수 있습니다.