Configuring Operations Dashboard

Once the Operations Dashboard is deployed, follow the steps below to verify the deployment, configure important settings, and register capabilities in order to start collecting tracing data and use the Operations Dashboard.

Replacing certificates

For information about replacing certificates, see Replacing certificates.

Verify the deployment

  • Access the Web Console.

  • The license agreement page should be displayed. Once you confirm the agreement, you should have access to the Web Console.

  • See to Internal health and make sure there are no internal alerts.

Important settings

IBM recommends that you configure the following settings at this point:

  • If you purchased a license of IBM Cloud Pak for Integration Operations Dashboard Add-on, see Product activation to upload the activation key that removes basic entitlement limitations (see Basic entitlement limitations).

  • By default, only ten percent (10%) of the traces is sampled. To change this value (for example, to increase it to 100% so all traces are sampled), see Sampling policy.

  • In order to allow Operations Dashboard to send emails (for reports, alerts, share, etc.), see SMTP system parameters to configure an SMTP connection.

  • In order to allow Operations Dashboard to send Syslog records for alerting, navigate to Reports & alerts system parameters page to configure the Syslog destination server.

Capability registration

Operations Dashboard receives distributed tracing data from registered IBM Cloud Pak for Integration capabilities. When a new capability is instantiated through the Platform Navigator, it must register with Operations Dashboard in order to be able to send distributed tracing data. For more information, see Capability registration.

Expanding tracing data storage

After Operations Dashboard is installed, it is possible to expand the tracing data storage in order to increase the amount of historical data that is persisted in the Store.

Restriction: Expanding the tracing data storage is applicable and possible only if basic entitlement limitations have been removed by uploading an activation key.

Option 1 - Increase replicas of store data nodes (recommended)

You can increase the number of replicas of Operations Dashboard store data nodes by changing the replicas value in the appropriate OperationsDashboard custom resource. This creates new data nodes with more storage, and increases the total storage capacity.

Option 2 - Increase the claim size

In order to expand the PVC (Persistent Volume Claim), follow the steps below for each Operations Dashboard Store data pod:

  • Make sure the provisioner supports resizing PVCs. You may use this article to find out whether your storage class may be resized.

  • Follow the documentation for expanding Persistent Volume Claims (PVCs).
    In order to locate the Store PVC name, change <OD_NAMESPACE> in the command below to the namespace where Operations Dashboard is installed in your environment and execute it:
    oc get pvc -n <OD_NAMESPACE> | grep -e "-od-str-"

  • You will get a list of 1 or more PVC names (depends on the amount of replicas for the Store data component). The PVC name is in the following format: pvc-<OD_INSTANCE_NAME>-ibm-integration-od-str-x

  • After the PVC expansion is complete for each of the PVCs in the list, the Store pods should be restarted in order for the expansion to take effect. In order to restart the Store pods, change <OD_NAMESPACE> in the command below to the namespace where Operations Dashboard is installed in your environment and execute it:
    oc delete sts -n <OD_NAMESPACE> <OD_INSTANCE_NAME>-ibm-integration-od-str

  • You can also get the instance name of Operations Dashboard that created the PVC by running the command on the PVC name obtained above: oc describe pvc <PVC_NAME>. The instance name will appear on the annotation app.kubernetes.io/instance.