productInsights-1.0 기능을 구성하면
사내 구축형 또는
클라우드 기반 Liberty 서버를 등록하여 사용 메트릭을
IBM® Cloud Product Insights서비스에 보고할
수 있습니다.
이 태스크 정보
IBM Cloud의 단일
Product Insights 서비스에서,
사용자는
IBM Cloud 또는
기타 클라우드 환경에 사내 구축형으로 호스팅된 다수의
Liberty 서버를 추적할 수 있습니다.
Liberty 서버가
Product Insights 서비스 인스턴스에 등록된 경우,
해당 서버는
IBM Cloud의 서비스에 연결하여
다음 사용 메트릭을 주기적으로 보고합니다.
- 활성 Liberty 서버의 수
- 각 서버의 호스트 위치
- 각 서버의 제품 에디션 및 버전
- 각 서버의 사용률
사용자 및 사용자가 IBM Cloud에서 권한 부여한 기타 사용자만 Product Insights 서비스 인스턴스를 제어할 수 있습니다.
자세한 정보는 IBM developerWorks에 있는
IBM Cloud Product Insights 문서를
참조하십시오.
프로시저
- IBM Cloud 콘솔에서
Product Insights의 인스턴스를 작성하십시오.
서비스가 많은 Liberty 서버를 추적할 수 있으므로, 단일 서버 인스턴스만 필요합니다.
- IBM Cloud 카탈로그에서,
Product Insights 서비스를 검색하거나 아래에서 서비스를 선택하십시오.
- 결과 페이지에서, 선택적으로 기본 서비스 이름을 변경한 후에 작성을 클릭하십시오.
- Product Insights 서비스에서
서비스 신임 정보로 이동한 후 표시된 신임 정보 중 하나에
대해 신임 정보 보기를 선택하십시오.
작성한 Product Insights
서비스의 API 호스트 및 API 키를 메모해 두십시오. 이 정보는 특정 서비스 인스턴스에
서버를 등록할 때 Liberty
서버에 추가됩니다.
- 등록할 Liberty 서버의
server.xml 구성 파일에 productInsights-1.0
기능을 추가하십시오.
<featureManager>
<feature>productInsights-1.0</feature>
</featureManager>
- Liberty 서버와
IBM Cloud의
Product Insights 서비스 간
SSL 통신에 사용할 키 저장소와 신뢰 저장소를 서버 구성에 정의하십시오.
<keyStore id="productInsightsKeyStore" location="keystorefile.jks" type="JKS"/>
<ssl id="productInsightsSSL"
keyStoreRef="productInsightsKeyStore"
trustStoreRef="productInsightsKeyStore"
sslProtocol="TLSv1.2"/>
- keyStore 요소에 ID를 지정하고 사용자 구성을 위한 키 저장소
파일을 참조하십시오. 이 파일은 시작하기 전에에서 설명한 게이트웨이용 인증서 또는
digicert.jks 파일입니다.
- ssl 요소에 ID를 지정하고 정의된 keyStore 요소의
ID를 참조하십시오. SSL 구성에 대한
자세한 정보는 SSL 구성 속성의 내용을 참조하십시오.
- productInsights 요소에서 Product Insights
서비스를 구성하십시오.
<productInsights url="<apiHost_or_gatewayURL>" apiKey="<apiKey>" sslRef="productInsightsSSL" groups="<groupName>"
proxyUrl="<proxyURL>" proxyUser="<proxyUserName>" proxyPassword="<proxyPassword>"/>
- Product Insights 서비스를
작성할 때 메모해 둔 API 호스트 및 키 신임 정보를 url 및
apiKey 속성에 지정하십시오. Product Insights
게이트웨이를 설치한 경우 url 속성에 게이트웨이 URL을 대신
지정하십시오.
- 정의한 ssl 요소의 ID를 sslRef 속성에서
참조하십시오.
- 선택적 groups 속성의 경우 보고용으로 그룹화할 Liberty 서버 세트를
정의할 수 있습니다. 복수의 중첩된 그룹 레벨을 정의할 수 있으며,
다음 예제와 같이 그룹 이름을 쉼표로 구분하여 각 Liberty 서버를 복수의 그룹에
포함시킬 수 있습니다.
groups="libertyGroup1, libertyGroup1/subgroupA, subgroupA/smallGroupx"
이
예제에서 smallGroupx는 libertyGroup1 내에 중첩된
subgroupA 내에 중첩됩니다. 최상위 레벨 그룹은 슬래시(/) 없이
지정하십시오. 중첩 그룹은 슬래시와 함께 지정하십시오(예:
parentGroup/nestedGroup). 그룹화된
서버는 Product Insights 서비스에
계층 구조로 표시됩니다.
- 게이트웨이를 사용하고 있지 않으며 Liberty
서버가 인터넷에 직접 액세스할 수 없는 경우, proxyUrl, proxyUser
및 proxyPassword 속성에 HTTP 프록시를 정의하십시오.
프록시 URL은 http://hostname:port 형식이어야 하며,
HTTP 프록시 서버를 인증해야 하는 경우에만 프록시 사용자 이름과 비밀번호가
필요합니다.
Liberty가
인터넷에 액세스할 수 있거나 게이트웨이를 통해 데이터를 라우팅하는 경우에는
프록시 설정을 정의할 필요가 없습니다.
결과
IBM Cloud 콘솔에서 등록된 서버를 보려면 로 이동하고 Product Insights 서비스 인스턴스를 선택하십시오.
등록된 서버가 서비스의 관리 탭에 나열됩니다.
Liberty 서버에서
사용 메트릭을 보고하는 작업을 중지하려면 해당 서버의 구성에서
productInsights 구성을 제거하십시오.