通过配置 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 元素中,指定标识并引用配置的密钥库文件,此文件为网关的证书或者 digicert.jks 文件,如开始之前中所述。
- 在 ssl 元素中,指定标识并引用您所定义的 keyStore 元素的标识。有关 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 元素的标识。
- 对于可选的 groups 属性,可以定义 Liberty 服务器集以将其分组以便于报告。您可以定义多个嵌套组级别,可以将每个 Liberty 服务器包括在多个组中,组名之间用逗号分隔,如以下示例所示。
groups="libertyGroup1, libertyGroup1/subgroupA, subgroupA/smallGroupx"
在此示例中,smallGroupx 嵌套在 subgroupA 中,而 subgroupA 又嵌套在 libertyGroup1 中。请指定最高级别的组,没有正斜杠 (/)。指定嵌套的组,具有正斜杠,例如 parentGroup/nestedGroup。分组的服务器以分层方式在 Product Insights 服务中显示。
- 如果未使用网关且 Liberty 服务器无法直接访问因特网,请在 proxyUrl、proxyUser 和 proxyPassword 属性上定义 HTTP 代理。代理 URL 必须为 http://hostname:port 格式,仅当 HTTP 代理服务器需要认证时,才需要代理用户名和密码。
如果 Liberty 具有因特网访问权或您将通过网关路由数据,那么不需要定义代理设置。
结果
要在 IBM Cloud 控制台中查看已注册服务器,请转至 ,并选择 Product Insights 服务实例。已注册的服务器在服务的管理选项卡上列出。
要停止从 Liberty 服务器报告使用情况指标,请从此服务器配置移除 productInsights 配置。