Configuring Kubernetes to run Grafana

Before you begin

To use Granfana, the Prometheus application must be installed.
  • If you installed Prometheus following the instructions in the Installing Prometheus topic, Grafana is installed as part of installing Prometheus.
  • If the Grafana application is not installed in your Kubernetes cluster, see the installation details, in the Deploying Grafana on Kubernetes topic in the Grafana documentation.
To verify that the service was created correctly, run the following command to display a list of all services:
kubectl get svc -n monitoring
Ensure that the type for the Grafana service is ClusterIP and the port is 3000. Below is an example.
Name Type Cluster-IP External-IP Port Age
grafana ClusterIP 10.97.236.243 <none> 3000/TCP 7m2s

About this task

By default, Grafana is not available through an ingress controller. You can do one of the following to ?
  • Configure Grafana manually, using the instruction in the GitHub - prometheus-operator/kub-prometheus readme file to make Grafana available outside the Kubernetes cluster.
  • Use port-forwarding to forward the Grafana port to the machine where kubectl is running. If the machine where kubectl is running does not have a browser, then SSH must be used to port forward from the machine where kubectl is running to a machine that has a browser. For SSH, used the LocalForward feature. For more information, see the Use Port Forwarding to Access Applications in a Cluster topic in the Kubernetes documentation.

Before you can create your first dashboard, you need to add your data source. Note that you must have Grafana administrator access to add data sources. Complete the following steps to run Grafana and import your dashboard.

Procedure

  1. Enable port forwarding for the Grafana service. 
    kubectl port-forward service/grafana 3000:3000 -n monitoring
  2. When using a remote setup, navigate to the Grafana sign-in page in your browser. 
    <Cluster-IP>:3000
    The default port for Grafana is 3000. If you are on a local machine use localhost:3000.
  3. Enter admin for both the user name and prom-operator, and then select Sign In.
    You are prompted to change the password.
  4. Select OK and enter the new password.
  5. From the left panel, hover over + Create and select Import.
  6. Upload the K8_Sametime_Dashboard.json file.
    The K8_Sametime_Dashboard.json file is included in the Sametime Premium install product image. After decompressing the product image, the file is in the root directory.
  7. Select Prometheus (default) as the data source and then select Import.
  8. Save the dashboard.