Configuring an integration server to send startup and usage information to IBM Cloud Product Insights

You can use the mqsichangebluemixreporting command to configure an integration server to connect to the IBM® Cloud Product Insights service, and to send startup and usage information to it.

1. Run the mqsichangebluemixreporting command from the host machine that is running your integration node (on premise) to configure and activate the IBM Cloud reporting feature.
   For example, the following command specifies an integration server called myIntegrationServer1, a reporting interval of 10 minutes, and sets the reporting state to active:

   mqsichangebluemixreporting IBNODE -e myIntegrationServer1 -c active 
   -j https://productinsights-api.ng.bluemix.net -m 10 
   -k ag282f6-6jki-4984-8892-7356e196k0l7
   

   The -j parameter specifies the API host for your region, where your data will be sent. To find your API host, check the information that is specified in the service credentials for your instance of Product Insights, as described in Configuring the IBM Cloud Product Insights service. If you choose to route the connection through the IBM Cloud Product Insights gateway, use the -j parameter to specify the URL of the gateway host rather than the API host. For more information, see Configuring a connection to IBM Cloud Product Insights through a gateway.

   The -k parameter specifies the API key, which you can also obtain by following the instructions in Configuring the IBM Cloud Product Insights service.

   You can set the reporting status (-c) to active only if valid values are specified (or have been specified previously) for the -j apiHost (or -j gatewayHost) and -k apiKey parameters.

   Note: You can configure your integration servers to connect to Product Insights through an HTTP proxy server, by specifying the -y parameter on the mqsichangebluemixreporting command. For information about how to complete this step, see Configuring a connection to IBM Cloud Product Insights through an HTTP proxy server. Alternatively, you can choose to route the connection through the IBM Cloud Product Insights gateway, as described in Configuring a connection to IBM Cloud Product Insights through a gateway.

   You can also choose to group instances of integration servers according to their usage (such as testing and staging) and view aggregated runtime usage data for the group, by specifying the -n groupname parameter.

   For more information about required and optional parameters, see mqsichangebluemixreporting command.

2. Optional: You can override the host name that the integration server reports to the Product Insights service, by setting the MQSI_BLUEMIXREPORTING_HOSTNAME environment variable. This can be useful if you are running the integration server in a container.
3. Restart the integration server for the changes to take effect.
   When the reporting status is active, startup and usage information for the specified integration server (or, if the -g parameter was specified, for all integration servers in the specified integration node) will be reported to the Product Insights service.
4. Optional: You can turn off reporting at any time by setting the -c parameter to inactive and then restarting the integration node.