您可以配置 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>"/>
- 在 url 和 apiKey 屬性中,指定您在建立
Product Insights 服務時所記下的 API 主機和金鑰認證。如果您已安裝 Product Insights 閘道,請改在 url 屬性中指定該閘道的 URL。
- 在 sslRef 屬性中,參照您所定義之 ssl 元素的 ID。
- 對於 groups 選用屬性,您可以定義多組 Liberty 伺服器,來加以分組,以方便報告。您可以定義多個巢狀群組層次,並以逗點來區隔群組名稱,以便將每一部 Liberty 伺服器包含在多個群組中,如下列範例所示。
groups="libertyGroup1, libertyGroup1/subgroupA, subgroupA/smallGroupx"
在本例中,smallGroupx 以巢狀方式放置於 subgroupA 內,而
subgroupA 也以巢狀方式放置於 libertyGroup1 內。如果要指定最高層次的群組,則不含正斜線 (/)。如果要指定巢狀群組,請使用正斜線,例如:parentGroup/nestedGroup。已分組的伺服器會在
Product Insights 服務中以階層方式顯示。
- 如果您沒有使用閘道,且 Liberty 伺服器無法直接存取網際網路,請在 proxyUrl、proxyUser 和
proxyPassword 屬性上定義 HTTP Proxy。Proxy URL 必須是
http://hostname:port 格式,並且只有在您的 HTTP Proxy 伺服器需要鑑別時,才需要 Proxy 使用者名稱和密碼。
如果 Liberty 能夠存取網際網路,或者您是透過閘道來遞送資料,就不需要定義 Proxy 設定。
結果
如果要在 IBM Cloud 主控台檢視已登錄的伺服器,請移至,然後選取 Product Insights 服務實例。您已登錄的伺服器會列在服務的管理標籤上。
如果要停止從 Liberty 伺服器報告使用情形度量,請將 productInsights 配置從該伺服器的配置中移除。