Dashboards for Siebel CRM Monitoring

Using Grafana Dashboards

For more details about Grafana Dashboards, see Key Software Components for Monitoring. Note that Grafana server/service is not shipped by Oracle and must be hosted and managed by the users. Features described in this document were tested with Grafana version 9.4.3.

The Grafana sample dashboards are provided as JSONs which can be downloaded after enabling the monitoring feature and available via GET API: /scm/api/v1.0/environment/<ENV_ID>/observability/download/sample_grafana_dashboards.zip.

Here's a list of sample Grafana dashboards from Oracle for complete backend monitoring:

• Node Exporter Dashboard
• Kube-State-Metrics Dashboard
• Cadvisor Dashboard
• Jmx Dashboard
• Nginx Ingress Controller Dashboard
• Siebel Server Dashboard
• Siebel Components Dashboard
• Siebel Block Volume and File System Storage Dashboard

The downloaded JSONs can be imported into Grafana for use with two steps:

1. Add SCM provisioned Prometheus endpoint as a Data Source in Grafana as follows:
   1. Log in to Grafana
   2. Add DataSource
   3. Select Prometheus
   4. Add Prometheus URL from SCM
   5. Choose GET as Https method
   6. Save
2. Select the same data source as Prometheus DataSource during import of JSONs.

Visualizing OCI Infrastructure Metrics in Grafana

Follow these steps below to visualize OCI Infrastructure Metrics in Grafana.

For more information, refer:

• https://grafana.com/grafana/plugins/oci-metrics-datasource/
• https://github.com/oracle/oci-grafana-metrics/blob/master/docs/using.md

1. In Grafana, go to Configurations > Plugins and install the Oracle Cloud Infrastructure Metrics plugin.

2. Click Create an Oracle Cloud Infrastructure Metrics Data Source and provide appropriate "Connection Details" and save the "Datasource".
3. You can now use OCI Infrastructure metrics to build custom Dashboards in Grafana. You can verify the metrics from the metrics Explore tab in Grafana.

Using OCI Dashboards

OCI APM (Application Performance Monitoring) Dashboards are part of Oracle Cloud's observability and monitoring functionalities.

These can be accessed under APM Dashboard services in OCI Console. Sample dashboards from Siebel CRM Observability – Monitoring solution is available under SCM compartment and named "Siebel CRM - <namespace>".

1. Log in to OCI.
2. Navigate to Application Performance Monitoring Dashboards Service.
3. Change compartment to SCM compartment.
4. Sample dashboard is named "Siebel CRM - <namespace>".

These and other dashboards can be customized for your specific business requirements. Broad customization steps for OCI dashboard include:

• Identify different metrics from Metric Explorer service that meet your requirements.
• Utilize Monitoring Query Language from OCI to generate right output. For more information, refer https://docs.oracle.com/en-us/iaas/Content/Monitoring/Reference/mql.htm).
• Build new Dashboards based on the output from previous step.

Troubleshooting Common Dashboard Issues

NGINX Dashboard Loading Issue

The NGINX dashboard does not load if the nginx_ingress_controller_requests metric is missing or appears only with a status of 404 in the Prometheus UI.

To resolve this issue:

1. Inspect the NGINX Ingress Controller pod arguments as follows:
   1. Execute the kubectl describe command to describe the NGINX Ingress Controller pod.
   2. Verify whether the metrics-per-host argument was set to a value other than false in the Containers.controller.Args section or missing when the pod started.
2. If this argument is not set to false or is missing, perform the following steps to resolve the issue:
   1. Update the NGINX Ingress Helm chart as follows:
      1. Navigate to the environment Helm chart directory:

         cd /home/opc/siebel/<env_id>

      2. Open the NGINX Ingress Helm chart.
      3. Increment the chart version in Chart.yaml (for example, from 4.12.2 to 4.12.3).
      4. Add the perHost parameter in values.yaml under controller.metrics as follows:

         perHost: false

      5. Update the template argument in the ingress-nginx/templates/_params.tpl file as follows:

            {{- if .Values.controller.metrics.enabled }}
            - --enable-metrics={{ .Values.controller.metrics.enabled }}
            - --metrics-per-host={{ .Values.controller.metrics.perHost }}
            {{- end }}

   2. Update the NGINX Ingress Flux release manifest as follows:
      1. Navigate to your environment Flux project in your environment directory.

         cd /home/opc/siebel/<env_id>/<Cloud manager repository name>

      2. Edit the infrastructure/nginx/release.yaml file to set the NGINX release metric as follows:

            spec:
               ...
               metrics:
                  enabled: true
                  perHost: false      
               ...

      3. Commit the changes and push them to the repository:

         git add . 
         git commit -m "perHost is set to false" 
         git push

         Wait for the reconciliation process to complete and for the changes to be applied.

3. Verify that the NGINX dashboard loads as expected.